From 35779c6675728fa6f0fd0a21cefb904408509c23 Mon Sep 17 00:00:00 2001 From: Sebastien Bacher Date: Mon, 5 Jul 2021 20:35:03 +0200 Subject: New upstream version 1.32.2 --- docs/libnm/html/NMSettingWired.html | 396 ++++++------------------------------ 1 file changed, 59 insertions(+), 337 deletions(-) (limited to 'docs/libnm/html/NMSettingWired.html') diff --git a/docs/libnm/html/NMSettingWired.html b/docs/libnm/html/NMSettingWired.html index d0be4268..6389ac4b 100644 --- a/docs/libnm/html/NMSettingWired.html +++ b/docs/libnm/html/NMSettingWired.html @@ -16,8 +16,7 @@ Top  |  Description  |  - Object Hierarchy  |  - Properties + Object Hierarchy Home Up @@ -94,6 +93,14 @@ + +NMTernary + + +nm_setting_wired_get_accept_all_mac_addresses () + + + const char * @@ -241,96 +248,6 @@
-

Properties

-
----- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
gbooleanauto-negotiateRead / Write
-char *cloned-mac-addressRead / Write
-char *duplexRead / Write
-char *generate-mac-address-maskRead / Write
-char *mac-addressRead / Write
GStrvmac-address-blacklistRead / Write
guintmtuRead / Write
-char *portRead / Write
-char *s390-nettypeRead / Write
-GHashTable *s390-optionsRead / Write
GStrvs390-subchannelsRead / Write
guintspeedRead / Write
guintwake-on-lanRead / Write
-char *wake-on-lan-passwordRead / Write
-
-

Types and Values

@@ -403,8 +320,8 @@ - - + +
NM_SETTING_WIRED_WAKE_ON_LAN_PASSWORD
 NMSettingWired#defineNM_SETTING_WIRED_ACCEPT_ALL_MAC_ADDRESSES
@@ -413,9 +330,6 @@

Object Hierarchy

    GFlags
     ╰── NMSettingWiredWakeOnLan
-    GObject
-    ╰── NMSetting
-        ╰── NMSettingWired
@@ -458,7 +372,7 @@ nm_setting_wired_get_port (

Returns

-

the “port” property of the setting

+

the “port” property of the setting

@@ -483,7 +397,7 @@ nm_setting_wired_get_speed (

Returns

-

the “speed” property of the setting

+

the “speed” property of the setting

@@ -508,7 +422,7 @@ nm_setting_wired_get_duplex (

Returns

-

the “duplex” property of the setting

+

the “duplex” property of the setting

@@ -533,7 +447,7 @@ nm_setting_wired_get_auto_negotiate (

Returns

-

the “auto-negotiate” property of the setting

+

the “auto-negotiate” property of the setting

@@ -558,7 +472,7 @@ nm_setting_wired_get_mac_address (

Returns

-

the “mac-address” property of the setting

+

the “mac-address” property of the setting

@@ -584,11 +498,38 @@ nm_setting_wired_get_cloned_mac_address

Returns

-

the “cloned-mac-address” property of the setting

+

the “cloned-mac-address” property of the setting

+

nm_setting_wired_get_accept_all_mac_addresses ()

+
NMTernary
+nm_setting_wired_get_accept_all_mac_addresses
+                               (NMSettingWired *setting);
+
+

Parameters

+
+++++ + + + + + +

setting

the NMSettingWired

 
+
+
+

Returns

+

the “accept-all-mac-addresses” property of the setting

+
+

Since: 1.32

+
+
+

nm_setting_wired_get_generate_mac_address_mask ()

const char *
 nm_setting_wired_get_generate_mac_address_mask
@@ -610,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

@@ -637,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

@@ -709,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

@@ -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