GI.NM.Objects.SettingHostname

Hostname settings

Since: 1.30

Exported types

newtype SettingHostname

Memory-managed wrapper type.

Constructors

SettingHostname (ManagedPtr SettingHostname)

Instances

Eq SettingHostname

Defined in GI.NM.Objects.SettingHostname

Methods

(==) :: SettingHostname -> SettingHostname -> Bool

(/=) :: SettingHostname -> SettingHostname -> Bool

GObject SettingHostname

Defined in GI.NM.Objects.SettingHostname

ManagedPtrNewtype SettingHostname

Defined in GI.NM.Objects.SettingHostname

Methods

toManagedPtr :: SettingHostname -> ManagedPtr SettingHostname

TypedObject SettingHostname

Defined in GI.NM.Objects.SettingHostname

Methods

glibType :: IO GType

HasParentTypes SettingHostname

Defined in GI.NM.Objects.SettingHostname

IsGValue (Maybe SettingHostname)

Convert SettingHostname to and from GValue. See toGValue and fromGValue.

Defined in GI.NM.Objects.SettingHostname

Methods

gvalueGType_ :: IO GType

gvalueSet_ :: Ptr GValue -> Maybe SettingHostname -> IO ()

gvalueGet_ :: Ptr GValue -> IO (Maybe SettingHostname)

type ParentTypes SettingHostname

Defined in GI.NM.Objects.SettingHostname

type ParentTypes SettingHostname = '[Setting, Object]

class (GObject o, IsDescendantOf SettingHostname o) => IsSettingHostname o

Type class for types which can be safely cast to SettingHostname, for instance with toSettingHostname.

Instances

(GObject o, IsDescendantOf SettingHostname o) => IsSettingHostname o

Defined in GI.NM.Objects.SettingHostname

toSettingHostname :: (MonadIO m, IsSettingHostname o) => o -> m SettingHostname

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

Methods

Click to display all available methods, including inherited ones

Methods

bindProperty, bindPropertyFull, compare, diff, duplicate, enumerateValues, forceFloating, freezeNotify, getv, isFloating, notify, notifyByPspec, optionClearByName, optionGet, optionGetAllNames, optionGetBoolean, optionGetUint32, optionSet, optionSetBoolean, optionSetUint32, ref, refSink, runDispose, stealData, stealQdata, thawNotify, toString, unref, verify, verifySecrets, watchClosure.

Getters

getData, getDbusPropertyType, getFromDhcp, getFromDnsLookup, getName, getOnlyFromDefault, getPriority, getProperty, getQdata, getSecretFlags.

Setters

setData, setDataFull, setProperty, setSecretFlags.

getFromDhcp

settingHostnameGetFromDhcp

Arguments

:: (HasCallStack, MonadIO m, IsSettingHostname a)

=> a

setting: the SettingHostname

-> m Ternary

Returns: the 'from-dhcp' property value

Returns the value contained in the SettingHostname:fromDhcp property.

Since: 1.30

getFromDnsLookup

settingHostnameGetFromDnsLookup

Arguments

:: (HasCallStack, MonadIO m, IsSettingHostname a)

=> a

setting: the SettingHostname

-> m Ternary

Returns: the 'from-dns-lookup' property value

Returns the value contained in the SettingHostname:fromDnsLookup property.

Since: 1.30

getOnlyFromDefault

settingHostnameGetOnlyFromDefault

Arguments

:: (HasCallStack, MonadIO m, IsSettingHostname a)

=> a

setting: the SettingHostname

-> m Ternary

Returns: the 'only-from-default' property value

Returns the value contained in the SettingHostname:onlyFromDefault property.

Since: 1.30

getPriority

settingHostnameGetPriority

Arguments

:: (HasCallStack, MonadIO m, IsSettingHostname a)

=> a

setting: the SettingHostname

-> m Int32

Returns: the 'priority' property value

Returns the value contained in the SettingHostname:priority property.

Since: 1.30

new

settingHostnameNew

Arguments

:: (HasCallStack, MonadIO m)

=> m SettingHostname

Returns: the new empty SettingHostname object

Creates a new SettingHostname object with default values.

Since: 1.42

Properties

fromDhcp

Whether the system hostname can be determined from DHCP on this connection.

When set to TernaryDefault, the value from global configuration is used. If the property doesn't have a value in the global configuration, NetworkManager assumes the value to be TernaryTrue.

Since: 1.30

constructSettingHostnameFromDhcp :: (IsSettingHostname o, MonadIO m) => Ternary -> m (GValueConstruct o)

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

getSettingHostnameFromDhcp :: (MonadIO m, IsSettingHostname o) => o -> m Ternary

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

get settingHostname #fromDhcp

setSettingHostnameFromDhcp :: (MonadIO m, IsSettingHostname o) => o -> Ternary -> m ()

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

set settingHostname [ #fromDhcp := value ]

fromDnsLookup

Whether the system hostname can be determined from reverse DNS lookup of addresses on this device.

When set to TernaryDefault, the value from global configuration is used. If the property doesn't have a value in the global configuration, NetworkManager assumes the value to be TernaryTrue.

Since: 1.30

constructSettingHostnameFromDnsLookup :: (IsSettingHostname o, MonadIO m) => Ternary -> m (GValueConstruct o)

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

getSettingHostnameFromDnsLookup :: (MonadIO m, IsSettingHostname o) => o -> m Ternary

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

get settingHostname #fromDnsLookup

setSettingHostnameFromDnsLookup :: (MonadIO m, IsSettingHostname o) => o -> Ternary -> m ()

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

set settingHostname [ #fromDnsLookup := value ]

onlyFromDefault

If set to TernaryTrue, NetworkManager attempts to get the hostname via DHCPv4/DHCPv6 or reverse DNS lookup on this device only when the device has the default route for the given address family (IPv4/IPv6).

If set to TernaryFalse, the hostname can be set from this device even if it doesn't have the default route.

When set to TernaryDefault, the value from global configuration is used. If the property doesn't have a value in the global configuration, NetworkManager assumes the value to be TernaryFalse.

Since: 1.30

constructSettingHostnameOnlyFromDefault :: (IsSettingHostname o, MonadIO m) => Ternary -> m (GValueConstruct o)

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

getSettingHostnameOnlyFromDefault :: (MonadIO m, IsSettingHostname o) => o -> m Ternary

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

get settingHostname #onlyFromDefault

setSettingHostnameOnlyFromDefault :: (MonadIO m, IsSettingHostname o) => o -> Ternary -> m ()

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

set settingHostname [ #onlyFromDefault := value ]

priority

The relative priority of this connection to determine the system hostname. A lower numerical value is better (higher priority). A connection with higher priority is considered before connections with lower priority.

If the value is zero, it can be overridden by a global value from NetworkManager configuration. If the property doesn't have a value in the global configuration, the value is assumed to be 100.

Negative values have the special effect of excluding other connections with a greater numerical priority value; so in presence of at least one negative priority, only connections with the lowest priority value will be used to determine the hostname.

Since: 1.30

constructSettingHostnamePriority :: (IsSettingHostname o, MonadIO m) => Int32 -> m (GValueConstruct o)

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

getSettingHostnamePriority :: (MonadIO m, IsSettingHostname o) => o -> m Int32

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

get settingHostname #priority

setSettingHostnamePriority :: (MonadIO m, IsSettingHostname o) => o -> Int32 -> m ()

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

set settingHostname [ #priority := value ]