Small corrections and enhancements in man xorriso
This commit is contained in:
parent
447b427688
commit
e72ab34569
@ -9,7 +9,7 @@
|
|||||||
.\" First parameter, NAME, should be all caps
|
.\" First parameter, NAME, should be all caps
|
||||||
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
|
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
|
||||||
.\" other parameters are allowed: see man(7), man(1)
|
.\" other parameters are allowed: see man(7), man(1)
|
||||||
.TH XORRISO 1 "Version 1.4.9, Nov 12, 2017"
|
.TH XORRISO 1 "Version 1.4.9, Mar 23, 2018"
|
||||||
.\" Please adjust this date whenever revising the manpage.
|
.\" Please adjust this date whenever revising the manpage.
|
||||||
.\"
|
.\"
|
||||||
.\" Some roff macros, for reference:
|
.\" Some roff macros, for reference:
|
||||||
@ -804,10 +804,14 @@ Examples:
|
|||||||
.br
|
.br
|
||||||
If a track of a CD starts at block 123456 and gets copied to a disk file
|
If a track of a CD starts at block 123456 and gets copied to a disk file
|
||||||
where it begins at block 0, then this copy can be loaded with
|
where it begins at block 0, then this copy can be loaded with
|
||||||
\-displacement \-123456.
|
\-displacement \-123456
|
||||||
.br
|
.br
|
||||||
If an ISO image was written onto a partition with offset of 640000 blocks of
|
If an ISO image was written onto a partition with offset of 640000 blocks of
|
||||||
512 bytes, then it can be loaded from the base device by \-displacement 160000.
|
512 bytes, then it can be loaded from the base device by
|
||||||
|
\-load sbsector 160000 \-displacement 160000
|
||||||
|
.br
|
||||||
|
(If the partition start address is not divisible by 4, then you will have
|
||||||
|
to employ a loop device instead.)
|
||||||
.br
|
.br
|
||||||
In both cases, the ISO sessions should be self contained, i.e. not add\-on
|
In both cases, the ISO sessions should be self contained, i.e. not add\-on
|
||||||
sessions to an ISO image outside their track or partition.
|
sessions to an ISO image outside their track or partition.
|
||||||
@ -3183,11 +3187,11 @@ can assume overwriteable media.
|
|||||||
Normally the boot images are data files inside the ISO filesystem. By
|
Normally the boot images are data files inside the ISO filesystem. By
|
||||||
special path "\-\-interval:appended_partition_NNN:all::" it is possible to
|
special path "\-\-interval:appended_partition_NNN:all::" it is possible to
|
||||||
refer to an appended partition. The number NNN gives the partition number
|
refer to an appended partition. The number NNN gives the partition number
|
||||||
as used with the corresponding option \-append_partition.
|
as used with the corresponding command \-append_partition.
|
||||||
E.g.:
|
E.g.:
|
||||||
.br
|
.br
|
||||||
\-append_partition 2 0xef /tmp/efi.img
|
\-append_partition 2 0xef /tmp/efi.img
|
||||||
\-e \-\-interval:appended_partition_2:all::
|
\-boot_image any efi_path=\-\-interval:appended_partition_2:all::
|
||||||
.br
|
.br
|
||||||
There are booting mechanisms which do not use an El Torito record but rather
|
There are booting mechanisms which do not use an El Torito record but rather
|
||||||
start at the first bytes of the image: PC\-BIOS MBR or EFI GPT for
|
start at the first bytes of the image: PC\-BIOS MBR or EFI GPT for
|
||||||
|
@ -736,10 +736,12 @@ activate them only after image loading.
|
|||||||
Examples:
|
Examples:
|
||||||
If a track of a CD starts at block 123456 and gets copied to a disk
|
If a track of a CD starts at block 123456 and gets copied to a disk
|
||||||
file where it begins at block 0, then this copy can be loaded with
|
file where it begins at block 0, then this copy can be loaded with
|
||||||
-displacement -123456.
|
-displacement -123456
|
||||||
If an ISO image was written onto a partition with offset of 640000
|
If an ISO image was written onto a partition with offset of 640000
|
||||||
blocks of 512 bytes, then it can be loaded from the base device by
|
blocks of 512 bytes, then it can be loaded from the base device by
|
||||||
-displacement 160000.
|
-load sbsector 160000 -displacement 160000
|
||||||
|
(If the partition start address is not divisible by 4, then you
|
||||||
|
will have to employ a loop device instead.)
|
||||||
In both cases, the ISO sessions should be self contained, i.e. not
|
In both cases, the ISO sessions should be self contained, i.e. not
|
||||||
add-on sessions to an ISO image outside their track or partition.
|
add-on sessions to an ISO image outside their track or partition.
|
||||||
-drive_class "harmless"|"banned"|"caution"|"clear_list" disk_pattern
|
-drive_class "harmless"|"banned"|"caution"|"clear_list" disk_pattern
|
||||||
@ -2702,9 +2704,9 @@ of the existing sessions, unless one can assume overwriteable media.
|
|||||||
Normally the boot images are data files inside the ISO filesystem. By
|
Normally the boot images are data files inside the ISO filesystem. By
|
||||||
special path "-interval:appended_partition_NNN:all::" it is possible to
|
special path "-interval:appended_partition_NNN:all::" it is possible to
|
||||||
refer to an appended partition. The number NNN gives the partition
|
refer to an appended partition. The number NNN gives the partition
|
||||||
number as used with the corresponding option -append_partition. E.g.:
|
number as used with the corresponding command -append_partition. E.g.:
|
||||||
-append_partition 2 0xef /tmp/efi.img
|
-append_partition 2 0xef /tmp/efi.img
|
||||||
-e -interval:appended_partition_2:all::
|
-boot_image any efi_path=-interval:appended_partition_2:all::
|
||||||
There are booting mechanisms which do not use an El Torito record but
|
There are booting mechanisms which do not use an El Torito record but
|
||||||
rather start at the first bytes of the image: PC-BIOS MBR or EFI GPT for
|
rather start at the first bytes of the image: PC-BIOS MBR or EFI GPT for
|
||||||
hard-disk-like devices, APM partition entries for Macs which expect HFS+
|
hard-disk-like devices, APM partition entries for Macs which expect HFS+
|
||||||
@ -5242,7 +5244,7 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
|
|||||||
* # starts a comment line: Scripting. (line 156)
|
* # starts a comment line: Scripting. (line 156)
|
||||||
* -abort_on controls abort on error: Exception. (line 27)
|
* -abort_on controls abort on error: Exception. (line 27)
|
||||||
* -abstract_file sets abstract file name: SetWrite. (line 244)
|
* -abstract_file sets abstract file name: SetWrite. (line 244)
|
||||||
* -acl controls handling of ACLs: Loading. (line 171)
|
* -acl controls handling of ACLs: Loading. (line 173)
|
||||||
* -add inserts one or more paths: Insert. (line 44)
|
* -add inserts one or more paths: Insert. (line 44)
|
||||||
* -add_plainly inserts one or more paths: Insert. (line 68)
|
* -add_plainly inserts one or more paths: Insert. (line 68)
|
||||||
* -alter_date sets timestamps in ISO image: Manip. (line 139)
|
* -alter_date sets timestamps in ISO image: Manip. (line 139)
|
||||||
@ -5252,14 +5254,14 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
|
|||||||
* -application_id sets application id: SetWrite. (line 191)
|
* -application_id sets application id: SetWrite. (line 191)
|
||||||
* -application_use sets application use field: SetWrite. (line 266)
|
* -application_use sets application use field: SetWrite. (line 266)
|
||||||
* -as emulates mkisofs or cdrecord: Emulation. (line 13)
|
* -as emulates mkisofs or cdrecord: Emulation. (line 13)
|
||||||
* -assert_volid rejects undesired images: Loading. (line 111)
|
* -assert_volid rejects undesired images: Loading. (line 113)
|
||||||
* -auto_charset learns character set from image: Loading. (line 123)
|
* -auto_charset learns character set from image: Loading. (line 125)
|
||||||
* -backslash_codes enables backslash conversion: Scripting. (line 71)
|
* -backslash_codes enables backslash conversion: Scripting. (line 71)
|
||||||
* -ban_stdio_write demands real drive: Loading. (line 334)
|
* -ban_stdio_write demands real drive: Loading. (line 336)
|
||||||
* -biblio_file sets biblio file name: SetWrite. (line 250)
|
* -biblio_file sets biblio file name: SetWrite. (line 250)
|
||||||
* -blank erases media: Writing. (line 57)
|
* -blank erases media: Writing. (line 57)
|
||||||
* -boot_image controls bootability: Bootable. (line 75)
|
* -boot_image controls bootability: Bootable. (line 75)
|
||||||
* -calm_drive reduces drive activity: Loading. (line 324)
|
* -calm_drive reduces drive activity: Loading. (line 326)
|
||||||
* -cd sets working directory in ISO: Navigate. (line 7)
|
* -cd sets working directory in ISO: Navigate. (line 7)
|
||||||
* -cdx sets working directory on disk: Navigate. (line 15)
|
* -cdx sets working directory on disk: Navigate. (line 15)
|
||||||
* -changes_pending overrides change status: Writing. (line 12)
|
* -changes_pending overrides change status: Writing. (line 12)
|
||||||
@ -5293,24 +5295,24 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
|
|||||||
* -cp_rx copies file trees to disk: Restore. (line 103)
|
* -cp_rx copies file trees to disk: Restore. (line 103)
|
||||||
* -cp_rx copies file trees to disk <1>: Restore. (line 111)
|
* -cp_rx copies file trees to disk <1>: Restore. (line 111)
|
||||||
* -cut_out inserts piece of data file: Insert. (line 139)
|
* -cut_out inserts piece of data file: Insert. (line 139)
|
||||||
* -data_cache_size adjusts read cache size: Loading. (line 350)
|
* -data_cache_size adjusts read cache size: Loading. (line 352)
|
||||||
* -dev acquires one drive for input and output: AqDrive. (line 12)
|
* -dev acquires one drive for input and output: AqDrive. (line 12)
|
||||||
* -devices gets list of drives: Inquiry. (line 7)
|
* -devices gets list of drives: Inquiry. (line 7)
|
||||||
* -device_links gets list of drives: Inquiry. (line 17)
|
* -device_links gets list of drives: Inquiry. (line 17)
|
||||||
* -dialog enables dialog mode: DialogCtl. (line 7)
|
* -dialog enables dialog mode: DialogCtl. (line 7)
|
||||||
* -disk_dev_ino fast incremental backup: Loading. (line 244)
|
* -disk_dev_ino fast incremental backup: Loading. (line 246)
|
||||||
* -disk_pattern controls pattern expansion: Insert. (line 34)
|
* -disk_pattern controls pattern expansion: Insert. (line 34)
|
||||||
* -displacement compensate altered image start address: Loading.
|
* -displacement compensate altered image start address: Loading.
|
||||||
(line 57)
|
(line 57)
|
||||||
* -drive_class controls drive accessability: Loading. (line 73)
|
* -drive_class controls drive accessability: Loading. (line 75)
|
||||||
* -du show directory size in ISO image: Navigate. (line 78)
|
* -du show directory size in ISO image: Navigate. (line 78)
|
||||||
* -dummy controls write simulation: SetWrite. (line 393)
|
* -dummy controls write simulation: SetWrite. (line 393)
|
||||||
* -dus show directory size in ISO image: Navigate. (line 81)
|
* -dus show directory size in ISO image: Navigate. (line 81)
|
||||||
* -dusx show directory size on disk: Navigate. (line 88)
|
* -dusx show directory size on disk: Navigate. (line 88)
|
||||||
* -dux show directory size on disk: Navigate. (line 84)
|
* -dux show directory size on disk: Navigate. (line 84)
|
||||||
* -dvd_obs set write block size: SetWrite. (line 330)
|
* -dvd_obs set write block size: SetWrite. (line 330)
|
||||||
* -early_stdio_test classifies stdio drives: Loading. (line 338)
|
* -early_stdio_test classifies stdio drives: Loading. (line 340)
|
||||||
* -ecma119_map names w/o Rock Ridge, Joliet: Loading. (line 232)
|
* -ecma119_map names w/o Rock Ridge, Joliet: Loading. (line 234)
|
||||||
* -eject ejects drive tray: Writing. (line 50)
|
* -eject ejects drive tray: Writing. (line 50)
|
||||||
* -end writes pending session and ends program: Scripting. (line 151)
|
* -end writes pending session and ends program: Scripting. (line 151)
|
||||||
* -errfile_log logs problematic disk files: Scripting. (line 116)
|
* -errfile_log logs problematic disk files: Scripting. (line 116)
|
||||||
@ -5321,13 +5323,13 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
|
|||||||
* -extract_cut copies file piece to disk: Restore. (line 80)
|
* -extract_cut copies file piece to disk: Restore. (line 80)
|
||||||
* -extract_l copies files to disk: Restore. (line 76)
|
* -extract_l copies files to disk: Restore. (line 76)
|
||||||
* -extract_single copies file to disk: Restore. (line 73)
|
* -extract_single copies file to disk: Restore. (line 73)
|
||||||
* -file_name_limit curbs length of file names: Loading. (line 264)
|
* -file_name_limit curbs length of file names: Loading. (line 266)
|
||||||
* -file_size_limit limits data file size: SetInsert. (line 7)
|
* -file_size_limit limits data file size: SetInsert. (line 7)
|
||||||
* -find traverses and alters ISO tree: CmdFind. (line 7)
|
* -find traverses and alters ISO tree: CmdFind. (line 7)
|
||||||
* -findx traverses disk tree: Navigate. (line 91)
|
* -findx traverses disk tree: Navigate. (line 91)
|
||||||
* -follow softlinks and mount points: SetInsert. (line 69)
|
* -follow softlinks and mount points: SetInsert. (line 69)
|
||||||
* -format formats media: Writing. (line 87)
|
* -format formats media: Writing. (line 87)
|
||||||
* -for_backup -acl,-xattr,-hardlinks,-md5: Loading. (line 218)
|
* -for_backup -acl,-xattr,-hardlinks,-md5: Loading. (line 220)
|
||||||
* -fs sets size of fifo: SetWrite. (line 396)
|
* -fs sets size of fifo: SetWrite. (line 396)
|
||||||
* -getfacl shows ACL in ISO image: Navigate. (line 60)
|
* -getfacl shows ACL in ISO image: Navigate. (line 60)
|
||||||
* -getfacl_r shows ACL in ISO image: Navigate. (line 66)
|
* -getfacl_r shows ACL in ISO image: Navigate. (line 66)
|
||||||
@ -5335,13 +5337,13 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
|
|||||||
* -getfattr_r shows xattr in ISO image: Navigate. (line 75)
|
* -getfattr_r shows xattr in ISO image: Navigate. (line 75)
|
||||||
* -gid sets global ownership: SetWrite. (line 287)
|
* -gid sets global ownership: SetWrite. (line 287)
|
||||||
* -grow_blindly overides next writeable address: AqDrive. (line 60)
|
* -grow_blindly overides next writeable address: AqDrive. (line 60)
|
||||||
* -hardlinks controls handling of hard links: Loading. (line 134)
|
* -hardlinks controls handling of hard links: Loading. (line 136)
|
||||||
* -help prints help text: Scripting. (line 19)
|
* -help prints help text: Scripting. (line 19)
|
||||||
* -hfsplus enables production of HFS+ partition: SetWrite. (line 14)
|
* -hfsplus enables production of HFS+ partition: SetWrite. (line 14)
|
||||||
* -hide excludes file names from directory trees: Manip. (line 177)
|
* -hide excludes file names from directory trees: Manip. (line 177)
|
||||||
* -history brings text into readline history: Scripting. (line 42)
|
* -history brings text into readline history: Scripting. (line 42)
|
||||||
* -indev acquires a drive for input: AqDrive. (line 23)
|
* -indev acquires a drive for input: AqDrive. (line 23)
|
||||||
* -in_charset sets input character set: Loading. (line 118)
|
* -in_charset sets input character set: Loading. (line 120)
|
||||||
* -iso_rr_pattern controls pattern expansion: Manip. (line 10)
|
* -iso_rr_pattern controls pattern expansion: Manip. (line 10)
|
||||||
* -jigdo clears JTE or or adds parameter to JTE: Jigdo. (line 33)
|
* -jigdo clears JTE or or adds parameter to JTE: Jigdo. (line 33)
|
||||||
* -joliet enables production of Joliet tree: SetWrite. (line 10)
|
* -joliet enables production of Joliet tree: SetWrite. (line 10)
|
||||||
@ -5369,7 +5371,7 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
|
|||||||
* -map_l inserts paths from disk file: Insert. (line 96)
|
* -map_l inserts paths from disk file: Insert. (line 96)
|
||||||
* -map_single inserts path: Insert. (line 93)
|
* -map_single inserts path: Insert. (line 93)
|
||||||
* -mark sets synchronizing message: Frontend. (line 23)
|
* -mark sets synchronizing message: Frontend. (line 23)
|
||||||
* -md5 controls handling of MD5 sums: Loading. (line 190)
|
* -md5 controls handling of MD5 sums: Loading. (line 192)
|
||||||
* -mkdir creates ISO directory: Insert. (line 177)
|
* -mkdir creates ISO directory: Insert. (line 177)
|
||||||
* -modesty_on_drive keep drive buffer hungry: SetWrite. (line 336)
|
* -modesty_on_drive keep drive buffer hungry: SetWrite. (line 336)
|
||||||
* -mount issues mount command for ISO session: Restore. (line 146)
|
* -mount issues mount command for ISO session: Restore. (line 146)
|
||||||
@ -5410,7 +5412,7 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
|
|||||||
* -pwdx tells working directory on disk: Navigate. (line 21)
|
* -pwdx tells working directory on disk: Navigate. (line 21)
|
||||||
* -quoted_not_list sets exclusions: SetInsert. (line 66)
|
* -quoted_not_list sets exclusions: SetInsert. (line 66)
|
||||||
* -quoted_path_list inserts paths from disk file: Insert. (line 85)
|
* -quoted_path_list inserts paths from disk file: Insert. (line 85)
|
||||||
* -read_fs filesystem type for image loading: Loading. (line 102)
|
* -read_fs filesystem type for image loading: Loading. (line 104)
|
||||||
* -read_mkisofsrc searches and reads .mkisofsrc file: Emulation.
|
* -read_mkisofsrc searches and reads .mkisofsrc file: Emulation.
|
||||||
(line 155)
|
(line 155)
|
||||||
* -read_speed set read speed: Loading. (line 11)
|
* -read_speed set read speed: Loading. (line 11)
|
||||||
@ -5426,7 +5428,7 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
|
|||||||
(line 51)
|
(line 51)
|
||||||
* -rollback discards pending changes: Writing. (line 9)
|
* -rollback discards pending changes: Writing. (line 9)
|
||||||
* -rollback_end ends program without writing: Scripting. (line 154)
|
* -rollback_end ends program without writing: Scripting. (line 154)
|
||||||
* -rom_toc_scan searches for sessions: Loading. (line 296)
|
* -rom_toc_scan searches for sessions: Loading. (line 298)
|
||||||
* -rr_reloc_dir sets name of relocation directory: SetWrite. (line 144)
|
* -rr_reloc_dir sets name of relocation directory: SetWrite. (line 144)
|
||||||
* -scdbackup_tag enables scdbackup checksum tag: Emulation. (line 179)
|
* -scdbackup_tag enables scdbackup checksum tag: Emulation. (line 179)
|
||||||
* -scsi_dev_family choose Linux device file type: AqDrive. (line 43)
|
* -scsi_dev_family choose Linux device file type: AqDrive. (line 43)
|
||||||
@ -5473,7 +5475,7 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
|
|||||||
* -volume_date sets volume timestamp: SetWrite. (line 205)
|
* -volume_date sets volume timestamp: SetWrite. (line 205)
|
||||||
* -write_type chooses TAO or SAO/DAO: SetWrite. (line 417)
|
* -write_type chooses TAO or SAO/DAO: SetWrite. (line 417)
|
||||||
* -x enables automatic execution order of arguments: ArgSort. (line 16)
|
* -x enables automatic execution order of arguments: ArgSort. (line 16)
|
||||||
* -xattr controls handling of xattr (EA): Loading. (line 178)
|
* -xattr controls handling of xattr (EA): Loading. (line 180)
|
||||||
* -zisofs controls zisofs production: SetWrite. (line 290)
|
* -zisofs controls zisofs production: SetWrite. (line 290)
|
||||||
|
|
||||||
|
|
||||||
@ -5485,7 +5487,7 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
|
|||||||
|