- Specify devices for which NetworkManager will (partially) - ignore the carrier state. Normally, for - device types that support carrier-detect, such as Ethernet - and InfiniBand, NetworkManager will only allow a - connection to be activated on the device if carrier is - present (ie, a cable is plugged in), and it will - deactivate the device if carrier drops for more than a few - seconds. -

- Listing a device here will allow activating connections on - that device even when it does not have carrier, provided - that the connection uses only statically-configured IP - addresses. Additionally, it will allow any active - connection (whether static or dynamic) to remain active on - the device when carrier is lost. -

- Note that the "carrier" property of NMDevices and device D-Bus - interfaces will still reflect the actual device state; it's just - that NetworkManager will not make use of that information. -

+ This setting is deprecated for the per-device setting + ignore-carrier which overwrites this setting + if specified (See ???). + Otherwise, it is a list of matches to specify for which device + carrier should be ignored. See the section called “Device List Format” for the + syntax how to specify a device. +

none: NetworkManager will not - modify resolv.conf. This implies rc-manager - unmanaged

symlink: NetworkManager will symlink /etc/resolv.conf to its private - resolv.conf file in the runtime state directory.

file: NetworkManager will write /etc/resolv.conf as file. If it finds a symlink, it will follow the symlink and update the target @@ -325,7 +310,7 @@ no-auto-default=*

The location where keyfiles are read and stored. - This defaults to "${prefix}/etc/NetworkManager/conf.d". + This defaults to "/etc/NetworkManager/conf.d".

You can specify per-domain log level overrides by @@ -530,7 +515,7 @@ ipv6.ip6-privacy=0

Not all properties can be overwritten, only the following properties are supported to have their default values configured - (see nm-settings(5) for details). + (see nm-settings(5) for details). A default value is only consulted if the corresponding per-connection value explicitly allows for that.

If left unspecified, MAC address randomization is disabled. + This setting is deprecated for wifi.cloned-mac-address. +

+`device` section

Contains per-device persistent configuration. +

+ Example: +

+[device]
+match-device=interface-name:eth3
+unmanaged=1
+

Supported Properties

+ The following properties can be configured per-device. +

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

ignore-carrier

+ Specify devices for which NetworkManager will (partially) + ignore the carrier state. Normally, for + device types that support carrier-detect, such as Ethernet + and InfiniBand, NetworkManager will only allow a + connection to be activated on the device if carrier is + present (ie, a cable is plugged in), and it will + deactivate the device if carrier drops for more than a few + seconds. +

+ A device with carrier ignored will allow activating connections on + that device even when it does not have carrier, provided + that the connection uses only statically-configured IP + addresses. Additionally, it will allow any active + connection (whether static or dynamic) to remain active on + the device when carrier is lost. +

+ Note that the "carrier" property of NMDevices and device D-Bus + interfaces will still reflect the actual device state; it's just + that NetworkManager will not make use of that information. +

+ This setting overwrites the deprecated main.ignore-carrier + setting above. +

wifi.scan-rand-mac-address

+ Configures MAC address randomization of a Wi-Fi device during + scanning. This defaults to yes in which case + a random, locally-administered MAC address will be used. + The setting wifi.scan-generate-mac-address-mask + allows to influence the generated MAC address to use certain vendor + OUIs. + If disabled, the MAC address during scanning is left unchanged to + whatever is configured. + For the configured MAC address while the device is associated, see instead + the per-connection setting wifi.cloned-mac-address. +

wifi.scan-generate-mac-address-mask

+ Like the per-connection settings ethernet.generate-mac-address-mask + and wifi.generate-mac-address-mask, this allows to configure the + generated MAC addresses during scanning. See nm-settings(5) + for details. +

Sections

+ The [device] section works the same as the [connection] section. + That is, multiple sections that all start with the prefix "device" can be specified. + The settings "match-device" and "stop-match" are available to match a device section + on a device. The order of multiple sections is also top-down within the file and + later files overwrite previous settings. See the section called “Sections” + for details. +

`connectivity` section

This section controls NetworkManager's optional connectivity checking functionality. This allows NetworkManager to detect @@ -721,7 +824,7 @@ ipv6.ip6-privacy=1

+

`global-dns` section

This section specifies global DNS settings that override connection-specific configuration.

@@ -751,7 +854,7 @@ ipv6.ip6-privacy=1

+

`global-dns-domain` sections

Sections with a name starting with the "global-dns-domain-" prefix allow to define global DNS configuration for specific @@ -787,7 +890,7 @@ ipv6.ip6-privacy=1

+

`.config` sections

This is a special section that contains options which apply to the configuration file that contains the option. @@ -890,7 +993,7 @@ enable=nm-version-min:1.3,nm-version-min:1.2.6,nm-version-min:1.0.16

Plugins

@@ -974,12 +1077,13 @@ enable=nm-version-min:1.3,nm-version-min:1.2.6,nm-version-min:1.0.16

Appendix

Device List Format

The configuration options main.no-auto-default, main.ignore-carrier, - and keyfile.unmanaged-devices select devices based on a list of matchings. + keyfile.unmanaged-devices, connection*.match-device and + device*.match-device select devices based on a list of matchings. Devices can be specified using the following format:

@@ -1000,7 +1104,7 @@ enable=nm-version-min:1.3,nm-version-min:1.2.6,nm-version-min:1.0.16

HWADDR

Match the MAC address of the device. Globbing is not supported

Match the permanent MAC address of the device. Globbing is not supported

interface-name:IFNAME, interface-name:~IFNAME

@@ -1014,7 +1118,7 @@ enable=nm-version-min:1.3,nm-version-min:1.2.6,nm-version-min:1.0.16

mac:HWADDR

Match the MAC address of the device. Globbing is not supported

Match the permanent MAC address of the device. Globbing is not supported

s390-subchannels:HWADDR

@@ -1063,19 +1167,19 @@ interface-name:vboxnet*,except:interface-name:vboxnet2

Sections

Sections

+`device` section

Supported Properties

Sections

`connectivity` section

+

`global-dns` section

+

`global-dns-domain` sections

+

`.config` sections

Plugins

Plugins

Appendix

Appendix

Device List Format

See Also

See Also

Sections

Sections

+device section

Supported Properties

Sections

connectivity section

+

global-dns section

+

global-dns-domain sections

+

.config sections

Plugins

Plugins

Appendix

Appendix

Device List Format

See Also

See Also

+`device` section

`connectivity` section

`global-dns` section

`global-dns-domain` sections

`.config` sections