diff --git a/test/README b/test/README new file mode 100644 index 00000000..88d00e55 --- /dev/null +++ b/test/README @@ -0,0 +1,134 @@ +------------------------------------------------------------------------------ + libburnia-project.org scdbackup.sourceforge.net/xorriso_eng.html +------------------------------------------------------------------------------ +xorriso. By Thomas Schmitt +Integrated sub project of libburnia-project.org but also published via: +http://scdbackup.sourceforge.net/xorriso_eng.html +http://scdbackup.sourceforge.net/xorriso-0.1.0.tar.gz +Copyright (C) 2006-2008 Thomas Schmitt, provided under GPL version 2. +------------------------------------------------------------------------------ + + +xorriso is a program which maps file objects from POSIX compliant +filesystems into Rock Ridge enhanced ISO 9660 filesystems and allows +session-wise manipulation of such filesystems. It can load the management +information of existing ISO images and it writes the session results to +optical media or to filesystem objects. + +Currently it is only supported on Linux with kernels >= 2.4. + +A special property of xorriso is that it needs neither an external ISO 9660 +formatter program nor an external burn program for CD or DVD but rather +incorporates the libraries of libburnia-project.org . + +By using this software you agree to the disclaimer at the end of this text +"This software is provided as is. There is no warranty implied and ..." + + + Compilation, First Glimpse, Installation + +The most simple way to get xorriso is the xorriso standalone tarball. + +Prerequisites: +The tarball contains anything that is needed except libc and libpthread. +libreadline and the libreadline-development headers will make dialog mode +more convenient but are not mandatory. + +Obtain xorriso-0.1.0.tar.gz, take it to a directory of your choice and do: + + tar xzf xorriso-0.1.0.tar.gz + cd xorriso-0.1.0 + +Within that directory execute: + + ./configure --prefix=/usr + make + +This will produce a binary named + ./xorriso/xorriso + +You may copy or move it to a directory where it can be found by the shell, +you may execute xorriso at the place where it was built, or you may execute +as superuser: + make install + +There is a man page + xorriso/xorriso.1 +which gets installed with "make install" but may also be place manually in the +./man1 directory below the directories mentioned in environment variablei +$MANPATH. +You may get a first glimpse by + man ./xorriso/xorriso.1 + + + Drives and Disk File Objects + +The user of xorriso needs rw-permission for the CD burner device. +A list of rw-accessible drives can be obtained by + + xorriso -devices + +CD devices which offer no rw-permission are invisible to normal users. +The superuser should be able to see any usable drive and then set the +permissions as needed. + +The output of xorriso -devices might look like + +0 -dev '/dev/sr0' rwrw-- : 'TSSTcorp' 'CDDVDW SH-S203B' +1 -dev '/dev/hda' rwrw-- : 'HL-DT-ST' 'DVD-ROM GDR8162B' + +So full and insecure enabling of both for everybody would look like + chmod a+rw /dev/sr0 /dev/hda +This is equivalent to the traditional setup chmod a+x,u+s cdrecord. + +I strongly discourage to run xorriso with setuid root or via sudo ! +It is not checked for the necessary degree of hacker safety. + +Consider to put all authorized users into group "floppy", to chgrp the +device file to that group and to disallow w-access to others. + + +Besides true optical drives, xorriso can also address disk files as input or +output drives. The addresses of the disk files have to be preceded by "stdio:". +Like: + xorriso -dev stdio:/tmp/pseudo_drive ...more arguments... + + + + Usage examples + +For options and general concepts see + man 1 xorriso + +>>> Some examples + + +------------------------------------------------------------------------------ + + This program is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License version 2 as + published by the Free Software Foundation. + + This program is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + + You should have received a copy of the GNU General Public License + along with this program; if not, write to the Free Software + Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + +------------------------------------------------------------------------------ +Based on and sub project of: +libburnia-project.org +By Mario Danic , + Vreixo Formoso + Thomas Schmitt +Copyright (C) 2006-2008 Mario Danic, Vreixo Formoso, Thomas Schmitt. + +libburnia-project.org is inspired by and in other components still containing +parts of old +Libburn. By Derek Foreman and + Ben Jansens +Copyright (C) 2002-2006 Derek Foreman and Ben Jansens +