diff options
Diffstat (limited to 'libnm-core/nm-setting-connection.c')
| -rw-r--r-- | libnm-core/nm-setting-connection.c | 2529 |
1 files changed, 0 insertions, 2529 deletions
diff --git a/libnm-core/nm-setting-connection.c b/libnm-core/nm-setting-connection.c deleted file mode 100644 index d6626a4d..00000000 --- a/libnm-core/nm-setting-connection.c +++ /dev/null @@ -1,2529 +0,0 @@ -/* SPDX-License-Identifier: LGPL-2.1-or-later */ -/* - * Copyright (C) 2007 - 2013 Red Hat, Inc. - * Copyright (C) 2007 - 2008 Novell, Inc. - */ - -#include "libnm-core/nm-default-libnm-core.h" - -#include "nm-setting-connection.h" - -#include "nm-libnm-core-intern/nm-common-macros.h" -#include "nm-utils.h" -#include "nm-utils-private.h" -#include "nm-core-enum-types.h" -#include "nm-connection-private.h" -#include "nm-setting-bond.h" -#include "nm-setting-bridge.h" -#include "nm-setting-team.h" -#include "nm-setting-vlan.h" -#include "systemd/nm-sd-utils-shared.h" - -/** - * SECTION:nm-setting-connection - * @short_description: Describes general connection properties - * - * The #NMSettingConnection object is a #NMSetting subclass that describes - * properties that apply to all #NMConnection objects, regardless of what type - * of network connection they describe. Each #NMConnection object must contain - * a #NMSettingConnection setting. - **/ - -/*****************************************************************************/ - -typedef enum _nm_packed { - PERM_TYPE_INVALID, - PERM_TYPE_USER, -} PermType; - -typedef struct { - PermType ptype; - char * item; -} Permission; - -NM_GOBJECT_PROPERTIES_DEFINE(NMSettingConnection, - PROP_ID, - PROP_UUID, - PROP_INTERFACE_NAME, - PROP_TYPE, - PROP_PERMISSIONS, - PROP_AUTOCONNECT, - PROP_AUTOCONNECT_PRIORITY, - PROP_AUTOCONNECT_RETRIES, - PROP_MULTI_CONNECT, - PROP_TIMESTAMP, - PROP_READ_ONLY, - PROP_ZONE, - PROP_MASTER, - PROP_SLAVE_TYPE, - PROP_AUTOCONNECT_SLAVES, - PROP_SECONDARIES, - PROP_GATEWAY_PING_TIMEOUT, - PROP_METERED, - PROP_LLDP, - PROP_MDNS, - PROP_LLMNR, - PROP_STABLE_ID, - PROP_AUTH_RETRIES, - PROP_WAIT_DEVICE_TIMEOUT, - PROP_MUD_URL, ); - -typedef struct { - GArray *permissions; - GSList *secondaries; /* secondary connections to activate with the base connection */ - char * id; - char * uuid; - char * stable_id; - char * interface_name; - char * type; - char * master; - char * slave_type; - char * zone; - char * mud_url; - guint64 timestamp; - int autoconnect_priority; - int autoconnect_retries; - int multi_connect; - int auth_retries; - int mdns; - int llmnr; - int wait_device_timeout; - guint gateway_ping_timeout; - NMSettingConnectionAutoconnectSlaves autoconnect_slaves; - NMMetered metered; - NMSettingConnectionLldp lldp; - bool read_only : 1; - bool autoconnect : 1; -} NMSettingConnectionPrivate; - -G_DEFINE_TYPE(NMSettingConnection, nm_setting_connection, NM_TYPE_SETTING) - -#define NM_SETTING_CONNECTION_GET_PRIVATE(o) \ - (G_TYPE_INSTANCE_GET_PRIVATE((o), NM_TYPE_SETTING_CONNECTION, NMSettingConnectionPrivate)) - -/*****************************************************************************/ - -static void -_permission_set_stale(Permission *permission, PermType ptype, char *item_take) -{ - nm_assert(permission); - nm_assert(NM_IN_SET(ptype, PERM_TYPE_INVALID, PERM_TYPE_USER)); - nm_assert(ptype != PERM_TYPE_USER - || nm_settings_connection_validate_permission_user(item_take, -1)); - - /* we don't inspect (clear) permission before setting. It takes a - * stale instance. */ - *permission = (Permission){ - .ptype = ptype, - .item = item_take, - }; -} - -static void -_permission_clear_stale(Permission *permission) -{ - g_free(permission->item); - /* We leave the permission instance with dangling pointers. - * It is "stale". */ -} - -static gboolean -_permission_set_stale_parse(Permission *permission, const char *str) -{ - const char *str0 = str; - const char *last_colon; - gsize ulen; - - nm_assert(str); - - if (!str) - goto invalid; - - if (!NM_STR_HAS_PREFIX(str, NM_SETTINGS_CONNECTION_PERMISSION_USER_PREFIX)) - goto invalid; - - str += NM_STRLEN(NM_SETTINGS_CONNECTION_PERMISSION_USER_PREFIX); - - last_colon = strrchr(str, ':'); - if (last_colon) { - /* Reject :[detail] for now */ - if (last_colon[1] != '\0') - goto invalid; - ulen = last_colon - str; - } else - ulen = strlen(str); - - if (!nm_settings_connection_validate_permission_user(str, ulen)) - goto invalid; - - /* Yay, valid... create the new permission */ - if (permission) - _permission_set_stale(permission, PERM_TYPE_USER, g_strndup(str, ulen)); - return TRUE; - -invalid: - if (permission) - _permission_set_stale(permission, PERM_TYPE_INVALID, g_strdup(str0)); - return FALSE; -} - -static char * -_permission_to_string(Permission *permission) -{ - nm_assert(permission); - - switch (permission->ptype) { - case PERM_TYPE_USER: - return g_strdup_printf(NM_SETTINGS_CONNECTION_PERMISSION_USER_PREFIX "%s:", - permission->item); - case PERM_TYPE_INVALID: - nm_assert(permission->item); - return g_strdup(permission->item); - } - nm_assert_not_reached(); - return g_strdup(permission->item ?: ""); -} - -/*****************************************************************************/ - -/** - * nm_setting_connection_get_id: - * @setting: the #NMSettingConnection - * - * Returns the #NMSettingConnection:id property of the connection. - * - * Returns: the connection ID - **/ -const char * -nm_setting_connection_get_id(NMSettingConnection *setting) -{ - g_return_val_if_fail(NM_IS_SETTING_CONNECTION(setting), NULL); - - return NM_SETTING_CONNECTION_GET_PRIVATE(setting)->id; -} - -/** - * nm_setting_connection_get_uuid: - * @setting: the #NMSettingConnection - * - * Returns the #NMSettingConnection:uuid property of the connection. - * - * Returns: the connection UUID - **/ -const char * -nm_setting_connection_get_uuid(NMSettingConnection *setting) -{ - g_return_val_if_fail(NM_IS_SETTING_CONNECTION(setting), NULL); - - return NM_SETTING_CONNECTION_GET_PRIVATE(setting)->uuid; -} - -/** - * nm_setting_connection_get_stable_id: - * @setting: the #NMSettingConnection - * - * Returns the #NMSettingConnection:stable_id property of the connection. - * - * Returns: the stable-id for the connection - * - * Since: 1.4 - **/ -const char * -nm_setting_connection_get_stable_id(NMSettingConnection *setting) -{ - g_return_val_if_fail(NM_IS_SETTING_CONNECTION(setting), NULL); - - return NM_SETTING_CONNECTION_GET_PRIVATE(setting)->stable_id; -} - -/** - * nm_setting_connection_get_interface_name: - * @setting: the #NMSettingConnection - * - * Returns the #NMSettingConnection:interface-name property of the connection. - * - * Returns: the connection's interface name - **/ -const char * -nm_setting_connection_get_interface_name(NMSettingConnection *setting) -{ - g_return_val_if_fail(NM_IS_SETTING_CONNECTION(setting), NULL); - - return NM_SETTING_CONNECTION_GET_PRIVATE(setting)->interface_name; -} - -/** - * nm_setting_connection_get_connection_type: - * @setting: the #NMSettingConnection - * - * Returns the #NMSettingConnection:type property of the connection. - * - * Returns: the connection type - **/ -const char * -nm_setting_connection_get_connection_type(NMSettingConnection *setting) -{ - g_return_val_if_fail(NM_IS_SETTING_CONNECTION(setting), NULL); - - return NM_SETTING_CONNECTION_GET_PRIVATE(setting)->type; -} - -/** - * nm_setting_connection_get_num_permissions: - * @setting: the #NMSettingConnection - * - * Returns the number of entries in the #NMSettingConnection:permissions - * property of this setting. - * - * Returns: the number of permissions entries - */ -guint32 -nm_setting_connection_get_num_permissions(NMSettingConnection *setting) -{ - g_return_val_if_fail(NM_IS_SETTING_CONNECTION(setting), 0); - - return nm_g_array_len(NM_SETTING_CONNECTION_GET_PRIVATE(setting)->permissions); -} - -/** - * nm_setting_connection_get_permission: - * @setting: the #NMSettingConnection - * @idx: the zero-based index of the permissions entry - * @out_ptype: on return, the permission type. This is currently always "user", - * unless the entry is invalid, in which case it returns "invalid". - * @out_pitem: on return, the permission item (formatted according to @ptype, see - * #NMSettingConnection:permissions for more detail - * @out_detail: on return, the permission detail (at this time, always %NULL) - * - * Retrieve one of the entries of the #NMSettingConnection:permissions property - * of this setting. - * - * Returns: %TRUE if a permission was returned, %FALSE if @idx was invalid - */ -gboolean -nm_setting_connection_get_permission(NMSettingConnection *setting, - guint32 idx, - const char ** out_ptype, - const char ** out_pitem, - const char ** out_detail) -{ - NMSettingConnectionPrivate *priv; - Permission * permission; - - g_return_val_if_fail(NM_IS_SETTING_CONNECTION(setting), FALSE); - - priv = NM_SETTING_CONNECTION_GET_PRIVATE(setting); - - g_return_val_if_fail(idx < nm_g_array_len(priv->permissions), FALSE); - - permission = &g_array_index(priv->permissions, Permission, idx); - switch (permission->ptype) { - case PERM_TYPE_USER: - NM_SET_OUT(out_ptype, NM_SETTINGS_CONNECTION_PERMISSION_USER); - NM_SET_OUT(out_pitem, permission->item); - NM_SET_OUT(out_detail, NULL); - return TRUE; - case PERM_TYPE_INVALID: - goto invalid; - } - nm_assert_not_reached(); -invalid: - NM_SET_OUT(out_ptype, "invalid"); - NM_SET_OUT(out_pitem, permission->item); - NM_SET_OUT(out_detail, NULL); - return TRUE; -} - -/** - * nm_setting_connection_permissions_user_allowed: - * @setting: the #NMSettingConnection - * @uname: the user name to check permissions for - * - * Checks whether the given username is allowed to view/access this connection. - * - * Returns: %TRUE if the requested user is allowed to view this connection, - * %FALSE if the given user is not allowed to view this connection - */ -gboolean -nm_setting_connection_permissions_user_allowed(NMSettingConnection *setting, const char *uname) -{ - NMSettingConnectionPrivate *priv; - guint i; - - g_return_val_if_fail(NM_IS_SETTING_CONNECTION(setting), FALSE); - g_return_val_if_fail(uname != NULL, FALSE); - - priv = NM_SETTING_CONNECTION_GET_PRIVATE(setting); - - if (nm_g_array_len(priv->permissions) == 0) { - /* If no permissions, visible to all */ - return TRUE; - } - - for (i = 0; i < priv->permissions->len; i++) { - const Permission *permission = &g_array_index(priv->permissions, Permission, i); - - if (permission->ptype == PERM_TYPE_USER && nm_streq(permission->item, uname)) - return TRUE; - } - - return FALSE; -} - -/** - * nm_setting_connection_add_permission: - * @setting: the #NMSettingConnection - * @ptype: the permission type; at this time only "user" is supported - * @pitem: the permission item formatted as required for @ptype - * @detail: (allow-none): unused at this time; must be %NULL - * - * Adds a permission to the connection's permission list. At this time, only - * the "user" permission type is supported, and @pitem must be a username. See - * #NMSettingConnection:permissions: for more details. - * - * Returns: %TRUE if the permission was unique and was successfully added to the - * list, %FALSE if @ptype or @pitem was invalid. - * If the permission was already present in the list, it will not be added - * a second time but %TRUE will be returned. Note that before 1.28, in this - * case %FALSE would be returned. - */ -gboolean -nm_setting_connection_add_permission(NMSettingConnection *setting, - const char * ptype, - const char * pitem, - const char * detail) -{ - NMSettingConnectionPrivate *priv; - guint i; - - g_return_val_if_fail(NM_IS_SETTING_CONNECTION(setting), FALSE); - g_return_val_if_fail(ptype, FALSE); - g_return_val_if_fail(pitem, FALSE); - - if (!nm_streq0(ptype, NM_SETTINGS_CONNECTION_PERMISSION_USER)) - return FALSE; - - if (!nm_settings_connection_validate_permission_user(pitem, -1)) - return FALSE; - - if (detail) - return FALSE; - - priv = NM_SETTING_CONNECTION_GET_PRIVATE(setting); - - if (!priv->permissions) { - priv->permissions = g_array_sized_new(FALSE, FALSE, sizeof(Permission), 1); - g_array_set_clear_func(priv->permissions, (GDestroyNotify) _permission_clear_stale); - } - - for (i = 0; i < priv->permissions->len; i++) { - const Permission *permission = &g_array_index(priv->permissions, Permission, i); - - if (permission->ptype == PERM_TYPE_USER && nm_streq(permission->item, pitem)) - return TRUE; - } - - _permission_set_stale(nm_g_array_append_new(priv->permissions, Permission), - PERM_TYPE_USER, - g_strdup(pitem)); - _notify(setting, PROP_PERMISSIONS); - return TRUE; -} - -/** - * nm_setting_connection_remove_permission: - * @setting: the #NMSettingConnection - * @idx: the zero-based index of the permission to remove - * - * Removes the permission at index @idx from the connection. - */ -void -nm_setting_connection_remove_permission(NMSettingConnection *setting, guint32 idx) -{ - NMSettingConnectionPrivate *priv; - - g_return_if_fail(NM_IS_SETTING_CONNECTION(setting)); - - priv = NM_SETTING_CONNECTION_GET_PRIVATE(setting); - - g_return_if_fail(idx < nm_g_array_len(priv->permissions)); - - g_array_remove_index(priv->permissions, idx); - - _notify(setting, PROP_PERMISSIONS); -} - -/** - * nm_setting_connection_remove_permission_by_value: - * @setting: the #NMSettingConnection - * @ptype: the permission type; at this time only "user" is supported - * @pitem: the permission item formatted as required for @ptype - * @detail: (allow-none): unused at this time; must be %NULL - * - * Removes the permission from the connection. - * At this time, only the "user" permission type is supported, and @pitem must - * be a username. See #NMSettingConnection:permissions: for more details. - * - * Returns: %TRUE if the permission was found and removed; %FALSE if it was not. - */ -gboolean -nm_setting_connection_remove_permission_by_value(NMSettingConnection *setting, - const char * ptype, - const char * pitem, - const char * detail) -{ - NMSettingConnectionPrivate *priv; - guint i; - - g_return_val_if_fail(NM_IS_SETTING_CONNECTION(setting), FALSE); - g_return_val_if_fail(ptype, FALSE); - g_return_val_if_fail(pitem, FALSE); - - if (!nm_streq0(ptype, NM_SETTINGS_CONNECTION_PERMISSION_USER)) - return FALSE; - - if (detail) - return FALSE; - - priv = NM_SETTING_CONNECTION_GET_PRIVATE(setting); - if (priv->permissions) { - for (i = 0; i < priv->permissions->len; i++) { - const Permission *permission = &g_array_index(priv->permissions, Permission, i); - - if (permission->ptype == PERM_TYPE_USER && nm_streq(permission->item, pitem)) { - g_array_remove_index(priv->permissions, i); - _notify(setting, PROP_PERMISSIONS); - return TRUE; - } - } - } - return FALSE; -} - -/** - * nm_setting_connection_get_autoconnect: - * @setting: the #NMSettingConnection - * - * Returns the #NMSettingConnection:autoconnect property of the connection. - * - * Returns: the connection's autoconnect behavior - **/ -gboolean -nm_setting_connection_get_autoconnect(NMSettingConnection *setting) -{ - g_return_val_if_fail(NM_IS_SETTING_CONNECTION(setting), FALSE); - - return NM_SETTING_CONNECTION_GET_PRIVATE(setting)->autoconnect; -} - -/** - * nm_setting_connection_get_autoconnect_priority: - * @setting: the #NMSettingConnection - * - * Returns the #NMSettingConnection:autoconnect-priority property of the connection. - * The higher number, the higher priority. - * - * Returns: the connection's autoconnect priority - **/ -int -nm_setting_connection_get_autoconnect_priority(NMSettingConnection *setting) -{ - g_return_val_if_fail(NM_IS_SETTING_CONNECTION(setting), 0); - - return NM_SETTING_CONNECTION_GET_PRIVATE(setting)->autoconnect_priority; -} - -/** - * nm_setting_connection_get_autoconnect_retries: - * @setting: the #NMSettingConnection - * - * Returns the #NMSettingConnection:autoconnect-retries property of the connection. - * Zero means infinite, -1 means the global default value. - * - * Returns: the connection's autoconnect retries - * - * Since: 1.6 - **/ -int -nm_setting_connection_get_autoconnect_retries(NMSettingConnection *setting) -{ - g_return_val_if_fail(NM_IS_SETTING_CONNECTION(setting), -1); - - return NM_SETTING_CONNECTION_GET_PRIVATE(setting)->autoconnect_retries; -} - -/** - * nm_setting_connection_get_multi_connect: - * @setting: the #NMSettingConnection - * - * Returns: the #NMSettingConnection:multi-connect property of the connection. - * - * Since: 1.14 - **/ -NMConnectionMultiConnect -nm_setting_connection_get_multi_connect(NMSettingConnection *setting) -{ - g_return_val_if_fail(NM_IS_SETTING_CONNECTION(setting), -1); - - return (NMConnectionMultiConnect) NM_SETTING_CONNECTION_GET_PRIVATE(setting)->multi_connect; -} - -/** - * nm_setting_connection_get_auth_retries: - * @setting: the #NMSettingConnection - * - * Returns the value contained in the #NMSettingConnection:auth-retries property. - * - * Returns: the configured authentication retries. Zero means - * infinity and -1 means a global default value. - * - * Since: 1.10 - **/ -int -nm_setting_connection_get_auth_retries(NMSettingConnection *setting) -{ - g_return_val_if_fail(NM_IS_SETTING_CONNECTION(setting), -1); - - return NM_SETTING_CONNECTION_GET_PRIVATE(setting)->auth_retries; -} - -/** - * nm_setting_connection_get_timestamp: - * @setting: the #NMSettingConnection - * - * Returns the #NMSettingConnection:timestamp property of the connection. - * - * Returns: the connection's timestamp - **/ -guint64 -nm_setting_connection_get_timestamp(NMSettingConnection *setting) -{ - g_return_val_if_fail(NM_IS_SETTING_CONNECTION(setting), 0); - - return NM_SETTING_CONNECTION_GET_PRIVATE(setting)->timestamp; -} - -static GVariant * -_to_dbus_fcn_timestamp(const NMSettInfoSetting * sett_info, - guint property_idx, - NMConnection * connection, - NMSetting * setting, - NMConnectionSerializationFlags flags, - const NMConnectionSerializationOptions *options) -{ - guint64 v; - - v = options && options->timestamp.has ? options->timestamp.val - : NM_SETTING_CONNECTION_GET_PRIVATE(setting)->timestamp; - - if (v == 0u) - return NULL; - - return g_variant_new_uint64(v); -} - -/** - * nm_setting_connection_get_read_only: - * @setting: the #NMSettingConnection - * - * Returns the #NMSettingConnection:read-only property of the connection. - * - * Returns: %TRUE if the connection is read-only, %FALSE if it is not - **/ -gboolean -nm_setting_connection_get_read_only(NMSettingConnection *setting) -{ - g_return_val_if_fail(NM_IS_SETTING_CONNECTION(setting), TRUE); - - return NM_SETTING_CONNECTION_GET_PRIVATE(setting)->read_only; -} - -/** - * nm_setting_connection_get_zone: - * @setting: the #NMSettingConnection - * - * Returns the #NMSettingConnection:zone property of the connection. - * - * Returns: the trust level of a connection - **/ -const char * -nm_setting_connection_get_zone(NMSettingConnection *setting) -{ - g_return_val_if_fail(NM_IS_SETTING_CONNECTION(setting), NULL); - - return NM_SETTING_CONNECTION_GET_PRIVATE(setting)->zone; -} - -/** - * nm_setting_connection_get_master: - * @setting: the #NMSettingConnection - * - * Returns the #NMSettingConnection:master property of the connection. - * - * Returns: interface name of the master device or UUID of the master - * connection. - */ -const char * -nm_setting_connection_get_master(NMSettingConnection *setting) -{ - g_return_val_if_fail(NM_IS_SETTING_CONNECTION(setting), NULL); - - return NM_SETTING_CONNECTION_GET_PRIVATE(setting)->master; -} - -/** - * nm_setting_connection_get_slave_type: - * @setting: the #NMSettingConnection - * - * Returns the #NMSettingConnection:slave-type property of the connection. - * - * Returns: the type of slave this connection is, if any - */ -const char * -nm_setting_connection_get_slave_type(NMSettingConnection *setting) -{ - g_return_val_if_fail(NM_IS_SETTING_CONNECTION(setting), NULL); - - return NM_SETTING_CONNECTION_GET_PRIVATE(setting)->slave_type; -} - -/** - * nm_setting_connection_is_slave_type: - * @setting: the #NMSettingConnection - * @type: the setting name (ie #NM_SETTING_BOND_SETTING_NAME) to be matched - * against @setting's slave type - * - * Returns: %TRUE if connection is of the given slave @type - */ -gboolean -nm_setting_connection_is_slave_type(NMSettingConnection *setting, const char *type) -{ - g_return_val_if_fail(NM_IS_SETTING_CONNECTION(setting), FALSE); - - return !g_strcmp0(NM_SETTING_CONNECTION_GET_PRIVATE(setting)->slave_type, type); -} - -/** - * nm_setting_connection_get_wait_device_timeout: - * @setting: the #NMSettingConnection - * - * Returns: the %NM_SETTING_CONNECTION_WAIT_DEVICE_TIMEOUT property with - * the timeout in milliseconds. -1 is the default. - * - * Since: 1.20 - */ -gint32 -nm_setting_connection_get_wait_device_timeout(NMSettingConnection *setting) -{ - g_return_val_if_fail(NM_IS_SETTING_CONNECTION(setting), -1); - - return NM_SETTING_CONNECTION_GET_PRIVATE(setting)->wait_device_timeout; -} - -/** - * nm_setting_connection_get_autoconnect_slaves: - * @setting: the #NMSettingConnection - * - * Returns the #NMSettingConnection:autoconnect-slaves property of the connection. - * - * Returns: whether slaves of the connection should be activated together - * with the connection. - * - * Since: 1.2 - **/ -NMSettingConnectionAutoconnectSlaves -nm_setting_connection_get_autoconnect_slaves(NMSettingConnection *setting) -{ - g_return_val_if_fail(NM_IS_SETTING_CONNECTION(setting), - NM_SETTING_CONNECTION_AUTOCONNECT_SLAVES_DEFAULT); - - return NM_SETTING_CONNECTION_GET_PRIVATE(setting)->autoconnect_slaves; -} - -/** - * nm_setting_connection_get_num_secondaries: - * @setting: the #NMSettingConnection - * - * Returns: the number of configured secondary connection UUIDs - **/ -guint32 -nm_setting_connection_get_num_secondaries(NMSettingConnection *setting) -{ - g_return_val_if_fail(NM_IS_SETTING_CONNECTION(setting), 0); - - return g_slist_length(NM_SETTING_CONNECTION_GET_PRIVATE(setting)->secondaries); -} - -/** - * nm_setting_connection_get_secondary: - * @setting: the #NMSettingConnection - * @idx: the zero-based index of the secondary connection UUID entry - * - * Returns: the secondary connection UUID at index @idx - **/ -const char * -nm_setting_connection_get_secondary(NMSettingConnection *setting, guint32 idx) -{ - NMSettingConnectionPrivate *priv; - - g_return_val_if_fail(NM_IS_SETTING_CONNECTION(setting), NULL); - - priv = NM_SETTING_CONNECTION_GET_PRIVATE(setting); - g_return_val_if_fail(idx <= g_slist_length(priv->secondaries), NULL); - - return (const char *) g_slist_nth_data(priv->secondaries, idx); -} - -/** - * nm_setting_connection_get_mud_url: - * @setting: the #NMSettingConnection - * - * Returns the value contained in the #NMSettingConnection:mud-url - * property. - * - * Since: 1.26 - **/ -const char * -nm_setting_connection_get_mud_url(NMSettingConnection *setting) -{ - g_return_val_if_fail(NM_IS_SETTING_CONNECTION(setting), NULL); - - return NM_SETTING_CONNECTION_GET_PRIVATE(setting)->mud_url; -} - -/** - * nm_setting_connection_add_secondary: - * @setting: the #NMSettingConnection - * @sec_uuid: the secondary connection UUID to add - * - * Adds a new secondary connection UUID to the setting. - * - * Returns: %TRUE if the secondary connection UUID was added; %FALSE if the UUID - * was already present - **/ -gboolean -nm_setting_connection_add_secondary(NMSettingConnection *setting, const char *sec_uuid) -{ - NMSettingConnectionPrivate *priv; - GSList * iter; - - g_return_val_if_fail(NM_IS_SETTING_CONNECTION(setting), FALSE); - g_return_val_if_fail(sec_uuid != NULL, FALSE); - g_return_val_if_fail(sec_uuid[0] != '\0', FALSE); - - priv = NM_SETTING_CONNECTION_GET_PRIVATE(setting); - for (iter = priv->secondaries; iter; iter = g_slist_next(iter)) { - if (!strcmp(sec_uuid, (char *) iter->data)) - return FALSE; - } - - priv->secondaries = g_slist_append(priv->secondaries, g_strdup(sec_uuid)); - _notify(setting, PROP_SECONDARIES); - return TRUE; -} - -/** - * nm_setting_connection_remove_secondary: - * @setting: the #NMSettingConnection - * @idx: index number of the secondary connection UUID - * - * Removes the secondary connection UUID at index @idx. - **/ -void -nm_setting_connection_remove_secondary(NMSettingConnection *setting, guint32 idx) -{ - NMSettingConnectionPrivate *priv; - GSList * elt; - - g_return_if_fail(NM_IS_SETTING_CONNECTION(setting)); - - priv = NM_SETTING_CONNECTION_GET_PRIVATE(setting); - elt = g_slist_nth(priv->secondaries, idx); - g_return_if_fail(elt != NULL); - - g_free(elt->data); - priv->secondaries = g_slist_delete_link(priv->secondaries, elt); - _notify(setting, PROP_SECONDARIES); -} - -/** - * nm_setting_connection_remove_secondary_by_value: - * @setting: the #NMSettingConnection - * @sec_uuid: the secondary connection UUID to remove - * - * Removes the secondary connection UUID @sec_uuid. - * - * Returns: %TRUE if the secondary connection UUID was found and removed; %FALSE if it was not. - **/ -gboolean -nm_setting_connection_remove_secondary_by_value(NMSettingConnection *setting, const char *sec_uuid) -{ - NMSettingConnectionPrivate *priv; - GSList * iter; - - g_return_val_if_fail(NM_IS_SETTING_CONNECTION(setting), FALSE); - g_return_val_if_fail(sec_uuid != NULL, FALSE); - g_return_val_if_fail(sec_uuid[0] != '\0', FALSE); - - priv = NM_SETTING_CONNECTION_GET_PRIVATE(setting); - for (iter = priv->secondaries; iter; iter = g_slist_next(iter)) { - if (!strcmp(sec_uuid, (char *) iter->data)) { - priv->secondaries = g_slist_delete_link(priv->secondaries, iter); - _notify(setting, PROP_SECONDARIES); - return TRUE; - } - } - return FALSE; -} - -/** - * nm_setting_connection_get_gateway_ping_timeout: - * @setting: the #NMSettingConnection - * - * Returns: the value contained in the #NMSettingConnection:gateway-ping-timeout - * property. - **/ -guint32 -nm_setting_connection_get_gateway_ping_timeout(NMSettingConnection *setting) -{ - g_return_val_if_fail(NM_IS_SETTING_CONNECTION(setting), 0); - - return NM_SETTING_CONNECTION_GET_PRIVATE(setting)->gateway_ping_timeout; -} - -/** - * nm_setting_connection_get_metered: - * @setting: the #NMSettingConnection - * - * Returns: the #NMSettingConnection:metered property of the setting. - * - * Since: 1.2 - **/ -NMMetered -nm_setting_connection_get_metered(NMSettingConnection *setting) -{ - g_return_val_if_fail(NM_IS_SETTING_CONNECTION(setting), NM_METERED_UNKNOWN); - - return NM_SETTING_CONNECTION_GET_PRIVATE(setting)->metered; -} - -/** - * nm_setting_connection_get_lldp: - * @setting: the #NMSettingConnection - * - * Returns the #NMSettingConnection:lldp property of the connection. - * - * Returns: a %NMSettingConnectionLldp which indicates whether LLDP must be - * enabled for the connection. - * - * Since: 1.2 - **/ -NMSettingConnectionLldp -nm_setting_connection_get_lldp(NMSettingConnection *setting) -{ - g_return_val_if_fail(NM_IS_SETTING_CONNECTION(setting), NM_SETTING_CONNECTION_LLDP_DEFAULT); - - return NM_SETTING_CONNECTION_GET_PRIVATE(setting)->lldp; -} - -/** - * nm_setting_connection_get_mdns: - * @setting: the #NMSettingConnection - * - * Returns: the #NMSettingConnection:mdns property of the setting. - * - * Since: 1.12 - **/ -NMSettingConnectionMdns -nm_setting_connection_get_mdns(NMSettingConnection *setting) -{ - g_return_val_if_fail(NM_IS_SETTING_CONNECTION(setting), NM_SETTING_CONNECTION_MDNS_DEFAULT); - - return NM_SETTING_CONNECTION_GET_PRIVATE(setting)->mdns; -} - -/** - * nm_setting_connection_get_llmnr: - * @setting: the #NMSettingConnection - * - * Returns: the #NMSettingConnection:llmnr property of the setting. - * - * Since: 1.14 - **/ -NMSettingConnectionLlmnr -nm_setting_connection_get_llmnr(NMSettingConnection *setting) -{ - g_return_val_if_fail(NM_IS_SETTING_CONNECTION(setting), NM_SETTING_CONNECTION_LLMNR_DEFAULT); - - return NM_SETTING_CONNECTION_GET_PRIVATE(setting)->llmnr; -} - -static void -_set_error_missing_base_setting(GError **error, const char *type) -{ - g_set_error(error, - NM_CONNECTION_ERROR, - NM_CONNECTION_ERROR_MISSING_SETTING, - _("setting required for connection of type '%s'"), - type); - g_prefix_error(error, "%s: ", type); -} - -gboolean -_nm_connection_detect_slave_type_full(NMSettingConnection *s_con, - NMConnection * connection, - const char ** out_slave_type, - const char ** out_normerr_slave_setting_type, - const char ** out_normerr_missing_slave_type, - const char ** out_normerr_missing_slave_type_port, - GError ** error) -{ - NMSettingConnectionPrivate *priv = NM_SETTING_CONNECTION_GET_PRIVATE(s_con); - gboolean is_slave; - const char * slave_setting_type; - const char * slave_type; - const char * normerr_slave_setting_type = NULL; - const char * normerr_missing_slave_type = NULL; - const char * normerr_missing_slave_type_port = NULL; - - is_slave = FALSE; - slave_setting_type = NULL; - slave_type = priv->slave_type; - if (slave_type) { - is_slave = _nm_setting_slave_type_is_valid(slave_type, &slave_setting_type); - if (!is_slave) { - g_set_error(error, - NM_CONNECTION_ERROR, - NM_CONNECTION_ERROR_INVALID_PROPERTY, - _("Unknown slave type '%s'"), - slave_type); - g_prefix_error(error, - "%s.%s: ", - NM_SETTING_CONNECTION_SETTING_NAME, - NM_SETTING_CONNECTION_SLAVE_TYPE); - return FALSE; - } - } - - if (is_slave) { - if (!priv->master) { - g_set_error(error, - NM_CONNECTION_ERROR, - NM_CONNECTION_ERROR_MISSING_PROPERTY, - _("Slave connections need a valid '%s' property"), - NM_SETTING_CONNECTION_MASTER); - g_prefix_error(error, - "%s.%s: ", - NM_SETTING_CONNECTION_SETTING_NAME, - NM_SETTING_CONNECTION_MASTER); - return FALSE; - } - if (slave_setting_type && connection - && !nm_connection_get_setting_by_name(connection, slave_setting_type)) - normerr_slave_setting_type = slave_setting_type; - } else { - nm_assert(!slave_type); - if (priv->master) { - NMSetting *s_port; - - if (connection - && (slave_type = _nm_connection_detect_slave_type(connection, &s_port))) { - normerr_missing_slave_type = slave_type; - normerr_missing_slave_type_port = nm_setting_get_name(s_port); - } else { - g_set_error(error, - NM_CONNECTION_ERROR, - NM_CONNECTION_ERROR_MISSING_PROPERTY, - _("Cannot set '%s' without '%s'"), - NM_SETTING_CONNECTION_MASTER, - NM_SETTING_CONNECTION_SLAVE_TYPE); - g_prefix_error(error, - "%s.%s: ", - NM_SETTING_CONNECTION_SETTING_NAME, - NM_SETTING_CONNECTION_SLAVE_TYPE); - return FALSE; - } - } - } - - NM_SET_OUT(out_slave_type, slave_type); - NM_SET_OUT(out_normerr_slave_setting_type, normerr_slave_setting_type); - NM_SET_OUT(out_normerr_missing_slave_type, normerr_missing_slave_type); - NM_SET_OUT(out_normerr_missing_slave_type_port, normerr_missing_slave_type_port); - return TRUE; -} - -static gboolean -verify(NMSetting *setting, NMConnection *connection, GError **error) -{ - NMSettingConnection * self = NM_SETTING_CONNECTION(setting); - NMSettingConnectionPrivate *priv = NM_SETTING_CONNECTION_GET_PRIVATE(self); - NMSetting * normerr_base_type = NULL; - const char * type; - const char * slave_type; - const char * normerr_slave_setting_type = NULL; - const char * normerr_missing_slave_type = NULL; - const char * normerr_missing_slave_type_port = NULL; - gboolean normerr_base_setting = FALSE; - - if (!priv->id) { - g_set_error_literal(error, - NM_CONNECTION_ERROR, - NM_CONNECTION_ERROR_MISSING_PROPERTY, - _("property is missing")); - g_prefix_error(error, - "%s.%s: ", - NM_SETTING_CONNECTION_SETTING_NAME, - NM_SETTING_CONNECTION_ID); - return FALSE; - } else if (!priv->id[0]) { - g_set_error_literal(error, - NM_CONNECTION_ERROR, - NM_CONNECTION_ERROR_INVALID_PROPERTY, - _("property is empty")); - g_prefix_error(error, - "%s.%s: ", - NM_SETTING_CONNECTION_SETTING_NAME, - NM_SETTING_CONNECTION_ID); - return FALSE; - } - - if (priv->uuid && !nm_utils_is_uuid(priv->uuid)) { - g_set_error(error, - NM_CONNECTION_ERROR, - NM_CONNECTION_ERROR_INVALID_PROPERTY, - _("'%s' is not a valid UUID"), - priv->uuid); - g_prefix_error(error, - "%s.%s: ", - NM_SETTING_CONNECTION_SETTING_NAME, - NM_SETTING_CONNECTION_UUID); - return FALSE; - } - - type = priv->type; - if (!type) { - if (!connection - || !(normerr_base_type = _nm_connection_find_base_type_setting(connection))) { - g_set_error_literal(error, - NM_CONNECTION_ERROR, - NM_CONNECTION_ERROR_MISSING_PROPERTY, - _("property is missing")); - g_prefix_error(error, - "%s.%s: ", - NM_SETTING_CONNECTION_SETTING_NAME, - NM_SETTING_CONNECTION_TYPE); - return FALSE; - } - type = nm_setting_get_name(normerr_base_type); - } else { - GType base_type; - - if (!type[0]) { - g_set_error_literal(error, - NM_CONNECTION_ERROR, - NM_CONNECTION_ERROR_INVALID_PROPERTY, - _("property is empty")); - g_prefix_error(error, - "%s.%s: ", - NM_SETTING_CONNECTION_SETTING_NAME, - NM_SETTING_CONNECTION_TYPE); - return FALSE; - } - - base_type = nm_setting_lookup_type(type); - if (base_type == G_TYPE_INVALID - || _nm_setting_type_get_base_type_priority(base_type) == NM_SETTING_PRIORITY_INVALID) { - g_set_error(error, - NM_CONNECTION_ERROR, - NM_CONNECTION_ERROR_INVALID_PROPERTY, - _("connection type '%s' is not valid"), - type); - g_prefix_error(error, - "%s.%s: ", - NM_SETTING_CONNECTION_SETTING_NAME, - NM_SETTING_CONNECTION_TYPE); - return FALSE; - } - - /* Make sure the corresponding 'type' item is present */ - if (connection && !nm_connection_get_setting_by_name(connection, type)) { - NMSetting * s_base; - NMConnection *connection2; - - s_base = g_object_new(base_type, NULL); - connection2 = nm_simple_connection_new_clone(connection); - nm_connection_add_setting(connection2, s_base); - - normerr_base_setting = nm_setting_verify(s_base, connection2, NULL); - - g_object_unref(connection2); - - if (!normerr_base_setting) { - _set_error_missing_base_setting(error, type); - return FALSE; - } - } - } - - if (priv->interface_name) { - GError * tmp_error = NULL; - NMUtilsIfaceType iface_type; - - if (NM_IN_STRSET(type, - NM_SETTING_OVS_BRIDGE_SETTING_NAME, - NM_SETTING_OVS_PORT_SETTING_NAME)) - iface_type = NMU_IFACE_OVS; - else if (nm_streq(type, NM_SETTING_OVS_INTERFACE_SETTING_NAME)) { - NMSettingOvsInterface *s_ovs_iface = NULL; - const char * ovs_iface_type; - - if (connection) - s_ovs_iface = nm_connection_get_setting_ovs_interface(connection); - _nm_setting_ovs_interface_verify_interface_type( - s_ovs_iface, - s_ovs_iface ? nm_setting_ovs_interface_get_interface_type(s_ovs_iface) : NULL, - connection, - FALSE, - NULL, - &ovs_iface_type, - NULL); - if (!ovs_iface_type) { - /* We cannot determine to OVS interface type. Consequently, we cannot - * fully validate the interface name. - * - * If we have a connection (and we do a full validation anyway), skip the - * check. The connection will fail validation when we validate the OVS setting. - * - * Otherwise, do the most basic validation. - */ - if (connection) - goto after_interface_name; - iface_type = NMU_IFACE_ANY; - } else if (NM_IN_STRSET(ovs_iface_type, "patch")) { - /* this interface type is internal to OVS. */ - iface_type = NMU_IFACE_OVS; - } else { - /* This interface type also requires a netdev. We need to validate - * for both OVS and KERNEL. */ - nm_assert(NM_IN_STRSET(ovs_iface_type, "internal", "system", "dpdk")); - iface_type = NMU_IFACE_OVS_AND_KERNEL; - } - } else - iface_type = NMU_IFACE_KERNEL; - - if (!nm_utils_ifname_valid(priv->interface_name, iface_type, &tmp_error)) { - g_set_error(error, - NM_CONNECTION_ERROR, - NM_CONNECTION_ERROR_INVALID_PROPERTY, - "'%s': %s", - priv->interface_name, - tmp_error->message); - g_prefix_error(error, - "%s.%s: ", - NM_SETTING_CONNECTION_SETTING_NAME, - NM_SETTING_CONNECTION_INTERFACE_NAME); - g_error_free(tmp_error); - return FALSE; - } - } -after_interface_name: - - if (!_nm_connection_detect_slave_type_full(self, - connection, - &slave_type, - &normerr_slave_setting_type, - &normerr_missing_slave_type, - &normerr_missing_slave_type_port, - error)) - return FALSE; - - if (nm_streq(type, NM_SETTING_OVS_PORT_SETTING_NAME) && slave_type - && !nm_streq(slave_type, NM_SETTING_OVS_BRIDGE_SETTING_NAME)) { - g_set_error(error, - NM_CONNECTION_ERROR, - NM_CONNECTION_ERROR_MISSING_PROPERTY, - _("'%s' connections must be enslaved to '%s', not '%s'"), - NM_SETTING_OVS_PORT_SETTING_NAME, - NM_SETTING_OVS_BRIDGE_SETTING_NAME, - slave_type); - g_prefix_error(error, - "%s.%s: ", - NM_SETTING_CONNECTION_SETTING_NAME, - NM_SETTING_CONNECTION_SLAVE_TYPE); - return FALSE; - } - - if (priv->metered != NM_METERED_UNKNOWN && priv->metered != NM_METERED_YES - && priv->metered != NM_METERED_NO) { - g_set_error(error, - NM_CONNECTION_ERROR, - NM_CONNECTION_ERROR_INVALID_PROPERTY, - _("metered value %d is not valid"), - priv->metered); - g_prefix_error(error, - "%s.%s: ", - NM_SETTING_CONNECTION_SETTING_NAME, - NM_SETTING_CONNECTION_METERED); - return FALSE; - } - - if (priv->mdns < (int) NM_SETTING_CONNECTION_MDNS_DEFAULT - || priv->mdns > (int) NM_SETTING_CONNECTION_MDNS_YES) { - g_set_error(error, - NM_CONNECTION_ERROR, - NM_CONNECTION_ERROR_INVALID_PROPERTY, - _("value %d is not valid"), - priv->mdns); - g_prefix_error(error, - "%s.%s: ", - NM_SETTING_CONNECTION_SETTING_NAME, - NM_SETTING_CONNECTION_MDNS); - return FALSE; - } - - if (priv->llmnr < (int) NM_SETTING_CONNECTION_LLMNR_DEFAULT - || priv->llmnr > (int) NM_SETTING_CONNECTION_LLMNR_YES) { - g_set_error(error, - NM_CONNECTION_ERROR, - NM_CONNECTION_ERROR_INVALID_PROPERTY, - _("value %d is not valid"), - priv->llmnr); - g_prefix_error(error, - "%s.%s: ", - NM_SETTING_CONNECTION_SETTING_NAME, - NM_SETTING_CONNECTION_LLMNR); - return FALSE; - } - - if (!NM_IN_SET(priv->multi_connect, - (int) NM_CONNECTION_MULTI_CONNECT_DEFAULT, - (int) NM_CONNECTION_MULTI_CONNECT_SINGLE, - (int) NM_CONNECTION_MULTI_CONNECT_MANUAL_MULTIPLE, - (int) NM_CONNECTION_MULTI_CONNECT_MULTIPLE)) { - g_set_error(error, - NM_CONNECTION_ERROR, - NM_CONNECTION_ERROR_INVALID_PROPERTY, - _("value %d is not valid"), - priv->multi_connect); - g_prefix_error(error, - "%s.%s: ", - NM_SETTING_CONNECTION_SETTING_NAME, - NM_SETTING_CONNECTION_MULTI_CONNECT); - return FALSE; - } - - if (priv->mud_url) { - if (!priv->mud_url[0]) { - g_set_error_literal(error, - NM_CONNECTION_ERROR, - NM_CONNECTION_ERROR_INVALID_PROPERTY, - _("property is empty")); - g_prefix_error(error, - "%s.%s: ", - nm_setting_get_name(setting), - NM_SETTING_CONNECTION_MUD_URL); - return FALSE; - } - if (nm_streq(priv->mud_url, NM_CONNECTION_MUD_URL_NONE)) { - /* pass */ - } else { - if (strlen(priv->mud_url) > 255) { - g_set_error_literal(error, - NM_CONNECTION_ERROR, - NM_CONNECTION_ERROR_INVALID_PROPERTY, - _("DHCP option cannot be longer than 255 characters")); - g_prefix_error(error, - "%s.%s: ", - nm_setting_get_name(setting), - NM_SETTING_CONNECTION_MUD_URL); - return FALSE; - } - if (!nm_sd_http_url_is_valid_https(priv->mud_url)) { - g_set_error_literal(error, - NM_CONNECTION_ERROR, - NM_CONNECTION_ERROR_INVALID_PROPERTY, - _("MUD URL is not a valid URL")); - g_prefix_error(error, - "%s.%s: ", - nm_setting_get_name(setting), - NM_SETTING_CONNECTION_MUD_URL); - return FALSE; - } - } - } - - if (priv->permissions) { - guint i; - - for (i = 0; i < priv->permissions->len; i++) { - const Permission *permissions = &g_array_index(priv->permissions, Permission, i); - - if (permissions->ptype != PERM_TYPE_USER) { - g_set_error_literal(error, - NM_CONNECTION_ERROR, - NM_CONNECTION_ERROR_INVALID_PROPERTY, - _("invalid permissions not in format \"user:$UNAME[:]\"")); - g_prefix_error(error, - "%s.%s: ", - nm_setting_get_name(setting), - NM_SETTING_CONNECTION_PERMISSIONS); - return FALSE; - } - nm_assert(nm_settings_connection_validate_permission_user(permissions->item, -1)); - } - } - - /* *** errors above here should be always fatal, below NORMALIZABLE_ERROR *** */ - - if (!priv->uuid) { - g_set_error_literal(error, - NM_CONNECTION_ERROR, - NM_CONNECTION_ERROR_MISSING_PROPERTY, - _("property is missing")); - g_prefix_error(error, - "%s.%s: ", - NM_SETTING_CONNECTION_SETTING_NAME, - NM_SETTING_CONNECTION_UUID); - return NM_SETTING_VERIFY_NORMALIZABLE_ERROR; - } - - if (normerr_base_type) { - g_set_error(error, - NM_CONNECTION_ERROR, - NM_CONNECTION_ERROR_MISSING_PROPERTY, - _("property type should be set to '%s'"), - nm_setting_get_name(normerr_base_type)); - g_prefix_error(error, - "%s.%s: ", - NM_SETTING_CONNECTION_SETTING_NAME, - NM_SETTING_CONNECTION_TYPE); - return NM_SETTING_VERIFY_NORMALIZABLE_ERROR; - } - - if (normerr_base_setting) { - _set_error_missing_base_setting(error, priv->type); - return NM_SETTING_VERIFY_NORMALIZABLE_ERROR; - } - - if (normerr_slave_setting_type) { - g_set_error(error, - NM_CONNECTION_ERROR, - NM_CONNECTION_ERROR_MISSING_SETTING, - _("slave-type '%s' requires a '%s' setting in the connection"), - priv->slave_type, - normerr_slave_setting_type); - g_prefix_error(error, "%s: ", normerr_slave_setting_type); - return NM_SETTING_VERIFY_NORMALIZABLE_ERROR; - } - - if (normerr_missing_slave_type) { - g_set_error(error, - NM_CONNECTION_ERROR, - NM_CONNECTION_ERROR_MISSING_PROPERTY, - _("Detect a slave connection with '%s' set and a port type '%s'. '%s' should " - "be set to '%s'"), - NM_SETTING_CONNECTION_MASTER, - normerr_missing_slave_type_port, - NM_SETTING_CONNECTION_SLAVE_TYPE, - normerr_missing_slave_type); - g_prefix_error(error, - "%s.%s: ", - NM_SETTING_CONNECTION_SETTING_NAME, - NM_SETTING_CONNECTION_SLAVE_TYPE); - return NM_SETTING_VERIFY_NORMALIZABLE_ERROR; - } - - if (connection) { - gboolean has_bridge_port = FALSE; - - if ((!nm_streq0(priv->slave_type, NM_SETTING_BRIDGE_SETTING_NAME) - && (has_bridge_port = - !!nm_connection_get_setting_by_name(connection, - NM_SETTING_BRIDGE_PORT_SETTING_NAME))) - || (!nm_streq0(priv->slave_type, NM_SETTING_TEAM_SETTING_NAME) - && nm_connection_get_setting_by_name(connection, - NM_SETTING_TEAM_PORT_SETTING_NAME))) { - g_set_error(error, - NM_CONNECTION_ERROR, - NM_CONNECTION_ERROR_INVALID_SETTING, - _("A slave connection with '%s' set to '%s' cannot have a '%s' setting"), - NM_SETTING_CONNECTION_SLAVE_TYPE, - priv->slave_type ?: "", - has_bridge_port ? NM_SETTING_BRIDGE_PORT_SETTING_NAME - : NM_SETTING_TEAM_PORT_SETTING_NAME); - g_prefix_error(error, - "%s.%s: ", - NM_SETTING_CONNECTION_SETTING_NAME, - NM_SETTING_CONNECTION_SLAVE_TYPE); - return NM_SETTING_VERIFY_NORMALIZABLE_ERROR; - } - } - - return TRUE; -} - -static const char * -find_virtual_interface_name(GVariant *connection_dict, GVariant **variant_to_free) -{ - GVariant * setting_dict; - const char *interface_name; - - nm_assert(variant_to_free && !*variant_to_free); - - setting_dict = g_variant_lookup_value(connection_dict, - NM_SETTING_BOND_SETTING_NAME, - NM_VARIANT_TYPE_SETTING); - if (!setting_dict) - setting_dict = g_variant_lookup_value(connection_dict, - NM_SETTING_BRIDGE_SETTING_NAME, - NM_VARIANT_TYPE_SETTING); - if (!setting_dict) - setting_dict = g_variant_lookup_value(connection_dict, - NM_SETTING_TEAM_SETTING_NAME, - NM_VARIANT_TYPE_SETTING); - if (!setting_dict) - setting_dict = g_variant_lookup_value(connection_dict, - NM_SETTING_VLAN_SETTING_NAME, - NM_VARIANT_TYPE_SETTING); - - if (!setting_dict) - return NULL; - - *variant_to_free = setting_dict; - - /* All of the deprecated virtual interface name properties were named "interface-name". */ - if (!g_variant_lookup(setting_dict, "interface-name", "&s", &interface_name)) - interface_name = NULL; - - return interface_name; -} - -static gboolean -nm_setting_connection_no_interface_name(NMSetting * setting, - GVariant * connection_dict, - const char * property, - NMSettingParseFlags parse_flags, - GError ** error) -{ - const char * virtual_interface_name; - gs_unref_variant GVariant *variant_to_free = NULL; - - virtual_interface_name = find_virtual_interface_name(connection_dict, &variant_to_free); - g_object_set(G_OBJECT(setting), - NM_SETTING_CONNECTION_INTERFACE_NAME, - virtual_interface_name, - NULL); - return TRUE; -} - -static NMTernary -compare_property(const NMSettInfoSetting *sett_info, - guint property_idx, - NMConnection * con_a, - NMSetting * set_a, - NMConnection * con_b, - NMSetting * set_b, - NMSettingCompareFlags flags) -{ - if (NM_FLAGS_HAS(flags, NM_SETTING_COMPARE_FLAG_IGNORE_ID) - && nm_streq(sett_info->property_infos[property_idx].name, NM_SETTING_CONNECTION_ID)) - return NM_TERNARY_DEFAULT; - - if (NM_FLAGS_HAS(flags, NM_SETTING_COMPARE_FLAG_IGNORE_TIMESTAMP) - && nm_streq(sett_info->property_infos[property_idx].name, NM_SETTING_CONNECTION_TIMESTAMP)) - return NM_TERNARY_DEFAULT; - - return NM_SETTING_CLASS(nm_setting_connection_parent_class) - ->compare_property(sett_info, property_idx, con_a, set_a, con_b, set_b, flags); -} - -/*****************************************************************************/ - -static void -get_property(GObject *object, guint prop_id, GValue *value, GParamSpec *pspec) -{ - NMSettingConnection * setting = NM_SETTING_CONNECTION(object); - NMSettingConnectionPrivate *priv = NM_SETTING_CONNECTION_GET_PRIVATE(setting); - - switch (prop_id) { - case PROP_ID: - g_value_set_string(value, nm_setting_connection_get_id(setting)); - break; - case PROP_UUID: - g_value_set_string(value, nm_setting_connection_get_uuid(setting)); - break; - case PROP_STABLE_ID: - g_value_set_string(value, nm_setting_connection_get_stable_id(setting)); - break; - case PROP_INTERFACE_NAME: - g_value_set_string(value, nm_setting_connection_get_interface_name(setting)); - break; - case PROP_TYPE: - g_value_set_string(value, nm_setting_connection_get_connection_type(setting)); - break; - case PROP_PERMISSIONS: - { - char **strv; - gsize i, l; - - l = nm_g_array_len(priv->permissions); - strv = g_new(char *, l + 1u); - - for (i = 0; i < l; i++) - strv[i] = _permission_to_string(&g_array_index(priv->permissions, Permission, i)); - strv[i] = NULL; - - g_value_take_boxed(value, strv); - break; - } - case PROP_AUTOCONNECT: - g_value_set_boolean(value, nm_setting_connection_get_autoconnect(setting)); - break; - case PROP_AUTOCONNECT_PRIORITY: - g_value_set_int(value, nm_setting_connection_get_autoconnect_priority(setting)); - break; - case PROP_AUTOCONNECT_RETRIES: - g_value_set_int(value, nm_setting_connection_get_autoconnect_retries(setting)); - break; - case PROP_MULTI_CONNECT: - g_value_set_int(value, priv->multi_connect); - break; - case PROP_TIMESTAMP: - g_value_set_uint64(value, nm_setting_connection_get_timestamp(setting)); - break; - case PROP_READ_ONLY: - g_value_set_boolean(value, nm_setting_connection_get_read_only(setting)); - break; - case PROP_ZONE: - g_value_set_string(value, nm_setting_connection_get_zone(setting)); - break; - case PROP_MASTER: - g_value_set_string(value, nm_setting_connection_get_master(setting)); - break; - case PROP_SLAVE_TYPE: - g_value_set_string(value, nm_setting_connection_get_slave_type(setting)); - break; - case PROP_AUTOCONNECT_SLAVES: - g_value_set_enum(value, nm_setting_connection_get_autoconnect_slaves(setting)); - break; - case PROP_SECONDARIES: - g_value_take_boxed(value, _nm_utils_slist_to_strv(priv->secondaries, TRUE)); - break; - case PROP_GATEWAY_PING_TIMEOUT: - g_value_set_uint(value, priv->gateway_ping_timeout); - break; - case PROP_METERED: - g_value_set_enum(value, priv->metered); - break; - case PROP_LLDP: - g_value_set_int(value, priv->lldp); - break; - case PROP_AUTH_RETRIES: - g_value_set_int(value, priv->auth_retries); - break; - case PROP_MDNS: - g_value_set_int(value, priv->mdns); - break; - case PROP_LLMNR: - g_value_set_int(value, priv->llmnr); - break; - case PROP_WAIT_DEVICE_TIMEOUT: - g_value_set_int(value, priv->wait_device_timeout); - break; - case PROP_MUD_URL: - g_value_set_string(value, priv->mud_url); - break; - default: - G_OBJECT_WARN_INVALID_PROPERTY_ID(object, prop_id, pspec); - break; - } -} - -static void -set_property(GObject *object, guint prop_id, const GValue *value, GParamSpec *pspec) -{ - NMSettingConnectionPrivate *priv = NM_SETTING_CONNECTION_GET_PRIVATE(object); - - switch (prop_id) { - case PROP_ID: - g_free(priv->id); - priv->id = g_value_dup_string(value); - break; - case PROP_UUID: - g_free(priv->uuid); - priv->uuid = g_value_dup_string(value); - break; - case PROP_STABLE_ID: - g_free(priv->stable_id); - priv->stable_id = g_value_dup_string(value); - break; - case PROP_INTERFACE_NAME: - g_free(priv->interface_name); - priv->interface_name = g_value_dup_string(value); - break; - case PROP_TYPE: - g_free(priv->type); - priv->type = g_value_dup_string(value); - break; - case PROP_PERMISSIONS: - { - const char *const *strv; - guint i; - - nm_clear_pointer(&priv->permissions, g_array_unref); - strv = g_value_get_boxed(value); - if (strv && strv[0]) { - priv->permissions = - g_array_sized_new(FALSE, FALSE, sizeof(Permission), NM_PTRARRAY_LEN(strv)); - g_array_set_clear_func(priv->permissions, (GDestroyNotify) _permission_clear_stale); - - for (i = 0; strv[i]; i++) { - Permission *permission = nm_g_array_append_new(priv->permissions, Permission); - - _permission_set_stale_parse(permission, strv[i]); - } - } - break; - } - case PROP_AUTOCONNECT: - priv->autoconnect = g_value_get_boolean(value); - break; - case PROP_AUTOCONNECT_PRIORITY: - priv->autoconnect_priority = g_value_get_int(value); - break; - case PROP_AUTOCONNECT_RETRIES: - priv->autoconnect_retries = g_value_get_int(value); - break; - case PROP_MULTI_CONNECT: - priv->multi_connect = g_value_get_int(value); - break; - case PROP_TIMESTAMP: - priv->timestamp = g_value_get_uint64(value); - break; - case PROP_READ_ONLY: - priv->read_only = g_value_get_boolean(value); - break; - case PROP_ZONE: - g_free(priv->zone); - priv->zone = g_value_dup_string(value); - break; - case PROP_MASTER: - g_free(priv->master); - priv->master = g_value_dup_string(value); - break; - case PROP_SLAVE_TYPE: - g_free(priv->slave_type); - priv->slave_type = g_value_dup_string(value); - break; - case PROP_AUTOCONNECT_SLAVES: - priv->autoconnect_slaves = g_value_get_enum(value); - break; - case PROP_SECONDARIES: - g_slist_free_full(priv->secondaries, g_free); - priv->secondaries = _nm_utils_strv_to_slist(g_value_get_boxed(value), TRUE); - break; - case PROP_GATEWAY_PING_TIMEOUT: - priv->gateway_ping_timeout = g_value_get_uint(value); - break; - case PROP_METERED: - priv->metered = g_value_get_enum(value); - break; - case PROP_LLDP: - priv->lldp = g_value_get_int(value); - break; - case PROP_AUTH_RETRIES: - priv->auth_retries = g_value_get_int(value); - break; - case PROP_MDNS: - priv->mdns = g_value_get_int(value); - break; - case PROP_LLMNR: - priv->llmnr = g_value_get_int(value); - break; - case PROP_WAIT_DEVICE_TIMEOUT: - priv->wait_device_timeout = g_value_get_int(value); - break; - case PROP_MUD_URL: - g_free(priv->mud_url); - priv->mud_url = g_value_dup_string(value); - break; - default: - G_OBJECT_WARN_INVALID_PROPERTY_ID(object, prop_id, pspec); - break; - } -} - -/*****************************************************************************/ - -static void -nm_setting_connection_init(NMSettingConnection *setting) -{ - NMSettingConnectionPrivate *priv = NM_SETTING_CONNECTION_GET_PRIVATE(setting); - - priv->auth_retries = -1; - priv->autoconnect = TRUE; - priv->autoconnect_priority = NM_SETTING_CONNECTION_AUTOCONNECT_PRIORITY_DEFAULT; - priv->autoconnect_retries = -1; - priv->autoconnect_slaves = NM_SETTING_CONNECTION_AUTOCONNECT_SLAVES_DEFAULT; - priv->lldp = NM_SETTING_CONNECTION_LLDP_DEFAULT; - priv->llmnr = NM_SETTING_CONNECTION_LLMNR_DEFAULT; - priv->mdns = NM_SETTING_CONNECTION_MDNS_DEFAULT; - priv->wait_device_timeout = -1; -} - -/** - * nm_setting_connection_new: - * - * Creates a new #NMSettingConnection object with default values. - * - * Returns: the new empty #NMSettingConnection object - **/ -NMSetting * -nm_setting_connection_new(void) -{ - return g_object_new(NM_TYPE_SETTING_CONNECTION, NULL); -} - -static void -finalize(GObject *object) -{ - NMSettingConnectionPrivate *priv = NM_SETTING_CONNECTION_GET_PRIVATE(object); - - g_free(priv->id); - g_free(priv->uuid); - g_free(priv->stable_id); - g_free(priv->interface_name); - g_free(priv->type); - g_free(priv->zone); - g_free(priv->master); - g_free(priv->slave_type); - g_free(priv->mud_url); - nm_clear_pointer(&priv->permissions, g_array_unref); - g_slist_free_full(priv->secondaries, g_free); - - G_OBJECT_CLASS(nm_setting_connection_parent_class)->finalize(object); -} - -static void -nm_setting_connection_class_init(NMSettingConnectionClass *klass) -{ - GObjectClass * object_class = G_OBJECT_CLASS(klass); - NMSettingClass *setting_class = NM_SETTING_CLASS(klass); - GArray * properties_override = _nm_sett_info_property_override_create_array(); - - g_type_class_add_private(klass, sizeof(NMSettingConnectionPrivate)); - - object_class->get_property = get_property; - object_class->set_property = set_property; - object_class->finalize = finalize; - - setting_class->verify = verify; - setting_class->compare_property = compare_property; - - /** - * NMSettingConnection:id: - * - * A human readable unique identifier for the connection, like "Work Wi-Fi" - * or "T-Mobile 3G". - **/ - /* ---ifcfg-rh--- - * property: id - * variable: NAME(+) - * description: User friendly name for the connection profile. - * ---end--- - */ - obj_properties[PROP_ID] = g_param_spec_string(NM_SETTING_CONNECTION_ID, - "", - "", - NULL, - G_PARAM_READWRITE | NM_SETTING_PARAM_FUZZY_IGNORE - | G_PARAM_STATIC_STRINGS); - - /** - * NMSettingConnection:uuid: - * - * A universally unique identifier for the connection, for example generated - * with libuuid. It should be assigned when the connection is created, and - * never changed as long as the connection still applies to the same - * network. For example, it should not be changed when the - * #NMSettingConnection:id property or #NMSettingIP4Config changes, but - * might need to be re-created when the Wi-Fi SSID, mobile broadband network - * provider, or #NMSettingConnection:type property changes. - * - * The UUID must be in the format "2815492f-7e56-435e-b2e9-246bd7cdc664" - * (ie, contains only hexadecimal characters and "-"). A suitable UUID may - * be generated by nm_utils_uuid_generate() or - * nm_utils_uuid_generate_from_string(). - **/ - /* ---ifcfg-rh--- - * property: uuid - * variable: UUID(+) - * description: UUID for the connection profile. When missing, NetworkManager - * creates the UUID itself (by hashing the filename). - * ---end--- - */ - obj_properties[PROP_UUID] = g_param_spec_string( - NM_SETTING_CONNECTION_UUID, - "", - "", - NULL, - G_PARAM_READWRITE | NM_SETTING_PARAM_FUZZY_IGNORE | G_PARAM_STATIC_STRINGS); - - /** - * NMSettingConnection:stable-id: - * - * This represents the identity of the connection used for various purposes. - * It allows to configure multiple profiles to share the identity. Also, - * the stable-id can contain placeholders that are substituted dynamically and - * deterministically depending on the context. - * - * The stable-id is used for generating IPv6 stable private addresses - * with ipv6.addr-gen-mode=stable-privacy. It is also used to seed the - * generated cloned MAC address for ethernet.cloned-mac-address=stable - * and wifi.cloned-mac-address=stable. It is also used as DHCP client - * identifier with ipv4.dhcp-client-id=stable and to derive the DHCP - * DUID with ipv6.dhcp-duid=stable-[llt,ll,uuid]. - * - * Note that depending on the context where it is used, other parameters are - * also seeded into the generation algorithm. For example, a per-host key - * is commonly also included, so that different systems end up generating - * different IDs. Or with ipv6.addr-gen-mode=stable-privacy, also the device's - * name is included, so that different interfaces yield different addresses. - * The per-host key is the identity of your machine and stored in /var/lib/NetworkManager/secret-key. - * - * The '$' character is treated special to perform dynamic substitutions - * at runtime. Currently, supported are "${CONNECTION}", "${DEVICE}", "${MAC}", - * "${BOOT}", "${RANDOM}". - * These effectively create unique IDs per-connection, per-device, per-boot, - * or every time. Note that "${DEVICE}" corresponds to the interface name of the - * device and "${MAC}" is the permanent MAC address of the device. - * Any unrecognized patterns following '$' are treated verbatim, however - * are reserved for future use. You are thus advised to avoid '$' or - * escape it as "$$". - * For example, set it to "${CONNECTION}-${BOOT}-${DEVICE}" to create a unique id for - * this connection that changes with every reboot and differs depending on the - * interface where the profile activates. - * - * If the value is unset, a global connection default is consulted. If the - * value is still unset, the default is similar to "${CONNECTION}" and uses - * a unique, fixed ID for the connection. - * - * Since: 1.4 - **/ - /* ---ifcfg-rh--- - * property: stable-id - * variable: STABLE_ID(+) - * description: Token to generate stable IDs. - * ---end--- - */ - obj_properties[PROP_STABLE_ID] = g_param_spec_string( - NM_SETTING_CONNECTION_STABLE_ID, - "", - "", - NULL, - G_PARAM_READWRITE | NM_SETTING_PARAM_FUZZY_IGNORE | G_PARAM_STATIC_STRINGS); - - /** - * NMSettingConnection:interface-name: - * - * The name of the network interface this connection is bound to. If not - * set, then the connection can be attached to any interface of the - * appropriate type (subject to restrictions imposed by other settings). - * - * For software devices this specifies the name of the created device. - * - * For connection types where interface names cannot easily be made - * persistent (e.g. mobile broadband or USB Ethernet), this property should - * not be used. Setting this property restricts the interfaces a connection - * can be used with, and if interface names change or are reordered the - * connection may be applied to the wrong interface. - **/ - /* ---ifcfg-rh--- - * property: interface-name - * variable: DEVICE - * description: Interface name of the device this profile is bound to. The variable - * can be left out when the profile should apply for more devices. Note that DEVICE - * can be required for some connection types. - * ---end--- - */ - obj_properties[PROP_INTERFACE_NAME] = g_param_spec_string( - NM_SETTING_CONNECTION_INTERFACE_NAME, - "", - "", - NULL, - G_PARAM_READWRITE | NM_SETTING_PARAM_INFERRABLE | G_PARAM_STATIC_STRINGS); - _nm_properties_override_gobj( - properties_override, - obj_properties[PROP_INTERFACE_NAME], - NM_SETT_INFO_PROPERT_TYPE(.dbus_type = G_VARIANT_TYPE_STRING, - .missing_from_dbus_fcn = - nm_setting_connection_no_interface_name, )); - - /** - * NMSettingConnection:type: - * - * Base type of the connection. For hardware-dependent connections, should - * contain the setting name of the hardware-type specific setting (ie, - * "802-3-ethernet" or "802-11-wireless" or "bluetooth", etc), and for - * non-hardware dependent connections like VPN or otherwise, should contain - * the setting name of that setting type (ie, "vpn" or "bridge", etc). - **/ - /* ---ifcfg-rh--- - * property: type - * variable: TYPE (DEVICETYPE, DEVICE) - * values: Ethernet, Wireless, InfiniBand, Bridge, Bond, Vlan, Team, TeamPort - * description: Base type of the connection. DEVICETYPE is used for teaming - * connections. - * example: TYPE=Ethernet; TYPE=Bond; TYPE=Bridge; DEVICETYPE=TeamPort - * ---end--- - */ - obj_properties[PROP_TYPE] = g_param_spec_string(NM_SETTING_CONNECTION_TYPE, - "", - "", - NULL, - G_PARAM_READWRITE | NM_SETTING_PARAM_INFERRABLE - | G_PARAM_STATIC_STRINGS); - - /** - * NMSettingConnection:permissions: - * - * An array of strings defining what access a given user has to this - * connection. If this is %NULL or empty, all users are allowed to access - * this connection; otherwise users are allowed if and only if they are in - * this list. When this is not empty, the connection can be active only when - * one of the specified users is logged into an active session. Each entry - * is of the form "[type]:[id]:[reserved]"; for example, "user:dcbw:blah". - * - * At this time only the "user" [type] is allowed. Any other values are - * ignored and reserved for future use. [id] is the username that this - * permission refers to, which may not contain the ":" character. Any - * [reserved] information present must be ignored and is reserved for future - * use. All of [type], [id], and [reserved] must be valid UTF-8. - */ - /* ---ifcfg-rh--- - * property: permissions - * variable: USERS(+) - * description: Restrict to certain users the access to this connection, and - * allow the connection to be active only when at least one of the - * specified users is logged into an active session. - * example: USERS="joe bob" - * ---end--- - */ - obj_properties[PROP_PERMISSIONS] = - g_param_spec_boxed(NM_SETTING_CONNECTION_PERMISSIONS, - "", - "", - G_TYPE_STRV, - G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS); - - /** - * NMSettingConnection:autoconnect: - * - * Whether or not the connection should be automatically connected by - * NetworkManager when the resources for the connection are available. - * %TRUE to automatically activate the connection, %FALSE to require manual - * intervention to activate the connection. - * - * Note that autoconnect is not implemented for VPN profiles. See - * #NMSettingConnection:secondaries as an alternative to automatically - * connect VPN profiles. - **/ - /* ---ifcfg-rh--- - * property: autoconnect - * variable: ONBOOT - * default: yes - * description: Whether the connection should be autoconnected (not only while booting). - * ---end--- - */ - obj_properties[PROP_AUTOCONNECT] = g_param_spec_boolean( - NM_SETTING_CONNECTION_AUTOCONNECT, - "", - "", - TRUE, - G_PARAM_READWRITE | NM_SETTING_PARAM_FUZZY_IGNORE | G_PARAM_STATIC_STRINGS); - - /** - * NMSettingConnection:autoconnect-priority: - * - * The autoconnect priority. If the connection is set to autoconnect, - * connections with higher priority will be preferred. Defaults to 0. - * The higher number means higher priority. - **/ - /* ---ifcfg-rh--- - * property: autoconnect-priority - * variable: AUTOCONNECT_PRIORITY(+) - * values: -999 to 999 - * default: 0 - * description: Connection priority for automatic activation. Connections with - * higher numbers are preferred when selecting profiles for automatic activation. - * example: AUTOCONNECT_PRIORITY=20 - * ---end--- - */ - obj_properties[PROP_AUTOCONNECT_PRIORITY] = g_param_spec_int( - NM_SETTING_CONNECTION_AUTOCONNECT_PRIORITY, - "", - "", - NM_SETTING_CONNECTION_AUTOCONNECT_PRIORITY_MIN, - NM_SETTING_CONNECTION_AUTOCONNECT_PRIORITY_MAX, - NM_SETTING_CONNECTION_AUTOCONNECT_PRIORITY_DEFAULT, - G_PARAM_READWRITE | NM_SETTING_PARAM_FUZZY_IGNORE | G_PARAM_STATIC_STRINGS); - - /** - * NMSettingConnection:autoconnect-retries: - * - * The number of times a connection should be tried when autoactivating before - * giving up. Zero means forever, -1 means the global default (4 times if not - * overridden). Setting this to 1 means to try activation only once before - * blocking autoconnect. Note that after a timeout, NetworkManager will try - * to autoconnect again. - */ - /* ---ifcfg-rh--- - * property: autoconnect-retries - * variable: AUTOCONNECT_RETRIES(+) - * description: The number of times a connection should be autoactivated - * before giving up and switching to the next one. - * values: -1 (use global default), 0 (forever) or a positive value - * example: AUTOCONNECT_RETRIES=1 - * ---end--- - */ - obj_properties[PROP_AUTOCONNECT_RETRIES] = g_param_spec_int( - NM_SETTING_CONNECTION_AUTOCONNECT_RETRIES, - "", - "", - -1, - G_MAXINT32, - -1, - G_PARAM_READWRITE | NM_SETTING_PARAM_FUZZY_IGNORE | G_PARAM_STATIC_STRINGS); - - /** - * NMSettingConnection:multi-connect: - * - * Specifies whether the profile can be active multiple times at a particular - * moment. The value is of type #NMConnectionMultiConnect. - * - * Since: 1.14 - */ - /* ---ifcfg-rh--- - * property: multi-connect - * variable: MULTI_CONNECT(+) - * description: whether the profile can be active on multiple devices at a given - * moment. The values are numbers corresponding to #NMConnectionMultiConnect enum. - * example: MULTI_CONNECT=3 - * ---end--- - */ - obj_properties[PROP_MULTI_CONNECT] = g_param_spec_int( - NM_SETTING_CONNECTION_MULTI_CONNECT, - "", - "", - G_MININT32, - G_MAXINT32, - NM_CONNECTION_MULTI_CONNECT_DEFAULT, - G_PARAM_READWRITE | NM_SETTING_PARAM_FUZZY_IGNORE | G_PARAM_STATIC_STRINGS); - - /** - * NMSettingConnection:timestamp: - * - * The time, in seconds since the Unix Epoch, that the connection was last - * _successfully_ fully activated. - * - * NetworkManager updates the connection timestamp periodically when the - * connection is active to ensure that an active connection has the latest - * timestamp. The property is only meant for reading (changes to this - * property will not be preserved). - **/ - obj_properties[PROP_TIMESTAMP] = g_param_spec_uint64( - NM_SETTING_CONNECTION_TIMESTAMP, - "", - "", - 0, - G_MAXUINT64, - 0, - G_PARAM_READWRITE | NM_SETTING_PARAM_FUZZY_IGNORE | G_PARAM_STATIC_STRINGS); - _nm_properties_override_gobj( - properties_override, - obj_properties[PROP_TIMESTAMP], - NM_SETT_INFO_PROPERT_TYPE(.dbus_type = G_VARIANT_TYPE_UINT64, - .to_dbus_fcn = _to_dbus_fcn_timestamp, )); - - /** - * NMSettingConnection:read-only: - * - * %FALSE if the connection can be modified using the provided settings - * service's D-Bus interface with the right privileges, or %TRUE if the - * connection is read-only and cannot be modified. - **/ - obj_properties[PROP_READ_ONLY] = g_param_spec_boolean( - NM_SETTING_CONNECTION_READ_ONLY, - "", - "", - FALSE, - G_PARAM_READWRITE | NM_SETTING_PARAM_FUZZY_IGNORE | G_PARAM_STATIC_STRINGS); - - /** - * NMSettingConnection:zone: - * - * The trust level of a the connection. Free form case-insensitive string - * (for example "Home", "Work", "Public"). %NULL or unspecified zone means - * the connection will be placed in the default zone as defined by the - * firewall. - * - * When updating this property on a currently activated connection, - * the change takes effect immediately. - **/ - /* ---ifcfg-rh--- - * property: zone - * variable: ZONE(+) - * description: Trust level of this connection. The string is usually used - * for a firewall. - * example: ZONE=Work - * ---end--- - */ - obj_properties[PROP_ZONE] = - g_param_spec_string(NM_SETTING_CONNECTION_ZONE, - "", - "", - NULL, - G_PARAM_READWRITE | NM_SETTING_PARAM_FUZZY_IGNORE - | NM_SETTING_PARAM_REAPPLY_IMMEDIATELY | G_PARAM_STATIC_STRINGS); - - /** - * NMSettingConnection:master: - * - * Interface name of the master device or UUID of the master connection. - **/ - /* ---ifcfg-rh--- - * property: master - * variable: MASTER, MASTER_UUID, TEAM_MASTER, TEAM_MASTER_UUID, BRIDGE, BRIDGE_UUID - * description: Reference to master connection. The variable used depends on - * the connection type and the value. In general, if the *_UUID variant is present, - * the variant without *_UUID is ignored. NetworkManager attempts to write both - * for compatibility with legacy tooling. - * ---end--- - */ - obj_properties[PROP_MASTER] = - g_param_spec_string(NM_SETTING_CONNECTION_MASTER, - "", - "", - NULL, - G_PARAM_READWRITE | NM_SETTING_PARAM_FUZZY_IGNORE - | NM_SETTING_PARAM_INFERRABLE | G_PARAM_STATIC_STRINGS); - - /** - * NMSettingConnection:slave-type: - * - * Setting name of the device type of this slave's master connection (eg, - * %NM_SETTING_BOND_SETTING_NAME), or %NULL if this connection is not a - * slave. - **/ - /* ---ifcfg-rh--- - * property: slave-type - * variable: MASTER, MASTER_UUID, TEAM_MASTER, TEAM_MASTER_UUID, DEVICETYPE, - * BRIDGE, BRIDGE_UUID - * description: Slave type doesn't map directly to a variable, but it is - * recognized using different variables. MASTER and MASTER_UUID for bonding, - * TEAM_MASTER, TEAM_MASTER_UUID and DEVICETYPE for teaming, BRIDGE - * and BRIDGE_UUID for bridging. - * ---end--- - */ - obj_properties[PROP_SLAVE_TYPE] = - g_param_spec_string(NM_SETTING_CONNECTION_SLAVE_TYPE, - "", - "", - NULL, - G_PARAM_READWRITE | NM_SETTING_PARAM_FUZZY_IGNORE - | NM_SETTING_PARAM_INFERRABLE | G_PARAM_STATIC_STRINGS); - - /** - * NMSettingConnection:autoconnect-slaves: - * - * Whether or not slaves of this connection should be automatically brought up - * when NetworkManager activates this connection. This only has a real effect - * for master connections. The properties #NMSettingConnection:autoconnect, - * #NMSettingConnection:autoconnect-priority and #NMSettingConnection:autoconnect-retries - * are unrelated to this setting. - * The permitted values are: 0: leave slave connections untouched, - * 1: activate all the slave connections with this connection, -1: default. - * If -1 (default) is set, global connection.autoconnect-slaves is read to - * determine the real value. If it is default as well, this fallbacks to 0. - * - * Since: 1.2 - **/ - /* ---ifcfg-rh--- - * property: autoconnect-slaves - * variable: AUTOCONNECT_SLAVES(+) - * default: missing variable means global default - * description: Whether slaves of this connection should be auto-connected - * when this connection is activated. - * ---end--- - */ - obj_properties[PROP_AUTOCONNECT_SLAVES] = g_param_spec_enum( - NM_SETTING_CONNECTION_AUTOCONNECT_SLAVES, - "", - "", - NM_TYPE_SETTING_CONNECTION_AUTOCONNECT_SLAVES, - NM_SETTING_CONNECTION_AUTOCONNECT_SLAVES_DEFAULT, - G_PARAM_READWRITE | NM_SETTING_PARAM_FUZZY_IGNORE | G_PARAM_STATIC_STRINGS); - - /** - * NMSettingConnection:secondaries: - * - * List of connection UUIDs that should be activated when the base - * connection itself is activated. Currently, only VPN connections are - * supported. - **/ - /* ---ifcfg-rh--- - * property: secondaries - * variable: SECONDARY_UUIDS(+) - * description: UUID of VPN connections that should be activated - * together with this connection. - * ---end--- - */ - obj_properties[PROP_SECONDARIES] = g_param_spec_boxed( - NM_SETTING_CONNECTION_SECONDARIES, - "", - "", - G_TYPE_STRV, - G_PARAM_READWRITE | NM_SETTING_PARAM_FUZZY_IGNORE | G_PARAM_STATIC_STRINGS); - - /** - * NMSettingConnection:gateway-ping-timeout: - * - * If greater than zero, delay success of IP addressing until either the - * timeout is reached, or an IP gateway replies to a ping. - **/ - /* ---ifcfg-rh--- - * property: gateway-ping-timeout - * variable: GATEWAY_PING_TIMEOUT(+) - * default: 0 - * description: If greater than zero, the IP connectivity will be checked by - * pinging the gateway and waiting for the specified timeout (in seconds). - * example: GATEWAY_PING_TIMEOUT=5 - * ---end--- - */ - obj_properties[PROP_GATEWAY_PING_TIMEOUT] = - g_param_spec_uint(NM_SETTING_CONNECTION_GATEWAY_PING_TIMEOUT, - "", - "", - 0, - 600, - 0, - G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS); - - /** - * NMSettingConnection:metered: - * - * Whether the connection is metered. - * - * When updating this property on a currently activated connection, - * the change takes effect immediately. - * - * Since: 1.2 - **/ - /* ---ifcfg-rh--- - * property: metered - * variable: CONNECTION_METERED(+) - * values: yes,no,unknown - * description: Whether the device is metered - * example: CONNECTION_METERED=yes - * ---end--- - */ - obj_properties[PROP_METERED] = g_param_spec_enum( - NM_SETTING_CONNECTION_METERED, - "", - "", - NM_TYPE_METERED, - NM_METERED_UNKNOWN, - G_PARAM_READWRITE | NM_SETTING_PARAM_REAPPLY_IMMEDIATELY | G_PARAM_STATIC_STRINGS); - - /** - * NMSettingConnection:lldp: - * - * Whether LLDP is enabled for the connection. - * - * Since: 1.2 - **/ - /* ---ifcfg-rh--- - * property: lldp - * variable: LLDP(+) - * values: boolean value or 'rx' - * default: missing variable means global default - * description: whether LLDP is enabled for the connection - * example: LLDP=no - * ---end--- - */ - obj_properties[PROP_LLDP] = g_param_spec_int(NM_SETTING_CONNECTION_LLDP, - "", - "", - G_MININT32, - G_MAXINT32, - NM_SETTING_CONNECTION_LLDP_DEFAULT, - NM_SETTING_PARAM_FUZZY_IGNORE | G_PARAM_READWRITE - | G_PARAM_STATIC_STRINGS); - - /** - * NMSettingConnection:auth-retries: - * - * The number of retries for the authentication. Zero means to try indefinitely; -1 means - * to use a global default. If the global default is not set, the authentication - * retries for 3 times before failing the connection. - * - * Currently, this only applies to 802-1x authentication. - * - * Since: 1.10 - **/ - /* ---ifcfg-rh--- - * property: auth-retries - * variable: AUTH_RETRIES(+) - * default: 0 - * description: Number of retries for authentication. - * ---end--- - */ - obj_properties[PROP_AUTH_RETRIES] = g_param_spec_int( - NM_SETTING_CONNECTION_AUTH_RETRIES, - "", - "", - -1, - G_MAXINT32, - -1, - G_PARAM_READWRITE | NM_SETTING_PARAM_FUZZY_IGNORE | G_PARAM_STATIC_STRINGS); - - /** - * NMSettingConnection:mdns: - * - * Whether mDNS is enabled for the connection. - * - * The permitted values are: "yes" (2) register hostname and resolving - * for the connection, "no" (0) disable mDNS for the interface, "resolve" - * (1) do not register hostname but allow resolving of mDNS host names - * and "default" (-1) to allow lookup of a global default in NetworkManager.conf. - * If unspecified, "default" ultimately depends on the DNS plugin (which - * for systemd-resolved currently means "no"). - * - * This feature requires a plugin which supports mDNS. Otherwise, the - * setting has no effect. One such plugin is dns-systemd-resolved. -* - * Since: 1.12 - **/ - /* ---ifcfg-rh--- - * property: mdns - * variable: MDNS(+) - * values: yes,no,resolve - * default: missing variable means global default - * description: Whether or not mDNS is enabled for the connection - * example: MDNS=yes - * ---end--- - */ - obj_properties[PROP_MDNS] = g_param_spec_int(NM_SETTING_CONNECTION_MDNS, - "", - "", - G_MININT32, - G_MAXINT32, - NM_SETTING_CONNECTION_MDNS_DEFAULT, - G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS); - - /** - * NMSettingConnection:llmnr: - * - * Whether Link-Local Multicast Name Resolution (LLMNR) is enabled - * for the connection. LLMNR is a protocol based on the Domain Name - * System (DNS) packet format that allows both IPv4 and IPv6 hosts - * to perform name resolution for hosts on the same local link. - * - * The permitted values are: "yes" (2) register hostname and resolving - * for the connection, "no" (0) disable LLMNR for the interface, "resolve" - * (1) do not register hostname but allow resolving of LLMNR host names - * If unspecified, "default" ultimately depends on the DNS plugin (which - * for systemd-resolved currently means "yes"). - * - * This feature requires a plugin which supports LLMNR. Otherwise, the - * setting has no effect. One such plugin is dns-systemd-resolved. - * - * Since: 1.14 - **/ - /* ---ifcfg-rh--- - * property: llmnr - * variable: LLMNR(+) - * values: yes,no,resolve - * default: missing variable means global default - * description: Whether or not LLMNR is enabled for the connection - * example: LLMNR=yes - * ---end--- - */ - obj_properties[PROP_LLMNR] = g_param_spec_int(NM_SETTING_CONNECTION_LLMNR, - "", - "", - G_MININT32, - G_MAXINT32, - NM_SETTING_CONNECTION_LLMNR_DEFAULT, - G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS); - - /** - * NMSettingConnection:wait-device-timeout: - * - * Timeout in milliseconds to wait for device at startup. - * During boot, devices may take a while to be detected by the driver. - * This property will cause to delay NetworkManager-wait-online.service - * and nm-online to give the device a chance to appear. This works by - * waiting for the given timeout until a compatible device for the - * profile is available and managed. - * - * The value 0 means no wait time. The default value is -1, which - * currently has the same meaning as no wait time. - * - * Since: 1.20 - **/ - /* ---ifcfg-rh--- - * property: wait-device-timeout - * variable: DEVTIMEOUT(+) - * values: timeout in seconds. - * description: for initscripts compatibility, this variable must be - * a whole integer. If necessary, NetworkManager stores also a fractional - * component for the milliseconds. - * example: DEVTIMEOUT=5 - * ---end--- - */ - obj_properties[PROP_WAIT_DEVICE_TIMEOUT] = - g_param_spec_int(NM_SETTING_CONNECTION_WAIT_DEVICE_TIMEOUT, - "", - "", - -1, - G_MAXINT32, - -1, - G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS); - - /** - * NMSettingConnection:mud-url: - * - * If configured, set to a Manufacturer Usage Description (MUD) URL that points - * to manufacturer-recommended network policies for IoT devices. It is transmitted - * as a DHCPv4 or DHCPv6 option. The value must be a valid URL starting with "https://". - * - * The special value "none" is allowed to indicate that no MUD URL is used. - * - * If the per-profile value is unspecified (the default), a global connection default gets - * consulted. If still unspecified, the ultimate default is "none". - * - * Since: 1.26 - **/ - /* ---ifcfg-rh--- - * property: mud-url - * variable: MUD_URL - * values: a valid URL that points to recommended policy for this device - * description: MUD_URL to be sent by device (See RFC 8520). - * example: https://yourdevice.example.com/model.json - * ---end--- - */ - obj_properties[PROP_MUD_URL] = g_param_spec_string(NM_SETTING_CONNECTION_MUD_URL, - "", - "", - NULL, - G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS); - - g_object_class_install_properties(object_class, _PROPERTY_ENUMS_LAST, obj_properties); - - _nm_setting_class_commit_full(setting_class, - NM_META_SETTING_TYPE_CONNECTION, - NULL, - properties_override); -} |