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

Mentioned in the man page the increased number of appended GPT partitions in libisofs

Browse Source
This commit is contained in:
Thomas Schmitt 2024-05-11 13:06:20 +02:00
parent a26df9c49f
commit 4818eeaa5f
6 changed files with 300 additions and 191 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

54
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, Aug 07, 2023" .TH XORRISO 1 "Version 1.5.7, May 07, 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:
@ -1394,7 +1394,8 @@ pattern expansion happens. The current \-cdi directory has no influence.
\fB\-cut_out\fR disk_path byte_offset byte_count iso_rr_path \fB\-cut_out\fR disk_path byte_offset byte_count iso_rr_path
Map a byte interval of a regular disk file or of a device file into a regular Map a byte interval of a regular disk file or of a device file into a regular
file in the ISO image. The file depicted by disk_path has to support random file in the ISO image. The file depicted by disk_path has to support random
read access. read access. A symbolic link will only work if enabled by \-follow "link" or
"param".
.br .br
Cutting out a byte interval may be necessary if the disk file is larger than Cutting out a byte interval may be necessary if the disk file is larger than
a single medium, or if it exceeds the traditional limit of 2 GiB \- 1 for old a single medium, or if it exceeds the traditional limit of 2 GiB \- 1 for old
@ -1565,7 +1566,7 @@ Keep in mind that there may be alternative paths to the same disk file. The
exclusion tests are done literally, so that they do not keep files from getting exclusion tests are done literally, so that they do not keep files from getting
into the ISO filesystem by other paths. Accordingly an exclusion does not into the ISO filesystem by other paths. Accordingly an exclusion does not
prevent a disk file from being overwritten by file extraction via an prevent a disk file from being overwritten by file extraction via an
alternative not excluded path. So the exlusions need to be coordinated with alternative not excluded path. So the exclusions need to be coordinated with
the actual disk_path parameters given with commands. the actual disk_path parameters given with commands.
.br .br
(Do not forget to end the list of disk_paths by "\-\-") (Do not forget to end the list of disk_paths by "\-\-")
@ -1585,10 +1586,10 @@ handled as one parameter for \-not_paths or \-not_leaf.
.TP .TP
\fB\-follow\fR occasion[:occasion[...]] \fB\-follow\fR occasion[:occasion[...]]
Enable or disable resolution of symbolic links and mountpoints under Enable or disable resolution of symbolic links and mountpoints under
disk_paths. This applies to actions \-add, \-du*x, \-ls*x, \-findx, \-concat, disk_paths. This applies to actions \-add, \-cut_out, \-du*x, \-ls*x, \-findx,
and to \-disk_pattern expansion. \-concat, and to \-disk_pattern expansion.
.br .br
There are three kinds of follow decisison to be made: There are three main kinds of follow decisison to be made:
.br .br
\fBlink\fR is the hop from a symbolic link to its target file object for the \fBlink\fR is the hop from a symbolic link to its target file object for the
purpose of reading. I.e. not for command \-concat. purpose of reading. I.e. not for command \-concat.
@ -1613,7 +1614,7 @@ expansion).
If enabled then \-ls*x will show the link targets rather than the links If enabled then \-ls*x will show the link targets rather than the links
themselves. \-du*x, \-findx, and \-add will process the link targets but not themselves. \-du*x, \-findx, and \-add will process the link targets but not
follow links in an eventual directory tree below the targets (unless "link" follow links in an eventual directory tree below the targets (unless "link"
is enabled). is enabled). \-cut_out will process link targets.
.br .br
Occasions can be combined in a colon separated list. All occasions Occasions can be combined in a colon separated list. All occasions
mentioned in the list will then lead to a positive follow decision. mentioned in the list will then lead to a positive follow decision.
@ -3633,7 +3634,7 @@ and their designated fate.
.br .br
Examples: Examples:
.br .br
Drop unknown El Torito: Drop El Torito:
.br .br
\-boot_image any discard \-boot_image any discard
.br .br
@ -3851,6 +3852,7 @@ Use this to discard an MBR which was loaded with the ISO image.
\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.
The number of appendable partitions with GPT is 8 rather than 4 with MBR.
.br .br
\fBappended_part_as=mbr\fR is the default. Appended partitions get \fBappended_part_as=mbr\fR is the default. Appended partitions get
marked in GPT only if GPT is produced because of other settings. marked in GPT only if GPT is produced because of other settings.
@ -3858,7 +3860,8 @@ If given explicitly, this clears setting "gpt" and "apm". Nevertheless "apm"
may be added to "mbr". may be added to "mbr".
.br .br
\fBappended_part_as=apm\fR marks partitions from \-append_partition in APM \fBappended_part_as=apm\fR marks partitions from \-append_partition in APM
additionally to "mbr" or "gpt". additionally to "mbr" or "gpt". The partition number in APM will not be
influenced by \-append_partition parameter partition_number.
.br .br
By default, appended partitions get marked in APM only if APM is By default, appended partitions get marked in APM only if APM is
produced because of other options together with part_like_isohybrid="on". produced because of other options together with part_like_isohybrid="on".
@ -4033,9 +4036,11 @@ of the cylinder size.
Beware of subsequent multi\-session runs. The appended partition will get Beware of subsequent multi\-session runs. The appended partition will get
overwritten. overwritten.
.br .br
Partitions may be appended with boot block type MBR and with SUN Disk Label. Partitions may be appended with partition table types MBR, GPT, and
SUN Disk Label. Additionally to MBR and GPT it is possible to have them
marked in APM.
.br .br
With MBR: With \fBMBR\fR:
.br .br
partition_number may be 1 to 4. Number 1 will put the whole ISO image into partition_number may be 1 to 4. Number 1 will put the whole ISO image into
the unclaimed space before partition 1. So together with most \fBxorriso\fR the unclaimed space before partition 1. So together with most \fBxorriso\fR
@ -4055,11 +4060,30 @@ In APM, 48465300\-0000\-11AA\-AA11\-00306543ECAC will be mapped to partition
type "Apple_HFS", any other to "Data". type "Apple_HFS", any other to "Data".
.br .br
If some other command causes the production of GPT, then the appended If some other command causes the production of GPT, then the appended
partitions will be mentioned there too. GPT can be forced by partitions will be mentioned there too.
.br
\fBGPT\fR can be forced by
.br .br
\-boot_image "any" "appended_part_as=gpt" \-boot_image "any" "appended_part_as=gpt"
.br .br
With SUN Disk Label (selected by \-boot_image any sparc_label=): partition_number may be 1 to 8. But other than with MBR partitions it is not
guaranteed that the resulting GPT partition will have this number.
.br
More important than the desired partition number will be that the resulting
ISO filesystem is covered gaplessly with GPT table and its partitions and that
the partitions in the table are sorted by block address. If partition_number is
higher than the number of preceding partitions, then the appropriate number of
empty partition entries is inserted to achieve the desired partition_number.
If the number of preceding partitions is too high, then a NOTE message informs
about the inability to achieve partition_number and about the actually assigned
number.
.br
The type_code may be the same as described with MBR. Given GUIDs are used
unchanged. Given MBR partition types get translated. 0xef becomes
C12A7328\-F81F\-11D2\-BA4B\-00A0C93EC93B, others become
EBD0A0A2\-B9E5\-4433\-87C0\-68B6B72699C7.
.br
\fBSUN Disk Label\fR is chosen by \-boot_image any sparc_label=.
.br .br
partition_number may be 2 to 8. Number 1 will always be the ISO image. partition_number may be 2 to 8. Number 1 will always be the ISO image.
Partition start addresses are aligned to 320 KiB. The type_code does not Partition start addresses are aligned to 320 KiB. The type_code does not
@ -5167,7 +5191,7 @@ manipulation commands like \-rm or \-find ... \-exec rm before extraction,
and end the program by \-rollback_end . and end the program by \-rollback_end .
.br .br
Excluded disk_path parameters of extraction commands cause SORRY events. Excluded disk_path parameters of extraction commands cause SORRY events.
Implicitely given paths in trees under disk_path parameters are excluded Implicitly given paths in trees under disk_path parameters are excluded
silently. silently.
.br .br
If disk file objects already exist then the settings of \-overwrite and If disk file objects already exist then the settings of \-overwrite and
@ -6713,7 +6737,7 @@ Thomas Schmitt <scdbackup@gmx.net>
.br .br
for libburnia\-project.org for libburnia\-project.org
.SH COPYRIGHT .SH COPYRIGHT
Copyright (c) 2007 \- 2023 Thomas Schmitt Copyright (c) 2007 \- 2024 Thomas Schmitt
.br .br
Permission is granted to distribute this text freely. It shall only be Permission is granted to distribute this text freely. It shall only be
modified in sync with the technical properties of \fBxorriso\fR. modified in sync with the technical properties of \fBxorriso\fR.

215
xorriso/xorriso.info
View File

@ -1247,7 +1247,8 @@ filesystem.
-cut_out disk_path byte_offset byte_count iso_rr_path -cut_out disk_path byte_offset byte_count iso_rr_path
Map a byte interval of a regular disk file or of a device file into Map a byte interval of a regular disk file or of a device file into
a regular file in the ISO image. The file depicted by disk_path a regular file in the ISO image. The file depicted by disk_path
has to support random read access. has to support random read access. A symbolic link will only work
if enabled by -follow "link" or "param".
Cutting out a byte interval may be necessary if the disk file is Cutting out a byte interval may be necessary if the disk file is
larger than a single medium, or if it exceeds the traditional limit larger than a single medium, or if it exceeds the traditional limit
of 2 GiB - 1 for old operating systems, or the limit of 4 GiB - 1 of 2 GiB - 1 for old operating systems, or the limit of 4 GiB - 1
@ -1385,7 +1386,7 @@ File: xorriso.info, Node: SetInsert, Next: Manip, Prev: Insert, Up: Commands
keep files from getting into the ISO filesystem by other paths. keep files from getting into the ISO filesystem by other paths.
Accordingly an exclusion does not prevent a disk file from being Accordingly an exclusion does not prevent a disk file from being
overwritten by file extraction via an alternative not excluded overwritten by file extraction via an alternative not excluded
path. So the exlusions need to be coordinated with the actual path. So the exclusions need to be coordinated with the actual
disk_path parameters given with commands. disk_path parameters given with commands.
(Do not forget to end the list of disk_paths by "--") (Do not forget to end the list of disk_paths by "--")
-not_leaf pattern -not_leaf pattern
@ -1400,9 +1401,9 @@ File: xorriso.info, Node: SetInsert, Next: Manip, Prev: Insert, Up: Commands
handled as one parameter for -not_paths or -not_leaf. handled as one parameter for -not_paths or -not_leaf.
-follow occasion[:occasion[...]] -follow occasion[:occasion[...]]
Enable or disable resolution of symbolic links and mountpoints Enable or disable resolution of symbolic links and mountpoints
under disk_paths. This applies to actions -add, -du*x, -ls*x, under disk_paths. This applies to actions -add, -cut_out, -du*x,
-findx, -concat, and to -disk_pattern expansion. -ls*x, -findx, -concat, and to -disk_pattern expansion.
There are three kinds of follow decisison to be made: There are three main kinds of follow decisison to be made:
*link* is the hop from a symbolic link to its target file object *link* is the hop from a symbolic link to its target file object
for the purpose of reading. I.e. not for command -concat. If for the purpose of reading. I.e. not for command -concat. If
enabled then symbolic links are handled as their target file enabled then symbolic links are handled as their target file
@ -1422,6 +1423,7 @@ File: xorriso.info, Node: SetInsert, Next: Manip, Prev: Insert, Up: Commands
rather than the links themselves. -du*x, -findx, and -add will rather than the links themselves. -du*x, -findx, and -add will
process the link targets but not follow links in an eventual process the link targets but not follow links in an eventual
directory tree below the targets (unless "link" is enabled). directory tree below the targets (unless "link" is enabled).
-cut_out will process link targets.
Occasions can be combined in a colon separated list. All occasions Occasions can be combined in a colon separated list. All occasions
mentioned in the list will then lead to a positive follow decision. mentioned in the list will then lead to a positive follow decision.
@ -3070,7 +3072,7 @@ Examples:
*show_status* will print what is known about the loaded boot images *show_status* will print what is known about the loaded boot images
and their designated fate. and their designated fate.
Examples: Examples:
Drop unknown El Torito: Drop El Torito:
-boot_image any discard -boot_image any discard
Drop El Torito, system area, appended partitions: Drop El Torito, system area, appended partitions:
-boot_image any discard -boot_image any discard
@ -3243,13 +3245,17 @@ Examples:
to discard an MBR which was loaded with the ISO image. 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. partition of type 0xee which covers the whole output data. The
number of appendable partitions with GPT is 8 rather than 4 with
MBR.
*appended_part_as=mbr* is the default. Appended partitions get *appended_part_as=mbr* is the default. Appended partitions get
marked in GPT only if GPT is produced because of other settings. marked in GPT only if GPT is produced because of other settings.
If given explicitly, this clears setting "gpt" and "apm". If given explicitly, this clears setting "gpt" and "apm".
Nevertheless "apm" may be added to "mbr". Nevertheless "apm" may be added to "mbr".
*appended_part_as=apm* marks partitions from -append_partition in *appended_part_as=apm* marks partitions from -append_partition in
APM additionally to "mbr" or "gpt". APM additionally to "mbr" or "gpt". The partition number in APM
will not be influenced by -append_partition parameter
partition_number.
By default, appended partitions get marked in APM only if APM is By default, appended partitions get marked in APM only if APM is
produced because of other options together with produced because of other options together with
part_like_isohybrid="on". part_like_isohybrid="on".
@ -3397,9 +3403,10 @@ Examples:
2048 bytes or to the next multiple of the cylinder size. 2048 bytes or to the next multiple of the cylinder size.
Beware of subsequent multi-session runs. The appended partition Beware of subsequent multi-session runs. The appended partition
will get overwritten. will get overwritten.
Partitions may be appended with boot block type MBR and with SUN Partitions may be appended with partition table types MBR, GPT, and
Disk Label. SUN Disk Label. Additionally to MBR and GPT it is possible to have
With MBR: them marked in APM.
With *MBR*:
partition_number may be 1 to 4. Number 1 will put the whole ISO partition_number may be 1 to 4. Number 1 will put the whole ISO
image into the unclaimed space before partition 1. So together image into the unclaimed space before partition 1. So together
with most 'xorriso' MBR features, number 2 would be the most with most 'xorriso' MBR features, number 2 would be the most
@ -3417,10 +3424,26 @@ Examples:
48465300-0000-11AA-AA11-00306543ECAC will be mapped to partition 48465300-0000-11AA-AA11-00306543ECAC will be mapped to partition
type "Apple_HFS", any other to "Data". type "Apple_HFS", any other to "Data".
If some other command causes the production of GPT, then the If some other command causes the production of GPT, then the
appended partitions will be mentioned there too. GPT can be forced appended partitions will be mentioned there too.
by *GPT* can be forced by
-boot_image "any" "appended_part_as=gpt" -boot_image "any" "appended_part_as=gpt"
With SUN Disk Label (selected by -boot_image any sparc_label=): partition_number may be 1 to 8. But other than with MBR partitions
it is not guaranteed that the resulting GPT partition will have
this number.
More important than the desired partition number will be that the
resulting ISO filesystem is covered gaplessly with GPT table and
its partitions and that the partitions in the table are sorted by
block address. If partition_number is higher than the number of
preceding partitions, then the appropriate number of empty
partition entries is inserted to achieve the desired
partition_number. If the number of preceding partitions is too
high, then a NOTE message informs about the inability to achieve
partition_number and about the actually assigned number.
The type_code may be the same as described with MBR. Given GUIDs
are used unchanged. Given MBR partition types get translated.
0xef becomes C12A7328-F81F-11D2-BA4B-00A0C93EC93B, others become
EBD0A0A2-B9E5-4433-87C0-68B6B72699C7.
*SUN Disk Label* is chosen by -boot_image any sparc_label=.
partition_number may be 2 to 8. Number 1 will always be the ISO partition_number may be 2 to 8. Number 1 will always be the ISO
image. Partition start addresses are aligned to 320 KiB. The image. Partition start addresses are aligned to 320 KiB. The
type_code does not matter. Submit 0x0. type_code does not matter. Submit 0x0.
@ -4346,7 +4369,7 @@ If exclusion of paths or names in the ISO image is desired, then use
image manipulation commands like -rm or -find ... -exec rm before image manipulation commands like -rm or -find ... -exec rm before
extraction, and end the program by -rollback_end . extraction, and end the program by -rollback_end .
Excluded disk_path parameters of extraction commands cause SORRY events. Excluded disk_path parameters of extraction commands cause SORRY events.
Implicitely given paths in trees under disk_path parameters are excluded Implicitly given paths in trees under disk_path parameters are excluded
silently. silently.
If disk file objects already exist then the settings of -overwrite and If disk file objects already exist then the settings of -overwrite and
-reassure apply. But -overwrite "on" only triggers the behavior of -reassure apply. But -overwrite "on" only triggers the behavior of
@ -5676,7 +5699,7 @@ for libburnia-project.org
15.2 Copyright 15.2 Copyright
============== ==============
Copyright (c) 2007 - 2023 Thomas Schmitt Copyright (c) 2007 - 2024 Thomas Schmitt
Permission is granted to distribute this text freely. It shall only be Permission is granted to distribute this text freely. It shall only be
modified in sync with the technical properties of 'xorriso'. If you modified in sync with the technical properties of 'xorriso'. If you
make use of the license to derive modified versions of 'xorriso' then make use of the license to derive modified versions of 'xorriso' then
@ -5711,7 +5734,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 450) (line 454)
* -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)
@ -5738,7 +5761,7 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
* -chmod_r sets permissions in ISO image: Manip. (line 66) * -chmod_r sets permissions in ISO image: Manip. (line 66)
* -chown sets ownership in ISO image: Manip. (line 43) * -chown sets ownership in ISO image: Manip. (line 43)
* -chown_r sets ownership in ISO image: Manip. (line 47) * -chown_r sets ownership in ISO image: Manip. (line 47)
* -clone copies ISO directory tree: Insert. (line 195) * -clone copies ISO directory tree: Insert. (line 196)
* -close controls media closing: SetWrite. (line 505) * -close controls media closing: SetWrite. (line 505)
* -close_damaged closes damaged track and session: Writing. (line 209) * -close_damaged closes damaged track and session: Writing. (line 209)
* -close_filter_list bans filter registration: Filter. (line 50) * -close_filter_list bans filter registration: Filter. (line 50)
@ -5751,9 +5774,9 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
* -concat copies ISO file content: Restore. (line 148) * -concat copies ISO file content: Restore. (line 148)
* -copyright_file sets copyright file name: SetWrite. (line 266) * -copyright_file sets copyright file name: SetWrite. (line 266)
* -cpax copies files to disk: Restore. (line 128) * -cpax copies files to disk: Restore. (line 128)
* -cpr inserts like with cp -r: Insert. (line 174) * -cpr inserts like with cp -r: Insert. (line 175)
* -cpx copies files to disk: Restore. (line 117) * -cpx copies files to disk: Restore. (line 117)
* -cp_clone copies ISO directory tree: Insert. (line 206) * -cp_clone copies ISO directory tree: Insert. (line 207)
* -cp_rx copies file trees to disk: Restore. (line 131) * -cp_rx copies file trees to disk: Restore. (line 131)
* -cp_rx copies file trees to disk <1>: Restore. (line 139) * -cp_rx copies file trees to disk <1>: Restore. (line 139)
* -cut_out inserts piece of data file or device: Insert. (line 139) * -cut_out inserts piece of data file or device: Insert. (line 139)
@ -5823,7 +5846,7 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
* -list_formats lists available formats: Writing. (line 128) * -list_formats lists available formats: Writing. (line 128)
* -list_profiles lists supported media: Writing. (line 163) * -list_profiles lists supported media: Writing. (line 163)
* -list_speeds lists available write speeds: Writing. (line 139) * -list_speeds lists available write speeds: Writing. (line 139)
* -lns creates ISO symbolic link: Insert. (line 191) * -lns creates ISO symbolic link: Insert. (line 192)
* -load addresses a particular session as input: Loading. (line 54) * -load addresses a particular session as input: Loading. (line 54)
* -local_charset sets terminal character set: Charset. (line 57) * -local_charset sets terminal character set: Charset. (line 57)
* -logfile logs output channels to file: Frontend. (line 19) * -logfile logs output channels to file: Frontend. (line 19)
@ -5840,7 +5863,7 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
* -map_single inserts path: Insert. (line 93) * -map_single inserts path: Insert. (line 93)
* -mark sets synchronizing message: Frontend. (line 23) * -mark sets synchronizing message: Frontend. (line 23)
* -md5 controls handling of MD5 sums: Loading. (line 183) * -md5 controls handling of MD5 sums: Loading. (line 183)
* -mkdir creates ISO directory: Insert. (line 187) * -mkdir creates ISO directory: Insert. (line 188)
* -modesty_on_drive keep drive buffer hungry: SetWrite. (line 440) * -modesty_on_drive keep drive buffer hungry: SetWrite. (line 440)
* -mount issues mount command for ISO session: Restore. (line 204) * -mount issues mount command for ISO session: Restore. (line 204)
* -mount_cmd composes mount command line: Inquiry. (line 83) * -mount_cmd composes mount command line: Inquiry. (line 83)
@ -5858,12 +5881,12 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
* -osirrox enables ISO-to-disk copying: Restore. (line 25) * -osirrox enables ISO-to-disk copying: Restore. (line 25)
* -outdev acquires a drive for output: AqDrive. (line 29) * -outdev acquires a drive for output: AqDrive. (line 29)
* -out_charset sets output character set: SetWrite. (line 306) * -out_charset sets output character set: SetWrite. (line 306)
* -overwrite enables overwriting in ISO: SetInsert. (line 139) * -overwrite enables overwriting in ISO: SetInsert. (line 140)
* -pacifier controls pacifier text form: Emulation. (line 166) * -pacifier controls pacifier text form: Emulation. (line 166)
* -padding sets amount or mode of image padding: SetWrite. (line 528) * -padding sets amount or mode of image padding: SetWrite. (line 528)
* -page set terminal geometry: DialogCtl. (line 18) * -page set terminal geometry: DialogCtl. (line 18)
* -paste_in copies file into disk file: Restore. (line 142) * -paste_in copies file into disk file: Restore. (line 142)
* -pathspecs sets meaning of = with -add: SetInsert. (line 123) * -pathspecs sets meaning of = with -add: SetInsert. (line 124)
* -path_list inserts paths from disk file: Insert. (line 81) * -path_list inserts paths from disk file: Insert. (line 81)
* -pkt_output consolidates text output: Frontend. (line 7) * -pkt_output consolidates text output: Frontend. (line 7)
* -preparer_id sets preparer id: SetWrite. (line 282) * -preparer_id sets preparer id: SetWrite. (line 282)
@ -5919,7 +5942,7 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
(line 66) (line 66)
* -sleep waits for a given time span: Scripting. (line 113) * -sleep waits for a given time span: Scripting. (line 113)
* -speed set write speed: SetWrite. (line 392) * -speed set write speed: SetWrite. (line 392)
* -split_size enables large file splitting: SetInsert. (line 153) * -split_size enables large file splitting: SetInsert. (line 154)
* -status shows current settings: Scripting. (line 44) * -status shows current settings: Scripting. (line 44)
* -status_history_max curbs -status history: Scripting. (line 52) * -status_history_max curbs -status history: Scripting. (line 52)
* -stdio_sync controls stdio buffer: SetWrite. (line 490) * -stdio_sync controls stdio buffer: SetWrite. (line 490)
@ -5963,12 +5986,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 441) * APM block size: Bootable. (line 445)
* 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 450) * Appended Filesystem Image, -append_partition: Bootable. (line 454)
* Appended partition, in APM: Bootable. (line 308) * Appended partition, in APM: Bootable. (line 310)
* Appended partition, in MBR or GPT: Bootable. (line 301) * Appended partition, in MBR or GPT: Bootable. (line 301)
* Appended partitions, GPT: Bootable. (line 483)
* Appended partitions, MBR: Bootable. (line 464)
* 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)
@ -5986,15 +6011,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 313) * CHRP partition, _definition: Bootable. (line 317)
* 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 357) * Cylinder alignment, _definition: Bootable. (line 361)
* Cylinder size, _definition: Bootable. (line 342) * Cylinder size, _definition: Bootable. (line 346)
* 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 427) * DEC Alpha SRM boot sector, production: Bootable. (line 431)
* 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)
@ -6005,9 +6030,9 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Dialog, EOF resistant, -named_pipe_loop: Frontend. (line 119) * Dialog, EOF resistant, -named_pipe_loop: Frontend. (line 119)
* Dialog, line editing, -use_readline: DialogCtl. (line 26) * Dialog, line editing, -use_readline: DialogCtl. (line 26)
* Dialog, terminal geometry, -page: DialogCtl. (line 18) * Dialog, terminal geometry, -page: DialogCtl. (line 18)
* Directories, copy, -cp_clone: Insert. (line 206) * Directories, copy, -cp_clone: Insert. (line 207)
* Directory, copy, -clone: Insert. (line 195) * Directory, copy, -clone: Insert. (line 196)
* Directory, create, -mkdir: Insert. (line 187) * Directory, create, -mkdir: Insert. (line 188)
* Directory, delete, -rmdir: Manip. (line 29) * Directory, delete, -rmdir: Manip. (line 29)
* disk_path, _definition: Insert. (line 6) * disk_path, _definition: Insert. (line 6)
* Drive, accessability, -drive_class: AqDrive. (line 43) * Drive, accessability, -drive_class: AqDrive. (line 43)
@ -6026,7 +6051,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 322) * EFI system partition, _definition: Bootable. (line 326)
* 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)
@ -6051,8 +6076,8 @@ 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 379) * GPT Legacy BIOS bootable flag, set for ISO: Bootable. (line 383)
* GPT read-only flag, do not set for ISO: Bootable. (line 384) * GPT read-only flag, do not set for ISO: Bootable. (line 388)
* GPT, control GUID, -boot_image gpt_disk_guid=: Bootable. (line 242) * GPT, control GUID, -boot_image gpt_disk_guid=: Bootable. (line 242)
* 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)
@ -6060,10 +6085,10 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* 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 438) * HFS+ allocation block size: Bootable. (line 442)
* HFS+ serial number: Bootable. (line 435) * HFS+ serial number: Bootable. (line 439)
* 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 410) * HP-PA boot sector, production: Bootable. (line 414)
* 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)
@ -6086,7 +6111,7 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Image, show MBR, GPT, and alike, -pvd_info: Inquiry. (line 180) * Image, show MBR, GPT, and alike, -pvd_info: Inquiry. (line 180)
* Image, _definition: Model. (line 9) * Image, _definition: Model. (line 9)
* Input Character Set, _definition: Charset. (line 25) * Input Character Set, _definition: Charset. (line 25)
* Insert, enable overwriting, -overwrite: SetInsert. (line 139) * Insert, enable overwriting, -overwrite: SetInsert. (line 140)
* Insert, file exclusion absolute, -not_paths: SetInsert. (line 54) * Insert, file exclusion absolute, -not_paths: SetInsert. (line 54)
* Insert, file exclusion from file, -not_list: SetInsert. (line 71) * Insert, file exclusion from file, -not_list: SetInsert. (line 71)
* Insert, file exclusion pattern, -not_leaf: SetInsert. (line 67) * Insert, file exclusion pattern, -not_leaf: SetInsert. (line 67)
@ -6097,17 +6122,17 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Insert, if different, -update_li: Insert. (line 124) * Insert, if different, -update_li: Insert. (line 124)
* Insert, if different, -update_lxi: Insert. (line 128) * Insert, if different, -update_lxi: Insert. (line 128)
* Insert, if different, -update_r: Insert. (line 110) * Insert, if different, -update_r: Insert. (line 110)
* Insert, large file splitting, -split_size: SetInsert. (line 153) * Insert, large file splitting, -split_size: SetInsert. (line 154)
* Insert, limit data file size, -file_size_limit: SetInsert. (line 7) * Insert, limit data file size, -file_size_limit: SetInsert. (line 7)
* Insert, links or mount points, -follow: SetInsert. (line 77) * Insert, links or mount points, -follow: SetInsert. (line 77)
* Insert, meaning of = with -add, -pathspecs: SetInsert. (line 123) * Insert, meaning of = with -add, -pathspecs: SetInsert. (line 124)
* Insert, non-dashed arguments, -add_plainly: Insert. (line 68) * Insert, non-dashed arguments, -add_plainly: Insert. (line 68)
* Insert, path, -map: Insert. (line 89) * Insert, path, -map: Insert. (line 89)
* Insert, path, -map_single: Insert. (line 93) * Insert, path, -map_single: Insert. (line 93)
* Insert, paths from disk file, -map_l: Insert. (line 96) * Insert, paths from disk file, -map_l: Insert. (line 96)
* Insert, paths from disk file, -path_list: Insert. (line 81) * Insert, paths from disk file, -path_list: Insert. (line 81)
* Insert, paths from disk file, -quoted_path_list: Insert. (line 85) * Insert, paths from disk file, -quoted_path_list: Insert. (line 85)
* Insert, paths, -cpr: Insert. (line 174) * Insert, paths, -cpr: Insert. (line 175)
* Insert, pathspecs, -add: Insert. (line 44) * Insert, pathspecs, -add: Insert. (line 44)
* Insert, piece of data file or device, -cut_out: Insert. (line 139) * Insert, piece of data file or device, -cut_out: Insert. (line 139)
* Interval reader for system area and partitions: Bootable. (line 32) * Interval reader for system area and partitions: Bootable. (line 32)
@ -6120,7 +6145,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 368) * MBR bootable/active flag, enforce: Bootable. (line 372)
* MBR, set, -boot_image system_area=: Bootable. (line 217) * MBR, set, -boot_image system_area=: Bootable. (line 217)
* MBR, _definition: Extras. (line 27) * MBR, _definition: Extras. (line 27)
* MD5, control handling, -md5: Loading. (line 183) * MD5, control handling, -md5: Loading. (line 183)
@ -6128,7 +6153,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 389) * MIPS boot file, activation: Bootable. (line 393)
* 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)
@ -6156,15 +6181,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 332) * Partition offset, _definition: Bootable. (line 336)
* Partition table, _definition: Bootable. (line 282) * Partition table, _definition: Bootable. (line 282)
* Pathspec, _definition: SetInsert. (line 125) * 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 317) * PReP partition, _definition: Bootable. (line 321)
* 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)
@ -6226,9 +6251,9 @@ 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 400) * SUN Disk Label, production: Bootable. (line 404)
* SUN SPARC boot images, activation: Bootable. (line 480) * SUN SPARC boot images, activation: Bootable. (line 501)
* Symbolic link, create, -lns: Insert. (line 191) * Symbolic link, create, -lns: Insert. (line 192)
* System area, _definition: Bootable. (line 217) * System area, _definition: Bootable. (line 217)
* Table-of-content, search sessions, -rom_toc_scan: Loading. (line 307) * Table-of-content, search sessions, -rom_toc_scan: Loading. (line 307)
* Table-of-content, show, -toc: Inquiry. (line 27) * Table-of-content, show, -toc: Inquiry. (line 27)
@ -6290,47 +6315,47 @@ Node: ArgSort27718
Node: AqDrive29212 Node: AqDrive29212
Node: Loading36369 Node: Loading36369
Node: Insert58140 Node: Insert58140
Node: SetInsert70257 Node: SetInsert70335
Node: Manip80374 Node: Manip80509
Node: CmdFind90474 Node: CmdFind90609
Node: Filter110498 Node: Filter110633
Node: Writing115120 Node: Writing115255
Node: SetWrite127614 Node: SetWrite127749
Node: Bootable158889 Node: Bootable159024
Node: Jigdo187867 Node: Jigdo189289
Node: Charset192870 Node: Charset194292
Node: Exception196199 Node: Exception197621
Node: DialogCtl202328 Node: DialogCtl203750
Node: Inquiry204930 Node: Inquiry206352
Node: Navigate216188 Node: Navigate217610
Node: Verify224895 Node: Verify226317
Node: Restore236044 Node: Restore237466
Node: Emulation248252 Node: Emulation249673
Node: Scripting258708 Node: Scripting260129
Node: Frontend266491 Node: Frontend267912
Node: Examples276117 Node: Examples277538
Node: ExDevices277295 Node: ExDevices278716
Node: ExCreate277956 Node: ExCreate279377
Node: ExDialog279256 Node: ExDialog280677
Node: ExGrowing280527 Node: ExGrowing281948
Node: ExModifying281336 Node: ExModifying282757
Node: ExBootable281846 Node: ExBootable283267
Node: ExCharset282401 Node: ExCharset283822
Node: ExPseudo283297 Node: ExPseudo284718
Node: ExCdrecord284224 Node: ExCdrecord285645
Node: ExMkisofs284544 Node: ExMkisofs285965
Node: ExGrowisofs286441 Node: ExGrowisofs287862
Node: ExException287594 Node: ExException289015
Node: ExTime288052 Node: ExTime289473
Node: ExIncBackup288510 Node: ExIncBackup289931
Node: ExRestore292536 Node: ExRestore293957
Node: ExRecovery293482 Node: ExRecovery294903
Node: Files294054 Node: Files295475
Node: Environ295388 Node: Environ296809
Node: Seealso296136 Node: Seealso297557
Node: Bugreport296853 Node: Bugreport298274
Node: Legal297444 Node: Legal298865
Node: CommandIdx298456 Node: CommandIdx299877
Node: ConceptIdx316354 Node: ConceptIdx317775
 
End Tag Table End Tag Table

56
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, Aug 07, 2023" @c man .TH XORRISO 1 "Version 1.5.7, May 07, 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:
@ -1704,7 +1704,8 @@ pattern expansion happens. The current -cdi directory has no influence.
@cindex Insert, piece of data file or device, -cut_out @cindex Insert, piece of data file or device, -cut_out
Map a byte interval of a regular disk file or of a device file into a regular Map a byte interval of a regular disk file or of a device file into a regular
file in the ISO image. The file depicted by disk_path has to support random file in the ISO image. The file depicted by disk_path has to support random
read access. read access. A symbolic link will only work if enabled by -follow "link" or
"param".
@* @*
Cutting out a byte interval may be necessary if the disk file is larger than Cutting out a byte interval may be necessary if the disk file is larger than
a single medium, or if it exceeds the traditional limit of 2 GiB - 1 for old a single medium, or if it exceeds the traditional limit of 2 GiB - 1 for old
@ -1895,7 +1896,7 @@ Keep in mind that there may be alternative paths to the same disk file. The
exclusion tests are done literally, so that they do not keep files from getting exclusion tests are done literally, so that they do not keep files from getting
into the ISO filesystem by other paths. Accordingly an exclusion does not into the ISO filesystem by other paths. Accordingly an exclusion does not
prevent a disk file from being overwritten by file extraction via an prevent a disk file from being overwritten by file extraction via an
alternative not excluded path. So the exlusions need to be coordinated with alternative not excluded path. So the exclusions need to be coordinated with
the actual disk_path parameters given with commands. the actual disk_path parameters given with commands.
@* @*
(Do not forget to end the list of disk_paths by "@minus{}@minus{}") (Do not forget to end the list of disk_paths by "@minus{}@minus{}")
@ -1923,10 +1924,10 @@ handled as one parameter for -not_paths or -not_leaf.
@kindex -follow softlinks and mount points @kindex -follow softlinks and mount points
@cindex Insert, links or mount points, -follow @cindex Insert, links or mount points, -follow
Enable or disable resolution of symbolic links and mountpoints under Enable or disable resolution of symbolic links and mountpoints under
disk_paths. This applies to actions -add, -du*x, -ls*x, -findx, -concat, disk_paths. This applies to actions -add, -cut_out, -du*x, -ls*x, -findx,
and to -disk_pattern expansion. -concat, and to -disk_pattern expansion.
@* @*
There are three kinds of follow decisison to be made: There are three main kinds of follow decisison to be made:
@* @*
@strong{link} is the hop from a symbolic link to its target file object for the @strong{link} is the hop from a symbolic link to its target file object for the
purpose of reading. I.e. not for command -concat. purpose of reading. I.e. not for command -concat.
@ -1951,7 +1952,7 @@ expansion).
If enabled then -ls*x will show the link targets rather than the links If enabled then -ls*x will show the link targets rather than the links
themselves. -du*x, -findx, and -add will process the link targets but not themselves. -du*x, -findx, and -add will process the link targets but not
follow links in an eventual directory tree below the targets (unless "link" follow links in an eventual directory tree below the targets (unless "link"
is enabled). is enabled). -cut_out will process link targets.
@* @*
Occasions can be combined in a colon separated list. All occasions Occasions can be combined in a colon separated list. All occasions
mentioned in the list will then lead to a positive follow decision. mentioned in the list will then lead to a positive follow decision.
@ -4187,7 +4188,7 @@ and their designated fate.
@* @*
Examples: Examples:
@* @*
Drop unknown El Torito: Drop El Torito:
@* @*
-boot_image any discard -boot_image any discard
@* @*
@ -4411,6 +4412,7 @@ Use this to discard an MBR which was loaded with the ISO image.
@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
of type 0xee which covers the whole output data. of type 0xee which covers the whole output data.
The number of appendable partitions with GPT is 8 rather than 4 with MBR.
@* @*
@strong{appended_part_as=mbr} is the default. Appended partitions get @strong{appended_part_as=mbr} is the default. Appended partitions get
marked in GPT only if GPT is produced because of other settings. marked in GPT only if GPT is produced because of other settings.
@ -4419,7 +4421,8 @@ may be added to "mbr".
@* @*
@cindex Appended partition, in APM @cindex Appended partition, in APM
@strong{appended_part_as=apm} marks partitions from -append_partition in APM @strong{appended_part_as=apm} marks partitions from -append_partition in APM
additionally to "mbr" or "gpt". additionally to "mbr" or "gpt". The partition number in APM will not be
influenced by -append_partition parameter partition_number.
@* @*
By default, appended partitions get marked in APM only if APM is By default, appended partitions get marked in APM only if APM is
produced because of other options together with part_like_isohybrid="on". produced because of other options together with part_like_isohybrid="on".
@ -4615,9 +4618,12 @@ of the cylinder size.
Beware of subsequent multi-session runs. The appended partition will get Beware of subsequent multi-session runs. The appended partition will get
overwritten. overwritten.
@* @*
Partitions may be appended with boot block type MBR and with SUN Disk Label. Partitions may be appended with partition table types MBR, GPT, and
SUN Disk Label. Additionally to MBR and GPT it is possible to have them
marked in APM.
@* @*
With MBR: @cindex Appended partitions, MBR
With @strong{MBR}:
@* @*
partition_number may be 1 to 4. Number 1 will put the whole ISO image into partition_number may be 1 to 4. Number 1 will put the whole ISO image into
the unclaimed space before partition 1. So together with most @command{xorriso} the unclaimed space before partition 1. So together with most @command{xorriso}
@ -4637,12 +4643,32 @@ In APM, 48465300-0000-11AA-AA11-00306543ECAC will be mapped to partition
type "Apple_HFS", any other to "Data". type "Apple_HFS", any other to "Data".
@* @*
If some other command causes the production of GPT, then the appended If some other command causes the production of GPT, then the appended
partitions will be mentioned there too. GPT can be forced by partitions will be mentioned there too.
@*
@cindex Appended partitions, GPT
@strong{GPT} can be forced by
@* @*
-boot_image "any" "appended_part_as=gpt" -boot_image "any" "appended_part_as=gpt"
@* @*
partition_number may be 1 to 8. But other than with MBR partitions it is not
guaranteed that the resulting GPT partition will have this number.
@*
More important than the desired partition number will be that the resulting
ISO filesystem is covered gaplessly with GPT table and its partitions and that
the partitions in the table are sorted by block address. If partition_number is
higher than the number of preceding partitions, then the appropriate number of
empty partition entries is inserted to achieve the desired partition_number.
If the number of preceding partitions is too high, then a NOTE message informs
about the inability to achieve partition_number and about the actually assigned
number.
@*
The type_code may be the same as described with MBR. Given GUIDs are used
unchanged. Given MBR partition types get translated. 0xef becomes
C12A7328-F81F-11D2-BA4B-00A0C93EC93B, others become
EBD0A0A2-B9E5-4433-87C0-68B6B72699C7.
@*
@cindex SUN SPARC boot images, activation @cindex SUN SPARC boot images, activation
With SUN Disk Label (selected by -boot_image any sparc_label=): @strong{SUN Disk Label} is chosen by -boot_image any sparc_label=.
@* @*
partition_number may be 2 to 8. Number 1 will always be the ISO image. partition_number may be 2 to 8. Number 1 will always be the ISO image.
Partition start addresses are aligned to 320 KiB. The type_code does not Partition start addresses are aligned to 320 KiB. The type_code does not
@ -5906,7 +5932,7 @@ manipulation commands like -rm or -find ... -exec rm before extraction,
and end the program by -rollback_end . and end the program by -rollback_end .
@* @*
Excluded disk_path parameters of extraction commands cause SORRY events. Excluded disk_path parameters of extraction commands cause SORRY events.
Implicitely given paths in trees under disk_path parameters are excluded Implicitly given paths in trees under disk_path parameters are excluded
silently. silently.
@* @*
If disk file objects already exist then the settings of -overwrite and If disk file objects already exist then the settings of -overwrite and
@ -7784,7 +7810,7 @@ Thomas Schmitt <scdbackup@@gmx.net>
for libburnia-project.org for libburnia-project.org
@c man .SH COPYRIGHT @c man .SH COPYRIGHT
@section Copyright @section Copyright
Copyright (c) 2007 - 2023 Thomas Schmitt Copyright (c) 2007 - 2024 Thomas Schmitt
@* @*
Permission is granted to distribute this text freely. It shall only be Permission is granted to distribute this text freely. It shall only be
modified in sync with the technical properties of @command{xorriso}. modified in sync with the technical properties of @command{xorriso}.

18
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 12, 2023" .TH XORRISOFS 1 "Version 1.5.7, May 07, 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:
@ -883,7 +883,7 @@ These values may be combined.
E.g.: joliet:hfsplus E.g.: joliet:hfsplus
.br .br
This command does not apply to the boot catalog. This command does not apply to the boot catalog.
Rather use: boot\-catalog\-hide Rather use: \-\-boot\-catalog\-hide
.TP .TP
.B ISO image ID strings: .B ISO image ID strings:
.PP .PP
@ -1438,9 +1438,21 @@ of type 0xee which covers the whole output data.
.br .br
By default, appended partitions get marked in GPT only if GPT is produced By default, appended partitions get marked in GPT only if GPT is produced
because of other options. because of other options.
.br
This option raises the maximum number of appended partitions from 4 to 8.
But it is not guaranteed that the resulting GPT partition will have the
given partition_number. Other GPT partitions may emerge. The final sorting by
start block address may put one of them in the partition entry with the desired
number, so that the appended partition will get a higher number.
.br
Given MBR partition types get translated.
0xef becomes C12A7328\-F81F\-11D2\-BA4B\-00A0C93EC93B, others become
EBD0A0A2\-B9E5\-4433\-87C0\-68B6B72699C7.
.TP .TP
\fB\-appended_part_as_apm\fR \fB\-appended_part_as_apm\fR
Marks partitions from \-append_partition in Apple Partition Map, too. Marks partitions from \-append_partition in Apple Partition Map, too.
The partition number in APM will not be influenced by \-append_partition
parameter partition_number.
.br .br
By default, appended partitions get marked in APM only if APM is produced By default, appended partitions get marked in APM only if APM is produced
because of other options and \-part_like_isohybrid is enabled. because of other options and \-part_like_isohybrid is enabled.
@ -2282,7 +2294,7 @@ Thomas Schmitt <scdbackup@gmx.net>
.br .br
for libburnia\-project.org for libburnia\-project.org
.SH COPYRIGHT .SH COPYRIGHT
Copyright (c) 2011 \- 2023 Thomas Schmitt Copyright (c) 2011 \- 2024 Thomas Schmitt
.br .br
Permission is granted to distribute this text freely. It shall only be Permission is granted to distribute this text freely. It shall only be
modified in sync with the technical properties of xorriso. If you make use modified in sync with the technical properties of xorriso. If you make use

130
xorriso/xorrisofs.info
View File

@ -791,7 +791,7 @@ File: xorrisofs.info, Node: SetHide, Next: ImageId, Prev: SetExtras, Up: Opt
them all. "off" means visibility in all directory trees. them all. "off" means visibility in all directory trees.
These values may be combined. E.g.: joliet:hfsplus These values may be combined. E.g.: joliet:hfsplus
This command does not apply to the boot catalog. Rather use: This command does not apply to the boot catalog. Rather use:
boot-catalog-hide --boot-catalog-hide
 
File: xorrisofs.info, Node: ImageId, Next: Bootable, Prev: SetHide, Up: Options File: xorrisofs.info, Node: ImageId, Next: Bootable, Prev: SetHide, Up: Options
@ -1251,9 +1251,19 @@ Examples:
covers the whole output data. covers the whole output data.
By default, appended partitions get marked in GPT only if GPT is By default, appended partitions get marked in GPT only if GPT is
produced because of other options. produced because of other options.
This option raises the maximum number of appended partitions from 4
to 8. But it is not guaranteed that the resulting GPT partition
will have the given partition_number. Other GPT partitions may
emerge. The final sorting by start block address may put one of
them in the partition entry with the desired number, so that the
appended partition will get a higher number.
Given MBR partition types get translated. 0xef becomes
C12A7328-F81F-11D2-BA4B-00A0C93EC93B, others become
EBD0A0A2-B9E5-4433-87C0-68B6B72699C7.
-appended_part_as_apm -appended_part_as_apm
Marks partitions from -append_partition in Apple Partition Map, Marks partitions from -append_partition in Apple Partition Map,
too. too. The partition number in APM will not be influenced by
-append_partition parameter partition_number.
By default, appended partitions get marked in APM only if APM is By default, appended partitions get marked in APM only if APM is
produced because of other options and -part_like_isohybrid is produced because of other options and -part_like_isohybrid is
enabled. enabled.
@ -2002,7 +2012,7 @@ for libburnia-project.org
11.2 Copyright 11.2 Copyright
============== ==============
Copyright (c) 2011 - 2023 Thomas Schmitt Copyright (c) 2011 - 2024 Thomas Schmitt
Permission is granted to distribute this text freely. It shall only be Permission is granted to distribute this text freely. It shall only be
modified in sync with the technical properties of xorriso. If you make modified in sync with the technical properties of xorriso. If you make
use of the license to derive modified versions of xorriso then you are use of the license to derive modified versions of xorriso then you are
@ -2037,10 +2047,10 @@ File: xorrisofs.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: T
* --gpt-iso-bootable Set Legacy BIOS bootable flag: SystemArea. * --gpt-iso-bootable Set Legacy BIOS bootable flag: SystemArea.
(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 260) * --gpt_disk_guid GPT GUID: SystemArea. (line 270)
* --grub2-boot-info Patch El Torito boot image: Bootable. (line 109) * --grub2-boot-info Patch El Torito boot image: Bootable. (line 109)
* --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 315) * --grub2-sparc-core SUN SPARC core file: SystemArea. (line 325)
* --hardlinks Recording of hardlink relations: SetExtras. (line 130) * --hardlinks Recording of hardlink relations: SetExtras. (line 130)
* --mbr-force-bootable Enforce MBR bootable/active flag: SystemArea. * --mbr-force-bootable Enforce MBR bootable/active flag: SystemArea.
(line 148) (line 148)
@ -2080,16 +2090,16 @@ File: xorrisofs.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: T
* -A set Application Id: ImageId. (line 34) * -A set Application Id: ImageId. (line 34)
* -abstract set Abstract File path: ImageId. (line 57) * -abstract set Abstract File path: ImageId. (line 57)
* -allow-lowercase lowercase in ISO file names: SetCompl. (line 42) * -allow-lowercase lowercase in ISO file names: SetCompl. (line 42)
* -alpha-boot DEC Alpha SRM bootloader: SystemArea. (line 338) * -alpha-boot DEC Alpha SRM bootloader: SystemArea. (line 348)
* -appended_part_as_apm Appended partitions in APM: SystemArea. * -appended_part_as_apm Appended partitions in APM: SystemArea.
(line 244) (line 253)
* -appended_part_as_gpt Appended partitions in GPT: SystemArea. * -appended_part_as_gpt Appended partitions in GPT: SystemArea.
(line 238) (line 238)
* -append_partition Append MBR or GPT partition after image: SystemArea. * -append_partition Append MBR or GPT partition after image: SystemArea.
(line 208) (line 208)
* -appid set Application Id: ImageId. (line 41) * -appid set Application Id: ImageId. (line 41)
* -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 300) * -B SUN SPARC boot images: SystemArea. (line 310)
* -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 104)
* -boot-load-size El Torito boot image load size: Bootable. (line 72) * -boot-load-size El Torito boot image load size: Bootable. (line 72)
@ -2101,8 +2111,8 @@ File: xorrisofs.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: T
* -checksum_algorithm_iso choose .jigdo checksums: Jigdo. (line 86) * -checksum_algorithm_iso choose .jigdo checksums: Jigdo. (line 86)
* -checksum_algorithm_template choose .template checksums: Jigdo. * -checksum_algorithm_template choose .template checksums: Jigdo.
(line 92) (line 92)
* -chrp-boot CHRP partition: SystemArea. (line 282) * -chrp-boot CHRP partition: SystemArea. (line 292)
* -chrp-boot-part CHRP partition: SystemArea. (line 273) * -chrp-boot-part CHRP partition: SystemArea. (line 283)
* -copyright set Copyright File path: ImageId. (line 66) * -copyright set Copyright File path: ImageId. (line 66)
* -cut_out insert piece of data file or device: SetInsert. (line 22) * -cut_out insert piece of data file or device: SetInsert. (line 22)
* -D allow deep directory hierarchies: SetExtras. (line 60) * -D allow deep directory hierarchies: SetExtras. (line 60)
@ -2114,7 +2124,7 @@ File: xorrisofs.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: T
* -disallow_dir_id_ext enforce ISO level 1 directory names: SetCompl. * -disallow_dir_id_ext enforce ISO level 1 directory names: SetCompl.
(line 23) (line 23)
* -e El Torito EFI boot image: Bootable. (line 53) * -e El Torito EFI boot image: Bootable. (line 53)
* -efi-boot-part EFI boot partition: SystemArea. (line 250) * -efi-boot-part EFI boot partition: SystemArea. (line 260)
* -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 119)
@ -2161,12 +2171,12 @@ File: xorrisofs.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: T
* -hide-rr-moved set deep directory relocation target: SetExtras. * -hide-rr-moved set deep directory relocation target: SetExtras.
(line 90) (line 90)
* -hide_iso_path keep a file invisible in ISO tree: SetHide. (line 31) * -hide_iso_path keep a file invisible in ISO tree: SetHide. (line 31)
* -hppa-bootloader HP-PA bootloader file: SystemArea. (line 327) * -hppa-bootloader HP-PA bootloader file: SystemArea. (line 337)
* -hppa-cmdline HP-PA PALO command line: SystemArea. (line 321) * -hppa-cmdline HP-PA PALO command line: SystemArea. (line 331)
* -hppa-hdrversion HP-PA PALO header version: SystemArea. (line 335) * -hppa-hdrversion HP-PA PALO header version: SystemArea. (line 345)
* -hppa-kernel_32 HP-PA kernel_32 file: SystemArea. (line 329) * -hppa-kernel_32 HP-PA kernel_32 file: SystemArea. (line 339)
* -hppa-kernel_64 HP-PA kernel_64 file: SystemArea. (line 331) * -hppa-kernel_64 HP-PA kernel_64 file: SystemArea. (line 341)
* -hppa-ramdisk HP-PA ramdisk file: SystemArea. (line 333) * -hppa-ramdisk HP-PA ramdisk file: SystemArea. (line 343)
* -input-charset set character set of disk file names: Charset. * -input-charset set character set of disk file names: Charset.
(line 17) (line 17)
* -iso-level define ISO 9660 limitations: SetCompl. (line 7) * -iso-level define ISO 9660 limitations: SetCompl. (line 7)
@ -2203,8 +2213,8 @@ File: xorrisofs.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: T
* -max-iso9660-filenames allow 37 characters in ISO file names: SetCompl. * -max-iso9660-filenames allow 37 characters in ISO file names: SetCompl.
(line 61) (line 61)
* -md5-list set path of input checksum file: Jigdo. (line 81) * -md5-list set path of input checksum file: Jigdo. (line 81)
* -mips-boot MIPS Big Endian boot image: SystemArea. (line 289) * -mips-boot MIPS Big Endian boot image: SystemArea. (line 299)
* -mipsel-boot MIPS Little Endian boot image: SystemArea. (line 295) * -mipsel-boot MIPS Little Endian boot image: SystemArea. (line 305)
* -N omit version number in ISO file names: SetCompl. (line 64) * -N omit version number in ISO file names: SetCompl. (line 64)
* -no-emul-boot El Torito boot image emulation: Bootable. (line 86) * -no-emul-boot El Torito boot image emulation: Bootable. (line 86)
* -no-pad do not add zeros to ISO tree: SetProduct. (line 101) * -no-pad do not add zeros to ISO tree: SetProduct. (line 101)
@ -2228,7 +2238,7 @@ File: xorrisofs.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: T
* -part_like_isohybrid Mark partitions like with isohybrid: SystemArea. * -part_like_isohybrid Mark partitions like with isohybrid: SystemArea.
(line 122) (line 122)
* -path-list read pathspecs from disk file: SetInsert. (line 8) * -path-list read pathspecs from disk file: SetInsert. (line 8)
* -prep-boot-part PReP partition: SystemArea. (line 284) * -prep-boot-part PReP partition: SystemArea. (line 294)
* -preparer set Preparer Id: ImageId. (line 55) * -preparer set Preparer Id: ImageId. (line 55)
* -prev-session set path for loading existing ISO image: Loading. * -prev-session set path for loading existing ISO image: Loading.
(line 21) (line 21)
@ -2245,8 +2255,8 @@ File: xorrisofs.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: T
* -root redirect ISO root directory: SetInsert. (line 85) * -root redirect ISO root directory: SetInsert. (line 85)
* -rr_reloc_dir set deep directory relocation target: SetExtras. * -rr_reloc_dir set deep directory relocation target: SetExtras.
(line 74) (line 74)
* -sparc-boot SUN SPARC boot images: SystemArea. (line 311) * -sparc-boot SUN SPARC boot images: SystemArea. (line 321)
* -sparc-label SUN Disk Label text: SystemArea. (line 313) * -sparc-label SUN Disk Label text: SystemArea. (line 323)
* -sysid set System Id: ImageId. (line 43) * -sysid set System Id: ImageId. (line 43)
* -transparent-compression enable recognition of zisofs files: SetInsert. * -transparent-compression enable recognition of zisofs files: SetInsert.
(line 63) (line 63)
@ -2276,7 +2286,7 @@ File: xorrisofs.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Abstract File, set path, -abstract: ImageId. (line 57) * Abstract File, set path, -abstract: ImageId. (line 57)
* ACL, record and load, --acl: SetExtras. (line 103) * ACL, record and load, --acl: SetExtras. (line 103)
* APM, mark appended partitions, -appended_part_as_apm: SystemArea. * APM, mark appended partitions, -appended_part_as_apm: SystemArea.
(line 244) (line 253)
* APM, _definition: SystemArea. (line 16) * APM, _definition: SystemArea. (line 16)
* Application Id, set, -A, -appid: ImageId. (line 34) * Application Id, set, -A, -appid: ImageId. (line 34)
* Backup, enable fidelity, --for_backup: SetExtras. (line 92) * Backup, enable fidelity, --for_backup: SetExtras. (line 92)
@ -2301,30 +2311,30 @@ File: xorrisofs.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
(line 104) (line 104)
* 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 315) * Bootability, control, --grub2-sparc-core: SystemArea. (line 325)
* Bootability, control, --efi-boot: Bootable. (line 59) * Bootability, control, --efi-boot: Bootable. (line 59)
* Bootability, control, -alpha-boot: SystemArea. (line 338) * Bootability, control, -alpha-boot: SystemArea. (line 348)
* Bootability, control, -b, -eltorito-boot: Bootable. (line 38) * Bootability, control, -b, -eltorito-boot: Bootable. (line 38)
* Bootability, control, -B, -sparc-boot: SystemArea. (line 300) * Bootability, control, -B, -sparc-boot: SystemArea. (line 310)
* Bootability, control, -e: Bootable. (line 53) * Bootability, control, -e: Bootable. (line 53)
* Bootability, control, -eltorito-platform: Bootable. (line 63) * Bootability, control, -eltorito-platform: Bootable. (line 63)
* Bootability, control, -hppa-bootloader: SystemArea. (line 327) * Bootability, control, -hppa-bootloader: SystemArea. (line 337)
* Bootability, control, -hppa-cmdline: SystemArea. (line 321) * Bootability, control, -hppa-cmdline: SystemArea. (line 331)
* Bootability, control, -hppa-hdrversion: SystemArea. (line 335) * Bootability, control, -hppa-hdrversion: SystemArea. (line 345)
* Bootability, control, -hppa-kernel_32: SystemArea. (line 329) * Bootability, control, -hppa-kernel_32: SystemArea. (line 339)
* Bootability, control, -hppa-kernel_64: SystemArea. (line 331) * Bootability, control, -hppa-kernel_64: SystemArea. (line 341)
* Bootability, control, -hppa-ramdisk: SystemArea. (line 333) * Bootability, control, -hppa-ramdisk: SystemArea. (line 343)
* Bootability, control, -mips-boot: SystemArea. (line 289) * Bootability, control, -mips-boot: SystemArea. (line 299)
* Bootability, control, -mipsel-boot: SystemArea. (line 295) * Bootability, control, -mipsel-boot: SystemArea. (line 305)
* Bootability, El Torito section id string, -eltorito-id: Bootable. * Bootability, El Torito section id string, -eltorito-id: Bootable.
(line 93) (line 93)
* Bootability, El Torito selection criteria, -eltorito-selcrit: Bootable. * Bootability, El Torito selection criteria, -eltorito-selcrit: Bootable.
(line 100) (line 100)
* 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 273) * Bootability, for CHRP, -chrp-boot-part: SystemArea. (line 283)
* Bootability, for EFI, -efi-boot-part: SystemArea. (line 250) * Bootability, for EFI, -efi-boot-part: SystemArea. (line 260)
* Bootability, for PReP, -prep-boot-part: SystemArea. (line 284) * Bootability, for PReP, -prep-boot-part: SystemArea. (line 294)
* Bootability, GPT Legacy BIOS bootable, --gpt-iso-bootable: SystemArea. * Bootability, GPT Legacy BIOS bootable, --gpt-iso-bootable: SystemArea.
(line 159) (line 159)
* Bootability, GPT Read-only flag, --gpt-iso-not-ro: SystemArea. * Bootability, GPT Read-only flag, --gpt-iso-not-ro: SystemArea.
@ -2346,7 +2356,7 @@ File: xorrisofs.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
(line 122) (line 122)
* Bootability, patch System Area partition table, --protective-msdos-label: SystemArea. * Bootability, patch System Area partition table, --protective-msdos-label: SystemArea.
(line 143) (line 143)
* Bootability, SUN Disk Label text, -sparc-label: SystemArea. (line 313) * Bootability, SUN Disk Label text, -sparc-label: SystemArea. (line 323)
* Bootability, type of ISO MBR partition, -iso_mbr_part_type: SystemArea. * Bootability, type of ISO MBR partition, -iso_mbr_part_type: SystemArea.
(line 129) (line 129)
* Bugs, reporting: Bugreport. (line 6) * Bugs, reporting: Bugreport. (line 6)
@ -2365,7 +2375,7 @@ File: xorrisofs.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Disk files, exclude, -exclude-list: SetInsert. (line 54) * Disk files, exclude, -exclude-list: SetInsert. (line 54)
* Disk files, exclude, -m, -exclude, -x, -old-exclude: SetInsert. * Disk files, exclude, -m, -exclude, -x, -old-exclude: SetInsert.
(line 41) (line 41)
* Disk GUID, for GPT, --gpt_disk_guid: SystemArea. (line 260) * Disk GUID, for GPT, --gpt_disk_guid: SystemArea. (line 270)
* disk_path, _definition: Insert. (line 7) * disk_path, _definition: Insert. (line 7)
* ECMA-119, _definition: Standards. (line 6) * ECMA-119, _definition: Standards. (line 6)
* El Torito, _definition: Bootable. (line 13) * El Torito, _definition: Bootable. (line 13)
@ -2524,26 +2534,26 @@ Node: SetProduct15465
Node: SetCompl21036 Node: SetCompl21036
Node: SetExtras23628 Node: SetExtras23628
Node: SetHide35237 Node: SetHide35237
Node: ImageId37234 Node: ImageId37236
Node: Bootable41516 Node: Bootable41518
Node: SystemArea47802 Node: SystemArea47804
Node: Charset66861 Node: Charset67532
Node: Jigdo67886 Node: Jigdo68557
Node: Miscellaneous72856 Node: Miscellaneous73527
Node: Examples74501 Node: Examples75172
Node: ExSimple74995 Node: ExSimple75666
Node: ExGraft75478 Node: ExGraft76149
Node: ExMkisofs76778 Node: ExMkisofs77449
Node: ExGrowisofs78586 Node: ExGrowisofs79257
Node: ExIncBackup79776 Node: ExIncBackup80447
Node: ExIncBckAcc82952 Node: ExIncBckAcc83623
Node: ExBootable84657 Node: ExBootable85328
Node: Files88839 Node: Files89510
Node: Environ89934 Node: Environ90605
Node: Seealso90807 Node: Seealso91478
Node: Bugreport91458 Node: Bugreport92129
Node: Legal92051 Node: Legal92722
Node: CommandIdx92948 Node: CommandIdx93619
Node: ConceptIdx110086 Node: ConceptIdx110757
 
End Tag Table End Tag Table

18
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 12, 2023" @c man .TH XORRISOFS 1 "Version 1.5.7, May 07, 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:
@ -1201,7 +1201,7 @@ These values may be combined.
E.g.: joliet:hfsplus E.g.: joliet:hfsplus
@* @*
This command does not apply to the boot catalog. This command does not apply to the boot catalog.
Rather use: boot-catalog-hide Rather use: @minus{}@minus{}boot-catalog-hide
@end table @end table
@c man .TP @c man .TP
@c man .B ISO image ID strings: @c man .B ISO image ID strings:
@ -1874,11 +1874,23 @@ of type 0xee which covers the whole output data.
@* @*
By default, appended partitions get marked in GPT only if GPT is produced By default, appended partitions get marked in GPT only if GPT is produced
because of other options. because of other options.
@*
This option raises the maximum number of appended partitions from 4 to 8.
But it is not guaranteed that the resulting GPT partition will have the
given partition_number. Other GPT partitions may emerge. The final sorting by
start block address may put one of them in the partition entry with the desired
number, so that the appended partition will get a higher number.
@*
Given MBR partition types get translated.
0xef becomes C12A7328-F81F-11D2-BA4B-00A0C93EC93B, others become
EBD0A0A2-B9E5-4433-87C0-68B6B72699C7.
@c man .TP @c man .TP
@item -appended_part_as_apm @item -appended_part_as_apm
@kindex -appended_part_as_apm Appended partitions in APM @kindex -appended_part_as_apm Appended partitions in APM
@cindex APM, mark appended partitions, -appended_part_as_apm @cindex APM, mark appended partitions, -appended_part_as_apm
Marks partitions from -append_partition in Apple Partition Map, too. Marks partitions from -append_partition in Apple Partition Map, too.
The partition number in APM will not be influenced by -append_partition
parameter partition_number.
@* @*
By default, appended partitions get marked in APM only if APM is produced By default, appended partitions get marked in APM only if APM is produced
because of other options and -part_like_isohybrid is enabled. because of other options and -part_like_isohybrid is enabled.
@ -2965,7 +2977,7 @@ Thomas Schmitt <scdbackup@@gmx.net>
for libburnia-project.org for libburnia-project.org
@c man .SH COPYRIGHT @c man .SH COPYRIGHT
@section Copyright @section Copyright
Copyright (c) 2011 - 2023 Thomas Schmitt Copyright (c) 2011 - 2024 Thomas Schmitt
@* @*
Permission is granted to distribute this text freely. It shall only be Permission is granted to distribute this text freely. It shall only be
modified in sync with the technical properties of xorriso. If you make use modified in sync with the technical properties of xorriso. If you make use