New option -close_damaged

2011-06-01 16:52:29 +00:00
parent 59154653db
commit 85805ee265
11 changed files with 172 additions and 42 deletions
--- a/xorriso/xorriso.info
+++ b/xorriso/xorriso.info
@ -1828,6 +1828,20 @@ File: xorriso.info,  Node: Writing,  Next: SetWrite,  Prev: Filter,  Up: Options
     Smaller format size with DVD-RAM, BD-RE, or BD-R means more
     reserve space.

+-close_damaged "as_needed"|"force"
+     Try to close the upcomming track and session if the drive reported
+     the media as damaged. This may apply to CD-R, CD-RW, DVD-R,
+     DVD-RW, DVD+R, DVD+R DL, or BD-R media. It is indicated by warning
+     messages when the drive gets aquired, and by a remark "but next
+     track is damaged" with the line "Media status :" of command -toc.
+     The setting of option -close determines whether the media stays
+     appendable.
+     Mode "as_needed" gracefully refuses on media which are not
+     reported as damaged. Mode "force" attempts the close operation
+     even with media which appear undamaged.
+     No image changes are allowed to be pending before this command is
+     performed.  After closing was attempted, both drives are given up.
+
 -list_profiles "in"|"out"|"all"
     Put out a list of media types supported by -indev, resp. -outdev,
     resp. both.  The currently recognized type is marked by text
@ -4192,6 +4206,7 @@ File: xorriso.info,  Node: CommandIdx,  Next: ConceptIdx,  Prev: Legal,  Up: Top
 * -chown_r   sets ownership in ISO image: Manip.              (line  47)
 * -clone   copies ISO directory tree:    Insert.              (line 171)
 * -close   controls media closing:       SetWrite.            (line 262)
+* -close_damaged   closes damaged track and session: Writing. (line 122)
 * -close_filter_list   bans filter registration: Filter.      (line  52)
 * -commit   writes pending ISO image:    Writing.             (line  13)
 * -commit_eject    writes and ejects:    Writing.             (line  40)
@ -4255,7 +4270,7 @@ File: xorriso.info,  Node: CommandIdx,  Next: ConceptIdx,  Prev: Legal,  Up: Top
 * -joliet   enables production of Joliet tree: SetWrite.      (line  10)
 * -list_delimiter   replaces '--':       Scripting.           (line  42)
 * -list_formats   lists available formats: Writing.           (line 110)
-* -list_profiles   lists supported media: Writing.            (line 122)
+* -list_profiles   lists supported media: Writing.            (line 136)
 * -load   addresses a particular session as input: Loading.   (line  11)
 * -local_charset   sets terminal character set: Charset.      (line  47)
 * -logfile   logs output channels to file: Frontend.          (line  20)
@ -4396,6 +4411,7 @@ File: xorriso.info,  Node: ConceptIdx,  Prev: CommandIdx,  Up: Top
 * Create, new ISO image, _definiton:     Methods.             (line   6)
 * Cylinder alignment, _definiton:        Bootable.            (line 169)
 * Cylinder size, _definiton:             Bootable.            (line 158)
+* Damaged track and session, close, -close_damaged: Writing.  (line 122)
 * Delete, from ISO image, -rm:           Manip.               (line  21)
 * Delete, from ISO image, -rm_r:         Manip.               (line  28)
 * Delete, ISO directory, -rmdir:         Manip.               (line  32)
@ -4418,7 +4434,7 @@ File: xorriso.info,  Node: ConceptIdx,  Prev: CommandIdx,  Up: Top
 * Drive, for input, -indev:              AqDrive.             (line  22)
 * Drive, for output, -outdev:            AqDrive.             (line  29)
 * Drive, get drive list, -devices:       Inquiry.             (line   7)
-* Drive, list supported media, -list_profiles: Writing.       (line 122)
+* Drive, list supported media, -list_profiles: Writing.       (line 136)
 * Drive, reduce activity, -calm_drive:   Loading.             (line 235)
 * Drive, report SCSI commands, -scsi_log: Scripting.          (line 125)
 * Drive, write and eject, -commit_eject: Writing.             (line  40)
@ -4634,41 +4650,41 @@ Node: Manip60375
 Node: CmdFind69060
 Node: Filter80363
 Node: Writing84720
-Node: SetWrite91164
-Node: Bootable105210
-Node: Jigdo118530
-Node: Charset122794
-Node: Exception125553
-Node: DialogCtl131693
-Node: Inquiry134280
-Node: Navigate138663
-Node: Verify146603
-Node: Restore155198
-Node: Emulation161858
-Node: Scripting171731
-Node: Frontend177881
-Node: Examples179180
-Node: ExDevices180351
-Node: ExCreate180989
-Node: ExDialog182263
-Node: ExGrowing183525
-Node: ExModifying184327
-Node: ExBootable184828
-Node: ExCharset185377
-Node: ExPseudo186205
-Node: ExCdrecord187103
-Node: ExMkisofs187418
-Node: ExGrowisofs188756
-Node: ExException189891
-Node: ExTime190345
-Node: ExIncBackup190804
-Node: ExRestore194728
-Node: ExRecovery195697
-Node: Files196263
-Node: Seealso197561
-Node: Bugreport198149
-Node: Legal198730
-Node: CommandIdx199660
-Node: ConceptIdx214328
+Node: SetWrite91955
+Node: Bootable106001
+Node: Jigdo119321
+Node: Charset123585
+Node: Exception126344
+Node: DialogCtl132484
+Node: Inquiry135071
+Node: Navigate139454
+Node: Verify147394
+Node: Restore155989
+Node: Emulation162649
+Node: Scripting172522
+Node: Frontend178672
+Node: Examples179971
+Node: ExDevices181142
+Node: ExCreate181780
+Node: ExDialog183054
+Node: ExGrowing184316
+Node: ExModifying185118
+Node: ExBootable185619
+Node: ExCharset186168
+Node: ExPseudo186996
+Node: ExCdrecord187894
+Node: ExMkisofs188209
+Node: ExGrowisofs189547
+Node: ExException190682
+Node: ExTime191136
+Node: ExIncBackup191595
+Node: ExRestore195519
+Node: ExRecovery196488
+Node: Files197054
+Node: Seealso198352
+Node: Bugreport198940
+Node: Legal199521
+Node: CommandIdx200451
+Node: ConceptIdx215192

 End Tag Table