systemd/test/test-udev.py
Frantisek Sumsal 79f902eb09 Add .pylintrc to globally suppress warnings we don't really care about
Also, drop the respective disable directives from existing files.
2023-08-10 18:13:29 +02:00

2439 lines
86 KiB
Python
Executable File

#!/usr/bin/env python3
# SPDX-License-Identifier: LGPL-2.1-or-later
# pylint: disable=redefined-outer-name,no-else-return,multiple-imports
# pylint: disable=consider-using-with,global-statement
# udev test
#
# Provides automated testing of the udev binary.
# The whole test is self contained in this file, except the matching sysfs tree.
# Simply extend RULES to add a new test.
#
# Every test is driven by its own temporary config file.
# This program prepares the environment, creates the config and calls udev.
#
# udev parses the rules, looks at the provided sysfs and first creates and then
# removes the device node. After creation and removal the result is checked
# against the expected value and the result is printed.
import functools
import os
import pwd, grp
import re
import stat
import subprocess
import sys
import tempfile
import textwrap
from pathlib import Path
from typing import Callable, Optional
try:
import dataclasses # requires Python >= 3.7
import pytest
except ImportError as e:
print(str(e), file=sys.stderr)
sys.exit(77)
SYS_SCRIPT = Path(__file__).with_name('sys-script.py')
try:
UDEV_BIN = Path(os.environ['UDEV_RULE_RUNNER'])
except KeyError:
UDEV_BIN = Path(__file__).parent / 'manual/test-udev-rule-runner'
UDEV_BIN = UDEV_BIN.absolute()
# Those will be set by the udev_setup() fixture
UDEV_RUN = UDEV_RULES = UDEV_DEV = UDEV_SYS = None
# Relax sd-device's sysfs verification, since we want to provide a fake sysfs
# here that actually is a tmpfs.
os.environ['SYSTEMD_DEVICE_VERIFY_SYSFS'] = '0'
rules_10k_tags = \
'\n'.join(f'KERNEL=="sda", TAG+="test{i + 1}"'
for i in range(10_000))
rules_10k_tags_continuation = \
',\\\n'.join(('KERNEL=="sda"',
*(f'TAG+="test{i + 1}"' for i in range(10_000))))
@dataclasses.dataclass
class Device:
devpath: str
devnode: Optional[str] = None
exp_links: Optional[list[str]] = None
not_exp_links: Optional[list[str]] = None
exp_perms: Optional[int] = None
exp_major_minor: Optional[str] = None
def check_permissions(self, st: os.stat_result) -> None:
if self.exp_perms is None:
return
user, group, mode = self.exp_perms.split(':')
if user:
try:
uid = pwd.getpwnam(user).pw_uid
except KeyError:
uid = int(user)
assert uid == st.st_uid
if group:
try:
gid = grp.getgrnam(group).gr_gid
except KeyError:
gid = int(group)
assert gid == st.st_gid
if mode:
mode = int(mode, 8)
assert stat.S_IMODE(st.st_mode) == mode
def check_major_minor(self, st: os.stat_result) -> None:
if not self.exp_major_minor:
return
minor, major = (int(x) for x in self.exp_major_minor.split(':'))
assert st.st_rdev == os.makedev(minor, major)
def get_devnode(self) -> Path:
suffix = self.devnode if self.devnode else self.devpath.split('/')[-1]
return UDEV_DEV / suffix
def check_link_add(self, link: str, devnode: Path) -> None:
link = UDEV_DEV / link
tgt = link.parent / link.readlink()
assert devnode.samefile(tgt)
def check_link_nonexistent(self, link: str, devnode: Path) -> None:
link = UDEV_DEV / link
try:
tgt = link.parent / link.readlink()
except FileNotFoundError:
return
assert not devnode.samefile(tgt)
def check_add(self) -> None:
print(f'check_add {self.devpath}')
devnode = self.get_devnode()
st = devnode.stat(follow_symlinks=False)
assert stat.S_ISCHR(st.st_mode) or stat.S_ISBLK(st.st_mode)
self.check_permissions(st)
self.check_major_minor(st)
for link in self.exp_links or []:
self.check_link_add(link, devnode)
for link in self.not_exp_links or []:
self.check_link_nonexistent(link, devnode)
def check_link_remove(self, link: str) -> None:
link = UDEV_DEV / link
with pytest.raises(FileNotFoundError):
link.readlink()
def check_remove(self) -> None:
devnode = self.get_devnode()
assert not devnode.exists()
for link in self.exp_links or []:
self.check_link_remove(link)
def listify(f):
def wrap(*args, **kwargs):
return list(f(*args, **kwargs))
return functools.update_wrapper(wrap, f)
@listify
def all_block_devs(exp_func) -> list[Device]:
# Create a device list with all block devices under /sys
# (except virtual devices and cd-roms)
# the optional argument exp_func returns expected and non-expected
# symlinks for the device.
for p in UDEV_SYS.glob('dev/block/*'):
tgt = os.readlink(p)
if re.search('/virtual/ | /sr[0-9]*$', tgt, re.VERBOSE):
continue
assert tgt.startswith('../../')
tgt = tgt[5:]
exp, not_exp = exp_func(tgt)
yield Device(devpath=tgt,
exp_links=exp,
not_exp_links=not_exp)
@dataclasses.dataclass
class Rules:
desc: str
devices: list[Device]
rules: str
device_generator: Callable = None
repeat: int = 1
delay: Optional[int] = None
@classmethod
def new(cls, desc: str, *devices, rules=None, device_generator=None, **kwargs):
assert rules.startswith('\n')
rules = textwrap.dedent(rules[1:]) if rules else ''
assert bool(devices) ^ bool(device_generator)
return cls(desc, devices, rules, device_generator=device_generator, **kwargs)
def generate_devices(self) -> None:
# We can't do this when the class is created, because setup is done later.
if self.device_generator:
self.devices = self.device_generator()
def create_rules_file(self) -> None:
# create temporary rules
UDEV_RULES.parent.mkdir(exist_ok=True, parents=True)
UDEV_RULES.write_text(self.rules)
RULES = [
Rules.new(
'no rules',
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda",
),
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda1",
),
rules = r"""
#
"""),
Rules.new(
'label test of scsi disc',
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda",
exp_links = ["boot_disk"],
),
rules = r"""
SUBSYSTEMS=="scsi", ATTRS{vendor}=="ATA", SYMLINK+="boot_disk%n"
KERNEL=="ttyACM0", SYMLINK+="modem"
"""),
Rules.new(
"label test of scsi disc",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda",
exp_links = ["boot_disk"],
),
rules = r"""
SUBSYSTEMS=="scsi", ATTRS{vendor}=="ATA", SYMLINK+="boot_disk%n"
KERNEL=="ttyACM0", SYMLINK+="modem"
"""),
Rules.new(
"label test of scsi disc",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda",
exp_links = ["boot_disk"],
),
rules = r"""
SUBSYSTEMS=="scsi", ATTRS{vendor}=="ATA", SYMLINK+="boot_disk%n"
KERNEL=="ttyACM0", SYMLINK+="modem"
"""),
Rules.new(
"label test of scsi partition",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda1",
exp_links = ["boot_disk1"],
),
rules = r"""
SUBSYSTEMS=="scsi", ATTRS{vendor}=="ATA", SYMLINK+="boot_disk%n"
"""),
Rules.new(
"label test of pattern match",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda1",
exp_links = ["boot_disk1", "boot_disk1-4", "boot_disk1-5"],
not_exp_links = ["boot_disk1-1", "boot_disk1-2", "boot_disk1-3", "boot_disk1-6", "boot_disk1-7"],
),
rules = r"""
SUBSYSTEMS=="scsi", ATTRS{vendor}=="?ATA", SYMLINK+="boot_disk%n-1"
SUBSYSTEMS=="scsi", ATTRS{vendor}=="ATA?", SYMLINK+="boot_disk%n-2"
SUBSYSTEMS=="scsi", ATTRS{vendor}=="A??", SYMLINK+="boot_disk%n"
SUBSYSTEMS=="scsi", ATTRS{vendor}=="ATAS", SYMLINK+="boot_disk%n-3"
SUBSYSTEMS=="scsi", ATTRS{vendor}=="AT?", SYMLINK+="boot_disk%n-4"
SUBSYSTEMS=="scsi", ATTRS{vendor}=="??A", SYMLINK+="boot_disk%n-5"
SUBSYSTEMS=="scsi", ATTRS{vendor}=="ATA", GOTO="skip-6"
SUBSYSTEMS=="scsi", ATTRS{vendor}=="ATA", SYMLINK+="boot_disk%n-6"
LABEL="skip-6"
SUBSYSTEMS=="scsi", GOTO="skip-7"
SUBSYSTEMS=="scsi", ATTRS{vendor}=="ATA", SYMLINK+="boot_disk%n-7"
LABEL="skip-7"
"""),
Rules.new(
"label test of multiple sysfs files",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda1",
exp_links = ["boot_disk1"],
not_exp_links = ["boot_diskX1"],
),
rules = r"""
SUBSYSTEMS=="scsi", ATTRS{vendor}=="ATA", ATTRS{model}=="ST910021AS X ", SYMLINK+="boot_diskX%n"
SUBSYSTEMS=="scsi", ATTRS{vendor}=="ATA", ATTRS{model}=="ST910021AS", SYMLINK+="boot_disk%n"
"""),
Rules.new(
"label test of max sysfs files (skip invalid rule)",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda1",
exp_links = ["boot_disk1", "boot_diskXY1"],
not_exp_links = ["boot_diskXX1"],
),
rules = r"""
SUBSYSTEMS=="scsi", ATTRS{vendor}=="ATA", ATTRS{model}=="ST910021AS", ATTRS{scsi_level}=="6", ATTRS{rev}=="4.06", ATTRS{type}=="0", ATTRS{queue_depth}=="32", SYMLINK+="boot_diskXX%n"
SUBSYSTEMS=="scsi", ATTRS{vendor}=="ATA", ATTRS{model}=="ST910021AS", ATTRS{scsi_level}=="6", ATTRS{rev}=="4.06", ATTRS{type}=="0", ATTRS{queue_depth}=="1", SYMLINK+="boot_diskXY%n"
SUBSYSTEMS=="scsi", ATTRS{vendor}=="ATA", ATTRS{model}=="ST910021AS", ATTRS{scsi_level}=="6", ATTRS{rev}=="4.06", ATTRS{type}=="0", SYMLINK+="boot_disk%n"
"""),
Rules.new(
"SYMLINK tests",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda1",
exp_links = ["link1", "link2/foo", "link3/aaa/bbb",
"abs1", "abs2/foo", "abs3/aaa/bbb",
"default___replace_test/foo_aaa",
"string_escape___replace/foo_bbb",
"env_with_space",
"default/replace/mode_foo__hoge",
"replace_env_harder_foo__hoge",
"match", "unmatch"],
not_exp_links = ["removed1", "removed2", "removed3", "unsafe/../../path", "/nondev/path/will/be/refused"],
),
rules = r"""
SUBSYSTEMS=="scsi", ATTRS{vendor}=="ATA", ATTRS{model}=="ST910021AS", SYMLINK+="removed1"
SUBSYSTEMS=="scsi", ATTRS{vendor}=="ATA", ATTRS{model}=="ST910021AS", SYMLINK-="removed1"
SUBSYSTEMS=="scsi", ATTRS{vendor}=="ATA", ATTRS{model}=="ST910021AS", SYMLINK+="/./dev///removed2"
SUBSYSTEMS=="scsi", ATTRS{vendor}=="ATA", ATTRS{model}=="ST910021AS", SYMLINK-="removed2"
SUBSYSTEMS=="scsi", ATTRS{vendor}=="ATA", ATTRS{model}=="ST910021AS", SYMLINK+="././removed3"
SUBSYSTEMS=="scsi", ATTRS{vendor}=="ATA", ATTRS{model}=="ST910021AS", SYMLINK-="/dev//./removed3/./"
SUBSYSTEMS=="scsi", ATTRS{vendor}=="ATA", ATTRS{model}=="ST910021AS", SYMLINK+="unsafe/../../path"
SUBSYSTEMS=="scsi", ATTRS{vendor}=="ATA", ATTRS{model}=="ST910021AS", SYMLINK+="/nondev/path/will/be/refused"
SUBSYSTEMS=="scsi", ATTRS{vendor}=="ATA", ATTRS{model}=="ST910021AS", SYMLINK+="link1 .///link2/././/foo//./ .///link3/aaa/bbb"
SUBSYSTEMS=="scsi", ATTRS{vendor}=="ATA", ATTRS{model}=="ST910021AS", SYMLINK+="/dev/abs1 /dev//./abs2///foo/./ ////dev/abs3/aaa/bbb"
SUBSYSTEMS=="scsi", ATTRS{vendor}=="ATA", ATTRS{model}=="ST910021AS", SYMLINK+="default?;;replace%%test/foo'aaa"
SUBSYSTEMS=="scsi", ATTRS{vendor}=="ATA", ATTRS{model}=="ST910021AS", OPTIONS="string_escape=replace", SYMLINK+="string_escape replace/foo%%bbb"
SUBSYSTEMS=="scsi", ATTRS{vendor}=="ATA", ATTRS{model}=="ST910021AS", ENV{.HOGE}="env with space", SYMLINK+="%E{.HOGE}"
SUBSYSTEMS=="scsi", ATTRS{vendor}=="ATA", ATTRS{model}=="ST910021AS", ENV{.HOGE}="default/replace/mode?foo;;hoge", SYMLINK+="%E{.HOGE}"
SUBSYSTEMS=="scsi", ATTRS{vendor}=="ATA", ATTRS{model}=="ST910021AS", OPTIONS="string_escape=replace", ENV{.HOGE}="replace/env/harder?foo;;hoge", SYMLINK+="%E{.HOGE}"
SUBSYSTEMS=="scsi", ATTRS{vendor}=="ATA", ATTRS{model}=="ST910021AS", SYMLINK=="link1", SYMLINK+="match"
SUBSYSTEMS=="scsi", ATTRS{vendor}=="ATA", ATTRS{model}=="ST910021AS", SYMLINK!="removed1", SYMLINK+="unmatch"
"""),
Rules.new(
"catch device by *",
Device(
"/devices/pci0000:00/0000:00:1d.7/usb5/5-2/5-2:1.0/tty/ttyACM0",
exp_links = ["modem/0", "catch-all"],
),
rules = r"""
KERNEL=="ttyACM*", SYMLINK+="modem/%n"
KERNEL=="*", SYMLINK+="catch-all"
"""),
Rules.new(
"catch device by * - take 2",
Device(
"/devices/pci0000:00/0000:00:1d.7/usb5/5-2/5-2:1.0/tty/ttyACM0",
exp_links = ["modem/0"],
not_exp_links = ["bad"],
),
rules = r"""
KERNEL=="*ACM1", SYMLINK+="bad"
KERNEL=="*ACM0", SYMLINK+="modem/%n"
"""),
Rules.new(
"catch device by ?",
Device(
"/devices/pci0000:00/0000:00:1d.7/usb5/5-2/5-2:1.0/tty/ttyACM0",
exp_links = ["modem/0"],
not_exp_links = ["modem/0-1", "modem/0-2"],
),
rules = r"""
KERNEL=="ttyACM??*", SYMLINK+="modem/%n-1"
KERNEL=="ttyACM??", SYMLINK+="modem/%n-2"
KERNEL=="ttyACM?", SYMLINK+="modem/%n"
"""),
Rules.new(
"catch device by character class",
Device(
"/devices/pci0000:00/0000:00:1d.7/usb5/5-2/5-2:1.0/tty/ttyACM0",
exp_links = ["modem/0"],
not_exp_links = ["modem/0-1", "modem/0-2"],
),
rules = r"""
KERNEL=="ttyACM[A-Z]*", SYMLINK+="modem/%n-1"
KERNEL=="ttyACM?[0-9]", SYMLINK+="modem/%n-2"
KERNEL=="ttyACM[0-9]*", SYMLINK+="modem/%n"
"""),
Rules.new(
"don't replace kernel name",
Device(
"/devices/pci0000:00/0000:00:1d.7/usb5/5-2/5-2:1.0/tty/ttyACM0",
exp_links = ["modem"],
),
rules = r"""
KERNEL=="ttyACM0", SYMLINK+="modem"
"""),
Rules.new(
"comment lines in config file (and don't replace kernel name)",
Device(
"/devices/pci0000:00/0000:00:1d.7/usb5/5-2/5-2:1.0/tty/ttyACM0",
exp_links = ["modem"],
),
rules = r"""
# this is a comment
KERNEL=="ttyACM0", SYMLINK+="modem"
"""),
Rules.new(
"comment lines in config file with whitespace (and don't replace kernel name)",
Device(
"/devices/pci0000:00/0000:00:1d.7/usb5/5-2/5-2:1.0/tty/ttyACM0",
exp_links = ["modem"],
),
rules = r"""
# this is a comment with whitespace before the comment
KERNEL=="ttyACM0", SYMLINK+="modem"
"""),
Rules.new(
"whitespace only lines (and don't replace kernel name)",
Device(
"/devices/pci0000:00/0000:00:1d.7/usb5/5-2/5-2:1.0/tty/ttyACM0",
exp_links = ["whitespace"],
),
rules = r"""
# this is a comment with whitespace before the comment
KERNEL=="ttyACM0", SYMLINK+="whitespace"
"""),
Rules.new(
"empty lines in config file (and don't replace kernel name)",
Device(
"/devices/pci0000:00/0000:00:1d.7/usb5/5-2/5-2:1.0/tty/ttyACM0",
exp_links = ["modem"],
),
rules = r"""
KERNEL=="ttyACM0", SYMLINK+="modem"
"""),
Rules.new(
"backslashed multi lines in config file (and don't replace kernel name)",
Device(
"/devices/pci0000:00/0000:00:1d.7/usb5/5-2/5-2:1.0/tty/ttyACM0",
exp_links = ["modem"],
),
rules = r"""
KERNEL=="ttyACM0", \
SYMLINK+="modem"
"""),
Rules.new(
"preserve backslashes, if they are not for a newline",
Device(
"/devices/pci0000:00/0000:00:1d.7/usb5/5-2/5-2:1.0/tty/ttyACM0",
exp_links = ["aaa"],
),
rules = r"""
KERNEL=="ttyACM0", PROGRAM=="/bin/echo -e \101", RESULT=="A", SYMLINK+="aaa"
"""),
Rules.new(
"stupid backslashed multi lines in config file (and don't replace kernel name)",
Device(
"/devices/pci0000:00/0000:00:1d.7/usb5/5-2/5-2:1.0/tty/ttyACM0",
exp_links = ["modem"],
),
rules = r"""
#
\
\
#\
KERNEL=="ttyACM0", \
SYMLINK+="modem"
"""),
Rules.new(
"subdirectory handling",
Device(
"/devices/pci0000:00/0000:00:1d.7/usb5/5-2/5-2:1.0/tty/ttyACM0",
exp_links = ["sub/direct/ory/modem"],
),
rules = r"""
KERNEL=="ttyACM0", SYMLINK+="sub/direct/ory/modem"
"""),
Rules.new(
"parent device name match of scsi partition",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda5",
exp_links = ["first_disk5"],
),
rules = r"""
SUBSYSTEMS=="scsi", KERNELS=="0:0:0:0", SYMLINK+="first_disk%n"
"""),
Rules.new(
"test substitution chars",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda5",
exp_links = ["Major:8:minor:5:kernelnumber:5:id:0:0:0:0"],
),
rules = r"""
SUBSYSTEMS=="scsi", KERNELS=="0:0:0:0", SYMLINK+="Major:%M:minor:%m:kernelnumber:%n:id:%b"
"""),
Rules.new(
"import of shell-value returned from program",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda",
exp_links = ["node12345678"],
),
rules = r"""
SUBSYSTEMS=="scsi", IMPORT{program}="/bin/echo -e ' TEST_KEY=12345678\n TEST_key2=98765'", SYMLINK+="node$env{TEST_KEY}"
KERNEL=="ttyACM0", SYMLINK+="modem"
"""),
Rules.new(
"substitution of sysfs value (%s{file})",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda",
exp_links = ["disk-ATA-sda"],
not_exp_links = ["modem"],
),
rules = r"""
SUBSYSTEMS=="scsi", ATTRS{vendor}=="ATA", SYMLINK+="disk-%s{vendor}-%k"
KERNEL=="ttyACM0", SYMLINK+="modem"
"""),
Rules.new(
"program result substitution",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda5",
exp_links = ["special-device-5"],
not_exp_links = ["not"],
),
rules = r"""
SUBSYSTEMS=="scsi", PROGRAM=="/bin/echo -n special-device", RESULT=="-special-*", SYMLINK+="not"
SUBSYSTEMS=="scsi", PROGRAM=="/bin/echo -n special-device", RESULT=="special-*", SYMLINK+="%c-%n"
"""),
Rules.new(
"program result substitution (newline removal)",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda5",
exp_links = ["newline_removed"],
),
rules = r"""
SUBSYSTEMS=="scsi", PROGRAM=="/bin/echo test", RESULT=="test", SYMLINK+="newline_removed"
"""),
Rules.new(
"program result substitution",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda5",
exp_links = ["test-0:0:0:0"],
),
rules = r"""
SUBSYSTEMS=="scsi", PROGRAM=="/bin/echo -n test-%b", RESULT=="test-0:0*", SYMLINK+="%c"
"""),
Rules.new(
"program with lots of arguments",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda5",
exp_links = ["foo9"],
not_exp_links = ["foo3", "foo4", "foo5", "foo6", "foo7", "foo8"],
),
rules = r"""
SUBSYSTEMS=="scsi", PROGRAM=="/bin/echo -n foo3 foo4 foo5 foo6 foo7 foo8 foo9", KERNEL=="sda5", SYMLINK+="%c{7}"
"""),
Rules.new(
"program with subshell",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda5",
exp_links = ["bar9"],
not_exp_links = ["foo3", "foo4", "foo5", "foo6", "foo7", "foo8"],
),
rules = r"""
SUBSYSTEMS=="scsi", PROGRAM=="/bin/sh -c 'echo foo3 foo4 foo5 foo6 foo7 foo8 foo9 | sed s/foo9/bar9/'", KERNEL=="sda5", SYMLINK+="%c{7}"
"""),
Rules.new(
"program arguments combined with apostrophes",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda5",
exp_links = ["foo7"],
not_exp_links = ["foo3", "foo4", "foo5", "foo6", "foo8"],
),
rules = r"""
SUBSYSTEMS=="scsi", PROGRAM=="/bin/echo -n 'foo3 foo4' 'foo5 foo6 foo7 foo8'", KERNEL=="sda5", SYMLINK+="%c{5}"
"""),
Rules.new(
"program arguments combined with escaped double quotes, part 1",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda5",
exp_links = ["foo2"],
not_exp_links = ["foo1"],
),
rules = r"""
SUBSYSTEMS=="scsi", PROGRAM=="/bin/sh -c 'printf %%s \"foo1 foo2\" | grep \"foo1 foo2\"'", KERNEL=="sda5", SYMLINK+="%c{2}"
"""),
Rules.new(
"program arguments combined with escaped double quotes, part 2",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda5",
exp_links = ["foo2"],
not_exp_links = ["foo1"],
),
rules = r"""
SUBSYSTEMS=="scsi", PROGRAM=="/bin/sh -c \"printf %%s 'foo1 foo2' | grep 'foo1 foo2'\"", KERNEL=="sda5", SYMLINK+="%c{2}"
"""),
Rules.new(
"program arguments combined with escaped double quotes, part 3",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda5",
exp_links = ["foo2"],
not_exp_links = ["foo1", "foo3"],
),
rules = r"""
SUBSYSTEMS=="scsi", PROGRAM=="/bin/sh -c 'printf \"%%s %%s\" \"foo1 foo2\" \"foo3\"| grep \"foo1 foo2\"'", KERNEL=="sda5", SYMLINK+="%c{2}"
"""),
Rules.new(
"characters before the %c{N} substitution",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda5",
exp_links = ["my-foo9"],
),
rules = r"""
SUBSYSTEMS=="scsi", PROGRAM=="/bin/echo -n foo3 foo4 foo5 foo6 foo7 foo8 foo9", KERNEL=="sda5", SYMLINK+="my-%c{7}"
"""),
Rules.new(
"substitute the second to last argument",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda5",
exp_links = ["my-foo8"],
not_exp_links = ["my-foo3", "my-foo4", "my-foo5", "my-foo6", "my-foo7", "my-foo9"],
),
rules = r"""
SUBSYSTEMS=="scsi", PROGRAM=="/bin/echo -n foo3 foo4 foo5 foo6 foo7 foo8 foo9", KERNEL=="sda5", SYMLINK+="my-%c{6}"
"""),
Rules.new(
"test substitution by variable name",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda5",
exp_links = ["Major:8-minor:5-kernelnumber:5-id:0:0:0:0"],
),
rules = r"""
SUBSYSTEMS=="scsi", KERNELS=="0:0:0:0", SYMLINK+="Major:$major-minor:$minor-kernelnumber:$number-id:$id"
"""),
Rules.new(
"test substitution by variable name 2",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda5",
exp_links = ["Major:8-minor:5-kernelnumber:5-id:0:0:0:0"],
),
rules = r"""
SUBSYSTEMS=="scsi", KERNELS=="0:0:0:0", DEVPATH=="*/sda/*", SYMLINK+="Major:$major-minor:%m-kernelnumber:$number-id:$id"
"""),
Rules.new(
"test substitution by variable name 3",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda5",
exp_links = ["850:0:0:05"],
),
rules = r"""
SUBSYSTEMS=="scsi", KERNELS=="0:0:0:0", DEVPATH=="*/sda/*", SYMLINK+="%M%m%b%n"
"""),
Rules.new(
"test substitution by variable name 4",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda5",
exp_links = ["855"],
),
rules = r"""
SUBSYSTEMS=="scsi", KERNELS=="0:0:0:0", DEVPATH=="*/sda/*", SYMLINK+="$major$minor$number"
"""),
Rules.new(
"test substitution by variable name 5",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda5",
exp_links = ["8550:0:0:0"],
),
rules = r"""
SUBSYSTEMS=="scsi", KERNELS=="0:0:0:0", DEVPATH=="*/sda/*", SYMLINK+="$major%m%n$id"
"""),
Rules.new(
"non matching SUBSYSTEMS for device with no parent",
Device(
"/devices/virtual/tty/console",
exp_links = ["TTY"],
not_exp_links = ["foo"],
),
rules = r"""
SUBSYSTEMS=="scsi", PROGRAM=="/bin/echo -n foo", RESULT=="foo", SYMLINK+="foo"
KERNEL=="console", SYMLINK+="TTY"
"""),
Rules.new(
"non matching SUBSYSTEMS",
Device(
"/devices/virtual/tty/console",
exp_links = ["TTY"],
not_exp_links = ["foo"],
),
rules = r"""
SUBSYSTEMS=="foo", ATTRS{dev}=="5:1", SYMLINK+="foo"
KERNEL=="console", SYMLINK+="TTY"
"""),
Rules.new(
"ATTRS match",
Device(
"/devices/virtual/tty/console",
exp_links = ["foo", "TTY"],
),
rules = r"""
KERNEL=="console", SYMLINK+="TTY"
ATTRS{dev}=="5:1", SYMLINK+="foo"
"""),
Rules.new(
"ATTR (empty file)",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda",
exp_links = ["empty", "not-something"],
not_exp_links = ["something", "not-empty"],
),
rules = r"""
KERNEL=="sda", ATTR{test_empty_file}=="?*", SYMLINK+="something"
KERNEL=="sda", ATTR{test_empty_file}!="", SYMLINK+="not-empty"
KERNEL=="sda", ATTR{test_empty_file}=="", SYMLINK+="empty"
KERNEL=="sda", ATTR{test_empty_file}!="?*", SYMLINK+="not-something"
"""),
Rules.new(
"ATTR (non-existent file)",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda",
exp_links = ["non-existent", "wrong"],
not_exp_links = ["something", "empty", "not-empty",
"not-something", "something"],
),
rules = r"""
KERNEL=="sda", ATTR{nofile}=="?*", SYMLINK+="something"
KERNEL=="sda", ATTR{nofile}!="", SYMLINK+="not-empty"
KERNEL=="sda", ATTR{nofile}=="", SYMLINK+="empty"
KERNEL=="sda", ATTR{nofile}!="?*", SYMLINK+="not-something"
KERNEL=="sda", TEST!="nofile", SYMLINK+="non-existent"
KERNEL=="sda", SYMLINK+="wrong"
"""),
Rules.new(
"program and bus type match",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda",
exp_links = ["scsi-0:0:0:0"],
),
rules = r"""
SUBSYSTEMS=="usb", PROGRAM=="/bin/echo -n usb-%b", SYMLINK+="%c"
SUBSYSTEMS=="scsi", PROGRAM=="/bin/echo -n scsi-%b", SYMLINK+="%c"
SUBSYSTEMS=="foo", PROGRAM=="/bin/echo -n foo-%b", SYMLINK+="%c"
"""),
Rules.new(
"sysfs parent hierarchy",
Device(
"/devices/pci0000:00/0000:00:1d.7/usb5/5-2/5-2:1.0/tty/ttyACM0",
exp_links = ["modem"],
),
rules = r"""
ATTRS{idProduct}=="007b", SYMLINK+="modem"
"""),
Rules.new(
"name test with ! in the name",
Device(
"/devices/virtual/block/fake!blockdev0",
devnode = "fake/blockdev0",
exp_links = ["is/a/fake/blockdev0"],
not_exp_links = ["is/not/a/fake/blockdev0", "modem"],
),
rules = r"""
SUBSYSTEMS=="scsi", SYMLINK+="is/not/a/%k"
SUBSYSTEM=="block", SYMLINK+="is/a/%k"
KERNEL=="ttyACM0", SYMLINK+="modem"
"""),
Rules.new(
"name test with ! in the name, but no matching rule",
Device(
"/devices/virtual/block/fake!blockdev0",
devnode = "fake/blockdev0",
not_exp_links = ["modem"],
),
rules = r"""
KERNEL=="ttyACM0", SYMLINK+="modem"
"""),
Rules.new(
"KERNELS rule",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda",
exp_links = ["scsi-0:0:0:0"],
not_exp_links = ["no-match", "short-id", "not-scsi"],
),
rules = r"""
SUBSYSTEMS=="usb", KERNELS=="0:0:0:0", SYMLINK+="not-scsi"
SUBSYSTEMS=="scsi", KERNELS=="0:0:0:1", SYMLINK+="no-match"
SUBSYSTEMS=="scsi", KERNELS==":0", SYMLINK+="short-id"
SUBSYSTEMS=="scsi", KERNELS=="/0:0:0:0", SYMLINK+="no-match"
SUBSYSTEMS=="scsi", KERNELS=="0:0:0:0", SYMLINK+="scsi-0:0:0:0"
"""),
Rules.new(
"KERNELS wildcard all",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda",
exp_links = ["scsi-0:0:0:0"],
not_exp_links = ["no-match", "before"],
),
rules = r"""
SUBSYSTEMS=="scsi", KERNELS=="*:1", SYMLINK+="no-match"
SUBSYSTEMS=="scsi", KERNELS=="*:0:1", SYMLINK+="no-match"
SUBSYSTEMS=="scsi", KERNELS=="*:0:0:1", SYMLINK+="no-match"
SUBSYSTEMS=="scsi", KERNEL=="0:0:0:0", SYMLINK+="before"
SUBSYSTEMS=="scsi", KERNELS=="*", SYMLINK+="scsi-0:0:0:0"
"""),
Rules.new(
"KERNELS wildcard partial",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda",
exp_links = ["scsi-0:0:0:0", "before"],
),
rules = r"""
SUBSYSTEMS=="scsi", KERNELS=="0:0:0:0", SYMLINK+="before"
SUBSYSTEMS=="scsi", KERNELS=="*:0", SYMLINK+="scsi-0:0:0:0"
"""),
Rules.new(
"KERNELS wildcard partial 2",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda",
exp_links = ["scsi-0:0:0:0", "before"],
),
rules = r"""
SUBSYSTEMS=="scsi", KERNELS=="0:0:0:0", SYMLINK+="before"
SUBSYSTEMS=="scsi", KERNELS=="*:0:0:0", SYMLINK+="scsi-0:0:0:0"
"""),
Rules.new(
"substitute attr with link target value (first match)",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda",
exp_links = ["driver-is-sd"],
),
rules = r"""
SUBSYSTEMS=="scsi", SYMLINK+="driver-is-$attr{driver}"
"""),
Rules.new(
"substitute attr with link target value (currently selected device)",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda",
exp_links = ["driver-is-ahci"],
),
rules = r"""
SUBSYSTEMS=="pci", SYMLINK+="driver-is-$attr{driver}"
"""),
Rules.new(
"ignore ATTRS attribute whitespace",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda",
exp_links = ["ignored"],
),
rules = r"""
SUBSYSTEMS=="scsi", ATTRS{whitespace_test}=="WHITE SPACE", SYMLINK+="ignored"
"""),
Rules.new(
"do not ignore ATTRS attribute whitespace",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda",
exp_links = ["matched-with-space"],
not_exp_links = ["wrong-to-ignore"],
),
rules = r"""
SUBSYSTEMS=="scsi", ATTRS{whitespace_test}=="WHITE SPACE ", SYMLINK+="wrong-to-ignore"
SUBSYSTEMS=="scsi", ATTRS{whitespace_test}=="WHITE SPACE ", SYMLINK+="matched-with-space"
"""),
Rules.new(
"permissions USER=bad GROUP=name",
Device(
"/devices/virtual/tty/tty33",
exp_perms = "0:0:0600",
),
rules = r"""
KERNEL=="tty33", OWNER="bad", GROUP="name"
"""),
Rules.new(
"permissions OWNER=1",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda",
exp_links = ["node"],
exp_perms = "1::0600",
),
rules = r"""
SUBSYSTEMS=="scsi", KERNEL=="sda", SYMLINK+="node", OWNER="1"
"""),
Rules.new(
"permissions GROUP=1",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda",
exp_links = ["node"],
exp_perms = ":1:0660",
),
rules = r"""
SUBSYSTEMS=="scsi", KERNEL=="sda", SYMLINK+="node", GROUP="1"
"""),
Rules.new(
"textual user id",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda",
exp_links = ["node"],
exp_perms = "daemon::0600",
),
rules = r"""
SUBSYSTEMS=="scsi", KERNEL=="sda", SYMLINK+="node", OWNER="daemon"
"""),
Rules.new(
"textual group id",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda",
exp_links = ["node"],
exp_perms = ":daemon:0660",
),
rules = r"""
SUBSYSTEMS=="scsi", KERNEL=="sda", SYMLINK+="node", GROUP="daemon"
"""),
Rules.new(
"textual user/group id",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda",
exp_links = ["node"],
exp_perms = "root:audio:0660",
),
rules = r"""
SUBSYSTEMS=="scsi", KERNEL=="sda", SYMLINK+="node", OWNER="root", GROUP="audio"
"""),
Rules.new(
"permissions MODE=0777",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda",
exp_links = ["node"],
exp_perms = "::0777",
),
rules = r"""
SUBSYSTEMS=="scsi", KERNEL=="sda", SYMLINK+="node", MODE="0777"
"""),
Rules.new(
"permissions OWNER=1 GROUP=1 MODE=0777",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda",
exp_links = ["node"],
exp_perms = "1:1:0777",
),
rules = r"""
SUBSYSTEMS=="scsi", KERNEL=="sda", SYMLINK+="node", OWNER="1", GROUP="1", MODE="0777"
"""),
Rules.new(
"permissions OWNER to 1",
Device(
"/devices/pci0000:00/0000:00:1d.7/usb5/5-2/5-2:1.0/tty/ttyACM0",
exp_perms = "1::",
),
rules = r"""
KERNEL=="ttyACM[0-9]*", SYMLINK+="ttyACM%n", OWNER="1"
"""),
Rules.new(
"permissions GROUP to 1",
Device(
"/devices/pci0000:00/0000:00:1d.7/usb5/5-2/5-2:1.0/tty/ttyACM0",
exp_perms = ":1:0660",
),
rules = r"""
KERNEL=="ttyACM[0-9]*", SYMLINK+="ttyACM%n", GROUP="1"
"""),
Rules.new(
"permissions MODE to 0060",
Device(
"/devices/pci0000:00/0000:00:1d.7/usb5/5-2/5-2:1.0/tty/ttyACM0",
exp_perms = "::0060",
),
rules = r"""
KERNEL=="ttyACM[0-9]*", SYMLINK+="ttyACM%n", MODE="0060"
"""),
Rules.new(
"permissions OWNER, GROUP, MODE",
Device(
"/devices/pci0000:00/0000:00:1d.7/usb5/5-2/5-2:1.0/tty/ttyACM0",
exp_perms = "1:1:0777",
),
rules = r"""
KERNEL=="ttyACM[0-9]*", SYMLINK+="ttyACM%n", OWNER="1", GROUP="1", MODE="0777"
"""),
Rules.new(
"permissions only rule",
Device(
"/devices/pci0000:00/0000:00:1d.7/usb5/5-2/5-2:1.0/tty/ttyACM0",
exp_perms = "1:1:0777",
),
rules = r"""
KERNEL=="ttyACM[0-9]*", OWNER="1", GROUP="1", MODE="0777"
KERNEL=="ttyUSX[0-9]*", OWNER="2", GROUP="2", MODE="0444"
KERNEL=="ttyACM[0-9]*", SYMLINK+="ttyACM%n"
"""),
Rules.new(
"multiple permissions only rule",
Device(
"/devices/pci0000:00/0000:00:1d.7/usb5/5-2/5-2:1.0/tty/ttyACM0",
exp_perms = "1:1:0777",
),
rules = r"""
SUBSYSTEM=="tty", OWNER="1"
SUBSYSTEM=="tty", GROUP="1"
SUBSYSTEM=="tty", MODE="0777"
KERNEL=="ttyUSX[0-9]*", OWNER="2", GROUP="2", MODE="0444"
KERNEL=="ttyACM[0-9]*", SYMLINK+="ttyACM%n"
"""),
Rules.new(
"permissions only rule with override at SYMLINK+ rule",
Device(
"/devices/pci0000:00/0000:00:1d.7/usb5/5-2/5-2:1.0/tty/ttyACM0",
exp_perms = "1:2:0777",
),
rules = r"""
SUBSYSTEM=="tty", OWNER="1"
SUBSYSTEM=="tty", GROUP="1"
SUBSYSTEM=="tty", MODE="0777"
KERNEL=="ttyUSX[0-9]*", OWNER="2", GROUP="2", MODE="0444"
KERNEL=="ttyACM[0-9]*", SYMLINK+="ttyACM%n", GROUP="2"
"""),
Rules.new(
"major/minor number test",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda",
exp_links = ["node"],
exp_major_minor = "8:0",
),
rules = r"""
SUBSYSTEMS=="scsi", KERNEL=="sda", SYMLINK+="node"
"""),
Rules.new(
"big major number test",
Device(
"/devices/virtual/misc/misc-fake1",
exp_links = ["node"],
exp_major_minor = "4095:1",
),
rules = r"""
KERNEL=="misc-fake1", SYMLINK+="node"
"""),
Rules.new(
"big major and big minor number test",
Device(
"/devices/virtual/misc/misc-fake89999",
exp_links = ["node"],
exp_major_minor = "4095:89999",
),
rules = r"""
KERNEL=="misc-fake89999", SYMLINK+="node"
"""),
Rules.new(
"multiple symlinks with format char",
Device(
"/devices/pci0000:00/0000:00:1d.7/usb5/5-2/5-2:1.0/tty/ttyACM0",
exp_links = ["symlink1-0", "symlink2-ttyACM0", "symlink3-"],
),
rules = r"""
KERNEL=="ttyACM[0-9]*", SYMLINK="symlink1-%n symlink2-%k symlink3-%b"
"""),
Rules.new(
"multiple symlinks with a lot of s p a c e s",
Device(
"/devices/pci0000:00/0000:00:1d.7/usb5/5-2/5-2:1.0/tty/ttyACM0",
exp_links = ["one", "two"],
not_exp_links = [" "],
),
rules = r"""
KERNEL=="ttyACM[0-9]*", SYMLINK=" one two "
"""),
Rules.new(
"symlink with spaces in substituted variable",
Device(
"/devices/pci0000:00/0000:00:1d.7/usb5/5-2/5-2:1.0/tty/ttyACM0",
exp_links = ["name-one_two_three-end"],
not_exp_links = [" "],
),
rules = r"""
ENV{WITH_WS}="one two three"
SYMLINK="name-$env{WITH_WS}-end"
"""),
Rules.new(
"symlink with leading space in substituted variable",
Device(
"/devices/pci0000:00/0000:00:1d.7/usb5/5-2/5-2:1.0/tty/ttyACM0",
exp_links = ["name-one_two_three-end"],
not_exp_links = [" "],
),
rules = r"""
ENV{WITH_WS}=" one two three"
SYMLINK="name-$env{WITH_WS}-end"
"""),
Rules.new(
"symlink with trailing space in substituted variable",
Device(
"/devices/pci0000:00/0000:00:1d.7/usb5/5-2/5-2:1.0/tty/ttyACM0",
exp_links = ["name-one_two_three-end"],
not_exp_links = [" "],
),
rules = r"""
ENV{WITH_WS}="one two three "
SYMLINK="name-$env{WITH_WS}-end"
"""),
Rules.new(
"symlink with lots of space in substituted variable",
Device(
"/devices/pci0000:00/0000:00:1d.7/usb5/5-2/5-2:1.0/tty/ttyACM0",
exp_links = ["name-one_two_three-end"],
not_exp_links = [" "],
),
rules = r"""
ENV{WITH_WS}=" one two three "
SYMLINK="name-$env{WITH_WS}-end"
"""),
Rules.new(
"symlink with multiple spaces in substituted variable",
Device(
"/devices/pci0000:00/0000:00:1d.7/usb5/5-2/5-2:1.0/tty/ttyACM0",
exp_links = ["name-one_two_three-end"],
not_exp_links = [" "],
),
rules = r"""
ENV{WITH_WS}=" one two three "
SYMLINK="name-$env{WITH_WS}-end"
"""),
Rules.new(
"symlink with space and var with space",
Device(
"/devices/pci0000:00/0000:00:1d.7/usb5/5-2/5-2:1.0/tty/ttyACM0",
exp_links = ["first", "name-one_two_three-end",
"another_symlink", "a", "b", "c"],
not_exp_links = [" "],
),
rules = r"""
ENV{WITH_WS}=" one two three "
SYMLINK=" first name-$env{WITH_WS}-end another_symlink a b c "
"""),
Rules.new(
"symlink with env which contain slash (see #19309)",
Device(
"/devices/pci0000:00/0000:00:1d.7/usb5/5-2/5-2:1.0/tty/ttyACM0",
exp_links = ["first", "name-aaa_bbb_ccc-end",
"another_symlink", "a", "b", "c"],
not_exp_links = ["ame-aaa/bbb/ccc-end"],
),
rules = r"""
ENV{WITH_SLASH}="aaa/bbb/ccc"
OPTIONS="string_escape=replace", ENV{REPLACED}="$env{WITH_SLASH}"
SYMLINK=" first name-$env{REPLACED}-end another_symlink a b c "
"""),
Rules.new(
"symlink creation (same directory)",
Device(
"/devices/pci0000:00/0000:00:1d.7/usb5/5-2/5-2:1.0/tty/ttyACM0",
exp_links = ["modem0"],
),
rules = r"""
KERNEL=="ttyACM[0-9]*", SYMLINK+="ttyACM%n", SYMLINK="modem%n"
"""),
Rules.new(
"multiple symlinks",
Device(
"/devices/pci0000:00/0000:00:1d.7/usb5/5-2/5-2:1.0/tty/ttyACM0",
exp_links = ["first-0", "second-0", "third-0"],
),
rules = r"""
KERNEL=="ttyACM0", SYMLINK="first-%n second-%n third-%n"
"""),
Rules.new(
"symlink name '.'",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda",
),
# we get a warning, but the process does not fail
rules = r"""
SUBSYSTEMS=="scsi", KERNEL=="sda", SYMLINK+="."
"""),
Rules.new(
"symlink node to itself",
Device(
"/devices/virtual/tty/tty0",
),
# we get a warning, but the process does not fail
rules = r"""
KERNEL=="tty0", SYMLINK+="tty0"
"""),
Rules.new(
"symlink %n substitution",
Device(
"/devices/pci0000:00/0000:00:1d.7/usb5/5-2/5-2:1.0/tty/ttyACM0",
exp_links = ["symlink0"],
),
rules = r"""
KERNEL=="ttyACM[0-9]*", SYMLINK+="ttyACM%n", SYMLINK+="symlink%n"
"""),
Rules.new(
"symlink %k substitution",
Device(
"/devices/pci0000:00/0000:00:1d.7/usb5/5-2/5-2:1.0/tty/ttyACM0",
exp_links = ["symlink-ttyACM0"],
),
rules = r"""
KERNEL=="ttyACM[0-9]*", SYMLINK+="ttyACM%n", SYMLINK+="symlink-%k"
"""),
Rules.new(
"symlink %M:%m substitution",
Device(
"/devices/pci0000:00/0000:00:1d.7/usb5/5-2/5-2:1.0/tty/ttyACM0",
exp_links = ["major-166:0"],
),
rules = r"""
KERNEL=="ttyACM[0-9]*", SYMLINK+="ttyACM%n", SYMLINK+="major-%M:%m"
"""),
Rules.new(
"symlink %b substitution",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda",
exp_links = ["symlink-0:0:0:0"],
),
rules = r"""
SUBSYSTEMS=="scsi", KERNEL=="sda", SYMLINK+="symlink-%b"
"""),
Rules.new(
"symlink %c substitution",
Device(
"/devices/pci0000:00/0000:00:1d.7/usb5/5-2/5-2:1.0/tty/ttyACM0",
exp_links = ["test"],
),
rules = r"""
KERNEL=="ttyACM[0-9]*", PROGRAM=="/bin/echo test", SYMLINK+="%c"
"""),
Rules.new(
"symlink %c{N} substitution",
Device(
"/devices/pci0000:00/0000:00:1d.7/usb5/5-2/5-2:1.0/tty/ttyACM0",
exp_links = ["test"],
not_exp_links = ["symlink", "this"],
),
rules = r"""
KERNEL=="ttyACM[0-9]*", PROGRAM=="/bin/echo symlink test this", SYMLINK+="%c{2}"
"""),
Rules.new(
"symlink %c{N+} substitution",
Device(
"/devices/pci0000:00/0000:00:1d.7/usb5/5-2/5-2:1.0/tty/ttyACM0",
exp_links = ["test", "this"],
not_exp_links = ["symlink"],
),
rules = r"""
KERNEL=="ttyACM[0-9]*", PROGRAM=="/bin/echo symlink test this", SYMLINK+="%c{2+}"
"""),
Rules.new(
"symlink only rule with %c{N+}",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda",
exp_links = ["test", "this"],
not_exp_links = ["symlink"],
),
rules = r"""
SUBSYSTEMS=="scsi", KERNEL=="sda", PROGRAM=="/bin/echo link test this" SYMLINK+="%c{2+}"
"""),
Rules.new(
"symlink %s{filename} substitution",
Device(
"/devices/pci0000:00/0000:00:1d.7/usb5/5-2/5-2:1.0/tty/ttyACM0",
exp_links = ["166:0"],
),
rules = r"""
KERNEL=="ttyACM[0-9]*", SYMLINK+="%s{dev}"
"""),
Rules.new(
"program result substitution (numbered part of)",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda5",
exp_links = ["link1", "link2"],
not_exp_links = ["node"],
),
rules = r"""
SUBSYSTEMS=="scsi", PROGRAM=="/bin/echo -n node link1 link2", RESULT=="node *", SYMLINK+="%c{2} %c{3}"
"""),
Rules.new(
"program result substitution (numbered part of+)",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda5",
exp_links = ["link1", "link2", "link3", "link4"],
not_exp_links = ["node"],
),
rules = r"""
SUBSYSTEMS=="scsi", PROGRAM=="/bin/echo -n node link1 link2 link3 link4", RESULT=="node *", SYMLINK+="%c{2+}"
"""),
Rules.new(
"SUBSYSTEM match test",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda",
exp_links = ["node"],
not_exp_links = ["should_not_match", "should_not_match2"],
),
rules = r"""
SUBSYSTEMS=="scsi", KERNEL=="sda", SYMLINK+="should_not_match", SUBSYSTEM=="vc"
SUBSYSTEMS=="scsi", KERNEL=="sda", SYMLINK+="node", SUBSYSTEM=="block"
SUBSYSTEMS=="scsi", KERNEL=="sda", SYMLINK+="should_not_match2", SUBSYSTEM=="vc"
"""),
Rules.new(
"DRIVERS match test",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda",
exp_links = ["node"],
not_exp_links = ["should_not_match"]
),
rules = r"""
SUBSYSTEMS=="scsi", KERNEL=="sda", SYMLINK+="should_not_match", DRIVERS=="sd-wrong"
SUBSYSTEMS=="scsi", KERNEL=="sda", SYMLINK+="node", DRIVERS=="sd"
"""),
Rules.new(
"devnode substitution test",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda",
exp_links = ["node"],
),
rules = r"""
SUBSYSTEMS=="scsi", KERNEL=="sda", PROGRAM=="/usr/bin/test -b %N" SYMLINK+="node"
"""),
Rules.new(
"parent node name substitution test",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda1",
exp_links = ["sda-part-1"],
),
rules = r"""
SUBSYSTEMS=="scsi", KERNEL=="sda1", SYMLINK+="%P-part-%n"
"""),
Rules.new(
"udev_root substitution",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda1",
exp_links = ["start-/dev-end"],
),
rules = r"""
SUBSYSTEMS=="scsi", KERNEL=="sda1", SYMLINK+="start-%r-end"
"""),
Rules.new(
# This is not supported any more
"last_rule option",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda1",
exp_links = ["last", "very-last"],
),
rules = r"""
SUBSYSTEMS=="scsi", KERNEL=="sda1", SYMLINK+="last", OPTIONS="last_rule"
SUBSYSTEMS=="scsi", KERNEL=="sda1", SYMLINK+="very-last"
"""),
Rules.new(
"negation KERNEL!=",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda1",
exp_links = ["match", "before"],
not_exp_links = ["matches-but-is-negated"],
),
rules = r"""
SUBSYSTEMS=="scsi", KERNEL!="sda1", SYMLINK+="matches-but-is-negated"
SUBSYSTEMS=="scsi", KERNEL=="sda1", SYMLINK+="before"
SUBSYSTEMS=="scsi", KERNEL!="xsda1", SYMLINK+="match"
"""),
Rules.new(
"negation SUBSYSTEM!=",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda1",
exp_links = ["before", "not-anything"],
not_exp_links = ["matches-but-is-negated"],
),
rules = r"""
SUBSYSTEMS=="scsi", SUBSYSTEM=="block", KERNEL!="sda1", SYMLINK+="matches-but-is-negated"
SUBSYSTEMS=="scsi", KERNEL=="sda1", SYMLINK+="before"
SUBSYSTEMS=="scsi", SUBSYSTEM!="anything", SYMLINK+="not-anything"
"""),
Rules.new(
"negation PROGRAM!= exit code",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda1",
exp_links = ["before", "nonzero-program"],
),
rules = r"""
SUBSYSTEMS=="scsi", KERNEL=="sda1", SYMLINK+="before"
KERNEL=="sda1", PROGRAM!="/bin/false", SYMLINK+="nonzero-program"
"""),
Rules.new(
"ENV{} test",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda1",
exp_links = ["true"],
not_exp_links = ["bad", "wrong"],
),
rules = r"""
ENV{ENV_KEY_TEST}="test"
SUBSYSTEMS=="scsi", KERNEL=="sda1", ENV{ENV_KEY_TEST}=="go", SYMLINK+="wrong"
SUBSYSTEMS=="scsi", KERNEL=="sda1", ENV{ENV_KEY_TEST}=="test", SYMLINK+="true"
SUBSYSTEMS=="scsi", KERNEL=="sda1", ENV{ENV_KEY_TEST}=="bad", SYMLINK+="bad"
"""),
Rules.new(
"ENV{} test",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda1",
exp_links = ["true"],
not_exp_links = ["bad", "wrong", "no"],
),
rules = r"""
ENV{ENV_KEY_TEST}="test"
SUBSYSTEMS=="scsi", KERNEL=="sda1", ENV{ENV_KEY_TEST}=="go", SYMLINK+="wrong"
SUBSYSTEMS=="scsi", KERNEL=="sda1", ENV{ENV_KEY_TEST}=="yes", ENV{ACTION}=="add", ENV{DEVPATH}=="*/block/sda/sdax1", SYMLINK+="no"
SUBSYSTEMS=="scsi", KERNEL=="sda1", ENV{ENV_KEY_TEST}=="test", ENV{ACTION}=="add", ENV{DEVPATH}=="*/block/sda/sda1", SYMLINK+="true"
SUBSYSTEMS=="scsi", KERNEL=="sda1", ENV{ENV_KEY_TEST}=="bad", SYMLINK+="bad"
"""),
Rules.new(
"ENV{} test (assign)",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda1",
exp_links = ["true", "before"],
not_exp_links = ["no"],
),
rules = r"""
SUBSYSTEMS=="scsi", KERNEL=="sda1", ENV{ASSIGN}="true"
SUBSYSTEMS=="scsi", KERNEL=="sda1", ENV{ASSIGN}=="yes", SYMLINK+="no"
SUBSYSTEMS=="scsi", KERNEL=="sda1", SYMLINK+="before"
SUBSYSTEMS=="scsi", KERNEL=="sda1", ENV{ASSIGN}=="true", SYMLINK+="true"
"""),
Rules.new(
"ENV{} test (assign 2 times)",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda1",
exp_links = ["true", "before"],
not_exp_links = ["no", "bad"],
),
rules = r"""
SUBSYSTEMS=="scsi", KERNEL=="sda1", ENV{ASSIGN}="true"
SUBSYSTEMS=="scsi", KERNEL=="sda1", ENV{ASSIGN}="absolutely-$env{ASSIGN}"
SUBSYSTEMS=="scsi", KERNEL=="sda1", SYMLINK+="before"
SUBSYSTEMS=="scsi", KERNEL=="sda1", ENV{ASSIGN}=="yes", SYMLINK+="no"
SUBSYSTEMS=="scsi", KERNEL=="sda1", ENV{ASSIGN}=="true", SYMLINK+="bad"
SUBSYSTEMS=="scsi", KERNEL=="sda1", ENV{ASSIGN}=="absolutely-true", SYMLINK+="true"
"""),
Rules.new(
"ENV{} test (assign2)",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda1",
exp_links = ["part"],
not_exp_links = ["disk"],
),
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda",
exp_links = ["disk"],
not_exp_links = ["part"],
),
rules = r"""
SUBSYSTEM=="block", KERNEL=="*[0-9]", ENV{PARTITION}="true", ENV{MAINDEVICE}="false"
SUBSYSTEM=="block", KERNEL=="*[!0-9]", ENV{PARTITION}="false", ENV{MAINDEVICE}="true"
ENV{MAINDEVICE}=="true", SYMLINK+="disk"
SUBSYSTEM=="block", SYMLINK+="before"
ENV{PARTITION}=="true", SYMLINK+="part"
"""),
Rules.new(
"untrusted string sanitize",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda1",
exp_links = ["sane"],
),
rules = r"""
SUBSYSTEMS=="scsi", KERNEL=="sda1", PROGRAM=="/bin/echo -e name; (/usr/bin/badprogram)", RESULT=="name_ _/usr/bin/badprogram_", SYMLINK+="sane"
"""),
Rules.new(
"untrusted string sanitize (don't replace utf8)",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda1",
exp_links = ["uber"],
),
rules = r"""
SUBSYSTEMS=="scsi", KERNEL=="sda1", PROGRAM=="/bin/echo -e \xc3\xbcber" RESULT=="über", SYMLINK+="uber"
"""),
Rules.new(
"untrusted string sanitize (replace invalid utf8)",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda1",
exp_links = ["replaced"],
),
rules = r"""
SUBSYSTEMS=="scsi", KERNEL=="sda1", PROGRAM=="/bin/echo -e \xef\xe8garbage", RESULT=="__garbage", SYMLINK+="replaced"
"""),
Rules.new(
"read sysfs value from parent device",
Device(
"/devices/pci0000:00/0000:00:1d.7/usb5/5-2/5-2:1.0/tty/ttyACM0",
exp_links = ["serial-354172020305000"],
),
rules = r"""
KERNEL=="ttyACM*", ATTRS{serial}=="?*", SYMLINK+="serial-%s{serial}"
"""),
Rules.new(
"match against empty key string",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda",
exp_links = ["ok"],
not_exp_links = ["not-1-ok", "not-2-ok", "not-3-ok"],
),
rules = r"""
KERNEL=="sda", ATTRS{nothing}!="", SYMLINK+="not-1-ok"
KERNEL=="sda", ATTRS{nothing}=="", SYMLINK+="not-2-ok"
KERNEL=="sda", ATTRS{vendor}!="", SYMLINK+="ok"
KERNEL=="sda", ATTRS{vendor}=="", SYMLINK+="not-3-ok"
"""),
Rules.new(
"check ACTION value",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda",
exp_links = ["ok"],
not_exp_links = ["unknown-not-ok"],
),
rules = r"""
ACTION=="unknown", KERNEL=="sda", SYMLINK+="unknown-not-ok"
ACTION=="add", KERNEL=="sda", SYMLINK+="ok"
"""),
Rules.new(
"final assignment",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda",
exp_links = ["ok"],
exp_perms = "root:tty:0640",
),
rules = r"""
KERNEL=="sda", GROUP:="tty"
KERNEL=="sda", GROUP="root", MODE="0640", SYMLINK+="ok"
"""),
Rules.new(
"final assignment 2",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda",
exp_links = ["ok"],
exp_perms = "root:tty:0640",
),
rules = r"""
KERNEL=="sda", GROUP:="tty"
SUBSYSTEM=="block", MODE:="640"
KERNEL=="sda", GROUP="root", MODE="0666", SYMLINK+="ok"
"""),
Rules.new(
"env substitution",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda",
exp_links = ["node-add-me"],
),
rules = r"""
KERNEL=="sda", MODE="0666", SYMLINK+="node-$env{ACTION}-me"
"""),
Rules.new(
"reset list to current value",
Device(
"/devices/pci0000:00/0000:00:1d.7/usb5/5-2/5-2:1.0/tty/ttyACM0",
exp_links = ["three"],
not_exp_links = ["two", "one"],
),
rules = r"""
KERNEL=="ttyACM[0-9]*", SYMLINK+="one"
KERNEL=="ttyACM[0-9]*", SYMLINK+="two"
KERNEL=="ttyACM[0-9]*", SYMLINK="three"
"""),
Rules.new(
"test empty SYMLINK+ (empty override)",
Device(
"/devices/pci0000:00/0000:00:1d.7/usb5/5-2/5-2:1.0/tty/ttyACM0",
exp_links = ["right"],
not_exp_links = ["wrong"],
),
rules = r"""
KERNEL=="ttyACM[0-9]*", SYMLINK+="wrong"
KERNEL=="ttyACM[0-9]*", SYMLINK=""
KERNEL=="ttyACM[0-9]*", SYMLINK+="right"
"""),
Rules.new(
"test multi matches",
Device(
"/devices/pci0000:00/0000:00:1d.7/usb5/5-2/5-2:1.0/tty/ttyACM0",
exp_links = ["right", "before"],
),
rules = r"""
KERNEL=="ttyACM*", SYMLINK+="before"
KERNEL=="ttyACM*|nothing", SYMLINK+="right"
"""),
Rules.new(
"test multi matches 2",
Device(
"/devices/pci0000:00/0000:00:1d.7/usb5/5-2/5-2:1.0/tty/ttyACM0",
exp_links = ["right", "before"],
not_exp_links = ["nomatch"],
),
rules = r"""
KERNEL=="dontknow*|*nothing", SYMLINK+="nomatch"
KERNEL=="ttyACM*", SYMLINK+="before"
KERNEL=="dontknow*|ttyACM*|nothing*", SYMLINK+="right"
"""),
Rules.new(
"test multi matches 3",
Device(
"/devices/pci0000:00/0000:00:1d.7/usb5/5-2/5-2:1.0/tty/ttyACM0",
exp_links = ["right"],
not_exp_links = ["nomatch", "wrong1", "wrong2"],
),
rules = r"""
KERNEL=="dontknow|nothing", SYMLINK+="nomatch"
KERNEL=="dontknow|ttyACM0a|nothing|attyACM0", SYMLINK+="wrong1"
KERNEL=="X|attyACM0|dontknow|ttyACM0a|nothing|attyACM0", SYMLINK+="wrong2"
KERNEL=="dontknow|ttyACM0|nothing", SYMLINK+="right"
"""),
Rules.new(
"test multi matches 4",
Device(
"/devices/pci0000:00/0000:00:1d.7/usb5/5-2/5-2:1.0/tty/ttyACM0",
exp_links = ["right"],
not_exp_links = ["nomatch", "wrong1", "wrong2", "wrong3"],
),
rules = r"""
KERNEL=="dontknow|nothing", SYMLINK+="nomatch"
KERNEL=="dontknow|ttyACM0a|nothing|attyACM0", SYMLINK+="wrong1"
KERNEL=="X|attyACM0|dontknow|ttyACM0a|nothing|attyACM0", SYMLINK+="wrong2"
KERNEL=="all|dontknow|ttyACM0", SYMLINK+="right"
KERNEL=="ttyACM0a|nothing", SYMLINK+="wrong3"
"""),
Rules.new(
"test multi matches 5",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda",
exp_links = ["found"],
not_exp_links = ["bad"],
),
rules = r"""
KERNEL=="sda", TAG="foo"
TAGS=="|foo", SYMLINK+="found"
TAGS=="|aaa", SYMLINK+="bad"
"""),
Rules.new(
"test multi matches 6",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda",
exp_links = ["found"],
not_exp_links = ["bad"],
),
rules = r"""
KERNEL=="sda", ENV{HOGE}=""
ENV{HOGE}=="|foo", SYMLINK+="found"
ENV{HOGE}=="aaa|bbb", SYMLINK+="bad"
"""),
Rules.new(
"test multi matches 7",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda",
exp_links = ["found"],
not_exp_links = ["bad"],
),
rules = r"""
KERNEL=="sda", TAG="foo"
TAGS=="foo||bar", SYMLINK+="found"
TAGS=="aaa||bbb", SYMLINK+="bad"
"""),
Rules.new(
"test multi matches 8",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda",
exp_links = ["found"],
not_exp_links = ["bad"],
),
rules = r"""
KERNEL=="sda", ENV{HOGE}=""
ENV{HOGE}=="foo||bar", SYMLINK+="found"
ENV{HOGE}=="aaa|bbb", SYMLINK+="bad"
"""),
Rules.new(
"test multi matches 9",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda",
exp_links = ["found", "found2"],
not_exp_links = ["bad"],
),
rules = r"""
KERNEL=="sda", TAG="foo"
TAGS=="foo|", SYMLINK+="found"
TAGS=="aaa|", SYMLINK+="bad"
KERNEL=="sda", TAGS!="hoge", SYMLINK+="found2"
KERNEL=="sda", TAGS!="foo", SYMLINK+="bad2"
"""),
Rules.new(
"test multi matches 10",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda",
exp_links = ["found"],
not_exp_links = ["bad"],
),
rules = r"""
KERNEL=="sda", ENV{HOGE}=""
ENV{HOGE}=="foo|", SYMLINK+="found"
ENV{HOGE}=="aaa|bbb", SYMLINK+="bad"
"""),
Rules.new(
"test multi matches 11",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda",
exp_links = ["found"],
not_exp_links = ["bad"],
),
rules = r"""
KERNEL=="sda", TAG="c"
TAGS=="foo||bar||c", SYMLINK+="found"
TAGS=="aaa||bbb||ccc", SYMLINK+="bad"
"""),
Rules.new(
"TAG refuses invalid string",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda",
exp_links = ["valid", "found"],
not_exp_links = ["empty", "invalid_char", "path", "bad", "bad2"],
),
rules = r"""
KERNEL=="sda", TAG+="", TAG+="invalid.char", TAG+="path/is/also/invalid", TAG+="valid"
TAGS=="", SYMLINK+="empty"
TAGS=="invalid.char", SYMLINK+="invalid_char"
TAGS=="path/is/also/invalid", SYMLINK+="path"
TAGS=="valid", SYMLINK+="valid"
TAGS=="valid|", SYMLINK+="found"
TAGS=="aaa|", SYMLINK+="bad"
TAGS=="aaa|bbb", SYMLINK+="bad2"
"""),
Rules.new(
"IMPORT parent test",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda",
exp_links = ["parent"],
),
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda1",
exp_links = ["parentenv-parent_right"],
),
delay = 500000, # Serialized! We need to sleep here after adding sda
rules = r"""
KERNEL=="sda1", IMPORT{parent}="PARENT*", SYMLINK+="parentenv-$env{PARENT_KEY}$env{WRONG_PARENT_KEY}"
KERNEL=="sda", IMPORT{program}="/bin/echo -e 'PARENT_KEY=parent_right\nWRONG_PARENT_KEY=parent_wrong'"
KERNEL=="sda", SYMLINK+="parent"
"""),
Rules.new(
"GOTO test",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda1",
exp_links = ["right"],
not_exp_links = ["wrong", "wrong2"],
),
rules = r"""
KERNEL=="sda1", GOTO="TEST"
KERNEL=="sda1", SYMLINK+="wrong"
KERNEL=="sda1", GOTO="BAD"
KERNEL=="sda1", SYMLINK+="", LABEL="NO"
KERNEL=="sda1", SYMLINK+="right", LABEL="TEST", GOTO="end"
KERNEL=="sda1", SYMLINK+="wrong2", LABEL="BAD"
LABEL="end"
"""),
Rules.new(
"GOTO label does not exist",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda1",
exp_links = ["right"],
),
rules = r"""
KERNEL=="sda1", GOTO="does-not-exist"
KERNEL=="sda1", SYMLINK+="right",
LABEL="exists"
"""),
Rules.new(
"SYMLINK+ compare test",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda1",
exp_links = ["right", "link"],
not_exp_links = ["wrong"],
),
rules = r"""
KERNEL=="sda1", SYMLINK+="link"
KERNEL=="sda1", SYMLINK=="link*", SYMLINK+="right"
KERNEL=="sda1", SYMLINK=="nolink*", SYMLINK+="wrong"
"""),
Rules.new(
"invalid key operation",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda1",
exp_links = ["yes"],
not_exp_links = ["no"],
),
rules = r"""
KERNEL="sda1", SYMLINK+="no"
KERNEL=="sda1", SYMLINK+="yes"
"""),
Rules.new(
"operator chars in attribute",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda",
exp_links = ["yes"],
),
rules = r"""
KERNEL=="sda", ATTR{test:colon+plus}=="?*", SYMLINK+="yes"
"""),
Rules.new(
"overlong comment line",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda1",
exp_links = ["yes"],
not_exp_links = ["no"],
),
rules = r"""
# 012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789
# 012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789
KERNEL=="sda1", SYMLINK+=="no"
KERNEL=="sda1", SYMLINK+="yes"
"""),
Rules.new(
"magic subsys/kernel lookup",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda",
exp_links = ["00:16:41:e2:8d:ff"],
),
rules = r"""
KERNEL=="sda", SYMLINK+="$attr{[net/eth0]address}"
"""),
Rules.new(
"TEST absolute path",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda",
exp_links = ["there"],
not_exp_links = ["notthere"],
),
rules = r"""
TEST=="/etc/passwd", SYMLINK+="there"
TEST!="/etc/passwd", SYMLINK+="notthere"
"""),
Rules.new(
"TEST subsys/kernel lookup",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda",
exp_links = ["yes"],
),
rules = r"""
KERNEL=="sda", TEST=="[net/eth0]", SYMLINK+="yes"
"""),
Rules.new(
"TEST relative path",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda",
exp_links = ["relative"],
),
rules = r"""
KERNEL=="sda", TEST=="size", SYMLINK+="relative"
"""),
Rules.new(
"TEST wildcard substitution (find queue/nr_requests)",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda",
exp_links = ["found-subdir"],
),
rules = r"""
KERNEL=="sda", TEST=="*/nr_requests", SYMLINK+="found-subdir"
"""),
Rules.new(
"TEST MODE=0000",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda",
exp_perms = "0:0:0000",
),
rules = r"""
KERNEL=="sda", MODE="0000"
"""),
Rules.new(
"TEST PROGRAM feeds OWNER, GROUP, MODE",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda",
exp_perms = "1:1:0400",
),
rules = r"""
KERNEL=="sda", MODE="666"
KERNEL=="sda", PROGRAM=="/bin/echo 1 1 0400", OWNER="%c{1}", GROUP="%c{2}", MODE="%c{3}"
"""),
Rules.new(
"TEST PROGRAM feeds MODE with overflow",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda",
exp_perms = "0:0:0440",
),
rules = r"""
KERNEL=="sda", MODE="440"
KERNEL=="sda", PROGRAM=="/bin/echo 0 0 0400letsdoabuffferoverflow0123456789012345789012345678901234567890", OWNER="%c{1}", GROUP="%c{2}", MODE="%c{3}"
"""),
Rules.new(
"magic [subsys/sysname] attribute substitution",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda",
exp_links = ["sda-8741C4G-end"],
exp_perms = "0:0:0600",
),
rules = r"""
KERNEL=="sda", SYMLINK+="%k-%s{[dmi/id]product_name}-end"
"""),
Rules.new(
"builtin path_id",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda",
exp_links = ["disk/by-path/pci-0000:00:1f.2-scsi-0:0:0:0"],
),
rules = r"""
KERNEL=="sda", IMPORT{builtin}="path_id"
KERNEL=="sda", ENV{ID_PATH}=="?*", SYMLINK+="disk/by-path/$env{ID_PATH}"
"""),
Rules.new(
"add and match tag",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda",
exp_links = ["found"],
not_exp_links = ["bad"],
),
rules = r"""
SUBSYSTEMS=="scsi", ATTRS{vendor}=="ATA", TAG+="green"
TAGS=="green", SYMLINK+="found"
TAGS=="blue", SYMLINK+="bad"
"""),
Rules.new(
"don't crash with lots of tags",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda",
exp_links = ["found"],
),
rules = f"""
{rules_10k_tags}
TAGS=="test1", TAGS=="test500", TAGS=="test1234", TAGS=="test9999", TAGS=="test10000", SYMLINK+="found"
"""),
Rules.new(
"continuations",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda",
exp_links = ["found"],
not_exp_links = ["bad"],
),
rules = f"""
{rules_10k_tags_continuation}
TAGS=="test1", TAGS=="test500", TAGS=="test1234", TAGS=="test9999", TAGS=="test10000", SYMLINK+="bad"
KERNEL=="sda",\\
# comment in continuation
TAG+="hoge1",\\
# space before comment
TAG+="hoge2",\\
# spaces before and after token are dropped
TAG+="hoge3", \\
\\
\\
TAG+="hoge4"
TAGS=="hoge1", TAGS=="hoge2", TAGS=="hoge3", TAGS=="hoge4", SYMLINK+="found"
"""),
Rules.new(
"continuations with empty line",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda",
exp_links = ["found"],
not_exp_links = ["bad"],
),
rules = r"""
# empty line finishes continuation
KERNEL=="sda", TAG+="foo" \
KERNEL=="sdb", TAG+="hoge"
KERNEL=="sda", TAG+="aaa" \
KERNEL=="sdb", TAG+="bbb"
TAGS=="foo", SYMLINK+="found"
TAGS=="aaa", SYMLINK+="bad"
"""),
Rules.new(
"continuations with space only line",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda",
exp_links = ["found"],
not_exp_links = ["bad"],
),
rules = """
# space only line finishes continuation
KERNEL=="sda", TAG+="foo" \\
\t
KERNEL=="sdb", TAG+="hoge"
KERNEL=="sda", TAG+="aaa" \\
KERNEL=="sdb", TAG+="bbb"
TAGS=="foo", SYMLINK+="found"
TAGS=="aaa", SYMLINK+="bad"
"""),
Rules.new(
"multiple devices",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda1",
exp_links = ["part-1"],
),
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda5",
exp_links = ["part-5"],
),
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda6",
exp_links = ["part-6"],
),
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda7",
exp_links = ["part-7"],
),
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda8",
exp_links = ["part-8"],
),
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda9",
exp_links = ["part-9"],
),
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda10",
exp_links = ["part-10"],
),
rules = r"""
SUBSYSTEM=="block", SUBSYSTEMS=="scsi", KERNEL=="sda?*", ENV{DEVTYPE}=="partition", SYMLINK+="part-%n"
"""),
Rules.new(
"multiple devices, same link name, positive prio",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda1",
exp_links = ["part-1"],
not_exp_links = ["partition"],
),
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda5",
exp_links = ["part-5"],
not_exp_links = ["partition"],
),
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda6",
not_exp_links = ["partition"],
exp_links = ["part-6"],
),
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda7",
exp_links = ["part-7", "partition"],
),
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda8",
not_exp_links = ["partition"],
exp_links = ["part-8"],
),
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda9",
not_exp_links = ["partition"],
exp_links = ["part-9"],
),
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda10",
not_exp_links = ["partition"],
exp_links = ["part-10"],
),
repeat = 100,
rules = r"""
SUBSYSTEM=="block", SUBSYSTEMS=="scsi", KERNEL=="sda?*", ENV{DEVTYPE}=="partition", SYMLINK+="part-%n"
SUBSYSTEM=="block", SUBSYSTEMS=="scsi", KERNEL=="sda?*", ENV{DEVTYPE}=="partition", SYMLINK+="partition"
KERNEL=="*7", OPTIONS+="link_priority=10"
"""),
Rules.new(
"multiple devices, same link name, negative prio",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda1",
exp_links = ["part-1"],
not_exp_links = ["partition"],
),
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda5",
exp_links = ["part-5"],
not_exp_links = ["partition"],
),
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda6",
not_exp_links = ["partition"],
exp_links = ["part-6"],
),
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda7",
exp_links = ["part-7", "partition"],
),
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda8",
not_exp_links = ["partition"],
exp_links = ["part-8"],
),
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda9",
not_exp_links = ["partition"],
exp_links = ["part-9"],
),
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda10",
not_exp_links = ["partition"],
exp_links = ["part-10"],
),
rules = r"""
SUBSYSTEM=="block", SUBSYSTEMS=="scsi", KERNEL=="sda?*", ENV{DEVTYPE}=="partition", SYMLINK+="part-%n"
SUBSYSTEM=="block", SUBSYSTEMS=="scsi", KERNEL=="sda?*", ENV{DEVTYPE}=="partition", SYMLINK+="partition"
KERNEL!="*7", OPTIONS+="link_priority=-10"
"""),
Rules.new(
"multiple devices, same link name, positive prio, sleep",
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda1",
exp_links = ["part-1"],
not_exp_links = ["partition"],
),
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda5",
exp_links = ["part-5"],
not_exp_links = ["partition"],
),
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda6",
not_exp_links = ["partition"],
exp_links = ["part-6"],
),
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda7",
exp_links = ["part-7", "partition"],
),
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda8",
not_exp_links = ["partition"],
exp_links = ["part-8"],
),
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda9",
not_exp_links = ["partition"],
exp_links = ["part-9"],
),
Device(
"/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda10",
not_exp_links = ["partition"],
exp_links = ["part-10"],
),
delay = 10000,
rules = r"""
SUBSYSTEM=="block", SUBSYSTEMS=="scsi", KERNEL=="sda?*", ENV{DEVTYPE}=="partition", SYMLINK+="part-%n"
SUBSYSTEM=="block", SUBSYSTEMS=="scsi", KERNEL=="sda?*", ENV{DEVTYPE}=="partition", SYMLINK+="partition"
KERNEL=="*7", OPTIONS+="link_priority=10"
"""),
Rules.new(
'all_block_devs',
device_generator = lambda: \
all_block_devs(lambda name: (["blockdev"], None) if name.endswith('/sda6') else (None, None)),
repeat = 10,
rules = r"""
SUBSYSTEM=="block", SUBSYSTEMS=="scsi", KERNEL=="sd*", SYMLINK+="blockdev"
KERNEL=="sda6", OPTIONS+="link_priority=10"
"""),
]
def fork_and_run_udev(action: str, rules: Rules) -> None:
kinder = []
for k, device in enumerate(rules.devices):
# TODO: valgrind/gdb/strace
cmd = [UDEV_BIN, action, device.devpath]
if rules.delay:
cmd += [f'{k * rules.delay}']
kinder += [subprocess.Popen(cmd)]
good = True
for c in kinder:
if not good:
# once something fails, terminate all workers
c.terminate()
elif c.wait() != 0:
good = False
assert good
def environment_issue():
if os.getuid() != 0:
return 'Must be root to run properly'
c = subprocess.run(['systemd-detect-virt', '-r', '-q'],
check=False)
if c.returncode == 0:
return 'Running in a chroot, skipping the test'
c = subprocess.run(['systemd-detect-virt', '-c', '-q'],
check=False)
if c.returncode == 0:
return 'Running in a container, skipping the test'
return None
@pytest.fixture(scope='module')
def udev_setup():
issue = environment_issue()
if issue:
pytest.skip(issue)
global UDEV_RUN, UDEV_RULES, UDEV_DEV, UDEV_SYS
_tmpdir = tempfile.TemporaryDirectory()
tmpdir = Path(_tmpdir.name)
UDEV_RUN = tmpdir / 'run'
UDEV_RULES = UDEV_RUN / 'udev-test.rules'
udev_tmpfs = tmpdir / 'tmpfs'
UDEV_DEV = udev_tmpfs / 'dev'
UDEV_SYS = udev_tmpfs / 'sys'
subprocess.run(['umount', udev_tmpfs],
stderr=subprocess.DEVNULL,
check=False)
udev_tmpfs.mkdir(exist_ok=True, parents=True)
subprocess.check_call(['mount', '-v',
'-t', 'tmpfs',
'-o', 'rw,mode=0755,nosuid,noexec',
'tmpfs', udev_tmpfs])
UDEV_DEV.mkdir(exist_ok=True)
# setting group and mode of udev_dev ensures the tests work
# even if the parent directory has setgid bit enabled.
os.chmod(UDEV_DEV,0o755)
os.chown(UDEV_DEV, 0, 0)
os.mknod(UDEV_DEV / 'null', 0o600 | stat.S_IFCHR, os.makedev(1, 3))
# check if we are permitted to create block device nodes
sda = UDEV_DEV / 'sda'
os.mknod(sda, 0o600 | stat.S_IFBLK, os.makedev(8, 0))
sda.unlink()
subprocess.check_call([SYS_SCRIPT, UDEV_SYS.parent])
subprocess.check_call(['rm', '-rf', UDEV_RUN])
UDEV_RUN.mkdir(parents=True)
os.chdir(tmpdir)
if subprocess.run([UDEV_BIN, 'check'],
check=False).returncode != 0:
pytest.skip(f'{UDEV_BIN} failed to set up the environment, skipping the test',
allow_module_level=True)
yield
subprocess.check_call(['rm', '-rf', UDEV_RUN])
subprocess.check_call(['umount', '-v', udev_tmpfs])
udev_tmpfs.rmdir()
@pytest.mark.parametrize("rules", RULES, ids=(rule.desc for rule in RULES))
def test_udev(rules: Rules, udev_setup):
assert udev_setup is None
rules.create_rules_file()
rules.generate_devices()
for _ in range(rules.repeat):
fork_and_run_udev('add', rules)
for device in rules.devices:
device.check_add()
fork_and_run_udev('remove', rules)
for device in rules.devices:
device.check_remove()
if __name__ == '__main__':
issue = environment_issue()
if issue:
print(issue, file=sys.stderr)
sys.exit(77)
sys.exit(pytest.main(sys.argv))