From 3909540cb858d3cd6067f448b60274c7312d96e0 Mon Sep 17 00:00:00 2001 From: Thomas Schmitt Date: Tue, 7 May 2013 20:02:40 +0000 Subject: [PATCH] Documented new -hardlinks mode --- libisoburn/trunk/xorriso/xorriso.1 | 4 + libisoburn/trunk/xorriso/xorriso.info | 127 +++++++++++++------------- libisoburn/trunk/xorriso/xorriso.texi | 4 + 3 files changed, 73 insertions(+), 62 deletions(-) diff --git a/libisoburn/trunk/xorriso/xorriso.1 b/libisoburn/trunk/xorriso/xorriso.1 index 5aad5e90..6e146165 100644 --- a/libisoburn/trunk/xorriso/xorriso.1 +++ b/libisoburn/trunk/xorriso/xorriso.1 @@ -812,6 +812,10 @@ identical properties. The family members all get the same inode number. Whether these numbers are respected at mount time depends on the operating system. .br +Command \-lsl displays hardlink counts if "lsl_count" is enabled. This can +slow down the command substantially after changes to the ISO image have +been made. Therefore the default is "no_lsl_count". +.br Commands \-update and \-update_r track splits and fusions of hard links in filesystems which have stable device and inode numbers. This can cause automatic last minute changes before the session gets written. Command diff --git a/libisoburn/trunk/xorriso/xorriso.info b/libisoburn/trunk/xorriso/xorriso.info index 0d935cb2..6ee3859c 100644 --- a/libisoburn/trunk/xorriso/xorriso.info +++ b/libisoburn/trunk/xorriso/xorriso.info @@ -753,6 +753,9 @@ activate them only after image loading. family members all get the same inode number. Whether these numbers are respected at mount time depends on the operating system. + Command -lsl displays hardlink counts if "lsl_count" is enabled. + This can slow down the command substantially after changes to the + ISO image have been made. Therefore the default is "no_lsl_count". Commands -update and -update_r track splits and fusions of hard links in filesystems which have stable device and inode numbers. This can cause automatic last minute changes before the session @@ -4714,7 +4717,7 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top * # starts a comment line: Scripting. (line 162) * -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 143) +* -acl controls handling of ACLs: Loading. (line 146) * -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) @@ -4726,11 +4729,11 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top * -assert_volid rejects undesired images: Loading. (line 84) * -auto_charset learns character set from image: Loading. (line 98) * -backslash_codes enables backslash conversion: Scripting. (line 67) -* -ban_stdio_write demands real drive: Loading. (line 251) +* -ban_stdio_write demands real drive: Loading. (line 254) * -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 240) +* -calm_drive reduces drive activity: Loading. (line 243) * -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) @@ -4762,12 +4765,12 @@ 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 269) +* -data_cache_size adjusts read cache size: Loading. (line 272) * -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 190) +* -disk_dev_ino fast incremental backup: Loading. (line 193) * -disk_pattern controls pattern expansion: Insert. (line 35) * -displacement compensate altered image start address: Loading. (line 36) @@ -4778,7 +4781,7 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top * -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 311) -* -early_stdio_test classifies stdio drives: Loading. (line 256) +* -early_stdio_test classifies stdio drives: Loading. (line 259) * -eject ejects drive tray: Writing. (line 52) * -end writes pending session and ends program: Scripting. (line 156) * -errfile_log logs problematic disk files: Scripting. (line 118) @@ -4793,7 +4796,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 185) +* -for_backup -acl,-xattr,-hardlinks,-md5: Loading. (line 188) * -format formats media: Writing. (line 91) * -fs sets size of fifo: SetWrite. (line 328) * -getfacl shows ACL in ISO image: Navigate. (line 70) @@ -4837,7 +4840,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 156) +* -md5 controls handling of MD5 sums: Loading. (line 159) * -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) @@ -4888,7 +4891,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 159) -* -rom_toc_scan searches for sessions: Loading. (line 211) +* -rom_toc_scan searches for sessions: Loading. (line 214) * -rr_reloc_dir sets name of relocation directory: SetWrite. (line 141) * -scdbackup_tag enables scdbackup checksum tag: Emulation. (line 173) @@ -4931,7 +4934,7 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top * -write_type chooses TAO or SAO/DAO: SetWrite. (line 341) * -x enables automatic execution order of arguments: ArgSort. (line 16) -* -xattr controls handling of xattr (EA): Loading. (line 151) +* -xattr controls handling of xattr (EA): Loading. (line 154) * -zisofs controls zisofs production: SetWrite. (line 272)  @@ -4944,7 +4947,7 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top * Menu: * ACL, _definition: Extras. (line 49) -* ACL, control handling, -acl: Loading. (line 143) +* ACL, control handling, -acl: Loading. (line 146) * 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) @@ -4956,8 +4959,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 190) -* Backup, enable features, -for_backup: Loading. (line 185) +* Backup, enable fast incremental, -disk_dev_ino: Loading. (line 193) +* Backup, enable features, -for_backup: Loading. (line 188) * Backup, scdbackup checksum tag, -scdbackup: Emulation. (line 173) * Blank media, _definition: Media. (line 29) * Blind growing, _definition: Methods. (line 40) @@ -4993,8 +4996,8 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top * disk_path, _definition: Insert. (line 6) * Drive, _definition: Drives. (line 6) * Drive, accessability, -drive_class: Loading. (line 54) -* Drive, classify stdio, -early_stdio_test: Loading. (line 256) -* Drive, demand real MMC, -ban_stdio_write: Loading. (line 251) +* Drive, classify stdio, -early_stdio_test: Loading. (line 259) +* Drive, demand real MMC, -ban_stdio_write: Loading. (line 254) * Drive, eject tray, -eject: Writing. (line 52) * Drive, for input and output, -dev: AqDrive. (line 12) * Drive, for input, -indev: AqDrive. (line 24) @@ -5002,7 +5005,7 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top * 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 172) -* Drive, reduce activity, -calm_drive: Loading. (line 240) +* Drive, reduce activity, -calm_drive: Loading. (line 243) * Drive, report SCSI commands, -scsi_log: Scripting. (line 147) * Drive, write and eject, -commit_eject: Writing. (line 56) * EA, _definition: Extras. (line 65) @@ -5036,7 +5039,7 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top * 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 269) +* Image reading, cache size, -data_cache_size: Loading. (line 272) * Image, _definition: Model. (line 9) * Image, demand volume ID, -assert_volid: Loading. (line 84) * Image, discard pending changes, -rollback: Writing. (line 9) @@ -5081,7 +5084,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 156) +* MD5, control handling, -md5: Loading. (line 159) * Media, erase, -blank: Writing. (line 61) * Media, format, -format: Writing. (line 91) * Media, list formats, -list_formats: Writing. (line 129) @@ -5180,7 +5183,7 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top * 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 211) +* Table-of-content, search sessions, -rom_toc_scan: Loading. (line 214) * 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) @@ -5213,7 +5216,7 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top * Write, simulation, -dummy: SetWrite. (line 324) * Write, TAO or SAO/DAO, -write_type: SetWrite. (line 341) * xattr, _definition: Extras. (line 65) -* xattr, control handling, -xattr: Loading. (line 151) +* xattr, control handling, -xattr: Loading. (line 154) * 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) @@ -5236,47 +5239,47 @@ Node: Commands24481 Node: ArgSort26158 Node: AqDrive27650 Node: Loading30695 -Node: Insert46151 -Node: SetInsert56350 -Node: Manip64927 -Node: CmdFind74436 -Node: Filter89141 -Node: Writing93697 -Node: SetWrite103085 -Node: Bootable121836 -Node: Jigdo138226 -Node: Charset142473 -Node: Exception145235 -Node: DialogCtl151355 -Node: Inquiry153953 -Node: Navigate160031 -Node: Verify168329 -Node: Restore177361 -Node: Emulation184448 -Node: Scripting194572 -Node: Frontend201733 -Node: Examples209808 -Node: ExDevices210986 -Node: ExCreate211645 -Node: ExDialog212930 -Node: ExGrowing214195 -Node: ExModifying215000 -Node: ExBootable215504 -Node: ExCharset216056 -Node: ExPseudo216877 -Node: ExCdrecord217775 -Node: ExMkisofs218092 -Node: ExGrowisofs219432 -Node: ExException220567 -Node: ExTime221021 -Node: ExIncBackup221480 -Node: ExRestore225472 -Node: ExRecovery226432 -Node: Files227002 -Node: Seealso228301 -Node: Bugreport229024 -Node: Legal229605 -Node: CommandIdx230616 -Node: ConceptIdx246918 +Node: Insert46364 +Node: SetInsert56563 +Node: Manip65140 +Node: CmdFind74649 +Node: Filter89354 +Node: Writing93910 +Node: SetWrite103298 +Node: Bootable122049 +Node: Jigdo138439 +Node: Charset142686 +Node: Exception145448 +Node: DialogCtl151568 +Node: Inquiry154166 +Node: Navigate160244 +Node: Verify168542 +Node: Restore177574 +Node: Emulation184661 +Node: Scripting194785 +Node: Frontend201946 +Node: Examples210021 +Node: ExDevices211199 +Node: ExCreate211858 +Node: ExDialog213143 +Node: ExGrowing214408 +Node: ExModifying215213 +Node: ExBootable215717 +Node: ExCharset216269 +Node: ExPseudo217090 +Node: ExCdrecord217988 +Node: ExMkisofs218305 +Node: ExGrowisofs219645 +Node: ExException220780 +Node: ExTime221234 +Node: ExIncBackup221693 +Node: ExRestore225685 +Node: ExRecovery226645 +Node: Files227215 +Node: Seealso228514 +Node: Bugreport229237 +Node: Legal229818 +Node: CommandIdx230829 +Node: ConceptIdx247131  End Tag Table diff --git a/libisoburn/trunk/xorriso/xorriso.texi b/libisoburn/trunk/xorriso/xorriso.texi index fdf9075c..6e173813 100644 --- a/libisoburn/trunk/xorriso/xorriso.texi +++ b/libisoburn/trunk/xorriso/xorriso.texi @@ -1043,6 +1043,10 @@ identical properties. The family members all get the same inode number. Whether these numbers are respected at mount time depends on the operating system. @* +Command -lsl displays hardlink counts if "lsl_count" is enabled. This can +slow down the command substantially after changes to the ISO image have +been made. Therefore the default is "no_lsl_count". +@* Commands -update and -update_r track splits and fusions of hard links in filesystems which have stable device and inode numbers. This can cause automatic last minute changes before the session gets written. Command