man: clarify keyfile.unmanaged-devices in man NetworkManager.conf

This commit is contained in:
Thomas Haller 2021-03-20 10:39:41 +01:00
parent ed172287da
commit 5a20d96f36
No known key found for this signature in database
GPG key ID: 29C2366E4DFC5728

View file

@ -502,19 +502,29 @@ no-auto-default=*
</varlistentry>
<varlistentry>
<term><varname>unmanaged-devices</varname></term>
<listitem><para>Set devices that should be ignored by
NetworkManager.
</para>
<para>See <xref linkend="device-spec"/> for the syntax on how to
specify a device.
</para>
<para>
Example:
<programlisting>
<listitem>
<para>Set devices that should be ignored by NetworkManager.
</para>
<para>
A device unmanaged due to this option is strictly
unmanaged and cannot be overruled by using the API like
<command>nmcli device set $IFNAME managed yes</command>.
Also, a device that is unmanaged for other reasons, like
an udev rule, cannot be made managed with this option (e.g. by
using an <literal>except:</literal> specifier).
These two points make it different from the <literal>device*.managed</literal>
option which for that reason may be a better choice.
</para>
<para>See <xref linkend="device-spec"/> for the syntax on how to
specify a device.
</para>
<para>
Example:
<programlisting>
unmanaged-devices=interface-name:em4
unmanaged-devices=mac:00:22:68:1c:59:b1;mac:00:1E:65:30:D1:C4;interface-name:eth2
</programlisting>
</para>
</para>
</listitem>
</varlistentry>
</variablelist>