Polished xorrisofs documentation
This commit is contained in:
parent
ab8265b042
commit
1c1e86f168
@ -9,7 +9,7 @@
|
||||
.\" First parameter, NAME, should be all caps
|
||||
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
|
||||
.\" other parameters are allowed: see man(7), man(1)
|
||||
.TH XORRISOFS 1 "Mar 05, 2011"
|
||||
.TH XORRISOFS 1 "Mar 06, 2011"
|
||||
.\" Please adjust this date whenever revising the manpage.
|
||||
.\"
|
||||
.\" Some roff macros, for reference:
|
||||
@ -24,7 +24,7 @@
|
||||
.\" for manpage-specific macros, see man(7)
|
||||
.nh
|
||||
.SH NAME
|
||||
xorrisofs - Emulation of ISO 9660 program mkisofs by program xorriso,
|
||||
xorrisofs - Emulation of ISO 9660 program mkisofs by program xorriso
|
||||
.SH SYNOPSIS
|
||||
.B xorrisofs
|
||||
[ options ] [-o filename ] pathspec [pathspecs ...]
|
||||
@ -34,41 +34,22 @@ xorrisofs - Emulation of ISO 9660 program mkisofs by program xorriso,
|
||||
\fBxorrisofs\fR
|
||||
produces Rock Ridge enhanced ISO 9660 filesystems and add-on sessions to
|
||||
such filesystems. Optionally it can produce Joliet directory trees too.
|
||||
.br
|
||||
.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.
|
||||
.SS
|
||||
\fBRelation to program xorriso:\fR
|
||||
.br
|
||||
xorrisofs is actually a command mode of program \fBxorriso\fR,
|
||||
which gets entered either by xorriso command "-as mkisofs" or by
|
||||
starting the program by one of the names "xorrisofs", "mkisofs",
|
||||
"genisoimage", or "genisofs".
|
||||
.br
|
||||
This command mode can be left by argument "--" which leads
|
||||
to generic xorriso command mode. See \fBman xorriso\fR for its description.
|
||||
.br
|
||||
.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.
|
||||
.br
|
||||
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.
|
||||
.br
|
||||
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.
|
||||
.SS
|
||||
\fBISO 9660, Rock Ridge, Joliet:\fR
|
||||
.br
|
||||
\fBISO 9660\fR
|
||||
(aka \fBECMA-119\fR) describes directories and data files with
|
||||
(aka \fBECMA-119\fR) 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.
|
||||
.br
|
||||
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.
|
||||
.br
|
||||
@ -130,6 +111,31 @@ underneath this directory get inserted into the image, too.
|
||||
It is possible to exclude particular files from being inserted
|
||||
by help of option -m.
|
||||
.SS
|
||||
\fBRelation to program xorriso:\fR
|
||||
.br
|
||||
xorrisofs is actually a command mode of program \fBxorriso\fR,
|
||||
which gets entered either by xorriso command "-as mkisofs" or by
|
||||
starting the program by one of the names "xorrisofs", "mkisofs",
|
||||
"genisoimage", or "genisofs".
|
||||
.br
|
||||
This command mode can be left by argument "--" which leads
|
||||
to generic xorriso command mode. See \fBman xorriso\fR for its description.
|
||||
.br
|
||||
.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.
|
||||
.br
|
||||
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.
|
||||
.br
|
||||
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.
|
||||
.SS
|
||||
.br
|
||||
.SH OPTIONS
|
||||
.br
|
||||
@ -139,12 +145,19 @@ by help of option -m.
|
||||
.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.
|
||||
.TP
|
||||
\fB\-M\fR disk_path
|
||||
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.
|
||||
.br
|
||||
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.
|
||||
.TP
|
||||
\fB\-prev-session\fR disk_path
|
||||
Alias of -M.
|
||||
@ -287,7 +300,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.
|
||||
.br
|
||||
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.
|
||||
.br
|
||||
Default is standard output (/dev/fd/1) which may also be set by disk_path "-".
|
||||
.TP
|
||||
\fB\-output\fR disk_path
|
||||
Alias of -o.
|
||||
@ -1078,7 +1097,7 @@ the image will be created automatically:
|
||||
.br
|
||||
/datafiles/file1=/home/me/datafile
|
||||
.br
|
||||
yields in the ISO image
|
||||
yields in the ISO image:
|
||||
.br
|
||||
/datafiles/file1
|
||||
.br
|
||||
@ -1090,7 +1109,7 @@ But if it must be, one may escape them:
|
||||
.br
|
||||
/with_\\=_and_\\\\/file=/tmp/directory/file
|
||||
.br
|
||||
yields in the ISO image
|
||||
yields in the ISO image:
|
||||
.br
|
||||
/with_=_and_\\/file
|
||||
.SS
|
||||
|
||||
@ -17,14 +17,14 @@ File: xorrisofs.info, Node: Top, Next: Overview, Up: (dir)
|
||||
xorrisofs
|
||||
*********
|
||||
|
||||
xorrisofs - Emulation of ISO 9660 program mkisofs by program xorriso,
|
||||
xorrisofs - Emulation of ISO 9660 program mkisofs by program xorriso
|
||||
|
||||
* 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
|
||||
@ -34,51 +34,33 @@ xorrisofs - Emulation of ISO 9660 program mkisofs by program xorriso,
|
||||
* ConceptIdx:: Alphabetic List of Concepts and Objects
|
||||
|
||||
|
||||
File: xorrisofs.info, Node: Overview, Next: Xorriso, Prev: Top, Up: Top
|
||||
File: xorrisofs.info, Node: Overview, Next: Standards, Prev: Top, Up: Top
|
||||
|
||||
1 Overview
|
||||
**********
|
||||
|
||||
*xorrisofs* produces Rock Ridge enhanced ISO 9660 filesystems and
|
||||
add-on sessions to such filesystems. Optionally it can produce Joliet
|
||||
directory trees too. 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.
|
||||
directory trees too.
|
||||
|
||||
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.
|
||||
|
||||
|
||||
File: xorrisofs.info, Node: Xorriso, Next: Standards, Prev: Overview, Up: Top
|
||||
File: xorrisofs.info, Node: Standards, Next: Insert, Prev: Overview, Up: Top
|
||||
|
||||
2 Relation to program xorriso
|
||||
*****************************
|
||||
|
||||
xorrisofs is actually a command mode of program *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 "--" which leads to generic
|
||||
xorriso command mode. See *man xorriso* for its description.
|
||||
|
||||
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.
|
||||
|
||||
|
||||
File: xorrisofs.info, Node: Standards, Next: Insert, Prev: Xorriso, Up: Top
|
||||
|
||||
3 ISO 9660, Rock Ridge, Joliet
|
||||
2 ISO 9660, Rock Ridge, Joliet
|
||||
******************************
|
||||
|
||||
*ISO 9660* (aka *ECMA-119*) describes directories and data files with
|
||||
very restricted filenames with no distinction of upper case and lower
|
||||
case. Its metadata do not comply to fundamental POSIX specifications.
|
||||
*ISO 9660* (aka *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.
|
||||
*Rock Ridge* is the name of a set of additional information which
|
||||
enhance an ISO 9660 filesystem so that it can represent a POSIX
|
||||
compliant filesystem with ownership, access permissions, symbolic
|
||||
@ -99,9 +81,9 @@ filenames nevertheless. Production of this directory tree may be
|
||||
enabled by option -iso-level 4.
|
||||
|
||||
|
||||
File: xorrisofs.info, Node: Insert, Next: Options, Prev: Standards, Up: Top
|
||||
File: xorrisofs.info, Node: Insert, Next: Xorriso, Prev: Standards, Up: Top
|
||||
|
||||
4 Inserting files into the ISO image
|
||||
3 Inserting files into the ISO image
|
||||
************************************
|
||||
|
||||
xorrisofs deals with two kinds of file addresses:
|
||||
@ -130,7 +112,32 @@ possible to exclude particular files from being inserted by help of
|
||||
option -m.
|
||||
|
||||
|
||||
File: xorrisofs.info, Node: Options, Next: Examples, Prev: Insert, Up: Top
|
||||
File: xorrisofs.info, Node: Xorriso, Next: Options, Prev: Insert, Up: Top
|
||||
|
||||
4 Relation to program xorriso
|
||||
*****************************
|
||||
|
||||
xorrisofs is actually a command mode of program *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 "--" which leads to generic
|
||||
xorriso command mode. See *man xorriso* for its description.
|
||||
|
||||
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.
|
||||
|
||||
|
||||
File: xorrisofs.info, Node: Options, Next: Examples, Prev: Xorriso, Up: Top
|
||||
|
||||
5 Options
|
||||
*********
|
||||
@ -157,13 +164,19 @@ File: xorrisofs.info, Node: Loading, Next: SetInsert, Prev: Options, Up: Opt
|
||||
=============================================
|
||||
|
||||
The following options control loading of an existing ISO image for the
|
||||
purpose of preparing a suitable add-on session.
|
||||
purpose of preparing a suitable add-on session. If they are missing
|
||||
then a new image is composed from scratch.
|
||||
|
||||
-M disk_path
|
||||
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.
|
||||
|
||||
-prev-session disk_path
|
||||
Alias of -M.
|
||||
@ -312,7 +325,13 @@ File: xorrisofs.info, Node: SetProduct, Next: SetCompl, Prev: SetInsert, Up:
|
||||
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 "-".
|
||||
|
||||
-output disk_path
|
||||
Alias of -o.
|
||||
@ -1093,7 +1112,7 @@ automatically:
|
||||
|
||||
/datafiles/file1=/home/me/datafile
|
||||
|
||||
yields in the ISO image
|
||||
yields in the ISO image:
|
||||
|
||||
/datafiles/file1
|
||||
|
||||
@ -1104,7 +1123,7 @@ pathspec. But if it must be, one may escape them:
|
||||
|
||||
/with_\=_and_\\/file=/tmp/directory/file
|
||||
|
||||
yields in the ISO image
|
||||
yields in the ISO image:
|
||||
|
||||
/with_=_and_\/file
|
||||
|
||||
@ -1425,15 +1444,15 @@ File: xorrisofs.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: T
|
||||
(line 95)
|
||||
* --efi-boot El Torito EFI boot image: Bootable. (line 58)
|
||||
* --embedded-boot Fill System Area e.g. by MBR: SystemArea. (line 27)
|
||||
* --emul-toc enable table-of-content emulation: SetProduct. (line 29)
|
||||
* --emul-toc enable table-of-content emulation: SetProduct. (line 35)
|
||||
* --for_backup Enable backup fidelity: SetExtras. (line 24)
|
||||
* --hardlinks Recording of hardlink relations: SetExtras. (line 47)
|
||||
* --md5 Recording of MD5 checksums: SetExtras. (line 39)
|
||||
* --modification-date set ISO image timestamps: ImageId. (line 82)
|
||||
* --no-emul-toc no table-of-content emulation: SetProduct. (line 38)
|
||||
* --no-emul-toc no table-of-content emulation: SetProduct. (line 44)
|
||||
* --no_rc do not execute startup files: Miscellaneous. (line 16)
|
||||
* --old-empty old block addresses for empty files: SetProduct.
|
||||
(line 75)
|
||||
(line 81)
|
||||
* --old-root-devno enable disk idevno with -old-root: SetInsert.
|
||||
(line 97)
|
||||
* --old-root-no-ino disable disk ino with -old-root: SetInsert.
|
||||
@ -1444,9 +1463,9 @@ File: xorrisofs.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: T
|
||||
* --quoted_path_list read pathspecs from disk file: SetInsert.
|
||||
(line 13)
|
||||
* --scdbackup_tag Recording of MD5 checksum: SetExtras. (line 56)
|
||||
* --sort-weight set output file address: SetProduct. (line 43)
|
||||
* --sort-weight set output file address: SetProduct. (line 49)
|
||||
* --stdio_sync control forced output to disk files: SetProduct.
|
||||
(line 19)
|
||||
(line 25)
|
||||
* --xattr Recording of xattr: SetExtras. (line 33)
|
||||
* -A set Application Id: ImageId. (line 38)
|
||||
* -abstract set Abstract File path: ImageId. (line 66)
|
||||
@ -1460,16 +1479,16 @@ File: xorrisofs.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: T
|
||||
* -boot-info-table Patch El Torito boot image: Bootable. (line 80)
|
||||
* -boot-load-size El Torito boot image load size: Bootable. (line 63)
|
||||
* -c El Torito boot catalog name: Bootable. (line 86)
|
||||
* -C set load address and write address offset: Loading. (line 22)
|
||||
* -C set load address and write address offset: Loading. (line 28)
|
||||
* -cdrecord-params set load address and write address offset: Loading.
|
||||
(line 37)
|
||||
(line 43)
|
||||
* -checksum_algorithm_iso choose .jigdo checksums: Jigdo. (line 80)
|
||||
* -checksum_algorithm_template choose .template checksums: Jigdo.
|
||||
(line 87)
|
||||
* -copyright set Copyright File path: ImageId. (line 77)
|
||||
* -d omit trailing dot in ISO file names: SetCompl. (line 50)
|
||||
* -dev set path for loading existing ISO image: Loading. (line 19)
|
||||
* -dir-mode permissions for all directories: SetProduct. (line 54)
|
||||
* -dev set path for loading existing ISO image: Loading. (line 25)
|
||||
* -dir-mode permissions for all directories: SetProduct. (line 60)
|
||||
* -disallow_dir_id_ext enforce ISO level 1 directory names: SetCompl.
|
||||
(line 24)
|
||||
* -e El Torito EFI boot image: Bootable. (line 50)
|
||||
@ -1481,7 +1500,7 @@ File: xorrisofs.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: T
|
||||
* -exclude-list exclude disk files from inserting: SetInsert.
|
||||
(line 51)
|
||||
* -f follow symbolic links on disk: SetInsert. (line 24)
|
||||
* -file-mode permissions for all data files: SetProduct. (line 60)
|
||||
* -file-mode permissions for all data files: SetProduct. (line 66)
|
||||
* -follow-links follow symbolic links on disk: SetInsert. (line 28)
|
||||
* -full-iso9660-filenames allow 37 characters in ISO file names: SetCompl.
|
||||
(line 61)
|
||||
@ -1516,7 +1535,7 @@ File: xorrisofs.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: T
|
||||
* -joliet-long allow longer Joliet names: SetExtras. (line 72)
|
||||
* -l allow 37 characters in ISO file names: SetCompl. (line 57)
|
||||
* -m exclude disk files from inserting: SetInsert. (line 35)
|
||||
* -M set path for loading existing ISO image: Loading. (line 10)
|
||||
* -M set path for loading existing ISO image: Loading. (line 11)
|
||||
* -max-iso9660-filenames allow 37 characters in ISO file names: SetCompl.
|
||||
(line 64)
|
||||
* -md5-list set path of readable .md5: Jigdo. (line 73)
|
||||
@ -1524,7 +1543,7 @@ File: xorrisofs.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: T
|
||||
* -mipsel-boot MIPS Little Endian boot image: SystemArea. (line 111)
|
||||
* -N omit version number in ISO file names: SetCompl. (line 67)
|
||||
* -no-emul-boot El Torito boot image emulation: Bootable. (line 72)
|
||||
* -no-pad do not add zeros to ISO tree: SetProduct. (line 70)
|
||||
* -no-pad do not add zeros to ISO tree: SetProduct. (line 76)
|
||||
* -o set output file address: SetProduct. (line 8)
|
||||
* -old-exclude exclude disk files from inserting: SetInsert.
|
||||
(line 48)
|
||||
@ -1533,12 +1552,12 @@ File: xorrisofs.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: T
|
||||
(line 54)
|
||||
* -omit-version-number omit version number in ISO file names: SetCompl.
|
||||
(line 71)
|
||||
* -output set output file address: SetProduct. (line 16)
|
||||
* -output set output file address: SetProduct. (line 22)
|
||||
* -output-charset set character set of ISO file names: Charset.
|
||||
(line 21)
|
||||
* -p set Preparer Id: ImageId. (line 54)
|
||||
* -p set Publisher Id: ImageId. (line 30)
|
||||
* -pad add 300 KiB of zeros to ISO tree: SetProduct. (line 63)
|
||||
* -pad add 300 KiB of zeros to ISO tree: SetProduct. (line 69)
|
||||
* -partition_cyl_align Image size alignment: SystemArea. (line 75)
|
||||
* -partition_hd_cyl MBR heads per cylinder: SystemArea. (line 58)
|
||||
* -partition_offset Make mountable by partition 1: SystemArea.
|
||||
@ -1547,7 +1566,7 @@ File: xorrisofs.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: T
|
||||
* -path-list read pathspecs from disk file: SetInsert. (line 8)
|
||||
* -preparer set Preparer Id: ImageId. (line 63)
|
||||
* -prev-session set path for loading existing ISO image: Loading.
|
||||
(line 16)
|
||||
(line 22)
|
||||
* -print-size predict ISO image size: Miscellaneous. (line 8)
|
||||
* -publisher set Publisher Id: ImageId. (line 35)
|
||||
* -quiet suppress most messages: Miscellaneous. (line 24)
|
||||
@ -1590,7 +1609,7 @@ File: xorrisofs.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
|
||||
* Application Id, set, -A, -appid: ImageId. (line 38)
|
||||
* Backup, enable fidelity, --for_backup: SetExtras. (line 24)
|
||||
* Biblio File, set path, -biblio: ImageId. (line 72)
|
||||
* Block address, set sort weight, --sort-weight: SetProduct. (line 43)
|
||||
* Block address, set sort weight, --sort-weight: SetProduct. (line 49)
|
||||
* Bootability, boot catalog hidden, --boot-catalog-hide: Bootable.
|
||||
(line 95)
|
||||
* Bootability, boot catalog name, -c, -eltorito-catalog: Bootable.
|
||||
@ -1630,7 +1649,7 @@ File: xorrisofs.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
|
||||
* ECMA-119, _definiton: Standards. (line 6)
|
||||
* El Torito, _definiton: Bootable. (line 13)
|
||||
* Examples: Examples. (line 6)
|
||||
* Forced output, control, --stdio_sync: SetProduct. (line 19)
|
||||
* Forced output, control, --stdio_sync: SetProduct. (line 25)
|
||||
* Hiding, from ISO and Rock Ridge, -hide: SetHide. (line 8)
|
||||
* Hiding, from ISO and Rock Ridge, -hide-list: SetHide. (line 16)
|
||||
* Hiding, from Joliet, -hide-joliet: SetHide. (line 20)
|
||||
@ -1644,7 +1663,7 @@ File: xorrisofs.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
|
||||
(line 97)
|
||||
* Incremental insertion, enable, -old-root: SetInsert. (line 70)
|
||||
* ISO 9660, _definiton: Standards. (line 6)
|
||||
* ISO 9660:1999, _definiton: Standards. (line 21)
|
||||
* ISO 9660:1999, _definiton: Standards. (line 26)
|
||||
* ISO file names, allow 37 characters, -l, -full-iso9660-filenames, -max-iso9660-filenames: SetCompl.
|
||||
(line 57)
|
||||
* ISO file names, allow lowercase, -allow-lowercase: SetCompl.
|
||||
@ -1676,7 +1695,7 @@ File: xorrisofs.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
|
||||
* Jigdo Template Extraction, -jigdo-template-compress: Jigdo. (line 76)
|
||||
* Jigdo Template Extraction, -md5-list: Jigdo. (line 73)
|
||||
* Jigdo Template Extraction, _definition: Jigdo. (line 6)
|
||||
* Joliet, _definiton: Standards. (line 16)
|
||||
* Joliet, _definiton: Standards. (line 21)
|
||||
* Joliet, allows longer names, -joliet-long: SetExtras. (line 72)
|
||||
* Joliet, enable, -J, -joliet: SetExtras. (line 65)
|
||||
* Links, follow on disk, -f, -follow-links: SetInsert. (line 24)
|
||||
@ -1690,31 +1709,31 @@ File: xorrisofs.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
|
||||
(line 46)
|
||||
* Options, list, -help: Miscellaneous. (line 20)
|
||||
* Output file, set address, -o, -output: SetProduct. (line 8)
|
||||
* Padding, 300 KiB, -pad: SetProduct. (line 63)
|
||||
* Padding, disable, --old-empty: SetProduct. (line 75)
|
||||
* Padding, disable, -no-pad: SetProduct. (line 70)
|
||||
* Padding, 300 KiB, -pad: SetProduct. (line 69)
|
||||
* Padding, disable, --old-empty: SetProduct. (line 81)
|
||||
* Padding, disable, -no-pad: SetProduct. (line 76)
|
||||
* pathspec, _definition: Insert. (line 11)
|
||||
* pathspec, enable target=source, -graft-points: SetInsert. (line 31)
|
||||
* pathspec, read list of, --quoted_path_list: SetInsert. (line 13)
|
||||
* pathspec, read list of, -path-list: SetInsert. (line 8)
|
||||
* Permissions, for all data files, -file-mode: SetProduct. (line 60)
|
||||
* Permissions, for all directories, -dir-mode: SetProduct. (line 54)
|
||||
* Permissions, for all data files, -file-mode: SetProduct. (line 66)
|
||||
* Permissions, for all directories, -dir-mode: SetProduct. (line 60)
|
||||
* Preparer Id, set, -p: ImageId. (line 54)
|
||||
* Program version, report, -version: Miscellaneous. (line 34)
|
||||
* Publisher Id, set, -p, -publisher: ImageId. (line 30)
|
||||
* Rock Ridge, (always enabled), -R, -rock: SetExtras. (line 8)
|
||||
* Rock Ridge, _definiton: Standards. (line 9)
|
||||
* Rock Ridge, _definiton: Standards. (line 14)
|
||||
* Rock Ridge, altered owner and permission, -r, -rational-rock: SetExtras.
|
||||
(line 15)
|
||||
* scdbackup, record checksum tag, --scdbackup_tag: SetExtras. (line 56)
|
||||
* Session, select path, -M, -prev-session, -dev: Loading. (line 10)
|
||||
* Session, select path, -M, -prev-session, -dev: Loading. (line 11)
|
||||
* Session, set load and write address, -C, -cdrecord-params: Loading.
|
||||
(line 22)
|
||||
(line 28)
|
||||
* Startup files, suppress, --no_rc: Miscellaneous. (line 16)
|
||||
* System Area, _definiton: SystemArea. (line 6)
|
||||
* System Id, set, -sysid: ImageId. (line 49)
|
||||
* Table-of-content, emulation off, --no-emul-toc: SetProduct. (line 38)
|
||||
* Table-of-content, emulation, --emul-toc: SetProduct. (line 29)
|
||||
* Table-of-content, emulation off, --no-emul-toc: SetProduct. (line 44)
|
||||
* Table-of-content, emulation, --emul-toc: SetProduct. (line 35)
|
||||
* Verbosity, high, -v, -verbose: Miscellaneous. (line 28)
|
||||
* Volume Id, set, -V, -volid: ImageId. (line 13)
|
||||
* Volume Set Id, set, -volset: ImageId. (line 26)
|
||||
@ -1728,35 +1747,35 @@ File: xorrisofs.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
|
||||
|
||||
Tag Table:
|
||||
Node: Top397
|
||||
Node: Overview1053
|
||||
Node: Xorriso1487
|
||||
Node: Standards2621
|
||||
Node: Insert4024
|
||||
Node: Options5445
|
||||
Node: Loading6161
|
||||
Node: SetInsert7792
|
||||
Node: SetProduct12194
|
||||
Node: SetCompl15533
|
||||
Node: SetExtras17852
|
||||
Node: SetHide20580
|
||||
Node: ImageId21588
|
||||
Node: Bootable25092
|
||||
Node: SystemArea29172
|
||||
Node: Charset35532
|
||||
Node: Jigdo36557
|
||||
Node: Miscellaneous40838
|
||||
Node: Examples42011
|
||||
Node: ExSimple42497
|
||||
Node: ExGraft42976
|
||||
Node: ExMkisofs44221
|
||||
Node: ExGrowisofs45146
|
||||
Node: ExIncBackup46127
|
||||
Node: ExIncBckAcc49017
|
||||
Node: ExBootable50533
|
||||
Node: Files52489
|
||||
Node: Seealso53559
|
||||
Node: Legal54074
|
||||
Node: CommandIdx54870
|
||||
Node: ConceptIdx66203
|
||||
Node: Overview1052
|
||||
Node: Standards1488
|
||||
Node: Insert3163
|
||||
Node: Xorriso4584
|
||||
Node: Options5720
|
||||
Node: Loading6437
|
||||
Node: SetInsert8474
|
||||
Node: SetProduct12876
|
||||
Node: SetCompl16583
|
||||
Node: SetExtras18902
|
||||
Node: SetHide21630
|
||||
Node: ImageId22638
|
||||
Node: Bootable26142
|
||||
Node: SystemArea30222
|
||||
Node: Charset36582
|
||||
Node: Jigdo37607
|
||||
Node: Miscellaneous41888
|
||||
Node: Examples43061
|
||||
Node: ExSimple43547
|
||||
Node: ExGraft44026
|
||||
Node: ExMkisofs45273
|
||||
Node: ExGrowisofs46198
|
||||
Node: ExIncBackup47179
|
||||
Node: ExIncBckAcc50069
|
||||
Node: ExBootable51585
|
||||
Node: Files53541
|
||||
Node: Seealso54611
|
||||
Node: Legal55126
|
||||
Node: CommandIdx55922
|
||||
Node: ConceptIdx67255
|
||||
|
||||
End Tag Table
|
||||
|
||||
@ -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
|
||||
|
||||
Loading…
Reference in New Issue
Block a user