NMSettingConnection: libnm Reference Manual

+ + +

NMSettingConnection

NMSettingConnection — Describes general connection properties

Functions

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

+NMSetting * +	+nm_setting_connection_new () +
const char * +	+nm_setting_connection_get_id () +
const char * +	+nm_setting_connection_get_uuid () +
const char * +	+nm_setting_connection_get_stable_id () +
const char * +	+nm_setting_connection_get_interface_name () +
const char * +	+nm_setting_connection_get_connection_type () +
+gboolean +	+nm_setting_connection_get_autoconnect () +
+int +	+nm_setting_connection_get_autoconnect_priority () +
+int +	+nm_setting_connection_get_autoconnect_retries () +
+NMConnectionMultiConnect +	+nm_setting_connection_get_multi_connect () +
+guint64 +	+nm_setting_connection_get_timestamp () +
+gboolean +	+nm_setting_connection_get_read_only () +
+guint32 +	+nm_setting_connection_get_num_permissions () +
+gboolean +	+nm_setting_connection_get_permission () +
const char * +	+nm_setting_connection_get_zone () +
+gboolean +	+nm_setting_connection_permissions_user_allowed () +
+gboolean +	+nm_setting_connection_add_permission () +
+void +	+nm_setting_connection_remove_permission () +
+gboolean +	+nm_setting_connection_remove_permission_by_value () +
const char * +	+nm_setting_connection_get_master () +
+gboolean +	+nm_setting_connection_is_slave_type () +
const char * +	+nm_setting_connection_get_slave_type () +
+NMSettingConnectionAutoconnectSlaves +	+nm_setting_connection_get_autoconnect_slaves () +
+guint32 +	+nm_setting_connection_get_num_secondaries () +
const char * +	+nm_setting_connection_get_secondary () +
+gboolean +	+nm_setting_connection_add_secondary () +
+void +	+nm_setting_connection_remove_secondary () +
+gboolean +	+nm_setting_connection_remove_secondary_by_value () +
+guint32 +	+nm_setting_connection_get_gateway_ping_timeout () +
+NMMetered +	+nm_setting_connection_get_metered () +
+NMSettingConnectionLldp +	+nm_setting_connection_get_lldp () +
+int +	+nm_setting_connection_get_auth_retries () +
+NMSettingConnectionMdns +	+nm_setting_connection_get_mdns () +
+NMSettingConnectionLlmnr +	+nm_setting_connection_get_llmnr () +
+NMSettingConnectionDnsOverTls +	+nm_setting_connection_get_dns_over_tls () +
+NMMptcpFlags +	+nm_setting_connection_get_mptcp_flags () +
+gint32 +	+nm_setting_connection_get_wait_device_timeout () +
+gint32 +	+nm_setting_connection_get_wait_activation_delay () +
const char * +	+nm_setting_connection_get_mud_url () +

Types and Values

#define	NM_SETTING_CONNECTION_SETTING_NAME
#define	NM_SETTING_CONNECTION_AUTOCONNECT_PRIORITY_MIN
#define	NM_SETTING_CONNECTION_AUTOCONNECT_PRIORITY_MAX
#define	NM_SETTING_CONNECTION_AUTOCONNECT_PRIORITY_DEFAULT
#define	NM_SETTING_CONNECTION_ID
#define	NM_SETTING_CONNECTION_UUID
#define	NM_SETTING_CONNECTION_STABLE_ID
#define	NM_SETTING_CONNECTION_INTERFACE_NAME
#define	NM_SETTING_CONNECTION_TYPE
#define	NM_SETTING_CONNECTION_AUTOCONNECT
#define	NM_SETTING_CONNECTION_AUTOCONNECT_PRIORITY
#define	NM_SETTING_CONNECTION_AUTOCONNECT_RETRIES
#define	NM_SETTING_CONNECTION_MULTI_CONNECT
#define	NM_SETTING_CONNECTION_TIMESTAMP
#define	NM_SETTING_CONNECTION_READ_ONLY
#define	NM_SETTING_CONNECTION_PERMISSIONS
#define	NM_SETTING_CONNECTION_ZONE
#define	NM_SETTING_CONNECTION_MASTER
#define	NM_SETTING_CONNECTION_SLAVE_TYPE
#define	NM_SETTING_CONNECTION_AUTOCONNECT_SLAVES
#define	NM_SETTING_CONNECTION_SECONDARIES
#define	NM_SETTING_CONNECTION_GATEWAY_PING_TIMEOUT
#define	NM_SETTING_CONNECTION_METERED
#define	NM_SETTING_CONNECTION_LLDP
#define	NM_SETTING_CONNECTION_AUTH_RETRIES
#define	NM_SETTING_CONNECTION_MDNS
#define	NM_SETTING_CONNECTION_LLMNR
#define	NM_SETTING_CONNECTION_DNS_OVER_TLS
#define	NM_SETTING_CONNECTION_MPTCP_FLAGS
#define	NM_SETTING_CONNECTION_WAIT_DEVICE_TIMEOUT
#define	NM_SETTING_CONNECTION_MUD_URL
#define	NM_SETTING_CONNECTION_WAIT_ACTIVATION_DELAY
enum	NMSettingConnectionAutoconnectSlaves
enum	NMSettingConnectionLldp
enum	NMSettingConnectionMdns
enum	NMSettingConnectionLlmnr
enum	NMSettingConnectionDnsOverTls

Object Hierarchy

    GEnum
+    ├── NMSettingConnectionAutoconnectSlaves
+    ├── NMSettingConnectionDnsOverTls
+    ├── NMSettingConnectionLldp
+    ├── NMSettingConnectionLlmnr
+    ╰── NMSettingConnectionMdns
+

Description

The NMSettingConnection object is a NMSetting subclass that describes +properties that apply to all NMConnection objects, regardless of what type +of network connection they describe. Each NMConnection object must contain +a NMSettingConnection setting.

Functions

nm_setting_connection_new ()

NMSetting *
+nm_setting_connection_new (void);

Creates a new NMSettingConnection object with default values.

Returns

the new empty NMSettingConnection object

nm_setting_connection_get_id ()

const char *
+nm_setting_connection_get_id (NMSettingConnection *setting);

Returns the “id” property of the connection.

Parameters

+++++ + + + + + +

setting

setting	the NMSettingConnection
idx	the zero-based index of the permissions entry
out_ptype	on return, the permission type. This is currently always "user", +unless the entry is invalid, in which case it returns "invalid".
out_pitem	on return, the permission item (formatted according to `ptype` +, see +“permissions” for more detail
out_detail	on return, the permission detail (at this time, always `NULL`)

setting	the NMSettingConnection
uname	the user name to check permissions for

setting	the NMSettingConnection
ptype	the permission type; at this time only "user" is supported
pitem	the permission item formatted as required for `ptype` +
detail	unused at this time; must be `NULL`.	[allow-none]

setting	the NMSettingConnection
idx	the zero-based index of the permission to remove

setting	the NMSettingConnection
type	the setting name (ie NM_SETTING_BOND_SETTING_NAME) to be matched +against `setting` +'s slave type

setting	the NMSettingConnection
idx	the zero-based index of the secondary connection UUID entry. +Access one past the length of secondaries is ok and will return +`NULL`. Otherwise, it is a user error.

setting	the NMSettingConnection
sec_uuid	the secondary connection UUID to add

setting	the NMSettingConnection
idx	index number of the secondary connection UUID

NM_SETTING_CONNECTION_AUTOCONNECT_SLAVES_DEFAULT	+ default value +
NM_SETTING_CONNECTION_AUTOCONNECT_SLAVES_NO	+ slaves are not brought up when +master is activated +
NM_SETTING_CONNECTION_AUTOCONNECT_SLAVES_YES	+ slaves are brought up when +master is activated +

NM_SETTING_CONNECTION_LLDP_DEFAULT	+ default value +
NM_SETTING_CONNECTION_LLDP_DISABLE	+ disable LLDP +
NM_SETTING_CONNECTION_LLDP_ENABLE_RX	+ enable reception of LLDP frames +

NM_SETTING_CONNECTION_MDNS_DEFAULT	+ default value +
NM_SETTING_CONNECTION_MDNS_NO	+ disable mDNS +
NM_SETTING_CONNECTION_MDNS_RESOLVE	+ support only resolving, do not register hostname +
NM_SETTING_CONNECTION_MDNS_YES	+ enable mDNS +

NM_SETTING_CONNECTION_LLMNR_DEFAULT	+ default value +
NM_SETTING_CONNECTION_LLMNR_NO	+ disable LLMNR +
NM_SETTING_CONNECTION_LLMNR_RESOLVE	+ support only resolving, do not register hostname +
NM_SETTING_CONNECTION_LLMNR_YES	+ enable LLMNR +

NM_SETTING_CONNECTION_DNS_OVER_TLS_DEFAULT	+ default value +
NM_SETTING_CONNECTION_DNS_OVER_TLS_NO	+ disable DNSOverTls +
NM_SETTING_CONNECTION_DNS_OVER_TLS_OPPORTUNISTIC	+ enable opportunistic mode +
NM_SETTING_CONNECTION_DNS_OVER_TLS_YES	+ enable strict mode +