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

Updated generated manuals

Browse Source
This commit is contained in:
Thomas Schmitt 2011-05-17 09:42:51 +00:00
parent f855071fb7
commit f3936045de
4 changed files with 225 additions and 157 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
xorriso/xorriso.1
View File

@ -4625,6 +4625,18 @@ ACL and xattr
.TP .TP
MD5 checksums MD5 checksums
.BR md5sum(1) .BR md5sum(1)
.SH BUGS
To report bugs or to suggest enhancements for \fBxorriso\fR, please
send electronic mail to the public lists <bug\-xorriso@gnu.org>
or <libburn\-hackers@pykix.org>. If more privacy is desired, mail
to <scdbackup@gmx.net>.
.br
Please describe what you expect \fBxorriso\fR to do,
the program arguments resp. commands by which you tried to achieve it,
the messages of \fBxorriso\fR, and the undesirable outcome of your
program run.
.br
Expect to get asked more questions before solutions can be proposed.
.SH AUTHOR .SH AUTHOR
Thomas Schmitt <scdbackup@gmx.net> Thomas Schmitt <scdbackup@gmx.net>
.br .br

141
xorriso/xorriso.info
View File

@ -35,6 +35,7 @@ images with Rock Ridge extensions.
* Examples:: Examples * Examples:: Examples
* Files:: Files * Files:: Files
* Seealso:: See also * Seealso:: See also
* Bugreport:: Reporting bugs
* Legal:: Author, Copyright, Credits * Legal:: Author, Copyright, Credits
* CommandIdx:: Alphabetic Command List * CommandIdx:: Alphabetic Command List
* ConceptIdx:: Alphabetic List of Concepts and Objects * ConceptIdx:: Alphabetic List of Concepts and Objects
@ -4072,7 +4073,7 @@ The default setting of -check_media abort_file= is:
/var/opt/xorriso/do_abort_check_media /var/opt/xorriso/do_abort_check_media
 
File: xorriso.info, Node: Seealso, Next: Legal, Prev: Files, Up: Top File: xorriso.info, Node: Seealso, Next: Bugreport, Prev: Files, Up: Top
12 See also 12 See also
*********** ***********
@ -4099,18 +4100,35 @@ MD5 checksums
md5sum(1) md5sum(1)
 
File: xorriso.info, Node: Legal, Next: CommandIdx, Prev: Seealso, Up: Top File: xorriso.info, Node: Bugreport, Next: Legal, Prev: Seealso, Up: Top
13 Author, Copyright, Credits 13 Reporting bugs
*****************
To report bugs or to suggest enhancements for `xorriso', please send
electronic mail to the public lists <bug-xorriso@gnu.org> or
<libburn-hackers@pykix.org>. If more privacy is desired, mail to
<scdbackup@gmx.net>.
Please describe what you expect `xorriso' to do, the program arguments
resp. commands by which you tried to achieve it, the messages of
`xorriso', and the undesirable outcome of your program run.
Expect to get asked more questions before solutions can be proposed.

File: xorriso.info, Node: Legal, Next: CommandIdx, Prev: Bugreport, Up: Top
14 Author, Copyright, Credits
***************************** *****************************
13.1 Author 14.1 Author
=========== ===========
Thomas Schmitt <scdbackup@gmx.net> Thomas Schmitt <scdbackup@gmx.net>
for libburnia-project.org for libburnia-project.org
13.2 Copyright 14.2 Copyright
============== ==============
Copyright (c) 2007 - 2011 Thomas Schmitt Copyright (c) 2007 - 2011 Thomas Schmitt
@ -4119,7 +4137,7 @@ modified in sync with the technical properties of `xorriso'. If you
make use of the license to derive modified versions of `xorriso' then make use of the license to derive modified versions of `xorriso' then
you are entitled to modify this text under that same license. you are entitled to modify this text under that same license.
13.3 Credits 14.3 Credits
============ ============
`xorriso' is in part based on work by Vreixo Formoso who provides `xorriso' is in part based on work by Vreixo Formoso who provides
@ -4132,7 +4150,7 @@ years.
 
File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
14 Alphabetic Command List 15 Alphabetic Command List
************************** **************************
[index] [index]
@ -4341,7 +4359,7 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
 
File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
15 Alphabetic List of Concepts and Objects 16 Alphabetic List of Concepts and Objects
****************************************** ******************************************
[index] [index]
@ -4363,6 +4381,7 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Blank media, _definition: Media. (line 29) * Blank media, _definition: Media. (line 29)
* Blind growing, _definition: Methods. (line 40) * Blind growing, _definition: Methods. (line 40)
* Bootability, control, -boot_image: Bootable. (line 26) * Bootability, control, -boot_image: Bootable. (line 26)
* Bugs, reporting: Bugreport. (line 6)
* cdrecord, Emulation: Emulation. (line 111) * cdrecord, Emulation: Emulation. (line 111)
* Character Set, _definition: Charset. (line 6) * Character Set, _definition: Charset. (line 6)
* Character Set, for input, -in_charset: Loading. (line 92) * Character Set, for input, -in_charset: Loading. (line 92)
@ -4504,6 +4523,7 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Pattern expansion, for ISO paths, -iso_rr_pattern: Manip. (line 10) * Pattern expansion, for ISO paths, -iso_rr_pattern: Manip. (line 10)
* Permissions, in ISO image, -chmod: Manip. (line 58) * Permissions, in ISO image, -chmod: Manip. (line 58)
* Permissions, in ISO image, -chmod_r: Manip. (line 70) * Permissions, in ISO image, -chmod_r: Manip. (line 70)
* Problems, reporting: Bugreport. (line 6)
* Process, consolidate text output, -pkt_output: Frontend. (line 7) * Process, consolidate text output, -pkt_output: Frontend. (line 7)
* Process, control abort on error, -abort_on: Exception. (line 27) * Process, control abort on error, -abort_on: Exception. (line 27)
* Process, control exit value, -return_with: Exception. (line 39) * Process, control exit value, -return_with: Exception. (line 39)
@ -4596,57 +4616,58 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
 
Tag Table: Tag Table:
Node: Top420 Node: Top420
Node: Overview1336 Node: Overview1375
Node: Model3225 Node: Model3264
Node: Media6111 Node: Media6150
Node: Methods8773 Node: Methods8812
Node: Drives11331 Node: Drives11370
Node: Extras14639 Node: Extras14678
Node: Processing18128 Node: Processing18167
Node: Dialog21628 Node: Dialog21667
Node: Options23291 Node: Options23330
Node: AqDrive24899 Node: AqDrive24938
Node: Loading27807 Node: Loading27846
Node: Insert42143 Node: Insert42182
Node: SetInsert51762 Node: SetInsert51801
Node: Manip60336 Node: Manip60375
Node: CmdFind69021 Node: CmdFind69060
Node: Filter80324 Node: Filter80363
Node: Writing84681 Node: Writing84720
Node: SetWrite90979 Node: SetWrite91018
Node: Bootable105025 Node: Bootable105064
Node: Jigdo118345 Node: Jigdo118384
Node: Charset122609 Node: Charset122648
Node: Exception125368 Node: Exception125407
Node: DialogCtl131508 Node: DialogCtl131547
Node: Inquiry134095 Node: Inquiry134134
Node: Navigate138478 Node: Navigate138517
Node: Verify146418 Node: Verify146457
Node: Restore155013 Node: Restore155052
Node: Emulation161673 Node: Emulation161712
Node: Scripting171546 Node: Scripting171585
Node: Frontend177696 Node: Frontend177735
Node: Examples178995 Node: Examples179034
Node: ExDevices180166 Node: ExDevices180205
Node: ExCreate180804 Node: ExCreate180843
Node: ExDialog182078 Node: ExDialog182117
Node: ExGrowing183340 Node: ExGrowing183379
Node: ExModifying184142 Node: ExModifying184181
Node: ExBootable184643 Node: ExBootable184682
Node: ExCharset185192 Node: ExCharset185231
Node: ExPseudo186020 Node: ExPseudo186059
Node: ExCdrecord186918 Node: ExCdrecord186957
Node: ExMkisofs187233 Node: ExMkisofs187272
Node: ExGrowisofs188571 Node: ExGrowisofs188610
Node: ExException189706 Node: ExException189745
Node: ExTime190160 Node: ExTime190199
Node: ExIncBackup190619 Node: ExIncBackup190658
Node: ExRestore194543 Node: ExRestore194582
Node: ExRecovery195512 Node: ExRecovery195551
Node: Files196078 Node: Files196117
Node: Seealso197376 Node: Seealso197415
Node: Legal197960 Node: Bugreport198003
Node: CommandIdx198888 Node: Legal198604
Node: ConceptIdx213556 Node: CommandIdx199534
Node: ConceptIdx214202
 
End Tag Table End Tag Table

52
xorriso/xorrisofs.1
View File

@ -36,7 +36,7 @@ produces Rock Ridge enhanced ISO 9660 filesystems and add\-on sessions to
such filesystems. Optionally it can produce Joliet directory trees too. such filesystems. Optionally it can produce Joliet directory trees too.
.br .br
.PP .PP
xorrisofs understands options of program mkisofs from cdrtools by \fBxorrisofs\fR understands options of program mkisofs from cdrtools by
Joerg Schilling. Joerg Schilling.
Its implementation is part of program xorriso which shares no source Its implementation is part of program xorriso which shares no source
code with cdrtools. code with cdrtools.
@ -60,7 +60,8 @@ with ownership, access permissions, symbolic links, and other attributes.
Rock Ridge allows filenames of up to 255 bytes and paths of up to Rock Ridge allows filenames of up to 255 bytes and paths of up to
1024 bytes. 1024 bytes.
.br .br
Rock Ridge information is produced unconditionally with any xorrisofs image. Rock Ridge information is produced unconditionally with any \fBxorrisofs\fR
image.
.br .br
\fBJoliet\fR \fBJoliet\fR
is the name of an additional directory tree which provides is the name of an additional directory tree which provides
@ -79,7 +80,7 @@ Production of this directory tree may be enabled by option \-iso\-level 4.
.SS .SS
.B Inserting files into the ISO image: .B Inserting files into the ISO image:
.PP .PP
xorrisofs deals with two kinds of file addresses: \fBxorrisofs\fR deals with two kinds of file addresses:
.br .br
\fBdisk_path\fR \fBdisk_path\fR
is a path to an object in the local filesystem tree. is a path to an object in the local filesystem tree.
@ -90,7 +91,7 @@ confuse with the lowlevel ISO 9660 names visible if Rock Ridge gets ignored.)
.br .br
.PP .PP
A program argument is handled as a \fBpathspec\fR, if it is not A program argument is handled as a \fBpathspec\fR, if it is not
recognized as original mkisofs option or additional xorrisofs option. recognized as original mkisofs option or additional \fBxorrisofs\fR option.
A pathspec depicts an input file object by a disk_path. A pathspec depicts an input file object by a disk_path.
If option \-graft\-points is not present, then the behavior depends on the If option \-graft\-points is not present, then the behavior depends on the
file type of disk_path. Directories get merged with the /\-directory of the file type of disk_path. Directories get merged with the /\-directory of the
@ -119,7 +120,7 @@ Non\-directories may not overwrite existing directories.
.SS .SS
\fBRelation to program xorriso:\fR \fBRelation to program xorriso:\fR
.br .br
xorrisofs is actually a command mode of program \fBxorriso\fR, \fBxorrisofs\fR is actually a command mode of program \fBxorriso\fR,
which gets entered either by xorriso command "\-as mkisofs" or by which gets entered either by xorriso command "\-as mkisofs" or by
starting the program by one of the names "xorrisofs", "mkisofs", starting the program by one of the names "xorrisofs", "mkisofs",
"genisoimage", or "genisofs". "genisoimage", or "genisofs".
@ -136,7 +137,7 @@ 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 supported for reading are reported as "blank". The reported free media
space may be quite fictional. space may be quite fictional.
.br .br
Nevertheless xorrisofs does not operate directly on optical drives, Nevertheless \fBxorrisofs\fR does not operate directly on optical drives,
but rather forces libburn to regard them as general device files. 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) 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. one will have to use a burn program. E.g the cdrecord emulation of xorriso.
@ -472,8 +473,8 @@ Alias of \-N.
.TP .TP
\fB\-R\fR \fB\-R\fR
.br .br
With mkisofs this option enables Rock Ridge extensions. xorrisofs produces With mkisofs this option enables Rock Ridge extensions. \fBxorrisofs\fR
them unconditionally. produces them unconditionally.
.TP .TP
\fB\-rock\fR \fB\-rock\fR
.br .br
@ -676,7 +677,7 @@ The precondition for a bootable ISO image is to have in the ISO image
the files of a boot loader. The boot facilities of computers get the files of a boot loader. The boot facilities of computers get
directed to such files, which usually execute further program files directed to such files, which usually execute further program files
from the ISO image. from the ISO image.
xorrisofs can produce several kinds of boot block or boot record, \fBxorrisofs\fR can produce several kinds of boot block or boot record,
which become part of the ISO image, and get interpreted by the according which become part of the ISO image, and get interpreted by the according
boot facility. boot facility.
.br .br
@ -695,7 +696,7 @@ El Torito gets interpreted by boot facilities PC\-BIOS and EFI.
Most bootable GNU/Linux CDs are equipped with ISOLINUX or GRUB boot images Most bootable GNU/Linux CDs are equipped with ISOLINUX or GRUB boot images
for PC\-BIOS. for PC\-BIOS.
.br .br
xorrisofs supports the example options out of the ISOLINUX wiki, \fBxorrisofs\fR supports the example options out of the ISOLINUX wiki,
the options used in GRUB script grub\-mkrescue, and the example in the the options used in GRUB script grub\-mkrescue, and the example in the
FreeBSD AvgLiveCD wiki. FreeBSD AvgLiveCD wiki.
.br .br
@ -781,7 +782,7 @@ a MBR for booting via PC\-BIOS from USB stick or hard disk.
A \fBMBR\fR (Master Boot Record) contains boot code and a partition table. A \fBMBR\fR (Master Boot Record) contains boot code and a partition table.
It does not hamper El Torito booting from CDROM. It does not hamper El Torito booting from CDROM.
.br .br
xorrisofs supports boot facilities other than PC\-BIOS: \fBxorrisofs\fR supports boot facilities other than PC\-BIOS:
MIPS Big Endian (SGI), MIPS Little Endian (DEC), SUN SPARC. MIPS Big Endian (SGI), MIPS Little Endian (DEC), SUN SPARC.
Those are mutually not combinable and also not combinable with MBR. Those are mutually not combinable and also not combinable with MBR.
.br .br
@ -942,7 +943,7 @@ and DVD ISO images are published on the web in jigdo format to allow
end users to download them more efficiently." end users to download them more efficiently."
.br .br
If the use of libjte was enabled at compile time of xorriso, then If the use of libjte was enabled at compile time of xorriso, then
xorrisofs can produce a .jigdo and a .template file together with a \fBxorrisofs\fR can produce a .jigdo and a .template file together with a
single\-session ISO image. If not, then Jigdo options will cause a single\-session ISO image. If not, then Jigdo options will cause a
FAILURE event, which normally leads to program abort. FAILURE event, which normally leads to program abort.
.br .br
@ -955,7 +956,8 @@ The .jigdo file contains checksums and symbolic file addresses.
The .template file contains the compressed ISO image with reference tags The .template file contains the compressed ISO image with reference tags
instead of the content bytes of the listed files. instead of the content bytes of the listed files.
.br .br
Input for this process are the normal arguments for a xorrisofs session Input for this process are the normal arguments for a \fBxorrisofs\fR
session
with no image loaded, and a .md5 file which lists those data files which may be with no image loaded, and a .md5 file which lists those data files which may be
listed in the .jigdo file and externally referenced in the .template file. listed in the .jigdo file and externally referenced in the .template file.
Each designated file is represented in the .md5 file by a single text line: Each designated file is represented in the .md5 file by a single text line:
@ -1362,7 +1364,7 @@ to copy all desired files underneath that directory. Especially file
isolinux.bin shall be copied to ./CD_root/isolinux/isolinux.bin . isolinux.bin shall be copied to ./CD_root/isolinux/isolinux.bin .
This is the boot image file. This is the boot image file.
.br .br
The prescribed mkisofs options can be used unchanged with xorrisofs: The prescribed mkisofs options can be used unchanged with \fBxorrisofs\fR:
.br .br
$ xorrisofs \-o output.iso \\ $ xorrisofs \-o output.iso \\
.br .br
@ -1422,7 +1424,7 @@ Now copy the image onto it
.SS .SS
.B Startup files: .B Startup files:
.br .br
If not \-\-no_rc is given as the first argument then xorrisofs If not \-\-no_rc is given as the first argument then \fBxorrisofs\fR
attempts on startup to read and execute lines from the following files: attempts on startup to read and execute lines from the following files:
.br .br
/etc/default/xorriso /etc/default/xorriso
@ -1434,8 +1436,8 @@ attempts on startup to read and execute lines from the following files:
$HOME/.xorrisorc $HOME/.xorrisorc
.br .br
The files are read in the sequence given here, but none of them is required The files are read in the sequence given here, but none of them is required
to exist. The lines are not interpreted as xorrisofs options but as generic to exist. The lines are not interpreted as \fBxorrisofs\fR options but
xorriso commands. See man xorriso. as generic xorriso commands. See man xorriso.
.PP .PP
After the xorriso startup files, the program tries one by one to open for After the xorriso startup files, the program tries one by one to open for
reading: reading:
@ -1492,6 +1494,18 @@ ACL and xattr
.TP .TP
MD5 checksums MD5 checksums
.BR md5sum(1) .BR md5sum(1)
.SH BUGS
To report bugs or to suggest enhancements for \fBxorriso\fR, please
send electronic mail to the public lists <bug\-xorriso@gnu.org>
or <libburn\-hackers@pykix.org>. If more privacy is desired, mail
to <scdbackup@gmx.net>.
.br
Please describe what you expect \fBxorriso\fR to do,
the program arguments resp. commands by which you tried to achieve it,
the messages of \fBxorriso\fR, and the undesirable outcome of your
program run.
.br
Expect to get asked more questions before solutions can be proposed.
.SH AUTHOR .SH AUTHOR
Thomas Schmitt <scdbackup@gmx.net> Thomas Schmitt <scdbackup@gmx.net>
.br .br
@ -1504,7 +1518,7 @@ modified in sync with the technical properties of xorriso. If you make use
of the license to derive modified versions of xorriso then you are entitled of the license to derive modified versions of xorriso then you are entitled
to modify this text under that same license. to modify this text under that same license.
.SH CREDITS .SH CREDITS
xorrisofs is in part based on work by Vreixo Formoso who provides libisofs \fBxorrisofs\fR is in part based on work by Vreixo Formoso who provides
together with Mario Danic who also leads the libburnia team. libisofs together with Mario Danic who also leads the libburnia team.
.br .br
Compliments towards Joerg Schilling whose cdrtools served me for ten years. Compliments towards Joerg Schilling whose cdrtools served me for ten years.

177
xorriso/xorrisofs.info
View File

@ -29,6 +29,7 @@ xorrisofs - Emulation of ISO 9660 program mkisofs by program xorriso
* Examples:: Examples * Examples:: Examples
* Files:: Files * Files:: Files
* Seealso:: See also * Seealso:: See also
* Bugreport:: Reporting bugs
* Legal:: Author, Copyright, Credits * Legal:: Author, Copyright, Credits
* CommandIdx:: Alphabetic Command List * CommandIdx:: Alphabetic Command List
* ConceptIdx:: Alphabetic List of Concepts and Objects * ConceptIdx:: Alphabetic List of Concepts and Objects
@ -39,13 +40,13 @@ File: xorrisofs.info, Node: Overview, Next: Standards, Prev: Top, Up: Top
1 Overview 1 Overview
********** **********
*xorrisofs* produces Rock Ridge enhanced ISO 9660 filesystems and `xorrisofs' produces Rock Ridge enhanced ISO 9660 filesystems and
add-on sessions to such filesystems. Optionally it can produce Joliet add-on sessions to such filesystems. Optionally it can produce Joliet
directory trees too. directory trees too.
xorrisofs understands options of program mkisofs from cdrtools by Joerg `xorrisofs' understands options of program mkisofs from cdrtools by
Schilling. Its implementation is part of program xorriso which shares Joerg Schilling. Its implementation is part of program xorriso which
no source code with cdrtools. shares no source code with cdrtools.
 
File: xorrisofs.info, Node: Standards, Next: Insert, Prev: Overview, Up: Top File: xorrisofs.info, Node: Standards, Next: Insert, Prev: Overview, Up: Top
@ -66,7 +67,7 @@ enhance an ISO 9660 filesystem so that it can represent a POSIX
compliant filesystem with ownership, access permissions, symbolic compliant filesystem with ownership, access permissions, symbolic
links, and other attributes. Rock Ridge allows filenames of up to 255 links, and other attributes. Rock Ridge allows filenames of up to 255
bytes and paths of up to 1024 bytes. bytes and paths of up to 1024 bytes.
Rock Ridge information is produced unconditionally with any xorrisofs Rock Ridge information is produced unconditionally with any `xorrisofs'
image. image.
*Joliet* is the name of an additional directory tree which provides *Joliet* is the name of an additional directory tree which provides
filenames up to 64 characters encoded as UTF-16. A Joliet tree is filenames up to 64 characters encoded as UTF-16. A Joliet tree is
@ -86,18 +87,18 @@ File: xorrisofs.info, Node: Insert, Next: Xorriso, Prev: Standards, Up: Top
3 Inserting files into the ISO image 3 Inserting files into the ISO image
************************************ ************************************
xorrisofs deals with two kinds of file addresses: `xorrisofs' deals with two kinds of file addresses:
*disk_path* is a path to an object in the local filesystem tree. *disk_path* is a path to an object in the local filesystem tree.
*iso_rr_path* is the Rock Ridge address of a file object in the ISO *iso_rr_path* is the Rock Ridge address of a file object in the ISO
image. (Do not confuse with the lowlevel ISO 9660 names visible if Rock image. (Do not confuse with the lowlevel ISO 9660 names visible if Rock
Ridge gets ignored.) Ridge gets ignored.)
A program argument is handled as a *pathspec*, if it is not recognized A program argument is handled as a *pathspec*, if it is not recognized
as original mkisofs option or additional xorrisofs option. A pathspec as original mkisofs option or additional `xorrisofs' option. A
depicts an input file object by a disk_path. If option -graft-points pathspec depicts an input file object by a disk_path. If option
is not present, then the behavior depends on the file type of -graft-points is not present, then the behavior depends on the file
disk_path. Directories get merged with the /-directory of the ISO type of disk_path. Directories get merged with the /-directory of the
image. Files of other types get copied into the /-directory. ISO image. Files of other types get copied into the /-directory.
If -graft-points is present then each pathspec gets split at the first If -graft-points is present then each pathspec gets split at the first
occurence of the =-character. The part before the = is taken as occurence of the =-character. The part before the = is taken as
*target*, i.e. the iso_rr_path for the file object in the ISO image. *target*, i.e. the iso_rr_path for the file object in the ISO image.
@ -122,7 +123,7 @@ File: xorrisofs.info, Node: Xorriso, Next: Options, Prev: Insert, Up: Top
4 Relation to program xorriso 4 Relation to program xorriso
***************************** *****************************
xorrisofs is actually a command mode of program *xorriso*, which gets `xorrisofs' is actually a command mode of program *xorriso*, which gets
entered either by xorriso command "-as mkisofs" or by starting the entered either by xorriso command "-as mkisofs" or by starting the
program by one of the names "xorrisofs", "mkisofs", "genisoimage", or program by one of the names "xorrisofs", "mkisofs", "genisoimage", or
"genisofs". "genisofs".
@ -135,11 +136,11 @@ types except directories.
The program messages call any image file a "drive". File types which The program messages call any image file a "drive". File types which
are not supported for reading are reported as "blank". The reported are not supported for reading are reported as "blank". The reported
free media space may be quite fictional. free media space may be quite fictional.
Nevertheless xorrisofs does not operate directly on optical drives, but Nevertheless `xorrisofs' does not operate directly on optical drives,
rather forces libburn to regard them as general device files. So for but rather forces libburn to regard them as general device files. So
writing of sequential optical media (CD, DVD-R, DVD+R, BD-R) one will for writing of sequential optical media (CD, DVD-R, DVD+R, BD-R) one
have to use a burn program. E.g the cdrecord emulation of xorriso. See will have to use a burn program. E.g the cdrecord emulation of xorriso.
EXAMPLES. See EXAMPLES.
 
File: xorrisofs.info, Node: Options, Next: Examples, Prev: Xorriso, Up: Top File: xorrisofs.info, Node: Options, Next: Examples, Prev: Xorriso, Up: Top
@ -490,7 +491,7 @@ File: xorrisofs.info, Node: SetExtras, Next: SetHide, Prev: SetCompl, Up: Op
-R -R
With mkisofs this option enables Rock Ridge extensions. xorrisofs With mkisofs this option enables Rock Ridge extensions. `xorrisofs'
produces them unconditionally. produces them unconditionally.
-rock -rock
@ -686,9 +687,9 @@ File: xorrisofs.info, Node: Bootable, Next: SystemArea, Prev: ImageId, Up: O
The precondition for a bootable ISO image is to have in the ISO image The precondition for a bootable ISO image is to have in the ISO image
the files of a boot loader. The boot facilities of computers get the files of a boot loader. The boot facilities of computers get
directed to such files, which usually execute further program files directed to such files, which usually execute further program files
from the ISO image. xorrisofs can produce several kinds of boot block from the ISO image. `xorrisofs' can produce several kinds of boot
or boot record, which become part of the ISO image, and get interpreted block or boot record, which become part of the ISO image, and get
by the according boot facility. interpreted by the according boot facility.
An *El Torito* boot record points the bootstrapping facility to a boot An *El Torito* boot record points the bootstrapping facility to a boot
catalog with one or more boot images, which are binary program files catalog with one or more boot images, which are binary program files
@ -700,7 +701,7 @@ given and structured by options -b, -e, -el-torito-alt-boot, and
El Torito gets interpreted by boot facilities PC-BIOS and EFI. Most El Torito gets interpreted by boot facilities PC-BIOS and EFI. Most
bootable GNU/Linux CDs are equipped with ISOLINUX or GRUB boot images bootable GNU/Linux CDs are equipped with ISOLINUX or GRUB boot images
for PC-BIOS. for PC-BIOS.
xorrisofs supports the example options out of the ISOLINUX wiki, the `xorrisofs' supports the example options out of the ISOLINUX wiki, the
options used in GRUB script grub-mkrescue, and the example in the options used in GRUB script grub-mkrescue, and the example in the
FreeBSD AvgLiveCD wiki. FreeBSD AvgLiveCD wiki.
@ -787,9 +788,9 @@ facilities of exotic hardware architectures or it may be a MBR for
booting via PC-BIOS from USB stick or hard disk. booting via PC-BIOS from USB stick or hard disk.
A *MBR* (Master Boot Record) contains boot code and a partition table. A *MBR* (Master Boot Record) contains boot code and a partition table.
It does not hamper El Torito booting from CDROM. It does not hamper El Torito booting from CDROM.
xorrisofs supports boot facilities other than PC-BIOS: MIPS Big Endian `xorrisofs' supports boot facilities other than PC-BIOS: MIPS Big
(SGI), MIPS Little Endian (DEC), SUN SPARC. Those are mutually not Endian (SGI), MIPS Little Endian (DEC), SUN SPARC. Those are mutually
combinable and also not combinable with MBR. not combinable and also not combinable with MBR.
-G disk_path -G disk_path
Copy at most 32768 bytes from the given disk file to the very Copy at most 32768 bytes from the given disk file to the very
@ -944,7 +945,7 @@ large files like CD and DVD images; see http://atterer.net/jigdo/ for
more details. Debian CDs and DVD ISO images are published on the web in more details. Debian CDs and DVD ISO images are published on the web in
jigdo format to allow end users to download them more efficiently." jigdo format to allow end users to download them more efficiently."
If the use of libjte was enabled at compile time of xorriso, then If the use of libjte was enabled at compile time of xorriso, then
xorrisofs can produce a .jigdo and a .template file together with a `xorrisofs' can produce a .jigdo and a .template file together with a
single-session ISO image. If not, then Jigdo options will cause a single-session ISO image. If not, then Jigdo options will cause a
FAILURE event, which normally leads to program abort. FAILURE event, which normally leads to program abort.
One may determine the ability for Jigdo by: One may determine the ability for Jigdo by:
@ -954,11 +955,11 @@ $ xorrisofs -version 2>&1 | grep '^libjte' && echo YES
The .jigdo file contains checksums and symbolic file addresses. The The .jigdo file contains checksums and symbolic file addresses. The
.template file contains the compressed ISO image with reference tags .template file contains the compressed ISO image with reference tags
instead of the content bytes of the listed files. instead of the content bytes of the listed files.
Input for this process are the normal arguments for a xorrisofs session Input for this process are the normal arguments for a `xorrisofs'
with no image loaded, and a .md5 file which lists those data files session with no image loaded, and a .md5 file which lists those data
which may be listed in the .jigdo file and externally referenced in the files which may be listed in the .jigdo file and externally referenced
.template file. Each designated file is represented in the .md5 file in the .template file. Each designated file is represented in the .md5
by a single text line: file by a single text line:
MD5 as 32 hex digits, 2 blanks, size as 12 decimal digits or blanks, 2 MD5 as 32 hex digits, 2 blanks, size as 12 decimal digits or blanks, 2
blanks, symbolic file address blanks, symbolic file address
The file address in an .md5 line has to bear the same basename as the The file address in an .md5 line has to bear the same basename as the
@ -1329,7 +1330,7 @@ The ISOLINUX wiki prescribes to create on disk a directory ./CD_root and
to copy all desired files underneath that directory. Especially file to copy all desired files underneath that directory. Especially file
isolinux.bin shall be copied to ./CD_root/isolinux/isolinux.bin . This isolinux.bin shall be copied to ./CD_root/isolinux/isolinux.bin . This
is the boot image file. is the boot image file.
The prescribed mkisofs options can be used unchanged with xorrisofs: The prescribed mkisofs options can be used unchanged with `xorrisofs':
$ xorrisofs -o output.iso \ $ xorrisofs -o output.iso \
-b isolinux/isolinux.bin -c isolinux/boot.cat \ -b isolinux/isolinux.bin -c isolinux/boot.cat \
@ -1382,8 +1383,8 @@ File: xorrisofs.info, Node: Files, Next: Seealso, Prev: Examples, Up: Top
7.1 Startup Files 7.1 Startup Files
================= =================
If not -no_rc is given as the first argument then xorrisofs attempts on If not -no_rc is given as the first argument then `xorrisofs' attempts
startup to read and execute lines from the following files: on startup to read and execute lines from the following files:
/etc/default/xorriso /etc/default/xorriso
/etc/opt/xorriso/rc /etc/opt/xorriso/rc
@ -1391,7 +1392,7 @@ startup to read and execute lines from the following files:
$HOME/.xorrisorc $HOME/.xorrisorc
The files are read in the sequence given here, but none of them is The files are read in the sequence given here, but none of them is
required to exist. The lines are not interpreted as xorrisofs options required to exist. The lines are not interpreted as `xorrisofs' options
but as generic xorriso commands. See man xorriso. After the xorriso but as generic xorriso commands. See man xorriso. After the xorriso
startup files, the program tries one by one to open for reading: startup files, the program tries one by one to open for reading:
@ -1413,7 +1414,7 @@ VOLS default for -volset
Any other lines will be silently ignored. Any other lines will be silently ignored.
 
File: xorrisofs.info, Node: Seealso, Next: Legal, Prev: Files, Up: Top File: xorrisofs.info, Node: Seealso, Next: Bugreport, Prev: Files, Up: Top
8 See also 8 See also
********** **********
@ -1437,19 +1438,36 @@ MD5 checksums
md5sum(1) md5sum(1)
 
File: xorrisofs.info, Node: Legal, Next: CommandIdx, Prev: Seealso, Up: Top File: xorrisofs.info, Node: Bugreport, Next: Legal, Prev: Seealso, Up: Top
9 Author, Copyright, Credits 9 Reporting bugs
**************************** ****************
9.1 Author To report bugs or to suggest enhancements for `xorriso', please send
========== electronic mail to the public lists <bug-xorriso@gnu.org> or
<libburn-hackers@pykix.org>. If more privacy is desired, mail to
<scdbackup@gmx.net>.
Please describe what you expect `xorriso' to do, the program arguments
resp. commands by which you tried to achieve it, the messages of
`xorriso', and the undesirable outcome of your program run.
Expect to get asked more questions before solutions can be proposed.

File: xorrisofs.info, Node: Legal, Next: CommandIdx, Prev: Bugreport, Up: Top
10 Author, Copyright, Credits
*****************************
10.1 Author
===========
Thomas Schmitt <scdbackup@gmx.net> Thomas Schmitt <scdbackup@gmx.net>
for libburnia-project.org for libburnia-project.org
9.2 Copyright 10.2 Copyright
============= ==============
Copyright (c) 2011 Thomas Schmitt Copyright (c) 2011 Thomas Schmitt
Permission is granted to distribute this text freely. It shall only be Permission is granted to distribute this text freely. It shall only be
@ -1457,10 +1475,10 @@ modified in sync with the technical properties of xorriso. If you make
use of the license to derive modified versions of xorriso then you are use of the license to derive modified versions of xorriso then you are
entitled to modify this text under that same license. entitled to modify this text under that same license.
9.3 Credits 10.3 Credits
=========== ============
xorrisofs is in part based on work by Vreixo Formoso who provides `xorrisofs' is in part based on work by Vreixo Formoso who provides
libisofs together with Mario Danic who also leads the libburnia team. libisofs together with Mario Danic who also leads the libburnia team.
Compliments towards Joerg Schilling whose cdrtools served me for ten Compliments towards Joerg Schilling whose cdrtools served me for ten
years. years.
@ -1468,7 +1486,7 @@ years.
 
File: xorrisofs.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top File: xorrisofs.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
10 Alphabetic Command List 11 Alphabetic Command List
************************** **************************
[index] [index]
@ -1633,7 +1651,7 @@ File: xorrisofs.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: T
 
File: xorrisofs.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top File: xorrisofs.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
11 Alphabetic List of Concepts and Objects 12 Alphabetic List of Concepts and Objects
****************************************** ******************************************
[index] [index]
@ -1671,6 +1689,7 @@ File: xorrisofs.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Bootability, patch System Area partition table, --protective-msdos-label: SystemArea. * Bootability, patch System Area partition table, --protective-msdos-label: SystemArea.
(line 41) (line 41)
* Bootability, SUN Disk Label text, -sparc-label: SystemArea. (line 132) * Bootability, SUN Disk Label text, -sparc-label: SystemArea. (line 132)
* Bugs, reporting: Bugreport. (line 6)
* Character Set, for disk file names, -input-charset: Charset. * Character Set, for disk file names, -input-charset: Charset.
(line 17) (line 17)
* Character Set, for ISO file names, -output-charset: Charset. * Character Set, for ISO file names, -output-charset: Charset.
@ -1754,6 +1773,7 @@ File: xorrisofs.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Permissions, for all data files, -file-mode: SetProduct. (line 66) * Permissions, for all data files, -file-mode: SetProduct. (line 66)
* Permissions, for all directories, -dir-mode: SetProduct. (line 60) * Permissions, for all directories, -dir-mode: SetProduct. (line 60)
* Preparer Id, set, -p: ImageId. (line 54) * Preparer Id, set, -p: ImageId. (line 54)
* Problems, reporting: Bugreport. (line 6)
* Program version, report, -version: Miscellaneous. (line 34) * Program version, report, -version: Miscellaneous. (line 34)
* Publisher Id, set, -p, -publisher: ImageId. (line 30) * Publisher Id, set, -p, -publisher: ImageId. (line 30)
* Rock Ridge, (always enabled), -R, -rock: SetExtras. (line 8) * Rock Ridge, (always enabled), -R, -rock: SetExtras. (line 8)
@ -1782,35 +1802,36 @@ File: xorrisofs.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
 
Tag Table: Tag Table:
Node: Top397 Node: Top397
Node: Overview1064 Node: Overview1103
Node: Standards1500 Node: Standards1541
Node: Insert3175 Node: Insert3218
Node: Xorriso4943 Node: Xorriso4990
Node: Options6079 Node: Options6129
Node: Loading6796 Node: Loading6846
Node: SetInsert9090 Node: SetInsert9140
Node: SetProduct13492 Node: SetProduct13542
Node: SetCompl17199 Node: SetCompl17249
Node: SetExtras19518 Node: SetExtras19568
Node: SetHide22390 Node: SetHide22442
Node: ImageId23398 Node: ImageId23450
Node: Bootable26902 Node: Bootable26954
Node: SystemArea30982 Node: SystemArea31038
Node: Charset37342 Node: Charset37400
Node: Jigdo38367 Node: Jigdo38425
Node: Miscellaneous42648 Node: Miscellaneous42710
Node: Examples43821 Node: Examples43883
Node: ExSimple44307 Node: ExSimple44369
Node: ExGraft44786 Node: ExGraft44848
Node: ExMkisofs46033 Node: ExMkisofs46095
Node: ExGrowisofs47284 Node: ExGrowisofs47346
Node: ExIncBackup48456 Node: ExIncBackup48518
Node: ExIncBckAcc51505 Node: ExIncBckAcc51567
Node: ExBootable53180 Node: ExBootable53242
Node: Files55279 Node: Files55343
Node: Seealso56349 Node: Seealso56417
Node: Legal56864 Node: Bugreport56936
Node: CommandIdx57660 Node: Legal57537
Node: ConceptIdx68993 Node: CommandIdx58345
Node: ConceptIdx69678
 
End Tag Table End Tag Table