diff --git a/man/systemd.link.xml b/man/systemd.link.xml index 22713e0316..c4b1a3bfc5 100644 --- a/man/systemd.link.xml +++ b/man/systemd.link.xml @@ -50,27 +50,21 @@ same name pointing to /dev/null disables the configuration file entirely (it is "masked"). - The link file contains a [Match] section, - which determines if a given link file may be applied to a given - device, as well as a [Link] section specifying - how the device should be configured. The first (in lexical order) - of the link files that matches a given device is applied. Note - that a default file 99-default.link is - shipped by the system. Any user-supplied - .link should hence have a lexically earlier - name to be considered at all. + The link file contains a [Match] section, which determines if a given link file may be applied to a + given device, as well as a [Link] section specifying how the device should be configured. The first (in + lexical order) of the link files that matches a given device is applied. Note that a default file + 99-default.link is shipped by the system. Any user-supplied + .link should hence have a lexically earlier name to be considered at all. - See - udevadm8 - for diagnosing problems with .link files. + See udevadm8 for + diagnosing problems with .link files. [Match] Section Options - A link file is said to match a device if each of the entries - in the [Match] section matches, or if the - section is empty. The following keys are accepted: + A link file is said to match a device if each of the entries in the [Match] section matches, or if + the section is empty. The following keys are accepted: @@ -100,18 +94,15 @@ A whitespace-separated list of shell-style globs matching the persistent path, as exposed by the udev property - ID_PATH. + ID_PATH. Driver= - A whitespace-separated list of shell-style globs matching - the driver currently bound to the device, - as exposed by the udev property DRIVER - of its parent device, or if that is not set, the - driver as exposed by ethtool -i - of the device itself. + A whitespace-separated list of shell-style globs matching the driver currently bound to the + device, as exposed by the udev property DRIVER of its parent device, or if that + is not set, the driver as exposed by ethtool -i of the device itself. @@ -119,14 +110,14 @@ A whitespace-separated list of shell-style globs matching the device type, as exposed by the udev - property DEVTYPE. + property DEVTYPE. Host= Matches against the hostname or machine - ID of the host. See ConditionHost= in + ID of the host. See ConditionHost= in systemd.unit5 for details. @@ -137,7 +128,7 @@ Checks whether the system is executed in a virtualized environment and optionally test whether it is a specific implementation. See - ConditionVirtualization= in + ConditionVirtualization= in systemd.unit5 for details. @@ -147,7 +138,7 @@ Checks whether a specific kernel command line option is set (or if prefixed with the exclamation mark unset). See - ConditionKernelCommandLine= in + ConditionKernelCommandLine= in systemd.unit5 for details. @@ -157,7 +148,7 @@ Checks whether the kernel version (as reported by uname -r) matches a certain expression (or if prefixed with the exclamation mark does not match it). See - ConditionKernelVersion= in + ConditionKernelVersion= in systemd.unit5 for details. @@ -167,7 +158,7 @@ Architecture= Checks whether the system is running on a specific - architecture. See ConditionArchitecture= + architecture. See ConditionArchitecture= in systemd.unit5 for details. @@ -180,7 +171,7 @@ [Link] Section Options - The [Link] section accepts the following + The [Link] section accepts the following keys: @@ -193,8 +184,7 @@ Alias= - The ifalias is set to this - value. + The ifalias interface property is set to this value. @@ -206,7 +196,7 @@ - persistent + If the hardware has a persistent MAC address, as most hardware should, and if it is used by the kernel, @@ -220,7 +210,7 @@ - random + If the kernel is using a random MAC address, nothing is done. Otherwise, a new address is randomly @@ -231,7 +221,7 @@ - none + Keeps the MAC address assigned by the kernel. @@ -243,7 +233,7 @@ MACAddress= The MAC address to use, if no - MACAddressPolicy= + MACAddressPolicy= is specified. @@ -251,15 +241,15 @@ NamePolicy= An ordered, space-separated list of policies by which the interface name should be set. - NamePolicy may be disabled by specifying net.ifnames=0 on the + NamePolicy= may be disabled by specifying on the kernel command line. Each of the policies may fail, and the first successful one is used. The name - is not set directly, but is exported to udev as the property ID_NET_NAME, which - is, by default, used by a udev rule to set NAME. The available policies are: + is not set directly, but is exported to udev as the property , which + is, by default, used by a udev rule to set NAME. The available policies are: - kernel + If the kernel claims that the name it has set for a device is predictable, then no renaming is @@ -267,50 +257,50 @@ - database + The name is set based on entries in the udev's Hardware Database with the key - ID_NET_NAME_FROM_DATABASE. + ID_NET_NAME_FROM_DATABASE. - onboard + The name is set based on information given by the firmware for on-board devices, as exported by the - udev property ID_NET_NAME_ONBOARD. + udev property ID_NET_NAME_ONBOARD. - slot + The name is set based on information given by the firmware for hot-plug devices, as exported by the - udev property ID_NET_NAME_SLOT. + udev property ID_NET_NAME_SLOT. - path + The name is set based on the device's physical location, as exported by the udev property - ID_NET_NAME_PATH. + ID_NET_NAME_PATH. - mac + The name is set based on the device's persistent MAC address, as exported by the udev property - ID_NET_NAME_MAC. + ID_NET_NAME_MAC. - keep + If the device already had a name given by userspace (as part of creation of the device or a rename), keep it. @@ -358,9 +348,8 @@ Duplex= - The duplex mode to set for the device. The accepted - values are half and - full. + The duplex mode to set for the device. The accepted values are and + . @@ -384,58 +373,58 @@ - phy + Wake on PHY activity. - unicast + Wake on unicast messages. - multicast + Wake on multicast messages. - broadcast + Wake on broadcast messages. - arp + Wake on ARP. - magic + Wake on receipt of a magic packet. - secureon + Enable secureon(tm) password for MagicPacket(tm). - off + Never wake. - Defaults to off. + Defaults to . @@ -446,32 +435,32 @@ - tp + An Ethernet interface using Twisted-Pair cable as the medium. - aui + Attachment Unit Interface (AUI). Normally used with hubs. - bnc + An Ethernet interface using BNC connectors and co-axial cable. - mii + An Ethernet interface using a Media Independent Interface (MII). - fibre + An Ethernet interface using Optical Fibre as the medium. @@ -498,47 +487,46 @@ Duplex Mode - - 10baset-half + 10half - 10baset-full + 10full - 100baset-half + 100half - 100baset-full + 100full - 1000baset-half + 1000half - 1000baset-full + 1000full - 10000baset-full + 10000full - 2500basex-full + 2500full - 1000basekx-full + 1000full - 10000basekx4-full + 10000full - 10000basekr-full + 10000full - 10000baser-fec + 10000full - 20000basemld2-full + 20000full - 20000basekr2-full + 20000full