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

Bug fix: -boot_image system_area=/dev/zero preserved system area of loaded ISO

Browse Source
This commit is contained in:
Thomas Schmitt 2024-05-13 12:22:04 +02:00
parent c8fab513c6
commit 4dc5edc565
5 changed files with 121 additions and 104 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
xorriso/write_run.c
View File

@ -447,7 +447,8 @@ int Xorriso_set_system_area(struct XorrisO *xorriso,
Xorriso_alloc_meM(buf, char, 32768); Xorriso_alloc_meM(buf, char, 32768);
memset(buf, 0, 32768); memset(buf, 0, 32768);
system_area_options= xorriso->system_area_options; system_area_options= xorriso->system_area_options;
if(xorriso->system_area_clear_loaded) if(xorriso->system_area_clear_loaded ||
(in_drive != out_drive && in_drive != NULL))
sa_loaded= 0; sa_loaded= 0;
else else
sa_loaded= iso_image_get_system_area(img, buf, &options, 0); sa_loaded= iso_image_get_system_area(img, buf, &options, 0);
@ -457,8 +458,8 @@ int Xorriso_set_system_area(struct XorrisO *xorriso,
"Error when inquiring System Area data of ISO 9660 image", "Error when inquiring System Area data of ISO 9660 image",
0, "FAILURE", 1); 0, "FAILURE", 1);
{ret= 0; goto ex;} {ret= 0; goto ex;}
} if(sa_loaded > 0) }
bufpt= buf; bufpt= buf;
if(xorriso->system_area_disk_path[0] == 0) { if(xorriso->system_area_disk_path[0] == 0) {
if(xorriso->patch_system_area && xorriso->system_area_options == 0 && if(xorriso->patch_system_area && xorriso->system_area_options == 0 &&
sa_loaded > 0) { sa_loaded > 0) {

31
xorriso/xorriso.1
View File

@ -3767,13 +3767,27 @@ which can be used to boot from USB stick or hard disk.
Other than an El Torito boot image, the file disk_path needs not to be added Other than an El Torito boot image, the file disk_path needs not to be added
to the ISO image. to the ISO image.
.br .br
In multi\-session situations the existing System Area is preserved by default.
In in this case, the special disk_path "." prevents reading of
a disk file but nevertheless causes adjustments in the
loaded system area data. Such adjustments may get ordered by \-boot_image
commands.
.br
Special "system_area=/dev/zero" causes 32k of 0\-bytes.
Use this to e.g. discard partition tables which were loaded with the ISO image.
.br
This setting is the default with the write method of Modifying, when \-indev
and \-outdev are both used and not the same drive. If you indeed need to copy
the unchanged system area from \-indev to \-outdev, use
"system_area=\-\-interval:imported_iso:0s\-15s::" , which was the default in older
versions of xorriso.
.br
\fB\-boot_image isolinux system_area=\fR implies "partition_table=on". \fB\-boot_image isolinux system_area=\fR implies "partition_table=on".
In this case, the disk path should lead to one of the SYSLINUX files In this case, the disk path should lead to one of the SYSLINUX files
isohdp[fp]x*.bin or to a file which was derived from one of those files. isohdp[fp]x*.bin or to a file which was derived from one of those files.
E.g. to the first 512 bytes from an ISOLINUX isohybrid ISO image. E.g. to the first 512 bytes from an ISOLINUX isohybrid ISO image.
.br .br
In this case, El Torito boot images (dir=, bin_path=, efi_path=) El Torito boot images (dir=, bin_path=, efi_path=) may then be augmented by
may be augmented by
\fBisolinux partition_entry=gpt_basdat\fR \fBisolinux partition_entry=gpt_basdat\fR
or \fBisolinux partition_entry=gpt_hfsplus\fR, or \fBisolinux partition_entry=gpt_hfsplus\fR,
and by \fBisolinux partition_entry=apm_hfsplus\fR. and by \fBisolinux partition_entry=apm_hfsplus\fR.
@ -3783,12 +3797,6 @@ The first three GPT partitions will also be marked by MBR partitions. The
MBR partition of type 0xEF is what actually is used by EFI firmware for MBR partition of type 0xEF is what actually is used by EFI firmware for
booting from USB stick. booting from USB stick.
.br .br
In multi\-session situations the existing System Area is preserved by default.
In in this case, the special disk_path "." prevents reading of
a disk file but nevertheless causes adjustments in the
loaded system area data. Such adjustments may get ordered by \-boot_image
commands.
.br
\fB\-boot_image any gpt_disk_guid=\fRvalue controls whether an emerging GPT \fB\-boot_image any gpt_disk_guid=\fRvalue controls whether an emerging GPT
shall get a randomly generated disk GUID or whether the GUID is supplied by shall get a randomly generated disk GUID or whether the GUID is supplied by
the user. the user.
@ -3856,9 +3864,6 @@ In this case the existing System Area gets checked whether it bears addresses
and sizes as if it had been processed by "partition_table=on". If so, and sizes as if it had been processed by "partition_table=on". If so,
then those parameters get updated when the new System Area is written. then those parameters get updated when the new System Area is written.
.br .br
Special "system_area=/dev/zero" causes 32k of NUL\-bytes.
Use this to discard an MBR which was loaded with the ISO image.
.br
\fBappended_part_as=gpt\fR marks partitions from \-append_partition \fBappended_part_as=gpt\fR marks partitions from \-append_partition
in GPT rather than in MBR. In this case the MBR shows a single partition in GPT rather than in MBR. In this case the MBR shows a single partition
of type 0xee which covers the whole output data. of type 0xee which covers the whole output data.
@ -4014,8 +4019,8 @@ DEC Alpha SRM Secondary Bootstrap Loader and causes production of a boot sector
which points to it. which points to it.
This is mutually exclusive with production of other boot blocks like MBR. This is mutually exclusive with production of other boot blocks like MBR.
.br .br
\fBmips_discard\fR, \fBsparc_discard\fR, \fBhppa_discard\fR, \fBmips_discard\fR, \fBmipsel_discard\fR, \fBsparc_discard\fR,
\fBalpha_discard\fR \fBhppa_discard\fR, \fBalpha_discard\fR
revoke any boot file declarations made for mips/mipsel, sparc, hppa, revoke any boot file declarations made for mips/mipsel, sparc, hppa,
or alpha, respectively. or alpha, respectively.
This removes the ban on production of other boot blocks. This removes the ban on production of other boot blocks.

154
xorriso/xorriso.info
View File

@ -3175,25 +3175,33 @@ Examples:
be used to boot from USB stick or hard disk. be used to boot from USB stick or hard disk.
Other than an El Torito boot image, the file disk_path needs not to Other than an El Torito boot image, the file disk_path needs not to
be added to the ISO image. be added to the ISO image.
In multi-session situations the existing System Area is preserved
by default. In in this case, the special disk_path "." prevents
reading of a disk file but nevertheless causes adjustments in the
loaded system area data. Such adjustments may get ordered by
-boot_image commands.
Special "system_area=/dev/zero" causes 32k of 0-bytes. Use this to
e.g. discard partition tables which were loaded with the ISO
image.
This setting is the default with the write method of Modifying,
when -indev and -outdev are both used and not the same drive. If
you indeed need to copy the unchanged system area from -indev to
-outdev, use "system_area=-interval:imported_iso:0s-15s::" , which
was the default in older versions of xorriso.
*-boot_image isolinux system_area=* implies "partition_table=on". *-boot_image isolinux system_area=* implies "partition_table=on".
In this case, the disk path should lead to one of the SYSLINUX In this case, the disk path should lead to one of the SYSLINUX
files isohdp[fp]x*.bin or to a file which was derived from one of files isohdp[fp]x*.bin or to a file which was derived from one of
those files. E.g. to the first 512 bytes from an ISOLINUX those files. E.g. to the first 512 bytes from an ISOLINUX
isohybrid ISO image. isohybrid ISO image.
In this case, El Torito boot images (dir=, bin_path=, efi_path=) El Torito boot images (dir=, bin_path=, efi_path=) may then be
may be augmented by *isolinux partition_entry=gpt_basdat* or augmented by *isolinux partition_entry=gpt_basdat* or *isolinux
*isolinux partition_entry=gpt_hfsplus*, and by *isolinux partition_entry=gpt_hfsplus*, and by *isolinux
partition_entry=apm_hfsplus*. The boot image will then be partition_entry=apm_hfsplus*. The boot image will then be
mentioned in an invalid GPT as Basic Data or GPT HFS+ partition, mentioned in an invalid GPT as Basic Data or GPT HFS+ partition,
and in a valid APM as HFS+ partition. The first three GPT and in a valid APM as HFS+ partition. The first three GPT
partitions will also be marked by MBR partitions. The MBR partitions will also be marked by MBR partitions. The MBR
partition of type 0xEF is what actually is used by EFI firmware for partition of type 0xEF is what actually is used by EFI firmware for
booting from USB stick. booting from USB stick.
In multi-session situations the existing System Area is preserved
by default. In in this case, the special disk_path "." prevents
reading of a disk file but nevertheless causes adjustments in the
loaded system area data. Such adjustments may get ordered by
-boot_image commands.
*-boot_image any gpt_disk_guid=*value controls whether an emerging *-boot_image any gpt_disk_guid=*value controls whether an emerging
GPT shall get a randomly generated disk GUID or whether the GUID is GPT shall get a randomly generated disk GUID or whether the GUID is
supplied by the user. Value "random" is default. Value supplied by the user. Value "random" is default. Value
@ -3251,8 +3259,6 @@ Examples:
addresses and sizes as if it had been processed by addresses and sizes as if it had been processed by
"partition_table=on". If so, then those parameters get updated "partition_table=on". If so, then those parameters get updated
when the new System Area is written. when the new System Area is written.
Special "system_area=/dev/zero" causes 32k of NUL-bytes. Use this
to discard an MBR which was loaded with the ISO image.
*appended_part_as=gpt* marks partitions from -append_partition in *appended_part_as=gpt* marks partitions from -append_partition in
GPT rather than in MBR. In this case the MBR shows a single GPT rather than in MBR. In this case the MBR shows a single
partition of type 0xee which covers the whole output data. The partition of type 0xee which covers the whole output data. The
@ -3387,10 +3393,10 @@ Examples:
the DEC Alpha SRM Secondary Bootstrap Loader and causes production the DEC Alpha SRM Secondary Bootstrap Loader and causes production
of a boot sector which points to it. This is mutually exclusive of a boot sector which points to it. This is mutually exclusive
with production of other boot blocks like MBR. with production of other boot blocks like MBR.
*mips_discard*, *sparc_discard*, *hppa_discard*, *alpha_discard* *mips_discard*, *mipsel_discard*, *sparc_discard*, *hppa_discard*,
revoke any boot file declarations made for mips/mipsel, sparc, *alpha_discard* revoke any boot file declarations made for
hppa, or alpha, respectively. This removes the ban on production mips/mipsel, sparc, hppa, or alpha, respectively. This removes the
of other boot blocks. ban on production of other boot blocks.
*hfsplus_serial=*hexstring sets a string of 16 digits "0" to "9" *hfsplus_serial=*hexstring sets a string of 16 digits "0" to "9"
and letters "a" to "f", which will be used as unique serial number and letters "a" to "f", which will be used as unique serial number
of an emerging HFS+ filesystem. of an emerging HFS+ filesystem.
@ -5754,7 +5760,7 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
* -alter_date sets timestamps in ISO image: Manip. (line 139) * -alter_date sets timestamps in ISO image: Manip. (line 139)
* -alter_date_r sets timestamps in ISO image: Manip. (line 174) * -alter_date_r sets timestamps in ISO image: Manip. (line 174)
* -append_partition adds arbitrary file after image end: Bootable. * -append_partition adds arbitrary file after image end: Bootable.
(line 464) (line 470)
* -application_id sets application id: SetWrite. (line 218) * -application_id sets application id: SetWrite. (line 218)
* -application_use sets application use field: SetWrite. (line 293) * -application_use sets application use field: SetWrite. (line 293)
* -as emulates mkisofs or cdrecord: Emulation. (line 13) * -as emulates mkisofs or cdrecord: Emulation. (line 13)
@ -6006,14 +6012,14 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* ACL, show in ISO image, -getfacl: Navigate. (line 60) * ACL, show in ISO image, -getfacl: Navigate. (line 60)
* ACL, show in ISO image, -getfacl_r: Navigate. (line 66) * ACL, show in ISO image, -getfacl_r: Navigate. (line 66)
* ACL, _definition: Extras. (line 50) * ACL, _definition: Extras. (line 50)
* APM block size: Bootable. (line 455) * APM block size: Bootable. (line 461)
* APM, _definition: Extras. (line 42) * APM, _definition: Extras. (line 42)
* Appendable media, _definition: Media. (line 43) * Appendable media, _definition: Media. (line 43)
* Appended Filesystem Image, -append_partition: Bootable. (line 464) * Appended Filesystem Image, -append_partition: Bootable. (line 470)
* Appended partition, in APM: Bootable. (line 320) * Appended partition, in APM: Bootable. (line 326)
* Appended partition, in MBR or GPT: Bootable. (line 311) * Appended partition, in MBR or GPT: Bootable. (line 317)
* Appended partitions, GPT: Bootable. (line 493) * Appended partitions, GPT: Bootable. (line 499)
* Appended partitions, MBR: Bootable. (line 474) * Appended partitions, MBR: Bootable. (line 480)
* Automatic execution order, of arguments, -x: ArgSort. (line 16) * Automatic execution order, of arguments, -x: ArgSort. (line 16)
* Backslash Interpretation, _definition: Processing. (line 57) * Backslash Interpretation, _definition: Processing. (line 57)
* Backup, enable fast incremental, -disk_dev_ino: Loading. (line 255) * Backup, enable fast incremental, -disk_dev_ino: Loading. (line 255)
@ -6031,15 +6037,15 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Character set, learn from image, -auto_charset: Loading. (line 117) * Character set, learn from image, -auto_charset: Loading. (line 117)
* Character Set, of terminal, -local_charset: Charset. (line 57) * Character Set, of terminal, -local_charset: Charset. (line 57)
* Character Set, _definition: Charset. (line 6) * Character Set, _definition: Charset. (line 6)
* CHRP partition, _definition: Bootable. (line 327) * CHRP partition, _definition: Bootable. (line 333)
* Closed media, _definition: Media. (line 49) * Closed media, _definition: Media. (line 49)
* Comment, #: Scripting. (line 156) * Comment, #: Scripting. (line 156)
* Control, signal handling, -signal_handling: Exception. (line 66) * Control, signal handling, -signal_handling: Exception. (line 66)
* Create, new ISO image, _definition: Methods. (line 7) * Create, new ISO image, _definition: Methods. (line 7)
* Cylinder alignment, _definition: Bootable. (line 371) * Cylinder alignment, _definition: Bootable. (line 377)
* Cylinder size, _definition: Bootable. (line 356) * Cylinder size, _definition: Bootable. (line 362)
* Damaged track and session, close, -close_damaged: Writing. (line 209) * Damaged track and session, close, -close_damaged: Writing. (line 209)
* DEC Alpha SRM boot sector, production: Bootable. (line 441) * DEC Alpha SRM boot sector, production: Bootable. (line 447)
* Delete, from ISO image, -rm: Manip. (line 20) * Delete, from ISO image, -rm: Manip. (line 20)
* Delete, from ISO image, -rm_r: Manip. (line 26) * Delete, from ISO image, -rm_r: Manip. (line 26)
* Delete, ISO directory, -rmdir: Manip. (line 29) * Delete, ISO directory, -rmdir: Manip. (line 29)
@ -6071,7 +6077,7 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Drive, _definition: Drives. (line 6) * Drive, _definition: Drives. (line 6)
* EA, _definition: Extras. (line 66) * EA, _definition: Extras. (line 66)
* ECMA-119, _definition: Model. (line 6) * ECMA-119, _definition: Model. (line 6)
* EFI system partition, _definition: Bootable. (line 336) * EFI system partition, _definition: Bootable. (line 342)
* El Torito, _definition: Extras. (line 19) * El Torito, _definition: Extras. (line 19)
* Emulation, -as: Emulation. (line 13) * Emulation, -as: Emulation. (line 13)
* Emulation, .mkisofsrc, -read_mkisofsrc: Emulation. (line 155) * Emulation, .mkisofsrc, -read_mkisofsrc: Emulation. (line 155)
@ -6096,19 +6102,19 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Filter, _definition: Filter. (line 6) * Filter, _definition: Filter. (line 6)
* Frontend program, start at pipes, -launch_frontend: Frontend. * Frontend program, start at pipes, -launch_frontend: Frontend.
(line 141) (line 141)
* GPT Legacy BIOS bootable flag, set for ISO: Bootable. (line 393) * GPT Legacy BIOS bootable flag, set for ISO: Bootable. (line 399)
* GPT read-only flag, do not set for ISO: Bootable. (line 398) * GPT read-only flag, do not set for ISO: Bootable. (line 404)
* GPT, control GUID, -boot_image gpt_disk_guid=: Bootable. (line 252) * GPT, control GUID, -boot_image gpt_disk_guid=: Bootable. (line 260)
* GPT, _definition: Extras. (line 39) * GPT, _definition: Extras. (line 39)
* Group, global in ISO image, -gid: SetWrite. (line 314) * Group, global in ISO image, -gid: SetWrite. (line 314)
* Group, in ISO image, -chgrp: Manip. (line 49) * Group, in ISO image, -chgrp: Manip. (line 49)
* Group, in ISO image, -chgrp_r: Manip. (line 53) * Group, in ISO image, -chgrp_r: Manip. (line 53)
* Growing, _definition: Methods. (line 20) * Growing, _definition: Methods. (line 20)
* Hard links, control handling, -hardlinks: Loading. (line 128) * Hard links, control handling, -hardlinks: Loading. (line 128)
* HFS+ allocation block size: Bootable. (line 452) * HFS+ allocation block size: Bootable. (line 458)
* HFS+ serial number: Bootable. (line 449) * HFS+ serial number: Bootable. (line 455)
* hidden, set in ISO image, -hide: Manip. (line 177) * hidden, set in ISO image, -hide: Manip. (line 177)
* HP-PA boot sector, production: Bootable. (line 424) * HP-PA boot sector, production: Bootable. (line 430)
* Image reading, cache size, -data_cache_size: Loading. (line 361) * Image reading, cache size, -data_cache_size: Loading. (line 361)
* Image, demand volume ID, -assert_volid: Loading. (line 105) * Image, demand volume ID, -assert_volid: Loading. (line 105)
* Image, discard pending changes, -rollback: Writing. (line 9) * Image, discard pending changes, -rollback: Writing. (line 9)
@ -6165,7 +6171,7 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Linux device type, -scsi_dev_family: AqDrive. (line 95) * Linux device type, -scsi_dev_family: AqDrive. (line 95)
* List delimiter, _definition: Processing. (line 13) * List delimiter, _definition: Processing. (line 13)
* Local Character Set, _definition: Charset. (line 11) * Local Character Set, _definition: Charset. (line 11)
* MBR bootable/active flag, enforce: Bootable. (line 382) * MBR bootable/active flag, enforce: Bootable. (line 388)
* MBR, set, -boot_image system_area=: Bootable. (line 227) * MBR, set, -boot_image system_area=: Bootable. (line 227)
* MBR, _definition: Extras. (line 27) * MBR, _definition: Extras. (line 27)
* MD5, control handling, -md5: Loading. (line 183) * MD5, control handling, -md5: Loading. (line 183)
@ -6173,7 +6179,7 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Media, format, -format: Writing. (line 87) * Media, format, -format: Writing. (line 87)
* Media, list formats, -list_formats: Writing. (line 128) * Media, list formats, -list_formats: Writing. (line 128)
* Media, list write speeds, -list_speeds: Writing. (line 139) * Media, list write speeds, -list_speeds: Writing. (line 139)
* MIPS boot file, activation: Bootable. (line 403) * MIPS boot file, activation: Bootable. (line 409)
* mkisofs, Emulation: Emulation. (line 17) * mkisofs, Emulation: Emulation. (line 17)
* Modifying, _definition: Methods. (line 28) * Modifying, _definition: Methods. (line 28)
* Multi-session media, _definition: Media. (line 7) * Multi-session media, _definition: Media. (line 7)
@ -6201,15 +6207,15 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Ownership, global in ISO image, -uid: SetWrite. (line 311) * Ownership, global in ISO image, -uid: SetWrite. (line 311)
* Ownership, in ISO image, -chown: Manip. (line 43) * Ownership, in ISO image, -chown: Manip. (line 43)
* Ownership, in ISO image, -chown_r: Manip. (line 47) * Ownership, in ISO image, -chown_r: Manip. (line 47)
* Partition offset, _definition: Bootable. (line 346) * Partition offset, _definition: Bootable. (line 352)
* Partition table, _definition: Bootable. (line 292) * Partition table, _definition: Bootable. (line 300)
* Pathspec, _definition: SetInsert. (line 126) * Pathspec, _definition: SetInsert. (line 126)
* Pattern expansion, for disk paths, -disk_pattern: Insert. (line 34) * Pattern expansion, for disk paths, -disk_pattern: Insert. (line 34)
* Pattern expansion, for ISO paths, -iso_rr_pattern: Manip. (line 10) * Pattern expansion, for ISO paths, -iso_rr_pattern: Manip. (line 10)
* Pattern expansion, _definition: Processing. (line 29) * Pattern expansion, _definition: Processing. (line 29)
* Permissions, in ISO image, -chmod: Manip. (line 55) * Permissions, in ISO image, -chmod: Manip. (line 55)
* Permissions, in ISO image, -chmod_r: Manip. (line 66) * Permissions, in ISO image, -chmod_r: Manip. (line 66)
* PReP partition, _definition: Bootable. (line 331) * PReP partition, _definition: Bootable. (line 337)
* Problems, reporting: Bugreport. (line 6) * Problems, reporting: Bugreport. (line 6)
* Process, consolidate text output, -pkt_output: Frontend. (line 7) * Process, consolidate text output, -pkt_output: Frontend. (line 7)
* Process, control abort on error, -abort_on: Exception. (line 27) * Process, control abort on error, -abort_on: Exception. (line 27)
@ -6271,8 +6277,8 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Session, select as input, -load: Loading. (line 54) * Session, select as input, -load: Loading. (line 54)
* Session, _definition: Model. (line 6) * Session, _definition: Model. (line 6)
* Sorting order, for -x, -list_arg_sorting: ArgSort. (line 26) * Sorting order, for -x, -list_arg_sorting: ArgSort. (line 26)
* SUN Disk Label, production: Bootable. (line 414) * SUN Disk Label, production: Bootable. (line 420)
* SUN SPARC boot images, activation: Bootable. (line 511) * SUN SPARC boot images, activation: Bootable. (line 517)
* Symbolic link, create, -lns: Insert. (line 192) * Symbolic link, create, -lns: Insert. (line 192)
* System area, _definition: Bootable. (line 227) * System area, _definition: Bootable. (line 227)
* Table-of-content, search sessions, -rom_toc_scan: Loading. (line 307) * Table-of-content, search sessions, -rom_toc_scan: Loading. (line 307)
@ -6342,40 +6348,40 @@ Node: Filter110633
Node: Writing115255 Node: Writing115255
Node: SetWrite127749 Node: SetWrite127749
Node: Bootable159024 Node: Bootable159024
Node: Jigdo189944 Node: Jigdo190306
Node: Charset194947 Node: Charset195309
Node: Exception198276 Node: Exception198638
Node: DialogCtl204405 Node: DialogCtl204767
Node: Inquiry207007 Node: Inquiry207369
Node: Navigate218879 Node: Navigate219241
Node: Verify227586 Node: Verify227948
Node: Restore238735 Node: Restore239097
Node: Emulation250942 Node: Emulation251304
Node: Scripting261398 Node: Scripting261760
Node: Frontend269181 Node: Frontend269543
Node: Examples278807 Node: Examples279169
Node: ExDevices279985 Node: ExDevices280347
Node: ExCreate280646 Node: ExCreate281008
Node: ExDialog281946 Node: ExDialog282308
Node: ExGrowing283217 Node: ExGrowing283579
Node: ExModifying284026 Node: ExModifying284388
Node: ExBootable284536 Node: ExBootable284898
Node: ExCharset285091 Node: ExCharset285453
Node: ExPseudo285987 Node: ExPseudo286349
Node: ExCdrecord286914 Node: ExCdrecord287276
Node: ExMkisofs287234 Node: ExMkisofs287596
Node: ExGrowisofs289131 Node: ExGrowisofs289493
Node: ExException290284 Node: ExException290646
Node: ExTime290742 Node: ExTime291104
Node: ExIncBackup291200 Node: ExIncBackup291562
Node: ExRestore295226 Node: ExRestore295588
Node: ExRecovery296172 Node: ExRecovery296534
Node: Files296744 Node: Files297106
Node: Environ298078 Node: Environ298440
Node: Seealso298826 Node: Seealso299188
Node: Bugreport299543 Node: Bugreport299905
Node: Legal300134 Node: Legal300496
Node: CommandIdx301146 Node: CommandIdx301508
Node: ConceptIdx319044 Node: ConceptIdx319406
 
End Tag Table End Tag Table

31
xorriso/xorriso.texi
View File

@ -4324,13 +4324,27 @@ which can be used to boot from USB stick or hard disk.
Other than an El Torito boot image, the file disk_path needs not to be added Other than an El Torito boot image, the file disk_path needs not to be added
to the ISO image. to the ISO image.
@* @*
In multi-session situations the existing System Area is preserved by default.
In in this case, the special disk_path "." prevents reading of
a disk file but nevertheless causes adjustments in the
loaded system area data. Such adjustments may get ordered by -boot_image
commands.
@*
Special "system_area=/dev/zero" causes 32k of 0-bytes.
Use this to e.g. discard partition tables which were loaded with the ISO image.
@*
This setting is the default with the write method of Modifying, when -indev
and -outdev are both used and not the same drive. If you indeed need to copy
the unchanged system area from -indev to -outdev, use
"system_area=--interval:imported_iso:0s-15s::" , which was the default in older
versions of xorriso.
@*
@strong{-boot_image isolinux system_area=} implies "partition_table=on". @strong{-boot_image isolinux system_area=} implies "partition_table=on".
In this case, the disk path should lead to one of the SYSLINUX files In this case, the disk path should lead to one of the SYSLINUX files
isohdp[fp]x*.bin or to a file which was derived from one of those files. isohdp[fp]x*.bin or to a file which was derived from one of those files.
E.g. to the first 512 bytes from an ISOLINUX isohybrid ISO image. E.g. to the first 512 bytes from an ISOLINUX isohybrid ISO image.
@* @*
In this case, El Torito boot images (dir=, bin_path=, efi_path=) El Torito boot images (dir=, bin_path=, efi_path=) may then be augmented by
may be augmented by
@strong{isolinux partition_entry=gpt_basdat} @strong{isolinux partition_entry=gpt_basdat}
or @strong{isolinux partition_entry=gpt_hfsplus}, or @strong{isolinux partition_entry=gpt_hfsplus},
and by @strong{isolinux partition_entry=apm_hfsplus}. and by @strong{isolinux partition_entry=apm_hfsplus}.
@ -4340,12 +4354,6 @@ The first three GPT partitions will also be marked by MBR partitions. The
MBR partition of type 0xEF is what actually is used by EFI firmware for MBR partition of type 0xEF is what actually is used by EFI firmware for
booting from USB stick. booting from USB stick.
@* @*
In multi-session situations the existing System Area is preserved by default.
In in this case, the special disk_path "." prevents reading of
a disk file but nevertheless causes adjustments in the
loaded system area data. Such adjustments may get ordered by -boot_image
commands.
@*
@cindex GPT, control GUID, -boot_image gpt_disk_guid= @cindex GPT, control GUID, -boot_image gpt_disk_guid=
@strong{-boot_image any gpt_disk_guid=}value controls whether an emerging GPT @strong{-boot_image any gpt_disk_guid=}value controls whether an emerging GPT
shall get a randomly generated disk GUID or whether the GUID is supplied by shall get a randomly generated disk GUID or whether the GUID is supplied by
@ -4415,9 +4423,6 @@ In this case the existing System Area gets checked whether it bears addresses
and sizes as if it had been processed by "partition_table=on". If so, and sizes as if it had been processed by "partition_table=on". If so,
then those parameters get updated when the new System Area is written. then those parameters get updated when the new System Area is written.
@* @*
Special "system_area=/dev/zero" causes 32k of NUL-bytes.
Use this to discard an MBR which was loaded with the ISO image.
@*
@cindex Appended partition, in MBR or GPT @cindex Appended partition, in MBR or GPT
@strong{appended_part_as=gpt} marks partitions from -append_partition @strong{appended_part_as=gpt} marks partitions from -append_partition
in GPT rather than in MBR. In this case the MBR shows a single partition in GPT rather than in MBR. In this case the MBR shows a single partition
@ -4588,8 +4593,8 @@ DEC Alpha SRM Secondary Bootstrap Loader and causes production of a boot sector
which points to it. which points to it.
This is mutually exclusive with production of other boot blocks like MBR. This is mutually exclusive with production of other boot blocks like MBR.
@* @*
@strong{mips_discard}, @strong{sparc_discard}, @strong{hppa_discard}, @strong{mips_discard}, @strong{mipsel_discard}, @strong{sparc_discard},
@strong{alpha_discard} @strong{hppa_discard}, @strong{alpha_discard}
revoke any boot file declarations made for mips/mipsel, sparc, hppa, revoke any boot file declarations made for mips/mipsel, sparc, hppa,
or alpha, respectively. or alpha, respectively.
This removes the ban on production of other boot blocks. This removes the ban on production of other boot blocks.

2
xorriso/xorriso_timestamp.h
View File

@ -1 +1 @@
#define Xorriso_timestamP "2024.05.12.153800" #define Xorriso_timestamP "2024.05.13.101913"