From 9b8b8aaa520b5a6b5a2722423e33df8b690dd337 Mon Sep 17 00:00:00 2001 From: Thomas Schmitt Date: Mon, 12 Sep 2016 14:38:22 +0000 Subject: [PATCH] Mentioned --interval:appended_partition_NNN in man pages --- libisoburn/trunk/xorriso/xorriso.1 | 16 +- libisoburn/trunk/xorriso/xorriso.info | 134 +++++++------ libisoburn/trunk/xorriso/xorriso.texi | 17 +- libisoburn/trunk/xorriso/xorrisofs.1 | 16 +- libisoburn/trunk/xorriso/xorrisofs.info | 240 ++++++++++++------------ libisoburn/trunk/xorriso/xorrisofs.texi | 16 +- 6 files changed, 258 insertions(+), 181 deletions(-) diff --git a/libisoburn/trunk/xorriso/xorriso.1 b/libisoburn/trunk/xorriso/xorriso.1 index bf5873c8..6829785c 100644 --- a/libisoburn/trunk/xorriso/xorriso.1 +++ b/libisoburn/trunk/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.4.5, Aug 20, 2016" +.TH XORRISO 1 "Version 1.4.5, Sep 12, 2016" .\" Please adjust this date whenever revising the manpage. .\" .\" Some roff macros, for reference: @@ -3121,6 +3121,15 @@ 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. .br +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.: +.br + \-append_partition 2 0xef /tmp/efi.img + \-e \-\-interval:appended_partition_2:all:: +.br 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, @@ -3151,6 +3160,11 @@ The component Flags modifies the further interpretation: "imported_iso" demands to read from the \-indev. This works only if \-outdev is not the same as \-indev. The Source component is ignored. .br +"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. +.br The component Interval consists of two byte address numbers separated by a "\-" character. E.g. "0\-429" means to read bytes 0 to 429. .br The component Zeroizers consists of zero or more comma separated strings. diff --git a/libisoburn/trunk/xorriso/xorriso.info b/libisoburn/trunk/xorriso/xorriso.info index 7741bd8a..6372dba5 100644 --- a/libisoburn/trunk/xorriso/xorriso.info +++ b/libisoburn/trunk/xorriso/xorriso.info @@ -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 diff --git a/libisoburn/trunk/xorriso/xorriso.texi b/libisoburn/trunk/xorriso/xorriso.texi index 3fbf806a..ab94de54 100644 --- a/libisoburn/trunk/xorriso/xorriso.texi +++ b/libisoburn/trunk/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.4.5, Aug 20, 2016" +@c man .TH XORRISO 1 "Version 1.4.5, Sep 12, 2016" @c man .\" Please adjust this date whenever revising the manpage. @c man .\" @c man .\" Some roff macros, for reference: @@ -3649,6 +3649,16 @@ 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, @@ -3682,6 +3692,11 @@ The component Flags modifies the further interpretation: "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 strings. diff --git a/libisoburn/trunk/xorriso/xorrisofs.1 b/libisoburn/trunk/xorriso/xorrisofs.1 index 3c708b99..6a78b7cc 100644 --- a/libisoburn/trunk/xorriso/xorrisofs.1 +++ b/libisoburn/trunk/xorriso/xorrisofs.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 XORRISOFS 1 "Version 1.4.5, Aug 20, 2016" +.TH XORRISOFS 1 "Version 1.4.5, Sep 12, 2016" .\" Please adjust this date whenever revising the manpage. .\" .\" Some roff macros, for reference: @@ -934,6 +934,16 @@ xorriso composes the boot catalog according to the boot image files given and structured by options \-b, \-e, \-el\-torito\-alt\-boot, and \-\-efi\-boot. Often it contains only one entry. .br +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.: +.br + \-append_partition 2 0xef /tmp/efi.img +.br + \-e \-\-interval:appended_partition_2:all:: +.br El Torito gets interpreted by boot facilities PC\-BIOS and EFI. Most bootable GNU/Linux CDs are equipped with ISOLINUX or GRUB boot images for PC\-BIOS. @@ -1086,6 +1096,10 @@ The component Flags modifies the further interpretation: "imported_iso" demands to read from the \-indev. This works only if \-outdev is not the same as \-indev. The Source component is ignored. .br +"appended_partition_NNN" with a decimal number NNN works only for options +which announce El Torito boot image paths: \-b, \-e, \-\-efi\-boot. The number gives +the partition number as used with the corresponding option \-append_partition. +.br The component Interval consists of two byte address numbers separated by a "\-" character. E.g. "0\-429" means to read bytes 0 to 429. .br The component Zeroizers consists of zero or more comma separated strings. diff --git a/libisoburn/trunk/xorriso/xorrisofs.info b/libisoburn/trunk/xorriso/xorrisofs.info index a75cd257..138c5185 100644 --- a/libisoburn/trunk/xorriso/xorrisofs.info +++ b/libisoburn/trunk/xorriso/xorrisofs.info @@ -839,6 +839,12 @@ not in the scope of El Torito. xorriso composes the boot catalog according to the boot image files given and structured by options -b, -e, -el-torito-alt-boot, and --efi-boot. Often it contains only one entry. +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:: El Torito gets interpreted by boot facilities PC-BIOS and EFI. Most bootable GNU/Linux CDs are equipped with ISOLINUX or GRUB boot images for PC-BIOS. @@ -962,6 +968,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 +options which announce El Torito boot image paths: -b, -e, -efi-boot. +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 @@ -1874,18 +1884,18 @@ File: xorrisofs.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: T * --acl Recording of ACLs: SetExtras. (line 95) * --application_use set Application Use field: ImageId. (line 79) -* --boot-catalog-hide Hide El Torito boot catalog: Bootable. (line 101) -* --efi-boot El Torito EFI boot image: Bootable. (line 53) -* --embedded-boot Fill System Area e.g. by MBR: SystemArea. (line 75) +* --boot-catalog-hide Hide El Torito boot catalog: Bootable. (line 107) +* --efi-boot El Torito EFI boot image: Bootable. (line 59) +* --embedded-boot Fill System Area e.g. by MBR: SystemArea. (line 79) * --emul-toc enable table-of-content emulation: SetProduct. (line 33) * --for_backup Enable backup fidelity: SetExtras. (line 92) -* --gpt_disk_guid GPT GUID: SystemArea. (line 216) -* --grub2-boot-info Patch El Torito boot image: Bootable. (line 89) -* --grub2-mbr Install modern GRUB2 MBR: SystemArea. (line 77) -* --grub2-sparc-core SUN SPARC core file: SystemArea. (line 271) +* --gpt_disk_guid GPT GUID: SystemArea. (line 220) +* --grub2-boot-info Patch El Torito boot image: Bootable. (line 95) +* --grub2-mbr Install modern GRUB2 MBR: SystemArea. (line 81) +* --grub2-sparc-core SUN SPARC core file: SystemArea. (line 275) * --hardlinks Recording of hardlink relations: SetExtras. (line 116) * --mbr-force-bootable Enforce MBR bootable/active flag: SystemArea. - (line 127) + (line 131) * --md5 Recording of MD5 checksums: SetExtras. (line 108) * --modification-date set ISO image timestamps: ImageId. (line 70) * --no-emul-toc no table-of-content emulation: SetProduct. (line 41) @@ -1899,7 +1909,7 @@ File: xorrisofs.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: T (line 73) * --old-root-no-md5 disable MD5 with -old-root: SetInsert. (line 91) * --protective-msdos-label Patch System Area partition table: SystemArea. - (line 123) + (line 127) * --quoted_path_list read pathspecs from disk file: SetInsert. (line 12) * --scdbackup_tag Recording of MD5 checksum: SetExtras. (line 124) @@ -1915,28 +1925,28 @@ File: xorrisofs.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: T * -A set Application Id: ImageId. (line 34) * -abstract set Abstract File path: ImageId. (line 57) * -allow-lowercase lowercase in ISO file names: SetCompl. (line 42) -* -alpha-boot DEC Alpha SRM bootloader: SystemArea. (line 294) +* -alpha-boot DEC Alpha SRM bootloader: SystemArea. (line 298) * -appended_part_as_apm Appended partitions in APM: SystemArea. - (line 200) + (line 204) * -appended_part_as_gpt Appended partitions in GPT: SystemArea. - (line 194) + (line 198) * -append_partition Append MBR or GPT partition after image: SystemArea. - (line 174) + (line 178) * -appid set Application Id: ImageId. (line 41) -* -b El Torito PC-BIOS boot image: Bootable. (line 32) -* -B SUN SPARC boot images: SystemArea. (line 256) +* -b El Torito PC-BIOS boot image: Bootable. (line 38) +* -B SUN SPARC boot images: SystemArea. (line 260) * -biblio set Biblio File path: ImageId. (line 62) -* -boot-info-table Patch El Torito boot image: Bootable. (line 84) -* -boot-load-size El Torito boot image load size: Bootable. (line 57) -* -c El Torito boot catalog name: Bootable. (line 94) +* -boot-info-table Patch El Torito boot image: Bootable. (line 90) +* -boot-load-size El Torito boot image load size: Bootable. (line 63) +* -c El Torito boot catalog name: Bootable. (line 100) * -C set load address and write address offset: Loading. (line 25) * -cdrecord-params set load address and write address offset: Loading. (line 46) * -checksum_algorithm_iso choose .jigdo checksums: Jigdo. (line 72) * -checksum_algorithm_template choose .template checksums: Jigdo. (line 78) -* -chrp-boot CHRP partition: SystemArea. (line 238) -* -chrp-boot-part CHRP partition: SystemArea. (line 229) +* -chrp-boot CHRP partition: SystemArea. (line 242) +* -chrp-boot-part CHRP partition: SystemArea. (line 233) * -copyright set Copyright File path: ImageId. (line 66) * -D allow deep directory hierachies: SetExtras. (line 60) * -d omit trailing dot in ISO file names: SetCompl. (line 50) @@ -1946,14 +1956,14 @@ File: xorrisofs.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: T (line 72) * -disallow_dir_id_ext enforce ISO level 1 directory names: SetCompl. (line 23) -* -e El Torito EFI boot image: Bootable. (line 47) -* -efi-boot-part EFI boot partition: SystemArea. (line 206) -* -eltorito-alt-boot begin next boot catalog entry: Bootable. (line 41) -* -eltorito-boot El Torito PC-BIOS boot image: Bootable. (line 39) -* -eltorito-catalog El Torito boot catalog name: Bootable. (line 99) -* -eltorito-id El Torito boot section id string: Bootable. (line 73) +* -e El Torito EFI boot image: Bootable. (line 53) +* -efi-boot-part EFI boot partition: SystemArea. (line 210) +* -eltorito-alt-boot begin next boot catalog entry: Bootable. (line 47) +* -eltorito-boot El Torito PC-BIOS boot image: Bootable. (line 45) +* -eltorito-catalog El Torito boot catalog name: Bootable. (line 105) +* -eltorito-id El Torito boot section id string: Bootable. (line 79) * -eltorito-selcrit El Torito boot selection criteria: Bootable. - (line 80) + (line 86) * -exclude exclude disk files from inserting: SetInsert. (line 37) * -exclude-list exclude disk files from inserting: SetInsert. (line 44) * -f follow symbolic links on disk: SetInsert. (line 22) @@ -1962,12 +1972,12 @@ File: xorrisofs.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: T * -follow-links follow symbolic links on disk: SetInsert. (line 26) * -full-iso9660-filenames allow 31 characters in ISO file names: SetCompl. (line 59) -* -G Fill System Area e.g. by MBR: SystemArea. (line 64) -* -generic-boot Fill System Area e.g. by MBR: SystemArea. (line 73) +* -G Fill System Area e.g. by MBR: SystemArea. (line 68) +* -generic-boot Fill System Area e.g. by MBR: SystemArea. (line 77) * -graft-points enable target=source pathspecs: SetInsert. (line 28) * -gui increase frequency of pacifier messages: Miscellaneous. (line 29) -* -hard-disk-boot El Torito boot image emulation: Bootable. (line 63) +* -hard-disk-boot El Torito boot image emulation: Bootable. (line 69) * -help list supported options: Miscellaneous. (line 21) * -hfs-bless HFS+ blessing ppc_bootdir: SetExtras. (line 201) * -hfs-bless-by HFS+ blessing: SetExtras. (line 191) @@ -1991,20 +2001,20 @@ File: xorrisofs.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: T (line 15) * -hide-rr-moved set deep directory relocation target: SetExtras. (line 90) -* -hppa-bootloader HP-PA bootloader file: SystemArea. (line 283) -* -hppa-cmdline HP-PA PALO command line: SystemArea. (line 277) -* -hppa-hdrversion HP-PA PALO header version: SystemArea. (line 291) -* -hppa-kernel_32 HP-PA kernel_32 file: SystemArea. (line 285) -* -hppa-kernel_64 HP-PA kernel_64 file: SystemArea. (line 287) -* -hppa-ramdisk HP-PA ramdisk file: SystemArea. (line 289) +* -hppa-bootloader HP-PA bootloader file: SystemArea. (line 287) +* -hppa-cmdline HP-PA PALO command line: SystemArea. (line 281) +* -hppa-hdrversion HP-PA PALO header version: SystemArea. (line 295) +* -hppa-kernel_32 HP-PA kernel_32 file: SystemArea. (line 289) +* -hppa-kernel_64 HP-PA kernel_64 file: SystemArea. (line 291) +* -hppa-ramdisk HP-PA ramdisk file: SystemArea. (line 293) * -input-charset set character set of disk file names: Charset. (line 17) * -iso-level define ISO 9660 limitations: SetCompl. (line 7) * -iso-level define ISO 9660 limitations <1>: SetCompl. (line 8) -* -isohybrid-apm-hfsplus Mark boot image in APM: SystemArea. (line 108) -* -isohybrid-gpt-basdat Mark boot image in GPT: SystemArea. (line 94) -* -isohybrid-gpt-hfsplus Mark boot image in GPT: SystemArea. (line 104) -* -isohybrid-mbr Install ISOLINUX isohybrid MBR: SystemArea. (line 83) +* -isohybrid-apm-hfsplus Mark boot image in APM: SystemArea. (line 112) +* -isohybrid-gpt-basdat Mark boot image in GPT: SystemArea. (line 98) +* -isohybrid-gpt-hfsplus Mark boot image in GPT: SystemArea. (line 108) +* -isohybrid-mbr Install ISOLINUX isohybrid MBR: SystemArea. (line 87) * -J enable production of Joliet directory tree: SetExtras. (line 133) * -jigdo-exclude add exclusion pattern for .md5: Jigdo. (line 55) * -jigdo-force-md5 add check pattern for .md5: Jigdo. (line 49) @@ -2025,10 +2035,10 @@ File: xorrisofs.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: T * -max-iso9660-filenames allow 37 characters in ISO file names: SetCompl. (line 61) * -md5-list set path of readable .md5: Jigdo. (line 67) -* -mips-boot MIPS Big Endian boot image: SystemArea. (line 245) -* -mipsel-boot MIPS Little Endian boot image: SystemArea. (line 251) +* -mips-boot MIPS Big Endian boot image: SystemArea. (line 249) +* -mipsel-boot MIPS Little Endian boot image: SystemArea. (line 255) * -N omit version number in ISO file names: SetCompl. (line 64) -* -no-emul-boot El Torito boot image emulation: Bootable. (line 66) +* -no-emul-boot El Torito boot image emulation: Bootable. (line 72) * -no-pad do not add zeros to ISO tree: SetProduct. (line 93) * -o set output file address: SetProduct. (line 8) * -old-exclude exclude disk files from inserting: SetInsert. (line 42) @@ -2042,15 +2052,15 @@ File: xorrisofs.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: T * -p set Preparer Id: ImageId. (line 47) * -P set Publisher Id: ImageId. (line 28) * -pad add 300 KiB of zeros to ISO tree: SetProduct. (line 86) -* -partition_cyl_align Image size alignment: SystemArea. (line 163) -* -partition_hd_cyl MBR heads per cylinder: SystemArea. (line 146) +* -partition_cyl_align Image size alignment: SystemArea. (line 167) +* -partition_hd_cyl MBR heads per cylinder: SystemArea. (line 150) * -partition_offset Make mountable by partition 1: SystemArea. - (line 135) -* -partition_sec_hd MBR sectors per head: SystemArea. (line 149) + (line 139) +* -partition_sec_hd MBR sectors per head: SystemArea. (line 153) * -part_like_isohybrid Mark partitions like with isohybrid: SystemArea. - (line 116) + (line 120) * -path-list read pathspecs from disk file: SetInsert. (line 8) -* -prep-boot-part PReP partition: SystemArea. (line 240) +* -prep-boot-part PReP partition: SystemArea. (line 244) * -preparer set Preparer Id: ImageId. (line 55) * -prev-session set path for loading existing ISO image: Loading. (line 21) @@ -2067,8 +2077,8 @@ File: xorrisofs.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: T * -root redirect ISO root directory: SetInsert. (line 55) * -rr_reloc_dir set deep directory relocation target: SetExtras. (line 74) -* -sparc-boot SUN SPARC boot images: SystemArea. (line 267) -* -sparc-label SUN Disk Label text: SystemArea. (line 269) +* -sparc-boot SUN SPARC boot images: SystemArea. (line 271) +* -sparc-label SUN Disk Label text: SystemArea. (line 273) * -sysid set System Id: ImageId. (line 43) * -transparent-compression enable recognition of zisofs files: SetInsert. (line 53) @@ -2097,7 +2107,7 @@ File: xorrisofs.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top * Abstract File, set path, -abstract: ImageId. (line 57) * ACL, record and load, --acl: SetExtras. (line 95) * APM, mark appended partitions, -appended_part_as_apm: SystemArea. - (line 200) + (line 204) * APM, _definition: SystemArea. (line 16) * Application Id, set, -A, -appid: ImageId. (line 34) * Backup, enable fidelity, --for_backup: SetExtras. (line 92) @@ -2109,60 +2119,60 @@ File: xorrisofs.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top * Block address, set sorting weight, --sort-weight-patterns: SetProduct. (line 76) * Bootability, boot catalog hidden, --boot-catalog-hide: Bootable. - (line 101) + (line 107) * Bootability, boot catalog name, -c, -eltorito-catalog: Bootable. - (line 94) + (line 100) * Bootability, boot image emulation, -hard-disk-boot: Bootable. - (line 63) + (line 69) * Bootability, boot image load size, -boot-load-size: Bootable. - (line 57) + (line 63) * Bootability, boot image patching, --grub2-boot-info: Bootable. - (line 89) + (line 95) * Bootability, boot image patching, -boot-info-table: Bootable. - (line 84) + (line 90) * Bootability, bootable MBR partition, --mbr-force-bootable: SystemArea. - (line 127) -* Bootability, control, --grub2-sparc-core: SystemArea. (line 271) -* Bootability, control, --efi-boot: Bootable. (line 53) -* Bootability, control, -alpha-boot: SystemArea. (line 294) -* Bootability, control, -b, -eltorito-boot: Bootable. (line 32) -* Bootability, control, -B, -sparc-boot: SystemArea. (line 256) -* Bootability, control, -e: Bootable. (line 47) -* Bootability, control, -hppa-bootloader: SystemArea. (line 283) -* Bootability, control, -hppa-cmdline: SystemArea. (line 277) -* Bootability, control, -hppa-hdrversion: SystemArea. (line 291) -* Bootability, control, -hppa-kernel_32: SystemArea. (line 285) -* Bootability, control, -hppa-kernel_64: SystemArea. (line 287) -* Bootability, control, -hppa-ramdisk: SystemArea. (line 289) -* Bootability, control, -mips-boot: SystemArea. (line 245) -* Bootability, control, -mipsel-boot: SystemArea. (line 251) + (line 131) +* Bootability, control, --grub2-sparc-core: SystemArea. (line 275) +* Bootability, control, --efi-boot: Bootable. (line 59) +* Bootability, control, -alpha-boot: SystemArea. (line 298) +* Bootability, control, -b, -eltorito-boot: Bootable. (line 38) +* Bootability, control, -B, -sparc-boot: SystemArea. (line 260) +* Bootability, control, -e: Bootable. (line 53) +* Bootability, control, -hppa-bootloader: SystemArea. (line 287) +* Bootability, control, -hppa-cmdline: SystemArea. (line 281) +* Bootability, control, -hppa-hdrversion: SystemArea. (line 295) +* Bootability, control, -hppa-kernel_32: SystemArea. (line 289) +* Bootability, control, -hppa-kernel_64: SystemArea. (line 291) +* Bootability, control, -hppa-ramdisk: SystemArea. (line 293) +* Bootability, control, -mips-boot: SystemArea. (line 249) +* Bootability, control, -mipsel-boot: SystemArea. (line 255) * Bootability, El Torito section id string, -eltorito-id: Bootable. - (line 73) + (line 79) * Bootability, El Torito selection criteria, -eltorito-selcrit: Bootable. - (line 80) + (line 86) * Bootability, fill System Area e.g. by MBR, -G, --embedded-boot, -generic-boot: SystemArea. - (line 64) -* Bootability, for CHRP, -chrp-boot-part: SystemArea. (line 229) -* Bootability, for EFI, -efi-boot-part: SystemArea. (line 206) -* Bootability, for PReP, -prep-boot-part: SystemArea. (line 240) + (line 68) +* Bootability, for CHRP, -chrp-boot-part: SystemArea. (line 233) +* Bootability, for EFI, -efi-boot-part: SystemArea. (line 210) +* Bootability, for PReP, -prep-boot-part: SystemArea. (line 244) * Bootability, install ISOLINUX isohybrid MBR, -isohybrid-mbr: SystemArea. - (line 83) + (line 87) * Bootability, install modern GRUB2 MBR, --grub2-mbr: SystemArea. - (line 77) + (line 81) * Bootability, mark boot image in APM, -isohybrid-apm-hfsplus: SystemArea. - (line 108) + (line 112) * Bootability, mark boot image in GPT, -isohybrid-gpt-basdat: SystemArea. - (line 94) + (line 98) * Bootability, mark boot image in GPT, -isohybrid-gpt-hfsplus: SystemArea. - (line 104) -* Bootability, next entry, -eltorito-alt-boot: Bootable. (line 41) + (line 108) +* Bootability, next entry, -eltorito-alt-boot: Bootable. (line 47) * Bootability, no boot image emulation, -no-emul-boot: Bootable. - (line 66) + (line 72) * Bootability, partitions like with isohybrid, -part_like_isohybrid: SystemArea. - (line 116) + (line 120) * Bootability, patch System Area partition table, --protective-msdos-label: SystemArea. - (line 123) -* Bootability, SUN Disk Label text, -sparc-label: SystemArea. (line 269) + (line 127) +* Bootability, SUN Disk Label text, -sparc-label: SystemArea. (line 273) * Bugs, reporting: Bugreport. (line 6) * Character Set, for disk file names, -input-charset: Charset. (line 17) @@ -2179,7 +2189,7 @@ File: xorrisofs.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top * Disk files, exclude, -hide-list: SetInsert. (line 44) * Disk files, exclude, -m, -exclude, -x, -old-exclude: SetInsert. (line 31) -* Disk GUID, for GPT, --gpt_disk_guid: SystemArea. (line 216) +* Disk GUID, for GPT, --gpt_disk_guid: SystemArea. (line 220) * disk_path, _definition: Insert. (line 7) * ECMA-119, _definition: Standards. (line 6) * El Torito, _definition: Bootable. (line 13) @@ -2188,7 +2198,7 @@ File: xorrisofs.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top * File timestamps, set all, --set_all_file_dates: SetExtras. (line 35) * Forced output, control, --stdio_sync: SetProduct. (line 23) * GPT, mark appended partitions, -appended_part_as_gpt: SystemArea. - (line 194) + (line 198) * GPT, _definition: SystemArea. (line 13) * HFS+, enables production: SetExtras. (line 150) * HFS+, issue blessing ppc_bootdir, -hfs-bless: SetExtras. (line 201) @@ -2205,7 +2215,7 @@ File: xorrisofs.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top * Hiding, from ISO and Rock Ridge, -hide-list: SetHide. (line 15) * Hiding, from Joliet, -hide-joliet: SetHide. (line 18) * Hiding, from Joliet, -hide-joliet-list: SetHide. (line 22) -* Image size, alignment, -partition_cyl_align: SystemArea. (line 163) +* Image size, alignment, -partition_cyl_align: SystemArea. (line 167) * Incremental insertion, disable disk ino, --old-root-no-ino: SetInsert. (line 73) * Incremental insertion, disable MD5, --old-root-no-md5: SetInsert. @@ -2259,16 +2269,16 @@ File: xorrisofs.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top * Joliet, _definition: Standards. (line 21) * Links, follow on disk, -f, -follow-links: SetInsert. (line 22) * Links, record and load hard links, --hardlinks: SetExtras. (line 116) -* MBR, GPT, append partition, -append_partition: SystemArea. (line 174) -* MBR, sectors per head, -partition_sec_hd: SystemArea. (line 146) -* MBR, sectors per head, -partition_sec_hd <1>: SystemArea. (line 149) +* MBR, GPT, append partition, -append_partition: SystemArea. (line 178) +* MBR, sectors per head, -partition_sec_hd: SystemArea. (line 150) +* MBR, sectors per head, -partition_sec_hd <1>: SystemArea. (line 153) * MBR, _definition: SystemArea. (line 9) * MD5, record and load, --md5: SetExtras. (line 108) * Message output, increase frequency, -gui: Miscellaneous. (line 29) * Message output, redirect stderr, -log-file: Miscellaneous. (line 33) * Message output, suppress, -quiet: Miscellaneous. (line 25) * Mountability, by non-trivial partition 1, -partition_offset: SystemArea. - (line 135) + (line 139) * Options, list, -help: Miscellaneous. (line 21) * Output file, set address, -o, -output: SetProduct. (line 8) * Padding, 300 KiB, -pad: SetProduct. (line 86) @@ -2325,24 +2335,24 @@ Node: SetExtras21966 Node: SetHide32539 Node: ImageId33843 Node: Bootable38125 -Node: SystemArea43293 -Node: Charset59742 -Node: Jigdo60767 -Node: Miscellaneous65044 -Node: Examples66689 -Node: ExSimple67183 -Node: ExGraft67666 -Node: ExMkisofs68966 -Node: ExGrowisofs70232 -Node: ExIncBackup71422 -Node: ExIncBckAcc74583 -Node: ExBootable76272 -Node: Files80454 -Node: Environ81549 -Node: Seealso82320 -Node: Bugreport82971 -Node: Legal83564 -Node: CommandIdx84461 -Node: ConceptIdx99899 +Node: SystemArea43653 +Node: Charset60333 +Node: Jigdo61358 +Node: Miscellaneous65635 +Node: Examples67280 +Node: ExSimple67774 +Node: ExGraft68257 +Node: ExMkisofs69557 +Node: ExGrowisofs70823 +Node: ExIncBackup72013 +Node: ExIncBckAcc75174 +Node: ExBootable76863 +Node: Files81045 +Node: Environ82140 +Node: Seealso82911 +Node: Bugreport83562 +Node: Legal84155 +Node: CommandIdx85052 +Node: ConceptIdx100490  End Tag Table diff --git a/libisoburn/trunk/xorriso/xorrisofs.texi b/libisoburn/trunk/xorriso/xorrisofs.texi index 67586e7a..bb9ab780 100644 --- a/libisoburn/trunk/xorriso/xorrisofs.texi +++ b/libisoburn/trunk/xorriso/xorrisofs.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 XORRISOFS 1 "Version 1.4.5, Aug 20, 2016" +@c man .TH XORRISOFS 1 "Version 1.4.5, Sep 12, 2016" @c man .\" Please adjust this date whenever revising the manpage. @c man .\" @c man .\" Some roff macros, for reference: @@ -1273,6 +1273,16 @@ xorriso composes the boot catalog according to the boot image files given and structured by options -b, -e, -el-torito-alt-boot, and @minus{}@minus{}efi-boot. Often it contains only one entry. @* +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:: +@* El Torito gets interpreted by boot facilities PC-BIOS and EFI. Most bootable GNU/Linux CDs are equipped with ISOLINUX or GRUB boot images for PC-BIOS. @@ -1465,6 +1475,10 @@ The component Flags modifies the further interpretation: "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 options +which announce El Torito boot image paths: -b, -e, --efi-boot. 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 strings.