/* SPDX-License-Identifier: LGPL-2.1-or-later */ /* * Predictable network interface device names based on: * - firmware/bios-provided index numbers for on-board devices * - firmware-provided pci-express hotplug slot index number * - physical/geographical location of the hardware * - the interface's MAC address * * https://systemd.io/PREDICTABLE_INTERFACE_NAMES * * When the code here is changed, man/systemd.net-naming-scheme.xml must be updated too. */ #include #include #include #include #include #include #include #include #include #include "alloc-util.h" #include "chase-symlinks.h" #include "device-util.h" #include "dirent-util.h" #include "fd-util.h" #include "fileio.h" #include "netif-naming-scheme.h" #include "parse-util.h" #include "proc-cmdline.h" #include "stdio-util.h" #include "string-util.h" #include "strv.h" #include "strxcpyx.h" #include "udev-builtin.h" #include "udev-netlink.h" #define ONBOARD_14BIT_INDEX_MAX ((1U << 14) - 1) #define ONBOARD_16BIT_INDEX_MAX ((1U << 16) - 1) typedef enum NetNameType { NET_UNDEF, NET_PCI, NET_USB, NET_BCMA, NET_VIRTIO, NET_CCW, NET_VIO, NET_XENVIF, NET_PLATFORM, NET_NETDEVSIM, } NetNameType; typedef struct NetNames { NetNameType type; sd_device *pcidev; char pci_slot[ALTIFNAMSIZ]; char pci_path[ALTIFNAMSIZ]; char pci_onboard[ALTIFNAMSIZ]; const char *pci_onboard_label; char usb_ports[ALTIFNAMSIZ]; char bcma_core[ALTIFNAMSIZ]; char ccw_busid[ALTIFNAMSIZ]; char vio_slot[ALTIFNAMSIZ]; char xen_slot[ALTIFNAMSIZ]; char platform_path[ALTIFNAMSIZ]; char netdevsim_path[ALTIFNAMSIZ]; } NetNames; /* skip intermediate virtio devices */ static sd_device *skip_virtio(sd_device *dev) { /* there can only ever be one virtio bus per parent device, so we can * safely ignore any virtio buses. see * http://lists.linuxfoundation.org/pipermail/virtualization/2015-August/030331.html */ while (dev) { const char *subsystem; if (sd_device_get_subsystem(dev, &subsystem) < 0) break; if (!streq(subsystem, "virtio")) break; if (sd_device_get_parent(dev, &dev) < 0) return NULL; } return dev; } static int get_virtfn_info(sd_device *pcidev, sd_device **ret_physfn_pcidev, char **ret_suffix) { _cleanup_(sd_device_unrefp) sd_device *physfn_pcidev = NULL; const char *physfn_syspath, *syspath; _cleanup_closedir_ DIR *dir = NULL; int r; assert(pcidev); assert(ret_physfn_pcidev); assert(ret_suffix); r = sd_device_get_syspath(pcidev, &syspath); if (r < 0) return r; /* Get physical function's pci device. */ physfn_syspath = strjoina(syspath, "/physfn"); r = sd_device_new_from_syspath(&physfn_pcidev, physfn_syspath); if (r < 0) return r; r = sd_device_get_syspath(physfn_pcidev, &physfn_syspath); if (r < 0) return r; /* Find the virtual function number by finding the right virtfn link. */ dir = opendir(physfn_syspath); if (!dir) return -errno; FOREACH_DIRENT_ALL(de, dir, break) { _cleanup_free_ char *virtfn_link_file = NULL, *virtfn_pci_syspath = NULL; const char *n; n = startswith(de->d_name, "virtfn"); if (!n) continue; virtfn_link_file = path_join(physfn_syspath, de->d_name); if (!virtfn_link_file) return -ENOMEM; if (chase_symlinks(virtfn_link_file, NULL, 0, &virtfn_pci_syspath, NULL) < 0) continue; if (streq(syspath, virtfn_pci_syspath)) { char *suffix; suffix = strjoin("v", n); if (!suffix) return -ENOMEM; *ret_physfn_pcidev = TAKE_PTR(physfn_pcidev); *ret_suffix = suffix; return 0; } } return -ENOENT; } static bool is_valid_onboard_index(unsigned long idx) { /* Some BIOSes report rubbish indexes that are excessively high (2^24-1 is an index VMware likes to * report for example). Let's define a cut-off where we don't consider the index reliable anymore. We * pick some arbitrary cut-off, which is somewhere beyond the realistic number of physical network * interface a system might have. Ideally the kernel would already filter this crap for us, but it * doesn't currently. The initial cut-off value (2^14-1) was too conservative for s390 PCI which * allows for index values up 2^16-1 which is now enabled with the NAMING_16BIT_INDEX naming flag. */ return idx <= (naming_scheme_has(NAMING_16BIT_INDEX) ? ONBOARD_16BIT_INDEX_MAX : ONBOARD_14BIT_INDEX_MAX); } /* retrieve on-board index number and label from firmware */ static int dev_pci_onboard(sd_device *dev, const LinkInfo *info, NetNames *names) { unsigned long idx, dev_port = 0; const char *attr; size_t l; char *s; int r; assert(dev); assert(info); assert(names); /* ACPI _DSM — device specific method for naming a PCI or PCI Express device */ if (sd_device_get_sysattr_value(names->pcidev, "acpi_index", &attr) >= 0) log_device_debug(names->pcidev, "acpi_index=%s", attr); else { /* SMBIOS type 41 — Onboard Devices Extended Information */ r = sd_device_get_sysattr_value(names->pcidev, "index", &attr); if (r < 0) return r; log_device_debug(names->pcidev, "index=%s", attr); } r = safe_atolu(attr, &idx); if (r < 0) return log_device_debug_errno(names->pcidev, r, "Failed to parse onboard index \"%s\": %m", attr); if (idx == 0 && !naming_scheme_has(NAMING_ZERO_ACPI_INDEX)) return log_device_debug_errno(names->pcidev, SYNTHETIC_ERRNO(EINVAL), "Naming scheme does not allow onboard index==0."); if (!is_valid_onboard_index(idx)) return log_device_debug_errno(names->pcidev, SYNTHETIC_ERRNO(ENOENT), "Not a valid onboard index: %lu", idx); /* kernel provided port index for multiple ports on a single PCI function */ if (sd_device_get_sysattr_value(dev, "dev_port", &attr) >= 0) { r = safe_atolu_full(attr, 10, &dev_port); if (r < 0) log_device_debug_errno(dev, r, "Failed to parse dev_port, ignoring: %m"); log_device_debug(dev, "dev_port=%lu", dev_port); } s = names->pci_onboard; l = sizeof(names->pci_onboard); l = strpcpyf(&s, l, "o%lu", idx); if (!isempty(info->phys_port_name)) /* kernel provided front panel port name for multiple port PCI device */ l = strpcpyf(&s, l, "n%s", info->phys_port_name); else if (dev_port > 0) l = strpcpyf(&s, l, "d%lu", dev_port); if (l == 0) names->pci_onboard[0] = '\0'; log_device_debug(dev, "Onboard index identifier: index=%lu phys_port=%s dev_port=%lu → %s", idx, strempty(info->phys_port_name), dev_port, empty_to_na(names->pci_slot)); if (sd_device_get_sysattr_value(names->pcidev, "label", &names->pci_onboard_label) >= 0) log_device_debug(dev, "Onboard label from PCI device: %s", names->pci_onboard_label); else names->pci_onboard_label = NULL; return 0; } /* read the 256 bytes PCI configuration space to check the multi-function bit */ static bool is_pci_multifunction(sd_device *dev) { _cleanup_close_ int fd = -1; const char *filename, *syspath; uint8_t config[64]; if (sd_device_get_syspath(dev, &syspath) < 0) return false; filename = strjoina(syspath, "/config"); fd = open(filename, O_RDONLY | O_CLOEXEC); if (fd < 0) return false; if (read(fd, &config, sizeof(config)) != sizeof(config)) return false; /* bit 0-6 header type, bit 7 multi/single function device */ return config[PCI_HEADER_TYPE] & 0x80; } static bool is_pci_ari_enabled(sd_device *dev) { const char *a; if (sd_device_get_sysattr_value(dev, "ari_enabled", &a) < 0) return false; return streq(a, "1"); } static bool is_pci_bridge(sd_device *dev) { const char *v, *p; if (sd_device_get_sysattr_value(dev, "modalias", &v) < 0) return false; if (!startswith(v, "pci:")) return false; p = strrchr(v, 's'); if (!p) return false; if (p[1] != 'c') return false; /* PCI device subclass 04 corresponds to PCI bridge */ bool b = strneq(p + 2, "04", 2); if (b) log_device_debug(dev, "Device is a PCI bridge."); return b; } static int parse_hotplug_slot_from_function_id(sd_device *dev, const char *slots, uint32_t *ret) { uint64_t function_id; char path[PATH_MAX]; const char *attr; int r; /* The /function_id attribute is unique to the s390 PCI driver. If present, we know * that the slot's directory name for this device is /sys/bus/pci/XXXXXXXX/ where XXXXXXXX is * the fixed length 8 hexadecimal character string representation of function_id. Therefore we * can short cut here and just check for the existence of the slot directory. As this directory * has to exist, we're emitting a debug message for the unlikely case it's not found. Note that * the domain part doesn't belong to the slot name here because there's a 1-to-1 relationship * between PCI function and its hotplug slot. */ assert(dev); assert(slots); assert(ret); if (!naming_scheme_has(NAMING_SLOT_FUNCTION_ID)) return 0; if (sd_device_get_sysattr_value(dev, "function_id", &attr) < 0) return 0; r = safe_atou64(attr, &function_id); if (r < 0) return log_device_debug_errno(dev, r, "Failed to parse function_id, ignoring: %s", attr); if (function_id <= 0 || function_id > UINT32_MAX) return log_device_debug_errno(dev, SYNTHETIC_ERRNO(EINVAL), "Invalid function id (0x%"PRIx64"), ignoring.", function_id); if (!snprintf_ok(path, sizeof path, "%s/%08"PRIx64, slots, function_id)) return log_device_debug_errno(dev, SYNTHETIC_ERRNO(ENAMETOOLONG), "PCI slot path is too long, ignoring."); if (access(path, F_OK) < 0) return log_device_debug_errno(dev, errno, "Cannot access %s, ignoring: %m", path); *ret = (uint32_t) function_id; return 1; } static int dev_pci_slot(sd_device *dev, const LinkInfo *info, NetNames *names) { const char *sysname, *attr, *syspath; _cleanup_(sd_device_unrefp) sd_device *pci = NULL; _cleanup_closedir_ DIR *dir = NULL; unsigned domain, bus, slot, func; sd_device *hotplug_slot_dev; unsigned long dev_port = 0; uint32_t hotplug_slot = 0; char slots[PATH_MAX], *s; size_t l; int r; assert(dev); assert(info); assert(names); r = sd_device_get_sysname(names->pcidev, &sysname); if (r < 0) return log_device_debug_errno(names->pcidev, r, "Failed to get sysname: %m"); r = sscanf(sysname, "%x:%x:%x.%u", &domain, &bus, &slot, &func); log_device_debug(dev, "Parsing slot information from PCI device sysname \"%s\": %s", sysname, r == 4 ? "success" : "failure"); if (r != 4) return -ENOENT; if (naming_scheme_has(NAMING_NPAR_ARI) && is_pci_ari_enabled(names->pcidev)) /* ARI devices support up to 256 functions on a single device ("slot"), and interpret the * traditional 5-bit slot and 3-bit function number as a single 8-bit function number, * where the slot makes up the upper 5 bits. */ func += slot * 8; /* kernel provided port index for multiple ports on a single PCI function */ if (sd_device_get_sysattr_value(dev, "dev_port", &attr) >= 0) { log_device_debug(dev, "dev_port=%s", attr); r = safe_atolu_full(attr, 10, &dev_port); if (r < 0) log_device_debug_errno(dev, r, "Failed to parse attribute dev_port, ignoring: %m"); /* With older kernels IP-over-InfiniBand network interfaces sometimes erroneously * provide the port number in the 'dev_id' sysfs attribute instead of 'dev_port', * which thus stays initialized as 0. */ if (dev_port == 0 && info->iftype == ARPHRD_INFINIBAND && sd_device_get_sysattr_value(dev, "dev_id", &attr) >= 0) { log_device_debug(dev, "dev_id=%s", attr); r = safe_atolu_full(attr, 10, &dev_port); if (r < 0) log_device_debug_errno(dev, r, "Failed to parse attribute dev_id, ignoring: %m"); } } /* compose a name based on the raw kernel's PCI bus, slot numbers */ s = names->pci_path; l = sizeof(names->pci_path); if (domain > 0) l = strpcpyf(&s, l, "P%u", domain); l = strpcpyf(&s, l, "p%us%u", bus, slot); if (func > 0 || is_pci_multifunction(names->pcidev)) l = strpcpyf(&s, l, "f%u", func); if (!isempty(info->phys_port_name)) /* kernel provided front panel port name for multi-port PCI device */ l = strpcpyf(&s, l, "n%s", info->phys_port_name); else if (dev_port > 0) l = strpcpyf(&s, l, "d%lu", dev_port); if (l == 0) names->pci_path[0] = '\0'; log_device_debug(dev, "PCI path identifier: domain=%u bus=%u slot=%u func=%u phys_port=%s dev_port=%lu → %s", domain, bus, slot, func, strempty(info->phys_port_name), dev_port, empty_to_na(names->pci_path)); /* ACPI _SUN — slot user number */ r = sd_device_new_from_subsystem_sysname(&pci, "subsystem", "pci"); if (r < 0) return log_debug_errno(r, "sd_device_new_from_subsystem_sysname failed: %m"); r = sd_device_get_syspath(pci, &syspath); if (r < 0) return log_device_debug_errno(pci, r, "sd_device_get_syspath failed: %m"); if (!snprintf_ok(slots, sizeof slots, "%s/slots", syspath)) return log_device_debug_errno(dev, SYNTHETIC_ERRNO(ENAMETOOLONG), "Cannot access %s/slots: %m", syspath); dir = opendir(slots); if (!dir) return log_device_debug_errno(dev, errno, "Cannot access %s: %m", slots); hotplug_slot_dev = names->pcidev; while (hotplug_slot_dev) { r = parse_hotplug_slot_from_function_id(hotplug_slot_dev, slots, &hotplug_slot); if (r < 0) return 0; if (r > 0) { domain = 0; /* See comments in parse_hotplug_slot_from_function_id(). */ break; } r = sd_device_get_sysname(hotplug_slot_dev, &sysname); if (r < 0) return log_device_debug_errno(hotplug_slot_dev, r, "Failed to get sysname: %m"); FOREACH_DIRENT_ALL(de, dir, break) { _cleanup_free_ char *address = NULL; char str[PATH_MAX]; uint32_t i; if (dot_or_dot_dot(de->d_name)) continue; r = safe_atou32(de->d_name, &i); if (r < 0 || i <= 0) continue; /* match slot address with device by stripping the function */ if (snprintf_ok(str, sizeof str, "%s/%s/address", slots, de->d_name) && read_one_line_file(str, &address) >= 0 && startswith(sysname, address)) { hotplug_slot = i; /* We found the match between PCI device and slot. However, we won't use the * slot index if the device is a PCI bridge, because it can have other child * devices that will try to claim the same index and that would create name * collision. */ if (naming_scheme_has(NAMING_BRIDGE_NO_SLOT) && is_pci_bridge(hotplug_slot_dev)) { log_device_debug(dev, "Not using slot information because the PCI device is a bridge."); return 0; } break; } } if (hotplug_slot > 0) break; if (sd_device_get_parent_with_subsystem_devtype(hotplug_slot_dev, "pci", NULL, &hotplug_slot_dev) < 0) break; rewinddir(dir); } if (hotplug_slot > 0) { s = names->pci_slot; l = sizeof(names->pci_slot); if (domain > 0) l = strpcpyf(&s, l, "P%u", domain); l = strpcpyf(&s, l, "s%"PRIu32, hotplug_slot); if (func > 0 || is_pci_multifunction(names->pcidev)) l = strpcpyf(&s, l, "f%u", func); if (!isempty(info->phys_port_name)) l = strpcpyf(&s, l, "n%s", info->phys_port_name); else if (dev_port > 0) l = strpcpyf(&s, l, "d%lu", dev_port); if (l == 0) names->pci_slot[0] = '\0'; log_device_debug(dev, "Slot identifier: domain=%u slot=%"PRIu32" func=%u phys_port=%s dev_port=%lu → %s", domain, hotplug_slot, func, strempty(info->phys_port_name), dev_port, empty_to_na(names->pci_slot)); } return 0; } static int names_vio(sd_device *dev, NetNames *names) { sd_device *parent; unsigned busid, slotid, ethid; const char *syspath, *subsystem; int r; /* check if our direct parent is a VIO device with no other bus in-between */ r = sd_device_get_parent(dev, &parent); if (r < 0) return log_device_debug_errno(dev, r, "sd_device_get_parent failed: %m"); r = sd_device_get_subsystem(parent, &subsystem); if (r < 0) return log_device_debug_errno(parent, r, "sd_device_get_subsystem failed: %m"); if (!streq("vio", subsystem)) return -ENOENT; log_device_debug(dev, "Parent device is in the vio subsystem."); /* The devices' $DEVPATH number is tied to (virtual) hardware (slot id * selected in the HMC), thus this provides a reliable naming (e.g. * "/devices/vio/30000002/net/eth1"); we ignore the bus number, as * there should only ever be one bus, and then remove leading zeros. */ r = sd_device_get_syspath(dev, &syspath); if (r < 0) return log_device_debug_errno(dev, r, "sd_device_get_syspath failed: %m"); r = sscanf(syspath, "/sys/devices/vio/%4x%4x/net/eth%u", &busid, &slotid, ðid); log_device_debug(dev, "Parsing vio slot information from syspath \"%s\": %s", syspath, r == 3 ? "success" : "failure"); if (r != 3) return -EINVAL; xsprintf(names->vio_slot, "v%u", slotid); names->type = NET_VIO; log_device_debug(dev, "Vio slot identifier: slotid=%u → %s", slotid, names->vio_slot); return 0; } #define PLATFORM_TEST "/sys/devices/platform/vvvvPPPP" #define PLATFORM_PATTERN4 "/sys/devices/platform/%4s%4x:%2x/net/eth%u" #define PLATFORM_PATTERN3 "/sys/devices/platform/%3s%4x:%2x/net/eth%u" static int names_platform(sd_device *dev, NetNames *names, bool test) { sd_device *parent; char vendor[5]; unsigned model, instance, ethid; const char *syspath, *pattern, *validchars, *subsystem; int r; /* check if our direct parent is a platform device with no other bus in-between */ r = sd_device_get_parent(dev, &parent); if (r < 0) return log_device_debug_errno(dev, r, "sd_device_get_parent failed: %m"); r = sd_device_get_subsystem(parent, &subsystem); if (r < 0) return log_device_debug_errno(parent, r, "sd_device_get_subsystem failed: %m"); if (!streq("platform", subsystem)) return -ENOENT; log_device_debug(dev, "Parent device is in the platform subsystem."); r = sd_device_get_syspath(dev, &syspath); if (r < 0) return log_device_debug_errno(dev, r, "sd_device_get_syspath failed: %m"); /* syspath is too short, to have a valid ACPI instance */ if (strlen(syspath) < STRLEN(PLATFORM_TEST) + 1) return log_device_debug_errno(dev, SYNTHETIC_ERRNO(EINVAL), "Syspath \"%s\" is too short for a valid ACPI instance.", syspath); /* Vendor ID can be either PNP ID (3 chars A-Z) or ACPI ID (4 chars A-Z and numerals) */ if (syspath[STRLEN(PLATFORM_TEST)] == ':') { pattern = PLATFORM_PATTERN4; validchars = UPPERCASE_LETTERS DIGITS; } else { pattern = PLATFORM_PATTERN3; validchars = UPPERCASE_LETTERS; } /* Platform devices are named after ACPI table match, and instance id * eg. "/sys/devices/platform/HISI00C2:00"); * The Vendor (3 or 4 char), followed by hexadecimal model number : instance id. */ DISABLE_WARNING_FORMAT_NONLITERAL; r = sscanf(syspath, pattern, vendor, &model, &instance, ðid); REENABLE_WARNING; log_device_debug(dev, "Parsing platform device information from syspath \"%s\": %s", syspath, r == 4 ? "success" : "failure"); if (r != 4) return -EINVAL; if (!in_charset(vendor, validchars)) return log_device_debug_errno(dev, SYNTHETIC_ERRNO(ENOENT), "Platform vendor contains invalid characters: %s", vendor); ascii_strlower(vendor); xsprintf(names->platform_path, "a%s%xi%u", vendor, model, instance); names->type = NET_PLATFORM; log_device_debug(dev, "Platform identifier: vendor=%s model=%u instance=%u → %s", vendor, model, instance, names->platform_path); return 0; } static int names_pci(sd_device *dev, const LinkInfo *info, NetNames *names) { _cleanup_(sd_device_unrefp) sd_device *physfn_pcidev = NULL; _cleanup_free_ char *virtfn_suffix = NULL; sd_device *parent; const char *subsystem; int r; assert(dev); assert(info); assert(names); r = sd_device_get_parent(dev, &parent); if (r < 0) return r; /* skip virtio subsystem if present */ parent = skip_virtio(parent); if (!parent) return -ENOENT; /* check if our direct parent is a PCI device with no other bus in-between */ if (sd_device_get_subsystem(parent, &subsystem) >= 0 && streq("pci", subsystem)) { names->type = NET_PCI; names->pcidev = parent; } else { r = sd_device_get_parent_with_subsystem_devtype(dev, "pci", NULL, &names->pcidev); if (r < 0) return r; } if (naming_scheme_has(NAMING_SR_IOV_V) && get_virtfn_info(names->pcidev, &physfn_pcidev, &virtfn_suffix) >= 0) { NetNames vf_names = {}; /* If this is an SR-IOV virtual device, get base name using physical device and add virtfn suffix. */ vf_names.pcidev = physfn_pcidev; dev_pci_onboard(dev, info, &vf_names); dev_pci_slot(dev, info, &vf_names); if (vf_names.pci_onboard[0]) if (strlen(vf_names.pci_onboard) + strlen(virtfn_suffix) < sizeof(names->pci_onboard)) strscpyl(names->pci_onboard, sizeof(names->pci_onboard), vf_names.pci_onboard, virtfn_suffix, NULL); if (vf_names.pci_slot[0]) if (strlen(vf_names.pci_slot) + strlen(virtfn_suffix) < sizeof(names->pci_slot)) strscpyl(names->pci_slot, sizeof(names->pci_slot), vf_names.pci_slot, virtfn_suffix, NULL); if (vf_names.pci_path[0]) if (strlen(vf_names.pci_path) + strlen(virtfn_suffix) < sizeof(names->pci_path)) strscpyl(names->pci_path, sizeof(names->pci_path), vf_names.pci_path, virtfn_suffix, NULL); } else { dev_pci_onboard(dev, info, names); dev_pci_slot(dev, info, names); } return 0; } static int names_usb(sd_device *dev, NetNames *names) { sd_device *usbdev; char name[256], *ports, *config, *interf, *s; const char *sysname; size_t l; int r; assert(dev); assert(names); r = sd_device_get_parent_with_subsystem_devtype(dev, "usb", "usb_interface", &usbdev); if (r < 0) return log_device_debug_errno(dev, r, "sd_device_get_parent_with_subsystem_devtype() failed: %m"); r = sd_device_get_sysname(usbdev, &sysname); if (r < 0) return log_device_debug_errno(usbdev, r, "sd_device_get_sysname() failed: %m"); /* get USB port number chain, configuration, interface */ strscpy(name, sizeof(name), sysname); s = strchr(name, '-'); if (!s) return log_device_debug_errno(usbdev, SYNTHETIC_ERRNO(EINVAL), "sysname \"%s\" does not have '-' in the expected place.", sysname); ports = s+1; s = strchr(ports, ':'); if (!s) return log_device_debug_errno(usbdev, SYNTHETIC_ERRNO(EINVAL), "sysname \"%s\" does not have ':' in the expected place.", sysname); s[0] = '\0'; config = s+1; s = strchr(config, '.'); if (!s) return log_device_debug_errno(usbdev, SYNTHETIC_ERRNO(EINVAL), "sysname \"%s\" does not have '.' in the expected place.", sysname); s[0] = '\0'; interf = s+1; /* prefix every port number in the chain with "u" */ s = ports; while ((s = strchr(s, '.'))) s[0] = 'u'; s = names->usb_ports; l = strpcpyl(&s, sizeof(names->usb_ports), "u", ports, NULL); /* append USB config number, suppress the common config == 1 */ if (!streq(config, "1")) l = strpcpyl(&s, sizeof(names->usb_ports), "c", config, NULL); /* append USB interface number, suppress the interface == 0 */ if (!streq(interf, "0")) l = strpcpyl(&s, sizeof(names->usb_ports), "i", interf, NULL); if (l == 0) return log_device_debug_errno(dev, SYNTHETIC_ERRNO(ENAMETOOLONG), "Generated USB name would be too long."); log_device_debug(dev, "USB name identifier: ports=%.*s config=%s interface=%s → %s", (int) strlen(ports), sysname + (ports - name), config, interf, names->usb_ports); names->type = NET_USB; return 0; } static int names_bcma(sd_device *dev, NetNames *names) { sd_device *bcmadev; unsigned core; const char *sysname; int r; assert(dev); assert(names); r = sd_device_get_parent_with_subsystem_devtype(dev, "bcma", NULL, &bcmadev); if (r < 0) return log_device_debug_errno(dev, r, "sd_device_get_parent_with_subsystem_devtype() failed: %m"); r = sd_device_get_sysname(bcmadev, &sysname); if (r < 0) return log_device_debug_errno(dev, r, "sd_device_get_sysname() failed: %m"); /* bus num:core num */ r = sscanf(sysname, "bcma%*u:%u", &core); log_device_debug(dev, "Parsing bcma device information from sysname \"%s\": %s", sysname, r == 1 ? "success" : "failure"); if (r != 1) return -EINVAL; /* suppress the common core == 0 */ if (core > 0) xsprintf(names->bcma_core, "b%u", core); names->type = NET_BCMA; log_device_debug(dev, "BCMA core identifier: core=%u → \"%s\"", core, names->bcma_core); return 0; } static int names_ccw(sd_device *dev, NetNames *names) { sd_device *cdev; const char *bus_id, *subsys; size_t bus_id_start, bus_id_len; int r; assert(dev); assert(names); /* Retrieve the associated CCW device */ r = sd_device_get_parent(dev, &cdev); if (r < 0) return log_device_debug_errno(dev, r, "sd_device_get_parent() failed: %m"); /* skip virtio subsystem if present */ cdev = skip_virtio(cdev); if (!cdev) return -ENOENT; r = sd_device_get_subsystem(cdev, &subsys); if (r < 0) return log_device_debug_errno(cdev, r, "sd_device_get_subsystem() failed: %m"); /* Network devices are either single or grouped CCW devices */ if (!STR_IN_SET(subsys, "ccwgroup", "ccw")) return -ENOENT; log_device_debug(dev, "Device is CCW."); /* Retrieve bus-ID of the CCW device. The bus-ID uniquely * identifies the network device on the Linux on System z channel * subsystem. Note that the bus-ID contains lowercase characters. */ r = sd_device_get_sysname(cdev, &bus_id); if (r < 0) return log_device_debug_errno(cdev, r, "Failed to get sysname: %m"); /* Check the length of the bus-ID. Rely on the fact that the kernel provides a correct bus-ID; * alternatively, improve this check and parse and verify each bus-ID part... */ bus_id_len = strlen(bus_id); if (!IN_SET(bus_id_len, 8, 9)) return log_device_debug_errno(cdev, SYNTHETIC_ERRNO(EINVAL), "Invalid bus_id: %s", bus_id); /* Strip leading zeros from the bus id for aesthetic purposes. This * keeps the ccw names stable, yet much shorter in general case of * bus_id 0.0.0600 -> 600. This is similar to e.g. how PCI domain is * not prepended when it is zero. Preserve the last 0 for 0.0.0000. */ bus_id_start = strspn(bus_id, ".0"); bus_id += bus_id_start < bus_id_len ? bus_id_start : bus_id_len - 1; /* Store the CCW bus-ID for use as network device name */ if (!snprintf_ok(names->ccw_busid, sizeof(names->ccw_busid), "c%s", bus_id)) return log_device_debug_errno(dev, SYNTHETIC_ERRNO(ENAMETOOLONG), "Generated CCW name would be too long."); names->type = NET_CCW; log_device_debug(dev, "CCW identifier: ccw_busid=%s → \"%s\"", bus_id, names->ccw_busid); return 0; } static int names_mac(sd_device *dev, const LinkInfo *info) { const char *s; unsigned i; int r; assert(dev); assert(info); /* The persistent part of a hardware address of an InfiniBand NIC is 8 bytes long. We cannot * fit this much in an iface name. * TODO: but it can be used as alternative names?? */ if (info->iftype == ARPHRD_INFINIBAND) return log_device_debug_errno(dev, SYNTHETIC_ERRNO(EOPNOTSUPP), "Not generating MAC name for infiniband device."); if (info->hw_addr.length != 6) return log_device_debug_errno(dev, SYNTHETIC_ERRNO(EOPNOTSUPP), "Not generating MAC name for device with MAC address of length %zu.", info->hw_addr.length); /* check for NET_ADDR_PERM, skip random MAC addresses */ r = sd_device_get_sysattr_value(dev, "addr_assign_type", &s); if (r < 0) return log_device_debug_errno(dev, r, "Failed to read addr_assign_type: %m"); r = safe_atou(s, &i); if (r < 0) return log_device_debug_errno(dev, r, "Failed to parse addr_assign_type: %m"); if (i != NET_ADDR_PERM) return log_device_debug_errno(dev, SYNTHETIC_ERRNO(EINVAL), "addr_assign_type=%d, MAC address is not permanent.", i); return 0; } static int names_netdevsim(sd_device *dev, const LinkInfo *info, NetNames *names) { sd_device *netdevsimdev; const char *sysname; unsigned addr; int r; if (!naming_scheme_has(NAMING_NETDEVSIM)) return 0; assert(dev); assert(info); assert(names); if (isempty(info->phys_port_name)) return -EINVAL; r = sd_device_get_parent_with_subsystem_devtype(dev, "netdevsim", NULL, &netdevsimdev); if (r < 0) return r; r = sd_device_get_sysname(netdevsimdev, &sysname); if (r < 0) return r; if (sscanf(sysname, "netdevsim%u", &addr) != 1) return -EINVAL; if (!snprintf_ok(names->netdevsim_path, sizeof(names->netdevsim_path), "i%un%s", addr, info->phys_port_name)) return -ENOBUFS; names->type = NET_NETDEVSIM; return 0; } static int names_xen(sd_device *dev, NetNames *names) { sd_device *parent; unsigned id; const char *syspath, *subsystem, *p, *p2; int r; assert(dev); assert(names); if (!naming_scheme_has(NAMING_XEN_VIF)) return 0; /* check if our direct parent is a Xen VIF device with no other bus in-between */ r = sd_device_get_parent(dev, &parent); if (r < 0) return r; /* Do an exact-match on subsystem "xen". This will miss on "xen-backend" on * purpose as the VIFs on the backend (dom0) have their own naming scheme * which we don't want to affect */ r = sd_device_get_subsystem(parent, &subsystem); if (r < 0) return r; if (!streq("xen", subsystem)) return -ENOENT; /* Use the vif-n name to extract "n" */ r = sd_device_get_syspath(dev, &syspath); if (r < 0) return r; p = path_startswith(syspath, "/sys/devices/"); if (!p) return -ENOENT; p = startswith(p, "vif-"); if (!p) return -ENOENT; p2 = strchr(p, '/'); if (!p2) return -ENOENT; p = strndupa_safe(p, p2 - p); if (!p) return -ENOENT; r = safe_atou_full(p, SAFE_ATO_REFUSE_PLUS_MINUS | SAFE_ATO_REFUSE_LEADING_ZERO | SAFE_ATO_REFUSE_LEADING_WHITESPACE | 10, &id); if (r < 0) return r; xsprintf(names->xen_slot, "X%u", id); names->type = NET_XENVIF; return 0; } /* IEEE Organizationally Unique Identifier vendor string */ static int ieee_oui(sd_device *dev, const LinkInfo *info, bool test) { char str[32]; assert(dev); assert(info); if (info->hw_addr.length != 6) return -EOPNOTSUPP; /* skip commonly misused 00:00:00 (Xerox) prefix */ if (info->hw_addr.bytes[0] == 0 && info->hw_addr.bytes[1] == 0 && info->hw_addr.bytes[2] == 0) return -EINVAL; xsprintf(str, "OUI:%02X%02X%02X%02X%02X%02X", info->hw_addr.bytes[0], info->hw_addr.bytes[1], info->hw_addr.bytes[2], info->hw_addr.bytes[3], info->hw_addr.bytes[4], info->hw_addr.bytes[5]); return udev_builtin_hwdb_lookup(dev, NULL, str, NULL, test); } static int builtin_net_id(sd_device *dev, sd_netlink **rtnl, int argc, char *argv[], bool test) { _cleanup_(link_info_clear) LinkInfo info = LINK_INFO_NULL; const char *devtype, *prefix = "en"; NetNames names = {}; int ifindex, r; r = sd_device_get_ifindex(dev, &ifindex); if (r < 0) return r; r = link_info_get(rtnl, ifindex, &info); if (r < 0) return r; if (!info.phys_port_name_supported) { const char *s; r = sd_device_get_sysattr_value(dev, "phys_port_name", &s); if (r >= 0) { info.phys_port_name = strdup(s); if (!info.phys_port_name) return log_oom(); } } r = device_cache_sysattr_from_link_info(dev, &info); if (r < 0) return r; /* skip stacked devices, like VLANs, ... */ if (info.ifindex != (int) info.iflink) return 0; /* handle only ARPHRD_ETHER, ARPHRD_SLIP and ARPHRD_INFINIBAND devices */ switch (info.iftype) { case ARPHRD_ETHER: prefix = "en"; break; case ARPHRD_INFINIBAND: if (naming_scheme_has(NAMING_INFINIBAND)) prefix = "ib"; else return 0; break; case ARPHRD_SLIP: prefix = "sl"; break; default: return 0; } if (sd_device_get_devtype(dev, &devtype) >= 0) { if (streq("wlan", devtype)) prefix = "wl"; else if (streq("wwan", devtype)) prefix = "ww"; } udev_builtin_add_property(dev, test, "ID_NET_NAMING_SCHEME", naming_scheme()->name); if (names_mac(dev, &info) >= 0) { char str[ALTIFNAMSIZ]; xsprintf(str, "%sx%s", prefix, HW_ADDR_TO_STR_FULL(&info.hw_addr, HW_ADDR_TO_STRING_NO_COLON)); udev_builtin_add_property(dev, test, "ID_NET_NAME_MAC", str); log_device_debug(dev, "MAC address identifier: hw_addr=%s → %s", HW_ADDR_TO_STR(&info.hw_addr), str + strlen(prefix)); ieee_oui(dev, &info, test); } /* get path names for Linux on System z network devices */ if (names_ccw(dev, &names) >= 0 && names.type == NET_CCW) { char str[ALTIFNAMSIZ]; if (snprintf_ok(str, sizeof str, "%s%s", prefix, names.ccw_busid)) udev_builtin_add_property(dev, test, "ID_NET_NAME_PATH", str); return 0; } /* get ibmveth/ibmvnic slot-based names. */ if (names_vio(dev, &names) >= 0 && names.type == NET_VIO) { char str[ALTIFNAMSIZ]; if (snprintf_ok(str, sizeof str, "%s%s", prefix, names.vio_slot)) udev_builtin_add_property(dev, test, "ID_NET_NAME_SLOT", str); return 0; } /* get ACPI path names for ARM64 platform devices */ if (names_platform(dev, &names, test) >= 0 && names.type == NET_PLATFORM) { char str[ALTIFNAMSIZ]; if (snprintf_ok(str, sizeof str, "%s%s", prefix, names.platform_path)) udev_builtin_add_property(dev, test, "ID_NET_NAME_PATH", str); return 0; } /* get netdevsim path names */ if (names_netdevsim(dev, &info, &names) >= 0 && names.type == NET_NETDEVSIM) { char str[ALTIFNAMSIZ]; if (snprintf_ok(str, sizeof str, "%s%s", prefix, names.netdevsim_path)) udev_builtin_add_property(dev, test, "ID_NET_NAME_PATH", str); return 0; } /* get xen vif "slot" based names. */ if (names_xen(dev, &names) >= 0 && names.type == NET_XENVIF) { char str[ALTIFNAMSIZ]; if (snprintf_ok(str, sizeof str, "%s%s", prefix, names.xen_slot)) udev_builtin_add_property(dev, test, "ID_NET_NAME_SLOT", str); return 0; } /* get PCI based path names, we compose only PCI based paths */ if (names_pci(dev, &info, &names) < 0) return 0; /* plain PCI device */ if (names.type == NET_PCI) { char str[ALTIFNAMSIZ]; if (names.pci_onboard[0] && snprintf_ok(str, sizeof str, "%s%s", prefix, names.pci_onboard)) udev_builtin_add_property(dev, test, "ID_NET_NAME_ONBOARD", str); if (names.pci_onboard_label && snprintf_ok(str, sizeof str, "%s%s", naming_scheme_has(NAMING_LABEL_NOPREFIX) ? "" : prefix, names.pci_onboard_label)) udev_builtin_add_property(dev, test, "ID_NET_LABEL_ONBOARD", str); if (names.pci_path[0] && snprintf_ok(str, sizeof str, "%s%s", prefix, names.pci_path)) udev_builtin_add_property(dev, test, "ID_NET_NAME_PATH", str); if (names.pci_slot[0] && snprintf_ok(str, sizeof str, "%s%s", prefix, names.pci_slot)) udev_builtin_add_property(dev, test, "ID_NET_NAME_SLOT", str); return 0; } /* USB device */ if (names_usb(dev, &names) >= 0 && names.type == NET_USB) { char str[ALTIFNAMSIZ]; if (names.pci_path[0] && snprintf_ok(str, sizeof str, "%s%s%s", prefix, names.pci_path, names.usb_ports)) udev_builtin_add_property(dev, test, "ID_NET_NAME_PATH", str); if (names.pci_slot[0] && snprintf_ok(str, sizeof str, "%s%s%s", prefix, names.pci_slot, names.usb_ports)) udev_builtin_add_property(dev, test, "ID_NET_NAME_SLOT", str); return 0; } /* Broadcom bus */ if (names_bcma(dev, &names) >= 0 && names.type == NET_BCMA) { char str[ALTIFNAMSIZ]; if (names.pci_path[0] && snprintf_ok(str, sizeof str, "%s%s%s", prefix, names.pci_path, names.bcma_core)) udev_builtin_add_property(dev, test, "ID_NET_NAME_PATH", str); if (names.pci_slot[0] && snprintf_ok(str, sizeof str, "%s%s%s", prefix, names.pci_slot, names.bcma_core)) udev_builtin_add_property(dev, test, "ID_NET_NAME_SLOT", str); return 0; } return 0; } const UdevBuiltin udev_builtin_net_id = { .name = "net_id", .cmd = builtin_net_id, .help = "Network device properties", };