legacy/libisoburn/trunk/test
2008-01-17 19:28:38 +00:00
..
changelog.txt Updated changelog 2007-12-24 16:14:57 +00:00
compile_xorriso.sh Added forgotten source module 2008-01-14 16:35:07 +00:00
configure_ac.txt Added a test for readline.h and eventually enabled use of libreadline 2008-01-16 23:36:17 +00:00
make_timestamp.sh A build facility to circumvent autotools during development 2007-10-12 22:19:19 +00:00
make_xorriso_standalone.sh Silenced most compiler warnings of libisofs in xorriso-standalone 2008-01-17 19:27:51 +00:00
ng_xorrisoburn.c Silenced -pedantic compiler warnings about type punning 2008-01-17 14:53:08 +00:00
ng_xorrisoburn.h Closed a small memory leak 2008-01-15 20:41:56 +00:00
README Began a README file for xorriso 2008-01-17 19:28:38 +00:00
test.c New API call isoburn_attach_volset(), changes with isoburn_read_volset() 2007-11-14 14:26:32 +00:00
xorriso_makefile_am.txt Added a test for readline.h and eventually enabled use of libreadline 2008-01-16 23:36:17 +00:00
xorriso_pc_in.txt A sketch of a xorriso source standalone release generator 2008-01-16 20:13:18 +00:00
xorriso_private.h Made improvements about pattern matching .., closed small memory leaks 2008-01-15 17:45:08 +00:00
xorriso_timestamp.h Silenced -pedantic compiler warnings about type punning 2008-01-17 14:53:08 +00:00
xorriso.1 Made improvements around volume id 2008-01-14 22:47:44 +00:00
xorriso.c Adaption to Xorriso_standalonE, some consequences from compiler warnings 2008-01-16 20:10:50 +00:00
xorriso.h Made improvements about pattern matching .., closed small memory leaks 2008-01-15 17:45:08 +00:00
xorriso.txt Splitted think text from emerging man page, formatted man page 2007-10-20 17:12:11 +00:00
xorrisoburn.c Closed a small memory leak 2008-01-15 20:41:56 +00:00
xorrisoburn.h Closed a small memory leak 2008-01-15 20:41:56 +00:00

------------------------------------------------------------------------------
     libburnia-project.org     scdbackup.sourceforge.net/xorriso_eng.html
------------------------------------------------------------------------------
xorriso. By Thomas Schmitt <scdbackup@gmx.net>
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           <mario.danic@gmail.com>,
   Vreixo Formoso        <metalpain2002@yahoo.es>
   Thomas Schmitt        <scdbackup@gmx.net>
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 <derek@signalmarketing.com> and
            Ben Jansens <xor@orodu.net>
Copyright (C) 2002-2006  Derek Foreman and Ben Jansens