Mentioned --interval:appended_partition_NNN in man pages

This commit is contained in:
2016-09-12 14:38:22 +00:00
parent e3933ca63c
commit 32e08e5c8e
6 changed files with 258 additions and 181 deletions

View File

@ -2646,6 +2646,12 @@ If a boot image from ISOLINUX or GRUB is known to be present on media
then it is advised to patch it when a follow-up session gets written.
But one should not rely on the capability to influence the bootability
of the existing sessions, unless one can assume overwriteable media.
Normally the boot images are data files inside the ISO filesystem. By
special path "-interval:appended_partition_NNN:all::" it is possible to
refer to an appended partition. The number NNN gives the partition
number as used with the corresponding option -append_partition. E.g.:
-append_partition 2 0xef /tmp/efi.img
-e -interval:appended_partition_2:all::
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
hard-disk-like devices, APM partition entries for Macs which expect HFS+
@ -2668,6 +2674,10 @@ The component Flags modifies the further interpretation:
"local_fs" demands to read from a file depicted by the path in Source.
"imported_iso" demands to read from the -indev. This works only if
-outdev is not the same as -indev. The Source component is ignored.
"appended_partition_NNN" with a decimal number NNN works only for
-boot_image bootspecs which announce El Torito boot image paths:
bin_path=, efi_path=. The number gives the partition number as used
with the corresponding option -append_partition.
The component Interval consists of two byte address numbers separated by
a "-" character. E.g. "0-429" means to read bytes 0 to 429.
The component Zeroizers consists of zero or more comma separated
@ -5167,7 +5177,7 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
* -alter_date sets timestamps in ISO image: Manip. (line 136)
* -alter_date_r sets timestamps in ISO image: Manip. (line 171)
* -append_partition adds arbitrary file after image end: Bootable.
(line 391)
(line 401)
* -application_id sets application id: SetWrite. (line 191)
* -application_use sets application use field: SetWrite. (line 266)
* -as emulates mkisofs or cdrecord: Emulation. (line 13)
@ -5177,7 +5187,7 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
* -ban_stdio_write demands real drive: Loading. (line 316)
* -biblio_file sets biblio file name: SetWrite. (line 250)
* -blank erases media: Writing. (line 57)
* -boot_image controls bootability: Bootable. (line 65)
* -boot_image controls bootability: Bootable. (line 75)
* -calm_drive reduces drive activity: Loading. (line 306)
* -cd sets working directory in ISO: Navigate. (line 7)
* -cdx sets working directory on disk: Navigate. (line 15)
@ -5409,12 +5419,12 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* ACL, show in ISO image, -getfacl: Navigate. (line 60)
* ACL, show in ISO image, -getfacl_r: Navigate. (line 66)
* ACL, _definition: Extras. (line 50)
* APM block size: Bootable. (line 382)
* APM block size: Bootable. (line 392)
* APM, _definition: Extras. (line 42)
* Appendable media, _definition: Media. (line 38)
* Appended Filesystem Image, -append_partition: Bootable. (line 391)
* Appended partition, in APM: Bootable. (line 262)
* Appended partition, in MBR or GPT: Bootable. (line 255)
* Appended Filesystem Image, -append_partition: Bootable. (line 401)
* Appended partition, in APM: Bootable. (line 272)
* Appended partition, in MBR or GPT: Bootable. (line 265)
* Automatic execution order, of arguments, -x: ArgSort. (line 16)
* Backslash Interpretation, _definition: Processing. (line 53)
* Backup, enable fast incremental, -disk_dev_ino: Loading. (line 226)
@ -5423,7 +5433,7 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Blank media, _definition: Media. (line 29)
* Blank, format, Immed bit, -use_immed_bit: SetWrite. (line 374)
* Blind growing, _definition: Methods. (line 41)
* Bootability, control, -boot_image: Bootable. (line 65)
* Bootability, control, -boot_image: Bootable. (line 75)
* Bugs, reporting: Bugreport. (line 6)
* cdrecord, Emulation: Emulation. (line 120)
* Character Set, for input, -in_charset: Loading. (line 118)
@ -5432,15 +5442,15 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Character set, learn from image, -auto_charset: Loading. (line 123)
* Character Set, of terminal, -local_charset: Charset. (line 57)
* Character Set, _definition: Charset. (line 6)
* CHRP partition, _definition: Bootable. (line 267)
* CHRP partition, _definition: Bootable. (line 277)
* Closed media, _definition: Media. (line 44)
* Comment, #: Scripting. (line 156)
* Control, signal handling, -signal_handling: Exception. (line 66)
* Create, new ISO image, _definition: Methods. (line 7)
* Cylinder alignment, _definition: Bootable. (line 311)
* Cylinder size, _definition: Bootable. (line 296)
* Cylinder alignment, _definition: Bootable. (line 321)
* Cylinder size, _definition: Bootable. (line 306)
* Damaged track and session, close, -close_damaged: Writing. (line 164)
* DEC Alpha SRM boot sector, production: Bootable. (line 368)
* DEC Alpha SRM boot sector, production: Bootable. (line 378)
* Delete, from ISO image, -rm: Manip. (line 20)
* Delete, from ISO image, -rm_r: Manip. (line 26)
* Delete, ISO directory, -rmdir: Manip. (line 29)
@ -5471,7 +5481,7 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Drive, _definition: Drives. (line 6)
* EA, _definition: Extras. (line 66)
* ECMA-119, _definition: Model. (line 6)
* EFI system partition, _definition: Bootable. (line 276)
* EFI system partition, _definition: Bootable. (line 286)
* El Torito, _definition: Extras. (line 19)
* Emulation, -as: Emulation. (line 13)
* Emulation, .mkisofsrc, -read_mkisofsrc: Emulation. (line 155)
@ -5494,17 +5504,17 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Filter, _definition: Filter. (line 6)
* Frontend program, start at pipes, -launch_frontend: Frontend.
(line 141)
* GPT, control GUID, -boot_image gpt_disk_guid=: Bootable. (line 210)
* GPT, control GUID, -boot_image gpt_disk_guid=: Bootable. (line 220)
* GPT, _definition: Extras. (line 39)
* Group, global in ISO image, -gid: SetWrite. (line 287)
* Group, in ISO image, -chgrp: Manip. (line 49)
* Group, in ISO image, -chgrp_r: Manip. (line 53)
* Growing, _definition: Methods. (line 20)
* Hard links, control handling, -hardlinks: Loading. (line 134)
* HFS+ allocation block size: Bootable. (line 379)
* HFS+ serial number: Bootable. (line 376)
* HFS+ allocation block size: Bootable. (line 389)
* HFS+ serial number: Bootable. (line 386)
* hidden, set in ISO image, -hide: Manip. (line 174)
* HP-PA boot sector, production: Bootable. (line 351)
* HP-PA boot sector, production: Bootable. (line 361)
* Image reading, cache size, -data_cache_size: Loading. (line 332)
* Image, demand volume ID, -assert_volid: Loading. (line 111)
* Image, discard pending changes, -rollback: Writing. (line 9)
@ -5549,7 +5559,7 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Insert, paths, -cpr: Insert. (line 149)
* Insert, pathspecs, -add: Insert. (line 44)
* Insert, piece of data file, -cut_out: Insert. (line 124)
* Interval reader for system area and partitions: Bootable. (line 26)
* Interval reader for system area and partitions: Bootable. (line 32)
* ISO 9660, _definition: Model. (line 6)
* iso_rr_path, _definition: Insert. (line 7)
* Jigdo Template Extraction, -jigdo: Jigdo. (line 33)
@ -5558,15 +5568,15 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Linux device type, -scsi_dev_family: AqDrive. (line 43)
* List delimiter, _definition: Processing. (line 9)
* Local Character Set, _definition: Charset. (line 11)
* MBR bootable/active flag, enforce: Bootable. (line 322)
* MBR, set, -boot_image system_area=: Bootable. (line 187)
* MBR bootable/active flag, enforce: Bootable. (line 332)
* MBR, set, -boot_image system_area=: Bootable. (line 197)
* MBR, _definition: Extras. (line 27)
* MD5, control handling, -md5: Loading. (line 182)
* Media, erase, -blank: Writing. (line 57)
* Media, format, -format: Writing. (line 87)
* Media, list formats, -list_formats: Writing. (line 129)
* Media, list write speeds, -list_speeds: Writing. (line 140)
* MIPS boot file, activation: Bootable. (line 330)
* MIPS boot file, activation: Bootable. (line 340)
* mkisofs, Emulation: Emulation. (line 17)
* Modifying, _definition: Methods. (line 28)
* Multi-session media, _definition: Media. (line 7)
@ -5593,15 +5603,15 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Ownership, global in ISO image, -uid: SetWrite. (line 284)
* Ownership, in ISO image, -chown: Manip. (line 43)
* Ownership, in ISO image, -chown_r: Manip. (line 47)
* Partition offset, _definition: Bootable. (line 286)
* Partition table, _definition: Bootable. (line 236)
* Partition offset, _definition: Bootable. (line 296)
* Partition table, _definition: Bootable. (line 246)
* Pathspec, _definition: SetInsert. (line 117)
* Pattern expansion, for disk paths, -disk_pattern: Insert. (line 34)
* Pattern expansion, for ISO paths, -iso_rr_pattern: Manip. (line 10)
* Pattern expansion, _definition: Processing. (line 25)
* Permissions, in ISO image, -chmod: Manip. (line 55)
* Permissions, in ISO image, -chmod_r: Manip. (line 66)
* PReP partition, _definition: Bootable. (line 271)
* PReP partition, _definition: Bootable. (line 281)
* Problems, reporting: Bugreport. (line 6)
* Process, consolidate text output, -pkt_output: Frontend. (line 7)
* Process, control abort on error, -abort_on: Exception. (line 27)
@ -5661,10 +5671,10 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Session, select as input, -load: Loading. (line 33)
* Session, _definition: Model. (line 6)
* Sorting order, for -x, -list_arg_sorting: ArgSort. (line 26)
* SUN Disk Label, production: Bootable. (line 341)
* SUN SPARC boot images, activation: Bootable. (line 414)
* SUN Disk Label, production: Bootable. (line 351)
* SUN SPARC boot images, activation: Bootable. (line 424)
* Symbolic link, create, -lns: Insert. (line 166)
* System area, _definition: Bootable. (line 187)
* System area, _definition: Bootable. (line 197)
* Table-of-content, search sessions, -rom_toc_scan: Loading. (line 278)
* Table-of-content, show, -toc: Inquiry. (line 27)
* Timestamps, set in ISO image, -alter_date: Manip. (line 136)
@ -5680,7 +5690,7 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Verify, file tree checksums, -check_md5_r: Verify. (line 178)
* Verify, preset -check_media, -check_media_defaults: Verify. (line 40)
* Write, block size, -dvd_obs: SetWrite. (line 330)
* Write, bootability, -boot_image: Bootable. (line 65)
* Write, bootability, -boot_image: Bootable. (line 75)
* Write, buffer syncing, -stdio_sync: SetWrite. (line 386)
* Write, close media, -close: SetWrite. (line 401)
* Write, compliance to specs, -compliance: SetWrite. (line 56)
@ -5731,40 +5741,40 @@ Node: Filter100989
Node: Writing105611
Node: SetWrite115767
Node: Bootable140526
Node: Jigdo165262
Node: Charset169521
Node: Exception172850
Node: DialogCtl178979
Node: Inquiry181581
Node: Navigate190369
Node: Verify198664
Node: Restore208542
Node: Emulation217155
Node: Scripting227614
Node: Frontend235397
Node: Examples245023
Node: ExDevices246201
Node: ExCreate246862
Node: ExDialog248162
Node: ExGrowing249433
Node: ExModifying250242
Node: ExBootable250752
Node: ExCharset251307
Node: ExPseudo252203
Node: ExCdrecord253130
Node: ExMkisofs253450
Node: ExGrowisofs254807
Node: ExException255961
Node: ExTime256419
Node: ExIncBackup256877
Node: ExRestore260903
Node: ExRecovery261849
Node: Files262421
Node: Environ263755
Node: Seealso264461
Node: Bugreport265178
Node: Legal265769
Node: CommandIdx266781
Node: ConceptIdx283969
Node: Jigdo165871
Node: Charset170130
Node: Exception173459
Node: DialogCtl179588
Node: Inquiry182190
Node: Navigate190978
Node: Verify199273
Node: Restore209151
Node: Emulation217764
Node: Scripting228223
Node: Frontend236006
Node: Examples245632
Node: ExDevices246810
Node: ExCreate247471
Node: ExDialog248771
Node: ExGrowing250042
Node: ExModifying250851
Node: ExBootable251361
Node: ExCharset251916
Node: ExPseudo252812
Node: ExCdrecord253739
Node: ExMkisofs254059
Node: ExGrowisofs255416
Node: ExException256570
Node: ExTime257028
Node: ExIncBackup257486
Node: ExRestore261512
Node: ExRecovery262458
Node: Files263030
Node: Environ264364
Node: Seealso265070
Node: Bugreport265787
Node: Legal266378
Node: CommandIdx267390
Node: ConceptIdx284578

End Tag Table