More emphasis on early use of -hardlinks, -acl, -xattr etc.
This commit is contained in:
parent
de28197e01
commit
697ba0d9a6
@ -2,7 +2,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 "Jun 27, 2009"
|
||||
.TH XORRISO 1 "Jul 22, 2009"
|
||||
.\" Please adjust this date whenever revising the manpage.
|
||||
.\"
|
||||
.\" Some roff macros, for reference:
|
||||
@ -519,14 +519,15 @@ try to abort as soon as possible.
|
||||
.SH OPTIONS
|
||||
.br
|
||||
All command words are shown with a leading dash although this dash is not
|
||||
mandatory for the option to be recognized. There may be future emulation
|
||||
modes, where dashes may become mandatory in order to distinguish options
|
||||
from file addresses.
|
||||
mandatory for the option to be recognized. Note that with emulation modes the
|
||||
dashes of the emulated options are mandatory.
|
||||
.br
|
||||
Normally any number of leading dashes is ignored with command words and
|
||||
inner dashes are interpreted as underscores.
|
||||
.TP
|
||||
.B Aquiring source and target drive:
|
||||
Before aquiring a drive one will eventually enable options which influence
|
||||
the behavior of image loading. See next option group.
|
||||
.TP
|
||||
\fB\-dev\fR address
|
||||
Set input and output drive to the same address and load an eventual ISO image.
|
||||
@ -565,6 +566,53 @@ apply. See above paragraph "Libburn drives".
|
||||
An empty address string "" gives up the current output drive
|
||||
without aquiring a new one. No writing is possible without an output drive.
|
||||
.TP
|
||||
\fB\-grow_blindly\fR "off"|predicted_nwa
|
||||
If predicted_nwa is a non-negative number then perform blind growing rather
|
||||
than modifying if -indev and -outdev are set to different drives.
|
||||
"off" or "-1" switch to modifying, which is the default.
|
||||
.br
|
||||
predicted_nwa is the block address where the add-on session of blind
|
||||
growing will finally end up. It is the responsibility of the user to ensure
|
||||
this final position and the presence of the older sessions. Else the
|
||||
overall ISO image will not be mountable or will produce read errors when
|
||||
accessing file content. xorriso will write the session to the address
|
||||
as obtained from examining -outdev and not necessarily to predicted_nwa.
|
||||
.br
|
||||
During a run of blind growing, the input drive is given up before output
|
||||
begins. The output drive is given up when writing is done.
|
||||
.TP
|
||||
.B Influencing the behavior of image loading:
|
||||
The following options should normally be performed before loading an image
|
||||
by aquiring an input drive. In rare cases it is desirable to activate
|
||||
them only after image loading.
|
||||
.TP
|
||||
\fB\-load\fR entity id
|
||||
Load a particular (possibly outdated) ISO image from -dev or -indev.
|
||||
Usually all available sessions are shown with option -toc.
|
||||
.br
|
||||
entity depicts the kind of addressing. id depicts the particular
|
||||
address. The following entities are defined:
|
||||
.br
|
||||
"auto" with any id addresses the last session in -toc. This is the default.
|
||||
.br
|
||||
"session" with id being a number as of a line "ISO session", column "Idx".
|
||||
.br
|
||||
"track" with id being a number as of a line "ISO track", column "Idx".
|
||||
.br
|
||||
"lba" or "sbsector" with a number as of a line "ISO ...", column "sbsector".
|
||||
.br
|
||||
"volid" with a search pattern for a text as of a line "ISO ...",
|
||||
column "Volume Id".
|
||||
.br
|
||||
Adressing a non-existing entity or one which does not represent an ISO
|
||||
image will either abandon -indev or at least lead to a blank image.
|
||||
.br
|
||||
If an input drive is set at the moment when -load is executed, then the
|
||||
addressed ISO image is loaded immediately. Else, the setting will be pending
|
||||
until the next -dev or -indev. After the image has been loaded once, the
|
||||
setting is valid for -rollback until next -dev or -indev, where it
|
||||
will be reset to "auto".
|
||||
.TP
|
||||
\fB\-drive_class\fR "harmless"|"banned"|"caution"|"clear_list" disk_pattern
|
||||
Add a drive path pattern to one of the safety lists or make those lists empty.
|
||||
There are three lists defined which get tested in the following sequence:
|
||||
@ -600,48 +648,6 @@ Note: This is not a security feature but rather a bumper for the superuser to
|
||||
prevent inadverted mishaps. For reliably blocking access to a device file you
|
||||
have to deny its rw-permissions in the filesystem.
|
||||
.TP
|
||||
\fB\-grow_blindly\fR "off"|predicted_nwa
|
||||
If predicted_nwa is a non-negative number then perform blind growing rather
|
||||
than modifying if -indev and -outdev are set to different drives.
|
||||
"off" or "-1" switch to modifying, which is the default.
|
||||
.br
|
||||
predicted_nwa is the block address where the add-on session of blind
|
||||
growing will finally end up. It is the responsibility of the user to ensure
|
||||
this final position and the presence of the older sessions. Else the
|
||||
overall ISO image will not be mountable or will produce read errors when
|
||||
accessing file content. xorriso will write the session to the address
|
||||
as obtained from examining -outdev and not necessarily to predicted_nwa.
|
||||
.br
|
||||
During a run of blind growing, the input drive is given up before output
|
||||
begins. The output drive is given up when writing is done.
|
||||
.TP
|
||||
\fB\-load\fR entity id
|
||||
Load a particular (possibly outdated) ISO image from -dev or -indev.
|
||||
Usually all available sessions are shown with option -toc.
|
||||
.br
|
||||
entity depicts the kind of addressing. id depicts the particular
|
||||
address. The following entities are defined:
|
||||
.br
|
||||
"auto" with any id addresses the last session in -toc. This is the default.
|
||||
.br
|
||||
"session" with id being a number as of a line "ISO session", column "Idx".
|
||||
.br
|
||||
"track" with id being a number as of a line "ISO track", column "Idx".
|
||||
.br
|
||||
"lba" or "sbsector" with a number as of a line "ISO ...", column "sbsector".
|
||||
.br
|
||||
"volid" with a search pattern for a text as of a line "ISO ...",
|
||||
column "Volume Id".
|
||||
.br
|
||||
Adressing a non-existing entity or one which does not represent an ISO
|
||||
image will either abandon -indev or at least lead to a blank image.
|
||||
.br
|
||||
If an input drive is set at the moment when -load is executed, then the
|
||||
addressed ISO image is loaded immediately. Else, the setting will be pending
|
||||
until the next -dev or -indev. After the image has been loaded once, the
|
||||
setting is valid for -rollback until next -dev or -indev, where it
|
||||
will be reset to "auto".
|
||||
.TP
|
||||
\fB\-assert_volid\fR pattern severity
|
||||
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
|
||||
|
Loading…
x
Reference in New Issue
Block a user