Este conteúdo não está disponível no idioma selecionado.
Chapter 14. Configuring NetworkManager to ignore certain devices
By default, NetworkManager manages all devices except the ones described in the /usr/lib/udev/rules.d/85-nm-unmanaged.rules
file. To ignore certain other devices, you can configure them in NetworkManager as unmanaged
.
14.1. Permanently configuring a device as unmanaged in NetworkManager
You can configure devices as unmanaged
based on several criteria, such as the interface name, MAC address, or device type. If you use a device section in the configuration to set a device as unmanaged, NetworkManager does not manage the device until you start using it in a connection profile.
Procedure
Optional: Display the list of devices to identify the device or MAC address you want to set as
unmanaged
:Copy to Clipboard Copied! Toggle word wrap Toggle overflow ip link show
# ip link show ... 2: enp1s0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc fq_codel state UP mode DEFAULT group default qlen 1000 link/ether 52:54:00:74:79:56 brd ff:ff:ff:ff:ff:ff ...
-
Create a
*.conf
file in the/etc/NetworkManager/conf.d/
directory, for example,/etc/NetworkManager/conf.d/99-unmanaged-devices.conf
. For each device you want to configure as unmanaged, add a section with a unique name to the file.
ImportantThe section name must begin with
device-
.To configure a specific interface as unmanaged, add:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow [device-enp1s0-unmanaged] match-device=interface-name:enp1s0 managed=0
[device-enp1s0-unmanaged] match-device=interface-name:enp1s0 managed=0
To configure a device with a specific MAC address as unmanaged, add:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow [device-mac525400747956-unmanaged] match-device=mac:52:54:00:74:79:56 managed=0
[device-mac525400747956-unmanaged] match-device=mac:52:54:00:74:79:56 managed=0
To configure all devices of a specific type as unmanaged, add:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow [device-ethernet-unmanaged] match-device=type:ethernet managed=0
[device-ethernet-unmanaged] match-device=type:ethernet managed=0
To set multiple devices as unmanaged, separate the entries in the
unmanaged-devices
parameter with a semicolon, for example:Copy to Clipboard Copied! Toggle word wrap Toggle overflow [device-multiple-devices-unmanaged] match-device=interface-name:enp1s0;interface-name:enp7s0 managed=0
[device-multiple-devices-unmanaged] match-device=interface-name:enp1s0;interface-name:enp7s0 managed=0
Alternatively, you can add separate sections for each device in this file or create additional
*.conf
files in the/etc/NetworkManager/conf.d/
directory.
Restart the host system:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow reboot
# reboot
Verification
Display the list of devices:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow nmcli device status
# nmcli device status DEVICE TYPE STATE CONNECTION enp1s0 ethernet unmanaged -- ...
The
unmanaged
state next to theenp1s0
device indicates that NetworkManager does not manage this device.
Troubleshooting
If the output of the
nmcli device status
command does not list the device asunmanaged
, display the NetworkManager configuration:Copy to Clipboard Copied! Toggle word wrap Toggle overflow NetworkManager --print-config
# NetworkManager --print-config ... [device-enp1s0-unmanaged] match-device=interface-name:enp1s0 managed=0 ...
If the output does not match the settings that you configured, ensure that no configuration file with a higher priority overrides your settings. For details on how NetworkManager merges multiple configuration files, see the
NetworkManager.conf(5)
man page on your system.
14.2. Temporarily configuring a device as unmanaged in NetworkManager
You can temporarily configure devices as unmanaged
, for example, for testing purposes. This change persists a reload and restart of the NetworkManager systemd service, but not a system reboot.
Procedure
Optional: Display the list of devices to identify the device you want to set as
unmanaged
:Copy to Clipboard Copied! Toggle word wrap Toggle overflow nmcli device status
# nmcli device status DEVICE TYPE STATE CONNECTION enp1s0 ethernet disconnected -- ...
Set the
enp1s0
device to theunmanaged
state:Copy to Clipboard Copied! Toggle word wrap Toggle overflow nmcli device set enp1s0 managed no
# nmcli device set enp1s0 managed no
Verification
Display the list of devices:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow nmcli device status
# nmcli device status DEVICE TYPE STATE CONNECTION enp1s0 ethernet unmanaged -- ...
The
unmanaged
state next to theenp1s0
device indicates that NetworkManager does not manage this device.
Additional resources
-
NetworkManager.conf(5)
man page on your system