diff --git a/libisoburn/trunk/xorriso/xorrisofs.texi b/libisoburn/trunk/xorriso/xorrisofs.texi index 4d48b155..22599b59 100644 --- a/libisoburn/trunk/xorriso/xorrisofs.texi +++ b/libisoburn/trunk/xorriso/xorrisofs.texi @@ -111,13 +111,13 @@ xorrisofs - Emulation of ISO 9660 program mkisofs by program xorriso @c man .br @c man .SH DESCRIPTION @c man .PP -@strong{xorrisofs} +@command{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 +@command{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. @@ -146,7 +146,8 @@ with ownership, access permissions, symbolic links, and other attributes. Rock Ridge allows filenames of up to 255 bytes and paths of up to 1024 bytes. @* -Rock Ridge information is produced unconditionally with any xorrisofs image. +Rock Ridge information is produced unconditionally with any @command{xorrisofs} +image. @* @cindex Joliet, _definiton @strong{Joliet} @@ -170,7 +171,7 @@ Production of this directory tree may be enabled by option -iso-level 4. @node Insert, Xorriso, Standards, Top @chapter Inserting files into the ISO image @c man .PP -xorrisofs deals with two kinds of file addresses: +@command{xorrisofs} deals with two kinds of file addresses: @* @cindex disk_path, _definition @strong{disk_path} @@ -185,7 +186,7 @@ confuse with the lowlevel ISO 9660 names visible if Rock Ridge gets ignored.) @sp 1 @c man .PP A program argument is handled as a @strong{pathspec}, if it is not -recognized as original mkisofs option or additional xorrisofs option. +recognized as original mkisofs option or additional @command{xorrisofs} option. A pathspec depicts an input file object by a disk_path. 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 @@ -218,7 +219,7 @@ Non-directories may not overwrite existing directories. @c man \fBRelation to program xorriso:\fR @c man .br @cindex xorriso, mkisofs emulation -xorrisofs is actually a command mode of program @strong{xorriso}, +@command{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". @@ -236,7 +237,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 space may be quite fictional. @* -Nevertheless xorrisofs does not operate directly on optical drives, +Nevertheless @command{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. @@ -697,8 +698,8 @@ Alias of -N. @kindex -R Rock Ridge (is always enabled) @cindex Rock Ridge, (always enabled), -R, -rock @* -With mkisofs this option enables Rock Ridge extensions. xorrisofs produces -them unconditionally. +With mkisofs this option enables Rock Ridge extensions. @command{xorrisofs} +produces them unconditionally. @c man .TP @item -rock @kindex -rock Rock Ridge (is always enabled) @@ -967,7 +968,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 directed to such files, which usually execute further program files from the ISO image. -xorrisofs can produce several kinds of boot block or boot record, +@command{xorrisofs} can produce several kinds of boot block or boot record, which become part of the ISO image, and get interpreted by the according boot facility. @* @@ -988,7 +989,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 for PC-BIOS. @* -xorrisofs supports the example options out of the ISOLINUX wiki, +@command{xorrisofs} supports the example options out of the ISOLINUX wiki, the options used in GRUB script grub-mkrescue, and the example in the FreeBSD AvgLiveCD wiki. @* @@ -1104,7 +1105,7 @@ a MBR for booting via PC-BIOS from USB stick or hard disk. A @strong{MBR} (Master Boot Record) contains boot code and a partition table. It does not hamper El Torito booting from CDROM. @* -xorrisofs supports boot facilities other than PC-BIOS: +@command{xorrisofs} supports boot facilities other than PC-BIOS: MIPS Big Endian (SGI), MIPS Little Endian (DEC), SUN SPARC. Those are mutually not combinable and also not combinable with MBR. @* @@ -1309,7 +1310,7 @@ and DVD ISO images are published on the web in jigdo format to allow end users to download them more efficiently." @* 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 +@command{xorrisofs} can produce a .jigdo and a .template file together with a single-session ISO image. If not, then Jigdo options will cause a FAILURE event, which normally leads to program abort. @* @@ -1324,7 +1325,8 @@ The .jigdo file contains checksums and symbolic file addresses. The .template file contains the compressed ISO image with reference tags 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 @command{xorrisofs} +session 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. Each designated file is represented in the .md5 file by a single text line: @@ -1842,7 +1844,7 @@ to copy all desired files underneath that directory. Especially file isolinux.bin shall be copied to ./CD_root/isolinux/isolinux.bin . This is the boot image file. @* -The prescribed mkisofs options can be used unchanged with xorrisofs: +The prescribed mkisofs options can be used unchanged with @command{xorrisofs}: @* @sp 1 $ xorrisofs -o output.iso \ @@ -1917,7 +1919,7 @@ Now copy the image onto it @c man .B Startup files: @section Startup Files @* -If not --no_rc is given as the first argument then xorrisofs +If not --no_rc is given as the first argument then @command{xorrisofs} attempts on startup to read and execute lines from the following files: @* @sp 1 @@ -1931,8 +1933,8 @@ attempts on startup to read and execute lines from the following files: @* @sp 1 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 -xorriso commands. See man xorriso. +to exist. The lines are not interpreted as @command{xorrisofs} options but +as generic xorriso commands. See man xorriso. @c man .PP After the xorriso startup files, the program tries one by one to open for reading: @@ -2054,8 +2056,8 @@ of the license to derive modified versions of xorriso then you are entitled to modify this text under that same license. @c man .SH CREDITS @section Credits -xorrisofs is in part based on work by Vreixo Formoso who provides libisofs -together with Mario Danic who also leads the libburnia team. +@command{xorrisofs} is in part based on work by Vreixo Formoso who provides +libisofs together with Mario Danic who also leads the libburnia team. @* Compliments towards Joerg Schilling whose cdrtools served me for ten years. @c man-ignore-lines begin