Documentation for recent enhancements

This commit is contained in:
Thomas Schmitt 2010-05-23 15:16:25 +00:00
parent 1482eb02f1
commit 673906b084
3 changed files with 83 additions and 72 deletions

View File

@ -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 "Apr 28, 2010"
.TH XORRISO 1 "May 22, 2010"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
@ -1961,6 +1961,9 @@ Default is "old_rr" which uses Rock Ridge version 1.10. This implies also
"aaip_susp_1_10" allows AAIP to be written as unofficial extension of RRIP
rather than as official extension under SUSP-1.12.
.br
"no_emul_toc" saves 64 kB with the first session on overwriteable media
but makes the image incapable of displaying its session history.
.br
Default setting is
.br
"clear:only_iso_version:deep_paths:long_paths:no_j_force_dots:
@ -3175,6 +3178,7 @@ They work like the xorriso options with the
same name and hardcoded argument "on", e.g. -acl "on".
Explicit arguments are expected by --stdio_sync
and --scdbackup_tag.
--no-emul-toc is -compliance no_emul_toc.
.br
--sort-weight gets as arguments a number and an iso_rr_path.
The number becomes the LBA sorting weight of regular file iso_rr_path or

View File

@ -1760,6 +1760,9 @@ will be written according to the setting of option -acl.
"aaip_susp_1_10_off".
"aaip_susp_1_10" allows AAIP to be written as unofficial extension
of RRIP rather than as official extension under SUSP-1.12.
"no_emul_toc" saves 64 kB with the first session on overwriteable
media but makes the image incapable of displaying its session
history.
Default setting is
"clear:only_iso_version:deep_paths:long_paths:no_j_force_dots:
always_gmt:old_rr".
@ -2841,7 +2844,7 @@ programs trigger comparable actions.
, --acl , --xattr , --md5 , --stdio_sync . They work like the
xorriso options with the same name and hardcoded argument "on",
e.g. -acl "on". Explicit arguments are expected by --stdio_sync
and --scdbackup_tag.
and --scdbackup_tag. --no-emul-toc is -compliance no_emul_toc.
--sort-weight gets as arguments a number and an iso_rr_path. The
number becomes the LBA sorting weight of regular file iso_rr_path
or of all regular files underneath directory iso_rr_path. (See
@ -3642,7 +3645,7 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
* -add_plainly inserts one or more paths: Insert. (line 61)
* -alter_date sets timestamps in ISO image: Manip. (line 146)
* -alter_date_r sets timestamps in ISO image: Manip. (line 166)
* -application_id sets application id: SetWrite. (line 87)
* -application_id sets application id: SetWrite. (line 90)
* -as emulates mkisofs or cdrecord: Emulation. (line 13)
* -assert_volid rejects undesired images: Loading. (line 65)
* -auto_charset learns character set from image: Loading. (line 80)
@ -3664,7 +3667,7 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
* -chmod_r sets permissions in ISO image: Manip. (line 70)
* -chown sets ownership in ISO image: Manip. (line 42)
* -chown_r sets ownership in ISO image: Manip. (line 47)
* -close controls media closing: SetWrite. (line 196)
* -close controls media closing: SetWrite. (line 199)
* -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)
@ -3684,11 +3687,11 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
* -disk_pattern controls pattern expansion: Insert. (line 31)
* -drive_class controls drive accessability: Loading. (line 35)
* -du show directory size in ISO image: Navigate. (line 84)
* -dummy controls write simulation: SetWrite. (line 185)
* -dummy controls write simulation: SetWrite. (line 188)
* -dus show directory size in ISO image: Navigate. (line 88)
* -dusx show directory size on disk: Navigate. (line 97)
* -dux show directory size on disk: Navigate. (line 92)
* -dvd_obs set write block size: SetWrite. (line 172)
* -dvd_obs set write block size: SetWrite. (line 175)
* -eject ejects drive tray: Writing. (line 36)
* -end writes pending session and ends program: Scripting. (line 122)
* -errfile_log logs problematic disk files: Scripting. (line 84)
@ -3705,12 +3708,12 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
* -follow softlinks and mount points: SetInsert. (line 76)
* -for_backup -acl,-xattr,-hardlinks,-md5: Loading. (line 163)
* -format formats media: Writing. (line 69)
* -fs sets size of fifo: SetWrite. (line 189)
* -fs sets size of fifo: SetWrite. (line 192)
* -getfacl shows ACL in ISO image: Navigate. (line 65)
* -getfacl_r shows ACL in ISO image: Navigate. (line 72)
* -getfattr shows xattr in ISO image: Navigate. (line 76)
* -getfattr_r shows xattr in ISO image: Navigate. (line 80)
* -gid sets global ownership: SetWrite. (line 129)
* -gid sets global ownership: SetWrite. (line 132)
* -grow_blindly overides next writeable address: AqDrive. (line 44)
* -hardlinks controls handling of hard links: Loading. (line 91)
* -help prints help text: Scripting. (line 16)
@ -3750,11 +3753,11 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
* -not_paths sets absolute exclusion paths: SetInsert. (line 55)
* -options_from_file reads commands from file: Scripting. (line 12)
* -osirrox enables ISO-to-disk copying: Restore. (line 18)
* -out_charset sets output character set: SetWrite. (line 119)
* -out_charset sets output character set: SetWrite. (line 122)
* -outdev aquires a drive for output: AqDrive. (line 29)
* -overwrite enables overwriting in ISO: SetInsert. (line 127)
* -pacifier controls pacifier text form: Emulation. (line 105)
* -padding sets amount of image padding: SetWrite. (line 202)
* -padding sets amount of image padding: SetWrite. (line 205)
* -page set terminal geometry: DialogCtl. (line 15)
* -paste_in copies file into disk file: Restore. (line 117)
* -path_list inserts paths from disk file: Insert. (line 75)
@ -3765,7 +3768,7 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
* -prog sets program name: Frontend. (line 29)
* -prog_help prints help text: Frontend. (line 32)
* -prompt prompts for enter key: Scripting. (line 80)
* -publisher sets publisher id: SetWrite. (line 81)
* -publisher sets publisher id: SetWrite. (line 84)
* -pvd_info shows image id strings: Inquiry. (line 78)
* -pwd tells working directory in ISO: Navigate. (line 20)
* -pwdx tells working directory on disk: Navigate. (line 23)
@ -3794,27 +3797,27 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
* -setfattr_r sets xattr in ISO image: Manip. (line 123)
* -show_stream shows data source and filters: Navigate. (line 153)
* -show_stream_r shows data source and filters: Navigate. (line 168)
* -speed set write speed: SetWrite. (line 145)
* -speed set write speed: SetWrite. (line 148)
* -split_size enables large file splitting: SetInsert. (line 140)
* -status shows current settings: Scripting. (line 25)
* -status_history_max curbs -status history: Scripting. (line 34)
* -stdio_sync controls stdio buffer: SetWrite. (line 179)
* -stream_recording controls defect management: SetWrite. (line 160)
* -system_id sets system id: SetWrite. (line 93)
* -stdio_sync controls stdio buffer: SetWrite. (line 182)
* -stream_recording controls defect management: SetWrite. (line 163)
* -system_id sets system id: SetWrite. (line 96)
* -tell_media_space reports free space: Inquiry. (line 74)
* -temp_mem_limit curbs memory consumption: Scripting. (line 70)
* -toc shows list of sessions: Inquiry. (line 18)
* -uid sets global ownership: SetWrite. (line 125)
* -uid sets global ownership: SetWrite. (line 128)
* -update inserts path if different: Insert. (line 99)
* -update_l inserts paths if different: Insert. (line 121)
* -update_r inserts paths if different: Insert. (line 110)
* -use_readline enables readline for dialog: DialogCtl. (line 24)
* -version prints help text: Scripting. (line 19)
* -volid sets volume id: SetWrite. (line 57)
* -volset_id sets volume set id: SetWrite. (line 76)
* -volume_date sets volume timestamp: SetWrite. (line 100)
* -volid sets volume id: SetWrite. (line 60)
* -volset_id sets volume set id: SetWrite. (line 79)
* -volume_date sets volume timestamp: SetWrite. (line 103)
* -xattr controls handling of xattr (EA): Loading. (line 136)
* -zisofs controls zisofs production: SetWrite. (line 133)
* -zisofs controls zisofs production: SetWrite. (line 136)

File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
@ -3844,7 +3847,7 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Character Set, _definition: Charset. (line 6)
* Character Set, for input, -in_charset: Loading. (line 73)
* Character Set, for input/output, -charset: Charset. (line 43)
* Character Set, for output, -out_charset: SetWrite. (line 119)
* Character Set, for output, -out_charset: SetWrite. (line 122)
* Character set, learn from image, -auto_charset: Loading. (line 80)
* Character Set, of terminal, -local_charset: Charset. (line 47)
* Closed media, _definition: Media. (line 39)
@ -3887,8 +3890,8 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Filter, show chain, -show_stream: Navigate. (line 153)
* Filter, show chains of tree, -show_stream_r: Navigate. (line 168)
* Filter, unregister, -unregister_filter: Filter. (line 48)
* Filter, zisofs parameters, -zisofs: SetWrite. (line 133)
* Group, global in ISO image, -gid: SetWrite. (line 129)
* Filter, zisofs parameters, -zisofs: SetWrite. (line 136)
* Group, global in ISO image, -gid: SetWrite. (line 132)
* Group, in ISO image, -chgrp: Manip. (line 50)
* Group, in ISO image, -chgrp_r: Manip. (line 55)
* Growing, _definition: Methods. (line 19)
@ -3896,12 +3899,12 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Image, _definition: Model. (line 9)
* Image, demand volume id, -assert_volid: Loading. (line 65)
* Image, discard pending changes, -rollback: Writing. (line 9)
* Image, set application id, -application_id: SetWrite. (line 87)
* Image, set publisher id, -publisher: SetWrite. (line 81)
* Image, set system id, -system_id: SetWrite. (line 93)
* Image, set volume id, -volid: SetWrite. (line 57)
* Image, set volume set id, -volset_id: SetWrite. (line 76)
* Image, set volume timestamp, -volume_date: SetWrite. (line 100)
* Image, set application id, -application_id: SetWrite. (line 90)
* Image, set publisher id, -publisher: SetWrite. (line 84)
* Image, set system id, -system_id: SetWrite. (line 96)
* Image, set volume id, -volid: SetWrite. (line 60)
* Image, set volume set id, -volset_id: SetWrite. (line 79)
* Image, set volume timestamp, -volume_date: SetWrite. (line 103)
* Image, show id strings, -pvd_info: Inquiry. (line 78)
* Insert, enable overwriting, -overwrite: SetInsert. (line 127)
* Insert, file exclusion absolute, -not_paths: SetInsert. (line 55)
@ -3955,7 +3958,7 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Navigate, tell ISO working directory, -pwd: Navigate. (line 20)
* Next writeable address, -grow_blindly: AqDrive. (line 44)
* Overwriteable media, _definition: Media. (line 10)
* Ownership, global in ISO image, -uid: SetWrite. (line 125)
* Ownership, global in ISO image, -uid: SetWrite. (line 128)
* Ownership, in ISO image, -chown: Manip. (line 42)
* Ownership, in ISO image, -chown_r: Manip. (line 47)
* Partition table, _definiton: Bootable. (line 116)
@ -4023,22 +4026,22 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Verify, file checksum, -check_md5: Verify. (line 144)
* Verify, file tree checksums, -check_md5_r: Verify. (line 160)
* Verify, preset -check_media, -check_media_defaults: Verify. (line 40)
* Write, block size, -dvd_obs: SetWrite. (line 172)
* Write, block size, -dvd_obs: SetWrite. (line 175)
* Write, bootability, -boot_image: Bootable. (line 20)
* Write, buffer syncing, -stdio_sync: SetWrite. (line 179)
* Write, close media, -close: SetWrite. (line 196)
* Write, buffer syncing, -stdio_sync: SetWrite. (line 182)
* Write, close media, -close: SetWrite. (line 199)
* Write, compliance to specs, -compliance: SetWrite. (line 14)
* Write, defect management, -stream_recording: SetWrite. (line 160)
* Write, defect management, -stream_recording: SetWrite. (line 163)
* Write, enable Joliet, -joliet: SetWrite. (line 10)
* Write, fifo size, -fs: SetWrite. (line 189)
* Write, fifo size, -fs: SetWrite. (line 192)
* Write, free space, -tell_media_space: Inquiry. (line 74)
* Write, log problematic disk files, -errfile_log: Scripting. (line 84)
* Write, log written sessions, -session_log: Scripting. (line 104)
* Write, padding image, -padding: SetWrite. (line 202)
* Write, padding image, -padding: SetWrite. (line 205)
* Write, pending ISO image, -commit: Writing. (line 13)
* Write, predict image size, -print_size: Inquiry. (line 69)
* Write, set speed, -speed: SetWrite. (line 145)
* Write, simulation, -dummy: SetWrite. (line 185)
* Write, set speed, -speed: SetWrite. (line 148)
* Write, simulation, -dummy: SetWrite. (line 188)
* xattr, _definiton: Extras. (line 50)
* xattr, control handling, -xattr: Loading. (line 136)
* xattr, set in ISO image, -setfattr: Manip. (line 110)
@ -4069,38 +4072,38 @@ Node: CmdFind64592
Node: Filter73937
Node: Writing78286
Node: SetWrite84575
Node: Bootable94707
Node: Charset102455
Node: Exception105209
Node: DialogCtl109724
Node: Inquiry112069
Node: Navigate116209
Node: Verify123563
Node: Restore131983
Node: Emulation138639
Node: Scripting145465
Node: Frontend151027
Node: Examples152228
Node: ExDevices153397
Node: ExCreate153879
Node: ExDialog155153
Node: ExGrowing156415
Node: ExModifying157217
Node: ExBootable157718
Node: ExCharset158265
Node: ExPseudo159093
Node: ExCdrecord159987
Node: ExMkisofs160302
Node: ExGrowisofs161305
Node: ExException162429
Node: ExTime162883
Node: ExIncBackup163342
Node: ExRestore166814
Node: ExRecovery167783
Node: Files168349
Node: Seealso169387
Node: Legal169911
Node: CommandIdx170833
Node: ConceptIdx184134
Node: Bootable94859
Node: Charset102607
Node: Exception105361
Node: DialogCtl109876
Node: Inquiry112221
Node: Navigate116361
Node: Verify123715
Node: Restore132135
Node: Emulation138791
Node: Scripting145660
Node: Frontend151222
Node: Examples152423
Node: ExDevices153592
Node: ExCreate154074
Node: ExDialog155348
Node: ExGrowing156610
Node: ExModifying157412
Node: ExBootable157913
Node: ExCharset158460
Node: ExPseudo159288
Node: ExCdrecord160182
Node: ExMkisofs160497
Node: ExGrowisofs161500
Node: ExException162624
Node: ExTime163078
Node: ExIncBackup163537
Node: ExRestore167009
Node: ExRecovery167978
Node: Files168544
Node: Seealso169582
Node: Legal170106
Node: CommandIdx171028
Node: ConceptIdx184329

End Tag Table

View File

@ -44,7 +44,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 "Apr 28, 2010"
@c man .TH XORRISO 1 "May 22, 2010"
@c man .\" Please adjust this date whenever revising the manpage.
@c man .\"
@c man .\" Some roff macros, for reference:
@ -2364,6 +2364,9 @@ Default is "old_rr" which uses Rock Ridge version 1.10. This implies also
"aaip_susp_1_10" allows AAIP to be written as unofficial extension of RRIP
rather than as official extension under SUSP-1.12.
@*
"no_emul_toc" saves 64 kB with the first session on overwriteable media
but makes the image incapable of displaying its session history.
@*
Default setting is
@*
"clear:only_iso_version:deep_paths:long_paths:no_j_force_dots:
@ -3796,6 +3799,7 @@ They work like the xorriso options with the
same name and hardcoded argument "on", e.g. -acl "on".
Explicit arguments are expected by @minus{}@minus{}stdio_sync
and @minus{}@minus{}scdbackup_tag.
@minus{}@minus{}no-emul-toc is -compliance no_emul_toc.
@*
@minus{}@minus{}sort-weight gets as arguments a number and an iso_rr_path.
The number becomes the LBA sorting weight of regular file iso_rr_path or