libburnia/libisoburn
2
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Clarified that El Torito images for EFI always get their own size as load size

Browse Source
This commit is contained in:
Thomas Schmitt 2024-12-20 17:37:29 +01:00
parent 362a17c571
commit 23f28b97e5
6 changed files with 96 additions and 90 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
xorriso/xorriso.1
View File

@ -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.5.7, Dec 08, 2024" .TH XORRISO 1 "Version 1.5.7, Dec 19, 2024"
.\" 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:
@ -4035,9 +4035,9 @@ The default "no_emulation" is suitable for ISOLINUX, GRUB, FreeBSD cdboot.
Default for legacy BIOS is 2048 which matches the expectations of most BIOS Default for legacy BIOS is 2048 which matches the expectations of most BIOS
boot images. The special value "full" means the full size of the boot image boot images. The special value "full" means the full size of the boot image
file rounded up to a multiple of 2048 bytes. Maximum is 33,552,384 bytes. file rounded up to a multiple of 2048 bytes. Maximum is 33,552,384 bytes.
With EFI boot images the default is the full image size. Images which exceed With EFI boot images the load size is always the full image size.
the maximum size get size 0 or 1, which means "up to the end of the device" Images which exceed the maximum size get size 0 or 1, which means
according to the UEFI specification. "up to the end of the device" according to the UEFI specification.
.br .br
\fBboot_info_table=on\fR causes address patching to bytes 8 to 63 \fBboot_info_table=on\fR causes address patching to bytes 8 to 63
of the boot image which is given by "any" "bin_path=". of the boot image which is given by "any" "bin_path=".

78
xorriso/xorriso.info
View File

@ -3400,10 +3400,10 @@ Examples:
for legacy BIOS is 2048 which matches the expectations of most BIOS for legacy BIOS is 2048 which matches the expectations of most BIOS
boot images. The special value "full" means the full size of the boot images. The special value "full" means the full size of the
boot image file rounded up to a multiple of 2048 bytes. Maximum is boot image file rounded up to a multiple of 2048 bytes. Maximum is
33,552,384 bytes. With EFI boot images the default is the full 33,552,384 bytes. With EFI boot images the load size is always the
image size. Images which exceed the maximum size get size 0 or 1, full image size. Images which exceed the maximum size get size 0
which means "up to the end of the device" according to the UEFI or 1, which means "up to the end of the device" according to the
specification. UEFI specification.
*boot_info_table=on* causes address patching to bytes 8 to 63 of *boot_info_table=on* causes address patching to bytes 8 to 63 of
the boot image which is given by "any" "bin_path=". the boot image which is given by "any" "bin_path=".
"boot_info_table=off" disables this patching. "boot_info_table=off" disables this patching.
@ -6783,40 +6783,40 @@ Node: Filter125299
Node: Writing129921 Node: Writing129921
Node: SetWrite142415 Node: SetWrite142415
Node: Bootable173847 Node: Bootable173847
Node: Jigdo206572 Node: Jigdo206581
Node: Charset211575 Node: Charset211584
Node: Exception214904 Node: Exception214913
Node: DialogCtl221093 Node: DialogCtl221102
Node: Inquiry223695 Node: Inquiry223704
Node: Navigate236390 Node: Navigate236399
Node: Verify248443 Node: Verify248452
Node: Restore259592 Node: Restore259601
Node: Emulation271799 Node: Emulation271808
Node: Scripting283375 Node: Scripting283384
Node: Frontend291630 Node: Frontend291639
Node: Examples301256 Node: Examples301265
Node: ExDevices302434 Node: ExDevices302443
Node: ExCreate303095 Node: ExCreate303104
Node: ExDialog304395 Node: ExDialog304404
Node: ExGrowing305666 Node: ExGrowing305675
Node: ExModifying306475 Node: ExModifying306484
Node: ExBootable306985 Node: ExBootable306994
Node: ExCharset307540 Node: ExCharset307549
Node: ExPseudo308436 Node: ExPseudo308445
Node: ExCdrecord309363 Node: ExCdrecord309372
Node: ExMkisofs309683 Node: ExMkisofs309692
Node: ExGrowisofs311580 Node: ExGrowisofs311589
Node: ExException312733 Node: ExException312742
Node: ExTime313191 Node: ExTime313200
Node: ExIncBackup313649 Node: ExIncBackup313658
Node: ExRestore317675 Node: ExRestore317684
Node: ExRecovery318621 Node: ExRecovery318630
Node: Files319193 Node: Files319202
Node: Environ320527 Node: Environ320536
Node: Seealso321275 Node: Seealso321284
Node: Bugreport322075 Node: Bugreport322084
Node: Legal322666 Node: Legal322675
Node: CommandIdx323678 Node: CommandIdx323687
Node: ConceptIdx342984 Node: ConceptIdx342993
 
End Tag Table End Tag Table

8
xorriso/xorriso.texi
View File

@ -50,7 +50,7 @@
@c man .\" First parameter, NAME, should be all caps @c man .\" First parameter, NAME, should be all caps
@c man .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection @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 .\" other parameters are allowed: see man(7), man(1)
@c man .TH XORRISO 1 "Version 1.5.7, Dec 08, 2024" @c man .TH XORRISO 1 "Version 1.5.7, Dec 19, 2024"
@c man .\" Please adjust this date whenever revising the manpage. @c man .\" Please adjust this date whenever revising the manpage.
@c man .\" @c man .\"
@c man .\" Some roff macros, for reference: @c man .\" Some roff macros, for reference:
@ -4606,9 +4606,9 @@ The default "no_emulation" is suitable for ISOLINUX, GRUB, FreeBSD cdboot.
Default for legacy BIOS is 2048 which matches the expectations of most BIOS Default for legacy BIOS is 2048 which matches the expectations of most BIOS
boot images. The special value "full" means the full size of the boot image boot images. The special value "full" means the full size of the boot image
file rounded up to a multiple of 2048 bytes. Maximum is 33,552,384 bytes. file rounded up to a multiple of 2048 bytes. Maximum is 33,552,384 bytes.
With EFI boot images the default is the full image size. Images which exceed With EFI boot images the load size is always the full image size.
the maximum size get size 0 or 1, which means "up to the end of the device" Images which exceed the maximum size get size 0 or 1, which means
according to the UEFI specification. "up to the end of the device" according to the UEFI specification.
@* @*
@strong{boot_info_table=on} causes address patching to bytes 8 to 63 @strong{boot_info_table=on} causes address patching to bytes 8 to 63
of the boot image which is given by "any" "bin_path=". of the boot image which is given by "any" "bin_path=".

6
xorriso/xorrisofs.1
View File

@ -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 XORRISOFS 1 "Version 1.5.7, Nov 17, 2024" .TH XORRISOFS 1 "Version 1.5.7, Dec 20, 2024"
.\" 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:
@ -1112,10 +1112,12 @@ Nevertheless the default setting of mkisofs is to use the full size of the
boot image rounded up to a multiple of 4 512\-byte blocks. This default boot image rounded up to a multiple of 4 512\-byte blocks. This default
may be explicitly enforced by the word "full" instead of a number. may be explicitly enforced by the word "full" instead of a number.
.br .br
EFI boot images usually get set the number of blocks occupied EFI boot images always get set the number of blocks occupied
by the boot image file. by the boot image file.
.br .br
El Torito cannot represent load sizes higher than 65535. El Torito cannot represent load sizes higher than 65535.
EFI images which exceed the maximum size get size 0 or 1, which means
"up to the end of the device" according to the UEFI specification.
.TP .TP
\fB\-hard-disk-boot\fR \fB\-hard-disk-boot\fR
Mark the boot image in the current catalog entry as emulated hard disk. Mark the boot image in the current catalog entry as emulated hard disk.

80
xorriso/xorrisofs.info
View File

@ -982,9 +982,11 @@ the System Area.
of the boot image rounded up to a multiple of 4 512-byte blocks. of the boot image rounded up to a multiple of 4 512-byte blocks.
This default may be explicitly enforced by the word "full" instead This default may be explicitly enforced by the word "full" instead
of a number. of a number.
EFI boot images usually get set the number of blocks occupied by EFI boot images always get set the number of blocks occupied by the
the boot image file. boot image file.
El Torito cannot represent load sizes higher than 65535. El Torito cannot represent load sizes higher than 65535. EFI
images which exceed the maximum size get size 0 or 1, which means
"up to the end of the device" according to the UEFI specification.
-hard-disk-boot -hard-disk-boot
Mark the boot image in the current catalog entry as emulated hard Mark the boot image in the current catalog entry as emulated hard
disk. (Not suitable for any known boot loader.) disk. (Not suitable for any known boot loader.)
@ -2101,7 +2103,7 @@ File: xorrisofs.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: T
* --acl Recording of ACLs: SetExtras. (line 107) * --acl Recording of ACLs: SetExtras. (line 107)
* --application_use set Application Use field: ImageId. (line 79) * --application_use set Application Use field: ImageId. (line 79)
* --boot-catalog-hide Hide El Torito boot catalog: Bootable. (line 121) * --boot-catalog-hide Hide El Torito boot catalog: Bootable. (line 123)
* --efi-boot El Torito EFI boot image: Bootable. (line 59) * --efi-boot El Torito EFI boot image: Bootable. (line 59)
* --embedded-boot Fill System Area e.g. by MBR: SystemArea. (line 79) * --embedded-boot Fill System Area e.g. by MBR: SystemArea. (line 79)
* --emul-toc enable table-of-content emulation: SetProduct. (line 33) * --emul-toc enable table-of-content emulation: SetProduct. (line 33)
@ -2110,7 +2112,7 @@ File: xorrisofs.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: T
(line 159) (line 159)
* --gpt-iso-not-ro Do not set Read-only flag: SystemArea. (line 164) * --gpt-iso-not-ro Do not set Read-only flag: SystemArea. (line 164)
* --gpt_disk_guid GPT GUID: SystemArea. (line 297) * --gpt_disk_guid GPT GUID: SystemArea. (line 297)
* --grub2-boot-info Patch El Torito boot image: Bootable. (line 109) * --grub2-boot-info Patch El Torito boot image: Bootable. (line 111)
* --grub2-mbr Install modern GRUB2 MBR: SystemArea. (line 81) * --grub2-mbr Install modern GRUB2 MBR: SystemArea. (line 81)
* --grub2-sparc-core SUN SPARC core file: SystemArea. (line 352) * --grub2-sparc-core SUN SPARC core file: SystemArea. (line 352)
* --hardlinks Recording of hardlink relations: SetExtras. (line 146) * --hardlinks Recording of hardlink relations: SetExtras. (line 146)
@ -2165,9 +2167,9 @@ File: xorrisofs.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: T
* -b El Torito PC-BIOS boot image: Bootable. (line 38) * -b El Torito PC-BIOS boot image: Bootable. (line 38)
* -B SUN SPARC boot images: SystemArea. (line 337) * -B SUN SPARC boot images: SystemArea. (line 337)
* -biblio set Biblio File path: ImageId. (line 62) * -biblio set Biblio File path: ImageId. (line 62)
* -boot-info-table Patch El Torito boot image: Bootable. (line 104) * -boot-info-table Patch El Torito boot image: Bootable. (line 106)
* -boot-load-size El Torito boot image load size: Bootable. (line 72) * -boot-load-size El Torito boot image load size: Bootable. (line 72)
* -c El Torito boot catalog name: Bootable. (line 114) * -c El Torito boot catalog name: Bootable. (line 116)
* -C set load address and write address offset: Loading. (line 25) * -C set load address and write address offset: Loading. (line 25)
* -cdrecord-params set load address and write address offset: Loading. * -cdrecord-params set load address and write address offset: Loading.
(line 41) (line 41)
@ -2191,11 +2193,11 @@ File: xorrisofs.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: T
* -efi-boot-part EFI boot partition: SystemArea. (line 287) * -efi-boot-part EFI boot partition: SystemArea. (line 287)
* -eltorito-alt-boot begin next boot catalog entry: Bootable. (line 47) * -eltorito-alt-boot begin next boot catalog entry: Bootable. (line 47)
* -eltorito-boot El Torito PC-BIOS boot image: Bootable. (line 45) * -eltorito-boot El Torito PC-BIOS boot image: Bootable. (line 45)
* -eltorito-catalog El Torito boot catalog name: Bootable. (line 119) * -eltorito-catalog El Torito boot catalog name: Bootable. (line 121)
* -eltorito-id El Torito boot section id string: Bootable. (line 93) * -eltorito-id El Torito boot section id string: Bootable. (line 95)
* -eltorito-platform El Torito Platform Id: Bootable. (line 63) * -eltorito-platform El Torito Platform Id: Bootable. (line 63)
* -eltorito-selcrit El Torito boot selection criteria: Bootable. * -eltorito-selcrit El Torito boot selection criteria: Bootable.
(line 100) (line 102)
* -exclude exclude disk files from inserting: SetInsert. (line 47) * -exclude exclude disk files from inserting: SetInsert. (line 47)
* -exclude-list exclude disk files from inserting: SetInsert. (line 54) * -exclude-list exclude disk files from inserting: SetInsert. (line 54)
* -f follow symbolic links on disk: SetInsert. (line 32) * -f follow symbolic links on disk: SetInsert. (line 32)
@ -2212,7 +2214,7 @@ File: xorrisofs.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: T
* -graft-points enable target=source pathspecs: SetInsert. (line 38) * -graft-points enable target=source pathspecs: SetInsert. (line 38)
* -gui increase frequency of pacifier messages: Miscellaneous. * -gui increase frequency of pacifier messages: Miscellaneous.
(line 44) (line 44)
* -hard-disk-boot El Torito boot image emulation: Bootable. (line 83) * -hard-disk-boot El Torito boot image emulation: Bootable. (line 85)
* -help list supported options: Miscellaneous. (line 36) * -help list supported options: Miscellaneous. (line 36)
* -hfs-bless HFS+ blessing ppc_bootdir: SetExtras. (line 237) * -hfs-bless HFS+ blessing ppc_bootdir: SetExtras. (line 237)
* -hfs-bless-by HFS+ blessing: SetExtras. (line 227) * -hfs-bless-by HFS+ blessing: SetExtras. (line 227)
@ -2282,7 +2284,7 @@ File: xorrisofs.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: T
* -mips-boot MIPS Big Endian boot image: SystemArea. (line 326) * -mips-boot MIPS Big Endian boot image: SystemArea. (line 326)
* -mipsel-boot MIPS Little Endian boot image: SystemArea. (line 332) * -mipsel-boot MIPS Little Endian boot image: SystemArea. (line 332)
* -N omit version number in ISO file names: SetCompl. (line 65) * -N omit version number in ISO file names: SetCompl. (line 65)
* -no-emul-boot El Torito boot image emulation: Bootable. (line 86) * -no-emul-boot El Torito boot image emulation: Bootable. (line 88)
* -no-pad do not add zeros to ISO tree: SetProduct. (line 101) * -no-pad do not add zeros to ISO tree: SetProduct. (line 101)
* -o set output file address: SetProduct. (line 8) * -o set output file address: SetProduct. (line 8)
* -old-exclude exclude disk files from inserting: SetInsert. (line 52) * -old-exclude exclude disk files from inserting: SetInsert. (line 52)
@ -2367,17 +2369,17 @@ File: xorrisofs.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Block address, set sorting weight, --sort-weight-patterns: SetProduct. * Block address, set sorting weight, --sort-weight-patterns: SetProduct.
(line 76) (line 76)
* Bootability, boot catalog hidden, --boot-catalog-hide: Bootable. * Bootability, boot catalog hidden, --boot-catalog-hide: Bootable.
(line 121) (line 123)
* Bootability, boot catalog name, -c, -eltorito-catalog: Bootable. * Bootability, boot catalog name, -c, -eltorito-catalog: Bootable.
(line 114) (line 116)
* Bootability, boot image emulation, -hard-disk-boot: Bootable. * Bootability, boot image emulation, -hard-disk-boot: Bootable.
(line 83) (line 85)
* Bootability, boot image load size, -boot-load-size: Bootable. * Bootability, boot image load size, -boot-load-size: Bootable.
(line 72) (line 72)
* Bootability, boot image patching, --grub2-boot-info: Bootable. * Bootability, boot image patching, --grub2-boot-info: Bootable.
(line 109) (line 111)
* Bootability, boot image patching, -boot-info-table: Bootable. * Bootability, boot image patching, -boot-info-table: Bootable.
(line 104) (line 106)
* Bootability, bootable MBR partition, --mbr-force-bootable: SystemArea. * Bootability, bootable MBR partition, --mbr-force-bootable: SystemArea.
(line 148) (line 148)
* Bootability, control, --grub2-sparc-core: SystemArea. (line 352) * Bootability, control, --grub2-sparc-core: SystemArea. (line 352)
@ -2396,9 +2398,9 @@ File: xorrisofs.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Bootability, control, -mips-boot: SystemArea. (line 326) * Bootability, control, -mips-boot: SystemArea. (line 326)
* Bootability, control, -mipsel-boot: SystemArea. (line 332) * Bootability, control, -mipsel-boot: SystemArea. (line 332)
* Bootability, El Torito section id string, -eltorito-id: Bootable. * Bootability, El Torito section id string, -eltorito-id: Bootable.
(line 93) (line 95)
* Bootability, El Torito selection criteria, -eltorito-selcrit: Bootable. * Bootability, El Torito selection criteria, -eltorito-selcrit: Bootable.
(line 100) (line 102)
* Bootability, fill System Area e.g. by MBR, -G, --embedded-boot, -generic-boot: SystemArea. * Bootability, fill System Area e.g. by MBR, -G, --embedded-boot, -generic-boot: SystemArea.
(line 68) (line 68)
* Bootability, for CHRP, -chrp-boot-part: SystemArea. (line 310) * Bootability, for CHRP, -chrp-boot-part: SystemArea. (line 310)
@ -2420,7 +2422,7 @@ File: xorrisofs.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
(line 110) (line 110)
* Bootability, next entry, -eltorito-alt-boot: Bootable. (line 47) * Bootability, next entry, -eltorito-alt-boot: Bootable. (line 47)
* Bootability, no boot image emulation, -no-emul-boot: Bootable. * Bootability, no boot image emulation, -no-emul-boot: Bootable.
(line 86) (line 88)
* Bootability, partitions like with isohybrid, -part_like_isohybrid: SystemArea. * Bootability, partitions like with isohybrid, -part_like_isohybrid: SystemArea.
(line 122) (line 122)
* Bootability, patch System Area partition table, --protective-msdos-label: SystemArea. * Bootability, patch System Area partition table, --protective-msdos-label: SystemArea.
@ -2611,24 +2613,24 @@ Node: SetExtras23818
Node: SetHide36210 Node: SetHide36210
Node: ImageId38209 Node: ImageId38209
Node: Bootable42491 Node: Bootable42491
Node: SystemArea48777 Node: SystemArea48924
Node: Charset70088 Node: Charset70235
Node: Jigdo71113 Node: Jigdo71260
Node: Miscellaneous76083 Node: Miscellaneous76230
Node: Examples78679 Node: Examples78826
Node: ExSimple79173 Node: ExSimple79320
Node: ExGraft79656 Node: ExGraft79803
Node: ExMkisofs80956 Node: ExMkisofs81103
Node: ExGrowisofs82764 Node: ExGrowisofs82911
Node: ExIncBackup83954 Node: ExIncBackup84101
Node: ExIncBckAcc87130 Node: ExIncBckAcc87277
Node: ExBootable88835 Node: ExBootable88982
Node: Files93017 Node: Files93164
Node: Environ94112 Node: Environ94259
Node: Seealso94985 Node: Seealso95132
Node: Bugreport95686 Node: Bugreport95833
Node: Legal96279 Node: Legal96426
Node: CommandIdx97176 Node: CommandIdx97323
Node: ConceptIdx114682 Node: ConceptIdx114829
 
End Tag Table End Tag Table

6
xorriso/xorrisofs.texi
View File

@ -50,7 +50,7 @@
@c man .\" First parameter, NAME, should be all caps @c man .\" First parameter, NAME, should be all caps
@c man .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection @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 .\" other parameters are allowed: see man(7), man(1)
@c man .TH XORRISOFS 1 "Version 1.5.7, Nov 17, 2024" @c man .TH XORRISOFS 1 "Version 1.5.7, Dec 20, 2024"
@c man .\" Please adjust this date whenever revising the manpage. @c man .\" Please adjust this date whenever revising the manpage.
@c man .\" @c man .\"
@c man .\" Some roff macros, for reference: @c man .\" Some roff macros, for reference:
@ -1486,10 +1486,12 @@ Nevertheless the default setting of mkisofs is to use the full size of the
boot image rounded up to a multiple of 4 512-byte blocks. This default boot image rounded up to a multiple of 4 512-byte blocks. This default
may be explicitly enforced by the word "full" instead of a number. may be explicitly enforced by the word "full" instead of a number.
@* @*
EFI boot images usually get set the number of blocks occupied EFI boot images always get set the number of blocks occupied
by the boot image file. by the boot image file.
@* @*
El Torito cannot represent load sizes higher than 65535. El Torito cannot represent load sizes higher than 65535.
EFI images which exceed the maximum size get size 0 or 1, which means
"up to the end of the device" according to the UEFI specification.
@c man .TP @c man .TP
@item -hard-disk-boot @item -hard-disk-boot
@kindex -hard-disk-boot El Torito boot image emulation @kindex -hard-disk-boot El Torito boot image emulation