diff --git a/man/NetworkManager.conf.xml.in b/man/NetworkManager.conf.xml.in
index d9d51b846..ecba84439 100644
--- a/man/NetworkManager.conf.xml.in
+++ b/man/NetworkManager.conf.xml.in
@@ -148,7 +148,7 @@ Copyright 2010 - 2014 Red Hat, Inc.
no-auto-default
- Comma-separated list of devices for which
+ Specify devices for which
NetworkManager shouldn't create default wired connection
(Auto eth0). By default, NetworkManager creates a temporary
wired connection for any Ethernet device that is managed and
@@ -162,11 +162,15 @@ Copyright 2010 - 2014 Red Hat, Inc.
/var/run/NetworkManager/no-auto-default.state
to prevent creating the default connection for that device
again.
+ See for the syntax how to
+ specify a device.
+
+ Example:
- no-auto-default=00:22:68:5c:5d:c4,00:1e:65:ff:aa:ee
- no-auto-default=eth0,eth1
- no-auto-default=*
+no-auto-default=00:22:68:5c:5d:c4,00:1e:65:ff:aa:ee
+no-auto-default=eth0,eth1
+no-auto-default=*
@@ -176,8 +180,8 @@ Copyright 2010 - 2014 Red Hat, Inc.
ignore-carrier
- Comma-separated list of devices for which NetworkManager
- will (partially) ignore the carrier state. Normally, for
+ 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
@@ -193,15 +197,14 @@ Copyright 2010 - 2014 Red Hat, Inc.
connection (whether static or dynamic) to remain active on
the device when carrier is lost.
-
- May have the special value * to apply
- to all devices.
-
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.
+ See for the syntax how to
+ specify a device.
+
@@ -279,17 +282,11 @@ Copyright 2010 - 2014 Red Hat, Inc.
unmanaged-devices
Set devices that should be ignored by
- NetworkManager when using the keyfile
- plugin. Devices are specified in the following
- format:
- mac:<hwaddr> or
- interface-name:<ifname>. Here
- hwaddr is the MAC address of the device
- to be ignored, in hex-digits-and-colons notation.
- ifname is the interface name of the
- ignored device.
- Multiple entries are separated with semicolons. No
- spaces are allowed in the value.
+ NetworkManager.
+
+ See for the syntax how to
+ specify a device.
+
Example:
@@ -545,6 +542,77 @@ unmanaged-devices=mac:00:22:68:1c:59:b1;mac:00:1E:65:30:D1:C4;interface-name:eth
+
+ 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.
+ Devices can be specified using the following format:
+
+
+
+
+ *
+ Matches every device.
+
+
+ IFNAME
+ Case sensitive match of interface name of the device. Globbing is not supported.
+
+
+ HWADDR
+ Match the MAC address of the device. Globbing is not supported
+
+
+ interface-name:IFNAME
+ interface-name:~IFNAME
+ Case sensitive match of interface name of the device. Simple globbing is supported with
+ * and ?. Ranges and escaping is not supported.
+
+
+ interface-name:=IFNAME
+ Case sensitive match of interface name of the device. Globbing is disabled and IFNAME
+ is taken literally.
+
+
+ mac:HWADDR
+ Match the MAC address of the device. Globbing is not supported
+
+
+ s390-subchannels:HWADDR
+ Match the device based on the subchannel address. Globbing is not supported
+
+
+ except:SPEC
+ Negative match of a device. SPEC must be explicitly qualified with
+ a prefix such as interface-name:. A negative match has higher priority then the positive
+ matches above.
+
+
+ SPEC[,;]SPEC
+ Multiple specs can be concatenated with comman or semicolon. The order does not matter as
+ matches are either positive (inclusive) or negative, with negative matches having higher priority.
+ Backslash is supported to escape the separators ';' and ',', and to express special
+ characters such as newline ('\n'), tabulator ('\t'), whitespace ('\s') and backslash ('\\'). The globbing of
+ interface names cannot be escaped. Whitespace is taken literally so usually the specs will be concatenated
+ without spaces.
+
+
+
+
+ Example:
+
+interface-name:em4
+mac:00:22:68:1c:59:b1;mac:00:1E:65:30:D1:C4;interface-name:eth2
+interface-name:vboxnet*,except:interface-name:vboxnet2
+*,except:mac:00:22:68:1c:59:b1
+
+
+
+
+
See Also