From 18996ea46d17213a321794f90f1e48cf8b2bcc5e Mon Sep 17 00:00:00 2001 From: Thomas Schmitt Date: Fri, 18 Jan 2008 10:19:36 +0000 Subject: [PATCH] Worked on documentation --- test/README | 36 +-- test/make_xorriso_standalone.sh | 4 +- test/xorriso_eng.html | 387 ++++++++++++++++++++++++++++++++ 3 files changed, 412 insertions(+), 15 deletions(-) create mode 100644 test/xorriso_eng.html diff --git a/test/README b/test/README index 88d00e55..f79b722e 100644 --- a/test/README +++ b/test/README @@ -47,21 +47,27 @@ Within that directory execute: This will produce a binary named ./xorriso/xorriso +which you may strip to reduce it in size + strip ./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 +For general concepts, options and usage examples see + man 1 xorriso + +This man page is part of the tarball as 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. +It gets installed with "make install" but may also be place manually in the +./man1 directory below one of the the directories mentioned in environment +variable $MANPATH. You may get a first glimpse by man ./xorriso/xorriso.1 - Drives and Disk File Objects + 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 @@ -77,7 +83,7 @@ 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 +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. @@ -88,6 +94,16 @@ Consider to put all authorized users into group "floppy", to chgrp the device file to that group and to disallow w-access to others. +A possible source of problems are hald or other automounters. +If you can spot a process "hald-addon-storage" with the address of +your desired drive, then consider to kill it. + +If you cannot get rid of the automounter that easily, try whether it helps +to always load the drive tray manually before starting a write run of +xorriso. Wait until the drive light is off. +Better try to unmount an eventually mounted media before a write run. + + 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: @@ -95,14 +111,6 @@ Like: - 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 diff --git a/test/make_xorriso_standalone.sh b/test/make_xorriso_standalone.sh index 67776ac8..946b9fd7 100755 --- a/test/make_xorriso_standalone.sh +++ b/test/make_xorriso_standalone.sh @@ -88,7 +88,7 @@ copy_files test/xorriso_pc_in.txt "$lone_dir"/xorriso.pc.in copy_files test/README "$lone_dir"/README -cat "See end of xorriso/changelog.txt" >"$lone_dir"/TODO +echo "See end of xorriso/changelog.txt" >"$lone_dir"/TODO # libisoburn @@ -107,6 +107,8 @@ copy_files \ test/changelog.txt \ "$lone_dir"/xorriso +copy_files test/xorriso_eng.html "$lone_dir"/xorriso/xorriso_eng.html + mv "$lone_dir"/xorriso/ng_xorrisoburn.h "$lone_dir"/xorriso/xorrisoburn.h mv "$lone_dir"/xorriso/ng_xorrisoburn.c "$lone_dir"/xorriso/xorrisoburn.c diff --git a/test/xorriso_eng.html b/test/xorriso_eng.html new file mode 100644 index 00000000..d35a9a64 --- /dev/null +++ b/test/xorriso_eng.html @@ -0,0 +1,387 @@ + + + + + + +xorriso homepage english + + + + + +
+

Homepage of

+

xorriso

+ +

ISO 9660 Rock Ridge Filesystem Manipulator for Linux

+
+ +

+

Purpose:

+xorriso 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. +

+

+ +

+ +Direct hop to download links -> + +

+

Hardware requirements:

+A CD/DVD recorder suitable for +http://libburnia-project.org
+(SCSI , ATA , USB , or SATA writers compliant to standard MMC-3 for CD +and to MMC-5 for DVD). +
+

+ +

+

Software requirements :

+
+
Linux with kernel 2.4 or higher (and libc, of course) :
+
With kernel 2.4 an ATA drive has to be under ide-scsi emulation.
+
With kernel 2.6 the drive should not be under ide-scsi.
+
libpthread
+
is supposed to be a standard system component.
+
libreadline and libreadline-dev
+
are optional and eventually make dialog more convenient.
+
+

+ +

+

+GPL software included:
+

+
+
libburn-0.4.1
+
reads and writes data from and to CD and DVD.
+
(founded by Derek Foreman and Ben Jansens, +furthered by team of libburnia-project.org)
+
libisofs-1.0.0
+
operates ISO 9660 images.
+
(By Vreixo Formoso from team of libburnia-project.org)
+
libisoburn-0.1.0
+
coordinates libburn and libisofs, emulates multi-session where needed.
+
(By Vreixo Formoso and Thomas Schmitt +from team of libburnia-project.org)
+
+
The source code of this software is independent of +cdrecord and mkisofs. +
+

+ +

+This program system has been tested on Intel/AMD Linux systems only.
+For ports to other usable systems contact us. +

+ +
+ +

+

Special features:

+ +

+ +

+

Commands:

+
+
Get an overview of drives and their addresses
+
# xorriso -devices
+
Being superuser avoids permission problems with /dev/srN resp. /dev/hdX . +
+
Ordinary users should then get granted rw access to the /dev files +as listed by option -devices.
+
 
+ +
Options are either performed as program arguments or as dialog input. +Some options have a parameter list of variable length. This list has to +be terminated by word '--' or by the end of the input line. Option -add +may accept pathspecs of form target=source as known from program mkisofs.
+ +
+ +
Get info about a particular drive or loaded media:
+
$ xorriso -dev /dev/sr0 -toc
+ +
Make re-usable media writable from scratch again:
+
$ xorriso -dev /dev/sr0 -blank fast -eject all
+ +
+
+
+ +
Write some directories into a new or existing ISO 9660 image:
+
$ xorriso -dev /dev/sr0 -add /home/me/sounds /home/me/pictures +
+ +
+
+
+ +
Create new ISO-9660 filesystem image, compose content, +adjust permissions to make it publicly read-only, +write it to media, eject media. +
+
$ xorriso -outdev /dev/sr0 -blank fast -pathspecs on \
+
  -add /sounds=/home/me/sounds \
+
       +/pictures=/home/me/pictures -- \
+
  -rm_r /sounds/indecent '/pictures/*private*' -- \
+
  -add /pictures/private/horses=/home/me/pictures/private/horses -- \
+
  -chmod_r a+r,a-w / -- \
+
  -find / -type d -exec chmod a+x \
+
  -volid SOUNDS_PICS_2008_01_16 \
+
  -commit -eject all
+ +
+
+
+ +
Load the previous session from media, +remove (i.e. hide) directory /sounds, +rename /pictures/private/horses, +add new directory trees /sounds and /movies, +disallow any access for group and others. +Finally write as additional session to media and eject:
+
$ xorriso -dev /dev/sr0 -pathspecs on \
+
  -rm_r /sounds -- \
+
  -mv /pictures/private/horses /horse_show -- \
+
  -add /sounds=/home/me/prepared_for_dvd/sounds_dummy \
+
       /movies=/home/me/prepared_for_dvd/movies -- \
+
  -chmod_r go-rwx / -- \
+
  -volid SOUNDS_PICS_2008_01_17 \
+
  -commit -eject all
+ +
+
+
+ +
Merge the various sessions from old readable media into a single session +on new writeable media, +cleaning out all invalidated files and session overhead. +Touch / in order to mark the image as worth to be written. +
+Important: -indev and -outdev have to be different drives. +
+
$ xorriso -indev /dev/dvd \
+
  -alter_date a +0 / -- \
+
  -outdev /dev/sr0 -blank fast \
+
  -commit -eject all
+ +
+
+
+ +
Get overview of the options:
+
$ xorriso -help
+ +
Read the detailed manual page:
+
$ man xorriso
+
+ + +Testers wanted who are willing to risk some double layer DVD media. + +

+ +
+ +

+

+
Download as source code (see README):
+
xorriso-0.1.0.pl00.tar.gz +( KB). +
+ + + +
+ + +
Documentation:
+
README about installation and drive setup
+
xorriso -help gives an overview of options
+
man xorriso is the manual page
+
+ +
Contact:
+
Thomas Schmitt, scdbackup@gmx.net
+
libburn development mailing list, +libburn-hackers@pykix.org
+
+
License:
+
GPL version 2, +an Open Source approved license
+
 
+
+

+ + + +
+ +

+Many thanks to Derek Foreman and Ben Jansens for starting libburn. +
+Very special thanks to Andy Polyakov whose +dvd+rw-tools +provide the libburnia project with invaluable examples on how to deal +with DVD media and how to emulate multi-session on overwriteable media. +

+ +
+ + +
+ +

+Enjoying free Open Source hosting by www.webframe.org
+ +100 % Microsoft free
+and by sourceforge.net
+ +SourceForge Logo + +
+
+
+
Links to my other published software projects :
+
+cdrskin, a cdrecord emulator
+
+scdbackup, multi volume CD backup
+
+(a second source of above)
+
Some Tools for Image Collectors
+
+pppoem, a DSL throughput monitor (mainly for Linux kernel 2.4)
+
+

+Legal statement: This website does not serve any commercial purpose.
+ + +