Option --priv_cmd for releng/manual_burn and releng/manual_devices

libisoburn/trunk/releng/README

@@ -33,6 +33,8 @@ 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.
 
+>>> Do we really need to be glued to bash ?
+
 
 +++ auto and manual tests
 
@@ -69,6 +71,8 @@ go to directory ./releng, and execute
 
 or if you want to use an installed xorriso program:
 
+  ./run_all_auto -x $(which xorriso)
+resp.
   ./run_all_auto -x $(type -p xorriso)
 
 
@@ -102,16 +106,23 @@ the user or require sysadmin considerations before they are run:
   when libisofs was built. libjte is part of package jigit, version >= 1.18,
   available at:
     http://www.einval.com/~steve/software/JTE/
+  For building it you will need gmake (which is default "make" on GNU/Linux).
 
-./manual_devices -x ../xorriso/xorriso [-- [--dev device_file_to_use]]
+./manual_devices -x ../xorriso/xorriso [-- [--dev device_file_to_use]
+                                        [--priv_cmd 'command [arg [arg ...]]']]
   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.
   If no option --dev is given, then the user gets asked which of the listed
   drives to examine more closely.
+  If a privilege command and optional arguments are given with --priv_cmd,
+  then this command and arguments are used to laynch the xorriso runs.
+  Command and arguments must be single words and be submitted alltogether
+  as one single argument. On Solaris use: --priv_cmd pfexec
 
 ./manual_burn -x ../xorriso/xorriso [-- [--dev device_file_to_use]
+                                        [--priv_cmd 'command [arg [arg ...]]']
                                         [--what ...directory...] [--any_media]]
   Burns the content of the directory given with --what onto re-usable
   media: CD-RW, DVD-RW, DVD-RAM, DVD+RW, BD-RE.
@@ -120,6 +131,10 @@ the user or require sysadmin considerations before they are run:
   The result gets check read and compared with the state of the input
   directory. MD5 mismatch causes a test failure. Differences to the directory
   state are reported but still regarded as success.
+  If a privilege command and optional arguments are given with --priv_cmd,
+  then this command and arguments are used to laynch the xorriso runs.
+  Command and arguments must be single words and be submitted alltogether
+  as one single argument. On Solaris use: --priv_cmd pfexec
 
 
 >>> ./run_all_manual
@@ -127,6 +142,17 @@ the user or require sysadmin considerations before they are run:
 >>> + Any auto_* script can be run on its own, regardless.
 >>> List auto tests
 
+./auto_cxx
+  Exercises inclusion of xorriso/xorriso.h and libisoburn/libisoburn.h
+  in C++ programs and linking of the libraries. It might be necessary
+  to set compiler options by shell variable CFLAGS before running the test.
+  E.g. if the include headers libisofs.h and libburn.h are not found:
+    export CFLAGS="-I/usr/local/include"
+
+>>> ./auto_isocontent
+
+>>> ./auto_printsize
+
 
 +++ give hints what to do with FAIL results.
 
@@ -258,3 +284,7 @@ TODO:
 * auto_ tests should know whether they work underneath run_all_auto
   or whether they run standalone
 
+* Port releng to FreeBSD.
+  - Make it run with /bin/sh . Remove all bashisms and GNU gimmicks.
+
+