diff options
Diffstat (limited to 'libnm-core/nm-setting-wired.c')
| -rw-r--r-- | libnm-core/nm-setting-wired.c | 1647 |
1 files changed, 0 insertions, 1647 deletions
diff --git a/libnm-core/nm-setting-wired.c b/libnm-core/nm-setting-wired.c deleted file mode 100644 index 857f11b1..00000000 --- a/libnm-core/nm-setting-wired.c +++ /dev/null @@ -1,1647 +0,0 @@ -/* SPDX-License-Identifier: LGPL-2.1-or-later */ -/* - * Copyright (C) 2007 - 2014 Red Hat, Inc. - * Copyright (C) 2007 - 2008 Novell, Inc. - */ - -#include "libnm-core/nm-default-libnm-core.h" - -#include "nm-setting-wired.h" - -#include <net/ethernet.h> - -#include "nm-utils.h" -#include "nm-libnm-core-intern/nm-common-macros.h" -#include "nm-utils-private.h" -#include "nm-setting-private.h" - -/** - * SECTION:nm-setting-wired - * @short_description: Describes connection properties for Ethernet-based networks - * - * The #NMSettingWired object is a #NMSetting subclass that describes properties - * necessary for connection to Ethernet networks. - **/ - -/*****************************************************************************/ - -G_STATIC_ASSERT(NM_SETTING_WIRED_WAKE_ON_LAN_EXCLUSIVE_FLAGS - == (NM_SETTING_WIRED_WAKE_ON_LAN_DEFAULT | NM_SETTING_WIRED_WAKE_ON_LAN_IGNORE)); - -/*****************************************************************************/ - -NM_GOBJECT_PROPERTIES_DEFINE(NMSettingWired, - PROP_PORT, - PROP_SPEED, - PROP_DUPLEX, - PROP_AUTO_NEGOTIATE, - PROP_MAC_ADDRESS, - PROP_CLONED_MAC_ADDRESS, - PROP_GENERATE_MAC_ADDRESS_MASK, - PROP_MAC_ADDRESS_BLACKLIST, - PROP_MTU, - PROP_S390_SUBCHANNELS, - PROP_S390_NETTYPE, - PROP_S390_OPTIONS, - PROP_WAKE_ON_LAN, - PROP_WAKE_ON_LAN_PASSWORD, ); - -typedef struct { - struct { - NMUtilsNamedValue *arr; - guint len; - guint n_alloc; - } s390_options; - GArray * mac_address_blacklist; - char ** s390_subchannels; - char * port; - char * duplex; - char * device_mac_address; - char * cloned_mac_address; - char * generate_mac_address_mask; - char * s390_nettype; - char * wol_password; - NMSettingWiredWakeOnLan wol; - guint32 speed; - guint32 mtu; - bool auto_negotiate : 1; -} NMSettingWiredPrivate; - -G_DEFINE_TYPE(NMSettingWired, nm_setting_wired, NM_TYPE_SETTING) - -#define NM_SETTING_WIRED_GET_PRIVATE(o) \ - (G_TYPE_INSTANCE_GET_PRIVATE((o), NM_TYPE_SETTING_WIRED, NMSettingWiredPrivate)) - -/*****************************************************************************/ - -static const char *valid_s390_opts[] = { - "broadcast_mode", - "buffer_count", - "canonical_macaddr", - "checksumming", - "ctcprot", - "fake_broadcast", - "inter", - "inter_jumbo", - "ipato_add4", - "ipato_add6", - "ipato_enable", - "ipato_invert4", - "ipato_invert6", - "isolation", - "lancmd_timeout", - "large_send", - "layer2", - "portname", - "portno", - "priority_queueing", - "protocol", - "route4", - "route6", - "rxip_add4", - "rxip_add6", - "sniffer", - "total", - "vipa_add4", - "vipa_add6", - NULL, -}; - -static gboolean -valid_s390_opts_check(const char *option) -{ -#if NM_MORE_ASSERTS > 5 - nm_assert(NM_PTRARRAY_LEN(valid_s390_opts) + 1 == G_N_ELEMENTS(valid_s390_opts)); - { - gsize i; - - for (i = 0; i < G_N_ELEMENTS(valid_s390_opts); i++) { - if (i == G_N_ELEMENTS(valid_s390_opts) - 1) - nm_assert(!valid_s390_opts[i]); - else { - nm_assert(valid_s390_opts[i]); - nm_assert(valid_s390_opts[i][0] != '\0'); - if (i > 0) - g_assert(strcmp(valid_s390_opts[i - 1], valid_s390_opts[i]) < 0); - } - } - } -#endif - - return option - && (nm_utils_array_find_binary_search(valid_s390_opts, - sizeof(const char *), - G_N_ELEMENTS(valid_s390_opts) - 1, - &option, - nm_strcmp_p_with_data, - NULL) - >= 0); -} - -/** - * nm_setting_wired_get_port: - * @setting: the #NMSettingWired - * - * Returns: the #NMSettingWired:port property of the setting - **/ -const char * -nm_setting_wired_get_port(NMSettingWired *setting) -{ - g_return_val_if_fail(NM_IS_SETTING_WIRED(setting), NULL); - - return NM_SETTING_WIRED_GET_PRIVATE(setting)->port; -} - -/** - * nm_setting_wired_get_speed: - * @setting: the #NMSettingWired - * - * Returns: the #NMSettingWired:speed property of the setting - **/ -guint32 -nm_setting_wired_get_speed(NMSettingWired *setting) -{ - g_return_val_if_fail(NM_IS_SETTING_WIRED(setting), 0); - - return NM_SETTING_WIRED_GET_PRIVATE(setting)->speed; -} - -/** - * nm_setting_wired_get_duplex: - * @setting: the #NMSettingWired - * - * Returns: the #NMSettingWired:duplex property of the setting - **/ -const char * -nm_setting_wired_get_duplex(NMSettingWired *setting) -{ - g_return_val_if_fail(NM_IS_SETTING_WIRED(setting), NULL); - - return NM_SETTING_WIRED_GET_PRIVATE(setting)->duplex; -} - -/** - * nm_setting_wired_get_auto_negotiate: - * @setting: the #NMSettingWired - * - * Returns: the #NMSettingWired:auto-negotiate property of the setting - **/ -gboolean -nm_setting_wired_get_auto_negotiate(NMSettingWired *setting) -{ - g_return_val_if_fail(NM_IS_SETTING_WIRED(setting), FALSE); - - return NM_SETTING_WIRED_GET_PRIVATE(setting)->auto_negotiate; -} - -/** - * nm_setting_wired_get_mac_address: - * @setting: the #NMSettingWired - * - * Returns: the #NMSettingWired:mac-address property of the setting - **/ -const char * -nm_setting_wired_get_mac_address(NMSettingWired *setting) -{ - g_return_val_if_fail(NM_IS_SETTING_WIRED(setting), NULL); - - return NM_SETTING_WIRED_GET_PRIVATE(setting)->device_mac_address; -} - -/** - * nm_setting_wired_get_cloned_mac_address: - * @setting: the #NMSettingWired - * - * Returns: the #NMSettingWired:cloned-mac-address property of the setting - **/ -const char * -nm_setting_wired_get_cloned_mac_address(NMSettingWired *setting) -{ - g_return_val_if_fail(NM_IS_SETTING_WIRED(setting), NULL); - - return NM_SETTING_WIRED_GET_PRIVATE(setting)->cloned_mac_address; -} - -/** - * nm_setting_wired_get_generate_mac_address_mask: - * @setting: the #NMSettingWired - * - * Returns: the #NMSettingWired:generate-mac-address-mask property of the setting - * - * Since: 1.4 - **/ -const char * -nm_setting_wired_get_generate_mac_address_mask(NMSettingWired *setting) -{ - g_return_val_if_fail(NM_IS_SETTING_WIRED(setting), NULL); - - return NM_SETTING_WIRED_GET_PRIVATE(setting)->generate_mac_address_mask; -} - -/** - * nm_setting_wired_get_mac_address_blacklist: - * @setting: the #NMSettingWired - * - * Returns: the #NMSettingWired:mac-address-blacklist property of the setting - **/ -const char *const * -nm_setting_wired_get_mac_address_blacklist(NMSettingWired *setting) -{ - NMSettingWiredPrivate *priv; - - g_return_val_if_fail(NM_IS_SETTING_WIRED(setting), NULL); - - priv = NM_SETTING_WIRED_GET_PRIVATE(setting); - return (const char *const *) priv->mac_address_blacklist->data; -} - -/** - * nm_setting_wired_get_num_mac_blacklist_items: - * @setting: the #NMSettingWired - * - * Returns: the number of blacklisted MAC addresses - **/ -guint32 -nm_setting_wired_get_num_mac_blacklist_items(NMSettingWired *setting) -{ - g_return_val_if_fail(NM_IS_SETTING_WIRED(setting), 0); - - return NM_SETTING_WIRED_GET_PRIVATE(setting)->mac_address_blacklist->len; -} - -/** - * nm_setting_wired_get_mac_blacklist_item: - * @setting: the #NMSettingWired - * @idx: the zero-based index of the MAC address entry - * - * Returns: the blacklisted MAC address string (hex-digits-and-colons notation) - * at index @idx - **/ -const char * -nm_setting_wired_get_mac_blacklist_item(NMSettingWired *setting, guint32 idx) -{ - NMSettingWiredPrivate *priv; - - g_return_val_if_fail(NM_IS_SETTING_WIRED(setting), NULL); - - priv = NM_SETTING_WIRED_GET_PRIVATE(setting); - g_return_val_if_fail(idx <= priv->mac_address_blacklist->len, NULL); - - return g_array_index(priv->mac_address_blacklist, const char *, idx); -} - -/** - * nm_setting_wired_add_mac_blacklist_item: - * @setting: the #NMSettingWired - * @mac: the MAC address string (hex-digits-and-colons notation) to blacklist - * - * Adds a new MAC address to the #NMSettingWired:mac-address-blacklist property. - * - * Returns: %TRUE if the MAC address was added; %FALSE if the MAC address - * is invalid or was already present - **/ -gboolean -nm_setting_wired_add_mac_blacklist_item(NMSettingWired *setting, const char *mac) -{ - NMSettingWiredPrivate *priv; - const char * candidate; - int i; - - g_return_val_if_fail(NM_IS_SETTING_WIRED(setting), FALSE); - g_return_val_if_fail(mac != NULL, FALSE); - - if (!nm_utils_hwaddr_valid(mac, ETH_ALEN)) - return FALSE; - - priv = NM_SETTING_WIRED_GET_PRIVATE(setting); - for (i = 0; i < priv->mac_address_blacklist->len; i++) { - candidate = g_array_index(priv->mac_address_blacklist, char *, i); - if (nm_utils_hwaddr_matches(mac, -1, candidate, -1)) - return FALSE; - } - - mac = nm_utils_hwaddr_canonical(mac, ETH_ALEN); - g_array_append_val(priv->mac_address_blacklist, mac); - _notify(setting, PROP_MAC_ADDRESS_BLACKLIST); - return TRUE; -} - -/** - * nm_setting_wired_remove_mac_blacklist_item: - * @setting: the #NMSettingWired - * @idx: index number of the MAC address - * - * Removes the MAC address at index @idx from the blacklist. - **/ -void -nm_setting_wired_remove_mac_blacklist_item(NMSettingWired *setting, guint32 idx) -{ - NMSettingWiredPrivate *priv; - - g_return_if_fail(NM_IS_SETTING_WIRED(setting)); - - priv = NM_SETTING_WIRED_GET_PRIVATE(setting); - g_return_if_fail(idx < priv->mac_address_blacklist->len); - - g_array_remove_index(priv->mac_address_blacklist, idx); - _notify(setting, PROP_MAC_ADDRESS_BLACKLIST); -} - -/** - * nm_setting_wired_remove_mac_blacklist_item_by_value: - * @setting: the #NMSettingWired - * @mac: the MAC address string (hex-digits-and-colons notation) to remove from - * the blacklist - * - * Removes the MAC address @mac from the blacklist. - * - * Returns: %TRUE if the MAC address was found and removed; %FALSE if it was not. - **/ -gboolean -nm_setting_wired_remove_mac_blacklist_item_by_value(NMSettingWired *setting, const char *mac) -{ - NMSettingWiredPrivate *priv; - const char * candidate; - int i; - - g_return_val_if_fail(NM_IS_SETTING_WIRED(setting), FALSE); - g_return_val_if_fail(mac != NULL, FALSE); - - priv = NM_SETTING_WIRED_GET_PRIVATE(setting); - for (i = 0; i < priv->mac_address_blacklist->len; i++) { - candidate = g_array_index(priv->mac_address_blacklist, char *, i); - if (!nm_utils_hwaddr_matches(mac, -1, candidate, -1)) { - g_array_remove_index(priv->mac_address_blacklist, i); - _notify(setting, PROP_MAC_ADDRESS_BLACKLIST); - return TRUE; - } - } - return FALSE; -} - -/** - * nm_setting_wired_clear_mac_blacklist_items: - * @setting: the #NMSettingWired - * - * Removes all blacklisted MAC addresses. - **/ -void -nm_setting_wired_clear_mac_blacklist_items(NMSettingWired *setting) -{ - g_return_if_fail(NM_IS_SETTING_WIRED(setting)); - - g_array_set_size(NM_SETTING_WIRED_GET_PRIVATE(setting)->mac_address_blacklist, 0); - _notify(setting, PROP_MAC_ADDRESS_BLACKLIST); -} - -/** - * nm_setting_wired_get_mtu: - * @setting: the #NMSettingWired - * - * Returns: the #NMSettingWired:mtu property of the setting - **/ -guint32 -nm_setting_wired_get_mtu(NMSettingWired *setting) -{ - g_return_val_if_fail(NM_IS_SETTING_WIRED(setting), 0); - - return NM_SETTING_WIRED_GET_PRIVATE(setting)->mtu; -} - -/** - * nm_setting_wired_get_s390_subchannels: - * @setting: the #NMSettingWired - * - * Return the list of s390 subchannels that identify the device that this - * connection is applicable to. The connection should only be used in - * conjunction with that device. - * - * Returns: (transfer none) (element-type utf8): array of strings, each specifying - * one subchannel the s390 device uses to communicate to the host. - **/ -const char *const * -nm_setting_wired_get_s390_subchannels(NMSettingWired *setting) -{ - g_return_val_if_fail(NM_IS_SETTING_WIRED(setting), NULL); - - return (const char *const *) NM_SETTING_WIRED_GET_PRIVATE(setting)->s390_subchannels; -} - -/** - * nm_setting_wired_get_s390_nettype: - * @setting: the #NMSettingWired - * - * Returns the s390 device type this connection should apply to. Will be one - * of 'qeth', 'lcs', or 'ctc'. - * - * Returns: the s390 device type - **/ -const char * -nm_setting_wired_get_s390_nettype(NMSettingWired *setting) -{ - g_return_val_if_fail(NM_IS_SETTING_WIRED(setting), NULL); - - return NM_SETTING_WIRED_GET_PRIVATE(setting)->s390_nettype; -} - -/** - * nm_setting_wired_get_num_s390_options: - * @setting: the #NMSettingWired - * - * Returns the number of s390-specific options that should be set for this - * device when it is activated. This can be used to retrieve each s390 - * option individually using nm_setting_wired_get_s390_option(). - * - * Returns: the number of s390-specific device options - **/ -guint32 -nm_setting_wired_get_num_s390_options(NMSettingWired *setting) -{ - g_return_val_if_fail(NM_IS_SETTING_WIRED(setting), 0); - - return NM_SETTING_WIRED_GET_PRIVATE(setting)->s390_options.len; -} - -/** - * nm_setting_wired_get_s390_option: - * @setting: the #NMSettingWired - * @idx: index of the desired option, from 0 to - * nm_setting_wired_get_num_s390_options() - 1 - * @out_key: (out) (transfer none): on return, the key name of the s390 specific - * option; this value is owned by the setting and should not be modified - * @out_value: (out) (transfer none): on return, the value of the key of the - * s390 specific option; this value is owned by the setting and should not be - * modified - * - * Given an index, return the value of the s390 option at that index. indexes - * are *not* guaranteed to be static across modifications to options done by - * nm_setting_wired_add_s390_option() and nm_setting_wired_remove_s390_option(), - * and should not be used to refer to options except for short periods of time - * such as during option iteration. - * - * Returns: %TRUE on success if the index was valid and an option was found, - * %FALSE if the index was invalid (ie, greater than the number of options - * currently held by the setting) - **/ -gboolean -nm_setting_wired_get_s390_option(NMSettingWired *setting, - guint32 idx, - const char ** out_key, - const char ** out_value) -{ - NMSettingWiredPrivate *priv; - - /* with LTO and optimization, the compiler complains that the - * output variables are not initialized. In practice, the function - * only sets the output on success. But make the compiler happy. - */ - NM_SET_OUT(out_key, NULL); - NM_SET_OUT(out_value, NULL); - - g_return_val_if_fail(NM_IS_SETTING_WIRED(setting), FALSE); - - priv = NM_SETTING_WIRED_GET_PRIVATE(setting); - - g_return_val_if_fail(idx < priv->s390_options.len, FALSE); - - NM_SET_OUT(out_key, priv->s390_options.arr[idx].name); - NM_SET_OUT(out_value, priv->s390_options.arr[idx].value_str); - return TRUE; -} - -/** - * nm_setting_wired_get_s390_option_by_key: - * @setting: the #NMSettingWired - * @key: the key for which to retrieve the value - * - * Returns the value associated with the s390-specific option specified by - * @key, if it exists. - * - * Returns: the value, or %NULL if the key/value pair was never added to the - * setting; the value is owned by the setting and must not be modified - **/ -const char * -nm_setting_wired_get_s390_option_by_key(NMSettingWired *setting, const char *key) -{ - NMSettingWiredPrivate *priv; - gssize idx; - - g_return_val_if_fail(NM_IS_SETTING_WIRED(setting), NULL); - g_return_val_if_fail(key && key[0], NULL); - - priv = NM_SETTING_WIRED_GET_PRIVATE(setting); - - idx = nm_utils_named_value_list_find(priv->s390_options.arr, priv->s390_options.len, key, TRUE); - if (idx < 0) - return NULL; - return priv->s390_options.arr[idx].value_str; -} - -/** - * nm_setting_wired_add_s390_option: - * @setting: the #NMSettingWired - * @key: key name for the option - * @value: value for the option - * - * Add an option to the table. The option is compared to an internal list - * of allowed options. Key names may contain only alphanumeric characters - * (ie [a-zA-Z0-9]). Adding a new key replaces any existing key/value pair that - * may already exist. - * - * Returns: %TRUE if the option was valid and was added to the internal option - * list, %FALSE if it was not. - **/ -gboolean -nm_setting_wired_add_s390_option(NMSettingWired *setting, const char *key, const char *value) -{ - NMSettingWiredPrivate *priv; - gssize idx; - NMUtilsNamedValue * v; - - g_return_val_if_fail(NM_IS_SETTING_WIRED(setting), FALSE); - g_return_val_if_fail(value, FALSE); - - if (!valid_s390_opts_check(key)) { - g_return_val_if_fail(key, FALSE); - return FALSE; - } - - priv = NM_SETTING_WIRED_GET_PRIVATE(setting); - - idx = nm_utils_named_value_list_find(priv->s390_options.arr, priv->s390_options.len, key, TRUE); - if (idx < 0) { - gsize dst_idx = ~idx; - - if (priv->s390_options.n_alloc < priv->s390_options.len + 1) { - priv->s390_options.n_alloc = NM_MAX(4, (priv->s390_options.len + 1) * 2); - priv->s390_options.arr = - g_realloc(priv->s390_options.arr, - priv->s390_options.n_alloc * sizeof(NMUtilsNamedValue)); - } - if (dst_idx < priv->s390_options.len) { - memmove(&priv->s390_options.arr[dst_idx + 1], - &priv->s390_options.arr[dst_idx], - (priv->s390_options.len - dst_idx) * sizeof(NMUtilsNamedValue)); - } - priv->s390_options.arr[dst_idx] = (NMUtilsNamedValue){ - .name = g_strdup(key), - .value_str = g_strdup(value), - }; - priv->s390_options.len++; - } else { - v = &priv->s390_options.arr[idx]; - if (nm_streq(value, v->value_str)) - return TRUE; - g_free((char *) v->value_str); - v->value_str = g_strdup(value); - } - - _notify(setting, PROP_S390_OPTIONS); - return TRUE; -} - -/** - * nm_setting_wired_remove_s390_option: - * @setting: the #NMSettingWired - * @key: key name for the option to remove - * - * Remove the s390-specific option referenced by @key from the internal option - * list. - * - * Returns: %TRUE if the option was found and removed from the internal option - * list, %FALSE if it was not. - **/ -gboolean -nm_setting_wired_remove_s390_option(NMSettingWired *setting, const char *key) -{ - NMSettingWiredPrivate *priv; - gsize dst_idx; - gssize idx; - - g_return_val_if_fail(NM_IS_SETTING_WIRED(setting), FALSE); - g_return_val_if_fail(key, FALSE); - - priv = NM_SETTING_WIRED_GET_PRIVATE(setting); - - idx = nm_utils_named_value_list_find(priv->s390_options.arr, priv->s390_options.len, key, TRUE); - if (idx < 0) - return FALSE; - - dst_idx = idx; - - g_free((char *) priv->s390_options.arr[dst_idx].name); - g_free((char *) priv->s390_options.arr[dst_idx].value_str); - if (dst_idx + 1 != priv->s390_options.len) { - memmove(&priv->s390_options.arr[dst_idx], - &priv->s390_options.arr[dst_idx + 1], - (priv->s390_options.len - dst_idx - 1) * sizeof(NMUtilsNamedValue)); - } - - priv->s390_options.len--; - - _notify(setting, PROP_S390_OPTIONS); - return TRUE; -} - -static void -_s390_options_clear(NMSettingWiredPrivate *priv) -{ - guint i; - - for (i = 0; i < priv->s390_options.len; i++) { - g_free((char *) priv->s390_options.arr[i].name); - g_free((char *) priv->s390_options.arr[i].value_str); - } - nm_clear_g_free(&priv->s390_options.arr); - priv->s390_options.len = 0; - priv->s390_options.n_alloc = 0; -} - -void -_nm_setting_wired_clear_s390_options(NMSettingWired *setting) -{ - g_return_if_fail(NM_IS_SETTING_WIRED(setting)); - - _s390_options_clear(NM_SETTING_WIRED_GET_PRIVATE(setting)); -} - -/** - * nm_setting_wired_get_valid_s390_options: - * @setting: (allow-none): the #NMSettingWired. This argument is unused - * and you may pass %NULL. - * - * Returns a list of valid s390 options. - * - * The @setting argument is unused and %NULL may be passed instead. - * - * Returns: (transfer none): a %NULL-terminated array of strings of valid s390 options. - **/ -const char ** -nm_setting_wired_get_valid_s390_options(NMSettingWired *setting) -{ - return valid_s390_opts; -} - -/** - * nm_setting_wired_get_wake_on_lan: - * @setting: the #NMSettingWired - * - * Returns the Wake-on-LAN options enabled for the connection - * - * Returns: the Wake-on-LAN options - * - * Since: 1.2 - */ -NMSettingWiredWakeOnLan -nm_setting_wired_get_wake_on_lan(NMSettingWired *setting) -{ - g_return_val_if_fail(NM_IS_SETTING_WIRED(setting), NM_SETTING_WIRED_WAKE_ON_LAN_NONE); - - return NM_SETTING_WIRED_GET_PRIVATE(setting)->wol; -} - -/** - * nm_setting_wired_get_wake_on_lan_password: - * @setting: the #NMSettingWired - * - * Returns the Wake-on-LAN password. This only applies to - * %NM_SETTING_WIRED_WAKE_ON_LAN_MAGIC. - * - * Returns: the Wake-on-LAN setting password, or %NULL if there is no password. - * - * Since: 1.2 - */ -const char * -nm_setting_wired_get_wake_on_lan_password(NMSettingWired *setting) -{ - g_return_val_if_fail(NM_IS_SETTING_WIRED(setting), NULL); - - return NM_SETTING_WIRED_GET_PRIVATE(setting)->wol_password; -} - -static gboolean -verify(NMSetting *setting, NMConnection *connection, GError **error) -{ - NMSettingWiredPrivate *priv = NM_SETTING_WIRED_GET_PRIVATE(setting); - GError * local = NULL; - guint i; - - if (!NM_IN_STRSET(priv->port, NULL, "tp", "aui", "bnc", "mii")) { - g_set_error(error, - NM_CONNECTION_ERROR, - NM_CONNECTION_ERROR_INVALID_PROPERTY, - _("'%s' is not a valid Ethernet port value"), - priv->port); - g_prefix_error(error, "%s.%s: ", NM_SETTING_WIRED_SETTING_NAME, NM_SETTING_WIRED_PORT); - return FALSE; - } - - if (!NM_IN_STRSET(priv->duplex, NULL, "half", "full")) { - g_set_error(error, - NM_CONNECTION_ERROR, - NM_CONNECTION_ERROR_INVALID_PROPERTY, - _("'%s' is not a valid duplex value"), - priv->duplex); - g_prefix_error(error, "%s.%s: ", NM_SETTING_WIRED_SETTING_NAME, NM_SETTING_WIRED_DUPLEX); - return FALSE; - } - - if (priv->device_mac_address && !nm_utils_hwaddr_valid(priv->device_mac_address, ETH_ALEN)) { - g_set_error(error, - NM_CONNECTION_ERROR, - NM_CONNECTION_ERROR_INVALID_PROPERTY, - _("'%s' is not a valid MAC address"), - priv->device_mac_address); - g_prefix_error(error, - "%s.%s: ", - NM_SETTING_WIRED_SETTING_NAME, - NM_SETTING_WIRED_MAC_ADDRESS); - return FALSE; - } - - for (i = 0; i < priv->mac_address_blacklist->len; i++) { - const char *mac = g_array_index(priv->mac_address_blacklist, const char *, i); - - if (!nm_utils_hwaddr_valid(mac, ETH_ALEN)) { - g_set_error(error, - NM_CONNECTION_ERROR, - NM_CONNECTION_ERROR_INVALID_PROPERTY, - _("'%s' is not a valid MAC address"), - mac); - g_prefix_error(error, - "%s.%s: ", - NM_SETTING_WIRED_SETTING_NAME, - NM_SETTING_WIRED_MAC_ADDRESS_BLACKLIST); - return FALSE; - } - } - - if (priv->s390_subchannels) { - guint len = g_strv_length(priv->s390_subchannels); - - if (len != 2 && len != 3) { - g_set_error_literal(error, - NM_CONNECTION_ERROR, - NM_CONNECTION_ERROR_INVALID_PROPERTY, - _("property is invalid")); - g_prefix_error(error, - "%s.%s: ", - NM_SETTING_WIRED_SETTING_NAME, - NM_SETTING_WIRED_S390_SUBCHANNELS); - return FALSE; - } - } - - if (!NM_IN_STRSET(priv->s390_nettype, NULL, "qeth", "lcs", "ctc")) { - g_set_error_literal(error, - NM_CONNECTION_ERROR, - NM_CONNECTION_ERROR_INVALID_PROPERTY, - _("property is invalid")); - g_prefix_error(error, - "%s.%s: ", - NM_SETTING_WIRED_SETTING_NAME, - NM_SETTING_WIRED_S390_NETTYPE); - return FALSE; - } - - for (i = 0; i < priv->s390_options.len; i++) { - const NMUtilsNamedValue *v = &priv->s390_options.arr[i]; - - nm_assert(v->name); - - if (!valid_s390_opts_check(v->name) || v->value_str[0] == '\0' - || strlen(v->value_str) > 200) { - g_set_error(error, - NM_CONNECTION_ERROR, - NM_CONNECTION_ERROR_INVALID_PROPERTY, - _("invalid '%s' or its value '%s'"), - v->name, - v->value_str); - g_prefix_error(error, - "%s.%s: ", - NM_SETTING_WIRED_SETTING_NAME, - NM_SETTING_WIRED_S390_OPTIONS); - return FALSE; - } - } - - if (priv->cloned_mac_address && !NM_CLONED_MAC_IS_SPECIAL(priv->cloned_mac_address) - && !nm_utils_hwaddr_valid(priv->cloned_mac_address, ETH_ALEN)) { - g_set_error(error, - NM_CONNECTION_ERROR, - NM_CONNECTION_ERROR_INVALID_PROPERTY, - _("'%s' is not a valid MAC address"), - priv->cloned_mac_address); - g_prefix_error(error, - "%s.%s: ", - NM_SETTING_WIRED_SETTING_NAME, - NM_SETTING_WIRED_CLONED_MAC_ADDRESS); - return FALSE; - } - - /* generate-mac-address-mask only makes sense with cloned-mac-address "random" or - * "stable". Still, let's not be so strict about that and accept the value - * even if it is unused. */ - if (!_nm_utils_generate_mac_address_mask_parse(priv->generate_mac_address_mask, - NULL, - NULL, - NULL, - &local)) { - g_set_error_literal(error, - NM_CONNECTION_ERROR, - NM_CONNECTION_ERROR_INVALID_PROPERTY, - local->message); - g_prefix_error(error, - "%s.%s: ", - NM_SETTING_WIRED_SETTING_NAME, - NM_SETTING_WIRED_GENERATE_MAC_ADDRESS_MASK); - g_error_free(local); - return FALSE; - } - - if (NM_FLAGS_ANY(priv->wol, NM_SETTING_WIRED_WAKE_ON_LAN_EXCLUSIVE_FLAGS) - && !nm_utils_is_power_of_two(priv->wol)) { - g_set_error_literal(error, - NM_CONNECTION_ERROR, - NM_CONNECTION_ERROR_INVALID_PROPERTY, - _("Wake-on-LAN mode 'default' and 'ignore' are exclusive flags")); - g_prefix_error(error, - "%s.%s: ", - NM_SETTING_WIRED_SETTING_NAME, - NM_SETTING_WIRED_WAKE_ON_LAN); - return FALSE; - } - - if (priv->wol_password && !NM_FLAGS_HAS(priv->wol, NM_SETTING_WIRED_WAKE_ON_LAN_MAGIC)) { - g_set_error_literal(error, - NM_CONNECTION_ERROR, - NM_CONNECTION_ERROR_INVALID_PROPERTY, - _("Wake-on-LAN password can only be used with magic packet mode")); - g_prefix_error(error, - "%s.%s: ", - NM_SETTING_WIRED_SETTING_NAME, - NM_SETTING_WIRED_WAKE_ON_LAN_PASSWORD); - return FALSE; - } - - if (priv->wol_password && !nm_utils_hwaddr_valid(priv->wol_password, ETH_ALEN)) { - g_set_error(error, - NM_CONNECTION_ERROR, - NM_CONNECTION_ERROR_INVALID_PROPERTY, - _("'%s' is not a valid MAC address"), - priv->wol_password); - g_prefix_error(error, - "%s.%s: ", - NM_SETTING_WIRED_SETTING_NAME, - NM_SETTING_WIRED_WAKE_ON_LAN_PASSWORD); - return FALSE; - } - - /* Normalizable properties - just return NM_SETTING_VERIFY_NORMALIZABLE for compatibility - * with legacy nm-connection-editor which used to save "full" duplex connection as default - */ - - if (((priv->speed) && (!priv->duplex)) || ((!priv->speed) && (priv->duplex))) { - g_set_error_literal( - error, - NM_CONNECTION_ERROR, - NM_CONNECTION_ERROR_INVALID_PROPERTY, - priv->auto_negotiate - ? _("both speed and duplex should have a valid value or both should be unset") - : _("both speed and duplex are required for static link configuration")); - return NM_SETTING_VERIFY_NORMALIZABLE; - } - - 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_streq(sett_info->property_infos[property_idx].name, - NM_SETTING_WIRED_CLONED_MAC_ADDRESS)) { - return !set_b - || nm_streq0(NM_SETTING_WIRED_GET_PRIVATE(set_a)->cloned_mac_address, - NM_SETTING_WIRED_GET_PRIVATE(set_b)->cloned_mac_address); - } - - return NM_SETTING_CLASS(nm_setting_wired_parent_class) - ->compare_property(sett_info, property_idx, con_a, set_a, con_b, set_b, flags); -} - -static GVariant * -_override_autoneg_get(const NMSettInfoSetting * sett_info, - guint property_idx, - NMConnection * connection, - NMSetting * setting, - NMConnectionSerializationFlags flags, - const NMConnectionSerializationOptions *options) -{ - return g_variant_new_boolean(nm_setting_wired_get_auto_negotiate((NMSettingWired *) setting)); -} - -/*****************************************************************************/ - -static void -clear_blacklist_item(char **item_p) -{ - g_free(*item_p); -} - -/*****************************************************************************/ - -static void -get_property(GObject *object, guint prop_id, GValue *value, GParamSpec *pspec) -{ - NMSettingWired * setting = NM_SETTING_WIRED(object); - NMSettingWiredPrivate *priv = NM_SETTING_WIRED_GET_PRIVATE(setting); - GHashTable * hash; - guint i; - - switch (prop_id) { - case PROP_PORT: - g_value_set_string(value, nm_setting_wired_get_port(setting)); - break; - case PROP_SPEED: - g_value_set_uint(value, nm_setting_wired_get_speed(setting)); - break; - case PROP_DUPLEX: - g_value_set_string(value, nm_setting_wired_get_duplex(setting)); - break; - case PROP_AUTO_NEGOTIATE: - g_value_set_boolean(value, nm_setting_wired_get_auto_negotiate(setting)); - break; - case PROP_MAC_ADDRESS: - g_value_set_string(value, nm_setting_wired_get_mac_address(setting)); - break; - case PROP_CLONED_MAC_ADDRESS: - g_value_set_string(value, nm_setting_wired_get_cloned_mac_address(setting)); - break; - case PROP_GENERATE_MAC_ADDRESS_MASK: - g_value_set_string(value, nm_setting_wired_get_generate_mac_address_mask(setting)); - break; - case PROP_MAC_ADDRESS_BLACKLIST: - g_value_set_boxed(value, (char **) priv->mac_address_blacklist->data); - break; - case PROP_MTU: - g_value_set_uint(value, nm_setting_wired_get_mtu(setting)); - break; - case PROP_S390_SUBCHANNELS: - g_value_set_boxed(value, priv->s390_subchannels); - break; - case PROP_S390_NETTYPE: - g_value_set_string(value, nm_setting_wired_get_s390_nettype(setting)); - break; - case PROP_S390_OPTIONS: - hash = g_hash_table_new_full(nm_str_hash, g_str_equal, g_free, g_free); - for (i = 0; i < priv->s390_options.len; i++) { - g_hash_table_insert(hash, - g_strdup(priv->s390_options.arr[i].name), - g_strdup(priv->s390_options.arr[i].value_str)); - } - g_value_take_boxed(value, hash); - break; - case PROP_WAKE_ON_LAN: - g_value_set_uint(value, priv->wol); - break; - case PROP_WAKE_ON_LAN_PASSWORD: - g_value_set_string(value, priv->wol_password); - 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) -{ - NMSettingWiredPrivate *priv = NM_SETTING_WIRED_GET_PRIVATE(object); - const char *const * blacklist; - const char * mac; - - switch (prop_id) { - case PROP_PORT: - g_free(priv->port); - priv->port = g_value_dup_string(value); - break; - case PROP_SPEED: - priv->speed = g_value_get_uint(value); - break; - case PROP_DUPLEX: - g_free(priv->duplex); - priv->duplex = g_value_dup_string(value); - break; - case PROP_AUTO_NEGOTIATE: - priv->auto_negotiate = g_value_get_boolean(value); - break; - case PROP_MAC_ADDRESS: - g_free(priv->device_mac_address); - priv->device_mac_address = - _nm_utils_hwaddr_canonical_or_invalid(g_value_get_string(value), ETH_ALEN); - break; - case PROP_CLONED_MAC_ADDRESS: - g_free(priv->cloned_mac_address); - priv->cloned_mac_address = - _nm_utils_hwaddr_canonical_or_invalid(g_value_get_string(value), ETH_ALEN); - break; - case PROP_GENERATE_MAC_ADDRESS_MASK: - g_free(priv->generate_mac_address_mask); - priv->generate_mac_address_mask = g_value_dup_string(value); - break; - case PROP_MAC_ADDRESS_BLACKLIST: - blacklist = g_value_get_boxed(value); - g_array_set_size(priv->mac_address_blacklist, 0); - if (blacklist && *blacklist) { - guint i; - - for (i = 0; blacklist[i]; i++) { - mac = _nm_utils_hwaddr_canonical_or_invalid(blacklist[i], ETH_ALEN); - g_array_append_val(priv->mac_address_blacklist, mac); - } - } - break; - case PROP_MTU: - priv->mtu = g_value_get_uint(value); - break; - case PROP_S390_SUBCHANNELS: - if (priv->s390_subchannels) - g_strfreev(priv->s390_subchannels); - priv->s390_subchannels = g_value_dup_boxed(value); - break; - case PROP_S390_NETTYPE: - g_free(priv->s390_nettype); - priv->s390_nettype = g_value_dup_string(value); - break; - case PROP_S390_OPTIONS: - { - GHashTable *hash; - - _s390_options_clear(priv); - - hash = g_value_get_boxed(value); - - priv->s390_options.n_alloc = hash ? g_hash_table_size(hash) : 0u; - - if (priv->s390_options.n_alloc > 0) { - gboolean invalid_content = FALSE; - GHashTableIter iter; - const char * key; - const char * val; - guint i, j; - - priv->s390_options.arr = g_new(NMUtilsNamedValue, priv->s390_options.n_alloc); - g_hash_table_iter_init(&iter, hash); - while (g_hash_table_iter_next(&iter, (gpointer *) &key, (gpointer *) &val)) { - if (!key || !val) { - invalid_content = TRUE; - continue; - } - nm_assert(priv->s390_options.len < priv->s390_options.n_alloc); - priv->s390_options.arr[priv->s390_options.len] = (NMUtilsNamedValue){ - .name = g_strdup(key), - .value_str = g_strdup(val), - }; - priv->s390_options.len++; - } - if (priv->s390_options.len > 1) { - nm_utils_named_value_list_sort(priv->s390_options.arr, - priv->s390_options.len, - NULL, - NULL); - /* prune duplicate keys. This is only possible if @hash does not use - * g_str_equal() as compare function (which would be a bug). - * Still, handle this, because we use later binary sort and rely - * on unique names. One bug here, should not bork the remainder - * of the program. */ - j = 1; - for (i = 1; i < priv->s390_options.len; i++) { - if (nm_streq(priv->s390_options.arr[j - 1].name, - priv->s390_options.arr[i].name)) { - g_free((char *) priv->s390_options.arr[i].name); - g_free((char *) priv->s390_options.arr[i].value_str); - invalid_content = TRUE; - continue; - } - priv->s390_options.arr[j++] = priv->s390_options.arr[i]; - } - priv->s390_options.len = j; - } - - g_return_if_fail(!invalid_content); - } - } break; - case PROP_WAKE_ON_LAN: - priv->wol = g_value_get_uint(value); - break; - case PROP_WAKE_ON_LAN_PASSWORD: - g_free(priv->wol_password); - priv->wol_password = g_value_dup_string(value); - break; - default: - G_OBJECT_WARN_INVALID_PROPERTY_ID(object, prop_id, pspec); - break; - } -} - -/*****************************************************************************/ - -static void -nm_setting_wired_init(NMSettingWired *setting) -{ - NMSettingWiredPrivate *priv = NM_SETTING_WIRED_GET_PRIVATE(setting); - - /* We use GArray rather than GPtrArray so it will automatically be NULL-terminated */ - priv->mac_address_blacklist = g_array_new(TRUE, FALSE, sizeof(char *)); - g_array_set_clear_func(priv->mac_address_blacklist, (GDestroyNotify) clear_blacklist_item); - - priv->wol = NM_SETTING_WIRED_WAKE_ON_LAN_DEFAULT; -} - -/** - * nm_setting_wired_new: - * - * Creates a new #NMSettingWired object with default values. - * - * Returns: (transfer full): the new empty #NMSettingWired object - **/ -NMSetting * -nm_setting_wired_new(void) -{ - return g_object_new(NM_TYPE_SETTING_WIRED, NULL); -} - -static void -finalize(GObject *object) -{ - NMSettingWiredPrivate *priv = NM_SETTING_WIRED_GET_PRIVATE(object); - - g_free(priv->port); - g_free(priv->duplex); - g_free(priv->s390_nettype); - - _s390_options_clear(priv); - - g_free(priv->device_mac_address); - g_free(priv->cloned_mac_address); - g_free(priv->generate_mac_address_mask); - g_array_unref(priv->mac_address_blacklist); - - if (priv->s390_subchannels) - g_strfreev(priv->s390_subchannels); - - g_free(priv->wol_password); - - G_OBJECT_CLASS(nm_setting_wired_parent_class)->finalize(object); -} - -static void -nm_setting_wired_class_init(NMSettingWiredClass *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(NMSettingWiredPrivate)); - - 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; - - /** - * NMSettingWired:port: - * - * Specific port type to use if the device supports multiple - * attachment methods. One of "tp" (Twisted Pair), "aui" (Attachment Unit - * Interface), "bnc" (Thin Ethernet) or "mii" (Media Independent Interface). - * If the device supports only one port type, this setting is ignored. - **/ - /* ---ifcfg-rh--- - * property: port - * variable: (none) - * description: The property is not saved by the plugin. - * ---end--- - */ - obj_properties[PROP_PORT] = g_param_spec_string(NM_SETTING_WIRED_PORT, - "", - "", - NULL, - G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS); - - /** - * NMSettingWired:speed: - * - * When a value greater than 0 is set, configures the device to use - * the specified speed. If "auto-negotiate" is "yes" the specified - * speed will be the only one advertised during link negotiation: - * this works only for BASE-T 802.3 specifications and is useful for - * enforcing gigabit speeds, as in this case link negotiation is - * mandatory. - * If the value is unset (0, the default), the link configuration will be - * either skipped (if "auto-negotiate" is "no", the default) or will - * be auto-negotiated (if "auto-negotiate" is "yes") and the local device - * will advertise all the supported speeds. - * In Mbit/s, ie 100 == 100Mbit/s. - * Must be set together with the "duplex" property when non-zero. - * Before specifying a speed value be sure your device supports it. - **/ - /* ---ifcfg-rh--- - * property: speed - * variable: ETHTOOL_OPTS - * description: Fixed speed for the ethernet link. It is added as "speed" - * parameter in the ETHTOOL_OPTS variable. - * ---end--- - */ - obj_properties[PROP_SPEED] = g_param_spec_uint(NM_SETTING_WIRED_SPEED, - "", - "", - 0, - G_MAXUINT32, - 0, - G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS); - - /** - * NMSettingWired:duplex: - * - * When a value is set, either "half" or "full", configures the device - * to use the specified duplex mode. If "auto-negotiate" is "yes" the - * specified duplex mode will be the only one advertised during link - * negotiation: this works only for BASE-T 802.3 specifications and is - * useful for enforcing gigabits modes, as in these cases link negotiation - * is mandatory. - * If the value is unset (the default), the link configuration will be - * either skipped (if "auto-negotiate" is "no", the default) or will - * be auto-negotiated (if "auto-negotiate" is "yes") and the local device - * will advertise all the supported duplex modes. - * Must be set together with the "speed" property if specified. - * Before specifying a duplex mode be sure your device supports it. - **/ - /* ---ifcfg-rh--- - * property: duplex - * variable: ETHTOOL_OPTS - * description: Fixed duplex mode for the ethernet link. It is added as - * "duplex" parameter in the ETHOOL_OPTS variable. - * ---end--- - */ - obj_properties[PROP_DUPLEX] = g_param_spec_string(NM_SETTING_WIRED_DUPLEX, - "", - "", - NULL, - G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS); - - /** - * NMSettingWired:auto-negotiate: - * - * When %TRUE, enforce auto-negotiation of speed and duplex mode. - * If "speed" and "duplex" properties are both specified, only that - * single mode will be advertised and accepted during the link - * auto-negotiation process: this works only for BASE-T 802.3 specifications - * and is useful for enforcing gigabits modes, as in these cases link - * negotiation is mandatory. - * When %FALSE, "speed" and "duplex" properties should be both set or - * link configuration will be skipped. - **/ - /* ---ifcfg-rh--- - * property: auto-negotiate - * variable: ETHTOOL_OPTS - * description: Whether link speed and duplex autonegotiation is enabled. - * It is not saved only if disabled and no values are provided for the - * "speed" and "duplex" parameters (skips link configuration). - * ---end--- - */ - obj_properties[PROP_AUTO_NEGOTIATE] = - g_param_spec_boolean(NM_SETTING_WIRED_AUTO_NEGOTIATE, - "", - "", - FALSE, - G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS); - _nm_properties_override_gobj(properties_override, - obj_properties[PROP_AUTO_NEGOTIATE], - NM_SETT_INFO_PROPERT_TYPE(.dbus_type = G_VARIANT_TYPE_BOOLEAN, - .to_dbus_fcn = _override_autoneg_get, )); - - /** - * NMSettingWired:mac-address: - * - * If specified, this connection will only apply to the Ethernet device - * whose permanent MAC address matches. This property does not change the - * MAC address of the device (i.e. MAC spoofing). - **/ - /* ---keyfile--- - * property: mac-address - * format: usual hex-digits-and-colons notation - * description: MAC address in traditional hex-digits-and-colons notation - * (e.g. 00:22:68:12:79:A2), or semicolon separated list of 6 bytes (obsolete) - * (e.g. 0;34;104;18;121;162) - * ---end--- - * ---ifcfg-rh--- - * property: mac-address - * variable: HWADDR - * description: Hardware address of the device in traditional hex-digits-and-colons - * notation (e.g. 00:22:68:14:5A:05). - * Note that for initscripts this is the current MAC address of the device as found - * during ifup. For NetworkManager this is the permanent MAC address. Or in case no - * permanent MAC address exists, the MAC address initially configured on the device. - * ---end--- - */ - obj_properties[PROP_MAC_ADDRESS] = g_param_spec_string( - NM_SETTING_WIRED_MAC_ADDRESS, - "", - "", - NULL, - G_PARAM_READWRITE | NM_SETTING_PARAM_INFERRABLE | G_PARAM_STATIC_STRINGS); - _nm_properties_override_gobj(properties_override, - obj_properties[PROP_MAC_ADDRESS], - &nm_sett_info_propert_type_mac_address); - - /** - * NMSettingWired:cloned-mac-address: - * - * If specified, request that the device use this MAC address instead. - * This is known as MAC cloning or spoofing. - * - * Beside explicitly specifying a MAC address, the special values "preserve", "permanent", - * "random" and "stable" are supported. - * "preserve" means not to touch the MAC address on activation. - * "permanent" means to use the permanent hardware address if the device - * has one (otherwise this is treated as "preserve"). - * "random" creates a random MAC address on each connect. - * "stable" creates a hashed MAC address based on connection.stable-id and a - * machine dependent key. - * - * If unspecified, the value can be overwritten via global defaults, see manual - * of NetworkManager.conf. If still unspecified, it defaults to "preserve" - * (older versions of NetworkManager may use a different default value). - * - * On D-Bus, this field is expressed as "assigned-mac-address" or the deprecated - * "cloned-mac-address". - **/ - /* ---keyfile--- - * property: cloned-mac-address - * format: usual hex-digits-and-colons notation - * description: Cloned MAC address in traditional hex-digits-and-colons notation - * (e.g. 00:22:68:12:79:B2), or semicolon separated list of 6 bytes (obsolete) - * (e.g. 0;34;104;18;121;178). - * ---end--- - * ---ifcfg-rh--- - * property: cloned-mac-address - * variable: MACADDR - * description: Cloned (spoofed) MAC address in traditional hex-digits-and-colons - * notation (e.g. 00:22:68:14:5A:99). - * ---end--- - * ---dbus--- - * property: cloned-mac-address - * format: byte array - * description: This D-Bus field is deprecated in favor of "assigned-mac-address" - * which is more flexible and allows specifying special variants like "random". - * For libnm and nmcli, this field is called "cloned-mac-address". - * ---end--- - */ - obj_properties[PROP_CLONED_MAC_ADDRESS] = g_param_spec_string( - NM_SETTING_WIRED_CLONED_MAC_ADDRESS, - "", - "", - NULL, - G_PARAM_READWRITE | NM_SETTING_PARAM_INFERRABLE | G_PARAM_STATIC_STRINGS); - _nm_properties_override_gobj(properties_override, - obj_properties[PROP_CLONED_MAC_ADDRESS], - &nm_sett_info_propert_type_cloned_mac_address); - - /* ---dbus--- - * property: assigned-mac-address - * format: string - * description: The new field for the cloned MAC address. It can be either - * a hardware address in ASCII representation, or one of the special values - * "preserve", "permanent", "random" or "stable". - * This field replaces the deprecated "cloned-mac-address" on D-Bus, which - * can only contain explicit hardware addresses. Note that this property - * only exists in D-Bus API. libnm and nmcli continue to call this property - * "cloned-mac-address". - * ---end--- - */ - _nm_properties_override_dbus(properties_override, - "assigned-mac-address", - &nm_sett_info_propert_type_assigned_mac_address); - - /** - * NMSettingWired:generate-mac-address-mask: - * - * With #NMSettingWired:cloned-mac-address setting "random" or "stable", - * by default all bits of the MAC address are scrambled and a locally-administered, - * unicast MAC address is created. This property allows to specify that certain bits - * are fixed. Note that the least significant bit of the first MAC address will - * always be unset to create a unicast MAC address. - * - * If the property is %NULL, it is eligible to be overwritten by a default - * connection setting. If the value is still %NULL or an empty string, the - * default is to create a locally-administered, unicast MAC address. - * - * If the value contains one MAC address, this address is used as mask. The set - * bits of the mask are to be filled with the current MAC address of the device, - * while the unset bits are subject to randomization. - * Setting "FE:FF:FF:00:00:00" means to preserve the OUI of the current MAC address - * and only randomize the lower 3 bytes using the "random" or "stable" algorithm. - * - * If the value contains one additional MAC address after the mask, - * this address is used instead of the current MAC address to fill the bits - * that shall not be randomized. For example, a value of - * "FE:FF:FF:00:00:00 68:F7:28:00:00:00" will set the OUI of the MAC address - * to 68:F7:28, while the lower bits are randomized. A value of - * "02:00:00:00:00:00 00:00:00:00:00:00" will create a fully scrambled - * globally-administered, burned-in MAC address. - * - * If the value contains more than one additional MAC addresses, one of - * them is chosen randomly. For example, "02:00:00:00:00:00 00:00:00:00:00:00 02:00:00:00:00:00" - * will create a fully scrambled MAC address, randomly locally or globally - * administered. - **/ - /* ---ifcfg-rh--- - * property: generate-mac-address-mask - * variable: GENERATE_MAC_ADDRESS_MASK(+) - * description: the MAC address mask for generating randomized and stable - * cloned-mac-address. - * ---end--- - */ - obj_properties[PROP_GENERATE_MAC_ADDRESS_MASK] = g_param_spec_string( - NM_SETTING_WIRED_GENERATE_MAC_ADDRESS_MASK, - "", - "", - NULL, - G_PARAM_READWRITE | NM_SETTING_PARAM_FUZZY_IGNORE | G_PARAM_STATIC_STRINGS); - - /** - * NMSettingWired:mac-address-blacklist: - * - * If specified, this connection will never apply to the Ethernet device - * whose permanent MAC address matches an address in the list. Each MAC - * address is in the standard hex-digits-and-colons notation - * (00:11:22:33:44:55). - **/ - /* ---keyfile--- - * property: mac-address-blacklist - * format: list of MACs (separated with semicolons) - * description: MAC address blacklist. - * example: mac-address-blacklist= 00:22:68:12:79:A6;00:22:68:12:79:78 - * ---end--- - * ---ifcfg-rh--- - * property: mac-address-blacklist - * variable: HWADDR_BLACKLIST(+) - * description: It denies usage of the connection for any device whose address - * is listed. - * example: HWADDR_BLACKLIST="00:22:68:11:69:08 00:11:22:11:44:55" - * ---end--- - */ - obj_properties[PROP_MAC_ADDRESS_BLACKLIST] = g_param_spec_boxed( - NM_SETTING_WIRED_MAC_ADDRESS_BLACKLIST, - "", - "", - G_TYPE_STRV, - G_PARAM_READWRITE | NM_SETTING_PARAM_FUZZY_IGNORE | G_PARAM_STATIC_STRINGS); - - /** - * NMSettingWired:mtu: - * - * If non-zero, only transmit packets of the specified size or smaller, - * breaking larger packets up into multiple Ethernet frames. - **/ - /* ---ifcfg-rh--- - * property: mtu - * variable: MTU - * description: MTU of the interface. - * ---end--- - */ - obj_properties[PROP_MTU] = g_param_spec_uint(NM_SETTING_WIRED_MTU, - "", - "", - 0, - G_MAXUINT32, - 0, - G_PARAM_READWRITE | NM_SETTING_PARAM_FUZZY_IGNORE - | G_PARAM_STATIC_STRINGS); - - /** - * NMSettingWired:s390-subchannels: - * - * Identifies specific subchannels that this network device uses for - * communication with z/VM or s390 host. Like the - * #NMSettingWired:mac-address property for non-z/VM devices, this property - * can be used to ensure this connection only applies to the network device - * that uses these subchannels. The list should contain exactly 3 strings, - * and each string may only be composed of hexadecimal characters and the - * period (.) character. - **/ - /* ---ifcfg-rh--- - * property: s390-subchannels - * variable: SUBCHANNELS - * description: Subchannels for IBM S390 hosts. - * example: SUBCHANNELS=0.0.b00a,0.0.b00b,0.0.b00c - * ---end--- - */ - obj_properties[PROP_S390_SUBCHANNELS] = g_param_spec_boxed( - NM_SETTING_WIRED_S390_SUBCHANNELS, - "", - "", - G_TYPE_STRV, - G_PARAM_READWRITE | NM_SETTING_PARAM_INFERRABLE | G_PARAM_STATIC_STRINGS); - - /** - * NMSettingWired:s390-nettype: - * - * s390 network device type; one of "qeth", "lcs", or "ctc", representing - * the different types of virtual network devices available on s390 systems. - **/ - /* ---ifcfg-rh--- - * property: s390-nettype - * variable: NETTYPE - * values: "qeth", "lcs" or "ctc" - * description: Network type of the S390 host. - * example: NETTYPE=qeth - * ---end--- - */ - obj_properties[PROP_S390_NETTYPE] = g_param_spec_string( - NM_SETTING_WIRED_S390_NETTYPE, - "", - "", - NULL, - G_PARAM_READWRITE | NM_SETTING_PARAM_INFERRABLE | G_PARAM_STATIC_STRINGS); - - /** - * NMSettingWired:s390-options: (type GHashTable(utf8,utf8)): - * - * Dictionary of key/value pairs of s390-specific device options. Both keys - * and values must be strings. Allowed keys include "portno", "layer2", - * "portname", "protocol", among others. Key names must contain only - * alphanumeric characters (ie, [a-zA-Z0-9]). - **/ - /* ---ifcfg-rh--- - * property: s390-options - * variable: OPTIONS and PORTNAME, CTCPROTO, - * description: S390 device options. All options go to OPTIONS, except for - * "portname" and "ctcprot" that have their own variables. - * ---end--- - */ - obj_properties[PROP_S390_OPTIONS] = g_param_spec_boxed( - NM_SETTING_WIRED_S390_OPTIONS, - "", - "", - G_TYPE_HASH_TABLE, - G_PARAM_READWRITE | NM_SETTING_PARAM_INFERRABLE | G_PARAM_STATIC_STRINGS); - _nm_properties_override_gobj(properties_override, - obj_properties[PROP_S390_OPTIONS], - &nm_sett_info_propert_type_strdict); - - /** - * NMSettingWired:wake-on-lan: - * - * The #NMSettingWiredWakeOnLan options to enable. Not all devices support all options. - * May be any combination of %NM_SETTING_WIRED_WAKE_ON_LAN_PHY, - * %NM_SETTING_WIRED_WAKE_ON_LAN_UNICAST, %NM_SETTING_WIRED_WAKE_ON_LAN_MULTICAST, - * %NM_SETTING_WIRED_WAKE_ON_LAN_BROADCAST, %NM_SETTING_WIRED_WAKE_ON_LAN_ARP, - * %NM_SETTING_WIRED_WAKE_ON_LAN_MAGIC or the special values - * %NM_SETTING_WIRED_WAKE_ON_LAN_DEFAULT (to use global settings) and - * %NM_SETTING_WIRED_WAKE_ON_LAN_IGNORE (to disable management of Wake-on-LAN in - * NetworkManager). - * - * Since: 1.2 - **/ - obj_properties[PROP_WAKE_ON_LAN] = - g_param_spec_uint(NM_SETTING_WIRED_WAKE_ON_LAN, - "", - "", - 0, - G_MAXUINT32, - NM_SETTING_WIRED_WAKE_ON_LAN_DEFAULT, - G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS); - - /** - * NMSettingWired:wake-on-lan-password: - * - * If specified, the password used with magic-packet-based - * Wake-on-LAN, represented as an Ethernet MAC address. If %NULL, - * no password will be required. - * - * Since: 1.2 - **/ - obj_properties[PROP_WAKE_ON_LAN_PASSWORD] = - g_param_spec_string(NM_SETTING_WIRED_WAKE_ON_LAN_PASSWORD, - "", - "", - 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_WIRED, - NULL, - properties_override); -} |