File manager - Edit - /var/www/payraty/helpdesk/public/storage/branding_media/images/netplan.zip
Back
PK ! �u� � 50-cloud-init.yamlnu �[��� # This file is generated from information provided by the datasource. Changes # to it will not persist across an instance reboot. To disable cloud-init's # network configuration capabilities, write a file # /etc/cloud/cloud.cfg.d/99-disable-network-config.cfg with the following: # network: {config: disabled} network: ethernets: eth0: dhcp4: true dhcp6: false match: macaddress: 06:3b:6d:c0:fb:8f set-name: eth0 version: 2 PK ! � G�� � netplan/configmanager.pynu �[��� #!/usr/bin/python3 # # Copyright (C) 2018 Canonical, Ltd. # Author: Mathieu Trudel-Lapierre <mathieu.trudel-lapierre@canonical.com> # # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation; version 3. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty 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, see <http://www.gnu.org/licenses/>. '''netplan configuration manager''' import logging import os import shutil import sys import tempfile from typing import Optional from netplan import libnetplan class ConfigManager(object): def __init__(self, prefix="/", extra_files={}): self.prefix = prefix self.tempdir = tempfile.mkdtemp(prefix='netplan_') self.temp_etc = os.path.join(self.tempdir, "etc") self.temp_run = os.path.join(self.tempdir, "run") self.extra_files = extra_files self.new_interfaces = set() self.np_state: Optional[libnetplan.State] = None def __getattr__(self, attr): assert self.np_state is not None, "Must call parse() before accessing the config." return getattr(self.np_state, attr) @property def physical_interfaces(self): assert self.np_state is not None, "Must call parse() before accessing the config." interfaces = {} interfaces.update(self.np_state.ethernets) interfaces.update(self.np_state.modems) interfaces.update(self.np_state.wifis) return interfaces @property def virtual_interfaces(self): assert self.np_state is not None, "Must call parse() before accessing the config." interfaces = {} # what about ovs_ports? interfaces.update(self.np_state.bridges) interfaces.update(self.np_state.bonds) interfaces.update(self.np_state.tunnels) interfaces.update(self.np_state.vlans) interfaces.update(self.np_state.vrfs) return interfaces def parse(self, extra_config=None): """ Parse all our config files to return an object that describes the system's entire configuration, so that it can later be interrogated. Returns a libnetplan State wrapper """ # /run/netplan shadows /etc/netplan/, which shadows /lib/netplan parser = libnetplan.Parser() try: parser.load_yaml_hierarchy(rootdir=self.prefix) if extra_config: for f in extra_config: parser.load_yaml(f) self.np_state = libnetplan.State() self.np_state.import_parser_results(parser) except libnetplan.LibNetplanException as e: raise ConfigurationError(*e.args) self.np_state.dump_to_logs() return self.np_state def add(self, config_dict): for config_file in config_dict: self._copy_file(config_file, config_dict[config_file]) self.extra_files.update(config_dict) # Invalidate the current parsed state self.np_state = None def backup(self, backup_config_dir=True): if backup_config_dir: self._copy_tree(os.path.join(self.prefix, "etc/netplan"), os.path.join(self.temp_etc, "netplan")) self._copy_tree(os.path.join(self.prefix, "run/NetworkManager/system-connections"), os.path.join(self.temp_run, "NetworkManager", "system-connections"), missing_ok=True) self._copy_tree(os.path.join(self.prefix, "run/systemd/network"), os.path.join(self.temp_run, "systemd", "network"), missing_ok=True) def revert(self): try: for extra_file in dict(self.extra_files): os.unlink(self.extra_files[extra_file]) del self.extra_files[extra_file] temp_nm_path = "{}/NetworkManager/system-connections".format(self.temp_run) temp_networkd_path = "{}/systemd/network".format(self.temp_run) if os.path.exists(temp_nm_path): shutil.rmtree(os.path.join(self.prefix, "run/NetworkManager/system-connections")) self._copy_tree(temp_nm_path, os.path.join(self.prefix, "run/NetworkManager/system-connections")) if os.path.exists(temp_networkd_path): shutil.rmtree(os.path.join(self.prefix, "run/systemd/network")) self._copy_tree(temp_networkd_path, os.path.join(self.prefix, "run/systemd/network")) except Exception as e: # pragma: nocover (only relevant to filesystem failures) # If we reach here, we're in big trouble. We may have wiped out # file NM or networkd are using, and we most likely removed the # "new" config -- or at least our copy of it. # Given that we're in some halfway done revert; warn the user # aggressively and drop everything; leaving any remaining backups # around for the user to handle themselves. logging.error("Something really bad happened while reverting config: {}".format(e)) logging.error("You should verify the netplan YAML in /etc/netplan and probably run 'netplan apply' again.") sys.exit(-1) def cleanup(self): shutil.rmtree(self.tempdir) def __del__(self): try: self.cleanup() except FileNotFoundError: # If cleanup() was called before, there is nothing to delete pass def _copy_file(self, src, dst): shutil.copy(src, dst) def _copy_tree(self, src, dst, missing_ok=False): try: shutil.copytree(src, dst) except FileNotFoundError: if missing_ok: pass else: raise class ConfigurationError(Exception): """ Configuration could not be parsed or has otherwise failed to apply """ pass PK ! ���� � netplan/terminal.pynu �[��� #!/usr/bin/python3 # # Copyright (C) 2018 Canonical, Ltd. # Author: Mathieu Trudel-Lapierre <mathieu.trudel-lapierre@canonical.com> # # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation; version 3. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty 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, see <http://www.gnu.org/licenses/>. """ Terminal / input handling """ import fcntl import os import termios import select import sys class Terminal(object): """ Do minimal terminal mangling to prompt users for input """ def __init__(self, fd): self.fd = fd self.orig_flags = None self.orig_term = None self.save() def enable_echo(self): if sys.stdin.isatty(): attrs = termios.tcgetattr(self.fd) attrs[3] = attrs[3] | termios.ICANON attrs[3] = attrs[3] | termios.ECHO termios.tcsetattr(self.fd, termios.TCSANOW, attrs) def disable_echo(self): if sys.stdin.isatty(): attrs = termios.tcgetattr(self.fd) attrs[3] = attrs[3] & ~termios.ICANON attrs[3] = attrs[3] & ~termios.ECHO termios.tcsetattr(self.fd, termios.TCSANOW, attrs) def enable_nonblocking_io(self): flags = fcntl.fcntl(self.fd, fcntl.F_GETFL) fcntl.fcntl(self.fd, fcntl.F_SETFL, flags | os.O_NONBLOCK) def disable_nonblocking_io(self): flags = fcntl.fcntl(self.fd, fcntl.F_GETFL) fcntl.fcntl(self.fd, fcntl.F_SETFL, flags & ~os.O_NONBLOCK) def get_confirmation_input(self, timeout=120, message=None): # pragma: nocover (requires user input) """ Get a "confirmation" input from the user, for at most (timeout) seconds. Optionally, customize the message to be displayed. timeout -- timeout to wait for input (default 120) message -- optional customized message ("Press ENTER to (message)") raises: InputAccepted -- the user confirmed the changes InputRejected -- the user rejected the changes """ print("Do you want to keep these settings?\n\n") settings = dict() self.save(settings) self.disable_echo() self.enable_nonblocking_io() if not message: message = "accept the new configuration" print("Press ENTER before the timeout to {}\n\n".format(message)) timeout_now = timeout while (timeout_now > 0): print("Changes will revert in {:>{}} seconds".format(timeout_now, len(str(timeout))), end='\r') # wait at most 1 second for usable input from stdin select.select([sys.stdin], [], [], 1) try: # retrieve any input from the terminal. select() either has # timed out with no input, or found something we can retrieve. c = sys.stdin.read() if (c == '\n'): self.reset(settings) # Yay, user has accepted the changes! raise InputAccepted() except TypeError: # read() above is non-blocking, if there is nothing to read it # will return TypeError, which we should ignore -- on to the # next iteration until timeout. pass timeout_now -= 1 # We reached the timeout for our loop, now revert our change for # non-blocking I/O and signal the caller the changes were essentially # rejected. self.reset(settings) raise InputRejected() def save(self, dest=None): """ Save the terminal's current attributes and flags Optional argument: - dest: if set, save settings to this dict """ orig_flags = fcntl.fcntl(self.fd, fcntl.F_GETFL) orig_term = None if sys.stdin.isatty(): orig_term = termios.tcgetattr(self.fd) if dest is not None: dest.update({'flags': orig_flags, 'term': orig_term}) else: self.orig_flags = orig_flags self.orig_term = orig_term def reset(self, orig=None): """ Reset the terminal to its original attributes and flags Optional argument: - orig: if set, reset to settings from this dict """ orig_term = None orig_flags = None if orig is not None: orig_term = orig.get('term') orig_flags = orig.get('flags') else: orig_term = self.orig_term orig_flags = self.orig_flags if sys.stdin.isatty(): termios.tcsetattr(self.fd, termios.TCSAFLUSH, orig_term) fcntl.fcntl(self.fd, fcntl.F_SETFL, orig_flags) class InputAccepted(Exception): """ Denotes has accepted input""" pass class InputRejected(Exception): """ Denotes that the user has rejected input""" pass PK ! ��PH PH netplan/libnetplan.pynu �[��� # Copyright (C) 2018-2020 Canonical, Ltd. # Author: Mathieu Trudel-Lapierre <mathieu.trudel-lapierre@canonical.com> # Author: Łukasz 'sil2100' Zemczak <lukasz.zemczak@canonical.com> # Author: Lukas 'slyon' Märdian <lukas.maerdian@canonical.com> # Author: Simon Chopin <simon.chopin@canonical.com> # # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation; version 3. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty 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, see <http://www.gnu.org/licenses/>. import tempfile import logging import ctypes import ctypes.util from ctypes import c_char_p, c_void_p, c_int, c_uint, c_size_t, c_ssize_t from typing import List, Union, IO class LibNetplanException(Exception): pass class _GError(ctypes.Structure): _fields_ = [("domain", ctypes.c_uint32), ("code", c_int), ("message", c_char_p)] class _netplan_state(ctypes.Structure): pass class _netplan_parser(ctypes.Structure): pass class _netplan_net_definition(ctypes.Structure): pass lib = ctypes.CDLL(ctypes.util.find_library('netplan')) _GErrorPP = ctypes.POINTER(ctypes.POINTER(_GError)) _NetplanParserP = ctypes.POINTER(_netplan_parser) _NetplanStateP = ctypes.POINTER(_netplan_state) _NetplanNetDefinitionP = ctypes.POINTER(_netplan_net_definition) lib.netplan_get_id_from_nm_filename.restype = ctypes.c_char_p def _string_realloc_call_no_error(function): size = 16 while size < 1048576: # 1MB buffer = ctypes.create_string_buffer(size) code = function(buffer) if code == -2: size = size * 2 continue if code < 0: # pragma: nocover raise LibNetplanException("Unknown error: %d" % code) elif code == 0: return None # pragma: nocover as it's hard to trigger for now else: return buffer.value.decode('utf-8') raise LibNetplanException('Halting due to string buffer size > 1M') # pragma: nocover def _checked_lib_call(fn, *args): err = ctypes.POINTER(_GError)() ret = bool(fn(*args, ctypes.byref(err))) if not ret: raise LibNetplanException(err.contents.message.decode('utf-8')) class Parser: _abi_loaded = False @classmethod def _load_abi(cls): if cls._abi_loaded: return lib.netplan_parser_new.restype = _NetplanParserP lib.netplan_parser_clear.argtypes = [ctypes.POINTER(_NetplanParserP)] lib.netplan_parser_load_yaml.argtypes = [_NetplanParserP, c_char_p, _GErrorPP] lib.netplan_parser_load_yaml.restype = c_int lib.netplan_parser_load_yaml_from_fd.argtypes = [_NetplanParserP, c_int, _GErrorPP] lib.netplan_parser_load_yaml_from_fd.restype = c_int lib.netplan_parser_load_nullable_fields.argtypes = [_NetplanParserP, c_int, _GErrorPP] lib.netplan_parser_load_nullable_fields.restype = c_int lib.netplan_parser_load_nullable_overrides.argtypes =\ [_NetplanParserP, c_int, c_char_p, _GErrorPP] lib.netplan_parser_load_nullable_overrides.restype = c_int cls._abi_loaded = True def __init__(self): self._load_abi() self._ptr = lib.netplan_parser_new() def __del__(self): lib.netplan_parser_clear(ctypes.byref(self._ptr)) def load_yaml(self, input_file: Union[str, IO]): if isinstance(input_file, str): _checked_lib_call(lib.netplan_parser_load_yaml, self._ptr, input_file.encode('utf-8')) else: _checked_lib_call(lib.netplan_parser_load_yaml_from_fd, self._ptr, input_file.fileno()) def load_yaml_hierarchy(self, rootdir): _checked_lib_call(lib.netplan_parser_load_yaml_hierarchy, self._ptr, rootdir.encode('utf-8')) def load_nullable_fields(self, input_file: IO): _checked_lib_call(lib.netplan_parser_load_nullable_fields, self._ptr, input_file.fileno()) def load_nullable_overrides(self, input_file: IO, constraint: str): _checked_lib_call(lib.netplan_parser_load_nullable_overrides, self._ptr, input_file.fileno(), constraint.encode('utf-8')) class State: _abi_loaded = False @classmethod def _load_abi(cls): if cls._abi_loaded: return lib.netplan_state_new.restype = _NetplanStateP lib.netplan_state_clear.argtypes = [ctypes.POINTER(_NetplanStateP)] lib.netplan_state_import_parser_results.argtypes = [_NetplanStateP, _NetplanParserP, _GErrorPP] lib.netplan_state_import_parser_results.restype = c_int lib.netplan_state_get_netdefs_size.argtypes = [_NetplanStateP] lib.netplan_state_get_netdefs_size.restype = c_int lib.netplan_state_get_netdef.argtypes = [_NetplanStateP, c_char_p] lib.netplan_state_get_netdef.restype = _NetplanNetDefinitionP lib.netplan_state_write_yaml_file.argtypes = [_NetplanStateP, c_char_p, c_char_p, _GErrorPP] lib.netplan_state_write_yaml_file.restype = c_int lib.netplan_state_update_yaml_hierarchy.argtypes = [_NetplanStateP, c_char_p, c_char_p, _GErrorPP] lib.netplan_state_update_yaml_hierarchy.restype = c_int lib.netplan_state_dump_yaml.argtypes = [_NetplanStateP, c_int, _GErrorPP] lib.netplan_state_dump_yaml.restype = c_int lib.netplan_netdef_get_embedded_switch_mode.argtypes = [_NetplanNetDefinitionP] lib.netplan_netdef_get_embedded_switch_mode.restype = c_char_p lib.netplan_netdef_get_delay_virtual_functions_rebind.argtypes = [_NetplanNetDefinitionP] lib.netplan_netdef_get_delay_virtual_functions_rebind.restype = c_int lib.netplan_state_get_backend.argtypes = [_NetplanStateP] lib.netplan_state_get_backend.restype = c_int cls._abi_loaded = True def __init__(self): self._load_abi() self._ptr = lib.netplan_state_new() def __del__(self): lib.netplan_state_clear(ctypes.byref(self._ptr)) def import_parser_results(self, parser): _checked_lib_call(lib.netplan_state_import_parser_results, self._ptr, parser._ptr) def write_yaml_file(self, filename, rootdir): name = filename.encode('utf-8') if filename else None root = rootdir.encode('utf-8') if rootdir else None _checked_lib_call(lib.netplan_state_write_yaml_file, self._ptr, name, root) def update_yaml_hierarchy(self, default_filename, rootdir): name = default_filename.encode('utf-8') root = rootdir.encode('utf-8') if rootdir else None _checked_lib_call(lib.netplan_state_update_yaml_hierarchy, self._ptr, name, root) def dump_yaml(self, output_file): fd = output_file.fileno() _checked_lib_call(lib.netplan_state_dump_yaml, self._ptr, fd) def __len__(self): return lib.netplan_state_get_netdefs_size(self._ptr) def __getitem__(self, def_id): ptr = lib.netplan_state_get_netdef(self._ptr, def_id.encode('utf-8')) if not ptr: raise IndexError() return NetDefinition(self, ptr) @property def all_defs(self): return dict((nd.id, nd) for nd in _NetdefIterator(self, None)) @property def ethernets(self): return dict((nd.id, nd) for nd in _NetdefIterator(self, "ethernets")) @property def modems(self): return dict((nd.id, nd) for nd in _NetdefIterator(self, "modems")) @property def wifis(self): return dict((nd.id, nd) for nd in _NetdefIterator(self, "wifis")) @property def vlans(self): return dict((nd.id, nd) for nd in _NetdefIterator(self, "vlans")) @property def bridges(self): return dict((nd.id, nd) for nd in _NetdefIterator(self, "bridges")) @property def bonds(self): return dict((nd.id, nd) for nd in _NetdefIterator(self, "bonds")) @property def tunnels(self): return dict((nd.id, nd) for nd in _NetdefIterator(self, "tunnels")) @property def vrfs(self): return dict((nd.id, nd) for nd in _NetdefIterator(self, "vrfs")) @property def ovs_ports(self): return dict((nd.id, nd) for nd in _NetdefIterator(self, "_ovs-ports")) @property def nm_devices(self): return dict((nd.id, nd) for nd in _NetdefIterator(self, "nm-devices")) @property def backend(self): return lib.netplan_backend_name(lib.netplan_state_get_backend(self._ptr)).decode('utf-8') def dump_to_logs(self): # Convoluted way to dump the parsed config to the logs... with tempfile.TemporaryFile() as tmp: self.dump_yaml(output_file=tmp) logging.debug("Merged config:\n{}".format(tmp.read())) class NetDefinition: _abi_loaded = False @classmethod def _load_abi(cls): if cls._abi_loaded: return lib.netplan_netdef_has_match.argtypes = [_NetplanNetDefinitionP] lib.netplan_netdef_has_match.restype = c_int lib.netplan_netdef_get_id.argtypes = [_NetplanNetDefinitionP, c_char_p, c_size_t] lib.netplan_netdef_get_id.restype = c_ssize_t lib.netplan_netdef_get_filepath.argtypes = [_NetplanNetDefinitionP, c_char_p, c_size_t] lib.netplan_netdef_get_filepath.restype = c_ssize_t lib.netplan_netdef_get_backend.argtypes = [_NetplanNetDefinitionP] lib.netplan_netdef_get_backend.restype = c_int lib.netplan_netdef_get_type.argtypes = [_NetplanNetDefinitionP] lib.netplan_netdef_get_type.restype = c_int lib.netplan_netdef_get_set_name.argtypes = [_NetplanNetDefinitionP, c_char_p, c_size_t] lib.netplan_netdef_get_set_name.restype = c_ssize_t lib._netplan_netdef_get_critical.argtypes = [_NetplanNetDefinitionP] lib._netplan_netdef_get_critical.restype = c_int lib.netplan_netdef_get_sriov_link.argtypes = [_NetplanNetDefinitionP] lib.netplan_netdef_get_sriov_link.restype = _NetplanNetDefinitionP lib.netplan_netdef_get_vlan_link.argtypes = [_NetplanNetDefinitionP] lib.netplan_netdef_get_vlan_link.restype = _NetplanNetDefinitionP lib.netplan_netdef_get_bridge_link.argtypes = [_NetplanNetDefinitionP] lib.netplan_netdef_get_bridge_link.restype = _NetplanNetDefinitionP lib.netplan_netdef_get_bond_link.argtypes = [_NetplanNetDefinitionP] lib.netplan_netdef_get_bond_link.restype = _NetplanNetDefinitionP lib.netplan_netdef_get_peer_link.argtypes = [_NetplanNetDefinitionP] lib.netplan_netdef_get_peer_link.restype = _NetplanNetDefinitionP lib._netplan_netdef_get_vlan_id.argtypes = [_NetplanNetDefinitionP] lib._netplan_netdef_get_vlan_id.restype = c_uint lib._netplan_netdef_get_sriov_vlan_filter.argtypes = [_NetplanNetDefinitionP] lib._netplan_netdef_get_sriov_vlan_filter.restype = c_int lib.netplan_netdef_match_interface.argtypes = [_NetplanNetDefinitionP] lib.netplan_netdef_match_interface.restype = c_int lib.netplan_backend_name.argtypes = [c_int] lib.netplan_backend_name.restype = c_char_p lib.netplan_def_type_name.argtypes = [c_int] lib.netplan_def_type_name.restype = c_char_p lib._netplan_state_get_vf_count_for_def.argtypes = [_NetplanStateP, _NetplanNetDefinitionP, _GErrorPP] lib._netplan_state_get_vf_count_for_def.restype = c_int lib._netplan_netdef_is_trivial_compound_itf.argtypes = [_NetplanNetDefinitionP] lib._netplan_netdef_is_trivial_compound_itf.restype = c_int cls._abi_loaded = True def __eq__(self, other): if not hasattr(other, '_ptr'): return False return ctypes.addressof(self._ptr.contents) == ctypes.addressof(other._ptr.contents) def __init__(self, np_state, ptr): self._load_abi() self._ptr = ptr # We hold on to this to avoid the underlying pointer being invalidated by # the GC invoking netplan_state_free self._parent = np_state @property def has_match(self): return bool(lib.netplan_netdef_has_match(self._ptr)) @property def set_name(self): return _string_realloc_call_no_error(lambda b: lib.netplan_netdef_get_set_name(self._ptr, b, len(b))) @property def critical(self): return bool(lib._netplan_netdef_get_critical(self._ptr)) @property def sriov_link(self): link_ptr = lib.netplan_netdef_get_sriov_link(self._ptr) if link_ptr: return NetDefinition(self._parent, link_ptr) return None @property def vlan_link(self): link_ptr = lib.netplan_netdef_get_vlan_link(self._ptr) if link_ptr: return NetDefinition(self._parent, link_ptr) return None @property def bridge_link(self): link_ptr = lib.netplan_netdef_get_bridge_link(self._ptr) if link_ptr: return NetDefinition(self._parent, link_ptr) return None @property def bond_link(self): link_ptr = lib.netplan_netdef_get_bond_link(self._ptr) if link_ptr: return NetDefinition(self._parent, link_ptr) return None @property def peer_link(self): link_ptr = lib.netplan_netdef_get_peer_link(self._ptr) if link_ptr: return NetDefinition(self._parent, link_ptr) return None # pragma: nocover (ovs ports are always defined in pairs) @property def vlan_id(self): vlan_id = lib._netplan_netdef_get_vlan_id(self._ptr) # No easy way to get UINT_MAX besides this... if vlan_id == c_uint(-1).value: return None return vlan_id @property def has_sriov_vlan_filter(self): return bool(lib._netplan_netdef_get_sriov_vlan_filter(self._ptr)) @property def backend(self): return lib.netplan_backend_name(lib.netplan_netdef_get_backend(self._ptr)).decode('utf-8') @property def type(self): return lib.netplan_def_type_name(lib.netplan_netdef_get_type(self._ptr)).decode('utf-8') @property def id(self): return _string_realloc_call_no_error(lambda b: lib.netplan_netdef_get_id(self._ptr, b, len(b))) @property def filepath(self): return _string_realloc_call_no_error(lambda b: lib.netplan_netdef_get_filepath(self._ptr, b, len(b))) @property def embedded_switch_mode(self): mode = lib.netplan_netdef_get_embedded_switch_mode(self._ptr) return mode and mode.decode('utf-8') @property def delay_virtual_functions_rebind(self): return bool(lib.netplan_netdef_get_delay_virtual_functions_rebind(self._ptr)) def match_interface(self, itf_name=None, itf_driver=None, itf_mac=None): return bool(lib.netplan_netdef_match_interface( self._ptr, itf_name and itf_name.encode('utf-8'), itf_mac and itf_mac.encode('utf-8'), itf_driver and itf_driver.encode('utf-8'))) @property def vf_count(self): err = ctypes.POINTER(_GError)() count = lib._netplan_state_get_vf_count_for_def(self._parent._ptr, self._ptr, ctypes.byref(err)) if count < 0: raise LibNetplanException(err.contents.message.decode('utf-8')) return count @property def is_trivial_compound_itf(self): ''' Returns True if the interface is a compound interface (bond or bridge), and its configuration is trivial, without any variation from the defaults. ''' return bool(lib._netplan_netdef_is_trivial_compound_itf(self._ptr)) class _NetdefIterator: _abi_loaded = False @classmethod def _load_abi(cls): if cls._abi_loaded: return if not hasattr(lib, '_netplan_iter_defs_per_devtype_init'): # pragma: nocover (hard to unit-test against the WRONG lib) raise LibNetplanException(''' The current version of libnetplan does not allow iterating by devtype. Please ensure that both the netplan CLI package and its library are up to date. ''') lib._netplan_state_new_netdef_pertype_iter.argtypes = [_NetplanStateP, c_char_p] lib._netplan_state_new_netdef_pertype_iter.restype = c_void_p lib._netplan_iter_defs_per_devtype_next.argtypes = [c_void_p] lib._netplan_iter_defs_per_devtype_next.restype = _NetplanNetDefinitionP lib._netplan_iter_defs_per_devtype_free.argtypes = [c_void_p] lib._netplan_iter_defs_per_devtype_free.restype = None lib._netplan_netdef_id.argtypes = [c_void_p] lib._netplan_netdef_id.restype = c_char_p cls._abi_loaded = True def __init__(self, np_state, devtype): self._load_abi() # To keep things valid, keep a reference to the parent state self.np_state = np_state self.iterator = lib._netplan_state_new_netdef_pertype_iter(np_state._ptr, devtype and devtype.encode('utf-8')) def __del__(self): lib._netplan_iter_defs_per_devtype_free(self.iterator) def __iter__(self): return self def __next__(self): next_value = lib._netplan_iter_defs_per_devtype_next(self.iterator) if not next_value: raise StopIteration return NetDefinition(self.np_state, next_value) lib.netplan_util_create_yaml_patch.argtypes = [c_char_p, c_char_p, c_int, _GErrorPP] lib.netplan_util_create_yaml_patch.restype = c_int lib.netplan_util_dump_yaml_subtree.argtypes = [c_char_p, c_int, c_int, _GErrorPP] lib.netplan_util_dump_yaml_subtree.restype = c_int def create_yaml_patch(patch_object_path: List[str], patch_payload: str, patch_output): _checked_lib_call(lib.netplan_util_create_yaml_patch, '\t'.join(patch_object_path).encode('utf-8'), patch_payload.encode('utf-8'), patch_output.fileno()) def dump_yaml_subtree(prefix, input_file, output_file): _checked_lib_call(lib.netplan_util_dump_yaml_subtree, prefix.encode('utf-8'), input_file.fileno(), output_file.fileno()) PK ! �i-� � netplan/__init__.pynu �[��� #!/usr/bin/python3 # # Copyright (C) 2018 Canonical, Ltd. # Author: Mathieu Trudel-Lapierre <mathieu.trudel-lapierre@canonical.com> # # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation; version 3. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty 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, see <http://www.gnu.org/licenses/>. from netplan.cli.core import Netplan __all__ = [Netplan] PK ! �$<�O �O netplan/cli/commands/apply.pynu �[��� #!/usr/bin/python3 # # Copyright (C) 2018-2020 Canonical, Ltd. # Author: Mathieu Trudel-Lapierre <mathieu.trudel-lapierre@canonical.com> # Author: Łukasz 'sil2100' Zemczak <lukasz.zemczak@canonical.com> # Author: Lukas 'slyon' Märdian <lukas.maerdian@canonical.com> # # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation; version 3. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty 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, see <http://www.gnu.org/licenses/>. '''netplan apply command line''' import logging import os import sys import glob import subprocess import shutil import netifaces import time import netplan.cli.utils as utils from netplan.configmanager import ConfigManager, ConfigurationError from netplan.cli.sriov import apply_sriov_config from netplan.cli.ovs import OvsDbServerNotRunning, apply_ovs_cleanup OVS_CLEANUP_SERVICE = 'netplan-ovs-cleanup.service' IF_NAMESIZE = 16 class NetplanApply(utils.NetplanCommand): def __init__(self): super().__init__(command_id='apply', description='Apply current netplan config to running system', leaf=True) self.sriov_only = False self.only_ovs_cleanup = False self.state = None # to be filled by the '--state' argument def run(self): # pragma: nocover (covered in autopkgtest) self.parser.add_argument('--sriov-only', action='store_true', help='Only apply SR-IOV related configuration and exit') self.parser.add_argument('--only-ovs-cleanup', action='store_true', help='Only clean up old OpenVSwitch interfaces and exit') self.parser.add_argument('--state', help='Directory containing previous YAML configuration') self.func = self.command_apply self.parse_args() self.run_command() def command_apply(self, run_generate=True, sync=False, exit_on_error=True, state_dir=None): # pragma: nocover config_manager = ConfigManager() if state_dir: self.state = state_dir # For certain use-cases, we might want to only apply specific configuration. # If we only need SR-IOV configuration, do that and exit early. if self.sriov_only: NetplanApply.process_sriov_config(config_manager, exit_on_error) return # If we only need OpenVSwitch cleanup, do that and exit early. elif self.only_ovs_cleanup: NetplanApply.process_ovs_cleanup(config_manager, False, False, exit_on_error) return # if we are inside a snap, then call dbus to run netplan apply instead if "SNAP" in os.environ: # TODO: maybe check if we are inside a classic snap and don't do # this if we are in a classic snap? busctl = shutil.which("busctl") if busctl is None: raise RuntimeError("missing busctl utility") # XXX: DO NOT TOUCH or change this API call, it is used by snapd to communicate # using core20 netplan binary/client/CLI on core18 base systems. Any change # must be agreed upon with the snapd team, so we don't break support for # base systems running older netplan versions. # https://github.com/snapcore/snapd/pull/5915 res = subprocess.call([busctl, "call", "--quiet", "--system", "io.netplan.Netplan", # the service "/io/netplan/Netplan", # the object "io.netplan.Netplan", # the interface "Apply", # the method ]) if res != 0: if exit_on_error: sys.exit(res) elif res == 130: raise PermissionError( "failed to communicate with dbus service") else: raise RuntimeError( "failed to communicate with dbus service: error %s" % res) else: return ovs_cleanup_service = '/run/systemd/system/netplan-ovs-cleanup.service' old_files_networkd = bool(glob.glob('/run/systemd/network/*netplan-*')) old_ovs_glob = glob.glob('/run/systemd/system/netplan-ovs-*') # Ignore netplan-ovs-cleanup.service, as it can always be there if ovs_cleanup_service in old_ovs_glob: old_ovs_glob.remove(ovs_cleanup_service) old_files_ovs = bool(old_ovs_glob) old_nm_glob = glob.glob('/run/NetworkManager/system-connections/netplan-*') nm_ifaces = utils.nm_interfaces(old_nm_glob, netifaces.interfaces()) old_files_nm = bool(old_nm_glob) generator_call = [] generate_out = None if 'NETPLAN_PROFILE' in os.environ: generator_call.extend(['valgrind', '--leak-check=full']) generate_out = subprocess.STDOUT generator_call.append(utils.get_generator_path()) if run_generate and subprocess.call(generator_call, stderr=generate_out) != 0: if exit_on_error: sys.exit(os.EX_CONFIG) else: raise ConfigurationError("the configuration could not be generated") devices = netifaces.interfaces() # Re-start service when # 1. We have configuration files for it # 2. Previously we had config files for it but not anymore # Ideally we should compare the content of the *netplan-* files before and # after generation to minimize the number of re-starts, but the conditions # above works too. restart_networkd = bool(glob.glob('/run/systemd/network/*netplan-*')) if not restart_networkd and old_files_networkd: restart_networkd = True restart_ovs_glob = glob.glob('/run/systemd/system/netplan-ovs-*') # Ignore netplan-ovs-cleanup.service, as it can always be there if ovs_cleanup_service in restart_ovs_glob: restart_ovs_glob.remove(ovs_cleanup_service) restart_ovs = bool(restart_ovs_glob) if not restart_ovs and old_files_ovs: # OVS is managed via systemd units restart_networkd = True restart_nm_glob = glob.glob('/run/NetworkManager/system-connections/netplan-*') nm_ifaces.update(utils.nm_interfaces(restart_nm_glob, devices)) restart_nm = bool(restart_nm_glob) if not restart_nm and old_files_nm: restart_nm = True # Running 'systemctl daemon-reload' will re-run the netplan systemd generator, # so let's make sure we only run it iff we're willing to run 'netplan generate' if run_generate: utils.systemctl_daemon_reload() # stop backends if restart_networkd: logging.debug('netplan generated networkd configuration changed, reloading networkd') # Clean up any old netplan related OVS ports/bonds/bridges, if applicable NetplanApply.process_ovs_cleanup(config_manager, old_files_ovs, restart_ovs, exit_on_error) wpa_services = ['netplan-wpa-*.service'] # Historically (up to v0.98) we had netplan-wpa@*.service files, in case of an # upgraded system, we need to make sure to stop those. if utils.systemctl_is_active('netplan-wpa@*.service'): wpa_services.insert(0, 'netplan-wpa@*.service') utils.systemctl('stop', wpa_services, sync=sync) else: logging.debug('no netplan generated networkd configuration exists') if restart_nm: logging.debug('netplan generated NM configuration changed, restarting NM') if utils.nm_running(): # restarting NM does not cause new config to be applied, need to shut down devices first for device in devices: if device not in nm_ifaces: continue # do not touch this interface # ignore failures here -- some/many devices might not be managed by NM try: utils.nmcli(['device', 'disconnect', device]) except subprocess.CalledProcessError: pass utils.systemctl_network_manager('stop', sync=sync) else: logging.debug('no netplan generated NM configuration exists') # Refresh devices now; restarting a backend might have made something appear. devices = netifaces.interfaces() # evaluate config for extra steps we need to take (like renaming) # for now, only applies to non-virtual (real) devices. config_manager.parse() changes = NetplanApply.process_link_changes(devices, config_manager) # delete virtual interfaces that have been defined in a previous state # but are not configured anymore in the current YAML if self.state: cm = ConfigManager(self.state) cm.parse() # get previous configuration state prev_links = cm.virtual_interfaces.keys() curr_links = config_manager.virtual_interfaces.keys() NetplanApply.clear_virtual_links(prev_links, curr_links, devices) # if the interface is up, we can still apply some .link file changes # but we cannot apply the interface rename via udev, as it won't touch # the interface name, if it was already renamed once (e.g. during boot), # because of the NamePolicy=keep default: # https://www.freedesktop.org/software/systemd/man/systemd.net-naming-scheme.html devices = netifaces.interfaces() for device in devices: logging.debug('netplan triggering .link rules for %s', device) try: subprocess.check_call(['udevadm', 'test-builtin', 'net_setup_link', '/sys/class/net/' + device], stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL) subprocess.check_call(['udevadm', 'test', '/sys/class/net/' + device], stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL) except subprocess.CalledProcessError: logging.debug('Ignoring device without syspath: %s', device) devices_after_udev = netifaces.interfaces() # apply some more changes manually for iface, settings in changes.items(): # rename non-critical network interfaces new_name = settings.get('name') if new_name: if len(new_name) >= IF_NAMESIZE: logging.warning('Interface name {} is too long. {} will not be renamed'.format(new_name, iface)) continue if iface in devices and new_name in devices_after_udev: logging.debug('Interface rename {} -> {} already happened.'.format(iface, new_name)) continue # re-name already happened via 'udevadm test' # bring down the interface, using its current (matched) interface name subprocess.check_call(['ip', 'link', 'set', 'dev', iface, 'down'], stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL) # rename the interface to the name given via 'set-name' subprocess.check_call(['ip', 'link', 'set', 'dev', iface, 'name', settings.get('name')], stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL) # Reloading of udev rules happens during 'netplan generate' already # subprocess.check_call(['udevadm', 'control', '--reload-rules']) subprocess.check_call(['udevadm', 'trigger', '--attr-match=subsystem=net']) subprocess.check_call(['udevadm', 'settle']) # apply any SR-IOV related changes, if applicable NetplanApply.process_sriov_config(config_manager, exit_on_error) # (re)set global regulatory domain if os.path.exists('/run/systemd/system/netplan-regdom.service'): utils.systemctl('start', ['netplan-regdom.service']) # (re)start backends if restart_networkd: netplan_wpa = [os.path.basename(f) for f in glob.glob('/run/systemd/system/*.wants/netplan-wpa-*.service')] # exclude the special 'netplan-ovs-cleanup.service' unit netplan_ovs = [os.path.basename(f) for f in glob.glob('/run/systemd/system/*.wants/netplan-ovs-*.service') if not f.endswith('/' + OVS_CLEANUP_SERVICE)] # Run 'systemctl start' command synchronously, to avoid race conditions # with 'oneshot' systemd service units, e.g. netplan-ovs-*.service. try: utils.networkctl_reload() utils.networkctl_reconfigure(utils.networkd_interfaces()) except subprocess.CalledProcessError: # (re-)start systemd-networkd if it is not running, yet logging.warning('Falling back to a hard restart of systemd-networkd.service') utils.systemctl('restart', ['systemd-networkd.service'], sync=True) # 1st: execute OVS cleanup, to avoid races while applying OVS config utils.systemctl('start', [OVS_CLEANUP_SERVICE], sync=True) # 2nd: start all other services utils.systemctl('start', netplan_wpa + netplan_ovs, sync=True) if restart_nm: # Flush all IP addresses of NM managed interfaces, to avoid NM creating # new, non netplan-* connection profiles, using the existing IPs. for iface in utils.nm_interfaces(restart_nm_glob, devices): utils.ip_addr_flush(iface) # clear NM state, especially the [device].managed=true config, as that might have been # re-set via an udev rule setting "NM_UNMANAGED=1" shutil.rmtree('/run/NetworkManager/devices', ignore_errors=True) utils.systemctl_network_manager('start', sync=sync) if sync: # 'nmcli' could be /usr/bin/nmcli or # /snap/bin/nmcli -> /snap/bin/network-manager.nmcli cmd = ['nmcli', 'general', 'status'] # wait a bit for 'connected (site/local-only)' or # 'connected' to appear in 'nmcli general' STATE for _ in range(10): out = subprocess.run(cmd, capture_output=True, text=True) # Handle nmcli's "not running" return code (8) gracefully, # giving some more time for NetworkManager startup if out.returncode == 8: time.sleep(1) continue if '\nconnected' in str(out.stdout): break time.sleep(0.5) @staticmethod def is_composite_member(composites, phy): """ Is this physical interface a member of a 'composite' virtual interface? (bond, bridge) """ for composite in composites: for _, settings in composite.items(): if not type(settings) is dict: continue members = settings.get('interfaces', []) for iface in members: if iface == phy: return True return False @staticmethod def clear_virtual_links(prev_links, curr_links, devices=[]): """ Calculate the delta of virtual links. And remove the links that were dropped from the YAML config, if they were not dropped by the backend already. We can make use of the netplan netdef ids, as those equal the interface name for virtual links. """ if not devices: logging.warning('Cannot clear virtual links: no network interfaces provided.') return [] dropped_interfaces = list(set(prev_links) - set(curr_links)) # some interfaces might have been cleaned up already, e.g. by the # NetworkManager backend interfaces_to_clear = list(set(dropped_interfaces).intersection(devices)) for link in interfaces_to_clear: try: cmd = ['ip', 'link', 'delete', 'dev', link] subprocess.check_call(cmd) except subprocess.CalledProcessError: logging.warning('Could not delete interface {}'.format(link)) return dropped_interfaces @staticmethod def process_link_changes(interfaces, config_manager: ConfigManager): # pragma: nocover (covered in autopkgtest) """ Go through the pending changes and pick what needs special handling. Only applies to non-critical interfaces which can be safely updated. """ changes = {} composite_interfaces = [config_manager.bridges, config_manager.bonds] # Find physical interfaces which need a rename # But do not rename virtual interfaces for netdef in config_manager.physical_interfaces.values(): newname = netdef.set_name if not newname: continue # Skip if no new name needs to be set if not netdef.has_match: continue # Skip if no match for current name is given if NetplanApply.is_composite_member(composite_interfaces, netdef.id): logging.debug('Skipping composite member {}'.format(netdef.id)) # do not rename members of virtual devices. MAC addresses # may be the same for all interface members. continue # Find current name of the interface, according to match conditions and globs (name, mac, driver) current_iface_name = utils.find_matching_iface(interfaces, netdef) if not current_iface_name: logging.warning('Cannot find unique matching interface for {}'.format(netdef.id)) continue if current_iface_name == newname: # Skip interface if it already has the correct name logging.debug('Skipping correctly named interface: {}'.format(newname)) continue if netdef.critical: # Skip interfaces defined as critical, as we should not take them down in order to rename logging.warning('Cannot rename {} ({} -> {}) at runtime (needs reboot), due to being critical' .format(netdef.id, current_iface_name, newname)) continue # record the interface rename change changes[current_iface_name] = {'name': newname} logging.debug('Link changes: {}'.format(changes)) return changes @staticmethod def process_sriov_config(config_manager, exit_on_error=True): # pragma: nocover (covered in autopkgtest) try: apply_sriov_config(config_manager) except utils.config_errors as e: logging.error(str(e)) if exit_on_error: sys.exit(1) @staticmethod def process_ovs_cleanup(config_manager, ovs_old, ovs_current, exit_on_error=True): # pragma: nocover (autopkgtest) try: apply_ovs_cleanup(config_manager, ovs_old, ovs_current) except (OSError, RuntimeError) as e: logging.error(str(e)) if exit_on_error: sys.exit(1) except OvsDbServerNotRunning as e: logging.warning('Cannot call Open vSwitch: {}.'.format(e)) PK ! �2�9c c netplan/cli/commands/ip.pynu �[��� #!/usr/bin/python3 # # Copyright (C) 2018 Canonical, Ltd. # Author: Mathieu Trudel-Lapierre <mathieu.trudel-lapierre@canonical.com> # # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation; version 3. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty 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, see <http://www.gnu.org/licenses/>. '''netplan ip command line''' import logging import os import sys import subprocess from subprocess import CalledProcessError import netplan.cli.utils as utils lease_path = { 'networkd': { 'pattern': 'run/systemd/netif/leases/{lease_id}', 'method': 'ifindex', }, 'NetworkManager': { 'pattern': 'var/lib/NetworkManager/internal-{lease_id}-{interface}.lease', 'method': 'nm_connection', }, } class NetplanIp(utils.NetplanCommand): def __init__(self): super().__init__(command_id='ip', description='Retrieve IP information from the system', leaf=False) def run(self): self.command_leases = NetplanIpLeases() # subcommand: leases p_ip_leases = self.subparsers.add_parser('leases', help='Display IP leases', add_help=False) p_ip_leases.set_defaults(func=self.command_leases.run, commandclass=self.command_leases) self.parse_args() self.run_command() class NetplanIpLeases(utils.NetplanCommand): def __init__(self): super().__init__(command_id='ip leases', description='Display IP leases', leaf=True) def run(self): self.parser.add_argument('interface', help='Interface for which to display IP lease settings.') self.parser.add_argument('--root-dir', help='Search for configuration files in this root directory instead of /') self.func = self.command_ip_leases self.parse_args() self.run_command() def command_ip_leases(self): if self.interface == 'help': # pragma: nocover (covered in autopkgtest) self.print_usage() def find_lease_file(mapping): def lease_method_ifindex(): ifindex_f = os.path.join('/sys/class/net', self.interface, 'ifindex') try: with open(ifindex_f) as f: return f.readlines()[0].strip() except Exception as e: logging.debug('Cannot read file %s: %s', ifindex_f, str(e)) raise def lease_method_nm_connection(): # FIXME: handle older versions of NM where 'nmcli dev show' doesn't exist try: nmcli_dev_out = utils.nmcli_out(['dev', 'show', self.interface]) for line in nmcli_dev_out.splitlines(): if 'GENERAL.CONNECTION' in line: conn_id = line.split(':')[1].rstrip().strip() nmcli_con_out = utils.nmcli_out(['con', 'show', 'id', conn_id]) for line in nmcli_con_out.splitlines(): if 'connection.uuid' in line: return line.split(':')[1].rstrip().strip() except Exception as e: raise Exception('Could not find a NetworkManager connection for the interface: %s' % str(e)) raise Exception('Could not find a NetworkManager connection for the interface') lease_pattern = lease_path[mapping['backend']]['pattern'] lease_method = lease_path[mapping['backend']]['method'] try: lease_id = eval("lease_method_" + lease_method)() # We found something to build the path to the lease file with, # at this point we may have something to look at; but if not, # we'll rely on open() throwing an error. # This might happen if networkd doesn't use DHCP for the interface, # for instance. path = os.path.join('/', os.path.abspath(self.root_dir) if self.root_dir else "", lease_pattern.format(interface=self.interface, lease_id=lease_id)) # Fallback to 'dhclient' if no lease of NetworkManager's # internal DHCP client is found if not os.path.isfile(path): path = path.replace('NetworkManager/internal-', 'NetworkManager/dhclient-') with open(path) as f: for line in f.readlines(): print(line.rstrip()) except Exception as e: print("No lease found for interface '%s': %s" % (self.interface, str(e)), file=sys.stderr) sys.exit(1) argv = [utils.get_generator_path()] if self.root_dir: argv += ['--root-dir', self.root_dir] argv += ['--mapping', self.interface] # Extract out of the generator our mapping in a dict. logging.debug('command ip leases: running %s', argv) try: out = subprocess.check_output(argv, text=True) except CalledProcessError: # pragma: nocover (better be covered in autopkgtest) print("No lease found for interface '%s' (not managed by Netplan)" % self.interface, file=sys.stderr) sys.exit(1) mapping = {} mapping_s = out.split(',') for keyvalue in mapping_s: key, value = keyvalue.strip().split('=') mapping[key] = value find_lease_file(mapping) PK ! �E�� � netplan/cli/commands/info.pynu �[��� #!/usr/bin/python3 # # Copyright (C) 2019 Canonical, Ltd. # Author: Mathieu Trudel-Lapierre <mathieu.trudel-lapierre@canonical.com> # # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation; version 3. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty 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, see <http://www.gnu.org/licenses/>. '''netplan info command line''' import netplan.cli.utils as utils import netplan._features class NetplanInfo(utils.NetplanCommand): def __init__(self): super().__init__(command_id='info', description='Show available features', leaf=True) def run(self): # pragma: nocover (covered in autopkgtest) format_group = self.parser.add_mutually_exclusive_group(required=False) format_group.add_argument('--json', dest='version_format', action='store_const', const='json', help='Output version and features in JSON format') format_group.add_argument('--yaml', dest='version_format', action='store_const', const='yaml', help='Output version and features in YAML format') self.func = self.command_info self.parse_args() self.run_command() def command_info(self): netplan_version = { 'netplan.io': { 'website': 'https://netplan.io/', } } flags = netplan._features.NETPLAN_FEATURE_FLAGS netplan_version['netplan.io'].update({'features': flags}) # Default to output in YAML format. if self.version_format is None: self.version_format = 'yaml' if self.version_format == 'json': import json print(json.dumps(netplan_version, indent=2)) elif self.version_format == 'yaml': print('''netplan.io: website: "{}" features:'''.format(netplan_version['netplan.io']['website'])) for feature in netplan._features.NETPLAN_FEATURE_FLAGS: print(' - ' + feature) PK ! ��~��k �k netplan/cli/commands/status.pynu �[��� #!/usr/bin/python3 # # Copyright (C) 2022 Canonical, Ltd. # Author: Lukas Märdian <slyon@ubuntu.com> # # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation; version 3. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty 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, see <http://www.gnu.org/licenses/>. '''netplan status command line''' import ipaddress import json import logging import re import socket import subprocess import sys from typing import Union, Dict, List, Type import dbus import yaml import netplan.cli.utils as utils JSON = Union[Dict[str, 'JSON'], List['JSON'], int, str, float, bool, Type[None]] MATCH_TAGS = re.compile(r'\[([a-z0-9]+)\].*\[\/\1\]') RICH_OUTPUT = False try: from rich.console import Console from rich.highlighter import RegexHighlighter from rich.theme import Theme class NetplanHighlighter(RegexHighlighter): base_style = 'netplan.' highlights = [ r'(^|[\s\/])(?P<int>\d+)([\s:]?\s|$)', r'(?P<str>(\"|\').+(\"|\'))', ] RICH_OUTPUT = True except ImportError: # pragma: nocover (we mock RICH_OUTPUT, ignore the logging) logging.debug("python3-rich not found, falling back to plain output") class Interface(): def __extract_mac(self, ip: dict) -> str: ''' Extract the MAC address if it's set inside the JSON data and seems to have the correct format. Return 'None' otherwise. ''' if len(address := ip.get('address', '')) == 17: # 6 byte MAC (+5 colons) return address.lower() return None def __init__(self, ip: dict, nd_data: JSON = [], nm_data: JSON = [], resolved_data: tuple = (None, None), route_data: tuple = (None, None)): self.idx: int = ip.get('ifindex', -1) self.name: str = ip.get('ifname', 'unknown') self.adminstate: str = 'UP' if 'UP' in ip.get('flags', []) else 'DOWN' self.operstate: str = ip.get('operstate', 'unknown').upper() self.macaddress: str = self.__extract_mac(ip) # Filter networkd/NetworkManager data nm_data = nm_data or [] # avoid 'None' value on systems without NM self.nd: JSON = next((x for x in nd_data if x['Index'] == self.idx), None) self.nm: JSON = next((x for x in nm_data if x['device'] == self.name), None) # Filter resolved's DNS data self.dns_addresses: list = None if resolved_data[0]: self.dns_addresses = [] for itr in resolved_data[0]: if int(itr[0]) == int(self.idx): ipfamily = itr[1] dns = itr[2] self.dns_addresses.append(socket.inet_ntop(ipfamily, b''.join([v.to_bytes(1, 'big') for v in dns]))) self.dns_search: list = None if resolved_data[1]: self.dns_search = [] for v in resolved_data[1]: if int(v[0]) == int(self.idx): self.dns_search.append(str(v[1])) # Filter route data _routes: list = [] self.routes: list = None if route_data[0]: _routes += route_data[0] if route_data[1]: _routes += route_data[1] if _routes: self.routes = [] for obj in _routes: if obj.get('dev') == self.name: elem = {'to': obj.get('dst')} val = obj.get('gateway') if val: elem['via'] = val val = obj.get('prefsrc') if val: elem['from'] = val val = obj.get('metric') if val: elem['metric'] = val val = obj.get('type') if val: elem['type'] = val val = obj.get('scope') if val: elem['scope'] = val val = obj.get('protocol') if val: elem['protocol'] = val self.routes.append(elem) self.addresses: list = None if addr_info := ip.get('addr_info'): self.addresses = [] for addr in addr_info: flags: list = [] if ipaddress.ip_address(addr['local']).is_link_local: flags.append('link') if self.routes: for route in self.routes: if ('from' in route and ipaddress.ip_address(route['from']) == ipaddress.ip_address(addr['local'])): if route['protocol'] == 'dhcp': flags.append('dhcp') break ip_addr = addr['local'].lower() elem = {ip_addr: {'prefix': addr['prefixlen']}} if flags: elem[ip_addr]['flags'] = flags self.addresses.append(elem) self.iproute_type: str = None if info_kind := ip.get('linkinfo', {}).get('info_kind'): self.iproute_type = info_kind.strip() # workaround: query some data which is not available via networkctl's JSON output self._networkctl: str = self.query_networkctl(self.name) or '' def query_nm_ssid(self, con_name: str) -> str: ssid: str = None try: ssid = utils.nmcli_out(['--get-values', '802-11-wireless.ssid', 'con', 'show', 'id', con_name]) return ssid.strip() except Exception as e: logging.warning('Cannot query NetworkManager SSID for {}: {}'.format( con_name, str(e))) return ssid def query_networkctl(self, ifname: str) -> str: output: str = None try: output = subprocess.check_output(['networkctl', 'status', '--', ifname], text=True) except Exception as e: logging.warning('Cannot query networkctl for {}: {}'.format( ifname, str(e))) return output def json(self) -> JSON: json = { 'index': self.idx, 'adminstate': self.adminstate, 'operstate': self.operstate, } if self.type: json['type'] = self.type if self.ssid: json['ssid'] = self.ssid if self.tunnel_mode: json['tunnel_mode'] = self.tunnel_mode if self.backend: json['backend'] = self.backend if self.netdef_id: json['id'] = self.netdef_id if self.macaddress: json['macaddress'] = self.macaddress if self.vendor: json['vendor'] = self.vendor if self.addresses: json['addresses'] = self.addresses if self.dns_addresses: json['dns_addresses'] = self.dns_addresses if self.dns_search: json['dns_search'] = self.dns_search if self.routes: json['routes'] = self.routes if self.activation_mode: json['activation_mode'] = self.activation_mode return (self.name, json) @property def up(self) -> bool: return self.adminstate == 'UP' and self.operstate == 'UP' @property def down(self) -> bool: return self.adminstate == 'DOWN' and self.operstate == 'DOWN' @property def type(self) -> str: match = dict({ 'bond': 'bond', 'bridge': 'bridge', 'ether': 'ethernet', 'ipgre': 'tunnel', 'ip6gre': 'tunnel', 'loopback': 'ethernet', 'sit': 'tunnel', 'tunnel': 'tunnel', 'tunnel6': 'tunnel', 'wireguard': 'tunnel', 'wlan': 'wifi', 'wwan': 'modem', 'vrf': 'vrf', 'vxlan': 'tunnel', }) nd_type = self.nd.get('Type') if self.nd else None if nd_type in match: return match[nd_type] logging.warning('Unknown device type: {}'.format(nd_type)) return None @property def tunnel_mode(self) -> str: if self.type == 'tunnel' and self.iproute_type: return self.iproute_type return None @property def backend(self) -> str: if (self.nd and 'unmanaged' not in self.nd.get('SetupState', '') and 'run/systemd/network/10-netplan-' in self.nd.get('NetworkFile', '')): return 'networkd' elif self.nm and 'run/NetworkManager/system-connections/netplan-' in self.nm.get('filename', ''): return 'NetworkManager' return None @property def netdef_id(self) -> str: if self.backend == 'networkd': return self.nd.get('NetworkFile', '').split( 'run/systemd/network/10-netplan-')[1].split('.network')[0] elif self.backend == 'NetworkManager': netdef = self.nm.get('filename', '').split( 'run/NetworkManager/system-connections/netplan-')[1].split('.nmconnection')[0] if self.nm.get('type', '') == '802-11-wireless': ssid = self.query_nm_ssid(self.nm.get('name')) if ssid: # XXX: escaping needed? netdef = netdef.split('-' + ssid)[0] return netdef return None @property def vendor(self) -> str: if self.nd and 'Vendor' in self.nd and self.nd['Vendor']: return self.nd['Vendor'].strip() return None @property def ssid(self) -> str: if self.type == 'wifi': # XXX: available from networkctl's JSON output as of v250: # https://github.com/systemd/systemd/commit/da7c995 for line in self._networkctl.splitlines(): line = line.strip() key = 'WiFi access point: ' if line.startswith(key): ssid = line[len(key):-len(' (xB:SS:ID:xx:xx:xx)')].strip() return ssid if ssid else None return None @property def activation_mode(self) -> str: if self.backend == 'networkd': # XXX: available from networkctl's JSON output as of v250: # https://github.com/systemd/systemd/commit/3b60ede for line in self._networkctl.splitlines(): line = line.strip() key = 'Activation Policy: ' if line.startswith(key): mode = line[len(key):].strip() return mode if mode != 'up' else None # XXX: this is not fully supported on NetworkManager, only 'manual'/'up' elif self.backend == 'NetworkManager': return 'manual' if self.nm['autoconnect'] == 'no' else None return None class NetplanStatus(utils.NetplanCommand): def __init__(self): super().__init__(command_id='status', description='Query networking state of the running system', leaf=True) self.all = False def run(self): self.parser.add_argument('ifname', nargs='?', type=str, default=None, help='Show only this interface') self.parser.add_argument('-a', '--all', action='store_true', help='Show all interface data (incl. inactive)') self.parser.add_argument('-f', '--format', default='tabular', help='Output in machine readable `json` or `yaml` format') self.func = self.command self.parse_args() self.run_command() def resolvconf_json(self) -> dict: res = { 'addresses': [], 'search': [], 'mode': None, } try: with open('/etc/resolv.conf') as f: # check first line for systemd-resolved stub or compat modes firstline = f.readline() if '# This is /run/systemd/resolve/stub-resolv.conf' in firstline: res['mode'] = 'stub' elif '# This is /run/systemd/resolve/resolv.conf' in firstline: res['mode'] = 'compat' for line in [firstline] + f.readlines(): if line.startswith('nameserver'): res['addresses'] += line.split()[1:] # append if line.startswith('search'): res['search'] = line.split()[1:] # override except Exception as e: logging.warning('Cannot parse /etc/resolv.conf: {}'.format(str(e))) return res def query_online_state(self, interfaces: list) -> bool: # TODO: fully implement network-online.target specification (FO020): # https://discourse.ubuntu.com/t/spec-definition-of-an-online-system/27838 for itf in interfaces: if itf.up and itf.addresses and itf.routes and itf.dns_addresses: non_local_ips = [] for addr in itf.addresses: ip, extra = list(addr.items())[0] if 'flags' not in extra or 'link' not in extra['flags']: non_local_ips.append(ip) default_routes = [x for x in itf.routes if x.get('to', None) == 'default'] if non_local_ips and default_routes and itf.dns_addresses: return True return False def process_generic(self, cmd_output: str) -> JSON: return json.loads(cmd_output) def query_iproute2(self) -> JSON: data: JSON = None try: output: str = subprocess.check_output(['ip', '-d', '-j', 'addr'], text=True) data = self.process_generic(output) except Exception as e: logging.critical('Cannot query iproute2 interface data: {}'.format(str(e))) return data def process_networkd(self, cmd_output) -> JSON: return json.loads(cmd_output)['Interfaces'] def query_networkd(self) -> JSON: data: JSON = None try: output: str = subprocess.check_output(['networkctl', '--json=short'], text=True) data = self.process_networkd(output) except Exception as e: logging.critical('Cannot query networkd interface data: {}'.format(str(e))) return data def process_nm(self, cmd_output) -> JSON: data: JSON = [] for line in cmd_output.splitlines(): split = line.split(':') dev = split[0] if split[0] else None if dev: # ignore inactive connection profiles data.append({ 'device': dev, 'name': split[1], 'uuid': split[2], 'filename': split[3], 'type': split[4], 'autoconnect': split[5], }) return data def query_nm(self) -> JSON: data: JSON = None try: output: str = utils.nmcli_out(['-t', '-f', 'DEVICE,NAME,UUID,FILENAME,TYPE,AUTOCONNECT', 'con', 'show']) data = self.process_nm(output) except Exception as e: logging.debug('Cannot query NetworkManager interface data: {}'.format(str(e))) return data def query_routes(self) -> tuple: data4 = None data6 = None try: output4: str = subprocess.check_output(['ip', '-d', '-j', 'route'], text=True) data4: JSON = self.process_generic(output4) output6: str = subprocess.check_output(['ip', '-d', '-j', '-6', 'route'], text=True) data6: JSON = self.process_generic(output6) except Exception as e: logging.debug('Cannot query iproute2 route data: {}'.format(str(e))) return (data4, data6) def query_resolved(self) -> tuple: addresses = None search = None try: ipc = dbus.SystemBus() resolve1 = ipc.get_object('org.freedesktop.resolve1', '/org/freedesktop/resolve1') resolve1_if = dbus.Interface(resolve1, 'org.freedesktop.DBus.Properties') res = resolve1_if.GetAll('org.freedesktop.resolve1.Manager') addresses = res['DNS'] search = res['Domains'] except Exception as e: logging.debug('Cannot query resolved DNS data: {}'.format(str(e))) return (addresses, search) def plain_print(self, *args, **kwargs): if len(args): lst = list(args) for tag in MATCH_TAGS.findall(lst[0]): # remove matching opening and closing tag lst[0] = lst[0].replace('[{}]'.format(tag), '')\ .replace('[/{}]'.format(tag), '') return print(*lst, **kwargs) return print(*args, **kwargs) def pretty_print(self, data: JSON, total: int, _console_width=None) -> None: if RICH_OUTPUT: # TODO: Use a proper (subiquity?) color palette theme = Theme({ 'netplan.int': 'bold cyan', 'netplan.str': 'yellow', 'muted': 'grey62', 'online': 'green bold', 'offline': 'red bold', 'unknown': 'yellow bold', 'highlight': 'bold' }) console = Console(highlighter=NetplanHighlighter(), theme=theme, width=_console_width, emoji=False) pprint = console.print else: pprint = self.plain_print pad = '18' global_state = data.get('netplan-global-state', {}) interfaces = [(key, data[key]) for key in data if key != 'netplan-global-state'] # Global state pprint(('{title:>'+pad+'} {value}').format( title='Online state:', value='[online]online[/online]' if global_state.get('online', False) else '[offline]offline[/offline]', )) ns = global_state.get('nameservers', {}) dns_addr: list = ns.get('addresses', []) dns_mode: str = ns.get('mode') dns_search: list = ns.get('search', []) if dns_addr: for i, val in enumerate(dns_addr): pprint(('{title:>'+pad+'} {value}[muted]{mode}[/muted]').format( title='DNS Addresses:' if i == 0 else '', value=val, mode=' ({})'.format(dns_mode) if dns_mode else '', )) if dns_search: for i, val in enumerate(dns_search): pprint(('{title:>'+pad+'} {value}').format( title='DNS Search:' if i == 0 else '', value=val, )) pprint() # Per interface for (ifname, data) in interfaces: state = data.get('operstate', 'UNKNOWN') + '/' + data.get('adminstate', 'UNKNOWN') scolor = 'unknown' if state == 'UP/UP': state = 'UP' scolor = 'online' elif state == 'DOWN/DOWN': state = 'DOWN' scolor = 'offline' full_type = data.get('type', 'other') ssid = data.get('ssid') tunnel_mode = data.get('tunnel_mode') if full_type == 'wifi' and ssid: full_type += ('/"' + ssid + '"') elif full_type == 'tunnel' and tunnel_mode: full_type += ('/' + tunnel_mode) pprint('[{col}]●[/{col}] {idx:>2}: {name} {type} [{col}]{state}[/{col}] ({backend}{netdef})'.format( col=scolor, idx=data.get('index', '?'), name=ifname, type=full_type, state=state, backend=data.get('backend', 'unmanaged'), netdef=': [highlight]{}[/highlight]'.format(data.get('id')) if data.get('id') else '' )) if data.get('macaddress'): pprint(('{title:>'+pad+'} {mac}[muted]{vendor}[/muted]').format( title='MAC Address:', mac=data.get('macaddress', ''), vendor=' ({})'.format(data.get('vendor', '')) if data.get('vendor') else '', )) lst: list = data.get('addresses', []) if lst: for i, obj in enumerate(lst): ip, extra = list(obj.items())[0] # get first (any only) address flags = [] if extra.get('flags'): # flags flags = extra.get('flags', []) highlight_start = '' highlight_end = '' if not flags or 'dhcp' in flags: highlight_start = '[highlight]' highlight_end = '[/highlight]' pprint(('{title:>'+pad+'} {start}{ip}/{prefix}{end}[muted]{extra}[/muted]').format( title='Addresses:' if i == 0 else '', ip=ip, prefix=extra.get('prefix', ''), extra=' ('+', '.join(flags)+')' if flags else '', start=highlight_start, end=highlight_end, )) lst = data.get('dns_addresses', []) if lst: for i, val in enumerate(lst): pprint(('{title:>'+pad+'} {value}').format( title='DNS Addresses:' if i == 0 else '', value=val, )) lst = data.get('dns_search', []) if lst: for i, val in enumerate(lst): pprint(('{title:>'+pad+'} {value}').format( title='DNS Search:' if i == 0 else '', value=val, )) lst = data.get('routes', []) if lst: for i, obj in enumerate(lst): default_start = '' default_end = '' if obj['to'] == 'default': default_start = '[highlight]' default_end = '[/highlight]' via = '' if 'via' in obj: via = ' via ' + obj['via'] src = '' if 'from' in obj: src = ' from ' + obj['from'] metric = '' if 'metric' in obj: metric = ' metric ' + str(obj['metric']) extra = [] if 'protocol' in obj and obj['protocol'] != 'kernel': proto = obj['protocol'] extra.append(proto) if 'scope' in obj and obj['scope'] != 'global': scope = obj['scope'] extra.append(scope) if 'type' in obj and obj['type'] != 'unicast': type = obj['type'] extra.append(type) pprint(('{title:>'+pad+'} {start}{to}{via}{src}{metric}{end}[muted]{extra}[/muted]').format( title='Routes:' if i == 0 else '', to=obj['to'], via=via, src=src, metric=metric, extra=' ('+', '.join(extra)+')' if extra else '', start=default_start, end=default_end)) val = data.get('activation_mode') if val: pprint(('{title:>'+pad+'} {value}').format( title='Activation Mode:', value=val, )) pprint() hidden = total - len(interfaces) if (hidden > 0): pprint('{} inactive interfaces hidden. Use "--all" to show all.'.format(hidden)) def command(self): # Make sure sd-networkd is running, as we need the data it provides. if not utils.systemctl_is_active('systemd-networkd.service'): if utils.systemctl_is_masked('systemd-networkd.service'): logging.error('\'netplan status\' depends on networkd, ' 'but systemd-networkd.service is masked. ' 'Please start it.') sys.exit(1) logging.debug('systemd-networkd.service is not active. Starting...') utils.systemctl('start', ['systemd-networkd.service'], True) # required data: iproute2 and sd-networkd can be expected to exist, # due to hard package dependencies iproute2 = self.query_iproute2() networkd = self.query_networkd() if not iproute2 or not networkd: logging.error('Could not query iproute2 or systemd-networkd') sys.exit(1) # optional data nmcli = self.query_nm() route4, route6 = self.query_routes() dns_addresses, dns_search = self.query_resolved() interfaces = [Interface(itf, networkd, nmcli, (dns_addresses, dns_search), (route4, route6)) for itf in iproute2] total = len(interfaces) # show only active interfaces by default filtered = [itf for itf in interfaces if itf.operstate != 'DOWN'] # down interfaces do not contribute anything to the online state online_state = self.query_online_state(filtered) # show only a single interface, if requested # XXX: bash completion (for interfaces names) if self.ifname: filtered = [next((itf for itf in interfaces if itf.name == self.ifname), None)] filtered = [elem for elem in filtered if elem is not None] if self.ifname and filtered == []: logging.error('Could not find interface {}'.format(self.ifname)) sys.exit(1) # Global state data = { 'netplan-global-state': { 'online': online_state, 'nameservers': self.resolvconf_json() } } # Per interface itf_iter = interfaces if self.all else filtered for itf in itf_iter: ifname, obj = itf.json() data[ifname] = obj # Output data in requested format output_format = self.format.lower() if output_format == 'json': # structural JSON output print(json.dumps(data, indent=None)) elif output_format == 'yaml': # stuctural YAML output print(yaml.dump(data, default_flow_style=False)) else: # pretty print, human readable output self.pretty_print(data, total) PK ! I��O �O netplan/cli/commands/migrate.pynu �[��� #!/usr/bin/python3 # # Copyright (C) 2018 Canonical, Ltd. # Author: Mathieu Trudel-Lapierre <mathieu.trudel-lapierre@canonical.com> # # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation; version 3. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty 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, see <http://www.gnu.org/licenses/>. '''netplan migrate command line''' import logging import os import sys import re from glob import glob try: import yaml NO_YAML = False except ImportError: # pragma: nocover NO_YAML = True from collections import OrderedDict import ipaddress import netplan.cli.utils as utils class NetplanMigrate(utils.NetplanCommand): def __init__(self): super().__init__(command_id='migrate', description='Migration of /etc/network/interfaces to netplan', leaf=True, testing=True) def parse_dns_options(self, if_options, if_config): """Parse dns options (dns-nameservers and dns-search) from if_options (an interface options dict) into the interface configuration if_config Mutates the arguments in place. """ if 'dns-nameservers' in if_options: if 'nameservers' not in if_config: if_config['nameservers'] = {} if 'addresses' not in if_config['nameservers']: if_config['nameservers']['addresses'] = [] for ns in if_options['dns-nameservers'].split(' '): # allow multiple spaces in the dns-nameservers entry if not ns: continue # validate? if_config['nameservers']['addresses'] += [ns] del if_options['dns-nameservers'] if 'dns-search' in if_options: if 'nameservers' not in if_config: if_config['nameservers'] = {} if 'search' not in if_config['nameservers']: if_config['nameservers']['search'] = [] for domain in if_options['dns-search'].split(' '): # allow multiple spaces in the dns-search entry if not domain: continue if_config['nameservers']['search'] += [domain] del if_options['dns-search'] def parse_mtu(self, iface, if_options, if_config): """Parse out the MTU. Operates the same way as parse_dns_options iface is the name of the interface, used only to print error messages """ if 'mtu' in if_options: try: mtu = int(if_options['mtu']) except ValueError: logging.error('%s: cannot parse "%s" as an MTU', iface, if_options['mtu']) sys.exit(2) if 'mtu' in if_config and not if_config['mtu'] == mtu: logging.error('%s: tried to set MTU=%d, but already have MTU=%d', iface, mtu, if_config['mtu']) sys.exit(2) if_config['mtu'] = mtu del if_options['mtu'] def parse_hwaddress(self, iface, if_options, if_config): """Parse out the manually configured MAC. Operates the same way as parse_dns_options iface is the name of the interface, used only to print error messages """ if 'hwaddress' in if_options: if 'macaddress' in if_config and not if_config['macaddress'] == if_options['hwaddress']: logging.error('%s: tried to set MAC %s, but already have MAC %s', iface, if_options['hwaddress'], if_config['macaddress']) sys.exit(2) if_config['macaddress'] = if_options['hwaddress'] del if_options['hwaddress'] def run(self): self.parser.add_argument('--root-dir', help='Search for and generate configuration files in this root directory instead of /') self.parser.add_argument('--dry-run', action='store_true', help='Print converted netplan configuration to stdout instead of writing/changing files') self.func = self.command_migrate self.parse_args() if NO_YAML: # pragma: nocover logging.error("""The `yaml` Python package couldn't be imported, and is needed for the migrate command. To install it on Debian or Ubuntu-based system, run `apt install python3-yaml`""") sys.exit(1) self.run_command() def command_migrate(self): netplan_config = {} try: ifaces, auto_ifaces = self.parse_ifupdown(self.root_dir or '') except ValueError as e: logging.error(str(e)) sys.exit(2) for iface, family_config in ifaces.items(): for family, config in family_config.items(): logging.debug('Converting %s family %s %s', iface, family, config) if iface not in auto_ifaces: logging.error('%s: non-automatic interfaces are not supported', iface) sys.exit(2) if config['method'] == 'loopback': # both systemd and modern ifupdown set up lo automatically logging.debug('Ignoring loopback interface %s', iface) elif config['method'] == 'dhcp': c = netplan_config.setdefault('network', {}).setdefault('ethernets', {}).setdefault(iface, {}) self.parse_dns_options(config['options'], c) self.parse_hwaddress(iface, config['options'], c) if config['options']: logging.error('%s: option(s) %s are not supported for dhcp method', iface, ", ".join(config['options'].keys())) sys.exit(2) if family == 'inet': c['dhcp4'] = True else: assert family == 'inet6' c['dhcp6'] = True elif config['method'] == 'static': c = netplan_config.setdefault('network', {}).setdefault('ethernets', {}).setdefault(iface, {}) if 'addresses' not in c: c['addresses'] = [] self.parse_dns_options(config['options'], c) self.parse_mtu(iface, config['options'], c) self.parse_hwaddress(iface, config['options'], c) # ipv4 if family == 'inet': # Already handled: mtu, hwaddress # Supported: address netmask gateway # Not supported yet: metric(?) # No YAML support: pointopoint scope broadcast supported_opts = set(['address', 'netmask', 'gateway']) unsupported_opts = set(['broadcast', 'metric', 'pointopoint', 'scope']) opts = set(config['options'].keys()) bad_opts = opts - supported_opts if bad_opts: for unsupported in bad_opts.intersection(unsupported_opts): logging.error('%s: unsupported %s option "%s"', iface, family, unsupported) sys.exit(2) for unknown in bad_opts - unsupported_opts: logging.error('%s: unknown %s option "%s"', iface, family, unknown) sys.exit(2) # the address may contain a /prefix suffix, or # the netmask property may be used. It's not clear # what happens if both are supplied. if 'address' not in config['options']: logging.error('%s: no address supplied in static method', iface) sys.exit(2) if '/' in config['options']['address']: addr_spec = config['options']['address'].split('/')[0] net_spec = config['options']['address'] else: if 'netmask' not in config['options']: logging.error('%s: address does not specify prefix length, and netmask not specified', iface) sys.exit(2) addr_spec = config['options']['address'] net_spec = config['options']['address'] + '/' + config['options']['netmask'] try: ipaddr = ipaddress.IPv4Address(addr_spec) except ipaddress.AddressValueError as a: logging.error('%s: error parsing "%s" as an IPv4 address: %s', iface, addr_spec, a) sys.exit(2) try: ipnet = ipaddress.IPv4Network(net_spec, strict=False) except ipaddress.NetmaskValueError as a: logging.error('%s: error parsing "%s" as an IPv4 network: %s', iface, net_spec, a) sys.exit(2) c['addresses'] += [str(ipaddr) + '/' + str(ipnet.prefixlen)] if 'gateway' in config['options']: # validate? c['gateway4'] = config['options']['gateway'] # ipv6 else: assert family == 'inet6' # Already handled: mtu, hwaddress # supported: address netmask gateway # partially supported: accept_ra (0/1 supported, 2 has no YAML rep) # unsupported: metric(?) # no YAML representation: media autoconf privext scope # preferred-lifetime dad-attempts dad-interval supported_opts = set(['address', 'netmask', 'gateway', 'accept_ra']) unsupported_opts = set(['metric', 'media', 'autoconf', 'privext', 'scope', 'preferred-lifetime', 'dad-attempts', 'dad-interval']) opts = set(config['options'].keys()) bad_opts = opts - supported_opts if bad_opts: for unsupported in bad_opts.intersection(unsupported_opts): logging.error('%s: unsupported %s option "%s"', iface, family, unsupported) sys.exit(2) for unknown in bad_opts - unsupported_opts: logging.error('%s: unknown %s option "%s"', iface, family, unknown) sys.exit(2) # the address may contain a /prefix suffix, or # the netmask property may be used. It's not clear # what happens if both are supplied. if 'address' not in config['options']: logging.error('%s: no address supplied in static method', iface) sys.exit(2) if '/' in config['options']['address']: addr_spec = config['options']['address'].split('/')[0] net_spec = config['options']['address'] else: if 'netmask' not in config['options']: logging.error('%s: address does not specify prefix length, and netmask not specified', iface) sys.exit(2) addr_spec = config['options']['address'] net_spec = config['options']['address'] + '/' + config['options']['netmask'] try: ipaddr = ipaddress.IPv6Address(addr_spec) except ipaddress.AddressValueError as a: logging.error('%s: error parsing "%s" as an IPv6 address: %s', iface, addr_spec, a) sys.exit(2) try: ipnet = ipaddress.IPv6Network(net_spec, strict=False) except ipaddress.NetmaskValueError as a: logging.error('%s: error parsing "%s" as an IPv6 network: %s', iface, net_spec, a) sys.exit(2) c['addresses'] += [str(ipaddr) + '/' + str(ipnet.prefixlen)] if 'gateway' in config['options']: # validate? c['gateway6'] = config['options']['gateway'] if 'accept_ra' in config['options']: if config['options']['accept_ra'] == '0': c['accept_ra'] = False elif config['options']['accept_ra'] == '1': c['accept_ra'] = True elif config['options']['accept_ra'] == '2': logging.error('%s: netplan does not support accept_ra=2', iface) sys.exit(2) else: logging.error('%s: unexpected accept_ra value "%s"', iface, config['options']['accept_ra']) sys.exit(2) else: # pragma nocover # this should be unreachable logging.error('%s: method %s is not supported', iface, config['method']) sys.exit(2) if_config = os.path.join(self.root_dir or '/', 'etc/network/interfaces') if netplan_config: netplan_config['network']['version'] = 2 netplan_yaml = yaml.dump(netplan_config) if self.dry_run: print(netplan_yaml) else: dest = os.path.join(self.root_dir or '/', 'etc/netplan/10-ifupdown.yaml') try: os.makedirs(os.path.dirname(dest)) except FileExistsError: pass try: with open(dest, 'x') as f: f.write(netplan_yaml) except FileExistsError: logging.error('%s already exists; remove it if you want to run the migration again', dest) sys.exit(3) logging.info('migration complete, wrote %s', dest) else: logging.warning('ifupdown does not configure any interfaces, nothing to migrate') if not self.dry_run: logging.info('renaming %s to %s.netplan-converted', if_config, if_config) os.rename(if_config, if_config + '.netplan-converted') def _ifupdown_lines_from_file(self, rootdir, path): '''Return normalized lines from ifupdown config This resolves "source" and "source-directory" includes. ''' def expand_source_arg(rootdir, curdir, line): arg = line.split()[1] if arg.startswith('/'): return rootdir + arg else: return curdir + '/' + arg lines = [] rootdir_len = len(rootdir) + 1 try: with open(rootdir + '/' + path) as f: logging.debug('reading %s', f.name) for line in f: # normalize, strip empty lines and comments line = line.strip() if not line or line.startswith('#'): continue if line.startswith('source-directory '): valid_re = re.compile('^[a-zA-Z0-9_-]+$') d = expand_source_arg(rootdir, os.path.dirname(f.name), line) for f in os.listdir(d): if valid_re.match(f): lines += self._ifupdown_lines_from_file(rootdir, os.path.join(d[rootdir_len:], f)) elif line.startswith('source '): for f in glob(expand_source_arg(rootdir, os.path.dirname(f.name), line)): lines += self._ifupdown_lines_from_file(rootdir, f[rootdir_len:]) else: lines.append(line) except FileNotFoundError: logging.debug('%s/%s does not exist, ignoring', rootdir, path) return lines def parse_ifupdown(self, rootdir='/'): '''Parse ifupdown configuration. Return (iface_name → family → {method, options}, auto_ifaces: set) tuple on successful parsing, or a ValueError when encountering an invalid file or ifupdown features which are not supported (such as "mapping"). options is itself a dictionary option_name → value. ''' # expected number of fields for every possible keyword, excluding the keyword itself fieldlen = {'auto': 1, 'allow-auto': 1, 'allow-hotplug': 1, 'mapping': 1, 'no-scripts': 1, 'iface': 3} # read and normalize all lines from config, with resolving includes lines = self._ifupdown_lines_from_file(rootdir, '/etc/network/interfaces') ifaces = OrderedDict() auto = set() in_options = None # interface name if parsing options lines after iface stanza in_family = None # we now have resolved all includes and normalized lines for line in lines: fields = line.split() try: # does the line start with a known stanza field? exp_len = fieldlen[fields[0]] logging.debug('line fields %s (expected length: %i)', fields, exp_len) in_options = None # stop option line parsing of iface stanza in_family = None except KeyError: # no known stanza field, are we in an iface stanza and parsing options? if in_options: logging.debug('in_options %s, parsing as option: %s', in_options, line) ifaces[in_options][in_family]['options'][fields[0]] = line.split(maxsplit=1)[1] continue else: raise ValueError('Unknown stanza type %s' % fields[0]) # do we have the expected #parameters? if len(fields) != exp_len + 1: raise ValueError('Expected %i fields for stanza type %s but got %i' % (exp_len, fields[0], len(fields) - 1)) # we have a valid stanza line now, handle them if fields[0] in ('auto', 'allow-auto', 'allow-hotplug'): auto.add(fields[1]) elif fields[0] == 'mapping': raise ValueError('mapping stanza is not supported') elif fields[0] == 'no-scripts': pass # ignore these elif fields[0] == 'iface': if fields[2] not in ('inet', 'inet6'): raise ValueError('Unknown address family %s' % fields[2]) if fields[3] not in ('loopback', 'static', 'dhcp'): raise ValueError('Unsupported method %s' % fields[3]) in_options = fields[1] in_family = fields[2] ifaces.setdefault(fields[1], OrderedDict())[in_family] = {'method': fields[3], 'options': {}} else: raise NotImplementedError('stanza type %s is not implemented' % fields[0]) # pragma nocover logging.debug('final parsed interfaces: %s; auto ifaces: %s', ifaces, auto) return (ifaces, auto) PK ! Fﱗ� � netplan/cli/commands/__init__.pynu �[��� #!/usr/bin/python3 # # Copyright (C) 2018 Canonical, Ltd. # Author: Mathieu Trudel-Lapierre <mathieu.trudel-lapierre@canonical.com> # # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation; version 3. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty 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, see <http://www.gnu.org/licenses/>. from netplan.cli.commands.apply import NetplanApply from netplan.cli.commands.generate import NetplanGenerate from netplan.cli.commands.ip import NetplanIp from netplan.cli.commands.migrate import NetplanMigrate from netplan.cli.commands.try_command import NetplanTry from netplan.cli.commands.info import NetplanInfo from netplan.cli.commands.set import NetplanSet from netplan.cli.commands.get import NetplanGet from netplan.cli.commands.sriov_rebind import NetplanSriovRebind from netplan.cli.commands.status import NetplanStatus __all__ = [ 'NetplanApply', 'NetplanGenerate', 'NetplanIp', 'NetplanMigrate', 'NetplanTry', 'NetplanInfo', 'NetplanSet', 'NetplanGet', 'NetplanSriovRebind', 'NetplanStatus', ] PK ! ��6 & & 6 netplan/cli/commands/__pycache__/apply.cpython-310.pycnu �[��� o � ed�O � @ s� d Z ddlZddlZddlZddlZddlZddlZddlZddlZddl m m Z ddl m Z mZ ddlmZ ddlmZmZ dZdZG dd � d e j�ZdS ) znetplan apply command line� N)� ConfigManager�ConfigurationError)�apply_sriov_config)�OvsDbServerNotRunning�apply_ovs_cleanupznetplan-ovs-cleanup.service� c sx e Zd Z� fdd�Zdd� Zddd �Zed d � �Zeg fd d ��Zede fdd��Z eddd��Z eddd��Z � Z S )� NetplanApplyc s( t � jdddd� d| _d| _d | _d S )N�applyz.Apply current netplan config to running systemT)� command_id� description�leafF)�super�__init__� sriov_only�only_ovs_cleanup�state��self�� __class__� �0/usr/share/netplan/netplan/cli/commands/apply.pyr , s � zNetplanApply.__init__c C sP | j jdddd� | j jdddd� | j jddd � | j| _| �� | �� d S ) Nz --sriov-only� store_truez0Only apply SR-IOV related configuration and exit)�action�helpz--only-ovs-cleanupz1Only clean up old OpenVSwitch interfaces and exitz--statez0Directory containing previous YAML configuration)r )�parser� add_argument� command_apply�func� parse_args� run_commandr r r r �run4 s � �� zNetplanApply.runTFNc & C s t � }|r|| _| jrt�||� d S | jr t�|dd|� d S dtjv r[t � d�}|d u r2t d��t � |ddddd dd g�}|d krY|rKt�|� n|d krStd ��t d| ��d S d}tt�d��} t�d�} || v rr| �|� t| �} t�d�} t�| t�� �} t| �}g }d }dtjv r�|�ddg� t j}|�t�� � |r�t j ||d�d kr�|r�t�tj � nt d��t�� }tt�d��}|s�| r�d}t�d�}||v r�|�|� t|�}|s�| r�d}t�d�}| � t�||�� t|�}|s�|r�d}|�rt� � |�r)t �!d� t�|| ||� dg}t�"d��r |�#d d� tj$d ||d � nt �!d � |�rft �!d � t�%� �re|D ] }|| v�rF�q=z t�&d d!|g� W �q= t j'�y] Y �q=w tj(d |d � nt �!d"� t�� }|�)� t�*||�}| j�r�t | j�}|�)� |j+�,� }|j+�,� } t�-|| |� t�� }|D ]<}t �!d#|� z"t j.d$d%d&d'| gt j/t j/d(� t j.d$d)d'| gt j/t j/d(� W �q� t j'�y� t �!d*|� Y �q�w t�� } |�0� D ]X\} } | �1d+�} | �r9t2| �t3k�r t �4d,�5| | �� �q�| |v �r| | v �rt �!d-�5| | �� �q�t j.d.d/d0d1| d2gt j/t j/d(� t j.d.d/d0d1| d+| �1d+�gt j/t j/d(� �q�t �.g d3�� t �.d$d4g� t�||� tj6�7d5��r]t�$d6d7g� |�r�d8d9� t�d:�D �}!d;d9� t�d<�D �}"z t�8� t�9t�:� � W n t j'�y� t �4d=� tj$d>d?gdd � Y nw tj$d6t;gdd � tj$d6|!|" dd � |�rt�||�D ]} t�<| � �q�t j=d@ddA� tj(d6|d � |�rg dB�}#t>dC�D ],}$t j?|#dddD�}%|%j@dEk�r�tA�BdF� �q�dGtC|%jD�v �r� d S tA�BdH� �q�d S d S d S )INF�SNAP�busctlzmissing busctl utility�callz--quietz--systemzio.netplan.Netplanz/io/netplan/Netplan�Applyr � z'failed to communicate with dbus servicez1failed to communicate with dbus service: error %sz//run/systemd/system/netplan-ovs-cleanup.servicez /run/systemd/network/*netplan-*z!/run/systemd/system/netplan-ovs-*z0/run/NetworkManager/system-connections/netplan-*�NETPLAN_PROFILE�valgrindz--leak-check=full)�stderrz(the configuration could not be generatedTzDnetplan generated networkd configuration changed, reloading networkdznetplan-wpa-*.serviceznetplan-wpa@*.service�stop)�syncz2no netplan generated networkd configuration existsz9netplan generated NM configuration changed, restarting NM�device� disconnectz,no netplan generated NM configuration existsz%netplan triggering .link rules for %s�udevadmz test-builtin�net_setup_linkz/sys/class/net/)�stdoutr) �testz#Ignoring device without syspath: %s�namez5Interface name {} is too long. {} will not be renamedz+Interface rename {} -> {} already happened.�ip�link�set�dev�down)r. �triggerz--attr-match=subsystem=net�settlez*/run/systemd/system/netplan-regdom.service�startznetplan-regdom.servicec S s g | ]}t j�|��qS r )�os�path�basename��.0�fr r r � <listcomp> s z.NetplanApply.command_apply.<locals>.<listcomp>z1/run/systemd/system/*.wants/netplan-wpa-*.servicec S s& g | ]}|� d t �stj�|��qS )�/)�endswith�OVS_CLEANUP_SERVICEr; r< r= r> r r r rA s �z1/run/systemd/system/*.wants/netplan-ovs-*.servicez:Falling back to a hard restart of systemd-networkd.service�restartzsystemd-networkd.servicez/run/NetworkManager/devices)� ignore_errors)�nmcli�general�status� )�capture_output�text� � z connectedg �?)Er r r r �process_sriov_configr �process_ovs_cleanupr; �environ�shutil�which� RuntimeError� subprocessr$ �sys�exit�PermissionError�bool�glob�remove�utils� nm_interfaces� netifaces� interfaces�extend�STDOUT�append�get_generator_path� EX_CONFIGr �update�systemctl_daemon_reload�logging�debug�systemctl_is_active�insert� systemctl� nm_runningrG �CalledProcessError�systemctl_network_manager�parse�process_link_changes�virtual_interfaces�keys�clear_virtual_links� check_call�DEVNULL�items�get�len� IF_NAMESIZE�warning�formatr< �exists�networkctl_reload�networkctl_reconfigure�networkd_interfacesrD � ip_addr_flush�rmtree�ranger! � returncode�time�sleep�strr0 )&r � run_generater+ � exit_on_error� state_dir�config_managerr# �res�ovs_cleanup_service�old_files_networkd� old_ovs_glob� old_files_ovs� old_nm_glob� nm_ifaces� old_files_nm�generator_call� generate_out�devices�restart_networkd�restart_ovs_glob� restart_ovs�restart_nm_glob� restart_nm� wpa_servicesr, �changes�cm� prev_links� curr_links�devices_after_udev�iface�settings�new_name� netplan_wpa� netplan_ovs�cmd�_�outr r r r A s\ � �� �� ��� �� � ��� � � zNetplanApply.command_applyc C sV | D ]&}|� � D ] \}}t|�turq|�dg �}|D ] }||kr& dS qqqdS )zp Is this physical interface a member of a 'composite' virtual interface? (bond, bridge) r_ TF)rv �type�dictrw )� composites�phy� compositer� r� �membersr� r r r �is_composite_member8 s ���z NetplanApply.is_composite_memberc C s� |s t �d� g S tt| �t|� �}tt|��|��}|D ]"}zdddd|g}t�|� W q tjy@ t �d�|�� Y q w |S )a% Calculate the delta of virtual links. And remove the links that were dropped from the YAML config, if they were not dropped by the backend already. We can make use of the netplan netdef ids, as those equal the interface name for virtual links. z;Cannot clear virtual links: no network interfaces provided.r3 r4 �deleter6 z Could not delete interface {}) rg rz �listr5 � intersectionrU rt rm r{ )r� r� r� �dropped_interfaces�interfaces_to_clearr4 r� r r r rs I s �z NetplanApply.clear_virtual_linksr� c C s� i }|j |jg}|j�� D ]Q}|j}|sq |jsq t�||j�r*t � d� |j�� q t � | |�}|s<t �d� |j�� q ||krIt � d� |�� q |jrXt �d� |j||�� q d|i||< q t � d� |�� |S )z� Go through the pending changes and pick what needs special handling. Only applies to non-critical interfaces which can be safely updated. z Skipping composite member {}z,Cannot find unique matching interface for {}z&Skipping correctly named interface: {}zLCannot rename {} ({} -> {}) at runtime (needs reboot), due to being criticalr2 zLink changes: {})�bridges�bonds�physical_interfaces�values�set_name� has_matchr r� �idrg rh r{ r\ �find_matching_ifacerz �critical)r_ r� r� �composite_interfaces�netdef�newname�current_iface_namer r r rp c s4 �z!NetplanApply.process_link_changesc C sb zt | � W d S tjy0 } z t�t|�� |r%t�d� W Y d }~d S W Y d }~d S d }~ww )NrN )r r\ � config_errorsrg �errorr� rV rW )r� r� �er r r rO � s ���z!NetplanApply.process_sriov_configc C s� z t | ||� W d S ttfy3 } z t�t|�� |r(t�d� W Y d }~d S W Y d }~d S d }~w tyM } zt� d� |�� W Y d }~d S d }~ww )NrN z Cannot call Open vSwitch: {}.) r �OSErrorrT rg r� r� rV rW r rz r{ )r� �ovs_old� ovs_currentr� r� r r r rP � s �� ��z NetplanApply.process_ovs_cleanup)TFTN)T)�__name__� __module__� __qualname__r r! r � staticmethodr� rs r rp rO rP � __classcell__r r r r r * s x + r )�__doc__rg r; rV rZ rU rR r^ r� �netplan.cli.utils�clir\ �netplan.configmanagerr r �netplan.cli.sriovr �netplan.cli.ovsr r rD ry �NetplanCommandr r r r r �<module> s PK ! �!��� � = netplan/cli/commands/__pycache__/sriov_rebind.cpython-310.pycnu �[��� o � ed� � @ sH d Z ddlZddlm mZ ddlmZmZmZ G dd� dej �Z dS )z"netplan SR-IOV rebind command line� N)� PCIDevice�bind_vfs�_get_pci_slot_namec s, e Zd Z� fdd�Zdd� Zdd� Z� ZS )�NetplanSriovRebindc s t � jdddd� d S )N�rebindzKRebind SR-IOV virtual functions of given physical functions to their driverT)� command_id� description�leaf)�super�__init__��self�� __class__� �7/usr/share/netplan/netplan/cli/commands/sriov_rebind.pyr s �zNetplanSriovRebind.__init__c C s2 | j jdtdg dd� | j| _| �� | �� d S )N�netdevs�*z*Space separated list of PF interface names)�type�nargs�default�help)�parser� add_argument�str�command_rebind�func� parse_args� run_commandr r r r �run! s � zNetplanSriovRebind.runc C s\ | j D ](}t|�}t|�}|jst�d�|�� qt|j|j �}t� d�|t |��� qdS )zeBind virtual functions of SR-IOV devices to their corresponding driver after eswitch mode was changedz1{} does not seem to be a SR-IOV physical functionz{}: bound {} VFsN) r r r �is_pf�logging�warning�formatr �vfs�driver�info�len)r �iface�pci_addr�pcidev� bound_vfsr r r r ) s �z!NetplanSriovRebind.command_rebind)�__name__� __module__� __qualname__r r r � __classcell__r r r r r s r ) �__doc__r! �netplan.cli.utils�cli�utils�netplan.cli.sriovr r r �NetplanCommandr r r r r �<module> s PK ! 5s'�) �) 8 netplan/cli/commands/__pycache__/migrate.cpython-310.pycnu �[��� o ���d�O � @ s� d Z ddlZddlZddlZddlZddlmZ zddlZdZW n ey+ dZY nw ddl m Z ddl Z ddl m mZ G dd� dej�ZdS ) z netplan migrate command line� N)�globFT)� OrderedDictc sV e Zd Z� fdd�Zdd� Zdd� Zdd� Zd d � Zd d � Zd d� Z ddd�Z � Z S )�NetplanMigratec s t � jddddd� d S )N�migratez/Migration of /etc/network/interfaces to netplanT)� command_id� description�leaf�testing)�super�__init__��self�� __class__� �2/usr/share/netplan/netplan/cli/commands/migrate.pyr % s �zNetplanMigrate.__init__c C s� d|v r3d|vr i |d< d|d vrg |d d< |d � d�D ]}|s$q |d d |g7 < q |d= d|v rhd|vr?i |d< d|d vrKg |d d< |d � d�D ]}|sWqR|d d |g7 < qR|d= dS dS )z�Parse dns options (dns-nameservers and dns-search) from if_options (an interface options dict) into the interface configuration if_config Mutates the arguments in place. zdns-nameservers� nameservers� addresses� z dns-search�searchN)�split)r � if_options� if_config�ns�domainr r r �parse_dns_options+ s* �z NetplanMigrate.parse_dns_optionsc C s� d|v rFzt |d �}W n ty# t�d||d � t�d� Y nw d|v r=|d |ks=t�d|||d � t�d� ||d< |d= dS dS )z�Parse out the MTU. Operates the same way as parse_dns_options iface is the name of the interface, used only to print error messages �mtuz %s: cannot parse "%s" as an MTU� z0%s: tried to set MTU=%d, but already have MTU=%dN)�int� ValueError�logging�error�sys�exit)r �ifacer r r r r r � parse_mtuH s � �zNetplanMigrate.parse_mtuc C s\ d|v r,d|v r!|d |d ks!t �d||d |d � t�d� |d |d< |d= dS dS )z�Parse out the manually configured MAC. Operates the same way as parse_dns_options iface is the name of the interface, used only to print error messages � hwaddress� macaddressz0%s: tried to set MAC %s, but already have MAC %sr N)r r! r" r# )r r$ r r r r r �parse_hwaddress[ s � �z NetplanMigrate.parse_hwaddressc C sV | j jddd� | j jdddd� | j| _| �� tr%t�d� t� d � | � � d S ) Nz --root-dirzOSearch for and generate configuration files in this root directory instead of /)�helpz --dry-run� store_truezQPrint converted netplan configuration to stdout instead of writing/changing files)�actionr) z�The `yaml` Python package couldn't be imported, and is needed for the migrate command. To install it on Debian or Ubuntu-based system, run `apt install python3-yaml`� ) �parser� add_argument�command_migrate�func� parse_args�NO_YAMLr r! r" r# � run_commandr r r r �runj s � � zNetplanMigrate.runc C s i }z | � | jp d�\}}W n ty, } zt�t|�� t�d� W Y d }~nd }~ww |�� D �]9\}}|�� D �]/\}}t� d|||� ||vrVt�d|� t�d� |d dkrct� d|� q:|d dkr�|� d i �� d i �� |i �} | � |d | � | � ||d | � |d r�t�d |d � |d �� �� t�d� |dkr�d| d< q:|dks�J �d| d< q:|d dk�r\|� d i �� d i �� |i �} d| vr�g | d< | � |d | � | �||d | � | � ||d | � |dk�r�tg d��} tg d��} t|d �� �} | | } | �r5| �| �D ]}t�d|||� t�d� �q| | D ]}t�d|||� t�d� �q$d|d v�rGt�d|� t�d� d|d d v �rb|d d �d�d }|d d }n&d |d v�rtt�d |� t�d� |d d }|d d d |d d }zt�|�}W n! tj�y� } zt�d |||� t�d� W Y d }~nd }~ww z tj|d d!�}W n! tj�y� } zt�d"|||� t�d� W Y d }~nd }~ww | d t|�d t|j� g7 < d#|d v �r�|d d# | d$< q:|dk�sJ �tg d%��} tg d&��} t|d �� �} | | } | �rK| �| �D ]}t�d|||� t�d� �q%| | D ]}t�d|||� t�d� �q:d|d v�r]t�d|� t�d� d|d d v �rx|d d �d�d }|d d }n&d |d v�r�t�d |� t�d� |d d }|d d d |d d }zt�|�}W n! tj�y� } zt�d'|||� t�d� W Y d }~nd }~ww z tj|d d!�}W n! tj�y� } zt�d(|||� t�d� W Y d }~nd }~ww | d t|�d t|j� g7 < d#|d v �r|d d# | d)< d*|d v �r[|d d* d+k�r(d | d*< q:|d d* d,k�r6d| d*< q:|d d* d-k�rKt�d.|� t�d� q:t�d/||d d* � t�d� q:t�d0||d � t�d� q:q1tj � | j�ptdd1�}|�r�d|d d2< t � |�}| j �r�t |� n`tj � | j�p�dd3�}z t�!tj �"|�� W n t#�y� Y nw z t$|d4�� }|�%|� W d � n 1 �s�w Y W n t#�y� t�d5|� t�d6� Y nw t�&d7|� nt�'d8� | j �st�&d9||� t�(||d: � d S d S );N� r zConverting %s family %s %sz.%s: non-automatic interfaces are not supported�method�loopbackz Ignoring loopback interface %s�dhcp�network� ethernets�optionsz2%s: option(s) %s are not supported for dhcp methodz, �inetT�dhcp4�inet6�dhcp6�staticr )�address�netmask�gateway)� broadcast�metric� pointopoint�scopez %s: unsupported %s option "%s"z%s: unknown %s option "%s"rA z(%s: no address supplied in static method�/r rB zE%s: address does not specify prefix length, and netmask not specifiedz-%s: error parsing "%s" as an IPv4 address: %sF)�strictz-%s: error parsing "%s" as an IPv4 network: %srC �gateway4)rA rB rC � accept_ra)rE �media�autoconf�privextrG zpreferred-lifetimez dad-attemptsz dad-intervalz-%s: error parsing "%s" as an IPv6 address: %sz-%s: error parsing "%s" as an IPv6 network: %s�gateway6rK �0�1�2z(%s: netplan does not support accept_ra=2z#%s: unexpected accept_ra value "%s"z %s: method %s is not supportedzetc/network/interfaces�versionz etc/netplan/10-ifupdown.yaml�xzC%s already exists; remove it if you want to run the migration again� z migration complete, wrote %sz>ifupdown does not configure any interfaces, nothing to migratez#renaming %s to %s.netplan-convertedz.netplan-converted))�parse_ifupdown�root_dirr r r! �strr" r# �items�debug� setdefaultr r( �join�keysr% �set� intersectionr � ipaddress� IPv4Address�AddressValueError� IPv4Network�NetmaskValueError� prefixlen� IPv6Address� IPv6Network�os�path�yaml�dump�dry_run�print�makedirs�dirname�FileExistsError�open�write�info�warning�rename)r �netplan_config�ifaces� auto_ifaces�er$ � family_config�family�config�c�supported_opts�unsupported_opts�opts�bad_opts� unsupported�unknown� addr_spec�net_spec�ipaddr�a�ipnetr � netplan_yaml�dest�fr r r r/ x sL �� � � ����$� � ����$ � � �� ( � �� � �z NetplanMigrate.command_migratec C s\ dd� }g }t |�d }z�t|d | ��}}t�d|j� |D ]i}|�� }|r,|�d�r-q |�d�rat�d�}||t j � |j�|�} t � | �D ]}|� |�r_|| �|t j �| |d � |��7 }qGq |�d �r�t||t j � |j�|��D ]}|| �|||d � �7 }qsq |�|� q W d � W |S 1 s�w Y W |S ty� t�d ||� Y |S w ) zvReturn normalized lines from ifupdown config This resolves "source" and "source-directory" includes. c S s* |� � d }|�d�r| | S |d | S )Nr, rH )r � startswith)�rootdir�curdir�line�argr r r �expand_source_argG s zCNetplanMigrate._ifupdown_lines_from_file.<locals>.expand_source_argr, rH z reading %s�#zsource-directory z^[a-zA-Z0-9_-]+$Nzsource z %s/%s does not exist, ignoring)�lenrq r rZ �name�stripr� �re�compilerh ri ro �listdir�match�_ifupdown_lines_from_filer\ r �append�FileNotFoundError) r r� ri r� �lines� rootdir_lenr� r� �valid_re�dr r r r� B s@ "�� � � �� ��z(NetplanMigrate._ifupdown_lines_from_filerH c C s� ddddddd�}| � |d�}t� }t� }d}d}|D ]�}|�� } z|| d } t�d| | � d}d}W n, ty` |rXt�d||� |jdd �d || | d | d < Y qtd | d ��w t| �| d krxtd | | d t| �d f ��| d d v r�|� | d � q| d dkr�td��| d dkr�q| d dkr�| d dvr�td| d ��| d dvr�td| d ��| d }| d }| d i d�|� | d t� �|< qt d| d ��t�d||� ||fS )uW Parse ifupdown configuration. Return (iface_name → family → {method, options}, auto_ifaces: set) tuple on successful parsing, or a ValueError when encountering an invalid file or ifupdown features which are not supported (such as "mapping"). options is itself a dictionary option_name → value. r, rU )�auto� allow-auto� allow-hotplug�mapping� no-scriptsr$ z/etc/network/interfacesNr z$line fields %s (expected length: %i)z$in_options %s, parsing as option: %s)�maxsplitr; zUnknown stanza type %sz0Expected %i fields for stanza type %s but got %i)r� r� r� r� z mapping stanza is not supportedr� r$ r )r< r> zUnknown address family %s)r7 r@ r8 zUnsupported method %s)r6 r; z!stanza type %s is not implementedz,final parsed interfaces: %s; auto ifaces: %s) r� r r^ r r rZ �KeyErrorr r� �addr[ �NotImplementedError) r r� �fieldlenr� rw r� � in_options� in_familyr� �fields�exp_lenr r r rV h sR $� � "z NetplanMigrate.parse_ifupdown)rH ) �__name__� __module__� __qualname__r r r% r( r4 r/ r� rV � __classcell__r r r r r $ s K&r )�__doc__r rh r" r� r rj r2 � ImportError� collectionsr r` �netplan.cli.utils�cli�utils�NetplanCommandr r r r r �<module> s � PK ! �*�AxJ xJ 7 netplan/cli/commands/__pycache__/status.cpython-310.pycnu �[��� o ���d�k � @ s( d Z ddlZddlZddlZddlZddlZddlZddlZddlm Z m Z m Z m Z ddl Z ddlZddlm mZ e e edf e d eeeee d f Ze�d�ZdZz ddlmZ ddl m Z dd l m Z G d d � d e �Z d ZW n e!y� e�"d � Y nw G dd� d�Z#G dd� dej$�Z%dS )znetplan status command line� N)�Union�Dict�List�Type�JSONz\[([a-z0-9]+)\].*\[\/\1\]F)�Console)�RegexHighlighter)�Themec @ s e Zd ZdZddgZdS )�NetplanHighlighterznetplan.z"(^|[\s\/])(?P<int>\d+)([\s:]?\s|$)z(?P<str>(\"|\').+(\"|\'))N)�__name__� __module__� __qualname__� base_style� highlights� r r �1/usr/share/netplan/netplan/cli/commands/status.pyr , s �r Tz4python3-rich not found, falling back to plain outputc @ s e Zd Zdedefdd�Zg g ddfdedededed ef d d �Zd edefd d�Z dedefdd�Z defdd�Z e de fdd��Ze de fdd��Ze defdd��Ze defdd��Ze defd d ��Ze defd d ��Ze defd d!��Ze defd"d#��Ze defd$d%��Zd&S )'� Interface�ip�returnc C s$ t |�dd� }�dkr|�� S dS )z� Extract the MAC address if it's set inside the JSON data and seems to have the correct format. Return 'None' otherwise. �address� � N)�len�get�lower)�selfr r r r r � __extract_mac8 s zInterface.__extract_mac)NN�nd_data�nm_data� resolved_data� route_datac sb |� dd�� _|� dd�� _d|� dg �v rdnd� _|� dd��� � _� �|�� _|p-g }t� fd d �|D �d �� _ t� fd d �|D �d �� _ d � _ |d r~g � _ |d D ]'}t |d �t � j�kr}|d }|d }� j � t�|d�dd� |D ���� qVd � _|d r�g � _|d D ]} t | d �t � j�kr�� j� t| d �� q�g } d � _|d r�| |d 7 } |d r�| |d 7 } | �r#g � _| D ]]} | � d�� jk�r"d| � d�i} | � d�} | r�| | d< | � d�} | r�| | d< | � d�} | r�| | d< | � d�} | �r| | d< | � d�} | �r| | d< | � d �} | �r | | d < � j� | � q�d � _|� d � }�r�g � _|D ]]}g }t�|d �j�rE|� d � � j�rr� jD ]%}d|v �rpt�|d �t�|d �k�rp|d d k�rp|� d � n�qL|d �� }|d!|d" ii} |�r�|| | d< � j� | � �q3d � _|� d#i �� d$� }�r�|�� � _� �� j��p�d%� _ d S )&N�ifindex����ifname�unknown�UP�flags�DOWN� operstatec 3 �" � | ] }|d � j kr|V qdS )�IndexN)�idx��.0�x�r r r � <genexpr>K � � z%Interface.__init__.<locals>.<genexpr>c 3 r) )�deviceN)�namer, r/ r r r0 L r1 r � � � c S s g | ]}|� d d��qS )r4 �big)�to_bytes)r- �vr r r � <listcomp>V � z&Interface.__init__.<locals>.<listcomp>�dev�to�dst�gateway�via�prefsrc�from�metric�type�scope�protocol� addr_info�local�link�dhcp�prefix� prefixlen�linkinfo� info_kindr ) r r+ r3 � adminstate�upperr( �_Interface__extract_mac� macaddress�next�nd�nm� dns_addresses�int�append�socket� inet_ntop�join� dns_search�str�routes� addresses� ipaddress� ip_address� is_link_localr � iproute_type�strip�query_networkctl� _networkctl)r r r r r r �itr�ipfamily�dnsr9 �_routes�obj�elem�valrG �addrr& �route�ip_addrrN r r/ r �__init__A s� $� � � � zInterface.__init__�con_namec C sb d }zt �ddddd|g�}|�� W S ty0 } zt�d�|t|��� W Y d }~|S d }~ww )Nz --get-valuesz802-11-wireless.ssid�con�show�idz+Cannot query NetworkManager SSID for {}: {})�utils� nmcli_outrd � Exception�logging�warning�formatr] )r rr �ssid�er r r � query_nm_ssid� s � ���zInterface.query_nm_ssidr# c C s^ d }zt jddd|gdd�}W |S ty. } zt�d�|t|��� W Y d }~|S d }~ww )N� networkctl�statusz--T��textz"Cannot query networkctl for {}: {})� subprocess� check_outputrx ry rz r{ r] )r r# �outputr} r r r re � s ����zInterface.query_networkctlc C s� | j | j| jd�}| jr| j|d< | jr| j|d< | jr!| j|d< | jr)| j|d< | jr1| j|d< | jr9| j|d< | j rA| j |d< | j rI| j |d < | j rQ| j |d < | j rY| j |d < | j ra| j |d < | jri| j|d < | j|fS )N)�indexrO r( rD r| � tunnel_mode�backendru rR �vendorr_ rV r\ r^ �activation_mode)r+ rO r( rD r| r� r� � netdef_idrR r� r_ rV r\ r^ r� r3 )r �jsonr r r r� � s: � zInterface.jsonc C � | j dko | jdkS )Nr% �rO r( r/ r r r �up� � z Interface.upc C r� )Nr' r� r/ r r r �down� r� zInterface.downc C s` t ddddddddddddddd��}| jr | j�d �nd }||v r&|| S t�d �|�� d S ) N�bond�bridge�ethernet�tunnel�wifi�modem�vrf)r� r� �ether�ipgre�ip6gre�loopback�sitr� �tunnel6� wireguard�wlan�wwanr� �vxlanr zUnknown device type: {})�dictrT r ry rz r{ )r �match�nd_typer r r rD � s* �zInterface.typec C s | j dkr | jr | jS d S )Nr� )rD rc r/ r r r r� � s zInterface.tunnel_modec C sN | j rd| j �dd�vrd| j �dd�v rdS | jr%d| j�dd�v r%d S d S ) N� unmanaged� SetupStater � run/systemd/network/10-netplan-� NetworkFile�networkd�.run/NetworkManager/system-connections/netplan-�filename�NetworkManager)rT r rU r/ r r r r� � s zInterface.backendc C s� | j dkr| j�dd��d�d �d�d S | j dkrK| j�d d��d �d �d �d }| j�d d�d krI| �| j�d��}|rI|�d| �d }|S d S )Nr� r� r r� r4 z.networkr r� r� r� z .nmconnectionrD z802-11-wirelessr3 �-)r� rT r �splitrU r~ )r �netdefr| r r r r� � s, ��� ���zInterface.netdef_idc C s, | j rd| j v r| j d r| j d �� S d S )N�Vendor)rT rd r/ r r r r� s zInterface.vendorc C sb | j dkr/| j�� D ]$}|�� }d}|�|�r.|t|�td� � �� }|r*| S d S q d S )Nr� zWiFi access point: z (xB:SS:ID:xx:xx:xx))rD rf � splitlinesrd � startswithr )r �line�keyr| r r r r| s �zInterface.ssidc C s� | j dkr0| j�� D ]#}|�� }d}|�|�r-|t|�d � �� }|dkr)| S d S q d S | j dkr@| jd dkr>dS d S d S )Nr� zActivation Policy: r� r� � autoconnect�no�manual)r� rf r� rd r� r rU )r r� r� �moder r r r� s � �zInterface.activation_modeN)r r r r� r] rQ r �tuplerq r~ re r� �property�boolr� r� rD r� r� r� r� r| r� r r r r r 7 s< �� �X r c s� e Zd Z� fdd�Zdd� Zdefdd�Zdedefd d �Z d e de fd d �Z de fdd�Z de fdd�Zde fdd�Zde fdd�Zde fdd�Zdefdd�Zdefdd�Zd d � Zd%d e d edd fd!d"�Zd#d$� Z� ZS )&� NetplanStatusc s t � jdddd� d| _d S )Nr� z,Query networking state of the running systemT)� command_id� description�leafF)�superrq �allr/ �� __class__r r rq 1 s � zNetplanStatus.__init__c C sZ | j jddtd dd� | j jddddd � | j jd d d d d� | j| _| �� | �� d S )Nr# �?zShow only this interface)�nargsrD �default�helpz-az--all� store_truez(Show all interface data (incl. inactive))�actionr� �-fz--format�tabularz2Output in machine readable `json` or `yaml` format)r� r� )�parser� add_argumentr] �command�func� parse_args� run_commandr/ r r r �run7 s � � � zNetplanStatus.runr c C s� g g d d�}zZt d��K}|�� }d|v rd|d< nd|v r!d|d< |g|�� D ]$}|�d�r=|d |�� d d � 7 < |�d �rL|�� d d � |d < q(W d � W |S 1 sYw Y W |S ty} } zt�d �t |��� W Y d }~|S d }~ww ) N)r_ �searchr� z/etc/resolv.confz/# This is /run/systemd/resolve/stub-resolv.conf�stubr� z*# This is /run/systemd/resolve/resolv.conf�compat� nameserverr_ r4 r� z!Cannot parse /etc/resolv.conf: {}) �open�readline� readlinesr� r� rx ry rz r{ r] )r �res�f� firstliner� r} r r r �resolvconf_jsonC s6 � �� ��� ��z NetplanStatus.resolvconf_json� interfacesc C s� |D ]A}|j rC|jrC|jrC|jrCg }|jD ]}t|�� �d \}}d|vs+d|d vr0|�|� qdd� |jD �}|rC|rC|jrC dS qdS )Nr r& rI c S s g | ] }|� d d�dkr|�qS )r= Nr� )r r, r r r r: d � z4NetplanStatus.query_online_state.<locals>.<listcomp>TF)r� r_ r^ rV �list�itemsrX )r r� �itf� non_local_ipsrn r �extra�default_routesr r r �query_online_stateZ s ��z NetplanStatus.query_online_state� cmd_outputc C s t �|�S �N�r� �loads�r r� r r r �process_generici s z NetplanStatus.process_genericc C sb d }zt jg d�dd�}| �|�}W |S ty0 } zt�d�t|��� W Y d }~|S d }~ww )N)r �-d�-jrn Tr� z(Cannot query iproute2 interface data: {})r� r� r� rx ry �criticalr{ r] �r �datar� r} r r r �query_iproute2l � � � ��z NetplanStatus.query_iproute2c C s t �|�d S )N� Interfacesr� r� r r r �process_networkdv s z NetplanStatus.process_networkdc C sb d }zt jddgdd�}| �|�}W |S ty0 } zt�d�t|��� W Y d }~|S d }~ww )Nr z --json=shortTr� z(Cannot query networkd interface data: {})r� r� r� rx ry r� r{ r] r� r r r �query_networkdy r� z NetplanStatus.query_networkdc C sd g }|� � D ])}|�d�}|d r|d nd }|r/|�||d |d |d |d |d d�� q|S ) N�:r r4 r5 � � � )r2 r3 �uuidr� rD r� )r� r� rX )r r� r� r� r� r< r r r � process_nm� s ��zNetplanStatus.process_nmc C s^ d }zt �g d��}| �|�}W |S ty. } zt�d�t|��� W Y d }~|S d }~ww )N)z-tr� z*DEVICE,NAME,UUID,FILENAME,TYPE,AUTOCONNECTrs rt z.Cannot query NetworkManager interface data: {})rv rw r� rx ry �debugr{ r] r� r r r �query_nm� s � ��zNetplanStatus.query_nmc C s� d }d }z!t jg d�dd�}| �|�}t jg d�dd�}| �|�}W ||fS tyD } zt�d�t|��� W Y d }~||fS d }~ww )N)r r� r� ro Tr� )r r� r� z-6ro z$Cannot query iproute2 route data: {})r� r� r� rx ry r� r{ r] )r �data4�data6�output4�output6r} r r r � query_routes� s" � � � ��zNetplanStatus.query_routesc C s� d }d }z"t �� }|�dd�}t �|d�}|�d�}|d }|d }W ||fS tyE } zt�d�t |��� W Y d }~||fS d }~ww )Nzorg.freedesktop.resolve1z/org/freedesktop/resolve1z org.freedesktop.DBus.Propertiesz org.freedesktop.resolve1.Manager�DNS�Domainsz"Cannot query resolved DNS data: {}) �dbus� SystemBus� get_objectr �GetAllrx ry r� r{ r] )r r_ r� �ipc�resolve1� resolve1_ifr� r} r r r �query_resolved� s � ��z NetplanStatus.query_resolvedc O sh t |�r-t|�}t�|d �D ]}|d �d�|�d��d�|�d�|d< qt|i |��S t|i |��S )Nr z[{}]r z[/{}])r r� � MATCH_TAGS�findall�replacer{ �print)r �args�kwargs�lst�tagr r r � plain_print� s �zNetplanStatus.plain_printNr� �totalc & s� t rtdddddddd��}tt� ||d d �}|j}n| j}d }� �d i �}� fd d�� D �} |d| d jd|�dd �r?dndd�� |�di �} | �dg �} | �d�} | �dg �} | r�t| �D ] \}}|d| d j|dkrrd nd || r{d �| �nd d �� qa| r�t| �D ]\}}|d| d j|dkr�d nd |d�� q�|� | D �]\}� � �d!d"�d# � �d$d"� }d%}|d&kr�d'}d}n|d(kr�d)}d*}� �d+d,�}� �d-�}� �d.�}|d/kr�|r�|d0| d1 7 }n |d2kr�|r�|d#| 7 }|d3j|� �d4d5�|||� �d6d7�� �d8��rd9�� �d8��nd d:�� � �d;��r@|d| d< jd=� �d;d �� �d>��r;d �� �d>d ��nd d?�� � �dg �}|�r�t|�D ]U\}}t |� � �d \}}g }|�d@��ri|�d@g �}d }d } |�rudA|v �rydB}dC} |d| dD j|dk�r�dEnd ||�dFd �|�r�dGdH� |� dI nd || dJ�� �qM� �dKg �}|�r�t|�D ]\}}|d| d j|dk�r�d nd |d�� �q�� �dLg �}|�r�t|�D ]\}}|d| d j|dk�r�d nd |d�� �q �dMg �}|�r�t|�D ]�\}}d } d } |dN dOk�rdB} dC} d } dP|v �r dQ|dP } d } dR|v �r+dS|dR } d }!dT|v �r:dUt |dT � }!g }dV|v �rQ|dV dWk�rQ|dV }"|� |"� dX|v �rf|dX dYk�rf|dX }#|� |#� d+|v �r{|d+ dZk�r{|d+ }$|� |$� |d| d[ j|dk�r�d\nd |dN | | |!|�r�dGdH� |� dI nd | | d]�� �q�� �d^�}|�r�|d| d jd_|d�� |� q�|t| � }%|%dk�r�|d`�|%�� d S d S )aNz bold cyan�yellow�grey62z green boldzred boldz yellow bold�bold)z netplan.intz netplan.str�muted�online�offliner$ � highlightF)� highlighter�theme�width�emoji�18�netplan-global-statec s g | ] }|d kr|� | f�qS )r% r )r- r� �r� r r r: � r� z.NetplanStatus.pretty_print.<locals>.<listcomp>z{title:>z } {value}z Online state:r z[online]online[/online]z[offline]offline[/offline])�title�value� nameserversr_ r� r� z } {value}[muted]{mode}[/muted]r zDNS Addresses:r z ({}))r' r( r� z DNS Search:r( �UNKNOWN�/rO r$ zUP/UPr% z DOWN/DOWNr' r rD �otherr| r� r� z/"�"r� uU [{col}]●[/{col}] {idx:>2}: {name} {type} [{col}]{state}[/{col}] ({backend}{netdef})r� r� r� r� ru z: [highlight]{}[/highlight])�colr+ r3 rD �stater� r� rR z } {mac}[muted]{vendor}[/muted]z MAC Address:r� )r' �macr� r& rJ z [highlight]z [/highlight]z1} {start}{ip}/{prefix}{end}[muted]{extra}[/muted]z Addresses:rK z (z, �))r' r rK r� �start�endrV r\ r^ r= r� r@ z via rB z from rC z metric rF �kernelrE �global�unicastz:} {start}{to}{via}{src}{metric}{end}[muted]{extra}[/muted]zRoutes:)r' r= r@ �srcrC r� r2 r3 r� zActivation Mode:z7{} inactive interfaces hidden. Use "--all" to show all.)� RICH_OUTPUTr r r r r r r{ � enumerater� r� r[ r] rX r )&r r� r �_console_widthr! �console�pprint�pad� global_stater� �ns�dns_addr�dns_moder\ �irm r# r/ �scolor� full_typer| r� r rk r r� r& �highlight_start� highlight_end� default_start� default_endr@ r7 rC �protorE rD �hiddenr r& r � pretty_print� s2 � � � � � � � � � � � � �zNetplanStatus.pretty_printc s� t �d�s!t �d�rt�d� t�d� t�d� t �ddgd� �� � }�� � �|r-�s7t�d� t�d� �� � ��� � \���� � \� �� �����fdd �|D �}t|�}d d � |D �}��|�}�jrut�fd d �|D �d �g}d d � |D �}�jr�|g kr�t�d��j�� t�d� d|��� d�i}�jr�|n|}|D ] }|�� \} } | || < q��j�� } | dkr�ttj|d d�� d S | dkr�ttj|dd�� d S ��||� d S )Nzsystemd-networkd.servicez^'netplan status' depends on networkd, but systemd-networkd.service is masked. Please start it.r4 z3systemd-networkd.service is not active. Starting...r2 Tz,Could not query iproute2 or systemd-networkdc s$ g | ]}t |��� �f��f��qS r )r �r- r� )rV r\ r� �nmcli�route4�route6r r r: � s $ z)NetplanStatus.command.<locals>.<listcomp>c S s g | ] }|j d kr|�qS )r' )r( rL r r r r: � s c 3 s � | ] }|j � jkr|V qd S r� )r3 r# rL r/ r r r0 � s � z(NetplanStatus.command.<locals>.<genexpr>c S s g | ]}|d ur|�qS r� r )r- rl r r r r: � r; zCould not find interface {}r% )r r) r� )�indent�yamlF)�default_flow_style) rv �systemctl_is_active�systemctl_is_maskedry �error�sys�exitr� � systemctlr� r� r� r r r r� r# rS r{ r� r� r� r r �dumpsrQ �dumprK ) r �iproute2r� r �filtered� online_stater� �itf_iterr� r# rk � output_formatr )rV r\ r� rM rN rO r r r� l sN �� zNetplanStatus.commandr� )r r r rq r� r� r� r� r� r� r] r r� r� r� r� r� r� r� r r r rW rK r� � __classcell__r r r� r r� 0 s" )r� )&�__doc__r` r� ry �rerY r� rV �typingr r r r r rQ �netplan.cli.utils�clirv r] rW �floatr� r �compiler r8 � rich.consoler �rich.highlighterr � rich.themer r � ImportErrorr� r �NetplanCommandr� r r r r �<module> s6 & � zPK ! %]3+� � 9 netplan/cli/commands/__pycache__/generate.cpython-310.pycnu �[��� o � ed� � @ sT d Z ddlZddlZddlZddlZddlZddlm mZ G dd� dej �Z dS )z netplan generate command line� Nc s, e Zd Z� fdd�Zdd� Zdd� Z� ZS )�NetplanGeneratec s t � jdddd� d S )N�generatezFGenerate backend specific configuration files from /etc/netplan/*.yamlT)� command_id� description�leaf)�super�__init__��self�� __class__� �3/usr/share/netplan/netplan/cli/commands/generate.pyr s �zNetplanGenerate.__init__c C s< | j jddd� | j jddd� | j| _| �� | �� d S )N� --root-dirzOSearch for and generate configuration files in this root directory instead of /)�help� --mappingzFDisplay the netplan device ID/backend/interface name mapping and exit.)�parser� add_argument�command_generate�func� parse_args� run_commandr r r r �run% s �� zNetplanGenerate.runc C s� dt jv r3t�d�}|d u rtd��t�|ddddddd g�}|d kr1|d kr+td ��td | ��d S t� � g}| j rB|d| j g7 }| j rL|d| j g7 }t � d|� t�t�|�� d S )N�SNAP�busctlzmissing busctl utility�callz--quietz--systemzio.netplan.Netplanz/io/netplan/Netplan�Generater � z'failed to communicate with dbus servicez1failed to communicate with dbus service: error %sr r z command generate: running %s)�os�environ�shutil�which� RuntimeError� subprocessr �PermissionError�utils�get_generator_path�root_dir�mapping�logging�debug�sys�exit)r r �res�argvr r r r 0 s4 ��� z NetplanGenerate.command_generate)�__name__� __module__� __qualname__r r r � __classcell__r r r r r s r ) �__doc__r) r r+ r# r �netplan.cli.utils�clir% �NetplanCommandr r r r r �<module> s PK ! �ĉ�Z Z 9 netplan/cli/commands/__pycache__/__init__.cpython-310.pycnu �[��� o � ed� � @ s� d dl mZ d dlmZ d dlmZ d dlmZ d dlm Z d dl m Z d dl m Z d dlmZ d d lmZ d d lmZ g d �Zd S ) � )� NetplanApply)�NetplanGenerate)� NetplanIp)�NetplanMigrate)� NetplanTry)� NetplanInfo)� NetplanSet)� NetplanGet)�NetplanSriovRebind)� NetplanStatus) r r r r r r r r r r N)�netplan.cli.commands.applyr � netplan.cli.commands.generater �netplan.cli.commands.ipr � netplan.cli.commands.migrater � netplan.cli.commands.try_commandr �netplan.cli.commands.infor �netplan.cli.commands.setr �netplan.cli.commands.getr �!netplan.cli.commands.sriov_rebindr �netplan.cli.commands.statusr �__all__� r r �3/usr/share/netplan/netplan/cli/commands/__init__.py�<module> s PK ! <��y y 3 netplan/cli/commands/__pycache__/ip.cpython-310.pycnu �[��� o � edc � @ s� d Z ddlZddlZddlZddlZddlmZ ddlm mZ ddd�ddd�d �Z G d d � d ej �Z G d d � d ej �Z dS )znetplan ip command line� N)�CalledProcessErrorz#run/systemd/netif/leases/{lease_id}�ifindex)�pattern�methodz<var/lib/NetworkManager/internal-{lease_id}-{interface}.lease� nm_connection)�networkd�NetworkManagerc s$ e Zd Z� fdd�Zdd� Z� ZS )� NetplanIpc � t � jdddd� d S )N�ipz'Retrieve IP information from the systemF�� command_id� description�leaf��super�__init__��self�� __class__� �-/usr/share/netplan/netplan/cli/commands/ip.pyr * � �zNetplanIp.__init__c C sB t � | _| jjdddd�}|j| jj| jd� | �� | �� d S )N�leases�Display IP leasesF)�help�add_help)�func� commandclass)�NetplanIpLeases�command_leases� subparsers� add_parser� set_defaults�run� parse_args� run_command)r � p_ip_leasesr r r r% / s � z NetplanIp.run)�__name__� __module__� __qualname__r r% � __classcell__r r r r r ( s r c s, e Zd Z� fdd�Zdd� Zdd� Z� ZS )r c r )Nz ip leasesr Tr r r r r r r > r zNetplanIpLeases.__init__c C s< | j jddd� | j jddd� | j| _| �� | �� d S )N� interfacez1Interface for which to display IP lease settings.)r � --root-dirzBSearch for configuration files in this root directory instead of /)�parser� add_argument�command_ip_leasesr r& r' r r r r r% C s �� zNetplanIpLeases.runc s� � j dkr � �� � fdd�}t�� g}� jr |d� jg7 }|d� j g7 }t�d|� z tj|dd�}W n t yL t d � j t j d � t � d � Y nw i }|�d �}|D ]}|�� �d �\}}|||< qV||� d S )Nr c s( � fdd�}� fdd�}t | d d }t | d d }zQtd| �� }tj�d � jr2tj�� j�nd |j� j|d ��}tj� |�sH|� d d �}t |��}|� � D ]}t |�� � qQW d � W d S 1 sfw Y W d S ty� } zt d� jt| �f tjd� t�d� W Y d } ~ d S d } ~ ww )Nc s� t j�d� jd�} z t| ��}|�� d �� W d � W S 1 s"w Y W d S ty? } z t� d| t |�� � d }~ww )Nz/sys/class/netr r zCannot read file %s: %s) �os�path�joinr- �open� readlines�strip� Exception�logging�debug�str)� ifindex_f�f�er r r �lease_method_ifindexT s (���zXNetplanIpLeases.command_ip_leases.<locals>.find_lease_file.<locals>.lease_method_ifindexc s� zHt �dd� jg�} | �� D ]5}d|v rC|�d�d �� �� }t �ddd|g�}|�� D ]}d|v rB|�d�d �� �� W S q,qW td �� ty\ } ztd t|� ��d }~ww ) N�dev�showzGENERAL.CONNECTION�:� �con�idzconnection.uuidz@Could not find a NetworkManager connection for the interface: %sz<Could not find a NetworkManager connection for the interface) �utils� nmcli_outr- � splitlines�split�rstripr7 r8 r; )� nmcli_dev_out�line�conn_id� nmcli_con_outr> r r r �lease_method_nm_connection] s" ��� ���z^NetplanIpLeases.command_ip_leases.<locals>.find_lease_file.<locals>.lease_method_nm_connection�backendr r � lease_method_�/� )r- �lease_idzNetworkManager/internal-zNetworkManager/dhclient-z%No lease found for interface '%s': %s��filerC )� lease_path�evalr2 r3 r4 �root_dir�abspath�formatr- �isfile�replacer5 r6 �printrJ r8 r; �sys�stderr�exit) �mappingr? rO � lease_pattern� lease_methodrT r3 r= rL r> r r r �find_lease_fileS s4 �� �&����z:NetplanIpLeases.command_ip_leases.<locals>.find_lease_filer. z --mappingz command ip leases: running %sT)�textz:No lease found for interface '%s' (not managed by Netplan)rU rC �,�=)r- � print_usagerF �get_generator_pathrY r9 r: � subprocess� check_outputr r^ r_ r` ra rI r7 ) r re �argv�outrb � mapping_s�keyvalue�key�valuer r r r1 N s( 4 � z!NetplanIpLeases.command_ip_leases)r) r* r+ r r% r1 r, r r r r r < s r ) �__doc__r9 r2 r_ rk r �netplan.cli.utils�clirF rW �NetplanCommandr r r r r r �<module> s ��� PK ! �Cy�� � < netplan/cli/commands/__pycache__/try_command.cpython-310.pycnu �[��� o � ed� � @ s� d Z ddlZddlZddlZddlZddlZddlZddlZddlm Z ddl m m Z ddl mZ ddlZddlmZ dZG dd� de j�ZdS )znetplan try command line� N)� ConfigManager)� NetplanApply�x c sx e Zd Z� fdd�Zedd� �Zdd� Zdd� Zd d � Zd d � Z d d� Z dd� Z dd� Z dd� Z dd� Zdd� Z� ZS )� NetplanTryc s` t � jdddd� d| _d | _d | _d | _d | _d | _tj � dd�| _ tj � | j dd d �| _d S ) N�tryzLTry to apply a new netplan config to running system, with automatic rollbackT)� command_id� description�leafF�DBUS_TEST_NETPLAN_ROOT�/�run�netplanznetplan-try.ready)�super�__init__�configuration_changed�new_interfaces� config_file�_config_manager� t_settings�t�os�environ�get�_rootdir�path�join�_netplan_try_stamp��self�� __class__� �6/usr/share/netplan/netplan/cli/commands/try_command.pyr ) s �zNetplanTry.__init__c C s | j s t| jd�| _ | j S )N)�prefix)r r r r r! r! r" �config_manager7 s zNetplanTry.config_managerc C s" t j�| j�rt �| j� dS dS )NTF)r r �isfiler �remover r! r! r" �clear_ready_stamp= s z NetplanTry.clear_ready_stampc C s* t j| jd ddd� t| jd��� d S )Nz /run/netplani� T)�mode�exist_ok�w)r �makedirsr �openr �closer r! r! r" �touch_ready_stampC s z NetplanTry.touch_ready_stampc C sP | j jddd� | j jdttdd� | j jddd� | j| _| �� | �� d S ) Nz --config-filezGApply the config file in argument in addition to current configuration.)�helpz --timeoutz=Maximum number of seconds to wait for the user's confirmation)�type�defaultr/ z--statez0Directory containing previous YAML configuration)�parser� add_argument�int�DEFAULT_INPUT_TIMEOUT� command_try�func� parse_args� run_commandr r! r! r" r G s ��� zNetplanTry.runc C sp | � � s t�tj� z�zDtj�� }tj� |�| _ | j � | j � t � t j| j� t � t j| j� | �� | �� t� jddd| jd� | �� | j j| jd� W n@ tjjyb td� | �� Y n. tjj yp td� Y n t y� } ztd| � td� | �� W Y d }~nd }~ww W | j r�| j � | j � | � � | � � d S | j r�| j � | j � | � � | � � w )NTF�� run_generate�sync� exit_on_error� state_dir)�timeoutz Reverting.z Configuration accepted.z An error occurred: %s)!� is_revertable�sys�exitr � EX_CONFIG�stdin�filenor �terminal�Terminalr �saver �signal�SIGINT�_signal_handler�SIGUSR1�backup�setupr � command_apply�stater. �get_confirmation_inputr? � InputRejected�print�revert� InputAccepted� Exception�reset�cleanupr' )r �fd�er! r! r" r6 U sB ��� � zNetplanTry.command_tryc C s d}| j rd}| jj|d� d S )NFT)�backup_config_dir)r r$ rM )r r[ r! r! r" rM z s zNetplanTry.backupc C sd | j r-tj�ddd�}tj�| j ��d�}t�� }tj�|d�||��}| j� | j |i� d| _ d S )Nr �etcr z.yamlz {}.{}.yamlT) r r r r �basename�rstrip�time�formatr$ �addr )r �dest_dir� dest_name� dest_suffix� dest_pathr! r! r" rN � s zNetplanTry.setupc C s^ t �� }tj�|dd�}t�|� tjd|dd� | j� � t � j ddd|d� t� |� d S )Nr\ r z /etc/netplanT)� dirs_exist_okFr: ) �tempfile�mkdtempr r r r+ �shutil�copytreer$ rT r rO �rmtree)r �tempdir�confdirr! r! r" rT � s zNetplanTry.revertc C s | j �� d S �N)r$ rX r r! r! r" rX � s zNetplanTry.cleanupc C s� g }| j r |�| j � d}z | jj|d�}W n tjy4 } zt�|� t� t j � W Y d}~nd}~ww g }i }|� |j � |� |j� |�� D ]}|jsXd}|�|j|f� qI|rp|D ] \}}td�||�� q]td� dS dS )a Check if the configuration is revertable, if it doesn't contain bits that we know are likely to render the system unstable if we apply it, or if we revert. Returns True if the parsed config is "revertable", meaning that we can actually rely on backends to re-apply /all/ of the relevant configuration to interfaces when their config changes. Returns False if the parsed config contains options that are known to not cleanly revert via the backend. N)� extra_configzBreverting custom parameters for bridges and bonds is not supportedz{}: {}zL Please carefully review the configuration and use 'netplan apply' directly.FT)r �appendr$ �parse�utils� config_errors�logging�errorrA rB r rC �update�bridges�bonds�values�is_trivial_compound_itf�idrS r` ) r ro �np_staterZ �revert_unsupported� multi_iface�itf�reason�ifnamer! r! r" r@ � s4 �� � zNetplanTry.is_revertablec C s( |t jkr tj�� �| jrtj�� �d S rn )rI rL r rF rU r rR )r �sig�framer! r! r" rK � s �zNetplanTry._signal_handler)�__name__� __module__� __qualname__r �propertyr$ r' r. r r6 rM rN rT rX r@ rK � __classcell__r! r! r r" r ' s % -r )�__doc__rt r r_ ri rI rA rg �netplan.configmanagerr �netplan.cli.utils�clirr �netplan.cli.commands.applyr �netplan.terminalr �netplan.libnetplan� libnetplanr5 �NetplanCommandr r! r! r! r" �<module> s PK ! ~$�T� � 5 netplan/cli/commands/__pycache__/info.cpython-310.pycnu �[��� o � ed� � @ s4 d Z ddlm mZ ddlZG dd� dej�ZdS )znetplan info command line� Nc s, e Zd Z� fdd�Zdd� Zdd� Z� ZS )� NetplanInfoc s t � jdddd� d S )N�infozShow available featuresT)� command_id� description�leaf)�super�__init__)�self�� __class__� �//usr/share/netplan/netplan/cli/commands/info.pyr s �zNetplanInfo.__init__c C sR | j jdd�}|jdddddd� |jd ddd d d� | j| _| �� | �� d S ) NF)�requiredz--json�version_format� store_const�jsonz*Output version and features in JSON format)�dest�action�const�helpz--yaml�yamlz*Output version and features in YAML format)�parser� add_mutually_exclusive_group� add_argument� command_info�func� parse_args� run_command)r � format_groupr r r �run s � � zNetplanInfo.runc C s� dddii}t jj}|d �d|i� | jd u rd| _| jdkr/dd l}t|j|dd �� d S | jdkrLtd �|d d �� t jjD ] }td | � qCd S d S ) Nz netplan.io�websitezhttps://netplan.io/�featuresr r r � )�indentz'netplan.io: website: "{}" features:z - ) �netplan� _features�NETPLAN_FEATURE_FLAGS�updater r �print�dumps�format)r �netplan_version�flagsr �featurer r r r , s& �� � �zNetplanInfo.command_info)�__name__� __module__� __qualname__r r r � __classcell__r r r r r s r )�__doc__�netplan.cli.utils�cli�utils�netplan._featuresr$ �NetplanCommandr r r r r �<module> s PK ! ���I� � 4 netplan/cli/commands/__pycache__/get.cpython-310.pycnu �[��� o � ed� � @ sX d Z ddlZddlZddlZddlZddlm mZ ddlm Z G dd� dej �Z dS )znetplan get command line� Nc s4 e Zd Z� fdd�Zdd� Zdd� Zdd� Z� ZS ) � NetplanGetc s t � jdddd� d S )N�getzRGet a setting by specifying a nested key like "ethernets.eth0.addresses", or "all"T)� command_id� description�leaf)�super�__init__��self�� __class__� �./usr/share/netplan/netplan/cli/commands/get.pyr s �zNetplanGet.__init__c C sD | j jdtdddd� | j jdddd � | j| _| �� | �� d S ) N�key�?�allz The nested key in dotted format)�type�nargs�default�helpz --root-dir�/z>Read configuration files from this root directory instead of /)r r )�parser� add_argument�str� command_get�func� parse_args� run_commandr r r r �run# s � zNetplanGet.runc C s� |dkr |j |d� d S |�d�sd�d|f�}t�dd|��dd�}t�� �}|j |d� tj |||d� W d � d S 1 sAw Y d S )Nr )� output_file�network�.z (?<!\\)\.� z\.) � dump_yaml� startswith�join�re�sub�replace�tempfile�NamedTemporaryFile� libnetplan�dump_yaml_subtree)r r �np_stater �tmp_inr r r � dump_state- s "�zNetplanGet.dump_statec C s� t �� }|j| jd� t �� }|�|� z tj�� tj}W n t j y, t � � }Y nw | � | j||� |tjkrT|�� |�d� tj�|�� �d�� |�� d S d S )N)�rootdirr zutf-8)r+ �Parser�load_yaml_hierarchy�root_dir�State�import_parser_results�sys�stdout�fileno�io�UnsupportedOperationr) � TemporaryFiler/ r �flush�seek�write�read�decode�close)r r r- r r r r r ; s" � �zNetplanGet.command_get)�__name__� __module__� __qualname__r r r/ r � __classcell__r r r r r s r ) �__doc__r6 r9 r) r& �netplan.cli.utils�cli�utils�netplan.libnetplanr+ �NetplanCommandr r r r r �<module> s PK ! ���n4 4 4 netplan/cli/commands/__pycache__/set.cpython-310.pycnu �[��� o � edx � @ sT d Z ddlZddlZddlZddlmZ ddlmZ dZddgZ G dd� de�Z dS ) znetplan set command line� N)�NetplanCommandz70-netplan-set.yaml�renderer�versionc s, e Zd Z� fdd�Zdd� Zdd� Z� ZS )� NetplanSetc s t � jdddd� d S )N�setzTAdd new setting by specifying a dotted key=value pair like ethernets.eth0.dhcp4=trueT)� command_id� description�leaf)�super�__init__��self�� __class__� �./usr/share/netplan/netplan/cli/commands/set.pyr ! s �zNetplanSet.__init__c C sR | j jdtdd� | j jdtdd� | j jdddd � | j| _| �� | �� d S ) N� key_valuezNThe nested key=value pair in dotted format. Value can be NULL to delete a key.)�type�helpz --origin-hintz�Can be used to help choose a name for the overwrite YAML file. A .yaml suffix will be appended automatically.z --root-dir�/zAOverwrite configuration files in this root directory instead of /)�defaultr )�parser� add_argument�str� command_set�func� parse_args� run_commandr r r r �run& s � � � zNetplanSet.runc C s� | j d urt| j �dkrtd��| j r d�| j df�}nd }| j�dd�}t|�dkr/td��|\}}|�d �s?d�d |f�}d d � t�d |�D �}t� � }t � � ��}t� |||� |� � |�dtj� |�|� |�| j� |�dtj� |�|� t�� }|�|� |r�t� � } |�dtj� | �|� |�dtj� | j||d � | �| j� |�dtj� | �|� t�� } | �| � | �|| j� n|�t| j� W d � d S W d � d S 1 s�w Y d S )Nr zInvalid/empty origin-hint�.�yaml�=� � zInvalid value specified�networkc S s g | ]}|� d d��qS )z\.r )�replace)�.0�sr r r � <listcomp>D s z*NetplanSet.command_set.<locals>.<listcomp>z (?<!\\)\.)� constraint)� origin_hint�len� Exception�joinr �split� startswith�re� libnetplan�Parser�tempfile� TemporaryFile�create_yaml_patch�flush�seek�io�SEEK_SET�load_nullable_fields�load_yaml_hierarchy�root_dir� load_yaml�State�import_parser_results�load_nullable_overrides�write_yaml_file�update_yaml_hierarchy�FALLBACK_FILENAME) r �filenamer. �key�value� yaml_pathr �tmp�state�parser_output_file�state_output_filer r r r 4 sN �8"�zNetplanSet.command_set)�__name__� __module__� __qualname__r r r � __classcell__r r r r r s r ) �__doc__r3 r0 r8 �netplan.cli.utilsr �netplan.libnetplanr1 rC � GLOBAL_KEYSr r r r r �<module> s PK ! �q�� � netplan/cli/commands/get.pynu �[��� #!/usr/bin/python3 # # Copyright (C) 2020 Canonical, Ltd. # Author: Lukas Märdian <lukas.maerdian@canonical.com> # # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation; version 3. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty 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, see <http://www.gnu.org/licenses/>. '''netplan get command line''' import sys import io import tempfile import re import netplan.cli.utils as utils import netplan.libnetplan as libnetplan class NetplanGet(utils.NetplanCommand): def __init__(self): super().__init__(command_id='get', description='Get a setting by specifying a nested key like "ethernets.eth0.addresses", or "all"', leaf=True) def run(self): self.parser.add_argument('key', type=str, nargs='?', default='all', help='The nested key in dotted format') self.parser.add_argument('--root-dir', default='/', help='Read configuration files from this root directory instead of /') self.func = self.command_get self.parse_args() self.run_command() def dump_state(self, key, np_state, output_file): if key == 'all': np_state.dump_yaml(output_file=output_file) return if not key.startswith('network'): key = '.'.join(('network', key)) # Replace the '.' with '\t' but not at '\.' via negative lookbehind expression key = re.sub(r'(?<!\\)\.', '\t', key).replace(r'\.', '.') with tempfile.NamedTemporaryFile() as tmp_in: np_state.dump_yaml(output_file=tmp_in) libnetplan.dump_yaml_subtree(key, tmp_in, output_file=output_file) def command_get(self): parser = libnetplan.Parser() parser.load_yaml_hierarchy(rootdir=self.root_dir) np_state = libnetplan.State() np_state.import_parser_results(parser) try: sys.stdout.fileno() output_file = sys.stdout # pragma: nocover except io.UnsupportedOperation: # Test environment detected, using a buffer file output_file = tempfile.TemporaryFile() self.dump_state(self.key, np_state, output_file) if output_file != sys.stdout: output_file.flush() output_file.seek(0) sys.stdout.write(output_file.read().decode('utf-8')) output_file.close() PK ! �P+'� � # netplan/cli/commands/try_command.pynu �[��� #!/usr/bin/python3 # # Copyright (C) 2018 Canonical, Ltd. # Author: Mathieu Trudel-Lapierre <mathieu.trudel-lapierre@canonical.com> # # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation; version 3. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty 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, see <http://www.gnu.org/licenses/>. '''netplan try command line''' import logging import os import time import shutil import signal import sys import tempfile from netplan.configmanager import ConfigManager import netplan.cli.utils as utils from netplan.cli.commands.apply import NetplanApply import netplan.terminal import netplan.libnetplan as libnetplan # Keep a timeout long enough to allow the network to converge, 60 seconds may # be slightly short given some complex configs, i.e. if STP must reconverge. DEFAULT_INPUT_TIMEOUT = 120 class NetplanTry(utils.NetplanCommand): def __init__(self): super().__init__(command_id='try', description='Try to apply a new netplan config to running ' 'system, with automatic rollback', leaf=True) self.configuration_changed = False self.new_interfaces = None self.config_file = None self._config_manager = None self.t_settings = None self.t = None self._rootdir = os.environ.get('DBUS_TEST_NETPLAN_ROOT', '/') self._netplan_try_stamp = os.path.join(self._rootdir, 'run', 'netplan', 'netplan-try.ready') @property def config_manager(self): # pragma: nocover (called by later commands) if not self._config_manager: self._config_manager = ConfigManager(prefix=self._rootdir) return self._config_manager def clear_ready_stamp(self): if os.path.isfile(self._netplan_try_stamp): os.remove(self._netplan_try_stamp) return True return False def touch_ready_stamp(self): os.makedirs(self._rootdir + '/run/netplan', mode=0o700, exist_ok=True) open(self._netplan_try_stamp, 'w').close() def run(self): # pragma: nocover (requires user input) self.parser.add_argument('--config-file', help='Apply the config file in argument in addition to current configuration.') self.parser.add_argument('--timeout', type=int, default=DEFAULT_INPUT_TIMEOUT, help="Maximum number of seconds to wait for the user's confirmation") self.parser.add_argument('--state', help='Directory containing previous YAML configuration') self.func = self.command_try self.parse_args() self.run_command() def command_try(self): # pragma: nocover (requires user input) if not self.is_revertable(): sys.exit(os.EX_CONFIG) try: fd = sys.stdin.fileno() self.t = netplan.terminal.Terminal(fd) self.t.save(self.t_settings) # we really don't want to be interrupted while doing backup/revert operations signal.signal(signal.SIGINT, self._signal_handler) signal.signal(signal.SIGUSR1, self._signal_handler) self.backup() self.setup() NetplanApply().command_apply(run_generate=True, sync=True, exit_on_error=False, state_dir=self.state) # Touch stamp file, it is the signal (for netplan-dbus) that we're # ready to accept any Accept/Reject input (like SIGUSR1 or SIGTERM) self.touch_ready_stamp() self.t.get_confirmation_input(timeout=self.timeout) except netplan.terminal.InputRejected: print("\nReverting.") self.revert() except netplan.terminal.InputAccepted: print("\nConfiguration accepted.") except Exception as e: print("\nAn error occurred: %s" % e) print("\nReverting.") self.revert() finally: if self.t: self.t.reset(self.t_settings) self.cleanup() self.clear_ready_stamp() def backup(self): # pragma: nocover (requires user input) backup_config_dir = False if self.config_file: backup_config_dir = True self.config_manager.backup(backup_config_dir=backup_config_dir) def setup(self): # pragma: nocover (requires user input) if self.config_file: dest_dir = os.path.join("/", "etc", "netplan") dest_name = os.path.basename(self.config_file).rstrip('.yaml') dest_suffix = time.time() dest_path = os.path.join(dest_dir, "{}.{}.yaml".format(dest_name, dest_suffix)) self.config_manager.add({self.config_file: dest_path}) self.configuration_changed = True def revert(self): # pragma: nocover (requires user input) # backup the state we just tried to apply tempdir = tempfile.mkdtemp() confdir = os.path.join(tempdir, 'etc', 'netplan') os.makedirs(confdir) shutil.copytree('/etc/netplan', confdir, dirs_exist_ok=True) # restore previous state self.config_manager.revert() NetplanApply().command_apply(run_generate=False, sync=True, exit_on_error=False, state_dir=tempdir) # clear the backup shutil.rmtree(tempdir) def cleanup(self): # pragma: nocover (requires user input) self.config_manager.cleanup() def is_revertable(self): ''' Check if the configuration is revertable, if it doesn't contain bits that we know are likely to render the system unstable if we apply it, or if we revert. Returns True if the parsed config is "revertable", meaning that we can actually rely on backends to re-apply /all/ of the relevant configuration to interfaces when their config changes. Returns False if the parsed config contains options that are known to not cleanly revert via the backend. ''' extra_config = [] if self.config_file: extra_config.append(self.config_file) np_state = None try: np_state = self.config_manager.parse(extra_config=extra_config) except utils.config_errors as e: logging.error(e) sys.exit(os.EX_CONFIG) revert_unsupported = [] # Bridges and bonds are special. They typically include (or could include) # more than one device in them, and they can be set with special parameters # to tweak their behavior, which are really hard to "revert", especially # as systemd-networkd doesn't necessarily touch them when config changes. multi_iface = {} # type: dict[str, libnetplan.NetDefinition] multi_iface.update(np_state.bridges) multi_iface.update(np_state.bonds) for itf in multi_iface.values(): if not itf.is_trivial_compound_itf: reason = "reverting custom parameters for bridges and bonds is not supported" revert_unsupported.append((itf.id, reason)) if revert_unsupported: for ifname, reason in revert_unsupported: print("{}: {}".format(ifname, reason)) print("\nPlease carefully review the configuration and use 'netplan apply' directly.") return False return True def _signal_handler(self, sig, frame): # pragma: nocover (requires user input) if sig == signal.SIGUSR1: raise netplan.terminal.InputAccepted() else: if self.configuration_changed: raise netplan.terminal.InputRejected() PK ! &�Fx x netplan/cli/commands/set.pynu �[��� #!/usr/bin/python3 # # Copyright (C) 2020-2023 Canonical, Ltd. # Author: Lukas Märdian <slyon@ubuntu.com> # # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation; version 3. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty 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, see <http://www.gnu.org/licenses/>. '''netplan set command line''' import tempfile import re import io from netplan.cli.utils import NetplanCommand import netplan.libnetplan as libnetplan FALLBACK_FILENAME = '70-netplan-set.yaml' GLOBAL_KEYS = ['renderer', 'version'] class NetplanSet(NetplanCommand): def __init__(self): super().__init__(command_id='set', description='Add new setting by specifying a dotted key=value pair like ethernets.eth0.dhcp4=true', leaf=True) def run(self): self.parser.add_argument('key_value', type=str, help='The nested key=value pair in dotted format. Value can be NULL to delete a key.') self.parser.add_argument('--origin-hint', type=str, help='Can be used to help choose a name for the overwrite YAML file. \ A .yaml suffix will be appended automatically.') self.parser.add_argument('--root-dir', default='/', help='Overwrite configuration files in this root directory instead of /') self.func = self.command_set self.parse_args() self.run_command() def command_set(self): if self.origin_hint is not None and len(self.origin_hint) == 0: raise Exception('Invalid/empty origin-hint') if self.origin_hint: filename = '.'.join((self.origin_hint, 'yaml')) else: filename = None split = self.key_value.split('=', 1) if len(split) != 2: raise Exception('Invalid value specified') key, value = split if not key.startswith('network'): key = '.'.join(('network', key)) # Split the string into a list on the dot separators, and unescape the remaining dots yaml_path = [s.replace(r'\.', '.') for s in re.split(r'(?<!\\)\.', key)] parser = libnetplan.Parser() with tempfile.TemporaryFile() as tmp: libnetplan.create_yaml_patch(yaml_path, value, tmp) tmp.flush() # Load fields that are about to be deleted (e.g. some.setting=NULL) # Ignore those fields when parsing subsequent YAML files tmp.seek(0, io.SEEK_SET) parser.load_nullable_fields(tmp) # Parse the full, existing YAML config hierarchy parser.load_yaml_hierarchy(self.root_dir) # Load YAML patch, containing our update (new or deleted settings) tmp.seek(0, io.SEEK_SET) parser.load_yaml(tmp) # Validate the final parser state state = libnetplan.State() state.import_parser_results(parser) if filename: # only act on the output file (a.k.a. "origin-hint") parser_output_file = libnetplan.Parser() # Load fields that are about to be deleted ("some.setting=NULL") # Ignore those fields when parsing subsequent YAML files tmp.seek(0, io.SEEK_SET) parser_output_file.load_nullable_fields(tmp) # Load globals/netdefs that are to be ignored from the existing # YAML hierarchy, as our patch is supposed to override settings # in those netdefs via the output file. # Those netdefs and globals must end up in the output file # (a.k.a. "origin-hint", <filename>), have they been defined in # pre-existing YAML files or not. tmp.seek(0, io.SEEK_SET) parser_output_file.load_nullable_overrides(tmp, constraint=filename) # Parse the full YAML hierarchy and new patch, ignoring any # nullable overrides (netdefs/globals) from pre-existing files # and ignoring any nullable fields (settings to be deleted). # This way we can avoid updates to certain netdefs/globals to be # redirected into existing YAML files (defining those same # stanzas) or ignored, but have them written out to the single # output file. # XXX: The origin file of each individual YAML setting/stanza # should be tracked individually, to avoid this # double-parsing workaround (LP: #2003727) parser_output_file.load_yaml_hierarchy(self.root_dir) tmp.seek(0, io.SEEK_SET) parser_output_file.load_yaml(tmp) # Import the partial parser state, ignoring duplicated netdefs # from pre-existing YAML files, so we can force write the patch # contents to the output file or update this file if exists. state_output_file = libnetplan.State() state_output_file.import_parser_results(parser_output_file) state_output_file.write_yaml_file(filename, self.root_dir) else: state.update_yaml_hierarchy(FALLBACK_FILENAME, self.root_dir) PK ! ?�[/� � $ netplan/cli/commands/sriov_rebind.pynu �[��� #!/usr/bin/python3 # # Copyright (C) 2022 Canonical, Ltd. # Author: Lukas Märdian <slyon@ubuntu.com> # # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation; version 3. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty 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, see <http://www.gnu.org/licenses/>. '''netplan SR-IOV rebind command line''' import logging import netplan.cli.utils as utils from netplan.cli.sriov import PCIDevice, bind_vfs, _get_pci_slot_name class NetplanSriovRebind(utils.NetplanCommand): def __init__(self): super().__init__(command_id='rebind', description='Rebind SR-IOV virtual functions of given physical functions to their driver', leaf=True) def run(self): self.parser.add_argument('netdevs', type=str, nargs='*', default=[], help='Space separated list of PF interface names') self.func = self.command_rebind self.parse_args() self.run_command() def command_rebind(self): """Bind virtual functions of SR-IOV devices to their corresponding driver after eswitch mode was changed""" for iface in self.netdevs: pci_addr = _get_pci_slot_name(iface) pcidev = PCIDevice(pci_addr) if not pcidev.is_pf: logging.warning('{} does not seem to be a SR-IOV physical function'.format(iface)) continue bound_vfs = bind_vfs(pcidev.vfs, pcidev.driver) logging.info('{}: bound {} VFs'.format(pcidev, len(bound_vfs))) PK ! $��)� � netplan/cli/commands/generate.pynu �[��� #!/usr/bin/python3 # # Copyright (C) 2018 Canonical, Ltd. # Author: Mathieu Trudel-Lapierre <mathieu.trudel-lapierre@canonical.com> # # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation; version 3. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty 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, see <http://www.gnu.org/licenses/>. '''netplan generate command line''' import logging import os import sys import subprocess import shutil import netplan.cli.utils as utils class NetplanGenerate(utils.NetplanCommand): def __init__(self): super().__init__(command_id='generate', description='Generate backend specific configuration files' ' from /etc/netplan/*.yaml', leaf=True) def run(self): self.parser.add_argument('--root-dir', help='Search for and generate configuration files in this root directory instead of /') self.parser.add_argument('--mapping', help='Display the netplan device ID/backend/interface name mapping and exit.') self.func = self.command_generate self.parse_args() self.run_command() def command_generate(self): # if we are inside a snap, then call dbus to run netplan apply instead if "SNAP" in os.environ: # TODO: maybe check if we are inside a classic snap and don't do # this if we are in a classic snap? busctl = shutil.which("busctl") if busctl is None: raise RuntimeError("missing busctl utility") # pragma: nocover # XXX: DO NOT TOUCH or change this API call, it is used by snapd to communicate # using core20 netplan binary/client/CLI on core18 base systems. Any change # must be agreed upon with the snapd team, so we don't break support for # base systems running older netplan versions. # https://github.com/snapcore/snapd/pull/10212 res = subprocess.call([busctl, "call", "--quiet", "--system", "io.netplan.Netplan", # the service "/io/netplan/Netplan", # the object "io.netplan.Netplan", # the interface "Generate", # the method ]) if res != 0: if res == 130: raise PermissionError( "failed to communicate with dbus service") else: raise RuntimeError( "failed to communicate with dbus service: error %s" % res) else: return argv = [utils.get_generator_path()] if self.root_dir: argv += ['--root-dir', self.root_dir] if self.mapping: argv += ['--mapping', self.mapping] logging.debug('command generate: running %s', argv) # FIXME: os.execv(argv[0], argv) would be better but fails coverage sys.exit(subprocess.call(argv)) PK ! ��](�F �F netplan/cli/sriov.pynu �[��� #!/usr/bin/python3 # # Copyright (C) 2020-2022 Canonical, Ltd. # Author: Łukasz 'sil2100' Zemczak <lukasz.zemczak@canonical.com> # Author: Lukas Märdian <slyon@ubuntu.com> # # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation; version 3. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty 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, see <http://www.gnu.org/licenses/>. import logging import os import subprocess import typing from collections import defaultdict import netplan.cli.utils as utils import netplan.libnetplan as libnetplan from netplan.configmanager import ConfigurationError import netifaces # PCIDevice class originates from mlnx_switchdev_mode/sriovify.py # Copyright 2019 Canonical Ltd, Apache License, Version 2.0 # https://github.com/openstack-charmers/mlnx-switchdev-mode class PCIDevice(object): """Helper class for interaction with a PCI device""" def __init__(self, pci_addr: str): """Initialise a new PCI device handler :param pci_addr: PCI address of device :type: str """ self.pci_addr = pci_addr @property def sys(self) -> str: """sysfs path (can be overridden for testing) :return: full path to /sys filesystem :rtype: str """ return "/sys" @property def path(self) -> str: """/sys path for PCI device :return: full path to PCI device in /sys filesystem :rtype: str """ return os.path.join(self.sys, "bus/pci/devices", self.pci_addr) def subpath(self, subpath: str) -> str: """/sys subpath helper for PCI device :param subpath: subpath to construct path for :type: str :return: self.path + subpath :rtype: str """ return os.path.join(self.path, subpath) @property def driver(self) -> str: """Kernel driver for PCI device :return: kernel driver in use for device :rtype: str """ driver = '' if os.path.exists(self.subpath("driver")): driver = os.path.basename(os.readlink(self.subpath("driver"))) return driver @property def bound(self) -> bool: """Determine if device is bound to a kernel driver :return: whether device is bound to a kernel driver :rtype: bool """ return os.path.exists(self.subpath("driver")) @property def is_pf(self) -> bool: """Determine if device is a SR-IOV Physical Function :return: whether device is a PF :rtype: bool """ return os.path.exists(self.subpath("sriov_numvfs")) @property def is_vf(self) -> bool: """Determine if device is a SR-IOV Virtual Function :return: whether device is a VF :rtype: bool """ return os.path.exists(self.subpath("physfn")) @property def vf_addrs(self) -> list: """List Virtual Function addresses associated with a Physical Function :return: List of PCI addresses of Virtual Functions :rtype: list[str] """ vf_addrs = [] i = 0 while True: try: vf_addrs.append( os.path.basename( os.readlink(self.subpath("virtfn{}".format(i))) ) ) except FileNotFoundError: break i += 1 return vf_addrs @property def vfs(self) -> list: """List Virtual Function associated with a Physical Function :return: List of PCI devices of Virtual Functions :rtype: list[PCIDevice] """ return [PCIDevice(addr) for addr in self.vf_addrs] def devlink_set(self, obj_name: str, prop: str, value: str): """Set devlink options for the PCI device :param obj_name: devlink object to set options on :type: str :param prop: property to set :type: str :param value: value to set for property :type: str """ subprocess.check_call( [ "/sbin/devlink", "dev", obj_name, "set", "pci/{}".format(self.pci_addr), prop, value, ] ) def __str__(self) -> str: """String represenation of object :return: PCI address of string :rtype: str """ return self.pci_addr def bind_vfs(vfs: typing.Iterable[PCIDevice], driver): """Bind unbound VFs to driver.""" bound_vfs = [] for vf in vfs: if not vf.bound: with open("/sys/bus/pci/drivers/{}/bind".format(driver), "wt") as f: f.write(vf.pci_addr) bound_vfs.append(vf) return bound_vfs def unbind_vfs(vfs: typing.Iterable[PCIDevice], driver) -> typing.Iterable[PCIDevice]: """Unbind bound VFs from driver.""" unbound_vfs = [] for vf in vfs: if vf.bound: with open("/sys/bus/pci/drivers/{}/unbind".format(driver), "wt") as f: f.write(vf.pci_addr) unbound_vfs.append(vf) return unbound_vfs def _get_target_interface(interfaces, np_state, pf_link, pfs): if pf_link not in pfs: # handle the match: syntax, get the actual device name pf_dev = np_state[pf_link] if pf_dev.has_match: # now here it's a bit tricky set_name = pf_dev.set_name if set_name and set_name in interfaces: # if we had a match: stanza and set-name: this means we should # assume that, if found, the interface has already been # renamed - use the new name pfs[pf_link] = set_name else: for interface in interfaces: if not pf_dev.match_interface( itf_name=interface, itf_driver=utils.get_interface_driver_name(interface), itf_mac=utils.get_interface_macaddress(interface)): continue # we have a matching PF # store the matching interface in the dictionary of # active PFs, but error out if we matched more than one if pf_link in pfs: raise ConfigurationError('matched more than one interface for a PF device: %s' % pf_link) pfs[pf_link] = interface else: # no match field, assume entry name is the interface name if pf_link in interfaces: pfs[pf_link] = pf_link return pfs.get(pf_link, None) def _get_pci_slot_name(netdev): """ Read PCI slot name for given interface name """ uevent_path = os.path.join('/sys/class/net', netdev, 'device/uevent') try: with open(uevent_path) as f: pci_slot_name = None for line in f.readlines(): line = line.strip() if line.startswith('PCI_SLOT_NAME='): pci_slot_name = line.split('=', 2)[1] return pci_slot_name except IOError as e: raise RuntimeError('failed parsing PCI slot name for %s: %s' % (netdev, str(e))) def get_vf_count_and_functions(interfaces, np_state, vf_counts, vfs, pfs): """ Go through the list of netplan ethernet devices and identify which are PFs and VFs, matching the former with actual networking interfaces. Count how many VFs each PF will need. """ for nid, netdef in np_state.ethernets.items(): if netdef.sriov_link and _get_target_interface(interfaces, np_state, netdef.sriov_link.id, pfs): vfs[nid] = None try: count = netdef.vf_count except libnetplan.LibNetplanException as e: raise ConfigurationError(*e.args) if count == 0: continue pf = _get_target_interface(interfaces, np_state, nid, pfs) if pf: vf_counts[pf] = count def set_numvfs_for_pf(pf, vf_count): """ Allocate the required number of VFs for the selected PF. """ if vf_count > 256: raise ConfigurationError( 'cannot allocate more VFs for PF %s than the SR-IOV maximum: %s > 256' % (pf, vf_count)) devdir = os.path.join('/sys/class/net', pf, 'device') numvfs_path = os.path.join(devdir, 'sriov_numvfs') totalvfs_path = os.path.join(devdir, 'sriov_totalvfs') try: with open(totalvfs_path) as f: vf_max = int(f.read().strip()) except IOError as e: raise RuntimeError('failed parsing sriov_totalvfs for %s: %s' % (pf, str(e))) except ValueError: raise RuntimeError('invalid sriov_totalvfs value for %s' % pf) if vf_count > vf_max: raise ConfigurationError( 'cannot allocate more VFs for PF %s than supported: %s > %s (sriov_totalvfs)' % (pf, vf_count, vf_max)) try: with open(numvfs_path, 'w') as f: f.write(str(vf_count)) except IOError as e: bail = True if e.errno == 16: # device or resource busy logging.warning('device or resource busy while setting sriov_numvfs for %s, trying workaround' % pf) try: # doing this in two open/close sequences so that # it's as close to writing via shell as possible with open(numvfs_path, 'w') as f: f.write('0') with open(numvfs_path, 'w') as f: f.write(str(vf_count)) except IOError as e_inner: e = e_inner else: bail = False if bail: raise RuntimeError('failed setting sriov_numvfs to %s for %s: %s' % (vf_count, pf, str(e))) return True def perform_hardware_specific_quirks(pf): """ Perform any hardware-specific quirks for the given SR-IOV device to make sure all the VF-count changes are applied. """ devdir = os.path.join('/sys/class/net', pf, 'device') try: with open(os.path.join(devdir, 'vendor')) as f: device_id = f.read().strip()[2:] with open(os.path.join(devdir, 'device')) as f: vendor_id = f.read().strip()[2:] except IOError as e: raise RuntimeError('could not determine vendor and device ID of %s: %s' % (pf, str(e))) combined_id = ':'.join([vendor_id, device_id]) quirk_devices = () # TODO: add entries to the list if combined_id in quirk_devices: # pragma: nocover (empty quirk_devices) # some devices need special handling, so this is the place # Currently this part is empty, but has been added as a preemptive # measure, as apparently a lot of SR-IOV cards have issues with # dynamically allocating VFs. Some cards seem to require a full # kernel module reload cycle after changing the sriov_numvfs value # for the changes to come into effect. # Any identified card/vendor can then be special-cased here, if # needed. pass def apply_vlan_filter_for_vf(pf, vf, vlan_name, vlan_id, prefix='/'): """ Apply the hardware VLAN filtering for the selected VF. """ # this is more complicated, because to do this, we actually need to have # the vf index - just knowing the vf interface name is not enough vf_index = None # the prefix argument is here only for unit testing purposes vf_devdir = os.path.join(prefix, 'sys/class/net', vf, 'device') vf_dev_id = os.path.basename(os.readlink(vf_devdir)) pf_devdir = os.path.join(prefix, 'sys/class/net', pf, 'device') for f in os.listdir(pf_devdir): if 'virtfn' in f: dev_path = os.path.join(pf_devdir, f) dev_id = os.path.basename(os.readlink(dev_path)) if dev_id == vf_dev_id: vf_index = f[6:] break if not vf_index: raise RuntimeError( 'could not determine the VF index for %s while configuring vlan %s' % (vf, vlan_name)) # now, create the VLAN filter # TODO: would be best if we did this directl via python, without calling # the iproute tooling try: subprocess.check_call(['ip', 'link', 'set', 'dev', pf, 'vf', vf_index, 'vlan', str(vlan_id)], stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL) except subprocess.CalledProcessError: raise RuntimeError( 'failed setting SR-IOV VLAN filter for vlan %s (ip link set command failed)' % vlan_name) def apply_sriov_config(config_manager, rootdir='/'): """ Go through all interfaces, identify which ones are SR-IOV VFs, create them and perform all other necessary setup. """ parser = libnetplan.Parser() parser.load_yaml_hierarchy(rootdir) np_state = libnetplan.State() np_state.import_parser_results(parser) config_manager.parse() interfaces = netifaces.interfaces() np_state = config_manager.np_state # for sr-iov devices, we identify VFs by them having a link: field # pointing to an PF. So let's browse through all ethernet devices, # find all that are VFs and count how many of those are linked to # particular PFs, as we need to then set the numvfs for each. vf_counts = defaultdict(int) # we also store all matches between VF/PF netplan entry names and # interface that they're currently matching to vfs = {} pfs = {} get_vf_count_and_functions( interfaces, np_state, vf_counts, vfs, pfs) # setup the required number of VFs per PF # at the same time store which PFs got changed in case the NICs # require some special quirks for the VF number to change vf_count_changed = [] if vf_counts: for pf, vf_count in vf_counts.items(): if not set_numvfs_for_pf(pf, vf_count): continue vf_count_changed.append(pf) if vf_count_changed: # some cards need special treatment when we want to change the # number of enabled VFs for pf in vf_count_changed: perform_hardware_specific_quirks(pf) # also, since the VF number changed, the interfaces list also # changed, so we need to refresh it interfaces = netifaces.interfaces() # now in theory we should have all the new VFs set up and existing; # this is needed because we will have to now match the defined VF # entries to existing interfaces, otherwise we won't be able to set # filtered VLANs for those. # XXX: does matching those even make sense? for vf in vfs: netdef = np_state[vf] if netdef.has_match: # right now we only match by name, as I don't think matching per # driver and/or macaddress makes sense # TODO: print warning if other matches are provided for interface in interfaces: if netdef.match_interface(itf_name=interface): if vf in vfs and vfs[vf]: raise ConfigurationError('matched more than one interface for a VF device: %s' % vf) vfs[vf] = interface else: if vf in interfaces: vfs[vf] = vf # Walk the SR-IOV PFs and check if we need to change the eswitch mode for netdef_id, iface in pfs.items(): netdef = np_state[netdef_id] eswitch_mode = netdef.embedded_switch_mode if eswitch_mode in ['switchdev', 'legacy']: pci_addr = _get_pci_slot_name(iface) pcidev = PCIDevice(pci_addr) if pcidev.is_pf: logging.debug("Found VFs of {}: {}".format(pcidev, pcidev.vf_addrs)) if pcidev.vfs: rebind_delayed = netdef.delay_virtual_functions_rebind try: unbind_vfs(pcidev.vfs, pcidev.driver) pcidev.devlink_set('eswitch', 'mode', eswitch_mode) finally: if not rebind_delayed: bind_vfs(pcidev.vfs, pcidev.driver) filtered_vlans_set = set() for vlan, netdef in np_state.vlans.items(): # there is a special sriov vlan renderer that one can use to mark # a selected vlan to be done in hardware (VLAN filtering) if netdef.has_sriov_vlan_filter: # this only works for SR-IOV VF interfaces link = netdef.vlan_link vlan_id = netdef.vlan_id vf = vfs.get(link.id) if not vf: # it is possible this is not an error, for instance when # the configuration has been defined 'for the future' # XXX: but maybe we should error out here as well? logging.warning( 'SR-IOV vlan defined for %s but link %s is either not a VF or has no matches' % (vlan, link.id)) continue # get the parent pf interface # first we fetch the related vf netplan entry # and finally, get the matched pf interface pf = pfs.get(link.sriov_link.id) if vf in filtered_vlans_set: raise ConfigurationError( 'interface %s for netplan device %s (%s) already has an SR-IOV vlan defined' % (vf, link.id, vlan)) # TODO: make sure that we don't apply the filter twice apply_vlan_filter_for_vf(pf, vf, vlan, vlan_id) filtered_vlans_set.add(vf) PK ! � � � netplan/cli/__init__.pynu �[��� #!/usr/bin/python3 # # Copyright (C) 2018 Canonical, Ltd. # Author: Mathieu Trudel-Lapierre <mathieu.trudel-lapierre@canonical.com> # # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation; version 3. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty 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, see <http://www.gnu.org/licenses/>. PK ! �C�v. v. - netplan/cli/__pycache__/sriov.cpython-310.pycnu �[��� o � ed�F � @ s� d dl Z d dlZd dlZd dlZd dlmZ d dlm mZ d dl m Z d dl m Z d dl Z G dd� de�Zdeje fdd�Zdeje d eje fd d �Zd d � Zdd� Zdd� Zdd� Zdd� Zddd�Zddd�ZdS ) � N)� defaultdict)�ConfigurationErrorc @ s� e Zd ZdZdefdd�Zedefdd��Zedefdd ��Zd edefd d �Z edefd d��Z ede fdd��Z ede fdd��Z ede fdd��Zedefdd��Zedefdd��Zdededefd d �Zdefd d �Zd S )!� PCIDevicez.Helper class for interaction with a PCI device�pci_addrc C s || _ dS )znInitialise a new PCI device handler :param pci_addr: PCI address of device :type: str N�r )�selfr � r �'/usr/share/netplan/netplan/cli/sriov.py�__init__' s zPCIDevice.__init__�returnc C s dS )zusysfs path (can be overridden for testing) :return: full path to /sys filesystem :rtype: str z/sysr �r r r r �sys. s z PCIDevice.sysc C s t j�| jd| j�S )zq/sys path for PCI device :return: full path to PCI device in /sys filesystem :rtype: str zbus/pci/devices)�os�path�joinr r r r r r r 6 s zPCIDevice.path�subpathc C s t j�| j|�S )z�/sys subpath helper for PCI device :param subpath: subpath to construct path for :type: str :return: self.path + subpath :rtype: str )r r r )r r r r r r > s zPCIDevice.subpathc C s2 d}t j�| �d��rt j�t �| �d���}|S )zjKernel driver for PCI device :return: kernel driver in use for device :rtype: str � �driver)r r �existsr �basename�readlink)r r r r r r G s zPCIDevice.driverc C � t j�| �d��S )z�Determine if device is bound to a kernel driver :return: whether device is bound to a kernel driver :rtype: bool r �r r r r r r r r �boundR � zPCIDevice.boundc C r )zwDetermine if device is a SR-IOV Physical Function :return: whether device is a PF :rtype: bool � sriov_numvfsr r r r r �is_pfZ r zPCIDevice.is_pfc C r )zvDetermine if device is a SR-IOV Virtual Function :return: whether device is a VF :rtype: bool �physfnr r r r r �is_vfb r zPCIDevice.is_vfc C sR g }d} z|� tj�t�| �d�|����� W n ty# Y |S w |d7 }q)z�List Virtual Function addresses associated with a Physical Function :return: List of PCI addresses of Virtual Functions :rtype: list[str] r Tzvirtfn{}� )�appendr r r r r �format�FileNotFoundError)r �vf_addrs�ir r r r# j s �� ��zPCIDevice.vf_addrsc C s dd� | j D �S )z�List Virtual Function associated with a Physical Function :return: List of PCI devices of Virtual Functions :rtype: list[PCIDevice] c S s g | ]}t |��qS r )r )�.0�addrr r r � <listcomp>� s z!PCIDevice.vfs.<locals>.<listcomp>)r# r r r r �vfs~ s z PCIDevice.vfs�obj_name�prop�valuec C s$ t �dd|dd�| j�||g� dS )z�Set devlink options for the PCI device :param obj_name: devlink object to set options on :type: str :param prop: property to set :type: str :param value: value to set for property :type: str z /sbin/devlink�dev�setzpci/{}N)� subprocess� check_callr! r )r r) r* r+ r r r � devlink_set� s ��zPCIDevice.devlink_setc C s | j S )zbString represenation of object :return: PCI address of string :rtype: str r r r r r �__str__� s zPCIDevice.__str__N)�__name__� __module__� __qualname__�__doc__�strr �propertyr r r r �boolr r r �listr# r( r0 r1 r r r r r $ s, r r( c C s^ g }| D ](}|j s,td�|�d��}|�|j� |�|� W d � n1 s'w Y q|S )zBind unbound VFs to driver.z /sys/bus/pci/drivers/{}/bind�wtN�r �openr! �writer r )r( r � bound_vfs�vf�fr r r �bind_vfs� � ��rA r c C s^ g }| D ](}|j r,td�|�d��}|�|j� |�|� W d � n1 s'w Y q|S )z Unbind bound VFs from driver.z /sys/bus/pci/drivers/{}/unbindr: Nr; )r( r � unbound_vfsr? r@ r r r � unbind_vfs� rB rD c C s� ||vrD|| }|j r<|j}|r|| v r|||< n+| D ] }|j|t�|�t�|�d�s,q||v r6td| ��|||< qn|| v rD|||< |�|d �S )N)�itf_name� itf_driver�itf_macz3matched more than one interface for a PF device: %s)� has_match�set_name�match_interface�utils�get_interface_driver_name�get_interface_macaddressr �get)� interfaces�np_state�pf_link�pfs�pf_devrI � interfacer r r �_get_target_interface� s( � � rU c C s� t j�d| d�}z?t|��0}d}|�� D ] }|�� }|�d�r3|�dd�d }| W d � W S qW d � W dS 1 s@w Y W dS ty] } z t d| t |�f ��d}~ww ) z5 Read PCI slot name for given interface name �/sys/class/netz device/ueventNzPCI_SLOT_NAME=�=� r z'failed parsing PCI slot name for %s: %s) r r r r< � readlines�strip� startswith�split�IOError� RuntimeErrorr6 )�netdev� uevent_pathr@ � pci_slot_name�line�er r r �_get_pci_slot_name� s" ��&���rd c C s� |j �� D ]>\}}|jrt| ||jj|�rd||< z|j}W n tjy0 } zt|j � �d}~ww |dkr6qt| |||�} | rC||| < qdS )z� Go through the list of netplan ethernet devices and identify which are PFs and VFs, matching the former with actual networking interfaces. Count how many VFs each PF will need. Nr ) � ethernets�items� sriov_linkrU �id�vf_count� libnetplan�LibNetplanExceptionr �args) rO rP � vf_countsr( rR �nid�netdef�countrc �pfr r r �get_vf_count_and_functions� s ����rr c C s" |dkr t d| |f ��tj�d| d�}tj�|d�}tj�|d�}z t|��}t|�� �� �}W d � n1 s:w Y W n" tyV } z t d| t |�f ��d}~w t yb t d | ��w ||krpt d | ||f ��z!t|d ��}|� t |�� W d � W d S 1 s�w Y W d S t�y } zrd }|j d kr�t�d| � z8t|d �� }|� d� W d � n1 s�w Y t|d ��}|� t |�� W d � n1 s�w Y W n ty� } z| }W Y d} ~ nd} ~ ww d}|�rt d|| t |�f ��W Y d}~d S d}~ww )zB Allocate the required number of VFs for the selected PF. � zDcannot allocate more VFs for PF %s than the SR-IOV maximum: %s > 256rV �devicer �sriov_totalvfsNz(failed parsing sriov_totalvfs for %s: %sz#invalid sriov_totalvfs value for %szKcannot allocate more VFs for PF %s than supported: %s > %s (sriov_totalvfs)�wT� zLdevice or resource busy while setting sriov_numvfs for %s, trying workaround�0Fz,failed setting sriov_numvfs to %s for %s: %s)r r r r r< �int�readrZ r] r^ r6 � ValueErrorr= �errno�logging�warning) rq ri �devdir� numvfs_path� totalvfs_pathr@ �vf_maxrc �bail�e_innerr r r �set_numvfs_for_pf sh � ��� � � ��� � ���� ���r� c C s� t j�d| d�}zHtt j�|d���}|�� �� dd� }W d � n1 s'w Y tt j�|d���}|�� �� dd� }W d � n1 sJw Y W n tyf } z td| t|�f ��d}~ww d�||g�}d}||v rw dS dS ) z� Perform any hardware-specific quirks for the given SR-IOV device to make sure all the VF-count changes are applied. rV rt �vendorrX Nz2could not determine vendor and device ID of %s: %s�:r ) r r r r< rz rZ r] r^ r6 )rq r r@ � device_id� vendor_idrc � combined_id� quirk_devicesr r r � perform_hardware_specific_quirks1 s$ � ���� �r� �/c C s� d}t j�|d|d�}t j�t �|��}t j�|d| d�}t �|�D ]"} d| v rDt j�|| �} t j�t �| ��} | |krD| dd� } nq"|sOtd||f ��ztjddd d | d |d t |�g tj tj d � W dS tj yu td| ��w )z@ Apply the hardware VLAN filtering for the selected VF. Nz sys/class/netrt �virtfn� zAcould not determine the VF index for %s while configuring vlan %s�ip�linkr- r, r? �vlan)�stdout�stderrzJfailed setting SR-IOV VLAN filter for vlan %s (ip link set command failed)) r r r r r �listdirr^ r. r/ r6 �DEVNULL�CalledProcessError) rq r? � vlan_name�vlan_id�prefix�vf_index� vf_devdir� vf_dev_id� pf_devdirr@ �dev_path�dev_idr r r �apply_vlan_filter_for_vfN s< � � � ���r� c C sR t �� }|�|� t �� }|�|� | �� t�� }| j}t t �}i }i }t |||||� g }|rE|� � D ]\} } t | | �s?q5|�| � q5|rT|D ]} t| � qIt�� }|D ]/} || } | jr}|D ]} | j| d�r{| |v rw|| rwtd| ��| || < qaqV| |v r�| || < qV|� � D ]O\}}|| } | j}|dv r�t|�}t|�}|jr�t�d�||j�� |jr�| j }zt |j|j � |� dd|� W |s�t |j|j � q�|s�t |j|j � w w q�t!� }|j"� � D ]D\}} | j#�r&| j$}| j%}|�&|j'�} | �st�(d||j'f � q�|�&|j)j'�} | |v �rtd| |j'|f ��t*| | ||� |�+| � q�d S ) z Go through all interfaces, identify which ones are SR-IOV VFs, create them and perform all other necessary setup. )rE z3matched more than one interface for a VF device: %s)� switchdev�legacyzFound VFs of {}: {}�eswitch�modezKSR-IOV vlan defined for %s but link %s is either not a VF or has no matcheszJinterface %s for netplan device %s (%s) already has an SR-IOV vlan definedN),rj �Parser�load_yaml_hierarchy�State�import_parser_results�parse� netifacesrO rP r ry rr rf r� r r� rH rJ r �embedded_switch_moderd r r r} �debugr! r# r( � delay_virtual_functions_rebindrD r r0 rA r- �vlans�has_sriov_vlan_filter� vlan_linkr� rN rh r~ rg r� �add)�config_manager�rootdir�parserrP rO rm r( rR �vf_count_changedrq ri r? ro rT � netdef_id�iface� eswitch_moder �pcidev�rebind_delayed�filtered_vlans_setr� r� r� r r r �apply_sriov_configu s� � ������� � � ��r� )r� )r} r r. �typing� collectionsr �netplan.cli.utils�clirK �netplan.libnetplanrj �netplan.configmanagerr r� �objectr �IterablerA rD rU rd rr r� r� r� r� r r r r �<module> s& !/ 'PK ! ��M]� � 0 netplan/cli/__pycache__/__init__.cpython-310.pycnu �[��� o � ed� � @ s d S )N� r r r �*/usr/share/netplan/netplan/cli/__init__.py�<module> s PK ! 6�'ǣ � - netplan/cli/__pycache__/utils.cpython-310.pycnu �[��� o � ed�& � @ s@ d dl Z d dlZd dlZd dlZd dlZd dlZd dlZd dlZd dlm Z d dl m Z d dlm Z dZdZe e efZdd� Zdd � Zd d � Zd ed efdd�Zdd� Zdd� Zd3dd�Zd3dededefdd�Z d d � Z d d � Z d d!� Z d"d#� Z d$d%� Z!d&d'� Z"d(d)� Z#d3d*d+�Z$d,d-� Z%d.efd/d0�Z&G d1d2� d2ej'�Z(dS )4� N)�ConfigurationError)�LibNetplanExceptionzNetworkManager.servicez+snap.network-manager.networkmanager.servicec C s t j�dd�S )N�NETPLAN_GENERATE_PATHz /usr/libexec/netplan/generate)�os�environ�get� r r �'/usr/share/netplan/netplan/cli/utils.py�get_generator_path& s r c C s t jdddtgt jd�dkS )N� systemctl�--quiet� is-enabled)�stderrr )� subprocess�call�NM_SNAP_SERVICE_NAME�DEVNULLr r r r �is_nm_snap_enabled* s r c C s t jdg| t jt jd� d S )N�nmcli��stdoutr �r � check_callr ��argsr r r r . s r r �returnc C s t jdg| dd�S )Nr T��text)r � check_outputr r r r � nmcli_out4 s r c C s, zt dg� W dS ttjfy Y dS w )z"Check if NetworkManager is running�generalTF)r �OSErrorr �SubprocessErrorr r r r � nm_running: s �r# c C s� t �d�}t� }| D ]3}t|d��$}|D ]}|�|�}|r-|�tt�||�d���� nqW d � n1 s8w Y q |S )Nz^interface-name=(.*)$�r� ) �re�compile�set�open�match�update�fnmatch�filter�group)�paths�devices�pat� interfaces�path�f�line�mr r r � nm_interfacesD s �� ��r7 Fc C s" t � r t| tg|�S t| tg|�S �N)r r r �NM_SERVICE_NAME)�action�syncr r r �systemctl_network_managerR s r< r: �servicesr; c C s> t |�dkr d| g}|s|�d� |�|� t�|� d S d S )Nr% r z --no-block)�len�append�extendr r )r: r= r; �commandr r r r Z s �r c C s^ t � } tjg d�dd�}|�� D ] }|�� �d�}|d �� r,|d dvr,| �|d � q| S )N)� networkctlz --no-pagerz --no-legendTr � r ���)� unmanaged�linger)r( r r � splitlines�strip�split� isnumeric�add)r2 �outr5 �sr r r �networkd_interfacesf s �rN c C s t �ddg� d S )NrB �reload�r r r r r r �networkctl_reloadp s rQ c C s* t | �dkrt�ddgt| � � d S d S )Nr% rB � reconfigure)r> r r �list)r2 r r r �networkctl_reconfiguret s �rT c C s t �ddd| g�dkr dS dS )z4Return True if at least one matching unit is runningr r z is-activer TF)r r )� unit_patternr r r �systemctl_is_activey s rV c C s8 t jdd| gt jt jdd�}|jdkrd|jv rdS dS )z5Return True if output is "masked" or "masked-runtime"r r T)r r r r �maskedF)r �run�PIPE� returncoder )rU �resr r r �systemctl_is_masked� s �r\ c C s t �ddg� dS )zEReload systemd unit files from disk and re-calculate its dependenciesr z daemon-reloadNrP r r r r �systemctl_daemon_reload� s r] c C s t jddd| gt jt jd� dS )z8Flush all IP addresses of a given interface via iproute2�ip�addr�flushr Nr )�ifacer r r � ip_addr_flush� s rb c C s t j�d| �}|r\z6tt j�|d���#}|�� �� }|dkr/t�d| |� W d � W d S W d � n1 s9w Y W n ty[ } zt� d| t |�� W Y d }~d S d }~ww zt j� t j�|dd��}t j� |�}W |S ty� } zt�d| |t |�� W Y d }~d S d }~ww ) Nz/sys/class/net� operstate�downz'device %s operstate is %s, not changingz$Cannot determine operstate of %s: %s�device�driverz0Cannot replug %s: cannot read link %s/device: %s) r r3 �joinr) �readrH �logging�debug�IOError�error�str�realpath�basename)� interface� only_down�devdirr4 �state�erf � driver_namer r r �get_interface_driver_name� s4 � �������rv c C s& t �| ��t ji g�d }|�dd�S )Nr r_ � )� netifaces� ifaddressesr �AF_LINK)rp �linkr r r �get_interface_macaddress� s r| r2 c sR t � tj�sJ �� js J �tt� fdd�| ��}t|�dkr%t�|� d S |d S )Nc s � j | t| �t| �d�S )N)�itf_name� itf_driver�itf_mac)�match_interfacerv r| )�itf��netdefr r �<lambda>� s �z%find_matching_iface.<locals>.<lambda>r% r ) � isinstance�np� NetDefinition� has_matchrS r- r> ri �info)r2 r� �matchesr r� r �find_matching_iface� s � r� c @ sF e Zd Zddd�Zdd� Zdd� Zd d � Zd d � Zd d� Zdd� Z dS )�NetplanCommandTFc C s� || _ || _|| _|| _d | _d| _d| _d | _i | _d | _ d | _ t j dt jd |f |dd�| _| jjdddd � | jjd dt jd � |sb| jjd d d d�| _| jjdddd�}|j| jd� d S d S )NFz%s %sr T)�prog� description�add_helpz--debug� store_truezEnable debug messages)r: �helpz --breakpointzAvailable commandsrw � subcommand)�title�metavar�destr� zShow this help message)r� r� )�func)� command_idr� � leaf_command�testing�_argsrj � breakpoint� commandclass� subcommandsr� r� �argparse�ArgumentParser�sys�argv�parser� add_argument�SUPPRESS�add_subparsers� subparsers� add_parser� set_defaults� print_usage)�selfr� r� �leafr� �p_helpr r r �__init__� s> � � ����zNetplanCommand.__init__c C s || _ d S r8 )r� )r� r r r r r+ � s zNetplanCommand.updatec C sF | j j| j| d�\}| _| js | js!tdtjd� | �� d S d S d S )N)r � namespacez You need to specify a command��file) r� �parse_known_argsr� r� r� �printr� r r� )r� �nsr r r � parse_args� s �zNetplanCommand.parse_argsc C sD | j r | j �| j� | jrd| jv r| �� | jr t� | �� d S )Nr� )r� r+ r� r� r� r� r� �r� r r r � run_command� s zNetplanCommand.run_commandc C s | j jtjd� t�tj� d S )Nr� )r� � print_helpr� r �exitr �EX_USAGEr� r r r r� � s zNetplanCommand.print_usagec C s� |� }i | j |< || j | d< || j | d< |jr"tj�dd �s"d S | jj|j|j|jdd�}|j |j |d� || j | d< d S )N�class�instance�ENABLE_TEST_COMMANDSF)r� r� r� )r� r� r� ) r� r� r r r r� r� r� r� r� rX )r� �namer� r� �pr r r �_add_subparser_from_class� s �z(NetplanCommand._add_subparser_from_classc C s@ dd l }|�|�D ]\}}|�|�r t|t�r | �||� q d S )Nr )�inspect� getmembers�isclass� issubclassr� r� )r� � submodulesr� r� �objr r r �_import_subcommands s ��z"NetplanCommand._import_subcommandsN)TF) �__name__� __module__� __qualname__r� r+ r� r� r� r� r� r r r r r� � s r� )F))r� r ri r� r rx r, r& �netplan.libnetplan� libnetplanr� �netplan.configmanagerr r r9 r � RuntimeError� config_errorsr r r rS rm r r# r7 r< �boolr rN rQ rT rV r\ r] rb rv r| r� � Namespacer� r r r r �<module> sB PK ! ��_ � � + netplan/cli/__pycache__/ovs.cpython-310.pycnu �[��� o � ed� � @ s� d dl Z d dlZd dlZd dlZd dlmZ dZdZddd�Zddd d �Z G d d � d e �Z d d� Z dd� Z dd� Zdd� Zdd� Zdd� Zdd� ZdS )� N)�systemctl_is_activez/usr/bin/ovs-vsctlzovsdb-server.service�false)�mcast_snooping_enable� rstp_enable)�del-sslzget-ssl)z del-fail-modez get-fail-mode)zdel-controllerzget-controller)zset-sslz set-fail-modezset-controllerc @ s e Zd ZdS )�OvsDbServerNotRunningN)�__name__� __module__� __qualname__� r r �%/usr/share/netplan/netplan/cli/ovs.pyr * s r c C s` t �|�}|du rt�td| |||g� dS |r,||kr.t�td| |d||f g� dS dS dS )z2Cleanup values from a column (i.e. "column=value")N�remove�setz%s=%s)�DEFAULTS�get� subprocess� check_call�OPENVSWITCH_OVS_VSCTL)�type�iface�column�value�defaultr r r �_del_col. s �r c C s t �td| |||t|�g� dS )z:Cleanup values from a dictionary (i.e. "column:key=value")r N)r r r � _escape_colon)r r r �keyr r r r � _del_dict9 s r c C s t �dd| �S )Nz([^\\]):z\g<1>\:)�re�sub)�literalr r r r @ s r c s� t �|d�\}}|dkrd}|rBt|g}t|g}|r$|�|� |�|� tj|dd�� t� fdd�|�d�D ��r@t�|� dS dS t d |��) z*Cleanup commands from the global namespace)NNr NT��textc 3 s � | ]}|� v V qd S )Nr )�.0�item��outr r � <genexpr>^ s � z _del_global.<locals>.<genexpr>�,zReset command unknown for:) �GLOBALSr r �appendr � check_output�all�splitr � Exception)r r r r �del_cmd�get_cmd�args_get�args_delr r$ r � _del_globalD s � r2 c C s� |� dd�}|d }|dkr t|�dkr t| ||d |� n t|�dkr1t| ||d |d |� n t| ||d |� t�td| |d|g� dS )zDCheck if this setting is in a dict or a colum and delete accordingly�/� � �globalr � external-idsN)r, �lenr2 r r r r r )r r �settingr r, �colr r r � clear_settingd s r; c C s( t |t�sJ �|�| d �}|o|jdkS )N� OpenVSwitch)� isinstance�dictr �backend)r �np_interface_dict�np_defr r r �is_ovs_interfacer s rB c C s� t t�s td�t���| �� t� }| j�� D ] }t|| j�r$|� |� qt j � t �r�dD ]Q}tjt ddddddd |d g d d �}|�� D ]8}d |v r}|�d�d }||v rWqE|d dkrrt�t d|g�jd krrt�t dd|g� qEt�t d|d |g� qEq-dD ]a}d} |dkr�d} n|dkr�d} tjt d| dddddd |g d d �}|�� D ]9}d|v r�d }|} |dkr�|�dd�\}} | �d ��d �D ]} | �d�r�d | v r�| �d d�\} } t||| | � q�q�q�d!S |s�|r�t�d � d!S d!S )"aQ Query OpenVSwitch state through 'ovs-vsctl' and filter for netplan=true tagged ports/bonds and bridges. Delete interfaces which are not defined in the current configuration. Also filter for individual settings tagged netplan/<column>[/<key]=value in external-ids and clear them if they have been set by netplan. z{} is not running))�Portzdel-port)�Bridge�del-br)� InterfacerE z--columns=name,external-idsz-f�csvz-d�barez --no-headings�listr Tr z netplan=truer' rF z br-existsz --if-existszdel-bond-ifacer5 )rC rD rF � Open_vSwitch� Controllerzname,external-idsrJ r7 rK z_uuid,external-idsz --columns=%sznetplan/�.�"� �=zAovs-vsctl is missing, cannot tear down old OpenVSwitch interfacesN)r � OPENVSWITCH_OVSDB_SERVER_UNITr �format�parser �all_defs�keysrB �add�os�path�isfiler r r* � splitlinesr, �run� returncoder �strip� startswithr; �logging�warning)�config_manager�ovs_old� ovs_current� ovs_ifaces�i�tr% �liner �cols�extids�entryr9 �valr r r �apply_ovs_cleanupx sh � �� "�� �� ����rk )r^ rV r r �netplan.cli.utilsr r rP r r( r- r r r r r2 r; rB rk r r r r �<module> s, �� PK ! �Ƿ@a a , netplan/cli/__pycache__/core.cpython-310.pycnu �[��� o � ed� � @ s@ d Z ddlZddlZddlm mZ dZG dd� dej�ZdS )znetplan command line� Nz/usr/bin:/snap/binc s0 e Zd Z� fdd�Z� fdd�Zdd� Z� ZS )�Netplanc s0 t � jdddd� tj�dt�dt�d�� d S )N� z Network configuration in YAMLF)� command_id� description�leaf�C�PATH)�LC_ALLr )�super�__init__�os�environ�update�getenv� FALLBACK_PATH��self�� __class__� �&/usr/share/netplan/netplan/cli/core.pyr s � �zNetplan.__init__c s$ dd l }| �|jj� t� �� d S )Nr )�netplan.cli.commands�_import_subcommands�cli�commandsr � parse_args)r �netplanr r r r ( s zNetplan.parse_argsc C sF | � � | jrtjtjdd� dtjd< ntjtjdd� | �� d S )Nz%(levelname)s:%(message)s)�level�format�all�G_MESSAGES_DEBUGz %(message)s) r �debug�logging� basicConfig�DEBUGr r �INFO� run_commandr r r r �main/ s z Netplan.main)�__name__� __module__� __qualname__r r r' � __classcell__r r r r r s r ) �__doc__r" r �netplan.cli.utilsr �utilsr �NetplanCommandr r r r r �<module> s PK ! P�e�� � netplan/cli/core.pynu �[��� #!/usr/bin/python3 # # Copyright (C) 2018 Canonical, Ltd. # Author: Martin Pitt <martin.pitt@ubuntu.com> # Author: Mathieu Trudel-Lapierre <mathieu.trudel-lapierre@canonical.com> # # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation; version 3. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty 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, see <http://www.gnu.org/licenses/>. '''netplan command line''' import logging import os import netplan.cli.utils as utils FALLBACK_PATH = '/usr/bin:/snap/bin' class Netplan(utils.NetplanCommand): def __init__(self): super().__init__(command_id='', description='Network configuration in YAML', leaf=False) os.environ.update({ 'LC_ALL': 'C', 'PATH': os.getenv('PATH', FALLBACK_PATH)}) def parse_args(self): import netplan.cli.commands self._import_subcommands(netplan.cli.commands) super().parse_args() def main(self): self.parse_args() if self.debug: logging.basicConfig(level=logging.DEBUG, format='%(levelname)s:%(message)s') os.environ['G_MESSAGES_DEBUG'] = 'all' else: logging.basicConfig(level=logging.INFO, format='%(message)s') self.run_command() PK ! sx9Ň& �& netplan/cli/utils.pynu �[��� # Copyright (C) 2018-2020 Canonical, Ltd. # Author: Mathieu Trudel-Lapierre <mathieu.trudel-lapierre@canonical.com> # Author: Łukasz 'sil2100' Zemczak <lukasz.zemczak@canonical.com> # Author: Lukas 'slyon' Märdian <lukas.maerdian@canonical.com> # # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation; version 3. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty 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, see <http://www.gnu.org/licenses/>. import sys import os import logging import argparse import subprocess import netifaces import fnmatch import re import netplan.libnetplan as np from netplan.configmanager import ConfigurationError from netplan.libnetplan import LibNetplanException NM_SERVICE_NAME = 'NetworkManager.service' NM_SNAP_SERVICE_NAME = 'snap.network-manager.networkmanager.service' config_errors = (ConfigurationError, LibNetplanException, RuntimeError) def get_generator_path(): return os.environ.get('NETPLAN_GENERATE_PATH', '/usr/libexec/netplan/generate') def is_nm_snap_enabled(): return subprocess.call(['systemctl', '--quiet', 'is-enabled', NM_SNAP_SERVICE_NAME], stderr=subprocess.DEVNULL) == 0 def nmcli(args): # pragma: nocover (covered in autopkgtest) # 'nmcli' could be /usr/bin/nmcli or /snap/bin/nmcli -> /snap/bin/network-manager.nmcli # PATH is defined in cli/core.py subprocess.check_call(['nmcli'] + args, stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL) def nmcli_out(args: list) -> str: # pragma: nocover (covered in autopkgtest) # 'nmcli' could be /usr/bin/nmcli or /snap/bin/nmcli -> /snap/bin/network-manager.nmcli # PATH is defined in cli/core.py return subprocess.check_output(['nmcli'] + args, text=True) def nm_running(): # pragma: nocover (covered in autopkgtest) '''Check if NetworkManager is running''' try: nmcli(['general']) return True except (OSError, subprocess.SubprocessError): return False def nm_interfaces(paths, devices): pat = re.compile('^interface-name=(.*)$') interfaces = set() for path in paths: with open(path, 'r') as f: for line in f: m = pat.match(line) if m: # Expand/match globbing of interface names, to real devices interfaces.update(set(fnmatch.filter(devices, m.group(1)))) break # skip to next file return interfaces def systemctl_network_manager(action, sync=False): # If the network-manager snap is installed use its service # name rather than the one of the deb packaged NetworkManager if is_nm_snap_enabled(): return systemctl(action, [NM_SNAP_SERVICE_NAME], sync) return systemctl(action, [NM_SERVICE_NAME], sync) # pragma: nocover (covered in autopkgtest) def systemctl(action: str, services: list, sync: bool = False): if len(services) >= 1: command = ['systemctl', action] if not sync: command.append('--no-block') command.extend(services) subprocess.check_call(command) def networkd_interfaces(): interfaces = set() out = subprocess.check_output(['networkctl', '--no-pager', '--no-legend'], text=True) for line in out.splitlines(): s = line.strip().split(' ') if s[0].isnumeric() and s[-1] not in ['unmanaged', 'linger']: interfaces.add(s[0]) return interfaces def networkctl_reload(): subprocess.check_call(['networkctl', 'reload']) def networkctl_reconfigure(interfaces): if len(interfaces) >= 1: subprocess.check_call(['networkctl', 'reconfigure'] + list(interfaces)) def systemctl_is_active(unit_pattern): '''Return True if at least one matching unit is running''' if subprocess.call(['systemctl', '--quiet', 'is-active', unit_pattern]) == 0: return True return False def systemctl_is_masked(unit_pattern): '''Return True if output is "masked" or "masked-runtime"''' res = subprocess.run(['systemctl', 'is-enabled', unit_pattern], stdout=subprocess.PIPE, stderr=subprocess.PIPE, text=True) if res.returncode > 0 and 'masked' in res.stdout: return True return False def systemctl_daemon_reload(): '''Reload systemd unit files from disk and re-calculate its dependencies''' subprocess.check_call(['systemctl', 'daemon-reload']) def ip_addr_flush(iface): '''Flush all IP addresses of a given interface via iproute2''' subprocess.check_call(['ip', 'addr', 'flush', iface], stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL) def get_interface_driver_name(interface, only_down=False): # pragma: nocover (covered in autopkgtest) devdir = os.path.join('/sys/class/net', interface) if only_down: try: with open(os.path.join(devdir, 'operstate')) as f: state = f.read().strip() if state != 'down': logging.debug('device %s operstate is %s, not changing', interface, state) return None except IOError as e: logging.error('Cannot determine operstate of %s: %s', interface, str(e)) return None try: driver = os.path.realpath(os.path.join(devdir, 'device', 'driver')) driver_name = os.path.basename(driver) except IOError as e: logging.debug('Cannot replug %s: cannot read link %s/device: %s', interface, devdir, str(e)) return None return driver_name def get_interface_macaddress(interface): # return an empty list (and string) if no LL data can be found link = netifaces.ifaddresses(interface).get(netifaces.AF_LINK, [{}])[0] return link.get('addr', '') def find_matching_iface(interfaces: list, netdef): assert isinstance(netdef, np.NetDefinition) assert netdef.has_match matches = list(filter(lambda itf: netdef.match_interface( itf_name=itf, itf_driver=get_interface_driver_name(itf), itf_mac=get_interface_macaddress(itf)), interfaces)) # Return current name of unique matched interface, if available if len(matches) != 1: logging.info(matches) return None return matches[0] class NetplanCommand(argparse.Namespace): def __init__(self, command_id, description, leaf=True, testing=False): self.command_id = command_id self.description = description self.leaf_command = leaf self.testing = testing self._args = None self.debug = False self.breakpoint = False self.commandclass = None self.subcommands = {} self.subcommand = None self.func = None self.parser = argparse.ArgumentParser(prog="%s %s" % (sys.argv[0], command_id), description=description, add_help=True) self.parser.add_argument('--debug', action='store_true', help='Enable debug messages') self.parser.add_argument('--breakpoint', action='store_true', help=argparse.SUPPRESS) if not leaf: self.subparsers = self.parser.add_subparsers(title='Available commands', metavar='', dest='subcommand') p_help = self.subparsers.add_parser('help', description='Show this help message', help='Show this help message') p_help.set_defaults(func=self.print_usage) def update(self, args): self._args = args def parse_args(self): ns, self._args = self.parser.parse_known_args(args=self._args, namespace=self) if not self.subcommand and not self.leaf_command: print('You need to specify a command', file=sys.stderr) self.print_usage() def run_command(self): if self.commandclass: self.commandclass.update(self._args) # TODO: (cyphermox) this is actually testable in tests/cli.py; add it. if self.leaf_command and 'help' in self._args: # pragma: nocover (covered in autopkgtest) self.print_usage() if self.breakpoint: # pragma: nocover (cannot be automatically tested) breakpoint() self.func() def print_usage(self): self.parser.print_help(file=sys.stderr) sys.exit(os.EX_USAGE) def _add_subparser_from_class(self, name, commandclass): instance = commandclass() self.subcommands[name] = {} self.subcommands[name]['class'] = name self.subcommands[name]['instance'] = instance if instance.testing: if not os.environ.get('ENABLE_TEST_COMMANDS', None): return p = self.subparsers.add_parser(instance.command_id, description=instance.description, help=instance.description, add_help=False) p.set_defaults(func=instance.run, commandclass=instance) self.subcommands[name]['parser'] = p def _import_subcommands(self, submodules): import inspect for name, obj in inspect.getmembers(submodules): if inspect.isclass(obj) and issubclass(obj, NetplanCommand): self._add_subparser_from_class(name, obj) PK ! �8�� � netplan/cli/ovs.pynu �[��� #!/usr/bin/python3 # # Copyright (C) 2020 Canonical, Ltd. # Author: Lukas 'slyon' Märdian <lukas.maerdian@canonical.com> # # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation; version 3. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty 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, see <http://www.gnu.org/licenses/>. import logging import os import subprocess import re from netplan.cli.utils import systemctl_is_active OPENVSWITCH_OVS_VSCTL = '/usr/bin/ovs-vsctl' OPENVSWITCH_OVSDB_SERVER_UNIT = 'ovsdb-server.service' # Defaults for non-optional settings, as defined here: # http://www.openvswitch.org/ovs-vswitchd.conf.db.5.pdf DEFAULTS = { # Mandatory columns: 'mcast_snooping_enable': 'false', 'rstp_enable': 'false', } GLOBALS = { # Global commands: 'set-ssl': ('del-ssl', 'get-ssl'), 'set-fail-mode': ('del-fail-mode', 'get-fail-mode'), 'set-controller': ('del-controller', 'get-controller'), } class OvsDbServerNotRunning(Exception): pass def _del_col(type, iface, column, value): """Cleanup values from a column (i.e. "column=value")""" default = DEFAULTS.get(column) if default is None: # removes the exact value only if it was set by netplan subprocess.check_call([OPENVSWITCH_OVS_VSCTL, 'remove', type, iface, column, value]) elif default and default != value: # reset to default, if its not the default already subprocess.check_call([OPENVSWITCH_OVS_VSCTL, 'set', type, iface, '%s=%s' % (column, default)]) def _del_dict(type, iface, column, key, value): """Cleanup values from a dictionary (i.e. "column:key=value")""" # removes the exact value only if it was set by netplan subprocess.check_call([OPENVSWITCH_OVS_VSCTL, 'remove', type, iface, column, key, _escape_colon(value)]) # for ovsdb remove: column key's value can not contain bare ':', need to escape with '\' def _escape_colon(literal): return re.sub(r'([^\\]):', r'\g<1>\:', literal) def _del_global(type, iface, key, value): """Cleanup commands from the global namespace""" del_cmd, get_cmd = GLOBALS.get(key, (None, None)) if del_cmd == 'del-ssl': iface = None if del_cmd: args_get = [OPENVSWITCH_OVS_VSCTL, get_cmd] args_del = [OPENVSWITCH_OVS_VSCTL, del_cmd] if iface: args_get.append(iface) args_del.append(iface) # Check the current value of a global command and compare it to the tag-value, e.g.: # * get-ssl: netplan/global/set-ssl=/private/key.pem,/another/cert.pem,/some/ca-cert.pem # Private key: /private/key.pem # Certificate: /another/cert.pem # CA Certificate: /some/ca-cert.pem # Bootstrap: false # * get-fail-mode: netplan/global/set-fail-mode=secure # secure # * get-controller: netplan/global/set-controller=tcp:127.0.0.1:1337,unix:/some/socket # tcp:127.0.0.1:1337 # unix:/some/socket out = subprocess.check_output(args_get, text=True) # Clean it only if the exact same value(s) were set by netplan. # Don't touch it if other values were set by another integration. if all(item in out for item in value.split(',')): subprocess.check_call(args_del) else: raise Exception('Reset command unknown for:', key) def clear_setting(type, iface, setting, value): """Check if this setting is in a dict or a colum and delete accordingly""" split = setting.split('/', 2) col = split[1] if col == 'global' and len(split) > 2: _del_global(type, iface, split[2], value) elif len(split) > 2: _del_dict(type, iface, split[1], split[2], value) else: _del_col(type, iface, split[1], value) # Cleanup the tag itself (i.e. "netplan/column[/key]") subprocess.check_call([OPENVSWITCH_OVS_VSCTL, 'remove', type, iface, 'external-ids', setting]) def is_ovs_interface(iface, np_interface_dict): assert isinstance(np_interface_dict, dict) np_def = np_interface_dict.get(iface, None) return np_def and np_def.backend == 'OpenVSwitch' def apply_ovs_cleanup(config_manager, ovs_old, ovs_current): # pragma: nocover (covered in autopkgtest) """ Query OpenVSwitch state through 'ovs-vsctl' and filter for netplan=true tagged ports/bonds and bridges. Delete interfaces which are not defined in the current configuration. Also filter for individual settings tagged netplan/<column>[/<key]=value in external-ids and clear them if they have been set by netplan. """ if not systemctl_is_active(OPENVSWITCH_OVSDB_SERVER_UNIT): raise OvsDbServerNotRunning('{} is not running'.format(OPENVSWITCH_OVSDB_SERVER_UNIT)) config_manager.parse() ovs_ifaces = set() for i in config_manager.all_defs.keys(): if (is_ovs_interface(i, config_manager.all_defs)): ovs_ifaces.add(i) # Tear down old OVS interfaces, not defined in the current config. # Use 'del-br' on the Interface table, to delete any netplan created VLAN fake bridges. # Use 'del-bond-iface' on the Interface table, to delete netplan created patch port interfaces if os.path.isfile(OPENVSWITCH_OVS_VSCTL): # Step 1: Delete all interfaces, which are not part of the current OVS config for t in (('Port', 'del-port'), ('Bridge', 'del-br'), ('Interface', 'del-br')): out = subprocess.check_output([OPENVSWITCH_OVS_VSCTL, '--columns=name,external-ids', '-f', 'csv', '-d', 'bare', '--no-headings', 'list', t[0]], text=True) for line in out.splitlines(): if 'netplan=true' in line: iface = line.split(',')[0] # Skip cleanup if this OVS interface is part of the current netplan OVS config if iface in ovs_ifaces: continue if t[0] == 'Interface' and subprocess.run([OPENVSWITCH_OVS_VSCTL, 'br-exists', iface]).returncode > 0: subprocess.check_call([OPENVSWITCH_OVS_VSCTL, '--if-exists', 'del-bond-iface', iface]) else: subprocess.check_call([OPENVSWITCH_OVS_VSCTL, '--if-exists', t[1], iface]) # Step 2: Clean up the settings of the remaining interfaces for t in ('Port', 'Bridge', 'Interface', 'Open_vSwitch', 'Controller'): cols = 'name,external-ids' if t == 'Open_vSwitch': cols = 'external-ids' elif t == 'Controller': cols = '_uuid,external-ids' # handle _uuid as if it would be the iface 'name' out = subprocess.check_output([OPENVSWITCH_OVS_VSCTL, '--columns=%s' % cols, '-f', 'csv', '-d', 'bare', '--no-headings', 'list', t], text=True) for line in out.splitlines(): if 'netplan/' in line: iface = '.' extids = line if t != 'Open_vSwitch': iface, extids = line.split(',', 1) # Check each line (interface) if it contains any netplan tagged settings, e.g.: # ovs0,"iface-id=myhostname netplan=true netplan/external-ids/iface-id=myhostname" # ovs1,"netplan=true netplan/global/set-fail-mode=standalone netplan/mcast_snooping_enable=false" for entry in extids.strip('"').split(' '): if entry.startswith('netplan/') and '=' in entry: setting, val = entry.split('=', 1) clear_setting(t, iface, setting, val) # Show the warning only if we are or have been working with OVS definitions elif ovs_old or ovs_current: logging.warning('ovs-vsctl is missing, cannot tear down old OpenVSwitch interfaces') PK ! ed::� � , netplan/__pycache__/terminal.cpython-310.pycnu �[��� o � ed� � @ s` d Z ddlZddlZddlZddlZddlZG dd� de�ZG dd� de�Z G dd� de�Z dS ) z Terminal / input handling � Nc @ sV e Zd ZdZdd� Zdd� Zdd� Zdd � Zd d � Zddd�Z ddd�Z ddd�Z d S )�Terminalz@ Do minimal terminal mangling to prompt users for input c C s || _ d | _d | _| �� d S �N)�fd� orig_flags� orig_term�save)�selfr � r �&/usr/share/netplan/netplan/terminal.py�__init__" s zTerminal.__init__c C sT t j�� r(t�| j�}|d tjB |d< |d tjB |d< t�| jtj |� d S d S �N� � �sys�stdin�isatty�termios� tcgetattrr �ICANON�ECHO� tcsetattr�TCSANOW�r �attrsr r r � enable_echo( s �zTerminal.enable_echoc C sX t j�� r*t�| j�}|d tj @ |d< |d tj @ |d< t�| jtj |� d S d S r r r r r r � disable_echo/ s �zTerminal.disable_echoc C s, t � | jt j�}t � | jt j|tjB � d S r ��fcntlr �F_GETFL�F_SETFL�os� O_NONBLOCK�r �flagsr r r �enable_nonblocking_io6 s z Terminal.enable_nonblocking_ioc C s. t � | jt j�}t � | jt j|tj @ � d S r r r" r r r �disable_nonblocking_io: s z Terminal.disable_nonblocking_io�x Nc C s� t d� t� }| �|� | �� | �� |sd}t d�|�� |}|dkrbt d�|tt|���dd� t�t j gg g d� zt j � � }|d krO| � |� t � �W n tyY Y nw |d8 }|dks%| � |� t� �) a� Get a "confirmation" input from the user, for at most (timeout) seconds. Optionally, customize the message to be displayed. timeout -- timeout to wait for input (default 120) message -- optional customized message ("Press ENTER to (message)") raises: InputAccepted -- the user confirmed the changes InputRejected -- the user rejected the changes z%Do you want to keep these settings? z accept the new configurationz&Press ENTER before the timeout to {} r z%Changes will revert in {:>{}} seconds� )�end� � )�print�dictr r r$ �format�len�str�selectr r �read�reset� InputAccepted� TypeError� InputRejected)r �timeout�message�settings� timeout_now�cr r r �get_confirmation_input> s2 � �� z Terminal.get_confirmation_inputc C sV t � | jt j�}d}tj�� rt�| j�}|dur#|�||d�� dS || _ || _ dS )z� Save the terminal's current attributes and flags Optional argument: - dest: if set, save settings to this dict N)r# �term) r r r r r r r r �updater r )r �destr r r r r r p s � z Terminal.savec C sd d}d}|dur|� d�}|� d�}n| j}| j}tj�� r't�| jtj |� t � | jt j |� dS )z� Reset the terminal to its original attributes and flags Optional argument: - orig: if set, reset to settings from this dict Nr< r# ) �getr r r r r r r r � TCSAFLUSHr r )r �origr r r r r r2 � s zTerminal.reset)r& Nr ) �__name__� __module__� __qualname__�__doc__r r r r$ r% r; r r2 r r r r r s 2r c @ � e Zd ZdZdS )r3 z Denotes has accepted inputN�rB rC rD rE r r r r r3 � � r3 c @ rF )r5 z) Denotes that the user has rejected inputNrG r r r r r5 � rH r5 ) rE r r r r0 r �objectr � Exceptionr3 r5 r r r r �<module> s yPK ! �^V�� � 1 netplan/__pycache__/configmanager.cpython-310.pycnu �[��� o � ed� � @ sh d Z ddlZddlZddlZddlZddlZddlmZ ddlm Z G dd� de �Z G dd� de �Z dS ) z netplan configuration manager� N)�Optional)� libnetplanc @ s� e Zd Zdi fdd�Zdd� Zedd� �Zedd � �Zd d d �Zd d� Z d dd�Z dd� Z dd� Z dd� Z dd� Zd dd �Zd S ) � ConfigManager�/c C sP || _ tjdd�| _tj�| jd�| _tj�| jd�| _|| _ t � | _ d | _ d S )N�netplan_)�prefix�etc�run) r �tempfile�mkdtemp�tempdir�os�path�join�temp_etc�temp_run� extra_files�set�new_interfaces�np_state)�selfr r � r �+/usr/share/netplan/netplan/configmanager.py�__init__ s zConfigManager.__init__c C s | j d us J d��t| j |�S �Nz.Must call parse() before accessing the config.)r �getattr)r �attrr r r � __getattr__) s zConfigManager.__getattr__c C sD | j d us J d��i }|�| j j� |�| j j� |�| j j� |S r )r �update� ethernets�modems�wifis�r � interfacesr r r �physical_interfaces- s z!ConfigManager.physical_interfacesc C s` | j d us J d��i }|�| j j� |�| j j� |�| j j� |�| j j� |�| j j� |S r )r r �bridges�bonds�tunnels�vlans�vrfsr" r r r �virtual_interfaces6 s z ConfigManager.virtual_interfacesNc C s~ t �� }z |j| jd� |r|D ]}|�|� qt �� | _| j�|� W n t jy6 } zt |j � �d}~ww | j� � | jS )z� Parse all our config files to return an object that describes the system's entire configuration, so that it can later be interrogated. Returns a libnetplan State wrapper )�rootdirN) r �Parser�load_yaml_hierarchyr � load_yaml�Stater �import_parser_results�LibNetplanException�ConfigurationError�args� dump_to_logs)r � extra_config�parser�f�er r r �parseB s �� zConfigManager.parsec C s0 |D ] }| � ||| � q| j�|� d | _d S �N)� _copy_filer r r )r � config_dict� config_filer r r �add[ s zConfigManager.addTc C s� |r| � tj�| jd�tj�| jd�� | j tj�| jd�tj�| jdd�dd� | j tj�| jd�tj�| jd d �dd� d S ) Nz etc/netplan�netplan�%run/NetworkManager/system-connections�NetworkManagerzsystem-connectionsT)� missing_ok�run/systemd/network�systemd�network)� _copy_treer r r r r r )r �backup_config_dirr r r �backupc s �� �zConfigManager.backupc C s z`t | j�D ]}t�| j| � | j|= qd�| j�}d�| j�}tj�|�r>t� tj� | j d�� | � |tj� | j d�� tj�|�r^t� tj� | j d�� | � |tj� | j d�� W d S W d S t y� } zt�d�|�� t�d� t�d� W Y d }~d S d }~ww )Nz${}/NetworkManager/system-connectionsz{}/systemd/networkr@ rC z8Something really bad happened while reverting config: {}zZYou should verify the netplan YAML in /etc/netplan and probably run 'netplan apply' again.���)�dictr r �unlink�formatr r �exists�shutil�rmtreer r rF � Exception�logging�error�sys�exit)r � extra_file� temp_nm_path�temp_networkd_pathr8 r r r �revertn s. � �� ��zConfigManager.revertc C s t �| j� d S r: )rN rO r �r r r r �cleanup� � zConfigManager.cleanupc C s$ z| � � W d S ty Y d S w r: )rZ �FileNotFoundErrorrY r r r �__del__� s �zConfigManager.__del__c C s t �||� d S r: )rN �copy)r �src�dstr r r r; � r[ zConfigManager._copy_fileFc C s. z t �||� W d S ty |rY d S � w r: )rN �copytreer\ )r r_ r` rB r r r rF � s �zConfigManager._copy_treer: )T)F)�__name__� __module__� __qualname__r r �propertyr$ r* r9 r> rH rX rZ r] r; rF r r r r r s r c @ s e Zd ZdZdS )r2 zL Configuration could not be parsed or has otherwise failed to apply N)rb rc rd �__doc__r r r r r2 � s r2 )rf rQ r rN rS r �typingr r? r �objectr rP r2 r r r r �<module> s PK ! K��� � , netplan/__pycache__/__init__.cpython-310.pycnu �[��� o � ed� � @ s d dl mZ egZdS )� )�NetplanN)�netplan.cli.corer �__all__� r r �&/usr/share/netplan/netplan/__init__.py�<module> s PK ! >Q>�B �B . netplan/__pycache__/libnetplan.cpython-310.pycnu �[��� o � edPH � @ s� d dl Z d dlZd dlZd dlZd dlmZmZmZmZmZm Z d dl m Z m Z m Z G dd� de�ZG dd� dej�ZG dd � d ej�ZG d d � d ej�ZG d d � d ej�Ze�ej�d��Ze�e�e��Ze�e�Ze�e�Z e�e�Z ejej _ dd� Z dd� Z!G dd� d�Z"G dd� d�Z#G dd� d�Z$G dd� d�Z%eeeegej&_'eej&_ eeeegej(_'eej(_ de e) d e)fd d �Z*d d � Z+dS )!� N)�c_char_p�c_void_p�c_int�c_uint�c_size_t� c_ssize_t)�List�Union�IOc @ � e Zd ZdS )�LibNetplanExceptionN��__name__� __module__� __qualname__� r r �(/usr/share/netplan/netplan/libnetplan.pyr � r c @ s$ e Zd ZdejfdefdefgZdS )�_GError�domain�code�messageN)r r r �ctypes�c_uint32r r �_fields_r r r r r s r c @ r )�_netplan_stateNr r r r r r # r r c @ r )�_netplan_parserNr r r r r r ' r r c @ r )�_netplan_net_definitionNr r r r r r + r r �netplanc C sd d}|dk r.t �|�}| |�}|dkr|d }q|dk r"td| ��|dkr(d S |j�d�S td��) N� i ���� r zUnknown error: %d�utf-8z&Halting due to string buffer size > 1M)r �create_string_bufferr �value�decode)�function�size�bufferr r r r � _string_realloc_call_no_error9 s r) c G sB t �t�� }t| g |�t �|��R � �}|s t|jj�d���d S �Nr" ) r �POINTERr �bool�byrefr �contentsr r% )�fn�args�err�retr r r �_checked_lib_callK s �r3 c @ sj e Zd ZdZedd� �Zdd� Zdd� Zdee e f fd d �Z d d � Z de fd d�Z de de fdd�ZdS )�ParserFc C s� | j rd S ttj_t�t�gtj_tt t gtj _t tj _tt t gtj _t tj _tt t gtj_t tj_tt t t gtj_t tj_d| _ d S �NT)� _abi_loaded�_NetplanParserP�lib�netplan_parser_new�restyper r+ �netplan_parser_clear�argtypesr � _GErrorPP�netplan_parser_load_yamlr � netplan_parser_load_yaml_from_fd�#netplan_parser_load_nullable_fields�&netplan_parser_load_nullable_overrides��clsr r r � _load_abiU s � zParser._load_abic C � | � � t�� | _d S �N)rD r8 r9 �_ptr��selfr r r �__init__l � zParser.__init__c C � t �t�| j�� d S rF )r8 r; r r- rG rH r r r �__del__p � zParser.__del__� input_filec C s< t |t�rttj| j|�d�� d S ttj| j|�� � d S r* ) � isinstance�strr3 r8 r> rG �encoder? �fileno�rI rO r r r � load_yamls s zParser.load_yamlc C s t tj| j|�d�� d S r* )r3 r8 �"netplan_parser_load_yaml_hierarchyrG rR )rI �rootdirr r r �load_yaml_hierarchyy s zParser.load_yaml_hierarchyc C s t tj| j|�� � d S rF )r3 r8 r@ rG rS rT r r r �load_nullable_fields| s zParser.load_nullable_fields� constraintc C s t tj| j|�� |�d�� d S r* )r3 r8 rA rG rS rR )rI rO rZ r r r �load_nullable_overrides s �z Parser.load_nullable_overridesN)r r r r6 � classmethodrD rJ rM r rQ r rU rX rY r[ r r r r r4 R s r4 c @ s� e Zd ZdZedd� �Zdd� Zdd� Zdd � Zd d � Z d d � Z dd� Z dd� Z dd� Z edd� �Zedd� �Zedd� �Zedd� �Zed d � �Zed d � �Zed d!� �Zed"d#� �Zed$d%� �Zed&d'� �Zed(d)� �Zed*d+� �Zd,d-� Zd.S )/�StateFc C s� | j rd S ttj_t�t�gtj_tt t gtj _t tj _tgtj _t tj _ttgtj_ttj_tttt gtj_t tj_tttt gtj_t tj_tt t gtj_t tj_tgtj_ttj_tgtj_t tj_tgtj_t tj_d| _ d S r5 )r6 �_NetplanStatePr8 �netplan_state_newr: r r+ �netplan_state_clearr< r7 r= �#netplan_state_import_parser_resultsr � netplan_state_get_netdefs_sizer �netplan_state_get_netdef�_NetplanNetDefinitionP� netplan_state_write_yaml_file�#netplan_state_update_yaml_hierarchy�netplan_state_dump_yaml�'netplan_netdef_get_embedded_switch_mode�1netplan_netdef_get_delay_virtual_functions_rebind�netplan_state_get_backendrB r r r rD � s. zState._load_abic C rE rF )rD r8 r_ rG rH r r r rJ � rK zState.__init__c C rL rF )r8 r` r r- rG rH r r r rM � rN z State.__del__c C s t tj| j|j� d S rF )r3 r8 ra rG )rI �parserr r r �import_parser_results� rN zState.import_parser_resultsc C s: |r|� d�nd }|r|� d�nd }ttj| j||� d S r* )rR r3 r8 re rG )rI �filenamerW �name�rootr r r �write_yaml_file� s zState.write_yaml_filec C s2 |� d�}|r |� d�nd }ttj| j||� d S r* )rR r3 r8 rf rG )rI �default_filenamerW rn ro r r r �update_yaml_hierarchy� s zState.update_yaml_hierarchyc C s |� � }ttj| j|� d S rF )rS r3 r8 rg rG )rI � output_file�fdr r r � dump_yaml� s zState.dump_yamlc C s t �| j�S rF )r8 rb rG rH r r r �__len__� s z State.__len__c C s( t �| j|�d��}|st� �t| |�S r* )r8 rc rG rR � IndexError� NetDefinition)rI �def_id�ptrr r r � __getitem__� s zState.__getitem__c C s t dd� t| d �D ��S )Nc s � � | ]}|j |fV qd S rF ��id��.0�ndr r r � <genexpr>� � � z!State.all_defs.<locals>.<genexpr>��dict�_NetdefIteratorrH r r r �all_defs� � zState.all_defsc C � t dd� t| d�D ��S )Nc s r| rF r} r r r r r� � r� z"State.ethernets.<locals>.<genexpr>� ethernetsr� rH r r r r� � r� zState.ethernetsc C r� )Nc s r| rF r} r r r r r� � r� z State.modems.<locals>.<genexpr>�modemsr� rH r r r r� � r� z State.modemsc C r� )Nc s r| rF r} r r r r r� � r� z State.wifis.<locals>.<genexpr>�wifisr� rH r r r r� � r� z State.wifisc C r� )Nc s r| rF r} r r r r r� � r� z State.vlans.<locals>.<genexpr>�vlansr� rH r r r r� � r� z State.vlansc C r� )Nc s r| rF r} r r r r r� � r� z State.bridges.<locals>.<genexpr>�bridgesr� rH r r r r� � r� z State.bridgesc C r� )Nc s r| rF r} r r r r r� � r� z State.bonds.<locals>.<genexpr>�bondsr� rH r r r r� � r� z State.bondsc C r� )Nc s r| rF r} r r r r r� � r� z State.tunnels.<locals>.<genexpr>�tunnelsr� rH r r r r� � r� z State.tunnelsc C r� )Nc s r| rF r} r r r r r� � r� z State.vrfs.<locals>.<genexpr>�vrfsr� rH r r r r� � r� z State.vrfsc C r� )Nc s r| rF r} r r r r r� � r� z"State.ovs_ports.<locals>.<genexpr>z _ovs-portsr� rH r r r � ovs_ports� r� zState.ovs_portsc C r� )Nc s r| rF r} r r r r r� � r� z#State.nm_devices.<locals>.<genexpr>z nm-devicesr� rH r r r � nm_devices� r� zState.nm_devicesc C � t �t �| j���d�S r* )r8 �netplan_backend_namerj rG r% rH r r r �backend� r� z State.backendc C sN t �� �}| j|d� t�d�|�� �� W d � d S 1 s w Y d S )N)rs zMerged config: {})�tempfile� TemporaryFileru �logging�debug�format�read)rI �tmpr r r � dump_to_logs� s "�zState.dump_to_logsN) r r r r6 r\ rD rJ rM rl rp rr ru rv r{ �propertyr� r� r� r� r� r� r� r� r� r� r� r� r� r r r r r] � sJ $ r] c @ s e Zd ZdZedd� �Zdd� Zdd� Zedd � �Z ed d � �Z ed d � �Z edd� �Z edd� �Z edd� �Zedd� �Zedd� �Zedd� �Zedd� �Zed d � �Zed d � �Zed d!� �Zed"d#� �Zed$d%� �Zed&d'� �Zd/d)d*�Zed+d,� �Zed-d.� �Zd(S )0rx Fc C sz | j rd S tgtj_ttj_tttgtj _t tj _tttgtj _t tj _tgtj _ttj _tgtj _ttj _tttgtj_t tj_tgtj_ttj_tgtj_ttj_tgtj_ttj_tgtj_ttj_tgtj_ttj_tgtj_ttj_tgtj_ttj_tgtj_ttj_tgtj_ttj_tgtj_ttj_tgtj_ttj_ttt gtj _ttj _tgtj _ttj _d| _ d S r5 ) r6 rd r8 �netplan_netdef_has_matchr< r r: r r �netplan_netdef_get_idr �netplan_netdef_get_filepath�netplan_netdef_get_backend�netplan_netdef_get_type�netplan_netdef_get_set_name� _netplan_netdef_get_critical� netplan_netdef_get_sriov_link� netplan_netdef_get_vlan_link� netplan_netdef_get_bridge_link� netplan_netdef_get_bond_link� netplan_netdef_get_peer_link�_netplan_netdef_get_vlan_idr �%_netplan_netdef_get_sriov_vlan_filter� netplan_netdef_match_interfacer� �netplan_def_type_namer^ r= �#_netplan_state_get_vf_count_for_def�'_netplan_netdef_is_trivial_compound_itfrB r r r rD sR zNetDefinition._load_abic C s* t |d�sdS t�| jj�t�|jj�kS )NrG F)�hasattrr � addressofrG r. )rI �otherr r r �__eq__G s zNetDefinition.__eq__c C s | � � || _|| _d S rF )rD rG �_parent)rI �np_staterz r r r rJ L s zNetDefinition.__init__c C � t t�| j��S rF )r, r8 r� rG rH r r r � has_matchS � zNetDefinition.has_matchc � t � fdd��S )Nc � t �� j| t| ��S rF )r8 r� rG �len��brH r r �<lambda>Y � z(NetDefinition.set_name.<locals>.<lambda>�r) rH r rH r �set_nameW r� zNetDefinition.set_namec C r� rF )r, r8 r� rG rH r r r �critical[ r� zNetDefinition.criticalc C � t �| j�}|rt| j|�S d S rF )r8 r� rG rx r� �rI �link_ptrr r r � sriov_link_ � zNetDefinition.sriov_linkc C r� rF )r8 r� rG rx r� r� r r r � vlan_linkf r� zNetDefinition.vlan_linkc C r� rF )r8 r� rG rx r� r� r r r � bridge_linkm r� zNetDefinition.bridge_linkc C r� rF )r8 r� rG rx r� r� r r r � bond_linkt r� zNetDefinition.bond_linkc C r� rF )r8 r� rG rx r� r� r r r � peer_link{ r� zNetDefinition.peer_linkc C s" t �| j�}|td�jkrd S |S )N���)r8 r� rG r r$ )rI �vlan_idr r r r� � s zNetDefinition.vlan_idc C r� rF )r, r8 r� rG rH r r r �has_sriov_vlan_filter� r� z#NetDefinition.has_sriov_vlan_filterc C r� r* )r8 r� r� rG r% rH r r r r� � r� zNetDefinition.backendc C r� r* )r8 r� r� rG r% rH r r r �type� r� zNetDefinition.typec r� )Nc r� rF )r8 r� rG r� r� rH r r r� � r� z"NetDefinition.id.<locals>.<lambda>r� rH r rH r r~ � r� zNetDefinition.idc r� )Nc r� rF )r8 r� rG r� r� rH r r r� � r� z(NetDefinition.filepath.<locals>.<lambda>r� rH r rH r �filepath� r� zNetDefinition.filepathc C s t �| j�}|o |�d�S r* )r8 rh rG r% )rI �moder r r �embedded_switch_mode� s z"NetDefinition.embedded_switch_modec C r� rF )r, r8 ri rG rH r r r � delay_virtual_functions_rebind� r� z,NetDefinition.delay_virtual_functions_rebindNc C s4 t t�| j|o |�d�|o|�d�|o|�d���S r* )r, r8 r� rG rR )rI �itf_name� itf_driver�itf_macr r r �match_interface� s �z NetDefinition.match_interfacec C sD t �t�� }t�| jj| jt �|��}|dk r t|j j � d���|S )Nr r" ) r r+ r r8 r� r� rG r- r r. r r% )rI r1 �countr r r �vf_count� s zNetDefinition.vf_countc C r� )z� Returns True if the interface is a compound interface (bond or bridge), and its configuration is trivial, without any variation from the defaults. )r, r8 r� rG rH r r r �is_trivial_compound_itf� s z%NetDefinition.is_trivial_compound_itf)NNN) r r r r6 r\ rD r� rJ r� r� r� r� r� r� r� r� r� r� r� r� r� r~ r� r� r� r� r� r� r r r r rx sV ? rx c @ s< e Zd ZdZedd� �Zdd� Zdd� Zdd � Zd d � Z d S ) r� Fc C sp | j rd S ttd�std��ttgtj_ttj_ tgtj _t tj _ tgtj _d tj _ tgtj _ttj _ d| _ d S )N�#_netplan_iter_defs_per_devtype_initz� The current version of libnetplan does not allow iterating by devtype. Please ensure that both the netplan CLI package and its library are up to date. T)r6 r� r8 r r^ r �&_netplan_state_new_netdef_pertype_iterr< r r: �#_netplan_iter_defs_per_devtype_nextrd �#_netplan_iter_defs_per_devtype_free�_netplan_netdef_idrB r r r rD � s z_NetdefIterator._load_abic C s, | � � || _t�|j|o|�d��| _d S r* )rD r� r8 r� rG rR �iterator)rI r� �devtyper r r rJ � s z_NetdefIterator.__init__c C s t �| j� d S rF )r8 r� r� rH r r r rM � s z_NetdefIterator.__del__c C s | S rF r rH r r r �__iter__� s z_NetdefIterator.__iter__c C s t �| j�}|s t�t| j|�S rF )r8 r� r� � StopIterationrx r� )rI � next_valuer r r �__next__� s z_NetdefIterator.__next__N) r r r r6 r\ rD rJ rM r� r� r r r r r� � s r� �patch_object_path� patch_payloadc C s* t tjd�| ��d�|�d�|�� � d S )N� r" )r3 r8 � netplan_util_create_yaml_patch�joinrR rS )r� r� � patch_outputr r r �create_yaml_patch� s �r� c C s" t tj| �d�|�� |�� � d S r* )r3 r8 � netplan_util_dump_yaml_subtreerR rS )�prefixrO rs r r r �dump_yaml_subtree� s �r� ),r� r� r � ctypes.utilr r r r r r �typingr r r � Exceptionr � Structurer r r r �CDLL�util� find_libraryr8 r+ r= r7 r^ rd � netplan_get_id_from_nm_filenamer: r) r3 r4 r] rx r� r� r< r� rQ r� r� r r r r �<module> s> 2 <. PK ! gU p p - netplan/__pycache__/_features.cpython-310.pycnu �[��� o ���d[ � @ s g d �Z dS ))zdhcp-use-domainsz auth-phase2zipv6-mtu�modems�sriov� openvswitchzactivation-modez eswitch-mode� infiniband�regdom�vrf�vxlanz dbus-configzgenerate-just-in-timezgenerated-supplicantzdefault-routesN)�NETPLAN_FEATURE_FLAGS� r r �'/usr/share/netplan/netplan/_features.py�<module> s PK ! ^^�[ [ netplan/_features.pynu �[��� # Generated file NETPLAN_FEATURE_FLAGS = [ "dhcp-use-domains", "auth-phase2", "ipv6-mtu", "modems", "sriov", "openvswitch", "activation-mode", "eswitch-mode", "infiniband", "regdom", "vrf", "vxlan", "dbus-config", "generate-just-in-time", "generated-supplicant", "default-routes", ] PK ! !��b netplan.scriptnu ȯ�� #!/usr/bin/python3 # # Copyright (C) 2018 Canonical, Ltd. # Author: Mathieu Trudel-Lapierre <mathieu.trudel-lapierre@canonical.com> # # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation; version 3. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty 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, see <http://www.gnu.org/licenses/>. '''netplan command line''' from netplan import Netplan netplan = Netplan() netplan.main() PK ! 8��� � generatenu ȯ�� ELF > , @ � @ 8 @ @ @ @ � � 8 8 8 �� �� �� �� �� @ Ț Ț Ț P P T T T D D P�td �� �� �� � � Q�td R�td �� �� �� ` ` /lib64/ld-linux-x86-64.so.2 GNU GNU 9�QC}� ��P��p���� [ �� Y� � [ ^ e �SZ&��|CE���fԬK�أ�?�qX ��o >"h�������CE � � � D m � B � � � 1 G < V � � ` z X b o & x % � � � � � g Q 5 � J " * � x � � � . � ! s � � � � � � Y � q n � ( � � � + C > � K [ � � | P g / g � [ E � � � � (� � �� r � U � � p 2 @� y � � �� � �� � � � p � `� libnetplan.so.0.0 g_string_sized_new _ITM_deregisterTMCloneTable g_object_unref g_fprintf g_str_equal g_strjoin g_hash_table_lookup g_file_new_for_path g_ascii_strcasecmp g_assertion_message_expr g_string_free g_hash_table_iter_next g_ascii_strtoull g_strcmp0 g_hash_table_new_full __gmon_start__ g_hash_table_size g_hash_table_insert g_string_append_printf g_log g_str_hash g_hash_table_iter_init _ITM_registerTMCloneTable g_hash_table_foreach NETPLAN_WIFI_WOWLAN_TYPES wifi_frequency_5 wifi_get_freq5 _fini netplan_finish_parse NETPLAN_OPTIONAL_ADDRESS_TYPES missing_ids_found safe_mkdir_p_dir wifi_frequency_24 unlink_glob tunnel_mode_to_string missing_id current_file netplan_parse_yaml netplan_get_global_backend netdefs wifi_get_freq24 g_string_free_to_file netdefs_ordered libgio-2.0.so.0 g_path_get_basename g_hash_table_get_keys g_list_foreach g_list_free g_string_new g_access g_strv_length g_ptr_array_add g_strdup_printf g_ptr_array_free g_option_context_set_summary g_strchomp g_list_sort g_strchug g_uri_escape_string g_build_path g_option_context_new g_hash_table_unref g_error_free g_ptr_array_new g_option_context_set_description g_string_append g_spawn_check_exit_status g_option_context_set_help_enabled g_file_info_get_symlink_target g_file_query_info libgobject-2.0.so.0 libglib-2.0.so.0 g_string_printf g_option_context_parse g_string_overwrite g_option_context_add_main_entries g_spawn_sync libuuid.so.1 uuid_is_null uuid_unparse uuid_generate libpthread.so.0 __errno_location libc.so.6 exit fopen __stack_chk_fail unlink strpbrk symlink strlen strstr fclose umask __ctype_b_loc stderr __cxa_finalize strcmp __libc_start_main _edata __bss_start _end udev_rules _IO_stdin_used GLIBC_2.2.5 UUID_1.0 GLIBC_2.27 GLIBC_2.4 GLIBC_2.3 � ui � � �'� � � ��� � ii � ii � ui � �� - �� �, �� �� �� �� �� �� � � � d� 8� � @� �� P� G~ h� �� p� � x� m� �� ~� �� � �� X� �� �� �� �� �� �� # �� * ȟ 5 П = ؟ A � C � I � U �� V 0� 8� @� H� P� X� `� h� p� x� �� �� �� �� �� �� �� �� �� ȝ Н ؝ � � � �� � � ! � " � $ � % (� & 0� ' 8� ( @� ) H� + P� , X� - `� . h� / p� 0 x� 1 �� 2 �� 3 �� 4 �� 6 �� 7 �� 8 �� 9 �� : �� ; Ȟ < О > ؞ ? � @ � B � D �� E � F � G � H � J � K (� L 0� M 8� N @� O H� P P� Q X� R `� S h� T p� W x� X �� Y �� Z H��H�̀ H��t��H��� �5:~ �%<~ @ �%:~ h ����%2~ h �����%*~ h ����%"~ h ����%~ h ����%~ h ����% ~ h ����%~ h �p����%�} h �`����%�} h �P����%�} h �@����%�} h �0����%�} h � ����%�} h �����%�} h � ����%�} h ���%�} h ����%�} h �����%�} h ����%�} h ����%�} h ����%�} h ����%�} h ����%�} h �p����%z} h �`����%r} h �P����%j} h �@����%b} h �0����%Z} h � ����%R} h �����%J} h � ����%B} h ���%:} h ����%2} h! �����%*} h" ����%"} h# ����%} h$ ����%} h% ����% } h& ����%} h' �p����%�| h( �`����%�| h) �P����%�| h* �@����%�| h+ �0����%�| h, � ����%�| h- �����%�| h. � ����%�| h/ ���%�| h0 ����%�| h1 �����%�| h2 ����%�| h3 ����%�| h4 ����%�| h5 ����%�| h6 ����%�| h7 �p����%z| h8 �`����%r| h9 �P����%j| h: �@����%b| h; �0����%Z| h< � ����%R| h= �����%J| h> � ����%B| h? ���%:| h@ ����%2| hA �����%*| hB ����%"| hC ����%| hD ����%| hE ����% | hF ����%| hG �p����%�{ hH �`����%�{ hI �P����%�{ hJ �@����%�{ hK �0����%�{ f��%| f�AWAVH��AUATUSH��� �|$,H�8H�t$ H�5vi H�D$8 dH� %( H��$� 1����1�I���~���M��H���� H��1�H�l$8�s���H�5tj H������H�5�j H�����H�5�{ 1�H������H�T$ H�t$,H��H��� �����tvH�=|| H��t������� H�D$ H�55k H�H�C{ 1�A� H�81��9���H����H��$� dH3 %( D���� H��� []A\A]A^A_�H�D$8H�5�h H�P�H�5�i H��H�l$8�?���H�5�i H������H�5�z 1�H�����H�T$ H�t$,H��H���J�����t�H� �{ H��� H�5�{ H���� H� 2h H��g E1�1�1�����H�5u{ H�D$H���� H� h H��g E1�1�1����H�5F{ H�D$H���l H� �g H��g E1�1�1�L�t$P�y���H��y H�5z 1�H�=�y I���Z���1�1�L��L��I���8������8 ���/ L��H��y H�5�g H�81����M��tL���_���L��A� �Q���H�|$�G���H�|$�=����?���H�;H��t �{H H��u�1�H��� ���H� Ty H�H�D$8H���, H�=Lz ��F H�=@z �" H�- z H� y H���� H�8 �+ 1�������� M���� �=�y �2 H�56g H������H���. H��E1��1������H�5 W ���H�5 W �M���H�5�V ����H�|$1�L�� �����tq��tlH�T$���H�ry H�0H�������H��e H�=�e 1�1�����1�H��H�������A�������H� x H�59h H��H�81���������L��L�t$1Ҿ L���X������ ��� L����������H�=+h H��H�D$1����H��I�����H�5�e E1�1�1�H��I����H��I��H�D$ t H���w���H�����L��H�D$����L��L�t$PL�d$@���L��L�l$H����H�Lw L��H�0���L��L��L���s������, L�|$HH��I��8 �����t#I�H���w�����tI��P H���d�����u�H�|$L������E1��*H�D$XJ��I��H��H�T$����H�T$H��L���r���L9t$Pw�L���C���H�5|v H�����H�D$I���I�6L������H���E M�vM��u�H�D$H��tH���,���M��tL������L������H�|$���H�|$������E1����H�-/w 1��h���H�Q 1�H��H���������H�D$�x �- H�|$ t]H��u L��H�0�&���� H�l$HH�t$H��@ �.������9 L��L��L�������u�H�|$�Z���H�D$�x� A� H�|$� ����8���H�8 �]���H��c �� 1�1����H�3u H�Tv H�5 D H�8���H�=>v � H�\c HDŽ$� H��$� E1�E1�� H��$� H�<c 1�1�H��$� H�1c H��$� j j j j ��H�� ���H�|$ ��������H��u H�8�B ���L��b H� @f H�5�b � 1��-���H�|$H���������H� H�!o H��H�=�d E1�H� �pH��8 H��H�p��@ L��H L��P 1���XZ����G���H�PH�t H�5�a H�81��� ��1�I��^H��H���PTL��C H� sC H�=�����~s � D H�=�t UH��t H9�H��tH�bs H��t ]��f. � ]� @ f. � H�=it H�5bt UH)�H��H��H��H��?H�H�tH�s H��t ]��f � ]� @ f. � �=t u/H�=�r UH��t H�=*s �����H�����s ]� � ��f D UH��]�f���f D 1��?t �� � H�� � u苗 ��u�H�� u�H�� u�H��8 u�H��@ u�1�H��H ��ÐAUATI��USH��H�5�B H��H�����I�$�P��t0L�-B 1� D H� ��L��H���H��1��o���I�$;Xr�H��H��H�5nP []A\A]�=��� f. � USH��H�5(B 1�H��H��H���#����C���? ��� ���� H�SH��tH�5B H��1����H�SH��tH�5�A H��1����H�SH��t �;�� H�S H��tH�5�A H��1���H�S(H��tH�5�A H��1���H�S0H��tH�5�A H��1��q�H�S8H��tH�5�A H��1��W�H�S@H��tVH��H��H�5�A []1��7� � H�5#N H��1�� ��[���f. � H�5A H�������� @ H��[]ÐH�5�@ H��������� @ H�5�@ H������� @ �tBUSH��H��H��H��@ H��tJH�-�q H�} H��t"H��H�5_G 1�[]�~�f D ��f D �{�H��@ H��H�E �� H��H H��t,H�5�@ H��1��;�H��H��H�5�@ []��f D H��P �H��t*��w6H��8 H��HE�H�5�@ H��1����� @ H��8 H��t ��v�H�S�҃�w���uH�5a@ H�����x���H� K H�5T@ E1��C 1���f D L�E�HE���� AWAVI��AUATA��USI�Խ 1�H��H�|$ D I���L�<�E9/�� I�H��tH�5�? ����L I�H��tH�5�? �d��� A�W���� I� �� A�G8��uhI�O(M�G0H�5�? ��1�L�����A�W<���tH�5�? L��1���H�5�L L�����M���A;X�>���H��[]A\A]A^A_���H�D$H�5�F H�H�'n H�81��%�� ��H�D$H�5GF H�H��m H�81���� ��H�D$H�5�E H�H��m H�81����� �W�H�D$H�5kE H�H��m H�81���� �-�H�D$H�5 E H�H�m H�81��}�� �� AWAVI��AUATI��USH��H��8dH�%( H�D$(1����t*H��t}L��> H� /I H�5> �� 1���� @ H���� 1��X�H�SH�5�C H��H��1��0�I�UH�5�C H��1���;�� �H�IH Hc�H��u�� ���� 1���H�SH�5dC H��H��1����� @ H��= �H�5> 1�H������ ��t��X ���� ���� H��8 H���$ H�5�= 1�H���k������ H�� H��ttH�5�> 1�H���C�D��� E��u D��d E��tKH�5�> 1�H������� ��tH�5�> H��1�����d ��tH�5~= H��1���� @ H�� H��tH�5v> H��1������4 ���� 1��;�� ����\ 1�I��H��H�5R> ��1���H��8 �& H��( H��tH�5C> L��1��Y���0 ���� ��` ��vH�58> L��1��/�I�|$ t%����| ��tI�$H�52> H��1���� L��������z ��� ���� H�5�? H����M��t A�} �1 D�{,E���� H��� �� H�5�; H����H��� H��t>D�`E��t5L�=�? E1�H� D��A��L��H��H� �1�D���R�H��� D;`r�H��� H��tH�5�? H��1��(�H��� teH�5�? H����H��� D�XE��t7L�=�9 E1� D H� D��L��H��A��H��1����H��� D9`w�H�5�G H����H��� �� H��� tH��� H������H��� tH��� H�{� H�����D�KTE���s D�C,E��t�Sh���tH�5�> H��1��A��{0��uH��� �� H�5�> H��� ��K0H�": H�5(: H���HE����H��� H��t=�P��t6L�=I> E1�H� D��A��L��H��H� �1�D�����H��� D;`rՋ�� ��� D��� E���� H��� H��tH�5�= H��1��z�H��� tgH�5�= H���Q�H��� D�`E��t9L�=:8 E1� � H� D��L��H��A��H��1��%�H��� D9`w�H�5'F H����H��� tH��� H���0���H��� tH��� H�{� H���>���D��� E���� ��� ���tH�5]= H��1���M���I I�}1�� ��H��H�SL� }= j H� �E H�5�@ I��1�I��1���I��A�E AYAZ���� �� ���� H� u8 I�UH�57= 1�H��� �I�UH��tH�5cE H��1���A�E�P����� E�EpE���E L���]��? ���1ɉ�L��L��H���������L���2�H�D$(dH3%( �: H��8[]A\A]A^A_� � H�v7 ��� @ H�a7 ��� @ H�E7 ��� @ H��6 ��� @ H�*7 �|��� @ H����H�7 ��H��6 HE��W��� � ��H��( I��H��tH�5�8 H��1������0 ���= I�|$ ������� @ H������� H�5�7 H��1���D�� E���G H�� H��� H�5�7 1�H���v�H��0 H��tH�5]B H��1��Y�H��P H��tH�5P7 H��H��1��9�H�� H��tH�5=7 H��1�� ���0 ��� H�� H��tH�5(7 H��1����H��( H��tH�57 H��1����H��8 H��tH�57 H��1���H��@ H��tH�5�6 H��1���H��H H���*���H�5�6 H��1��y����� @ �� ����1 H�� �s H�5�7 H��1��B�H�� ��X ���m L�gL������tL����H�� I��L��H�x���L��H�5VQ 1�H��������������� ��H��p I��H��tH�5A7 H��1���H��x H��tH�5-7 L��1���H��� H��tH�5 7 L��1��|���� ���� H��� H��tH�5 7 L��1��Q�H��� H��tH�57 L��1��4���� ���F H��� H��tH�5�6 L��1�� �H��� �� H�5�6 1�L��E1����H��� �P���� D H� D��H�50B L��A��H��1���H��� D;x�` E��t�H�5L3 1�L����H��� 뱐H�SH�5�3 1�H���k���������D��� E������ �v�H��X I��H��tH�5�3 H��1��&���` ��tH�5�3 L��1�� �H��h H��tH�5�3 L��1����H��p H��tH�5�3 L��1����H��x H��tH�5|3 L��1���D��� H��2 H��2 H�5b3 L��E��HE�1���I�$H�5N3 H��1��r�� L�������f D D��X E���X L��P M�����H�5�2 L�����H���> L���� � D�S,E���X����CT������� � H�5m6 H�����H�5w6 H������j��� D H�5E6 H����H�5O6 H������� D H�5v6 H������� @ ��� ���w H��1 H�536 H��1��^����f � H�SH� H6 H�5�9 E1�1�1��b��� I�ą��D������ ���6���H��� H������"��� � H�5 1 H������U��� @ �;� H�5"5 H�����4��� H� �0 ��� @ H� �0 �s��� @ A�}(�������H�5�5 H���u�A�E(��� ���� ���� A�u,���u���I�}(H�����d���f � H��� H��tH�583 L��1��#�H��� H��tH�5,3 L��1���H��� H��tH�5#3 L��1����H��� H��tH�53 L��1����H��� H��tH�53 L��1������ ���� ��� ���c H��� H��tH�53 L��1��v���� ��� H��� H��tH�53 L��1��K�H�� H��tH�53 L��1��.�I�|$ tI�$H�5�2 H��1���� L���������!�H�5�2 H�������� H�5�2 1�H�����H��� H�5�2 1�H����H��� H�5�2 1�H����H��� H��tH�5�2 H��1���H��� H�����H�5�2 H��1��e���H��� �&�H��� ���� ��� �H�53 H�������f�H�KH��5 1��� 1���1����I��� H�5�. H��1������;���f�L�cL�������tL�����I��L��L�����H�5. L��H��1����� �H�5�/ L��1�������f. � H�5p/ L��1��o��� �f. � H��- ��� @ H��H H�����H�5 / L��1��/����f. � ��H�]- H��, H�522 H��HE�1����A�} �����A�}�q ���A�U H�52 H��1�������� @ H�W��� � L��, H� b7 H�5J, �� 1���� � H�5�0 H���i����� @ H��P H��0 H���� H�����H�59- H��1��?������f. � L�d. H� �6 H�5�+ �R 1���� � H�5&- H��1�������f�H�S�k� � L�-. H� �6 H�5z+ �S 1��/�� � H�5�/ H������� @ I�$H�5�- H��1������f D H��� ����%����-�����H�5�0 H���I����� @ H�5�. L��1��?������f. � H�5�. L��1�� �����f. � H�5e. L��1������� H�5_. L��1������B��� H�5�- L��1��������f. � H�5\- L��1�����<���H�5�/ H�����I�U@H���(���H�5e6 H��1��}������H�5�/ H���Y������O��H� 5 H�5 * E1��u 1����H� �4 H�5�) E1��� 1����H�SH�5"2 H��X H�81������ �O��H� �4 H�5�) E1��� 1��R��H�SH�5�1 � D AVAUATUSH��H��@D�GdH�%( H�D$81�A��uWH��@ H��tH��8 �� �;H��h �| H��tgL�'/ H� I4 H�5) �� 1�����f D H�OH��1 �� 1��I��H�D$8dH3%( �� H��@[]A\A]A^� � 1�H��H���S��ȐH��tCL�d$L�t$I��L������ @ H�T$H��H��� �L��L��L��������u�� @ L�U. H� �3 H�5R( �� 1����H�HW H�WH�5=1 H�81��;��� ����\��f�f. � H�W ATUH��SH�8�:����u[]A\ÐH�=A1 �D��L�`H��H��H��V H�5\�H�8���L9cw6� H�����H��W H�8H��t�[H��H�W1 1�]A\� �� D H�1 1�H��H������f�ATUH��SH� �4 H�C1 H��HE�1�1�H��1�����H�O1 1�H��I��1�1����L��H���C��H���;��H�5d1 H��� ��H������[L��]A\���� � ATUH��SH�5 2 H��H��A�����H��@ H��tH�52 H��1����H��H H��tH�5�1 H��1�����E��uEH��P H��tH�5�1 H��1�����H�� tJH��H tJ[H��H�5�1 ]A\�����;w;H��8 H��tOH�5{4 1�H���~��H�� u�H�� u�[]A\� D H�SH�5H4 H��1��K���f � H��P H��u��g��� D f. � H��H�5N1 1�� �� f. � AUATI��USH��H��H������ �� ���C ��u H�5>1 ����C���> ���] ��uH�5.1 H�����H�SH��tH�591 H��1����H�SH��tH�501 H��1��e��L�kM��t9�;� H�=>1 � L��L����� ���2 H�5#1 H���#��H�S H��tH�5+1 H��1�� ��H�S(H��tH�5!1 H��1�����H�S0H��tH�51 H��1�����H�S8H��tH�51 H��1����H�S@H��tRH��H��H�51 []A\A]1���� � H�5�/ �t���C������H�5 0 H���Y������ @ H��[]A\A]� D H�5�/ H���1����� @ L�����H��@tzH��H��7�� H�5�/ L��H��1������� H�5 0 H��1���������f. � H�5/ ����� ��� � H�5/ ������ � �{��I�u@H�8L��H��DOt"H��H9�u�H�5a/ L��H��1��x���P���H�58 L��H�R H�81����� ���L��H�5,8 ��f�AWAV1�AUATUSH��H�� H�W1�H�t$H�5P8 dH�%( H��$� 1��0���;H�D$�� H��8 �� �� � ��1�H��H��H�����H�5L/ H�����H��8 H��tH�5�0 H��1������\ H�/ H�/ H�5/ H���HE�1��s����0 ���5 H��( H��tH�5T- H��1��H��� �^��H�T$H�t$H� �. A��H���b��D���:��H�SH� �. H�5�. E1�1�1��,���;H���0 H��8 �" H��H � �� ���H�57 H��I�����H��@ H���� H�5x. L��1����H��H H��tH�5{. L��1��z��H��8 H�5y. 1�L���b��� �x��H�t$1�A��H��L�����D���[��H�����D�CA��t{H�KH��6 �� 1�1�E1�� ��H�|$���H��$� dH3 %( D���� H�ĸ []A\A]A^A_� � H��@ ���f�H���8��D�CA��u������ ���� �� ���� ���W �� ����� I�����H�{ H���n �s ���� L�=�N I�H���P E1�1�L�%�0 � f�A�EH��I��H��I�H���% H���K$A�Lt�L��L��1������ � ��\ ���������0 ����H��( �������H�D$H�KH�5�, L�4 H��5 H��HE�E1�1�1����H�SH� �3 H�5�5 E1�1�I��1�����;H�D$u��X ���� H�6 �� 1�1��Q��H�="6 �E��H�SH� i3 H�5;, E1�1�H��1��D��H�KH�6 H�D$ I��1�1��� ����;�* ��` �e H��h L�d$`L�l$XL�5, L������H�\$(�%f D H�VH��H��(���H�5!, H�����1�L��L��������� H�D$XL��H��H�P1��f��H�t$XH�VH��tH�5�+ H��1��G��H�t$X�F���� ���� ����� ���� �Fp���^���H�5E) H�������Z���f. � ��0 ���� ��d ���d �S,�C0���� ��� H�5v. H�����H�� �� H�5�. H�����H��� H��t>D�hE��t5L�%{( E1� H� D��L��H��A��H��1��U��H��� D;hr�H��� H��tDD�`E��t;L�%1( E1�f � H� D��L��H��A��H��1����H��� D;hr�D��� E���� ��� ���) ���� D��� E���� H��� H��tH�5%. H��1����H��� H��tH�5. H��1����H��� H��tBD�HE��t9L�%�- E1� � H� D��L��H��A��H��1��E��H��� D;hr�H��� H��tDD�@E��t;L�%�- E1�f � H� D��L��H��A��H��1����H��� D;hr�H��� H��tkH� H�5^- H��H�1�����H��� �xv8L�%H- A� H� D��L��H��A��H��1����H��� D;hr�H�5�( H���a����4 ���; �;� H�� H��tnH�5- H��1��=����� ��u ��d ��tIH�5�, 1�H�������� ��tH�5�, H��1������d ��tH�5) H��1�����f�H�� H��t,H�5�, 1�H������H�� tH�5�, H��1������ ��t^H�?I L� M��tOL�-�, �f D M�d$M��t6I�$H;� u鋐 ��u�H�PL��1�H���N��M�d$M��u� @ H��� H���� �B���u E1�L�-(, �uf � I�H�5� �0����� A�G8��� A�W<���tH�5>, H��1�����A�W��tH�50, H��1����H��� A��D;b�� H�D��L��H��L�<�1����H�5�+ 1�H��I�W(�x��I�W0H��tH�5�* H��1��^��I�W H��tH�5u+ H��1��D��I�H�5� �d����� ���I�WH�5\+ H��1��������f����Y���H�5�) H�������E��� @ I�WH�5*+ 1�H������A�G8�����H�5+ H��1��������f � H��� H��� D�bE���� E1�L�- + �\ � A�W ���tH�5 + H��1��f��A�W ���� A�W$���tH�5+ H��1��@��H��� A��D;b�� H�D��L��H��L�<�1����I�WH��tH�5�* H��1����I�WH��tH�5�* H��1�����A�W���T���H�5:* H��1������>���f D H�5[* H��1�����H���f�D�[,E��u D�S0E���� H�5P* H���k��D�C(E��tH�5A* H��1��a���C,��u �{0���� H�{8H�53* �o������ �s,�C0���A ��D�c@�] �spD9��H H��� H�{X�1�����# �Ct9CD� �Cx9CH�� �C|9CL�� ��� 9CP�� H��� H�{`�������� �Sh;�� �{ D�kTD;�� �= �CDD�c@�KPL�{X�D$(�CH�D$�CL�D$ H�C`H�D$0����L$<�` �;�X �d H�5�) H��D�1��7���L$<���� H�5�) H��1����E���� E���� M��tH�5�) L��H��1������L$(���� �T$���� �D$ ���� H�D$0H��tH�5�) H��H��1����H�} uI�~ A� ���� ���� H��H��I���8�I�~ �� H�} �� � L������ H������� �^��H�T$H�t$H� Q) ��L��A� �]�����6����H�� �a���H��� �S���D��� ��� E��� ��� H�5�% H������0���f�H�5D" H��L�d$`L�l$X���H�SH��� H����H�5" H���u���? ���H�T$ H�t$1�A��H��H�l$P���D���w��H�|$ ����H�L$H��+ 1�1��� �C��H��! H��$� H�D$P H�D$X H�D$` H�=H0 H��$� H�CE1��D$L HDŽ$� E1�1�1�H��$� UH�D$TPATAU���H�� �|$LH�����H�|$P �� H�|$X�z��H���2��H�=4! ���H�T$XH� �' H�5�) E1�H��1�1����H�T$XH�5x+ H��I��1��K��H�5� H���,��H�T$XH�5�+ 1�H���&��H�T$XH�5�+ 1�H�����H�5�+ H������H�5� H������H�T$XH�5�+ 1�H��H�������;tH�5� H�����H�t$1�L��H����L���+��H�|$`�!��H�|$X���H�|$PH��t���H��+ 1�L���� 1����L���X���H�|$L���+�����y�"���8�� H�|$���L������������u�� ���7 �� �?���H�SH�5� H��H��1����H��( H��tH�5� H��1�������0 ���� ����� �� ���r ���; ��� ���s ���� ���v ��v ���h ���H�5c! H��H��1��a���� ���H�5j! H��I��1��#������ �G����� H��� H�5X! 1�L�����H��� H�5J! 1�L�����H��� H��tH�58! L��1�����H��� H��tH�5(! L��1�����I�$H�5!! H��1����� L���E���� ���H�T$H�t$H� � A��H��迾��D������������� �����H�KH�� �� 1�1�A� �O���-�f. � H�5� 1�H��� ��H��( H��������f. � D�K(E��������d���f D ���sp�U D�c@��� @ H�5C L������i� @ H�5f H������� @ H�5 H�����H�t$X�n� � H� i? H�; �� �~ ��tH�#���H�5� ��H��1��P���H�t$X��f D H��? H�8 �� �~ ��tX���뾐H�5� H��1�����H�;H�5��H���=���H�EH� H��H�p��&���H�t$XH����f � H�5: H��1����H�? H��H�5��H�8�f � H�\$(����f D H�5" H��1������`���f. � H�5 H���Q����� @ H�5� L��1��G����`�f�H�5� H���!������ @ H�5� H��1�������f�H�5f H�����<� @ H�5a! H��1�����L$<���f D � 莾��H�t$X�U��� @ H�5� L��衿���� @ H�U H�5�! L��1�蓿���,���f D I�H�5�! L��1��t������� � H�S8H�5Q H��1��S�������f D H�5� H��1��7����*���f�H�5� H��1�� ���� ���f. � H�5� H��1�����#���f. � H�5� H��1��߾�����f. � H�5� H��1�迾�����f. � H�5� H��1�蟾�����f. � � �F���H�t$X�M��� @ H�5� H���Y���L�%; D��` A�D$A���� A��� �� I�$E1�H��u �:f�A�EI��H��L�H�H��t"�@A��t�H�5E H��1������� � H�EH� H��H�p��!����� @ H�5 H��1��ǽ�����f��CD�KPD�kTL�{X�Sh�D$(�CH�D$�CL�D$ H�C`H�D$0�*��� � �Ct��� A��D��� L��� ��� �D$(�Cx�D$�C|�D$ H��� H�D$0��� D �� H�5 H��1��)������� @ H�5� H��1������>���f. � ���� H�5� H���ؼ��D��� E���3����� ���H��X I��H��tH�5� H��1�讼����` ��tH�5� L��1�蓼��H��h H��tH�5� L��1��v���H��p H��tH�5� L��1��Y���H��x H��tH�5� L��1��<���D��� H�2 H�0 H�5{ L��E��HE�1�����I�$H�5g �C��� � H�5a H���ٻ���� ����H��p I��H��tH�5D H��1�迻��H��x H��tH�50 L��1�袻��H��� tKH�5* L���y���H��� H�t$`� ���H�D$`�8 �* H��� H�5 L��1��M������ ��tH�5� L��1��2���H��� H��tH�5� L��1�����H��� H��tH�5� L��1������� ��tH�5� L��1��ݺ��H��� tBH�5� L��贺��H��� H�t$`� � ���H�D$`�8 �H H��� L��聺��H��� H��t D�HE���� H��� H��tH�5x L��1��[���H��� H��tH�5k L��1��>���H��� tBH�5b L������H��� H�t$`� ����H�D$`�8 �o H��� L�����H��� tBH�5# L���ɹ��H��� H�t$`� �3���H�D$`�8 �@ H��� L��薹��H��� H��tH�5� L��1�艹����� ��tH�5� L��1��n������ ��tH�5� L��1��S���H��� H��tH�5� L��1��6������ ��tH�5� L��1�����H��� H��tH�5� L��1����I�|$ �@���I�$H�5� �&���H�KH�O 1��� 1��ٸ����M������(�H�5� H��蛸����H�5� H��臸���1���H��� H�5- L��1��z������H��� H�5 L��1��]������H��� H�5� L��1��@������H��� L��� ��������� ���G������H� " H�5 E1��U 1��e��� D H�5� 1�L��E1�L�-G �շ��H��� D�@E���I����H� D��L��L��A��H��1�襷��H��� D;p� ���E��t�H�5} 1�L���~���H��� �� ���H�5� H��L��1��\����&�H�5% H���8�����H�\$(H�5� H�SH��3 H�81����� �h�������H�SH�5� ��H�SH�5� ��H��3 H�SH�5� L�L$`L�D$X�L$LH�81�菴��� ����H�v3 H�5 H�81��m���� ��H�SH�5 �`���H�D3 H�5� D��H�81��8���� 農��H� g H�5k E1��^ 1����H�SH� � H��2 H�5 H�81����� �t���H�SH� a ��H�SH� 6 ��H�SH� ? �H�SH� % �H�SH� �H�SH� � �H�SH� � �H�SH� � �s���f � SH�5� H���P���H�5� H���A���H�5� H���2���H�5+ H���#���H�5L H������H��H�5Z [���� @ USH��H� � H�� H��H�=y H��E1�1��e���H�n H��H�þ� 1�1�����H����H�=X H���ð����y 躳���8u`H� n H�P H�= E1�H��1�����H��H��訰��H�=i H���y�����y �p����8uH������H��H��[]����H�61 H�5� H�81��-���� 賰�� USH��H��H�������t �2 H��H��H��[]�`��SH�: H��H���� 1�H��dH�%( H�D$1�H�$ � ���H��H���?�����tH�D$dH3%( u0H��[�H�$H�5+ H�PH�w0 H�81��u���� ���薲��f D AWAVI��AUATL�%�* UH�-�* SA��I��L)�H��H������H��t 1� � L��L��D��A��H��H9�u�H��[]A\A]A^A_Ðf. � �� H��H��� dns-search= %s; [802-1x] eap=tls eap=peap eap=ttls anonymous-identity=%s ca-cert=%s client-cert=%s private-key=%s private-key-password=%s phase2-auth=%s mac:%s interface-name:%s type:ethernet src/nm.c , unicast global route%d=%s,%s ,%d gsm cdma wifi bridge bond vlan ip-tunnel true false method=auto method=manual 0 1 infrastructure adhoc ap bg ap == NULL type=%s uuid=%s interface-name=%s *[]? ageing-time=%s priority=%u forward-delay=%s hello-time=%s max-age=%s stp=%s [bridge] %s [gsm] [cdma] auto-config=true apn=%s username=%s device-id=%s mtu=%u network-id=%s number=%s pin=%s sim-id=%s sim-operator-id=%s slave-type=bridge master=%s [bridge-port] path-cost=%u slave-type=bond master=%s [ethernet] wake-on-lan=%i cloned-mac-address=%s mtu=%d wake-on-wlan=%u [802-11-wireless] %s [802-3-ethernet] %s def->vlan_id < G_MAXUINT def->vlan_link != NULL [vlan] id=%u parent= mode=%s lacp_rate=%s miimon=%s min_links=%d xmit_hash_policy=%s ad_select=%s all_slaves_active=%d arp_interval=%s arp_ip_target= arp_validate=%s arp_all_targets=%s updelay=%s downdelay=%s fail_over_mac=%s num_grat_arp=%d num_unsol_na=%d packets_per_slave=%d primary_reselect=%s resend_igmp=%d lp_interval=%s primary=%s [bond]%s [ip-tunnel] mode=%d local=%s remote=%s input-key=%s output-key=%s [ipv4] method=shared method=disabled method=link-local address%i=%s gateway=%s dns= ignore-auto-routes=true never-default=true route-metric=%u [ipv6] addr-gen-mode=%s ip6-privacy=2 [ipv6] method=ignore .nmconnection [wifi] ssid=%s mode=%s band=%s channel=%u [wifi-security] key-mgmt=wpa-psk key-mgmt=wpa-eap key-mgmt=ieee8021x [connection] id=netplan-%s def->access_points def->access_points == NULL ACTION=="add|change", SUBSYSTEM=="net", ENV{ID_NET_DRIVER}=="%s", ENV{NM_UNMANAGED}="1" ERROR: %s: NetworkManager only supports unicast routes ERROR: %s: NetworkManager only supports global scoped routes ERROR: %s: NetworkManager does not support non-default routing tables ERROR: %s: NetworkManager does not support routes with 'from' ERROR: %s: NetworkManager does not support on-link routes %s is defined as a hardware SR-IOV filtered VLAN, postponing creation ERROR: %s: NetworkManager definitions do not support name globbing ERROR: %s: NetworkManager definitions do not support ipv6-mtu run/NetworkManager/system-connections/netplan- NetworkManager: definition %s is not for us (backend %i) ERROR: %s: NetworkManager definitions do not support matching by driver [keyfile] # devices managed by networkd unmanaged-devices+= run/NetworkManager/conf.d/netplan.conf run/udev/rules.d/90-netplan.rules /run/NetworkManager/conf.d/netplan.conf /run/NetworkManager/conf.d/10-globally-managed-devices.conf /run/NetworkManager/system-connections/netplan-* a��h���X�������x���H���8�������g_string_append_netdef_match wifi_mode_str addr_gen_mode_str type_str write_nm_conf_access_point write_nm_conf [Match] Driver=%s MACAddress=%s OriginalName=%s Type=!vlan bond bridge %d key_mgmt=NONE key_mgmt=WPA-PSK key_mgmt=WPA-EAP key_mgmt=IEEE8021X eap=TLS eap=PEAP eap=TTLS identity="%s" anonymous_identity="%s" psk=%s psk="%s" hash: password=%s password="%s" ca_cert="%s" client_cert="%s" private_key="%s" private_key_passwd="%s" phase2="auth=%s" magic off [Link] WakeOnLan=%s MTUBytes=%u .link .rules run/udev/rules.d/99-netplan- DRIVERS=="%s", DRIVERS=="?*", ATTR{address}=="%s", NAME="%s" run/netplan/wpa- wowlan_triggers= %s network={ ssid="%s" bssid=%s freq_list=%d freq_list= mode=1 } network={ bin/systemd-escape [Unit] DefaultDependencies=no [Service] Type=simple -Dwired [NetDev] Name=%s Kind=bridge AgeingTimeSec=%s Priority=%u ForwardDelaySec=%s HelloTimeSec=%s MaxAgeSec=%s STP=%s [Bridge] %s Kind=bond Mode=%s LACPTransmitRate=%s MIIMonitorSec= %sms MinLinks=%d TransmitHashPolicy=%s AdSelect=%s AllSlavesActive=%d ARPIntervalSec= ARPIPTargets= ARPValidate=%s ARPAllTargets=%s UpDelaySec= DownDelaySec= FailOverMACPolicy=%s GratuitousARP=%d PacketsPerSlave=%d PrimaryReselectPolicy=%s ResendIGMP=%d LearnPacketIntervalSec=%s [Bond]%s Kind=vlan [VLAN] Id=%u Kind=%s Kind=ip6tnl src/networkd.c Independent=true Mode=%s Local=%s Remote=%s InputKey=%s OutputKey=%s [Tunnel] %s .netdev RequiredForOnline=no OptionalAddresses=%s EmitLLDP=true DHCP=yes DHCP=ipv4 DHCP=ipv6 LinkLocalAddressing=yes LinkLocalAddressing=ipv4 LinkLocalAddressing=ipv6 LinkLocalAddressing=no IPv6AcceptRA=yes IPv6AcceptRA=no IPv6PrivacyExtensions=yes Gateway=%s DNS=%s Domains=%s %s IPv6MTUBytes=%d ConfigureWithoutCarrier=yes Bridge=%s [Bridge] Cost=%u Bond=%s PrimarySlave=true VLAN=%s [Route] Destination=%s PreferredSource=%s Scope=%s Type=%s GatewayOnlink=true Metric=%d Table=%d [RoutingPolicyRule] From=%s To=%s Priority=%d FirewallMark=%d TypeOfService=%d [DHCP] CriticalConnection=true duid ClientIdentifier=%s use-dns use-domains use-ntp send-hostname use-hostname use-mtu route-metric use-routes RouteMetric=%i RouteMetric=%u UseMTU=false UseMTU=true UseRoutes=false UseDNS=false UseDomains=%s UseNTP=false SendHostname=false UseHostname=false Hostname=%s [Link] %s [Network] %s .network /run/netplan/wpa-*.conf multi-user.target.wants ../systemd-networkd.service network-online.target.wants ERROR: %s: PSK length of 64 is only supported for hex-digit representation ERROR: %s: ASCII passphrase must be between 8 and 63 characters (inclusive) run/systemd/network/10-netplan- SUBSYSTEM=="net", ACTION=="add", networkd: definition %s is not for us (backend %i) ERROR: %s: networkd backend does not support GSM/CDMA modem configuration /run/systemd/system/systemd-networkd.service.wants/netplan-wpa- /run/systemd/system/netplan-wpa- ERROR: %s: networkd backend does not support wifi with match:, only by interface name Creating wpa_supplicant config ctrl_interface=/run/wpa_supplicant %s: Creating wpa_supplicant configuration file %s ERROR: unsupported wowlan_triggers mask: 0x%x ERROR: %s: networkd does not support wifi in access point mode Creating wpa_supplicant unit %s failed to ask systemd to escape %s; exit %d stdout: '%s' stderr: '%s' Description=WPA supplicant for netplan %s Requires=sys-subsystem-net-devices-%s.device After=sys-subsystem-net-devices-%s.device Before=network.target Wants=network.target ExecStart=/sbin/wpa_supplicant -c /run/netplan/wpa-%s.conf -i%s Creating wpa_supplicant service enablement link %s failed to create enablement symlink: %m ERROR: %s: ipv6-address-generation is not supported by networkd ERROR: %s: networkd requires that %s has the same value in both dhcp4_overrides and dhcp6_overrides /run/systemd/network/10-netplan-* /run/systemd/system/systemd-networkd.service.wants/netplan-wpa-*.service /run/systemd/system/netplan-wpa-*.service /run/udev/rules.d/99-netplan-* /run/systemd/system/systemd-networkd.service.wants/netplan-wpa@*.service We created networkd configuration, adding %s enablement symlink systemd-networkd-wait-online.service /lib/systemd/system/systemd-networkd-wait-online.service write_netdev_file Processing input file %s.. systemd/system-generators/ failed to parse options: %s netplan.stamp etc/netplan/*.yaml run/netplan/*.yaml lib/netplan/*.yaml failed to glob for %s: %m standard::symlink-target Generating output files.. /sbin/udevadm control --reload w f != NULL src/generate.c root-dir [config file ..] mapping none networkd NetworkManager Generate backend network configuration from netplan YAML definition. This program reads the specified netplan YAML definition file(s) or, if none are given, /etc/netplan/*.yaml. It then generates the corresponding systemd-networkd, NetworkManager, and udev configuration files in /run. %s can not be called directly, use 'netplan generate'. netplan generate already ran, remove %s to force re-run /sys/class/net/%s/device/driver id=%s, backend=%s, set_name=%s, match_name=%s, match_mac=%s, match_driver=%s Search for and generate configuration files in this root directory instead of / Read configuration from this/these file(s) instead of /etc/netplan/*.yaml Only show the device to backend mapping for the specified interface. main ;� 8��� ���8 ��� X���� h���P ț��d H���� ȝ��� ���� ؠ��t ����� (��� ȷ��P H���� h���� ����� H��� ���� 8��� (��� X��� ���� X��� zR x � p���+ zR x � $ ���� FJ w� ?;*3$" D Ȑ�� \ ���_ 4 p \���s B�B�D �A(�Q0D(K ABB4 � ����| A�A�S � KAN | AAB < � ��* G�A�J `J�A�S ��y K�A�K \ ܜ��� R�B�E �B(�D0�A8�NP�8A0A(B BBBA������BP������ X � \���� B�B�E �B(�D0�A8�GpxM�fxBp� 8A0A(B BBBH @ � ��d B�B�B �A(�A0�Gp� 0A(A BBBI 8 ���� I�A�D �M ABB O MBJ , \ p���x B�A�D �fDB 8 � ���� B�A�D �� KBF w ABF � ���� L � ����� B�B�D �A(�J0? (K ABBN t (A ABBF ` , ���� B�B�D �B(�A0�A8�J�H 8A0A(B BBBH �F�B�B�I� � L��\ A�V , � ���� A�A�_ � DAE $ � P��0 A�A�J WGA X��� A�X @ AA p ( �? B�B�E �B(�A0�A8�G� 8A0A(B BBBA .�B�B�B�I�k�e�V�A�D � P��e B�B�E �B(�H0�H8�M@r8A0A(B BBB � x�� - �, �� �� �� � � � � � p �� �� ���o � � � � � � � � ���o ���o H ���o �o x ���o Ț � & 6 F V f v � � � � � � � � & 6 F V f v � � � � � � � � ! ! &! 6! F! V! f! v! �! �! �! �! �! �! �! �! " " &" 6" F" V" f" v" �" �" �" �" �" �" �" �" # # &# 6# F# V# f# v# �# �# �# � d� r � �� G~ �� � m� ~� � X� 8651437d069600afcc50edd470ffab9316e4c1.debug �� .shstrtab .interp .note.ABI-tag .note.gnu.build-id .gnu.hash .dynsym .dynstr .gnu.version .gnu.version_r .rela.dyn .rela.plt .init .plt.got .text .fini .rodata .eh_frame_hdr .eh_frame .init_array .fini_array .data.rel.ro .dynamic .data .bss .gnu_debuglink 8 8 T T ! t t $ 4 ���o � � \ > � � � F � � � N ���o x x � [ ���o H H � j � � � t B � � ~ � � y � � � � �# �# � �# �# BL � p p � p p �! � �� �� � � p� p� ( � �� �� � �� �� � �� �� � Ț Ț P � � � � � � � � � � � � � � 4 � PK ! ���8 �8 netplan-dbusnu ȯ�� ELF > p @ �1 @ 8 @ @ @ @ � � 8 8 8 � � �+ �+ �+ x � �, �, �, T T T D D P�td � � � T T Q�td R�td �+ �+ �+ 0 0 /lib64/ld-linux-x86-64.so.2 GNU GNU �m��-+{�ƴ�H��w�X �� d@ ! $ BE���|�K��qX ������ V � � � � ' u Q � F ] - 6 � � � � ) � p � < = . " � X H0 k P0 p � _ H0 � H � t libsystemd.so.0 _ITM_deregisterTMCloneTable __gmon_start__ _ITM_registerTMCloneTable sd_bus_message_close_container sd_bus_request_name sd_bus_wait sd_bus_reply_method_return sd_bus_add_object_vtable sd_bus_slot_unref sd_bus_message_open_container sd_bus_process sd_bus_message_new_method_return sd_bus_unref sd_bus_message_append_strv sd_bus_send sd_bus_open_system sd_bus_message_append sd_bus_error_setf libglib-2.0.so.0 _init g_spawn_sync g_error_free _fini g_spawn_check_exit_status g_free libc.so.6 __stack_chk_fail __fprintf_chk getenv stderr getuid __cxa_finalize strerror __libc_start_main _edata __bss_start _end _IO_stdin_used LIBSYSTEMD_221 GLIBC_2.3.4 GLIBC_2.4 GLIBC_2.2.5 ��b � ti � ii � ui � �+ p �+ 0 , H , G (, � 0, @ H, N P, G X, � `, � x, W �, G �, \ �, � 0 0 0 b (0 n 00 80 � �/ �/ �/ �/ �/ �/ �. / / / / / (/ 0/ 8/ @/ H/ P/ X/ `/ h/ p/ x/ �/ �/ �/ �/ �/ �/ �/ H��H�u! H��t��H��� �5� �%� @ �%� h ����%z h �����%r h ����%j h ����%b h ����%Z h ����%R h ����%J h �p����%B h �`����%: h �P����%2 h �@����%* h �0����%" h � ����% h �����% h � ����% h ���% h ����%� h �����%� h ����%� h ����%� h ����%� h ����%� h ����%� h �p����%� f� SH�� H�|$H�D$ H�D$ dH�%( H�D$1�������� H�|$H�t$L�� H� � H�� E1��`�����x`H�|$H�5{ 1�H���u������� D H�|$1�������� u�H�|$H��������y�؉�����H�n H����؉�����H�� H��H� � H�81�����H�|$�y���H�|$����H�L$dH3 %( � uHH�� [�؉����H�, H���؉����H�� H���؉����H�R H���y����m���f. � 1�I��^H��H���PTL�� H� s H�=l����& � D H�=� UH�� H9�H��tH�� H��t ]��f. � ]� @ f. � H�=a H�5Z UH)�H��H��H��H��?H�H�tH�� H��t ]��f � ]� @ f. � �= u/H�=� UH��t H�=� ����H����� ]� � ��f D UH��]�f���f D H��(H�t$H�D$ dH�%( H�D$1��������� H�|$H�� �a �������� H�|$H�� �r ������� H�|$H�� H�5� 1������xgH�|$H�{ �v �q�����xMH�|$H�5� �����x8H�|$�>�����x*H�|$�0�����x H�|$�"�����xH�t$1�1����1��D$ �%���1�� ���H�L$dH3 %( �D$ uH��(��0���ATUI��SH�= H��H��@dH�%( H�D$81�H�� H�D$ H�D$ H�D$ �D$ H�D$ H�� H�D$0 H�D$(�b���H��tH�=� �Q���H�D$ H�\$H�t$ H�=� E1�E1�1�S1�H�D$ PH�D$(PH�D$(P���H�D$(H�� H��tcH�HH�0 H�5I H��1�������H�|$����H�|$� ���H�|$H��t�:���H�T$8dH3%( ��uuH��@[]A\� � �|$H�����H�D$H��t2H�HL�L$H�� L�D$H�5� H��1��\������x��� D H�5� � L��1�������V������ @ f. � ATUI��SH��H��@dH�%( H�D$81�H�. H�D$ H�D$ H�D$ �D$ H�D$ H�4 H�D$0 H�D$(�9������� H�\$H�t$ H�= E1�E1�1�S1�H�D$ PH�D$(PH�D$(P�^���H�D$(H�� H���� H�HH�� H�5� H��1��P�����H�|$���H�|$�z���H�|$H��t���H�T$8dH3%( ���� H��@[]A\� @ H�=O � ���H���B���H�=: ���H�D$ �,��� D �|$H�����H�D$H��t2H�HL�L$H�r L�D$H�5 H��1�������G��� D H�5� � L��1��*������%�������f. � @ AWAVI��AUATL�%� UH�-� SA��I��L)�H��H������H��t 1� � L��L��D��A��H��H9�u�H��[]A\A]A^A_Ðf. � �� H��H��� sv Features as /usr/sbin/netplan generate DBUS_TEST_NETPLAN_CMD / b apply cannot run netplan apply: %s io.netplan.Netplan /io/netplan/Netplan Failed to process bus: %s Failed to wait on bus: %s Apply Generate Info a(sv) auth-phase2 dhcp-use-domains ipv6-mtu generated-supplicant cannot run netplan generate: %s org.freedesktop.DBus.Error.Failed netplan generate failed: %s stdout: '%s' stderr: '%s' netplan apply failed: %s stdout: '%s' stderr: '%s' Failed to connect to system bus: %s Failed to issue method call: %s Failed to acquire service name: %s ;T �� ���� 0���� ����p ����� ���� p���@ 0���� ����� zR x � (���+ zR x � $ �� FJ w� ?;*3$" D P��� \ ��� D0 A @ x ���� B�A�D �N`�hHpFxF�N`\ AABH @ � (���� B�A�D �G`{hHpFxF�N`d AABE ��c A�D0 AA D $ ����e B�B�E �B(�H0�H8�M@r8A0A(B BBB l ���� p 0 < 0 M H G � @ M N G � � M W G \ � > � � H t �+ �+ ���o � P � � �. @ � X ���o ���o P ���o �o ���o �, v � � � � � � � � & 6 F V f v � � � � � � � 0 b n � b9146df4c22d2b7babc6b4f0481af6ee77f458.debug ��)� .shstrtab .interp .note.ABI-tag .note.gnu.build-id .gnu.hash .dynsym .dynstr .gnu.version .gnu.version_r .rela.dyn .rela.plt .init .plt.got .text .fini .rodata .eh_frame_hdr .eh_frame .init_array .fini_array .data.rel.ro .dynamic .data .bss .gnu_debuglink 8 8 T T ! t t $ 4 ���o � � < > � � x F P P � N ���o J [ ���o P P ` j � � X t B @ ~ H H y ` ` � � � � � r � t t � � � P � � � T � ( ( � � �+ �+ � �+ �+ � �+ �+ � � �, �, � �. �. � 0 0 H � H0 H0 � H0 4 |0 PK ! �ߐ4 4 00-snapd-config.yamlnu �[��� # This is the initial network config. # It can be overwritten by cloud-init or console-conf. network: version: 2 ethernets: all-en: match: name: "en*" dhcp4: true all-eth: match: name: "eth*" dhcp4: true PK ! ѽ���1 �1 netplan.htmlnu �[��� <!DOCTYPE html> <html xmlns="http://www.w3.org/1999/xhtml" lang="" xml:lang=""> <head> <meta charset="utf-8" /> <meta name="generator" content="pandoc" /> <meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes" /> <title>"Netplan reference"</title> <style> code{white-space: pre-wrap;} span.smallcaps{font-variant: small-caps;} span.underline{text-decoration: underline;} div.column{display: inline-block; vertical-align: top; width: 50%;} div.hanging-indent{margin-left: 1.5em; text-indent: -1.5em;} ul.task-list{list-style: none;} pre > code.sourceCode { white-space: pre; position: relative; } pre > code.sourceCode > span { display: inline-block; line-height: 1.25; } pre > code.sourceCode > span:empty { height: 1.2em; } code.sourceCode > span { color: inherit; text-decoration: inherit; } div.sourceCode { margin: 1em 0; } pre.sourceCode { margin: 0; } @media screen { div.sourceCode { overflow: auto; } } @media print { pre > code.sourceCode { white-space: pre-wrap; } pre > code.sourceCode > span { text-indent: -5em; padding-left: 5em; } } pre.numberSource code { counter-reset: source-line 0; } pre.numberSource code > span { position: relative; left: -4em; counter-increment: source-line; } pre.numberSource code > span > a:first-child::before { content: counter(source-line); position: relative; left: -1em; text-align: right; vertical-align: baseline; border: none; display: inline-block; -webkit-touch-callout: none; -webkit-user-select: none; -khtml-user-select: none; -moz-user-select: none; -ms-user-select: none; user-select: none; padding: 0 4px; width: 4em; color: #aaaaaa; } pre.numberSource { margin-left: 3em; border-left: 1px solid #aaaaaa; padding-left: 4px; } div.sourceCode { } @media screen { pre > code.sourceCode > span > a:first-child::before { text-decoration: underline; } } code span.al { color: #ff0000; font-weight: bold; } /* Alert */ code span.an { color: #60a0b0; font-weight: bold; font-style: italic; } /* Annotation */ code span.at { color: #7d9029; } /* Attribute */ code span.bn { color: #40a070; } /* BaseN */ code span.bu { } /* BuiltIn */ code span.cf { color: #007020; font-weight: bold; } /* ControlFlow */ code span.ch { color: #4070a0; } /* Char */ code span.cn { color: #880000; } /* Constant */ code span.co { color: #60a0b0; font-style: italic; } /* Comment */ code span.cv { color: #60a0b0; font-weight: bold; font-style: italic; } /* CommentVar */ code span.do { color: #ba2121; font-style: italic; } /* Documentation */ code span.dt { color: #902000; } /* DataType */ code span.dv { color: #40a070; } /* DecVal */ code span.er { color: #ff0000; font-weight: bold; } /* Error */ code span.ex { } /* Extension */ code span.fl { color: #40a070; } /* Float */ code span.fu { color: #06287e; } /* Function */ code span.im { } /* Import */ code span.in { color: #60a0b0; font-weight: bold; font-style: italic; } /* Information */ code span.kw { color: #007020; font-weight: bold; } /* Keyword */ code span.op { color: #666666; } /* Operator */ code span.ot { color: #007020; } /* Other */ code span.pp { color: #bc7a00; } /* Preprocessor */ code span.sc { color: #4070a0; } /* SpecialChar */ code span.ss { color: #bb6688; } /* SpecialString */ code span.st { color: #4070a0; } /* String */ code span.va { color: #19177c; } /* Variable */ code span.vs { color: #4070a0; } /* VerbatimString */ code span.wa { color: #60a0b0; font-weight: bold; font-style: italic; } /* Warning */ </style> </head> <body> <header id="title-block-header"> <h1 class="title">"Netplan reference"</h1> </header> <nav id="TOC" role="doc-toc"> <ul> <li><a href="#top-level-configuration-structure">Top-level configuration structure</a></li> <li><a href="#properties-for-physical-device-types">Properties for physical device types</a></li> <li><a href="#properties-for-all-device-types">Properties for all device types</a></li> <li><a href="#dhcp-overrides">DHCP Overrides</a></li> <li><a href="#routing">Routing</a> <ul> <li><a href="#default-routes">Default routes</a></li> </ul></li> <li><a href="#authentication">Authentication</a></li> <li><a href="#properties-for-device-type-ethernets">Properties for device type <code>ethernets:</code></a></li> <li><a href="#properties-for-device-type-modems">Properties for device type <code>modems:</code></a></li> <li><a href="#properties-for-device-type-wifis">Properties for device type <code>wifis:</code></a></li> <li><a href="#properties-for-device-type-bridges">Properties for device type <code>bridges:</code></a></li> <li><a href="#properties-for-device-type-bonds">Properties for device type <code>bonds:</code></a></li> <li><a href="#properties-for-device-type-tunnels">Properties for device type <code>tunnels:</code></a></li> <li><a href="#properties-for-device-type-vlans">Properties for device type <code>vlans:</code></a></li> <li><a href="#properties-for-device-type-vrfs">Properties for device type <code>vrfs:</code></a></li> <li><a href="#properties-for-device-type-nm-devices">Properties for device type <code>nm-devices:</code></a></li> <li><a href="#backend-specific-configuration-parameters">Backend-specific configuration parameters</a></li> </ul> </nav> <h2 id="top-level-configuration-structure">Top-level configuration structure</h2> <p>The general structure of a Netplan YAML file is shown below.</p> <div class="sourceCode" id="cb1"><pre class="sourceCode yaml"><code class="sourceCode yaml"><span id="cb1-1"><a href="#cb1-1" aria-hidden="true"></a><span class="fu">network</span><span class="kw">:</span></span> <span id="cb1-2"><a href="#cb1-2" aria-hidden="true"></a><span class="at"> </span><span class="fu">version</span><span class="kw">:</span><span class="at"> NUMBER</span></span> <span id="cb1-3"><a href="#cb1-3" aria-hidden="true"></a><span class="at"> </span><span class="fu">renderer</span><span class="kw">:</span><span class="at"> STRING</span></span> <span id="cb1-4"><a href="#cb1-4" aria-hidden="true"></a><span class="at"> </span><span class="fu">bonds</span><span class="kw">:</span><span class="at"> MAPPING</span></span> <span id="cb1-5"><a href="#cb1-5" aria-hidden="true"></a><span class="at"> </span><span class="fu">bridges</span><span class="kw">:</span><span class="at"> MAPPING</span></span> <span id="cb1-6"><a href="#cb1-6" aria-hidden="true"></a><span class="at"> </span><span class="fu">ethernets</span><span class="kw">:</span><span class="at"> MAPPING</span></span> <span id="cb1-7"><a href="#cb1-7" aria-hidden="true"></a><span class="at"> </span><span class="fu">modems</span><span class="kw">:</span><span class="at"> MAPPING</span></span> <span id="cb1-8"><a href="#cb1-8" aria-hidden="true"></a><span class="at"> </span><span class="fu">tunnels</span><span class="kw">:</span><span class="at"> MAPPING</span></span> <span id="cb1-9"><a href="#cb1-9" aria-hidden="true"></a><span class="at"> </span><span class="fu">vlans</span><span class="kw">:</span><span class="at"> MAPPING</span></span> <span id="cb1-10"><a href="#cb1-10" aria-hidden="true"></a><span class="at"> </span><span class="fu">vrfs</span><span class="kw">:</span><span class="at"> MAPPING</span></span> <span id="cb1-11"><a href="#cb1-11" aria-hidden="true"></a><span class="at"> </span><span class="fu">wifis</span><span class="kw">:</span><span class="at"> MAPPING</span></span> <span id="cb1-12"><a href="#cb1-12" aria-hidden="true"></a><span class="at"> </span><span class="fu">nm-devices</span><span class="kw">:</span><span class="at"> MAPPING</span></span></code></pre></div> <ul> <li><p><strong>version</strong> (number)</p> <blockquote> <p>Defines what version of the configuration format is used. The only value supported is <code>2</code>. Defaults to <code>2</code> if not defined.</p> </blockquote></li> <li><p><strong>renderer</strong> (scalar)</p> <blockquote> <p>Defines what network configuration tool will be used to set up your configuration. Valid values are <code>networkd</code> and <code>NetworkManager</code>. Defaults to <code>networkd</code> if not defined.</p> </blockquote></li> <li><p><a href="#properties-for-device-type-bonds"><strong>bonds</strong></a> (mapping)</p> <blockquote> <p>Creates and configures link aggregation (bonding) devices.</p> </blockquote></li> <li><p><a href="#properties-for-device-type-bridges"><strong>bridges</strong></a> (mapping)</p> <blockquote> <p>Creates and configures bridge devices.</p> </blockquote></li> <li><p><a href="#properties-for-device-type-ethernets"><strong>ethernets</strong></a> (mapping)</p> <blockquote> <p>Configures physical Ethernet interfaces.</p> </blockquote></li> <li><p><a href="#properties-for-device-type-modems"><strong>modems</strong></a> (mapping)</p> <blockquote> <p>Configures modems</p> </blockquote></li> <li><p><a href="#properties-for-device-type-tunnels"><strong>tunnels</strong></a> (mapping)</p> <blockquote> <p>Creates and configures different types of virtual tunnels.</p> </blockquote></li> <li><p><a href="#properties-for-device-type-vlans"><strong>vlans</strong></a> (mapping)</p> <blockquote> <p>Creates and configures VLANs.</p> </blockquote></li> <li><p><a href="#properties-for-device-type-vrfs"><strong>vrfs</strong></a> (mapping)</p> <blockquote> <p>Configures Virtual Routing and Forwarding (VRF) devices.</p> </blockquote></li> <li><p><a href="#properties-for-device-type-wifis"><strong>wifis</strong></a> (mapping)</p> <blockquote> <p>Configures physical Wifi interfaces as client, adhoc or access point.</p> </blockquote></li> <li><p><a href="#properties-for-device-type-nm-devices"><strong>nm-devices</strong></a> (mapping)</p> <blockquote> <p><code>nm-devices</code> are used in situations where Netplan doesn’t support the connection type. The raw configuration expected by NetworkManager can be defined and will be passed as is (passthrough) to the <code>.nmconnection</code> file. Users will not normally use this type of device.</p> </blockquote></li> </ul> <p>All the properties for all the device types will be described in the next sections.</p> <h2 id="properties-for-physical-device-types">Properties for physical device types</h2> <p>These properties are used with physical devices such as Ethernet and Wifi network interfaces.</p> <p><strong>Note:</strong> Some options will not work reliably for devices matched by name only and rendered by networkd, due to interactions with device renaming in udev. Match devices by MAC when setting options like: <code>wakeonlan</code> or <code>*-offload</code>.</p> <ul> <li><p><strong>match</strong> (mapping)</p> <blockquote> <p>This selects a subset of available physical devices by various hardware properties. The following configuration will then apply to all matching devices, as soon as they appear. <em>All</em> specified properties must match.</p> </blockquote> <ul> <li><p><strong>name</strong> (scalar)</p> <blockquote> <p>Current interface name. Globs are supported, and the primary use case for matching on names, as selecting one fixed name can be more easily achieved with having no <code>match:</code> at all and just using the ID (see above). (<code>NetworkManager</code>: as of v1.14.0)</p> </blockquote></li> <li><p><strong>macaddress</strong> (scalar)</p> <blockquote> <p>Device’s 6-byte permanent MAC address in the form “XX:XX:XX:XX:XX:XX” or 20 bytes for InfiniBand devices (IPoIB). Globs are not allowed. This doesn’t match virtual MAC addresses for veth, bridge, bond, vlan, …</p> </blockquote></li> <li><p><strong>driver</strong> (scalar or sequence of scalars) – sequence since <strong>0.104</strong></p> <blockquote> <p>Kernel driver name, corresponding to the <code>DRIVER</code> udev property. A sequence of globs is supported, any of which must match. Matching on driver is <em>only</em> supported with networkd.</p> </blockquote></li> </ul> <p>Examples:</p> <ul> <li><p>All cards on second PCI bus:</p> <div class="sourceCode" id="cb2"><pre class="sourceCode yaml"><code class="sourceCode yaml"><span id="cb2-1"><a href="#cb2-1" aria-hidden="true"></a><span class="fu">network</span><span class="kw">:</span></span> <span id="cb2-2"><a href="#cb2-2" aria-hidden="true"></a><span class="at"> </span><span class="fu">ethernets</span><span class="kw">:</span></span> <span id="cb2-3"><a href="#cb2-3" aria-hidden="true"></a><span class="at"> </span><span class="fu">myinterface</span><span class="kw">:</span></span> <span id="cb2-4"><a href="#cb2-4" aria-hidden="true"></a><span class="at"> </span><span class="fu">match</span><span class="kw">:</span></span> <span id="cb2-5"><a href="#cb2-5" aria-hidden="true"></a><span class="at"> </span><span class="fu">name</span><span class="kw">:</span><span class="at"> enp2*</span></span></code></pre></div></li> <li><p>Fixed MAC address:</p> <div class="sourceCode" id="cb3"><pre class="sourceCode yaml"><code class="sourceCode yaml"><span id="cb3-1"><a href="#cb3-1" aria-hidden="true"></a><span class="fu">network</span><span class="kw">:</span></span> <span id="cb3-2"><a href="#cb3-2" aria-hidden="true"></a><span class="at"> </span><span class="fu">ethernets</span><span class="kw">:</span></span> <span id="cb3-3"><a href="#cb3-3" aria-hidden="true"></a><span class="at"> </span><span class="fu">interface0</span><span class="kw">:</span></span> <span id="cb3-4"><a href="#cb3-4" aria-hidden="true"></a><span class="at"> </span><span class="fu">match</span><span class="kw">:</span></span> <span id="cb3-5"><a href="#cb3-5" aria-hidden="true"></a><span class="at"> </span><span class="fu">macaddress</span><span class="kw">:</span><span class="at"> 11:22:33:AA:BB:FF</span></span></code></pre></div></li> <li><p>First card of driver <code>ixgbe</code>:</p> <div class="sourceCode" id="cb4"><pre class="sourceCode yaml"><code class="sourceCode yaml"><span id="cb4-1"><a href="#cb4-1" aria-hidden="true"></a><span class="fu">network</span><span class="kw">:</span></span> <span id="cb4-2"><a href="#cb4-2" aria-hidden="true"></a><span class="at"> </span><span class="fu">ethernets</span><span class="kw">:</span></span> <span id="cb4-3"><a href="#cb4-3" aria-hidden="true"></a><span class="at"> </span><span class="fu">nic0</span><span class="kw">:</span></span> <span id="cb4-4"><a href="#cb4-4" aria-hidden="true"></a><span class="at"> </span><span class="fu">match</span><span class="kw">:</span></span> <span id="cb4-5"><a href="#cb4-5" aria-hidden="true"></a><span class="at"> </span><span class="fu">driver</span><span class="kw">:</span><span class="at"> ixgbe</span></span> <span id="cb4-6"><a href="#cb4-6" aria-hidden="true"></a><span class="at"> </span><span class="fu">name</span><span class="kw">:</span><span class="at"> en*s0</span></span></code></pre></div></li> <li><p>First card with a driver matching <code>bcmgenet</code> or <code>smsc*</code>:</p> <div class="sourceCode" id="cb5"><pre class="sourceCode yaml"><code class="sourceCode yaml"><span id="cb5-1"><a href="#cb5-1" aria-hidden="true"></a><span class="fu">network</span><span class="kw">:</span></span> <span id="cb5-2"><a href="#cb5-2" aria-hidden="true"></a><span class="at"> </span><span class="fu">ethernets</span><span class="kw">:</span></span> <span id="cb5-3"><a href="#cb5-3" aria-hidden="true"></a><span class="at"> </span><span class="fu">nic0</span><span class="kw">:</span></span> <span id="cb5-4"><a href="#cb5-4" aria-hidden="true"></a><span class="at"> </span><span class="fu">match</span><span class="kw">:</span></span> <span id="cb5-5"><a href="#cb5-5" aria-hidden="true"></a><span class="at"> </span><span class="fu">driver</span><span class="kw">:</span><span class="at"> </span><span class="kw">[</span><span class="st">"bcmgenet"</span><span class="kw">,</span><span class="at"> </span><span class="st">"smsc*"</span><span class="kw">]</span></span> <span id="cb5-6"><a href="#cb5-6" aria-hidden="true"></a><span class="at"> </span><span class="fu">name</span><span class="kw">:</span><span class="at"> en*</span></span></code></pre></div></li> </ul></li> <li><p><strong>set-name</strong> (scalar)</p> <blockquote> <p>When matching on unique properties such as path or MAC, or with additional assumptions such as “there will only ever be one wifi device”, match rules can be written so that they only match one device. Then this property can be used to give that device a more specific/desirable/nicer name than the default from udev’s ifnames. Any additional device that satisfies the match rules will then fail to get renamed and keep the original kernel name (and dmesg will show an error).</p> </blockquote></li> <li><p><strong>wakeonlan</strong> (bool)</p> <blockquote> <p>Enable wake on LAN. Off by default.</p> </blockquote></li> <li><p><strong>emit-lldp</strong> (bool) – since <strong>0.99</strong></p> <blockquote> <p>(networkd backend only) Whether to emit LLDP packets. Off by default.</p> </blockquote></li> <li><p><strong>receive-checksum-offload</strong> (bool) – since <strong>0.104</strong></p> <blockquote> <p>(networkd backend only) If set to true (false), the hardware offload for checksumming of ingress network packets is enabled (disabled). When unset, the kernel’s default will be used.</p> </blockquote></li> <li><p><strong>transmit-checksum-offload</strong> (bool) – since <strong>0.104</strong></p> <blockquote> <p>(networkd backend only) If set to true (false), the hardware offload for checksumming of egress network packets is enabled (disabled). When unset, the kernel’s default will be used.</p> </blockquote></li> <li><p><strong>tcp-segmentation-offload</strong> (bool) – since <strong>0.104</strong></p> <blockquote> <p>(networkd backend only) If set to true (false), the TCP Segmentation Offload (TSO) is enabled (disabled). When unset, the kernel’s default will be used.</p> </blockquote></li> <li><p><strong>tcp6-segmentation-offload</strong> (bool) – since <strong>0.104</strong></p> <blockquote> <p>(networkd backend only) If set to true (false), the TCP6 Segmentation Offload (tx-tcp6-segmentation) is enabled (disabled). When unset, the kernel’s default will be used.</p> </blockquote></li> <li><p><strong>generic-segmentation-offload</strong> (bool) – since <strong>0.104</strong></p> <blockquote> <p>(networkd backend only) If set to true (false), the Generic Segmentation Offload (GSO) is enabled (disabled). When unset, the kernel’s default will be used.</p> </blockquote></li> <li><p><strong>generic-receive-offload</strong> (bool) – since <strong>0.104</strong></p> <blockquote> <p>(networkd backend only) If set to true (false), the Generic Receive Offload (GRO) is enabled (disabled). When unset, the kernel’s default will be used.</p> </blockquote></li> <li><p><strong>large-receive-offload</strong> (bool) – since <strong>0.104</strong></p> <blockquote> <p>(networkd backend only) If set to true (false), the Large Receive Offload (LRO) is enabled (disabled). When unset, the kernel’s default will be used.</p> </blockquote></li> <li><p><strong>openvswitch</strong> (mapping) – since <strong>0.100</strong></p> <blockquote> <p>This provides additional configuration for the openvswitch network device. If Open vSwitch is not available on the system, netplan treats the presence of <code>openvswitch</code> configuration as an error.</p> <p>Any supported network device that is declared with the <code>openvswitch</code> mapping (or any bond/bridge that includes an interface with an openvswitch configuration) will be created in openvswitch instead of the defined renderer. In the case of a <code>vlan</code> definition declared the same way, netplan will create a fake VLAN bridge in openvswitch with the requested <code>vlan</code> properties.</p> </blockquote> <ul> <li><p><strong>external-ids</strong> (mapping) – since <strong>0.100</strong></p> <blockquote> <p>Passed-through directly to Open vSwitch</p> </blockquote></li> <li><p><strong>other-config</strong> (mapping) – since <strong>0.100</strong></p> <blockquote> <p>Passed-through directly to Open vSwitch</p> </blockquote></li> <li><p><strong>lacp</strong> (scalar) – since <strong>0.100</strong></p> <blockquote> <p>Valid for bond interfaces. Accepts <code>active</code>, <code>passive</code> or <code>off</code> (the default).</p> </blockquote></li> <li><p><strong>fail-mode</strong> (scalar) – since <strong>0.100</strong></p> <blockquote> <p>Valid for bridge interfaces. Accepts <code>secure</code> or <code>standalone</code> (the default).</p> </blockquote></li> <li><p><strong>mcast-snooping</strong> (bool) – since <strong>0.100</strong></p> <blockquote> <p>Valid for bridge interfaces. False by default.</p> </blockquote></li> <li><p><strong>protocols</strong> (sequence of scalars) – since <strong>0.100</strong></p> <blockquote> <p>Valid for bridge interfaces or the network section. List of protocols to be used when negotiating a connection with the controller. Accepts <code>OpenFlow10</code>, <code>OpenFlow11</code>, <code>OpenFlow12</code>, <code>OpenFlow13</code>, <code>OpenFlow14</code>, and <code>OpenFlow15</code>.</p> </blockquote></li> <li><p><strong>rstp</strong> (bool) – since <strong>0.100</strong></p> <blockquote> <p>Valid for bridge interfaces. False by default.</p> </blockquote></li> <li><p><strong>controller</strong> (mapping) – since <strong>0.100</strong></p> <blockquote> <p>Valid for bridge interfaces. Specify an external OpenFlow controller.</p> </blockquote> <ul> <li><p><strong>addresses</strong> (sequence of scalars)</p> <blockquote> <p>Set the list of addresses to use for the controller targets. The syntax of these addresses is as defined in ovs-vsctl(8). Example: addresses: <code>[tcp:127.0.0.1:6653, "ssl:[fe80::1234%eth0]:6653"]</code></p> </blockquote></li> <li><p><strong>connection-mode</strong> (scalar)</p> <blockquote> <p>Set the connection mode for the controller. Supported options are <code>in-band</code> and <code>out-of-band</code>. The default is <code>in-band</code>.</p> </blockquote></li> </ul></li> <li><p><strong>ports</strong> (sequence of sequence of scalars) – since <strong>0.100</strong></p> <blockquote> <p>Open vSwitch patch ports. Each port is declared as a pair of names which can be referenced as interfaces in dependent virtual devices (bonds, bridges).</p> </blockquote> <p>Example:</p> <div class="sourceCode" id="cb6"><pre class="sourceCode yaml"><code class="sourceCode yaml"><span id="cb6-1"><a href="#cb6-1" aria-hidden="true"></a><span class="fu">openvswitch</span><span class="kw">:</span></span> <span id="cb6-2"><a href="#cb6-2" aria-hidden="true"></a><span class="at"> </span><span class="fu">ports</span><span class="kw">:</span></span> <span id="cb6-3"><a href="#cb6-3" aria-hidden="true"></a><span class="at"> </span><span class="kw">-</span><span class="at"> </span><span class="kw">[</span><span class="at">patch0</span><span class="dv">-1</span><span class="kw">,</span><span class="at"> patch1-</span><span class="dv">0</span><span class="kw">]</span></span></code></pre></div></li> <li><p><strong>ssl</strong> (mapping) – since <strong>0.100</strong></p> <blockquote> <p>Valid for global <code>openvswitch</code> settings. Options for configuring SSL server endpoint for the switch.</p> </blockquote> <ul> <li><p><strong>ca-cert</strong> (scalar)</p> <blockquote> <p>Path to a file containing the CA certificate to be used.</p> </blockquote></li> <li><p><strong>certificate</strong> (scalar)</p> <blockquote> <p>Path to a file containing the server certificate.</p> </blockquote></li> <li><p><strong>private-key</strong> (scalar)</p> <blockquote> <p>Path to a file containing the private key for the server.</p> </blockquote></li> </ul></li> </ul></li> </ul> <h2 id="properties-for-all-device-types">Properties for all device types</h2> <ul> <li><p><strong>renderer</strong> (scalar)</p> <blockquote> <p>Use the given networking backend for this definition. Currently supported are <code>networkd</code> and <code>NetworkManager</code>. This property can be specified globally in <code>network:</code>, for a device type (in e. g. <code>ethernets:</code>) or for a particular device definition. Default is <code>networkd</code>.</p> <p>(Since 0.99) The <code>renderer</code> property has one additional acceptable value for vlan objects (i. e. defined in <code>vlans:</code>): <code>sriov</code>. If a vlan is defined with the <code>sriov</code> renderer for an SR-IOV Virtual Function interface, this causes netplan to set up a hardware VLAN filter for it. There can be only one defined per VF.</p> </blockquote></li> <li><p><strong>dhcp4</strong> (bool)</p> <blockquote> <p>Enable DHCP for IPv4. Off by default.</p> </blockquote></li> <li><p><strong>dhcp6</strong> (bool)</p> <blockquote> <p>Enable DHCP for IPv6. Off by default. This covers both stateless DHCP - where the DHCP server supplies information like DNS nameservers but not the IP address - and stateful DHCP, where the server provides both the address and the other information.</p> <p>If you are in an IPv6-only environment with completely stateless auto-configuration (SLAAC with RDNSS), this option can be set to cause the interface to be brought up. (Setting accept-ra alone is not sufficient.) Auto-configuration will still honor the contents of the router advertisement and only use DHCP if requested in the RA.</p> <p>Note that <strong><code>rdnssd</code></strong>(8) is required to use RDNSS with networkd. No extra software is required for NetworkManager.</p> </blockquote></li> <li><p><strong>ipv6-mtu</strong> (scalar) – since <strong>0.98</strong> > Set the IPv6 MTU (only supported with <code>networkd</code> backend). Note > that needing to set this is an unusual requirement. > > <strong>Requires feature: ipv6-mtu</strong></p></li> <li><p><strong>ipv6-privacy</strong> (bool)</p> <blockquote> <p>Enable IPv6 Privacy Extensions (RFC 4941) for the specified interface, and prefer temporary addresses. Defaults to false - no privacy extensions. There is currently no way to have a private address but prefer the public address.</p> </blockquote></li> <li><p><strong>link-local</strong> (sequence of scalars)</p> <blockquote> <p>Configure the link-local addresses to bring up. Valid options are ‘ipv4’ and ‘ipv6’, which respectively allow enabling IPv4 and IPv6 link local addressing. If this field is not defined, the default is to enable only IPv6 link-local addresses. If the field is defined but configured as an empty set, IPv6 link-local addresses are disabled as well as IPv4 link- local addresses.</p> <p>This feature enables or disables link-local addresses for a protocol, but the actual implementation differs per backend. On networkd, this directly changes the behavior and may add an extra address on an interface. When using the NetworkManager backend, enabling link-local has no effect if the interface also has DHCP enabled.</p> </blockquote> <p>Examples:</p> <ul> <li>Enable only IPv4 link-local: <code>link-local: [ ipv4 ]</code></li> <li>Enable all link-local addresses: <code>link-local: [ ipv4, ipv6 ]</code></li> <li>Disable all link-local addresses: <code>link-local: [ ]</code></li> </ul></li> <li><p><strong>ignore-carrier</strong> (bool) – since <strong>0.104</strong></p> <blockquote> <p>(networkd backend only) Allow the specified interface to be configured even if it has no carrier.</p> </blockquote></li> <li><p><strong>critical</strong> (bool)</p> <blockquote> <p>Designate the connection as “critical to the system”, meaning that special care will be taken by to not release the assigned IP when the daemon is restarted. (not recognized by NetworkManager)</p> </blockquote></li> <li><p><strong>dhcp-identifier</strong> (scalar)</p> <blockquote> <p>(networkd backend only) Sets the source of DHCPv4 client identifier. If <code>mac</code> is specified, the MAC address of the link is used. If this option is omitted, or if <code>duid</code> is specified, networkd will generate an RFC4361-compliant client identifier for the interface by combining the link’s IAID and DUID.</p> </blockquote></li> <li><p><strong>dhcp4-overrides</strong> (mapping)</p> <blockquote> <p>(networkd backend only) Overrides default DHCP behavior; see the <code>DHCP Overrides</code> section below.</p> </blockquote></li> <li><p><strong>dhcp6-overrides</strong> (mapping)</p> <blockquote> <p>(networkd backend only) Overrides default DHCP behavior; see the <code>DHCP Overrides</code> section below.</p> </blockquote></li> <li><p><strong>accept-ra</strong> (bool)</p> <blockquote> <p>Accept Router Advertisement that would have the kernel configure IPv6 by itself. When enabled, accept Router Advertisements. When disabled, do not respond to Router Advertisements. If unset use the host kernel default setting.</p> </blockquote></li> <li><p><strong>addresses</strong> (sequence of scalars and mappings)</p> <blockquote> <p>Add static addresses to the interface in addition to the ones received through DHCP or RA. Each sequence entry is in CIDR notation, i. e. of the form <code>addr/prefixlen</code>. <code>addr</code> is an IPv4 or IPv6 address as recognized by <strong><code>inet_pton</code></strong>(3) and <code>prefixlen</code> the number of bits of the subnet.</p> <p>For virtual devices (bridges, bonds, vlan) if there is no address configured and DHCP is disabled, the interface may still be brought online, but will not be addressable from the network.</p> <p>In addition to the addresses themselves one can specify configuration parameters as mappings. Current supported options are:</p> </blockquote> <ul> <li><p><strong>lifetime</strong> (scalar) – since <strong>0.100</strong></p> <blockquote> <p>Default: <code>forever</code>. This can be <code>forever</code> or <code>0</code> and corresponds to the <code>PreferredLifetime</code> option in <code>systemd-networkd</code>’s Address section. Currently supported on the <code>networkd</code> backend only.</p> </blockquote></li> <li><p><strong>label</strong> (scalar) – since <strong>0.100</strong></p> <blockquote> <p>An IP address label, equivalent to the <code>ip address label</code> command. Currently supported on the <code>networkd</code> backend only.</p> </blockquote></li> </ul> <p>Examples:</p> <ul> <li><p>Simple: <code>addresses: [192.168.14.2/24, "2001:1::1/64"]</code></p></li> <li><p>Advanced:</p> <div class="sourceCode" id="cb7"><pre class="sourceCode yaml"><code class="sourceCode yaml"><span id="cb7-1"><a href="#cb7-1" aria-hidden="true"></a><span class="fu">network</span><span class="kw">:</span></span> <span id="cb7-2"><a href="#cb7-2" aria-hidden="true"></a><span class="at"> </span><span class="fu">ethernets</span><span class="kw">:</span></span> <span id="cb7-3"><a href="#cb7-3" aria-hidden="true"></a><span class="at"> </span><span class="fu">eth0</span><span class="kw">:</span></span> <span id="cb7-4"><a href="#cb7-4" aria-hidden="true"></a><span class="at"> </span><span class="fu">addresses</span><span class="kw">:</span></span> <span id="cb7-5"><a href="#cb7-5" aria-hidden="true"></a><span class="at"> </span><span class="kw">-</span><span class="at"> </span><span class="st">"10.0.0.15/24"</span><span class="kw">:</span></span> <span id="cb7-6"><a href="#cb7-6" aria-hidden="true"></a><span class="at"> </span><span class="fu">lifetime</span><span class="kw">:</span><span class="at"> </span><span class="dv">0</span></span> <span id="cb7-7"><a href="#cb7-7" aria-hidden="true"></a><span class="at"> </span><span class="fu">label</span><span class="kw">:</span><span class="at"> </span><span class="st">"maas"</span></span> <span id="cb7-8"><a href="#cb7-8" aria-hidden="true"></a><span class="at"> </span><span class="kw">-</span><span class="at"> </span><span class="st">"2001:1::1/64"</span></span></code></pre></div></li> </ul></li> <li><p><strong>ipv6-address-generation</strong> (scalar) – since <strong>0.99</strong></p> <blockquote> <p>Configure method for creating the address for use with RFC4862 IPv6 Stateless Address Auto-configuration (only supported with <code>NetworkManager</code> backend). Possible values are <code>eui64</code> or <code>stable-privacy</code>.</p> </blockquote></li> <li><p><strong>ipv6-address-token</strong> (scalar) – since <strong>0.100</strong></p> <blockquote> <p>Define an IPv6 address token for creating a static interface identifier for IPv6 Stateless Address Auto-configuration. This is mutually exclusive with <code>ipv6-address-generation</code>.</p> </blockquote></li> <li><p><strong>gateway4</strong>, <strong>gateway6</strong> (scalar)</p> <blockquote> <p>Deprecated, see <code>Default routes</code>. Set default gateway for IPv4/6, for manual address configuration. This requires setting <code>addresses</code> too. Gateway IPs must be in a form recognized by <strong><code>inet_pton</code></strong>(3). There should only be a single gateway per IP address family set in your global config, to make it unambiguous. If you need multiple default routes, please define them via <code>routing-policy</code>.</p> </blockquote> <p>Examples</p> <ul> <li>IPv4: <code>gateway4: 172.16.0.1</code></li> <li>IPv6: <code>gateway6: "2001:4::1"</code></li> </ul></li> <li><p><strong>nameservers</strong> (mapping)</p> <blockquote> <p>Set DNS servers and search domains, for manual address configuration. There are two supported fields: <code>addresses:</code> is a list of IPv4 or IPv6 addresses similar to <code>gateway*</code>, and <code>search:</code> is a list of search domains.</p> </blockquote> <p>Example:</p> <div class="sourceCode" id="cb8"><pre class="sourceCode yaml"><code class="sourceCode yaml"><span id="cb8-1"><a href="#cb8-1" aria-hidden="true"></a><span class="fu">network</span><span class="kw">:</span></span> <span id="cb8-2"><a href="#cb8-2" aria-hidden="true"></a><span class="at"> </span><span class="fu">ethernets</span><span class="kw">:</span></span> <span id="cb8-3"><a href="#cb8-3" aria-hidden="true"></a><span class="at"> </span><span class="fu">id0</span><span class="kw">:</span></span> <span id="cb8-4"><a href="#cb8-4" aria-hidden="true"></a><span class="at"> </span><span class="kw">[</span><span class="at">...</span><span class="kw">]</span></span> <span id="cb8-5"><a href="#cb8-5" aria-hidden="true"></a><span class="at"> </span><span class="fu">nameservers</span><span class="kw">:</span></span> <span id="cb8-6"><a href="#cb8-6" aria-hidden="true"></a><span class="at"> </span><span class="fu">search</span><span class="kw">:</span><span class="at"> </span><span class="kw">[</span><span class="at">lab</span><span class="kw">,</span><span class="at"> home</span><span class="kw">]</span></span> <span id="cb8-7"><a href="#cb8-7" aria-hidden="true"></a><span class="at"> </span><span class="fu">addresses</span><span class="kw">:</span><span class="at"> </span><span class="kw">[</span><span class="fl">8.8.8.8</span><span class="kw">,</span><span class="at"> </span><span class="st">"FEDC::1"</span><span class="kw">]</span></span></code></pre></div></li> <li><p><strong>macaddress</strong> (scalar)</p> <blockquote> <p>Set the device’s MAC address. The MAC address must be in the form “XX:XX:XX:XX:XX:XX”.</p> <p><strong>Note:</strong> This will not work reliably for devices matched by name only and rendered by networkd, due to interactions with device renaming in udev. Match devices by MAC when setting MAC addresses.</p> </blockquote> <p>Example:</p> <div class="sourceCode" id="cb9"><pre class="sourceCode yaml"><code class="sourceCode yaml"><span id="cb9-1"><a href="#cb9-1" aria-hidden="true"></a><span class="fu">network</span><span class="kw">:</span></span> <span id="cb9-2"><a href="#cb9-2" aria-hidden="true"></a><span class="at"> </span><span class="fu">ethernets</span><span class="kw">:</span></span> <span id="cb9-3"><a href="#cb9-3" aria-hidden="true"></a><span class="at"> </span><span class="fu">id0</span><span class="kw">:</span></span> <span id="cb9-4"><a href="#cb9-4" aria-hidden="true"></a><span class="at"> </span><span class="fu">match</span><span class="kw">:</span></span> <span id="cb9-5"><a href="#cb9-5" aria-hidden="true"></a><span class="at"> </span><span class="fu">macaddress</span><span class="kw">:</span><span class="at"> 52:54:00:6b:3c:58</span></span> <span id="cb9-6"><a href="#cb9-6" aria-hidden="true"></a><span class="at"> </span><span class="kw">[</span><span class="at">...</span><span class="kw">]</span></span> <span id="cb9-7"><a href="#cb9-7" aria-hidden="true"></a><span class="at"> </span><span class="fu">macaddress</span><span class="kw">:</span><span class="at"> 52:54:00:6b:3c:59</span></span></code></pre></div></li> <li><p><strong>mtu</strong> (scalar)</p> <blockquote> <p>Set the Maximum Transmission Unit for the interface. The default is 1500. Valid values depend on your network interface.</p> <p><strong>Note:</strong> This will not work reliably for devices matched by name only and rendered by networkd, due to interactions with device renaming in udev. Match devices by MAC when setting MTU.</p> </blockquote></li> <li><p><strong>optional</strong> (bool)</p> <blockquote> <p>An optional device is not required for booting. Normally, networkd will wait some time for device to become configured before proceeding with booting. However, if a device is marked as optional, networkd will not wait for it. This is <em>only</em> supported by networkd, and the default is false.</p> </blockquote> <p>Example:</p> <div class="sourceCode" id="cb10"><pre class="sourceCode yaml"><code class="sourceCode yaml"><span id="cb10-1"><a href="#cb10-1" aria-hidden="true"></a><span class="fu">network</span><span class="kw">:</span></span> <span id="cb10-2"><a href="#cb10-2" aria-hidden="true"></a><span class="at"> </span><span class="fu">ethernets</span><span class="kw">:</span></span> <span id="cb10-3"><a href="#cb10-3" aria-hidden="true"></a><span class="at"> </span><span class="fu">eth7</span><span class="kw">:</span></span> <span id="cb10-4"><a href="#cb10-4" aria-hidden="true"></a><span class="co"> # this is plugged into a test network that is often</span></span> <span id="cb10-5"><a href="#cb10-5" aria-hidden="true"></a><span class="co"> # down - don't wait for it to come up during boot.</span></span> <span id="cb10-6"><a href="#cb10-6" aria-hidden="true"></a><span class="at"> </span><span class="fu">dhcp4</span><span class="kw">:</span><span class="at"> </span><span class="ch">true</span></span> <span id="cb10-7"><a href="#cb10-7" aria-hidden="true"></a><span class="at"> </span><span class="fu">optional</span><span class="kw">:</span><span class="at"> </span><span class="ch">true</span></span></code></pre></div></li> <li><p><strong>optional-addresses</strong> (sequence of scalars)</p> <blockquote> <p>Specify types of addresses that are not required for a device to be considered online. This changes the behavior of backends at boot time to avoid waiting for addresses that are marked optional, and thus consider the interface as “usable” sooner. This does not disable these addresses, which will be brought up anyway.</p> </blockquote> <p>Example:</p> <div class="sourceCode" id="cb11"><pre class="sourceCode yaml"><code class="sourceCode yaml"><span id="cb11-1"><a href="#cb11-1" aria-hidden="true"></a><span class="fu">network</span><span class="kw">:</span></span> <span id="cb11-2"><a href="#cb11-2" aria-hidden="true"></a><span class="at"> </span><span class="fu">ethernets</span><span class="kw">:</span></span> <span id="cb11-3"><a href="#cb11-3" aria-hidden="true"></a><span class="at"> </span><span class="fu">eth7</span><span class="kw">:</span></span> <span id="cb11-4"><a href="#cb11-4" aria-hidden="true"></a><span class="at"> </span><span class="fu">dhcp4</span><span class="kw">:</span><span class="at"> </span><span class="ch">true</span></span> <span id="cb11-5"><a href="#cb11-5" aria-hidden="true"></a><span class="at"> </span><span class="fu">dhcp6</span><span class="kw">:</span><span class="at"> </span><span class="ch">true</span></span> <span id="cb11-6"><a href="#cb11-6" aria-hidden="true"></a><span class="at"> </span><span class="fu">optional-addresses</span><span class="kw">:</span><span class="at"> </span><span class="kw">[</span><span class="at"> ipv4-ll</span><span class="kw">,</span><span class="at"> dhcp6 </span><span class="kw">]</span></span></code></pre></div></li> <li><p><strong>activation-mode</strong> (scalar) – since <strong>0.103</strong></p> <blockquote> <p>Allows specifying the management policy of the selected interface. By default, netplan brings up any configured interface if possible. Using the <code>activation-mode</code> setting users can override that behavior by either specifying <code>manual</code>, to hand over control over the interface state to the administrator or (for networkd backend <em>only</em>) <code>off</code> to force the link in a down state at all times. Any interface with <code>activation-mode</code> defined is implicitly considered <code>optional</code>. Supported officially as of <code>networkd</code> v248+.</p> </blockquote> <p>Example:</p> <div class="sourceCode" id="cb12"><pre class="sourceCode yaml"><code class="sourceCode yaml"><span id="cb12-1"><a href="#cb12-1" aria-hidden="true"></a><span class="fu">network</span><span class="kw">:</span></span> <span id="cb12-2"><a href="#cb12-2" aria-hidden="true"></a><span class="at"> </span><span class="fu">ethernets</span><span class="kw">:</span></span> <span id="cb12-3"><a href="#cb12-3" aria-hidden="true"></a><span class="at"> </span><span class="fu">eth1</span><span class="kw">:</span></span> <span id="cb12-4"><a href="#cb12-4" aria-hidden="true"></a><span class="co"> # this interface will not be put into an UP state automatically</span></span> <span id="cb12-5"><a href="#cb12-5" aria-hidden="true"></a><span class="at"> </span><span class="fu">dhcp4</span><span class="kw">:</span><span class="at"> </span><span class="ch">true</span></span> <span id="cb12-6"><a href="#cb12-6" aria-hidden="true"></a><span class="at"> </span><span class="fu">activation-mode</span><span class="kw">:</span><span class="at"> manual</span></span></code></pre></div></li> <li><p><strong>routes</strong> (sequence of mappings)</p> <blockquote> <p>Configure static routing for the device; see the <code>Routing</code> section below.</p> </blockquote></li> <li><p><strong>routing-policy</strong> (sequence of mappings)</p> <blockquote> <p>Configure policy routing for the device; see the <code>Routing</code> section below.</p> </blockquote></li> <li><p><strong>neigh-suppress</strong> (scalar) – since <strong>0.105</strong></p> <blockquote> <p>Takes a boolean. Configures whether ARP and ND neighbor suppression is enabled for this port. When unset, the kernel’s default will be used.</p> </blockquote></li> </ul> <h2 id="dhcp-overrides">DHCP Overrides</h2> <p>Several DHCP behavior overrides are available. Most currently only have any effect when using the <code>networkd</code> backend, with the exception of <code>use-routes</code> and <code>route-metric</code>.</p> <p>Overrides only have an effect if the corresponding <code>dhcp4</code> or <code>dhcp6</code> is set to <code>true</code>.</p> <p>If both <code>dhcp4</code> and <code>dhcp6</code> are <code>true</code>, the <code>networkd</code> backend requires that <code>dhcp4-overrides</code> and <code>dhcp6-overrides</code> contain the same keys and values. If the values do not match, an error will be shown and the network configuration will not be applied.</p> <p>When using the NetworkManager backend, different values may be specified for <code>dhcp4-overrides</code> and <code>dhcp6-overrides</code>, and will be applied to the DHCP client processes as specified in the netplan YAML.</p> <ul> <li><p><strong>dhcp4-overrides</strong>, <strong>dhcp6-overrides</strong> (mapping)</p> <blockquote> <p>The <code>dhcp4-overrides</code> and `dhcp6-override`` mappings override the default DHCP behavior.</p> </blockquote> <ul> <li><p><strong>use-dns</strong> (bool)</p> <blockquote> <p>Default: <code>true</code>. When <code>true</code>, the DNS servers received from the DHCP server will be used and take precedence over any statically configured ones. Currently only has an effect on the <code>networkd</code> backend.</p> </blockquote></li> <li><p><strong>use-ntp</strong> (bool)</p> <blockquote> <p>Default: <code>true</code>. When <code>true</code>, the NTP servers received from the DHCP server will be used by systemd-timesyncd and take precedence over any statically configured ones. Currently only has an effect on the <code>networkd</code> backend.</p> </blockquote></li> <li><p><strong>send-hostname</strong> (bool)</p> <blockquote> <p>Default: <code>true</code>. When <code>true</code>, the machine’s hostname will be sent to the DHCP server. Currently only has an effect on the <code>networkd</code> backend.</p> </blockquote></li> <li><p><strong>use-hostname</strong> (bool)</p> <blockquote> <p>Default: <code>true</code>. When <code>true</code>, the hostname received from the DHCP server will be set as the transient hostname of the system. Currently only has an effect on the <code>networkd</code> backend.</p> </blockquote></li> <li><p><strong>use-mtu</strong> (bool)</p> <blockquote> <p>Default: <code>true</code>. When <code>true</code>, the MTU received from the DHCP server will be set as the MTU of the network interface. When <code>false</code>, the MTU advertised by the DHCP server will be ignored. Currently only has an effect on the <code>networkd</code> backend.</p> </blockquote></li> <li><p><strong>hostname</strong> (scalar)</p> <blockquote> <p>Use this value for the hostname which is sent to the DHCP server, instead of machine’s hostname. Currently only has an effect on the <code>networkd</code> backend.</p> </blockquote></li> <li><p><strong>use-routes</strong> (bool)</p> <blockquote> <p>Default: <code>true</code>. When <code>true</code>, the routes received from the DHCP server will be installed in the routing table normally. When set to <code>false</code>, routes from the DHCP server will be ignored: in this case, the user is responsible for adding static routes if necessary for correct network operation. This allows users to avoid installing a default gateway for interfaces configured via DHCP. Available for both the <code>networkd</code> and <code>NetworkManager</code> backends.</p> </blockquote></li> <li><p><strong>route-metric</strong> (scalar)</p> <blockquote> <p>Use this value for default metric for automatically-added routes. Use this to prioritize routes for devices by setting a lower metric on a preferred interface. Available for both the <code>networkd</code> and <code>NetworkManager</code> backends.</p> </blockquote></li> <li><p><strong>use-domains</strong> (scalar) – since <strong>0.98</strong></p> <blockquote> <p>Takes a boolean, or the special value “route”. When true, the domain name received from the DHCP server will be used as DNS search domain over this link, similar to the effect of the Domains= setting. If set to “route”, the domain name received from the DHCP server will be used for routing DNS queries only, but not for searching, similar to the effect of the Domains= setting when the argument is prefixed with “~”.</p> <p><strong>Requires feature: dhcp-use-domains</strong></p> </blockquote></li> </ul></li> </ul> <h2 id="routing">Routing</h2> <p>Complex routing is possible with netplan. Standard static routes as well as policy routing using routing tables are supported via the <code>networkd</code> backend.</p> <p>These options are available for all types of interfaces.</p> <h3 id="default-routes">Default routes</h3> <p>The most common need for routing concerns the definition of default routes to reach the wider Internet. Those default routes can only defined once per IP family and routing table. A typical example would look like the following:</p> <div class="sourceCode" id="cb13"><pre class="sourceCode yaml"><code class="sourceCode yaml"><span id="cb13-1"><a href="#cb13-1" aria-hidden="true"></a><span class="fu">network</span><span class="kw">:</span></span> <span id="cb13-2"><a href="#cb13-2" aria-hidden="true"></a><span class="at"> </span><span class="fu">ethernets</span><span class="kw">:</span></span> <span id="cb13-3"><a href="#cb13-3" aria-hidden="true"></a><span class="at"> </span><span class="fu">eth0</span><span class="kw">:</span></span> <span id="cb13-4"><a href="#cb13-4" aria-hidden="true"></a><span class="at"> </span><span class="kw">[</span><span class="at">...</span><span class="kw">]</span></span> <span id="cb13-5"><a href="#cb13-5" aria-hidden="true"></a><span class="at"> </span><span class="fu">routes</span><span class="kw">:</span></span> <span id="cb13-6"><a href="#cb13-6" aria-hidden="true"></a><span class="at"> </span><span class="kw">-</span><span class="at"> </span><span class="fu">to</span><span class="kw">:</span><span class="at"> default</span><span class="co"> # could be 0.0.0.0/0 optionally</span></span> <span id="cb13-7"><a href="#cb13-7" aria-hidden="true"></a><span class="at"> </span><span class="fu">via</span><span class="kw">:</span><span class="at"> </span><span class="fl">10.0.0.1</span></span> <span id="cb13-8"><a href="#cb13-8" aria-hidden="true"></a><span class="at"> </span><span class="fu">metric</span><span class="kw">:</span><span class="at"> </span><span class="dv">100</span></span> <span id="cb13-9"><a href="#cb13-9" aria-hidden="true"></a><span class="at"> </span><span class="fu">on-link</span><span class="kw">:</span><span class="at"> </span><span class="ch">true</span></span> <span id="cb13-10"><a href="#cb13-10" aria-hidden="true"></a><span class="at"> </span><span class="kw">-</span><span class="at"> </span><span class="fu">to</span><span class="kw">:</span><span class="at"> default</span><span class="co"> # could be ::/0 optionally</span></span> <span id="cb13-11"><a href="#cb13-11" aria-hidden="true"></a><span class="at"> </span><span class="fu">via</span><span class="kw">:</span><span class="at"> cf02:de:ad:be:ef::2</span></span> <span id="cb13-12"><a href="#cb13-12" aria-hidden="true"></a><span class="at"> </span><span class="fu">eth1</span><span class="kw">:</span></span> <span id="cb13-13"><a href="#cb13-13" aria-hidden="true"></a><span class="at"> </span><span class="kw">[</span><span class="at">...</span><span class="kw">]</span></span> <span id="cb13-14"><a href="#cb13-14" aria-hidden="true"></a><span class="at"> </span><span class="fu">routes</span><span class="kw">:</span></span> <span id="cb13-15"><a href="#cb13-15" aria-hidden="true"></a><span class="at"> </span><span class="kw">-</span><span class="at"> </span><span class="fu">to</span><span class="kw">:</span><span class="at"> default</span></span> <span id="cb13-16"><a href="#cb13-16" aria-hidden="true"></a><span class="at"> </span><span class="fu">via</span><span class="kw">:</span><span class="at"> </span><span class="fl">172.134.67.1</span></span> <span id="cb13-17"><a href="#cb13-17" aria-hidden="true"></a><span class="at"> </span><span class="fu">metric</span><span class="kw">:</span><span class="at"> </span><span class="dv">100</span></span> <span id="cb13-18"><a href="#cb13-18" aria-hidden="true"></a><span class="at"> </span><span class="fu">on-link</span><span class="kw">:</span><span class="at"> </span><span class="ch">true</span></span> <span id="cb13-19"><a href="#cb13-19" aria-hidden="true"></a><span class="co"> # Not on the main routing table,</span></span> <span id="cb13-20"><a href="#cb13-20" aria-hidden="true"></a><span class="co"> # does not conflict with the eth0 default route</span></span> <span id="cb13-21"><a href="#cb13-21" aria-hidden="true"></a><span class="at"> </span><span class="fu">table</span><span class="kw">:</span><span class="at"> </span><span class="dv">76</span></span></code></pre></div> <ul> <li><p><strong>routes</strong> (mapping)</p> <blockquote> <p>The <code>routes</code> block defines standard static routes for an interface. At least <code>to</code> must be specified. If type is <code>local</code> or <code>nat</code> a default scope of <code>host</code> is assumed. If type is <code>unicast</code> and no gateway (<code>via</code>) is given or type is <code>broadcast</code>, <code>multicast</code> or <code>anycast</code> a default scope of <code>link</code> is assumed. Otherwise, a <code>global</code> scope is the default setting.</p> <p>For <code>from</code>, <code>to</code>, and <code>via</code>, both IPv4 and IPv6 addresses are recognized, and must be in the form <code>addr/prefixlen</code> or <code>addr</code>.</p> </blockquote> <ul> <li><p><strong>from</strong> (scalar)</p> <blockquote> <p>Set a source IP address for traffic going through the route. (<code>NetworkManager</code>: as of v1.8.0)</p> </blockquote></li> <li><p><strong>to</strong> (scalar)</p> <blockquote> <p>Destination address for the route.</p> </blockquote></li> <li><p><strong>via</strong> (scalar)</p> <blockquote> <p>Address to the gateway to use for this route.</p> </blockquote></li> <li><p><strong>on-link</strong> (bool)</p> <blockquote> <p>When set to “true”, specifies that the route is directly connected to the interface. (<code>NetworkManager</code>: as of v1.12.0 for IPv4 and v1.18.0 for IPv6)</p> </blockquote></li> <li><p><strong>metric</strong> (scalar)</p> <blockquote> <p>The relative priority of the route. Must be a positive integer value.</p> </blockquote></li> <li><p><strong>type</strong> (scalar)</p> <blockquote> <p>The type of route. Valid options are “unicast” (default), “anycast”, “blackhole”, “broadcast”, “local”, “multicast”, “nat”, “prohibit”, “throw”, “unreachable” or “xresolve”.</p> </blockquote></li> <li><p><strong>scope</strong> (scalar)</p> <blockquote> <p>The route scope, how wide-ranging it is to the network. Possible values are “global”, “link”, or “host”. Applies to IPv4 only.</p> </blockquote></li> <li><p><strong>table</strong> (scalar)</p> <blockquote> <p>The table number to use for the route. In some scenarios, it may be useful to set routes in a separate routing table. It may also be used to refer to routing policy rules which also accept a <code>table</code> parameter. Allowed values are positive integers starting from 1. Some values are already in use to refer to specific routing tables: see <code>/etc/iproute2/rt_tables</code>. (<code>NetworkManager</code>: as of v1.10.0)</p> </blockquote></li> <li><p><strong>mtu</strong> (scalar) – since <strong>0.101</strong></p> <blockquote> <p>The MTU to be used for the route, in bytes. Must be a positive integer value.</p> </blockquote></li> <li><p><strong>congestion-window</strong> (scalar) – since <strong>0.102</strong></p> <blockquote> <p>The congestion window to be used for the route, represented by number of segments. Must be a positive integer value.</p> </blockquote></li> <li><p><strong>advertised-receive-window</strong> (scalar) – since <strong>0.102</strong></p> <blockquote> <p>The receive window to be advertised for the route, represented by number of segments. Must be a positive integer value.</p> </blockquote></li> </ul></li> <li><p><strong>routing-policy</strong> (mapping)</p> <blockquote> <p>The <code>routing-policy</code> block defines extra routing policy for a network, where traffic may be handled specially based on the source IP, firewall marking, etc.</p> <p>For <code>from</code>, <code>to</code>, both IPv4 and IPv6 addresses are recognized, and must be in the form <code>addr/prefixlen</code> or <code>addr</code>.</p> </blockquote> <ul> <li><p><strong>from</strong> (scalar)</p> <blockquote> <p>Set a source IP address to match traffic for this policy rule.</p> </blockquote></li> <li><p><strong>to</strong> (scalar)</p> <blockquote> <p>Match on traffic going to the specified destination.</p> </blockquote></li> <li><p><strong>table</strong> (scalar)</p> <blockquote> <p>The table number to match for the route. In some scenarios, it may be useful to set routes in a separate routing table. It may also be used to refer to routes which also accept a <code>table</code> parameter. Allowed values are positive integers starting from 1. Some values are already in use to refer to specific routing tables: see <code>/etc/iproute2/rt_tables</code>.</p> </blockquote></li> <li><p><strong>priority</strong> (scalar)</p> <blockquote> <p>Specify a priority for the routing policy rule, to influence the order in which routing rules are processed. A higher number means lower priority: rules are processed in order by increasing priority number.</p> </blockquote></li> <li><p><strong>mark</strong> (scalar)</p> <blockquote> <p>Have this routing policy rule match on traffic that has been marked by the iptables firewall with this value. Allowed values are positive integers starting from 1.</p> </blockquote></li> <li><p><strong>type-of-service</strong> (scalar)</p> <blockquote> <p>Match this policy rule based on the type of service number applied to the traffic.</p> </blockquote></li> </ul></li> </ul> <h2 id="authentication">Authentication</h2> <p>Netplan supports advanced authentication settings for ethernet and wifi interfaces, as well as individual wifi networks, by means of the <code>auth</code> block.</p> <ul> <li><p><strong>auth</strong> (mapping)</p> <blockquote> <p>Specifies authentication settings for a device of type <code>ethernets:</code>, or an <code>access-points:</code> entry on a <code>wifis:</code> device.</p> <p>The <code>auth</code> block supports the following properties:</p> </blockquote> <ul> <li><p><strong>key-management</strong> (scalar)</p> <blockquote> <p>The supported key management modes are <code>none</code> (no key management); <code>psk</code> (WPA with pre-shared key, common for home wifi); <code>eap</code> (WPA with EAP, common for enterprise wifi); <code>sae</code> (used by WPA3); and <code>802.1x</code> (used primarily for wired Ethernet connections).</p> </blockquote></li> <li><p><strong>password</strong> (scalar)</p> <blockquote> <p>The password string for EAP, or the pre-shared key for WPA-PSK.</p> </blockquote> <p>The following properties can be used if <code>key-management</code> is <code>eap</code> or <code>802.1x</code>:</p></li> <li><p><strong>method</strong> (scalar)</p> <blockquote> <p>The EAP method to use. The supported EAP methods are <code>tls</code> (TLS), <code>peap</code> (Protected EAP), and <code>ttls</code> (Tunneled TLS).</p> </blockquote></li> <li><p><strong>identity</strong> (scalar)</p> <blockquote> <p>The identity to use for EAP.</p> </blockquote></li> <li><p><strong>anonymous-identity</strong> (scalar)</p> <blockquote> <p>The identity to pass over the unencrypted channel if the chosen EAP method supports passing a different tunnelled identity.</p> </blockquote></li> <li><p><strong>ca-certificate</strong> (scalar)</p> <blockquote> <p>Path to a file with one or more trusted certificate authority (CA) certificates.</p> </blockquote></li> <li><p><strong>client-certificate</strong> (scalar)</p> <blockquote> <p>Path to a file containing the certificate to be used by the client during authentication.</p> </blockquote></li> <li><p><strong>client-key</strong> (scalar)</p> <blockquote> <p>Path to a file containing the private key corresponding to <code>client-certificate</code>.</p> </blockquote></li> <li><p><strong>client-key-password</strong> (scalar)</p> <blockquote> <p>Password to use to decrypt the private key specified in <code>client-key</code> if it is encrypted.</p> </blockquote></li> <li><p><strong>phase2-auth</strong> (scalar) – since <strong>0.99</strong></p> <blockquote> <p>Phase 2 authentication mechanism.</p> </blockquote></li> </ul></li> </ul> <h2 id="properties-for-device-type-ethernets">Properties for device type <code>ethernets:</code></h2> <p><strong>Status</strong>: Optional.</p> <p><strong>Purpose</strong>: Use the <code>ethernets</code> key to configure Ethernet interfaces.</p> <p><strong>Structure</strong>: The key consists of a mapping of Ethernet interface IDs. Each <code>ethernet</code> has a number of configuration options. You don’t need to define each interface by their name inside the <code>ethernets</code> mapping. You can use any ID that describes the interface and match the actual network card using the <code>match</code> key. The general configuration structure for Ethernets is shown below.</p> <div class="sourceCode" id="cb14"><pre class="sourceCode yaml"><code class="sourceCode yaml"><span id="cb14-1"><a href="#cb14-1" aria-hidden="true"></a><span class="fu">network</span><span class="kw">:</span></span> <span id="cb14-2"><a href="#cb14-2" aria-hidden="true"></a><span class="at"> </span><span class="fu">ethernets</span><span class="kw">:</span></span> <span id="cb14-3"><a href="#cb14-3" aria-hidden="true"></a><span class="at"> </span><span class="fu">device-id</span><span class="kw">:</span></span> <span id="cb14-4"><a href="#cb14-4" aria-hidden="true"></a><span class="at"> ...</span></span></code></pre></div> <p><code>device-id</code> is the interface identifier. If you use the interface name as the ID, Netplan will match that interface.</p> <p>Consider the example below. In this case, an interface called <code>eth0</code> will be configured with DHCP.</p> <div class="sourceCode" id="cb15"><pre class="sourceCode yaml"><code class="sourceCode yaml"><span id="cb15-1"><a href="#cb15-1" aria-hidden="true"></a><span class="fu">network</span><span class="kw">:</span></span> <span id="cb15-2"><a href="#cb15-2" aria-hidden="true"></a><span class="at"> </span><span class="fu">ethernets</span><span class="kw">:</span></span> <span id="cb15-3"><a href="#cb15-3" aria-hidden="true"></a><span class="at"> </span><span class="fu">eth0</span><span class="kw">:</span></span> <span id="cb15-4"><a href="#cb15-4" aria-hidden="true"></a><span class="at"> </span><span class="fu">dhcp4</span><span class="kw">:</span><span class="at"> </span><span class="ch">true</span></span></code></pre></div> <p>The <code>device-id</code> can be any descriptive name your find meaningful. Although, if it doesn’t match a real interface name, you must use the property <code>match</code> to identify the device you want to configure.</p> <p>The example below defines an Ethernet connection called <code>isp-interface</code> (supposedly an external interface connected to the Internet Service Provider) and uses <code>match</code> to apply the configuration to the physical device with MAC address <code>aa:bb:cc:00:11:22</code>.</p> <div class="sourceCode" id="cb16"><pre class="sourceCode yaml"><code class="sourceCode yaml"><span id="cb16-1"><a href="#cb16-1" aria-hidden="true"></a><span class="fu">network</span><span class="kw">:</span></span> <span id="cb16-2"><a href="#cb16-2" aria-hidden="true"></a><span class="at"> </span><span class="fu">ethernets</span><span class="kw">:</span></span> <span id="cb16-3"><a href="#cb16-3" aria-hidden="true"></a><span class="at"> </span><span class="fu">isp-interface</span><span class="kw">:</span></span> <span id="cb16-4"><a href="#cb16-4" aria-hidden="true"></a><span class="at"> </span><span class="fu">match</span><span class="kw">:</span></span> <span id="cb16-5"><a href="#cb16-5" aria-hidden="true"></a><span class="at"> </span><span class="fu">macaddress</span><span class="kw">:</span><span class="at"> aa:bb:cc:00:11:22</span></span> <span id="cb16-6"><a href="#cb16-6" aria-hidden="true"></a><span class="at"> </span><span class="fu">dhcp4</span><span class="kw">:</span><span class="at"> </span><span class="ch">true</span></span></code></pre></div> <p>Ethernet device definitions, beyond common ones described above, also support some additional properties that can be used for SR-IOV devices.</p> <ul> <li><p><strong>link</strong> (scalar) – since <strong>0.99</strong></p> <blockquote> <p>(SR-IOV devices only) The <code>link</code> property declares the device as a Virtual Function of the selected Physical Function device, as identified by the given netplan id.</p> </blockquote> <p>Example:</p> <div class="sourceCode" id="cb17"><pre class="sourceCode yaml"><code class="sourceCode yaml"><span id="cb17-1"><a href="#cb17-1" aria-hidden="true"></a><span class="fu">network</span><span class="kw">:</span></span> <span id="cb17-2"><a href="#cb17-2" aria-hidden="true"></a><span class="at"> </span><span class="fu">ethernets</span><span class="kw">:</span></span> <span id="cb17-3"><a href="#cb17-3" aria-hidden="true"></a><span class="at"> </span><span class="fu">enp1</span><span class="kw">:</span><span class="at"> </span><span class="kw">{</span><span class="at">...</span><span class="kw">}</span></span> <span id="cb17-4"><a href="#cb17-4" aria-hidden="true"></a><span class="at"> </span><span class="fu">enp1s16f1</span><span class="kw">:</span></span> <span id="cb17-5"><a href="#cb17-5" aria-hidden="true"></a><span class="at"> </span><span class="fu">link</span><span class="kw">:</span><span class="at"> enp1</span></span></code></pre></div></li> <li><p><strong>virtual-function-count</strong> (scalar) – since <strong>0.99</strong></p> <blockquote> <p>(SR-IOV devices only) In certain special cases VFs might need to be configured outside of netplan. For such configurations <code>virtual-function-count</code> can be optionally used to set an explicit number of Virtual Functions for the given Physical Function. If unset, the default is to create only as many VFs as are defined in the netplan configuration. This should be used for special cases only.</p> <p><strong>Requires feature: sriov</strong></p> </blockquote></li> <li><p><strong>embedded-switch-mode</strong> (scalar) – since <strong>0.104</strong></p> <blockquote> <p>(SR-IOV devices only) Change the operational mode of the embedded switch of a supported SmartNIC PCI device (e.g. Mellanox ConnectX-5). Possible values are <code>switchdev</code> or <code>legacy</code>, if unspecified the vendor’s default configuration is used.</p> <p><strong>Requires feature: eswitch-mode</strong></p> </blockquote></li> <li><p><strong>delay-virtual-functions-rebind</strong> (bool) – since <strong>0.104</strong></p> <blockquote> <p>(SR-IOV devices only) Delay rebinding of SR-IOV virtual functions to its driver after changing the embedded-switch-mode setting to a later stage. Can be enabled when bonding/VF LAG is in use. Defaults to <code>false</code>.</p> <p><strong>Requires feature: eswitch-mode</strong></p> </blockquote></li> <li><p><strong>infiniband-mode</strong> (scalar) – since <strong>0.105</strong></p> <blockquote> <p>(InfiniBand devices only) Change the operational mode of a IPoIB device. Possible values are <code>datagram</code> or <code>connected</code>. If unspecified the kernel’s default configuration is used.</p> <p><strong>Requires feature: infiniband</strong></p> </blockquote></li> </ul> <h2 id="properties-for-device-type-modems">Properties for device type <code>modems:</code></h2> <p><strong>Status</strong>: Optional.</p> <p><strong>Purpose</strong>: Use the <code>modems</code> key to configure Modem interfaces. GSM/CDMA modem configuration is only supported for the <code>NetworkManager</code> backend. <code>systemd-networkd</code> does not support modems.</p> <p><strong>Structure</strong>: The key consists of a mapping of Modem IDs. Each <code>modem</code> has a number of configuration options. The general configuration structure for Modems is shown below.</p> <div class="sourceCode" id="cb18"><pre class="sourceCode yaml"><code class="sourceCode yaml"><span id="cb18-1"><a href="#cb18-1" aria-hidden="true"></a><span class="fu">network</span><span class="kw">:</span></span> <span id="cb18-2"><a href="#cb18-2" aria-hidden="true"></a><span class="at"> </span><span class="fu">version</span><span class="kw">:</span><span class="at"> </span><span class="dv">2</span></span> <span id="cb18-3"><a href="#cb18-3" aria-hidden="true"></a><span class="at"> </span><span class="fu">renderer</span><span class="kw">:</span><span class="at"> NetworkManager</span></span> <span id="cb18-4"><a href="#cb18-4" aria-hidden="true"></a><span class="at"> </span><span class="fu">modems</span><span class="kw">:</span></span> <span id="cb18-5"><a href="#cb18-5" aria-hidden="true"></a><span class="at"> </span><span class="fu">cdc-wdm1</span><span class="kw">:</span></span> <span id="cb18-6"><a href="#cb18-6" aria-hidden="true"></a><span class="at"> </span><span class="fu">mtu</span><span class="kw">:</span><span class="at"> </span><span class="dv">1600</span></span> <span id="cb18-7"><a href="#cb18-7" aria-hidden="true"></a><span class="at"> </span><span class="fu">apn</span><span class="kw">:</span><span class="at"> ISP.CINGULAR</span></span> <span id="cb18-8"><a href="#cb18-8" aria-hidden="true"></a><span class="at"> </span><span class="fu">username</span><span class="kw">:</span><span class="at"> ISP@CINGULARGPRS.COM</span></span> <span id="cb18-9"><a href="#cb18-9" aria-hidden="true"></a><span class="at"> </span><span class="fu">password</span><span class="kw">:</span><span class="at"> CINGULAR1</span></span> <span id="cb18-10"><a href="#cb18-10" aria-hidden="true"></a><span class="at"> </span><span class="fu">number</span><span class="kw">:</span><span class="at"> </span><span class="st">"*99#"</span></span> <span id="cb18-11"><a href="#cb18-11" aria-hidden="true"></a><span class="at"> </span><span class="fu">network-id</span><span class="kw">:</span><span class="at"> </span><span class="dv">24005</span></span> <span id="cb18-12"><a href="#cb18-12" aria-hidden="true"></a><span class="at"> </span><span class="fu">device-id</span><span class="kw">:</span><span class="at"> da812de91eec16620b06cd0ca5cbc7ea25245222</span></span> <span id="cb18-13"><a href="#cb18-13" aria-hidden="true"></a><span class="at"> </span><span class="fu">pin</span><span class="kw">:</span><span class="at"> </span><span class="dv">2345</span></span> <span id="cb18-14"><a href="#cb18-14" aria-hidden="true"></a><span class="at"> </span><span class="fu">sim-id</span><span class="kw">:</span><span class="at"> </span><span class="dv">89148000000060671234</span></span> <span id="cb18-15"><a href="#cb18-15" aria-hidden="true"></a><span class="at"> </span><span class="fu">sim-operator-id</span><span class="kw">:</span><span class="at"> </span><span class="dv">310260</span></span></code></pre></div> <p><strong>Requires feature: modems</strong></p> <ul> <li><p><strong>apn</strong> (scalar) – since <strong>0.99</strong></p> <blockquote> <p>Set the carrier APN (Access Point Name). This can be omitted if <code>auto-config</code> is enabled.</p> </blockquote></li> <li><p><strong>auto-config</strong> (bool) – since <strong>0.99</strong></p> <blockquote> <p>Specify whether to try and auto-configure the modem by doing a lookup of the carrier against the Mobile Broadband Provider database. This may not work for all carriers.</p> </blockquote></li> <li><p><strong>device-id</strong> (scalar) – since <strong>0.99</strong></p> <blockquote> <p>Specify the device ID (as given by the WWAN management service) of the modem to match. This can be found using <code>mmcli</code>.</p> </blockquote></li> <li><p><strong>network-id</strong> (scalar) – since <strong>0.99</strong></p> <blockquote> <p>Specify the Network ID (GSM LAI format). If this is specified, the device will not roam networks.</p> </blockquote></li> <li><p><strong>number</strong> (scalar) – since <strong>0.99</strong></p> <blockquote> <p>The number to dial to establish the connection to the mobile broadband network. (Deprecated for GSM)</p> </blockquote></li> <li><p><strong>password</strong> (scalar) – since <strong>0.99</strong></p> <blockquote> <p>Specify the password used to authenticate with the carrier network. This can be omitted if <code>auto-config</code> is enabled.</p> </blockquote></li> <li><p><strong>pin</strong> (scalar) – since <strong>0.99</strong></p> <blockquote> <p>Specify the SIM PIN to allow it to operate if a PIN is set.</p> </blockquote></li> <li><p><strong>sim-id</strong> (scalar) – since <strong>0.99</strong></p> <blockquote> <p>Specify the SIM unique identifier (as given by the WWAN management service) which this connection applies to. If given, the connection will apply to any device also allowed by <code>device-id</code> which contains a SIM card matching the given identifier.</p> </blockquote></li> <li><p><strong>sim-operator-id</strong> (scalar) – since <strong>0.99</strong></p> <blockquote> <p>Specify the MCC/MNC string (such as “310260” or “21601”) which identifies the carrier that this connection should apply to. If given, the connection will apply to any device also allowed by <code>device-id</code> and <code>sim-id</code> which contains a SIM card provisioned by the given operator.</p> </blockquote></li> <li><p><strong>username</strong> (scalar) – since <strong>0.99</strong></p> <blockquote> <p>Specify the username used to authenticate with the carrier network. This can be omitted if <code>auto-config</code> is enabled.</p> </blockquote></li> </ul> <h2 id="properties-for-device-type-wifis">Properties for device type <code>wifis:</code></h2> <p><strong>Status</strong>: Optional.</p> <p><strong>Purpose</strong>: Use the <code>wifis</code> key to configure WiFi access points.</p> <p><strong>Structure</strong>: The key consists of a mapping of WiFi IDs. Each <code>wifi</code> has a number of configuration options. The general configuration structure for WiFis is shown below.</p> <div class="sourceCode" id="cb19"><pre class="sourceCode yaml"><code class="sourceCode yaml"><span id="cb19-1"><a href="#cb19-1" aria-hidden="true"></a><span class="fu">network</span><span class="kw">:</span></span> <span id="cb19-2"><a href="#cb19-2" aria-hidden="true"></a><span class="at"> </span><span class="fu">version</span><span class="kw">:</span><span class="at"> </span><span class="dv">2</span></span> <span id="cb19-3"><a href="#cb19-3" aria-hidden="true"></a><span class="at"> </span><span class="fu">wifis</span><span class="kw">:</span></span> <span id="cb19-4"><a href="#cb19-4" aria-hidden="true"></a><span class="at"> </span><span class="fu">wlp0s1</span><span class="kw">:</span></span> <span id="cb19-5"><a href="#cb19-5" aria-hidden="true"></a><span class="at"> </span><span class="fu">access-points</span><span class="kw">:</span></span> <span id="cb19-6"><a href="#cb19-6" aria-hidden="true"></a><span class="at"> </span><span class="fu">"network_ssid_name"</span><span class="kw">:</span></span> <span id="cb19-7"><a href="#cb19-7" aria-hidden="true"></a><span class="at"> </span><span class="fu">password</span><span class="kw">:</span><span class="at"> </span><span class="st">"**********"</span></span></code></pre></div> <p>Note that <code>systemd-networkd</code> does not natively support wifi, so you need wpasupplicant installed if you let the <code>networkd</code> renderer handle wifi.</p> <ul> <li><p><strong>access-points</strong> (mapping)</p> <blockquote> <p>This provides pre-configured connections to NetworkManager. Note that users can of course select other access points/SSIDs. The keys of the mapping are the SSIDs, and the values are mappings with the following supported properties:</p> </blockquote> <ul> <li><p><strong>password</strong> (scalar)</p> <blockquote> <p>Enable WPA/WPA2 authentication and set the passphrase for it. If neither this nor an <code>auth</code> block are given, the network is assumed to be open. The setting</p> <div class="sourceCode" id="cb20"><pre class="sourceCode yaml"><code class="sourceCode yaml"><span id="cb20-1"><a href="#cb20-1" aria-hidden="true"></a><span class="fu">password</span><span class="kw">:</span><span class="at"> </span><span class="st">"S3kr1t"</span></span></code></pre></div> <p>is equivalent to</p> <div class="sourceCode" id="cb21"><pre class="sourceCode yaml"><code class="sourceCode yaml"><span id="cb21-1"><a href="#cb21-1" aria-hidden="true"></a><span class="fu">auth</span><span class="kw">:</span></span> <span id="cb21-2"><a href="#cb21-2" aria-hidden="true"></a><span class="at"> </span><span class="fu">key-management</span><span class="kw">:</span><span class="at"> psk</span></span> <span id="cb21-3"><a href="#cb21-3" aria-hidden="true"></a><span class="at"> </span><span class="fu">password</span><span class="kw">:</span><span class="at"> </span><span class="st">"S3kr1t"</span></span></code></pre></div> </blockquote></li> <li><p><strong>mode</strong> (scalar)</p> <blockquote> <p>Possible access point modes are <code>infrastructure</code> (the default), <code>ap</code> (create an access point to which other devices can connect), and <code>adhoc</code> (peer to peer networks without a central access point). <code>ap</code> is only supported with NetworkManager.</p> </blockquote></li> <li><p><strong>bssid</strong> (scalar) – since <strong>0.99</strong></p> <blockquote> <p>If specified, directs the device to only associate with the given access point.</p> </blockquote></li> <li><p><strong>band</strong> (scalar) – since <strong>0.99</strong></p> <blockquote> <p>Possible bands are <code>5GHz</code> (for 5GHz 802.11a) and <code>2.4GHz</code> (for 2.4GHz 802.11), do not restrict the 802.11 frequency band of the network if unset (the default).</p> </blockquote></li> <li><p><strong>channel</strong> (scalar) – since <strong>0.99</strong></p> <blockquote> <p>Wireless channel to use for the Wi-Fi connection. Because channel numbers overlap between bands, this property takes effect only if the <code>band</code> property is also set.</p> </blockquote></li> <li><p><strong>hidden</strong> (bool) – since <strong>0.100</strong></p> <blockquote> <p>Set to <code>true</code> to change the SSID scan technique for connecting to hidden WiFi networks. Note this may have slower performance compared to <code>false</code> (the default) when connecting to publicly broadcast SSIDs.</p> </blockquote></li> </ul></li> <li><p><strong>wakeonwlan</strong> (sequence of scalars) – since <strong>0.99</strong></p> <blockquote> <p>This enables WakeOnWLan on supported devices. Not all drivers support all options. May be any combination of <code>any</code>, <code>disconnect</code>, <code>magic_pkt</code>, <code>gtk_rekey_failure</code>, <code>eap_identity_req</code>, <code>four_way_handshake</code>, <code>rfkill_release</code> or <code>tcp</code> (NetworkManager only). Or the exclusive <code>default</code> flag (the default).</p> </blockquote></li> <li><p><strong>regulatory-domain</strong> (scalar) – since <strong>0.105</strong></p> <blockquote> <p>This can be used to define the radio’s regulatory domain, to make use of additional WiFi channels outside the “world domain”. Takes an ISO / IEC 3166 country code (like <code>GB</code>) or <code>00</code> to reset to the “world domain”. See <a href="https://git.kernel.org/pub/scm/linux/kernel/git/sforshee/wireless-regdb.git/tree/db.txt">wireless-regdb</a> for available values.</p> <p><strong>Requires dependency: iw</strong>, if it is to be used outside the <code>networkd</code> (wpa_supplicant) backend.</p> </blockquote></li> </ul> <h2 id="properties-for-device-type-bridges">Properties for device type <code>bridges:</code></h2> <p><strong>Status</strong>: Optional.</p> <p><strong>Purpose</strong>: Use the <code>bridges</code> key to create Bridge interfaces.</p> <p><strong>Structure</strong>: The key consists of a mapping of Bridge interface names. Each <code>bridge</code> has an optional list of interfaces that will be bridged together. The interfaces listed in the <code>interfaces</code> key (<code>enp5s0</code> and <code>enp5s1</code> below) must also be defined in your Netplan configuration. The general configuration structure for Bridges is shown below.</p> <div class="sourceCode" id="cb22"><pre class="sourceCode yaml"><code class="sourceCode yaml"><span id="cb22-1"><a href="#cb22-1" aria-hidden="true"></a><span class="fu">network</span><span class="kw">:</span></span> <span id="cb22-2"><a href="#cb22-2" aria-hidden="true"></a><span class="at"> </span><span class="fu">bridges</span><span class="kw">:</span></span> <span id="cb22-3"><a href="#cb22-3" aria-hidden="true"></a><span class="at"> </span><span class="fu">br0</span><span class="kw">:</span></span> <span id="cb22-4"><a href="#cb22-4" aria-hidden="true"></a><span class="at"> </span><span class="fu">interfaces</span><span class="kw">:</span></span> <span id="cb22-5"><a href="#cb22-5" aria-hidden="true"></a><span class="at"> </span><span class="kw">-</span><span class="at"> enp5s0</span></span> <span id="cb22-6"><a href="#cb22-6" aria-hidden="true"></a><span class="at"> </span><span class="kw">-</span><span class="at"> enp5s1</span></span> <span id="cb22-7"><a href="#cb22-7" aria-hidden="true"></a><span class="at"> </span><span class="fu">dhcp4</span><span class="kw">:</span><span class="at"> </span><span class="ch">true</span></span> <span id="cb22-8"><a href="#cb22-8" aria-hidden="true"></a><span class="at"> ...</span></span></code></pre></div> <p>When applied, a virtual interface of type bridge called <code>br0</code> will be created in the system.</p> <p>The specific settings for bridges are defined below.</p> <ul> <li><p><strong>interfaces</strong> (sequence of scalars)</p> <blockquote> <p>All devices matching this ID list will be added to the bridge. This may be an empty list, in which case the bridge will be brought online with no member interfaces.</p> </blockquote> <p>Example:</p> <div class="sourceCode" id="cb23"><pre class="sourceCode yaml"><code class="sourceCode yaml"><span id="cb23-1"><a href="#cb23-1" aria-hidden="true"></a><span class="fu">network</span><span class="kw">:</span></span> <span id="cb23-2"><a href="#cb23-2" aria-hidden="true"></a><span class="at"> </span><span class="fu">ethernets</span><span class="kw">:</span></span> <span id="cb23-3"><a href="#cb23-3" aria-hidden="true"></a><span class="at"> </span><span class="fu">switchports</span><span class="kw">:</span></span> <span id="cb23-4"><a href="#cb23-4" aria-hidden="true"></a><span class="at"> </span><span class="fu">match</span><span class="kw">:</span><span class="at"> </span><span class="kw">{</span><span class="fu">name</span><span class="kw">:</span><span class="at"> </span><span class="st">"enp2*"</span><span class="kw">}</span></span> <span id="cb23-5"><a href="#cb23-5" aria-hidden="true"></a><span class="at"> </span><span class="kw">[</span><span class="at">...</span><span class="kw">]</span></span> <span id="cb23-6"><a href="#cb23-6" aria-hidden="true"></a><span class="at"> </span><span class="fu">bridges</span><span class="kw">:</span></span> <span id="cb23-7"><a href="#cb23-7" aria-hidden="true"></a><span class="at"> </span><span class="fu">br0</span><span class="kw">:</span></span> <span id="cb23-8"><a href="#cb23-8" aria-hidden="true"></a><span class="at"> </span><span class="fu">interfaces</span><span class="kw">:</span><span class="at"> </span><span class="kw">[</span><span class="at">switchports</span><span class="kw">]</span></span></code></pre></div></li> <li><p><strong>parameters</strong> (mapping)</p> <blockquote> <p>Customization parameters for special bridging options. Time intervals may need to be expressed as a number of seconds or milliseconds: the default value type is specified below. If necessary, time intervals can be qualified using a time suffix (such as “s” for seconds, “ms” for milliseconds) to allow for more control over its behavior.</p> </blockquote> <ul> <li><p><strong>ageing-time</strong>, <strong>aging-time</strong> (scalar)</p> <blockquote> <p>Set the period of time to keep a MAC address in the forwarding database after a packet is received. This maps to the AgeingTimeSec= property when the networkd renderer is used. If no time suffix is specified, the value will be interpreted as seconds.</p> </blockquote></li> <li><p><strong>priority</strong> (scalar)</p> <blockquote> <p>Set the priority value for the bridge. This value should be a number between <code>0</code> and <code>65535</code>. Lower values mean higher priority. The bridge with the higher priority will be elected as the root bridge.</p> </blockquote></li> <li><p><strong>port-priority</strong> (mapping)</p> <blockquote> <p>Set the port priority per interface. The priority value is a number between <code>0</code> and <code>63</code>. This metric is used in the designated port and root port selection algorithms.</p> </blockquote> <p>Example:</p> <div class="sourceCode" id="cb24"><pre class="sourceCode yaml"><code class="sourceCode yaml"><span id="cb24-1"><a href="#cb24-1" aria-hidden="true"></a><span class="fu">network</span><span class="kw">:</span></span> <span id="cb24-2"><a href="#cb24-2" aria-hidden="true"></a><span class="at"> </span><span class="fu">ethernets</span><span class="kw">:</span></span> <span id="cb24-3"><a href="#cb24-3" aria-hidden="true"></a><span class="at"> </span><span class="fu">eth0</span><span class="kw">:</span></span> <span id="cb24-4"><a href="#cb24-4" aria-hidden="true"></a><span class="at"> </span><span class="fu">dhcp4</span><span class="kw">:</span><span class="at"> </span><span class="ch">false</span></span> <span id="cb24-5"><a href="#cb24-5" aria-hidden="true"></a><span class="at"> </span><span class="fu">eth1</span><span class="kw">:</span></span> <span id="cb24-6"><a href="#cb24-6" aria-hidden="true"></a><span class="at"> </span><span class="fu">dhcp4</span><span class="kw">:</span><span class="at"> </span><span class="ch">false</span></span> <span id="cb24-7"><a href="#cb24-7" aria-hidden="true"></a><span class="at"> </span><span class="fu">bridges</span><span class="kw">:</span></span> <span id="cb24-8"><a href="#cb24-8" aria-hidden="true"></a><span class="at"> </span><span class="fu">br0</span><span class="kw">:</span></span> <span id="cb24-9"><a href="#cb24-9" aria-hidden="true"></a><span class="at"> </span><span class="fu">interfaces</span><span class="kw">:</span><span class="at"> </span><span class="kw">[</span><span class="at">eth0</span><span class="kw">,</span><span class="at"> eth1</span><span class="kw">]</span></span> <span id="cb24-10"><a href="#cb24-10" aria-hidden="true"></a><span class="at"> </span><span class="fu">parameters</span><span class="kw">:</span></span> <span id="cb24-11"><a href="#cb24-11" aria-hidden="true"></a><span class="at"> </span><span class="fu">port-priority</span><span class="kw">:</span></span> <span id="cb24-12"><a href="#cb24-12" aria-hidden="true"></a><span class="at"> </span><span class="fu">eth0</span><span class="kw">:</span><span class="at"> </span><span class="dv">10</span></span> <span id="cb24-13"><a href="#cb24-13" aria-hidden="true"></a><span class="at"> </span><span class="fu">eth1</span><span class="kw">:</span><span class="at"> </span><span class="dv">20</span></span></code></pre></div></li> <li><p><strong>forward-delay</strong> (scalar)</p> <blockquote> <p>Specify the period of time the bridge will remain in Listening and Learning states before getting to the Forwarding state. This field maps to the ForwardDelaySec= property for the networkd renderer. If no time suffix is specified, the value will be interpreted as seconds.</p> </blockquote></li> <li><p><strong>hello-time</strong> (scalar)</p> <blockquote> <p>Specify the interval between two hello packets being sent out from the root and designated bridges. Hello packets communicate information about the network topology. When the networkd renderer is used, this maps to the HelloTimeSec= property. If no time suffix is specified, the value will be interpreted as seconds.</p> </blockquote></li> <li><p><strong>max-age</strong> (scalar)</p> <blockquote> <p>Set the maximum age of a hello packet. If the last hello packet is older than that value, the bridge will attempt to become the root bridge. This maps to the MaxAgeSec= property when the networkd renderer is used. If no time suffix is specified, the value will be interpreted as seconds.</p> </blockquote></li> <li><p><strong>path-cost</strong> (mapping)</p> <blockquote> <p>Set the per-interface cost of a path on the bridge. Faster interfaces should have a lower cost. This allows a finer control on the network topology so that the fastest paths are available whenever possible.</p> </blockquote> <p>Example:</p> <div class="sourceCode" id="cb25"><pre class="sourceCode yaml"><code class="sourceCode yaml"><span id="cb25-1"><a href="#cb25-1" aria-hidden="true"></a><span class="fu">network</span><span class="kw">:</span></span> <span id="cb25-2"><a href="#cb25-2" aria-hidden="true"></a><span class="at"> </span><span class="fu">ethernets</span><span class="kw">:</span></span> <span id="cb25-3"><a href="#cb25-3" aria-hidden="true"></a><span class="at"> </span><span class="fu">eth0</span><span class="kw">:</span></span> <span id="cb25-4"><a href="#cb25-4" aria-hidden="true"></a><span class="at"> </span><span class="fu">dhcp4</span><span class="kw">:</span><span class="at"> </span><span class="ch">false</span></span> <span id="cb25-5"><a href="#cb25-5" aria-hidden="true"></a><span class="at"> </span><span class="fu">eth1</span><span class="kw">:</span></span> <span id="cb25-6"><a href="#cb25-6" aria-hidden="true"></a><span class="at"> </span><span class="fu">dhcp4</span><span class="kw">:</span><span class="at"> </span><span class="ch">false</span></span> <span id="cb25-7"><a href="#cb25-7" aria-hidden="true"></a><span class="at"> </span><span class="fu">bridges</span><span class="kw">:</span></span> <span id="cb25-8"><a href="#cb25-8" aria-hidden="true"></a><span class="at"> </span><span class="fu">br0</span><span class="kw">:</span></span> <span id="cb25-9"><a href="#cb25-9" aria-hidden="true"></a><span class="at"> </span><span class="fu">interfaces</span><span class="kw">:</span><span class="at"> </span><span class="kw">[</span><span class="at">eth0</span><span class="kw">,</span><span class="at"> eth1</span><span class="kw">]</span></span> <span id="cb25-10"><a href="#cb25-10" aria-hidden="true"></a><span class="at"> </span><span class="fu">parameters</span><span class="kw">:</span></span> <span id="cb25-11"><a href="#cb25-11" aria-hidden="true"></a><span class="at"> </span><span class="fu">path-cost</span><span class="kw">:</span></span> <span id="cb25-12"><a href="#cb25-12" aria-hidden="true"></a><span class="at"> </span><span class="fu">eth0</span><span class="kw">:</span><span class="at"> </span><span class="dv">100</span></span> <span id="cb25-13"><a href="#cb25-13" aria-hidden="true"></a><span class="at"> </span><span class="fu">eth1</span><span class="kw">:</span><span class="at"> </span><span class="dv">200</span></span></code></pre></div></li> <li><p><strong>stp</strong> (bool)</p> <blockquote> <p>Define whether the bridge should use Spanning Tree Protocol. The default value is “true”, which means that Spanning Tree should be used.</p> </blockquote></li> </ul></li> </ul> <h2 id="properties-for-device-type-bonds">Properties for device type <code>bonds:</code></h2> <p><strong>Status</strong>: Optional.</p> <p><strong>Purpose</strong>: Use the <code>bonds</code> key to create Bond (Link Aggregation) interfaces.</p> <p><strong>Structure</strong>: The key consists of a mapping of Bond interface names. Each <code>bond</code> has an optional list of interfaces that will be part of the aggregation. The interfaces listed in the <code>interfaces</code> key must also be defined in your Netplan configuration. The general configuration structure for Bonds is shown below.</p> <div class="sourceCode" id="cb26"><pre class="sourceCode yaml"><code class="sourceCode yaml"><span id="cb26-1"><a href="#cb26-1" aria-hidden="true"></a><span class="fu">network</span><span class="kw">:</span></span> <span id="cb26-2"><a href="#cb26-2" aria-hidden="true"></a><span class="at"> </span><span class="fu">bonds</span><span class="kw">:</span></span> <span id="cb26-3"><a href="#cb26-3" aria-hidden="true"></a><span class="at"> </span><span class="fu">bond0</span><span class="kw">:</span></span> <span id="cb26-4"><a href="#cb26-4" aria-hidden="true"></a><span class="at"> </span><span class="fu">interfaces</span><span class="kw">:</span></span> <span id="cb26-5"><a href="#cb26-5" aria-hidden="true"></a><span class="at"> </span><span class="kw">-</span><span class="at"> enp5s0</span></span> <span id="cb26-6"><a href="#cb26-6" aria-hidden="true"></a><span class="at"> </span><span class="kw">-</span><span class="at"> enp5s1</span></span> <span id="cb26-7"><a href="#cb26-7" aria-hidden="true"></a><span class="at"> </span><span class="kw">-</span><span class="at"> enp5s2</span></span> <span id="cb26-8"><a href="#cb26-8" aria-hidden="true"></a><span class="at"> </span><span class="fu">mode</span><span class="kw">:</span><span class="at"> active-backup</span></span> <span id="cb26-9"><a href="#cb26-9" aria-hidden="true"></a><span class="at"> ...</span></span></code></pre></div> <p>When applied, a virtual interface of type bond called <code>bond0</code> will be created in the system.</p> <p>The specific settings for bonds are defined below.</p> <ul> <li><p><strong>interfaces</strong> (sequence of scalars)</p> <blockquote> <p>All devices matching this ID list will be added to the bond.</p> </blockquote> <p>Example:</p> <div class="sourceCode" id="cb27"><pre class="sourceCode yaml"><code class="sourceCode yaml"><span id="cb27-1"><a href="#cb27-1" aria-hidden="true"></a><span class="fu">network</span><span class="kw">:</span></span> <span id="cb27-2"><a href="#cb27-2" aria-hidden="true"></a><span class="at"> </span><span class="fu">ethernets</span><span class="kw">:</span></span> <span id="cb27-3"><a href="#cb27-3" aria-hidden="true"></a><span class="at"> </span><span class="fu">switchports</span><span class="kw">:</span></span> <span id="cb27-4"><a href="#cb27-4" aria-hidden="true"></a><span class="at"> </span><span class="fu">match</span><span class="kw">:</span><span class="at"> </span><span class="kw">{</span><span class="fu">name</span><span class="kw">:</span><span class="at"> </span><span class="st">"enp2*"</span><span class="kw">}</span></span> <span id="cb27-5"><a href="#cb27-5" aria-hidden="true"></a><span class="at"> </span><span class="kw">[</span><span class="at">...</span><span class="kw">]</span></span> <span id="cb27-6"><a href="#cb27-6" aria-hidden="true"></a><span class="at"> </span><span class="fu">bonds</span><span class="kw">:</span></span> <span id="cb27-7"><a href="#cb27-7" aria-hidden="true"></a><span class="at"> </span><span class="fu">bond0</span><span class="kw">:</span></span> <span id="cb27-8"><a href="#cb27-8" aria-hidden="true"></a><span class="at"> </span><span class="fu">interfaces</span><span class="kw">:</span><span class="at"> </span><span class="kw">[</span><span class="at">switchports</span><span class="kw">]</span></span></code></pre></div></li> <li><p><strong>parameters</strong> (mapping)</p> <blockquote> <p>Customization parameters for special bonding options. Time intervals may need to be expressed as a number of seconds or milliseconds: the default value type is specified below. If necessary, time intervals can be qualified using a time suffix (such as “s” for seconds, “ms” for milliseconds) to allow for more control over its behavior.</p> </blockquote> <ul> <li><p><strong>mode</strong> (scalar)</p> <blockquote> <p>Set the bonding mode used for the interfaces. The default is <code>balance-rr</code> (round robin). Possible values are <code>balance-rr</code>, <code>active-backup</code>, <code>balance-xor</code>, <code>broadcast</code>, <code>802.3ad</code>, <code>balance-tlb</code>, and <code>balance-alb</code>. For Open vSwitch <code>active-backup</code> and the additional modes <code>balance-tcp</code> and <code>balance-slb</code> are supported.</p> </blockquote></li> <li><p><strong>lacp-rate</strong> (scalar)</p> <blockquote> <p>Set the rate at which LACPDUs are transmitted. This is only useful in 802.3ad mode. Possible values are <code>slow</code> (30 seconds, default), and <code>fast</code> (every second).</p> </blockquote></li> <li><p><strong>mii-monitor-interval</strong> (scalar)</p> <blockquote> <p>Specifies the interval for MII monitoring (verifying if an interface of the bond has carrier). The default is <code>0</code>; which disables MII monitoring. This is equivalent to the MIIMonitorSec= field for the networkd backend. If no time suffix is specified, the value will be interpreted as milliseconds.</p> </blockquote></li> <li><p><strong>min-links</strong> (scalar)</p> <blockquote> <p>The minimum number of links up in a bond to consider the bond interface to be up.</p> </blockquote></li> <li><p><strong>transmit-hash-policy</strong> (scalar)</p> <blockquote> <p>Specifies the transmit hash policy for the selection of ports. This is only useful in balance-xor, 802.3ad and balance-tlb modes. Possible values are <code>layer2</code>, <code>layer3+4</code>, <code>layer2+3</code>, <code>encap2+3</code>, and <code>encap3+4</code>.</p> </blockquote></li> <li><p><strong>ad-select</strong> (scalar)</p> <blockquote> <p>Set the aggregation selection mode. Possible values are <code>stable</code>, <code>bandwidth</code>, and <code>count</code>. This option is only used in 802.3ad mode.</p> </blockquote></li> <li><p><strong>all-members-active</strong> (bool) – since <strong>0.106</strong></p> <blockquote> <p>If the bond should drop duplicate frames received on inactive ports, set this option to <code>false</code>. If they should be delivered, set this option to <code>true</code>. The default value is false, and is the desirable behavior in most situations.</p> <p>Alias: <strong>all-slaves-active</strong> <!--- wokeignore:rule=slave --></p> </blockquote></li> <li><p><strong>arp-interval</strong> (scalar)</p> <blockquote> <p>Set the interval value for how frequently ARP link monitoring should happen. The default value is <code>0</code>, which disables ARP monitoring. For the networkd backend, this maps to the ARPIntervalSec= property. If no time suffix is specified, the value will be interpreted as milliseconds.</p> </blockquote></li> <li><p><strong>arp-ip-targets</strong> (sequence of scalars)</p> <blockquote> <p>IPs of other hosts on the link which should be sent ARP requests in order to validate that a port is up. This option is only used when <code>arp-interval</code> is set to a value other than <code>0</code>. At least one IP address must be given for ARP link monitoring to function. Only IPv4 addresses are supported. You can specify up to 16 IP addresses. The default value is an empty list.</p> </blockquote></li> <li><p><strong>arp-validate</strong> (scalar)</p> <blockquote> <p>Configure how ARP replies are to be validated when using ARP link monitoring. Possible values are <code>none</code>, <code>active</code>, <code>backup</code>, and <code>all</code>.</p> </blockquote></li> <li><p><strong>arp-all-targets</strong> (scalar)</p> <blockquote> <p>Specify whether to use any ARP IP target being up as sufficient for a port to be considered up; or if all the targets must be up. This is only used for <code>active-backup</code> mode when <code>arp-validate</code> is enabled. Possible values are <code>any</code> and <code>all</code>.</p> </blockquote></li> <li><p><strong>up-delay</strong> (scalar)</p> <blockquote> <p>Specify the delay before enabling a link once the link is physically up. The default value is <code>0</code>. This maps to the UpDelaySec= property for the networkd renderer. This option is only valid for the miimon link monitor. If no time suffix is specified, the value will be interpreted as milliseconds.</p> </blockquote></li> <li><p><strong>down-delay</strong> (scalar)</p> <blockquote> <p>Specify the delay before disabling a link once the link has been lost. The default value is <code>0</code>. This maps to the DownDelaySec= property for the networkd renderer. This option is only valid for the miimon link monitor. If no time suffix is specified, the value will be interpreted as milliseconds.</p> </blockquote></li> <li><p><strong>fail-over-mac-policy</strong> (scalar)</p> <blockquote> <p>Set whether to set all ports to the same MAC address when adding them to the bond, or how else the system should handle MAC addresses. The possible values are <code>none</code>, <code>active</code>, and <code>follow</code>.</p> </blockquote></li> <li><p><strong>gratuitous-arp</strong> (scalar)</p> <blockquote> <p>Specify how many ARP packets to send after failover. Once a link is up on a new port, a notification is sent and possibly repeated if this value is set to a number greater than <code>1</code>. The default value is <code>1</code> and valid values are between <code>1</code> and <code>255</code>. This only affects <code>active-backup</code> mode.</p> <p>For historical reasons, the misspelling <code>gratuitious-arp</code> is also accepted and has the same function.</p> </blockquote></li> <li><p><strong>packets-per-member</strong> (scalar) – since <strong>0.106</strong></p> <blockquote> <p>In <code>balance-rr</code> mode, specifies the number of packets to transmit on a port before switching to the next. When this value is set to <code>0</code>, ports are chosen at random. Allowable values are between <code>0</code> and <code>65535</code>. The default value is <code>1</code>. This setting is only used in <code>balance-rr</code> mode.</p> <p>Alias: <strong>packets-per-slave</strong> <!--- wokeignore:rule=slave --></p> </blockquote></li> <li><p><strong>primary-reselect-policy</strong> (scalar)</p> <blockquote> <p>Set the reselection policy for the primary port. On failure of the active port, the system will use this policy to decide how the new active port will be chosen and how recovery will be handled. The possible values are <code>always</code>, <code>better</code>, and <code>failure</code>.</p> </blockquote></li> <li><p><strong>resend-igmp</strong> (scalar)</p> <blockquote> <p>In modes <code>balance-rr</code>, <code>active-backup</code>, <code>balance-tlb</code> and <code>balance-alb</code>, a failover can switch IGMP traffic from one port to another.</p> <p>This parameter specifies how many IGMP membership reports are issued on a failover event. Values range from 0 to 255. 0 disables sending membership reports. Otherwise, the first membership report is sent on failover and subsequent reports are sent at 200ms intervals.</p> </blockquote></li> <li><p><strong>learn-packet-interval</strong> (scalar)</p> <blockquote> <p>Specify the interval between sending learning packets to each port. The value range is between <code>1</code> and <code>0x7fffffff</code>. The default value is <code>1</code>. This option only affects <code>balance-tlb</code> and <code>balance-alb</code> modes. Using the networkd renderer, this field maps to the LearnPacketIntervalSec= property. If no time suffix is specified, the value will be interpreted as seconds.</p> </blockquote></li> <li><p><strong>primary</strong> (scalar)</p> <blockquote> <p>Specify a device to be used as a primary port, or preferred device to use as a port for the bond (i.e. the preferred device to send data through), whenever it is available. This only affects <code>active-backup</code>, <code>balance-alb</code>, and <code>balance-tlb</code> modes.</p> </blockquote></li> </ul></li> </ul> <h2 id="properties-for-device-type-tunnels">Properties for device type <code>tunnels:</code></h2> <p><strong>Status</strong>: Optional.</p> <p><strong>Purpose</strong>: Use the <code>tunnels</code> key to create virtual tunnel interfaces.</p> <p><strong>Structure</strong>: The key consists of a mapping of tunnel interface names. Each <code>tunnel</code> requires the identification of the tunnel mode (see the section <code>mode</code> below for the list of supported modes). The general configuration structure for Tunnels is shown below.</p> <div class="sourceCode" id="cb28"><pre class="sourceCode yaml"><code class="sourceCode yaml"><span id="cb28-1"><a href="#cb28-1" aria-hidden="true"></a><span class="fu">network</span><span class="kw">:</span></span> <span id="cb28-2"><a href="#cb28-2" aria-hidden="true"></a><span class="at"> </span><span class="fu">tunnels</span><span class="kw">:</span></span> <span id="cb28-3"><a href="#cb28-3" aria-hidden="true"></a><span class="at"> </span><span class="fu">tunnel0</span><span class="kw">:</span></span> <span id="cb28-4"><a href="#cb28-4" aria-hidden="true"></a><span class="at"> </span><span class="fu">mode</span><span class="kw">:</span><span class="at"> SCALAR</span></span> <span id="cb28-5"><a href="#cb28-5" aria-hidden="true"></a><span class="at"> ...</span></span></code></pre></div> <p>When applied, a virtual interface called <code>tunnel0</code> will be created in the system. Its operation mode is defined by the property <code>mode</code>.</p> <p>Tunnels allow traffic to pass as if it was between systems on the same local network, although systems may be far from each other but reachable via the Internet. They may be used to support IPv6 traffic on a network where the ISP does not provide the service, or to extend and “connect” separate local networks. Please see <a href="https://en.wikipedia.org/wiki/Tunneling_protocol" class="uri">https://en.wikipedia.org/wiki/Tunneling_protocol</a> for more general information about tunnels.</p> <p>The specific settings for tunnels are defined below.</p> <ul> <li><p><strong>mode</strong> (scalar)</p> <blockquote> <p>Defines the tunnel mode. Valid options are <code>sit</code>, <code>gre</code>, <code>ip6gre</code>, <code>ipip</code>, <code>ipip6</code>, <code>ip6ip6</code>, <code>vti</code>, <code>vti6</code>, <code>wireguard</code>, <code>vxlan</code>, <code>gretap</code> and <code>ip6gretap</code> modes. In addition, the <code>NetworkManager</code> backend supports <code>isatap</code> tunnels.</p> </blockquote></li> <li><p><strong>local</strong> (scalar)</p> <blockquote> <p>Defines the address of the local endpoint of the tunnel. (For VXLAN) This should match one of the parent’s IP addresses or make use of the networkd special values.</p> </blockquote></li> <li><p><strong>remote</strong> (scalar)</p> <blockquote> <p>Defines the address of the remote endpoint of the tunnel or multicast group IP address for VXLAN.</p> </blockquote></li> <li><p><strong>ttl</strong> (scalar) – since <strong>0.103</strong></p> <blockquote> <p>Defines the Time To Live (TTL) of the tunnel. Takes a number in the range <code>1..255</code>.</p> </blockquote></li> <li><p><strong>key</strong> (scalar or mapping)</p> <blockquote> <p>Define keys to use for the tunnel. The key can be a number or a dotted quad (an IPv4 address). For <code>wireguard</code> it can be a base64-encoded private key or (as of <code>networkd</code> v242+) an absolute path to a file, containing the private key (since 0.100). It is used for identification of IP transforms. This is only required for <code>vti</code> and <code>vti6</code> when using the networkd backend.</p> <p>This field may be used as a scalar (meaning that a single key is specified and to be used for input, output and private key), or as a mapping, where you can further specify <code>input</code>/<code>output</code>/<code>private</code>.</p> </blockquote> <ul> <li><p><strong>input</strong> (scalar)</p> <blockquote> <p>The input key for the tunnel</p> </blockquote></li> <li><p><strong>output</strong> (scalar)</p> <blockquote> <p>The output key for the tunnel</p> </blockquote></li> <li><p><strong>private</strong> (scalar) – since <strong>0.100</strong></p> <blockquote> <p>A base64-encoded private key required for WireGuard tunnels. When the <code>systemd-networkd</code> backend (v242+) is used, this can also be an absolute path to a file containing the private key.</p> </blockquote></li> </ul></li> <li><p><strong>keys</strong> (scalar or mapping)</p> <blockquote> <p>Alternate name for the <code>key</code> field. See above.</p> </blockquote> <p>Examples:</p> <div class="sourceCode" id="cb29"><pre class="sourceCode yaml"><code class="sourceCode yaml"><span id="cb29-1"><a href="#cb29-1" aria-hidden="true"></a><span class="fu">network</span><span class="kw">:</span></span> <span id="cb29-2"><a href="#cb29-2" aria-hidden="true"></a><span class="at"> </span><span class="fu">tunnels</span><span class="kw">:</span></span> <span id="cb29-3"><a href="#cb29-3" aria-hidden="true"></a><span class="at"> </span><span class="fu">tun0</span><span class="kw">:</span></span> <span id="cb29-4"><a href="#cb29-4" aria-hidden="true"></a><span class="at"> </span><span class="fu">mode</span><span class="kw">:</span><span class="at"> gre</span></span> <span id="cb29-5"><a href="#cb29-5" aria-hidden="true"></a><span class="at"> </span><span class="fu">local</span><span class="kw">:</span><span class="at"> ...</span></span> <span id="cb29-6"><a href="#cb29-6" aria-hidden="true"></a><span class="at"> </span><span class="fu">remote</span><span class="kw">:</span><span class="at"> ...</span></span> <span id="cb29-7"><a href="#cb29-7" aria-hidden="true"></a><span class="at"> </span><span class="fu">keys</span><span class="kw">:</span></span> <span id="cb29-8"><a href="#cb29-8" aria-hidden="true"></a><span class="at"> </span><span class="fu">input</span><span class="kw">:</span><span class="at"> </span><span class="dv">1234</span></span> <span id="cb29-9"><a href="#cb29-9" aria-hidden="true"></a><span class="at"> </span><span class="fu">output</span><span class="kw">:</span><span class="at"> </span><span class="dv">5678</span></span></code></pre></div> <div class="sourceCode" id="cb30"><pre class="sourceCode yaml"><code class="sourceCode yaml"><span id="cb30-1"><a href="#cb30-1" aria-hidden="true"></a><span class="fu">network</span><span class="kw">:</span></span> <span id="cb30-2"><a href="#cb30-2" aria-hidden="true"></a><span class="at"> </span><span class="fu">tunnels</span><span class="kw">:</span></span> <span id="cb30-3"><a href="#cb30-3" aria-hidden="true"></a><span class="at"> </span><span class="fu">tun0</span><span class="kw">:</span></span> <span id="cb30-4"><a href="#cb30-4" aria-hidden="true"></a><span class="at"> </span><span class="fu">mode</span><span class="kw">:</span><span class="at"> vti6</span></span> <span id="cb30-5"><a href="#cb30-5" aria-hidden="true"></a><span class="at"> </span><span class="fu">local</span><span class="kw">:</span><span class="at"> ...</span></span> <span id="cb30-6"><a href="#cb30-6" aria-hidden="true"></a><span class="at"> </span><span class="fu">remote</span><span class="kw">:</span><span class="at"> ...</span></span> <span id="cb30-7"><a href="#cb30-7" aria-hidden="true"></a><span class="at"> </span><span class="fu">key</span><span class="kw">:</span><span class="at"> </span><span class="dv">59568549</span></span></code></pre></div> <div class="sourceCode" id="cb31"><pre class="sourceCode yaml"><code class="sourceCode yaml"><span id="cb31-1"><a href="#cb31-1" aria-hidden="true"></a><span class="fu">network</span><span class="kw">:</span></span> <span id="cb31-2"><a href="#cb31-2" aria-hidden="true"></a><span class="at"> </span><span class="fu">tunnels</span><span class="kw">:</span></span> <span id="cb31-3"><a href="#cb31-3" aria-hidden="true"></a><span class="at"> </span><span class="fu">wg0</span><span class="kw">:</span></span> <span id="cb31-4"><a href="#cb31-4" aria-hidden="true"></a><span class="at"> </span><span class="fu">mode</span><span class="kw">:</span><span class="at"> wireguard</span></span> <span id="cb31-5"><a href="#cb31-5" aria-hidden="true"></a><span class="at"> </span><span class="fu">addresses</span><span class="kw">:</span><span class="at"> </span><span class="kw">[</span><span class="at">...</span><span class="kw">]</span></span> <span id="cb31-6"><a href="#cb31-6" aria-hidden="true"></a><span class="at"> </span><span class="fu">peers</span><span class="kw">:</span></span> <span id="cb31-7"><a href="#cb31-7" aria-hidden="true"></a><span class="at"> </span><span class="kw">-</span><span class="at"> </span><span class="fu">keys</span><span class="kw">:</span></span> <span id="cb31-8"><a href="#cb31-8" aria-hidden="true"></a><span class="at"> </span><span class="fu">public</span><span class="kw">:</span><span class="at"> rlbInAj0qV69CysWPQY7KEBnKxpYCpaWqOs/dLevdWc=</span></span> <span id="cb31-9"><a href="#cb31-9" aria-hidden="true"></a><span class="at"> </span><span class="fu">shared</span><span class="kw">:</span><span class="at"> /path/to/shared.key</span></span> <span id="cb31-10"><a href="#cb31-10" aria-hidden="true"></a><span class="at"> ...</span></span> <span id="cb31-11"><a href="#cb31-11" aria-hidden="true"></a><span class="at"> </span><span class="fu">key</span><span class="kw">:</span><span class="at"> mNb7OIIXTdgW4khM7OFlzJ+UPs7lmcWHV7xjPgakMkQ=</span></span></code></pre></div> <div class="sourceCode" id="cb32"><pre class="sourceCode yaml"><code class="sourceCode yaml"><span id="cb32-1"><a href="#cb32-1" aria-hidden="true"></a><span class="fu">network</span><span class="kw">:</span></span> <span id="cb32-2"><a href="#cb32-2" aria-hidden="true"></a><span class="at"> </span><span class="fu">tunnels</span><span class="kw">:</span></span> <span id="cb32-3"><a href="#cb32-3" aria-hidden="true"></a><span class="at"> </span><span class="fu">wg0</span><span class="kw">:</span></span> <span id="cb32-4"><a href="#cb32-4" aria-hidden="true"></a><span class="at"> </span><span class="fu">mode</span><span class="kw">:</span><span class="at"> wireguard</span></span> <span id="cb32-5"><a href="#cb32-5" aria-hidden="true"></a><span class="at"> </span><span class="fu">addresses</span><span class="kw">:</span><span class="at"> </span><span class="kw">[</span><span class="at">...</span><span class="kw">]</span></span> <span id="cb32-6"><a href="#cb32-6" aria-hidden="true"></a><span class="at"> </span><span class="fu">peers</span><span class="kw">:</span></span> <span id="cb32-7"><a href="#cb32-7" aria-hidden="true"></a><span class="at"> </span><span class="kw">-</span><span class="at"> </span><span class="fu">keys</span><span class="kw">:</span></span> <span id="cb32-8"><a href="#cb32-8" aria-hidden="true"></a><span class="at"> </span><span class="fu">public</span><span class="kw">:</span><span class="at"> rlbInAj0qV69CysWPQY7KEBnKxpYCpaWqOs/dLevdWc=</span></span> <span id="cb32-9"><a href="#cb32-9" aria-hidden="true"></a><span class="at"> ...</span></span> <span id="cb32-10"><a href="#cb32-10" aria-hidden="true"></a><span class="at"> </span><span class="fu">keys</span><span class="kw">:</span></span> <span id="cb32-11"><a href="#cb32-11" aria-hidden="true"></a><span class="at"> </span><span class="fu">private</span><span class="kw">:</span><span class="at"> /path/to/priv.key</span></span></code></pre></div></li> </ul> <p>WireGuard specific keys:</p> <ul> <li><p><strong>mark</strong> (scalar) – since <strong>0.100</strong></p> <blockquote> <p>Firewall mark for outgoing WireGuard packets from this interface, optional.</p> </blockquote></li> <li><p><strong>port</strong> (scalar) – since <strong>0.100</strong></p> <blockquote> <p>UDP port to listen at or <code>auto</code>. Optional, defaults to <code>auto</code>.</p> </blockquote></li> <li><p><strong>peers</strong> (sequence of mappings) – since <strong>0.100</strong></p> <blockquote> <p>A list of peers, each having keys documented below.</p> </blockquote> <p>Example:</p> <div class="sourceCode" id="cb33"><pre class="sourceCode yaml"><code class="sourceCode yaml"><span id="cb33-1"><a href="#cb33-1" aria-hidden="true"></a><span class="fu">network</span><span class="kw">:</span></span> <span id="cb33-2"><a href="#cb33-2" aria-hidden="true"></a><span class="at"> </span><span class="fu">tunnels</span><span class="kw">:</span></span> <span id="cb33-3"><a href="#cb33-3" aria-hidden="true"></a><span class="at"> </span><span class="fu">wg0</span><span class="kw">:</span></span> <span id="cb33-4"><a href="#cb33-4" aria-hidden="true"></a><span class="at"> </span><span class="fu">mode</span><span class="kw">:</span><span class="at"> wireguard</span></span> <span id="cb33-5"><a href="#cb33-5" aria-hidden="true"></a><span class="at"> </span><span class="fu">key</span><span class="kw">:</span><span class="at"> /path/to/private.key</span></span> <span id="cb33-6"><a href="#cb33-6" aria-hidden="true"></a><span class="at"> </span><span class="fu">mark</span><span class="kw">:</span><span class="at"> </span><span class="dv">42</span></span> <span id="cb33-7"><a href="#cb33-7" aria-hidden="true"></a><span class="at"> </span><span class="fu">port</span><span class="kw">:</span><span class="at"> </span><span class="dv">5182</span></span> <span id="cb33-8"><a href="#cb33-8" aria-hidden="true"></a><span class="at"> </span><span class="fu">peers</span><span class="kw">:</span></span> <span id="cb33-9"><a href="#cb33-9" aria-hidden="true"></a><span class="at"> </span><span class="kw">-</span><span class="at"> </span><span class="fu">keys</span><span class="kw">:</span></span> <span id="cb33-10"><a href="#cb33-10" aria-hidden="true"></a><span class="at"> </span><span class="fu">public</span><span class="kw">:</span><span class="at"> rlbInAj0qV69CysWPQY7KEBnKxpYCpaWqOs/dLevdWc=</span></span> <span id="cb33-11"><a href="#cb33-11" aria-hidden="true"></a><span class="at"> </span><span class="fu">allowed-ips</span><span class="kw">:</span><span class="at"> </span><span class="kw">[</span><span class="at">0.0.0.0/</span><span class="dv">0</span><span class="kw">,</span><span class="at"> </span><span class="st">"2001:fe:ad:de:ad:be:ef:1/24"</span><span class="kw">]</span></span> <span id="cb33-12"><a href="#cb33-12" aria-hidden="true"></a><span class="at"> </span><span class="fu">keepalive</span><span class="kw">:</span><span class="at"> </span><span class="dv">23</span></span> <span id="cb33-13"><a href="#cb33-13" aria-hidden="true"></a><span class="at"> </span><span class="fu">endpoint</span><span class="kw">:</span><span class="at"> 1.2.3.4:5</span></span> <span id="cb33-14"><a href="#cb33-14" aria-hidden="true"></a><span class="at"> </span><span class="kw">-</span><span class="at"> </span><span class="fu">keys</span><span class="kw">:</span></span> <span id="cb33-15"><a href="#cb33-15" aria-hidden="true"></a><span class="at"> </span><span class="fu">public</span><span class="kw">:</span><span class="at"> M9nt4YujIOmNrRmpIRTmYSfMdrpvE7u6WkG8FY8WjG4=</span></span> <span id="cb33-16"><a href="#cb33-16" aria-hidden="true"></a><span class="at"> </span><span class="fu">shared</span><span class="kw">:</span><span class="at"> /some/shared.key</span></span> <span id="cb33-17"><a href="#cb33-17" aria-hidden="true"></a><span class="at"> </span><span class="fu">allowed-ips</span><span class="kw">:</span><span class="at"> </span><span class="kw">[</span><span class="at">10.10.10.20/</span><span class="dv">24</span><span class="kw">]</span></span> <span id="cb33-18"><a href="#cb33-18" aria-hidden="true"></a><span class="at"> </span><span class="fu">keepalive</span><span class="kw">:</span><span class="at"> </span><span class="dv">22</span></span> <span id="cb33-19"><a href="#cb33-19" aria-hidden="true"></a><span class="at"> </span><span class="fu">endpoint</span><span class="kw">:</span><span class="at"> 5.4.3.2:1</span></span></code></pre></div> <ul> <li><p><strong>endpoint</strong> (scalar) – since <strong>0.100</strong></p> <blockquote> <p>Remote endpoint IPv4/IPv6 address or a hostname, followed by a colon and a port number.</p> </blockquote></li> <li><p><strong>allowed-ips</strong> (sequence of scalars) – since <strong>0.100</strong></p> <blockquote> <p>A list of IP (v4 or v6) addresses with CIDR masks from which this peer is allowed to send incoming traffic and to which outgoing traffic for this peer is directed. The catch-all 0.0.0.0/0 may be specified for matching all IPv4 addresses, and ::/0 may be specified for matching all IPv6 addresses.</p> </blockquote></li> <li><p><strong>keepalive</strong> (scalar) – since <strong>0.100</strong></p> <blockquote> <p>An interval in seconds, between 1 and 65535 inclusive, of how often to send an authenticated empty packet to the peer for the purpose of keeping a stateful firewall or NAT mapping valid persistently. Optional.</p> </blockquote></li> <li><p><strong>keys</strong> (mapping) – since <strong>0.100</strong></p> <blockquote> <p>Define keys to use for the WireGuard peers.</p> <p>This field can be used as a mapping, where you can further specify the <code>public</code> and <code>shared</code> keys.</p> </blockquote> <ul> <li><p><strong>public</strong> (scalar) – since <strong>0.100</strong></p> <blockquote> <p>A base64-encoded public key, required for WireGuard peers.</p> </blockquote></li> <li><p><strong>shared</strong> (scalar) – since <strong>0.100</strong></p> <blockquote> <p>A base64-encoded preshared key. Optional for WireGuard peers. When the <code>systemd-networkd</code> backend (v242+) is used, this can also be an absolute path to a file containing the preshared key.</p> </blockquote></li> </ul></li> </ul></li> </ul> <p>VXLAN specific keys:</p> <ul> <li><p><strong>id</strong> (scalar) – since <strong>0.105</strong></p> <blockquote> <p>The VXLAN Network Identifier (VNI or VXLAN Segment ID). Takes a number in the range <code>1..16777215</code>.</p> </blockquote></li> <li><p><strong>link</strong> (scalar) – since <strong>0.105</strong></p> <blockquote> <p>netplan ID of the parent device definition to which this VXLAN gets connected.</p> </blockquote></li> <li><p><strong>type-of-service</strong> (scalar) – since <strong>0.105</strong></p> <blockquote> <p>The Type Of Service byte value for a vxlan interface.</p> </blockquote></li> <li><p><strong>mac-learning</strong> (scalar) – since <strong>0.105</strong></p> <blockquote> <p>Takes a boolean. When <code>true</code>, enables dynamic MAC learning to discover remote MAC addresses.</p> </blockquote></li> <li><p><strong>ageing</strong>, <strong>aging</strong> (scalar) – since <strong>0.105</strong></p> <blockquote> <p>The lifetime of Forwarding Database entry learned by the kernel, in seconds.</p> </blockquote></li> <li><p><strong>limit</strong> (scalar) – since <strong>0.105</strong></p> <blockquote> <p>Configures maximum number of FDB entries.</p> </blockquote></li> <li><p><strong>arp-proxy</strong> (scalar) – since <strong>0.105</strong></p> <blockquote> <p>Takes a boolean. When <code>true</code>, bridge-connected VXLAN tunnel endpoint answers ARP requests from the local bridge on behalf of remote Distributed Overlay Virtual Ethernet (DOVE) clients. Defaults to <code>false</code>.</p> </blockquote></li> <li><p><strong>notifications</strong> (sequence of scalars) – since <strong>0.105</strong></p> <blockquote> <p>Takes the flags <code>l2-miss</code> and <code>l3-miss</code> to enable netlink LLADDR and/or netlink IP address miss notifications.</p> </blockquote></li> <li><p><strong>short-circuit</strong> (scalar) – since <strong>0.105</strong></p> <blockquote> <p>Takes a boolean. When <code>true</code>, route short circuiting is turned on.</p> </blockquote></li> <li><p><strong>checksums</strong> (sequence of scalars) – since <strong>0.105</strong></p> <blockquote> <p>Takes the flags <code>udp</code>, <code>zero-udp6-tx</code>, <code>zero-udp6-rx</code>, <code>remote-tx</code> and <code>remote-rx</code> to enable transmitting UDP checksums in VXLAN/IPv4, send/receive zero checksums in VXLAN/IPv6 and enable sending/receiving checksum offloading in VXLAN.</p> </blockquote></li> <li><p><strong>extensions</strong> (sequence of scalars) – since <strong>0.105</strong></p> <blockquote> <p>Takes the flags <code>group-policy</code> and <code>generic-protocol</code> to enable the “Group Policy” and/or “Generic Protocol” VXLAN extensions.</p> </blockquote></li> <li><p><strong>port</strong> (scalar) – since <strong>0.105</strong></p> <blockquote> <p>Configures the default destination UDP port. If the destination port is not specified then Linux kernel default will be used. Set to <code>4789</code> to get the IANA assigned value.</p> </blockquote></li> <li><p><strong>port-range</strong> (sequence of scalars) – since <strong>0.105</strong></p> <blockquote> <p>Configures the source port range for the VXLAN. The kernel assigns the source UDP port based on the flow to help the receiver to do load balancing. When this option is not set, the normal range of local UDP ports is used. Uses the form <code>[LOWER, UPPER]</code>.</p> </blockquote></li> <li><p><strong>flow-label</strong> (scalar) – since <strong>0.105</strong></p> <blockquote> <p>Specifies the flow label to use in outgoing packets. The valid range is <code>0-1048575</code>.</p> </blockquote></li> <li><p><strong>do-not-fragment</strong> (scalar) – since <strong>0.105</strong></p> <blockquote> <p>Allows setting the IPv4 Do not Fragment (DF) bit in outgoing packets. Takes a boolean value. When unset, the kernel’s default will be used.</p> </blockquote></li> </ul> <h2 id="properties-for-device-type-vlans">Properties for device type <code>vlans:</code></h2> <p><strong>Status</strong>: Optional.</p> <p><strong>Purpose</strong>: Use the <code>vlans</code> key to create VLAN interfaces.</p> <p><strong>Structure</strong>: The key consists of a mapping of VLAN interface names. The interface used in the <code>link</code> option (<code>enp5s0</code> in the example below) must also be defined in the Netplan configuration. The general configuration structure for Vlans is shown below.</p> <div class="sourceCode" id="cb34"><pre class="sourceCode yaml"><code class="sourceCode yaml"><span id="cb34-1"><a href="#cb34-1" aria-hidden="true"></a><span class="fu">network</span><span class="kw">:</span></span> <span id="cb34-2"><a href="#cb34-2" aria-hidden="true"></a><span class="at"> </span><span class="fu">vlans</span><span class="kw">:</span></span> <span id="cb34-3"><a href="#cb34-3" aria-hidden="true"></a><span class="at"> </span><span class="fu">vlan123</span><span class="kw">:</span></span> <span id="cb34-4"><a href="#cb34-4" aria-hidden="true"></a><span class="at"> </span><span class="fu">id</span><span class="kw">:</span><span class="at"> </span><span class="dv">123</span></span> <span id="cb34-5"><a href="#cb34-5" aria-hidden="true"></a><span class="at"> </span><span class="fu">link</span><span class="kw">:</span><span class="at"> enp5s0</span></span> <span id="cb34-6"><a href="#cb34-6" aria-hidden="true"></a><span class="at"> </span><span class="fu">dhcp4</span><span class="kw">:</span><span class="at"> </span><span class="ch">yes</span></span></code></pre></div> <p>The specific settings for VLANs are defined below.</p> <ul> <li><p><strong>id</strong> (scalar)</p> <blockquote> <p>VLAN ID, a number between <code>0</code> and <code>4094</code>.</p> </blockquote></li> <li><p><strong>link</strong> (scalar)</p> <blockquote> <p>netplan ID of the underlying device definition on which this VLAN gets created.</p> </blockquote></li> </ul> <p>Example:</p> <div class="sourceCode" id="cb35"><pre class="sourceCode yaml"><code class="sourceCode yaml"><span id="cb35-1"><a href="#cb35-1" aria-hidden="true"></a><span class="fu">network</span><span class="kw">:</span></span> <span id="cb35-2"><a href="#cb35-2" aria-hidden="true"></a><span class="at"> </span><span class="fu">ethernets</span><span class="kw">:</span></span> <span id="cb35-3"><a href="#cb35-3" aria-hidden="true"></a><span class="at"> </span><span class="fu">eno1</span><span class="kw">:</span><span class="at"> </span><span class="kw">{</span><span class="at">...</span><span class="kw">}</span></span> <span id="cb35-4"><a href="#cb35-4" aria-hidden="true"></a><span class="at"> </span><span class="fu">vlans</span><span class="kw">:</span></span> <span id="cb35-5"><a href="#cb35-5" aria-hidden="true"></a><span class="at"> </span><span class="fu">en-intra</span><span class="kw">:</span></span> <span id="cb35-6"><a href="#cb35-6" aria-hidden="true"></a><span class="at"> </span><span class="fu">id</span><span class="kw">:</span><span class="at"> </span><span class="dv">1</span></span> <span id="cb35-7"><a href="#cb35-7" aria-hidden="true"></a><span class="at"> </span><span class="fu">link</span><span class="kw">:</span><span class="at"> eno1</span></span> <span id="cb35-8"><a href="#cb35-8" aria-hidden="true"></a><span class="at"> </span><span class="fu">dhcp4</span><span class="kw">:</span><span class="at"> </span><span class="ch">yes</span></span> <span id="cb35-9"><a href="#cb35-9" aria-hidden="true"></a><span class="at"> </span><span class="fu">en-vpn</span><span class="kw">:</span></span> <span id="cb35-10"><a href="#cb35-10" aria-hidden="true"></a><span class="at"> </span><span class="fu">id</span><span class="kw">:</span><span class="at"> </span><span class="dv">2</span></span> <span id="cb35-11"><a href="#cb35-11" aria-hidden="true"></a><span class="at"> </span><span class="fu">link</span><span class="kw">:</span><span class="at"> eno1</span></span> <span id="cb35-12"><a href="#cb35-12" aria-hidden="true"></a><span class="at"> </span><span class="fu">addresses</span><span class="kw">:</span><span class="at"> </span><span class="kw">[</span><span class="at">...</span><span class="kw">]</span></span></code></pre></div> <h2 id="properties-for-device-type-vrfs">Properties for device type <code>vrfs:</code></h2> <p><strong>Status</strong>: Optional.</p> <p><strong>Purpose</strong>: Use the <code>vrfs</code> key to create Virtual Routing and Forwarding (VRF) interfaces.</p> <p><strong>Structure</strong>: The key consists of a mapping of VRF interface names. The interface used in the <code>link</code> option (<code>enp5s0</code> in the example below) must also be defined in the Netplan configuration. The general configuration structure for VRFs is shown below.</p> <div class="sourceCode" id="cb36"><pre class="sourceCode yaml"><code class="sourceCode yaml"><span id="cb36-1"><a href="#cb36-1" aria-hidden="true"></a><span class="fu">network</span><span class="kw">:</span></span> <span id="cb36-2"><a href="#cb36-2" aria-hidden="true"></a><span class="at"> </span><span class="fu">renderer</span><span class="kw">:</span><span class="at"> networkd</span></span> <span id="cb36-3"><a href="#cb36-3" aria-hidden="true"></a><span class="at"> </span><span class="fu">vrfs</span><span class="kw">:</span></span> <span id="cb36-4"><a href="#cb36-4" aria-hidden="true"></a><span class="at"> </span><span class="fu">vrf1</span><span class="kw">:</span></span> <span id="cb36-5"><a href="#cb36-5" aria-hidden="true"></a><span class="at"> </span><span class="fu">table</span><span class="kw">:</span><span class="at"> </span><span class="dv">1</span></span> <span id="cb36-6"><a href="#cb36-6" aria-hidden="true"></a><span class="at"> </span><span class="fu">interfaces</span><span class="kw">:</span></span> <span id="cb36-7"><a href="#cb36-7" aria-hidden="true"></a><span class="at"> </span><span class="kw">-</span><span class="at"> enp5s0</span></span> <span id="cb36-8"><a href="#cb36-8" aria-hidden="true"></a><span class="at"> </span><span class="fu">routes</span><span class="kw">:</span></span> <span id="cb36-9"><a href="#cb36-9" aria-hidden="true"></a><span class="at"> </span><span class="kw">-</span><span class="at"> </span><span class="fu">to</span><span class="kw">:</span><span class="at"> default</span></span> <span id="cb36-10"><a href="#cb36-10" aria-hidden="true"></a><span class="at"> </span><span class="fu">via</span><span class="kw">:</span><span class="at"> </span><span class="fl">10.10.10.4</span></span> <span id="cb36-11"><a href="#cb36-11" aria-hidden="true"></a><span class="at"> </span><span class="fu">routing-policy</span><span class="kw">:</span></span> <span id="cb36-12"><a href="#cb36-12" aria-hidden="true"></a><span class="at"> </span><span class="kw">-</span><span class="at"> </span><span class="fu">from</span><span class="kw">:</span><span class="at"> </span><span class="fl">10.10.10.42</span></span></code></pre></div> <ul> <li><p><strong>table</strong> (scalar) – since <strong>0.105</strong></p> <blockquote> <p>The numeric routing table identifier. This setting is compulsory.</p> </blockquote></li> <li><p><strong>interfaces</strong> (sequence of scalars) – since <strong>0.105</strong></p> <blockquote> <p>All devices matching this ID list will be added to the VRF. This may be an empty list, in which case the VRF will be brought online with no member interfaces.</p> </blockquote></li> <li><p><strong>routes</strong> (sequence of mappings) – since <strong>0.105</strong></p> <blockquote> <p>Configure static routing for the device; see the <code>Routing</code> section. The <code>table</code> value is implicitly set to the VRF’s <code>table</code>.</p> </blockquote></li> <li><p><strong>routing-policy</strong> (sequence of mappings) – since <strong>0.105</strong></p> <blockquote> <p>Configure policy routing for the device; see the <code>Routing</code> section. The <code>table</code> value is implicitly set to the VRF’s <code>table</code>.</p> </blockquote></li> </ul> <p>Example:</p> <div class="sourceCode" id="cb37"><pre class="sourceCode yaml"><code class="sourceCode yaml"><span id="cb37-1"><a href="#cb37-1" aria-hidden="true"></a><span class="fu">network</span><span class="kw">:</span></span> <span id="cb37-2"><a href="#cb37-2" aria-hidden="true"></a><span class="at"> </span><span class="fu">vrfs</span><span class="kw">:</span></span> <span id="cb37-3"><a href="#cb37-3" aria-hidden="true"></a><span class="at"> </span><span class="fu">vrf20</span><span class="kw">:</span></span> <span id="cb37-4"><a href="#cb37-4" aria-hidden="true"></a><span class="at"> </span><span class="fu">table</span><span class="kw">:</span><span class="at"> </span><span class="dv">20</span></span> <span id="cb37-5"><a href="#cb37-5" aria-hidden="true"></a><span class="at"> </span><span class="fu">interfaces</span><span class="kw">:</span><span class="at"> </span><span class="kw">[</span><span class="at"> br0 </span><span class="kw">]</span></span> <span id="cb37-6"><a href="#cb37-6" aria-hidden="true"></a><span class="at"> </span><span class="fu">routes</span><span class="kw">:</span></span> <span id="cb37-7"><a href="#cb37-7" aria-hidden="true"></a><span class="at"> </span><span class="kw">-</span><span class="at"> </span><span class="fu">to</span><span class="kw">:</span><span class="at"> default</span></span> <span id="cb37-8"><a href="#cb37-8" aria-hidden="true"></a><span class="at"> </span><span class="fu">via</span><span class="kw">:</span><span class="at"> </span><span class="fl">10.10.10.3</span></span> <span id="cb37-9"><a href="#cb37-9" aria-hidden="true"></a><span class="at"> </span><span class="fu">routing-policy</span><span class="kw">:</span></span> <span id="cb37-10"><a href="#cb37-10" aria-hidden="true"></a><span class="at"> </span><span class="kw">-</span><span class="at"> </span><span class="fu">from</span><span class="kw">:</span><span class="at"> </span><span class="fl">10.10.10.42</span></span> <span id="cb37-11"><a href="#cb37-11" aria-hidden="true"></a><span class="at"> </span><span class="kw">[</span><span class="at">...</span><span class="kw">]</span></span> <span id="cb37-12"><a href="#cb37-12" aria-hidden="true"></a><span class="at"> </span><span class="fu">bridges</span><span class="kw">:</span></span> <span id="cb37-13"><a href="#cb37-13" aria-hidden="true"></a><span class="at"> </span><span class="fu">br0</span><span class="kw">:</span></span> <span id="cb37-14"><a href="#cb37-14" aria-hidden="true"></a><span class="at"> </span><span class="fu">interfaces</span><span class="kw">:</span><span class="at"> </span><span class="kw">[]</span></span></code></pre></div> <h2 id="properties-for-device-type-nm-devices">Properties for device type <code>nm-devices:</code></h2> <p><strong>Status</strong>: Optional. Its use is not recommended.</p> <p><strong>Purpose</strong>: Use the <code>nm-devices</code> key to configure device types that are not supported by Netplan. This is NetworkManager specific configuration.</p> <p><strong>Structure</strong>: The key consists of a mapping of NetworkManager connections. The <code>nm-devices</code> device type is for internal use only and should not be used in normal configuration files. It enables a fallback mode for unsupported settings, using the <code>passthrough</code> mapping. The general configuration structure for NM connections is shown below.</p> <div class="sourceCode" id="cb38"><pre class="sourceCode yaml"><code class="sourceCode yaml"><span id="cb38-1"><a href="#cb38-1" aria-hidden="true"></a><span class="fu">network</span><span class="kw">:</span></span> <span id="cb38-2"><a href="#cb38-2" aria-hidden="true"></a><span class="at"> </span><span class="fu">version</span><span class="kw">:</span><span class="at"> </span><span class="dv">2</span></span> <span id="cb38-3"><a href="#cb38-3" aria-hidden="true"></a><span class="at"> </span><span class="fu">nm-devices</span><span class="kw">:</span></span> <span id="cb38-4"><a href="#cb38-4" aria-hidden="true"></a><span class="at"> </span><span class="fu">NM-db5f0f67-1f4c-4d59-8ab8-3d278389cf87</span><span class="kw">:</span></span> <span id="cb38-5"><a href="#cb38-5" aria-hidden="true"></a><span class="at"> </span><span class="fu">renderer</span><span class="kw">:</span><span class="at"> NetworkManager</span></span> <span id="cb38-6"><a href="#cb38-6" aria-hidden="true"></a><span class="at"> </span><span class="fu">networkmanager</span><span class="kw">:</span></span> <span id="cb38-7"><a href="#cb38-7" aria-hidden="true"></a><span class="at"> </span><span class="fu">uuid</span><span class="kw">:</span><span class="at"> </span><span class="st">"db5f0f67-1f4c-4d59-8ab8-3d278389cf87"</span></span> <span id="cb38-8"><a href="#cb38-8" aria-hidden="true"></a><span class="at"> </span><span class="fu">name</span><span class="kw">:</span><span class="at"> </span><span class="st">"myvpnconnection"</span></span> <span id="cb38-9"><a href="#cb38-9" aria-hidden="true"></a><span class="at"> </span><span class="fu">passthrough</span><span class="kw">:</span></span> <span id="cb38-10"><a href="#cb38-10" aria-hidden="true"></a><span class="at"> </span><span class="fu">connection.type</span><span class="kw">:</span><span class="at"> </span><span class="st">"vpn"</span></span> <span id="cb38-11"><a href="#cb38-11" aria-hidden="true"></a><span class="at"> </span><span class="fu">vpn.ca</span><span class="kw">:</span><span class="at"> </span><span class="st">"path to ca.crt"</span></span> <span id="cb38-12"><a href="#cb38-12" aria-hidden="true"></a><span class="at"> </span><span class="fu">vpn.cert</span><span class="kw">:</span><span class="at"> </span><span class="st">"path to client.crt"</span></span> <span id="cb38-13"><a href="#cb38-13" aria-hidden="true"></a><span class="at"> </span><span class="fu">vpn.cipher</span><span class="kw">:</span><span class="at"> </span><span class="st">"AES-256-GCM"</span></span> <span id="cb38-14"><a href="#cb38-14" aria-hidden="true"></a><span class="at"> </span><span class="fu">vpn.connection-type</span><span class="kw">:</span><span class="at"> </span><span class="st">"tls"</span></span> <span id="cb38-15"><a href="#cb38-15" aria-hidden="true"></a><span class="at"> </span><span class="fu">vpn.dev</span><span class="kw">:</span><span class="at"> </span><span class="st">"tun"</span></span> <span id="cb38-16"><a href="#cb38-16" aria-hidden="true"></a><span class="at"> </span><span class="fu">vpn.key</span><span class="kw">:</span><span class="at"> </span><span class="st">"path to client.key"</span></span> <span id="cb38-17"><a href="#cb38-17" aria-hidden="true"></a><span class="at"> </span><span class="fu">vpn.remote</span><span class="kw">:</span><span class="at"> </span><span class="st">"1.2.3.4:1194"</span></span> <span id="cb38-18"><a href="#cb38-18" aria-hidden="true"></a><span class="at"> </span><span class="fu">vpn.service-type</span><span class="kw">:</span><span class="at"> </span><span class="st">"org.freedesktop.NetworkManager.openvpn"</span></span></code></pre></div> <h2 id="backend-specific-configuration-parameters">Backend-specific configuration parameters</h2> <p>In addition to the other fields available to configure interfaces, some backends may require to record some of their own parameters in netplan, especially if the netplan definitions are generated automatically by the consumer of that backend. Currently, this is only used with <code>NetworkManager</code>.</p> <ul> <li><p><strong>networkmanager</strong> (mapping) – since <strong>0.99</strong></p> <blockquote> <p>Keeps the NetworkManager-specific configuration parameters used by the daemon to recognize connections.</p> </blockquote> <ul> <li><p><strong>name</strong> (scalar) – since <strong>0.99</strong></p> <blockquote> <p>Set the display name for the connection.</p> </blockquote></li> <li><p><strong>uuid</strong> (scalar) – since <strong>0.99</strong></p> <blockquote> <p>Defines the UUID (unique identifier) for this connection, as generated by NetworkManager itself.</p> </blockquote></li> <li><p><strong>stable-id</strong> (scalar) – since <strong>0.99</strong></p> <blockquote> <p>Defines the stable ID (a different form of a connection name) used by NetworkManager in case the name of the connection might otherwise change, such as when sharing connections between users.</p> </blockquote></li> <li><p><strong>device</strong> (scalar) – since <strong>0.99</strong></p> <blockquote> <p>Defines the interface name for which this connection applies.</p> </blockquote></li> <li><p><strong>passthrough</strong> (mapping) – since <strong>0.102</strong></p> <blockquote> <p>Can be used as a fallback mechanism to missing keyfile settings.</p> </blockquote></li> </ul></li> </ul> <!--- vim: ft=markdown --> </body> </html> PK ! �b�qj j examples/vlan.yamlnu �[��� network: version: 2 renderer: networkd ethernets: mainif: match: macaddress: "de:ad:be:ef:ca:fe" set-name: mainif addresses: [ "10.3.0.5/23" ] nameservers: addresses: [ "8.8.8.8", "8.8.4.4" ] search: [ example.com ] routes: - to: default via: 10.3.0.1 vlans: vlan15: id: 15 link: mainif addresses: [ "10.3.99.5/24" ] vlan10: id: 10 link: mainif addresses: [ "10.3.98.5/24" ] nameservers: addresses: [ "127.0.0.1" ] search: [ domain1.example.com, domain2.example.com ] PK ! � ��} } examples/ipv6_tunnel.yamlnu �[��� network: version: 2 ethernets: eth0: addresses: - 1.1.1.1/24 - "2001:cafe:face::1/64" routes: - to: default via: 1.1.1.254 tunnels: he-ipv6: mode: sit remote: 2.2.2.2 local: 1.1.1.1 addresses: - "2001:dead:beef::2/64" routes: - to: default via: "2001:dead:beef::1" PK ! ��V� � examples/bonding_router.yamlnu �[��� network: version: 2 renderer: networkd ethernets: enp1s0: dhcp4: no enp2s0: dhcp4: no enp3s0: dhcp4: no optional: true enp4s0: dhcp4: no optional: true enp5s0: dhcp4: no optional: true enp6s0: dhcp4: no optional: true bonds: bond-lan: interfaces: [enp2s0, enp3s0] addresses: [192.168.93.2/24] parameters: mode: 802.3ad mii-monitor-interval: 1 bond-wan: interfaces: [enp1s0, enp4s0] addresses: [192.168.1.252/24] nameservers: search: [local] addresses: [8.8.8.8, 8.8.4.4] parameters: mode: active-backup mii-monitor-interval: 1 gratuitious-arp: 5 routes: - to: default via: 192.168.1.1 bond-conntrack: interfaces: [enp5s0, enp6s0] addresses: [192.168.254.2/24] parameters: mode: balance-rr mii-monitor-interval: 1 PK ! ���� � examples/bonding.yamlnu �[��� network: version: 2 renderer: networkd ethernets: enp3s0: {} enp4s0: {} bonds: bond0: dhcp4: yes interfaces: - enp3s0 - enp4s0 parameters: mode: active-backup primary: enp3s0 PK ! 0� L� � examples/bridge.yamlnu �[��� network: version: 2 renderer: networkd ethernets: enp3s0: dhcp4: no bridges: br0: dhcp4: yes interfaces: - enp3s0 PK ! ���[ [ ! examples/windows_dhcp_server.yamlnu �[��� network: version: 2 ethernets: enp3s0: dhcp4: yes dhcp-identifier: mac PK ! ݞ�� � ) examples/direct_connect_gateway_ipv6.yamlnu �[��� network: version: 2 renderer: networkd ethernets: eth0: addresses: [ "2001:cafe:face:beef::dead:dead/64" ] routes: - to: "::/0" via: "2001:cafe:face::1" on-link: true PK ! �*^)0 0 examples/vrf.yamlnu �[��� network: renderer: networkd vrfs: vrf1005: table: 1005 interfaces: - br1 - br1005 routes: - to: default via: 10.10.10.4 routing-policy: - from: 10.10.10.42 bridges: br1: interfaces: [] br1005: interfaces: [] PK ! $��PW W examples/openvswitch.yamlnu �[��� network: version: 2 openvswitch: protocols: [OpenFlow13, OpenFlow14, OpenFlow15] ports: - [patch0-1, patch1-0] ssl: ca-cert: /some/ca-cert.pem certificate: /another/cert.pem private-key: /private/key.pem external-ids: somekey: somevalue other-config: key: value ethernets: eth0: addresses: [10.5.32.26/20] openvswitch: external-ids: iface-id: mylocaliface other-config: disable-in-band: false eth1: {} bonds: bond0: interfaces: [patch1-0, eth1] openvswitch: lacp: passive parameters: mode: balance-tcp bridges: ovs0: addresses: [10.5.48.11/20] interfaces: [patch0-1, eth0, bond0] openvswitch: protocols: [OpenFlow10, OpenFlow11, OpenFlow12] controller: addresses: [unix:/var/run/openvswitch/ovs0.mgmt] connection-mode: out-of-band fail-mode: secure mcast-snooping: true external-ids: iface-id: myhostname other-config: disable-in-band: true PK ! !�Ɖ3 3 examples/offload.yamlnu �[��� network: version: 2 ethernets: ens1: receive-checksum-offload: false transmit-checksum-offload: true tcp-segmentation-offload: true tcp6-segmentation-offload: true generic-segmentation-offload: true generic-receive-offload: true large-receive-offload: true PK ! dn��� � examples/infiniband.yamlnu �[��� network: version: 2 renderer: networkd ethernets: ib0: match: macaddress: "11:22:33:44:55:66:77:88:99:00:11:22:33:44:55:66:77:88:99:00" dhcp4: true infiniband-mode: "connected" PK ! ���xh h examples/modem.yamlnu �[��� network: version: 2 renderer: NetworkManager modems: cdc-wdm1: mtu: 1600 apn: ISP.CINGULAR username: ISP@CINGULARGPRS.COM password: CINGULAR1 number: "*99#" network-id: 24005 device-id: da812de91eec16620b06cd0ca5cbc7ea25245222 pin: 2345 sim-id: 89148000000060671234 sim-operator-id: 310260 PK ! �FR~� � examples/wireguard.yamlnu �[��� network: version: 2 tunnels: wg0: #server mode: wireguard addresses: [10.10.10.20/24] key: 4GgaQCy68nzNsUE5aJ9fuLzHhB65tAlwbmA72MWnOm8= mark: 42 port: 51820 peers: - keys: public: M9nt4YujIOmNrRmpIRTmYSfMdrpvE7u6WkG8FY8WjG4= shared: 7voRZ/ojfXgfPOlswo3Lpma1RJq7qijIEEUEMShQFV8= allowed-ips: [20.20.20.10/24] routes: - to: default via: 10.10.10.21 metric: 100 wg1: #client mode: wireguard addresses: [20.20.20.10/24] key: KPt9BzQjejRerEv8RMaFlpsD675gNexELOQRXt/AcH0= peers: - endpoint: 10.10.10.20:51820 allowed-ips: [0.0.0.0/0] keys: public: rlbInAj0qV69CysWPQY7KEBnKxpYCpaWqOs/dLevdWc= shared: 7voRZ/ojfXgfPOlswo3Lpma1RJq7qijIEEUEMShQFV8= keepalive: 21 routes: - to: default via: 20.20.20.11 metric: 200 PK ! �mc�1 1 examples/network_manager.yamlnu �[��� network: version: 2 renderer: NetworkManager PK ! I߬�� � $ examples/direct_connect_gateway.yamlnu �[��� network: version: 2 renderer: networkd ethernets: eth0: addresses: [ "10.10.10.1/24" ] routes: - to: 0.0.0.0/0 via: 9.9.9.9 on-link: true PK ! U?F^� � ! examples/static_multiaddress.yamlnu �[��� network: version: 2 renderer: networkd ethernets: enp3s0: addresses: - 10.100.1.38/24 - 10.100.1.39/24 routes: - to: default via: 10.100.1.1 PK ! �,�� � examples/vxlan.yamlnu �[��� network: renderer: networkd ethernets: lo: addresses: - 192.168.10.10/32 vrfs: vrf1005: table: 1005 interfaces: - br1 - br1005 bridges: br1: interfaces: - vxlan1 br1005: interfaces: - vxlan1005 tunnels: vxlan1005: mode: vxlan id: 1005 link: lo mtu: 8950 accept-ra: no neigh-suppress: true mac-learning: false port: 4789 local: 192.168.10.10 vxlan1: mode: vxlan id: 1 link: lo mtu: 8950 accept-ra: no neigh-suppress: true mac-learning: false port: 4789 local: 192.168.10.10 PK ! (M�Zr r examples/wireless.yamlnu �[��� network: version: 2 renderer: networkd wifis: wlp2s0b1: regulatory-domain: "GB" dhcp4: no dhcp6: no addresses: [192.168.0.21/24] nameservers: addresses: [192.168.0.1, 8.8.8.8] access-points: "network_ssid_name": password: "**********" routes: - to: default via: 192.168.0.1 PK ! ����+ + examples/sriov.yamlnu �[��� network: version: 2 renderer: networkd ethernets: eno1: mtu: 9000 embedded-switch-mode: "switchdev" enp1s16f1: link: eno1 addresses : [ "10.15.98.25/24" ] vf1: match: name: enp1s16f[2-3] link: eno1 addresses : [ "10.15.99.25/24" ] PK ! ��1~ ~ examples/loopback_interface.yamlnu �[��� network: version: 2 renderer: networkd ethernets: lo: match: name: lo addresses: [ 7.7.7.7/32 ] PK ! ��*ݿ � examples/route_metric.yamlnu �[��� network: version: 2 ethernets: enred: dhcp4: yes dhcp4-overrides: route-metric: 100 engreen: dhcp4: yes dhcp4-overrides: route-metric: 200 PK ! Ӆ�Y Y 3 examples/static_singlenic_multiip_multigateway.yamlnu �[��� network: version: 2 renderer: networkd ethernets: eno1: addresses: - 10.0.0.10/24 - 11.0.0.11/24 nameservers: addresses: - 8.8.8.8 - 8.8.4.4 routes: - to: 0.0.0.0/0 via: 10.0.0.1 metric: 100 - to: 0.0.0.0/0 via: 11.0.0.1 metric: 200 PK ! �!)1 1 examples/source_routing.yamlnu �[��� network: version: 2 renderer: networkd ethernets: ens3: addresses: - 192.168.3.30/24 dhcp4: no routes: - to: 192.168.3.0/24 via: 192.168.3.1 table: 101 routing-policy: - from: 192.168.3.0/24 table: 101 ens5: addresses: - 192.168.5.24/24 dhcp4: no routes: - to: default via: 192.168.5.1 - to: 192.168.5.0/24 via: 192.168.5.1 table: 102 routing-policy: - from: 192.168.5.0/24 table: 102 PK ! \��; ; examples/sriov_vlan.yamlnu �[��� network: version: 2 renderer: networkd ethernets: eno1: mtu: 9000 enp1s16f1: link: eno1 addresses : [ "10.15.98.25/24" ] vlans: vlan1: id: 15 link: enp1s16f1 addresses: [ "10.3.99.5/24" ] vlan2_hw: id: 10 link: enp1s16f1 renderer: sriov PK ! qفiV V examples/dhcp.yamlnu �[��� network: version: 2 renderer: networkd ethernets: enp3s0: dhcp4: true PK ! �5�8� � examples/bridge_vlan.yamlnu �[��� network: version: 2 renderer: networkd ethernets: enp0s25: dhcp4: true bridges: br0: addresses: [ 10.3.99.25/24 ] interfaces: [ vlan15 ] vlans: vlan15: accept-ra: no id: 15 link: enp0s25 PK ! r|ף examples/static.yamlnu �[��� network: version: 2 renderer: networkd ethernets: enp3s0: addresses: - 10.10.10.2/24 nameservers: search: [mydomain, otherdomain] addresses: [10.10.10.1, 1.1.1.1] routes: - to: default via: 10.10.10.1 PK ! jhm� � examples/dhcp_wired8021x.yamlnu �[��� network: version: 2 renderer: networkd ethernets: enp3s0: dhcp4: true auth: key-management: 802.1x method: ttls identity: fluffy@cisco.com password: hash:83...11 PK ! �[ examples/wpa_enterprise.yamlnu �[��� network: version: 2 wifis: wl0: access-points: workplace: auth: key-management: eap method: ttls anonymous-identity: "@internal.example.com" identity: "joe@internal.example.com" password: "v3ryS3kr1t" university: auth: key-management: eap method: tls anonymous-identity: "@cust.example.com" identity: "cert-joe@cust.example.com" ca-certificate: /etc/ssl/cust-cacrt.pem client-certificate: /etc/ssl/cust-crt.pem client-key: /etc/ssl/cust-key.pem client-key-password: "d3cryptPr1v4t3K3y" open-network: auth: key-management: none dhcp4: yes PK ! � G�� � configmanager.pynu �[��� #!/usr/bin/python3 # # Copyright (C) 2018 Canonical, Ltd. # Author: Mathieu Trudel-Lapierre <mathieu.trudel-lapierre@canonical.com> # # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation; version 3. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty 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, see <http://www.gnu.org/licenses/>. '''netplan configuration manager''' import logging import os import shutil import sys import tempfile from typing import Optional from netplan import libnetplan class ConfigManager(object): def __init__(self, prefix="/", extra_files={}): self.prefix = prefix self.tempdir = tempfile.mkdtemp(prefix='netplan_') self.temp_etc = os.path.join(self.tempdir, "etc") self.temp_run = os.path.join(self.tempdir, "run") self.extra_files = extra_files self.new_interfaces = set() self.np_state: Optional[libnetplan.State] = None def __getattr__(self, attr): assert self.np_state is not None, "Must call parse() before accessing the config." return getattr(self.np_state, attr) @property def physical_interfaces(self): assert self.np_state is not None, "Must call parse() before accessing the config." interfaces = {} interfaces.update(self.np_state.ethernets) interfaces.update(self.np_state.modems) interfaces.update(self.np_state.wifis) return interfaces @property def virtual_interfaces(self): assert self.np_state is not None, "Must call parse() before accessing the config." interfaces = {} # what about ovs_ports? interfaces.update(self.np_state.bridges) interfaces.update(self.np_state.bonds) interfaces.update(self.np_state.tunnels) interfaces.update(self.np_state.vlans) interfaces.update(self.np_state.vrfs) return interfaces def parse(self, extra_config=None): """ Parse all our config files to return an object that describes the system's entire configuration, so that it can later be interrogated. Returns a libnetplan State wrapper """ # /run/netplan shadows /etc/netplan/, which shadows /lib/netplan parser = libnetplan.Parser() try: parser.load_yaml_hierarchy(rootdir=self.prefix) if extra_config: for f in extra_config: parser.load_yaml(f) self.np_state = libnetplan.State() self.np_state.import_parser_results(parser) except libnetplan.LibNetplanException as e: raise ConfigurationError(*e.args) self.np_state.dump_to_logs() return self.np_state def add(self, config_dict): for config_file in config_dict: self._copy_file(config_file, config_dict[config_file]) self.extra_files.update(config_dict) # Invalidate the current parsed state self.np_state = None def backup(self, backup_config_dir=True): if backup_config_dir: self._copy_tree(os.path.join(self.prefix, "etc/netplan"), os.path.join(self.temp_etc, "netplan")) self._copy_tree(os.path.join(self.prefix, "run/NetworkManager/system-connections"), os.path.join(self.temp_run, "NetworkManager", "system-connections"), missing_ok=True) self._copy_tree(os.path.join(self.prefix, "run/systemd/network"), os.path.join(self.temp_run, "systemd", "network"), missing_ok=True) def revert(self): try: for extra_file in dict(self.extra_files): os.unlink(self.extra_files[extra_file]) del self.extra_files[extra_file] temp_nm_path = "{}/NetworkManager/system-connections".format(self.temp_run) temp_networkd_path = "{}/systemd/network".format(self.temp_run) if os.path.exists(temp_nm_path): shutil.rmtree(os.path.join(self.prefix, "run/NetworkManager/system-connections")) self._copy_tree(temp_nm_path, os.path.join(self.prefix, "run/NetworkManager/system-connections")) if os.path.exists(temp_networkd_path): shutil.rmtree(os.path.join(self.prefix, "run/systemd/network")) self._copy_tree(temp_networkd_path, os.path.join(self.prefix, "run/systemd/network")) except Exception as e: # pragma: nocover (only relevant to filesystem failures) # If we reach here, we're in big trouble. We may have wiped out # file NM or networkd are using, and we most likely removed the # "new" config -- or at least our copy of it. # Given that we're in some halfway done revert; warn the user # aggressively and drop everything; leaving any remaining backups # around for the user to handle themselves. logging.error("Something really bad happened while reverting config: {}".format(e)) logging.error("You should verify the netplan YAML in /etc/netplan and probably run 'netplan apply' again.") sys.exit(-1) def cleanup(self): shutil.rmtree(self.tempdir) def __del__(self): try: self.cleanup() except FileNotFoundError: # If cleanup() was called before, there is nothing to delete pass def _copy_file(self, src, dst): shutil.copy(src, dst) def _copy_tree(self, src, dst, missing_ok=False): try: shutil.copytree(src, dst) except FileNotFoundError: if missing_ok: pass else: raise class ConfigurationError(Exception): """ Configuration could not be parsed or has otherwise failed to apply """ pass PK ! ���� � terminal.pynu �[��� #!/usr/bin/python3 # # Copyright (C) 2018 Canonical, Ltd. # Author: Mathieu Trudel-Lapierre <mathieu.trudel-lapierre@canonical.com> # # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation; version 3. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty 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, see <http://www.gnu.org/licenses/>. """ Terminal / input handling """ import fcntl import os import termios import select import sys class Terminal(object): """ Do minimal terminal mangling to prompt users for input """ def __init__(self, fd): self.fd = fd self.orig_flags = None self.orig_term = None self.save() def enable_echo(self): if sys.stdin.isatty(): attrs = termios.tcgetattr(self.fd) attrs[3] = attrs[3] | termios.ICANON attrs[3] = attrs[3] | termios.ECHO termios.tcsetattr(self.fd, termios.TCSANOW, attrs) def disable_echo(self): if sys.stdin.isatty(): attrs = termios.tcgetattr(self.fd) attrs[3] = attrs[3] & ~termios.ICANON attrs[3] = attrs[3] & ~termios.ECHO termios.tcsetattr(self.fd, termios.TCSANOW, attrs) def enable_nonblocking_io(self): flags = fcntl.fcntl(self.fd, fcntl.F_GETFL) fcntl.fcntl(self.fd, fcntl.F_SETFL, flags | os.O_NONBLOCK) def disable_nonblocking_io(self): flags = fcntl.fcntl(self.fd, fcntl.F_GETFL) fcntl.fcntl(self.fd, fcntl.F_SETFL, flags & ~os.O_NONBLOCK) def get_confirmation_input(self, timeout=120, message=None): # pragma: nocover (requires user input) """ Get a "confirmation" input from the user, for at most (timeout) seconds. Optionally, customize the message to be displayed. timeout -- timeout to wait for input (default 120) message -- optional customized message ("Press ENTER to (message)") raises: InputAccepted -- the user confirmed the changes InputRejected -- the user rejected the changes """ print("Do you want to keep these settings?\n\n") settings = dict() self.save(settings) self.disable_echo() self.enable_nonblocking_io() if not message: message = "accept the new configuration" print("Press ENTER before the timeout to {}\n\n".format(message)) timeout_now = timeout while (timeout_now > 0): print("Changes will revert in {:>{}} seconds".format(timeout_now, len(str(timeout))), end='\r') # wait at most 1 second for usable input from stdin select.select([sys.stdin], [], [], 1) try: # retrieve any input from the terminal. select() either has # timed out with no input, or found something we can retrieve. c = sys.stdin.read() if (c == '\n'): self.reset(settings) # Yay, user has accepted the changes! raise InputAccepted() except TypeError: # read() above is non-blocking, if there is nothing to read it # will return TypeError, which we should ignore -- on to the # next iteration until timeout. pass timeout_now -= 1 # We reached the timeout for our loop, now revert our change for # non-blocking I/O and signal the caller the changes were essentially # rejected. self.reset(settings) raise InputRejected() def save(self, dest=None): """ Save the terminal's current attributes and flags Optional argument: - dest: if set, save settings to this dict """ orig_flags = fcntl.fcntl(self.fd, fcntl.F_GETFL) orig_term = None if sys.stdin.isatty(): orig_term = termios.tcgetattr(self.fd) if dest is not None: dest.update({'flags': orig_flags, 'term': orig_term}) else: self.orig_flags = orig_flags self.orig_term = orig_term def reset(self, orig=None): """ Reset the terminal to its original attributes and flags Optional argument: - orig: if set, reset to settings from this dict """ orig_term = None orig_flags = None if orig is not None: orig_term = orig.get('term') orig_flags = orig.get('flags') else: orig_term = self.orig_term orig_flags = self.orig_flags if sys.stdin.isatty(): termios.tcsetattr(self.fd, termios.TCSAFLUSH, orig_term) fcntl.fcntl(self.fd, fcntl.F_SETFL, orig_flags) class InputAccepted(Exception): """ Denotes has accepted input""" pass class InputRejected(Exception): """ Denotes that the user has rejected input""" pass PK ! ��PH PH libnetplan.pynu �[��� # Copyright (C) 2018-2020 Canonical, Ltd. # Author: Mathieu Trudel-Lapierre <mathieu.trudel-lapierre@canonical.com> # Author: Łukasz 'sil2100' Zemczak <lukasz.zemczak@canonical.com> # Author: Lukas 'slyon' Märdian <lukas.maerdian@canonical.com> # Author: Simon Chopin <simon.chopin@canonical.com> # # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation; version 3. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty 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, see <http://www.gnu.org/licenses/>. import tempfile import logging import ctypes import ctypes.util from ctypes import c_char_p, c_void_p, c_int, c_uint, c_size_t, c_ssize_t from typing import List, Union, IO class LibNetplanException(Exception): pass class _GError(ctypes.Structure): _fields_ = [("domain", ctypes.c_uint32), ("code", c_int), ("message", c_char_p)] class _netplan_state(ctypes.Structure): pass class _netplan_parser(ctypes.Structure): pass class _netplan_net_definition(ctypes.Structure): pass lib = ctypes.CDLL(ctypes.util.find_library('netplan')) _GErrorPP = ctypes.POINTER(ctypes.POINTER(_GError)) _NetplanParserP = ctypes.POINTER(_netplan_parser) _NetplanStateP = ctypes.POINTER(_netplan_state) _NetplanNetDefinitionP = ctypes.POINTER(_netplan_net_definition) lib.netplan_get_id_from_nm_filename.restype = ctypes.c_char_p def _string_realloc_call_no_error(function): size = 16 while size < 1048576: # 1MB buffer = ctypes.create_string_buffer(size) code = function(buffer) if code == -2: size = size * 2 continue if code < 0: # pragma: nocover raise LibNetplanException("Unknown error: %d" % code) elif code == 0: return None # pragma: nocover as it's hard to trigger for now else: return buffer.value.decode('utf-8') raise LibNetplanException('Halting due to string buffer size > 1M') # pragma: nocover def _checked_lib_call(fn, *args): err = ctypes.POINTER(_GError)() ret = bool(fn(*args, ctypes.byref(err))) if not ret: raise LibNetplanException(err.contents.message.decode('utf-8')) class Parser: _abi_loaded = False @classmethod def _load_abi(cls): if cls._abi_loaded: return lib.netplan_parser_new.restype = _NetplanParserP lib.netplan_parser_clear.argtypes = [ctypes.POINTER(_NetplanParserP)] lib.netplan_parser_load_yaml.argtypes = [_NetplanParserP, c_char_p, _GErrorPP] lib.netplan_parser_load_yaml.restype = c_int lib.netplan_parser_load_yaml_from_fd.argtypes = [_NetplanParserP, c_int, _GErrorPP] lib.netplan_parser_load_yaml_from_fd.restype = c_int lib.netplan_parser_load_nullable_fields.argtypes = [_NetplanParserP, c_int, _GErrorPP] lib.netplan_parser_load_nullable_fields.restype = c_int lib.netplan_parser_load_nullable_overrides.argtypes =\ [_NetplanParserP, c_int, c_char_p, _GErrorPP] lib.netplan_parser_load_nullable_overrides.restype = c_int cls._abi_loaded = True def __init__(self): self._load_abi() self._ptr = lib.netplan_parser_new() def __del__(self): lib.netplan_parser_clear(ctypes.byref(self._ptr)) def load_yaml(self, input_file: Union[str, IO]): if isinstance(input_file, str): _checked_lib_call(lib.netplan_parser_load_yaml, self._ptr, input_file.encode('utf-8')) else: _checked_lib_call(lib.netplan_parser_load_yaml_from_fd, self._ptr, input_file.fileno()) def load_yaml_hierarchy(self, rootdir): _checked_lib_call(lib.netplan_parser_load_yaml_hierarchy, self._ptr, rootdir.encode('utf-8')) def load_nullable_fields(self, input_file: IO): _checked_lib_call(lib.netplan_parser_load_nullable_fields, self._ptr, input_file.fileno()) def load_nullable_overrides(self, input_file: IO, constraint: str): _checked_lib_call(lib.netplan_parser_load_nullable_overrides, self._ptr, input_file.fileno(), constraint.encode('utf-8')) class State: _abi_loaded = False @classmethod def _load_abi(cls): if cls._abi_loaded: return lib.netplan_state_new.restype = _NetplanStateP lib.netplan_state_clear.argtypes = [ctypes.POINTER(_NetplanStateP)] lib.netplan_state_import_parser_results.argtypes = [_NetplanStateP, _NetplanParserP, _GErrorPP] lib.netplan_state_import_parser_results.restype = c_int lib.netplan_state_get_netdefs_size.argtypes = [_NetplanStateP] lib.netplan_state_get_netdefs_size.restype = c_int lib.netplan_state_get_netdef.argtypes = [_NetplanStateP, c_char_p] lib.netplan_state_get_netdef.restype = _NetplanNetDefinitionP lib.netplan_state_write_yaml_file.argtypes = [_NetplanStateP, c_char_p, c_char_p, _GErrorPP] lib.netplan_state_write_yaml_file.restype = c_int lib.netplan_state_update_yaml_hierarchy.argtypes = [_NetplanStateP, c_char_p, c_char_p, _GErrorPP] lib.netplan_state_update_yaml_hierarchy.restype = c_int lib.netplan_state_dump_yaml.argtypes = [_NetplanStateP, c_int, _GErrorPP] lib.netplan_state_dump_yaml.restype = c_int lib.netplan_netdef_get_embedded_switch_mode.argtypes = [_NetplanNetDefinitionP] lib.netplan_netdef_get_embedded_switch_mode.restype = c_char_p lib.netplan_netdef_get_delay_virtual_functions_rebind.argtypes = [_NetplanNetDefinitionP] lib.netplan_netdef_get_delay_virtual_functions_rebind.restype = c_int lib.netplan_state_get_backend.argtypes = [_NetplanStateP] lib.netplan_state_get_backend.restype = c_int cls._abi_loaded = True def __init__(self): self._load_abi() self._ptr = lib.netplan_state_new() def __del__(self): lib.netplan_state_clear(ctypes.byref(self._ptr)) def import_parser_results(self, parser): _checked_lib_call(lib.netplan_state_import_parser_results, self._ptr, parser._ptr) def write_yaml_file(self, filename, rootdir): name = filename.encode('utf-8') if filename else None root = rootdir.encode('utf-8') if rootdir else None _checked_lib_call(lib.netplan_state_write_yaml_file, self._ptr, name, root) def update_yaml_hierarchy(self, default_filename, rootdir): name = default_filename.encode('utf-8') root = rootdir.encode('utf-8') if rootdir else None _checked_lib_call(lib.netplan_state_update_yaml_hierarchy, self._ptr, name, root) def dump_yaml(self, output_file): fd = output_file.fileno() _checked_lib_call(lib.netplan_state_dump_yaml, self._ptr, fd) def __len__(self): return lib.netplan_state_get_netdefs_size(self._ptr) def __getitem__(self, def_id): ptr = lib.netplan_state_get_netdef(self._ptr, def_id.encode('utf-8')) if not ptr: raise IndexError() return NetDefinition(self, ptr) @property def all_defs(self): return dict((nd.id, nd) for nd in _NetdefIterator(self, None)) @property def ethernets(self): return dict((nd.id, nd) for nd in _NetdefIterator(self, "ethernets")) @property def modems(self): return dict((nd.id, nd) for nd in _NetdefIterator(self, "modems")) @property def wifis(self): return dict((nd.id, nd) for nd in _NetdefIterator(self, "wifis")) @property def vlans(self): return dict((nd.id, nd) for nd in _NetdefIterator(self, "vlans")) @property def bridges(self): return dict((nd.id, nd) for nd in _NetdefIterator(self, "bridges")) @property def bonds(self): return dict((nd.id, nd) for nd in _NetdefIterator(self, "bonds")) @property def tunnels(self): return dict((nd.id, nd) for nd in _NetdefIterator(self, "tunnels")) @property def vrfs(self): return dict((nd.id, nd) for nd in _NetdefIterator(self, "vrfs")) @property def ovs_ports(self): return dict((nd.id, nd) for nd in _NetdefIterator(self, "_ovs-ports")) @property def nm_devices(self): return dict((nd.id, nd) for nd in _NetdefIterator(self, "nm-devices")) @property def backend(self): return lib.netplan_backend_name(lib.netplan_state_get_backend(self._ptr)).decode('utf-8') def dump_to_logs(self): # Convoluted way to dump the parsed config to the logs... with tempfile.TemporaryFile() as tmp: self.dump_yaml(output_file=tmp) logging.debug("Merged config:\n{}".format(tmp.read())) class NetDefinition: _abi_loaded = False @classmethod def _load_abi(cls): if cls._abi_loaded: return lib.netplan_netdef_has_match.argtypes = [_NetplanNetDefinitionP] lib.netplan_netdef_has_match.restype = c_int lib.netplan_netdef_get_id.argtypes = [_NetplanNetDefinitionP, c_char_p, c_size_t] lib.netplan_netdef_get_id.restype = c_ssize_t lib.netplan_netdef_get_filepath.argtypes = [_NetplanNetDefinitionP, c_char_p, c_size_t] lib.netplan_netdef_get_filepath.restype = c_ssize_t lib.netplan_netdef_get_backend.argtypes = [_NetplanNetDefinitionP] lib.netplan_netdef_get_backend.restype = c_int lib.netplan_netdef_get_type.argtypes = [_NetplanNetDefinitionP] lib.netplan_netdef_get_type.restype = c_int lib.netplan_netdef_get_set_name.argtypes = [_NetplanNetDefinitionP, c_char_p, c_size_t] lib.netplan_netdef_get_set_name.restype = c_ssize_t lib._netplan_netdef_get_critical.argtypes = [_NetplanNetDefinitionP] lib._netplan_netdef_get_critical.restype = c_int lib.netplan_netdef_get_sriov_link.argtypes = [_NetplanNetDefinitionP] lib.netplan_netdef_get_sriov_link.restype = _NetplanNetDefinitionP lib.netplan_netdef_get_vlan_link.argtypes = [_NetplanNetDefinitionP] lib.netplan_netdef_get_vlan_link.restype = _NetplanNetDefinitionP lib.netplan_netdef_get_bridge_link.argtypes = [_NetplanNetDefinitionP] lib.netplan_netdef_get_bridge_link.restype = _NetplanNetDefinitionP lib.netplan_netdef_get_bond_link.argtypes = [_NetplanNetDefinitionP] lib.netplan_netdef_get_bond_link.restype = _NetplanNetDefinitionP lib.netplan_netdef_get_peer_link.argtypes = [_NetplanNetDefinitionP] lib.netplan_netdef_get_peer_link.restype = _NetplanNetDefinitionP lib._netplan_netdef_get_vlan_id.argtypes = [_NetplanNetDefinitionP] lib._netplan_netdef_get_vlan_id.restype = c_uint lib._netplan_netdef_get_sriov_vlan_filter.argtypes = [_NetplanNetDefinitionP] lib._netplan_netdef_get_sriov_vlan_filter.restype = c_int lib.netplan_netdef_match_interface.argtypes = [_NetplanNetDefinitionP] lib.netplan_netdef_match_interface.restype = c_int lib.netplan_backend_name.argtypes = [c_int] lib.netplan_backend_name.restype = c_char_p lib.netplan_def_type_name.argtypes = [c_int] lib.netplan_def_type_name.restype = c_char_p lib._netplan_state_get_vf_count_for_def.argtypes = [_NetplanStateP, _NetplanNetDefinitionP, _GErrorPP] lib._netplan_state_get_vf_count_for_def.restype = c_int lib._netplan_netdef_is_trivial_compound_itf.argtypes = [_NetplanNetDefinitionP] lib._netplan_netdef_is_trivial_compound_itf.restype = c_int cls._abi_loaded = True def __eq__(self, other): if not hasattr(other, '_ptr'): return False return ctypes.addressof(self._ptr.contents) == ctypes.addressof(other._ptr.contents) def __init__(self, np_state, ptr): self._load_abi() self._ptr = ptr # We hold on to this to avoid the underlying pointer being invalidated by # the GC invoking netplan_state_free self._parent = np_state @property def has_match(self): return bool(lib.netplan_netdef_has_match(self._ptr)) @property def set_name(self): return _string_realloc_call_no_error(lambda b: lib.netplan_netdef_get_set_name(self._ptr, b, len(b))) @property def critical(self): return bool(lib._netplan_netdef_get_critical(self._ptr)) @property def sriov_link(self): link_ptr = lib.netplan_netdef_get_sriov_link(self._ptr) if link_ptr: return NetDefinition(self._parent, link_ptr) return None @property def vlan_link(self): link_ptr = lib.netplan_netdef_get_vlan_link(self._ptr) if link_ptr: return NetDefinition(self._parent, link_ptr) return None @property def bridge_link(self): link_ptr = lib.netplan_netdef_get_bridge_link(self._ptr) if link_ptr: return NetDefinition(self._parent, link_ptr) return None @property def bond_link(self): link_ptr = lib.netplan_netdef_get_bond_link(self._ptr) if link_ptr: return NetDefinition(self._parent, link_ptr) return None @property def peer_link(self): link_ptr = lib.netplan_netdef_get_peer_link(self._ptr) if link_ptr: return NetDefinition(self._parent, link_ptr) return None # pragma: nocover (ovs ports are always defined in pairs) @property def vlan_id(self): vlan_id = lib._netplan_netdef_get_vlan_id(self._ptr) # No easy way to get UINT_MAX besides this... if vlan_id == c_uint(-1).value: return None return vlan_id @property def has_sriov_vlan_filter(self): return bool(lib._netplan_netdef_get_sriov_vlan_filter(self._ptr)) @property def backend(self): return lib.netplan_backend_name(lib.netplan_netdef_get_backend(self._ptr)).decode('utf-8') @property def type(self): return lib.netplan_def_type_name(lib.netplan_netdef_get_type(self._ptr)).decode('utf-8') @property def id(self): return _string_realloc_call_no_error(lambda b: lib.netplan_netdef_get_id(self._ptr, b, len(b))) @property def filepath(self): return _string_realloc_call_no_error(lambda b: lib.netplan_netdef_get_filepath(self._ptr, b, len(b))) @property def embedded_switch_mode(self): mode = lib.netplan_netdef_get_embedded_switch_mode(self._ptr) return mode and mode.decode('utf-8') @property def delay_virtual_functions_rebind(self): return bool(lib.netplan_netdef_get_delay_virtual_functions_rebind(self._ptr)) def match_interface(self, itf_name=None, itf_driver=None, itf_mac=None): return bool(lib.netplan_netdef_match_interface( self._ptr, itf_name and itf_name.encode('utf-8'), itf_mac and itf_mac.encode('utf-8'), itf_driver and itf_driver.encode('utf-8'))) @property def vf_count(self): err = ctypes.POINTER(_GError)() count = lib._netplan_state_get_vf_count_for_def(self._parent._ptr, self._ptr, ctypes.byref(err)) if count < 0: raise LibNetplanException(err.contents.message.decode('utf-8')) return count @property def is_trivial_compound_itf(self): ''' Returns True if the interface is a compound interface (bond or bridge), and its configuration is trivial, without any variation from the defaults. ''' return bool(lib._netplan_netdef_is_trivial_compound_itf(self._ptr)) class _NetdefIterator: _abi_loaded = False @classmethod def _load_abi(cls): if cls._abi_loaded: return if not hasattr(lib, '_netplan_iter_defs_per_devtype_init'): # pragma: nocover (hard to unit-test against the WRONG lib) raise LibNetplanException(''' The current version of libnetplan does not allow iterating by devtype. Please ensure that both the netplan CLI package and its library are up to date. ''') lib._netplan_state_new_netdef_pertype_iter.argtypes = [_NetplanStateP, c_char_p] lib._netplan_state_new_netdef_pertype_iter.restype = c_void_p lib._netplan_iter_defs_per_devtype_next.argtypes = [c_void_p] lib._netplan_iter_defs_per_devtype_next.restype = _NetplanNetDefinitionP lib._netplan_iter_defs_per_devtype_free.argtypes = [c_void_p] lib._netplan_iter_defs_per_devtype_free.restype = None lib._netplan_netdef_id.argtypes = [c_void_p] lib._netplan_netdef_id.restype = c_char_p cls._abi_loaded = True def __init__(self, np_state, devtype): self._load_abi() # To keep things valid, keep a reference to the parent state self.np_state = np_state self.iterator = lib._netplan_state_new_netdef_pertype_iter(np_state._ptr, devtype and devtype.encode('utf-8')) def __del__(self): lib._netplan_iter_defs_per_devtype_free(self.iterator) def __iter__(self): return self def __next__(self): next_value = lib._netplan_iter_defs_per_devtype_next(self.iterator) if not next_value: raise StopIteration return NetDefinition(self.np_state, next_value) lib.netplan_util_create_yaml_patch.argtypes = [c_char_p, c_char_p, c_int, _GErrorPP] lib.netplan_util_create_yaml_patch.restype = c_int lib.netplan_util_dump_yaml_subtree.argtypes = [c_char_p, c_int, c_int, _GErrorPP] lib.netplan_util_dump_yaml_subtree.restype = c_int def create_yaml_patch(patch_object_path: List[str], patch_payload: str, patch_output): _checked_lib_call(lib.netplan_util_create_yaml_patch, '\t'.join(patch_object_path).encode('utf-8'), patch_payload.encode('utf-8'), patch_output.fileno()) def dump_yaml_subtree(prefix, input_file, output_file): _checked_lib_call(lib.netplan_util_dump_yaml_subtree, prefix.encode('utf-8'), input_file.fileno(), output_file.fileno()) PK ! �i-� � __init__.pynu �[��� #!/usr/bin/python3 # # Copyright (C) 2018 Canonical, Ltd. # Author: Mathieu Trudel-Lapierre <mathieu.trudel-lapierre@canonical.com> # # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation; version 3. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty 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, see <http://www.gnu.org/licenses/>. from netplan.cli.core import Netplan __all__ = [Netplan] PK ! �$<�O �O cli/commands/apply.pynu �[��� #!/usr/bin/python3 # # Copyright (C) 2018-2020 Canonical, Ltd. # Author: Mathieu Trudel-Lapierre <mathieu.trudel-lapierre@canonical.com> # Author: Łukasz 'sil2100' Zemczak <lukasz.zemczak@canonical.com> # Author: Lukas 'slyon' Märdian <lukas.maerdian@canonical.com> # # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation; version 3. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty 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, see <http://www.gnu.org/licenses/>. '''netplan apply command line''' import logging import os import sys import glob import subprocess import shutil import netifaces import time import netplan.cli.utils as utils from netplan.configmanager import ConfigManager, ConfigurationError from netplan.cli.sriov import apply_sriov_config from netplan.cli.ovs import OvsDbServerNotRunning, apply_ovs_cleanup OVS_CLEANUP_SERVICE = 'netplan-ovs-cleanup.service' IF_NAMESIZE = 16 class NetplanApply(utils.NetplanCommand): def __init__(self): super().__init__(command_id='apply', description='Apply current netplan config to running system', leaf=True) self.sriov_only = False self.only_ovs_cleanup = False self.state = None # to be filled by the '--state' argument def run(self): # pragma: nocover (covered in autopkgtest) self.parser.add_argument('--sriov-only', action='store_true', help='Only apply SR-IOV related configuration and exit') self.parser.add_argument('--only-ovs-cleanup', action='store_true', help='Only clean up old OpenVSwitch interfaces and exit') self.parser.add_argument('--state', help='Directory containing previous YAML configuration') self.func = self.command_apply self.parse_args() self.run_command() def command_apply(self, run_generate=True, sync=False, exit_on_error=True, state_dir=None): # pragma: nocover config_manager = ConfigManager() if state_dir: self.state = state_dir # For certain use-cases, we might want to only apply specific configuration. # If we only need SR-IOV configuration, do that and exit early. if self.sriov_only: NetplanApply.process_sriov_config(config_manager, exit_on_error) return # If we only need OpenVSwitch cleanup, do that and exit early. elif self.only_ovs_cleanup: NetplanApply.process_ovs_cleanup(config_manager, False, False, exit_on_error) return # if we are inside a snap, then call dbus to run netplan apply instead if "SNAP" in os.environ: # TODO: maybe check if we are inside a classic snap and don't do # this if we are in a classic snap? busctl = shutil.which("busctl") if busctl is None: raise RuntimeError("missing busctl utility") # XXX: DO NOT TOUCH or change this API call, it is used by snapd to communicate # using core20 netplan binary/client/CLI on core18 base systems. Any change # must be agreed upon with the snapd team, so we don't break support for # base systems running older netplan versions. # https://github.com/snapcore/snapd/pull/5915 res = subprocess.call([busctl, "call", "--quiet", "--system", "io.netplan.Netplan", # the service "/io/netplan/Netplan", # the object "io.netplan.Netplan", # the interface "Apply", # the method ]) if res != 0: if exit_on_error: sys.exit(res) elif res == 130: raise PermissionError( "failed to communicate with dbus service") else: raise RuntimeError( "failed to communicate with dbus service: error %s" % res) else: return ovs_cleanup_service = '/run/systemd/system/netplan-ovs-cleanup.service' old_files_networkd = bool(glob.glob('/run/systemd/network/*netplan-*')) old_ovs_glob = glob.glob('/run/systemd/system/netplan-ovs-*') # Ignore netplan-ovs-cleanup.service, as it can always be there if ovs_cleanup_service in old_ovs_glob: old_ovs_glob.remove(ovs_cleanup_service) old_files_ovs = bool(old_ovs_glob) old_nm_glob = glob.glob('/run/NetworkManager/system-connections/netplan-*') nm_ifaces = utils.nm_interfaces(old_nm_glob, netifaces.interfaces()) old_files_nm = bool(old_nm_glob) generator_call = [] generate_out = None if 'NETPLAN_PROFILE' in os.environ: generator_call.extend(['valgrind', '--leak-check=full']) generate_out = subprocess.STDOUT generator_call.append(utils.get_generator_path()) if run_generate and subprocess.call(generator_call, stderr=generate_out) != 0: if exit_on_error: sys.exit(os.EX_CONFIG) else: raise ConfigurationError("the configuration could not be generated") devices = netifaces.interfaces() # Re-start service when # 1. We have configuration files for it # 2. Previously we had config files for it but not anymore # Ideally we should compare the content of the *netplan-* files before and # after generation to minimize the number of re-starts, but the conditions # above works too. restart_networkd = bool(glob.glob('/run/systemd/network/*netplan-*')) if not restart_networkd and old_files_networkd: restart_networkd = True restart_ovs_glob = glob.glob('/run/systemd/system/netplan-ovs-*') # Ignore netplan-ovs-cleanup.service, as it can always be there if ovs_cleanup_service in restart_ovs_glob: restart_ovs_glob.remove(ovs_cleanup_service) restart_ovs = bool(restart_ovs_glob) if not restart_ovs and old_files_ovs: # OVS is managed via systemd units restart_networkd = True restart_nm_glob = glob.glob('/run/NetworkManager/system-connections/netplan-*') nm_ifaces.update(utils.nm_interfaces(restart_nm_glob, devices)) restart_nm = bool(restart_nm_glob) if not restart_nm and old_files_nm: restart_nm = True # Running 'systemctl daemon-reload' will re-run the netplan systemd generator, # so let's make sure we only run it iff we're willing to run 'netplan generate' if run_generate: utils.systemctl_daemon_reload() # stop backends if restart_networkd: logging.debug('netplan generated networkd configuration changed, reloading networkd') # Clean up any old netplan related OVS ports/bonds/bridges, if applicable NetplanApply.process_ovs_cleanup(config_manager, old_files_ovs, restart_ovs, exit_on_error) wpa_services = ['netplan-wpa-*.service'] # Historically (up to v0.98) we had netplan-wpa@*.service files, in case of an # upgraded system, we need to make sure to stop those. if utils.systemctl_is_active('netplan-wpa@*.service'): wpa_services.insert(0, 'netplan-wpa@*.service') utils.systemctl('stop', wpa_services, sync=sync) else: logging.debug('no netplan generated networkd configuration exists') if restart_nm: logging.debug('netplan generated NM configuration changed, restarting NM') if utils.nm_running(): # restarting NM does not cause new config to be applied, need to shut down devices first for device in devices: if device not in nm_ifaces: continue # do not touch this interface # ignore failures here -- some/many devices might not be managed by NM try: utils.nmcli(['device', 'disconnect', device]) except subprocess.CalledProcessError: pass utils.systemctl_network_manager('stop', sync=sync) else: logging.debug('no netplan generated NM configuration exists') # Refresh devices now; restarting a backend might have made something appear. devices = netifaces.interfaces() # evaluate config for extra steps we need to take (like renaming) # for now, only applies to non-virtual (real) devices. config_manager.parse() changes = NetplanApply.process_link_changes(devices, config_manager) # delete virtual interfaces that have been defined in a previous state # but are not configured anymore in the current YAML if self.state: cm = ConfigManager(self.state) cm.parse() # get previous configuration state prev_links = cm.virtual_interfaces.keys() curr_links = config_manager.virtual_interfaces.keys() NetplanApply.clear_virtual_links(prev_links, curr_links, devices) # if the interface is up, we can still apply some .link file changes # but we cannot apply the interface rename via udev, as it won't touch # the interface name, if it was already renamed once (e.g. during boot), # because of the NamePolicy=keep default: # https://www.freedesktop.org/software/systemd/man/systemd.net-naming-scheme.html devices = netifaces.interfaces() for device in devices: logging.debug('netplan triggering .link rules for %s', device) try: subprocess.check_call(['udevadm', 'test-builtin', 'net_setup_link', '/sys/class/net/' + device], stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL) subprocess.check_call(['udevadm', 'test', '/sys/class/net/' + device], stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL) except subprocess.CalledProcessError: logging.debug('Ignoring device without syspath: %s', device) devices_after_udev = netifaces.interfaces() # apply some more changes manually for iface, settings in changes.items(): # rename non-critical network interfaces new_name = settings.get('name') if new_name: if len(new_name) >= IF_NAMESIZE: logging.warning('Interface name {} is too long. {} will not be renamed'.format(new_name, iface)) continue if iface in devices and new_name in devices_after_udev: logging.debug('Interface rename {} -> {} already happened.'.format(iface, new_name)) continue # re-name already happened via 'udevadm test' # bring down the interface, using its current (matched) interface name subprocess.check_call(['ip', 'link', 'set', 'dev', iface, 'down'], stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL) # rename the interface to the name given via 'set-name' subprocess.check_call(['ip', 'link', 'set', 'dev', iface, 'name', settings.get('name')], stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL) # Reloading of udev rules happens during 'netplan generate' already # subprocess.check_call(['udevadm', 'control', '--reload-rules']) subprocess.check_call(['udevadm', 'trigger', '--attr-match=subsystem=net']) subprocess.check_call(['udevadm', 'settle']) # apply any SR-IOV related changes, if applicable NetplanApply.process_sriov_config(config_manager, exit_on_error) # (re)set global regulatory domain if os.path.exists('/run/systemd/system/netplan-regdom.service'): utils.systemctl('start', ['netplan-regdom.service']) # (re)start backends if restart_networkd: netplan_wpa = [os.path.basename(f) for f in glob.glob('/run/systemd/system/*.wants/netplan-wpa-*.service')] # exclude the special 'netplan-ovs-cleanup.service' unit netplan_ovs = [os.path.basename(f) for f in glob.glob('/run/systemd/system/*.wants/netplan-ovs-*.service') if not f.endswith('/' + OVS_CLEANUP_SERVICE)] # Run 'systemctl start' command synchronously, to avoid race conditions # with 'oneshot' systemd service units, e.g. netplan-ovs-*.service. try: utils.networkctl_reload() utils.networkctl_reconfigure(utils.networkd_interfaces()) except subprocess.CalledProcessError: # (re-)start systemd-networkd if it is not running, yet logging.warning('Falling back to a hard restart of systemd-networkd.service') utils.systemctl('restart', ['systemd-networkd.service'], sync=True) # 1st: execute OVS cleanup, to avoid races while applying OVS config utils.systemctl('start', [OVS_CLEANUP_SERVICE], sync=True) # 2nd: start all other services utils.systemctl('start', netplan_wpa + netplan_ovs, sync=True) if restart_nm: # Flush all IP addresses of NM managed interfaces, to avoid NM creating # new, non netplan-* connection profiles, using the existing IPs. for iface in utils.nm_interfaces(restart_nm_glob, devices): utils.ip_addr_flush(iface) # clear NM state, especially the [device].managed=true config, as that might have been # re-set via an udev rule setting "NM_UNMANAGED=1" shutil.rmtree('/run/NetworkManager/devices', ignore_errors=True) utils.systemctl_network_manager('start', sync=sync) if sync: # 'nmcli' could be /usr/bin/nmcli or # /snap/bin/nmcli -> /snap/bin/network-manager.nmcli cmd = ['nmcli', 'general', 'status'] # wait a bit for 'connected (site/local-only)' or # 'connected' to appear in 'nmcli general' STATE for _ in range(10): out = subprocess.run(cmd, capture_output=True, text=True) # Handle nmcli's "not running" return code (8) gracefully, # giving some more time for NetworkManager startup if out.returncode == 8: time.sleep(1) continue if '\nconnected' in str(out.stdout): break time.sleep(0.5) @staticmethod def is_composite_member(composites, phy): """ Is this physical interface a member of a 'composite' virtual interface? (bond, bridge) """ for composite in composites: for _, settings in composite.items(): if not type(settings) is dict: continue members = settings.get('interfaces', []) for iface in members: if iface == phy: return True return False @staticmethod def clear_virtual_links(prev_links, curr_links, devices=[]): """ Calculate the delta of virtual links. And remove the links that were dropped from the YAML config, if they were not dropped by the backend already. We can make use of the netplan netdef ids, as those equal the interface name for virtual links. """ if not devices: logging.warning('Cannot clear virtual links: no network interfaces provided.') return [] dropped_interfaces = list(set(prev_links) - set(curr_links)) # some interfaces might have been cleaned up already, e.g. by the # NetworkManager backend interfaces_to_clear = list(set(dropped_interfaces).intersection(devices)) for link in interfaces_to_clear: try: cmd = ['ip', 'link', 'delete', 'dev', link] subprocess.check_call(cmd) except subprocess.CalledProcessError: logging.warning('Could not delete interface {}'.format(link)) return dropped_interfaces @staticmethod def process_link_changes(interfaces, config_manager: ConfigManager): # pragma: nocover (covered in autopkgtest) """ Go through the pending changes and pick what needs special handling. Only applies to non-critical interfaces which can be safely updated. """ changes = {} composite_interfaces = [config_manager.bridges, config_manager.bonds] # Find physical interfaces which need a rename # But do not rename virtual interfaces for netdef in config_manager.physical_interfaces.values(): newname = netdef.set_name if not newname: continue # Skip if no new name needs to be set if not netdef.has_match: continue # Skip if no match for current name is given if NetplanApply.is_composite_member(composite_interfaces, netdef.id): logging.debug('Skipping composite member {}'.format(netdef.id)) # do not rename members of virtual devices. MAC addresses # may be the same for all interface members. continue # Find current name of the interface, according to match conditions and globs (name, mac, driver) current_iface_name = utils.find_matching_iface(interfaces, netdef) if not current_iface_name: logging.warning('Cannot find unique matching interface for {}'.format(netdef.id)) continue if current_iface_name == newname: # Skip interface if it already has the correct name logging.debug('Skipping correctly named interface: {}'.format(newname)) continue if netdef.critical: # Skip interfaces defined as critical, as we should not take them down in order to rename logging.warning('Cannot rename {} ({} -> {}) at runtime (needs reboot), due to being critical' .format(netdef.id, current_iface_name, newname)) continue # record the interface rename change changes[current_iface_name] = {'name': newname} logging.debug('Link changes: {}'.format(changes)) return changes @staticmethod def process_sriov_config(config_manager, exit_on_error=True): # pragma: nocover (covered in autopkgtest) try: apply_sriov_config(config_manager) except utils.config_errors as e: logging.error(str(e)) if exit_on_error: sys.exit(1) @staticmethod def process_ovs_cleanup(config_manager, ovs_old, ovs_current, exit_on_error=True): # pragma: nocover (autopkgtest) try: apply_ovs_cleanup(config_manager, ovs_old, ovs_current) except (OSError, RuntimeError) as e: logging.error(str(e)) if exit_on_error: sys.exit(1) except OvsDbServerNotRunning as e: logging.warning('Cannot call Open vSwitch: {}.'.format(e)) PK ! �2�9c c cli/commands/ip.pynu �[��� #!/usr/bin/python3 # # Copyright (C) 2018 Canonical, Ltd. # Author: Mathieu Trudel-Lapierre <mathieu.trudel-lapierre@canonical.com> # # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation; version 3. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty 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, see <http://www.gnu.org/licenses/>. '''netplan ip command line''' import logging import os import sys import subprocess from subprocess import CalledProcessError import netplan.cli.utils as utils lease_path = { 'networkd': { 'pattern': 'run/systemd/netif/leases/{lease_id}', 'method': 'ifindex', }, 'NetworkManager': { 'pattern': 'var/lib/NetworkManager/internal-{lease_id}-{interface}.lease', 'method': 'nm_connection', }, } class NetplanIp(utils.NetplanCommand): def __init__(self): super().__init__(command_id='ip', description='Retrieve IP information from the system', leaf=False) def run(self): self.command_leases = NetplanIpLeases() # subcommand: leases p_ip_leases = self.subparsers.add_parser('leases', help='Display IP leases', add_help=False) p_ip_leases.set_defaults(func=self.command_leases.run, commandclass=self.command_leases) self.parse_args() self.run_command() class NetplanIpLeases(utils.NetplanCommand): def __init__(self): super().__init__(command_id='ip leases', description='Display IP leases', leaf=True) def run(self): self.parser.add_argument('interface', help='Interface for which to display IP lease settings.') self.parser.add_argument('--root-dir', help='Search for configuration files in this root directory instead of /') self.func = self.command_ip_leases self.parse_args() self.run_command() def command_ip_leases(self): if self.interface == 'help': # pragma: nocover (covered in autopkgtest) self.print_usage() def find_lease_file(mapping): def lease_method_ifindex(): ifindex_f = os.path.join('/sys/class/net', self.interface, 'ifindex') try: with open(ifindex_f) as f: return f.readlines()[0].strip() except Exception as e: logging.debug('Cannot read file %s: %s', ifindex_f, str(e)) raise def lease_method_nm_connection(): # FIXME: handle older versions of NM where 'nmcli dev show' doesn't exist try: nmcli_dev_out = utils.nmcli_out(['dev', 'show', self.interface]) for line in nmcli_dev_out.splitlines(): if 'GENERAL.CONNECTION' in line: conn_id = line.split(':')[1].rstrip().strip() nmcli_con_out = utils.nmcli_out(['con', 'show', 'id', conn_id]) for line in nmcli_con_out.splitlines(): if 'connection.uuid' in line: return line.split(':')[1].rstrip().strip() except Exception as e: raise Exception('Could not find a NetworkManager connection for the interface: %s' % str(e)) raise Exception('Could not find a NetworkManager connection for the interface') lease_pattern = lease_path[mapping['backend']]['pattern'] lease_method = lease_path[mapping['backend']]['method'] try: lease_id = eval("lease_method_" + lease_method)() # We found something to build the path to the lease file with, # at this point we may have something to look at; but if not, # we'll rely on open() throwing an error. # This might happen if networkd doesn't use DHCP for the interface, # for instance. path = os.path.join('/', os.path.abspath(self.root_dir) if self.root_dir else "", lease_pattern.format(interface=self.interface, lease_id=lease_id)) # Fallback to 'dhclient' if no lease of NetworkManager's # internal DHCP client is found if not os.path.isfile(path): path = path.replace('NetworkManager/internal-', 'NetworkManager/dhclient-') with open(path) as f: for line in f.readlines(): print(line.rstrip()) except Exception as e: print("No lease found for interface '%s': %s" % (self.interface, str(e)), file=sys.stderr) sys.exit(1) argv = [utils.get_generator_path()] if self.root_dir: argv += ['--root-dir', self.root_dir] argv += ['--mapping', self.interface] # Extract out of the generator our mapping in a dict. logging.debug('command ip leases: running %s', argv) try: out = subprocess.check_output(argv, text=True) except CalledProcessError: # pragma: nocover (better be covered in autopkgtest) print("No lease found for interface '%s' (not managed by Netplan)" % self.interface, file=sys.stderr) sys.exit(1) mapping = {} mapping_s = out.split(',') for keyvalue in mapping_s: key, value = keyvalue.strip().split('=') mapping[key] = value find_lease_file(mapping) PK ! �E�� � cli/commands/info.pynu �[��� #!/usr/bin/python3 # # Copyright (C) 2019 Canonical, Ltd. # Author: Mathieu Trudel-Lapierre <mathieu.trudel-lapierre@canonical.com> # # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation; version 3. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty 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, see <http://www.gnu.org/licenses/>. '''netplan info command line''' import netplan.cli.utils as utils import netplan._features class NetplanInfo(utils.NetplanCommand): def __init__(self): super().__init__(command_id='info', description='Show available features', leaf=True) def run(self): # pragma: nocover (covered in autopkgtest) format_group = self.parser.add_mutually_exclusive_group(required=False) format_group.add_argument('--json', dest='version_format', action='store_const', const='json', help='Output version and features in JSON format') format_group.add_argument('--yaml', dest='version_format', action='store_const', const='yaml', help='Output version and features in YAML format') self.func = self.command_info self.parse_args() self.run_command() def command_info(self): netplan_version = { 'netplan.io': { 'website': 'https://netplan.io/', } } flags = netplan._features.NETPLAN_FEATURE_FLAGS netplan_version['netplan.io'].update({'features': flags}) # Default to output in YAML format. if self.version_format is None: self.version_format = 'yaml' if self.version_format == 'json': import json print(json.dumps(netplan_version, indent=2)) elif self.version_format == 'yaml': print('''netplan.io: website: "{}" features:'''.format(netplan_version['netplan.io']['website'])) for feature in netplan._features.NETPLAN_FEATURE_FLAGS: print(' - ' + feature) PK ! ��~��k �k cli/commands/status.pynu �[��� #!/usr/bin/python3 # # Copyright (C) 2022 Canonical, Ltd. # Author: Lukas Märdian <slyon@ubuntu.com> # # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation; version 3. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty 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, see <http://www.gnu.org/licenses/>. '''netplan status command line''' import ipaddress import json import logging import re import socket import subprocess import sys from typing import Union, Dict, List, Type import dbus import yaml import netplan.cli.utils as utils JSON = Union[Dict[str, 'JSON'], List['JSON'], int, str, float, bool, Type[None]] MATCH_TAGS = re.compile(r'\[([a-z0-9]+)\].*\[\/\1\]') RICH_OUTPUT = False try: from rich.console import Console from rich.highlighter import RegexHighlighter from rich.theme import Theme class NetplanHighlighter(RegexHighlighter): base_style = 'netplan.' highlights = [ r'(^|[\s\/])(?P<int>\d+)([\s:]?\s|$)', r'(?P<str>(\"|\').+(\"|\'))', ] RICH_OUTPUT = True except ImportError: # pragma: nocover (we mock RICH_OUTPUT, ignore the logging) logging.debug("python3-rich not found, falling back to plain output") class Interface(): def __extract_mac(self, ip: dict) -> str: ''' Extract the MAC address if it's set inside the JSON data and seems to have the correct format. Return 'None' otherwise. ''' if len(address := ip.get('address', '')) == 17: # 6 byte MAC (+5 colons) return address.lower() return None def __init__(self, ip: dict, nd_data: JSON = [], nm_data: JSON = [], resolved_data: tuple = (None, None), route_data: tuple = (None, None)): self.idx: int = ip.get('ifindex', -1) self.name: str = ip.get('ifname', 'unknown') self.adminstate: str = 'UP' if 'UP' in ip.get('flags', []) else 'DOWN' self.operstate: str = ip.get('operstate', 'unknown').upper() self.macaddress: str = self.__extract_mac(ip) # Filter networkd/NetworkManager data nm_data = nm_data or [] # avoid 'None' value on systems without NM self.nd: JSON = next((x for x in nd_data if x['Index'] == self.idx), None) self.nm: JSON = next((x for x in nm_data if x['device'] == self.name), None) # Filter resolved's DNS data self.dns_addresses: list = None if resolved_data[0]: self.dns_addresses = [] for itr in resolved_data[0]: if int(itr[0]) == int(self.idx): ipfamily = itr[1] dns = itr[2] self.dns_addresses.append(socket.inet_ntop(ipfamily, b''.join([v.to_bytes(1, 'big') for v in dns]))) self.dns_search: list = None if resolved_data[1]: self.dns_search = [] for v in resolved_data[1]: if int(v[0]) == int(self.idx): self.dns_search.append(str(v[1])) # Filter route data _routes: list = [] self.routes: list = None if route_data[0]: _routes += route_data[0] if route_data[1]: _routes += route_data[1] if _routes: self.routes = [] for obj in _routes: if obj.get('dev') == self.name: elem = {'to': obj.get('dst')} val = obj.get('gateway') if val: elem['via'] = val val = obj.get('prefsrc') if val: elem['from'] = val val = obj.get('metric') if val: elem['metric'] = val val = obj.get('type') if val: elem['type'] = val val = obj.get('scope') if val: elem['scope'] = val val = obj.get('protocol') if val: elem['protocol'] = val self.routes.append(elem) self.addresses: list = None if addr_info := ip.get('addr_info'): self.addresses = [] for addr in addr_info: flags: list = [] if ipaddress.ip_address(addr['local']).is_link_local: flags.append('link') if self.routes: for route in self.routes: if ('from' in route and ipaddress.ip_address(route['from']) == ipaddress.ip_address(addr['local'])): if route['protocol'] == 'dhcp': flags.append('dhcp') break ip_addr = addr['local'].lower() elem = {ip_addr: {'prefix': addr['prefixlen']}} if flags: elem[ip_addr]['flags'] = flags self.addresses.append(elem) self.iproute_type: str = None if info_kind := ip.get('linkinfo', {}).get('info_kind'): self.iproute_type = info_kind.strip() # workaround: query some data which is not available via networkctl's JSON output self._networkctl: str = self.query_networkctl(self.name) or '' def query_nm_ssid(self, con_name: str) -> str: ssid: str = None try: ssid = utils.nmcli_out(['--get-values', '802-11-wireless.ssid', 'con', 'show', 'id', con_name]) return ssid.strip() except Exception as e: logging.warning('Cannot query NetworkManager SSID for {}: {}'.format( con_name, str(e))) return ssid def query_networkctl(self, ifname: str) -> str: output: str = None try: output = subprocess.check_output(['networkctl', 'status', '--', ifname], text=True) except Exception as e: logging.warning('Cannot query networkctl for {}: {}'.format( ifname, str(e))) return output def json(self) -> JSON: json = { 'index': self.idx, 'adminstate': self.adminstate, 'operstate': self.operstate, } if self.type: json['type'] = self.type if self.ssid: json['ssid'] = self.ssid if self.tunnel_mode: json['tunnel_mode'] = self.tunnel_mode if self.backend: json['backend'] = self.backend if self.netdef_id: json['id'] = self.netdef_id if self.macaddress: json['macaddress'] = self.macaddress if self.vendor: json['vendor'] = self.vendor if self.addresses: json['addresses'] = self.addresses if self.dns_addresses: json['dns_addresses'] = self.dns_addresses if self.dns_search: json['dns_search'] = self.dns_search if self.routes: json['routes'] = self.routes if self.activation_mode: json['activation_mode'] = self.activation_mode return (self.name, json) @property def up(self) -> bool: return self.adminstate == 'UP' and self.operstate == 'UP' @property def down(self) -> bool: return self.adminstate == 'DOWN' and self.operstate == 'DOWN' @property def type(self) -> str: match = dict({ 'bond': 'bond', 'bridge': 'bridge', 'ether': 'ethernet', 'ipgre': 'tunnel', 'ip6gre': 'tunnel', 'loopback': 'ethernet', 'sit': 'tunnel', 'tunnel': 'tunnel', 'tunnel6': 'tunnel', 'wireguard': 'tunnel', 'wlan': 'wifi', 'wwan': 'modem', 'vrf': 'vrf', 'vxlan': 'tunnel', }) nd_type = self.nd.get('Type') if self.nd else None if nd_type in match: return match[nd_type] logging.warning('Unknown device type: {}'.format(nd_type)) return None @property def tunnel_mode(self) -> str: if self.type == 'tunnel' and self.iproute_type: return self.iproute_type return None @property def backend(self) -> str: if (self.nd and 'unmanaged' not in self.nd.get('SetupState', '') and 'run/systemd/network/10-netplan-' in self.nd.get('NetworkFile', '')): return 'networkd' elif self.nm and 'run/NetworkManager/system-connections/netplan-' in self.nm.get('filename', ''): return 'NetworkManager' return None @property def netdef_id(self) -> str: if self.backend == 'networkd': return self.nd.get('NetworkFile', '').split( 'run/systemd/network/10-netplan-')[1].split('.network')[0] elif self.backend == 'NetworkManager': netdef = self.nm.get('filename', '').split( 'run/NetworkManager/system-connections/netplan-')[1].split('.nmconnection')[0] if self.nm.get('type', '') == '802-11-wireless': ssid = self.query_nm_ssid(self.nm.get('name')) if ssid: # XXX: escaping needed? netdef = netdef.split('-' + ssid)[0] return netdef return None @property def vendor(self) -> str: if self.nd and 'Vendor' in self.nd and self.nd['Vendor']: return self.nd['Vendor'].strip() return None @property def ssid(self) -> str: if self.type == 'wifi': # XXX: available from networkctl's JSON output as of v250: # https://github.com/systemd/systemd/commit/da7c995 for line in self._networkctl.splitlines(): line = line.strip() key = 'WiFi access point: ' if line.startswith(key): ssid = line[len(key):-len(' (xB:SS:ID:xx:xx:xx)')].strip() return ssid if ssid else None return None @property def activation_mode(self) -> str: if self.backend == 'networkd': # XXX: available from networkctl's JSON output as of v250: # https://github.com/systemd/systemd/commit/3b60ede for line in self._networkctl.splitlines(): line = line.strip() key = 'Activation Policy: ' if line.startswith(key): mode = line[len(key):].strip() return mode if mode != 'up' else None # XXX: this is not fully supported on NetworkManager, only 'manual'/'up' elif self.backend == 'NetworkManager': return 'manual' if self.nm['autoconnect'] == 'no' else None return None class NetplanStatus(utils.NetplanCommand): def __init__(self): super().__init__(command_id='status', description='Query networking state of the running system', leaf=True) self.all = False def run(self): self.parser.add_argument('ifname', nargs='?', type=str, default=None, help='Show only this interface') self.parser.add_argument('-a', '--all', action='store_true', help='Show all interface data (incl. inactive)') self.parser.add_argument('-f', '--format', default='tabular', help='Output in machine readable `json` or `yaml` format') self.func = self.command self.parse_args() self.run_command() def resolvconf_json(self) -> dict: res = { 'addresses': [], 'search': [], 'mode': None, } try: with open('/etc/resolv.conf') as f: # check first line for systemd-resolved stub or compat modes firstline = f.readline() if '# This is /run/systemd/resolve/stub-resolv.conf' in firstline: res['mode'] = 'stub' elif '# This is /run/systemd/resolve/resolv.conf' in firstline: res['mode'] = 'compat' for line in [firstline] + f.readlines(): if line.startswith('nameserver'): res['addresses'] += line.split()[1:] # append if line.startswith('search'): res['search'] = line.split()[1:] # override except Exception as e: logging.warning('Cannot parse /etc/resolv.conf: {}'.format(str(e))) return res def query_online_state(self, interfaces: list) -> bool: # TODO: fully implement network-online.target specification (FO020): # https://discourse.ubuntu.com/t/spec-definition-of-an-online-system/27838 for itf in interfaces: if itf.up and itf.addresses and itf.routes and itf.dns_addresses: non_local_ips = [] for addr in itf.addresses: ip, extra = list(addr.items())[0] if 'flags' not in extra or 'link' not in extra['flags']: non_local_ips.append(ip) default_routes = [x for x in itf.routes if x.get('to', None) == 'default'] if non_local_ips and default_routes and itf.dns_addresses: return True return False def process_generic(self, cmd_output: str) -> JSON: return json.loads(cmd_output) def query_iproute2(self) -> JSON: data: JSON = None try: output: str = subprocess.check_output(['ip', '-d', '-j', 'addr'], text=True) data = self.process_generic(output) except Exception as e: logging.critical('Cannot query iproute2 interface data: {}'.format(str(e))) return data def process_networkd(self, cmd_output) -> JSON: return json.loads(cmd_output)['Interfaces'] def query_networkd(self) -> JSON: data: JSON = None try: output: str = subprocess.check_output(['networkctl', '--json=short'], text=True) data = self.process_networkd(output) except Exception as e: logging.critical('Cannot query networkd interface data: {}'.format(str(e))) return data def process_nm(self, cmd_output) -> JSON: data: JSON = [] for line in cmd_output.splitlines(): split = line.split(':') dev = split[0] if split[0] else None if dev: # ignore inactive connection profiles data.append({ 'device': dev, 'name': split[1], 'uuid': split[2], 'filename': split[3], 'type': split[4], 'autoconnect': split[5], }) return data def query_nm(self) -> JSON: data: JSON = None try: output: str = utils.nmcli_out(['-t', '-f', 'DEVICE,NAME,UUID,FILENAME,TYPE,AUTOCONNECT', 'con', 'show']) data = self.process_nm(output) except Exception as e: logging.debug('Cannot query NetworkManager interface data: {}'.format(str(e))) return data def query_routes(self) -> tuple: data4 = None data6 = None try: output4: str = subprocess.check_output(['ip', '-d', '-j', 'route'], text=True) data4: JSON = self.process_generic(output4) output6: str = subprocess.check_output(['ip', '-d', '-j', '-6', 'route'], text=True) data6: JSON = self.process_generic(output6) except Exception as e: logging.debug('Cannot query iproute2 route data: {}'.format(str(e))) return (data4, data6) def query_resolved(self) -> tuple: addresses = None search = None try: ipc = dbus.SystemBus() resolve1 = ipc.get_object('org.freedesktop.resolve1', '/org/freedesktop/resolve1') resolve1_if = dbus.Interface(resolve1, 'org.freedesktop.DBus.Properties') res = resolve1_if.GetAll('org.freedesktop.resolve1.Manager') addresses = res['DNS'] search = res['Domains'] except Exception as e: logging.debug('Cannot query resolved DNS data: {}'.format(str(e))) return (addresses, search) def plain_print(self, *args, **kwargs): if len(args): lst = list(args) for tag in MATCH_TAGS.findall(lst[0]): # remove matching opening and closing tag lst[0] = lst[0].replace('[{}]'.format(tag), '')\ .replace('[/{}]'.format(tag), '') return print(*lst, **kwargs) return print(*args, **kwargs) def pretty_print(self, data: JSON, total: int, _console_width=None) -> None: if RICH_OUTPUT: # TODO: Use a proper (subiquity?) color palette theme = Theme({ 'netplan.int': 'bold cyan', 'netplan.str': 'yellow', 'muted': 'grey62', 'online': 'green bold', 'offline': 'red bold', 'unknown': 'yellow bold', 'highlight': 'bold' }) console = Console(highlighter=NetplanHighlighter(), theme=theme, width=_console_width, emoji=False) pprint = console.print else: pprint = self.plain_print pad = '18' global_state = data.get('netplan-global-state', {}) interfaces = [(key, data[key]) for key in data if key != 'netplan-global-state'] # Global state pprint(('{title:>'+pad+'} {value}').format( title='Online state:', value='[online]online[/online]' if global_state.get('online', False) else '[offline]offline[/offline]', )) ns = global_state.get('nameservers', {}) dns_addr: list = ns.get('addresses', []) dns_mode: str = ns.get('mode') dns_search: list = ns.get('search', []) if dns_addr: for i, val in enumerate(dns_addr): pprint(('{title:>'+pad+'} {value}[muted]{mode}[/muted]').format( title='DNS Addresses:' if i == 0 else '', value=val, mode=' ({})'.format(dns_mode) if dns_mode else '', )) if dns_search: for i, val in enumerate(dns_search): pprint(('{title:>'+pad+'} {value}').format( title='DNS Search:' if i == 0 else '', value=val, )) pprint() # Per interface for (ifname, data) in interfaces: state = data.get('operstate', 'UNKNOWN') + '/' + data.get('adminstate', 'UNKNOWN') scolor = 'unknown' if state == 'UP/UP': state = 'UP' scolor = 'online' elif state == 'DOWN/DOWN': state = 'DOWN' scolor = 'offline' full_type = data.get('type', 'other') ssid = data.get('ssid') tunnel_mode = data.get('tunnel_mode') if full_type == 'wifi' and ssid: full_type += ('/"' + ssid + '"') elif full_type == 'tunnel' and tunnel_mode: full_type += ('/' + tunnel_mode) pprint('[{col}]●[/{col}] {idx:>2}: {name} {type} [{col}]{state}[/{col}] ({backend}{netdef})'.format( col=scolor, idx=data.get('index', '?'), name=ifname, type=full_type, state=state, backend=data.get('backend', 'unmanaged'), netdef=': [highlight]{}[/highlight]'.format(data.get('id')) if data.get('id') else '' )) if data.get('macaddress'): pprint(('{title:>'+pad+'} {mac}[muted]{vendor}[/muted]').format( title='MAC Address:', mac=data.get('macaddress', ''), vendor=' ({})'.format(data.get('vendor', '')) if data.get('vendor') else '', )) lst: list = data.get('addresses', []) if lst: for i, obj in enumerate(lst): ip, extra = list(obj.items())[0] # get first (any only) address flags = [] if extra.get('flags'): # flags flags = extra.get('flags', []) highlight_start = '' highlight_end = '' if not flags or 'dhcp' in flags: highlight_start = '[highlight]' highlight_end = '[/highlight]' pprint(('{title:>'+pad+'} {start}{ip}/{prefix}{end}[muted]{extra}[/muted]').format( title='Addresses:' if i == 0 else '', ip=ip, prefix=extra.get('prefix', ''), extra=' ('+', '.join(flags)+')' if flags else '', start=highlight_start, end=highlight_end, )) lst = data.get('dns_addresses', []) if lst: for i, val in enumerate(lst): pprint(('{title:>'+pad+'} {value}').format( title='DNS Addresses:' if i == 0 else '', value=val, )) lst = data.get('dns_search', []) if lst: for i, val in enumerate(lst): pprint(('{title:>'+pad+'} {value}').format( title='DNS Search:' if i == 0 else '', value=val, )) lst = data.get('routes', []) if lst: for i, obj in enumerate(lst): default_start = '' default_end = '' if obj['to'] == 'default': default_start = '[highlight]' default_end = '[/highlight]' via = '' if 'via' in obj: via = ' via ' + obj['via'] src = '' if 'from' in obj: src = ' from ' + obj['from'] metric = '' if 'metric' in obj: metric = ' metric ' + str(obj['metric']) extra = [] if 'protocol' in obj and obj['protocol'] != 'kernel': proto = obj['protocol'] extra.append(proto) if 'scope' in obj and obj['scope'] != 'global': scope = obj['scope'] extra.append(scope) if 'type' in obj and obj['type'] != 'unicast': type = obj['type'] extra.append(type) pprint(('{title:>'+pad+'} {start}{to}{via}{src}{metric}{end}[muted]{extra}[/muted]').format( title='Routes:' if i == 0 else '', to=obj['to'], via=via, src=src, metric=metric, extra=' ('+', '.join(extra)+')' if extra else '', start=default_start, end=default_end)) val = data.get('activation_mode') if val: pprint(('{title:>'+pad+'} {value}').format( title='Activation Mode:', value=val, )) pprint() hidden = total - len(interfaces) if (hidden > 0): pprint('{} inactive interfaces hidden. Use "--all" to show all.'.format(hidden)) def command(self): # Make sure sd-networkd is running, as we need the data it provides. if not utils.systemctl_is_active('systemd-networkd.service'): if utils.systemctl_is_masked('systemd-networkd.service'): logging.error('\'netplan status\' depends on networkd, ' 'but systemd-networkd.service is masked. ' 'Please start it.') sys.exit(1) logging.debug('systemd-networkd.service is not active. Starting...') utils.systemctl('start', ['systemd-networkd.service'], True) # required data: iproute2 and sd-networkd can be expected to exist, # due to hard package dependencies iproute2 = self.query_iproute2() networkd = self.query_networkd() if not iproute2 or not networkd: logging.error('Could not query iproute2 or systemd-networkd') sys.exit(1) # optional data nmcli = self.query_nm() route4, route6 = self.query_routes() dns_addresses, dns_search = self.query_resolved() interfaces = [Interface(itf, networkd, nmcli, (dns_addresses, dns_search), (route4, route6)) for itf in iproute2] total = len(interfaces) # show only active interfaces by default filtered = [itf for itf in interfaces if itf.operstate != 'DOWN'] # down interfaces do not contribute anything to the online state online_state = self.query_online_state(filtered) # show only a single interface, if requested # XXX: bash completion (for interfaces names) if self.ifname: filtered = [next((itf for itf in interfaces if itf.name == self.ifname), None)] filtered = [elem for elem in filtered if elem is not None] if self.ifname and filtered == []: logging.error('Could not find interface {}'.format(self.ifname)) sys.exit(1) # Global state data = { 'netplan-global-state': { 'online': online_state, 'nameservers': self.resolvconf_json() } } # Per interface itf_iter = interfaces if self.all else filtered for itf in itf_iter: ifname, obj = itf.json() data[ifname] = obj # Output data in requested format output_format = self.format.lower() if output_format == 'json': # structural JSON output print(json.dumps(data, indent=None)) elif output_format == 'yaml': # stuctural YAML output print(yaml.dump(data, default_flow_style=False)) else: # pretty print, human readable output self.pretty_print(data, total) PK ! I��O �O cli/commands/migrate.pynu �[��� #!/usr/bin/python3 # # Copyright (C) 2018 Canonical, Ltd. # Author: Mathieu Trudel-Lapierre <mathieu.trudel-lapierre@canonical.com> # # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation; version 3. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty 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, see <http://www.gnu.org/licenses/>. '''netplan migrate command line''' import logging import os import sys import re from glob import glob try: import yaml NO_YAML = False except ImportError: # pragma: nocover NO_YAML = True from collections import OrderedDict import ipaddress import netplan.cli.utils as utils class NetplanMigrate(utils.NetplanCommand): def __init__(self): super().__init__(command_id='migrate', description='Migration of /etc/network/interfaces to netplan', leaf=True, testing=True) def parse_dns_options(self, if_options, if_config): """Parse dns options (dns-nameservers and dns-search) from if_options (an interface options dict) into the interface configuration if_config Mutates the arguments in place. """ if 'dns-nameservers' in if_options: if 'nameservers' not in if_config: if_config['nameservers'] = {} if 'addresses' not in if_config['nameservers']: if_config['nameservers']['addresses'] = [] for ns in if_options['dns-nameservers'].split(' '): # allow multiple spaces in the dns-nameservers entry if not ns: continue # validate? if_config['nameservers']['addresses'] += [ns] del if_options['dns-nameservers'] if 'dns-search' in if_options: if 'nameservers' not in if_config: if_config['nameservers'] = {} if 'search' not in if_config['nameservers']: if_config['nameservers']['search'] = [] for domain in if_options['dns-search'].split(' '): # allow multiple spaces in the dns-search entry if not domain: continue if_config['nameservers']['search'] += [domain] del if_options['dns-search'] def parse_mtu(self, iface, if_options, if_config): """Parse out the MTU. Operates the same way as parse_dns_options iface is the name of the interface, used only to print error messages """ if 'mtu' in if_options: try: mtu = int(if_options['mtu']) except ValueError: logging.error('%s: cannot parse "%s" as an MTU', iface, if_options['mtu']) sys.exit(2) if 'mtu' in if_config and not if_config['mtu'] == mtu: logging.error('%s: tried to set MTU=%d, but already have MTU=%d', iface, mtu, if_config['mtu']) sys.exit(2) if_config['mtu'] = mtu del if_options['mtu'] def parse_hwaddress(self, iface, if_options, if_config): """Parse out the manually configured MAC. Operates the same way as parse_dns_options iface is the name of the interface, used only to print error messages """ if 'hwaddress' in if_options: if 'macaddress' in if_config and not if_config['macaddress'] == if_options['hwaddress']: logging.error('%s: tried to set MAC %s, but already have MAC %s', iface, if_options['hwaddress'], if_config['macaddress']) sys.exit(2) if_config['macaddress'] = if_options['hwaddress'] del if_options['hwaddress'] def run(self): self.parser.add_argument('--root-dir', help='Search for and generate configuration files in this root directory instead of /') self.parser.add_argument('--dry-run', action='store_true', help='Print converted netplan configuration to stdout instead of writing/changing files') self.func = self.command_migrate self.parse_args() if NO_YAML: # pragma: nocover logging.error("""The `yaml` Python package couldn't be imported, and is needed for the migrate command. To install it on Debian or Ubuntu-based system, run `apt install python3-yaml`""") sys.exit(1) self.run_command() def command_migrate(self): netplan_config = {} try: ifaces, auto_ifaces = self.parse_ifupdown(self.root_dir or '') except ValueError as e: logging.error(str(e)) sys.exit(2) for iface, family_config in ifaces.items(): for family, config in family_config.items(): logging.debug('Converting %s family %s %s', iface, family, config) if iface not in auto_ifaces: logging.error('%s: non-automatic interfaces are not supported', iface) sys.exit(2) if config['method'] == 'loopback': # both systemd and modern ifupdown set up lo automatically logging.debug('Ignoring loopback interface %s', iface) elif config['method'] == 'dhcp': c = netplan_config.setdefault('network', {}).setdefault('ethernets', {}).setdefault(iface, {}) self.parse_dns_options(config['options'], c) self.parse_hwaddress(iface, config['options'], c) if config['options']: logging.error('%s: option(s) %s are not supported for dhcp method', iface, ", ".join(config['options'].keys())) sys.exit(2) if family == 'inet': c['dhcp4'] = True else: assert family == 'inet6' c['dhcp6'] = True elif config['method'] == 'static': c = netplan_config.setdefault('network', {}).setdefault('ethernets', {}).setdefault(iface, {}) if 'addresses' not in c: c['addresses'] = [] self.parse_dns_options(config['options'], c) self.parse_mtu(iface, config['options'], c) self.parse_hwaddress(iface, config['options'], c) # ipv4 if family == 'inet': # Already handled: mtu, hwaddress # Supported: address netmask gateway # Not supported yet: metric(?) # No YAML support: pointopoint scope broadcast supported_opts = set(['address', 'netmask', 'gateway']) unsupported_opts = set(['broadcast', 'metric', 'pointopoint', 'scope']) opts = set(config['options'].keys()) bad_opts = opts - supported_opts if bad_opts: for unsupported in bad_opts.intersection(unsupported_opts): logging.error('%s: unsupported %s option "%s"', iface, family, unsupported) sys.exit(2) for unknown in bad_opts - unsupported_opts: logging.error('%s: unknown %s option "%s"', iface, family, unknown) sys.exit(2) # the address may contain a /prefix suffix, or # the netmask property may be used. It's not clear # what happens if both are supplied. if 'address' not in config['options']: logging.error('%s: no address supplied in static method', iface) sys.exit(2) if '/' in config['options']['address']: addr_spec = config['options']['address'].split('/')[0] net_spec = config['options']['address'] else: if 'netmask' not in config['options']: logging.error('%s: address does not specify prefix length, and netmask not specified', iface) sys.exit(2) addr_spec = config['options']['address'] net_spec = config['options']['address'] + '/' + config['options']['netmask'] try: ipaddr = ipaddress.IPv4Address(addr_spec) except ipaddress.AddressValueError as a: logging.error('%s: error parsing "%s" as an IPv4 address: %s', iface, addr_spec, a) sys.exit(2) try: ipnet = ipaddress.IPv4Network(net_spec, strict=False) except ipaddress.NetmaskValueError as a: logging.error('%s: error parsing "%s" as an IPv4 network: %s', iface, net_spec, a) sys.exit(2) c['addresses'] += [str(ipaddr) + '/' + str(ipnet.prefixlen)] if 'gateway' in config['options']: # validate? c['gateway4'] = config['options']['gateway'] # ipv6 else: assert family == 'inet6' # Already handled: mtu, hwaddress # supported: address netmask gateway # partially supported: accept_ra (0/1 supported, 2 has no YAML rep) # unsupported: metric(?) # no YAML representation: media autoconf privext scope # preferred-lifetime dad-attempts dad-interval supported_opts = set(['address', 'netmask', 'gateway', 'accept_ra']) unsupported_opts = set(['metric', 'media', 'autoconf', 'privext', 'scope', 'preferred-lifetime', 'dad-attempts', 'dad-interval']) opts = set(config['options'].keys()) bad_opts = opts - supported_opts if bad_opts: for unsupported in bad_opts.intersection(unsupported_opts): logging.error('%s: unsupported %s option "%s"', iface, family, unsupported) sys.exit(2) for unknown in bad_opts - unsupported_opts: logging.error('%s: unknown %s option "%s"', iface, family, unknown) sys.exit(2) # the address may contain a /prefix suffix, or # the netmask property may be used. It's not clear # what happens if both are supplied. if 'address' not in config['options']: logging.error('%s: no address supplied in static method', iface) sys.exit(2) if '/' in config['options']['address']: addr_spec = config['options']['address'].split('/')[0] net_spec = config['options']['address'] else: if 'netmask' not in config['options']: logging.error('%s: address does not specify prefix length, and netmask not specified', iface) sys.exit(2) addr_spec = config['options']['address'] net_spec = config['options']['address'] + '/' + config['options']['netmask'] try: ipaddr = ipaddress.IPv6Address(addr_spec) except ipaddress.AddressValueError as a: logging.error('%s: error parsing "%s" as an IPv6 address: %s', iface, addr_spec, a) sys.exit(2) try: ipnet = ipaddress.IPv6Network(net_spec, strict=False) except ipaddress.NetmaskValueError as a: logging.error('%s: error parsing "%s" as an IPv6 network: %s', iface, net_spec, a) sys.exit(2) c['addresses'] += [str(ipaddr) + '/' + str(ipnet.prefixlen)] if 'gateway' in config['options']: # validate? c['gateway6'] = config['options']['gateway'] if 'accept_ra' in config['options']: if config['options']['accept_ra'] == '0': c['accept_ra'] = False elif config['options']['accept_ra'] == '1': c['accept_ra'] = True elif config['options']['accept_ra'] == '2': logging.error('%s: netplan does not support accept_ra=2', iface) sys.exit(2) else: logging.error('%s: unexpected accept_ra value "%s"', iface, config['options']['accept_ra']) sys.exit(2) else: # pragma nocover # this should be unreachable logging.error('%s: method %s is not supported', iface, config['method']) sys.exit(2) if_config = os.path.join(self.root_dir or '/', 'etc/network/interfaces') if netplan_config: netplan_config['network']['version'] = 2 netplan_yaml = yaml.dump(netplan_config) if self.dry_run: print(netplan_yaml) else: dest = os.path.join(self.root_dir or '/', 'etc/netplan/10-ifupdown.yaml') try: os.makedirs(os.path.dirname(dest)) except FileExistsError: pass try: with open(dest, 'x') as f: f.write(netplan_yaml) except FileExistsError: logging.error('%s already exists; remove it if you want to run the migration again', dest) sys.exit(3) logging.info('migration complete, wrote %s', dest) else: logging.warning('ifupdown does not configure any interfaces, nothing to migrate') if not self.dry_run: logging.info('renaming %s to %s.netplan-converted', if_config, if_config) os.rename(if_config, if_config + '.netplan-converted') def _ifupdown_lines_from_file(self, rootdir, path): '''Return normalized lines from ifupdown config This resolves "source" and "source-directory" includes. ''' def expand_source_arg(rootdir, curdir, line): arg = line.split()[1] if arg.startswith('/'): return rootdir + arg else: return curdir + '/' + arg lines = [] rootdir_len = len(rootdir) + 1 try: with open(rootdir + '/' + path) as f: logging.debug('reading %s', f.name) for line in f: # normalize, strip empty lines and comments line = line.strip() if not line or line.startswith('#'): continue if line.startswith('source-directory '): valid_re = re.compile('^[a-zA-Z0-9_-]+$') d = expand_source_arg(rootdir, os.path.dirname(f.name), line) for f in os.listdir(d): if valid_re.match(f): lines += self._ifupdown_lines_from_file(rootdir, os.path.join(d[rootdir_len:], f)) elif line.startswith('source '): for f in glob(expand_source_arg(rootdir, os.path.dirname(f.name), line)): lines += self._ifupdown_lines_from_file(rootdir, f[rootdir_len:]) else: lines.append(line) except FileNotFoundError: logging.debug('%s/%s does not exist, ignoring', rootdir, path) return lines def parse_ifupdown(self, rootdir='/'): '''Parse ifupdown configuration. Return (iface_name → family → {method, options}, auto_ifaces: set) tuple on successful parsing, or a ValueError when encountering an invalid file or ifupdown features which are not supported (such as "mapping"). options is itself a dictionary option_name → value. ''' # expected number of fields for every possible keyword, excluding the keyword itself fieldlen = {'auto': 1, 'allow-auto': 1, 'allow-hotplug': 1, 'mapping': 1, 'no-scripts': 1, 'iface': 3} # read and normalize all lines from config, with resolving includes lines = self._ifupdown_lines_from_file(rootdir, '/etc/network/interfaces') ifaces = OrderedDict() auto = set() in_options = None # interface name if parsing options lines after iface stanza in_family = None # we now have resolved all includes and normalized lines for line in lines: fields = line.split() try: # does the line start with a known stanza field? exp_len = fieldlen[fields[0]] logging.debug('line fields %s (expected length: %i)', fields, exp_len) in_options = None # stop option line parsing of iface stanza in_family = None except KeyError: # no known stanza field, are we in an iface stanza and parsing options? if in_options: logging.debug('in_options %s, parsing as option: %s', in_options, line) ifaces[in_options][in_family]['options'][fields[0]] = line.split(maxsplit=1)[1] continue else: raise ValueError('Unknown stanza type %s' % fields[0]) # do we have the expected #parameters? if len(fields) != exp_len + 1: raise ValueError('Expected %i fields for stanza type %s but got %i' % (exp_len, fields[0], len(fields) - 1)) # we have a valid stanza line now, handle them if fields[0] in ('auto', 'allow-auto', 'allow-hotplug'): auto.add(fields[1]) elif fields[0] == 'mapping': raise ValueError('mapping stanza is not supported') elif fields[0] == 'no-scripts': pass # ignore these elif fields[0] == 'iface': if fields[2] not in ('inet', 'inet6'): raise ValueError('Unknown address family %s' % fields[2]) if fields[3] not in ('loopback', 'static', 'dhcp'): raise ValueError('Unsupported method %s' % fields[3]) in_options = fields[1] in_family = fields[2] ifaces.setdefault(fields[1], OrderedDict())[in_family] = {'method': fields[3], 'options': {}} else: raise NotImplementedError('stanza type %s is not implemented' % fields[0]) # pragma nocover logging.debug('final parsed interfaces: %s; auto ifaces: %s', ifaces, auto) return (ifaces, auto) PK ! Fﱗ� � cli/commands/__init__.pynu �[��� #!/usr/bin/python3 # # Copyright (C) 2018 Canonical, Ltd. # Author: Mathieu Trudel-Lapierre <mathieu.trudel-lapierre@canonical.com> # # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation; version 3. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty 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, see <http://www.gnu.org/licenses/>. from netplan.cli.commands.apply import NetplanApply from netplan.cli.commands.generate import NetplanGenerate from netplan.cli.commands.ip import NetplanIp from netplan.cli.commands.migrate import NetplanMigrate from netplan.cli.commands.try_command import NetplanTry from netplan.cli.commands.info import NetplanInfo from netplan.cli.commands.set import NetplanSet from netplan.cli.commands.get import NetplanGet from netplan.cli.commands.sriov_rebind import NetplanSriovRebind from netplan.cli.commands.status import NetplanStatus __all__ = [ 'NetplanApply', 'NetplanGenerate', 'NetplanIp', 'NetplanMigrate', 'NetplanTry', 'NetplanInfo', 'NetplanSet', 'NetplanGet', 'NetplanSriovRebind', 'NetplanStatus', ] PK ! ��6 & & . cli/commands/__pycache__/apply.cpython-310.pycnu �[��� o � ed�O � @ s� d Z ddlZddlZddlZddlZddlZddlZddlZddlZddl m m Z ddl m Z mZ ddlmZ ddlmZmZ dZdZG dd � d e j�ZdS ) znetplan apply command line� N)� ConfigManager�ConfigurationError)�apply_sriov_config)�OvsDbServerNotRunning�apply_ovs_cleanupznetplan-ovs-cleanup.service� c sx e Zd Z� fdd�Zdd� Zddd �Zed d � �Zeg fd d ��Zede fdd��Z eddd��Z eddd��Z � Z S )� NetplanApplyc s( t � jdddd� d| _d| _d | _d S )N�applyz.Apply current netplan config to running systemT)� command_id� description�leafF)�super�__init__� sriov_only�only_ovs_cleanup�state��self�� __class__� �0/usr/share/netplan/netplan/cli/commands/apply.pyr , s � zNetplanApply.__init__c C sP | j jdddd� | j jdddd� | j jddd � | j| _| �� | �� d S ) Nz --sriov-only� store_truez0Only apply SR-IOV related configuration and exit)�action�helpz--only-ovs-cleanupz1Only clean up old OpenVSwitch interfaces and exitz--statez0Directory containing previous YAML configuration)r )�parser� add_argument� command_apply�func� parse_args� run_commandr r r r �run4 s � �� zNetplanApply.runTFNc & C s t � }|r|| _| jrt�||� d S | jr t�|dd|� d S dtjv r[t � d�}|d u r2t d��t � |ddddd dd g�}|d krY|rKt�|� n|d krStd ��t d| ��d S d}tt�d��} t�d�} || v rr| �|� t| �} t�d�} t�| t�� �} t| �}g }d }dtjv r�|�ddg� t j}|�t�� � |r�t j ||d�d kr�|r�t�tj � nt d��t�� }tt�d��}|s�| r�d}t�d�}||v r�|�|� t|�}|s�| r�d}t�d�}| � t�||�� t|�}|s�|r�d}|�rt� � |�r)t �!d� t�|| ||� dg}t�"d��r |�#d d� tj$d ||d � nt �!d � |�rft �!d � t�%� �re|D ] }|| v�rF�q=z t�&d d!|g� W �q= t j'�y] Y �q=w tj(d |d � nt �!d"� t�� }|�)� t�*||�}| j�r�t | j�}|�)� |j+�,� }|j+�,� } t�-|| |� t�� }|D ]<}t �!d#|� z"t j.d$d%d&d'| gt j/t j/d(� t j.d$d)d'| gt j/t j/d(� W �q� t j'�y� t �!d*|� Y �q�w t�� } |�0� D ]X\} } | �1d+�} | �r9t2| �t3k�r t �4d,�5| | �� �q�| |v �r| | v �rt �!d-�5| | �� �q�t j.d.d/d0d1| d2gt j/t j/d(� t j.d.d/d0d1| d+| �1d+�gt j/t j/d(� �q�t �.g d3�� t �.d$d4g� t�||� tj6�7d5��r]t�$d6d7g� |�r�d8d9� t�d:�D �}!d;d9� t�d<�D �}"z t�8� t�9t�:� � W n t j'�y� t �4d=� tj$d>d?gdd � Y nw tj$d6t;gdd � tj$d6|!|" dd � |�rt�||�D ]} t�<| � �q�t j=d@ddA� tj(d6|d � |�rg dB�}#t>dC�D ],}$t j?|#dddD�}%|%j@dEk�r�tA�BdF� �q�dGtC|%jD�v �r� d S tA�BdH� �q�d S d S d S )INF�SNAP�busctlzmissing busctl utility�callz--quietz--systemzio.netplan.Netplanz/io/netplan/Netplan�Applyr � z'failed to communicate with dbus servicez1failed to communicate with dbus service: error %sz//run/systemd/system/netplan-ovs-cleanup.servicez /run/systemd/network/*netplan-*z!/run/systemd/system/netplan-ovs-*z0/run/NetworkManager/system-connections/netplan-*�NETPLAN_PROFILE�valgrindz--leak-check=full)�stderrz(the configuration could not be generatedTzDnetplan generated networkd configuration changed, reloading networkdznetplan-wpa-*.serviceznetplan-wpa@*.service�stop)�syncz2no netplan generated networkd configuration existsz9netplan generated NM configuration changed, restarting NM�device� disconnectz,no netplan generated NM configuration existsz%netplan triggering .link rules for %s�udevadmz test-builtin�net_setup_linkz/sys/class/net/)�stdoutr) �testz#Ignoring device without syspath: %s�namez5Interface name {} is too long. {} will not be renamedz+Interface rename {} -> {} already happened.�ip�link�set�dev�down)r. �triggerz--attr-match=subsystem=net�settlez*/run/systemd/system/netplan-regdom.service�startznetplan-regdom.servicec S s g | ]}t j�|��qS r )�os�path�basename��.0�fr r r � <listcomp> s z.NetplanApply.command_apply.<locals>.<listcomp>z1/run/systemd/system/*.wants/netplan-wpa-*.servicec S s& g | ]}|� d t �stj�|��qS )�/)�endswith�OVS_CLEANUP_SERVICEr; r< r= r> r r r rA s �z1/run/systemd/system/*.wants/netplan-ovs-*.servicez:Falling back to a hard restart of systemd-networkd.service�restartzsystemd-networkd.servicez/run/NetworkManager/devices)� ignore_errors)�nmcli�general�status� )�capture_output�text� � z connectedg �?)Er r r r �process_sriov_configr �process_ovs_cleanupr; �environ�shutil�which� RuntimeError� subprocessr$ �sys�exit�PermissionError�bool�glob�remove�utils� nm_interfaces� netifaces� interfaces�extend�STDOUT�append�get_generator_path� EX_CONFIGr �update�systemctl_daemon_reload�logging�debug�systemctl_is_active�insert� systemctl� nm_runningrG �CalledProcessError�systemctl_network_manager�parse�process_link_changes�virtual_interfaces�keys�clear_virtual_links� check_call�DEVNULL�items�get�len� IF_NAMESIZE�warning�formatr< �exists�networkctl_reload�networkctl_reconfigure�networkd_interfacesrD � ip_addr_flush�rmtree�ranger! � returncode�time�sleep�strr0 )&r � run_generater+ � exit_on_error� state_dir�config_managerr# �res�ovs_cleanup_service�old_files_networkd� old_ovs_glob� old_files_ovs� old_nm_glob� nm_ifaces� old_files_nm�generator_call� generate_out�devices�restart_networkd�restart_ovs_glob� restart_ovs�restart_nm_glob� restart_nm� wpa_servicesr, �changes�cm� prev_links� curr_links�devices_after_udev�iface�settings�new_name� netplan_wpa� netplan_ovs�cmd�_�outr r r r A s\ � �� �� ��� �� � ��� � � zNetplanApply.command_applyc C sV | D ]&}|� � D ] \}}t|�turq|�dg �}|D ] }||kr& dS qqqdS )zp Is this physical interface a member of a 'composite' virtual interface? (bond, bridge) r_ TF)rv �type�dictrw )� composites�phy� compositer� r� �membersr� r r r �is_composite_member8 s ���z NetplanApply.is_composite_memberc C s� |s t �d� g S tt| �t|� �}tt|��|��}|D ]"}zdddd|g}t�|� W q tjy@ t �d�|�� Y q w |S )a% Calculate the delta of virtual links. And remove the links that were dropped from the YAML config, if they were not dropped by the backend already. We can make use of the netplan netdef ids, as those equal the interface name for virtual links. z;Cannot clear virtual links: no network interfaces provided.r3 r4 �deleter6 z Could not delete interface {}) rg rz �listr5 � intersectionrU rt rm r{ )r� r� r� �dropped_interfaces�interfaces_to_clearr4 r� r r r rs I s �z NetplanApply.clear_virtual_linksr� c C s� i }|j |jg}|j�� D ]Q}|j}|sq |jsq t�||j�r*t � d� |j�� q t � | |�}|s<t �d� |j�� q ||krIt � d� |�� q |jrXt �d� |j||�� q d|i||< q t � d� |�� |S )z� Go through the pending changes and pick what needs special handling. Only applies to non-critical interfaces which can be safely updated. z Skipping composite member {}z,Cannot find unique matching interface for {}z&Skipping correctly named interface: {}zLCannot rename {} ({} -> {}) at runtime (needs reboot), due to being criticalr2 zLink changes: {})�bridges�bonds�physical_interfaces�values�set_name� has_matchr r� �idrg rh r{ r\ �find_matching_ifacerz �critical)r_ r� r� �composite_interfaces�netdef�newname�current_iface_namer r r rp c s4 �z!NetplanApply.process_link_changesc C sb zt | � W d S tjy0 } z t�t|�� |r%t�d� W Y d }~d S W Y d }~d S d }~ww )NrN )r r\ � config_errorsrg �errorr� rV rW )r� r� �er r r rO � s ���z!NetplanApply.process_sriov_configc C s� z t | ||� W d S ttfy3 } z t�t|�� |r(t�d� W Y d }~d S W Y d }~d S d }~w tyM } zt� d� |�� W Y d }~d S d }~ww )NrN z Cannot call Open vSwitch: {}.) r �OSErrorrT rg r� r� rV rW r rz r{ )r� �ovs_old� ovs_currentr� r� r r r rP � s �� ��z NetplanApply.process_ovs_cleanup)TFTN)T)�__name__� __module__� __qualname__r r! r � staticmethodr� rs r rp rO rP � __classcell__r r r r r * s x + r )�__doc__rg r; rV rZ rU rR r^ r� �netplan.cli.utils�clir\ �netplan.configmanagerr r �netplan.cli.sriovr �netplan.cli.ovsr r rD ry �NetplanCommandr r r r r �<module> s PK ! �!��� � 5 cli/commands/__pycache__/sriov_rebind.cpython-310.pycnu �[��� o � ed� � @ sH d Z ddlZddlm mZ ddlmZmZmZ G dd� dej �Z dS )z"netplan SR-IOV rebind command line� N)� PCIDevice�bind_vfs�_get_pci_slot_namec s, e Zd Z� fdd�Zdd� Zdd� Z� ZS )�NetplanSriovRebindc s t � jdddd� d S )N�rebindzKRebind SR-IOV virtual functions of given physical functions to their driverT)� command_id� description�leaf)�super�__init__��self�� __class__� �7/usr/share/netplan/netplan/cli/commands/sriov_rebind.pyr s �zNetplanSriovRebind.__init__c C s2 | j jdtdg dd� | j| _| �� | �� d S )N�netdevs�*z*Space separated list of PF interface names)�type�nargs�default�help)�parser� add_argument�str�command_rebind�func� parse_args� run_commandr r r r �run! s � zNetplanSriovRebind.runc C s\ | j D ](}t|�}t|�}|jst�d�|�� qt|j|j �}t� d�|t |��� qdS )zeBind virtual functions of SR-IOV devices to their corresponding driver after eswitch mode was changedz1{} does not seem to be a SR-IOV physical functionz{}: bound {} VFsN) r r r �is_pf�logging�warning�formatr �vfs�driver�info�len)r �iface�pci_addr�pcidev� bound_vfsr r r r ) s �z!NetplanSriovRebind.command_rebind)�__name__� __module__� __qualname__r r r � __classcell__r r r r r s r ) �__doc__r! �netplan.cli.utils�cli�utils�netplan.cli.sriovr r r �NetplanCommandr r r r r �<module> s PK ! 5s'�) �) 0 cli/commands/__pycache__/migrate.cpython-310.pycnu �[��� o ���d�O � @ s� d Z ddlZddlZddlZddlZddlmZ zddlZdZW n ey+ dZY nw ddl m Z ddl Z ddl m mZ G dd� dej�ZdS ) z netplan migrate command line� N)�globFT)� OrderedDictc sV e Zd Z� fdd�Zdd� Zdd� Zdd� Zd d � Zd d � Zd d� Z ddd�Z � Z S )�NetplanMigratec s t � jddddd� d S )N�migratez/Migration of /etc/network/interfaces to netplanT)� command_id� description�leaf�testing)�super�__init__��self�� __class__� �2/usr/share/netplan/netplan/cli/commands/migrate.pyr % s �zNetplanMigrate.__init__c C s� d|v r3d|vr i |d< d|d vrg |d d< |d � d�D ]}|s$q |d d |g7 < q |d= d|v rhd|vr?i |d< d|d vrKg |d d< |d � d�D ]}|sWqR|d d |g7 < qR|d= dS dS )z�Parse dns options (dns-nameservers and dns-search) from if_options (an interface options dict) into the interface configuration if_config Mutates the arguments in place. zdns-nameservers� nameservers� addresses� z dns-search�searchN)�split)r � if_options� if_config�ns�domainr r r �parse_dns_options+ s* �z NetplanMigrate.parse_dns_optionsc C s� d|v rFzt |d �}W n ty# t�d||d � t�d� Y nw d|v r=|d |ks=t�d|||d � t�d� ||d< |d= dS dS )z�Parse out the MTU. Operates the same way as parse_dns_options iface is the name of the interface, used only to print error messages �mtuz %s: cannot parse "%s" as an MTU� z0%s: tried to set MTU=%d, but already have MTU=%dN)�int� ValueError�logging�error�sys�exit)r �ifacer r r r r r � parse_mtuH s � �zNetplanMigrate.parse_mtuc C s\ d|v r,d|v r!|d |d ks!t �d||d |d � t�d� |d |d< |d= dS dS )z�Parse out the manually configured MAC. Operates the same way as parse_dns_options iface is the name of the interface, used only to print error messages � hwaddress� macaddressz0%s: tried to set MAC %s, but already have MAC %sr N)r r! r" r# )r r$ r r r r r �parse_hwaddress[ s � �z NetplanMigrate.parse_hwaddressc C sV | j jddd� | j jdddd� | j| _| �� tr%t�d� t� d � | � � d S ) Nz --root-dirzOSearch for and generate configuration files in this root directory instead of /)�helpz --dry-run� store_truezQPrint converted netplan configuration to stdout instead of writing/changing files)�actionr) z�The `yaml` Python package couldn't be imported, and is needed for the migrate command. To install it on Debian or Ubuntu-based system, run `apt install python3-yaml`� ) �parser� add_argument�command_migrate�func� parse_args�NO_YAMLr r! r" r# � run_commandr r r r �runj s � � zNetplanMigrate.runc C s i }z | � | jp d�\}}W n ty, } zt�t|�� t�d� W Y d }~nd }~ww |�� D �]9\}}|�� D �]/\}}t� d|||� ||vrVt�d|� t�d� |d dkrct� d|� q:|d dkr�|� d i �� d i �� |i �} | � |d | � | � ||d | � |d r�t�d |d � |d �� �� t�d� |dkr�d| d< q:|dks�J �d| d< q:|d dk�r\|� d i �� d i �� |i �} d| vr�g | d< | � |d | � | �||d | � | � ||d | � |dk�r�tg d��} tg d��} t|d �� �} | | } | �r5| �| �D ]}t�d|||� t�d� �q| | D ]}t�d|||� t�d� �q$d|d v�rGt�d|� t�d� d|d d v �rb|d d �d�d }|d d }n&d |d v�rtt�d |� t�d� |d d }|d d d |d d }zt�|�}W n! tj�y� } zt�d |||� t�d� W Y d }~nd }~ww z tj|d d!�}W n! tj�y� } zt�d"|||� t�d� W Y d }~nd }~ww | d t|�d t|j� g7 < d#|d v �r�|d d# | d$< q:|dk�sJ �tg d%��} tg d&��} t|d �� �} | | } | �rK| �| �D ]}t�d|||� t�d� �q%| | D ]}t�d|||� t�d� �q:d|d v�r]t�d|� t�d� d|d d v �rx|d d �d�d }|d d }n&d |d v�r�t�d |� t�d� |d d }|d d d |d d }zt�|�}W n! tj�y� } zt�d'|||� t�d� W Y d }~nd }~ww z tj|d d!�}W n! tj�y� } zt�d(|||� t�d� W Y d }~nd }~ww | d t|�d t|j� g7 < d#|d v �r|d d# | d)< d*|d v �r[|d d* d+k�r(d | d*< q:|d d* d,k�r6d| d*< q:|d d* d-k�rKt�d.|� t�d� q:t�d/||d d* � t�d� q:t�d0||d � t�d� q:q1tj � | j�ptdd1�}|�r�d|d d2< t � |�}| j �r�t |� n`tj � | j�p�dd3�}z t�!tj �"|�� W n t#�y� Y nw z t$|d4�� }|�%|� W d � n 1 �s�w Y W n t#�y� t�d5|� t�d6� Y nw t�&d7|� nt�'d8� | j �st�&d9||� t�(||d: � d S d S );N� r zConverting %s family %s %sz.%s: non-automatic interfaces are not supported�method�loopbackz Ignoring loopback interface %s�dhcp�network� ethernets�optionsz2%s: option(s) %s are not supported for dhcp methodz, �inetT�dhcp4�inet6�dhcp6�staticr )�address�netmask�gateway)� broadcast�metric� pointopoint�scopez %s: unsupported %s option "%s"z%s: unknown %s option "%s"rA z(%s: no address supplied in static method�/r rB zE%s: address does not specify prefix length, and netmask not specifiedz-%s: error parsing "%s" as an IPv4 address: %sF)�strictz-%s: error parsing "%s" as an IPv4 network: %srC �gateway4)rA rB rC � accept_ra)rE �media�autoconf�privextrG zpreferred-lifetimez dad-attemptsz dad-intervalz-%s: error parsing "%s" as an IPv6 address: %sz-%s: error parsing "%s" as an IPv6 network: %s�gateway6rK �0�1�2z(%s: netplan does not support accept_ra=2z#%s: unexpected accept_ra value "%s"z %s: method %s is not supportedzetc/network/interfaces�versionz etc/netplan/10-ifupdown.yaml�xzC%s already exists; remove it if you want to run the migration again� z migration complete, wrote %sz>ifupdown does not configure any interfaces, nothing to migratez#renaming %s to %s.netplan-convertedz.netplan-converted))�parse_ifupdown�root_dirr r r! �strr" r# �items�debug� setdefaultr r( �join�keysr% �set� intersectionr � ipaddress� IPv4Address�AddressValueError� IPv4Network�NetmaskValueError� prefixlen� IPv6Address� IPv6Network�os�path�yaml�dump�dry_run�print�makedirs�dirname�FileExistsError�open�write�info�warning�rename)r �netplan_config�ifaces� auto_ifaces�er$ � family_config�family�config�c�supported_opts�unsupported_opts�opts�bad_opts� unsupported�unknown� addr_spec�net_spec�ipaddr�a�ipnetr � netplan_yaml�dest�fr r r r/ x sL �� � � ����$� � ����$ � � �� ( � �� � �z NetplanMigrate.command_migratec C s\ dd� }g }t |�d }z�t|d | ��}}t�d|j� |D ]i}|�� }|r,|�d�r-q |�d�rat�d�}||t j � |j�|�} t � | �D ]}|� |�r_|| �|t j �| |d � |��7 }qGq |�d �r�t||t j � |j�|��D ]}|| �|||d � �7 }qsq |�|� q W d � W |S 1 s�w Y W |S ty� t�d ||� Y |S w ) zvReturn normalized lines from ifupdown config This resolves "source" and "source-directory" includes. c S s* |� � d }|�d�r| | S |d | S )Nr, rH )r � startswith)�rootdir�curdir�line�argr r r �expand_source_argG s zCNetplanMigrate._ifupdown_lines_from_file.<locals>.expand_source_argr, rH z reading %s�#zsource-directory z^[a-zA-Z0-9_-]+$Nzsource z %s/%s does not exist, ignoring)�lenrq r rZ �name�stripr� �re�compilerh ri ro �listdir�match�_ifupdown_lines_from_filer\ r �append�FileNotFoundError) r r� ri r� �lines� rootdir_lenr� r� �valid_re�dr r r r� B s@ "�� � � �� ��z(NetplanMigrate._ifupdown_lines_from_filerH c C s� ddddddd�}| � |d�}t� }t� }d}d}|D ]�}|�� } z|| d } t�d| | � d}d}W n, ty` |rXt�d||� |jdd �d || | d | d < Y qtd | d ��w t| �| d krxtd | | d t| �d f ��| d d v r�|� | d � q| d dkr�td��| d dkr�q| d dkr�| d dvr�td| d ��| d dvr�td| d ��| d }| d }| d i d�|� | d t� �|< qt d| d ��t�d||� ||fS )uW Parse ifupdown configuration. Return (iface_name → family → {method, options}, auto_ifaces: set) tuple on successful parsing, or a ValueError when encountering an invalid file or ifupdown features which are not supported (such as "mapping"). options is itself a dictionary option_name → value. r, rU )�auto� allow-auto� allow-hotplug�mapping� no-scriptsr$ z/etc/network/interfacesNr z$line fields %s (expected length: %i)z$in_options %s, parsing as option: %s)�maxsplitr; zUnknown stanza type %sz0Expected %i fields for stanza type %s but got %i)r� r� r� r� z mapping stanza is not supportedr� r$ r )r< r> zUnknown address family %s)r7 r@ r8 zUnsupported method %s)r6 r; z!stanza type %s is not implementedz,final parsed interfaces: %s; auto ifaces: %s) r� r r^ r r rZ �KeyErrorr r� �addr[ �NotImplementedError) r r� �fieldlenr� rw r� � in_options� in_familyr� �fields�exp_lenr r r rV h sR $� � "z NetplanMigrate.parse_ifupdown)rH ) �__name__� __module__� __qualname__r r r% r( r4 r/ r� rV � __classcell__r r r r r $ s K&r )�__doc__r rh r" r� r rj r2 � ImportError� collectionsr r` �netplan.cli.utils�cli�utils�NetplanCommandr r r r r �<module> s � PK ! �*�AxJ xJ / cli/commands/__pycache__/status.cpython-310.pycnu �[��� o ���d�k � @ s( d Z ddlZddlZddlZddlZddlZddlZddlZddlm Z m Z m Z m Z ddl Z ddlZddlm mZ e e edf e d eeeee d f Ze�d�ZdZz ddlmZ ddl m Z dd l m Z G d d � d e �Z d ZW n e!y� e�"d � Y nw G dd� d�Z#G dd� dej$�Z%dS )znetplan status command line� N)�Union�Dict�List�Type�JSONz\[([a-z0-9]+)\].*\[\/\1\]F)�Console)�RegexHighlighter)�Themec @ s e Zd ZdZddgZdS )�NetplanHighlighterznetplan.z"(^|[\s\/])(?P<int>\d+)([\s:]?\s|$)z(?P<str>(\"|\').+(\"|\'))N)�__name__� __module__� __qualname__� base_style� highlights� r r �1/usr/share/netplan/netplan/cli/commands/status.pyr , s �r Tz4python3-rich not found, falling back to plain outputc @ s e Zd Zdedefdd�Zg g ddfdedededed ef d d �Zd edefd d�Z dedefdd�Z defdd�Z e de fdd��Ze de fdd��Ze defdd��Ze defdd��Ze defd d ��Ze defd d ��Ze defd d!��Ze defd"d#��Ze defd$d%��Zd&S )'� Interface�ip�returnc C s$ t |�dd� }�dkr|�� S dS )z� Extract the MAC address if it's set inside the JSON data and seems to have the correct format. Return 'None' otherwise. �address� � N)�len�get�lower)�selfr r r r r � __extract_mac8 s zInterface.__extract_mac)NN�nd_data�nm_data� resolved_data� route_datac sb |� dd�� _|� dd�� _d|� dg �v rdnd� _|� dd��� � _� �|�� _|p-g }t� fd d �|D �d �� _ t� fd d �|D �d �� _ d � _ |d r~g � _ |d D ]'}t |d �t � j�kr}|d }|d }� j � t�|d�dd� |D ���� qVd � _|d r�g � _|d D ]} t | d �t � j�kr�� j� t| d �� q�g } d � _|d r�| |d 7 } |d r�| |d 7 } | �r#g � _| D ]]} | � d�� jk�r"d| � d�i} | � d�} | r�| | d< | � d�} | r�| | d< | � d�} | r�| | d< | � d�} | �r| | d< | � d�} | �r| | d< | � d �} | �r | | d < � j� | � q�d � _|� d � }�r�g � _|D ]]}g }t�|d �j�rE|� d � � j�rr� jD ]%}d|v �rpt�|d �t�|d �k�rp|d d k�rp|� d � n�qL|d �� }|d!|d" ii} |�r�|| | d< � j� | � �q3d � _|� d#i �� d$� }�r�|�� � _� �� j��p�d%� _ d S )&N�ifindex����ifname�unknown�UP�flags�DOWN� operstatec 3 �" � | ] }|d � j kr|V qdS )�IndexN)�idx��.0�x�r r r � <genexpr>K � � z%Interface.__init__.<locals>.<genexpr>c 3 r) )�deviceN)�namer, r/ r r r0 L r1 r � � � c S s g | ]}|� d d��qS )r4 �big)�to_bytes)r- �vr r r � <listcomp>V � z&Interface.__init__.<locals>.<listcomp>�dev�to�dst�gateway�via�prefsrc�from�metric�type�scope�protocol� addr_info�local�link�dhcp�prefix� prefixlen�linkinfo� info_kindr ) r r+ r3 � adminstate�upperr( �_Interface__extract_mac� macaddress�next�nd�nm� dns_addresses�int�append�socket� inet_ntop�join� dns_search�str�routes� addresses� ipaddress� ip_address� is_link_localr � iproute_type�strip�query_networkctl� _networkctl)r r r r r r �itr�ipfamily�dnsr9 �_routes�obj�elem�valrG �addrr& �route�ip_addrrN r r/ r �__init__A s� $� � � � zInterface.__init__�con_namec C sb d }zt �ddddd|g�}|�� W S ty0 } zt�d�|t|��� W Y d }~|S d }~ww )Nz --get-valuesz802-11-wireless.ssid�con�show�idz+Cannot query NetworkManager SSID for {}: {})�utils� nmcli_outrd � Exception�logging�warning�formatr] )r rr �ssid�er r r � query_nm_ssid� s � ���zInterface.query_nm_ssidr# c C s^ d }zt jddd|gdd�}W |S ty. } zt�d�|t|��� W Y d }~|S d }~ww )N� networkctl�statusz--T��textz"Cannot query networkctl for {}: {})� subprocess� check_outputrx ry rz r{ r] )r r# �outputr} r r r re � s ����zInterface.query_networkctlc C s� | j | j| jd�}| jr| j|d< | jr| j|d< | jr!| j|d< | jr)| j|d< | jr1| j|d< | jr9| j|d< | j rA| j |d< | j rI| j |d < | j rQ| j |d < | j rY| j |d < | j ra| j |d < | jri| j|d < | j|fS )N)�indexrO r( rD r| � tunnel_mode�backendru rR �vendorr_ rV r\ r^ �activation_mode)r+ rO r( rD r| r� r� � netdef_idrR r� r_ rV r\ r^ r� r3 )r �jsonr r r r� � s: � zInterface.jsonc C � | j dko | jdkS )Nr% �rO r( r/ r r r �up� � z Interface.upc C r� )Nr' r� r/ r r r �down� r� zInterface.downc C s` t ddddddddddddddd��}| jr | j�d �nd }||v r&|| S t�d �|�� d S ) N�bond�bridge�ethernet�tunnel�wifi�modem�vrf)r� r� �ether�ipgre�ip6gre�loopback�sitr� �tunnel6� wireguard�wlan�wwanr� �vxlanr zUnknown device type: {})�dictrT r ry rz r{ )r �match�nd_typer r r rD � s* �zInterface.typec C s | j dkr | jr | jS d S )Nr� )rD rc r/ r r r r� � s zInterface.tunnel_modec C sN | j rd| j �dd�vrd| j �dd�v rdS | jr%d| j�dd�v r%d S d S ) N� unmanaged� SetupStater � run/systemd/network/10-netplan-� NetworkFile�networkd�.run/NetworkManager/system-connections/netplan-�filename�NetworkManager)rT r rU r/ r r r r� � s zInterface.backendc C s� | j dkr| j�dd��d�d �d�d S | j dkrK| j�d d��d �d �d �d }| j�d d�d krI| �| j�d��}|rI|�d| �d }|S d S )Nr� r� r r� r4 z.networkr r� r� r� z .nmconnectionrD z802-11-wirelessr3 �-)r� rT r �splitrU r~ )r �netdefr| r r r r� � s, ��� ���zInterface.netdef_idc C s, | j rd| j v r| j d r| j d �� S d S )N�Vendor)rT rd r/ r r r r� s zInterface.vendorc C sb | j dkr/| j�� D ]$}|�� }d}|�|�r.|t|�td� � �� }|r*| S d S q d S )Nr� zWiFi access point: z (xB:SS:ID:xx:xx:xx))rD rf � splitlinesrd � startswithr )r �line�keyr| r r r r| s �zInterface.ssidc C s� | j dkr0| j�� D ]#}|�� }d}|�|�r-|t|�d � �� }|dkr)| S d S q d S | j dkr@| jd dkr>dS d S d S )Nr� zActivation Policy: r� r� � autoconnect�no�manual)r� rf r� rd r� r rU )r r� r� �moder r r r� s � �zInterface.activation_modeN)r r r r� r] rQ r �tuplerq r~ re r� �property�boolr� r� rD r� r� r� r� r| r� r r r r r 7 s< �� �X r c s� e Zd Z� fdd�Zdd� Zdefdd�Zdedefd d �Z d e de fd d �Z de fdd�Z de fdd�Zde fdd�Zde fdd�Zde fdd�Zdefdd�Zdefdd�Zd d � Zd%d e d edd fd!d"�Zd#d$� Z� ZS )&� NetplanStatusc s t � jdddd� d| _d S )Nr� z,Query networking state of the running systemT)� command_id� description�leafF)�superrq �allr/ �� __class__r r rq 1 s � zNetplanStatus.__init__c C sZ | j jddtd dd� | j jddddd � | j jd d d d d� | j| _| �� | �� d S )Nr# �?zShow only this interface)�nargsrD �default�helpz-az--all� store_truez(Show all interface data (incl. inactive))�actionr� �-fz--format�tabularz2Output in machine readable `json` or `yaml` format)r� r� )�parser� add_argumentr] �command�func� parse_args� run_commandr/ r r r �run7 s � � � zNetplanStatus.runr c C s� g g d d�}zZt d��K}|�� }d|v rd|d< nd|v r!d|d< |g|�� D ]$}|�d�r=|d |�� d d � 7 < |�d �rL|�� d d � |d < q(W d � W |S 1 sYw Y W |S ty} } zt�d �t |��� W Y d }~|S d }~ww ) N)r_ �searchr� z/etc/resolv.confz/# This is /run/systemd/resolve/stub-resolv.conf�stubr� z*# This is /run/systemd/resolve/resolv.conf�compat� nameserverr_ r4 r� z!Cannot parse /etc/resolv.conf: {}) �open�readline� readlinesr� r� rx ry rz r{ r] )r �res�f� firstliner� r} r r r �resolvconf_jsonC s6 � �� ��� ��z NetplanStatus.resolvconf_json� interfacesc C s� |D ]A}|j rC|jrC|jrC|jrCg }|jD ]}t|�� �d \}}d|vs+d|d vr0|�|� qdd� |jD �}|rC|rC|jrC dS qdS )Nr r& rI c S s g | ] }|� d d�dkr|�qS )r= Nr� )r r, r r r r: d � z4NetplanStatus.query_online_state.<locals>.<listcomp>TF)r� r_ r^ rV �list�itemsrX )r r� �itf� non_local_ipsrn r �extra�default_routesr r r �query_online_stateZ s ��z NetplanStatus.query_online_state� cmd_outputc C s t �|�S �N�r� �loads�r r� r r r �process_generici s z NetplanStatus.process_genericc C sb d }zt jg d�dd�}| �|�}W |S ty0 } zt�d�t|��� W Y d }~|S d }~ww )N)r �-d�-jrn Tr� z(Cannot query iproute2 interface data: {})r� r� r� rx ry �criticalr{ r] �r �datar� r} r r r �query_iproute2l � � � ��z NetplanStatus.query_iproute2c C s t �|�d S )N� Interfacesr� r� r r r �process_networkdv s z NetplanStatus.process_networkdc C sb d }zt jddgdd�}| �|�}W |S ty0 } zt�d�t|��� W Y d }~|S d }~ww )Nr z --json=shortTr� z(Cannot query networkd interface data: {})r� r� r� rx ry r� r{ r] r� r r r �query_networkdy r� z NetplanStatus.query_networkdc C sd g }|� � D ])}|�d�}|d r|d nd }|r/|�||d |d |d |d |d d�� q|S ) N�:r r4 r5 � � � )r2 r3 �uuidr� rD r� )r� r� rX )r r� r� r� r� r< r r r � process_nm� s ��zNetplanStatus.process_nmc C s^ d }zt �g d��}| �|�}W |S ty. } zt�d�t|��� W Y d }~|S d }~ww )N)z-tr� z*DEVICE,NAME,UUID,FILENAME,TYPE,AUTOCONNECTrs rt z.Cannot query NetworkManager interface data: {})rv rw r� rx ry �debugr{ r] r� r r r �query_nm� s � ��zNetplanStatus.query_nmc C s� d }d }z!t jg d�dd�}| �|�}t jg d�dd�}| �|�}W ||fS tyD } zt�d�t|��� W Y d }~||fS d }~ww )N)r r� r� ro Tr� )r r� r� z-6ro z$Cannot query iproute2 route data: {})r� r� r� rx ry r� r{ r] )r �data4�data6�output4�output6r} r r r � query_routes� s" � � � ��zNetplanStatus.query_routesc C s� d }d }z"t �� }|�dd�}t �|d�}|�d�}|d }|d }W ||fS tyE } zt�d�t |��� W Y d }~||fS d }~ww )Nzorg.freedesktop.resolve1z/org/freedesktop/resolve1z org.freedesktop.DBus.Propertiesz org.freedesktop.resolve1.Manager�DNS�Domainsz"Cannot query resolved DNS data: {}) �dbus� SystemBus� get_objectr �GetAllrx ry r� r{ r] )r r_ r� �ipc�resolve1� resolve1_ifr� r} r r r �query_resolved� s � ��z NetplanStatus.query_resolvedc O sh t |�r-t|�}t�|d �D ]}|d �d�|�d��d�|�d�|d< qt|i |��S t|i |��S )Nr z[{}]r z[/{}])r r� � MATCH_TAGS�findall�replacer{ �print)r �args�kwargs�lst�tagr r r � plain_print� s �zNetplanStatus.plain_printNr� �totalc & s� t rtdddddddd��}tt� ||d d �}|j}n| j}d }� �d i �}� fd d�� D �} |d| d jd|�dd �r?dndd�� |�di �} | �dg �} | �d�} | �dg �} | r�t| �D ] \}}|d| d j|dkrrd nd || r{d �| �nd d �� qa| r�t| �D ]\}}|d| d j|dkr�d nd |d�� q�|� | D �]\}� � �d!d"�d# � �d$d"� }d%}|d&kr�d'}d}n|d(kr�d)}d*}� �d+d,�}� �d-�}� �d.�}|d/kr�|r�|d0| d1 7 }n |d2kr�|r�|d#| 7 }|d3j|� �d4d5�|||� �d6d7�� �d8��rd9�� �d8��nd d:�� � �d;��r@|d| d< jd=� �d;d �� �d>��r;d �� �d>d ��nd d?�� � �dg �}|�r�t|�D ]U\}}t |� � �d \}}g }|�d@��ri|�d@g �}d }d } |�rudA|v �rydB}dC} |d| dD j|dk�r�dEnd ||�dFd �|�r�dGdH� |� dI nd || dJ�� �qM� �dKg �}|�r�t|�D ]\}}|d| d j|dk�r�d nd |d�� �q�� �dLg �}|�r�t|�D ]\}}|d| d j|dk�r�d nd |d�� �q �dMg �}|�r�t|�D ]�\}}d } d } |dN dOk�rdB} dC} d } dP|v �r dQ|dP } d } dR|v �r+dS|dR } d }!dT|v �r:dUt |dT � }!g }dV|v �rQ|dV dWk�rQ|dV }"|� |"� dX|v �rf|dX dYk�rf|dX }#|� |#� d+|v �r{|d+ dZk�r{|d+ }$|� |$� |d| d[ j|dk�r�d\nd |dN | | |!|�r�dGdH� |� dI nd | | d]�� �q�� �d^�}|�r�|d| d jd_|d�� |� q�|t| � }%|%dk�r�|d`�|%�� d S d S )aNz bold cyan�yellow�grey62z green boldzred boldz yellow bold�bold)z netplan.intz netplan.str�muted�online�offliner$ � highlightF)� highlighter�theme�width�emoji�18�netplan-global-statec s g | ] }|d kr|� | f�qS )r% r )r- r� �r� r r r: � r� z.NetplanStatus.pretty_print.<locals>.<listcomp>z{title:>z } {value}z Online state:r z[online]online[/online]z[offline]offline[/offline])�title�value� nameserversr_ r� r� z } {value}[muted]{mode}[/muted]r zDNS Addresses:r z ({}))r' r( r� z DNS Search:r( �UNKNOWN�/rO r$ zUP/UPr% z DOWN/DOWNr' r rD �otherr| r� r� z/"�"r� uU [{col}]●[/{col}] {idx:>2}: {name} {type} [{col}]{state}[/{col}] ({backend}{netdef})r� r� r� r� ru z: [highlight]{}[/highlight])�colr+ r3 rD �stater� r� rR z } {mac}[muted]{vendor}[/muted]z MAC Address:r� )r' �macr� r& rJ z [highlight]z [/highlight]z1} {start}{ip}/{prefix}{end}[muted]{extra}[/muted]z Addresses:rK z (z, �))r' r rK r� �start�endrV r\ r^ r= r� r@ z via rB z from rC z metric rF �kernelrE �global�unicastz:} {start}{to}{via}{src}{metric}{end}[muted]{extra}[/muted]zRoutes:)r' r= r@ �srcrC r� r2 r3 r� zActivation Mode:z7{} inactive interfaces hidden. Use "--all" to show all.)� RICH_OUTPUTr r r r r r r{ � enumerater� r� r[ r] rX r )&r r� r �_console_widthr! �console�pprint�pad� global_stater� �ns�dns_addr�dns_moder\ �irm r# r/ �scolor� full_typer| r� r rk r r� r& �highlight_start� highlight_end� default_start� default_endr@ r7 rC �protorE rD �hiddenr r& r � pretty_print� s2 � � � � � � � � � � � � �zNetplanStatus.pretty_printc s� t �d�s!t �d�rt�d� t�d� t�d� t �ddgd� �� � }�� � �|r-�s7t�d� t�d� �� � ��� � \���� � \� �� �����fdd �|D �}t|�}d d � |D �}��|�}�jrut�fd d �|D �d �g}d d � |D �}�jr�|g kr�t�d��j�� t�d� d|��� d�i}�jr�|n|}|D ] }|�� \} } | || < q��j�� } | dkr�ttj|d d�� d S | dkr�ttj|dd�� d S ��||� d S )Nzsystemd-networkd.servicez^'netplan status' depends on networkd, but systemd-networkd.service is masked. Please start it.r4 z3systemd-networkd.service is not active. Starting...r2 Tz,Could not query iproute2 or systemd-networkdc s$ g | ]}t |��� �f��f��qS r )r �r- r� )rV r\ r� �nmcli�route4�route6r r r: � s $ z)NetplanStatus.command.<locals>.<listcomp>c S s g | ] }|j d kr|�qS )r' )r( rL r r r r: � s c 3 s � | ] }|j � jkr|V qd S r� )r3 r# rL r/ r r r0 � s � z(NetplanStatus.command.<locals>.<genexpr>c S s g | ]}|d ur|�qS r� r )r- rl r r r r: � r; zCould not find interface {}r% )r r) r� )�indent�yamlF)�default_flow_style) rv �systemctl_is_active�systemctl_is_maskedry �error�sys�exitr� � systemctlr� r� r� r r r r� r# rS r{ r� r� r� r r �dumpsrQ �dumprK ) r �iproute2r� r �filtered� online_stater� �itf_iterr� r# rk � output_formatr )rV r\ r� rM rN rO r r r� l sN �� zNetplanStatus.commandr� )r r r rq r� r� r� r� r� r� r] r r� r� r� r� r� r� r� r r r rW rK r� � __classcell__r r r� r r� 0 s" )r� )&�__doc__r` r� ry �rerY r� rV �typingr r r r r rQ �netplan.cli.utils�clirv r] rW �floatr� r �compiler r8 � rich.consoler �rich.highlighterr � rich.themer r � ImportErrorr� r �NetplanCommandr� r r r r �<module> s6 & � zPK ! %]3+� � 1 cli/commands/__pycache__/generate.cpython-310.pycnu �[��� o � ed� � @ sT d Z ddlZddlZddlZddlZddlZddlm mZ G dd� dej �Z dS )z netplan generate command line� Nc s, e Zd Z� fdd�Zdd� Zdd� Z� ZS )�NetplanGeneratec s t � jdddd� d S )N�generatezFGenerate backend specific configuration files from /etc/netplan/*.yamlT)� command_id� description�leaf)�super�__init__��self�� __class__� �3/usr/share/netplan/netplan/cli/commands/generate.pyr s �zNetplanGenerate.__init__c C s< | j jddd� | j jddd� | j| _| �� | �� d S )N� --root-dirzOSearch for and generate configuration files in this root directory instead of /)�help� --mappingzFDisplay the netplan device ID/backend/interface name mapping and exit.)�parser� add_argument�command_generate�func� parse_args� run_commandr r r r �run% s �� zNetplanGenerate.runc C s� dt jv r3t�d�}|d u rtd��t�|ddddddd g�}|d kr1|d kr+td ��td | ��d S t� � g}| j rB|d| j g7 }| j rL|d| j g7 }t � d|� t�t�|�� d S )N�SNAP�busctlzmissing busctl utility�callz--quietz--systemzio.netplan.Netplanz/io/netplan/Netplan�Generater � z'failed to communicate with dbus servicez1failed to communicate with dbus service: error %sr r z command generate: running %s)�os�environ�shutil�which� RuntimeError� subprocessr �PermissionError�utils�get_generator_path�root_dir�mapping�logging�debug�sys�exit)r r �res�argvr r r r 0 s4 ��� z NetplanGenerate.command_generate)�__name__� __module__� __qualname__r r r � __classcell__r r r r r s r ) �__doc__r) r r+ r# r �netplan.cli.utils�clir% �NetplanCommandr r r r r �<module> s PK ! �ĉ�Z Z 1 cli/commands/__pycache__/__init__.cpython-310.pycnu �[��� o � ed� � @ s� d dl mZ d dlmZ d dlmZ d dlmZ d dlm Z d dl m Z d dl m Z d dlmZ d d lmZ d d lmZ g d �Zd S ) � )� NetplanApply)�NetplanGenerate)� NetplanIp)�NetplanMigrate)� NetplanTry)� NetplanInfo)� NetplanSet)� NetplanGet)�NetplanSriovRebind)� NetplanStatus) r r r r r r r r r r N)�netplan.cli.commands.applyr � netplan.cli.commands.generater �netplan.cli.commands.ipr � netplan.cli.commands.migrater � netplan.cli.commands.try_commandr �netplan.cli.commands.infor �netplan.cli.commands.setr �netplan.cli.commands.getr �!netplan.cli.commands.sriov_rebindr �netplan.cli.commands.statusr �__all__� r r �3/usr/share/netplan/netplan/cli/commands/__init__.py�<module> s PK ! <��y y + cli/commands/__pycache__/ip.cpython-310.pycnu �[��� o � edc � @ s� d Z ddlZddlZddlZddlZddlmZ ddlm mZ ddd�ddd�d �Z G d d � d ej �Z G d d � d ej �Z dS )znetplan ip command line� N)�CalledProcessErrorz#run/systemd/netif/leases/{lease_id}�ifindex)�pattern�methodz<var/lib/NetworkManager/internal-{lease_id}-{interface}.lease� nm_connection)�networkd�NetworkManagerc s$ e Zd Z� fdd�Zdd� Z� ZS )� NetplanIpc � t � jdddd� d S )N�ipz'Retrieve IP information from the systemF�� command_id� description�leaf��super�__init__��self�� __class__� �-/usr/share/netplan/netplan/cli/commands/ip.pyr * � �zNetplanIp.__init__c C sB t � | _| jjdddd�}|j| jj| jd� | �� | �� d S )N�leases�Display IP leasesF)�help�add_help)�func� commandclass)�NetplanIpLeases�command_leases� subparsers� add_parser� set_defaults�run� parse_args� run_command)r � p_ip_leasesr r r r% / s � z NetplanIp.run)�__name__� __module__� __qualname__r r% � __classcell__r r r r r ( s r c s, e Zd Z� fdd�Zdd� Zdd� Z� ZS )r c r )Nz ip leasesr Tr r r r r r r > r zNetplanIpLeases.__init__c C s< | j jddd� | j jddd� | j| _| �� | �� d S )N� interfacez1Interface for which to display IP lease settings.)r � --root-dirzBSearch for configuration files in this root directory instead of /)�parser� add_argument�command_ip_leasesr r& r' r r r r r% C s �� zNetplanIpLeases.runc s� � j dkr � �� � fdd�}t�� g}� jr |d� jg7 }|d� j g7 }t�d|� z tj|dd�}W n t yL t d � j t j d � t � d � Y nw i }|�d �}|D ]}|�� �d �\}}|||< qV||� d S )Nr c s( � fdd�}� fdd�}t | d d }t | d d }zQtd| �� }tj�d � jr2tj�� j�nd |j� j|d ��}tj� |�sH|� d d �}t |��}|� � D ]}t |�� � qQW d � W d S 1 sfw Y W d S ty� } zt d� jt| �f tjd� t�d� W Y d } ~ d S d } ~ ww )Nc s� t j�d� jd�} z t| ��}|�� d �� W d � W S 1 s"w Y W d S ty? } z t� d| t |�� � d }~ww )Nz/sys/class/netr r zCannot read file %s: %s) �os�path�joinr- �open� readlines�strip� Exception�logging�debug�str)� ifindex_f�f�er r r �lease_method_ifindexT s (���zXNetplanIpLeases.command_ip_leases.<locals>.find_lease_file.<locals>.lease_method_ifindexc s� zHt �dd� jg�} | �� D ]5}d|v rC|�d�d �� �� }t �ddd|g�}|�� D ]}d|v rB|�d�d �� �� W S q,qW td �� ty\ } ztd t|� ��d }~ww ) N�dev�showzGENERAL.CONNECTION�:� �con�idzconnection.uuidz@Could not find a NetworkManager connection for the interface: %sz<Could not find a NetworkManager connection for the interface) �utils� nmcli_outr- � splitlines�split�rstripr7 r8 r; )� nmcli_dev_out�line�conn_id� nmcli_con_outr> r r r �lease_method_nm_connection] s" ��� ���z^NetplanIpLeases.command_ip_leases.<locals>.find_lease_file.<locals>.lease_method_nm_connection�backendr r � lease_method_�/� )r- �lease_idzNetworkManager/internal-zNetworkManager/dhclient-z%No lease found for interface '%s': %s��filerC )� lease_path�evalr2 r3 r4 �root_dir�abspath�formatr- �isfile�replacer5 r6 �printrJ r8 r; �sys�stderr�exit) �mappingr? rO � lease_pattern� lease_methodrT r3 r= rL r> r r r �find_lease_fileS s4 �� �&����z:NetplanIpLeases.command_ip_leases.<locals>.find_lease_filer. z --mappingz command ip leases: running %sT)�textz:No lease found for interface '%s' (not managed by Netplan)rU rC �,�=)r- � print_usagerF �get_generator_pathrY r9 r: � subprocess� check_outputr r^ r_ r` ra rI r7 ) r re �argv�outrb � mapping_s�keyvalue�key�valuer r r r1 N s( 4 � z!NetplanIpLeases.command_ip_leases)r) r* r+ r r% r1 r, r r r r r < s r ) �__doc__r9 r2 r_ rk r �netplan.cli.utils�clirF rW �NetplanCommandr r r r r r �<module> s ��� PK ! �Cy�� � 4 cli/commands/__pycache__/try_command.cpython-310.pycnu �[��� o � ed� � @ s� d Z ddlZddlZddlZddlZddlZddlZddlZddlm Z ddl m m Z ddl mZ ddlZddlmZ dZG dd� de j�ZdS )znetplan try command line� N)� ConfigManager)� NetplanApply�x c sx e Zd Z� fdd�Zedd� �Zdd� Zdd� Zd d � Zd d � Z d d� Z dd� Z dd� Z dd� Z dd� Zdd� Z� ZS )� NetplanTryc s` t � jdddd� d| _d | _d | _d | _d | _d | _tj � dd�| _ tj � | j dd d �| _d S ) N�tryzLTry to apply a new netplan config to running system, with automatic rollbackT)� command_id� description�leafF�DBUS_TEST_NETPLAN_ROOT�/�run�netplanznetplan-try.ready)�super�__init__�configuration_changed�new_interfaces� config_file�_config_manager� t_settings�t�os�environ�get�_rootdir�path�join�_netplan_try_stamp��self�� __class__� �6/usr/share/netplan/netplan/cli/commands/try_command.pyr ) s �zNetplanTry.__init__c C s | j s t| jd�| _ | j S )N)�prefix)r r r r r! r! r" �config_manager7 s zNetplanTry.config_managerc C s" t j�| j�rt �| j� dS dS )NTF)r r �isfiler �remover r! r! r" �clear_ready_stamp= s z NetplanTry.clear_ready_stampc C s* t j| jd ddd� t| jd��� d S )Nz /run/netplani� T)�mode�exist_ok�w)r �makedirsr �openr �closer r! r! r" �touch_ready_stampC s z NetplanTry.touch_ready_stampc C sP | j jddd� | j jdttdd� | j jddd� | j| _| �� | �� d S ) Nz --config-filezGApply the config file in argument in addition to current configuration.)�helpz --timeoutz=Maximum number of seconds to wait for the user's confirmation)�type�defaultr/ z--statez0Directory containing previous YAML configuration)�parser� add_argument�int�DEFAULT_INPUT_TIMEOUT� command_try�func� parse_args� run_commandr r! r! r" r G s ��� zNetplanTry.runc C sp | � � s t�tj� z�zDtj�� }tj� |�| _ | j � | j � t � t j| j� t � t j| j� | �� | �� t� jddd| jd� | �� | j j| jd� W n@ tjjyb td� | �� Y n. tjj yp td� Y n t y� } ztd| � td� | �� W Y d }~nd }~ww W | j r�| j � | j � | � � | � � d S | j r�| j � | j � | � � | � � w )NTF�� run_generate�sync� exit_on_error� state_dir)�timeoutz Reverting.z Configuration accepted.z An error occurred: %s)!� is_revertable�sys�exitr � EX_CONFIG�stdin�filenor �terminal�Terminalr �saver �signal�SIGINT�_signal_handler�SIGUSR1�backup�setupr � command_apply�stater. �get_confirmation_inputr? � InputRejected�print�revert� InputAccepted� Exception�reset�cleanupr' )r �fd�er! r! r" r6 U sB ��� � zNetplanTry.command_tryc C s d}| j rd}| jj|d� d S )NFT)�backup_config_dir)r r$ rM )r r[ r! r! r" rM z s zNetplanTry.backupc C sd | j r-tj�ddd�}tj�| j ��d�}t�� }tj�|d�||��}| j� | j |i� d| _ d S )Nr �etcr z.yamlz {}.{}.yamlT) r r r r �basename�rstrip�time�formatr$ �addr )r �dest_dir� dest_name� dest_suffix� dest_pathr! r! r" rN � s zNetplanTry.setupc C s^ t �� }tj�|dd�}t�|� tjd|dd� | j� � t � j ddd|d� t� |� d S )Nr\ r z /etc/netplanT)� dirs_exist_okFr: ) �tempfile�mkdtempr r r r+ �shutil�copytreer$ rT r rO �rmtree)r �tempdir�confdirr! r! r" rT � s zNetplanTry.revertc C s | j �� d S �N)r$ rX r r! r! r" rX � s zNetplanTry.cleanupc C s� g }| j r |�| j � d}z | jj|d�}W n tjy4 } zt�|� t� t j � W Y d}~nd}~ww g }i }|� |j � |� |j� |�� D ]}|jsXd}|�|j|f� qI|rp|D ] \}}td�||�� q]td� dS dS )a Check if the configuration is revertable, if it doesn't contain bits that we know are likely to render the system unstable if we apply it, or if we revert. Returns True if the parsed config is "revertable", meaning that we can actually rely on backends to re-apply /all/ of the relevant configuration to interfaces when their config changes. Returns False if the parsed config contains options that are known to not cleanly revert via the backend. N)� extra_configzBreverting custom parameters for bridges and bonds is not supportedz{}: {}zL Please carefully review the configuration and use 'netplan apply' directly.FT)r �appendr$ �parse�utils� config_errors�logging�errorrA rB r rC �update�bridges�bonds�values�is_trivial_compound_itf�idrS r` ) r ro �np_staterZ �revert_unsupported� multi_iface�itf�reason�ifnamer! r! r" r@ � s4 �� � zNetplanTry.is_revertablec C s( |t jkr tj�� �| jrtj�� �d S rn )rI rL r rF rU r rR )r �sig�framer! r! r" rK � s �zNetplanTry._signal_handler)�__name__� __module__� __qualname__r �propertyr$ r' r. r r6 rM rN rT rX r@ rK � __classcell__r! r! r r" r ' s % -r )�__doc__rt r r_ ri rI rA rg �netplan.configmanagerr �netplan.cli.utils�clirr �netplan.cli.commands.applyr �netplan.terminalr �netplan.libnetplan� libnetplanr5 �NetplanCommandr r! r! r! r" �<module> s PK ! ~$�T� � - cli/commands/__pycache__/info.cpython-310.pycnu �[��� o � ed� � @ s4 d Z ddlm mZ ddlZG dd� dej�ZdS )znetplan info command line� Nc s, e Zd Z� fdd�Zdd� Zdd� Z� ZS )� NetplanInfoc s t � jdddd� d S )N�infozShow available featuresT)� command_id� description�leaf)�super�__init__)�self�� __class__� �//usr/share/netplan/netplan/cli/commands/info.pyr s �zNetplanInfo.__init__c C sR | j jdd�}|jdddddd� |jd ddd d d� | j| _| �� | �� d S ) NF)�requiredz--json�version_format� store_const�jsonz*Output version and features in JSON format)�dest�action�const�helpz--yaml�yamlz*Output version and features in YAML format)�parser� add_mutually_exclusive_group� add_argument� command_info�func� parse_args� run_command)r � format_groupr r r �run s � � zNetplanInfo.runc C s� dddii}t jj}|d �d|i� | jd u rd| _| jdkr/dd l}t|j|dd �� d S | jdkrLtd �|d d �� t jjD ] }td | � qCd S d S ) Nz netplan.io�websitezhttps://netplan.io/�featuresr r r � )�indentz'netplan.io: website: "{}" features:z - ) �netplan� _features�NETPLAN_FEATURE_FLAGS�updater r �print�dumps�format)r �netplan_version�flagsr �featurer r r r , s& �� � �zNetplanInfo.command_info)�__name__� __module__� __qualname__r r r � __classcell__r r r r r s r )�__doc__�netplan.cli.utils�cli�utils�netplan._featuresr$ �NetplanCommandr r r r r �<module> s PK ! ���I� � , cli/commands/__pycache__/get.cpython-310.pycnu �[��� o � ed� � @ sX d Z ddlZddlZddlZddlZddlm mZ ddlm Z G dd� dej �Z dS )znetplan get command line� Nc s4 e Zd Z� fdd�Zdd� Zdd� Zdd� Z� ZS ) � NetplanGetc s t � jdddd� d S )N�getzRGet a setting by specifying a nested key like "ethernets.eth0.addresses", or "all"T)� command_id� description�leaf)�super�__init__��self�� __class__� �./usr/share/netplan/netplan/cli/commands/get.pyr s �zNetplanGet.__init__c C sD | j jdtdddd� | j jdddd � | j| _| �� | �� d S ) N�key�?�allz The nested key in dotted format)�type�nargs�default�helpz --root-dir�/z>Read configuration files from this root directory instead of /)r r )�parser� add_argument�str� command_get�func� parse_args� run_commandr r r r �run# s � zNetplanGet.runc C s� |dkr |j |d� d S |�d�sd�d|f�}t�dd|��dd�}t�� �}|j |d� tj |||d� W d � d S 1 sAw Y d S )Nr )� output_file�network�.z (?<!\\)\.� z\.) � dump_yaml� startswith�join�re�sub�replace�tempfile�NamedTemporaryFile� libnetplan�dump_yaml_subtree)r r �np_stater �tmp_inr r r � dump_state- s "�zNetplanGet.dump_statec C s� t �� }|j| jd� t �� }|�|� z tj�� tj}W n t j y, t � � }Y nw | � | j||� |tjkrT|�� |�d� tj�|�� �d�� |�� d S d S )N)�rootdirr zutf-8)r+ �Parser�load_yaml_hierarchy�root_dir�State�import_parser_results�sys�stdout�fileno�io�UnsupportedOperationr) � TemporaryFiler/ r �flush�seek�write�read�decode�close)r r r- r r r r r ; s" � �zNetplanGet.command_get)�__name__� __module__� __qualname__r r r/ r � __classcell__r r r r r s r ) �__doc__r6 r9 r) r& �netplan.cli.utils�cli�utils�netplan.libnetplanr+ �NetplanCommandr r r r r �<module> s PK ! ���n4 4 , cli/commands/__pycache__/set.cpython-310.pycnu �[��� o � edx � @ sT d Z ddlZddlZddlZddlmZ ddlmZ dZddgZ G dd� de�Z dS ) znetplan set command line� N)�NetplanCommandz70-netplan-set.yaml�renderer�versionc s, e Zd Z� fdd�Zdd� Zdd� Z� ZS )� NetplanSetc s t � jdddd� d S )N�setzTAdd new setting by specifying a dotted key=value pair like ethernets.eth0.dhcp4=trueT)� command_id� description�leaf)�super�__init__��self�� __class__� �./usr/share/netplan/netplan/cli/commands/set.pyr ! s �zNetplanSet.__init__c C sR | j jdtdd� | j jdtdd� | j jdddd � | j| _| �� | �� d S ) N� key_valuezNThe nested key=value pair in dotted format. Value can be NULL to delete a key.)�type�helpz --origin-hintz�Can be used to help choose a name for the overwrite YAML file. A .yaml suffix will be appended automatically.z --root-dir�/zAOverwrite configuration files in this root directory instead of /)�defaultr )�parser� add_argument�str� command_set�func� parse_args� run_commandr r r r �run& s � � � zNetplanSet.runc C s� | j d urt| j �dkrtd��| j r d�| j df�}nd }| j�dd�}t|�dkr/td��|\}}|�d �s?d�d |f�}d d � t�d |�D �}t� � }t � � ��}t� |||� |� � |�dtj� |�|� |�| j� |�dtj� |�|� t�� }|�|� |r�t� � } |�dtj� | �|� |�dtj� | j||d � | �| j� |�dtj� | �|� t�� } | �| � | �|| j� n|�t| j� W d � d S W d � d S 1 s�w Y d S )Nr zInvalid/empty origin-hint�.�yaml�=� � zInvalid value specified�networkc S s g | ]}|� d d��qS )z\.r )�replace)�.0�sr r r � <listcomp>D s z*NetplanSet.command_set.<locals>.<listcomp>z (?<!\\)\.)� constraint)� origin_hint�len� Exception�joinr �split� startswith�re� libnetplan�Parser�tempfile� TemporaryFile�create_yaml_patch�flush�seek�io�SEEK_SET�load_nullable_fields�load_yaml_hierarchy�root_dir� load_yaml�State�import_parser_results�load_nullable_overrides�write_yaml_file�update_yaml_hierarchy�FALLBACK_FILENAME) r �filenamer. �key�value� yaml_pathr �tmp�state�parser_output_file�state_output_filer r r r 4 sN �8"�zNetplanSet.command_set)�__name__� __module__� __qualname__r r r � __classcell__r r r r r s r ) �__doc__r3 r0 r8 �netplan.cli.utilsr �netplan.libnetplanr1 rC � GLOBAL_KEYSr r r r r �<module> s PK ! �q�� � cli/commands/get.pynu �[��� #!/usr/bin/python3 # # Copyright (C) 2020 Canonical, Ltd. # Author: Lukas Märdian <lukas.maerdian@canonical.com> # # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation; version 3. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty 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, see <http://www.gnu.org/licenses/>. '''netplan get command line''' import sys import io import tempfile import re import netplan.cli.utils as utils import netplan.libnetplan as libnetplan class NetplanGet(utils.NetplanCommand): def __init__(self): super().__init__(command_id='get', description='Get a setting by specifying a nested key like "ethernets.eth0.addresses", or "all"', leaf=True) def run(self): self.parser.add_argument('key', type=str, nargs='?', default='all', help='The nested key in dotted format') self.parser.add_argument('--root-dir', default='/', help='Read configuration files from this root directory instead of /') self.func = self.command_get self.parse_args() self.run_command() def dump_state(self, key, np_state, output_file): if key == 'all': np_state.dump_yaml(output_file=output_file) return if not key.startswith('network'): key = '.'.join(('network', key)) # Replace the '.' with '\t' but not at '\.' via negative lookbehind expression key = re.sub(r'(?<!\\)\.', '\t', key).replace(r'\.', '.') with tempfile.NamedTemporaryFile() as tmp_in: np_state.dump_yaml(output_file=tmp_in) libnetplan.dump_yaml_subtree(key, tmp_in, output_file=output_file) def command_get(self): parser = libnetplan.Parser() parser.load_yaml_hierarchy(rootdir=self.root_dir) np_state = libnetplan.State() np_state.import_parser_results(parser) try: sys.stdout.fileno() output_file = sys.stdout # pragma: nocover except io.UnsupportedOperation: # Test environment detected, using a buffer file output_file = tempfile.TemporaryFile() self.dump_state(self.key, np_state, output_file) if output_file != sys.stdout: output_file.flush() output_file.seek(0) sys.stdout.write(output_file.read().decode('utf-8')) output_file.close() PK ! �P+'� � cli/commands/try_command.pynu �[��� #!/usr/bin/python3 # # Copyright (C) 2018 Canonical, Ltd. # Author: Mathieu Trudel-Lapierre <mathieu.trudel-lapierre@canonical.com> # # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation; version 3. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty 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, see <http://www.gnu.org/licenses/>. '''netplan try command line''' import logging import os import time import shutil import signal import sys import tempfile from netplan.configmanager import ConfigManager import netplan.cli.utils as utils from netplan.cli.commands.apply import NetplanApply import netplan.terminal import netplan.libnetplan as libnetplan # Keep a timeout long enough to allow the network to converge, 60 seconds may # be slightly short given some complex configs, i.e. if STP must reconverge. DEFAULT_INPUT_TIMEOUT = 120 class NetplanTry(utils.NetplanCommand): def __init__(self): super().__init__(command_id='try', description='Try to apply a new netplan config to running ' 'system, with automatic rollback', leaf=True) self.configuration_changed = False self.new_interfaces = None self.config_file = None self._config_manager = None self.t_settings = None self.t = None self._rootdir = os.environ.get('DBUS_TEST_NETPLAN_ROOT', '/') self._netplan_try_stamp = os.path.join(self._rootdir, 'run', 'netplan', 'netplan-try.ready') @property def config_manager(self): # pragma: nocover (called by later commands) if not self._config_manager: self._config_manager = ConfigManager(prefix=self._rootdir) return self._config_manager def clear_ready_stamp(self): if os.path.isfile(self._netplan_try_stamp): os.remove(self._netplan_try_stamp) return True return False def touch_ready_stamp(self): os.makedirs(self._rootdir + '/run/netplan', mode=0o700, exist_ok=True) open(self._netplan_try_stamp, 'w').close() def run(self): # pragma: nocover (requires user input) self.parser.add_argument('--config-file', help='Apply the config file in argument in addition to current configuration.') self.parser.add_argument('--timeout', type=int, default=DEFAULT_INPUT_TIMEOUT, help="Maximum number of seconds to wait for the user's confirmation") self.parser.add_argument('--state', help='Directory containing previous YAML configuration') self.func = self.command_try self.parse_args() self.run_command() def command_try(self): # pragma: nocover (requires user input) if not self.is_revertable(): sys.exit(os.EX_CONFIG) try: fd = sys.stdin.fileno() self.t = netplan.terminal.Terminal(fd) self.t.save(self.t_settings) # we really don't want to be interrupted while doing backup/revert operations signal.signal(signal.SIGINT, self._signal_handler) signal.signal(signal.SIGUSR1, self._signal_handler) self.backup() self.setup() NetplanApply().command_apply(run_generate=True, sync=True, exit_on_error=False, state_dir=self.state) # Touch stamp file, it is the signal (for netplan-dbus) that we're # ready to accept any Accept/Reject input (like SIGUSR1 or SIGTERM) self.touch_ready_stamp() self.t.get_confirmation_input(timeout=self.timeout) except netplan.terminal.InputRejected: print("\nReverting.") self.revert() except netplan.terminal.InputAccepted: print("\nConfiguration accepted.") except Exception as e: print("\nAn error occurred: %s" % e) print("\nReverting.") self.revert() finally: if self.t: self.t.reset(self.t_settings) self.cleanup() self.clear_ready_stamp() def backup(self): # pragma: nocover (requires user input) backup_config_dir = False if self.config_file: backup_config_dir = True self.config_manager.backup(backup_config_dir=backup_config_dir) def setup(self): # pragma: nocover (requires user input) if self.config_file: dest_dir = os.path.join("/", "etc", "netplan") dest_name = os.path.basename(self.config_file).rstrip('.yaml') dest_suffix = time.time() dest_path = os.path.join(dest_dir, "{}.{}.yaml".format(dest_name, dest_suffix)) self.config_manager.add({self.config_file: dest_path}) self.configuration_changed = True def revert(self): # pragma: nocover (requires user input) # backup the state we just tried to apply tempdir = tempfile.mkdtemp() confdir = os.path.join(tempdir, 'etc', 'netplan') os.makedirs(confdir) shutil.copytree('/etc/netplan', confdir, dirs_exist_ok=True) # restore previous state self.config_manager.revert() NetplanApply().command_apply(run_generate=False, sync=True, exit_on_error=False, state_dir=tempdir) # clear the backup shutil.rmtree(tempdir) def cleanup(self): # pragma: nocover (requires user input) self.config_manager.cleanup() def is_revertable(self): ''' Check if the configuration is revertable, if it doesn't contain bits that we know are likely to render the system unstable if we apply it, or if we revert. Returns True if the parsed config is "revertable", meaning that we can actually rely on backends to re-apply /all/ of the relevant configuration to interfaces when their config changes. Returns False if the parsed config contains options that are known to not cleanly revert via the backend. ''' extra_config = [] if self.config_file: extra_config.append(self.config_file) np_state = None try: np_state = self.config_manager.parse(extra_config=extra_config) except utils.config_errors as e: logging.error(e) sys.exit(os.EX_CONFIG) revert_unsupported = [] # Bridges and bonds are special. They typically include (or could include) # more than one device in them, and they can be set with special parameters # to tweak their behavior, which are really hard to "revert", especially # as systemd-networkd doesn't necessarily touch them when config changes. multi_iface = {} # type: dict[str, libnetplan.NetDefinition] multi_iface.update(np_state.bridges) multi_iface.update(np_state.bonds) for itf in multi_iface.values(): if not itf.is_trivial_compound_itf: reason = "reverting custom parameters for bridges and bonds is not supported" revert_unsupported.append((itf.id, reason)) if revert_unsupported: for ifname, reason in revert_unsupported: print("{}: {}".format(ifname, reason)) print("\nPlease carefully review the configuration and use 'netplan apply' directly.") return False return True def _signal_handler(self, sig, frame): # pragma: nocover (requires user input) if sig == signal.SIGUSR1: raise netplan.terminal.InputAccepted() else: if self.configuration_changed: raise netplan.terminal.InputRejected() PK ! &�Fx x cli/commands/set.pynu �[��� #!/usr/bin/python3 # # Copyright (C) 2020-2023 Canonical, Ltd. # Author: Lukas Märdian <slyon@ubuntu.com> # # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation; version 3. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty 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, see <http://www.gnu.org/licenses/>. '''netplan set command line''' import tempfile import re import io from netplan.cli.utils import NetplanCommand import netplan.libnetplan as libnetplan FALLBACK_FILENAME = '70-netplan-set.yaml' GLOBAL_KEYS = ['renderer', 'version'] class NetplanSet(NetplanCommand): def __init__(self): super().__init__(command_id='set', description='Add new setting by specifying a dotted key=value pair like ethernets.eth0.dhcp4=true', leaf=True) def run(self): self.parser.add_argument('key_value', type=str, help='The nested key=value pair in dotted format. Value can be NULL to delete a key.') self.parser.add_argument('--origin-hint', type=str, help='Can be used to help choose a name for the overwrite YAML file. \ A .yaml suffix will be appended automatically.') self.parser.add_argument('--root-dir', default='/', help='Overwrite configuration files in this root directory instead of /') self.func = self.command_set self.parse_args() self.run_command() def command_set(self): if self.origin_hint is not None and len(self.origin_hint) == 0: raise Exception('Invalid/empty origin-hint') if self.origin_hint: filename = '.'.join((self.origin_hint, 'yaml')) else: filename = None split = self.key_value.split('=', 1) if len(split) != 2: raise Exception('Invalid value specified') key, value = split if not key.startswith('network'): key = '.'.join(('network', key)) # Split the string into a list on the dot separators, and unescape the remaining dots yaml_path = [s.replace(r'\.', '.') for s in re.split(r'(?<!\\)\.', key)] parser = libnetplan.Parser() with tempfile.TemporaryFile() as tmp: libnetplan.create_yaml_patch(yaml_path, value, tmp) tmp.flush() # Load fields that are about to be deleted (e.g. some.setting=NULL) # Ignore those fields when parsing subsequent YAML files tmp.seek(0, io.SEEK_SET) parser.load_nullable_fields(tmp) # Parse the full, existing YAML config hierarchy parser.load_yaml_hierarchy(self.root_dir) # Load YAML patch, containing our update (new or deleted settings) tmp.seek(0, io.SEEK_SET) parser.load_yaml(tmp) # Validate the final parser state state = libnetplan.State() state.import_parser_results(parser) if filename: # only act on the output file (a.k.a. "origin-hint") parser_output_file = libnetplan.Parser() # Load fields that are about to be deleted ("some.setting=NULL") # Ignore those fields when parsing subsequent YAML files tmp.seek(0, io.SEEK_SET) parser_output_file.load_nullable_fields(tmp) # Load globals/netdefs that are to be ignored from the existing # YAML hierarchy, as our patch is supposed to override settings # in those netdefs via the output file. # Those netdefs and globals must end up in the output file # (a.k.a. "origin-hint", <filename>), have they been defined in # pre-existing YAML files or not. tmp.seek(0, io.SEEK_SET) parser_output_file.load_nullable_overrides(tmp, constraint=filename) # Parse the full YAML hierarchy and new patch, ignoring any # nullable overrides (netdefs/globals) from pre-existing files # and ignoring any nullable fields (settings to be deleted). # This way we can avoid updates to certain netdefs/globals to be # redirected into existing YAML files (defining those same # stanzas) or ignored, but have them written out to the single # output file. # XXX: The origin file of each individual YAML setting/stanza # should be tracked individually, to avoid this # double-parsing workaround (LP: #2003727) parser_output_file.load_yaml_hierarchy(self.root_dir) tmp.seek(0, io.SEEK_SET) parser_output_file.load_yaml(tmp) # Import the partial parser state, ignoring duplicated netdefs # from pre-existing YAML files, so we can force write the patch # contents to the output file or update this file if exists. state_output_file = libnetplan.State() state_output_file.import_parser_results(parser_output_file) state_output_file.write_yaml_file(filename, self.root_dir) else: state.update_yaml_hierarchy(FALLBACK_FILENAME, self.root_dir) PK ! ?�[/� � cli/commands/sriov_rebind.pynu �[��� #!/usr/bin/python3 # # Copyright (C) 2022 Canonical, Ltd. # Author: Lukas Märdian <slyon@ubuntu.com> # # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation; version 3. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty 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, see <http://www.gnu.org/licenses/>. '''netplan SR-IOV rebind command line''' import logging import netplan.cli.utils as utils from netplan.cli.sriov import PCIDevice, bind_vfs, _get_pci_slot_name class NetplanSriovRebind(utils.NetplanCommand): def __init__(self): super().__init__(command_id='rebind', description='Rebind SR-IOV virtual functions of given physical functions to their driver', leaf=True) def run(self): self.parser.add_argument('netdevs', type=str, nargs='*', default=[], help='Space separated list of PF interface names') self.func = self.command_rebind self.parse_args() self.run_command() def command_rebind(self): """Bind virtual functions of SR-IOV devices to their corresponding driver after eswitch mode was changed""" for iface in self.netdevs: pci_addr = _get_pci_slot_name(iface) pcidev = PCIDevice(pci_addr) if not pcidev.is_pf: logging.warning('{} does not seem to be a SR-IOV physical function'.format(iface)) continue bound_vfs = bind_vfs(pcidev.vfs, pcidev.driver) logging.info('{}: bound {} VFs'.format(pcidev, len(bound_vfs))) PK ! $��)� � cli/commands/generate.pynu �[��� #!/usr/bin/python3 # # Copyright (C) 2018 Canonical, Ltd. # Author: Mathieu Trudel-Lapierre <mathieu.trudel-lapierre@canonical.com> # # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation; version 3. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty 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, see <http://www.gnu.org/licenses/>. '''netplan generate command line''' import logging import os import sys import subprocess import shutil import netplan.cli.utils as utils class NetplanGenerate(utils.NetplanCommand): def __init__(self): super().__init__(command_id='generate', description='Generate backend specific configuration files' ' from /etc/netplan/*.yaml', leaf=True) def run(self): self.parser.add_argument('--root-dir', help='Search for and generate configuration files in this root directory instead of /') self.parser.add_argument('--mapping', help='Display the netplan device ID/backend/interface name mapping and exit.') self.func = self.command_generate self.parse_args() self.run_command() def command_generate(self): # if we are inside a snap, then call dbus to run netplan apply instead if "SNAP" in os.environ: # TODO: maybe check if we are inside a classic snap and don't do # this if we are in a classic snap? busctl = shutil.which("busctl") if busctl is None: raise RuntimeError("missing busctl utility") # pragma: nocover # XXX: DO NOT TOUCH or change this API call, it is used by snapd to communicate # using core20 netplan binary/client/CLI on core18 base systems. Any change # must be agreed upon with the snapd team, so we don't break support for # base systems running older netplan versions. # https://github.com/snapcore/snapd/pull/10212 res = subprocess.call([busctl, "call", "--quiet", "--system", "io.netplan.Netplan", # the service "/io/netplan/Netplan", # the object "io.netplan.Netplan", # the interface "Generate", # the method ]) if res != 0: if res == 130: raise PermissionError( "failed to communicate with dbus service") else: raise RuntimeError( "failed to communicate with dbus service: error %s" % res) else: return argv = [utils.get_generator_path()] if self.root_dir: argv += ['--root-dir', self.root_dir] if self.mapping: argv += ['--mapping', self.mapping] logging.debug('command generate: running %s', argv) # FIXME: os.execv(argv[0], argv) would be better but fails coverage sys.exit(subprocess.call(argv)) PK ! ��](�F �F cli/sriov.pynu �[��� #!/usr/bin/python3 # # Copyright (C) 2020-2022 Canonical, Ltd. # Author: Łukasz 'sil2100' Zemczak <lukasz.zemczak@canonical.com> # Author: Lukas Märdian <slyon@ubuntu.com> # # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation; version 3. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty 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, see <http://www.gnu.org/licenses/>. import logging import os import subprocess import typing from collections import defaultdict import netplan.cli.utils as utils import netplan.libnetplan as libnetplan from netplan.configmanager import ConfigurationError import netifaces # PCIDevice class originates from mlnx_switchdev_mode/sriovify.py # Copyright 2019 Canonical Ltd, Apache License, Version 2.0 # https://github.com/openstack-charmers/mlnx-switchdev-mode class PCIDevice(object): """Helper class for interaction with a PCI device""" def __init__(self, pci_addr: str): """Initialise a new PCI device handler :param pci_addr: PCI address of device :type: str """ self.pci_addr = pci_addr @property def sys(self) -> str: """sysfs path (can be overridden for testing) :return: full path to /sys filesystem :rtype: str """ return "/sys" @property def path(self) -> str: """/sys path for PCI device :return: full path to PCI device in /sys filesystem :rtype: str """ return os.path.join(self.sys, "bus/pci/devices", self.pci_addr) def subpath(self, subpath: str) -> str: """/sys subpath helper for PCI device :param subpath: subpath to construct path for :type: str :return: self.path + subpath :rtype: str """ return os.path.join(self.path, subpath) @property def driver(self) -> str: """Kernel driver for PCI device :return: kernel driver in use for device :rtype: str """ driver = '' if os.path.exists(self.subpath("driver")): driver = os.path.basename(os.readlink(self.subpath("driver"))) return driver @property def bound(self) -> bool: """Determine if device is bound to a kernel driver :return: whether device is bound to a kernel driver :rtype: bool """ return os.path.exists(self.subpath("driver")) @property def is_pf(self) -> bool: """Determine if device is a SR-IOV Physical Function :return: whether device is a PF :rtype: bool """ return os.path.exists(self.subpath("sriov_numvfs")) @property def is_vf(self) -> bool: """Determine if device is a SR-IOV Virtual Function :return: whether device is a VF :rtype: bool """ return os.path.exists(self.subpath("physfn")) @property def vf_addrs(self) -> list: """List Virtual Function addresses associated with a Physical Function :return: List of PCI addresses of Virtual Functions :rtype: list[str] """ vf_addrs = [] i = 0 while True: try: vf_addrs.append( os.path.basename( os.readlink(self.subpath("virtfn{}".format(i))) ) ) except FileNotFoundError: break i += 1 return vf_addrs @property def vfs(self) -> list: """List Virtual Function associated with a Physical Function :return: List of PCI devices of Virtual Functions :rtype: list[PCIDevice] """ return [PCIDevice(addr) for addr in self.vf_addrs] def devlink_set(self, obj_name: str, prop: str, value: str): """Set devlink options for the PCI device :param obj_name: devlink object to set options on :type: str :param prop: property to set :type: str :param value: value to set for property :type: str """ subprocess.check_call( [ "/sbin/devlink", "dev", obj_name, "set", "pci/{}".format(self.pci_addr), prop, value, ] ) def __str__(self) -> str: """String represenation of object :return: PCI address of string :rtype: str """ return self.pci_addr def bind_vfs(vfs: typing.Iterable[PCIDevice], driver): """Bind unbound VFs to driver.""" bound_vfs = [] for vf in vfs: if not vf.bound: with open("/sys/bus/pci/drivers/{}/bind".format(driver), "wt") as f: f.write(vf.pci_addr) bound_vfs.append(vf) return bound_vfs def unbind_vfs(vfs: typing.Iterable[PCIDevice], driver) -> typing.Iterable[PCIDevice]: """Unbind bound VFs from driver.""" unbound_vfs = [] for vf in vfs: if vf.bound: with open("/sys/bus/pci/drivers/{}/unbind".format(driver), "wt") as f: f.write(vf.pci_addr) unbound_vfs.append(vf) return unbound_vfs def _get_target_interface(interfaces, np_state, pf_link, pfs): if pf_link not in pfs: # handle the match: syntax, get the actual device name pf_dev = np_state[pf_link] if pf_dev.has_match: # now here it's a bit tricky set_name = pf_dev.set_name if set_name and set_name in interfaces: # if we had a match: stanza and set-name: this means we should # assume that, if found, the interface has already been # renamed - use the new name pfs[pf_link] = set_name else: for interface in interfaces: if not pf_dev.match_interface( itf_name=interface, itf_driver=utils.get_interface_driver_name(interface), itf_mac=utils.get_interface_macaddress(interface)): continue # we have a matching PF # store the matching interface in the dictionary of # active PFs, but error out if we matched more than one if pf_link in pfs: raise ConfigurationError('matched more than one interface for a PF device: %s' % pf_link) pfs[pf_link] = interface else: # no match field, assume entry name is the interface name if pf_link in interfaces: pfs[pf_link] = pf_link return pfs.get(pf_link, None) def _get_pci_slot_name(netdev): """ Read PCI slot name for given interface name """ uevent_path = os.path.join('/sys/class/net', netdev, 'device/uevent') try: with open(uevent_path) as f: pci_slot_name = None for line in f.readlines(): line = line.strip() if line.startswith('PCI_SLOT_NAME='): pci_slot_name = line.split('=', 2)[1] return pci_slot_name except IOError as e: raise RuntimeError('failed parsing PCI slot name for %s: %s' % (netdev, str(e))) def get_vf_count_and_functions(interfaces, np_state, vf_counts, vfs, pfs): """ Go through the list of netplan ethernet devices and identify which are PFs and VFs, matching the former with actual networking interfaces. Count how many VFs each PF will need. """ for nid, netdef in np_state.ethernets.items(): if netdef.sriov_link and _get_target_interface(interfaces, np_state, netdef.sriov_link.id, pfs): vfs[nid] = None try: count = netdef.vf_count except libnetplan.LibNetplanException as e: raise ConfigurationError(*e.args) if count == 0: continue pf = _get_target_interface(interfaces, np_state, nid, pfs) if pf: vf_counts[pf] = count def set_numvfs_for_pf(pf, vf_count): """ Allocate the required number of VFs for the selected PF. """ if vf_count > 256: raise ConfigurationError( 'cannot allocate more VFs for PF %s than the SR-IOV maximum: %s > 256' % (pf, vf_count)) devdir = os.path.join('/sys/class/net', pf, 'device') numvfs_path = os.path.join(devdir, 'sriov_numvfs') totalvfs_path = os.path.join(devdir, 'sriov_totalvfs') try: with open(totalvfs_path) as f: vf_max = int(f.read().strip()) except IOError as e: raise RuntimeError('failed parsing sriov_totalvfs for %s: %s' % (pf, str(e))) except ValueError: raise RuntimeError('invalid sriov_totalvfs value for %s' % pf) if vf_count > vf_max: raise ConfigurationError( 'cannot allocate more VFs for PF %s than supported: %s > %s (sriov_totalvfs)' % (pf, vf_count, vf_max)) try: with open(numvfs_path, 'w') as f: f.write(str(vf_count)) except IOError as e: bail = True if e.errno == 16: # device or resource busy logging.warning('device or resource busy while setting sriov_numvfs for %s, trying workaround' % pf) try: # doing this in two open/close sequences so that # it's as close to writing via shell as possible with open(numvfs_path, 'w') as f: f.write('0') with open(numvfs_path, 'w') as f: f.write(str(vf_count)) except IOError as e_inner: e = e_inner else: bail = False if bail: raise RuntimeError('failed setting sriov_numvfs to %s for %s: %s' % (vf_count, pf, str(e))) return True def perform_hardware_specific_quirks(pf): """ Perform any hardware-specific quirks for the given SR-IOV device to make sure all the VF-count changes are applied. """ devdir = os.path.join('/sys/class/net', pf, 'device') try: with open(os.path.join(devdir, 'vendor')) as f: device_id = f.read().strip()[2:] with open(os.path.join(devdir, 'device')) as f: vendor_id = f.read().strip()[2:] except IOError as e: raise RuntimeError('could not determine vendor and device ID of %s: %s' % (pf, str(e))) combined_id = ':'.join([vendor_id, device_id]) quirk_devices = () # TODO: add entries to the list if combined_id in quirk_devices: # pragma: nocover (empty quirk_devices) # some devices need special handling, so this is the place # Currently this part is empty, but has been added as a preemptive # measure, as apparently a lot of SR-IOV cards have issues with # dynamically allocating VFs. Some cards seem to require a full # kernel module reload cycle after changing the sriov_numvfs value # for the changes to come into effect. # Any identified card/vendor can then be special-cased here, if # needed. pass def apply_vlan_filter_for_vf(pf, vf, vlan_name, vlan_id, prefix='/'): """ Apply the hardware VLAN filtering for the selected VF. """ # this is more complicated, because to do this, we actually need to have # the vf index - just knowing the vf interface name is not enough vf_index = None # the prefix argument is here only for unit testing purposes vf_devdir = os.path.join(prefix, 'sys/class/net', vf, 'device') vf_dev_id = os.path.basename(os.readlink(vf_devdir)) pf_devdir = os.path.join(prefix, 'sys/class/net', pf, 'device') for f in os.listdir(pf_devdir): if 'virtfn' in f: dev_path = os.path.join(pf_devdir, f) dev_id = os.path.basename(os.readlink(dev_path)) if dev_id == vf_dev_id: vf_index = f[6:] break if not vf_index: raise RuntimeError( 'could not determine the VF index for %s while configuring vlan %s' % (vf, vlan_name)) # now, create the VLAN filter # TODO: would be best if we did this directl via python, without calling # the iproute tooling try: subprocess.check_call(['ip', 'link', 'set', 'dev', pf, 'vf', vf_index, 'vlan', str(vlan_id)], stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL) except subprocess.CalledProcessError: raise RuntimeError( 'failed setting SR-IOV VLAN filter for vlan %s (ip link set command failed)' % vlan_name) def apply_sriov_config(config_manager, rootdir='/'): """ Go through all interfaces, identify which ones are SR-IOV VFs, create them and perform all other necessary setup. """ parser = libnetplan.Parser() parser.load_yaml_hierarchy(rootdir) np_state = libnetplan.State() np_state.import_parser_results(parser) config_manager.parse() interfaces = netifaces.interfaces() np_state = config_manager.np_state # for sr-iov devices, we identify VFs by them having a link: field # pointing to an PF. So let's browse through all ethernet devices, # find all that are VFs and count how many of those are linked to # particular PFs, as we need to then set the numvfs for each. vf_counts = defaultdict(int) # we also store all matches between VF/PF netplan entry names and # interface that they're currently matching to vfs = {} pfs = {} get_vf_count_and_functions( interfaces, np_state, vf_counts, vfs, pfs) # setup the required number of VFs per PF # at the same time store which PFs got changed in case the NICs # require some special quirks for the VF number to change vf_count_changed = [] if vf_counts: for pf, vf_count in vf_counts.items(): if not set_numvfs_for_pf(pf, vf_count): continue vf_count_changed.append(pf) if vf_count_changed: # some cards need special treatment when we want to change the # number of enabled VFs for pf in vf_count_changed: perform_hardware_specific_quirks(pf) # also, since the VF number changed, the interfaces list also # changed, so we need to refresh it interfaces = netifaces.interfaces() # now in theory we should have all the new VFs set up and existing; # this is needed because we will have to now match the defined VF # entries to existing interfaces, otherwise we won't be able to set # filtered VLANs for those. # XXX: does matching those even make sense? for vf in vfs: netdef = np_state[vf] if netdef.has_match: # right now we only match by name, as I don't think matching per # driver and/or macaddress makes sense # TODO: print warning if other matches are provided for interface in interfaces: if netdef.match_interface(itf_name=interface): if vf in vfs and vfs[vf]: raise ConfigurationError('matched more than one interface for a VF device: %s' % vf) vfs[vf] = interface else: if vf in interfaces: vfs[vf] = vf # Walk the SR-IOV PFs and check if we need to change the eswitch mode for netdef_id, iface in pfs.items(): netdef = np_state[netdef_id] eswitch_mode = netdef.embedded_switch_mode if eswitch_mode in ['switchdev', 'legacy']: pci_addr = _get_pci_slot_name(iface) pcidev = PCIDevice(pci_addr) if pcidev.is_pf: logging.debug("Found VFs of {}: {}".format(pcidev, pcidev.vf_addrs)) if pcidev.vfs: rebind_delayed = netdef.delay_virtual_functions_rebind try: unbind_vfs(pcidev.vfs, pcidev.driver) pcidev.devlink_set('eswitch', 'mode', eswitch_mode) finally: if not rebind_delayed: bind_vfs(pcidev.vfs, pcidev.driver) filtered_vlans_set = set() for vlan, netdef in np_state.vlans.items(): # there is a special sriov vlan renderer that one can use to mark # a selected vlan to be done in hardware (VLAN filtering) if netdef.has_sriov_vlan_filter: # this only works for SR-IOV VF interfaces link = netdef.vlan_link vlan_id = netdef.vlan_id vf = vfs.get(link.id) if not vf: # it is possible this is not an error, for instance when # the configuration has been defined 'for the future' # XXX: but maybe we should error out here as well? logging.warning( 'SR-IOV vlan defined for %s but link %s is either not a VF or has no matches' % (vlan, link.id)) continue # get the parent pf interface # first we fetch the related vf netplan entry # and finally, get the matched pf interface pf = pfs.get(link.sriov_link.id) if vf in filtered_vlans_set: raise ConfigurationError( 'interface %s for netplan device %s (%s) already has an SR-IOV vlan defined' % (vf, link.id, vlan)) # TODO: make sure that we don't apply the filter twice apply_vlan_filter_for_vf(pf, vf, vlan, vlan_id) filtered_vlans_set.add(vf) PK ! � � � cli/__init__.pynu �[��� #!/usr/bin/python3 # # Copyright (C) 2018 Canonical, Ltd. # Author: Mathieu Trudel-Lapierre <mathieu.trudel-lapierre@canonical.com> # # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation; version 3. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty 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, see <http://www.gnu.org/licenses/>. PK ! �C�v. v. % cli/__pycache__/sriov.cpython-310.pycnu �[��� o � ed�F � @ s� d dl Z d dlZd dlZd dlZd dlmZ d dlm mZ d dl m Z d dl m Z d dl Z G dd� de�Zdeje fdd�Zdeje d eje fd d �Zd d � Zdd� Zdd� Zdd� Zdd� Zddd�Zddd�ZdS ) � N)� defaultdict)�ConfigurationErrorc @ s� e Zd ZdZdefdd�Zedefdd��Zedefdd ��Zd edefd d �Z edefd d��Z ede fdd��Z ede fdd��Z ede fdd��Zedefdd��Zedefdd��Zdededefd d �Zdefd d �Zd S )!� PCIDevicez.Helper class for interaction with a PCI device�pci_addrc C s || _ dS )znInitialise a new PCI device handler :param pci_addr: PCI address of device :type: str N�r )�selfr � r �'/usr/share/netplan/netplan/cli/sriov.py�__init__' s zPCIDevice.__init__�returnc C s dS )zusysfs path (can be overridden for testing) :return: full path to /sys filesystem :rtype: str z/sysr �r r r r �sys. s z PCIDevice.sysc C s t j�| jd| j�S )zq/sys path for PCI device :return: full path to PCI device in /sys filesystem :rtype: str zbus/pci/devices)�os�path�joinr r r r r r r 6 s zPCIDevice.path�subpathc C s t j�| j|�S )z�/sys subpath helper for PCI device :param subpath: subpath to construct path for :type: str :return: self.path + subpath :rtype: str )r r r )r r r r r r > s zPCIDevice.subpathc C s2 d}t j�| �d��rt j�t �| �d���}|S )zjKernel driver for PCI device :return: kernel driver in use for device :rtype: str � �driver)r r �existsr �basename�readlink)r r r r r r G s zPCIDevice.driverc C � t j�| �d��S )z�Determine if device is bound to a kernel driver :return: whether device is bound to a kernel driver :rtype: bool r �r r r r r r r r �boundR � zPCIDevice.boundc C r )zwDetermine if device is a SR-IOV Physical Function :return: whether device is a PF :rtype: bool � sriov_numvfsr r r r r �is_pfZ r zPCIDevice.is_pfc C r )zvDetermine if device is a SR-IOV Virtual Function :return: whether device is a VF :rtype: bool �physfnr r r r r �is_vfb r zPCIDevice.is_vfc C sR g }d} z|� tj�t�| �d�|����� W n ty# Y |S w |d7 }q)z�List Virtual Function addresses associated with a Physical Function :return: List of PCI addresses of Virtual Functions :rtype: list[str] r Tzvirtfn{}� )�appendr r r r r �format�FileNotFoundError)r �vf_addrs�ir r r r# j s �� ��zPCIDevice.vf_addrsc C s dd� | j D �S )z�List Virtual Function associated with a Physical Function :return: List of PCI devices of Virtual Functions :rtype: list[PCIDevice] c S s g | ]}t |��qS r )r )�.0�addrr r r � <listcomp>� s z!PCIDevice.vfs.<locals>.<listcomp>)r# r r r r �vfs~ s z PCIDevice.vfs�obj_name�prop�valuec C s$ t �dd|dd�| j�||g� dS )z�Set devlink options for the PCI device :param obj_name: devlink object to set options on :type: str :param prop: property to set :type: str :param value: value to set for property :type: str z /sbin/devlink�dev�setzpci/{}N)� subprocess� check_callr! r )r r) r* r+ r r r � devlink_set� s ��zPCIDevice.devlink_setc C s | j S )zbString represenation of object :return: PCI address of string :rtype: str r r r r r �__str__� s zPCIDevice.__str__N)�__name__� __module__� __qualname__�__doc__�strr �propertyr r r r �boolr r r �listr# r( r0 r1 r r r r r $ s, r r( c C s^ g }| D ](}|j s,td�|�d��}|�|j� |�|� W d � n1 s'w Y q|S )zBind unbound VFs to driver.z /sys/bus/pci/drivers/{}/bind�wtN�r �openr! �writer r )r( r � bound_vfs�vf�fr r r �bind_vfs� � ��rA r c C s^ g }| D ](}|j r,td�|�d��}|�|j� |�|� W d � n1 s'w Y q|S )z Unbind bound VFs from driver.z /sys/bus/pci/drivers/{}/unbindr: Nr; )r( r � unbound_vfsr? r@ r r r � unbind_vfs� rB rD c C s� ||vrD|| }|j r<|j}|r|| v r|||< n+| D ] }|j|t�|�t�|�d�s,q||v r6td| ��|||< qn|| v rD|||< |�|d �S )N)�itf_name� itf_driver�itf_macz3matched more than one interface for a PF device: %s)� has_match�set_name�match_interface�utils�get_interface_driver_name�get_interface_macaddressr �get)� interfaces�np_state�pf_link�pfs�pf_devrI � interfacer r r �_get_target_interface� s( � � rU c C s� t j�d| d�}z?t|��0}d}|�� D ] }|�� }|�d�r3|�dd�d }| W d � W S qW d � W dS 1 s@w Y W dS ty] } z t d| t |�f ��d}~ww ) z5 Read PCI slot name for given interface name �/sys/class/netz device/ueventNzPCI_SLOT_NAME=�=� r z'failed parsing PCI slot name for %s: %s) r r r r< � readlines�strip� startswith�split�IOError� RuntimeErrorr6 )�netdev� uevent_pathr@ � pci_slot_name�line�er r r �_get_pci_slot_name� s" ��&���rd c C s� |j �� D ]>\}}|jrt| ||jj|�rd||< z|j}W n tjy0 } zt|j � �d}~ww |dkr6qt| |||�} | rC||| < qdS )z� Go through the list of netplan ethernet devices and identify which are PFs and VFs, matching the former with actual networking interfaces. Count how many VFs each PF will need. Nr ) � ethernets�items� sriov_linkrU �id�vf_count� libnetplan�LibNetplanExceptionr �args) rO rP � vf_countsr( rR �nid�netdef�countrc �pfr r r �get_vf_count_and_functions� s ����rr c C s" |dkr t d| |f ��tj�d| d�}tj�|d�}tj�|d�}z t|��}t|�� �� �}W d � n1 s:w Y W n" tyV } z t d| t |�f ��d}~w t yb t d | ��w ||krpt d | ||f ��z!t|d ��}|� t |�� W d � W d S 1 s�w Y W d S t�y } zrd }|j d kr�t�d| � z8t|d �� }|� d� W d � n1 s�w Y t|d ��}|� t |�� W d � n1 s�w Y W n ty� } z| }W Y d} ~ nd} ~ ww d}|�rt d|| t |�f ��W Y d}~d S d}~ww )zB Allocate the required number of VFs for the selected PF. � zDcannot allocate more VFs for PF %s than the SR-IOV maximum: %s > 256rV �devicer �sriov_totalvfsNz(failed parsing sriov_totalvfs for %s: %sz#invalid sriov_totalvfs value for %szKcannot allocate more VFs for PF %s than supported: %s > %s (sriov_totalvfs)�wT� zLdevice or resource busy while setting sriov_numvfs for %s, trying workaround�0Fz,failed setting sriov_numvfs to %s for %s: %s)r r r r r< �int�readrZ r] r^ r6 � ValueErrorr= �errno�logging�warning) rq ri �devdir� numvfs_path� totalvfs_pathr@ �vf_maxrc �bail�e_innerr r r �set_numvfs_for_pf sh � ��� � � ��� � ���� ���r� c C s� t j�d| d�}zHtt j�|d���}|�� �� dd� }W d � n1 s'w Y tt j�|d���}|�� �� dd� }W d � n1 sJw Y W n tyf } z td| t|�f ��d}~ww d�||g�}d}||v rw dS dS ) z� Perform any hardware-specific quirks for the given SR-IOV device to make sure all the VF-count changes are applied. rV rt �vendorrX Nz2could not determine vendor and device ID of %s: %s�:r ) r r r r< rz rZ r] r^ r6 )rq r r@ � device_id� vendor_idrc � combined_id� quirk_devicesr r r � perform_hardware_specific_quirks1 s$ � ���� �r� �/c C s� d}t j�|d|d�}t j�t �|��}t j�|d| d�}t �|�D ]"} d| v rDt j�|| �} t j�t �| ��} | |krD| dd� } nq"|sOtd||f ��ztjddd d | d |d t |�g tj tj d � W dS tj yu td| ��w )z@ Apply the hardware VLAN filtering for the selected VF. Nz sys/class/netrt �virtfn� zAcould not determine the VF index for %s while configuring vlan %s�ip�linkr- r, r? �vlan)�stdout�stderrzJfailed setting SR-IOV VLAN filter for vlan %s (ip link set command failed)) r r r r r �listdirr^ r. r/ r6 �DEVNULL�CalledProcessError) rq r? � vlan_name�vlan_id�prefix�vf_index� vf_devdir� vf_dev_id� pf_devdirr@ �dev_path�dev_idr r r �apply_vlan_filter_for_vfN s< � � � ���r� c C sR t �� }|�|� t �� }|�|� | �� t�� }| j}t t �}i }i }t |||||� g }|rE|� � D ]\} } t | | �s?q5|�| � q5|rT|D ]} t| � qIt�� }|D ]/} || } | jr}|D ]} | j| d�r{| |v rw|| rwtd| ��| || < qaqV| |v r�| || < qV|� � D ]O\}}|| } | j}|dv r�t|�}t|�}|jr�t�d�||j�� |jr�| j }zt |j|j � |� dd|� W |s�t |j|j � q�|s�t |j|j � w w q�t!� }|j"� � D ]D\}} | j#�r&| j$}| j%}|�&|j'�} | �st�(d||j'f � q�|�&|j)j'�} | |v �rtd| |j'|f ��t*| | ||� |�+| � q�d S ) z Go through all interfaces, identify which ones are SR-IOV VFs, create them and perform all other necessary setup. )rE z3matched more than one interface for a VF device: %s)� switchdev�legacyzFound VFs of {}: {}�eswitch�modezKSR-IOV vlan defined for %s but link %s is either not a VF or has no matcheszJinterface %s for netplan device %s (%s) already has an SR-IOV vlan definedN),rj �Parser�load_yaml_hierarchy�State�import_parser_results�parse� netifacesrO rP r ry rr rf r� r r� rH rJ r �embedded_switch_moderd r r r} �debugr! r# r( � delay_virtual_functions_rebindrD r r0 rA r- �vlans�has_sriov_vlan_filter� vlan_linkr� rN rh r~ rg r� �add)�config_manager�rootdir�parserrP rO rm r( rR �vf_count_changedrq ri r? ro rT � netdef_id�iface� eswitch_moder �pcidev�rebind_delayed�filtered_vlans_setr� r� r� r r r �apply_sriov_configu s� � ������� � � ��r� )r� )r} r r. �typing� collectionsr �netplan.cli.utils�clirK �netplan.libnetplanrj �netplan.configmanagerr r� �objectr �IterablerA rD rU rd rr r� r� r� r� r r r r �<module> s& !/ 'PK ! ��M]� � ( cli/__pycache__/__init__.cpython-310.pycnu �[��� o � ed� � @ s d S )N� r r r �*/usr/share/netplan/netplan/cli/__init__.py�<module> s PK ! 6�'ǣ � % cli/__pycache__/utils.cpython-310.pycnu �[��� o � ed�& � @ s@ d dl Z d dlZd dlZd dlZd dlZd dlZd dlZd dlZd dlm Z d dl m Z d dlm Z dZdZe e efZdd� Zdd � Zd d � Zd ed efdd�Zdd� Zdd� Zd3dd�Zd3dededefdd�Z d d � Z d d � Z d d!� Z d"d#� Z d$d%� Z!d&d'� Z"d(d)� Z#d3d*d+�Z$d,d-� Z%d.efd/d0�Z&G d1d2� d2ej'�Z(dS )4� N)�ConfigurationError)�LibNetplanExceptionzNetworkManager.servicez+snap.network-manager.networkmanager.servicec C s t j�dd�S )N�NETPLAN_GENERATE_PATHz /usr/libexec/netplan/generate)�os�environ�get� r r �'/usr/share/netplan/netplan/cli/utils.py�get_generator_path& s r c C s t jdddtgt jd�dkS )N� systemctl�--quiet� is-enabled)�stderrr )� subprocess�call�NM_SNAP_SERVICE_NAME�DEVNULLr r r r �is_nm_snap_enabled* s r c C s t jdg| t jt jd� d S )N�nmcli��stdoutr �r � check_callr ��argsr r r r . s r r �returnc C s t jdg| dd�S )Nr T��text)r � check_outputr r r r � nmcli_out4 s r c C s, zt dg� W dS ttjfy Y dS w )z"Check if NetworkManager is running�generalTF)r �OSErrorr �SubprocessErrorr r r r � nm_running: s �r# c C s� t �d�}t� }| D ]3}t|d��$}|D ]}|�|�}|r-|�tt�||�d���� nqW d � n1 s8w Y q |S )Nz^interface-name=(.*)$�r� ) �re�compile�set�open�match�update�fnmatch�filter�group)�paths�devices�pat� interfaces�path�f�line�mr r r � nm_interfacesD s �� ��r7 Fc C s" t � r t| tg|�S t| tg|�S �N)r r r �NM_SERVICE_NAME)�action�syncr r r �systemctl_network_managerR s r< r: �servicesr; c C s> t |�dkr d| g}|s|�d� |�|� t�|� d S d S )Nr% r z --no-block)�len�append�extendr r )r: r= r; �commandr r r r Z s �r c C s^ t � } tjg d�dd�}|�� D ] }|�� �d�}|d �� r,|d dvr,| �|d � q| S )N)� networkctlz --no-pagerz --no-legendTr � r ���)� unmanaged�linger)r( r r � splitlines�strip�split� isnumeric�add)r2 �outr5 �sr r r �networkd_interfacesf s �rN c C s t �ddg� d S )NrB �reload�r r r r r r �networkctl_reloadp s rQ c C s* t | �dkrt�ddgt| � � d S d S )Nr% rB � reconfigure)r> r r �list)r2 r r r �networkctl_reconfiguret s �rT c C s t �ddd| g�dkr dS dS )z4Return True if at least one matching unit is runningr r z is-activer TF)r r )� unit_patternr r r �systemctl_is_activey s rV c C s8 t jdd| gt jt jdd�}|jdkrd|jv rdS dS )z5Return True if output is "masked" or "masked-runtime"r r T)r r r r �maskedF)r �run�PIPE� returncoder )rU �resr r r �systemctl_is_masked� s �r\ c C s t �ddg� dS )zEReload systemd unit files from disk and re-calculate its dependenciesr z daemon-reloadNrP r r r r �systemctl_daemon_reload� s r] c C s t jddd| gt jt jd� dS )z8Flush all IP addresses of a given interface via iproute2�ip�addr�flushr Nr )�ifacer r r � ip_addr_flush� s rb c C s t j�d| �}|r\z6tt j�|d���#}|�� �� }|dkr/t�d| |� W d � W d S W d � n1 s9w Y W n ty[ } zt� d| t |�� W Y d }~d S d }~ww zt j� t j�|dd��}t j� |�}W |S ty� } zt�d| |t |�� W Y d }~d S d }~ww ) Nz/sys/class/net� operstate�downz'device %s operstate is %s, not changingz$Cannot determine operstate of %s: %s�device�driverz0Cannot replug %s: cannot read link %s/device: %s) r r3 �joinr) �readrH �logging�debug�IOError�error�str�realpath�basename)� interface� only_down�devdirr4 �state�erf � driver_namer r r �get_interface_driver_name� s4 � �������rv c C s& t �| ��t ji g�d }|�dd�S )Nr r_ � )� netifaces� ifaddressesr �AF_LINK)rp �linkr r r �get_interface_macaddress� s r| r2 c sR t � tj�sJ �� js J �tt� fdd�| ��}t|�dkr%t�|� d S |d S )Nc s � j | t| �t| �d�S )N)�itf_name� itf_driver�itf_mac)�match_interfacerv r| )�itf��netdefr r �<lambda>� s �z%find_matching_iface.<locals>.<lambda>r% r ) � isinstance�np� NetDefinition� has_matchrS r- r> ri �info)r2 r� �matchesr r� r �find_matching_iface� s � r� c @ sF e Zd Zddd�Zdd� Zdd� Zd d � Zd d � Zd d� Zdd� Z dS )�NetplanCommandTFc C s� || _ || _|| _|| _d | _d| _d| _d | _i | _d | _ d | _ t j dt jd |f |dd�| _| jjdddd � | jjd dt jd � |sb| jjd d d d�| _| jjdddd�}|j| jd� d S d S )NFz%s %sr T)�prog� description�add_helpz--debug� store_truezEnable debug messages)r: �helpz --breakpointzAvailable commandsrw � subcommand)�title�metavar�destr� zShow this help message)r� r� )�func)� command_idr� � leaf_command�testing�_argsrj � breakpoint� commandclass� subcommandsr� r� �argparse�ArgumentParser�sys�argv�parser� add_argument�SUPPRESS�add_subparsers� subparsers� add_parser� set_defaults� print_usage)�selfr� r� �leafr� �p_helpr r r �__init__� s> � � ����zNetplanCommand.__init__c C s || _ d S r8 )r� )r� r r r r r+ � s zNetplanCommand.updatec C sF | j j| j| d�\}| _| js | js!tdtjd� | �� d S d S d S )N)r � namespacez You need to specify a command��file) r� �parse_known_argsr� r� r� �printr� r r� )r� �nsr r r � parse_args� s �zNetplanCommand.parse_argsc C sD | j r | j �| j� | jrd| jv r| �� | jr t� | �� d S )Nr� )r� r+ r� r� r� r� r� �r� r r r � run_command� s zNetplanCommand.run_commandc C s | j jtjd� t�tj� d S )Nr� )r� � print_helpr� r �exitr �EX_USAGEr� r r r r� � s zNetplanCommand.print_usagec C s� |� }i | j |< || j | d< || j | d< |jr"tj�dd �s"d S | jj|j|j|jdd�}|j |j |d� || j | d< d S )N�class�instance�ENABLE_TEST_COMMANDSF)r� r� r� )r� r� r� ) r� r� r r r r� r� r� r� r� rX )r� �namer� r� �pr r r �_add_subparser_from_class� s �z(NetplanCommand._add_subparser_from_classc C s@ dd l }|�|�D ]\}}|�|�r t|t�r | �||� q d S )Nr )�inspect� getmembers�isclass� issubclassr� r� )r� � submodulesr� r� �objr r r �_import_subcommands s ��z"NetplanCommand._import_subcommandsN)TF) �__name__� __module__� __qualname__r� r+ r� r� r� r� r� r r r r r� � s r� )F))r� r ri r� r rx r, r& �netplan.libnetplan� libnetplanr� �netplan.configmanagerr r r9 r � RuntimeError� config_errorsr r r rS rm r r# r7 r< �boolr rN rQ rT rV r\ r] rb rv r| r� � Namespacer� r r r r �<module> sB PK ! ��_ � � # cli/__pycache__/ovs.cpython-310.pycnu �[��� o � ed� � @ s� d dl Z d dlZd dlZd dlZd dlmZ dZdZddd�Zddd d �Z G d d � d e �Z d d� Z dd� Z dd� Zdd� Zdd� Zdd� Zdd� ZdS )� N)�systemctl_is_activez/usr/bin/ovs-vsctlzovsdb-server.service�false)�mcast_snooping_enable� rstp_enable)�del-sslzget-ssl)z del-fail-modez get-fail-mode)zdel-controllerzget-controller)zset-sslz set-fail-modezset-controllerc @ s e Zd ZdS )�OvsDbServerNotRunningN)�__name__� __module__� __qualname__� r r �%/usr/share/netplan/netplan/cli/ovs.pyr * s r c C s` t �|�}|du rt�td| |||g� dS |r,||kr.t�td| |d||f g� dS dS dS )z2Cleanup values from a column (i.e. "column=value")N�remove�setz%s=%s)�DEFAULTS�get� subprocess� check_call�OPENVSWITCH_OVS_VSCTL)�type�iface�column�value�defaultr r r �_del_col. s �r c C s t �td| |||t|�g� dS )z:Cleanup values from a dictionary (i.e. "column:key=value")r N)r r r � _escape_colon)r r r �keyr r r r � _del_dict9 s r c C s t �dd| �S )Nz([^\\]):z\g<1>\:)�re�sub)�literalr r r r @ s r c s� t �|d�\}}|dkrd}|rBt|g}t|g}|r$|�|� |�|� tj|dd�� t� fdd�|�d�D ��r@t�|� dS dS t d |��) z*Cleanup commands from the global namespace)NNr NT��textc 3 s � | ]}|� v V qd S )Nr )�.0�item��outr r � <genexpr>^ s � z _del_global.<locals>.<genexpr>�,zReset command unknown for:) �GLOBALSr r �appendr � check_output�all�splitr � Exception)r r r r �del_cmd�get_cmd�args_get�args_delr r$ r � _del_globalD s � r2 c C s� |� dd�}|d }|dkr t|�dkr t| ||d |� n t|�dkr1t| ||d |d |� n t| ||d |� t�td| |d|g� dS )zDCheck if this setting is in a dict or a colum and delete accordingly�/� � �globalr � external-idsN)r, �lenr2 r r r r r )r r �settingr r, �colr r r � clear_settingd s r; c C s( t |t�sJ �|�| d �}|o|jdkS )N� OpenVSwitch)� isinstance�dictr �backend)r �np_interface_dict�np_defr r r �is_ovs_interfacer s rB c C s� t t�s td�t���| �� t� }| j�� D ] }t|| j�r$|� |� qt j � t �r�dD ]Q}tjt ddddddd |d g d d �}|�� D ]8}d |v r}|�d�d }||v rWqE|d dkrrt�t d|g�jd krrt�t dd|g� qEt�t d|d |g� qEq-dD ]a}d} |dkr�d} n|dkr�d} tjt d| dddddd |g d d �}|�� D ]9}d|v r�d }|} |dkr�|�dd�\}} | �d ��d �D ]} | �d�r�d | v r�| �d d�\} } t||| | � q�q�q�d!S |s�|r�t�d � d!S d!S )"aQ Query OpenVSwitch state through 'ovs-vsctl' and filter for netplan=true tagged ports/bonds and bridges. Delete interfaces which are not defined in the current configuration. Also filter for individual settings tagged netplan/<column>[/<key]=value in external-ids and clear them if they have been set by netplan. z{} is not running))�Portzdel-port)�Bridge�del-br)� InterfacerE z--columns=name,external-idsz-f�csvz-d�barez --no-headings�listr Tr z netplan=truer' rF z br-existsz --if-existszdel-bond-ifacer5 )rC rD rF � Open_vSwitch� Controllerzname,external-idsrJ r7 rK z_uuid,external-idsz --columns=%sznetplan/�.�"� �=zAovs-vsctl is missing, cannot tear down old OpenVSwitch interfacesN)r � OPENVSWITCH_OVSDB_SERVER_UNITr �format�parser �all_defs�keysrB �add�os�path�isfiler r r* � splitlinesr, �run� returncoder �strip� startswithr; �logging�warning)�config_manager�ovs_old� ovs_current� ovs_ifaces�i�tr% �liner �cols�extids�entryr9 �valr r r �apply_ovs_cleanupx sh � �� "�� �� ����rk )r^ rV r r �netplan.cli.utilsr r rP r r( r- r r r r r2 r; rB rk r r r r �<module> s, �� PK ! �Ƿ@a a $ cli/__pycache__/core.cpython-310.pycnu �[��� o � ed� � @ s@ d Z ddlZddlZddlm mZ dZG dd� dej�ZdS )znetplan command line� Nz/usr/bin:/snap/binc s0 e Zd Z� fdd�Z� fdd�Zdd� Z� ZS )�Netplanc s0 t � jdddd� tj�dt�dt�d�� d S )N� z Network configuration in YAMLF)� command_id� description�leaf�C�PATH)�LC_ALLr )�super�__init__�os�environ�update�getenv� FALLBACK_PATH��self�� __class__� �&/usr/share/netplan/netplan/cli/core.pyr s � �zNetplan.__init__c s$ dd l }| �|jj� t� �� d S )Nr )�netplan.cli.commands�_import_subcommands�cli�commandsr � parse_args)r �netplanr r r r ( s zNetplan.parse_argsc C sF | � � | jrtjtjdd� dtjd< ntjtjdd� | �� d S )Nz%(levelname)s:%(message)s)�level�format�all�G_MESSAGES_DEBUGz %(message)s) r �debug�logging� basicConfig�DEBUGr r �INFO� run_commandr r r r �main/ s z Netplan.main)�__name__� __module__� __qualname__r r r' � __classcell__r r r r r s r ) �__doc__r" r �netplan.cli.utilsr �utilsr �NetplanCommandr r r r r �<module> s PK ! P�e�� � cli/core.pynu �[��� #!/usr/bin/python3 # # Copyright (C) 2018 Canonical, Ltd. # Author: Martin Pitt <martin.pitt@ubuntu.com> # Author: Mathieu Trudel-Lapierre <mathieu.trudel-lapierre@canonical.com> # # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation; version 3. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty 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, see <http://www.gnu.org/licenses/>. '''netplan command line''' import logging import os import netplan.cli.utils as utils FALLBACK_PATH = '/usr/bin:/snap/bin' class Netplan(utils.NetplanCommand): def __init__(self): super().__init__(command_id='', description='Network configuration in YAML', leaf=False) os.environ.update({ 'LC_ALL': 'C', 'PATH': os.getenv('PATH', FALLBACK_PATH)}) def parse_args(self): import netplan.cli.commands self._import_subcommands(netplan.cli.commands) super().parse_args() def main(self): self.parse_args() if self.debug: logging.basicConfig(level=logging.DEBUG, format='%(levelname)s:%(message)s') os.environ['G_MESSAGES_DEBUG'] = 'all' else: logging.basicConfig(level=logging.INFO, format='%(message)s') self.run_command() PK ! sx9Ň& �& cli/utils.pynu �[��� # Copyright (C) 2018-2020 Canonical, Ltd. # Author: Mathieu Trudel-Lapierre <mathieu.trudel-lapierre@canonical.com> # Author: Łukasz 'sil2100' Zemczak <lukasz.zemczak@canonical.com> # Author: Lukas 'slyon' Märdian <lukas.maerdian@canonical.com> # # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation; version 3. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty 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, see <http://www.gnu.org/licenses/>. import sys import os import logging import argparse import subprocess import netifaces import fnmatch import re import netplan.libnetplan as np from netplan.configmanager import ConfigurationError from netplan.libnetplan import LibNetplanException NM_SERVICE_NAME = 'NetworkManager.service' NM_SNAP_SERVICE_NAME = 'snap.network-manager.networkmanager.service' config_errors = (ConfigurationError, LibNetplanException, RuntimeError) def get_generator_path(): return os.environ.get('NETPLAN_GENERATE_PATH', '/usr/libexec/netplan/generate') def is_nm_snap_enabled(): return subprocess.call(['systemctl', '--quiet', 'is-enabled', NM_SNAP_SERVICE_NAME], stderr=subprocess.DEVNULL) == 0 def nmcli(args): # pragma: nocover (covered in autopkgtest) # 'nmcli' could be /usr/bin/nmcli or /snap/bin/nmcli -> /snap/bin/network-manager.nmcli # PATH is defined in cli/core.py subprocess.check_call(['nmcli'] + args, stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL) def nmcli_out(args: list) -> str: # pragma: nocover (covered in autopkgtest) # 'nmcli' could be /usr/bin/nmcli or /snap/bin/nmcli -> /snap/bin/network-manager.nmcli # PATH is defined in cli/core.py return subprocess.check_output(['nmcli'] + args, text=True) def nm_running(): # pragma: nocover (covered in autopkgtest) '''Check if NetworkManager is running''' try: nmcli(['general']) return True except (OSError, subprocess.SubprocessError): return False def nm_interfaces(paths, devices): pat = re.compile('^interface-name=(.*)$') interfaces = set() for path in paths: with open(path, 'r') as f: for line in f: m = pat.match(line) if m: # Expand/match globbing of interface names, to real devices interfaces.update(set(fnmatch.filter(devices, m.group(1)))) break # skip to next file return interfaces def systemctl_network_manager(action, sync=False): # If the network-manager snap is installed use its service # name rather than the one of the deb packaged NetworkManager if is_nm_snap_enabled(): return systemctl(action, [NM_SNAP_SERVICE_NAME], sync) return systemctl(action, [NM_SERVICE_NAME], sync) # pragma: nocover (covered in autopkgtest) def systemctl(action: str, services: list, sync: bool = False): if len(services) >= 1: command = ['systemctl', action] if not sync: command.append('--no-block') command.extend(services) subprocess.check_call(command) def networkd_interfaces(): interfaces = set() out = subprocess.check_output(['networkctl', '--no-pager', '--no-legend'], text=True) for line in out.splitlines(): s = line.strip().split(' ') if s[0].isnumeric() and s[-1] not in ['unmanaged', 'linger']: interfaces.add(s[0]) return interfaces def networkctl_reload(): subprocess.check_call(['networkctl', 'reload']) def networkctl_reconfigure(interfaces): if len(interfaces) >= 1: subprocess.check_call(['networkctl', 'reconfigure'] + list(interfaces)) def systemctl_is_active(unit_pattern): '''Return True if at least one matching unit is running''' if subprocess.call(['systemctl', '--quiet', 'is-active', unit_pattern]) == 0: return True return False def systemctl_is_masked(unit_pattern): '''Return True if output is "masked" or "masked-runtime"''' res = subprocess.run(['systemctl', 'is-enabled', unit_pattern], stdout=subprocess.PIPE, stderr=subprocess.PIPE, text=True) if res.returncode > 0 and 'masked' in res.stdout: return True return False def systemctl_daemon_reload(): '''Reload systemd unit files from disk and re-calculate its dependencies''' subprocess.check_call(['systemctl', 'daemon-reload']) def ip_addr_flush(iface): '''Flush all IP addresses of a given interface via iproute2''' subprocess.check_call(['ip', 'addr', 'flush', iface], stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL) def get_interface_driver_name(interface, only_down=False): # pragma: nocover (covered in autopkgtest) devdir = os.path.join('/sys/class/net', interface) if only_down: try: with open(os.path.join(devdir, 'operstate')) as f: state = f.read().strip() if state != 'down': logging.debug('device %s operstate is %s, not changing', interface, state) return None except IOError as e: logging.error('Cannot determine operstate of %s: %s', interface, str(e)) return None try: driver = os.path.realpath(os.path.join(devdir, 'device', 'driver')) driver_name = os.path.basename(driver) except IOError as e: logging.debug('Cannot replug %s: cannot read link %s/device: %s', interface, devdir, str(e)) return None return driver_name def get_interface_macaddress(interface): # return an empty list (and string) if no LL data can be found link = netifaces.ifaddresses(interface).get(netifaces.AF_LINK, [{}])[0] return link.get('addr', '') def find_matching_iface(interfaces: list, netdef): assert isinstance(netdef, np.NetDefinition) assert netdef.has_match matches = list(filter(lambda itf: netdef.match_interface( itf_name=itf, itf_driver=get_interface_driver_name(itf), itf_mac=get_interface_macaddress(itf)), interfaces)) # Return current name of unique matched interface, if available if len(matches) != 1: logging.info(matches) return None return matches[0] class NetplanCommand(argparse.Namespace): def __init__(self, command_id, description, leaf=True, testing=False): self.command_id = command_id self.description = description self.leaf_command = leaf self.testing = testing self._args = None self.debug = False self.breakpoint = False self.commandclass = None self.subcommands = {} self.subcommand = None self.func = None self.parser = argparse.ArgumentParser(prog="%s %s" % (sys.argv[0], command_id), description=description, add_help=True) self.parser.add_argument('--debug', action='store_true', help='Enable debug messages') self.parser.add_argument('--breakpoint', action='store_true', help=argparse.SUPPRESS) if not leaf: self.subparsers = self.parser.add_subparsers(title='Available commands', metavar='', dest='subcommand') p_help = self.subparsers.add_parser('help', description='Show this help message', help='Show this help message') p_help.set_defaults(func=self.print_usage) def update(self, args): self._args = args def parse_args(self): ns, self._args = self.parser.parse_known_args(args=self._args, namespace=self) if not self.subcommand and not self.leaf_command: print('You need to specify a command', file=sys.stderr) self.print_usage() def run_command(self): if self.commandclass: self.commandclass.update(self._args) # TODO: (cyphermox) this is actually testable in tests/cli.py; add it. if self.leaf_command and 'help' in self._args: # pragma: nocover (covered in autopkgtest) self.print_usage() if self.breakpoint: # pragma: nocover (cannot be automatically tested) breakpoint() self.func() def print_usage(self): self.parser.print_help(file=sys.stderr) sys.exit(os.EX_USAGE) def _add_subparser_from_class(self, name, commandclass): instance = commandclass() self.subcommands[name] = {} self.subcommands[name]['class'] = name self.subcommands[name]['instance'] = instance if instance.testing: if not os.environ.get('ENABLE_TEST_COMMANDS', None): return p = self.subparsers.add_parser(instance.command_id, description=instance.description, help=instance.description, add_help=False) p.set_defaults(func=instance.run, commandclass=instance) self.subcommands[name]['parser'] = p def _import_subcommands(self, submodules): import inspect for name, obj in inspect.getmembers(submodules): if inspect.isclass(obj) and issubclass(obj, NetplanCommand): self._add_subparser_from_class(name, obj) PK ! �8�� � cli/ovs.pynu �[��� #!/usr/bin/python3 # # Copyright (C) 2020 Canonical, Ltd. # Author: Lukas 'slyon' Märdian <lukas.maerdian@canonical.com> # # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation; version 3. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty 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, see <http://www.gnu.org/licenses/>. import logging import os import subprocess import re from netplan.cli.utils import systemctl_is_active OPENVSWITCH_OVS_VSCTL = '/usr/bin/ovs-vsctl' OPENVSWITCH_OVSDB_SERVER_UNIT = 'ovsdb-server.service' # Defaults for non-optional settings, as defined here: # http://www.openvswitch.org/ovs-vswitchd.conf.db.5.pdf DEFAULTS = { # Mandatory columns: 'mcast_snooping_enable': 'false', 'rstp_enable': 'false', } GLOBALS = { # Global commands: 'set-ssl': ('del-ssl', 'get-ssl'), 'set-fail-mode': ('del-fail-mode', 'get-fail-mode'), 'set-controller': ('del-controller', 'get-controller'), } class OvsDbServerNotRunning(Exception): pass def _del_col(type, iface, column, value): """Cleanup values from a column (i.e. "column=value")""" default = DEFAULTS.get(column) if default is None: # removes the exact value only if it was set by netplan subprocess.check_call([OPENVSWITCH_OVS_VSCTL, 'remove', type, iface, column, value]) elif default and default != value: # reset to default, if its not the default already subprocess.check_call([OPENVSWITCH_OVS_VSCTL, 'set', type, iface, '%s=%s' % (column, default)]) def _del_dict(type, iface, column, key, value): """Cleanup values from a dictionary (i.e. "column:key=value")""" # removes the exact value only if it was set by netplan subprocess.check_call([OPENVSWITCH_OVS_VSCTL, 'remove', type, iface, column, key, _escape_colon(value)]) # for ovsdb remove: column key's value can not contain bare ':', need to escape with '\' def _escape_colon(literal): return re.sub(r'([^\\]):', r'\g<1>\:', literal) def _del_global(type, iface, key, value): """Cleanup commands from the global namespace""" del_cmd, get_cmd = GLOBALS.get(key, (None, None)) if del_cmd == 'del-ssl': iface = None if del_cmd: args_get = [OPENVSWITCH_OVS_VSCTL, get_cmd] args_del = [OPENVSWITCH_OVS_VSCTL, del_cmd] if iface: args_get.append(iface) args_del.append(iface) # Check the current value of a global command and compare it to the tag-value, e.g.: # * get-ssl: netplan/global/set-ssl=/private/key.pem,/another/cert.pem,/some/ca-cert.pem # Private key: /private/key.pem # Certificate: /another/cert.pem # CA Certificate: /some/ca-cert.pem # Bootstrap: false # * get-fail-mode: netplan/global/set-fail-mode=secure # secure # * get-controller: netplan/global/set-controller=tcp:127.0.0.1:1337,unix:/some/socket # tcp:127.0.0.1:1337 # unix:/some/socket out = subprocess.check_output(args_get, text=True) # Clean it only if the exact same value(s) were set by netplan. # Don't touch it if other values were set by another integration. if all(item in out for item in value.split(',')): subprocess.check_call(args_del) else: raise Exception('Reset command unknown for:', key) def clear_setting(type, iface, setting, value): """Check if this setting is in a dict or a colum and delete accordingly""" split = setting.split('/', 2) col = split[1] if col == 'global' and len(split) > 2: _del_global(type, iface, split[2], value) elif len(split) > 2: _del_dict(type, iface, split[1], split[2], value) else: _del_col(type, iface, split[1], value) # Cleanup the tag itself (i.e. "netplan/column[/key]") subprocess.check_call([OPENVSWITCH_OVS_VSCTL, 'remove', type, iface, 'external-ids', setting]) def is_ovs_interface(iface, np_interface_dict): assert isinstance(np_interface_dict, dict) np_def = np_interface_dict.get(iface, None) return np_def and np_def.backend == 'OpenVSwitch' def apply_ovs_cleanup(config_manager, ovs_old, ovs_current): # pragma: nocover (covered in autopkgtest) """ Query OpenVSwitch state through 'ovs-vsctl' and filter for netplan=true tagged ports/bonds and bridges. Delete interfaces which are not defined in the current configuration. Also filter for individual settings tagged netplan/<column>[/<key]=value in external-ids and clear them if they have been set by netplan. """ if not systemctl_is_active(OPENVSWITCH_OVSDB_SERVER_UNIT): raise OvsDbServerNotRunning('{} is not running'.format(OPENVSWITCH_OVSDB_SERVER_UNIT)) config_manager.parse() ovs_ifaces = set() for i in config_manager.all_defs.keys(): if (is_ovs_interface(i, config_manager.all_defs)): ovs_ifaces.add(i) # Tear down old OVS interfaces, not defined in the current config. # Use 'del-br' on the Interface table, to delete any netplan created VLAN fake bridges. # Use 'del-bond-iface' on the Interface table, to delete netplan created patch port interfaces if os.path.isfile(OPENVSWITCH_OVS_VSCTL): # Step 1: Delete all interfaces, which are not part of the current OVS config for t in (('Port', 'del-port'), ('Bridge', 'del-br'), ('Interface', 'del-br')): out = subprocess.check_output([OPENVSWITCH_OVS_VSCTL, '--columns=name,external-ids', '-f', 'csv', '-d', 'bare', '--no-headings', 'list', t[0]], text=True) for line in out.splitlines(): if 'netplan=true' in line: iface = line.split(',')[0] # Skip cleanup if this OVS interface is part of the current netplan OVS config if iface in ovs_ifaces: continue if t[0] == 'Interface' and subprocess.run([OPENVSWITCH_OVS_VSCTL, 'br-exists', iface]).returncode > 0: subprocess.check_call([OPENVSWITCH_OVS_VSCTL, '--if-exists', 'del-bond-iface', iface]) else: subprocess.check_call([OPENVSWITCH_OVS_VSCTL, '--if-exists', t[1], iface]) # Step 2: Clean up the settings of the remaining interfaces for t in ('Port', 'Bridge', 'Interface', 'Open_vSwitch', 'Controller'): cols = 'name,external-ids' if t == 'Open_vSwitch': cols = 'external-ids' elif t == 'Controller': cols = '_uuid,external-ids' # handle _uuid as if it would be the iface 'name' out = subprocess.check_output([OPENVSWITCH_OVS_VSCTL, '--columns=%s' % cols, '-f', 'csv', '-d', 'bare', '--no-headings', 'list', t], text=True) for line in out.splitlines(): if 'netplan/' in line: iface = '.' extids = line if t != 'Open_vSwitch': iface, extids = line.split(',', 1) # Check each line (interface) if it contains any netplan tagged settings, e.g.: # ovs0,"iface-id=myhostname netplan=true netplan/external-ids/iface-id=myhostname" # ovs1,"netplan=true netplan/global/set-fail-mode=standalone netplan/mcast_snooping_enable=false" for entry in extids.strip('"').split(' '): if entry.startswith('netplan/') and '=' in entry: setting, val = entry.split('=', 1) clear_setting(t, iface, setting, val) # Show the warning only if we are or have been working with OVS definitions elif ovs_old or ovs_current: logging.warning('ovs-vsctl is missing, cannot tear down old OpenVSwitch interfaces') PK ! ed::� � $ __pycache__/terminal.cpython-310.pycnu �[��� o � ed� � @ s` d Z ddlZddlZddlZddlZddlZG dd� de�ZG dd� de�Z G dd� de�Z dS ) z Terminal / input handling � Nc @ sV e Zd ZdZdd� Zdd� Zdd� Zdd � Zd d � Zddd�Z ddd�Z ddd�Z d S )�Terminalz@ Do minimal terminal mangling to prompt users for input c C s || _ d | _d | _| �� d S �N)�fd� orig_flags� orig_term�save)�selfr � r �&/usr/share/netplan/netplan/terminal.py�__init__" s zTerminal.__init__c C sT t j�� r(t�| j�}|d tjB |d< |d tjB |d< t�| jtj |� d S d S �N� � �sys�stdin�isatty�termios� tcgetattrr �ICANON�ECHO� tcsetattr�TCSANOW�r �attrsr r r � enable_echo( s �zTerminal.enable_echoc C sX t j�� r*t�| j�}|d tj @ |d< |d tj @ |d< t�| jtj |� d S d S r r r r r r � disable_echo/ s �zTerminal.disable_echoc C s, t � | jt j�}t � | jt j|tjB � d S r ��fcntlr �F_GETFL�F_SETFL�os� O_NONBLOCK�r �flagsr r r �enable_nonblocking_io6 s z Terminal.enable_nonblocking_ioc C s. t � | jt j�}t � | jt j|tj @ � d S r r r" r r r �disable_nonblocking_io: s z Terminal.disable_nonblocking_io�x Nc C s� t d� t� }| �|� | �� | �� |sd}t d�|�� |}|dkrbt d�|tt|���dd� t�t j gg g d� zt j � � }|d krO| � |� t � �W n tyY Y nw |d8 }|dks%| � |� t� �) a� Get a "confirmation" input from the user, for at most (timeout) seconds. Optionally, customize the message to be displayed. timeout -- timeout to wait for input (default 120) message -- optional customized message ("Press ENTER to (message)") raises: InputAccepted -- the user confirmed the changes InputRejected -- the user rejected the changes z%Do you want to keep these settings? z accept the new configurationz&Press ENTER before the timeout to {} r z%Changes will revert in {:>{}} seconds� )�end� � )�print�dictr r r$ �format�len�str�selectr r �read�reset� InputAccepted� TypeError� InputRejected)r �timeout�message�settings� timeout_now�cr r r �get_confirmation_input> s2 � �� z Terminal.get_confirmation_inputc C sV t � | jt j�}d}tj�� rt�| j�}|dur#|�||d�� dS || _ || _ dS )z� Save the terminal's current attributes and flags Optional argument: - dest: if set, save settings to this dict N)r# �term) r r r r r r r r �updater r )r �destr r r r r r p s � z Terminal.savec C sd d}d}|dur|� d�}|� d�}n| j}| j}tj�� r't�| jtj |� t � | jt j |� dS )z� Reset the terminal to its original attributes and flags Optional argument: - orig: if set, reset to settings from this dict Nr< r# ) �getr r r r r r r r � TCSAFLUSHr r )r �origr r r r r r2 � s zTerminal.reset)r& Nr ) �__name__� __module__� __qualname__�__doc__r r r r$ r% r; r r2 r r r r r s 2r c @ � e Zd ZdZdS )r3 z Denotes has accepted inputN�rB rC rD rE r r r r r3 � � r3 c @ rF )r5 z) Denotes that the user has rejected inputNrG r r r r r5 � rH r5 ) rE r r r r0 r �objectr � Exceptionr3 r5 r r r r �<module> s yPK ! �^V�� � ) __pycache__/configmanager.cpython-310.pycnu �[��� o � ed� � @ sh d Z ddlZddlZddlZddlZddlZddlmZ ddlm Z G dd� de �Z G dd� de �Z dS ) z netplan configuration manager� N)�Optional)� libnetplanc @ s� e Zd Zdi fdd�Zdd� Zedd� �Zedd � �Zd d d �Zd d� Z d dd�Z dd� Z dd� Z dd� Z dd� Zd dd �Zd S ) � ConfigManager�/c C sP || _ tjdd�| _tj�| jd�| _tj�| jd�| _|| _ t � | _ d | _ d S )N�netplan_)�prefix�etc�run) r �tempfile�mkdtemp�tempdir�os�path�join�temp_etc�temp_run� extra_files�set�new_interfaces�np_state)�selfr r � r �+/usr/share/netplan/netplan/configmanager.py�__init__ s zConfigManager.__init__c C s | j d us J d��t| j |�S �Nz.Must call parse() before accessing the config.)r �getattr)r �attrr r r � __getattr__) s zConfigManager.__getattr__c C sD | j d us J d��i }|�| j j� |�| j j� |�| j j� |S r )r �update� ethernets�modems�wifis�r � interfacesr r r �physical_interfaces- s z!ConfigManager.physical_interfacesc C s` | j d us J d��i }|�| j j� |�| j j� |�| j j� |�| j j� |�| j j� |S r )r r �bridges�bonds�tunnels�vlans�vrfsr" r r r �virtual_interfaces6 s z ConfigManager.virtual_interfacesNc C s~ t �� }z |j| jd� |r|D ]}|�|� qt �� | _| j�|� W n t jy6 } zt |j � �d}~ww | j� � | jS )z� Parse all our config files to return an object that describes the system's entire configuration, so that it can later be interrogated. Returns a libnetplan State wrapper )�rootdirN) r �Parser�load_yaml_hierarchyr � load_yaml�Stater �import_parser_results�LibNetplanException�ConfigurationError�args� dump_to_logs)r � extra_config�parser�f�er r r �parseB s �� zConfigManager.parsec C s0 |D ] }| � ||| � q| j�|� d | _d S �N)� _copy_filer r r )r � config_dict� config_filer r r �add[ s zConfigManager.addTc C s� |r| � tj�| jd�tj�| jd�� | j tj�| jd�tj�| jdd�dd� | j tj�| jd�tj�| jd d �dd� d S ) Nz etc/netplan�netplan�%run/NetworkManager/system-connections�NetworkManagerzsystem-connectionsT)� missing_ok�run/systemd/network�systemd�network)� _copy_treer r r r r r )r �backup_config_dirr r r �backupc s �� �zConfigManager.backupc C s z`t | j�D ]}t�| j| � | j|= qd�| j�}d�| j�}tj�|�r>t� tj� | j d�� | � |tj� | j d�� tj�|�r^t� tj� | j d�� | � |tj� | j d�� W d S W d S t y� } zt�d�|�� t�d� t�d� W Y d }~d S d }~ww )Nz${}/NetworkManager/system-connectionsz{}/systemd/networkr@ rC z8Something really bad happened while reverting config: {}zZYou should verify the netplan YAML in /etc/netplan and probably run 'netplan apply' again.���)�dictr r �unlink�formatr r �exists�shutil�rmtreer r rF � Exception�logging�error�sys�exit)r � extra_file� temp_nm_path�temp_networkd_pathr8 r r r �revertn s. � �� ��zConfigManager.revertc C s t �| j� d S r: )rN rO r �r r r r �cleanup� � zConfigManager.cleanupc C s$ z| � � W d S ty Y d S w r: )rZ �FileNotFoundErrorrY r r r �__del__� s �zConfigManager.__del__c C s t �||� d S r: )rN �copy)r �src�dstr r r r; � r[ zConfigManager._copy_fileFc C s. z t �||� W d S ty |rY d S � w r: )rN �copytreer\ )r r_ r` rB r r r rF � s �zConfigManager._copy_treer: )T)F)�__name__� __module__� __qualname__r r �propertyr$ r* r9 r> rH rX rZ r] r; rF r r r r r s r c @ s e Zd ZdZdS )r2 zL Configuration could not be parsed or has otherwise failed to apply N)rb rc rd �__doc__r r r r r2 � s r2 )rf rQ r rN rS r �typingr r? r �objectr rP r2 r r r r �<module> s PK ! K��� � $ __pycache__/__init__.cpython-310.pycnu �[��� o � ed� � @ s d dl mZ egZdS )� )�NetplanN)�netplan.cli.corer �__all__� r r �&/usr/share/netplan/netplan/__init__.py�<module> s PK ! >Q>�B �B & __pycache__/libnetplan.cpython-310.pycnu �[��� o � edPH � @ s� d dl Z d dlZd dlZd dlZd dlmZmZmZmZmZm Z d dl m Z m Z m Z G dd� de�ZG dd� dej�ZG dd � d ej�ZG d d � d ej�ZG d d � d ej�Ze�ej�d��Ze�e�e��Ze�e�Ze�e�Z e�e�Z ejej _ dd� Z dd� Z!G dd� d�Z"G dd� d�Z#G dd� d�Z$G dd� d�Z%eeeegej&_'eej&_ eeeegej(_'eej(_ de e) d e)fd d �Z*d d � Z+dS )!� N)�c_char_p�c_void_p�c_int�c_uint�c_size_t� c_ssize_t)�List�Union�IOc @ � e Zd ZdS )�LibNetplanExceptionN��__name__� __module__� __qualname__� r r �(/usr/share/netplan/netplan/libnetplan.pyr � r c @ s$ e Zd ZdejfdefdefgZdS )�_GError�domain�code�messageN)r r r �ctypes�c_uint32r r �_fields_r r r r r s r c @ r )�_netplan_stateNr r r r r r # r r c @ r )�_netplan_parserNr r r r r r ' r r c @ r )�_netplan_net_definitionNr r r r r r + r r �netplanc C sd d}|dk r.t �|�}| |�}|dkr|d }q|dk r"td| ��|dkr(d S |j�d�S td��) N� i ���� r zUnknown error: %d�utf-8z&Halting due to string buffer size > 1M)r �create_string_bufferr �value�decode)�function�size�bufferr r r r � _string_realloc_call_no_error9 s r) c G sB t �t�� }t| g |�t �|��R � �}|s t|jj�d���d S �Nr" ) r �POINTERr �bool�byrefr �contentsr r% )�fn�args�err�retr r r �_checked_lib_callK s �r3 c @ sj e Zd ZdZedd� �Zdd� Zdd� Zdee e f fd d �Z d d � Z de fd d�Z de de fdd�ZdS )�ParserFc C s� | j rd S ttj_t�t�gtj_tt t gtj _t tj _tt t gtj _t tj _tt t gtj_t tj_tt t t gtj_t tj_d| _ d S �NT)� _abi_loaded�_NetplanParserP�lib�netplan_parser_new�restyper r+ �netplan_parser_clear�argtypesr � _GErrorPP�netplan_parser_load_yamlr � netplan_parser_load_yaml_from_fd�#netplan_parser_load_nullable_fields�&netplan_parser_load_nullable_overrides��clsr r r � _load_abiU s � zParser._load_abic C � | � � t�� | _d S �N)rD r8 r9 �_ptr��selfr r r �__init__l � zParser.__init__c C � t �t�| j�� d S rF )r8 r; r r- rG rH r r r �__del__p � zParser.__del__� input_filec C s< t |t�rttj| j|�d�� d S ttj| j|�� � d S r* ) � isinstance�strr3 r8 r> rG �encoder? �fileno�rI rO r r r � load_yamls s zParser.load_yamlc C s t tj| j|�d�� d S r* )r3 r8 �"netplan_parser_load_yaml_hierarchyrG rR )rI �rootdirr r r �load_yaml_hierarchyy s zParser.load_yaml_hierarchyc C s t tj| j|�� � d S rF )r3 r8 r@ rG rS rT r r r �load_nullable_fields| s zParser.load_nullable_fields� constraintc C s t tj| j|�� |�d�� d S r* )r3 r8 rA rG rS rR )rI rO rZ r r r �load_nullable_overrides s �z Parser.load_nullable_overridesN)r r r r6 � classmethodrD rJ rM r rQ r rU rX rY r[ r r r r r4 R s r4 c @ s� e Zd ZdZedd� �Zdd� Zdd� Zdd � Zd d � Z d d � Z dd� Z dd� Z dd� Z edd� �Zedd� �Zedd� �Zedd� �Zed d � �Zed d � �Zed d!� �Zed"d#� �Zed$d%� �Zed&d'� �Zed(d)� �Zed*d+� �Zd,d-� Zd.S )/�StateFc C s� | j rd S ttj_t�t�gtj_tt t gtj _t tj _tgtj _t tj _ttgtj_ttj_tttt gtj_t tj_tttt gtj_t tj_tt t gtj_t tj_tgtj_ttj_tgtj_t tj_tgtj_t tj_d| _ d S r5 )r6 �_NetplanStatePr8 �netplan_state_newr: r r+ �netplan_state_clearr< r7 r= �#netplan_state_import_parser_resultsr � netplan_state_get_netdefs_sizer �netplan_state_get_netdef�_NetplanNetDefinitionP� netplan_state_write_yaml_file�#netplan_state_update_yaml_hierarchy�netplan_state_dump_yaml�'netplan_netdef_get_embedded_switch_mode�1netplan_netdef_get_delay_virtual_functions_rebind�netplan_state_get_backendrB r r r rD � s. zState._load_abic C rE rF )rD r8 r_ rG rH r r r rJ � rK zState.__init__c C rL rF )r8 r` r r- rG rH r r r rM � rN z State.__del__c C s t tj| j|j� d S rF )r3 r8 ra rG )rI �parserr r r �import_parser_results� rN zState.import_parser_resultsc C s: |r|� d�nd }|r|� d�nd }ttj| j||� d S r* )rR r3 r8 re rG )rI �filenamerW �name�rootr r r �write_yaml_file� s zState.write_yaml_filec C s2 |� d�}|r |� d�nd }ttj| j||� d S r* )rR r3 r8 rf rG )rI �default_filenamerW rn ro r r r �update_yaml_hierarchy� s zState.update_yaml_hierarchyc C s |� � }ttj| j|� d S rF )rS r3 r8 rg rG )rI � output_file�fdr r r � dump_yaml� s zState.dump_yamlc C s t �| j�S rF )r8 rb rG rH r r r �__len__� s z State.__len__c C s( t �| j|�d��}|st� �t| |�S r* )r8 rc rG rR � IndexError� NetDefinition)rI �def_id�ptrr r r � __getitem__� s zState.__getitem__c C s t dd� t| d �D ��S )Nc s � � | ]}|j |fV qd S rF ��id��.0�ndr r r � <genexpr>� � � z!State.all_defs.<locals>.<genexpr>��dict�_NetdefIteratorrH r r r �all_defs� � zState.all_defsc C � t dd� t| d�D ��S )Nc s r| rF r} r r r r r� � r� z"State.ethernets.<locals>.<genexpr>� ethernetsr� rH r r r r� � r� zState.ethernetsc C r� )Nc s r| rF r} r r r r r� � r� z State.modems.<locals>.<genexpr>�modemsr� rH r r r r� � r� z State.modemsc C r� )Nc s r| rF r} r r r r r� � r� z State.wifis.<locals>.<genexpr>�wifisr� rH r r r r� � r� z State.wifisc C r� )Nc s r| rF r} r r r r r� � r� z State.vlans.<locals>.<genexpr>�vlansr� rH r r r r� � r� z State.vlansc C r� )Nc s r| rF r} r r r r r� � r� z State.bridges.<locals>.<genexpr>�bridgesr� rH r r r r� � r� z State.bridgesc C r� )Nc s r| rF r} r r r r r� � r� z State.bonds.<locals>.<genexpr>�bondsr� rH r r r r� � r� z State.bondsc C r� )Nc s r| rF r} r r r r r� � r� z State.tunnels.<locals>.<genexpr>�tunnelsr� rH r r r r� � r� z State.tunnelsc C r� )Nc s r| rF r} r r r r r� � r� z State.vrfs.<locals>.<genexpr>�vrfsr� rH r r r r� � r� z State.vrfsc C r� )Nc s r| rF r} r r r r r� � r� z"State.ovs_ports.<locals>.<genexpr>z _ovs-portsr� rH r r r � ovs_ports� r� zState.ovs_portsc C r� )Nc s r| rF r} r r r r r� � r� z#State.nm_devices.<locals>.<genexpr>z nm-devicesr� rH r r r � nm_devices� r� zState.nm_devicesc C � t �t �| j���d�S r* )r8 �netplan_backend_namerj rG r% rH r r r �backend� r� z State.backendc C sN t �� �}| j|d� t�d�|�� �� W d � d S 1 s w Y d S )N)rs zMerged config: {})�tempfile� TemporaryFileru �logging�debug�format�read)rI �tmpr r r � dump_to_logs� s "�zState.dump_to_logsN) r r r r6 r\ rD rJ rM rl rp rr ru rv r{ �propertyr� r� r� r� r� r� r� r� r� r� r� r� r� r r r r r] � sJ $ r] c @ s e Zd ZdZedd� �Zdd� Zdd� Zedd � �Z ed d � �Z ed d � �Z edd� �Z edd� �Z edd� �Zedd� �Zedd� �Zedd� �Zedd� �Zed d � �Zed d � �Zed d!� �Zed"d#� �Zed$d%� �Zed&d'� �Zd/d)d*�Zed+d,� �Zed-d.� �Zd(S )0rx Fc C sz | j rd S tgtj_ttj_tttgtj _t tj _tttgtj _t tj _tgtj _ttj _tgtj _ttj _tttgtj_t tj_tgtj_ttj_tgtj_ttj_tgtj_ttj_tgtj_ttj_tgtj_ttj_tgtj_ttj_tgtj_ttj_tgtj_ttj_tgtj_ttj_tgtj_ttj_tgtj_ttj_ttt gtj _ttj _tgtj _ttj _d| _ d S r5 ) r6 rd r8 �netplan_netdef_has_matchr< r r: r r �netplan_netdef_get_idr �netplan_netdef_get_filepath�netplan_netdef_get_backend�netplan_netdef_get_type�netplan_netdef_get_set_name� _netplan_netdef_get_critical� netplan_netdef_get_sriov_link� netplan_netdef_get_vlan_link� netplan_netdef_get_bridge_link� netplan_netdef_get_bond_link� netplan_netdef_get_peer_link�_netplan_netdef_get_vlan_idr �%_netplan_netdef_get_sriov_vlan_filter� netplan_netdef_match_interfacer� �netplan_def_type_namer^ r= �#_netplan_state_get_vf_count_for_def�'_netplan_netdef_is_trivial_compound_itfrB r r r rD sR zNetDefinition._load_abic C s* t |d�sdS t�| jj�t�|jj�kS )NrG F)�hasattrr � addressofrG r. )rI �otherr r r �__eq__G s zNetDefinition.__eq__c C s | � � || _|| _d S rF )rD rG �_parent)rI �np_staterz r r r rJ L s zNetDefinition.__init__c C � t t�| j��S rF )r, r8 r� rG rH r r r � has_matchS � zNetDefinition.has_matchc � t � fdd��S )Nc � t �� j| t| ��S rF )r8 r� rG �len��brH r r �<lambda>Y � z(NetDefinition.set_name.<locals>.<lambda>�r) rH r rH r �set_nameW r� zNetDefinition.set_namec C r� rF )r, r8 r� rG rH r r r �critical[ r� zNetDefinition.criticalc C � t �| j�}|rt| j|�S d S rF )r8 r� rG rx r� �rI �link_ptrr r r � sriov_link_ � zNetDefinition.sriov_linkc C r� rF )r8 r� rG rx r� r� r r r � vlan_linkf r� zNetDefinition.vlan_linkc C r� rF )r8 r� rG rx r� r� r r r � bridge_linkm r� zNetDefinition.bridge_linkc C r� rF )r8 r� rG rx r� r� r r r � bond_linkt r� zNetDefinition.bond_linkc C r� rF )r8 r� rG rx r� r� r r r � peer_link{ r� zNetDefinition.peer_linkc C s" t �| j�}|td�jkrd S |S )N���)r8 r� rG r r$ )rI �vlan_idr r r r� � s zNetDefinition.vlan_idc C r� rF )r, r8 r� rG rH r r r �has_sriov_vlan_filter� r� z#NetDefinition.has_sriov_vlan_filterc C r� r* )r8 r� r� rG r% rH r r r r� � r� zNetDefinition.backendc C r� r* )r8 r� r� rG r% rH r r r �type� r� zNetDefinition.typec r� )Nc r� rF )r8 r� rG r� r� rH r r r� � r� z"NetDefinition.id.<locals>.<lambda>r� rH r rH r r~ � r� zNetDefinition.idc r� )Nc r� rF )r8 r� rG r� r� rH r r r� � r� z(NetDefinition.filepath.<locals>.<lambda>r� rH r rH r �filepath� r� zNetDefinition.filepathc C s t �| j�}|o |�d�S r* )r8 rh rG r% )rI �moder r r �embedded_switch_mode� s z"NetDefinition.embedded_switch_modec C r� rF )r, r8 ri rG rH r r r � delay_virtual_functions_rebind� r� z,NetDefinition.delay_virtual_functions_rebindNc C s4 t t�| j|o |�d�|o|�d�|o|�d���S r* )r, r8 r� rG rR )rI �itf_name� itf_driver�itf_macr r r �match_interface� s �z NetDefinition.match_interfacec C sD t �t�� }t�| jj| jt �|��}|dk r t|j j � d���|S )Nr r" ) r r+ r r8 r� r� rG r- r r. r r% )rI r1 �countr r r �vf_count� s zNetDefinition.vf_countc C r� )z� Returns True if the interface is a compound interface (bond or bridge), and its configuration is trivial, without any variation from the defaults. )r, r8 r� rG rH r r r �is_trivial_compound_itf� s z%NetDefinition.is_trivial_compound_itf)NNN) r r r r6 r\ rD r� rJ r� r� r� r� r� r� r� r� r� r� r� r� r� r~ r� r� r� r� r� r� r r r r rx sV ? rx c @ s< e Zd ZdZedd� �Zdd� Zdd� Zdd � Zd d � Z d S ) r� Fc C sp | j rd S ttd�std��ttgtj_ttj_ tgtj _t tj _ tgtj _d tj _ tgtj _ttj _ d| _ d S )N�#_netplan_iter_defs_per_devtype_initz� The current version of libnetplan does not allow iterating by devtype. Please ensure that both the netplan CLI package and its library are up to date. T)r6 r� r8 r r^ r �&_netplan_state_new_netdef_pertype_iterr< r r: �#_netplan_iter_defs_per_devtype_nextrd �#_netplan_iter_defs_per_devtype_free�_netplan_netdef_idrB r r r rD � s z_NetdefIterator._load_abic C s, | � � || _t�|j|o|�d��| _d S r* )rD r� r8 r� rG rR �iterator)rI r� �devtyper r r rJ � s z_NetdefIterator.__init__c C s t �| j� d S rF )r8 r� r� rH r r r rM � s z_NetdefIterator.__del__c C s | S rF r rH r r r �__iter__� s z_NetdefIterator.__iter__c C s t �| j�}|s t�t| j|�S rF )r8 r� r� � StopIterationrx r� )rI � next_valuer r r �__next__� s z_NetdefIterator.__next__N) r r r r6 r\ rD rJ rM r� r� r r r r r� � s r� �patch_object_path� patch_payloadc C s* t tjd�| ��d�|�d�|�� � d S )N� r" )r3 r8 � netplan_util_create_yaml_patch�joinrR rS )r� r� � patch_outputr r r �create_yaml_patch� s �r� c C s" t tj| �d�|�� |�� � d S r* )r3 r8 � netplan_util_dump_yaml_subtreerR rS )�prefixrO rs r r r �dump_yaml_subtree� s �r� ),r� r� r � ctypes.utilr r r r r r �typingr r r � Exceptionr � Structurer r r r �CDLL�util� find_libraryr8 r+ r= r7 r^ rd � netplan_get_id_from_nm_filenamer: r) r3 r4 r] rx r� r� r< r� rQ r� r� r r r r �<module> s> 2 <. PK ! gU p p % __pycache__/_features.cpython-310.pycnu �[��� o ���d[ � @ s g d �Z dS ))zdhcp-use-domainsz auth-phase2zipv6-mtu�modems�sriov� openvswitchzactivation-modez eswitch-mode� infiniband�regdom�vrf�vxlanz dbus-configzgenerate-just-in-timezgenerated-supplicantzdefault-routesN)�NETPLAN_FEATURE_FLAGS� r r �'/usr/share/netplan/netplan/_features.py�<module> s PK ! ^^�[ [ _features.pynu �[��� # Generated file NETPLAN_FEATURE_FLAGS = [ "dhcp-use-domains", "auth-phase2", "ipv6-mtu", "modems", "sriov", "openvswitch", "activation-mode", "eswitch-mode", "infiniband", "regdom", "vrf", "vxlan", "dbus-config", "generate-just-in-time", "generated-supplicant", "default-routes", ] PK ! �u� � 50-cloud-init.yamlnu �[��� PK ! � G�� � < netplan/configmanager.pynu �[��� PK ! ���� � ( netplan/terminal.pynu �[��� PK ! ��PH PH &0 netplan/libnetplan.pynu �[��� PK ! �i-� � �x netplan/__init__.pynu �[��� PK ! �$<�O �O �{ netplan/cli/commands/apply.pynu �[��� PK ! �2�9c c <� netplan/cli/commands/ip.pynu �[��� PK ! �E�� � �� netplan/cli/commands/info.pynu �[��� PK ! ��~��k �k �� netplan/cli/commands/status.pynu �[��� PK ! I��O �O �Z netplan/cli/commands/migrate.pynu �[��� PK ! Fﱗ� � � netplan/cli/commands/__init__.pynu �[��� PK ! ��6 & & 6 � netplan/cli/commands/__pycache__/apply.cpython-310.pycnu �[��� PK ! �!��� � = � netplan/cli/commands/__pycache__/sriov_rebind.cpython-310.pycnu �[��� PK ! 5s'�) �) 8 �� netplan/cli/commands/__pycache__/migrate.cpython-310.pycnu �[��� PK ! �*�AxJ xJ 7 � netplan/cli/commands/__pycache__/status.cpython-310.pycnu �[��� PK ! %]3+� � 9 �S netplan/cli/commands/__pycache__/generate.cpython-310.pycnu �[��� PK ! �ĉ�Z Z 9 \ netplan/cli/commands/__pycache__/__init__.cpython-310.pycnu �[��� PK ! <��y y 3 �_ netplan/cli/commands/__pycache__/ip.cpython-310.pycnu �[��� PK ! �Cy�� � < �r netplan/cli/commands/__pycache__/try_command.cpython-310.pycnu �[��� PK ! ~$�T� � 5 � netplan/cli/commands/__pycache__/info.cpython-310.pycnu �[��� PK ! ���I� � 4 ,� netplan/cli/commands/__pycache__/get.cpython-310.pycnu �[��� PK ! ���n4 4 4 W� netplan/cli/commands/__pycache__/set.cpython-310.pycnu �[��� PK ! �q�� � � netplan/cli/commands/get.pynu �[��� PK ! �P+'� � # #� netplan/cli/commands/try_command.pynu �[��� PK ! &�Fx x 5� netplan/cli/commands/set.pynu �[��� PK ! ?�[/� � $ �� netplan/cli/commands/sriov_rebind.pynu �[��� PK ! $��)� � �� netplan/cli/commands/generate.pynu �[��� PK ! ��](�F �F � netplan/cli/sriov.pynu �[��� PK ! � � � &F netplan/cli/__init__.pynu �[��� PK ! �C�v. v. - .I netplan/cli/__pycache__/sriov.cpython-310.pycnu �[��� PK ! ��M]� � 0 x netplan/cli/__pycache__/__init__.cpython-310.pycnu �[��� PK ! 6�'ǣ � - �x netplan/cli/__pycache__/utils.cpython-310.pycnu �[��� PK ! ��_ � � + � netplan/cli/__pycache__/ovs.cpython-310.pycnu �[��� PK ! �Ƿ@a a , � netplan/cli/__pycache__/core.cpython-310.pycnu �[��� PK ! P�e�� � �� netplan/cli/core.pynu �[��� PK ! sx9Ň& �& x� netplan/cli/utils.pynu �[��� PK ! �8�� � C� netplan/cli/ovs.pynu �[��� PK ! ed::� � , ' netplan/__pycache__/terminal.cpython-310.pycnu �[��� PK ! �^V�� � 1 a netplan/__pycache__/configmanager.cpython-310.pycnu �[��� PK ! K��� � , t# netplan/__pycache__/__init__.cpython-310.pycnu �[��� PK ! >Q>�B �B . �$ netplan/__pycache__/libnetplan.cpython-310.pycnu �[��� PK ! gU p p - �g netplan/__pycache__/_features.cpython-310.pycnu �[��� PK ! ^^�[ [ �i netplan/_features.pynu �[��� PK ! !��b 'k netplan.scriptnu ȯ�� PK ! 8��� � �n generatenu ȯ�� PK ! ���8 �8 � netplan-dbusnu ȯ�� PK ! �ߐ4 4 �P 00-snapd-config.yamlnu �[��� PK ! ѽ���1 �1 R netplan.htmlnu �[��� PK ! �b�qj j B� examples/vlan.yamlnu �[��� PK ! � ��} } � examples/ipv6_tunnel.yamlnu �[��� PK ! ��V� � �� examples/bonding_router.yamlnu �[��� PK ! ���� � ͌ examples/bonding.yamlnu �[��� PK ! 0� L� � � examples/bridge.yamlnu �[��� PK ! ���[ [ ! � examples/windows_dhcp_server.yamlnu �[��� PK ! ݞ�� � ) �� examples/direct_connect_gateway_ipv6.yamlnu �[��� PK ! �*^)0 0 Ő examples/vrf.yamlnu �[��� PK ! $��PW W 6� examples/openvswitch.yamlnu �[��� PK ! !�Ɖ3 3 ֖ examples/offload.yamlnu �[��� PK ! dn��� � N� examples/infiniband.yamlnu �[��� PK ! ���xh h k� examples/modem.yamlnu �[��� PK ! �FR~� � � examples/wireguard.yamlnu �[��� PK ! �mc�1 1 � examples/network_manager.yamlnu �[��� PK ! I߬�� � $ �� examples/direct_connect_gateway.yamlnu �[��� PK ! U?F^� � ! �� examples/static_multiaddress.yamlnu �[��� PK ! �,�� � �� examples/vxlan.yamlnu �[��� PK ! (M�Zr r �� examples/wireless.yamlnu �[��� PK ! ����+ + Z� examples/sriov.yamlnu �[��� PK ! ��1~ ~ ȧ examples/loopback_interface.yamlnu �[��� PK ! ��*ݿ � �� examples/route_metric.yamlnu �[��� PK ! Ӆ�Y Y 3 �� examples/static_singlenic_multiip_multigateway.yamlnu �[��� PK ! �!)1 1 [� examples/source_routing.yamlnu �[��� PK ! \��; ; ح examples/sriov_vlan.yamlnu �[��� PK ! qفiV V [� examples/dhcp.yamlnu �[��� PK ! �5�8� � � examples/bridge_vlan.yamlnu �[��� PK ! r|ף 1� examples/static.yamlnu �[��� PK ! jhm� � �� examples/dhcp_wired8021x.yamlnu �[��� PK ! �[ �� examples/wpa_enterprise.yamlnu �[��� PK ! � G�� � � configmanager.pynu �[��� PK ! ���� � �� terminal.pynu �[��� PK ! ��PH PH �� libnetplan.pynu �[��� PK ! �i-� � i- __init__.pynu �[��� PK ! �$<�O �O �0 cli/commands/apply.pynu �[��� PK ! �2�9c c ڀ cli/commands/ip.pynu �[��� PK ! �E�� � � cli/commands/info.pynu �[��� PK ! ��~��k �k }� cli/commands/status.pynu �[��� PK ! I��O �O P cli/commands/migrate.pynu �[��� PK ! Fﱗ� � �_ cli/commands/__init__.pynu �[��� PK ! ��6 & & . �e cli/commands/__pycache__/apply.cpython-310.pycnu �[��� PK ! �!��� � 5 � cli/commands/__pycache__/sriov_rebind.cpython-310.pycnu �[��� PK ! 5s'�) �) 0 �� cli/commands/__pycache__/migrate.cpython-310.pycnu �[��� PK ! �*�AxJ xJ / K� cli/commands/__pycache__/status.cpython-310.pycnu �[��� PK ! %]3+� � 1 " cli/commands/__pycache__/generate.cpython-310.pycnu �[��� PK ! �ĉ�Z Z 1 d cli/commands/__pycache__/__init__.cpython-310.pycnu �[��� PK ! <��y y + cli/commands/__pycache__/ip.cpython-310.pycnu �[��� PK ! �Cy�� � 4 �& cli/commands/__pycache__/try_command.cpython-310.pycnu �[��� PK ! ~$�T� � - ? cli/commands/__pycache__/info.cpython-310.pycnu �[��� PK ! ���I� � , ZF cli/commands/__pycache__/get.cpython-310.pycnu �[��� PK ! ���n4 4 , }O cli/commands/__pycache__/set.cpython-310.pycnu �[��� PK ! �q�� � [ cli/commands/get.pynu �[��� PK ! �P+'� � 9f cli/commands/try_command.pynu �[��� PK ! &�Fx x C� cli/commands/set.pynu �[��� PK ! ?�[/� � �� cli/commands/sriov_rebind.pynu �[��� PK ! $��)� � � cli/commands/generate.pynu �[��� PK ! ��](�F �F � cli/sriov.pynu �[��� PK ! � � � � cli/__init__.pynu �[��� PK ! �C�v. v. % � cli/__pycache__/sriov.cpython-310.pycnu �[��� PK ! ��M]� � ( �+ cli/__pycache__/__init__.cpython-310.pycnu �[��� PK ! 6�'ǣ � % �, cli/__pycache__/utils.cpython-310.pycnu �[��� PK ! ��_ � � # �M cli/__pycache__/ovs.cpython-310.pycnu �[��� PK ! �Ƿ@a a $ �_ cli/__pycache__/core.cpython-310.pycnu �[��� PK ! P�e�� � fe cli/core.pynu �[��� PK ! sx9Ň& �& .l cli/utils.pynu �[��� PK ! �8�� � � cli/ovs.pynu �[��� PK ! ed::� � $ ͳ __pycache__/terminal.cpython-310.pycnu �[��� PK ! �^V�� � ) �� __pycache__/configmanager.cpython-310.pycnu �[��� PK ! K��� � $ � __pycache__/__init__.cpython-310.pycnu �[��� PK ! >Q>�B �B & "� __pycache__/libnetplan.cpython-310.pycnu �[��� PK ! gU p p % A __pycache__/_features.cpython-310.pycnu �[��� PK ! ^^�[ [ _features.pynu �[��� PK w w 0, �
| ver. 1.4 |
Github
|
.
| PHP 8.3.30 | Generation time: 0.84 |
proxy
|
phpinfo
|
Settings