/* SPDX-License-Identifier: LGPL-2.1-or-later */ /* * Copyright (C) 2007 - 2013 Red Hat, Inc. * Copyright (C) 2007 - 2008 Novell, Inc. */ #include "libnm-core-impl/nm-default-libnm-core.h" #include "nm-setting-connection.h" #include "libnm-core-aux-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 "libnm-systemd-shared/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); }