anaconda/anaconda-40.22.3.13/pyanaconda/modules/network/device_configuration.py

525 lines
21 KiB
Python
Raw Normal View History

2024-11-14 21:39:56 -08:00
#
# Persistent device configuration state for network module
#
# Copyright (C) 2019 Red Hat, Inc.
#
# This copyrighted material is made available to anyone wishing to use,
# modify, copy, or redistribute it subject to the terms and conditions of
# the GNU General Public License v.2, or (at your option) any later version.
# This program is distributed in the hope that it will be useful, but WITHOUT
# ANY WARRANTY expressed or implied, including the implied warranties of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
# Public License for more details. You should have received a copy of the
# GNU General Public License along with this program; if not, write to the
# Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
# 02110-1301, USA. Any Red Hat trademarks that are incorporated in the
# source code or documentation are not subject to the GNU General Public
# License and may only be used or replicated with the express permission of
# Red Hat, Inc.
#
import copy
from pyanaconda.core.signal import Signal
from pyanaconda.modules.network.nm_client import get_iface_from_connection, \
get_vlan_interface_name_from_connection, get_config_file_connection_of_device, \
is_bootif_connection
from pyanaconda.modules.common.structures.network import NetworkDeviceConfiguration
from pyanaconda.modules.network.constants import NM_CONNECTION_TYPE_WIFI, \
NM_CONNECTION_TYPE_ETHERNET, NM_CONNECTION_TYPE_VLAN, NM_CONNECTION_TYPE_BOND, \
NM_CONNECTION_TYPE_TEAM, NM_CONNECTION_TYPE_BRIDGE, NM_CONNECTION_TYPE_INFINIBAND
from pyanaconda.modules.network.utils import is_ibft_configured_device, is_nbft_device
import gi
gi.require_version("NM", "1.0")
from gi.repository import NM
from pyanaconda.anaconda_loggers import get_module_logger
log = get_module_logger(__name__)
supported_device_types = [
NM.DeviceType.ETHERNET,
NM.DeviceType.WIFI,
NM.DeviceType.INFINIBAND,
NM.DeviceType.BOND,
NM.DeviceType.VLAN,
NM.DeviceType.BRIDGE,
NM.DeviceType.TEAM,
]
supported_wired_device_types = [
NM.DeviceType.ETHERNET,
NM.DeviceType.INFINIBAND,
]
virtual_device_types = [
NM.DeviceType.BOND,
NM.DeviceType.VLAN,
NM.DeviceType.BRIDGE,
NM.DeviceType.TEAM,
]
class DeviceConfigurations(object):
"""Stores the state of persistent configuration of network devices.
Contains only configuration of devices supported by Anaconda.
Configurations are hold in NetworkDeviceConfiguration objects.
For a physical device there is only single NetworkDeviceConfiguration
object bound to the device name (the mandatory persistent element of
the object). The uuid corresponds to the configuration of the device
for installed system.
For a virtual device there can be multiple NetworkDeviceConfiguration
objects, bound to uuid of the device configuration (the mandatory
persistent element of the object). The device name is set in the
object only if there exists respective active device with the
configuration given by uuid applied.
Configurations correspond to NetworkManager persistent connections by
their uuid.
signals:
configurations_changed - Provides list of changes - tuples containing
NetworkDeviceConfiguration objects with old and new
values.
"""
# Maps types of connections to types of devices (both provided by NM)
setting_types = {
NM_CONNECTION_TYPE_WIFI: NM.DeviceType.WIFI,
NM_CONNECTION_TYPE_ETHERNET: NM.DeviceType.ETHERNET,
NM_CONNECTION_TYPE_VLAN: NM.DeviceType.VLAN,
NM_CONNECTION_TYPE_BOND: NM.DeviceType.BOND,
NM_CONNECTION_TYPE_TEAM: NM.DeviceType.TEAM,
NM_CONNECTION_TYPE_BRIDGE: NM.DeviceType.BRIDGE,
NM_CONNECTION_TYPE_INFINIBAND: NM.DeviceType.INFINIBAND,
}
def __init__(self, nm_client=None):
self._device_configurations = None
self.nm_client = nm_client or NM.Client.new()
self.configurations_changed = Signal()
def reload(self):
"""Reload the state from the system."""
self._device_configurations = []
for device in self.nm_client.get_devices():
self.add_device(device)
for connection in self.nm_client.get_connections():
self.add_connection(connection)
def connect(self):
"""Connect to NetworkManager for devices and connections updates."""
self.nm_client.connect("device-added", self._device_added_cb)
self.nm_client.connect("device-removed", self._device_removed_cb)
self.nm_client.connect("connection-added", self._connection_added_cb)
self.nm_client.connect("connection-removed", self._connection_removed_cb)
self.nm_client.connect("active-connection-added", self._active_connection_added_cb)
def disconnect(self):
"""Disconnect from NetworkManager devices and connections updates."""
for cb in [self._device_added_cb,
self._device_removed_cb,
self._connection_added_cb,
self._connection_removed_cb,
self._active_connection_added_cb]:
try:
self.nm_client.disconnect_by_func(cb)
except TypeError as e:
if "nothing connected" not in str(e):
log.debug("%s", e)
def add(self, device_name=None, connection_uuid=None, device_type=None):
"""Add a new NetworkDeviceConfiguration."""
new_dev_cfg = NetworkDeviceConfiguration()
if device_name is not None:
new_dev_cfg.device_name = device_name
if connection_uuid is not None:
new_dev_cfg.connection_uuid = connection_uuid
if device_type is not None:
new_dev_cfg.device_type = device_type
self._device_configurations.append(new_dev_cfg)
log.debug("added %s", new_dev_cfg)
self.configurations_changed.emit([(NetworkDeviceConfiguration(), new_dev_cfg)])
def attach(self, dev_cfg, device_name=None, connection_uuid=None):
"""Attach device or connection to existing NetworkDeviceConfiguration."""
if not device_name and not connection_uuid:
return
old_dev_cfg = copy.deepcopy(dev_cfg)
if device_name:
dev_cfg.device_name = device_name
log.debug("attached device name to %s", dev_cfg)
if connection_uuid:
dev_cfg.connection_uuid = connection_uuid
log.debug("attached connection uuid to %s", dev_cfg)
self.configurations_changed.emit([(old_dev_cfg, dev_cfg)])
def _should_add_device(self, device):
"""Should the network device be added ?
:param device: NetworkManager device object
:type device: NMDevice
:returns: tuple containing reply and message with reason
:rtype: (bool, str)
"""
decline_reason = ""
# Ignore unsupported device types
if device.get_device_type() not in supported_device_types:
decline_reason = "unsupported type"
# Ignore libvirt bridges
elif is_libvirt_device(device.get_iface()):
decline_reason = "libvirt special device"
# Ignore fcoe vlan devices (can be chopped off to IFNAMSIZ kernel limit)
elif device.get_iface().endswith(('-fcoe', '-fco', '-fc', '-f', '-')):
decline_reason = "special FCoE vlan device"
# Ignore devices configured via iBFT, ie
# devices with active read-only connections (created by NM for iBFT VLAN)
elif self._has_read_only_active_connection(device):
decline_reason = "has active read-only connection (assuming configuration via iBFT)"
reply = not decline_reason
return reply, decline_reason
def _has_read_only_active_connection(self, device):
"""Does the device have read-only active connection ?
:param device: NetworkManager device object
:type device: NMDevice
"""
ac = device.get_active_connection()
if ac:
rc = ac.get_connection()
# Getting of NMRemoteConnection can fail (None), isn't it a bug in NM?
if rc:
con_setting = rc.get_setting_connection()
if con_setting and con_setting.get_read_only():
return True
else:
log.debug("can't get remote connection of active connection "
"of device %s", device.get_iface())
return False
def _find_connection_uuid_of_device(self, device):
"""Find uuid of connection that should be bound to the device.
Assumes existence of no more than one config file per non-port physical
device.
:param device: NetworkManager device object
:type device: NMDevice
:returns: uuid of NetworkManager connection
:rtype: str
"""
uuid = None
iface = device.get_iface()
# For virtual device only the active connection could be the connection
if device.get_device_type() in virtual_device_types:
ac = device.get_active_connection()
if ac:
uuid = ac.get_connection().get_uuid()
else:
log.debug("no active connection for virtual device %s", iface)
# For physical device we need to pick the right connection in some
# cases.
else:
cons = [c for c in device.get_available_connections() if not is_bootif_connection(c)]
config_uuid = None
if not cons:
log.debug("no available connection for physical device %s", iface)
elif len(cons) > 1:
# This can happen when activating device in initramfs and
# reconfiguring it via kickstart without activation.
log.debug("physical device %s has multiple connections: %s",
iface, [c.get_uuid() for c in cons])
hwaddr = device.get_hw_address()
config_uuid = get_config_file_connection_of_device(
self.nm_client, iface, device_hwaddr=hwaddr)
log.debug("config file connection for %s: %s", iface, config_uuid)
for c in cons:
# Ignore port connections
if c.get_setting_connection() and c.get_setting_connection().get_slave_type():
continue
candidate_uuid = c.get_uuid()
# In case of multiple connections choose the config connection
if not config_uuid or candidate_uuid == config_uuid:
uuid = candidate_uuid
return uuid
def add_device(self, device):
"""Add or update configuration for libnm network device object.
Filters out unsupported or special devices.
For virtual devices it may only attach the device name to existing
configuration with connection uuid (typically when the virtual device
is activated).
:param device: NetworkManager device object
:type device: NMDevice
:return: True if any configuration was added or modified, False otherwise
:rtype: bool
"""
iface = device.get_iface()
# Only single configuration per existing device
existing_cfgs = self.get_for_device(iface)
if existing_cfgs:
log.debug("add_device: not adding %s: already there: %s", iface, existing_cfgs)
return False
# Filter out special or unsupported devices
should_add, reason = self._should_add_device(device)
if not should_add:
log.debug("add_device: not adding %s: %s", iface, reason)
return False
log.debug("add device: adding device %s", iface)
# Handle wireless device
# TODO needs testing
if device.get_device_type() == NM.DeviceType.WIFI:
self.add(device_name=iface, device_type=NM.DeviceType.WIFI)
return True
existing_connection_uuid = self._find_connection_uuid_of_device(device)
existing_cfgs_for_uuid = self.get_for_uuid(existing_connection_uuid)
if existing_connection_uuid and existing_cfgs_for_uuid:
existing_cfg = existing_cfgs_for_uuid[0]
self.attach(existing_cfg, device_name=iface)
else:
self.add(device_name=iface, connection_uuid=existing_connection_uuid,
device_type=device.get_device_type())
return True
def _should_add_connection(self, connection):
"""Should the connection be added ?
:param connection: NetworkManager connection object
:type connection: NMConnection
:returns: tuple containing reply and message with reason
:rtype: (bool, str)
"""
decline_reason = ""
uuid = connection.get_uuid()
iface = get_iface_from_connection(self.nm_client, uuid)
connection_type = connection.get_connection_type()
device_type = self.setting_types.get(connection_type, None)
con_setting = connection.get_setting_connection()
# Ignore read-only connections
if con_setting and con_setting.get_read_only():
decline_reason = "read-only connection"
# Ignore libvirt devices
elif is_libvirt_device(iface or ""):
decline_reason = "libvirt special device connection"
# TODO we might want to remove the check if the devices are not renamed
# to ibftX in dracut (BZ #1749331)
# Ignore devices configured via iBFT
elif is_ibft_configured_device(iface or ""):
decline_reason = "configured from iBFT"
elif is_nbft_device(iface or ""):
decline_reason = "nBFT device"
# Ignore unsupported device types
elif device_type not in supported_device_types:
decline_reason = "unsupported type"
# BOOTIF connection created in initramfs
elif is_bootif_connection(connection):
decline_reason = "BOOTIF connection from initramfs"
# Ignore port connections
elif device_type == NM.DeviceType.ETHERNET:
if con_setting and con_setting.get_master():
decline_reason = "port connection"
# Wireless settings are handled in scope of configuration of its device
elif device_type == NM.DeviceType.WIFI:
decline_reason = "wireless connection"
reply = not decline_reason
return reply, decline_reason
def _find_existing_cfg_for_iface(self, iface):
cfgs = self.get_for_device(iface)
if cfgs:
if len(cfgs) > 1:
log.error("multiple configurations for device %s: %s", iface, cfgs)
return cfgs[0]
return None
def add_connection(self, connection):
"""Add or update configuration for libnm connection object.
Filters out unsupported or special devices.
Only single configuration for given uuid is allowed. For devices
without persistent connection it will just update the configuration.
:param connection: NetworkManager conenction object
:type connection: NMConnection
:return: True if any configuration was added or modified, False otherwise
:rtype: bool
"""
uuid = connection.get_uuid()
existing_cfg = self.get_for_uuid(uuid)
if existing_cfg:
log.debug("add_connection: not adding %s: already existing: %s", uuid, existing_cfg)
return False
# Filter out special or unsupported devices
should_add, reason = self._should_add_connection(connection)
if not should_add:
log.debug("add_connection: not adding %s: %s", uuid, reason)
return False
connection_type = connection.get_connection_type()
device_type = self.setting_types.get(connection_type, None)
iface = get_iface_from_connection(self.nm_client, uuid)
# Require interface name for physical devices
if device_type in supported_wired_device_types and not iface:
log.debug("add_connection: not adding %s: interface name is required for type %s",
uuid, device_type)
return False
# Handle also vlan connections without interface-name specified
if device_type == NM.DeviceType.VLAN:
if not iface:
iface = get_vlan_interface_name_from_connection(self.nm_client, connection)
log.debug("add_connection: interface name for vlan connection %s inferred: %s",
uuid, iface)
iface_cfg = self._find_existing_cfg_for_iface(iface)
log.debug("add_connection: adding connection %s", uuid)
# virtual devices
if device_type in virtual_device_types:
if iface_cfg:
if not iface_cfg.connection_uuid:
self.attach(iface_cfg, connection_uuid=uuid)
return True
else:
# TODO check that the device shouldn't be reattached?
log.debug("add_connection: already have %s for device %s, adding another one",
iface_cfg.connection_uuid, iface_cfg.device_name)
self.add(connection_uuid=uuid, device_type=device_type)
# physical devices
else:
if iface_cfg:
if iface_cfg.connection_uuid:
log.debug("add_connection: already have %s for device %s, not adding %s",
iface_cfg.connection_uuid, iface_cfg.device_name, uuid)
return False
else:
self.attach(iface_cfg, connection_uuid=uuid)
else:
self.add(connection_uuid=uuid, device_type=device_type)
return True
def get_for_device(self, device_name):
return [cfg for cfg in self._device_configurations
if cfg.device_name == device_name]
def get_for_uuid(self, connection_uuid):
return [cfg for cfg in self._device_configurations
if cfg.connection_uuid == connection_uuid]
def get_all(self):
return list(self._device_configurations)
def _device_added_cb(self, client, device, *args):
# We need to wait for valid state before adding the device
log.debug("NM device added: %s", device.get_iface())
if device.get_state() == NM.DeviceState.UNKNOWN:
device.connect("state-changed", self._added_device_state_changed_cb)
else:
self.add_device(device)
def _added_device_state_changed_cb(self, device, new_state, *args):
# We need to wait for valid state before adding the device
if new_state != NM.DeviceState.UNKNOWN:
device.disconnect_by_func(self._added_device_state_changed_cb)
self.add_device(device)
def _device_removed_cb(self, client, device, *args):
# We just remove the device from the NetworkDeviceConfiguration, keeping the object
# assuming it is just a disconnected virtual device.
iface = device.get_iface()
log.debug("NM device removed: %s", iface)
dev_cfgs = self.get_for_device(iface)
for cfg in dev_cfgs:
if cfg.connection_uuid and cfg.device_type in virtual_device_types:
old_cfg = copy.deepcopy(cfg)
cfg.device_name = ""
self.configurations_changed.emit([(old_cfg, cfg)])
log.debug("device name %s removed from %s", iface, cfg)
else:
empty_cfg = NetworkDeviceConfiguration()
self._device_configurations.remove(cfg)
self.configurations_changed.emit([(cfg, empty_cfg)])
log.debug("%s removed", cfg)
def _connection_added_cb(self, client, connection):
log.debug("NM connection added: %s", connection.get_uuid())
self.add_connection(connection)
def _active_connection_added_cb(self, client, connection):
connection_uuid = connection.get_uuid()
log.debug("NM active connection added: %s", connection_uuid)
dev_cfgs = self.get_for_uuid(connection_uuid)
for cfg in dev_cfgs:
if not cfg.device_name:
devices = connection.get_devices()
if devices:
log.debug("adding active connection %s", connection_uuid)
self.attach(cfg, device_name=devices[0].get_iface())
def _connection_removed_cb(self, client, connection):
uuid = connection.get_uuid()
log.debug("NM connection removed: %s", uuid)
# Remove the configuration if it does not have a device_name
# which means it is a virtual device configurtation
dev_cfgs = self.get_for_uuid(uuid)
for cfg in dev_cfgs:
if cfg.device_name:
old_cfg = copy.deepcopy(cfg)
cfg.connection_uuid = ""
self.configurations_changed.emit([(old_cfg, cfg)])
log.debug("connection uuid %s removed from %s", uuid, cfg)
else:
empty_cfg = NetworkDeviceConfiguration()
self._device_configurations.remove(cfg)
self.configurations_changed.emit([(cfg, empty_cfg)])
log.debug("%s removed", cfg)
def __str__(self):
return str(self._device_configurations)
def __repr__(self):
return "DeviceConfigurations({})".format(self.nm_client)
def is_libvirt_device(iface):
return iface.startswith("virbr")