NMConnection

@@ -39,2139 +32,2696 @@

NMConnection

NMConnection — Describes a connection to specific network or provider

- +

Synopsis

-#include <nm-connection.h>
-
-#define             NM_CONNECTION_SECRETS_UPDATED
-#define             NM_CONNECTION_SECRETS_CLEARED
-#define             NM_CONNECTION_CHANGED
-#define             NM_CONNECTION_PATH
-enum                NMConnectionError;
-#define             NM_CONNECTION_NORMALIZE_PARAM_IP6_CONFIG_METHOD
-#define             NM_CONNECTION_ERROR
-GQuark              nm_connection_error_quark           (void);
-                    NMConnection;
-                    NMConnectionClass;
-NMConnection *      nm_connection_new                   (void);
-NMConnection *      nm_connection_new_from_hash         (GHashTable *hash,
-                                                         GError **error);
-NMConnection *      nm_connection_duplicate             (NMConnection *connection);
-NMSetting *         nm_connection_create_setting        (const char *name);
-void                nm_connection_add_setting           (NMConnection *connection,
-                                                         NMSetting *setting);
-void                nm_connection_remove_setting        (NMConnection *connection,
-                                                         GType setting_type);
-NMSetting *         nm_connection_get_setting           (NMConnection *connection,
-                                                         GType setting_type);
-NMSetting *         nm_connection_get_setting_by_name   (NMConnection *connection,
-                                                         const char *name);
-gboolean            nm_connection_replace_settings      (NMConnection *connection,
-                                                         GHashTable *new_settings,
-                                                         GError **error);
-gboolean            nm_connection_replace_settings_from_connection
-                                                        (NMConnection *connection,
-                                                         NMConnection *new_connection,
-                                                         GError **error);
-gboolean            nm_connection_compare               (NMConnection *a,
-                                                         NMConnection *b,
-                                                         NMSettingCompareFlags flags);
-gboolean            nm_connection_diff                  (NMConnection *a,
-                                                         NMConnection *b,
-                                                         NMSettingCompareFlags flags,
-                                                         GHashTable **out_settings);
-gboolean            nm_connection_verify                (NMConnection *connection,
-                                                         GError **error);
-gboolean            nm_connection_normalize             (NMConnection *connection,
-                                                         GHashTable *parameters,
-                                                         gboolean *modified,
-                                                         GError **error);
-const char *        nm_connection_need_secrets          (NMConnection *connection,
-                                                         GPtrArray **hints);
-void                nm_connection_clear_secrets         (NMConnection *connection);
-void                nm_connection_clear_secrets_with_flags
-                                                        (NMConnection *connection,
-                                                         NMSettingClearSecretsWithFlagsFn func,
-                                                         gpointer user_data);
-gboolean            nm_connection_update_secrets        (NMConnection *connection,
-                                                         const char *setting_name,
-                                                         GHashTable *secrets,
-                                                         GError **error);
-void                nm_connection_set_path              (NMConnection *connection,
-                                                         const char *path);
-const char *        nm_connection_get_path              (NMConnection *connection);
-const char *        nm_connection_get_virtual_iface_name
-                                                        (NMConnection *connection);
-const char *        nm_connection_get_interface_name    (NMConnection *connection);
-gboolean            nm_connection_is_type               (NMConnection *connection,
-                                                         const char *type);
-void                nm_connection_for_each_setting_value
-                                                        (NMConnection *connection,
-                                                         NMSettingValueIterFn func,
-                                                         gpointer user_data);
-GHashTable *        nm_connection_to_hash               (NMConnection *connection,
-                                                         NMSettingHashFlags flags);
-void                nm_connection_dump                  (NMConnection *connection);
-GType               nm_connection_lookup_setting_type   (const char *name);
-GType               nm_connection_lookup_setting_type_by_quark
-                                                        (GQuark error_quark);
-const char *        nm_connection_get_uuid              (NMConnection *connection);
-const char *        nm_connection_get_id                (NMConnection *connection);
-const char *        nm_connection_get_connection_type   (NMConnection *connection);
-char *              nm_connection_get_virtual_device_description
-                                                        (NMConnection *connection);
-NMSetting8021x *    nm_connection_get_setting_802_1x    (NMConnection *connection);
-NMSettingBluetooth * nm_connection_get_setting_bluetooth
-                                                        (NMConnection *connection);
-NMSettingBond *     nm_connection_get_setting_bond      (NMConnection *connection);
-NMSettingTeam *     nm_connection_get_setting_team      (NMConnection *connection);
-NMSettingTeamPort * nm_connection_get_setting_team_port (NMConnection *connection);
-NMSettingBridge *   nm_connection_get_setting_bridge    (NMConnection *connection);
-NMSettingBridgePort * nm_connection_get_setting_bridge_port
-                                                        (NMConnection *connection);
-NMSettingCdma *     nm_connection_get_setting_cdma      (NMConnection *connection);
-NMSettingConnection * nm_connection_get_setting_connection
-                                                        (NMConnection *connection);
-NMSettingDcb *      nm_connection_get_setting_dcb       (NMConnection *connection);
-NMSettingGeneric *  nm_connection_get_setting_generic   (NMConnection *connection);
-NMSettingGsm *      nm_connection_get_setting_gsm       (NMConnection *connection);
-NMSettingInfiniband * nm_connection_get_setting_infiniband
-                                                        (NMConnection *connection);
-NMSettingIP4Config * nm_connection_get_setting_ip4_config
-                                                        (NMConnection *connection);
-NMSettingIP6Config * nm_connection_get_setting_ip6_config
-                                                        (NMConnection *connection);
-NMSettingOlpcMesh * nm_connection_get_setting_olpc_mesh (NMConnection *connection);
-NMSettingPPP *      nm_connection_get_setting_ppp       (NMConnection *connection);
-NMSettingPPPOE *    nm_connection_get_setting_pppoe     (NMConnection *connection);
-NMSettingSerial *   nm_connection_get_setting_serial    (NMConnection *connection);
-NMSettingVPN *      nm_connection_get_setting_vpn       (NMConnection *connection);
-NMSettingWimax *    nm_connection_get_setting_wimax     (NMConnection *connection);
-NMSettingAdsl *     nm_connection_get_setting_adsl      (NMConnection *connection);
-NMSettingWired *    nm_connection_get_setting_wired     (NMConnection *connection);
-NMSettingWireless * nm_connection_get_setting_wireless  (NMConnection *connection);
-NMSettingWirelessSecurity * nm_connection_get_setting_wireless_security
-                                                        (NMConnection *connection);
-NMSettingVlan *     nm_connection_get_setting_vlan      (NMConnection *connection);
-

Object Hierarchy

-  GEnum
-   +----NMConnectionError
-

-  GObject
-   +----NMConnection
-

Functions

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

+GQuark +	+nm_connection_error_quark () +
+NMConnection * +	+nm_connection_new () +
+NMConnection * +	+nm_connection_new_from_hash () +
+NMConnection * +	+nm_connection_duplicate () +
+NMSetting * +	+nm_connection_create_setting () +
+void +	+nm_connection_add_setting () +
+void +	+nm_connection_remove_setting () +
+NMSetting * +	+nm_connection_get_setting () +
+NMSetting * +	+nm_connection_get_setting_by_name () +
+gboolean +	+nm_connection_replace_settings () +
+gboolean +	+nm_connection_replace_settings_from_connection () +
+gboolean +	+nm_connection_compare () +
+gboolean +	+nm_connection_diff () +
+gboolean +	+nm_connection_verify () +
+gboolean +	+nm_connection_normalize () +
const char * +	+nm_connection_need_secrets () +
+void +	+nm_connection_clear_secrets () +
+void +	+nm_connection_clear_secrets_with_flags () +
+gboolean +	+nm_connection_update_secrets () +
+void +	+nm_connection_set_path () +
const char * +	+nm_connection_get_path () +
const char * +	+nm_connection_get_virtual_iface_name () +
const char * +	+nm_connection_get_interface_name () +
+gboolean +	+nm_connection_is_type () +
+void +	+nm_connection_for_each_setting_value () +
+GHashTable * +	+nm_connection_to_hash () +
+void +	+nm_connection_dump () +
+GType +	+nm_connection_lookup_setting_type () +
+GType +	+nm_connection_lookup_setting_type_by_quark () +
const char * +	+nm_connection_get_uuid () +
const char * +	+nm_connection_get_id () +
const char * +	+nm_connection_get_connection_type () +
+char * +	+nm_connection_get_virtual_device_description () +
+NMSetting8021x * +	+nm_connection_get_setting_802_1x () +
+NMSettingBluetooth * +	+nm_connection_get_setting_bluetooth () +
+NMSettingBond * +	+nm_connection_get_setting_bond () +
+NMSettingTeam * +	+nm_connection_get_setting_team () +
+NMSettingTeamPort * +	+nm_connection_get_setting_team_port () +
+NMSettingBridge * +	+nm_connection_get_setting_bridge () +
+NMSettingBridgePort * +	+nm_connection_get_setting_bridge_port () +
+NMSettingCdma * +	+nm_connection_get_setting_cdma () +
+NMSettingConnection * +	+nm_connection_get_setting_connection () +
+NMSettingDcb * +	+nm_connection_get_setting_dcb () +
+NMSettingGeneric * +	+nm_connection_get_setting_generic () +
+NMSettingGsm * +	+nm_connection_get_setting_gsm () +
+NMSettingInfiniband * +	+nm_connection_get_setting_infiniband () +
+NMSettingIP4Config * +	+nm_connection_get_setting_ip4_config () +
+NMSettingIP6Config * +	+nm_connection_get_setting_ip6_config () +
+NMSettingOlpcMesh * +	+nm_connection_get_setting_olpc_mesh () +
+NMSettingPPP * +	+nm_connection_get_setting_ppp () +
+NMSettingPPPOE * +	+nm_connection_get_setting_pppoe () +
+NMSettingSerial * +	+nm_connection_get_setting_serial () +
+NMSettingVPN * +	+nm_connection_get_setting_vpn () +
+NMSettingWimax * +	+nm_connection_get_setting_wimax () +
+NMSettingAdsl * +	+nm_connection_get_setting_adsl () +
+NMSettingWired * +	+nm_connection_get_setting_wired () +
+NMSettingWireless * +	+nm_connection_get_setting_wireless () +
+NMSettingWirelessSecurity * +	+nm_connection_get_setting_wireless_security () +
+NMSettingVlan * +	+nm_connection_get_setting_vlan () +

Properties

-  "path"                     gchar*                : Read / Write / Construct
-

+++++ + + + + + +

+gchar *

path

Read / Write / Construct

Signals

-  "changed"                                        : Run First
-  "secrets-cleared"                                : Run First
-  "secrets-updated"                                : Run First
-

Description

-An NMConnection describes all the settings and configuration values that -are necessary to configure network devices for operation on a specific -network. Connections are the fundamental operating object for -NetworkManager; no device is connected without a NMConnection, or -disconnected without having been connected with a NMConnection. -

-Each NMConnection contains a list of NMSetting objects usually referenced -by name (using nm_connection_get_setting_by_name()) or by type (with -nm_connection_get_setting()). The settings describe the actual parameters -with which the network devices are configured, including device-specific -parameters (MTU, SSID, APN, channel, rate, etc) and IP-level parameters -(addresses, routes, addressing methods, etc). -

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

void	changed	Run First
void	secrets-cleared	Run First
void	secrets-updated	Run First

Details

NM_CONNECTION_SECRETS_UPDATED

#define NM_CONNECTION_SECRETS_UPDATED "secrets-updated"
-

NM_CONNECTION_SECRETS_CLEARED

#define NM_CONNECTION_SECRETS_CLEARED "secrets-cleared"
-

NM_CONNECTION_CHANGED

#define NM_CONNECTION_CHANGED         "changed"
-

NM_CONNECTION_PATH

#define NM_CONNECTION_PATH "path"
-

enum NMConnectionError

typedef enum {
-	NM_CONNECTION_ERROR_UNKNOWN = 0,                  /*< nick=UnknownError >*/
-	NM_CONNECTION_ERROR_CONNECTION_SETTING_NOT_FOUND, /*< nick=ConnectionSettingNotFound >*/
-	NM_CONNECTION_ERROR_CONNECTION_TYPE_INVALID,      /*< nick=ConnectionTypeInvalid >*/
-	NM_CONNECTION_ERROR_SETTING_NOT_FOUND,            /*< nick=SettingNotFound >*/
-	NM_CONNECTION_ERROR_INVALID_SETTING,              /*< nick=InvalidSetting >*/
-} NMConnectionError;
-

-Describes errors that may result from operations involving a NMConnection. -

Types and Values

--++ - - + + - - + + - - + + - - + + - - + + + + + + + + + + + + + +

`NM_CONNECTION_ERROR_UNKNOWN`	unknown or unclassified error -	#define	NM_CONNECTION_SECRETS_UPDATED
`NM_CONNECTION_ERROR_CONNECTION_SETTING_NOT_FOUND`	the NMConnection object - did not contain the required NMSettingConnection object, which must be - present for all connections -	#define	NM_CONNECTION_SECRETS_CLEARED
`NM_CONNECTION_ERROR_CONNECTION_TYPE_INVALID`	the 'type' property of the - 'connection' setting did not point to a valid connection base type; ie - it was not a hardware-related setting like NMSettingWired or - NMSettingWireless. -	#define	NM_CONNECTION_CHANGED
`NM_CONNECTION_ERROR_SETTING_NOT_FOUND`	the NMConnection object - did not contain the specified NMSetting object -	#define	NM_CONNECTION_PATH
`NM_CONNECTION_ERROR_INVALID_SETTING`	the NMConnection object contains - a conflicting setting object -	enum	NMConnectionError
#define	NM_CONNECTION_NORMALIZE_PARAM_IP6_CONFIG_METHOD
#define	NM_CONNECTION_ERROR
	NMConnection

NM_CONNECTION_NORMALIZE_PARAM_IP6_CONFIG_METHOD

#define NM_CONNECTION_NORMALIZE_PARAM_IP6_CONFIG_METHOD "ip6-config-method"
+
+Object Hierarchy
+    GEnum
+    ╰── NMConnectionError
+    GObject
+    ╰── NMConnection
 
-
-
 
-
-
-NM_CONNECTION_ERROR
-#define NM_CONNECTION_ERROR nm_connection_error_quark ()
+
+Includes
+#include <nm-connection.h>
 
-
-
 
-
-
-nm_connection_error_quark ()
-GQuark              nm_connection_error_quark           (void);
-
-Registers an error quark for NMConnection if necessary.
-
-
----
-
-
-
-
-


Returns : the error quark used for NMConnection errors.
-
-
-
-NMConnection
-typedef struct _NMConnection NMConnection;
-
-The NMConnection struct contains only private data.
-It should only be accessed through the functions described below.
-
+
+Description
+An NMConnection describes all the settings and configuration values that
+are necessary to configure network devices for operation on a specific
+network.  Connections are the fundamental operating object for
+NetworkManager; no device is connected without a NMConnection, or
+disconnected without having been connected with a NMConnection.
+Each NMConnection contains a list of NMSetting objects usually referenced
+by name (using nm_connection_get_setting_by_name()) or by type (with
+nm_connection_get_setting()).  The settings describe the actual parameters
+with which the network devices are configured, including device-specific
+parameters (MTU, SSID, APN, channel, rate, etc) and IP-level parameters
+(addresses, routes, addressing methods, etc).
 
-
+
+Functions
 
-NMConnectionClass
-typedef struct {
-	GObjectClass parent;
-
-	/* Signals */
-	void (*secrets_updated) (NMConnection *connection, const char * setting);
-} NMConnectionClass;
-
-
-
+nm_connection_error_quark ()
+GQuark
+nm_connection_error_quark (void);
+Registers an error quark for NMConnection if necessary.
+
+Returns
+ the error quark used for NMConnection errors.
+
+
 
 
 
-nm_connection_new ()
-NMConnection *      nm_connection_new                   (void);
-
-Creates a new NMConnection object with no NMSetting objects.
-
-
----
-
-
-
-
-


Returns : the new empty NMConnection object
+nm_connection_new ()
+NMConnection *
+nm_connection_new (void);
+Creates a new NMConnection object with no NMSetting objects.
+
+Returns
+ the new empty NMConnection object
+
+
 
 
 
-nm_connection_new_from_hash ()
-NMConnection *      nm_connection_new_from_hash         (GHashTable *hash,
-                                                         GError **error);
-
-Creates a new NMConnection from a hash table describing the connection.  See
-nm_connection_to_hash() for a description of the expected hash table.
-
-
+nm_connection_new_from_hash ()
+NMConnection *
+nm_connection_new_from_hash (GHashTable *hash,
+                             GError **error);
+Creates a new NMConnection from a hash table describing the connection.  See
+nm_connection_to_hash() for a description of the expected hash table.
+
+Parameters
+
--+++
-
-
-
-
-
-
+
+
+
-
-
+
+
+
 





 
 
 hash : the GHashTable describing
-the connection. [element-type utf8 GLib.HashTable]
-
error : on unsuccessful return, an error hash  the GHashTable describing
+the connection. [element-type utf8 GLib.HashTable]
 
 Returns : the new NMConnection object, populated with settings created
-from the values in the hash table, or NULL if the connection failed to
-validate error on unsuccessful return, an error  
 
 
 
 
+
+Returns
+ the new NMConnection object, populated with settings created
+from the values in the hash table, or NULL if the connection failed to
+validate
+
+
+
 
 
-nm_connection_duplicate ()
-NMConnection *      nm_connection_duplicate             (NMConnection *connection);
-
-Duplicates a NMConnection.
-
-
+nm_connection_duplicate ()
+NMConnection *
+nm_connection_duplicate (NMConnection *connection);
+Duplicates a NMConnection.
+
+Parameters
+
--+++
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
 





 connection : the NMConnection to duplicate
Returns : a new NMConnection containing the same settings and properties
-as the source NMConnection. [transfer full]
-
connection the NMConnection to duplicate  
 
 
+
+Returns
+ a new NMConnection containing the same settings and properties
+as the source NMConnection. 
+[transfer full]
+
+
 
 
-nm_connection_create_setting ()
-NMSetting *         nm_connection_create_setting        (const char *name);
-
-Create a new NMSetting object of the desired type, given a setting name.
-
-
+nm_connection_create_setting ()
+NMSetting *
+nm_connection_create_setting (const char *name);
+Create a new NMSetting object of the desired type, given a setting name.
+
+Parameters
+
--+++
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
 





 name : a setting name
Returns : the new setting object, or NULL if the setting name was unknown. [transfer full]
-
name a setting name  
 
 
+
+Returns
+ the new setting object, or NULL if the setting name was unknown. 
+[transfer full]
+
+
 
 
-nm_connection_add_setting ()
-void                nm_connection_add_setting           (NMConnection *connection,
-                                                         NMSetting *setting);
-
-Adds a NMSetting to the connection, replacing any previous NMSetting of the
+
nm_connection_add_setting ()
+void
+nm_connection_add_setting (NMConnection *connection,
+                           NMSetting *setting);
+Adds a NMSetting to the connection, replacing any previous NMSetting of the
 same name which has previously been added to the NMConnection.  The
 connection takes ownership of the NMSetting object and does not increase
-the setting object's reference count.
-
-
+the setting object's reference count.
+
+Parameters
+
--+++
-
-
+
+
+
-
-
+
+
+
 





 
 
 connection : a NMConnection
- connection a NMConnection  
 
 setting : the NMSetting to add to the connection object. [transfer full]
- setting  the NMSetting to add to the connection object. [transfer full]
 
 
 
 
+

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 -operation dereferences the NMSetting object. -

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 +operation dereferences the NMSetting object.

Parameters

--+++ - - + + + - - + + +

`connection` :	a NMConnection -	connection	a NMConnection
`setting_type` :	the GType of the setting object to remove	setting_type	the GType of the setting object to remove

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 -to the NMConnection. -

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 +to the NMConnection.

Parameters

--+++ - - - - - - + + + - - + + +

`connection` :	a NMConnection -
`setting_type` :	the GType of the setting object to return	connection	a NMConnection
Returns :	the NMSetting, or `NULL` if no setting of that type was previously -added to the NMConnection. [transfer none] -	setting_type	the GType of the setting object to return

Returns

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

[transfer none]

`a` :	a NMConnection -
`b` :	a second NMConnection to compare with the first	a	a NMConnection
`flags` :	compare flags, e.g. `NM_SETTING_COMPARE_FLAG_EXACT` -	b	a second NMConnection to compare with the first
Returns :	-`TRUE` if the comparison succeeds, `FALSE` if it does not	flags	compare flags, e.g. `NM_SETTING_COMPARE_FLAG_EXACT`

`a` :	a NMConnection -	a	a NMConnection
`b` :	a second NMConnection to compare with the first	b	a second NMConnection to compare with the first
`flags` :	compare flags, e.g. `NM_SETTING_COMPARE_FLAG_EXACT` -	flags	compare flags, e.g. `NM_SETTING_COMPARE_FLAG_EXACT`
`out_settings` :	if the +	out_settings	if the connections differ, on return a hash table mapping setting names to second-level GHashTable (utf8 to guint32), which contains the key names that -differ mapped to one or more of `NMSettingDiffResult` as a bitfield. [element-type utf8 GLib.HashTable] -
Returns :	-`TRUE` if the connections contain the same values, `FALSE` if they do -not	[element-type utf8 GLib.HashTable]

`connection` :	the NMConnection to verify	connection	the NMConnection to verify
`error` :	location to store error, or `NULL` -
Returns :	-`TRUE` if the connection is valid, `FALSE` if it is not	error	location to store error, or `NULL`

`connection` :	the NMConnection to normalize	connection	the NMConnection to normalize
`parameters` :	a GHashTable with +	parameters	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, hashed by `g_str_hash()` and `g_str_equal()` functions. -The values are opaque and depend on the parameter name. [allow-none][element-type utf8 gpointer] -
`modified` :	outputs whether any settings were modified. [out][allow-none] -	[allow-none][element-type utf8 gpointer]
`error` :	location to store error, or `NULL`. Contains the reason, -why the connection is invalid, if the function returns an error.	modified	outputs whether any settings were modified.	[out][allow-none]
Returns :	-`TRUE` if the connection is valid, `FALSE` if it is not	error	location to store error, or `NULL`. Contains the reason, +why the connection is invalid, if the function returns an error.

`connection` :	the NMConnection -	connection	the NMConnection
`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 +	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 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 -elements. [out][element-type utf8][allow-none][transfer container] -
Returns :	the setting name of the NMSetting object which has invalid or -missing secrets	[out][element-type utf8][allow-none][transfer container]

			libnm-util Reference Manual
-Top - \| - Description - \| - Object Hierarchy - \| - Properties - \| - Signals -

`hash` :	the GHashTable describing -the connection. [element-type utf8 GLib.HashTable] -
`error` :	on unsuccessful return, an error	hash	the GHashTable describing +the connection.	[element-type utf8 GLib.HashTable]
Returns :	the new NMConnection object, populated with settings created -from the values in the hash table, or `NULL` if the connection failed to -validate	error	on unsuccessful return, an error

`connection` :	the NMConnection to duplicate
Returns :	a new NMConnection containing the same settings and properties -as the source NMConnection. [transfer full] -
connection	the NMConnection to duplicate

`name` :	a setting name
Returns :	the new setting object, or `NULL` if the setting name was unknown. [transfer full] -
name	a setting name

`connection` :	a NMConnection -
`new_settings` :	a GHashTable of settings. [element-type utf8 GLib.HashTable] -	connection	a NMConnection
`error` :	location to store error, or `NULL` -	new_settings	a GHashTable of settings.	[element-type utf8 GLib.HashTable]
Returns :	-`TRUE` if the settings were valid and added to the connection, `FALSE` -if they were not	error	location to store error, or `NULL`

`connection` :	a NMConnection -
`new_connection` :	a NMConnection to replace the settings of `connection` with	connection	a NMConnection
`error` :	location to store error, or `NULL` -	new_connection	a NMConnection to replace the settings of `connection` +with
Returns :	-`TRUE` if the settings were valid and added to the connection, `FALSE` -if they were not	error	location to store error, or `NULL`

`connection` :	the NMConnection -
`setting_name` :	the setting object name to which the secrets apply	connection	the NMConnection
`secrets` :	a GHashTable mapping -string:GValue of setting property names and secrets of the given `setting_name`. [element-type utf8 GObject.Value] -	setting_name	the setting object name to which the secrets apply
`error` :	location to store error, or `NULL` -	secrets	a GHashTable mapping +string:GValue of setting property names and secrets of the given `setting_name` +.	[element-type utf8 GObject.Value]
Returns :	-`TRUE` if the secrets were successfully updated, `FALSE` if the update -failed (tried to update secrets for a setting that doesn't exist, etc)	error	location to store error, or `NULL`

`connection` :	the NMConnection -
`type` :	a setting name to check the connection's type against (like -`NM_SETTING_WIRELESS_SETTING_NAME` or `NM_SETTING_WIRED_SETTING_NAME`)	connection	the NMConnection
Returns :	-`TRUE` if the connection is of the given `type`, `FALSE` if not	flags	hash flags, e.g. `NM_SETTING_HASH_FLAG_ALL`

`connection` :	the NMConnection -
`func` :	user-supplied function called for each setting's property. [scope call] -
`user_data` :	user data passed to `func` at each invocation
connection	the NMConnection

`error_quark` :	a setting error quark
Returns :	the GType of the setting's class
connection	the NMConnection

`connection` :	an NMConnection for a virtual device type
Returns :	the name of `connection`'s device, -or `NULL` if `connection` is not a virtual connection type. [transfer full] -
connection	the NMConnection

`connection` :	the NMConnection +	NM_CONNECTION_ERROR_UNKNOWN	+ unknown or unclassified error
Returns :	an NMSettingWired if the connection contains one, otherwise `NULL`. [transfer none] +	NM_CONNECTION_ERROR_CONNECTION_SETTING_NOT_FOUND	+ the NMConnection object + did not contain the required NMSettingConnection object, which must be + present for all connections
NM_CONNECTION_ERROR_CONNECTION_TYPE_INVALID	+ the 'type' property of the + 'connection' setting did not point to a valid connection base type; ie + it was not a hardware-related setting like NMSettingWired or + NMSettingWireless. +

`connection` :	the NMConnection +	NM_CONNECTION_ERROR_SETTING_NOT_FOUND	+ the NMConnection object + did not contain the specified NMSetting object
Returns :	an NMSettingWireless if the connection contains one, otherwise `NULL`. [transfer none] +	NM_CONNECTION_ERROR_INVALID_SETTING	+ the NMConnection object contains + a conflicting setting object

`connection` :	the object on which the signal is emitted	connection	the object on which the signal is emitted
`user_data` :	user data set when the signal handler was connected.	user_data	user data set when the signal handler was connected.

NMConnection

Synopsis

Object Hierarchy

Functions

Properties

Signals

Description

Details

NM_CONNECTION_SECRETS_UPDATED

NM_CONNECTION_SECRETS_CLEARED

NM_CONNECTION_CHANGED

NM_CONNECTION_PATH

enum NMConnectionError

Types and Values

NM_CONNECTION_NORMALIZE_PARAM_IP6_CONFIG_METHOD

Object Hierarchy

NM_CONNECTION_ERROR

Includes

nm_connection_error_quark ()

NMConnection

Description

Functions

NMConnectionClass

nm_connection_error_quark ()

Returns

nm_connection_new ()

nm_connection_new ()

Returns

nm_connection_new_from_hash ()

nm_connection_new_from_hash ()

Parameters

Returns

nm_connection_duplicate ()

nm_connection_duplicate ()

Parameters

Returns

nm_connection_create_setting ()

nm_connection_create_setting ()

Parameters

Returns

nm_connection_add_setting ()

nm_connection_add_setting ()

Parameters

nm_connection_remove_setting ()

nm_connection_remove_setting ()

Parameters

nm_connection_get_setting ()

nm_connection_get_setting ()

Parameters

Returns

nm_connection_get_setting_by_name ()

nm_connection_get_setting_by_name ()

Parameters

Returns

nm_connection_replace_settings ()

nm_connection_replace_settings ()

Parameters

Returns

nm_connection_replace_settings_from_connection ()

nm_connection_replace_settings_from_connection ()

Parameters

Returns

nm_connection_compare ()

nm_connection_compare ()

Parameters

Returns

nm_connection_diff ()

nm_connection_diff ()

Parameters

Returns

nm_connection_verify ()

nm_connection_verify ()

Parameters

Returns

nm_connection_normalize ()

nm_connection_normalize ()

Parameters

Returns

nm_connection_need_secrets ()

nm_connection_need_secrets ()