gi-nm-1.0.1: NM bindings
CopyrightWill Thompson and Iñaki García Etxebarria
LicenseLGPL-2.1
MaintainerIñaki García Etxebarria
Safe HaskellNone
LanguageHaskell2010

GI.NM.Objects.SettingConnection

Description

General Connection Profile Settings

Synopsis

Exported types

class (GObject o, IsDescendantOf SettingConnection o) => IsSettingConnection o Source #

Type class for types which can be safely cast to SettingConnection, for instance with toSettingConnection.

Instances

Instances details
(GObject o, IsDescendantOf SettingConnection o) => IsSettingConnection o Source # 
Instance details

Defined in GI.NM.Objects.SettingConnection

toSettingConnection :: (MonadIO m, IsSettingConnection o) => o -> m SettingConnection Source #

Cast to SettingConnection, for types for which this is known to be safe. For general casts, use castTo.

Methods

addPermission

settingConnectionAddPermission Source #

Arguments

:: (HasCallStack, MonadIO m, IsSettingConnection a) 
=> a

setting: the SettingConnection

-> Text

ptype: the permission type; at this time only "user" is supported

-> Text

pitem: the permission item formatted as required for ptype

-> Maybe Text

detail: unused at this time; must be Nothing

-> m Bool

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.

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 SettingConnection:permissions: for more details.

addSecondary

settingConnectionAddSecondary Source #

Arguments

:: (HasCallStack, MonadIO m, IsSettingConnection a) 
=> a

setting: the SettingConnection

-> Text

secUuid: the secondary connection UUID to add

-> m Bool

Returns: True if the secondary connection UUID was added; False if the UUID was already present

Adds a new secondary connection UUID to the setting.

getAuthRetries

settingConnectionGetAuthRetries Source #

Arguments

:: (HasCallStack, MonadIO m, IsSettingConnection a) 
=> a

setting: the SettingConnection

-> m Int32

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

Returns the value contained in the SettingConnection:authRetries property.

Since: 1.10

getAutoconnect

settingConnectionGetAutoconnect Source #

Arguments

:: (HasCallStack, MonadIO m, IsSettingConnection a) 
=> a

setting: the SettingConnection

-> m Bool

Returns: the connection's autoconnect behavior

Returns the SettingConnection:autoconnect property of the connection.

getAutoconnectPorts

settingConnectionGetAutoconnectPorts Source #

Arguments

:: (HasCallStack, MonadIO m, IsSettingConnection a) 
=> a

setting: the SettingConnection

-> m Ternary

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

Returns the SettingConnection:autoconnectPorts property of the connection.

Since: 1.46

getAutoconnectPriority

settingConnectionGetAutoconnectPriority Source #

Arguments

:: (HasCallStack, MonadIO m, IsSettingConnection a) 
=> a

setting: the SettingConnection

-> m Int32

Returns: the connection's autoconnect priority

Returns the SettingConnection:autoconnectPriority property of the connection. The higher number, the higher priority.

getAutoconnectRetries

settingConnectionGetAutoconnectRetries Source #

Arguments

:: (HasCallStack, MonadIO m, IsSettingConnection a) 
=> a

setting: the SettingConnection

-> m Int32

Returns: the connection's autoconnect retries

Returns the SettingConnection:autoconnectRetries property of the connection. Zero means infinite, -1 means the global default value.

Since: 1.6

getAutoconnectSlaves

settingConnectionGetAutoconnectSlaves Source #

Arguments

:: (HasCallStack, MonadIO m, IsSettingConnection a) 
=> a

setting: the SettingConnection

-> m SettingConnectionAutoconnectSlaves

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

Deprecated: (Since version 1.46.)Use settingConnectionGetAutoconnectPorts instead, thisis just an alias.

Returns the SettingConnection:autoconnectSlaves property of the connection.

Since: 1.2

getConnectionType

settingConnectionGetConnectionType Source #

Arguments

:: (HasCallStack, MonadIO m, IsSettingConnection a) 
=> a

setting: the SettingConnection

-> m Text

Returns: the connection type

Returns the SettingConnection:type property of the connection.

getController

settingConnectionGetController Source #

Arguments

:: (HasCallStack, MonadIO m, IsSettingConnection a) 
=> a

setting: the SettingConnection

-> m Text

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

Returns the SettingConnection:controller property of the connection.

Since: 1.46

getDnsOverTls

settingConnectionGetDnsOverTls Source #

Arguments

:: (HasCallStack, MonadIO m, IsSettingConnection a) 
=> a

setting: the SettingConnection

-> m SettingConnectionDnsOverTls

Returns: the SettingConnection:dnsOverTls property of the setting.

No description available in the introspection data.

Since: 1.34

getDownOnPoweroff

settingConnectionGetDownOnPoweroff Source #

Arguments

:: (HasCallStack, MonadIO m, IsSettingConnection a) 
=> a

setting: the SettingConnection

-> m SettingConnectionDownOnPoweroff

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

Returns the SETTING_CONNECTION_DOWN_ON_POWEROFF property.

Since: 1.48

getGatewayPingTimeout

settingConnectionGetGatewayPingTimeout Source #

Arguments

:: (HasCallStack, MonadIO m, IsSettingConnection a) 
=> a

setting: the SettingConnection

-> m Word32

Returns: the value contained in the SettingConnection:gatewayPingTimeout property.

No description available in the introspection data.

getId

settingConnectionGetId Source #

Arguments

:: (HasCallStack, MonadIO m, IsSettingConnection a) 
=> a

setting: the SettingConnection

-> m Text

Returns: the connection ID

Returns the SettingConnection:id property of the connection.

getInterfaceName

settingConnectionGetInterfaceName Source #

Arguments

:: (HasCallStack, MonadIO m, IsSettingConnection a) 
=> a

setting: the SettingConnection

-> m Text

Returns: the connection's interface name

Returns the SettingConnection:interfaceName property of the connection.

getLldp

settingConnectionGetLldp Source #

Arguments

:: (HasCallStack, MonadIO m, IsSettingConnection a) 
=> a

setting: the SettingConnection

-> m SettingConnectionLldp

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

Returns the SettingConnection:lldp property of the connection.

Since: 1.2

getLlmnr

settingConnectionGetLlmnr Source #

Arguments

:: (HasCallStack, MonadIO m, IsSettingConnection a) 
=> a

setting: the SettingConnection

-> m SettingConnectionLlmnr

Returns: the SettingConnection:llmnr property of the setting.

No description available in the introspection data.

Since: 1.14

getMaster

settingConnectionGetMaster Source #

Arguments

:: (HasCallStack, MonadIO m, IsSettingConnection a) 
=> a

setting: the SettingConnection

-> m Text

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

Deprecated: (Since version 1.46.)Use settingConnectionGetMaster instead whichis just an alias.

Returns the SettingConnection:master property of the connection.

getMdns

settingConnectionGetMdns Source #

Arguments

:: (HasCallStack, MonadIO m, IsSettingConnection a) 
=> a

setting: the SettingConnection

-> m SettingConnectionMdns

Returns: the SettingConnection:mdns property of the setting.

No description available in the introspection data.

Since: 1.12

getMetered

settingConnectionGetMetered Source #

Arguments

:: (HasCallStack, MonadIO m, IsSettingConnection a) 
=> a

setting: the SettingConnection

-> m Metered

Returns: the SettingConnection:metered property of the setting.

No description available in the introspection data.

Since: 1.2

getMptcpFlags

settingConnectionGetMptcpFlags Source #

Arguments

:: (HasCallStack, MonadIO m, IsSettingConnection a) 
=> a

setting: the SettingConnection

-> m [MptcpFlags]

Returns: the SettingConnection:mptcpFlags property of the setting.

No description available in the introspection data.

Since: 1.42

getMudUrl

settingConnectionGetMudUrl Source #

Arguments

:: (HasCallStack, MonadIO m, IsSettingConnection a) 
=> a

setting: the SettingConnection

-> m Text 

Returns the value contained in the SettingConnection:mudUrl property.

Since: 1.26

getMultiConnect

settingConnectionGetMultiConnect Source #

Arguments

:: (HasCallStack, MonadIO m, IsSettingConnection a) 
=> a

setting: the SettingConnection

-> m ConnectionMultiConnect

Returns: the SettingConnection:multiConnect property of the connection.

No description available in the introspection data.

Since: 1.14

getNumPermissions

settingConnectionGetNumPermissions Source #

Arguments

:: (HasCallStack, MonadIO m, IsSettingConnection a) 
=> a

setting: the SettingConnection

-> m Word32

Returns: the number of permissions entries

Returns the number of entries in the SettingConnection:permissions property of this setting.

getNumSecondaries

settingConnectionGetNumSecondaries Source #

Arguments

:: (HasCallStack, MonadIO m, IsSettingConnection a) 
=> a

setting: the SettingConnection

-> m Word32

Returns: the number of configured secondary connection UUIDs

No description available in the introspection data.

getPermission

settingConnectionGetPermission Source #

Arguments

:: (HasCallStack, MonadIO m, IsSettingConnection a) 
=> a

setting: the SettingConnection

-> Word32

idx: the zero-based index of the permissions entry

-> Text

outPtype: on return, the permission type. This is currently always "user", unless the entry is invalid, in which case it returns "invalid".

-> Text

outPitem: on return, the permission item (formatted according to ptype, see SettingConnection:permissions for more detail

-> Text

outDetail: on return, the permission detail (at this time, always Nothing)

-> m Bool

Returns: True if a permission was returned, False if idx was invalid

Retrieve one of the entries of the SettingConnection:permissions property of this setting.

getPortType

settingConnectionGetPortType Source #

Arguments

:: (HasCallStack, MonadIO m, IsSettingConnection a) 
=> a

setting: the SettingConnection

-> m Text

Returns: the type of port this connection is, if any.

Returns the SettingConnection:portType property of the connection.

Since: 1.46

getReadOnly

settingConnectionGetReadOnly Source #

Arguments

:: (HasCallStack, MonadIO m, IsSettingConnection a) 
=> a

setting: the SettingConnection

-> m Bool

Returns: True if the connection is read-only, False if it is not

Deprecated: (Since version 1.44)This property is deprecated and has no meaning.

Returns the SettingConnection:readOnly property of the connection.

getSecondary

settingConnectionGetSecondary Source #

Arguments

:: (HasCallStack, MonadIO m, IsSettingConnection a) 
=> a

setting: the SettingConnection

-> Word32

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

-> m Text

Returns: the secondary connection UUID at index idx or Nothing if idx is the number of secondaries.

No description available in the introspection data.

getSlaveType

settingConnectionGetSlaveType Source #

Arguments

:: (HasCallStack, MonadIO m, IsSettingConnection a) 
=> a

setting: the SettingConnection

-> m Text

Returns: the type of port this connection is, if any

Deprecated: (Since version 1.46.)Use settingConnectionGetPortType instead whichis just an alias.

Returns the SettingConnection:slaveType property of the connection.

getStableId

settingConnectionGetStableId Source #

Arguments

:: (HasCallStack, MonadIO m, IsSettingConnection a) 
=> a

setting: the SettingConnection

-> m Text

Returns: the stable-id for the connection

Returns the SettingConnection:stable_id property of the connection.

Since: 1.4

getTimestamp

settingConnectionGetTimestamp Source #

Arguments

:: (HasCallStack, MonadIO m, IsSettingConnection a) 
=> a

setting: the SettingConnection

-> m Word64

Returns: the connection's timestamp

Returns the SettingConnection:timestamp property of the connection.

getUuid

settingConnectionGetUuid Source #

Arguments

:: (HasCallStack, MonadIO m, IsSettingConnection a) 
=> a

setting: the SettingConnection

-> m Text

Returns: the connection UUID

Returns the SettingConnection:uuid property of the connection.

getWaitActivationDelay

settingConnectionGetWaitActivationDelay Source #

Arguments

:: (HasCallStack, MonadIO m, IsSettingConnection a) 
=> a

setting: the SettingConnection

-> m Int32

Returns: the SETTING_CONNECTION_WAIT_ACTIVATION_DELAY property with the delay in milliseconds. -1 is the default.

No description available in the introspection data.

Since: 1.40

getWaitDeviceTimeout

settingConnectionGetWaitDeviceTimeout Source #

Arguments

:: (HasCallStack, MonadIO m, IsSettingConnection a) 
=> a

setting: the SettingConnection

-> m Int32

Returns: the SETTING_CONNECTION_WAIT_DEVICE_TIMEOUT property with the timeout in milliseconds. -1 is the default.

No description available in the introspection data.

Since: 1.20

getZone

settingConnectionGetZone Source #

Arguments

:: (HasCallStack, MonadIO m, IsSettingConnection a) 
=> a

setting: the SettingConnection

-> m Text

Returns: the trust level of a connection

Returns the SettingConnection:zone property of the connection.

isSlaveType

settingConnectionIsSlaveType Source #

Arguments

:: (HasCallStack, MonadIO m, IsSettingConnection a) 
=> a

setting: the SettingConnection

-> Text

type: the setting name (ie SETTING_BOND_SETTING_NAME) to be matched against setting's port type

-> m Bool

Returns: True if connection is of the given port type

Deprecated: (Since version 1.46.)

No description available in the introspection data.

new

settingConnectionNew Source #

Arguments

:: (HasCallStack, MonadIO m) 
=> m SettingConnection

Returns: the new empty SettingConnection object

Creates a new SettingConnection object with default values.

permissionsUserAllowed

settingConnectionPermissionsUserAllowed Source #

Arguments

:: (HasCallStack, MonadIO m, IsSettingConnection a) 
=> a

setting: the SettingConnection

-> Text

uname: the user name to check permissions for

-> m Bool

Returns: True if the requested user is allowed to view this connection, False if the given user is not allowed to view this connection

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

removePermission

settingConnectionRemovePermission Source #

Arguments

:: (HasCallStack, MonadIO m, IsSettingConnection a) 
=> a

setting: the SettingConnection

-> Word32

idx: the zero-based index of the permission to remove

-> m () 

Removes the permission at index idx from the connection.

removePermissionByValue

settingConnectionRemovePermissionByValue Source #

Arguments

:: (HasCallStack, MonadIO m, IsSettingConnection a) 
=> a

setting: the SettingConnection

-> Text

ptype: the permission type; at this time only "user" is supported

-> Text

pitem: the permission item formatted as required for ptype

-> Maybe Text

detail: unused at this time; must be Nothing

-> m Bool

Returns: True if the permission was found and removed; False if it was not.

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

removeSecondary

settingConnectionRemoveSecondary Source #

Arguments

:: (HasCallStack, MonadIO m, IsSettingConnection a) 
=> a

setting: the SettingConnection

-> Word32

idx: index number of the secondary connection UUID

-> m () 

Removes the secondary connection UUID at index idx.

removeSecondaryByValue

settingConnectionRemoveSecondaryByValue Source #

Arguments

:: (HasCallStack, MonadIO m, IsSettingConnection a) 
=> a

setting: the SettingConnection

-> Text

secUuid: the secondary connection UUID to remove

-> m Bool

Returns: True if the secondary connection UUID was found and removed; False if it was not.

Removes the secondary connection UUID secUuid.

Properties

authRetries

The number of retries for the authentication. Zero means to try indefinitely; -1 means to use a global default. If the global default is not set, the authentication retries for 3 times before failing the connection.

Currently, this only applies to 802-1x authentication.

Since: 1.10

constructSettingConnectionAuthRetries :: (IsSettingConnection o, MonadIO m) => Int32 -> m (GValueConstruct o) Source #

Construct a GValueConstruct with valid value for the “auth-retries” property. This is rarely needed directly, but it is used by new.

getSettingConnectionAuthRetries :: (MonadIO m, IsSettingConnection o) => o -> m Int32 Source #

Get the value of the “auth-retries” property. When overloading is enabled, this is equivalent to

get settingConnection #authRetries

setSettingConnectionAuthRetries :: (MonadIO m, IsSettingConnection o) => o -> Int32 -> m () Source #

Set the value of the “auth-retries” property. When overloading is enabled, this is equivalent to

set settingConnection [ #authRetries := value ]

autoconnect

Whether or not the connection should be automatically connected by NetworkManager when the resources for the connection are available. True to automatically activate the connection, False to require manual intervention to activate the connection.

Autoconnect happens when the circumstances are suitable. That means for example that the device is currently managed and not active. Autoconnect thus never replaces or competes with an already active profile.

Note that autoconnect is not implemented for VPN profiles. See SettingConnection:secondaries as an alternative to automatically connect VPN profiles.

If multiple profiles are ready to autoconnect on the same device, the one with the better "connection.autoconnect-priority" is chosen. If the priorities are equal, then the most recently connected profile is activated. If the profiles were not connected earlier or their "connection.timestamp" is identical, the choice is undefined.

Depending on "connection.multi-connect", a profile can (auto)connect only once at a time or multiple times.

constructSettingConnectionAutoconnect :: (IsSettingConnection o, MonadIO m) => Bool -> m (GValueConstruct o) Source #

Construct a GValueConstruct with valid value for the “autoconnect” property. This is rarely needed directly, but it is used by new.

getSettingConnectionAutoconnect :: (MonadIO m, IsSettingConnection o) => o -> m Bool Source #

Get the value of the “autoconnect” property. When overloading is enabled, this is equivalent to

get settingConnection #autoconnect

setSettingConnectionAutoconnect :: (MonadIO m, IsSettingConnection o) => o -> Bool -> m () Source #

Set the value of the “autoconnect” property. When overloading is enabled, this is equivalent to

set settingConnection [ #autoconnect := value ]

autoconnectPorts

Whether or not ports of this connection should be automatically brought up when NetworkManager activates this connection. This only has a real effect for controller connections. The properties SettingConnection:autoconnect, SettingConnection:autoconnectPriority and SettingConnection:autoconnectRetries are unrelated to this setting. The permitted values are: 0: leave port connections untouched, 1: activate all the port connections with this connection, -1: default. If -1 (default) is set, global connection.autoconnect-ports is read to determine the real value. If it is default as well, this fallbacks to 0.

Since: 1.46

constructSettingConnectionAutoconnectPorts :: (IsSettingConnection o, MonadIO m) => Int32 -> m (GValueConstruct o) Source #

Construct a GValueConstruct with valid value for the “autoconnect-ports” property. This is rarely needed directly, but it is used by new.

getSettingConnectionAutoconnectPorts :: (MonadIO m, IsSettingConnection o) => o -> m Int32 Source #

Get the value of the “autoconnect-ports” property. When overloading is enabled, this is equivalent to

get settingConnection #autoconnectPorts

setSettingConnectionAutoconnectPorts :: (MonadIO m, IsSettingConnection o) => o -> Int32 -> m () Source #

Set the value of the “autoconnect-ports” property. When overloading is enabled, this is equivalent to

set settingConnection [ #autoconnectPorts := value ]

autoconnectPriority

The autoconnect priority in range -999 to 999. If the connection is set to autoconnect, connections with higher priority will be preferred. The higher number means higher priority. Defaults to 0. Note that this property only matters if there are more than one candidate profile to select for autoconnect. In case of equal priority, the profile used most recently is chosen.

constructSettingConnectionAutoconnectPriority :: (IsSettingConnection o, MonadIO m) => Int32 -> m (GValueConstruct o) Source #

Construct a GValueConstruct with valid value for the “autoconnect-priority” property. This is rarely needed directly, but it is used by new.

getSettingConnectionAutoconnectPriority :: (MonadIO m, IsSettingConnection o) => o -> m Int32 Source #

Get the value of the “autoconnect-priority” property. When overloading is enabled, this is equivalent to

get settingConnection #autoconnectPriority

setSettingConnectionAutoconnectPriority :: (MonadIO m, IsSettingConnection o) => o -> Int32 -> m () Source #

Set the value of the “autoconnect-priority” property. When overloading is enabled, this is equivalent to

set settingConnection [ #autoconnectPriority := value ]

autoconnectRetries

The number of times a connection should be tried when autoactivating before giving up. Zero means forever, -1 means the global default (4 times if not overridden). Setting this to 1 means to try activation only once before blocking autoconnect. Note that after a timeout, NetworkManager will try to autoconnect again.

constructSettingConnectionAutoconnectRetries :: (IsSettingConnection o, MonadIO m) => Int32 -> m (GValueConstruct o) Source #

Construct a GValueConstruct with valid value for the “autoconnect-retries” property. This is rarely needed directly, but it is used by new.

getSettingConnectionAutoconnectRetries :: (MonadIO m, IsSettingConnection o) => o -> m Int32 Source #

Get the value of the “autoconnect-retries” property. When overloading is enabled, this is equivalent to

get settingConnection #autoconnectRetries

setSettingConnectionAutoconnectRetries :: (MonadIO m, IsSettingConnection o) => o -> Int32 -> m () Source #

Set the value of the “autoconnect-retries” property. When overloading is enabled, this is equivalent to

set settingConnection [ #autoconnectRetries := value ]

autoconnectSlaves

Whether or not ports of this connection should be automatically brought up when NetworkManager activates this connection. This only has a real effect for controller connections. The properties SettingConnection:autoconnect, SettingConnection:autoconnectPriority and SettingConnection:autoconnectRetries are unrelated to this setting. The permitted values are: 0: leave port connections untouched, 1: activate all the port connections with this connection, -1: default. If -1 (default) is set, global connection.autoconnect-slaves is read to determine the real value. If it is default as well, this fallbacks to 0.

Deprecated 1.46. Use SettingConnection:autoconnectPorts instead, this is just an alias.

Since: 1.2

constructSettingConnectionAutoconnectSlaves :: (IsSettingConnection o, MonadIO m) => SettingConnectionAutoconnectSlaves -> m (GValueConstruct o) Source #

Construct a GValueConstruct with valid value for the “autoconnect-slaves” property. This is rarely needed directly, but it is used by new.

getSettingConnectionAutoconnectSlaves :: (MonadIO m, IsSettingConnection o) => o -> m SettingConnectionAutoconnectSlaves Source #

Get the value of the “autoconnect-slaves” property. When overloading is enabled, this is equivalent to

get settingConnection #autoconnectSlaves

setSettingConnectionAutoconnectSlaves :: (MonadIO m, IsSettingConnection o) => o -> SettingConnectionAutoconnectSlaves -> m () Source #

Set the value of the “autoconnect-slaves” property. When overloading is enabled, this is equivalent to

set settingConnection [ #autoconnectSlaves := value ]

controller

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

clearSettingConnectionController :: (MonadIO m, IsSettingConnection o) => o -> m () Source #

Set the value of the “controller” property to Nothing. When overloading is enabled, this is equivalent to

clear #controller

constructSettingConnectionController :: (IsSettingConnection o, MonadIO m) => Text -> m (GValueConstruct o) Source #

Construct a GValueConstruct with valid value for the “controller” property. This is rarely needed directly, but it is used by new.

getSettingConnectionController :: (MonadIO m, IsSettingConnection o) => o -> m Text Source #

Get the value of the “controller” property. When overloading is enabled, this is equivalent to

get settingConnection #controller

setSettingConnectionController :: (MonadIO m, IsSettingConnection o) => o -> Text -> m () Source #

Set the value of the “controller” property. When overloading is enabled, this is equivalent to

set settingConnection [ #controller := value ]

dnsOverTls

Whether DNSOverTls (dns-over-tls) is enabled for the connection. DNSOverTls is a technology which uses TLS to encrypt dns traffic.

The permitted values are: "yes" (2) use DNSOverTls and disabled fallback, "opportunistic" (1) use DNSOverTls but allow fallback to unencrypted resolution, "no" (0) don't ever use DNSOverTls. If unspecified "default" depends on the plugin used. Systemd-resolved uses global setting.

This feature requires a plugin which supports DNSOverTls. Otherwise, the setting has no effect. One such plugin is dns-systemd-resolved.

Since: 1.34

constructSettingConnectionDnsOverTls :: (IsSettingConnection o, MonadIO m) => Int32 -> m (GValueConstruct o) Source #

Construct a GValueConstruct with valid value for the “dns-over-tls” property. This is rarely needed directly, but it is used by new.

getSettingConnectionDnsOverTls :: (MonadIO m, IsSettingConnection o) => o -> m Int32 Source #

Get the value of the “dns-over-tls” property. When overloading is enabled, this is equivalent to

get settingConnection #dnsOverTls

setSettingConnectionDnsOverTls :: (MonadIO m, IsSettingConnection o) => o -> Int32 -> m () Source #

Set the value of the “dns-over-tls” property. When overloading is enabled, this is equivalent to

set settingConnection [ #dnsOverTls := value ]

downOnPoweroff

Whether the connection will be brought down before the system is powered off. The default value is SettingConnectionDownOnPoweroffDefault. When the default value is specified, then the global value from NetworkManager configuration is looked up, if not set, it is considered as SettingConnectionDownOnPoweroffNo.

Since: 1.48

constructSettingConnectionDownOnPoweroff :: (IsSettingConnection o, MonadIO m) => Int32 -> m (GValueConstruct o) Source #

Construct a GValueConstruct with valid value for the “down-on-poweroff” property. This is rarely needed directly, but it is used by new.

getSettingConnectionDownOnPoweroff :: (MonadIO m, IsSettingConnection o) => o -> m Int32 Source #

Get the value of the “down-on-poweroff” property. When overloading is enabled, this is equivalent to

get settingConnection #downOnPoweroff

setSettingConnectionDownOnPoweroff :: (MonadIO m, IsSettingConnection o) => o -> Int32 -> m () Source #

Set the value of the “down-on-poweroff” property. When overloading is enabled, this is equivalent to

set settingConnection [ #downOnPoweroff := value ]

gatewayPingTimeout

If greater than zero, delay success of IP addressing until either the timeout is reached, or an IP gateway replies to a ping.

constructSettingConnectionGatewayPingTimeout :: (IsSettingConnection o, MonadIO m) => Word32 -> m (GValueConstruct o) Source #

Construct a GValueConstruct with valid value for the “gateway-ping-timeout” property. This is rarely needed directly, but it is used by new.

getSettingConnectionGatewayPingTimeout :: (MonadIO m, IsSettingConnection o) => o -> m Word32 Source #

Get the value of the “gateway-ping-timeout” property. When overloading is enabled, this is equivalent to

get settingConnection #gatewayPingTimeout

setSettingConnectionGatewayPingTimeout :: (MonadIO m, IsSettingConnection o) => o -> Word32 -> m () Source #

Set the value of the “gateway-ping-timeout” property. When overloading is enabled, this is equivalent to

set settingConnection [ #gatewayPingTimeout := value ]

id

A human readable unique identifier for the connection, like "Work Wi-Fi" or "T-Mobile 3G".

clearSettingConnectionId :: (MonadIO m, IsSettingConnection o) => o -> m () Source #

Set the value of the “id” property to Nothing. When overloading is enabled, this is equivalent to

clear #id

constructSettingConnectionId :: (IsSettingConnection o, MonadIO m) => Text -> m (GValueConstruct o) Source #

Construct a GValueConstruct with valid value for the “id” property. This is rarely needed directly, but it is used by new.

getSettingConnectionId :: (MonadIO m, IsSettingConnection o) => o -> m Text Source #

Get the value of the “id” property. When overloading is enabled, this is equivalent to

get settingConnection #id

setSettingConnectionId :: (MonadIO m, IsSettingConnection o) => o -> Text -> m () Source #

Set the value of the “id” property. When overloading is enabled, this is equivalent to

set settingConnection [ #id := value ]

interfaceName

The name of the network interface this connection is bound to. If not set, then the connection can be attached to any interface of the appropriate type (subject to restrictions imposed by other settings).

For software devices this specifies the name of the created device.

For connection types where interface names cannot easily be made persistent (e.g. mobile broadband or USB Ethernet), this property should not be used. Setting this property restricts the interfaces a connection can be used with, and if interface names change or are reordered the connection may be applied to the wrong interface.

clearSettingConnectionInterfaceName :: (MonadIO m, IsSettingConnection o) => o -> m () Source #

Set the value of the “interface-name” property to Nothing. When overloading is enabled, this is equivalent to

clear #interfaceName

constructSettingConnectionInterfaceName :: (IsSettingConnection o, MonadIO m) => Text -> m (GValueConstruct o) Source #

Construct a GValueConstruct with valid value for the “interface-name” property. This is rarely needed directly, but it is used by new.

getSettingConnectionInterfaceName :: (MonadIO m, IsSettingConnection o) => o -> m Text Source #

Get the value of the “interface-name” property. When overloading is enabled, this is equivalent to

get settingConnection #interfaceName

setSettingConnectionInterfaceName :: (MonadIO m, IsSettingConnection o) => o -> Text -> m () Source #

Set the value of the “interface-name” property. When overloading is enabled, this is equivalent to

set settingConnection [ #interfaceName := value ]

lldp

Whether LLDP is enabled for the connection.

Since: 1.2

constructSettingConnectionLldp :: (IsSettingConnection o, MonadIO m) => Int32 -> m (GValueConstruct o) Source #

Construct a GValueConstruct with valid value for the “lldp” property. This is rarely needed directly, but it is used by new.

getSettingConnectionLldp :: (MonadIO m, IsSettingConnection o) => o -> m Int32 Source #

Get the value of the “lldp” property. When overloading is enabled, this is equivalent to

get settingConnection #lldp

setSettingConnectionLldp :: (MonadIO m, IsSettingConnection o) => o -> Int32 -> m () Source #

Set the value of the “lldp” property. When overloading is enabled, this is equivalent to

set settingConnection [ #lldp := value ]

llmnr

Whether Link-Local Multicast Name Resolution (LLMNR) is enabled for the connection. LLMNR is a protocol based on the Domain Name System (DNS) packet format that allows both IPv4 and IPv6 hosts to perform name resolution for hosts on the same local link.

The permitted values are: "yes" (2) register hostname and resolving for the connection, "no" (0) disable LLMNR for the interface, "resolve" (1) do not register hostname but allow resolving of LLMNR host names If unspecified, "default" ultimately depends on the DNS plugin (which for systemd-resolved currently means "yes").

This feature requires a plugin which supports LLMNR. Otherwise, the setting has no effect. One such plugin is dns-systemd-resolved.

Since: 1.14

constructSettingConnectionLlmnr :: (IsSettingConnection o, MonadIO m) => Int32 -> m (GValueConstruct o) Source #

Construct a GValueConstruct with valid value for the “llmnr” property. This is rarely needed directly, but it is used by new.

getSettingConnectionLlmnr :: (MonadIO m, IsSettingConnection o) => o -> m Int32 Source #

Get the value of the “llmnr” property. When overloading is enabled, this is equivalent to

get settingConnection #llmnr

setSettingConnectionLlmnr :: (MonadIO m, IsSettingConnection o) => o -> Int32 -> m () Source #

Set the value of the “llmnr” property. When overloading is enabled, this is equivalent to

set settingConnection [ #llmnr := value ]

master

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

Deprecated 1.46. Use SettingConnection:controller instead, this is just an alias.

clearSettingConnectionMaster :: (MonadIO m, IsSettingConnection o) => o -> m () Source #

Set the value of the “master” property to Nothing. When overloading is enabled, this is equivalent to

clear #master

constructSettingConnectionMaster :: (IsSettingConnection o, MonadIO m) => Text -> m (GValueConstruct o) Source #

Construct a GValueConstruct with valid value for the “master” property. This is rarely needed directly, but it is used by new.

getSettingConnectionMaster :: (MonadIO m, IsSettingConnection o) => o -> m Text Source #

Get the value of the “master” property. When overloading is enabled, this is equivalent to

get settingConnection #master

setSettingConnectionMaster :: (MonadIO m, IsSettingConnection o) => o -> Text -> m () Source #

Set the value of the “master” property. When overloading is enabled, this is equivalent to

set settingConnection [ #master := value ]

mdns

Whether mDNS is enabled for the connection.

The permitted values are: "yes" (2) register hostname and resolving for the connection, "no" (0) disable mDNS for the interface, "resolve" (1) do not register hostname but allow resolving of mDNS host names and "default" (-1) to allow lookup of a global default in NetworkManager.conf. If unspecified, "default" ultimately depends on the DNS plugin.

This feature requires a plugin which supports mDNS. Otherwise, the setting has no effect. Currently the only supported DNS plugin is systemd-resolved. For systemd-resolved, the default is configurable via MulticastDNS= setting in resolved.conf.

Since: 1.12

constructSettingConnectionMdns :: (IsSettingConnection o, MonadIO m) => Int32 -> m (GValueConstruct o) Source #

Construct a GValueConstruct with valid value for the “mdns” property. This is rarely needed directly, but it is used by new.

getSettingConnectionMdns :: (MonadIO m, IsSettingConnection o) => o -> m Int32 Source #

Get the value of the “mdns” property. When overloading is enabled, this is equivalent to

get settingConnection #mdns

setSettingConnectionMdns :: (MonadIO m, IsSettingConnection o) => o -> Int32 -> m () Source #

Set the value of the “mdns” property. When overloading is enabled, this is equivalent to

set settingConnection [ #mdns := value ]

metered

Whether the connection is metered.

When updating this property on a currently activated connection, the change takes effect immediately.

Since: 1.2

constructSettingConnectionMetered :: (IsSettingConnection o, MonadIO m) => Metered -> m (GValueConstruct o) Source #

Construct a GValueConstruct with valid value for the “metered” property. This is rarely needed directly, but it is used by new.

getSettingConnectionMetered :: (MonadIO m, IsSettingConnection o) => o -> m Metered Source #

Get the value of the “metered” property. When overloading is enabled, this is equivalent to

get settingConnection #metered

setSettingConnectionMetered :: (MonadIO m, IsSettingConnection o) => o -> Metered -> m () Source #

Set the value of the “metered” property. When overloading is enabled, this is equivalent to

set settingConnection [ #metered := value ]

mptcpFlags

Whether to configure MPTCP endpoints and the address flags. If MPTCP is enabled in NetworkManager, it will configure the addresses of the interface as MPTCP endpoints. Note that IPv4 loopback addresses (127.0.0.0/8), IPv4 link local addresses (169.254.0.0/16), the IPv6 loopback address (1), IPv6 link local addresses (fe80::/10), IPv6 unique local addresses (ULA, fc00::/7) and IPv6 privacy extension addresses (rfc3041, ipv6.ip6-privacy) will be excluded from being configured as endpoints.

If "disabled" (0x1), MPTCP handling for the interface is disabled and no endpoints are registered.

The "enabled" (0x2) flag means that MPTCP handling is enabled. This flag can also be implied from the presence of other flags.

Even when enabled, MPTCP handling will by default still be disabled unless "/proc/sys/net/mptcp/enabled" sysctl is on. NetworkManager does not change the sysctl and this is up to the administrator or distribution. To configure endpoints even if the sysctl is disabled, "also-without-sysctl" (0x4) flag can be used. In that case, NetworkManager doesn't look at the sysctl and configures endpoints regardless.

Even when enabled, NetworkManager will only configure MPTCP endpoints for a certain address family, if there is a unicast default route (0.0.0.0/0 or ::/0) in the main routing table. The flag "also-without-default-route" (0x8) can override that.

When MPTCP handling is enabled then endpoints are configured with the specified address flags "signal" (0x10), "subflow" (0x20), "backup" (0x40), "fullmesh" (0x80). See ip-mptcp(8) manual for additional information about the flags.

If the flags are zero (0x0), the global connection default from NetworkManager.conf is honored. If still unspecified, the fallback is "enabled,subflow". Note that this means that MPTCP is by default done depending on the "/proc/sys/net/mptcp/enabled" sysctl.

NetworkManager does not change the MPTCP limits nor enable MPTCP via "/proc/sys/net/mptcp/enabled". That is a host configuration which the admin can change via sysctl and ip-mptcp.

Strict reverse path filtering (rp_filter) breaks many MPTCP use cases, so when MPTCP handling for IPv4 addresses on the interface is enabled, NetworkManager would loosen the strict reverse path filtering (1) to the loose setting (2).

Since: 1.40

constructSettingConnectionMptcpFlags :: (IsSettingConnection o, MonadIO m) => Word32 -> m (GValueConstruct o) Source #

Construct a GValueConstruct with valid value for the “mptcp-flags” property. This is rarely needed directly, but it is used by new.

getSettingConnectionMptcpFlags :: (MonadIO m, IsSettingConnection o) => o -> m Word32 Source #

Get the value of the “mptcp-flags” property. When overloading is enabled, this is equivalent to

get settingConnection #mptcpFlags

setSettingConnectionMptcpFlags :: (MonadIO m, IsSettingConnection o) => o -> Word32 -> m () Source #

Set the value of the “mptcp-flags” property. When overloading is enabled, this is equivalent to

set settingConnection [ #mptcpFlags := value ]

mudUrl

If configured, set to a Manufacturer Usage Description (MUD) URL that points to manufacturer-recommended network policies for IoT devices. It is transmitted as a DHCPv4 or DHCPv6 option. The value must be a valid URL starting with "https://".

The special value "none" is allowed to indicate that no MUD URL is used.

If the per-profile value is unspecified (the default), a global connection default gets consulted. If still unspecified, the ultimate default is "none".

Since: 1.26

clearSettingConnectionMudUrl :: (MonadIO m, IsSettingConnection o) => o -> m () Source #

Set the value of the “mud-url” property to Nothing. When overloading is enabled, this is equivalent to

clear #mudUrl

constructSettingConnectionMudUrl :: (IsSettingConnection o, MonadIO m) => Text -> m (GValueConstruct o) Source #

Construct a GValueConstruct with valid value for the “mud-url” property. This is rarely needed directly, but it is used by new.

getSettingConnectionMudUrl :: (MonadIO m, IsSettingConnection o) => o -> m Text Source #

Get the value of the “mud-url” property. When overloading is enabled, this is equivalent to

get settingConnection #mudUrl

setSettingConnectionMudUrl :: (MonadIO m, IsSettingConnection o) => o -> Text -> m () Source #

Set the value of the “mud-url” property. When overloading is enabled, this is equivalent to

set settingConnection [ #mudUrl := value ]

multiConnect

Specifies whether the profile can be active multiple times at a particular moment. The value is of type ConnectionMultiConnect.

Since: 1.14

constructSettingConnectionMultiConnect :: (IsSettingConnection o, MonadIO m) => Int32 -> m (GValueConstruct o) Source #

Construct a GValueConstruct with valid value for the “multi-connect” property. This is rarely needed directly, but it is used by new.

getSettingConnectionMultiConnect :: (MonadIO m, IsSettingConnection o) => o -> m Int32 Source #

Get the value of the “multi-connect” property. When overloading is enabled, this is equivalent to

get settingConnection #multiConnect

setSettingConnectionMultiConnect :: (MonadIO m, IsSettingConnection o) => o -> Int32 -> m () Source #

Set the value of the “multi-connect” property. When overloading is enabled, this is equivalent to

set settingConnection [ #multiConnect := value ]

permissions

An array of strings defining what access a given user has to this connection. If this is Nothing or empty, all users are allowed to access this connection; otherwise users are allowed if and only if they are in this list. When this is not empty, the connection can be active only when one of the specified users is logged into an active session. Each entry is of the form "[type]:[id]:[reserved]"; for example, "user:dcbw:blah".

At this time only the "user" [type] is allowed. Any other values are ignored and reserved for future use. [id] is the username that this permission refers to, which may not contain the ":" character. Any [reserved] information present must be ignored and is reserved for future use. All of [type], [id], and [reserved] must be valid UTF-8.

clearSettingConnectionPermissions :: (MonadIO m, IsSettingConnection o) => o -> m () Source #

Set the value of the “permissions” property to Nothing. When overloading is enabled, this is equivalent to

clear #permissions

constructSettingConnectionPermissions :: (IsSettingConnection o, MonadIO m) => [Text] -> m (GValueConstruct o) Source #

Construct a GValueConstruct with valid value for the “permissions” property. This is rarely needed directly, but it is used by new.

getSettingConnectionPermissions :: (MonadIO m, IsSettingConnection o) => o -> m (Maybe [Text]) Source #

Get the value of the “permissions” property. When overloading is enabled, this is equivalent to

get settingConnection #permissions

setSettingConnectionPermissions :: (MonadIO m, IsSettingConnection o) => o -> [Text] -> m () Source #

Set the value of the “permissions” property. When overloading is enabled, this is equivalent to

set settingConnection [ #permissions := value ]

portType

Setting name of the device type of this port's controller connection (eg, SETTING_BOND_SETTING_NAME), or Nothing if this connection is not a port.

Since: 1.46

clearSettingConnectionPortType :: (MonadIO m, IsSettingConnection o) => o -> m () Source #

Set the value of the “port-type” property to Nothing. When overloading is enabled, this is equivalent to

clear #portType

constructSettingConnectionPortType :: (IsSettingConnection o, MonadIO m) => Text -> m (GValueConstruct o) Source #

Construct a GValueConstruct with valid value for the “port-type” property. This is rarely needed directly, but it is used by new.

getSettingConnectionPortType :: (MonadIO m, IsSettingConnection o) => o -> m Text Source #

Get the value of the “port-type” property. When overloading is enabled, this is equivalent to

get settingConnection #portType

setSettingConnectionPortType :: (MonadIO m, IsSettingConnection o) => o -> Text -> m () Source #

Set the value of the “port-type” property. When overloading is enabled, this is equivalent to

set settingConnection [ #portType := value ]

readOnly

This property is deprecated and has no meaning.

constructSettingConnectionReadOnly :: (IsSettingConnection o, MonadIO m) => Bool -> m (GValueConstruct o) Source #

Construct a GValueConstruct with valid value for the “read-only” property. This is rarely needed directly, but it is used by new.

getSettingConnectionReadOnly :: (MonadIO m, IsSettingConnection o) => o -> m Bool Source #

Get the value of the “read-only” property. When overloading is enabled, this is equivalent to

get settingConnection #readOnly

setSettingConnectionReadOnly :: (MonadIO m, IsSettingConnection o) => o -> Bool -> m () Source #

Set the value of the “read-only” property. When overloading is enabled, this is equivalent to

set settingConnection [ #readOnly := value ]

secondaries

List of connection UUIDs that should be activated when the base connection itself is activated. Currently, only VPN connections are supported.

clearSettingConnectionSecondaries :: (MonadIO m, IsSettingConnection o) => o -> m () Source #

Set the value of the “secondaries” property to Nothing. When overloading is enabled, this is equivalent to

clear #secondaries

constructSettingConnectionSecondaries :: (IsSettingConnection o, MonadIO m) => [Text] -> m (GValueConstruct o) Source #

Construct a GValueConstruct with valid value for the “secondaries” property. This is rarely needed directly, but it is used by new.

getSettingConnectionSecondaries :: (MonadIO m, IsSettingConnection o) => o -> m (Maybe [Text]) Source #

Get the value of the “secondaries” property. When overloading is enabled, this is equivalent to

get settingConnection #secondaries

setSettingConnectionSecondaries :: (MonadIO m, IsSettingConnection o) => o -> [Text] -> m () Source #

Set the value of the “secondaries” property. When overloading is enabled, this is equivalent to

set settingConnection [ #secondaries := value ]

slaveType

Setting name of the device type of this port's controller connection (eg, SETTING_BOND_SETTING_NAME), or Nothing if this connection is not a port.

Deprecated 1.46. Use SettingConnection:portType instead, this is just an alias.

clearSettingConnectionSlaveType :: (MonadIO m, IsSettingConnection o) => o -> m () Source #

Set the value of the “slave-type” property to Nothing. When overloading is enabled, this is equivalent to

clear #slaveType

constructSettingConnectionSlaveType :: (IsSettingConnection o, MonadIO m) => Text -> m (GValueConstruct o) Source #

Construct a GValueConstruct with valid value for the “slave-type” property. This is rarely needed directly, but it is used by new.

getSettingConnectionSlaveType :: (MonadIO m, IsSettingConnection o) => o -> m Text Source #

Get the value of the “slave-type” property. When overloading is enabled, this is equivalent to

get settingConnection #slaveType

setSettingConnectionSlaveType :: (MonadIO m, IsSettingConnection o) => o -> Text -> m () Source #

Set the value of the “slave-type” property. When overloading is enabled, this is equivalent to

set settingConnection [ #slaveType := value ]

stableId

This represents the identity of the connection used for various purposes. It allows to configure multiple profiles to share the identity. Also, the stable-id can contain placeholders that are substituted dynamically and deterministically depending on the context.

The stable-id is used for generating IPv6 stable private addresses with ipv6.addr-gen-mode=stable-privacy. It is also used to seed the generated cloned MAC address for ethernet.cloned-mac-address=stable and wifi.cloned-mac-address=stable. It is also used to derive the DHCP client identifier with ipv4.dhcp-client-id=stable, the DHCPv6 DUID with ipv6.dhcp-duid=stable-[llt,ll,uuid] and the DHCP IAID with ipv4.iaid=stable and ipv6.iaid=stable.

Note that depending on the context where it is used, other parameters are also seeded into the generation algorithm. For example, a per-host key is commonly also included, so that different systems end up generating different IDs. Or with ipv6.addr-gen-mode=stable-privacy, also the device's name is included, so that different interfaces yield different addresses. The per-host key is the identity of your machine and stored in /var/lib/NetworkManager/secret_key. See NetworkManager(8) manual about the secret-key and the host identity.

The '$' character is treated special to perform dynamic substitutions at activation time. Currently, supported are "${CONNECTION}", "${DEVICE}", "${MAC}", "${NETWORK_SSID}", "${BOOT}", "${RANDOM}". These effectively create unique IDs per-connection, per-device, per-SSID, per-boot, or every time. The "${CONNECTION}" uses the profile's connection.uuid, the "${DEVICE}" uses the interface name of the device and "${MAC}" the permanent MAC address of the device. "${NETWORK_SSID}" uses the SSID for Wi-Fi networks and falls back to "${CONNECTION}" on other networks. Any unrecognized patterns following '$' are treated verbatim, however are reserved for future use. You are thus advised to avoid '$' or escape it as "$$". For example, set it to "${CONNECTION}-${BOOT}-${DEVICE}" to create a unique id for this connection that changes with every reboot and differs depending on the interface where the profile activates.

If the value is unset, a global connection default is consulted. If the value is still unset, the default is "default${CONNECTION}" go generate an ID unique per connection profile.

Since: 1.4

clearSettingConnectionStableId :: (MonadIO m, IsSettingConnection o) => o -> m () Source #

Set the value of the “stable-id” property to Nothing. When overloading is enabled, this is equivalent to

clear #stableId

constructSettingConnectionStableId :: (IsSettingConnection o, MonadIO m) => Text -> m (GValueConstruct o) Source #

Construct a GValueConstruct with valid value for the “stable-id” property. This is rarely needed directly, but it is used by new.

getSettingConnectionStableId :: (MonadIO m, IsSettingConnection o) => o -> m Text Source #

Get the value of the “stable-id” property. When overloading is enabled, this is equivalent to

get settingConnection #stableId

setSettingConnectionStableId :: (MonadIO m, IsSettingConnection o) => o -> Text -> m () Source #

Set the value of the “stable-id” property. When overloading is enabled, this is equivalent to

set settingConnection [ #stableId := value ]

timestamp

The time, in seconds since the Unix Epoch, that the connection was last _successfully_ fully activated.

NetworkManager updates the connection timestamp periodically when the connection is active to ensure that an active connection has the latest timestamp. The property is only meant for reading (changes to this property will not be preserved).

constructSettingConnectionTimestamp :: (IsSettingConnection o, MonadIO m) => Word64 -> m (GValueConstruct o) Source #

Construct a GValueConstruct with valid value for the “timestamp” property. This is rarely needed directly, but it is used by new.

getSettingConnectionTimestamp :: (MonadIO m, IsSettingConnection o) => o -> m Word64 Source #

Get the value of the “timestamp” property. When overloading is enabled, this is equivalent to

get settingConnection #timestamp

setSettingConnectionTimestamp :: (MonadIO m, IsSettingConnection o) => o -> Word64 -> m () Source #

Set the value of the “timestamp” property. When overloading is enabled, this is equivalent to

set settingConnection [ #timestamp := value ]

type

Base type of the connection. For hardware-dependent connections, should contain the setting name of the hardware-type specific setting (ie, "802-3-ethernet" or "802-11-wireless" or "bluetooth", etc), and for non-hardware dependent connections like VPN or otherwise, should contain the setting name of that setting type (ie, "vpn" or "bridge", etc).

clearSettingConnectionType :: (MonadIO m, IsSettingConnection o) => o -> m () Source #

Set the value of the “type” property to Nothing. When overloading is enabled, this is equivalent to

clear #type

constructSettingConnectionType :: (IsSettingConnection o, MonadIO m) => Text -> m (GValueConstruct o) Source #

Construct a GValueConstruct with valid value for the “type” property. This is rarely needed directly, but it is used by new.

getSettingConnectionType :: (MonadIO m, IsSettingConnection o) => o -> m (Maybe Text) Source #

Get the value of the “type” property. When overloading is enabled, this is equivalent to

get settingConnection #type

setSettingConnectionType :: (MonadIO m, IsSettingConnection o) => o -> Text -> m () Source #

Set the value of the “type” property. When overloading is enabled, this is equivalent to

set settingConnection [ #type := value ]

uuid

A universally unique identifier for the connection, for example generated with libuuid. It should be assigned when the connection is created, and never changed as long as the connection still applies to the same network. For example, it should not be changed when the SettingConnection:id property or SettingIP4Config changes, but might need to be re-created when the Wi-Fi SSID, mobile broadband network provider, or SettingConnection:type property changes.

The UUID must be in the format "2815492f-7e56-435e-b2e9-246bd7cdc664" (ie, contains only hexadecimal characters and "-"). A suitable UUID may be generated by utilsUuidGenerate or nm_uuid_generate_from_string_str().

clearSettingConnectionUuid :: (MonadIO m, IsSettingConnection o) => o -> m () Source #

Set the value of the “uuid” property to Nothing. When overloading is enabled, this is equivalent to

clear #uuid

constructSettingConnectionUuid :: (IsSettingConnection o, MonadIO m) => Text -> m (GValueConstruct o) Source #

Construct a GValueConstruct with valid value for the “uuid” property. This is rarely needed directly, but it is used by new.

getSettingConnectionUuid :: (MonadIO m, IsSettingConnection o) => o -> m Text Source #

Get the value of the “uuid” property. When overloading is enabled, this is equivalent to

get settingConnection #uuid

setSettingConnectionUuid :: (MonadIO m, IsSettingConnection o) => o -> Text -> m () Source #

Set the value of the “uuid” property. When overloading is enabled, this is equivalent to

set settingConnection [ #uuid := value ]

waitActivationDelay

Time in milliseconds to wait for connection to be considered activated. The wait will start after the pre-up dispatcher event.

The value 0 means no wait time. The default value is -1, which currently has the same meaning as no wait time.

Since: 1.40

constructSettingConnectionWaitActivationDelay :: (IsSettingConnection o, MonadIO m) => Int32 -> m (GValueConstruct o) Source #

Construct a GValueConstruct with valid value for the “wait-activation-delay” property. This is rarely needed directly, but it is used by new.

getSettingConnectionWaitActivationDelay :: (MonadIO m, IsSettingConnection o) => o -> m Int32 Source #

Get the value of the “wait-activation-delay” property. When overloading is enabled, this is equivalent to

get settingConnection #waitActivationDelay

setSettingConnectionWaitActivationDelay :: (MonadIO m, IsSettingConnection o) => o -> Int32 -> m () Source #

Set the value of the “wait-activation-delay” property. When overloading is enabled, this is equivalent to

set settingConnection [ #waitActivationDelay := value ]

waitDeviceTimeout

Timeout in milliseconds to wait for device at startup. During boot, devices may take a while to be detected by the driver. This property will cause to delay NetworkManager-wait-online.service and nm-online to give the device a chance to appear. This works by waiting for the given timeout until a compatible device for the profile is available and managed.

The value 0 means no wait time. The default value is -1, which currently has the same meaning as no wait time.

Since: 1.20

constructSettingConnectionWaitDeviceTimeout :: (IsSettingConnection o, MonadIO m) => Int32 -> m (GValueConstruct o) Source #

Construct a GValueConstruct with valid value for the “wait-device-timeout” property. This is rarely needed directly, but it is used by new.

getSettingConnectionWaitDeviceTimeout :: (MonadIO m, IsSettingConnection o) => o -> m Int32 Source #

Get the value of the “wait-device-timeout” property. When overloading is enabled, this is equivalent to

get settingConnection #waitDeviceTimeout

setSettingConnectionWaitDeviceTimeout :: (MonadIO m, IsSettingConnection o) => o -> Int32 -> m () Source #

Set the value of the “wait-device-timeout” property. When overloading is enabled, this is equivalent to

set settingConnection [ #waitDeviceTimeout := value ]

zone

The trust level of a the connection. Free form case-insensitive string (for example "Home", "Work", "Public"). Nothing or unspecified zone means the connection will be placed in the default zone as defined by the firewall.

When updating this property on a currently activated connection, the change takes effect immediately.

clearSettingConnectionZone :: (MonadIO m, IsSettingConnection o) => o -> m () Source #

Set the value of the “zone” property to Nothing. When overloading is enabled, this is equivalent to

clear #zone

constructSettingConnectionZone :: (IsSettingConnection o, MonadIO m) => Text -> m (GValueConstruct o) Source #

Construct a GValueConstruct with valid value for the “zone” property. This is rarely needed directly, but it is used by new.

getSettingConnectionZone :: (MonadIO m, IsSettingConnection o) => o -> m Text Source #

Get the value of the “zone” property. When overloading is enabled, this is equivalent to

get settingConnection #zone

setSettingConnectionZone :: (MonadIO m, IsSettingConnection o) => o -> Text -> m () Source #

Set the value of the “zone” property. When overloading is enabled, this is equivalent to

set settingConnection [ #zone := value ]