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/NMConnection.html | 230 +++++++++++++++++++------------------- 1 file changed, 115 insertions(+), 115 deletions(-) (limited to 'docs/libnm/html/NMConnection.html') diff --git a/docs/libnm/html/NMConnection.html b/docs/libnm/html/NMConnection.html index cdd050db..75cc154a 100644 --- a/docs/libnm/html/NMConnection.html +++ b/docs/libnm/html/NMConnection.html @@ -74,7 +74,7 @@ -GVariant * +GVariant * nm_connection_to_dbus () @@ -82,7 +82,7 @@ -gboolean +gboolean nm_connection_replace_settings () @@ -106,7 +106,7 @@ -gboolean +gboolean nm_connection_compare () @@ -114,7 +114,7 @@ -gboolean +gboolean nm_connection_diff () @@ -122,7 +122,7 @@ -gboolean +gboolean nm_connection_verify () @@ -130,7 +130,7 @@ -gboolean +gboolean nm_connection_verify_secrets () @@ -138,7 +138,7 @@ -gboolean +gboolean nm_connection_normalize () @@ -169,7 +169,7 @@ -gboolean +gboolean nm_connection_update_secrets () @@ -199,7 +199,7 @@ -gboolean +gboolean nm_connection_is_type () @@ -252,7 +252,7 @@ -gboolean +gboolean nm_connection_is_virtual () @@ -675,8 +675,8 @@ the setting object's reference count.

nm_connection_remove_setting ()

void
 nm_connection_remove_setting (NMConnection *connection,
-                              GType setting_type);
-

Removes the NMSetting with the given GType from the NMConnection. This + GType setting_type); +

Removes the NMSetting with the given GType from the NMConnection. This operation dereferences the NMSetting object.

Parameters

@@ -694,7 +694,7 @@ operation dereferences the

setting_type

-

the GType of the setting object to remove

+

the GType of the setting object to remove

  @@ -706,8 +706,8 @@ operation dereferences the

nm_connection_get_setting ()

NMSetting *
 nm_connection_get_setting (NMConnection *connection,
-                           GType setting_type);
-

Gets the NMSetting with the given GType, if one has been previously added + GType setting_type); +

Gets the NMSetting with the given GType, if one has been previously added to the NMConnection.

Parameters

@@ -725,7 +725,7 @@ to the

setting_type

-

the GType of the setting object to return

+

the GType of the setting object to return

  @@ -733,7 +733,7 @@ to the

Returns

-

the NMSetting, or NULL if no setting of that type was previously +

the NMSetting, or NULL if no setting of that type was previously added to the NMConnection.

[transfer none]

@@ -770,7 +770,7 @@ the

Returns

-

the NMSetting, or NULL if no setting with that name was previously +

the NMSetting, or NULL if no setting with that name was previously added to the NMConnection.

[transfer none]

@@ -778,10 +778,10 @@ added to the

nm_connection_to_dbus ()

-
GVariant *
+
GVariant *
 nm_connection_to_dbus (NMConnection *connection,
                        NMConnectionSerializationFlags flags);

-
Converts the NMConnection into a GVariant of type
+
Converts the NMConnection into a GVariant of type
 NM_VARIANT_TYPE_CONNECTION describing the connection, suitable for
 marshalling over D-Bus or otherwise serializing.

 

@@ -808,7 +808,7 @@ marshalling over D-Bus or otherwise serializing.

 

 

 
Returns

-
a new floating GVariant describing the connection,
+
a new floating GVariant describing the connection,
 its settings, and each setting's properties. 

 
[transfer none]

 

@@ -816,10 +816,10 @@ its settings, and each setting's properties. 

 

 

 
nm_connection_replace_settings ()

-
gboolean
+
gboolean
 nm_connection_replace_settings (NMConnection *connection,
-                                GVariant *new_settings,
-                                GError **error);

+                                GVariant *new_settings,
+                                GError **error);

 
Replaces connection
 's settings with new_settings
  (which must be
@@ -841,12 +841,12 @@ need to result in a connection that passes 
new_settings

-
a GVariant of type NM_VARIANT_TYPE_CONNECTION, with the new settings

+
a GVariant of type NM_VARIANT_TYPE_CONNECTION, with the new settings

  
 
 
 
error

-
location to store error, or NULL

+
location to store error, or NULL

  
 
 
@@ -854,7 +854,7 @@ need to result in a connection that passes 
 
Returns

-
 TRUE if connection was updated, FALSE if new_settings
+
 TRUE if connection was updated, FALSE if new_settings
 could not
 be deserialized (in which case connection
 will be unchanged).

@@ -921,7 +921,7 @@ nm_connection_clear_settings (
 
nm_connection_compare ()

-
gboolean
+
gboolean
 nm_connection_compare (NMConnection *a,
                        NMConnection *b,
                        NMSettingCompareFlags flags);

@@ -957,17 +957,17 @@ each flag's behavior.

 

 

 
Returns

-
 TRUE if the comparison succeeds, FALSE if it does not

+
 TRUE if the comparison succeeds, FALSE if it does not

nm_connection_diff ()

-
gboolean
+
gboolean
 nm_connection_diff (NMConnection *a,
                     NMConnection *b,
                     NMSettingCompareFlags flags,
-                    GHashTable **out_settings);

+                    GHashTable **out_settings);

Compares two NMConnection objects for similarity, with comparison behavior modified by a set of flags. See nm_setting_compare() for a description of each flag's behavior. If the connections differ, settings and keys within @@ -1011,16 +1011,16 @@ contains the key names that differ mapped to one or more of

Returns

-

TRUE if the connections contain the same values, FALSE if they do +

TRUE if the connections contain the same values, FALSE if they do not

nm_connection_verify ()

-
gboolean
+
gboolean
 nm_connection_verify (NMConnection *connection,
-                      GError **error);

+                      GError **error);

Validates the connection and all its settings. Each setting's properties have allowed values, and some values are dependent on other values. For example, if a Wi-Fi connection is security enabled, the NMSettingWireless @@ -1028,7 +1028,7 @@ setting object's 'security' property must contain the setting name of the NMSettingWirelessSecurity object, which must also be present in the connection for the connection to be valid. As another example, the NMSettingWired object's 'mac-address' property must be a validly formatted -MAC address. The returned GError contains information about which +MAC address. The returned GError contains information about which setting and which property failed validation, and how it failed validation.

Parameters

@@ -1046,7 +1046,7 @@ setting and which property failed validation, and how it failed validation.

error

-

location to store error, or NULL

+

location to store error, or NULL

  @@ -1054,15 +1054,15 @@ setting and which property failed validation, and how it failed validation.

Returns

-

TRUE if the connection is valid, FALSE if it is not

+

TRUE if the connection is valid, FALSE if it is not

nm_connection_verify_secrets ()

-
gboolean
+
gboolean
 nm_connection_verify_secrets (NMConnection *connection,
-                              GError **error);

+                              GError **error);

Verifies the secrets in the connection.

Parameters

@@ -1080,7 +1080,7 @@ nm_connection_verify_secrets (

error

-

location to store error, or NULL

+

location to store error, or NULL

  @@ -1088,23 +1088,23 @@ nm_connection_verify_secrets (

Returns

-

TRUE if the secrets are valid, FALSE if they are not

+

TRUE if the secrets are valid, FALSE if they are not

Since: 1.2

nm_connection_normalize ()

-
gboolean
+
gboolean
 nm_connection_normalize (NMConnection *connection,
-                         GHashTable *parameters,
-                         gboolean *modified,
-                         GError **error);

+                         GHashTable *parameters,
+                         gboolean *modified,
+                         GError **error);

Does some basic normalization and fixup of well known inconsistencies and deprecated fields. If the connection was modified in any way, the output parameter modified - is set TRUE.

-

Finally the connection will be verified and TRUE returns if the connection + is set TRUE.

+

Finally the connection will be verified and TRUE returns if the connection is valid. As this function only performs some specific normalization steps it cannot repair all connections. If the connection has errors that cannot be normalized, the connection will not be modified.

@@ -1124,10 +1124,10 @@ cannot be normalized, the connection will not be modified.

parameters

-

a GHashTable with +

a GHashTable with normalization parameters to allow customization of the normalization by providing specific arguments. Unknown arguments will be ignored and the default will be -used. The keys must be strings compared with g_str_equal() function. +used. The keys must be strings compared with g_str_equal() function. The values are opaque and depend on the parameter name.

[nullable][element-type utf8 gpointer] @@ -1138,7 +1138,7 @@ The values are opaque and depend on the parameter name.

error

-

location to store error, or NULL. Contains the reason, +

location to store error, or NULL. Contains the reason, why the connection is invalid, if the function returns an error.

  @@ -1147,7 +1147,7 @@ why the connection is invalid, if the function returns an error.

Returns

-

TRUE if the connection is valid, FALSE if it is not

+

TRUE if the connection is valid, FALSE if it is not

@@ -1155,7 +1155,7 @@ why the connection is invalid, if the function returns an error.

nm_connection_need_secrets ()

const char *
 nm_connection_need_secrets (NMConnection *connection,
-                            GPtrArray **hints);
+ GPtrArray **hints);

Returns the name of the first setting object in the connection which would need secrets to make a successful connection. The returned hints are only intended as a guide to what secrets may be required, because in some @@ -1177,10 +1177,10 @@ secrets are needed.

hints

-

the address of a pointer to a GPtrArray, initialized to NULL, which on -return points to an allocated GPtrArray containing the property names of +

the address of a pointer to a GPtrArray, initialized to NULL, which on +return points to an allocated GPtrArray containing the property names of secrets of the NMSetting which may be required; the caller owns the array -and must free the array itself with g_ptr_array_free(), but not free its +and must free the array itself with g_ptr_array_free(), but not free its elements.

[out][element-type utf8][nullable][transfer container] @@ -1224,7 +1224,7 @@ keeping secret data in memory when not needed.

nm_connection_clear_secrets_with_flags (NMConnection *connection, NMSettingClearSecretsWithFlagsFn func, - gpointer user_data); + gpointer user_data);

Clears and frees secrets determined by func .

@@ -1244,7 +1244,7 @@ nm_connection_clear_secrets_with_flags

func

function to be called to determine whether a -specific secret should be cleared or not. If NULL, all secrets are cleared.

+specific secret should be cleared or not. If NULL, all secrets are cleared.

[scope call][nullable] @@ -1260,16 +1260,16 @@ specific secret should be cleared or not. If

nm_connection_update_secrets ()

-
gboolean
+
gboolean
 nm_connection_update_secrets (NMConnection *connection,
                               const char *setting_name,
-                              GVariant *secrets,
-                              GError **error);

+                              GVariant *secrets,
+                              GError **error);

Update the specified setting's secrets, given a dictionary of secrets intended for that setting (deserialized from D-Bus for example). Will also extract the given setting's secrets hash if given a connection dictionary. If setting_name - is NULL, expects a fully serialized NMConnection as + is NULL, expects a fully serialized NMConnection as returned by nm_connection_to_dbus() and will update all secrets from all settings contained in secrets .

@@ -1294,13 +1294,13 @@ settings contained in secrets

secrets

-

a GVariant of secrets, of type NM_VARIANT_TYPE_CONNECTION +

a GVariant of secrets, of type NM_VARIANT_TYPE_CONNECTION or NM_VARIANT_TYPE_SETTING

 

error

-

location to store error, or NULL

+

location to store error, or NULL

  @@ -1308,7 +1308,7 @@ or

Returns

-

TRUE if the secrets were successfully updated, FALSE if the update +

TRUE if the secrets were successfully updated, FALSE if the update failed (tried to update secrets for a setting that doesn't exist, etc)

@@ -1378,7 +1378,7 @@ nm_connection_get_path (const char * nm_connection_get_interface_name (NMConnection *connection);

Returns the interface name as stored in NMSettingConnection:interface_name. -If the connection contains no NMSettingConnection, it will return NULL.

+If the connection contains no NMSettingConnection, it will return NULL.

For hardware devices and software devices created outside of NetworkManager, this name is used to match the device. for software devices created by NetworkManager, this is the name of the created interface.

@@ -1399,13 +1399,13 @@ NetworkManager, this is the name of the created interface.

Returns

-

Name of the kernel interface or NULL

+

Name of the kernel interface or NULL

nm_connection_is_type ()

-
gboolean
+
gboolean
 nm_connection_is_type (NMConnection *connection,
                        const char *type);

 
A convenience function to check if the given connection
@@ -1438,8 +1438,8 @@ property of the connection and matches that against

Returns

-

TRUE if the connection is of the given type -, FALSE if not

+

TRUE if the connection is of the given type +, FALSE if not

@@ -1448,7 +1448,7 @@ property of the connection and matches that against 
void
 nm_connection_for_each_setting_value (NMConnection *connection,
                                       NMSettingValueIterFn func,
-                                      gpointer user_data);
+ gpointer user_data);

Iterates over the properties of each NMSetting object in the NMConnection, calling the supplied user function for each property.

@@ -1485,10 +1485,10 @@ at each invocation

nm_connection_get_settings ()

NMSetting **
 nm_connection_get_settings (NMConnection *connection,
-                            guint *out_length);
+ guint *out_length);

Retrieves the settings in connection .

-

The returned array is NULL-terminated.

+

The returned array is NULL-terminated.

Parameters

@@ -1514,9 +1514,9 @@ nm_connection_get_settings (

Returns

a -NULL-terminated array containing every setting of connection +NULL-terminated array containing every setting of connection . -If the connection has no settings, NULL is returned.

+If the connection has no settings, NULL is returned.

[array length=out_length][transfer container][nullable]

Since: 1.10

@@ -1627,7 +1627,7 @@ nm_connection_get_connection_type (

nm_connection_is_virtual ()

-
gboolean
+
gboolean
 nm_connection_is_virtual (NMConnection *connection);

 
Checks if connection
  refers to a virtual device (and thus can potentially be
@@ -1682,7 +1682,7 @@ Eg, "VLAN (eth1.1)".

 
Returns

 
the name of connection
 's device,
-or NULL if connection
+or NULL if connection
 is not a virtual connection type. 

 
[transfer full]
@@ -1710,7 +1710,7 @@ nm_connection_get_setting_802_1x (

Returns

-

an NMSetting8021x if the connection contains one, otherwise NULL.

+

an NMSetting8021x if the connection contains one, otherwise NULL.

[transfer none]

@@ -1737,7 +1737,7 @@ nm_connection_get_setting_bluetooth (

Returns

-

an NMSettingBluetooth if the connection contains one, otherwise NULL.

+

an NMSettingBluetooth if the connection contains one, otherwise NULL.

[transfer none]

@@ -1764,7 +1764,7 @@ nm_connection_get_setting_bond (

Returns

-

an NMSettingBond if the connection contains one, otherwise NULL.

+

an NMSettingBond if the connection contains one, otherwise NULL.

[transfer none]

@@ -1791,7 +1791,7 @@ nm_connection_get_setting_team (

Returns

-

an NMSettingTeam if the connection contains one, otherwise NULL.

+

an NMSettingTeam if the connection contains one, otherwise NULL.

[transfer none]

@@ -1818,7 +1818,7 @@ nm_connection_get_setting_team_port (

Returns

-

an NMSettingTeamPort if the connection contains one, otherwise NULL.

+

an NMSettingTeamPort if the connection contains one, otherwise NULL.

[transfer none]

@@ -1845,7 +1845,7 @@ nm_connection_get_setting_bridge (

Returns

-

an NMSettingBridge if the connection contains one, otherwise NULL.

+

an NMSettingBridge if the connection contains one, otherwise NULL.

[transfer none]

@@ -1872,7 +1872,7 @@ nm_connection_get_setting_bridge_port (

Returns

-

an NMSettingBridgePort if the connection contains one, otherwise NULL.

+

an NMSettingBridgePort if the connection contains one, otherwise NULL.

[transfer none]

@@ -1899,7 +1899,7 @@ nm_connection_get_setting_cdma (

Returns

-

an NMSettingCdma if the connection contains one, otherwise NULL.

+

an NMSettingCdma if the connection contains one, otherwise NULL.

[transfer none]

@@ -1926,7 +1926,7 @@ nm_connection_get_setting_connection (

Returns

-

an NMSettingConnection if the connection contains one, otherwise NULL.

+

an NMSettingConnection if the connection contains one, otherwise NULL.

[transfer none]

@@ -1980,7 +1980,7 @@ nm_connection_get_setting_dummy (

Returns

-

an NMSettingDummy if the connection contains one, otherwise NULL.

+

an NMSettingDummy if the connection contains one, otherwise NULL.

[transfer none]

Since: 1.8

@@ -2035,7 +2035,7 @@ nm_connection_get_setting_gsm (

Returns

-

an NMSettingGsm if the connection contains one, otherwise NULL.

+

an NMSettingGsm if the connection contains one, otherwise NULL.

[transfer none]

@@ -2062,7 +2062,7 @@ nm_connection_get_setting_infiniband (

Returns

-

an NMSettingInfiniband if the connection contains one, otherwise NULL.

+

an NMSettingInfiniband if the connection contains one, otherwise NULL.

[transfer none]

@@ -2089,7 +2089,7 @@ nm_connection_get_setting_ip_tunnel (

Returns

-

an NMSettingIPTunnel if the connection contains one, otherwise NULL.

+

an NMSettingIPTunnel if the connection contains one, otherwise NULL.

[transfer none]

Since: 1.2

@@ -2121,7 +2121,7 @@ majority of IPv4-setting-related methods are on that type, not

Returns

an NMSettingIP4Config if the -connection contains one, otherwise NULL.

+connection contains one, otherwise NULL.

[type NMSettingIP4Config][transfer none]

@@ -2152,7 +2152,7 @@ majority of IPv6-setting-related methods are on that type, not

Returns

an NMSettingIP6Config if the -connection contains one, otherwise NULL.

+connection contains one, otherwise NULL.

[type NMSettingIP6Config][transfer none]

@@ -2179,7 +2179,7 @@ nm_connection_get_setting_macsec (

Returns

-

an NMSettingMacsec if the connection contains one, otherwise NULL.

+

an NMSettingMacsec if the connection contains one, otherwise NULL.

[transfer none]

Since: 1.6

@@ -2207,7 +2207,7 @@ nm_connection_get_setting_macvlan (

Returns

-

an NMSettingMacvlan if the connection contains one, otherwise NULL.

+

an NMSettingMacvlan if the connection contains one, otherwise NULL.

[transfer none]

Since: 1.2

@@ -2235,7 +2235,7 @@ nm_connection_get_setting_olpc_mesh (

Returns

-

an NMSettingOlpcMesh if the connection contains one, otherwise NULL.

+

an NMSettingOlpcMesh if the connection contains one, otherwise NULL.

[transfer none]

@@ -2262,7 +2262,7 @@ nm_connection_get_setting_ovs_bridge (

Returns

-

an NMSettingOvsBridge if the connection contains one, otherwise NULL.

+

an NMSettingOvsBridge if the connection contains one, otherwise NULL.

[transfer none]

Since: 1.14

@@ -2291,7 +2291,7 @@ nm_connection_get_setting_ovs_interface

Returns

-

an NMSettingOvsInterface if the connection contains one, otherwise NULL.

+

an NMSettingOvsInterface if the connection contains one, otherwise NULL.

[transfer none]

Since: 1.14

@@ -2319,7 +2319,7 @@ nm_connection_get_setting_ovs_patch (

Returns

-

an NMSettingOvsPatch if the connection contains one, otherwise NULL.

+

an NMSettingOvsPatch if the connection contains one, otherwise NULL.

[transfer none]

Since: 1.14

@@ -2347,7 +2347,7 @@ nm_connection_get_setting_ovs_port (

Returns

-

an NMSettingOvsPort if the connection contains one, otherwise NULL.

+

an NMSettingOvsPort if the connection contains one, otherwise NULL.

[transfer none]

Since: 1.14

@@ -2375,7 +2375,7 @@ nm_connection_get_setting_ppp (

Returns

-

an NMSettingPpp if the connection contains one, otherwise NULL.

+

an NMSettingPpp if the connection contains one, otherwise NULL.

[transfer none]

@@ -2402,7 +2402,7 @@ nm_connection_get_setting_pppoe (

Returns

-

an NMSettingPppoe if the connection contains one, otherwise NULL.

+

an NMSettingPppoe if the connection contains one, otherwise NULL.

[transfer none]

@@ -2429,7 +2429,7 @@ nm_connection_get_setting_proxy (

Returns

-

an NMSettingProxy if the connection contains one, otherwise NULL.

+

an NMSettingProxy if the connection contains one, otherwise NULL.

[transfer none]

Since: 1.6

@@ -2457,7 +2457,7 @@ nm_connection_get_setting_serial (

Returns

-

an NMSettingSerial if the connection contains one, otherwise NULL.

+

an NMSettingSerial if the connection contains one, otherwise NULL.

[transfer none]

@@ -2484,7 +2484,7 @@ nm_connection_get_setting_tc_config (

Returns

-

an NMSettingTCConfig if the connection contains one, otherwise NULL.

+

an NMSettingTCConfig if the connection contains one, otherwise NULL.

[transfer none]

Since: 1.12

@@ -2512,7 +2512,7 @@ nm_connection_get_setting_tun (

Returns

-

an NMSettingTun if the connection contains one, otherwise NULL.

+

an NMSettingTun if the connection contains one, otherwise NULL.

[transfer none]

Since: 1.14

@@ -2540,7 +2540,7 @@ nm_connection_get_setting_vpn (

Returns

-

an NMSettingVpn if the connection contains one, otherwise NULL.

+

an NMSettingVpn if the connection contains one, otherwise NULL.

[transfer none]

@@ -2567,7 +2567,7 @@ nm_connection_get_setting_wimax (

Returns

-

an NMSettingWimax if the connection contains one, otherwise NULL.

+

an NMSettingWimax if the connection contains one, otherwise NULL.

[transfer none]

@@ -2594,7 +2594,7 @@ nm_connection_get_setting_adsl (

Returns

-

an NMSettingAdsl if the connection contains one, otherwise NULL.

+

an NMSettingAdsl if the connection contains one, otherwise NULL.

[transfer none]

@@ -2621,7 +2621,7 @@ nm_connection_get_setting_wired (

Returns

-

an NMSettingWired if the connection contains one, otherwise NULL.

+

an NMSettingWired if the connection contains one, otherwise NULL.

[transfer none]

@@ -2648,7 +2648,7 @@ nm_connection_get_setting_wireless (

Returns

-

an NMSettingWireless if the connection contains one, otherwise NULL.

+

an NMSettingWireless if the connection contains one, otherwise NULL.

[transfer none]

@@ -2676,7 +2676,7 @@ nm_connection_get_setting_wireless_security

Returns

-

an NMSettingWirelessSecurity if the connection contains one, otherwise NULL.

+

an NMSettingWirelessSecurity if the connection contains one, otherwise NULL.

[transfer none]

@@ -2703,7 +2703,7 @@ nm_connection_get_setting_vlan (

Returns

-

an NMSettingVlan if the connection contains one, otherwise NULL.

+

an NMSettingVlan if the connection contains one, otherwise NULL.

[transfer none]

@@ -2730,7 +2730,7 @@ nm_connection_get_setting_vxlan (

Returns

-

an NMSettingVxlan if the connection contains one, otherwise NULL.

+

an NMSettingVxlan if the connection contains one, otherwise NULL.

[transfer none]

Since: 1.2

@@ -2789,7 +2789,7 @@ nm_connection_get_setting_vxlan ( - + @@ -2817,8 +2817,8 @@ nm_connection_get_setting_vxlan (

NM_VARIANT_TYPE_SETTING

#define NM_VARIANT_TYPE_SETTING G_VARIANT_TYPE_VARDICT
-

GVariantType for a dictionary mapping from property names to values. This is -an alias for G_VARIANT_TYPE_VARDICT, and is the type of each element of +

GVariantType for a dictionary mapping from property names to values. This is +an alias for G_VARIANT_TYPE_VARDICT, and is the type of each element of an NM_VARIANT_TYPE_CONNECTION dictionary.

-- cgit 1.3.0-6-gf8a5

GTypeInterface parent;

GTypeInterface parent;

the parent interface struct