libburnia/legacy
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 a0b8588598
commit 3df66e608b
3 changed files with 214 additions and 202 deletions
Download Patch File Download Diff File Expand all files Collapse all files

45
libisoburn/trunk/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