diff --git a/xorriso/xorriso.1 b/xorriso/xorriso.1 index 2d4c45b3..7834fcff 100644 --- a/xorriso/xorriso.1 +++ b/xorriso/xorriso.1 @@ -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.3.3, Oct 27, 2013" +.TH XORRISO 1 "Version 1.3.3, Nov 14, 2013" .\" Please adjust this date whenever revising the manpage. .\" .\" Some roff macros, for reference: @@ -716,13 +716,14 @@ Example speeds: If there is no hint about the speed unit attached, then the medium in the \-indev will decide. Default unit is CD = 176.4k. .br -MMC drives usually activate their own idea of speed and take -the speed value given by the burn program only as upper limit -for their own decision. +Depending on the drive, the reported read speeds can be deceivingly low +or high. Therefore "min" cannot become higher than 1x speed of the involved +medium type. Read speed "max" cannot become lower than 52xCD, 24xDVD, +or 20xBD, depending on the medium type. .br -Depending on the drive, the reported read speeds can be deceivingly low. -Often it is possible to achieve higher read speeds by bold values -like "20xDVD" or "16xBD". +MMC drives usually activate their own idea of speed and take +the speed value given by the burn program only as hint +for their own decision. .TP \fB\-load\fR entity id Load a particular (possibly outdated) ISO session from \-dev or \-indev. @@ -2346,7 +2347,9 @@ Only if the drive reports contradicting speed information there will appear \-speed 0, if it deviates from "Write speed H". .br "Read speed L" and "Read speed H" tell the minimum and maximum read speeds, -as would be chosen by \-read_speed "min" resp. "max". +as reported by the drive. They would be chosen by \-read_speed "min" resp. +"max" if they undercut resp. surpass the built\-in limits. These are "1x" +resp. "52xCD", "24xDVD", "20xBD". .TP \fB\-close_damaged\fR "as_needed"|"force" Try to close the upcomming track and session if the drive reported the medium diff --git a/xorriso/xorriso.info b/xorriso/xorriso.info index 7375517b..360d3a39 100644 --- a/xorriso/xorriso.info +++ b/xorriso/xorriso.info @@ -660,12 +660,14 @@ activate them only after image loading. 5540k = 5540kB/s = 4d = 4xDVD If there is no hint about the speed unit attached, then the medium in the -indev will decide. Default unit is CD = 176.4k. - MMC drives usually activate their own idea of speed and take the - speed value given by the burn program only as upper limit for - their own decision. Depending on the drive, the reported read speeds can be - deceivingly low. Often it is possible to achieve higher read - speeds by bold values like "20xDVD" or "16xBD". + deceivingly low or high. Therefore "min" cannot become higher than + 1x speed of the involved medium type. Read speed "max" cannot + become lower than 52xCD, 24xDVD, or 20xBD, depending on the medium + type. + MMC drives usually activate their own idea of speed and take the + speed value given by the burn program only as hint for their own + decision. -load entity id Load a particular (possibly outdated) ISO session from -dev or @@ -2073,7 +2075,9 @@ File: xorriso.info, Node: Writing, Next: SetWrite, Prev: Filter, Up: Command will appear "Write speed 0", which tells the outcome of speed selection by command -speed 0, if it deviates from "Write speed H". "Read speed L" and "Read speed H" tell the minimum and maximum - read speeds, as would be chosen by -read_speed "min" resp. "max". + read speeds, as reported by the drive. They would be chosen by + -read_speed "min" resp. "max" if they undercut resp. surpass the + built-in limits. These are "1x" resp. "52xCD", "24xDVD", "20xBD". -close_damaged "as_needed"|"force" Try to close the upcomming track and session if the drive reported @@ -4835,7 +4839,7 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top * # starts a comment line: Scripting. (line 173) * -abort_on controls abort on error: Exception. (line 27) * -abstract_file sets abstract file name: SetWrite. (line 233) -* -acl controls handling of ACLs: Loading. (line 168) +* -acl controls handling of ACLs: Loading. (line 170) * -add inserts one or more paths: Insert. (line 46) * -add_plainly inserts one or more paths: Insert. (line 65) * -alter_date sets timestamps in ISO image: Manip. (line 154) @@ -4845,14 +4849,14 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top * -application_id sets application id: SetWrite. (line 192) * -application_use sets application use field: SetWrite. (line 258) * -as emulates mkisofs or cdrecord: Emulation. (line 13) -* -assert_volid rejects undesired images: Loading. (line 106) -* -auto_charset learns character set from image: Loading. (line 120) +* -assert_volid rejects undesired images: Loading. (line 108) +* -auto_charset learns character set from image: Loading. (line 122) * -backslash_codes enables backslash conversion: Scripting. (line 78) -* -ban_stdio_write demands real drive: Loading. (line 276) +* -ban_stdio_write demands real drive: Loading. (line 278) * -biblio_file sets biblio file name: SetWrite. (line 240) * -blank erases media: Writing. (line 61) * -boot_image controls bootability: Bootable. (line 26) -* -calm_drive reduces drive activity: Loading. (line 265) +* -calm_drive reduces drive activity: Loading. (line 267) * -cd sets working directory in ISO: Navigate. (line 7) * -cdx sets working directory on disk: Navigate. (line 16) * -changes_pending overrides change status: Writing. (line 13) @@ -4869,7 +4873,7 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top * -chown_r sets ownership in ISO image: Manip. (line 54) * -clone copies ISO directory tree: Insert. (line 180) * -close controls media closing: SetWrite. (line 353) -* -close_damaged closes damaged track and session: Writing. (line 168) +* -close_damaged closes damaged track and session: Writing. (line 170) * -close_filter_list bans filter registration: Filter. (line 52) * -commit writes pending ISO image: Writing. (line 29) * -commit_eject writes and ejects: Writing. (line 56) @@ -4884,23 +4888,23 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top * -cpr inserts like with cp -r: Insert. (line 156) * -cpx copies files to disk: Restore. (line 95) * -cut_out inserts piece of data file: Insert. (line 130) -* -data_cache_size adjusts read cache size: Loading. (line 294) +* -data_cache_size adjusts read cache size: Loading. (line 296) * -dev acquires one drive for input and output: AqDrive. (line 12) * -device_links gets list of drives: Inquiry. (line 18) * -devices gets list of drives: Inquiry. (line 7) * -dialog enables dialog mode: DialogCtl. (line 7) -* -disk_dev_ino fast incremental backup: Loading. (line 215) +* -disk_dev_ino fast incremental backup: Loading. (line 217) * -disk_pattern controls pattern expansion: Insert. (line 35) * -displacement compensate altered image start address: Loading. - (line 58) -* -drive_class controls drive accessability: Loading. (line 76) + (line 60) +* -drive_class controls drive accessability: Loading. (line 78) * -du show directory size in ISO image: Navigate. (line 89) * -dummy controls write simulation: SetWrite. (line 342) * -dus show directory size in ISO image: Navigate. (line 93) * -dusx show directory size on disk: Navigate. (line 102) * -dux show directory size on disk: Navigate. (line 97) * -dvd_obs set write block size: SetWrite. (line 329) -* -early_stdio_test classifies stdio drives: Loading. (line 281) +* -early_stdio_test classifies stdio drives: Loading. (line 283) * -eject ejects drive tray: Writing. (line 52) * -end writes pending session and ends program: Scripting. (line 167) * -errfile_log logs problematic disk files: Scripting. (line 129) @@ -4915,7 +4919,7 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top * -find traverses and alters ISO tree: CmdFind. (line 7) * -findx traverses disk tree: Navigate. (line 106) * -follow softlinks and mount points: SetInsert. (line 76) -* -for_backup -acl,-xattr,-hardlinks,-md5: Loading. (line 210) +* -for_backup -acl,-xattr,-hardlinks,-md5: Loading. (line 212) * -format formats media: Writing. (line 91) * -fs sets size of fifo: SetWrite. (line 346) * -getfacl shows ACL in ISO image: Navigate. (line 70) @@ -4924,12 +4928,12 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top * -getfattr_r shows xattr in ISO image: Navigate. (line 85) * -gid sets global ownership: SetWrite. (line 282) * -grow_blindly overides next writeable address: AqDrive. (line 46) -* -hardlinks controls handling of hard links: Loading. (line 132) +* -hardlinks controls handling of hard links: Loading. (line 134) * -help prints help text: Scripting. (line 20) * -hfsplus enables production of HFS+ partition: SetWrite. (line 14) * -hide excludes file names from directory trees: Manip. (line 184) * -history brings text into readline history: Scripting. (line 44) -* -in_charset sets input character set: Loading. (line 114) +* -in_charset sets input character set: Loading. (line 116) * -indev acquires a drive for input: AqDrive. (line 24) * -iso_rr_pattern controls pattern expansion: Manip. (line 10) * -jigdo clears JTE or or adds parameter to JTE: Jigdo. (line 33) @@ -4941,10 +4945,10 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top * -list_extras lists compile time extra features: Scripting. (line 26) * -list_formats lists available formats: Writing. (line 134) -* -list_profiles lists supported media: Writing. (line 182) +* -list_profiles lists supported media: Writing. (line 184) * -list_speeds lists available write speeds: Writing. (line 146) * -lns creates ISO symbolic link: Insert. (line 175) -* -load addresses a particular session as input: Loading. (line 33) +* -load addresses a particular session as input: Loading. (line 35) * -local_charset sets terminal character set: Charset. (line 47) * -logfile logs output channels to file: Frontend. (line 20) * -ls lists files in ISO image: Navigate. (line 26) @@ -4959,7 +4963,7 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top * -map_l inserts paths from disk file: Insert. (line 98) * -map_single inserts path: Insert. (line 94) * -mark sets synchronizing message: Frontend. (line 25) -* -md5 controls handling of MD5 sums: Loading. (line 181) +* -md5 controls handling of MD5 sums: Loading. (line 183) * -mkdir creates ISO directory: Insert. (line 170) * -mount issues mount command for ISO session: Restore. (line 129) * -mount_cmd composes mount command line: Inquiry. (line 52) @@ -5012,7 +5016,7 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top (line 52) * -rollback discards pending changes: Writing. (line 9) * -rollback_end ends program without writing: Scripting. (line 170) -* -rom_toc_scan searches for sessions: Loading. (line 236) +* -rom_toc_scan searches for sessions: Loading. (line 238) * -rr_reloc_dir sets name of relocation directory: SetWrite. (line 141) * -scdbackup_tag enables scdbackup checksum tag: Emulation. (line 177) @@ -5057,7 +5061,7 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top * -write_type chooses TAO or SAO/DAO: SetWrite. (line 370) * -x enables automatic execution order of arguments: ArgSort. (line 16) -* -xattr controls handling of xattr (EA): Loading. (line 176) +* -xattr controls handling of xattr (EA): Loading. (line 178) * -zisofs controls zisofs production: SetWrite. (line 286)  @@ -5070,7 +5074,7 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top * Menu: * ACL, _definition: Extras. (line 49) -* ACL, control handling, -acl: Loading. (line 168) +* ACL, control handling, -acl: Loading. (line 170) * ACL, set in ISO image, -setfacl: Manip. (line 80) * ACL, set in ISO image, -setfacl_list: Manip. (line 108) * ACL, set in ISO image, -setfacl_r: Manip. (line 105) @@ -5082,8 +5086,8 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top * Appended Filesystem Image, -append_partition: Bootable. (line 249) * Automatic execution order, of arguments, -x: ArgSort. (line 16) * Backslash Interpretation, _definition: Processing. (line 52) -* Backup, enable fast incremental, -disk_dev_ino: Loading. (line 215) -* Backup, enable features, -for_backup: Loading. (line 210) +* Backup, enable fast incremental, -disk_dev_ino: Loading. (line 217) +* Backup, enable features, -for_backup: Loading. (line 212) * Backup, scdbackup checksum tag, -scdbackup: Emulation. (line 177) * Blank media, _definition: Media. (line 29) * Blind growing, _definition: Methods. (line 40) @@ -5091,10 +5095,10 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top * Bugs, reporting: Bugreport. (line 6) * cdrecord, Emulation: Emulation. (line 116) * Character Set, _definition: Charset. (line 6) -* Character Set, for input, -in_charset: Loading. (line 114) +* Character Set, for input, -in_charset: Loading. (line 116) * Character Set, for input/output, -charset: Charset. (line 43) * Character Set, for output, -out_charset: SetWrite. (line 272) -* Character set, learn from image, -auto_charset: Loading. (line 120) +* Character set, learn from image, -auto_charset: Loading. (line 122) * Character Set, of terminal, -local_charset: Charset. (line 47) * CHRP partition, _definition: Bootable. (line 158) * Closed media, _definition: Media. (line 43) @@ -5103,7 +5107,7 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top * Create, new ISO image, _definition: Methods. (line 6) * Cylinder alignment, _definition: Bootable. (line 198) * Cylinder size, _definition: Bootable. (line 187) -* Damaged track and session, close, -close_damaged: Writing. (line 168) +* Damaged track and session, close, -close_damaged: Writing. (line 170) * Delete, from ISO image, -rm: Manip. (line 21) * Delete, from ISO image, -rm_r: Manip. (line 28) * Delete, ISO directory, -rmdir: Manip. (line 32) @@ -5119,17 +5123,17 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top * Directory, delete, -rmdir: Manip. (line 32) * disk_path, _definition: Insert. (line 6) * Drive, _definition: Drives. (line 6) -* Drive, accessability, -drive_class: Loading. (line 76) -* Drive, classify stdio, -early_stdio_test: Loading. (line 281) -* Drive, demand real MMC, -ban_stdio_write: Loading. (line 276) +* Drive, accessability, -drive_class: Loading. (line 78) +* Drive, classify stdio, -early_stdio_test: Loading. (line 283) +* Drive, demand real MMC, -ban_stdio_write: Loading. (line 278) * Drive, eject tray, -eject: Writing. (line 52) * Drive, for input and output, -dev: AqDrive. (line 12) * Drive, for input, -indev: AqDrive. (line 24) * Drive, for output, -outdev: AqDrive. (line 31) * Drive, get drive list, -device_links: Inquiry. (line 18) * Drive, get drive list, -devices: Inquiry. (line 7) -* Drive, list supported media, -list_profiles: Writing. (line 182) -* Drive, reduce activity, -calm_drive: Loading. (line 265) +* Drive, list supported media, -list_profiles: Writing. (line 184) +* Drive, reduce activity, -calm_drive: Loading. (line 267) * Drive, report SCSI commands, -scsi_log: Scripting. (line 158) * Drive, write and eject, -commit_eject: Writing. (line 56) * EA, _definition: Extras. (line 65) @@ -5159,13 +5163,13 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top * Group, in ISO image, -chgrp: Manip. (line 57) * Group, in ISO image, -chgrp_r: Manip. (line 62) * Growing, _definition: Methods. (line 19) -* Hard links, control handling, -hardlinks: Loading. (line 132) +* Hard links, control handling, -hardlinks: Loading. (line 134) * HFS+ allocation block size: Bootable. (line 237) * HFS+ serial number: Bootable. (line 234) * hidden, set in ISO image, -hide: Manip. (line 184) -* Image reading, cache size, -data_cache_size: Loading. (line 294) +* Image reading, cache size, -data_cache_size: Loading. (line 296) * Image, _definition: Model. (line 9) -* Image, demand volume ID, -assert_volid: Loading. (line 106) +* Image, demand volume ID, -assert_volid: Loading. (line 108) * Image, discard pending changes, -rollback: Writing. (line 9) * Image, override change status, -changes_pending: Writing. (line 13) * Image, set abstract file name, -abstract_file: SetWrite. (line 233) @@ -5210,7 +5214,7 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top * List delimiter, _definition: Processing. (line 9) * MBR, _definition: Extras. (line 26) * MBR, set, -boot_image system_area=: Bootable. (line 126) -* MD5, control handling, -md5: Loading. (line 181) +* MD5, control handling, -md5: Loading. (line 183) * Media, erase, -blank: Writing. (line 61) * Media, format, -format: Writing. (line 91) * Media, list formats, -list_formats: Writing. (line 134) @@ -5300,19 +5304,19 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top (line 67) * Rock Ridge, _definition: Extras. (line 6) * Session, _definition: Model. (line 6) -* Session, altered start address, -displacement: Loading. (line 58) +* Session, altered start address, -displacement: Loading. (line 60) * Session, info string, -session_string: Inquiry. (line 78) * Session, issue mount command, -mount: Restore. (line 129) * Session, log when written, -session_log: Scripting. (line 149) * Session, mount command line, -mount_cmd: Inquiry. (line 52) * Session, mount parameters, -mount_opts: Inquiry. (line 68) -* Session, select as input, -load: Loading. (line 33) +* Session, select as input, -load: Loading. (line 35) * Sorting order, for -x, -list_arg_sorting: ArgSort. (line 27) * SUN Disk Label, production: Bootable. (line 220) * SUN SPARC boot images, activation: Bootable. (line 270) * Symbolic link, create, -lns: Insert. (line 175) * System area, _definition: Bootable. (line 126) -* Table-of-content, search sessions, -rom_toc_scan: Loading. (line 236) +* Table-of-content, search sessions, -rom_toc_scan: Loading. (line 238) * Table-of-content, show, -toc: Inquiry. (line 28) * Timestamps, set in ISO image, -alter_date: Manip. (line 154) * Timestamps, set in ISO image, -alter_date_r: Manip. (line 180) @@ -5345,7 +5349,7 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top * Write, simulation, -dummy: SetWrite. (line 342) * Write, TAO or SAO/DAO, -write_type: SetWrite. (line 370) * xattr, _definition: Extras. (line 65) -* xattr, control handling, -xattr: Loading. (line 176) +* xattr, control handling, -xattr: Loading. (line 178) * xattr, set in ISO image, -setfattr: Manip. (line 118) * xattr, set in ISO image, -setfattr_list: Manip. (line 134) * xattr, set in ISO image, -setfattr_r: Manip. (line 131) @@ -5368,47 +5372,47 @@ Node: Commands24622 Node: ArgSort26299 Node: AqDrive27791 Node: Loading30836 -Node: Insert47670 -Node: SetInsert57869 -Node: Manip66446 -Node: CmdFind75955 -Node: Filter90997 -Node: Writing95553 -Node: SetWrite105545 -Node: Bootable125870 -Node: Jigdo142260 -Node: Charset146507 -Node: Exception149269 -Node: DialogCtl155389 -Node: Inquiry157987 -Node: Navigate164304 -Node: Verify172602 -Node: Restore181634 -Node: Emulation188721 -Node: Scripting199023 -Node: Frontend206794 -Node: Examples216401 -Node: ExDevices217579 -Node: ExCreate218238 -Node: ExDialog219523 -Node: ExGrowing220788 -Node: ExModifying221593 -Node: ExBootable222097 -Node: ExCharset222649 -Node: ExPseudo223470 -Node: ExCdrecord224368 -Node: ExMkisofs224685 -Node: ExGrowisofs226025 -Node: ExException227160 -Node: ExTime227614 -Node: ExIncBackup228073 -Node: ExRestore232053 -Node: ExRecovery232986 -Node: Files233556 -Node: Seealso234855 -Node: Bugreport235578 -Node: Legal236159 -Node: CommandIdx237170 -Node: ConceptIdx253832 +Node: Insert47765 +Node: SetInsert57964 +Node: Manip66541 +Node: CmdFind76050 +Node: Filter91092 +Node: Writing95648 +Node: SetWrite105779 +Node: Bootable126104 +Node: Jigdo142494 +Node: Charset146741 +Node: Exception149503 +Node: DialogCtl155623 +Node: Inquiry158221 +Node: Navigate164538 +Node: Verify172836 +Node: Restore181868 +Node: Emulation188955 +Node: Scripting199257 +Node: Frontend207028 +Node: Examples216635 +Node: ExDevices217813 +Node: ExCreate218472 +Node: ExDialog219757 +Node: ExGrowing221022 +Node: ExModifying221827 +Node: ExBootable222331 +Node: ExCharset222883 +Node: ExPseudo223704 +Node: ExCdrecord224602 +Node: ExMkisofs224919 +Node: ExGrowisofs226259 +Node: ExException227394 +Node: ExTime227848 +Node: ExIncBackup228307 +Node: ExRestore232287 +Node: ExRecovery233220 +Node: Files233790 +Node: Seealso235089 +Node: Bugreport235812 +Node: Legal236393 +Node: CommandIdx237404 +Node: ConceptIdx254066  End Tag Table diff --git a/xorriso/xorriso.texi b/xorriso/xorriso.texi index 6e0cf90a..4417ab31 100644 --- a/xorriso/xorriso.texi +++ b/xorriso/xorriso.texi @@ -50,7 +50,7 @@ @c man .\" First parameter, NAME, should be all caps @c man .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection @c man .\" other parameters are allowed: see man(7), man(1) -@c man .TH XORRISO 1 "Version 1.3.3, Oct 27, 2013" +@c man .TH XORRISO 1 "Version 1.3.3, Nov 14, 2013" @c man .\" Please adjust this date whenever revising the manpage. @c man .\" @c man .\" Some roff macros, for reference: @@ -936,13 +936,14 @@ Example speeds: If there is no hint about the speed unit attached, then the medium in the -indev will decide. Default unit is CD = 176.4k. @* -MMC drives usually activate their own idea of speed and take -the speed value given by the burn program only as upper limit -for their own decision. +Depending on the drive, the reported read speeds can be deceivingly low +or high. Therefore "min" cannot become higher than 1x speed of the involved +medium type. Read speed "max" cannot become lower than 52xCD, 24xDVD, +or 20xBD, depending on the medium type. @* -Depending on the drive, the reported read speeds can be deceivingly low. -Often it is possible to achieve higher read speeds by bold values -like "20xDVD" or "16xBD". +MMC drives usually activate their own idea of speed and take +the speed value given by the burn program only as hint +for their own decision. @c man .TP @item -load entity id @kindex -load addresses a particular session as input @@ -2785,7 +2786,9 @@ Only if the drive reports contradicting speed information there will appear -speed 0, if it deviates from "Write speed H". @* "Read speed L" and "Read speed H" tell the minimum and maximum read speeds, -as would be chosen by -read_speed "min" resp. "max". +as reported by the drive. They would be chosen by -read_speed "min" resp. +"max" if they undercut resp. surpass the built-in limits. These are "1x" +resp. "52xCD", "24xDVD", "20xBD". @c man .TP @item -close_damaged "as_needed"|"force" @kindex -close_damaged closes damaged track and session