diff options
| author | Zbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl> | 2019-01-16 14:26:29 +0100 |
|---|---|---|
| committer | Zbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl> | 2019-01-17 13:56:02 +0100 |
| commit | 3907446f02d5966e795a7361860f7189c8b3ccc5 (patch) | |
| tree | 4efa721555f3bb44929f9ca7bad63a9f0e2a2724 /man/systemd.link.xml | |
| parent | link-config: unentangle the renaming logic and add logging (diff) | |
| download | systemd-3907446f02d5966e795a7361860f7189c8b3ccc5.tar.xz systemd-3907446f02d5966e795a7361860f7189c8b3ccc5.zip | |
link-config: add "keep" policy and use it by default
If "keep" policy is specified, and the interface has a name that is
NET_NAME_USER or NET_NAME_RENAMED, we stop processing rules. "keep" should
probably be specified either first or last depending on the preference.
This partially reimplements 55b6530baacf4658a183b15b010a8cf3483fde08, in the
sense that if the "keep" policy is not specified, and if the interface has
a NamingPolicy, it will be renamed, even if it had a name previously.
So this breaks backwards compatibility in this case, but that's more in line
with what users expect.
Closes #9006.
Diffstat (limited to 'man/systemd.link.xml')
| -rw-r--r-- | man/systemd.link.xml | 24 |
1 files changed, 13 insertions, 11 deletions
diff --git a/man/systemd.link.xml b/man/systemd.link.xml index f74edd0186..22713e0316 100644 --- a/man/systemd.link.xml +++ b/man/systemd.link.xml @@ -250,17 +250,12 @@ <varlistentry> <term><varname>NamePolicy=</varname></term> <listitem> - <para>An ordered, space-separated list of policies by which - the interface name should be set. - <literal>NamePolicy</literal> may be disabled by specifying - <literal>net.ifnames=0</literal> 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 <literal>ID_NET_NAME</literal>, which - is, by default, used by a udev rule to set - <literal>NAME</literal>. If the name has already been set by - userspace, no renaming is performed. The available policies - are:</para> + <para>An ordered, space-separated list of policies by which the interface name should be set. + <literal>NamePolicy</literal> may be disabled by specifying <literal>net.ifnames=0</literal> 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 <literal>ID_NET_NAME</literal>, which + is, by default, used by a udev rule to set <literal>NAME</literal>. The available policies are: + </para> <variablelist> <varlistentry> @@ -314,6 +309,13 @@ <literal>ID_NET_NAME_MAC</literal>.</para> </listitem> </varlistentry> + <varlistentry> + <term><literal>keep</literal></term> + <listitem> + <para>If the device already had a name given by userspace (as part of creation of the device + or a rename), keep it.</para> + </listitem> + </varlistentry> </variablelist> </listitem> </varlistentry> |