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

This commit is contained in:
2024-05-11 13:06:20 +02:00
parent a26df9c49f
commit 4818eeaa5f
6 changed files with 300 additions and 191 deletions

View File

@ -1247,7 +1247,8 @@ filesystem.
-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
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
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
@ -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.
Accordingly an exclusion does not prevent a disk file from being
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.
(Do not forget to end the list of disk_paths by "--")
-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.
-follow occasion[:occasion[...]]
Enable or disable resolution of symbolic links and mountpoints
under disk_paths. This applies to actions -add, -du*x, -ls*x,
-findx, -concat, and to -disk_pattern expansion.
There are three kinds of follow decisison to be made:
under disk_paths. This applies to actions -add, -cut_out, -du*x,
-ls*x, -findx, -concat, and to -disk_pattern expansion.
There are three main kinds of follow decisison to be made:
*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
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
process the link targets but not follow links in an eventual
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
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
and their designated fate.
Examples:
Drop unknown El Torito:
Drop El Torito:
-boot_image any discard
Drop El Torito, system area, appended partitions:
-boot_image any discard
@ -3243,13 +3245,17 @@ Examples:
to discard an MBR which was loaded with the ISO image.
*appended_part_as=gpt* marks partitions from -append_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.
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
marked in GPT only if GPT is produced because of other settings.
If given explicitly, this clears setting "gpt" and "apm".
Nevertheless "apm" may be added to "mbr".
*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
produced because of other options together with
part_like_isohybrid="on".
@ -3397,9 +3403,10 @@ Examples:
2048 bytes or to the next multiple of the cylinder size.
Beware of subsequent multi-session runs. The appended partition
will get overwritten.
Partitions may be appended with boot block type MBR and with SUN
Disk Label.
With MBR:
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*:
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 'xorriso' MBR features, number 2 would be the most
@ -3417,10 +3424,26 @@ Examples:
48465300-0000-11AA-AA11-00306543ECAC will be mapped to partition
type "Apple_HFS", any other to "Data".
If some other command causes the production of GPT, then the
appended partitions will be mentioned there too. GPT can be forced
by
appended partitions will be mentioned there too.
*GPT* can be forced by
-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
image. Partition start addresses are aligned to 320 KiB. The
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
extraction, and end the program by -rollback_end .
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.
If disk file objects already exist then the settings of -overwrite and
-reassure apply. But -overwrite "on" only triggers the behavior of
@ -5676,7 +5699,7 @@ for libburnia-project.org
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
modified in sync with the technical properties of 'xorriso'. If you
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_r sets timestamps in ISO image: Manip. (line 174)
* -append_partition adds arbitrary file after image end: Bootable.
(line 450)
(line 454)
* -application_id sets application id: SetWrite. (line 218)
* -application_use sets application use field: SetWrite. (line 293)
* -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)
* -chown sets ownership in ISO image: Manip. (line 43)
* -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_damaged closes damaged track and session: Writing. (line 209)
* -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)
* -copyright_file sets copyright file name: SetWrite. (line 266)
* -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)
* -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 <1>: Restore. (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_profiles lists supported media: Writing. (line 163)
* -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)
* -local_charset sets terminal character set: Charset. (line 57)
* -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)
* -mark sets synchronizing message: Frontend. (line 23)
* -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)
* -mount issues mount command for ISO session: Restore. (line 204)
* -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)
* -outdev acquires a drive for output: AqDrive. (line 29)
* -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)
* -padding sets amount or mode of image padding: SetWrite. (line 528)
* -page set terminal geometry: DialogCtl. (line 18)
* -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)
* -pkt_output consolidates text output: Frontend. (line 7)
* -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)
* -sleep waits for a given time span: Scripting. (line 113)
* -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_history_max curbs -status history: Scripting. (line 52)
* -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_r: Navigate. (line 66)
* ACL, _definition: Extras. (line 50)
* APM block size: Bootable. (line 441)
* APM block size: Bootable. (line 445)
* APM, _definition: Extras. (line 42)
* Appendable media, _definition: Media. (line 43)
* Appended Filesystem Image, -append_partition: Bootable. (line 450)
* Appended partition, in APM: Bootable. (line 308)
* Appended Filesystem Image, -append_partition: Bootable. (line 454)
* Appended partition, in APM: Bootable. (line 310)
* 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)
* Backslash Interpretation, _definition: Processing. (line 57)
* 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, of terminal, -local_charset: Charset. (line 57)
* Character Set, _definition: Charset. (line 6)
* CHRP partition, _definition: Bootable. (line 313)
* CHRP partition, _definition: Bootable. (line 317)
* Closed media, _definition: Media. (line 49)
* Comment, #: Scripting. (line 156)
* Control, signal handling, -signal_handling: Exception. (line 66)
* Create, new ISO image, _definition: Methods. (line 7)
* Cylinder alignment, _definition: Bootable. (line 357)
* Cylinder size, _definition: Bootable. (line 342)
* Cylinder alignment, _definition: Bootable. (line 361)
* Cylinder size, _definition: Bootable. (line 346)
* 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_r: Manip. (line 26)
* 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, line editing, -use_readline: DialogCtl. (line 26)
* Dialog, terminal geometry, -page: DialogCtl. (line 18)
* Directories, copy, -cp_clone: Insert. (line 206)
* Directory, copy, -clone: Insert. (line 195)
* Directory, create, -mkdir: Insert. (line 187)
* Directories, copy, -cp_clone: Insert. (line 207)
* Directory, copy, -clone: Insert. (line 196)
* Directory, create, -mkdir: Insert. (line 188)
* Directory, delete, -rmdir: Manip. (line 29)
* disk_path, _definition: Insert. (line 6)
* 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)
* EA, _definition: Extras. (line 66)
* 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)
* Emulation, -as: Emulation. (line 13)
* 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)
* Frontend program, start at pipes, -launch_frontend: Frontend.
(line 141)
* GPT Legacy BIOS bootable flag, set for ISO: Bootable. (line 379)
* GPT read-only flag, do not set for ISO: Bootable. (line 384)
* GPT Legacy BIOS bootable flag, set for ISO: Bootable. (line 383)
* GPT read-only flag, do not set for ISO: Bootable. (line 388)
* GPT, control GUID, -boot_image gpt_disk_guid=: Bootable. (line 242)
* GPT, _definition: Extras. (line 39)
* 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)
* Growing, _definition: Methods. (line 20)
* Hard links, control handling, -hardlinks: Loading. (line 128)
* HFS+ allocation block size: Bootable. (line 438)
* HFS+ serial number: Bootable. (line 435)
* HFS+ allocation block size: Bootable. (line 442)
* HFS+ serial number: Bootable. (line 439)
* 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, demand volume ID, -assert_volid: Loading. (line 105)
* 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, _definition: Model. (line 9)
* 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 from file, -not_list: SetInsert. (line 71)
* 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_lxi: Insert. (line 128)
* 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, 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, path, -map: Insert. (line 89)
* Insert, path, -map_single: Insert. (line 93)
* 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, -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, piece of data file or device, -cut_out: Insert. (line 139)
* 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)
* List delimiter, _definition: Processing. (line 13)
* 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, _definition: Extras. (line 27)
* 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, list formats, -list_formats: Writing. (line 128)
* 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)
* Modifying, _definition: Methods. (line 28)
* 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, in ISO image, -chown: Manip. (line 43)
* 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)
* Pathspec, _definition: SetInsert. (line 125)
* Pathspec, _definition: SetInsert. (line 126)
* Pattern expansion, for disk paths, -disk_pattern: Insert. (line 34)
* Pattern expansion, for ISO paths, -iso_rr_pattern: Manip. (line 10)
* Pattern expansion, _definition: Processing. (line 29)
* Permissions, in ISO image, -chmod: Manip. (line 55)
* 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)
* Process, consolidate text output, -pkt_output: Frontend. (line 7)
* 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, _definition: Model. (line 6)
* Sorting order, for -x, -list_arg_sorting: ArgSort. (line 26)
* SUN Disk Label, production: Bootable. (line 400)
* SUN SPARC boot images, activation: Bootable. (line 480)
* Symbolic link, create, -lns: Insert. (line 191)
* SUN Disk Label, production: Bootable. (line 404)
* SUN SPARC boot images, activation: Bootable. (line 501)
* Symbolic link, create, -lns: Insert. (line 192)
* System area, _definition: Bootable. (line 217)
* Table-of-content, search sessions, -rom_toc_scan: Loading. (line 307)
* Table-of-content, show, -toc: Inquiry. (line 27)
@ -6290,47 +6315,47 @@ Node: ArgSort27718
Node: AqDrive29212
Node: Loading36369
Node: Insert58140
Node: SetInsert70257
Node: Manip80374
Node: CmdFind90474
Node: Filter110498
Node: Writing115120
Node: SetWrite127614
Node: Bootable158889
Node: Jigdo187867
Node: Charset192870
Node: Exception196199
Node: DialogCtl202328
Node: Inquiry204930
Node: Navigate216188
Node: Verify224895
Node: Restore236044
Node: Emulation248252
Node: Scripting258708
Node: Frontend266491
Node: Examples276117
Node: ExDevices277295
Node: ExCreate277956
Node: ExDialog279256
Node: ExGrowing280527
Node: ExModifying281336
Node: ExBootable281846
Node: ExCharset282401
Node: ExPseudo283297
Node: ExCdrecord284224
Node: ExMkisofs284544
Node: ExGrowisofs286441
Node: ExException287594
Node: ExTime288052
Node: ExIncBackup288510
Node: ExRestore292536
Node: ExRecovery293482
Node: Files294054
Node: Environ295388
Node: Seealso296136
Node: Bugreport296853
Node: Legal297444
Node: CommandIdx298456
Node: ConceptIdx316354
Node: SetInsert70335
Node: Manip80509
Node: CmdFind90609
Node: Filter110633
Node: Writing115255
Node: SetWrite127749
Node: Bootable159024
Node: Jigdo189289
Node: Charset194292
Node: Exception197621
Node: DialogCtl203750
Node: Inquiry206352
Node: Navigate217610
Node: Verify226317
Node: Restore237466
Node: Emulation249673
Node: Scripting260129
Node: Frontend267912
Node: Examples277538
Node: ExDevices278716
Node: ExCreate279377
Node: ExDialog280677
Node: ExGrowing281948
Node: ExModifying282757
Node: ExBootable283267
Node: ExCharset283822
Node: ExPseudo284718
Node: ExCdrecord285645
Node: ExMkisofs285965
Node: ExGrowisofs287862
Node: ExException289015
Node: ExTime289473
Node: ExIncBackup289931
Node: ExRestore293957
Node: ExRecovery294903
Node: Files295475
Node: Environ296809
Node: Seealso297557
Node: Bugreport298274
Node: Legal298865
Node: CommandIdx299877
Node: ConceptIdx317775

End Tag Table