Some documentation updates
This commit is contained in:
@ -1949,8 +1949,8 @@ of the existing sessions, unless one can assume overwriteable media.
|
||||
Each -boot_image command has two arguments: type and setting. More
|
||||
than one -boot_image command may be used to define the handling of
|
||||
one or more boot images. Sequence matters.
|
||||
Types "isolinux" and "grub" care for known peculiarities. Type
|
||||
"any" makes no assumptions about the origin of the boot images.
|
||||
Types *isolinux* and *grub* care for known peculiarities. Type
|
||||
*any* makes no assumptions about the origin of the boot images.
|
||||
|
||||
El Torito boot images of any type can be newly inserted, or
|
||||
discarded, or patched, or kept unaltered. Whether to patch or to
|
||||
@ -1959,9 +1959,9 @@ of the existing sessions, unless one can assume overwriteable media.
|
||||
newly introduced into the ISO image or if an existing image gets
|
||||
relocated. This is automatically done if type "isolinux" or "grub"
|
||||
is given, but not with "any".
|
||||
"show_status" will print what is known about the loaded image and
|
||||
*show_status* will print what is known about the loaded image and
|
||||
its designated fate.
|
||||
"next" ends the definition of a boot image and starts a new one.
|
||||
*next* ends the definition of a boot image and starts a new one.
|
||||
Any following -bootimage bootspecs will affect the new image. The
|
||||
first "next" discards eventually loaded boot images and their
|
||||
catalog.
|
||||
@ -1970,7 +1970,7 @@ of the existing sessions, unless one can assume overwriteable media.
|
||||
boot images which are present on the input media.
|
||||
Most safe is the default: -boot_image "any" "discard".
|
||||
|
||||
A bootspec is a word of the form name=value and is used to
|
||||
A *bootspec* is a word of the form name=value and is used to
|
||||
describe the parameters of a boot image by an El Torito record and
|
||||
eventually a MBR. The names "dir", "bin_path", "efi_path" lead to
|
||||
El Torito bootable images. Name "system_area" activates a given
|
||||
@ -1991,47 +1991,47 @@ of the existing sessions, unless one can assume overwriteable media.
|
||||
-boot_image isolinux cat_path=/boot/isolinux/boot.cat
|
||||
-boot_image isolinux load_size=2048
|
||||
-boot_image any boot_info_table=on
|
||||
"bin_path=" depicts the boot image file, a binary program which is
|
||||
*bin_path=* depicts the boot image file, a binary program which is
|
||||
to be started by the hardware boot facility (e.g. the BIOS) at
|
||||
boot time.
|
||||
"efi_path=" depicts a boot image file that is ready for EFI
|
||||
*efi_path=* depicts a boot image file that is ready for EFI
|
||||
booting. Its load_size is determined automatically, no boot info
|
||||
table gets written, platform_id is 0xef.
|
||||
An El Torito boot catalog file gets inserted into the ISO image
|
||||
with address "cat_path=" at -commit time. It is subject to normal
|
||||
with address *cat_path=* at -commit time. It is subject to normal
|
||||
-overwrite and -reassure processing if there is already a file
|
||||
with the same name. The catalog lists the boot images and is read
|
||||
by the boot facility to choose one of the boot images.
|
||||
"load_size=" is a value which depends on the boot image. Default
|
||||
*load_size=* is a value which depends on the boot image. Default
|
||||
2048 should be overridden only if a better value is known.
|
||||
"boot_info_table=on" may be used to apply patching to a boot image
|
||||
*boot_info_table=on* may be used to apply patching to a boot image
|
||||
which is given by "any" "bin_path=". "boot_info_table=off"
|
||||
disables patching.
|
||||
"platform_id=" defines by two hex digits the Platform ID of the
|
||||
boot image. "00" is 80x86 PC-BIOS, "01" is PowerPC, "02" is Mac,
|
||||
*platform_id=* defines by two hex digits the Platform ID of the
|
||||
boot image. "00" is 80x86 PC-BIOS, "01" is PowerPC, "02" is Mac,
|
||||
"ef" is EFI.
|
||||
"id_string="text|56_hexdigits defines the ID string of the boot
|
||||
*id_string=*text|56_hexdigits defines the ID string of the boot
|
||||
catalog section where the boot image will be listed. If the value
|
||||
consists of 56 characters [0-9A-Fa-f] then it is converted into 28
|
||||
bytes, else the first 28 characters become the ID string. The ID
|
||||
string of the first boot image becomes the overall catalog ID. It
|
||||
is limited to 24 characters. Other id_strings become section IDs.
|
||||
"sel_crit="hexdigits defines the Selection Criteria of the boot
|
||||
*sel_crit=*hexdigits defines the Selection Criteria of the boot
|
||||
image. Up to 20 bytes get read from the given characters
|
||||
[0-9A-Fa-f]. They get attributed to the boot image entry in the
|
||||
catalog.
|
||||
"discard" gives up an existing boot catalog and its boot images.
|
||||
"keep" keeps or copies boot images unaltered and writes a new
|
||||
*discard* gives up an existing boot catalog and its boot images.
|
||||
*keep* keeps or copies boot images unaltered and writes a new
|
||||
catalog.
|
||||
"patch" applies boot info table patching of existing boot images.
|
||||
"system_area="disk_path copies at most 32768 bytes from the given
|
||||
*patch* applies boot info table patching to existing boot images.
|
||||
*system_area=*disk_path copies at most 32768 bytes from the given
|
||||
disk file to the very start of the ISO image. This System Area is
|
||||
reserved for system dependent boot software, e.g. an MBR which can
|
||||
be used to boot from USB stick or hard disk.
|
||||
Other than a El Torito boot image, the file disk_path needs not to
|
||||
be added to the ISO image.
|
||||
-boot_image isolinux system_area= implies "partition_table=on".
|
||||
"partition_table=on" causes a simple partition table to be written
|
||||
*partition_table=on* causes a simple partition table to be written
|
||||
into bytes 446 to 511 of the System Area.
|
||||
With type "isolinux" it shows a partition that begins at byte 0
|
||||
and it causes the LBA of the first boot image to be written into
|
||||
@ -4063,37 +4063,37 @@ Node: Filter73937
|
||||
Node: Writing78286
|
||||
Node: SetWrite84575
|
||||
Node: Bootable94707
|
||||
Node: Charset102163
|
||||
Node: Exception104917
|
||||
Node: DialogCtl109432
|
||||
Node: Inquiry111777
|
||||
Node: Navigate115917
|
||||
Node: Verify123271
|
||||
Node: Restore131691
|
||||
Node: Emulation138347
|
||||
Node: Scripting145034
|
||||
Node: Frontend150596
|
||||
Node: Examples151797
|
||||
Node: ExDevices152966
|
||||
Node: ExCreate153448
|
||||
Node: ExDialog154722
|
||||
Node: ExGrowing155984
|
||||
Node: ExModifying156786
|
||||
Node: ExBootable157287
|
||||
Node: ExCharset157834
|
||||
Node: ExPseudo158662
|
||||
Node: ExCdrecord159556
|
||||
Node: ExMkisofs159871
|
||||
Node: ExGrowisofs160874
|
||||
Node: ExException161998
|
||||
Node: ExTime162452
|
||||
Node: ExIncBackup162911
|
||||
Node: ExRestore166383
|
||||
Node: ExRecovery167352
|
||||
Node: Files167918
|
||||
Node: Seealso168956
|
||||
Node: Legal169480
|
||||
Node: CommandIdx170402
|
||||
Node: ConceptIdx183703
|
||||
Node: Charset102166
|
||||
Node: Exception104920
|
||||
Node: DialogCtl109435
|
||||
Node: Inquiry111780
|
||||
Node: Navigate115920
|
||||
Node: Verify123274
|
||||
Node: Restore131694
|
||||
Node: Emulation138350
|
||||
Node: Scripting145037
|
||||
Node: Frontend150599
|
||||
Node: Examples151800
|
||||
Node: ExDevices152969
|
||||
Node: ExCreate153451
|
||||
Node: ExDialog154725
|
||||
Node: ExGrowing155987
|
||||
Node: ExModifying156789
|
||||
Node: ExBootable157290
|
||||
Node: ExCharset157837
|
||||
Node: ExPseudo158665
|
||||
Node: ExCdrecord159559
|
||||
Node: ExMkisofs159874
|
||||
Node: ExGrowisofs160877
|
||||
Node: ExException162001
|
||||
Node: ExTime162455
|
||||
Node: ExIncBackup162914
|
||||
Node: ExRestore166386
|
||||
Node: ExRecovery167355
|
||||
Node: Files167921
|
||||
Node: Seealso168959
|
||||
Node: Legal169483
|
||||
Node: CommandIdx170405
|
||||
Node: ConceptIdx183706
|
||||
|
||||
End Tag Table
|
||||
|
||||
Reference in New Issue
Block a user