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

Clarified xorriso documentation about deep directories

This commit is contained in:
Thomas Schmitt 2012-03-14 15:26:49 +00:00
parent ba571848fa
commit 7c34e7c255
3 changed files with 214 additions and 202 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

45
xorriso/xorriso.1
View File

@ -9,7 +9,7 @@
.\" First parameter, NAME, should be all caps .\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1) .\" other parameters are allowed: see man(7), man(1)
.TH XORRISO 1 "Version 1.2.1, Mar 11, 2012" .TH XORRISO 1 "Version 1.2.1, Mar 14, 2012"
.\" Please adjust this date whenever revising the manpage. .\" Please adjust this date whenever revising the manpage.
.\" .\"
.\" Some roff macros, for reference: .\" Some roff macros, for reference:
@ -107,7 +107,8 @@ this text before reading the next few hundred lines of background information.
.SS .SS
\fBSession model:\fR \fBSession model:\fR
.br .br
Unlike other filesystems, ISO 9660 is not intended for read\-write operation but Unlike other filesystems, \fBISO 9660\fR (aka \fBECMA\-119\fR)
is not intended for read\-write operation but
rather for being generated in a single sweep and being written to media as a rather for being generated in a single sweep and being written to media as a
\fBsession\fR. \fBsession\fR.
.br .br
@ -2200,8 +2201,8 @@ If enabled by "on", generate Joliet tree additional to ISO 9660 + Rock Ridge
tree. tree.
.TP .TP
\fB\-compliance\fR rule[:rule...] \fB\-compliance\fR rule[:rule...]
Adjust the compliance to specifications of ISO 9660 and its contemporary Adjust the compliance to specifications of ISO 9660/ECMA\-119 and its
extensions. In some contemporary extensions. In some
cases it is worth to deviate a bit in order to circumvent bugs of the intended cases it is worth to deviate a bit in order to circumvent bugs of the intended
reader system or to get unofficial extra features. reader system or to get unofficial extra features.
.br .br
@ -2213,40 +2214,40 @@ can be revoked individually by appending "_off". Like "deep_paths_off".
.br .br
Rule keywords are: Rule keywords are:
.br .br
"iso_9660_level="number chooses level 1 with ISO names of the form 8.3 "iso_9660_level="number chooses level 1 with ECMA\-119 names of the form 8.3
and \-file_size_limit <= 4g \- 1, or level 2 with ISO names up to and \-file_size_limit <= 4g \- 1, or level 2 with ECMA\-119 names up to
length 32 and the same \-file_size_limit, or level 3 with ISO names up to length 32 and the same \-file_size_limit, or level 3 with ECMA\-119 names up to
length 32 and \-file_size_limit >= 400g \-200k. If necessary \-file_size_limit length 32 and \-file_size_limit >= 400g \-200k. If necessary \-file_size_limit
gets adjusted. gets adjusted.
.br .br
"allow_dir_id_ext" allows ISO names of directories to have a name extension "allow_dir_id_ext" allows ECMA\-119 names of directories to have a name extension
as with other file types. It does not force dots and it omits the version as with other file types. It does not force dots and it omits the version
number, though. This is a bad tradition of mkisofs which violates ECMA\-119. number, though. This is a bad tradition of mkisofs which violates ECMA\-119.
Especially ISO level 1 only allows 8 characters in a directory name and Especially ISO level 1 only allows 8 characters in a directory name and
not 8.3. not 8.3.
.br .br
"omit_version" does not add versions (";1") to ISO and Joliet file names. "omit_version" does not add versions (";1") to ECMA\-119 and Joliet file names.
.br .br
"only_iso_version" does not add versions (";1") to Joliet file names. "only_iso_version" does not add versions (";1") to Joliet file names.
.br .br
"deep_paths" allows ISO file paths deeper than 8 levels. "deep_paths" allows ECMA\-119 file paths deeper than 8 levels.
.br .br
"long_paths" allows ISO file paths longer than 255 characters. "long_paths" allows ECMA\-119 file paths longer than 255 characters.
.br .br
"long_names" allows up to 37 characters with ISO file names. "long_names" allows up to 37 characters with ECMA\-119 file names.
.br .br
"no_force_dots" does not add a dot to ISO file names which have none. "no_force_dots" does not add a dot to ECMA\-119 file names which have none.
.br .br
"no_j_force_dots" does not add a dot to Joliet file names which have none. "no_j_force_dots" does not add a dot to Joliet file names which have none.
.br .br
"lowercase" allows lowercase characters in ISO file names. "lowercase" allows lowercase characters in ECMA\-119 file names.
.br .br
"full_ascii" allows all 8\-bit characters except 0x0 and '/' "full_ascii" allows all 8\-bit characters except 0x0 and '/'
in ISO file names. in ECMA\-119 file names.
.br .br
"untranslated_names" might be dangerous for inadverted reader programs "untranslated_names" might be dangerous for inadverted reader programs
which rely on the restriction to at most 37 characters in ISO file names. which rely on the restriction to at most 37 characters in ECMA\-119 file names.
This rule allows ISO file names up to 96 characters with no character This rule allows ECMA\-119 file names up to 96 characters with no character
conversion. If a file name has more characters, then image production will conversion. If a file name has more characters, then image production will
fail deliberately. fail deliberately.
.br .br
@ -2294,13 +2295,15 @@ Default setting is
.br .br
always_gmt:old_rr". always_gmt:old_rr".
.br .br
Note: The term "ISO file" means the plain ISO 9660 names and attributes Note: The term "ECMA\-119 name" means the plain ISO 9660 names and attributes
which get visible if the reader ignores Rock Ridge. which get visible if the reader ignores Rock Ridge.
.TP .TP
\fB\-rr_reloc_dir\fR name \fB\-rr_reloc_dir\fR name
Specify the name of the relocation directory in which deep directory subtrees Specify the name of the relocation directory in which deep directory subtrees
shall be placed if \-compliance is set to "deep_paths_off". A deep directory shall be placed if \-compliance is set to "deep_paths_off" or "long_paths_off".
is one that has a chain of 8 parent directories (including root) above itself. A deep directory is one that has a chain of 8 parent directories (including
root) above itself, or one that contains a file with an ECMA\-119 path of more
than 255 characters.
.br .br
The overall directory tree will appear originally deep when interpreted The overall directory tree will appear originally deep when interpreted
as Rock Ridge tree. It will appear as re\-arranged if only ECMA\-119 as Rock Ridge tree. It will appear as re\-arranged if only ECMA\-119
@ -2319,7 +2322,7 @@ The name must not contain a '/' character and must not be longer than
Specify the volume ID. \fBxorriso\fR accepts any text up to 32 characters, Specify the volume ID. \fBxorriso\fR accepts any text up to 32 characters,
but according to rarely obeyed specs stricter rules apply: but according to rarely obeyed specs stricter rules apply:
.br .br
ECMA 119 demands ASCII characters out of [A\-Z0\-9_]. Like: "IMAGE_23" ECMA\-119 demands ASCII characters out of [A\-Z0\-9_]. Like: "IMAGE_23"
.br .br
Joliet allows 16 UCS\-2 characters. Like: "Windows name" Joliet allows 16 UCS\-2 characters. Like: "Windows name"
.br .br

292
xorriso/xorriso.info
View File

@ -87,9 +87,9 @@ File: xorriso.info, Node: Model, Next: Media, Prev: Overview, Up: Top
2 Session model 2 Session model
*************** ***************
Unlike other filesystems, ISO 9660 is not intended for read-write Unlike other filesystems, *ISO 9660* (aka *ECMA-119*) is not intended
operation but rather for being generated in a single sweep and being for read-write operation but rather for being generated in a single
written to media as a *session*. sweep and being written to media as a *session*.
The data content of the session is called filesystem *image*. The data content of the session is called filesystem *image*.
The written image in its session can then be mounted by the The written image in its session can then be mounted by the
@ -1971,9 +1971,9 @@ will be written according to the setting of command -acl.
Rock Ridge tree. Rock Ridge tree.
-compliance rule[:rule...] -compliance rule[:rule...]
Adjust the compliance to specifications of ISO 9660 and its Adjust the compliance to specifications of ISO 9660/ECMA-119 and
contemporary extensions. In some cases it is worth to deviate a its contemporary extensions. In some cases it is worth to deviate
bit in order to circumvent bugs of the intended reader system or a bit in order to circumvent bugs of the intended reader system or
to get unofficial extra features. to get unofficial extra features.
There are several adjustable rules which have a keyword each. If There are several adjustable rules which have a keyword each. If
they are mentioned with this command then their rule gets added to they are mentioned with this command then their rule gets added to
@ -1982,35 +1982,35 @@ will be written according to the setting of command -acl.
the following relaxation rules can be revoked individually by the following relaxation rules can be revoked individually by
appending "_off". Like "deep_paths_off". appending "_off". Like "deep_paths_off".
Rule keywords are: Rule keywords are:
"iso_9660_level="number chooses level 1 with ISO names of the form "iso_9660_level="number chooses level 1 with ECMA-119 names of the
8.3 and -file_size_limit <= 4g - 1, or level 2 with ISO names up to form 8.3 and -file_size_limit <= 4g - 1, or level 2 with ECMA-119
length 32 and the same -file_size_limit, or level 3 with ISO names names up to length 32 and the same -file_size_limit, or level 3
up to length 32 and -file_size_limit >= 400g -200k. If necessary with ECMA-119 names up to length 32 and -file_size_limit >= 400g
-file_size_limit gets adjusted. -200k. If necessary -file_size_limit gets adjusted.
"allow_dir_id_ext" allows ISO names of directories to have a name "allow_dir_id_ext" allows ECMA-119 names of directories to have a
extension as with other file types. It does not force dots and it name extension as with other file types. It does not force dots
omits the version number, though. This is a bad tradition of and it omits the version number, though. This is a bad tradition
mkisofs which violates ECMA-119. Especially ISO level 1 only of mkisofs which violates ECMA-119. Especially ISO level 1 only
allows 8 characters in a directory name and not 8.3. allows 8 characters in a directory name and not 8.3.
"omit_version" does not add versions (";1") to ISO and Joliet file "omit_version" does not add versions (";1") to ECMA-119 and Joliet
names. file names.
"only_iso_version" does not add versions (";1") to Joliet file "only_iso_version" does not add versions (";1") to Joliet file
names. names.
"deep_paths" allows ISO file paths deeper than 8 levels. "deep_paths" allows ECMA-119 file paths deeper than 8 levels.
"long_paths" allows ISO file paths longer than 255 characters. "long_paths" allows ECMA-119 file paths longer than 255 characters.
"long_names" allows up to 37 characters with ISO file names. "long_names" allows up to 37 characters with ECMA-119 file names.
"no_force_dots" does not add a dot to ISO file names which have "no_force_dots" does not add a dot to ECMA-119 file names which
none. have none.
"no_j_force_dots" does not add a dot to Joliet file names which "no_j_force_dots" does not add a dot to Joliet file names which
have none. have none.
"lowercase" allows lowercase characters in ISO file names. "lowercase" allows lowercase characters in ECMA-119 file names.
"full_ascii" allows all 8-bit characters except 0x0 and '/' in ISO "full_ascii" allows all 8-bit characters except 0x0 and '/' in
file names. ECMA-119 file names.
"untranslated_names" might be dangerous for inadverted reader "untranslated_names" might be dangerous for inadverted reader
programs which rely on the restriction to at most 37 characters in programs which rely on the restriction to at most 37 characters in
ISO file names. This rule allows ISO file names up to 96 ECMA-119 file names. This rule allows ECMA-119 file names up to
characters with no character conversion. If a file name has more 96 characters with no character conversion. If a file name has
characters, then image production will fail deliberately. more characters, then image production will fail deliberately.
"untranslated_name_len="number enables untranslated_names with a "untranslated_name_len="number enables untranslated_names with a
smaller limit for the length of file names. 0 disables this smaller limit for the length of file names. 0 disables this
feature, -1 chooses maximum length limit, numbers larger than 0 feature, -1 chooses maximum length limit, numbers larger than 0
@ -2047,14 +2047,16 @@ will be written according to the setting of command -acl.
Default setting is Default setting is
"clear:only_iso_version:deep_paths:long_paths:no_j_force_dots: "clear:only_iso_version:deep_paths:long_paths:no_j_force_dots:
always_gmt:old_rr". always_gmt:old_rr".
Note: The term "ISO file" means the plain ISO 9660 names and Note: The term "ECMA-119 name" means the plain ISO 9660 names and
attributes which get visible if the reader ignores Rock Ridge. attributes which get visible if the reader ignores Rock Ridge.
-rr_reloc_dir name -rr_reloc_dir name
Specify the name of the relocation directory in which deep Specify the name of the relocation directory in which deep
directory subtrees shall be placed if -compliance is set to directory subtrees shall be placed if -compliance is set to
"deep_paths_off". A deep directory is one that has a chain of 8 "deep_paths_off" or "long_paths_off". A deep directory is one
parent directories (including root) above itself. that has a chain of 8 parent directories (including root) above
itself, or one that contains a file with an ECMA-119 path of more
than 255 characters.
The overall directory tree will appear originally deep when The overall directory tree will appear originally deep when
interpreted as Rock Ridge tree. It will appear as re-arranged if interpreted as Rock Ridge tree. It will appear as re-arranged if
only ECMA-119 information is considered. only ECMA-119 information is considered.
@ -2071,7 +2073,7 @@ will be written according to the setting of command -acl.
Specify the volume ID. `xorriso' accepts any text up to 32 Specify the volume ID. `xorriso' accepts any text up to 32
characters, but according to rarely obeyed specs stricter rules characters, but according to rarely obeyed specs stricter rules
apply: apply:
ECMA 119 demands ASCII characters out of [A-Z0-9_]. Like: ECMA-119 demands ASCII characters out of [A-Z0-9_]. Like:
"IMAGE_23" "IMAGE_23"
Joliet allows 16 UCS-2 characters. Like: "Windows name" Joliet allows 16 UCS-2 characters. Like: "Windows name"
Be aware that the volume id might get used automatically as name Be aware that the volume id might get used automatically as name
@ -4354,7 +4356,7 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
* # starts a comment line: Scripting. (line 162) * # starts a comment line: Scripting. (line 162)
* -abort_on controls abort on error: Exception. (line 27) * -abort_on controls abort on error: Exception. (line 27)
* -abstract_file sets abstract file name: SetWrite. (line 182) * -abstract_file sets abstract file name: SetWrite. (line 184)
* -acl controls handling of ACLs: Loading. (line 143) * -acl controls handling of ACLs: Loading. (line 143)
* -add inserts one or more paths: Insert. (line 42) * -add inserts one or more paths: Insert. (line 42)
* -add_plainly inserts one or more paths: Insert. (line 61) * -add_plainly inserts one or more paths: Insert. (line 61)
@ -4362,13 +4364,13 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
* -alter_date_r sets timestamps in ISO image: Manip. (line 167) * -alter_date_r sets timestamps in ISO image: Manip. (line 167)
* -append_partition adds arbitrary file after image end: Bootable. * -append_partition adds arbitrary file after image end: Bootable.
(line 199) (line 199)
* -application_id sets application id: SetWrite. (line 141) * -application_id sets application id: SetWrite. (line 143)
* -as emulates mkisofs or cdrecord: Emulation. (line 13) * -as emulates mkisofs or cdrecord: Emulation. (line 13)
* -assert_volid rejects undesired images: Loading. (line 84) * -assert_volid rejects undesired images: Loading. (line 84)
* -auto_charset learns character set from image: Loading. (line 98) * -auto_charset learns character set from image: Loading. (line 98)
* -backslash_codes enables backslash conversion: Scripting. (line 67) * -backslash_codes enables backslash conversion: Scripting. (line 67)
* -ban_stdio_write demands real drive: Loading. (line 247) * -ban_stdio_write demands real drive: Loading. (line 247)
* -biblio_file sets biblio file name: SetWrite. (line 189) * -biblio_file sets biblio file name: SetWrite. (line 191)
* -blank erases media: Writing. (line 61) * -blank erases media: Writing. (line 61)
* -boot_image controls bootability: Bootable. (line 26) * -boot_image controls bootability: Bootable. (line 26)
* -calm_drive reduces drive activity: Loading. (line 236) * -calm_drive reduces drive activity: Loading. (line 236)
@ -4387,7 +4389,7 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
* -chown sets ownership in ISO image: Manip. (line 42) * -chown sets ownership in ISO image: Manip. (line 42)
* -chown_r sets ownership in ISO image: Manip. (line 47) * -chown_r sets ownership in ISO image: Manip. (line 47)
* -clone copies ISO directory tree: Insert. (line 171) * -clone copies ISO directory tree: Insert. (line 171)
* -close controls media closing: SetWrite. (line 284) * -close controls media closing: SetWrite. (line 286)
* -close_damaged closes damaged track and session: Writing. (line 152) * -close_damaged closes damaged track and session: Writing. (line 152)
* -close_filter_list bans filter registration: Filter. (line 52) * -close_filter_list bans filter registration: Filter. (line 52)
* -commit writes pending ISO image: Writing. (line 29) * -commit writes pending ISO image: Writing. (line 29)
@ -4396,7 +4398,7 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
* -compare_l reports ISO/disk differences: Navigate. (line 164) * -compare_l reports ISO/disk differences: Navigate. (line 164)
* -compare_r reports ISO/disk differences: Navigate. (line 159) * -compare_r reports ISO/disk differences: Navigate. (line 159)
* -compliance controls standard compliance: SetWrite. (line 14) * -compliance controls standard compliance: SetWrite. (line 14)
* -copyright_file sets copyright file name: SetWrite. (line 176) * -copyright_file sets copyright file name: SetWrite. (line 178)
* -cp_clone copies ISO directory tree: Insert. (line 183) * -cp_clone copies ISO directory tree: Insert. (line 183)
* -cp_rx copies file trees to disk: Restore. (line 108) * -cp_rx copies file trees to disk: Restore. (line 108)
* -cpax copies files to disk: Restore. (line 104) * -cpax copies files to disk: Restore. (line 104)
@ -4414,11 +4416,11 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
(line 36) (line 36)
* -drive_class controls drive accessability: Loading. (line 54) * -drive_class controls drive accessability: Loading. (line 54)
* -du show directory size in ISO image: Navigate. (line 89) * -du show directory size in ISO image: Navigate. (line 89)
* -dummy controls write simulation: SetWrite. (line 273) * -dummy controls write simulation: SetWrite. (line 275)
* -dus show directory size in ISO image: Navigate. (line 93) * -dus show directory size in ISO image: Navigate. (line 93)
* -dusx show directory size on disk: Navigate. (line 102) * -dusx show directory size on disk: Navigate. (line 102)
* -dux show directory size on disk: Navigate. (line 97) * -dux show directory size on disk: Navigate. (line 97)
* -dvd_obs set write block size: SetWrite. (line 260) * -dvd_obs set write block size: SetWrite. (line 262)
* -early_stdio_test classifies stdio drives: Loading. (line 252) * -early_stdio_test classifies stdio drives: Loading. (line 252)
* -eject ejects drive tray: Writing. (line 52) * -eject ejects drive tray: Writing. (line 52)
* -end writes pending session and ends program: Scripting. (line 156) * -end writes pending session and ends program: Scripting. (line 156)
@ -4436,12 +4438,12 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
* -follow softlinks and mount points: SetInsert. (line 76) * -follow softlinks and mount points: SetInsert. (line 76)
* -for_backup -acl,-xattr,-hardlinks,-md5: Loading. (line 185) * -for_backup -acl,-xattr,-hardlinks,-md5: Loading. (line 185)
* -format formats media: Writing. (line 88) * -format formats media: Writing. (line 88)
* -fs sets size of fifo: SetWrite. (line 277) * -fs sets size of fifo: SetWrite. (line 279)
* -getfacl shows ACL in ISO image: Navigate. (line 70) * -getfacl shows ACL in ISO image: Navigate. (line 70)
* -getfacl_r shows ACL in ISO image: Navigate. (line 77) * -getfacl_r shows ACL in ISO image: Navigate. (line 77)
* -getfattr shows xattr in ISO image: Navigate. (line 81) * -getfattr shows xattr in ISO image: Navigate. (line 81)
* -getfattr_r shows xattr in ISO image: Navigate. (line 85) * -getfattr_r shows xattr in ISO image: Navigate. (line 85)
* -gid sets global ownership: SetWrite. (line 217) * -gid sets global ownership: SetWrite. (line 219)
* -grow_blindly overides next writeable address: AqDrive. (line 46) * -grow_blindly overides next writeable address: AqDrive. (line 46)
* -hardlinks controls handling of hard links: Loading. (line 110) * -hardlinks controls handling of hard links: Loading. (line 110)
* -help prints help text: Scripting. (line 20) * -help prints help text: Scripting. (line 20)
@ -4487,17 +4489,17 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
* -not_paths sets absolute exclusion paths: SetInsert. (line 55) * -not_paths sets absolute exclusion paths: SetInsert. (line 55)
* -options_from_file reads commands from file: Scripting. (line 12) * -options_from_file reads commands from file: Scripting. (line 12)
* -osirrox enables ISO-to-disk copying: Restore. (line 18) * -osirrox enables ISO-to-disk copying: Restore. (line 18)
* -out_charset sets output character set: SetWrite. (line 207) * -out_charset sets output character set: SetWrite. (line 209)
* -outdev acquires a drive for output: AqDrive. (line 31) * -outdev acquires a drive for output: AqDrive. (line 31)
* -overwrite enables overwriting in ISO: SetInsert. (line 127) * -overwrite enables overwriting in ISO: SetInsert. (line 127)
* -pacifier controls pacifier text form: Emulation. (line 158) * -pacifier controls pacifier text form: Emulation. (line 158)
* -padding sets amount or mode of image padding: SetWrite. (line 290) * -padding sets amount or mode of image padding: SetWrite. (line 292)
* -page set terminal geometry: DialogCtl. (line 19) * -page set terminal geometry: DialogCtl. (line 19)
* -paste_in copies file into disk file: Restore. (line 121) * -paste_in copies file into disk file: Restore. (line 121)
* -path_list inserts paths from disk file: Insert. (line 75) * -path_list inserts paths from disk file: Insert. (line 75)
* -pathspecs sets meaning of = with -add: SetInsert. (line 118) * -pathspecs sets meaning of = with -add: SetInsert. (line 118)
* -pkt_output consolidates text output: Frontend. (line 7) * -pkt_output consolidates text output: Frontend. (line 7)
* -preparer_id sets preparer id: SetWrite. (line 195) * -preparer_id sets preparer id: SetWrite. (line 197)
* -print prints result text line: Scripting. (line 99) * -print prints result text line: Scripting. (line 99)
* -print_info prints message text line: Scripting. (line 102) * -print_info prints message text line: Scripting. (line 102)
* -print_mark prints synchronizing text line: Scripting. (line 105) * -print_mark prints synchronizing text line: Scripting. (line 105)
@ -4505,7 +4507,7 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
* -prog sets program name: Frontend. (line 30) * -prog sets program name: Frontend. (line 30)
* -prog_help prints help text: Frontend. (line 33) * -prog_help prints help text: Frontend. (line 33)
* -prompt prompts for enter key: Scripting. (line 110) * -prompt prompts for enter key: Scripting. (line 110)
* -publisher sets publisher id: SetWrite. (line 135) * -publisher sets publisher id: SetWrite. (line 137)
* -pvd_info shows image id strings: Inquiry. (line 93) * -pvd_info shows image id strings: Inquiry. (line 93)
* -pwd tells working directory in ISO: Navigate. (line 20) * -pwd tells working directory in ISO: Navigate. (line 20)
* -pwdx tells working directory on disk: Navigate. (line 23) * -pwdx tells working directory on disk: Navigate. (line 23)
@ -4541,29 +4543,29 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
* -signal_handling controls handling of system signals: Exception. * -signal_handling controls handling of system signals: Exception.
(line 69) (line 69)
* -sleep waits for a given time span: Scripting. (line 114) * -sleep waits for a given time span: Scripting. (line 114)
* -speed set write speed: SetWrite. (line 233) * -speed set write speed: SetWrite. (line 235)
* -split_size enables large file splitting: SetInsert. (line 140) * -split_size enables large file splitting: SetInsert. (line 140)
* -status shows current settings: Scripting. (line 47) * -status shows current settings: Scripting. (line 47)
* -status_history_max curbs -status history: Scripting. (line 56) * -status_history_max curbs -status history: Scripting. (line 56)
* -stdio_sync controls stdio buffer: SetWrite. (line 267) * -stdio_sync controls stdio buffer: SetWrite. (line 269)
* -stream_recording controls defect management: SetWrite. (line 248) * -stream_recording controls defect management: SetWrite. (line 250)
* -system_id sets system id: SetWrite. (line 150) * -system_id sets system id: SetWrite. (line 152)
* -tell_media_space reports free space: Inquiry. (line 89) * -tell_media_space reports free space: Inquiry. (line 89)
* -temp_mem_limit curbs memory consumption: Scripting. (line 92) * -temp_mem_limit curbs memory consumption: Scripting. (line 92)
* -toc shows list of sessions: Inquiry. (line 28) * -toc shows list of sessions: Inquiry. (line 28)
* -uid sets global ownership: SetWrite. (line 213) * -uid sets global ownership: SetWrite. (line 215)
* -update inserts path if different: Insert. (line 99) * -update inserts path if different: Insert. (line 99)
* -update_l inserts paths if different: Insert. (line 121) * -update_l inserts paths if different: Insert. (line 121)
* -update_r inserts paths if different: Insert. (line 110) * -update_r inserts paths if different: Insert. (line 110)
* -use_readline enables readline for dialog: DialogCtl. (line 28) * -use_readline enables readline for dialog: DialogCtl. (line 28)
* -version prints help text: Scripting. (line 23) * -version prints help text: Scripting. (line 23)
* -volid sets volume id: SetWrite. (line 111) * -volid sets volume id: SetWrite. (line 113)
* -volset_id sets volume set id: SetWrite. (line 130) * -volset_id sets volume set id: SetWrite. (line 132)
* -volume_date sets volume timestamp: SetWrite. (line 157) * -volume_date sets volume timestamp: SetWrite. (line 159)
* -x enables automatic execution order of arguments: ArgSort. * -x enables automatic execution order of arguments: ArgSort.
(line 16) (line 16)
* -xattr controls handling of xattr (EA): Loading. (line 151) * -xattr controls handling of xattr (EA): Loading. (line 151)
* -zisofs controls zisofs production: SetWrite. (line 221) * -zisofs controls zisofs production: SetWrite. (line 223)
 
File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
@ -4574,7 +4576,7 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
[index] [index]
* Menu: * Menu:
* ACL, _definiton: Extras. (line 38) * ACL, _definition: Extras. (line 38)
* ACL, control handling, -acl: Loading. (line 143) * ACL, control handling, -acl: Loading. (line 143)
* ACL, set in ISO image, -setfacl: Manip. (line 73) * ACL, set in ISO image, -setfacl: Manip. (line 73)
* ACL, set in ISO image, -setfacl_list: Manip. (line 101) * ACL, set in ISO image, -setfacl_list: Manip. (line 101)
@ -4596,15 +4598,15 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* 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)
* Character Set, for input/output, -charset: Charset. (line 43) * Character Set, for input/output, -charset: Charset. (line 43)
* Character Set, for output, -out_charset: SetWrite. (line 207) * Character Set, for output, -out_charset: SetWrite. (line 209)
* Character set, learn from image, -auto_charset: Loading. (line 98) * Character set, learn from image, -auto_charset: Loading. (line 98)
* Character Set, of terminal, -local_charset: Charset. (line 47) * Character Set, of terminal, -local_charset: Charset. (line 47)
* Closed media, _definition: Media. (line 43) * Closed media, _definition: Media. (line 43)
* Comment, #: Scripting. (line 162) * Comment, #: Scripting. (line 162)
* Control, signal handling, -signal_handling: Exception. (line 69) * Control, signal handling, -signal_handling: Exception. (line 69)
* Create, new ISO image, _definiton: Methods. (line 6) * Create, new ISO image, _definition: Methods. (line 6)
* Cylinder alignment, _definiton: Bootable. (line 167) * Cylinder alignment, _definition: Bootable. (line 167)
* Cylinder size, _definiton: Bootable. (line 156) * Cylinder size, _definition: Bootable. (line 156)
* Damaged track and session, close, -close_damaged: Writing. (line 152) * Damaged track and session, close, -close_damaged: Writing. (line 152)
* Delete, from ISO image, -rm: Manip. (line 21) * Delete, from ISO image, -rm: Manip. (line 21)
* Delete, from ISO image, -rm_r: Manip. (line 28) * Delete, from ISO image, -rm_r: Manip. (line 28)
@ -4619,7 +4621,7 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Directory, create, -mkdir: Insert. (line 166) * Directory, create, -mkdir: Insert. (line 166)
* Directory, delete, -rmdir: Manip. (line 32) * Directory, delete, -rmdir: Manip. (line 32)
* disk_path, _definition: Insert. (line 6) * disk_path, _definition: Insert. (line 6)
* Drive, _definiton: Drives. (line 6) * Drive, _definition: Drives. (line 6)
* Drive, accessability, -drive_class: Loading. (line 54) * Drive, accessability, -drive_class: Loading. (line 54)
* Drive, classify stdio, -early_stdio_test: Loading. (line 252) * Drive, classify stdio, -early_stdio_test: Loading. (line 252)
* Drive, demand real MMC, -ban_stdio_write: Loading. (line 247) * Drive, demand real MMC, -ban_stdio_write: Loading. (line 247)
@ -4633,15 +4635,16 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Drive, reduce activity, -calm_drive: Loading. (line 236) * Drive, reduce activity, -calm_drive: Loading. (line 236)
* Drive, report SCSI commands, -scsi_log: Scripting. (line 147) * Drive, report SCSI commands, -scsi_log: Scripting. (line 147)
* Drive, write and eject, -commit_eject: Writing. (line 56) * Drive, write and eject, -commit_eject: Writing. (line 56)
* EA, _definiton: Extras. (line 54) * EA, _definition: Extras. (line 54)
* El Torito, _definiton: Extras. (line 19) * ECMA-119, _definition: Model. (line 6)
* El Torito, _definition: Extras. (line 19)
* Emulation, -as: Emulation. (line 13) * Emulation, -as: Emulation. (line 13)
* Emulation, .mkisofsrc, -read_mkisofsrc: Emulation. (line 146) * Emulation, .mkisofsrc, -read_mkisofsrc: Emulation. (line 146)
* Emulation, cdrecord, -as: Emulation. (line 111) * Emulation, cdrecord, -as: Emulation. (line 111)
* Emulation, mkisofs, -as: Emulation. (line 16) * Emulation, mkisofs, -as: Emulation. (line 16)
* Emulation, pacifier form, -pacifier: Emulation. (line 158) * Emulation, pacifier form, -pacifier: Emulation. (line 158)
* Examples: Examples. (line 6) * Examples: Examples. (line 6)
* extattr, _definiton: Extras. (line 54) * extattr, _definition: Extras. (line 54)
* Filter, _definition: Filter. (line 6) * Filter, _definition: Filter. (line 6)
* Filter, apply to file tree, -set_filter_r: Filter. (line 89) * Filter, apply to file tree, -set_filter_r: Filter. (line 89)
* Filter, apply to file, -set_filter: Filter. (line 60) * Filter, apply to file, -set_filter: Filter. (line 60)
@ -4650,8 +4653,8 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Filter, show chain, -show_stream: Navigate. (line 169) * Filter, show chain, -show_stream: Navigate. (line 169)
* Filter, show chains of tree, -show_stream_r: Navigate. (line 183) * Filter, show chains of tree, -show_stream_r: Navigate. (line 183)
* Filter, unregister, -unregister_filter: Filter. (line 48) * Filter, unregister, -unregister_filter: Filter. (line 48)
* Filter, zisofs parameters, -zisofs: SetWrite. (line 221) * Filter, zisofs parameters, -zisofs: SetWrite. (line 223)
* Group, global in ISO image, -gid: SetWrite. (line 217) * Group, global in ISO image, -gid: SetWrite. (line 219)
* Group, in ISO image, -chgrp: Manip. (line 50) * Group, in ISO image, -chgrp: Manip. (line 50)
* Group, in ISO image, -chgrp_r: Manip. (line 55) * Group, in ISO image, -chgrp_r: Manip. (line 55)
* Growing, _definition: Methods. (line 19) * Growing, _definition: Methods. (line 19)
@ -4662,16 +4665,16 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Image, demand volume id, -assert_volid: Loading. (line 84) * Image, demand volume id, -assert_volid: Loading. (line 84)
* Image, discard pending changes, -rollback: Writing. (line 9) * Image, discard pending changes, -rollback: Writing. (line 9)
* Image, override change status, -changes_pending: Writing. (line 13) * Image, override change status, -changes_pending: Writing. (line 13)
* Image, set abstract file name, -abstract_file: SetWrite. (line 182) * Image, set abstract file name, -abstract_file: SetWrite. (line 184)
* Image, set application id, -application_id: SetWrite. (line 141) * Image, set application id, -application_id: SetWrite. (line 143)
* Image, set biblio file name, -biblio_file: SetWrite. (line 189) * Image, set biblio file name, -biblio_file: SetWrite. (line 191)
* Image, set copyright file name, -copyright_file: SetWrite. (line 176) * Image, set copyright file name, -copyright_file: SetWrite. (line 178)
* Image, set preparer id, -preparer_id: SetWrite. (line 195) * Image, set preparer id, -preparer_id: SetWrite. (line 197)
* Image, set publisher id, -publisher: SetWrite. (line 135) * Image, set publisher id, -publisher: SetWrite. (line 137)
* Image, set system id, -system_id: SetWrite. (line 150) * Image, set system id, -system_id: SetWrite. (line 152)
* Image, set volume id, -volid: SetWrite. (line 111) * Image, set volume id, -volid: SetWrite. (line 113)
* Image, set volume set id, -volset_id: SetWrite. (line 130) * Image, set volume set id, -volset_id: SetWrite. (line 132)
* Image, set volume timestamp, -volume_date: SetWrite. (line 157) * Image, set volume timestamp, -volume_date: SetWrite. (line 159)
* Image, show id strings, -pvd_info: Inquiry. (line 93) * Image, show id strings, -pvd_info: Inquiry. (line 93)
* Insert, enable overwriting, -overwrite: SetInsert. (line 127) * Insert, enable overwriting, -overwrite: SetInsert. (line 127)
* Insert, file exclusion absolute, -not_paths: SetInsert. (line 55) * Insert, file exclusion absolute, -not_paths: SetInsert. (line 55)
@ -4695,11 +4698,12 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Insert, paths, -cpr: Insert. (line 152) * Insert, paths, -cpr: Insert. (line 152)
* Insert, pathspecs, -add: Insert. (line 42) * Insert, pathspecs, -add: Insert. (line 42)
* Insert, piece of data file, -cut_out: Insert. (line 126) * Insert, piece of data file, -cut_out: Insert. (line 126)
* ISO 9660, _definition: Model. (line 6)
* iso_rr_path, _definition: Insert. (line 7) * iso_rr_path, _definition: Insert. (line 7)
* Jigdo Template Extraction, -jigdo: Jigdo. (line 33) * Jigdo Template Extraction, -jigdo: Jigdo. (line 33)
* Jigdo Template Extraction, _definition: Jigdo. (line 6) * Jigdo Template Extraction, _definition: Jigdo. (line 6)
* List delimiter, _definiton: Processing. (line 9) * List delimiter, _definition: Processing. (line 9)
* MBR, _definiton: Extras. (line 26) * MBR, _definition: Extras. (line 26)
* MBR, set, -boot_image system_area=: Bootable. (line 121) * MBR, set, -boot_image system_area=: Bootable. (line 121)
* MD5, control handling, -md5: Loading. (line 156) * MD5, control handling, -md5: Loading. (line 156)
* Media, erase, -blank: Writing. (line 61) * Media, erase, -blank: Writing. (line 61)
@ -4729,11 +4733,11 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Navigate, tell ISO working directory, -pwd: Navigate. (line 20) * Navigate, tell ISO working directory, -pwd: Navigate. (line 20)
* Next writeable address, -grow_blindly: AqDrive. (line 46) * Next writeable address, -grow_blindly: AqDrive. (line 46)
* Overwriteable media, _definition: Media. (line 14) * Overwriteable media, _definition: Media. (line 14)
* Ownership, global in ISO image, -uid: SetWrite. (line 213) * Ownership, global in ISO image, -uid: SetWrite. (line 215)
* Ownership, in ISO image, -chown: Manip. (line 42) * Ownership, in ISO image, -chown: Manip. (line 42)
* Ownership, in ISO image, -chown_r: Manip. (line 47) * Ownership, in ISO image, -chown_r: Manip. (line 47)
* Partition offset, _definiton: Bootable. (line 146) * Partition offset, _definition: Bootable. (line 146)
* Partition table, _definiton: Bootable. (line 128) * Partition table, _definition: Bootable. (line 128)
* Pathspec, _definition: SetInsert. (line 120) * Pathspec, _definition: SetInsert. (line 120)
* Pattern expansion, _definition: Processing. (line 24) * Pattern expansion, _definition: Processing. (line 24)
* Pattern expansion, for disk paths, -disk_pattern: Insert. (line 31) * Pattern expansion, for disk paths, -disk_pattern: Insert. (line 31)
@ -4770,7 +4774,7 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Program, show current settings, -status: Scripting. (line 47) * Program, show current settings, -status: Scripting. (line 47)
* Program, status history, -status_history_max: Scripting. (line 56) * Program, status history, -status_history_max: Scripting. (line 56)
* Program, wait a time span, -sleep: Scripting. (line 114) * Program, wait a time span, -sleep: Scripting. (line 114)
* Quoted input, _definiton: Processing. (line 46) * Quoted input, _definition: Processing. (line 46)
* Recovery, retrieve blocks, -check_media: Verify. (line 21) * Recovery, retrieve blocks, -check_media: Verify. (line 21)
* Relocation directory, set name, -rr_reloc_dir: SetWrite. (line 94) * Relocation directory, set name, -rr_reloc_dir: SetWrite. (line 94)
* Rename, in ISO image, -mv: Manip. (line 35) * Rename, in ISO image, -mv: Manip. (line 35)
@ -4783,7 +4787,7 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Restore, copy files to disk, -cpx: Restore. (line 92) * Restore, copy files to disk, -cpx: Restore. (line 92)
* Restore, copy files to disk, -extract_l: Restore. (line 76) * Restore, copy files to disk, -extract_l: Restore. (line 76)
* Restore, enable ISO-to-disk, -osirrox: Restore. (line 18) * Restore, enable ISO-to-disk, -osirrox: Restore. (line 18)
* Rock Ridge, _definiton: Extras. (line 6) * Rock Ridge, _definition: Extras. (line 6)
* Session, _definition: Model. (line 6) * Session, _definition: Model. (line 6)
* Session, altered start address, -displacement: Loading. (line 36) * Session, altered start address, -displacement: Loading. (line 36)
* Session, info string, -session_string: Inquiry. (line 67) * Session, info string, -session_string: Inquiry. (line 67)
@ -4795,7 +4799,7 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Sorting order, for -x, -list_arg_sorting: ArgSort. (line 27) * Sorting order, for -x, -list_arg_sorting: ArgSort. (line 27)
* SUN Disk Label, production: Bootable. (line 187) * SUN Disk Label, production: Bootable. (line 187)
* SUN SPARC boot images, activation: Bootable. (line 220) * SUN SPARC boot images, activation: Bootable. (line 220)
* System area, _definiton: Bootable. (line 121) * System area, _definition: Bootable. (line 121)
* Table-of-content, search sessions, -rom_toc_scan: Loading. (line 211) * Table-of-content, search sessions, -rom_toc_scan: Loading. (line 211)
* Table-of-content, show, -toc: Inquiry. (line 28) * Table-of-content, show, -toc: Inquiry. (line 28)
* Timestamps, set in ISO image, -alter_date: Manip. (line 147) * Timestamps, set in ISO image, -alter_date: Manip. (line 147)
@ -4809,23 +4813,23 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Verify, file checksum, -check_md5: Verify. (line 148) * Verify, file checksum, -check_md5: Verify. (line 148)
* Verify, file tree checksums, -check_md5_r: Verify. (line 164) * Verify, file tree checksums, -check_md5_r: Verify. (line 164)
* Verify, preset -check_media, -check_media_defaults: Verify. (line 41) * Verify, preset -check_media, -check_media_defaults: Verify. (line 41)
* Write, block size, -dvd_obs: SetWrite. (line 260) * Write, block size, -dvd_obs: SetWrite. (line 262)
* Write, bootability, -boot_image: Bootable. (line 26) * Write, bootability, -boot_image: Bootable. (line 26)
* Write, buffer syncing, -stdio_sync: SetWrite. (line 267) * Write, buffer syncing, -stdio_sync: SetWrite. (line 269)
* Write, close media, -close: SetWrite. (line 284) * Write, close media, -close: SetWrite. (line 286)
* Write, compliance to specs, -compliance: SetWrite. (line 14) * Write, compliance to specs, -compliance: SetWrite. (line 14)
* Write, defect management, -stream_recording: SetWrite. (line 248) * Write, defect management, -stream_recording: SetWrite. (line 250)
* Write, enable Joliet, -joliet: SetWrite. (line 10) * Write, enable Joliet, -joliet: SetWrite. (line 10)
* Write, fifo size, -fs: SetWrite. (line 277) * Write, fifo size, -fs: SetWrite. (line 279)
* Write, free space, -tell_media_space: Inquiry. (line 89) * Write, free space, -tell_media_space: Inquiry. (line 89)
* Write, log problematic disk files, -errfile_log: Scripting. (line 118) * Write, log problematic disk files, -errfile_log: Scripting. (line 118)
* Write, log written sessions, -session_log: Scripting. (line 138) * Write, log written sessions, -session_log: Scripting. (line 138)
* Write, padding image, -padding: SetWrite. (line 290) * Write, padding image, -padding: SetWrite. (line 292)
* Write, pending ISO image, -commit: Writing. (line 29) * Write, pending ISO image, -commit: Writing. (line 29)
* Write, predict image size, -print_size: Inquiry. (line 80) * Write, predict image size, -print_size: Inquiry. (line 80)
* Write, set speed, -speed: SetWrite. (line 233) * Write, set speed, -speed: SetWrite. (line 235)
* Write, simulation, -dummy: SetWrite. (line 273) * Write, simulation, -dummy: SetWrite. (line 275)
* xattr, _definiton: Extras. (line 54) * xattr, _definition: Extras. (line 54)
* xattr, control handling, -xattr: Loading. (line 151) * xattr, control handling, -xattr: Loading. (line 151)
* xattr, set in ISO image, -setfattr: Manip. (line 111) * xattr, set in ISO image, -setfattr: Manip. (line 111)
* xattr, set in ISO image, -setfattr_list: Manip. (line 127) * xattr, set in ISO image, -setfattr_list: Manip. (line 127)
@ -4839,57 +4843,57 @@ Tag Table:
Node: Top420 Node: Top420
Node: Overview1375 Node: Overview1375
Node: Model3264 Node: Model3264
Node: Media6151 Node: Media6170
Node: Methods8822 Node: Methods8841
Node: Drives11397 Node: Drives11416
Node: Extras14712 Node: Extras14731
Node: Processing18433 Node: Processing18452
Node: Dialog22053 Node: Dialog22072
Node: Options23730 Node: Options23749
Node: ArgSort25404 Node: ArgSort25423
Node: AqDrive26894 Node: AqDrive26913
Node: Loading29938 Node: Loading29957
Node: Insert45147 Node: Insert45166
Node: SetInsert54862 Node: SetInsert54881
Node: Manip63438 Node: Manip63457
Node: CmdFind72174 Node: CmdFind72193
Node: Filter84283 Node: Filter84302
Node: Writing88838 Node: Writing88857
Node: SetWrite97802 Node: SetWrite97821
Node: Bootable113077 Node: Bootable113285
Node: Jigdo126299 Node: Jigdo126507
Node: Charset130545 Node: Charset130753
Node: Exception133306 Node: Exception133514
Node: DialogCtl139425 Node: DialogCtl139633
Node: Inquiry142022 Node: Inquiry142230
Node: Navigate146888 Node: Navigate147096
Node: Verify155149 Node: Verify155357
Node: Restore163838 Node: Restore164046
Node: Emulation170747 Node: Emulation170955
Node: Scripting180558 Node: Scripting180766
Node: Frontend187718 Node: Frontend187926
Node: Examples189018 Node: Examples189226
Node: ExDevices190195 Node: ExDevices190403
Node: ExCreate190854 Node: ExCreate191062
Node: ExDialog192139 Node: ExDialog192347
Node: ExGrowing193404 Node: ExGrowing193612
Node: ExModifying194209 Node: ExModifying194417
Node: ExBootable194713 Node: ExBootable194921
Node: ExCharset195265 Node: ExCharset195473
Node: ExPseudo196086 Node: ExPseudo196294
Node: ExCdrecord196984 Node: ExCdrecord197192
Node: ExMkisofs197301 Node: ExMkisofs197509
Node: ExGrowisofs198641 Node: ExGrowisofs198849
Node: ExException199776 Node: ExException199984
Node: ExTime200230 Node: ExTime200438
Node: ExIncBackup200689 Node: ExIncBackup200897
Node: ExRestore204680 Node: ExRestore204888
Node: ExRecovery205640 Node: ExRecovery205848
Node: Files206210 Node: Files206418
Node: Seealso207509 Node: Seealso207717
Node: Bugreport208232 Node: Bugreport208440
Node: Legal208813 Node: Legal209021
Node: CommandIdx209743 Node: CommandIdx209951
Node: ConceptIdx225331 Node: ConceptIdx225539
 
End Tag Table End Tag Table

79
xorriso/xorriso.texi
View File

@ -50,7 +50,7 @@
@c man .\" First parameter, NAME, should be all caps @c man .\" First parameter, NAME, should be all caps
@c man .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection @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 .\" other parameters are allowed: see man(7), man(1)
@c man .TH XORRISO 1 "Version 1.2.1, Mar 11, 2012" @c man .TH XORRISO 1 "Version 1.2.1, Mar 14, 2012"
@c man .\" Please adjust this date whenever revising the manpage. @c man .\" Please adjust this date whenever revising the manpage.
@c man .\" @c man .\"
@c man .\" Some roff macros, for reference: @c man .\" Some roff macros, for reference:
@ -199,7 +199,10 @@ Adjustable thresholds for abort, exit value, and problem reporting.
@c man \fBSession model:\fR @c man \fBSession model:\fR
@c man .br @c man .br
@cindex Session, _definition @cindex Session, _definition
Unlike other filesystems, ISO 9660 is not intended for read-write operation but @cindex ISO 9660, _definition
@cindex ECMA-119, _definition
Unlike other filesystems, @strong{ISO 9660} (aka @strong{ECMA-119})
is not intended for read-write operation but
rather for being generated in a single sweep and being written to media as a rather for being generated in a single sweep and being written to media as a
@strong{session}. @strong{session}.
@* @*
@ -335,7 +338,7 @@ not even that. Command -rom_toc_scan might or might not help in such cases.
@chapter Creating, Growing, Modifying, Blind Growing: @chapter Creating, Growing, Modifying, Blind Growing:
@c man .B Creating, Growing, Modifying, Blind Growing: @c man .B Creating, Growing, Modifying, Blind Growing:
@* @*
@cindex Create, new ISO image, _definiton @cindex Create, new ISO image, _definition
A new empty ISO image gets @strong{created} A new empty ISO image gets @strong{created}
if there is no input drive with a valid ISO 9660 image when the first time if there is no input drive with a valid ISO 9660 image when the first time
an output drive is defined. This is achieved by command -dev on blank media an output drive is defined. This is achieved by command -dev on blank media
@ -397,7 +400,7 @@ and the burn program is desired. -C $msc1,$msc2 is equivalent to:
@chapter Libburn drives @chapter Libburn drives
@c man .B Libburn drives: @c man .B Libburn drives:
@c man .br @c man .br
@cindex Drive, _definiton @cindex Drive, _definition
Input drive, i.e. source of an existing or empty ISO image, can be any random Input drive, i.e. source of an existing or empty ISO image, can be any random
access readable libburn drive: optical media with readable data, access readable libburn drive: optical media with readable data,
blank optical media, regular files, block devices. blank optical media, regular files, block devices.
@ -496,7 +499,7 @@ prefix "stdio:" to other paths.
@chapter Rock Ridge, POSIX, X/Open, El Torito, ACL, xattr @chapter Rock Ridge, POSIX, X/Open, El Torito, ACL, xattr
@c man .B Rock Ridge, POSIX, X/Open, El Torito, ACL, xattr: @c man .B Rock Ridge, POSIX, X/Open, El Torito, ACL, xattr:
@c man .br @c man .br
@cindex Rock Ridge, _definiton @cindex Rock Ridge, _definition
@strong{Rock Ridge} @strong{Rock Ridge}
is the name of a set of additional information which enhance is the name of a set of additional information which enhance
an ISO 9660 filesystem so that it can represent a POSIX compliant filesystem an ISO 9660 filesystem so that it can represent a POSIX compliant filesystem
@ -514,7 +517,7 @@ demands a file name length of up to 255 characters and paths of up to 1024
characters. Rock Ridge fulfills this demand. characters. Rock Ridge fulfills this demand.
@c man .PP @c man .PP
@sp 1 @sp 1
@cindex El Torito, _definiton @cindex El Torito, _definition
An @strong{El Torito} An @strong{El Torito}
boot record points the BIOS bootstrapping facility to one or more boot boot record points the BIOS bootstrapping facility to one or more boot
images, which are binary program files stored in the ISO image. images, which are binary program files stored in the ISO image.
@ -524,7 +527,7 @@ Most bootable GNU/Linux CDs are equipped with ISOLINUX or GRUB boot images.
@command{xorriso} is able to create or maintain an El Torito object which @command{xorriso} is able to create or maintain an El Torito object which
makes such an image bootable. For details see command -boot_image. makes such an image bootable. For details see command -boot_image.
@* @*
@cindex MBR, _definiton @cindex MBR, _definition
It is possible to make ISO images bootable from USB stick or other It is possible to make ISO images bootable from USB stick or other
hard-disk-like media by -boot_image parameter system_area= . This installs hard-disk-like media by -boot_image parameter system_area= . This installs
a Master Boot Record which may get adjusted according to the needs a Master Boot Record which may get adjusted according to the needs
@ -542,7 +545,7 @@ EFI, MIPS Big Endian (SGI), MIPS Little Endian (DEC), SUN SPARC.
@* @*
@c man .PP @c man .PP
@sp 1 @sp 1
@cindex ACL, _definiton @cindex ACL, _definition
@strong{ACL} @strong{ACL}
are an advanced way of controlling access permissions to file objects. Neither are an advanced way of controlling access permissions to file objects. Neither
ISO 9660 nor Rock Ridge specify a way to record ACLs. So libisofs has ISO 9660 nor Rock Ridge specify a way to record ACLs. So libisofs has
@ -566,9 +569,9 @@ Recording and restoring of ACLs from and to local files works currently
only on GNU/Linux and FreeBSD. only on GNU/Linux and FreeBSD.
@c man .PP @c man .PP
@sp 1 @sp 1
@cindex xattr, _definiton @cindex xattr, _definition
@cindex EA, _definiton @cindex EA, _definition
@cindex extattr, _definiton @cindex extattr, _definition
@strong{xattr} (aka EA, or extattr) @strong{xattr} (aka EA, or extattr)
are pairs of name and value which can be attached to file objects. AAIP is are pairs of name and value which can be attached to file objects. AAIP is
able to represent them and @command{xorriso} allows to record and restore able to represent them and @command{xorriso} allows to record and restore
@ -596,7 +599,7 @@ given as program arguments and command
@strong{-x} @strong{-x}
is among them. is among them.
@* @*
@cindex List delimiter, _definiton @cindex List delimiter, _definition
Commands consist of a command word, Commands consist of a command word,
followed by zero or more parameter words. If the list of parameter words followed by zero or more parameter words. If the list of parameter words
is of variable length (indicated by "[...]" or "[***]") then it must be is of variable length (indicated by "[...]" or "[***]") then it must be
@ -644,7 +647,7 @@ differs from the usual shell parsers. In @command{xorriso}, a quotation mark
does not make a pattern symbol literal. does not make a pattern symbol literal.
@c man .PP @c man .PP
@sp 1 @sp 1
@cindex Quoted input, _definiton @cindex Quoted input, _definition
@strong{Quoted input} @strong{Quoted input}
converts whitespace-separated text into words. converts whitespace-separated text into words.
The double quotation mark " and the single quotation mark ' can be used to The double quotation mark " and the single quotation mark ' can be used to
@ -2641,8 +2644,8 @@ tree.
@item -compliance rule[:rule...] @item -compliance rule[:rule...]
@kindex -compliance controls standard compliance @kindex -compliance controls standard compliance
@cindex Write, compliance to specs, -compliance @cindex Write, compliance to specs, -compliance
Adjust the compliance to specifications of ISO 9660 and its contemporary Adjust the compliance to specifications of ISO 9660/ECMA-119 and its
extensions. In some contemporary extensions. In some
cases it is worth to deviate a bit in order to circumvent bugs of the intended cases it is worth to deviate a bit in order to circumvent bugs of the intended
reader system or to get unofficial extra features. reader system or to get unofficial extra features.
@* @*
@ -2654,40 +2657,40 @@ can be revoked individually by appending "_off". Like "deep_paths_off".
@* @*
Rule keywords are: Rule keywords are:
@* @*
"iso_9660_level="number chooses level 1 with ISO names of the form 8.3 "iso_9660_level="number chooses level 1 with ECMA-119 names of the form 8.3
and -file_size_limit <= 4g - 1, or level 2 with ISO names up to and -file_size_limit <= 4g - 1, or level 2 with ECMA-119 names up to
length 32 and the same -file_size_limit, or level 3 with ISO names up to length 32 and the same -file_size_limit, or level 3 with ECMA-119 names up to
length 32 and -file_size_limit >= 400g -200k. If necessary -file_size_limit length 32 and -file_size_limit >= 400g -200k. If necessary -file_size_limit
gets adjusted. gets adjusted.
@* @*
"allow_dir_id_ext" allows ISO names of directories to have a name extension "allow_dir_id_ext" allows ECMA-119 names of directories to have a name extension
as with other file types. It does not force dots and it omits the version as with other file types. It does not force dots and it omits the version
number, though. This is a bad tradition of mkisofs which violates ECMA-119. number, though. This is a bad tradition of mkisofs which violates ECMA-119.
Especially ISO level 1 only allows 8 characters in a directory name and Especially ISO level 1 only allows 8 characters in a directory name and
not 8.3. not 8.3.
@* @*
"omit_version" does not add versions (";1") to ISO and Joliet file names. "omit_version" does not add versions (";1") to ECMA-119 and Joliet file names.
@* @*
"only_iso_version" does not add versions (";1") to Joliet file names. "only_iso_version" does not add versions (";1") to Joliet file names.
@* @*
"deep_paths" allows ISO file paths deeper than 8 levels. "deep_paths" allows ECMA-119 file paths deeper than 8 levels.
@* @*
"long_paths" allows ISO file paths longer than 255 characters. "long_paths" allows ECMA-119 file paths longer than 255 characters.
@* @*
"long_names" allows up to 37 characters with ISO file names. "long_names" allows up to 37 characters with ECMA-119 file names.
@* @*
"no_force_dots" does not add a dot to ISO file names which have none. "no_force_dots" does not add a dot to ECMA-119 file names which have none.
@* @*
"no_j_force_dots" does not add a dot to Joliet file names which have none. "no_j_force_dots" does not add a dot to Joliet file names which have none.
@* @*
"lowercase" allows lowercase characters in ISO file names. "lowercase" allows lowercase characters in ECMA-119 file names.
@* @*
"full_ascii" allows all 8-bit characters except 0x0 and '/' "full_ascii" allows all 8-bit characters except 0x0 and '/'
in ISO file names. in ECMA-119 file names.
@* @*
"untranslated_names" might be dangerous for inadverted reader programs "untranslated_names" might be dangerous for inadverted reader programs
which rely on the restriction to at most 37 characters in ISO file names. which rely on the restriction to at most 37 characters in ECMA-119 file names.
This rule allows ISO file names up to 96 characters with no character This rule allows ECMA-119 file names up to 96 characters with no character
conversion. If a file name has more characters, then image production will conversion. If a file name has more characters, then image production will
fail deliberately. fail deliberately.
@* @*
@ -2735,15 +2738,17 @@ Default setting is
@* @*
always_gmt:old_rr". always_gmt:old_rr".
@* @*
Note: The term "ISO file" means the plain ISO 9660 names and attributes Note: The term "ECMA-119 name" means the plain ISO 9660 names and attributes
which get visible if the reader ignores Rock Ridge. which get visible if the reader ignores Rock Ridge.
@c man .TP @c man .TP
@item -rr_reloc_dir name @item -rr_reloc_dir name
@kindex -rr_reloc_dir sets name of relocation directory @kindex -rr_reloc_dir sets name of relocation directory
@cindex Relocation directory, set name, -rr_reloc_dir @cindex Relocation directory, set name, -rr_reloc_dir
Specify the name of the relocation directory in which deep directory subtrees Specify the name of the relocation directory in which deep directory subtrees
shall be placed if -compliance is set to "deep_paths_off". A deep directory shall be placed if -compliance is set to "deep_paths_off" or "long_paths_off".
is one that has a chain of 8 parent directories (including root) above itself. A deep directory is one that has a chain of 8 parent directories (including
root) above itself, or one that contains a file with an ECMA-119 path of more
than 255 characters.
@* @*
The overall directory tree will appear originally deep when interpreted The overall directory tree will appear originally deep when interpreted
as Rock Ridge tree. It will appear as re-arranged if only ECMA-119 as Rock Ridge tree. It will appear as re-arranged if only ECMA-119
@ -2764,7 +2769,7 @@ The name must not contain a '/' character and must not be longer than
Specify the volume ID. @command{xorriso} accepts any text up to 32 characters, Specify the volume ID. @command{xorriso} accepts any text up to 32 characters,
but according to rarely obeyed specs stricter rules apply: but according to rarely obeyed specs stricter rules apply:
@* @*
ECMA 119 demands ASCII characters out of [A-Z0-9_]. Like: "IMAGE_23" ECMA-119 demands ASCII characters out of [A-Z0-9_]. Like: "IMAGE_23"
@* @*
Joliet allows 16 UCS-2 characters. Like: "Windows name" Joliet allows 16 UCS-2 characters. Like: "Windows name"
@* @*
@ -3180,7 +3185,7 @@ The first "next" discards loaded boot images and their catalog.
@strong{patch} applies patching to existing boot images @strong{patch} applies patching to existing boot images
if they seem to bear a boot info table. if they seem to bear a boot info table.
@* @*
@cindex System area, _definiton @cindex System area, _definition
@cindex MBR, set, -boot_image system_area= @cindex MBR, set, -boot_image system_area=
@strong{system_area=}disk_path copies at most 32768 bytes from the given @strong{system_area=}disk_path copies at most 32768 bytes from the given
disk file to the very start of the ISO image. disk file to the very start of the ISO image.
@ -3192,7 +3197,7 @@ to the ISO image.
@* @*
-boot_image isolinux system_area= implies "partition_table=on". -boot_image isolinux system_area= implies "partition_table=on".
@* @*
@cindex Partition table, _definiton @cindex Partition table, _definition
@strong{partition_table=on} causes a simple partition table to be written @strong{partition_table=on} causes a simple partition table to be written
into bytes 446 to 511 of the System Area. into bytes 446 to 511 of the System Area.
@* @*
@ -3215,7 +3220,7 @@ then those parameters get updated when the new System Area is written.
Special "system_area=/dev/zero" causes 32k of NUL-bytes. Special "system_area=/dev/zero" causes 32k of NUL-bytes.
Use this to discard an MBR which was loaded with the ISO image. Use this to discard an MBR which was loaded with the ISO image.
@* @*
@cindex Partition offset, _definiton @cindex Partition offset, _definition
@strong{partition_offset=}2kb_block_adr causes a partition table with a single @strong{partition_offset=}2kb_block_adr causes a partition table with a single
partition that begins at the given block address. This is counted in 2048 byte partition that begins at the given block address. This is counted in 2048 byte
blocks, not in 512 byte blocks. If the block address is non-zero then it must blocks, not in 512 byte blocks. If the block address is non-zero then it must
@ -3226,7 +3231,7 @@ absolute start as well as from the partition start.
The offset value of an ISO image gets preserved when a new session is added. The offset value of an ISO image gets preserved when a new session is added.
So the value defined here is only in effect if a new ISO image gets written. So the value defined here is only in effect if a new ISO image gets written.
@* @*
@cindex Cylinder size, _definiton @cindex Cylinder size, _definition
@strong{partition_hd_cyl=}number gives the number of heads per cylinder for @strong{partition_hd_cyl=}number gives the number of heads per cylinder for
the partition table. 0 chooses a default value. Maximum is 255. the partition table. 0 chooses a default value. Maximum is 255.
@* @*
@ -3240,7 +3245,7 @@ then appropriate values of partition_hd_cyl are chosen with
partition_sec_hd 32 or 63. If the image is larger than 8,422,686,720 bytes, partition_sec_hd 32 or 63. If the image is larger than 8,422,686,720 bytes,
then the cylinder size constraints cannot be fulfilled. then the cylinder size constraints cannot be fulfilled.
@* @*
@cindex Cylinder alignment, _definiton @cindex Cylinder alignment, _definition
@strong{partition_cyl_align=}mode controls image size alignment to an integer @strong{partition_cyl_align=}mode controls image size alignment to an integer
number of cylinders. It is prescribed by isohybrid specs and it seems to number of cylinders. It is prescribed by isohybrid specs and it seems to
please program fdisk. Cylinder size must be divisible by 2048. please program fdisk. Cylinder size must be divisible by 2048.