libburnia/legacy
2
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Polished xorrisofs documentation

Browse Source
This commit is contained in:
Thomas Schmitt
2011-03-06 18:37:52 +00:00
parent 1f65a1cde1
commit b6a52328bc
3 changed files with 231 additions and 173 deletions
Download Patch File Download Diff File Expand all files Collapse all files

100
libisoburn/trunk/xorriso/xorrisofs.texi
View File

@ -44,7 +44,7 @@
@c man .\" First parameter, NAME, should be all caps
@c man .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
@c man .\" other parameters are allowed: see man(7), man(1)
@c man .TH XORRISOFS 1 "Mar 05, 2011"
@c man .TH XORRISOFS 1 "Mar 06, 2011"
@c man .\" Please adjust this date whenever revising the manpage.
@c man .\"
@c man .\" Some roff macros, for reference:
@ -83,13 +83,13 @@ Permission is granted to distrubute this text freely.
@c man-ignore-lines 1
@c man .SH NAME
xorrisofs - Emulation of ISO 9660 program mkisofs by program xorriso,
xorrisofs - Emulation of ISO 9660 program mkisofs by program xorriso
@end ifnottex
@menu
* Overview:: Overview
* Xorriso:: Relation to program xorriso
* Standards:: ISO 9660, Rock Ridge, Joliet
* Insert:: Inserting files into the ISO image
* Xorriso:: Relation to program xorriso
* Options:: Options
* Examples:: Examples
* Files:: Files
@ -98,7 +98,7 @@ xorrisofs - Emulation of ISO 9660 program mkisofs by program xorriso,
* CommandIdx:: Alphabetic Command List
* ConceptIdx:: Alphabetic List of Concepts and Objects
@end menu
@node Overview, Xorriso, Top, Top
@node Overview, Standards, Top, Top
@chapter Overview
@c man .SH SYNOPSIS
@c man .B xorrisofs
@ -109,49 +109,27 @@ xorrisofs - Emulation of ISO 9660 program mkisofs by program xorriso,
@strong{xorrisofs}
produces Rock Ridge enhanced ISO 9660 filesystems and add-on sessions to
such filesystems. Optionally it can produce Joliet directory trees too.
@*
@sp 1
@c man .PP
xorrisofs understands options of program mkisofs from cdrtools by
Joerg Schilling.
Its implementation is part of program xorriso which shares no source
code with cdrtools.
@c man .SS
@node Xorriso, Standards, Overview, Top
@chapter Relation to program xorriso
@c man \fBRelation to program xorriso:\fR
@c man .br
@cindex xorriso, mkisofs emulation
xorrisofs is actually a command mode of program @strong{xorriso},
which gets entered either by xorriso command "-as mkisofs" or by
starting the program by one of the names "xorrisofs", "mkisofs",
"genisoimage", or "genisofs".
@*
This command mode can be left by argument "@minus{}@minus{}" which leads
to generic xorriso command mode. See @strong{man xorriso} for its description.
@*
@sp 1
@c man .PP
xorriso performs image reading and writing by help of libburn, which is
mainly intended for optical drives, but also operates on all POSIX
file types except directories.
@*
The program messages call any file a "drive". File types which are not
supported for reading are reported as "blank". The reported free media
space may be quite fictional.
@*
Nevertheless xorrisofs does not operate directly on optical drives,
but rather forces libburn to regard them as general device files.
So for writing of sequential optical media (CD, DVD-R, DVD+R, BD-R)
one will have to use a burn program. E.g the cdrecord emulation of xorriso.
See EXAMPLES.
@c man .SS
@node Standards, Insert, Xorriso, Top
@node Standards, Insert, Overview, Top
@chapter ISO 9660, Rock Ridge, Joliet
@c man \fBISO 9660, Rock Ridge, Joliet:\fR
@c man .br
@cindex ISO 9660, _definiton
@cindex ECMA-119, _definiton
@strong{ISO 9660}
(aka @strong{ECMA-119}) describes directories and data files with
(aka @strong{ECMA-119}) is a read-only filesystem that is mainly used for
optical media CD, DVD, BD, but may also reside on other storage devices like
disk files, USB sticks or disk partitions. It is widely readable by many
operating systems and by boot facilities of personal computers.
@*
ISO 9660 describes directories and data files by
very restricted filenames with no distinction of upper case and lower case.
Its metadata do not comply to fundamental POSIX specifications.
@*
@ -184,7 +162,7 @@ Production of this directory tree may be enabled by option -iso-level 4.
@c man .SS
@sp 1
@c man .B Inserting files into the ISO image:
@node Insert, Options, Standards, Top
@node Insert, Xorriso, Standards, Top
@chapter Inserting files into the ISO image
@c man .PP
xorrisofs deals with two kinds of file addresses:
@ -224,7 +202,36 @@ underneath this directory get inserted into the image, too.
It is possible to exclude particular files from being inserted
by help of option -m.
@c man .SS
@node Options, Examples, Insert, top
@node Xorriso, Options, Insert, Top
@chapter Relation to program xorriso
@c man \fBRelation to program xorriso:\fR
@c man .br
@cindex xorriso, mkisofs emulation
xorrisofs is actually a command mode of program @strong{xorriso},
which gets entered either by xorriso command "-as mkisofs" or by
starting the program by one of the names "xorrisofs", "mkisofs",
"genisoimage", or "genisofs".
@*
This command mode can be left by argument "@minus{}@minus{}" which leads
to generic xorriso command mode. See @strong{man xorriso} for its description.
@*
@sp 1
@c man .PP
xorriso performs image reading and writing by help of libburn, which is
mainly intended for optical drives, but also operates on all POSIX
file types except directories.
@*
The program messages call any image file a "drive". File types which are not
supported for reading are reported as "blank". The reported free media
space may be quite fictional.
@*
Nevertheless xorrisofs does not operate directly on optical drives,
but rather forces libburn to regard them as general device files.
So for writing of sequential optical media (CD, DVD-R, DVD+R, BD-R)
one will have to use a burn program. E.g the cdrecord emulation of xorriso.
See EXAMPLES.
@c man .SS
@node Options, Examples, Xorriso, top
@chapter Options
@cindex xorriso, options
@c man .br
@ -252,6 +259,7 @@ by help of option -m.
@c man .PP
The following options control loading of an existing ISO image for the purpose
of preparing a suitable add-on session.
If they are missing then a new image is composed from scratch.
@table @asis
@sp 1
@c man .TP
@ -262,6 +270,12 @@ Set the path from which to load the existing ISO image directory tree
on which to base the upcomming directory tree as add-on session.
The path must lead to a random-access readable file object.
On GNU/Linux: regular data files or block device files.
@*
A special kind of pseudo disk_path has the form "/dev/fd/"number.
It depicts the open file descriptor with the given number, regardless whether
the operating system supports this feature by file nodes in /dev/fd or not.
E.g. /dev/fd/3 is file descriptor 3 which was opened by the program that
later started xorriso.
@c man .TP
@item -prev-session disk_path
@kindex -prev-session set path for loading existing ISO image
@ -450,7 +464,13 @@ when image production begins. It may not already exist as directory.
If it does not exist yet then its parent directory must exist and
a regular file will get created.
@*
Default is stdout which may also be set by disk_path "-".
A special kind of pseudo disk_path has the form "/dev/fd/"number.
It depicts the open file descriptor with the given number, regardless whether
the operating system supports this feature by file nodes in /dev/fd or not.
E.g. /dev/fd/4 is file descriptor 4 which was opened by the program that
later started xorriso.
@*
Default is standard output (/dev/fd/1) which may also be set by disk_path "-".
@c man .TP
@item -output disk_path
@kindex -output set output file address
@ -1507,7 +1527,7 @@ the image will be created automatically:
/datafiles/file1=/home/me/datafile
@*
@sp 1
yields in the ISO image
yields in the ISO image:
@sp 1
@*
/datafiles/file1
@ -1524,7 +1544,7 @@ But if it must be, one may escape them:
/with_\=_and_\\/file=/tmp/directory/file
@*
@sp 1
yields in the ISO image
yields in the ISO image:
@*
@sp 1
/with_=_and_\/file