## 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 ()
const char * | nm_setting_connection_get_controller ()
gboolean | nm_setting_connection_is_slave_type ()
const char * | nm_setting_connection_get_slave_type ()
const char * | nm_setting_connection_get_port_type ()
NMSettingConnectionAutoconnectSlaves | nm_setting_connection_get_autoconnect_slaves ()
NMTernary | nm_setting_connection_get_autoconnect_ports ()
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 ()
NMSettingConnectionDownOnPoweroff | nm_setting_connection_get_down_on_poweroff ()
const char * | nm_setting_connection_get_mud_url ()
guint32 | nm_setting_connection_get_ip_ping_timeout ()
const char * | nm_setting_connection_get_ip_ping_address ()
gboolean | nm_setting_connection_add_ip_ping_address ()
void | nm_setting_connection_remove_ip_ping_address ()
gboolean | nm_setting_connection_remove_ip_ping_address_by_value ()
void | nm_setting_connection_clear_ip_ping_addresses ()
NMTernary | nm_setting_connection_get_ip_ping_addresses_require_all ()

## 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_CONTROLLER
#define | NM_SETTING_CONNECTION_SLAVE_TYPE
#define | NM_SETTING_CONNECTION_PORT_TYPE
#define | NM_SETTING_CONNECTION_AUTOCONNECT_SLAVES
#define | NM_SETTING_CONNECTION_AUTOCONNECT_PORTS
#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
#define | NM_SETTING_CONNECTION_DOWN_ON_POWEROFF
#define | NM_SETTING_CONNECTION_IP_PING_TIMEOUT
#define | NM_SETTING_CONNECTION_IP_PING_ADDRESSES
#define | NM_SETTING_CONNECTION_IP_PING_ADDRESSES_REQUIRE_ALL
enum | NMSettingConnectionAutoconnectSlaves
enum | NMSettingConnectionLldp
enum | NMSettingConnectionMdns
enum | NMSettingConnectionLlmnr
enum | NMSettingConnectionDnsOverTls
enum | NMSettingConnectionDownOnPoweroff

## Object Hierarchy

        GEnum
        ├── NMSettingConnectionAutoconnectSlaves
        ├── NMSettingConnectionDnsOverTls
        ├── NMSettingConnectionDownOnPoweroff
        ├── 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 | the NMSettingConnection |

#### Returns

the connection ID

### nm_setting_connection_get_uuid ()

    const char *
    nm_setting_connection_get_uuid (NMSettingConnection *setting);

Returns the “uuid” property of the connection.

#### Parameters

setting | the NMSettingConnection |

#### Returns

the connection UUID

### nm_setting_connection_get_stable_id ()

    const char *
    nm_setting_connection_get_stable_id (NMSettingConnection *setting);

Returns the “stable_id” property of the connection.

#### Parameters

setting | the NMSettingConnection |

#### Returns

the stable-id for the connection

Since: 1.4

### nm_setting_connection_get_interface_name ()

    const char *
    nm_setting_connection_get_interface_name
                                   (NMSettingConnection *setting);

Returns the “interface-name” property of the connection.

#### Parameters

setting | the NMSettingConnection |

#### Returns

the connection's interface name

### nm_setting_connection_get_connection_type ()

    const char *
    nm_setting_connection_get_connection_type
                                   (NMSettingConnection *setting);

Returns the “type” property of the connection.

#### Parameters

setting | the NMSettingConnection |

#### Returns

the connection type

### nm_setting_connection_get_autoconnect ()

    gboolean
    nm_setting_connection_get_autoconnect (NMSettingConnection *setting);

Returns the “autoconnect” property of the connection.

#### Parameters

setting | the NMSettingConnection |

#### Returns

the connection's autoconnect behavior

### nm_setting_connection_get_autoconnect_priority ()

    int
    nm_setting_connection_get_autoconnect_priority
                                   (NMSettingConnection *setting);

Returns the “autoconnect-priority” property of the connection. The higher number, the higher priority.

#### Parameters

setting | the NMSettingConnection |

#### Returns

the connection's autoconnect priority

### nm_setting_connection_get_autoconnect_retries ()

    int
    nm_setting_connection_get_autoconnect_retries
                                   (NMSettingConnection *setting);

Returns the “autoconnect-retries” property of the connection. Zero means infinite, -1 means the global default value.

#### Parameters

setting | the NMSettingConnection |

#### Returns

the connection's autoconnect retries

Since: 1.6

### nm_setting_connection_get_multi_connect ()

    NMConnectionMultiConnect
    nm_setting_connection_get_multi_connect
                                   (NMSettingConnection *setting);

#### Parameters

setting | the NMSettingConnection |

#### Returns

the “multi-connect” property of the connection.

Since: 1.14

### nm_setting_connection_get_timestamp ()

    guint64
    nm_setting_connection_get_timestamp (NMSettingConnection *setting);

Returns the “timestamp” property of the connection.

#### Parameters

setting | the NMSettingConnection |

#### Returns

the connection's timestamp

### nm_setting_connection_get_read_only ()

    gboolean
    nm_setting_connection_get_read_only (NMSettingConnection *setting);

`nm_setting_connection_get_read_only` has been deprecated since version 1.44 and should not be used in newly-written code.

This property is deprecated and has no meaning.

Returns the “read-only” property of the connection.

#### Parameters

setting | the NMSettingConnection |

#### Returns

`TRUE` if the connection is read-only, `FALSE` if it is not

### nm_setting_connection_get_num_permissions ()

    guint32
    nm_setting_connection_get_num_permissions
                                   (NMSettingConnection *setting);

Returns the number of entries in the “permissions” property of this setting.

#### Parameters

setting | the NMSettingConnection |

#### Returns

the number of permissions entries

### nm_setting_connection_get_permission ()

    gboolean
    nm_setting_connection_get_permission (NMSettingConnection *setting,
                                          guint32 idx,
                                          const char **out_ptype,
                                          const char **out_pitem,
                                          const char **out_detail);

Retrieve one of the entries of the “permissions” property of this setting.

#### Parameters

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`) |

#### Returns

`TRUE` if a permission was returned, `FALSE` if `idx` was invalid

### nm_setting_connection_get_zone ()

    const char *
    nm_setting_connection_get_zone (NMSettingConnection *setting);

Returns the “zone” property of the connection.

#### Parameters

setting | the NMSettingConnection |

#### Returns

the trust level of a connection

### nm_setting_connection_permissions_user_allowed ()

    gboolean
    nm_setting_connection_permissions_user_allowed
                                   (NMSettingConnection *setting,
                                    const char *uname);

Checks whether the given username is allowed to view/access this connection.

#### Parameters

setting | the NMSettingConnection |
uname | the user name to check permissions for |

#### Returns

`TRUE` if the requested user is allowed to view this connection, `FALSE` if the given user is not allowed to view this connection

### nm_setting_connection_add_permission ()

    gboolean
    nm_setting_connection_add_permission (NMSettingConnection *setting,
                                          const char *ptype,
                                          const char *pitem,
                                          const char *detail);

Adds a permission to the connection's permission list. At this time, only the "user" permission type is supported, and `pitem` must be a username. See “permissions”: for more details.

#### Parameters

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`. | [nullable]

#### Returns

`TRUE` if the permission was unique and was successfully added to the list, `FALSE` if `ptype` or `pitem` was invalid. If the permission was already present in the list, it will not be added a second time but `TRUE` will be returned. Note that before 1.28, in this case `FALSE` would be returned.

### nm_setting_connection_remove_permission ()

    void
    nm_setting_connection_remove_permission
                                   (NMSettingConnection *setting,
                                    guint32 idx);

Removes the permission at index `idx` from the connection.

#### Parameters

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

### nm_setting_connection_remove_permission_by_value ()

    gboolean
    nm_setting_connection_remove_permission_by_value
                                   (NMSettingConnection *setting,
                                    const char *ptype,
                                    const char *pitem,
                                    const char *detail);

Removes the permission from the connection. At this time, only the "user" permission type is supported, and `pitem` must be a username. See “permissions”: for more details.

#### Parameters

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`. | [nullable]

#### Returns

`TRUE` if the permission was found and removed; `FALSE` if it was not.

### nm_setting_connection_get_master ()

    const char *
    nm_setting_connection_get_master (NMSettingConnection *setting);

`nm_setting_connection_get_master` has been deprecated since version 1.46. and should not be used in newly-written code.

Use `nm_setting_connection_get_master()` instead which is just an alias.

Returns the “master” property of the connection.

#### Parameters

setting | the NMSettingConnection |

#### Returns

interface name of the controller device or UUID of the controller connection.

### nm_setting_connection_get_controller ()

    const char *
    nm_setting_connection_get_controller (NMSettingConnection *setting);

Returns the “controller” property of the connection.

#### Parameters

setting | the NMSettingConnection |

#### Returns

interface name of the controller device or UUID of the controller connection.

Since: 1.46

### nm_setting_connection_is_slave_type ()

    gboolean
    nm_setting_connection_is_slave_type (NMSettingConnection *setting,
                                         const char *type);

`nm_setting_connection_is_slave_type` has been deprecated since version 1.46. and should not be used in newly-written code.

#### Parameters

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

#### Returns

`TRUE` if connection is of the given port `type`

### nm_setting_connection_get_slave_type ()

    const char *
    nm_setting_connection_get_slave_type (NMSettingConnection *setting);

`nm_setting_connection_get_slave_type` has been deprecated since version 1.46. and should not be used in newly-written code.

Use `nm_setting_connection_get_port_type()` instead which is just an alias.

Returns the “slave-type” property of the connection.

#### Parameters

setting | the NMSettingConnection |

#### Returns

the type of port this connection is, if any

### nm_setting_connection_get_port_type ()

    const char *
    nm_setting_connection_get_port_type (NMSettingConnection *setting);

Returns the “port-type” property of the connection.

#### Parameters

setting | the NMSettingConnection |

#### Returns

the type of port this connection is, if any.

Since: 1.46

### nm_setting_connection_get_autoconnect_slaves ()

    NMSettingConnectionAutoconnectSlaves
    nm_setting_connection_get_autoconnect_slaves
                                   (NMSettingConnection *setting);

`nm_setting_connection_get_autoconnect_slaves` has been deprecated since version 1.46. and should not be used in newly-written code.

Use `nm_setting_connection_get_autoconnect_ports()` instead, this is just an alias.

Returns the “autoconnect-slaves” property of the connection.

#### Parameters

setting | the NMSettingConnection |

#### Returns

whether ports of the connection should be activated together with the connection.

Since: 1.2

### nm_setting_connection_get_autoconnect_ports ()

    NMTernary
    nm_setting_connection_get_autoconnect_ports
                                   (NMSettingConnection *setting);

Returns the “autoconnect-ports” property of the connection.

#### Parameters

setting | the NMSettingConnection |

#### Returns

whether ports of the connection should be activated together with the connection.

Since: 1.46

### nm_setting_connection_get_num_secondaries ()

    guint32
    nm_setting_connection_get_num_secondaries
                                   (NMSettingConnection *setting);

#### Parameters

setting | the NMSettingConnection |

#### Returns

the number of configured secondary connection UUIDs

### nm_setting_connection_get_secondary ()

    const char *
    nm_setting_connection_get_secondary (NMSettingConnection *setting,
                                         guint32 idx);

#### Parameters

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

#### Returns

the secondary connection UUID at index `idx` or `NULL` if `idx` is the number of secondaries.

### nm_setting_connection_add_secondary ()

    gboolean
    nm_setting_connection_add_secondary (NMSettingConnection *setting,
                                         const char *sec_uuid);

Adds a new secondary connection UUID to the setting.

#### Parameters

setting | the NMSettingConnection |
sec_uuid | the secondary connection UUID to add |

#### Returns

`TRUE` if the secondary connection UUID was added; `FALSE` if the UUID was already present

### nm_setting_connection_remove_secondary ()

    void
    nm_setting_connection_remove_secondary
                                   (NMSettingConnection *setting,
                                    guint32 idx);

Removes the secondary connection UUID at index `idx` .

#### Parameters

setting | the NMSettingConnection |
idx | index number of the secondary connection UUID |

### nm_setting_connection_remove_secondary_by_value ()

    gboolean
    nm_setting_connection_remove_secondary_by_value
                                   (NMSettingConnection *setting,
                                    const char *sec_uuid);

Removes the secondary connection UUID `sec_uuid` .

#### Parameters

setting | the NMSettingConnection |
sec_uuid | the secondary connection UUID to remove |

#### Returns

`TRUE` if the secondary connection UUID was found and removed; `FALSE` if it was not.

### nm_setting_connection_get_gateway_ping_timeout ()

    guint32
    nm_setting_connection_get_gateway_ping_timeout
                                   (NMSettingConnection *setting);

#### Parameters

setting | the NMSettingConnection |

#### Returns

the value contained in the “gateway-ping-timeout” property.

### nm_setting_connection_get_metered ()

    NMMetered
    nm_setting_connection_get_metered (NMSettingConnection *setting);

#### Parameters

setting | the NMSettingConnection |

#### Returns

the “metered” property of the setting.

Since: 1.2

### nm_setting_connection_get_lldp ()

    NMSettingConnectionLldp
    nm_setting_connection_get_lldp (NMSettingConnection *setting);

Returns the “lldp” property of the connection.

#### Parameters

setting | the NMSettingConnection |

#### Returns

a `NMSettingConnectionLldp` which indicates whether LLDP must be enabled for the connection.

Since: 1.2

### nm_setting_connection_get_auth_retries ()

    int
    nm_setting_connection_get_auth_retries
                                   (NMSettingConnection *setting);

Returns the value contained in the “auth-retries” property.

#### Parameters

setting | the NMSettingConnection |

#### Returns

the configured authentication retries. Zero means infinity and -1 means a global default value.

Since: 1.10

### nm_setting_connection_get_mdns ()

    NMSettingConnectionMdns
    nm_setting_connection_get_mdns (NMSettingConnection *setting);

#### Parameters

setting | the NMSettingConnection |

#### Returns

the “mdns” property of the setting.

Since: 1.12

### nm_setting_connection_get_llmnr ()

    NMSettingConnectionLlmnr
    nm_setting_connection_get_llmnr (NMSettingConnection *setting);

#### Parameters

setting | the NMSettingConnection |

#### Returns

the “llmnr” property of the setting.

Since: 1.14

### nm_setting_connection_get_dns_over_tls ()

    NMSettingConnectionDnsOverTls
    nm_setting_connection_get_dns_over_tls
                                   (NMSettingConnection *setting);

#### Parameters

setting | the NMSettingConnection |

#### Returns

the “dns-over-tls” property of the setting.

Since: 1.34

### nm_setting_connection_get_mptcp_flags ()

    NMMptcpFlags
    nm_setting_connection_get_mptcp_flags (NMSettingConnection *setting);

#### Parameters

setting | the NMSettingConnection |

#### Returns

the “mptcp-flags” property of the setting.

Since: 1.42

### nm_setting_connection_get_wait_device_timeout ()

    gint32
    nm_setting_connection_get_wait_device_timeout
                                   (NMSettingConnection *setting);

#### Parameters

setting | the NMSettingConnection |

#### Returns

the `NM_SETTING_CONNECTION_WAIT_DEVICE_TIMEOUT` property with the timeout in milliseconds. -1 is the default.

Since: 1.20

### nm_setting_connection_get_wait_activation_delay ()

    gint32
    nm_setting_connection_get_wait_activation_delay
                                   (NMSettingConnection *setting);

#### Parameters

setting | the NMSettingConnection |

#### Returns

the `NM_SETTING_CONNECTION_WAIT_ACTIVATION_DELAY` property with the delay in milliseconds. -1 is the default.

Since: 1.40

### nm_setting_connection_get_down_on_poweroff ()

    NMSettingConnectionDownOnPoweroff
    nm_setting_connection_get_down_on_poweroff
                                   (NMSettingConnection *setting);

Returns the `NM_SETTING_CONNECTION_DOWN_ON_POWEROFF` property.

#### Parameters

setting | the NMSettingConnection |

#### Returns

whether the connection will be brought down before the system is powered off.

Since: 1.48

### nm_setting_connection_get_mud_url ()

    const char *
    nm_setting_connection_get_mud_url (NMSettingConnection *setting);

Returns the value contained in the “mud-url” property.

#### Parameters

setting | the NMSettingConnection |

Since: 1.26

### nm_setting_connection_get_ip_ping_timeout ()

    guint32
    nm_setting_connection_get_ip_ping_timeout
                                   (NMSettingConnection *setting);

#### Parameters

setting | the NMSettingConnection |

#### Returns

the value contained in the “ip-ping-timeout” property.

Since: 1.52

### nm_setting_connection_get_ip_ping_address ()

    const char *
    nm_setting_connection_get_ip_ping_address
                                   (NMSettingConnection *setting,
                                    guint32 idx);

#### Parameters

setting | the NMSettingConnection |
idx | the zero-based index of the ip-ping-addresses entry. |

#### Returns

the ip address string at index `idx` or `NULL` if `idx` is the number of ip-ping-addresses.

Since: 1.52

### nm_setting_connection_add_ip_ping_address ()

    gboolean
    nm_setting_connection_add_ip_ping_address
                                   (NMSettingConnection *setting,
                                    const char *address);

Adds a new IP address string to the ip-ping-addresses.

#### Parameters

setting | the NMSettingConnection |
address | the IP address string to add |

#### Returns

`TRUE` if the new IP address was added; `FALSE` if the IP address was already present

Since: 1.52

### nm_setting_connection_remove_ip_ping_address ()

    void
    nm_setting_connection_remove_ip_ping_address
                                   (NMSettingConnection *setting,
                                    guint32 idx);

Removes the IP address at index `idx` .

#### Parameters

setting | the NMSettingConnection |
idx | index number of the IP address |

Since: 1.52

### nm_setting_connection_remove_ip_ping_address_by_value ()

    gboolean
    nm_setting_connection_remove_ip_ping_address_by_value
                                   (NMSettingConnection *setting,
                                    const char *address);

Removes the IP address `address` from ip-ping-addresses.

#### Parameters

setting | the NMSettingConnection |
address | the IP address to remove |

#### Returns

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

Since: 1.52

### nm_setting_connection_clear_ip_ping_addresses ()

    void
    nm_setting_connection_clear_ip_ping_addresses
                                   (NMSettingConnection *setting);

Removes all configured ip-ping-addresses.

#### Parameters

setting | the NMSettingConnection |

Since: 1.52

### nm_setting_connection_get_ip_ping_addresses_require_all ()

    NMTernary
    nm_setting_connection_get_ip_ping_addresses_require_all
                                   (NMSettingConnection *setting);

Returns the “ip-ping-addresses-require-all” property of the connection.

#### Parameters

setting | the NMSettingConnection |

#### Returns

whether all the ip ping addresses pass the connectivity check.

Since: 1.52

## Types and Values

### NM_SETTING_CONNECTION_SETTING_NAME

    #define NM_SETTING_CONNECTION_SETTING_NAME "connection"

### NM_SETTING_CONNECTION_AUTOCONNECT_PRIORITY_MIN

    #define NM_SETTING_CONNECTION_AUTOCONNECT_PRIORITY_MIN     -999

### NM_SETTING_CONNECTION_AUTOCONNECT_PRIORITY_MAX

    #define NM_SETTING_CONNECTION_AUTOCONNECT_PRIORITY_MAX     999

### NM_SETTING_CONNECTION_AUTOCONNECT_PRIORITY_DEFAULT

    #define NM_SETTING_CONNECTION_AUTOCONNECT_PRIORITY_DEFAULT 0

### NM_SETTING_CONNECTION_ID

    #define NM_SETTING_CONNECTION_ID                            "id"

### NM_SETTING_CONNECTION_UUID

    #define NM_SETTING_CONNECTION_UUID                          "uuid"

### NM_SETTING_CONNECTION_STABLE_ID

    #define NM_SETTING_CONNECTION_STABLE_ID                     "stable-id"

### NM_SETTING_CONNECTION_INTERFACE_NAME

    #define NM_SETTING_CONNECTION_INTERFACE_NAME                "interface-name"

### NM_SETTING_CONNECTION_TYPE

    #define NM_SETTING_CONNECTION_TYPE                          "type"

### NM_SETTING_CONNECTION_AUTOCONNECT

    #define NM_SETTING_CONNECTION_AUTOCONNECT                   "autoconnect"

### NM_SETTING_CONNECTION_AUTOCONNECT_PRIORITY

    #define NM_SETTING_CONNECTION_AUTOCONNECT_PRIORITY          "autoconnect-priority"

### NM_SETTING_CONNECTION_AUTOCONNECT_RETRIES

    #define NM_SETTING_CONNECTION_AUTOCONNECT_RETRIES           "autoconnect-retries"

### NM_SETTING_CONNECTION_MULTI_CONNECT

    #define NM_SETTING_CONNECTION_MULTI_CONNECT                 "multi-connect"

### NM_SETTING_CONNECTION_TIMESTAMP

    #define NM_SETTING_CONNECTION_TIMESTAMP                     "timestamp"

### NM_SETTING_CONNECTION_READ_ONLY

    #define NM_SETTING_CONNECTION_READ_ONLY                     "read-only"

### NM_SETTING_CONNECTION_PERMISSIONS

    #define NM_SETTING_CONNECTION_PERMISSIONS                   "permissions"

### NM_SETTING_CONNECTION_ZONE

    #define NM_SETTING_CONNECTION_ZONE                          "zone"

### NM_SETTING_CONNECTION_MASTER

    #define NM_SETTING_CONNECTION_MASTER                        "master"

### NM_SETTING_CONNECTION_CONTROLLER

    #define NM_SETTING_CONNECTION_CONTROLLER                    "controller"

### NM_SETTING_CONNECTION_SLAVE_TYPE

    #define NM_SETTING_CONNECTION_SLAVE_TYPE                    "slave-type"

### NM_SETTING_CONNECTION_PORT_TYPE

    #define NM_SETTING_CONNECTION_PORT_TYPE                     "port-type"

### NM_SETTING_CONNECTION_AUTOCONNECT_SLAVES

    #define NM_SETTING_CONNECTION_AUTOCONNECT_SLAVES            "autoconnect-slaves"

### NM_SETTING_CONNECTION_AUTOCONNECT_PORTS

    #define NM_SETTING_CONNECTION_AUTOCONNECT_PORTS             "autoconnect-ports"

### NM_SETTING_CONNECTION_SECONDARIES

    #define NM_SETTING_CONNECTION_SECONDARIES                   "secondaries"

### NM_SETTING_CONNECTION_GATEWAY_PING_TIMEOUT

    #define NM_SETTING_CONNECTION_GATEWAY_PING_TIMEOUT          "gateway-ping-timeout"

### NM_SETTING_CONNECTION_METERED

    #define NM_SETTING_CONNECTION_METERED                       "metered"

### NM_SETTING_CONNECTION_LLDP

    #define NM_SETTING_CONNECTION_LLDP                          "lldp"

### NM_SETTING_CONNECTION_AUTH_RETRIES

    #define NM_SETTING_CONNECTION_AUTH_RETRIES                  "auth-retries"

### NM_SETTING_CONNECTION_MDNS

    #define NM_SETTING_CONNECTION_MDNS                          "mdns"

### NM_SETTING_CONNECTION_LLMNR

    #define NM_SETTING_CONNECTION_LLMNR                         "llmnr"

### NM_SETTING_CONNECTION_DNS_OVER_TLS

    #define NM_SETTING_CONNECTION_DNS_OVER_TLS                  "dns-over-tls"

### NM_SETTING_CONNECTION_MPTCP_FLAGS

    #define NM_SETTING_CONNECTION_MPTCP_FLAGS                   "mptcp-flags"

### NM_SETTING_CONNECTION_WAIT_DEVICE_TIMEOUT

    #define NM_SETTING_CONNECTION_WAIT_DEVICE_TIMEOUT           "wait-device-timeout"

### NM_SETTING_CONNECTION_MUD_URL

    #define NM_SETTING_CONNECTION_MUD_URL                       "mud-url"

### NM_SETTING_CONNECTION_WAIT_ACTIVATION_DELAY

    #define NM_SETTING_CONNECTION_WAIT_ACTIVATION_DELAY         "wait-activation-delay"

### NM_SETTING_CONNECTION_DOWN_ON_POWEROFF

    #define NM_SETTING_CONNECTION_DOWN_ON_POWEROFF              "down-on-poweroff"

### NM_SETTING_CONNECTION_IP_PING_TIMEOUT

    #define NM_SETTING_CONNECTION_IP_PING_TIMEOUT               "ip-ping-timeout"

### NM_SETTING_CONNECTION_IP_PING_ADDRESSES

    #define NM_SETTING_CONNECTION_IP_PING_ADDRESSES             "ip-ping-addresses"

### NM_SETTING_CONNECTION_IP_PING_ADDRESSES_REQUIRE_ALL

    #define NM_SETTING_CONNECTION_IP_PING_ADDRESSES_REQUIRE_ALL "ip-ping-addresses-require-all"

### enum NMSettingConnectionAutoconnectSlaves

`NMSettingConnectionAutoconnectSlaves` has been deprecated since version 1.46 and should not be used in newly-written code.

NMSettingConnectionAutoconnectSlaves values indicate whether slave connections should be activated when controller is activated.

#### Members

NM_SETTING_CONNECTION_AUTOCONNECT_SLAVES_DEFAULT | default value |
NM_SETTING_CONNECTION_AUTOCONNECT_SLAVES_NO | slaves are not brought up when controller is activated |
NM_SETTING_CONNECTION_AUTOCONNECT_SLAVES_YES | slaves are brought up when controller is activated |

Since: 1.2

### enum NMSettingConnectionLldp

NMSettingConnectionLldp values indicate whether LLDP should be enabled.

#### Members

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 |

Since: 1.2

### enum NMSettingConnectionMdns

NMSettingConnectionMdns values indicate whether mDNS should be enabled.

#### Members

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 |

Since: 1.12

### enum NMSettingConnectionLlmnr

NMSettingConnectionLlmnr values indicate whether LLMNR should be enabled.

#### Members

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 |

Since: 1.14

### enum NMSettingConnectionDnsOverTls

NMSettingConnectionDnsOverTls values indicate whether DNSOverTls should be enabled.

#### Members

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 |

Since: 1.34

### enum NMSettingConnectionDownOnPoweroff

NMSettingConnectionDownOnPoweroff indicates whether the connection will be brought down before the system is powered off.

#### Members

NM_SETTING_CONNECTION_DOWN_ON_POWEROFF_DEFAULT | default value |
NM_SETTING_CONNECTION_DOWN_ON_POWEROFF_NO | disable down-on-poweroff |
NM_SETTING_CONNECTION_DOWN_ON_POWEROFF_YES | enable down-on-poweroff |

Since: 1.48