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

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

View File

@ -9,7 +9,7 @@
.\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1)
.TH XORRISO 1 "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.
.\"
.\" 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
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.
With EFI boot images the default is the full image size. 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.
With EFI boot images the load size is always the full image size.
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.
.br
\fBboot_info_table=on\fR causes address patching to bytes 8 to 63
of the boot image which is given by "any" "bin_path=".

View File

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

End Tag Table

View File

@ -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.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 .\"
@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
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.
With EFI boot images the default is the full image size. 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.
With EFI boot images the load size is always the full image size.
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.
@*
@strong{boot_info_table=on} causes address patching to bytes 8 to 63
of the boot image which is given by "any" "bin_path=".

View File

@ -9,7 +9,7 @@
.\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1)
.TH 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.
.\"
.\" 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
may be explicitly enforced by the word "full" instead of a number.
.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.
.br
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
\fB\-hard-disk-boot\fR
Mark the boot image in the current catalog entry as emulated hard disk.

View File

@ -982,9 +982,11 @@ the System Area.
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
of a number.
EFI boot images usually get set the number of blocks occupied by
the boot image file.
El Torito cannot represent load sizes higher than 65535.
EFI boot images always get set the number of blocks occupied by the
boot image file.
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
Mark the boot image in the current catalog entry as emulated hard
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)
* --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)
* --embedded-boot Fill System Area e.g. by MBR: SystemArea. (line 79)
* --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)
* --gpt-iso-not-ro Do not set Read-only flag: SystemArea. (line 164)
* --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-sparc-core SUN SPARC core file: SystemArea. (line 352)
* --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 SUN SPARC boot images: SystemArea. (line 337)
* -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)
* -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)
* -cdrecord-params set load address and write address offset: Loading.
(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)
* -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 119)
* -eltorito-id El Torito boot section id string: Bootable. (line 93)
* -eltorito-catalog El Torito boot catalog name: Bootable. (line 121)
* -eltorito-id El Torito boot section id string: Bootable. (line 95)
* -eltorito-platform El Torito Platform Id: Bootable. (line 63)
* -eltorito-selcrit El Torito boot selection criteria: Bootable.
(line 100)
(line 102)
* -exclude exclude disk files from inserting: SetInsert. (line 47)
* -exclude-list exclude disk files from inserting: SetInsert. (line 54)
* -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)
* -gui increase frequency of pacifier messages: Miscellaneous.
(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)
* -hfs-bless HFS+ blessing ppc_bootdir: SetExtras. (line 237)
* -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)
* -mipsel-boot MIPS Little Endian boot image: SystemArea. (line 332)
* -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)
* -o set output file address: SetProduct. (line 8)
* -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.
(line 76)
* Bootability, boot catalog hidden, --boot-catalog-hide: Bootable.
(line 121)
(line 123)
* Bootability, boot catalog name, -c, -eltorito-catalog: Bootable.
(line 114)
(line 116)
* Bootability, boot image emulation, -hard-disk-boot: Bootable.
(line 83)
(line 85)
* Bootability, boot image load size, -boot-load-size: Bootable.
(line 72)
* Bootability, boot image patching, --grub2-boot-info: Bootable.
(line 109)
(line 111)
* Bootability, boot image patching, -boot-info-table: Bootable.
(line 104)
(line 106)
* Bootability, bootable MBR partition, --mbr-force-bootable: SystemArea.
(line 148)
* 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, -mipsel-boot: SystemArea. (line 332)
* Bootability, El Torito section id string, -eltorito-id: Bootable.
(line 93)
(line 95)
* 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.
(line 68)
* Bootability, for CHRP, -chrp-boot-part: SystemArea. (line 310)
@ -2420,7 +2422,7 @@ File: xorrisofs.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
(line 110)
* Bootability, next entry, -eltorito-alt-boot: Bootable. (line 47)
* Bootability, no boot image emulation, -no-emul-boot: Bootable.
(line 86)
(line 88)
* Bootability, partitions like with isohybrid, -part_like_isohybrid: SystemArea.
(line 122)
* Bootability, patch System Area partition table, --protective-msdos-label: SystemArea.
@ -2611,24 +2613,24 @@ Node: SetExtras23818
Node: SetHide36210
Node: ImageId38209
Node: Bootable42491
Node: SystemArea48777
Node: Charset70088
Node: Jigdo71113
Node: Miscellaneous76083
Node: Examples78679
Node: ExSimple79173
Node: ExGraft79656
Node: ExMkisofs80956
Node: ExGrowisofs82764
Node: ExIncBackup83954
Node: ExIncBckAcc87130
Node: ExBootable88835
Node: Files93017
Node: Environ94112
Node: Seealso94985
Node: Bugreport95686
Node: Legal96279
Node: CommandIdx97176
Node: ConceptIdx114682
Node: SystemArea48924
Node: Charset70235
Node: Jigdo71260
Node: Miscellaneous76230
Node: Examples78826
Node: ExSimple79320
Node: ExGraft79803
Node: ExMkisofs81103
Node: ExGrowisofs82911
Node: ExIncBackup84101
Node: ExIncBckAcc87277
Node: ExBootable88982
Node: Files93164
Node: Environ94259
Node: Seealso95132
Node: Bugreport95833
Node: Legal96426
Node: CommandIdx97323
Node: ConceptIdx114829

End Tag Table

View File

@ -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.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 .\"
@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
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.
@*
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
@item -hard-disk-boot
@kindex -hard-disk-boot El Torito boot image emulation