#!/usr/bin/perl # 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 the @tests array, to add a new test variant. # # Every test is driven by its own temporary config file. # This program prepares the environment, creates the config and calls udev. # # udev reads the config, 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. # # happy testing, # Kay Sievers , 2003 # # Modified April 9, 2004 by Leann Ogasawara # - expanded @tests array to add more symlinks and permissions tests # - some of the symlinks tests also test lack of node creation # - added symlink_test() function # - moved permissions and major_minor tests into their own functions use warnings; use strict; my $PWD = $ENV{PWD}; my $sysfs = "sys/"; my $udev_bin = "../udev"; my $udev_root = "udev-root/"; # !!! directory will be removed !!! my $udev_db = ".udevdb"; my $perm = "udev.permissions"; my $main_conf = "udev-test.conf"; my $conf_tmp = "udev-test.rules"; my @tests = ( { desc => "label test of scsi disc", subsys => "block", devpath => "/block/sda", exp_name => "boot_disk" , conf => < "label test of scsi partition", subsys => "block", devpath => "/block/sda/sda1", exp_name => "boot_disk1" , conf => < "label test of pattern match", subsys => "block", devpath => "/block/sda/sda1", exp_name => "boot_disk1" , conf => < "label test of multiple sysfs files", subsys => "block", devpath => "/block/sda/sda1", exp_name => "boot_disk1" , conf => < "label test of max sysfs files", subsys => "block", devpath => "/block/sda/sda1", exp_name => "boot_disk1" , conf => < "catch device by *", subsys => "tty", devpath => "/class/tty/ttyUSB0", exp_name => "visor/0" , conf => < "catch device by * - take 2", subsys => "tty", devpath => "/class/tty/ttyUSB0", exp_name => "visor/0" , conf => < "catch device by ?", subsys => "tty", devpath => "/class/tty/ttyUSB0", exp_name => "visor/0" , conf => < "catch device by character class", subsys => "tty", devpath => "/class/tty/ttyUSB0", exp_name => "visor/0" , conf => < "replace kernel name", subsys => "tty", devpath => "/class/tty/ttyUSB0", exp_name => "visor" , conf => < "Handle comment lines in config file (and replace kernel name)", subsys => "tty", devpath => "/class/tty/ttyUSB0", exp_name => "visor" , conf => < "Handle comment lines in config file with whitespace (and replace kernel name)", subsys => "tty", devpath => "/class/tty/ttyUSB0", exp_name => "visor" , conf => < "Handle whitespace only lines (and replace kernel name)", subsys => "tty", devpath => "/class/tty/ttyUSB0", exp_name => "whitespace" , conf => < "Handle empty lines in config file (and replace kernel name)", subsys => "tty", devpath => "/class/tty/ttyUSB0", exp_name => "visor" , conf => < "subdirectory handling", subsys => "tty", devpath => "/class/tty/ttyUSB0", exp_name => "sub/direct/ory/visor" , conf => < "place on bus of scsi partition", subsys => "block", devpath => "/block/sda/sda3", exp_name => "first_disk3" , conf => < "test NAME substitution chars", subsys => "block", devpath => "/block/sda/sda3", exp_name => "Major:8:minor:3:kernelnumber:3:bus:0:0:0:0" , conf => < "test NAME substitution chars (with length limit)", subsys => "block", devpath => "/block/sda/sda3", exp_name => "M8-m3-n3-b0:0-sIBM" , conf => < "old style SYSFS_ attribute", subsys => "block", devpath => "/block/sda", exp_name => "good" , conf => < "sustitution of sysfs value (%s{file})", subsys => "block", devpath => "/block/sda", exp_name => "disk-IBM-ESXS-sda" , conf => < "program result substitution", subsys => "block", devpath => "/block/sda/sda3", exp_name => "special-device-3" , conf => < "program result substitution (no argument should be subsystem)", subsys => "block", devpath => "/block/sda/sda3", exp_name => "subsys_block" , conf => < "program result substitution (newline removal)", subsys => "block", devpath => "/block/sda/sda3", exp_name => "newline_removed" , conf => < "program result substitution", subsys => "block", devpath => "/block/sda/sda3", exp_name => "test-0:0:0:0" , conf => < "program with escaped format char (tricky: callout returns format char!)", subsys => "block", devpath => "/block/sda/sda3", exp_name => "escape-3" , conf => < "program with lots of arguments", subsys => "block", devpath => "/block/sda/sda3", exp_name => "foo9" , conf => < "program with subshell", subsys => "block", devpath => "/block/sda/sda3", exp_name => "bar9" , conf => < "program arguments combined with apostrophes", subsys => "block", devpath => "/block/sda/sda3", exp_name => "foo7" , conf => < "characters before the %c{N} substitution", subsys => "block", devpath => "/block/sda/sda3", exp_name => "my-foo9" , conf => < "substitute the second to last argument", subsys => "block", devpath => "/block/sda/sda3", exp_name => "my-foo8" , conf => < "invalid program for device with no bus", subsys => "tty", devpath => "/class/tty/console", exp_name => "TTY" , conf => < "valid program for device with no bus", subsys => "tty", devpath => "/class/tty/console", exp_name => "foo" , conf => < "invalid label for device with no bus", subsys => "tty", devpath => "/class/tty/console", exp_name => "TTY" , conf => < "valid label for device with no bus", subsys => "tty", devpath => "/class/tty/console", exp_name => "foo" , conf => < "program and bus type match", subsys => "block", devpath => "/block/sda", exp_name => "scsi-0:0:0:0" , conf => < "create all possible partitions", subsys => "block", devpath => "/block/sda", exp_name => "boot_disk15" , conf => < "sysfs parent hierarchy", subsys => "tty", devpath => "/class/tty/ttyUSB0", exp_name => "visor" , conf => < "name test with ! in the name", subsys => "block", devpath => "/block/rd!c0d0", exp_name => "rd/c0d0" , conf => < "name test with ! in the name, but no matching rule", subsys => "block", devpath => "/block/rd!c0d0", exp_name => "rd/c0d0" , conf => < "name test with ! in the name for a partition", subsys => "block", devpath => "/block/cciss!c0d0/cciss!c0d0p1", exp_name => "cciss/c0d0p1" , conf => < "ID rule", subsys => "block", devpath => "/block/sda", exp_name => "scsi-0:0:0:0", conf => < "ID wildcard all", subsys => "block", devpath => "/block/sda", exp_name => "scsi-0:0:0:0", conf => < "ID wildcard partial", subsys => "block", devpath => "/block/sda", exp_name => "scsi-0:0:0:0", conf => < "ID wildcard partial 2", subsys => "block", devpath => "/block/sda", exp_name => "scsi-0:0:0:0", conf => < "ignore SYSFS attribute whitespace", subsys => "block", devpath => "/block/sda", exp_name => "ignored", conf => < "do not ignore SYSFS attribute whitespace", subsys => "block", devpath => "/block/sda", exp_name => "matched-with-space", conf => < "permissions test", subsys => "block", devpath => "/block/sda", exp_name => "node", exp_perms => "5000::0444", conf => < "permissions ttyUSB0:root:uucp:0660", subsys => "tty", devpath => "/class/tty/ttyUSB0", exp_name => "ttyUSB0", exp_perms => "0:14:0660", conf => < "permissions tty0::root:0444", subsys => "tty", devpath => "/class/tty/tty0", exp_name => "tty0", exp_perms => "0:0:0444", conf => < "permissions tty1:root::0555", subsys => "tty", devpath => "/class/tty/tty1", exp_name => "tty1", exp_perms => "0:0:0555", conf => < "permissions tty2:::0777", subsys => "tty", devpath => "/class/tty/tty2", exp_name => "tty2", exp_perms => "0:0:0777", conf => < "permissions tty3::: (default mode applied)", subsys => "tty", devpath => "/class/tty/tty3", exp_name => "tty3", exp_perms => "0:0:600", conf => < "permissions i2c-300:root:sys:0744", subsys => "i2c-dev", devpath => "/class/i2c-dev/i2c-300", exp_name => "i2c-300", exp_perms => "0:3:0744", conf => < "permissions i2c-fake1:root:7:0007", subsys => "i2c-dev", devpath => "/class/i2c-dev/i2c-fake1", exp_name => "i2c-fake1", exp_perms => "0:7:0007", conf => < "permissions ttyS[01]:0:5:0700", subsys => "tty", devpath => "/class/tty/ttyS1", exp_name => "ttyS1", exp_perms => "0:5:0700", conf => < "permissions ttyS[4-9]:tty:5:0060", subsys => "tty", devpath => "/class/tty/ttyS7", exp_name => "ttyS7", exp_perms => "0:5:0060", conf => < "permissions tty4:0:5:0707", subsys => "ttyS4", devpath => "/class/tty/tty4", exp_name => "tty4", exp_perms => "0:5:0707", conf => < "permissions tty4?:0:5:0007", subsys => "tty", devpath => "/class/tty/tty44", exp_name => "tty44", exp_perms => "0:5:0007", conf => < "permissions tty3[!3]:::0467", subsys => "tty", devpath => "/class/tty/tty35", exp_name => "tty35", exp_perms => "0:0:0467", conf => < "permissions tty33:bad:name:0500", subsys => "tty", devpath => "/class/tty/tty33", exp_name => "tty33", exp_perms => "0:0:0500", conf => < "permissions rtc:0:users:0600", subsys => "misc", devpath => "/class/misc/rtc", exp_name => "misc/rtc", exp_perms => "0:100:0600", conf => < "permissions misc:0:users:0600", subsys => "misc", devpath => "/class/misc/psaux", exp_name => "misc/psaux", exp_perms => "0:100:0600", conf => < "permissions set OWNER=5000", subsys => "block", devpath => "/block/sda", exp_name => "node", exp_perms => "5000::0600", conf => < "permissions set GROUP=100", subsys => "block", devpath => "/block/sda", exp_name => "node", exp_perms => ":100:0600", conf => < "permissions set mode=0777", subsys => "block", devpath => "/block/sda", exp_name => "node", exp_perms => "::0777", conf => < "permissions set OWNER=5000 GROUP=100 MODE=0777", subsys => "block", devpath => "/block/sda", exp_name => "node", exp_perms => "5000:100:0777", conf => < "permissions override OWNER to 5000", subsys => "tty", devpath => "/class/tty/ttyUSB0", exp_name => "ttyUSB0", exp_perms => "5000:14:0660", conf => < "permissions override GROUP to 100", subsys => "tty", devpath => "/class/tty/ttyUSB0", exp_name => "ttyUSB0", exp_perms => ":100:0660", conf => < "permissions override MODE to 0060", subsys => "tty", devpath => "/class/tty/ttyUSB0", exp_name => "ttyUSB0", exp_perms => ":14:0060", conf => < "permissions override OWNER, GROUP, MODE", subsys => "tty", devpath => "/class/tty/ttyUSB0", exp_name => "ttyUSB0", exp_perms => "5000:100:0777", conf => < "major/minor number test", subsys => "block", devpath => "/block/sda", exp_name => "node", exp_majorminor => "8:0", conf => < "big minor number test", subsys => "i2c-dev", devpath => "/class/i2c-dev/i2c-300", exp_name => "node", exp_majorminor => "89:300", conf => < "big major number test", subsys => "i2c-dev", devpath => "/class/i2c-dev/i2c-fake1", exp_name => "node", exp_majorminor => "4095:1", conf => < "big major and big minor number test", subsys => "i2c-dev", devpath => "/class/i2c-dev/i2c-fake2", exp_name => "node", exp_majorminor => "4094:89999", conf => < "multiple symlinks with format char", subsys => "tty", devpath => "/class/tty/ttyUSB0", exp_name => "symlink2-ttyUSB0", exp_target => "ttyUSB0", conf => < "symlink creation (same directory)", subsys => "tty", devpath => "/class/tty/ttyUSB0", exp_name => "visor0", exp_target => "ttyUSB0", conf => < "symlink creation (relative link forward)", subsys => "block", devpath => "/block/sda/sda2", exp_name => "1/2/symlink" , exp_target => "a/b/node", conf => < "symlink creation (relative link back and forward)", subsys => "block", devpath => "/block/sda/sda2", exp_name => "1/2/c/d/symlink" , exp_target => "../../a/b/node", conf => < "multiple symlinks", subsys => "tty", devpath => "/class/tty/ttyUSB0", exp_name => "second-0" , exp_target => "visor" , conf => < "symlink only rule", subsys => "block", devpath => "/block/sda", exp_name => "symlink-only2", exp_target => "link", conf => < "symlink name empty", subsys => "block", devpath => "/block/sda", exp_name => "", exp_target => "link", exp_error => "yes", conf => < "symlink name '.'", subsys => "block", devpath => "/block/sda", exp_name => ".", exp_target => "link", exp_error => "yes", conf => < "symlink to empty name", subsys => "block", devpath => "/block/sda", exp_name => "symlink", exp_target => "", exp_error => "yes", conf => < "symlink and name empty", subsys => "block", devpath => "/block/sda", exp_name => "", exp_target => "", exp_error => "yes", conf => < "symlink node to itself", subsys => "tty", devpath => "/class/tty/tty0", exp_name => "link", exp_target => "link", conf => < "symlink %n substitution", subsys => "tty", devpath => "/class/tty/ttyUSB0", exp_name => "symlink0", exp_target => "ttyUSB0", conf => < "symlink %k substitution", subsys => "tty", devpath => "/class/tty/ttyUSB0", exp_name => "symlink-ttyUSB0", exp_target => "ttyUSB0", conf => < "symlink %M:%m substitution", subsys => "tty", devpath => "/class/tty/ttyUSB0", exp_name => "major-188:0", exp_target => "ttyUSB0", conf => < "symlink %b substitution", subsys => "block", devpath => "/block/sda", exp_name => "symlink-0:0:0:0", exp_target => "node", conf => < "symlink %c substitution", subsys => "tty", devpath => "/class/tty/ttyUSB0", exp_name => "test", exp_target => "ttyUSB0", conf => < "symlink %c{N} substitution", subsys => "tty", devpath => "/class/tty/ttyUSB0", exp_name => "test", exp_target => "ttyUSB0", conf => < "symlink %c{N+} substitution", subsys => "tty", devpath => "/class/tty/ttyUSB0", exp_name => "this", exp_target => "ttyUSB0", conf => < "symlink only rule with %c{N+}", subsys => "block", devpath => "/block/sda", exp_name => "test", exp_target => "link", conf => < "symlink %s{filename} substitution", subsys => "tty", devpath => "/class/tty/ttyUSB0", exp_name => "188:0", exp_target => "ttyUSB0", conf => < "symlink %Ns{filename} substitution", subsys => "tty", devpath => "/class/tty/ttyUSB0", exp_name => "188", exp_target => "ttyUSB0", conf => < "symlink with '%' in name", subsys => "tty", devpath => "/class/tty/ttyUSB0", exp_name => "percent%sign", exp_target => "ttyUSB0", conf => < "symlink with '%' in name", subsys => "tty", devpath => "/class/tty/ttyUSB0", exp_name => "%ttyUSB0_name", exp_target => "ttyUSB0", conf => < "program result substitution (numbered part of)", subsys => "block", devpath => "/block/sda/sda3", exp_name => "link1", exp_target => "node", conf => < "program result substitution (numbered part of+)", subsys => "block", devpath => "/block/sda/sda3", exp_name => "link4", exp_target => "node", conf => < "enumeration char test (single test)", subsys => "block", devpath => "/block/sda", exp_name => "cdrom", conf => < "enumeration char test sequence (1/5 keep)", subsys => "block", devpath => "/block/sda", exp_name => "cdrom", option => "keep", conf => < "enumeration char test sequence 2/5 (keep)", subsys => "block", devpath => "/block/sda/sda1", exp_name => "enum", option => "keep", conf => < "enumeration char test sequence 3/5 (keep)", subsys => "block", devpath => "/block/sda/sda2", exp_name => "cdrom1", option => "keep", conf => < "enumeration char test sequence 4/5 (keep)", subsys => "block", devpath => "/block/sda/sda3", exp_name => "enum1", option => "keep", conf => < "enumeration char test sequence 5/5 (clean)", subsys => "block", devpath => "/block/sda/sda4", exp_name => "cdrom2", option => "clear", conf => < "enumeration char test after cleanup (single test)", subsys => "block", devpath => "/block/sda", exp_name => "cdrom", conf => < "SUBSYSTEM test", subsys => "block", devpath => "/block/sda", exp_name => "node", conf => <$conf_tmp" || die "unable to create config file: $conf_tmp"; print CONF $$config; close CONF; $ENV{ACTION} = $action; system("$udev_bin $subsys"); } my $error = 0; sub permissions_test { my($config, $uid, $gid, $mode) = @_; my $wrong = 0; $config->{exp_perms} =~ m/^(.*):(.*):(.*)$/; if ($1 ne "") { if ($uid != $1) { $wrong = 1; }; } if ($2 ne "") { if ($gid != $2) { $wrong = 1; }; } if ($3 ne "") { if (($mode & 07777) != oct($3)) { $wrong = 1; }; } if ($wrong == 0) { print "permissions: ok "; } else { printf "expected permissions are: %i:%i:%#o\n", $1, $2, oct($3); printf "created permissions are : %i:%i:%#o\n", $uid, $gid, $mode & 07777; $error++; } } sub major_minor_test { my($config, $rdev) = @_; my $major = ($rdev >> 8) & 0xfff; my $minor = ($rdev & 0xff) | (($rdev >> 12) & 0xfff00); my $wrong = 0; $config->{exp_majorminor} =~ m/^(.*):(.*)$/; if ($1 ne "") { if ($major != $1) { $wrong = 1; }; } if ($2 ne "") { if ($minor != $2) { $wrong = 1; }; } if ($wrong == 0) { print "major:minor: ok "; } else { printf "expected major:minor is: %i:%i\n", $1, $2; printf "created major:minor is : %i:%i\n", $major, $minor; print "major:minor: error "; $error++; } } sub symlink_test { my ($config) = @_; my $output = `ls -l $PWD/$udev_root$config->{exp_name}`; if ($output =~ m/(.*)-> (.*)/) { if ($2 eq $config->{exp_target}) { print "symlink: ok "; } else { print "expected symlink from: \'$config->{exp_name}\' to \'$config->{exp_target}\'\n"; print "created symlink from: \'$config->{exp_name}\' to \'$2\'\n"; if ($config->{exp_error}) { print "as expected "; } else { $error++; } } } else { print "expected symlink from: \'$config->{exp_name}\' to \'$config->{exp_target}\'\n"; print "symlink: not created "; if ($config->{exp_error}) { print "as expected "; } else { $error++; } } } sub run_test { my ($config, $number) = @_; print "TEST $number: $config->{desc}\n"; if ($config->{exp_target}) { print "device \'$config->{devpath}\' expecting symlink '$config->{exp_name}' to node \'$config->{exp_target}\'\n"; } else { print "device \'$config->{devpath}\' expecting node \'$config->{exp_name}\'\n"; } udev("add", $config->{subsys}, $config->{devpath}, \$config->{conf}); if ((-e "$PWD/$udev_root$config->{exp_name}") || (-l "$PWD/$udev_root$config->{exp_name}")) { my ($dev, $ino, $mode, $nlink, $uid, $gid, $rdev, $size, $atime, $mtime, $ctime, $blksize, $blocks) = stat("$PWD/$udev_root$config->{exp_name}"); if (defined($config->{exp_perms})) { permissions_test($config, $uid, $gid, $mode); } if (defined($config->{exp_majorminor})) { major_minor_test($config, $rdev); } if (defined($config->{exp_target})) { symlink_test($config); } print "add: ok "; } else { print "add: error "; if ($config->{exp_error}) { print "as expected "; } else { print "\n\n"; system("tree $udev_root"); print "\n"; $error++; } } if (defined($config->{option}) && $config->{option} eq "keep") { print "\n\n"; return; } udev("remove", $config->{subsys}, $config->{devpath}, \$config->{conf}); if ((-e "$PWD/$udev_root$config->{exp_name}") || (-l "$PWD/$udev_root$config->{exp_name}")) { print "remove: error "; if ($config->{exp_error}) { print "as expected\n\n"; } else { print "\n\n"; system("tree $udev_root"); print "\n"; $error++; } } else { print "remove: ok\n\n"; } if (defined($config->{option}) && $config->{option} eq "clear") { system("rm -rf $udev_db"); system("rm -rf $udev_root"); mkdir($udev_root) || die "unable to create udev_root: $udev_root\n"; } } # only run if we have root permissions # due to mknod restrictions if (!($<==0)) { print "Must have root permissions to run properly.\n"; exit; } # prepare system("rm -rf $udev_root"); mkdir($udev_root) || die "unable to create udev_root: $udev_root\n"; # create initial config file open CONF, ">$main_conf" || die "unable to create config file: $main_conf"; print CONF "udev_root=\"$udev_root\"\n"; print CONF "udev_db=\"$udev_db\"\n"; print CONF "udev_rules=\"$conf_tmp\"\n"; print CONF "udev_permissions=\"$perm\"\n"; close CONF; my $test_num = 1; if ($ARGV[0]) { # only run one test $test_num = $ARGV[0]; if (defined($tests[$test_num-1]->{desc})) { print "udev-test will run test number $test_num only:\n\n"; run_test($tests[$test_num-1], $test_num); } else { print "test does not exist.\n"; } } else { # test all print "\nudev-test will run ".($#tests + 1)." tests:\n\n"; foreach my $config (@tests) { run_test($config, $test_num); $test_num++; } } print "$error errors occured\n\n"; # cleanup system("rm -rf $udev_db"); system("rm -rf $udev_root"); unlink($conf_tmp); unlink($main_conf);