From 920513356bbaac6e946dd2a1766826ff8ecc1dcb Mon Sep 17 00:00:00 2001 From: Thomas Schmitt Date: Sun, 7 Aug 2011 11:03:22 +0000 Subject: [PATCH] More work on releng/README --- releng/README | 33 ++++++++++++++++++++++++++------- xorriso/xorriso_timestamp.h | 2 +- 2 files changed, 27 insertions(+), 8 deletions(-) diff --git a/releng/README b/releng/README index 606e66c1..e3c56e34 100644 --- a/releng/README +++ b/releng/README @@ -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 diff --git a/xorriso/xorriso_timestamp.h b/xorriso/xorriso_timestamp.h index 7cc87e1a..8ab75077 100644 --- a/xorriso/xorriso_timestamp.h +++ b/xorriso/xorriso_timestamp.h @@ -1 +1 @@ -#define Xorriso_timestamP "2011.08.01.152915" +#define Xorriso_timestamP "2011.08.07.110306"