From 34bb501be08aa2b313d88e67d6e0a7e0a3f9cfa6 Mon Sep 17 00:00:00 2001 From: Michael Biebl Date: Sun, 5 May 2024 00:07:30 +0200 Subject: New upstream version 1.47.90 --- docs/libnm/html/NMSettingWired.html | 387 ++++++++++++++++++++++++++++++++---- 1 file changed, 351 insertions(+), 36 deletions(-) (limited to 'docs/libnm/html/NMSettingWired.html') diff --git a/docs/libnm/html/NMSettingWired.html b/docs/libnm/html/NMSettingWired.html index 18510898..4efcb874 100644 --- a/docs/libnm/html/NMSettingWired.html +++ b/docs/libnm/html/NMSettingWired.html @@ -57,7 +57,7 @@ -guint32 +guint32 nm_setting_wired_get_speed () @@ -72,7 +72,7 @@ -gboolean +gboolean nm_setting_wired_get_auto_negotiate () @@ -116,7 +116,7 @@ -guint32 +guint32 nm_setting_wired_get_num_mac_blacklist_items () @@ -131,7 +131,7 @@ -gboolean +gboolean nm_setting_wired_add_mac_blacklist_item () @@ -147,7 +147,7 @@ -gboolean +gboolean nm_setting_wired_remove_mac_blacklist_item_by_value () @@ -162,8 +162,62 @@ +const char *const * + + +nm_setting_wired_get_mac_address_denylist () + + + + +guint32 + + +nm_setting_wired_get_num_mac_denylist_items () + + + +const char * + + +nm_setting_wired_get_mac_denylist_item () + + + + +gboolean + + +nm_setting_wired_add_mac_denylist_item () + + + + +void + + +nm_setting_wired_remove_mac_denylist_item () + + + + +gboolean + + +nm_setting_wired_remove_mac_denylist_item_by_value () + + + + +void + + +nm_setting_wired_clear_mac_denylist_items () + + + -guint32 +guint32 nm_setting_wired_get_mtu () @@ -185,7 +239,7 @@ -guint32 +guint32 nm_setting_wired_get_num_s390_options () @@ -193,7 +247,7 @@ -gboolean +gboolean nm_setting_wired_get_s390_option () @@ -208,7 +262,7 @@ -gboolean +gboolean nm_setting_wired_add_s390_option () @@ -216,7 +270,7 @@ -gboolean +gboolean nm_setting_wired_remove_s390_option () @@ -297,6 +351,10 @@ #define +NM_SETTING_WIRED_MAC_ADDRESS_DENYLIST + + +#define NM_SETTING_WIRED_MTU @@ -378,7 +436,7 @@ nm_setting_wired_get_port (

nm_setting_wired_get_speed ()

-
guint32
+
guint32
 nm_setting_wired_get_speed (NMSettingWired *setting);

Parameters

@@ -428,7 +486,7 @@ nm_setting_wired_get_duplex (

nm_setting_wired_get_auto_negotiate ()

-
gboolean
+
gboolean
 nm_setting_wired_get_auto_negotiate (NMSettingWired *setting);

Parameters

@@ -561,6 +619,10 @@ nm_setting_wired_get_generate_mac_address_mask
const char *const *
 nm_setting_wired_get_mac_address_blacklist
                                (NMSettingWired *setting);
+
+

nm_setting_wired_get_mac_address_blacklist has been deprecated since version 1.48. and should not be used in newly-written code.

+

Use nm_setting_wired_get_mac_address_denylist() instead.

+

Parameters

@@ -584,9 +646,13 @@ nm_setting_wired_get_mac_address_blacklist

nm_setting_wired_get_num_mac_blacklist_items ()

-
guint32
+
guint32
 nm_setting_wired_get_num_mac_blacklist_items
                                (NMSettingWired *setting);
+
+

nm_setting_wired_get_num_mac_blacklist_items has been deprecated since version 1.48. and should not be used in newly-written code.

+

Use nm_setting_wired_get_num_mac_denylist_items() instead.

+

Parameters

@@ -613,8 +679,12 @@ nm_setting_wired_get_num_mac_blacklist_items
const char *
 nm_setting_wired_get_mac_blacklist_item
                                (NMSettingWired *setting,
-                                guint32 idx);
-

Since 1.46, access at index "len" is allowed and returns NULL.

+ guint32 idx); +
+

nm_setting_wired_get_mac_blacklist_item has been deprecated since version 1.48. and should not be used in newly-written code.

+

Use nm_setting_wired_get_mac_denylist_item() instead.

+
+

Since 1.48, access at index "len" is allowed and returns NULL.

Parameters

@@ -647,10 +717,14 @@ at index idx

nm_setting_wired_add_mac_blacklist_item ()

-
gboolean
+
gboolean
 nm_setting_wired_add_mac_blacklist_item
                                (NMSettingWired *setting,
                                 const char *mac);
+
+

nm_setting_wired_add_mac_blacklist_item has been deprecated since version 1.48. and should not be used in newly-written code.

+

Use nm_setting_wired_add_mac_denylist_item() instead.

+

Adds a new MAC address to the “mac-address-blacklist” property.

Parameters

@@ -676,7 +750,7 @@ nm_setting_wired_add_mac_blacklist_item

Returns

-

TRUE if the MAC address was added; FALSE if the MAC address +

TRUE if the MAC address was added; FALSE if the MAC address is invalid or was already present

@@ -686,7 +760,11 @@ is invalid or was already present

void
 nm_setting_wired_remove_mac_blacklist_item
                                (NMSettingWired *setting,
-                                guint32 idx);
+ guint32 idx); +
+

nm_setting_wired_remove_mac_blacklist_item has been deprecated since version 1.48. and should not be used in newly-written code.

+

Use nm_setting_wired_remove_mac_denylist_item() instead.

+

Removes the MAC address at index idx from the blacklist.

@@ -715,10 +793,14 @@ nm_setting_wired_remove_mac_blacklist_item

nm_setting_wired_remove_mac_blacklist_item_by_value ()

-
gboolean
+
gboolean
 nm_setting_wired_remove_mac_blacklist_item_by_value
                                (NMSettingWired *setting,
                                 const char *mac);
+
+

nm_setting_wired_remove_mac_blacklist_item_by_value has been deprecated since version 1.48. and should not be used in newly-written code.

+

Use nm_setting_wired_remove_mac_denylist_item_by_value() instead.

+

Removes the MAC address mac from the blacklist.

@@ -746,7 +828,7 @@ the blacklist

Returns

-

TRUE if the MAC address was found and removed; FALSE if it was not.

+

TRUE if the MAC address was found and removed; FALSE if it was not.


@@ -755,6 +837,10 @@ the blacklist

void
 nm_setting_wired_clear_mac_blacklist_items
                                (NMSettingWired *setting);
+
+

nm_setting_wired_clear_mac_blacklist_items has been deprecated since version 1.48. and should not be used in newly-written code.

+

Use nm_setting_wired_clear_mac_denylist_items() instead.

+

Removes all blacklisted MAC addresses.

Parameters

@@ -774,8 +860,231 @@ nm_setting_wired_clear_mac_blacklist_items

+

nm_setting_wired_get_mac_address_denylist ()

+
const char *const *
+nm_setting_wired_get_mac_address_denylist
+                               (NMSettingWired *setting);
+
+

Parameters

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

setting

the NMSettingWired

 
+
+
+

Returns

+

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

+
+

Since: 1.48

+
+
+
+

nm_setting_wired_get_num_mac_denylist_items ()

+
guint32
+nm_setting_wired_get_num_mac_denylist_items
+                               (NMSettingWired *setting);
+
+

Parameters

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

setting

the NMSettingWired

 
+
+
+

Returns

+

the number of denylisted MAC addresses

+
+

Since: 1.48

+
+
+
+

nm_setting_wired_get_mac_denylist_item ()

+
const char *
+nm_setting_wired_get_mac_denylist_item
+                               (NMSettingWired *setting,
+                                guint32 idx);
+
+

Parameters

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

setting

the NMSettingWired

 

idx

the zero-based index of the MAC address entry

 
+
+
+

Returns

+

the denylisted MAC address string (hex-digits-and-colons notation) +at index idx +

+
+

Since: 1.48

+
+
+
+

nm_setting_wired_add_mac_denylist_item ()

+
gboolean
+nm_setting_wired_add_mac_denylist_item
+                               (NMSettingWired *setting,
+                                const char *mac);
+

Adds a new MAC address to the “mac-address-denylist” property.

+
+

Parameters

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

setting

the NMSettingWired

 

mac

the MAC address string (hex-digits-and-colons notation) to denylist

 
+
+
+

Returns

+

TRUE if the MAC address was added; FALSE if the MAC address +is invalid or was already present

+
+

Since: 1.48

+
+
+
+

nm_setting_wired_remove_mac_denylist_item ()

+
void
+nm_setting_wired_remove_mac_denylist_item
+                               (NMSettingWired *setting,
+                                guint32 idx);
+

Removes the MAC address at index idx + from the denylist.

+
+

Parameters

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

setting

the NMSettingWired

 

idx

index number of the MAC address

 
+
+

Since: 1.48

+
+
+
+

nm_setting_wired_remove_mac_denylist_item_by_value ()

+
gboolean
+nm_setting_wired_remove_mac_denylist_item_by_value
+                               (NMSettingWired *setting,
+                                const char *mac);
+

Removes the MAC address mac + from the denylist.

+
+

Parameters

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

setting

the NMSettingWired

 

mac

the MAC address string (hex-digits-and-colons notation) to remove from +the denylist

 
+
+
+

Returns

+

TRUE if the MAC address was found and removed; FALSE if it was not.

+
+

Since: 1.48

+
+
+
+

nm_setting_wired_clear_mac_denylist_items ()

+
void
+nm_setting_wired_clear_mac_denylist_items
+                               (NMSettingWired *setting);
+

Removes all denylisted MAC addresses.

+
+

Parameters

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

setting

the NMSettingWired

 
+
+

Since: 1.48

+
+
+

nm_setting_wired_get_mtu ()

-
guint32
+
guint32
 nm_setting_wired_get_mtu (NMSettingWired *setting);

Parameters

@@ -857,7 +1166,7 @@ of 'qeth', 'lcs', or 'ctc'.


nm_setting_wired_get_num_s390_options ()

-
guint32
+
guint32
 nm_setting_wired_get_num_s390_options (NMSettingWired *setting);

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 @@ -885,9 +1194,9 @@ option individually using

nm_setting_wired_get_s390_option ()

-
gboolean
+
gboolean
 nm_setting_wired_get_s390_option (NMSettingWired *setting,
-                                  guint32 idx,
+                                  guint32 idx,
                                   const char **out_key,
                                   const char **out_value);

Given an index, return the value of the s390 option at that index. indexes @@ -934,8 +1243,8 @@ and should not be modified.

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 +

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)

@@ -973,14 +1282,14 @@ nm_setting_wired_get_s390_option_by_key

Returns

-

the value, or NULL if the key/value pair was never added to the +

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


nm_setting_wired_add_s390_option ()

-
gboolean
+
gboolean
 nm_setting_wired_add_s390_option (NMSettingWired *setting,
                                   const char *key,
                                   const char *value);
@@ -1017,13 +1326,13 @@ an invalid key gets silently added but renders the profile as invalid.

Returns

-

since 1.32 this always returns TRUE.

+

since 1.32 this always returns TRUE.


nm_setting_wired_remove_s390_option ()

-
gboolean
+
gboolean
 nm_setting_wired_remove_s390_option (NMSettingWired *setting,
                                      const char *key);

Remove the s390-specific option referenced by key @@ -1053,8 +1362,8 @@ list.

Returns

-

TRUE if the option was found and removed from the internal option -list, FALSE if it was not.

+

TRUE if the option was found and removed from the internal option +list, FALSE if it was not.


@@ -1065,7 +1374,7 @@ nm_setting_wired_get_valid_s390_options (NMSettingWired *setting);

Returns a list of valid s390 options.

The setting - argument is unused and NULL may be passed instead.

+ argument is unused and NULL may be passed instead.

Parameters

@@ -1077,14 +1386,14 @@ nm_setting_wired_get_valid_s390_options +and you may pass NULL.

setting

the NMSettingWired. This argument is unused -and you may pass NULL.

[nullable]

Returns

-

a NULL-terminated array of strings of valid s390 options.

+

a NULL-terminated array of strings of valid s390 options.

[transfer none]

@@ -1140,7 +1449,7 @@ nm_setting_wired_get_wake_on_lan_password

Returns

-

the Wake-on-LAN setting password, or NULL if there is no password.

+

the Wake-on-LAN setting password, or NULL if there is no password.

Since: 1.2

@@ -1303,6 +1612,12 @@ incompatible with other flags


+

NM_SETTING_WIRED_MAC_ADDRESS_DENYLIST

+
#define NM_SETTING_WIRED_MAC_ADDRESS_DENYLIST      "mac-address-denylist"
+
+
+
+

NM_SETTING_WIRED_MTU

#define NM_SETTING_WIRED_MTU                       "mtu"
 
-- cgit 1.3.0-6-gf8a5