|
|
|
|
@ -9,7 +9,7 @@ Copyright (C) 2011 George Danchev, Thomas Schmitt
|
|
|
|
|
Provided under GPL version 2 or later.
|
|
|
|
|
------------------------------------------------------------------------------
|
|
|
|
|
|
|
|
|
|
The impatient tester will build libisoburn and then do
|
|
|
|
|
The impatient tester will build libisoburn according to ./README and then do
|
|
|
|
|
cd ./releng
|
|
|
|
|
./run_all_auto -x ../xorriso/xorriso
|
|
|
|
|
|
|
|
|
|
@ -73,6 +73,7 @@ or if you want to use an installed xorriso program:
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
+++ General options -x , -k, -f, -c, -h, --
|
|
|
|
|
+++ + All scripts support -h
|
|
|
|
|
|
|
|
|
|
There are several options which work with run_all_auto and any single test.
|
|
|
|
|
-x absolute or relative path to xorriso binary to be run.
|
|
|
|
|
@ -87,7 +88,7 @@ particular manually executable test scripts.
|
|
|
|
|
|
|
|
|
|
Manually executable tests
|
|
|
|
|
|
|
|
|
|
>>> list of manual tests
|
|
|
|
|
+++ list of manual tests
|
|
|
|
|
|
|
|
|
|
Currently there are the following tests which should have the attention of
|
|
|
|
|
the user or require sysadmin considerations before they are run:
|
|
|
|
|
@ -120,14 +121,24 @@ the user or require sysadmin considerations before they are run:
|
|
|
|
|
directory. MD5 mismatch causes a test failure. Differences to the directory
|
|
|
|
|
state are reported but still regarded as success.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
>>> ./run_all_manual
|
|
|
|
|
|
|
|
|
|
>>> + Any auto_* script can be run on its own, regardless.
|
|
|
|
|
>>> List auto tests
|
|
|
|
|
|
|
|
|
|
>>> + All scripts support -h
|
|
|
|
|
|
|
|
|
|
>>> give hints what to do with FAIL results.
|
|
|
|
|
+++ give hints what to do with FAIL results.
|
|
|
|
|
|
|
|
|
|
The text output of the automatic tests is recorded in file
|
|
|
|
|
releng_generated_data/log.run_all_auto
|
|
|
|
|
|
|
|
|
|
Script ./run_all_auto will detect failure of perticular tests and report
|
|
|
|
|
lines from the log file which contain problem indicating key words:
|
|
|
|
|
NEVER|ABORT|FATAL|FAILURE|MISHAP|SORRY|WARNING|HINT|FAIL|ERROR|WRONG
|
|
|
|
|
|
|
|
|
|
If the program messages in log.run_all_auto do not explain the failure,
|
|
|
|
|
please contact mailing list libburn-hackers@pykix.org .
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
----------------------------------------------------------------------------
|
|
|
|
|
@ -151,8 +162,9 @@ not done as long as such a line remains.
|
|
|
|
|
+++ + Each script' self-generated data are to be stored in
|
|
|
|
|
+++ ./releng_generated_data/scriptname/ directory
|
|
|
|
|
|
|
|
|
|
Your test must not start if no file ./inc/releng_getopts.inc exists,
|
|
|
|
|
i.e. if the current working direcoty is not ./releng.
|
|
|
|
|
Your test must not start if no file
|
|
|
|
|
./inc/releng_getopts.inc
|
|
|
|
|
exists, i.e. if the current working direcoty is not ./releng.
|
|
|
|
|
If your test creates own files on disk, then it must do this underneath
|
|
|
|
|
directory ./releng_generated_data/$test_name (resp. $GEN_DATA_DIR, see below).
|
|
|
|
|
|
|
|
|
|
@ -161,7 +173,8 @@ directory ./releng_generated_data/$test_name (resp. $GEN_DATA_DIR, see below).
|
|
|
|
|
+++ + Use different exit codes for any failure (range 0-31)
|
|
|
|
|
|
|
|
|
|
In case of failure, issue a line to stdout that begins by the word "FAIL",
|
|
|
|
|
and make sure that the test script finally returns a non-zero exit value.
|
|
|
|
|
followed by " : " and the name of the test (e.g. $SELF, see below).
|
|
|
|
|
Make sure that the test script finally returns a non-zero exit value.
|
|
|
|
|
This value should be between 1 and 28. Each type of failure should have its
|
|
|
|
|
own exit value.
|
|
|
|
|
Predefined are:
|
|
|
|
|
@ -180,14 +193,20 @@ The code piece inc/releng_getopts.inc should get executed inline at the
|
|
|
|
|
start of a test script.
|
|
|
|
|
It initializes the following variables and sets some of them according
|
|
|
|
|
to the general options of the test suite:
|
|
|
|
|
|
|
|
|
|
SELF basename $0
|
|
|
|
|
|
|
|
|
|
GEN_DATA_DIR releng_generated_data/${SELF}
|
|
|
|
|
|
|
|
|
|
RELENG_XORRISO Path to xorriso binary. "" or "0" means no xorriso.
|
|
|
|
|
Default "0". Adjustable by option -x.
|
|
|
|
|
|
|
|
|
|
SIMULATE_FAILURE 0=normal operation, 1=test script shall simulate a failure.
|
|
|
|
|
Default 0. Setable to 1 by option -f.
|
|
|
|
|
|
|
|
|
|
CLEANUP 0=do not cleanup temporary data, 1=normal operation
|
|
|
|
|
Default 1. Setable to 0 by option -k.
|
|
|
|
|
|
|
|
|
|
SPECIFIC_HELP 0=normal operation, 1=print help text of script and exit 0
|
|
|
|
|
Default 0. Setable to 1 by option -h
|
|
|
|
|
|
|
|
|
|
|
