Parameters

@@ -852,7 +793,7 @@ nm_setting_wired_get_mtu (Returns - the “mtu” property of the setting + the “mtu” property of the setting @@ -977,14 +918,14 @@ such as during option iteration.-+-+

out_key	on return, the key name of the s390 specific option; this value is owned by the setting and should not be modified.	[out][transfer none]	[allow-none][out][transfer none]
out_value	on return, the value of the key of the s390 specific option; this value is owned by the setting and should not be modified.	[out][transfer none]	[allow-none][out][transfer none]

@@ -1041,10 +982,10 @@ setting; the value is owned by the setting and must not be modified nm_setting_wired_add_s390_option (NMSettingWired *setting, const char *key, const char *value); -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. +Add an option to the table. If the key already exists, the value gets +replaced. +Before 1.32, the function would assert that the key is valid. Since then, +an invalid key gets silently added but renders the profile as invalid. Parameters @@ -1074,8 +1015,7 @@ may already exist. Returns - TRUE if the option was valid and was added to the internal option -list, FALSE if it was not. + since 1.32 this always returns TRUE. @@ -1213,7 +1153,7 @@ nm_setting_wired_get_wake_on_lan_password enum NMSettingWiredWakeOnLan -Options for “wake-on-lan”. Note that not all options + Options for “wake-on-lan”. Note that not all options are supported by all devices. Members @@ -1397,227 +1337,9 @@ incompatible with other flags -NMSettingWired -typedef struct _NMSettingWired NMSettingWired; -Wired Ethernet Settings - - - -Property Details - -The “auto-negotiate” property - “auto-negotiate” gboolean -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. -Owner: NMSettingWired -Flags: Read / Write -Default value: FALSE - - - -The “cloned-mac-address” property - “cloned-mac-address” char * -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". -Owner: NMSettingWired -Flags: Read / Write -Default value: NULL - - - -The “duplex” property - “duplex” char * -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. -Owner: NMSettingWired -Flags: Read / Write -Default value: NULL - - - -The “generate-mac-address-mask” property - “generate-mac-address-mask” char * -With “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. -Owner: NMSettingWired -Flags: Read / Write -Default value: NULL - - - -The “mac-address” property - “mac-address” char * -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). -Owner: NMSettingWired -Flags: Read / Write -Default value: NULL - - - -The “mac-address-blacklist” property - “mac-address-blacklist” GStrv -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). -Owner: NMSettingWired -Flags: Read / Write - - - -The “mtu” property - “mtu” guint -If non-zero, only transmit packets of the specified size or smaller, -breaking larger packets up into multiple Ethernet frames. -Owner: NMSettingWired -Flags: Read / Write -Default value: 0 - - - -The “port” property - “port” char * -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. -Owner: NMSettingWired -Flags: Read / Write -Default value: NULL - - - -The “s390-nettype” property - “s390-nettype” char * -s390 network device type; one of "qeth", "lcs", or "ctc", representing -the different types of virtual network devices available on s390 systems. -Owner: NMSettingWired -Flags: Read / Write -Default value: NULL - - - -The “s390-options” property - “s390-options” GHashTable * -Owner: NMSettingWired -Flags: Read / Write - - - -The “s390-subchannels” property - “s390-subchannels” GStrv -Identifies specific subchannels that this network device uses for -communication with z/VM or s390 host. Like the -“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. -Owner: NMSettingWired -Flags: Read / Write - - - -The “speed” property - “speed” guint -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. -Owner: NMSettingWired -Flags: Read / Write -Default value: 0 - - - -The “wake-on-lan” property - “wake-on-lan” guint -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). -Owner: NMSettingWired -Flags: Read / Write -Default value: 1 -Since: 1.2 - - - -The “wake-on-lan-password” property - “wake-on-lan-password” char * -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. -Owner: NMSettingWired -Flags: Read / Write -Default value: NULL -Since: 1.2 +NM_SETTING_WIRED_ACCEPT_ALL_MAC_ADDRESSES +#define NM_SETTING_WIRED_ACCEPT_ALL_MAC_ADDRESSES "accept-all-mac-addresses" + -- cgit 1.3.0-6-gf8a5 From 88c227d90a6b7b388c5c85d72802a0ca8f05ed5c Mon Sep 17 00:00:00 2001 From: Michael Biebl Date: Thu, 13 Jan 2022 22:30:39 +0100 Subject: New upstream version 1.34.0 --- docs/libnm/html/NMSettingWired.html | 22 +++++++++++----------- 1 file changed, 11 insertions(+), 11 deletions(-) (limited to 'docs/libnm/html/NMSettingWired.html') diff --git a/docs/libnm/html/NMSettingWired.html b/docs/libnm/html/NMSettingWired.html index a27878e3..aa1ef24b 100644 --- a/docs/libnm/html/NMSettingWired.html +++ b/docs/libnm/html/NMSettingWired.html @@ -372,7 +372,7 @@ nm_setting_wired_get_port ( Returns - the “port” property of the setting + the “port” property of the setting @@ -397,7 +397,7 @@ nm_setting_wired_get_speed ( Returns - the “speed” property of the setting + the “speed” property of the setting @@ -422,7 +422,7 @@ nm_setting_wired_get_duplex ( Returns - the “duplex” property of the setting + the “duplex” property of the setting @@ -447,7 +447,7 @@ nm_setting_wired_get_auto_negotiate ( Returns - the “auto-negotiate” property of the setting + the “auto-negotiate” property of the setting @@ -472,7 +472,7 @@ nm_setting_wired_get_mac_address ( Returns - the “mac-address” property of the setting + the “mac-address” property of the setting @@ -498,7 +498,7 @@ nm_setting_wired_get_cloned_mac_address Returns - the “cloned-mac-address” property of the setting + the “cloned-mac-address” property of the setting @@ -551,7 +551,7 @@ nm_setting_wired_get_generate_mac_address_mask Returns - the “generate-mac-address-mask” property of the setting + the “generate-mac-address-mask” property of the setting Since: 1.4 @@ -578,7 +578,7 @@ nm_setting_wired_get_mac_address_blacklist Returns - the “mac-address-blacklist” property of the setting + the “mac-address-blacklist” property of the setting @@ -650,7 +650,7 @@ at index idx nm_setting_wired_add_mac_blacklist_item (NMSettingWired *setting, const char *mac); -Adds a new MAC address to the “mac-address-blacklist” property. +Adds a new MAC address to the “mac-address-blacklist” property. Parameters @@ -793,7 +793,7 @@ nm_setting_wired_get_mtu ( Returns - the “mtu” property of the setting + the “mtu” property of the setting @@ -1153,7 +1153,7 @@ nm_setting_wired_get_wake_on_lan_password enum NMSettingWiredWakeOnLan -Options for “wake-on-lan”. Note that not all options + Options for “wake-on-lan”. Note that not all options are supported by all devices. Members -- cgit 1.3.0-6-gf8a5

gboolean	auto-negotiate	Read / Write
-char *	cloned-mac-address	Read / Write
-char *	duplex	Read / Write
-char *	generate-mac-address-mask	Read / Write
-char *	mac-address	Read / Write
GStrv	mac-address-blacklist	Read / Write
guint	mtu	Read / Write
-char *	port	Read / Write
-char *	s390-nettype	Read / Write
-GHashTable *	s390-options	Read / Write
GStrv	s390-subchannels	Read / Write
guint	speed	Read / Write
guint	wake-on-lan	Read / Write
-char *	wake-on-lan-password	Read / Write

NM_SETTING_WIRED_WAKE_ON_LAN_PASSWORD
	NMSettingWired	#define	NM_SETTING_WIRED_ACCEPT_ALL_MAC_ADDRESSES

Returns

Returns

Returns

Properties

Types and Values

Object Hierarchy

Returns

Returns

Returns

Returns

Returns

Returns

nm_setting_wired_get_accept_all_mac_addresses ()

Parameters

Returns

nm_setting_wired_get_generate_mac_address_mask ()

Returns

Returns

Parameters

Returns

Parameters

Returns

enum NMSettingWiredWakeOnLan

Members

NMSettingWired

Property Details

The “auto-negotiate” property

The “cloned-mac-address” property

The “duplex” property

The “generate-mac-address-mask” property

The “mac-address” property

The “mac-address-blacklist” property

The “mtu” property

The “port” property

The “s390-nettype” property

The “s390-options” property

The “s390-subchannels” property

The “speed” property

The “wake-on-lan” property

The “wake-on-lan-password” property

NM_SETTING_WIRED_ACCEPT_ALL_MAC_ADDRESSES

Returns

Returns

Returns

Returns

Returns

Returns

Returns

Returns

Parameters

Returns

enum NMSettingWiredWakeOnLan

Members

The `“auto-negotiate”` property

The `“cloned-mac-address”` property

The `“duplex”` property

The `“generate-mac-address-mask”` property

The `“mac-address”` property

The `“mac-address-blacklist”` property

The `“mtu”` property

The `“port”` property

The `“s390-nettype”` property

The `“s390-options”` property

The `“s390-subchannels”` property

The `“speed”` property

The `“wake-on-lan”` property

The `“wake-on-lan-password”` property