Worked on documentation
This commit is contained in:
parent
0023f94511
commit
18996ea46d
36
test/README
36
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
|
||||
|
||||
@ -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
|
||||
|
||||
|
||||
387
test/xorriso_eng.html
Normal file
387
test/xorriso_eng.html
Normal file
@ -0,0 +1,387 @@
|
||||
<HTML>
|
||||
|
||||
<HEAD>
|
||||
<META NAME="description" CONTENT="xorriso, creates, loads, manipulates and writes ISO 9660 filesystem images with Rock Ridge extensions">
|
||||
<META NAME="keywords" CONTENT="xorriso, libburn, libburnia, burn, CD, DVD, ISO, ISO 9660, RockRidge, Rock Ridge, linux, recording, burning, CD-R, CD-RW, DVD-R, DVD-RW, DVD+RW, DVD+R, scdbackup">
|
||||
<META NAME="robots" CONTENT="follow">
|
||||
<TITLE>xorriso homepage english</TITLE>
|
||||
</HEAD>
|
||||
|
||||
<BODY BGCOLOR="#F5DEB3" TEXT=#000000 LINK=#0000A0 VLINK=#800000>
|
||||
<FONT SIZE=+1>
|
||||
|
||||
<CENTER>
|
||||
<P><H2> Homepage of </H2>
|
||||
<H1> xorriso </H1>
|
||||
|
||||
<H2>ISO 9660 Rock Ridge Filesystem Manipulator for Linux</H2>
|
||||
</CENTER>
|
||||
|
||||
<P>
|
||||
<H2>Purpose:</H2>
|
||||
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.
|
||||
</P>
|
||||
<P>
|
||||
|
||||
<HR>
|
||||
|
||||
<A HREF="#download">Direct hop to download links -></A>
|
||||
|
||||
<P>
|
||||
<H2>Hardware requirements:</H2>
|
||||
A CD/DVD recorder suitable for
|
||||
<A HREF="http://libburnia-project.org">http://libburnia-project.org</A> <BR>
|
||||
(SCSI , ATA , USB , or SATA writers compliant to standard MMC-3 for CD
|
||||
and to MMC-5 for DVD).
|
||||
<BR>
|
||||
</P>
|
||||
|
||||
<P>
|
||||
<H2>Software requirements :</H2>
|
||||
<DL>
|
||||
<DT>Linux with kernel 2.4 or higher (and libc, of course) :</DT>
|
||||
<DD>With kernel 2.4 an ATA drive has to be under ide-scsi emulation.</DD>
|
||||
<DD>With kernel 2.6 the drive should not be under ide-scsi.</DD>
|
||||
<DT>libpthread</DT>
|
||||
<DD>is supposed to be a standard system component.</DD>
|
||||
<DT>libreadline and libreadline-dev</DT>
|
||||
<DD>are optional and eventually make dialog more convenient.</DD>
|
||||
</DL>
|
||||
</P>
|
||||
|
||||
<P>
|
||||
<H2>
|
||||
GPL software included:<BR>
|
||||
</H2>
|
||||
<DL>
|
||||
<DT>libburn-0.4.1</DT>
|
||||
<DD>reads and writes data from and to CD and DVD.</DD>
|
||||
<DD>(founded by Derek Foreman and Ben Jansens,
|
||||
furthered by team of libburnia-project.org)</DD>
|
||||
<DT>libisofs-1.0.0</DT>
|
||||
<DD>operates ISO 9660 images.</DD>
|
||||
<DD>(By Vreixo Formoso from team of libburnia-project.org)</DD>
|
||||
<DT>libisoburn-0.1.0</DT>
|
||||
<DD>coordinates libburn and libisofs, emulates multi-session where needed.</DD>
|
||||
<DD>(By Vreixo Formoso and Thomas Schmitt
|
||||
from team of libburnia-project.org)</DD>
|
||||
</DL>
|
||||
<DD>The source code of this software is independent of
|
||||
cdrecord and mkisofs.</A>
|
||||
</DD>
|
||||
</P>
|
||||
|
||||
<P>
|
||||
This program system has been tested on Intel/AMD Linux systems only.<BR>
|
||||
For ports to other usable systems <A HREF="#contact">contact us</A>.
|
||||
</P>
|
||||
|
||||
<HR>
|
||||
|
||||
<P>
|
||||
<H2>Special features:</H2>
|
||||
<UL>
|
||||
<LI>
|
||||
ISO 9660 formatter and burner for CD or DVD are fixely integrated.
|
||||
</LI>
|
||||
<LI>
|
||||
Operates on an existing ISO image or creates a new one.
|
||||
<LI>
|
||||
</LI>
|
||||
Copies files from filesystem into the ISO image.
|
||||
<LI>
|
||||
</LI>
|
||||
Renames or deletes file objects in the ISO image.
|
||||
<LI>
|
||||
Changes file properties in the ISO image.
|
||||
</LI>
|
||||
<LI>
|
||||
Can write result as completely new image to optical media or
|
||||
filesystem objects.
|
||||
</LI>
|
||||
<LI>
|
||||
Can write result as add-on session to appendable multi-session media,
|
||||
to overwriteable media, to regular files, and to block devices.
|
||||
</LI>
|
||||
<LI>
|
||||
Scans for optical drives, blanks re-useable optical media.
|
||||
</LI>
|
||||
<LI>
|
||||
Suitable for: CD-R, CD-RW, DVD-R, DVD-RW, DVD+R, DVD+RW, DVD-RAM.
|
||||
</LI>
|
||||
<LI>
|
||||
Reads its instructions from command line arguments, dialog, and batch files.
|
||||
</LI>
|
||||
<LI>
|
||||
Provides navigation commands for interactive ISO image manipulation.
|
||||
</LI>
|
||||
|
||||
</UL>
|
||||
</P>
|
||||
|
||||
<P>
|
||||
<H2>Commands:</H2>
|
||||
<DL>
|
||||
<DT>Get an overview of drives and their addresses</DT>
|
||||
<DD>#<KBD> xorriso -devices</KBD></DD>
|
||||
<DT>Being superuser avoids permission problems with /dev/srN resp. /dev/hdX .
|
||||
</DT>
|
||||
<DT>Ordinary users should then get granted rw access to the /dev files
|
||||
as listed by option -devices.</DT>
|
||||
<DT> </DT>
|
||||
|
||||
<DT>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.</DT>
|
||||
|
||||
<HR>
|
||||
|
||||
<DT>Get info about a particular drive or loaded media:</DT>
|
||||
<DD>$<KBD> xorriso -dev /dev/sr0 -toc</KBD></DD>
|
||||
|
||||
<DT>Make re-usable media writable from scratch again:</DT>
|
||||
<DD>$<KBD> xorriso -dev /dev/sr0 -blank fast -eject all</KBD></DD>
|
||||
|
||||
<DT>
|
||||
<HR>
|
||||
</DT>
|
||||
|
||||
<DT>Write some directories into a new or existing ISO 9660 image:</DT>
|
||||
<DD>$<KBD> xorriso -dev /dev/sr0 -add /home/me/sounds /home/me/pictures
|
||||
</KBD></DD>
|
||||
|
||||
<DT>
|
||||
<HR>
|
||||
</DT>
|
||||
|
||||
<DT>Create new ISO-9660 filesystem image, compose content,
|
||||
adjust permissions to make it publicly read-only,
|
||||
write it to media, eject media.
|
||||
</DT>
|
||||
<DD>$<KBD> xorriso -outdev /dev/sr0 -blank fast -pathspecs on \</KBD></DD>
|
||||
<DD><KBD> -add /sounds=/home/me/sounds \</KBD></DD>
|
||||
<DD><KBD>
|
||||
/pictures=/home/me/pictures -- \</KBD></DD>
|
||||
<DD><KBD> -rm_r /sounds/indecent '/pictures/*private*' -- \</KBD></DD>
|
||||
<DD><KBD> -add /pictures/private/horses=/home/me/pictures/private/horses -- \</KBD></DD>
|
||||
<DD><KBD> -chmod_r a+r,a-w / -- \</KBD></DD>
|
||||
<DD><KBD> -find / -type d -exec chmod a+x \</KBD></DD>
|
||||
<DD><KBD> -volid SOUNDS_PICS_2008_01_16 \</KBD></DD>
|
||||
<DD><KBD> -commit -eject all</KBD></DD>
|
||||
|
||||
<DT>
|
||||
<HR>
|
||||
</DT>
|
||||
|
||||
<DT>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:</DT>
|
||||
<DD>$<KBD> xorriso -dev /dev/sr0 -pathspecs on \</KBD></DD>
|
||||
<DD><KBD> -rm_r /sounds -- \</KBD></DD>
|
||||
<DD><KBD> -mv /pictures/private/horses /horse_show -- \</KBD></DD>
|
||||
<DD><KBD> -add /sounds=/home/me/prepared_for_dvd/sounds_dummy \</KBD></DD>
|
||||
<DD><KBD> /movies=/home/me/prepared_for_dvd/movies -- \</KBD></DD>
|
||||
<DD><KBD> -chmod_r go-rwx / -- \</KBD></DD>
|
||||
<DD><KBD> -volid SOUNDS_PICS_2008_01_17 \</KBD></DD>
|
||||
<DD><KBD> -commit -eject all</KBD></DD>
|
||||
|
||||
<DT>
|
||||
<HR>
|
||||
</DT>
|
||||
|
||||
<DT>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.
|
||||
<BR>
|
||||
Important: -indev and -outdev have to be different drives.
|
||||
</DT>
|
||||
<DD>$<KBD> xorriso -indev /dev/dvd \</KBD></DD>
|
||||
<DD><KBD> -alter_date a +0 / -- \</KBD></DD>
|
||||
<DD><KBD> -outdev /dev/sr0 -blank fast \</KBD></DD>
|
||||
<DD><KBD> -commit -eject all</KBD></DD>
|
||||
|
||||
<DT>
|
||||
<HR>
|
||||
</DT>
|
||||
|
||||
<DT>Get overview of the options:</DT>
|
||||
<DD>$<KBD> <A HREF="xorriso_help">xorriso -help</A></KBD></DD>
|
||||
|
||||
<DT>Read the detailed manual page:</DT>
|
||||
<DD>$<KBD> <A HREF="man_1_xorriso.html">man xorriso</A></KBD></DD>
|
||||
</DL>
|
||||
|
||||
|
||||
Testers wanted who are willing to risk some double layer DVD media.
|
||||
|
||||
</P>
|
||||
|
||||
<HR>
|
||||
<A NAME="download"></A>
|
||||
<P>
|
||||
<DL>
|
||||
<DT>Download as source code (see README):</DT>
|
||||
<DD><A HREF="xorriso-0.1.0.pl00.tar.gz">xorriso-0.1.0.pl00.tar.gz</A>
|
||||
( KB).
|
||||
</DD>
|
||||
|
||||
<!--
|
||||
<DD> </DD>
|
||||
<DT>Download as single x86 binaries (untar and move to /usr/bin/xorriso):</DT>
|
||||
<DD><A HREF="xorriso_0.1.0.pl00-x86-suse9_0.tar.gz">
|
||||
xorriso_0.1.0.pl00-x86-suse9_0.tar.gz</A>, ( KB),
|
||||
<DL>
|
||||
<DD>runs on SuSE 9.0 (2.4.21) , SuSE 10.2 (2.6.18.2) and others.</DD>
|
||||
</DL>
|
||||
<DD><A HREF="xorriso_0.1.0.pl00-x86-suse9_0-static.tar.gz">
|
||||
xorriso_0.1.0.pl00-x86-suse9_0-static.tar.gz</A>, ( KB), -static compiled,
|
||||
<DL>
|
||||
<DD>runs on many other systems.</DD>
|
||||
-->
|
||||
|
||||
</DL>
|
||||
</DD>
|
||||
</DL>
|
||||
<DL><DT>Documentation:</DT>
|
||||
<DD><A HREF="README_xorriso">README</A> about installation and drive setup</DD>
|
||||
<DD><A HREF="xorriso_help">xorriso -help</A> gives an overview of options</DD>
|
||||
<DD><A HREF="man_1_xorriso.html">man xorriso</A> is the manual page</DD>
|
||||
</DL>
|
||||
<A NAME="contact"></A>
|
||||
<DL><DT>Contact:</DT>
|
||||
<DD>Thomas Schmitt, <A HREF="mailto:scdbackup@gmx.net">scdbackup@gmx.net</A></DD>
|
||||
<DD>libburn development mailing list,
|
||||
<A HREF="mailto:libburn-hackers@pykix.org">libburn-hackers@pykix.org</A></DD>
|
||||
</DL>
|
||||
<DL><DT>License:</DT>
|
||||
<DD><A HREF="COPYING_xorriso">GPL version 2</A>,
|
||||
an <A HREF="http://www.opensource.org/">Open Source</A> approved license</DD>
|
||||
<DD> </DD>
|
||||
</DL>
|
||||
</P>
|
||||
|
||||
|
||||
<!--
|
||||
<HR>
|
||||
|
||||
<P>
|
||||
Enhancements towards previous stable version xorriso-0.1.0:
|
||||
<UL>
|
||||
<LI>none yet</LI>
|
||||
</UL>
|
||||
|
||||
Bug fixes towards xorriso-0.1.0.pl00:
|
||||
<UL>
|
||||
<LI>none yet</LI>
|
||||
</UL>
|
||||
|
||||
</P>
|
||||
|
||||
<HR>
|
||||
|
||||
<P>
|
||||
<DL>
|
||||
<DT><H3>Development snapshot, version 0.1.1 :</H3></DT>
|
||||
<DD>Enhancements towards stable version 0.1.0.pl00:
|
||||
<UL>
|
||||
<LI>none yet</LI>
|
||||
</UL>
|
||||
</DD>
|
||||
<DD> </DD>
|
||||
<DD><A HREF="README_xorriso_devel">README 0.1.1</A>
|
||||
<DD><A HREF="xorriso_help_devel">xorriso_0.1.1 -help</A></DD>
|
||||
<DD><A HREF="man_1_xorriso_devel.html">man xorriso (as of 0.1.1)</A></DD>
|
||||
<DD> </DD>
|
||||
<DT>Maintainers of xorriso unstable packages please use SVN of
|
||||
<A HREF="http://libburnia-project.org"> libburnia-project.org</A></DT>
|
||||
<DD>Download: <KBD><B>svn co http://svn.libburnia-project.org/libburn/trunk libburn</B>
|
||||
</KBD></DD>
|
||||
<DD>Build: <KBD><B>cd libburn ; ./bootstrap ; ./configure --prefix /usr ; make</B>
|
||||
</KBD></DD>
|
||||
<DD>Download: <KBD><B>svn co http://svn.libburnia-project.org/libisoburn/trunk libisburn</B>
|
||||
</KBD></DD>
|
||||
<DD>Build: <KBD><B>cd libisoburn ; ./bootstrap ; ./configure --prefix /usr ; make</B>
|
||||
</KBD></DD>
|
||||
<DD>Download: - libisofs bzr service not functional yet - </DD>
|
||||
<DD>Build: <KBD><B>cd ng-libisofs ; ./autogen.sh ; ./configure --prefix /usr ; make</B>
|
||||
</KBD></DD>
|
||||
<DD>Build of SVN versions needs <A HREF="http://sources.redhat.com/autobook/">
|
||||
autotools</A> of at least version 1.7 installed.
|
||||
But after the run of <KBD>./bootstrap</KBD>, only
|
||||
vanilla tools like make and gcc are needed.</DD>
|
||||
</DD>
|
||||
<DD> </DD>
|
||||
<DT>The following downloads are intended for adventurous end users or
|
||||
admins with full system souvereignty.</DT>
|
||||
<DD>Source (./bootstrap is already applied, build tested, for more see
|
||||
<A HREF="README_xorriso_devel">upcoming README</A> ):
|
||||
</DD>
|
||||
<DD>
|
||||
<A HREF="xorriso-0.1.1.tar.gz">xorriso-0.1.1.tar.gz</A>
|
||||
(680 KB).
|
||||
</DD>
|
||||
<DD>Binary (untar and move to /usr/bin/xorriso):</DD>
|
||||
<DD><A HREF="xorriso_0.1.1-x86-suse9_0.tar.gz">
|
||||
xorriso_0.1.1-x86-suse9_0.tar.gz</A>, ( KB).
|
||||
</DD>
|
||||
<DD><A HREF="xorriso_0.1.1-x86-suse9_0-static.tar.gz">
|
||||
xorriso_0.1.1-x86-suse9_0-static.tar.gz</A>, ( KB)
|
||||
</DD>
|
||||
</DL>
|
||||
</P>
|
||||
|
||||
-->
|
||||
<HR>
|
||||
|
||||
<P>
|
||||
Many thanks to Derek Foreman and Ben Jansens for starting libburn.
|
||||
<BR>
|
||||
Very special thanks to Andy Polyakov whose
|
||||
<A HREF="http://fy.chalmers.se/~appro/linux/DVD+RW/tools">dvd+rw-tools</A>
|
||||
provide the libburnia project with invaluable examples on how to deal
|
||||
with DVD media and how to emulate multi-session on overwriteable media.
|
||||
</P>
|
||||
|
||||
<HR>
|
||||
|
||||
|
||||
<CENTER><FONT SIZE=+0>
|
||||
<!-- <A NAME="bottom" HREF="main_ger.html#bottom">deutsch (german)</A>
|
||||
<BR><BR>
|
||||
-->
|
||||
<BR><BR>
|
||||
<FONT SIZE=+0>Enjoying free Open Source hosting by <A HREF="http://www.webframe.org">www.webframe.org</A><BR>
|
||||
<A HREF="http://www.webframe.org">
|
||||
<IMG SRC="msfree.gif" ALT="100 % Microsoft free" BORDER=0></A><BR>
|
||||
and by <A HREF="http://sourceforge.net">sourceforge.net</A><BR>
|
||||
<A href="http://sourceforge.net">
|
||||
<IMG src="sflogo-88-1.png" BORDER="0" ALT="SourceForge Logo"></A>
|
||||
<!-- on sourceforge use : <IMG src="http://sourceforge.net/sflogo.php?group_id=16010" width="88" height="31" border="0" alt="SourceForge Logo"></A> -->
|
||||
</FONT></CENTER>
|
||||
<HR>
|
||||
<DL>
|
||||
<DT>Links to my other published software projects :</DT>
|
||||
<DD><A HREF=http://scdbackup.webframe.org/cdrskin_eng.html>
|
||||
cdrskin, a cdrecord emulator</A></DD>
|
||||
<DD><A HREF=http://scdbackup.webframe.org/main_eng.html>
|
||||
scdbackup, multi volume CD backup</A></DD>
|
||||
<DL><DD><A HREF=http://scdbackup.sourceforge.net/main_eng.html>
|
||||
(a second source of above)</A></DD></DL>
|
||||
<DD><A HREF=http://stic.sourceforge.net>Some Tools for Image Collectors</A></DD>
|
||||
<DD><A HREF=http://scdbackup.webframe.org/pppoem>
|
||||
pppoem, a DSL throughput monitor (mainly for Linux kernel 2.4)</A></DD>
|
||||
</DL>
|
||||
<BR><BR>
|
||||
Legal statement: This website does not serve any commercial purpose.<BR>
|
||||
</FONT>
|
||||
</BODY>
|
||||
</HTML>
|
||||
Loading…
Reference in New Issue
Block a user