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

Corrections in xorriso manual. Proposed by Paul Menzel.

Browse Source
This commit is contained in:
Thomas Schmitt
2012-11-05 09:37:47 +00:00
parent b0f8246ff2
commit 7353d3534e
3 changed files with 226 additions and 215 deletions
Download Patch File Download Diff File Expand all files Collapse all files

49
libisoburn/trunk/xorriso/xorriso.1
View File

@ -771,7 +771,7 @@ prevent inadverted mishaps. For reliably blocking access to a device file you
have to deny its rw\-permissions in the filesystem.
.TP
\fB\-assert_volid\fR pattern severity
Refuse to load ISO images with volume ids which do not match the given
Refuse to load ISO images with volume IDs which do not match the given
search pattern. When refusing an image, give up the input drive and issue
an event of the given severity (like FAILURE, see \-abort_on). An empty search
pattern accepts any image.
@ -2467,49 +2467,54 @@ The name must not contain a '/' character and must not be longer than
255 bytes.
.TP
\fB\-volid\fR text
Specify the volume ID. \fBxorriso\fR accepts any text up to 32 characters,
Specify the volume ID, which can be considered to be the name of the image.
\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:
.br
Joliet allows 16 UCS\-2 characters. Like: "Windows name"
"IMAGE_23"
.br
Be aware that the volume id might get used automatically as name of the
Joliet allows 16 UCS\-2 characters. Like:
.br
"Windows name"
.br
Be aware that the volume id might get used automatically as the name of the
mount point when the medium is inserted into a playful computer system.
.br
If an ISO image gets loaded while the volume ID is set to default "ISOIMAGE"
or to "", then the volume ID of the loaded image will become the effective
volume id for the next write run. But as soon as command \-volid is performed
afterwards, this pending id is overridden by the new setting.
afterwards, this pending ID is overridden by the new setting.
.br
Consider this when setting \-volid "ISOIMAGE" before executing \-dev, \-indev,
or \-rollback.
If you insist in \-volid "ISOIMAGE", set it again after those commands.
.TP
\fB\-volset_id\fR text
Set the volume set id string to be written with the next \-commit.
Set the volume set ID string to be written with the next \-commit.
Permissible are up to 128 characters. This setting gets overridden by
image loading.
.TP
\fB\-publisher\fR text
Set the publisher id string to be written with the next \-commit. This may
Set the publisher ID string to be written with the next \-commit. This may
identify the person or organisation who specified what shall be recorded.
Permissible are up to 128 characters. This setting gets overridden by
image loading.
.TP
\fB\-application_id\fR text
Set the application id string to be written with the next \-commit. This may
Set the application ID string to be written with the next \-commit. This may
identify the specification of how the data are recorded.
Permissible are up to 128 characters. This setting gets overridden by
image loading.
.br
The special text "@xorriso@" gets converted to the id string of
The special text "@xorriso@" gets converted to the ID string of
\fBxorriso\fR
which is normally written as \-preparer_id. It is a wrong tradition to write
the program id as \-application_id.
the program ID as \-application_id.
.TP
\fB\-system_id\fR text
Set the system id string to be written with the next \-commit. This may
Set the system ID string to be written with the next \-commit. This may
identify the system which can recognize and act upon the content of the
System Area in image blocks 0 to 15.
Permissible are up to 32 characters. This setting gets overridden by
@ -2564,16 +2569,16 @@ Permissible are up to 37 characters. This setting gets overridden by
image loading.
.TP
\fB\-preparer_id\fR
Set the preparer id string to be written with the next \-commit. This may
Set the preparer ID string to be written with the next \-commit. This may
identify the person or other entity which controls the preparation of the data
which shall be recorded. Normally this should be the id of \fBxorriso\fR
which shall be recorded. Normally this should be the ID of \fBxorriso\fR
and not of the person or program which operates \fBxorriso\fR.
Please avoid to change it. Permissible are up to 128 characters.
.br
The special text "@xorriso@" gets converted to the id string of
The special text "@xorriso@" gets converted to the ID string of
\fBxorriso\fR which is default at program startup.
.br
Unlike other id strings, this setting is not influenced by image loading.
Unlike other ID strings, this setting is not influenced by image loading.
.TP
\fB\-out_charset\fR character_set_name
Set the character set to which file names get converted when writing an
@ -3474,9 +3479,9 @@ Print available space on the output medium and the free space after
subtracting already foreseeable consumption by next \-commit.
.TP
\fB\-pvd_info\fR
Print various id strings which can be found in loaded ISO images. Some of
Print various ID strings which can be found in loaded ISO images. Some of
them may be changed by commands like \-volid or \-publisher. For these
ids \-pvd_info reports what would be written with the next \-commit.
IDs \-pvd_info reports what would be written with the next \-commit.
.TP
.B Navigation in ISO image and disk filesystem:
.TP
@ -3820,7 +3825,7 @@ and their start block addresses, followed by binary bitmap data.
.br
\fBmap_with_volid="on"\fR
examines tracks whether they are ISO images and
prints their volume ids into the human readable TOC of sector_map=.
prints their volume IDs into the human readable TOC of sector_map=.
.br
\fBpatch_lba0="on"\fR
transfers within the data_to= file a copy of the currently
@ -4400,11 +4405,11 @@ This transport becomes visible with \-report_about "ALL".
If path is not empty it gives the address of a plain text file where
a log record gets appended after each session. This log can be used to
determine the start_lba of a session for mount options \-o sbsector=
resp. \-s from date or volume id.
resp. \-s from date or volume ID.
.br
Record format is: timestamp start_lba size volume\-id
.br
The first three items are single words, the rest of the line is the volume id.
The first three items are single words, the rest of the line is the volume ID.
.TP
\fB\-scsi_log\fR "on"|"off"
Mode "on" enables very verbous logging of SCSI commands and drive replies.
@ -4840,7 +4845,7 @@ accordingly.
.br
ACL, xattr, hard links and MD5 checksums will be recorded.
Accelerated comparison is enabled at the expense of potentially larger backup
size. Only media with the expected volume id or blank media are accepted.
size. Only media with the expected volume ID or blank media are accepted.
Files with names matching *.o or *.swp get excluded explicitly.
.br
When done with writing the new session gets checked by its recorded MD5.