libisoburn/releng
Thomas Schmitt 91b0a2aa8d Checking -assert_volid in auto_isocontent 2011-08-01 19:23:42 +00:00
..
codesamples renamed to better reflect intentions 2011-07-19 17:16:21 +00:00
inc handle specific help anywhere 2011-07-18 17:22:59 +00:00
CHECKLIST a better description 2011-08-01 14:50:14 +00:00
README Began to sketch an releng/README file 2011-07-23 19:29:31 +00:00
README.old Began to sketch an releng/README file 2011-07-23 19:29:46 +00:00
TODO merge remaining todo entries into TODO file, drop completed 2011-07-19 17:02:09 +00:00
auto_cxx activate specific options help along with short overview 2011-07-20 12:23:40 +00:00
auto_isocontent Checking -assert_volid in auto_isocontent 2011-08-01 19:23:42 +00:00
auto_printsize Reduced runtime of auto_printsize and balanced xorriso versus genisoimage 2011-07-27 12:04:07 +00:00
manual_devices Switched releng/manual_devices from -devices to -device_links 2011-07-27 21:43:24 +00:00
manual_isojigdo give hints only if the result is left in place 2011-07-24 14:56:36 +00:00
run_all_auto don't inspect the log for NOTE|DEBUG|ALL 2011-07-24 14:49:43 +00:00
template_new activate specific options help along with short overview 2011-07-20 12:23:40 +00:00

README

------------------------------------------------------------------------------
                         http:libburnia-project.org
------------------------------------------------------------------------------
libisoburn/releng. By George Danchev <danchev@spnet.net>
                  and Thomas Schmitt <scdbackup@gmx.net>

Test suite for xorriso and libburnia libraries.
Copyright (C) 2011 George Danchev, Thomas Schmitt
Provided under GPL version 2 or later.
------------------------------------------------------------------------------

>>> introduce the test suite,

Directory ./releng of libisoburn contains a collection of test scripts and
auxiliary data. They exercise some typical use cases of building libisoburn
applications and running the ISO 9660 filesystem manipulation and CD/DVD/BD
burn program xorriso. 


>>> inform about intended audience and resource needs,

It is assumed that libburn and libisofs are installed, so that libisoburn
can be configured and built. It is not mandatory that libisoburn is already
installed. The tests may use an installed xorriso program as well as a
freshly built one.


>>> auto and manual tests

There are two groups of test scripts:

  auto_*    gets started and watched by script run_all_auto.
            These tests have a moderate resource consumption and do
            not cause mechanical movements of drive trays.

  manual_*  get started by the user if desired.
            Manual tests may create larger sets of temporary files,
            may download test data from the internet, may need
            system privileges beyond the reach of a sandbox user,
            and operate the mechanics of a CD drive.

>>> tell how to run the tests,

The test scripts expect to get run while the working directory is
  ./releng
of a libisoburn source tree. E.g.: libisoburn-1.1.4/releng
They create all their temporary files underneath
  ./releng/releng_generated_data 
Some of these files are persistent between tests.
Nevertheless it is safe to empty ./releng/releng_generated_data after
tests are done. The directory itself must be kept.

To run the unobtrusive automatic tests, build libisoburn and xorriso,
go to directory ./releng, and execute

  ./run_all_auto -x ../xorriso/xorriso

or if you want to use an installed xorriso program:

  ./run_all_auto -x $(type -p xorriso)


>>> list of manual tests

Currently there are the folling tests which should have the attention of
the user or require sysadmin considerations before they get run:

  ./manual_isojigdo -x ../xorriso/xorriso
Exercises the production of a bootable Debian GNU/Linux image and its Jigdo
files. This test downloads a Debian daily image for i386 of about 70 MB,
extracts its content and composes a new image.
Thus it needs about 250 MB of disk space in releng/releng_generated_data .

  ./manual_devices -x ../xorriso/xorriso
Exercises listing of all accessible optical drives and the examination of
a one of these drives. The user needs the permission to operate the CD
drives. This might involve the need for superuser authority.
The media tray of the examined drive will get loaded if it is not already.

>>> ./run_all_manual


>>> give hints what to do with FAIL results.

=============================================================================
TODO:


* move auto_isojigdo to manual_isojigdo
  because of its resource consumption

* Remove NOTE|DEBUG|ALL from run_all_auto event class list

* Delete debian-testing-i386-businesscard.iso with ./run_all_auto -c

* manual_isojigdo proposes to run manual checks after it removed the
  generated images.

* Have a script ./run_all_manual

* derive a GNU xorriso test suite from libisoburn test suite