README

   1 README for security-tests project
   2
   3 The project security-tests is designed for testing other packages:
   4
   5 -libsmack
   6 -libprivilege-control
   7 -security-server
   8
   9 The test runner framework used by this project is dpl/test. For more
  10 information about dpl see project wrt-commons.
  11
  12 The tests designed for each project are grouped in separate folders:
  13 1, libprivilege-control
  14     Sorces in folder tests/libprivilege-control-tests
  15     Test cases defined in tests/libprivilege-control-tests/test.cases.cpp
  16 2, libsmack
  17     Sources in folder tests/libsmack-tests
  18     Test cases defined in tests/libsmack-tests/test.cases.cpp
  19 3, security server
  20     Sources in folders tests/security-server-tests
  21     Test cases for different aspects of package divided into several
  22     security_server_tests_*.cpp files inside that folder.
  23
  24 Tests are run on the tested device by executing security-tests-all.sh or each
  25 test suite separately:
  26 - libsmack-test,
  27 - libprivilege-control-test,
  28 - security-server-tests-client-smack,
  29 - security-server-tests-label,
  30 - security-server-tests-pid-reuser,
  31 - security-server-tests-server,
  32 - security-server-tests-api-speed,
  33 - security-server-tests-password,
  34 - security-server-tests-dbus.
  35
  36 Each test suite may be run with options:
  37   --output=<output type> --output=<output type> ...
  38       possible output types:
  39         --output=csv
  40         --output=html
  41         --output=tap
  42         --output=text
  43         --output=xml
  44       example:
  45         test-binary --output=text --output=xml --file=output.xml
  46   --regexp='regexp'  Only selected tests which names match regexp run
  47   --start=<test id> Start from concrete test id  --group=<group name>
  48       Run tests only from one group
  49   --runignored   Run also ignored tests
  50   --list     Show a list of Test IDs
  51   --listgroups   Show a list of Test Group names
  52   --only-from-xml=<xml file>     Run only testcases specified in XML file
  53        XML name is taken from attribute id="part1_part2" as whole.
  54        If part1 is not found (no _) then it is implicitily set according to
  55        suite part1 from binary tests
  56   --listingroup=<group name>     Show a list of Test IDS in one group
  57   --allowchildlogs   Allow to print logs from child process on screen.
  58        When active child process will be able to print logs on stdout and
  59        stderr. Both descriptors will be closed after test.
  60   --help     print help
  61
  62 Apart from unit tests, the package also provides scripts designed to check:
  63 - CPU usage by SMACK related processes. (test-performance-check.sh, which
  64   internally uses the perf binary, and gives output to stdout.)
  65 - Time of last booting of the system. (boot-time-measure.bash)