From eff02e35ced3f7ad38853df1aa7c83aaf0bbf65e Mon Sep 17 00:00:00 2001 From: Thomas Haller Date: Mon, 9 Feb 2015 15:33:28 +0100 Subject: WIP: man: explain the format for device specifier in manual page for NetworkManager.conf TODO: just a first shot. The layout is terrible. Should be fixed. Rewording is necessary too. Fixup! commits are welcome --- man/NetworkManager.conf.xml.in | 62 ++++++++++++++++++++++++++++++++---------- 1 file changed, 48 insertions(+), 14 deletions(-) diff --git a/man/NetworkManager.conf.xml.in b/man/NetworkManager.conf.xml.in index d9d51b846a..ebd90da3ea 100644 --- a/man/NetworkManager.conf.xml.in +++ b/man/NetworkManager.conf.xml.in @@ -162,7 +162,7 @@ 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 supported format no-auto-default=00:22:68:5c:5d:c4,00:1e:65:ff:aa:ee no-auto-default=eth0,eth1 @@ -194,8 +194,7 @@ Copyright 2010 - 2014 Red Hat, Inc. the device when carrier is lost. - May have the special value * to apply - to all devices. + Devices are specified according to . Note that the "carrier" property of NMDevices and device D-Bus @@ -279,17 +278,8 @@ 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. Devices are specified according to . + Example: @@ -545,6 +535,50 @@ unmanaged-devices=mac:00:22:68:1c:59:b1;mac:00:1E:65:30:D1:C4;interface-name:eth + + Detail + + Device List Format + + Properties such as main.no-auto-default, main.ignore-carrier, + and keyfile.unmanaged-devices name a list of matching devices. + Devices can be specified using the following format: + + "*": matches every device + "IFNAME": exact match of interface name of device. + Globbing is not supported and the match is case sensitive + "HWADDR": exact match of the mac address of the + device. Globbing is not supported and the match is case insensitive + "interface-name:IFNAME": match of interface name of device. + Simple globbing is supported using '?' and '*' and the match is case sensitive. Escaping of + globbing characters is not supported. + "interface-name:=IFNAME": exact match of interface name of device. + Globbing is not supported and the match is case sensitive. + "mac:HWADDR": match the mac address of the device. + Globbing is not supported and the match is not case sensitive. + "s390-subchannels:HWADDR": match the subchannel address of the device. + Globbing is not supported and the match is not case sensitive. + "except:SPEC": negated match. SPEC must be explicitly qualified with + a prefix such as interface-name:. A matching except has higher priority. + + "SPEC[;,]SPEC": multiple specs can be concatenated with comma or + semicolon. The order of the specs does not matter as "except:SPEC" has + higher priority. + Backslash is supported to escape the separators ';' and ',', and to express special + characters such as newline ('\n'), tabulator ('\t') and backslash ('\\'). The globbing of interface names + cannot be escaped. + + 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 -- cgit v1.2.1