Minix Man Pages

Man Page or Keyword Search:
Man Architecture
Apropos Keyword Search (all sections) Output format
home | help
KYUA-ATF-TESTER(1)        BSD General Commands Manual       KYUA-ATF-TESTER(1)

     kyua-atf-tester -- Scriptable interface to interact with ATF test

     kyua-atf-tester [generic_flags] subcommand [subcommand_flags]

     kyua-atf-tester provides a scriptable interface to interact with test
     programs that implement the kyua-atf-interface(7) test interface.  This
     manual page describes the specific features that apply to this specific
     tester.  For the generic manual page, which describes the command-line
     interface in detail, please see kyua-tester(1).

   Results conversion
     The result format outputted by kyua-atf-tester (described in
     kyua-tester-result(5)) is more restricted than what the ATF test case
     itself can output.  The following list details maps ATF test results to
     their generic results:

     expected_death      Maps to 'expected_failure' if the death happens;
                         'failed' otherwise.

     expected_exit       Maps to 'expected_failure' if the test exits cleanly;
                         'failed' otherwise.

     expected_failure    Maps to 'expected_failure' if there is any failure
                         during the execution; 'failed' otherwise.

     expected_signal     Maps to 'expected_failure' if the test terminates due
                         to a signal; 'failed' otherwise.

     expected_timeout    Maps to 'expected_failure' if the test times out;
                         'failed' otherwise.

     failed              Maps to 'failed'.

     passed              Maps to 'passed'.

     skipped             Maps to 'skipped'.

     Any of the previous test results can also map to 'broken' in those cases
     where there is an unexpected problem in the communcation between the test
     and kyua-atf-tester.  For example, this will happen if result file
     created by the ATF test case does not comply to what
     kyua-atf-interface(7) describes.

   Cleanup routines
     Because kyua-atf-tester cannot keep any contextual information between
     the listing of test cases and their execution, the tester cannot easily
     (aka cheaply) know whether a test has or has not a cleanup routine when
     it is run.  For this reason, the 'test' subcommand of kyua-atf-tester
     will assume, by default, that a test case does have a cleanup routine.
     This postive assumption ensures that, if the tester is incorrectly
     executed, the test will be properly cleaned up.

     However, as an optimization, the caller can pass '-v has_cleanup=false'
     to the 'test' subcommand to tell kyua-atf-tester that the test being run
     does not have a cleanup routine.

     kyua-tester(1), kyua-atf-interface(7)

BSD                            December 26, 2012                           BSD