|
|
|
@ -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 |
|
|
|
|