xorrisofs: SetProduct
5.3 Settings for image production
=================================
-o disk_path
Set the output file address for the emerging ISO image. If the
address exists as regular file, it will be truncated to length 0
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.
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.
--stdio_sync "on"|"off"|"end"|number
Set the number of bytes after which to force output to disk in
order to keep the memory from being clogged with lots of pending
data for slow devices. "on" is the same as "16m". Forced output
can be disabled by "off", or be delayed by "end" until all data are
produced. If a number is chosen, then it must be at least 64k.
The default with xorriso mkisofs emulation is --stdio_sync "off".
xorriso uses an inner fifo buffer with default size 4 MiB. So
forcing the operating system i/o cache to disk does not necessarily
block the simultaneous production of more image content.
--emul-toc
Write a second superblock with the first session into random-access
files. If further sessions get appended and the first superblock
gets updated, then the second superblock will not be overwritten.
So it is still possible to mount the first session and to find the
start blocks of the further sessions.
The price is 64 KiB extra space consumption. If -partition_offset
is non-zero, then it is 128 KiB plus twice the partition setup.
--no-emul-toc
Do not write a second superblock with the first session into
random-access files.
This is the default.
--sort-weight weight_number iso_rr_path
Attribute a LBA weight number to regular files. If iso_rr_path
leads to a directory then all regular files underneath will get the
weight_number.
The weight_number may range from -2147483648 to 2147483647. The
higher it is, the lower will be the block address of the file data
in the emerging ISO image. Currently the El Torito boot catalog
has a hardcoded weight of 1 billion. Normally it should occupy the
block with the lowest possible address. Data files get added or
loaded with initial weight 0. Boot image files have a default
weight of 2.
--sort-weight-list disk_path
Read pairs of weight number and iso_rr_path from a file of the
local filesystem. Apply each pair like with --sort-weight.
Only the last --sort-weight-list or --sort-weight-patterns of a
xorrisofs run gets into effect.
The weight number is read from the start of the line. The
iso_rr_path part of an input line begins immediately after the
first blank or tab character of the line.
Notes for the case that this feature is used within a sequence of
generic xorriso commands (not an issue with a pure mkisofs
emulation run):
The addressed files must already be in the ISO image model when you
execute
-as mkisofs --sort-weight-list disk_path --
Several such commands may be used to apply more than one weight
file.
Data files which are loaded by -indev or -dev get a weight between
1 and 2 exp 28 = 268,435,456, depending on their block address.
This shall keep them roughly in the same order if the write method
of modifying is applied.
--sort-weight-patterns disk_path
Like --sort-weight-list , but expanding the iso_rr_paths as shell
parser patterns and applying --sort-weight to each matching file.
-dir-mode mode
Set the access permissions for all directories in the image to the
given mode which is either an octal number beginning with "0" or a
comma separated list of statements of the form [ugoa]*[+-=][rwxst]*
. E.g. ug=rx,a-rwx
-file-mode mode
Like -dir-mode but for all regular data files in the image.
-pad
Add 300 KiB to the end of the produced ISO image. This circumvents
possible read errors from ISO images which have been written to CD
media in TAO mode. The additional bytes are claimed as part of the
ISO image if not -emul-toc is given.
Option -pad is the default.
-no-pad
Disable padding of 300 KiB to the end of the produced ISO image.
This is safe if the image is not meant to be written on CD or if it
gets written to CD as only track in write mode SAO.
--old-empty
Use the old way of of giving block addresses in the range of [0,31]
to files with no own data content. The new way is to have a
dedicated block to which all such files will point.