diff --git a/xorriso/xorriso.1 b/xorriso/xorriso.1 index a40fe82c..407e34cd 100644 --- a/xorriso/xorriso.1 +++ b/xorriso/xorriso.1 @@ -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