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

Clarified xorriso documentation about deep directories

Browse Source
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
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" 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.
.\"
.\" Some roff macros, for reference:
@ -107,7 +107,8 @@ this text before reading the next few hundred lines of background information.
.SS
\fBSession model:\fR
.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
\fBsession\fR.
.br
@ -2200,8 +2201,8 @@ If enabled by "on", generate Joliet tree additional to ISO 9660 + Rock Ridge
tree.
.TP
\fB\-compliance\fR rule[:rule...]
Adjust the compliance to specifications of ISO 9660 and its contemporary
extensions. In some
Adjust the compliance to specifications of ISO 9660/ECMA\-119 and its
contemporary extensions. In some
cases it is worth to deviate a bit in order to circumvent bugs of the intended
reader system or to get unofficial extra features.
.br
@ -2213,40 +2214,40 @@ can be revoked individually by appending "_off". Like "deep_paths_off".
.br
Rule keywords are:
.br
"iso_9660_level="number chooses level 1 with ISO names of the form 8.3
and \-file_size_limit <= 4g \- 1, or level 2 with ISO names up to
length 32 and the same \-file_size_limit, or level 3 with ISO names up to
"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 ECMA\-119 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
gets adjusted.
.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
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
not 8.3.
.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
"only_iso_version" does not add versions (";1") to Joliet file names.
.br
"deep_paths" allows ISO file paths deeper than 8 levels.
"deep_paths" allows ECMA\-119 file paths deeper than 8 levels.
.br
"long_paths" allows ISO file paths longer than 255 characters.
"long_paths" allows ECMA\-119 file paths longer than 255 characters.
.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
"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
"no_j_force_dots" does not add a dot to Joliet file names which have none.
.br
"lowercase" allows lowercase characters in ISO file names.
"lowercase" allows lowercase characters in ECMA\-119 file names.
.br
"full_ascii" allows all 8\-bit characters except 0x0 and '/'
in ISO file names.
in ECMA\-119 file names.
.br
"untranslated_names" might be dangerous for inadverted reader programs
which rely on the restriction to at most 37 characters in ISO file names.
This rule allows ISO file names up to 96 characters with no character
which rely on the restriction to at most 37 characters in ECMA\-119 file names.
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
fail deliberately.
.br
@ -2294,13 +2295,15 @@ Default setting is
.br
always_gmt:old_rr".
.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.
.TP
\fB\-rr_reloc_dir\fR name
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
is one that has a chain of 8 parent directories (including root) above itself.
shall be placed if \-compliance is set to "deep_paths_off" or "long_paths_off".
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
The overall directory tree will appear originally deep when interpreted
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,
but according to rarely obeyed specs stricter rules apply:
.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
Joliet allows 16 UCS\-2 characters. Like: "Windows name"
.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
***************
Unlike other filesystems, ISO 9660 is not intended for read-write
operation but rather for being generated in a single sweep and being
written to media as a *session*.
Unlike other filesystems, *ISO 9660* (aka *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 *session*.
The data content of the session is called filesystem *image*.
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.
-compliance rule[:rule...]
Adjust the compliance to specifications of ISO 9660 and its
contemporary extensions. In some cases it is worth to deviate a
bit in order to circumvent bugs of the intended reader system or
Adjust the compliance to specifications of ISO 9660/ECMA-119 and
its contemporary extensions. In some cases it is worth to deviate
a bit in order to circumvent bugs of the intended reader system or
to get unofficial extra features.
There are several adjustable rules which have a keyword each. If
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
appending "_off". Like "deep_paths_off".
Rule keywords are:
"iso_9660_level="number chooses level 1 with ISO names of the form
8.3 and -file_size_limit <= 4g - 1, or level 2 with ISO names up to
length 32 and the same -file_size_limit, or level 3 with ISO names
up to length 32 and -file_size_limit >= 400g -200k. If necessary
-file_size_limit gets adjusted.
"allow_dir_id_ext" allows ISO names of directories to have a name
extension 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. Especially ISO level 1 only
"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 ECMA-119
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 gets adjusted.
"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 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 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.
"deep_paths" allows ISO file paths deeper than 8 levels.
"long_paths" allows ISO file paths longer than 255 characters.
"long_names" allows up to 37 characters with ISO file names.
"no_force_dots" does not add a dot to ISO file names which have
none.
"deep_paths" allows ECMA-119 file paths deeper than 8 levels.
"long_paths" allows ECMA-119 file paths longer than 255 characters.
"long_names" allows up to 37 characters with ECMA-119 file names.
"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.
"lowercase" allows lowercase characters in ISO file names.
"full_ascii" allows all 8-bit characters except 0x0 and '/' in ISO
file names.
"lowercase" allows lowercase characters in ECMA-119 file names.
"full_ascii" allows all 8-bit characters except 0x0 and '/' in
ECMA-119 file names.
"untranslated_names" might be dangerous for inadverted reader
programs which rely on the restriction to at most 37 characters in
ISO file names. This rule allows ISO file names up to 96
characters with no character conversion. If a file name has more
characters, then image production will fail deliberately.
ECMA-119 file names. 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 fail deliberately.
"untranslated_name_len="number enables untranslated_names with a
smaller limit for the length of file names. 0 disables this
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
"clear:only_iso_version:deep_paths:long_paths:no_j_force_dots:
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.
-rr_reloc_dir name
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 is one that has a chain of 8
parent directories (including root) above itself.
"deep_paths_off" or "long_paths_off". 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 as Rock Ridge tree. It will appear as re-arranged if
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
characters, but according to rarely obeyed specs stricter rules
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"
Joliet allows 16 UCS-2 characters. Like: "Windows 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)
* -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)
* -add inserts one or more paths: Insert. (line 42)
* -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)
* -append_partition adds arbitrary file after image end: Bootable.
(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)
* -assert_volid rejects undesired images: Loading. (line 84)
* -auto_charset learns character set from image: Loading. (line 98)
* -backslash_codes enables backslash conversion: Scripting. (line 67)
* -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)
* -boot_image controls bootability: Bootable. (line 26)
* -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_r sets ownership in ISO image: Manip. (line 47)
* -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_filter_list bans filter registration: Filter. (line 52)
* -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_r reports ISO/disk differences: Navigate. (line 159)
* -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_rx copies file trees to disk: Restore. (line 108)
* -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)
* -drive_class controls drive accessability: Loading. (line 54)
* -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)
* -dusx show directory size on disk: Navigate. (line 102)
* -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)
* -eject ejects drive tray: Writing. (line 52)
* -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)
* -for_backup -acl,-xattr,-hardlinks,-md5: Loading. (line 185)
* -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_r shows ACL in ISO image: Navigate. (line 77)
* -getfattr shows xattr in ISO image: Navigate. (line 81)
* -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)
* -hardlinks controls handling of hard links: Loading. (line 110)
* -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)
* -options_from_file reads commands from file: Scripting. (line 12)
* -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)
* -overwrite enables overwriting in ISO: SetInsert. (line 127)
* -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)
* -paste_in copies file into disk file: Restore. (line 121)
* -path_list inserts paths from disk file: Insert. (line 75)
* -pathspecs sets meaning of = with -add: SetInsert. (line 118)
* -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_info prints message text line: Scripting. (line 102)
* -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_help prints help text: Frontend. (line 33)
* -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)
* -pwd tells working directory in ISO: Navigate. (line 20)
* -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.
(line 69)
* -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)
* -status shows current settings: Scripting. (line 47)
* -status_history_max curbs -status history: Scripting. (line 56)
* -stdio_sync controls stdio buffer: SetWrite. (line 267)
* -stream_recording controls defect management: SetWrite. (line 248)
* -system_id sets system id: SetWrite. (line 150)
* -stdio_sync controls stdio buffer: SetWrite. (line 269)
* -stream_recording controls defect management: SetWrite. (line 250)
* -system_id sets system id: SetWrite. (line 152)
* -tell_media_space reports free space: Inquiry. (line 89)
* -temp_mem_limit curbs memory consumption: Scripting. (line 92)
* -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_l inserts paths if different: Insert. (line 121)
* -update_r inserts paths if different: Insert. (line 110)
* -use_readline enables readline for dialog: DialogCtl. (line 28)
* -version prints help text: Scripting. (line 23)
* -volid sets volume id: SetWrite. (line 111)
* -volset_id sets volume set id: SetWrite. (line 130)
* -volume_date sets volume timestamp: SetWrite. (line 157)
* -volid sets volume id: SetWrite. (line 113)
* -volset_id sets volume set id: SetWrite. (line 132)
* -volume_date sets volume timestamp: SetWrite. (line 159)
* -x enables automatic execution order of arguments: ArgSort.
(line 16)
* -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
@ -4574,7 +4576,7 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
[index]
* Menu:
* ACL, _definiton: Extras. (line 38)
* ACL, _definition: Extras. (line 38)
* ACL, control handling, -acl: Loading. (line 143)
* ACL, set in ISO image, -setfacl: Manip. (line 73)
* 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, for input, -in_charset: Loading. (line 92)
* 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, of terminal, -local_charset: Charset. (line 47)
* Closed media, _definition: Media. (line 43)
* Comment, #: Scripting. (line 162)
* Control, signal handling, -signal_handling: Exception. (line 69)
* Create, new ISO image, _definiton: Methods. (line 6)
* Cylinder alignment, _definiton: Bootable. (line 167)
* Cylinder size, _definiton: Bootable. (line 156)
* Create, new ISO image, _definition: Methods. (line 6)
* Cylinder alignment, _definition: Bootable. (line 167)
* Cylinder size, _definition: Bootable. (line 156)
* Damaged track and session, close, -close_damaged: Writing. (line 152)
* Delete, from ISO image, -rm: Manip. (line 21)
* 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, delete, -rmdir: Manip. (line 32)
* disk_path, _definition: Insert. (line 6)
* Drive, _definiton: Drives. (line 6)
* Drive, _definition: Drives. (line 6)
* Drive, accessability, -drive_class: Loading. (line 54)
* Drive, classify stdio, -early_stdio_test: Loading. (line 252)
* 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, report SCSI commands, -scsi_log: Scripting. (line 147)
* Drive, write and eject, -commit_eject: Writing. (line 56)
* EA, _definiton: Extras. (line 54)
* El Torito, _definiton: Extras. (line 19)
* EA, _definition: Extras. (line 54)
* ECMA-119, _definition: Model. (line 6)
* El Torito, _definition: Extras. (line 19)
* Emulation, -as: Emulation. (line 13)
* Emulation, .mkisofsrc, -read_mkisofsrc: Emulation. (line 146)
* Emulation, cdrecord, -as: Emulation. (line 111)
* Emulation, mkisofs, -as: Emulation. (line 16)
* Emulation, pacifier form, -pacifier: Emulation. (line 158)
* Examples: Examples. (line 6)
* extattr, _definiton: Extras. (line 54)
* extattr, _definition: Extras. (line 54)
* Filter, _definition: Filter. (line 6)
* Filter, apply to file tree, -set_filter_r: Filter. (line 89)
* 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 chains of tree, -show_stream_r: Navigate. (line 183)
* Filter, unregister, -unregister_filter: Filter. (line 48)
* Filter, zisofs parameters, -zisofs: SetWrite. (line 221)
* Group, global in ISO image, -gid: SetWrite. (line 217)
* Filter, zisofs parameters, -zisofs: SetWrite. (line 223)
* Group, global in ISO image, -gid: SetWrite. (line 219)
* Group, in ISO image, -chgrp: Manip. (line 50)
* Group, in ISO image, -chgrp_r: Manip. (line 55)
* 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, discard pending changes, -rollback: Writing. (line 9)
* Image, override change status, -changes_pending: Writing. (line 13)
* Image, set abstract file name, -abstract_file: SetWrite. (line 182)
* Image, set application id, -application_id: SetWrite. (line 141)
* Image, set biblio file name, -biblio_file: SetWrite. (line 189)
* Image, set copyright file name, -copyright_file: SetWrite. (line 176)
* Image, set preparer id, -preparer_id: SetWrite. (line 195)
* Image, set publisher id, -publisher: SetWrite. (line 135)
* Image, set system id, -system_id: SetWrite. (line 150)
* Image, set volume id, -volid: SetWrite. (line 111)
* Image, set volume set id, -volset_id: SetWrite. (line 130)
* Image, set volume timestamp, -volume_date: SetWrite. (line 157)
* Image, set abstract file name, -abstract_file: SetWrite. (line 184)
* Image, set application id, -application_id: SetWrite. (line 143)
* Image, set biblio file name, -biblio_file: SetWrite. (line 191)
* Image, set copyright file name, -copyright_file: SetWrite. (line 178)
* Image, set preparer id, -preparer_id: SetWrite. (line 197)
* Image, set publisher id, -publisher: SetWrite. (line 137)
* Image, set system id, -system_id: SetWrite. (line 152)
* Image, set volume id, -volid: SetWrite. (line 113)
* Image, set volume set id, -volset_id: SetWrite. (line 132)
* Image, set volume timestamp, -volume_date: SetWrite. (line 159)
* Image, show id strings, -pvd_info: Inquiry. (line 93)
* Insert, enable overwriting, -overwrite: SetInsert. (line 127)
* 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, pathspecs, -add: Insert. (line 42)
* Insert, piece of data file, -cut_out: Insert. (line 126)
* ISO 9660, _definition: Model. (line 6)
* iso_rr_path, _definition: Insert. (line 7)
* Jigdo Template Extraction, -jigdo: Jigdo. (line 33)
* Jigdo Template Extraction, _definition: Jigdo. (line 6)
* List delimiter, _definiton: Processing. (line 9)
* MBR, _definiton: Extras. (line 26)
* List delimiter, _definition: Processing. (line 9)
* MBR, _definition: Extras. (line 26)
* MBR, set, -boot_image system_area=: Bootable. (line 121)
* MD5, control handling, -md5: Loading. (line 156)
* 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)
* Next writeable address, -grow_blindly: AqDrive. (line 46)
* 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_r: Manip. (line 47)
* Partition offset, _definiton: Bootable. (line 146)
* Partition table, _definiton: Bootable. (line 128)
* Partition offset, _definition: Bootable. (line 146)
* Partition table, _definition: Bootable. (line 128)
* Pathspec, _definition: SetInsert. (line 120)
* Pattern expansion, _definition: Processing. (line 24)
* 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, status history, -status_history_max: Scripting. (line 56)
* 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)
* Relocation directory, set name, -rr_reloc_dir: SetWrite. (line 94)
* 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, -extract_l: Restore. (line 76)
* 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, altered start address, -displacement: Loading. (line 36)
* 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)
* SUN Disk Label, production: Bootable. (line 187)
* 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, show, -toc: Inquiry. (line 28)
* 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 tree checksums, -check_md5_r: Verify. (line 164)
* 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, buffer syncing, -stdio_sync: SetWrite. (line 267)
* Write, close media, -close: SetWrite. (line 284)
* Write, buffer syncing, -stdio_sync: SetWrite. (line 269)
* Write, close media, -close: SetWrite. (line 286)
* 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, fifo size, -fs: SetWrite. (line 277)
* Write, fifo size, -fs: SetWrite. (line 279)
* Write, free space, -tell_media_space: Inquiry. (line 89)
* Write, log problematic disk files, -errfile_log: Scripting. (line 118)
* 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, predict image size, -print_size: Inquiry. (line 80)
* Write, set speed, -speed: SetWrite. (line 233)
* Write, simulation, -dummy: SetWrite. (line 273)
* xattr, _definiton: Extras. (line 54)
* Write, set speed, -speed: SetWrite. (line 235)
* Write, simulation, -dummy: SetWrite. (line 275)
* xattr, _definition: Extras. (line 54)
* xattr, control handling, -xattr: Loading. (line 151)
* xattr, set in ISO image, -setfattr: Manip. (line 111)
* xattr, set in ISO image, -setfattr_list: Manip. (line 127)
@ -4839,57 +4843,57 @@ Tag Table:
Node: Top420
Node: Overview1375
Node: Model3264
Node: Media6151
Node: Methods8822
Node: Drives11397
Node: Extras14712
Node: Processing18433
Node: Dialog22053
Node: Options23730
Node: ArgSort25404
Node: AqDrive26894
Node: Loading29938
Node: Insert45147
Node: SetInsert54862
Node: Manip63438
Node: CmdFind72174
Node: Filter84283
Node: Writing88838
Node: SetWrite97802
Node: Bootable113077
Node: Jigdo126299
Node: Charset130545
Node: Exception133306
Node: DialogCtl139425
Node: Inquiry142022
Node: Navigate146888
Node: Verify155149
Node: Restore163838
Node: Emulation170747
Node: Scripting180558
Node: Frontend187718
Node: Examples189018
Node: ExDevices190195
Node: ExCreate190854
Node: ExDialog192139
Node: ExGrowing193404
Node: ExModifying194209
Node: ExBootable194713
Node: ExCharset195265
Node: ExPseudo196086
Node: ExCdrecord196984
Node: ExMkisofs197301
Node: ExGrowisofs198641
Node: ExException199776
Node: ExTime200230
Node: ExIncBackup200689
Node: ExRestore204680
Node: ExRecovery205640
Node: Files206210
Node: Seealso207509
Node: Bugreport208232
Node: Legal208813
Node: CommandIdx209743
Node: ConceptIdx225331
Node: Media6170
Node: Methods8841
Node: Drives11416
Node: Extras14731
Node: Processing18452
Node: Dialog22072
Node: Options23749
Node: ArgSort25423
Node: AqDrive26913
Node: Loading29957
Node: Insert45166
Node: SetInsert54881
Node: Manip63457
Node: CmdFind72193
Node: Filter84302
Node: Writing88857
Node: SetWrite97821
Node: Bootable113285
Node: Jigdo126507
Node: Charset130753
Node: Exception133514
Node: DialogCtl139633
Node: Inquiry142230
Node: Navigate147096
Node: Verify155357
Node: Restore164046
Node: Emulation170955
Node: Scripting180766
Node: Frontend187926
Node: Examples189226
Node: ExDevices190403
Node: ExCreate191062
Node: ExDialog192347
Node: ExGrowing193612
Node: ExModifying194417
Node: ExBootable194921
Node: ExCharset195473
Node: ExPseudo196294
Node: ExCdrecord197192
Node: ExMkisofs197509
Node: ExGrowisofs198849
Node: ExException199984
Node: ExTime200438
Node: ExIncBackup200897
Node: ExRestore204888
Node: ExRecovery205848
Node: Files206418
Node: Seealso207717
Node: Bugreport208440
Node: Legal209021
Node: CommandIdx209951
Node: ConceptIdx225539

End Tag Table

79
xorriso/xorriso.texi
View File

@ -50,7 +50,7 @@
@c man .\" First parameter, NAME, should be all caps
@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 .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 .\"
@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 .br
@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
@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:
@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}
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
@ -397,7 +400,7 @@ and the burn program is desired. -C $msc1,$msc2 is equivalent to:
@chapter Libburn drives
@c man .B Libburn drives:
@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
access readable libburn drive: optical media with readable data,
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
@c man .B Rock Ridge, POSIX, X/Open, El Torito, ACL, xattr:
@c man .br
@cindex Rock Ridge, _definiton
@cindex Rock Ridge, _definition
@strong{Rock Ridge}
is the name of a set of additional information which enhance
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.
@c man .PP
@sp 1
@cindex El Torito, _definiton
@cindex El Torito, _definition
An @strong{El Torito}
boot record points the BIOS bootstrapping facility to one or more boot
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
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
hard-disk-like media by -boot_image parameter system_area= . This installs
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
@sp 1
@cindex ACL, _definiton
@cindex ACL, _definition
@strong{ACL}
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
@ -566,9 +569,9 @@ Recording and restoring of ACLs from and to local files works currently
only on GNU/Linux and FreeBSD.
@c man .PP
@sp 1
@cindex xattr, _definiton
@cindex EA, _definiton
@cindex extattr, _definiton
@cindex xattr, _definition
@cindex EA, _definition
@cindex extattr, _definition
@strong{xattr} (aka EA, or extattr)
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
@ -596,7 +599,7 @@ given as program arguments and command
@strong{-x}
is among them.
@*
@cindex List delimiter, _definiton
@cindex List delimiter, _definition
Commands consist of a command word,
followed by zero or more parameter words. If the list of parameter words
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.
@c man .PP
@sp 1
@cindex Quoted input, _definiton
@cindex Quoted input, _definition
@strong{Quoted input}
converts whitespace-separated text into words.
The double quotation mark " and the single quotation mark ' can be used to
@ -2641,8 +2644,8 @@ tree.
@item -compliance rule[:rule...]
@kindex -compliance controls standard compliance
@cindex Write, compliance to specs, -compliance
Adjust the compliance to specifications of ISO 9660 and its contemporary
extensions. In some
Adjust the compliance to specifications of ISO 9660/ECMA-119 and its
contemporary extensions. In some
cases it is worth to deviate a bit in order to circumvent bugs of the intended
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:
@*
"iso_9660_level="number chooses level 1 with ISO names of the form 8.3
and -file_size_limit <= 4g - 1, or level 2 with ISO names up to
length 32 and the same -file_size_limit, or level 3 with ISO names up to
"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 ECMA-119 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
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
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
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.
@*
"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.
@*
"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 file names.
in ECMA-119 file names.
@*
"untranslated_names" might be dangerous for inadverted reader programs
which rely on the restriction to at most 37 characters in ISO file names.
This rule allows ISO file names up to 96 characters with no character
which rely on the restriction to at most 37 characters in ECMA-119 file names.
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
fail deliberately.
@*
@ -2735,15 +2738,17 @@ Default setting is
@*
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.
@c man .TP
@item -rr_reloc_dir name
@kindex -rr_reloc_dir sets name of relocation directory
@cindex Relocation directory, set name, -rr_reloc_dir
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
is one that has a chain of 8 parent directories (including root) above itself.
shall be placed if -compliance is set to "deep_paths_off" or "long_paths_off".
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
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,
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"
@*
@ -3180,7 +3185,7 @@ The first "next" discards loaded boot images and their catalog.
@strong{patch} applies patching to existing boot images
if they seem to bear a boot info table.
@*
@cindex System area, _definiton
@cindex System area, _definition
@cindex MBR, set, -boot_image system_area=
@strong{system_area=}disk_path copies at most 32768 bytes from the given
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".
@*
@cindex Partition table, _definiton
@cindex Partition table, _definition
@strong{partition_table=on} causes a simple partition table to be written
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.
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
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
@ -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.
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
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,
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
number of cylinders. It is prescribed by isohybrid specs and it seems to
please program fdisk. Cylinder size must be divisible by 2048.