From 4818eeaa5f3484ea6f3dbaa4a66134c447a9443b Mon Sep 17 00:00:00 2001 From: Thomas Schmitt Date: Sat, 11 May 2024 13:06:20 +0200 Subject: [PATCH] Mentioned in the man page the increased number of appended GPT partitions in libisofs --- xorriso/xorriso.1 | 54 ++++++++--- xorriso/xorriso.info | 215 +++++++++++++++++++++++------------------ xorriso/xorriso.texi | 56 ++++++++--- xorriso/xorrisofs.1 | 18 +++- xorriso/xorrisofs.info | 130 +++++++++++++------------ xorriso/xorrisofs.texi | 18 +++- 6 files changed, 300 insertions(+), 191 deletions(-) diff --git a/xorriso/xorriso.1 b/xorriso/xorriso.1 index ddb98b58..d4187773 100644 --- a/xorriso/xorriso.1 +++ b/xorriso/xorriso.1 @@ -9,7 +9,7 @@ .\" First parameter, NAME, should be all caps .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection .\" other parameters are allowed: see man(7), man(1) -.TH XORRISO 1 "Version 1.5.7, Aug 07, 2023" +.TH XORRISO 1 "Version 1.5.7, May 07, 2024" .\" Please adjust this date whenever revising the manpage. .\" .\" 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 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. +read access. A symbolic link will only work if enabled by \-follow "link" or +"param". .br 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 @@ -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 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 +alternative not excluded path. So the exclusions need to be coordinated with the actual disk_path parameters given with commands. .br (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 \fB\-follow\fR 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. +disk_paths. This applies to actions \-add, \-cut_out, \-du*x, \-ls*x, \-findx, +\-concat, and to \-disk_pattern expansion. .br -There are three kinds of follow decisison to be made: +There are three main kinds of follow decisison to be made: .br \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. @@ -1613,7 +1614,7 @@ expansion). 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 follow links in an eventual directory tree below the targets (unless "link" -is enabled). +is enabled). \-cut_out will process link targets. .br Occasions can be combined in a colon separated list. All occasions mentioned in the list will then lead to a positive follow decision. @@ -3633,7 +3634,7 @@ and their designated fate. .br Examples: .br -Drop unknown El Torito: +Drop El Torito: .br \-boot_image any discard .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 in GPT rather than in MBR. In this case the MBR shows a single partition of type 0xee which covers the whole output data. +The number of appendable partitions with GPT is 8 rather than 4 with MBR. .br \fBappended_part_as=mbr\fR is the default. Appended partitions get 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". .br \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 By default, appended partitions get marked in APM only if APM is 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 overwritten. .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 -With MBR: +With \fBMBR\fR: .br 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 @@ -4055,11 +4060,30 @@ In APM, 48465300\-0000\-11AA\-AA11\-00306543ECAC will be mapped to partition type "Apple_HFS", any other to "Data". .br 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 \-boot_image "any" "appended_part_as=gpt" .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 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 @@ -5167,7 +5191,7 @@ manipulation commands like \-rm or \-find ... \-exec rm before extraction, and end the program by \-rollback_end . .br 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. .br If disk file objects already exist then the settings of \-overwrite and @@ -6713,7 +6737,7 @@ Thomas Schmitt .br for libburnia\-project.org .SH COPYRIGHT -Copyright (c) 2007 \- 2023 Thomas Schmitt +Copyright (c) 2007 \- 2024 Thomas Schmitt .br Permission is granted to distribute this text freely. It shall only be modified in sync with the technical properties of \fBxorriso\fR. diff --git a/xorriso/xorriso.info b/xorriso/xorriso.info index c511c504..dad81222 100644 --- a/xorriso/xorriso.info +++ b/xorriso/xorriso.info @@ -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 diff --git a/xorriso/xorriso.texi b/xorriso/xorriso.texi index 9edcf1ef..ea2aa9ed 100644 --- a/xorriso/xorriso.texi +++ b/xorriso/xorriso.texi @@ -50,7 +50,7 @@ @c man .\" First parameter, NAME, should be all caps @c man .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection @c man .\" other parameters are allowed: see man(7), man(1) -@c man .TH XORRISO 1 "Version 1.5.7, 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 .\" @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 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. +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 @@ -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 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 +alternative not excluded 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 "@minus{}@minus{}") @@ -1923,10 +1924,10 @@ handled as one parameter for -not_paths or -not_leaf. @kindex -follow softlinks and mount points @cindex Insert, links or mount points, -follow 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. +disk_paths. This applies to actions -add, -cut_out, -du*x, -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: @* @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. @@ -1951,7 +1952,7 @@ expansion). 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 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 mentioned in the list will then lead to a positive follow decision. @@ -4187,7 +4188,7 @@ and their designated fate. @* Examples: @* -Drop unknown El Torito: +Drop El Torito: @* -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 in GPT rather than in MBR. In this case the MBR shows a single partition 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 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 @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 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 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 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". @* 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" @* +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 -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 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 . @* 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 @@ -7784,7 +7810,7 @@ Thomas Schmitt for libburnia-project.org @c man .SH 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 modified in sync with the technical properties of @command{xorriso}. diff --git a/xorriso/xorrisofs.1 b/xorriso/xorrisofs.1 index 0c60ac09..86d907b7 100644 --- a/xorriso/xorrisofs.1 +++ b/xorriso/xorrisofs.1 @@ -9,7 +9,7 @@ .\" First parameter, NAME, should be all caps .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection .\" other parameters are allowed: see man(7), man(1) -.TH XORRISOFS 1 "Version 1.5.7, Nov 12, 2023" +.TH XORRISOFS 1 "Version 1.5.7, May 07, 2024" .\" Please adjust this date whenever revising the manpage. .\" .\" Some roff macros, for reference: @@ -883,7 +883,7 @@ These values may be combined. E.g.: joliet:hfsplus .br This command does not apply to the boot catalog. -Rather use: boot\-catalog\-hide +Rather use: \-\-boot\-catalog\-hide .TP .B ISO image ID strings: .PP @@ -1438,9 +1438,21 @@ of type 0xee which covers the whole output data. .br By default, appended partitions get marked in GPT only if GPT is produced 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 \fB\-appended_part_as_apm\fR 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 By default, appended partitions get marked in APM only if APM is produced because of other options and \-part_like_isohybrid is enabled. @@ -2282,7 +2294,7 @@ Thomas Schmitt .br for libburnia\-project.org .SH COPYRIGHT -Copyright (c) 2011 \- 2023 Thomas Schmitt +Copyright (c) 2011 \- 2024 Thomas Schmitt .br 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 diff --git a/xorriso/xorrisofs.info b/xorriso/xorrisofs.info index bbfbeb5f..27678bcd 100644 --- a/xorriso/xorrisofs.info +++ b/xorriso/xorrisofs.info @@ -791,7 +791,7 @@ File: xorrisofs.info, Node: SetHide, Next: ImageId, Prev: SetExtras, Up: Opt them all. "off" means visibility in all directory trees. These values may be combined. E.g.: joliet:hfsplus 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 @@ -1251,9 +1251,19 @@ Examples: covers the whole output data. By default, appended partitions get marked in GPT only if GPT is 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 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 produced because of other options and -part_like_isohybrid is enabled. @@ -2002,7 +2012,7 @@ for libburnia-project.org 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 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 @@ -2037,10 +2047,10 @@ File: xorrisofs.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: T * --gpt-iso-bootable Set Legacy BIOS bootable flag: SystemArea. (line 159) * --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-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) * --mbr-force-bootable Enforce MBR bootable/active flag: SystemArea. (line 148) @@ -2080,16 +2090,16 @@ File: xorrisofs.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: T * -A set Application Id: ImageId. (line 34) * -abstract set Abstract File path: ImageId. (line 57) * -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. - (line 244) + (line 253) * -appended_part_as_gpt Appended partitions in GPT: SystemArea. (line 238) * -append_partition Append MBR or GPT partition after image: SystemArea. (line 208) * -appid set Application Id: ImageId. (line 41) * -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) * -boot-info-table Patch El Torito boot image: Bootable. (line 104) * -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_template choose .template checksums: Jigdo. (line 92) -* -chrp-boot CHRP partition: SystemArea. (line 282) -* -chrp-boot-part CHRP partition: SystemArea. (line 273) +* -chrp-boot CHRP partition: SystemArea. (line 292) +* -chrp-boot-part CHRP partition: SystemArea. (line 283) * -copyright set Copyright File path: ImageId. (line 66) * -cut_out insert piece of data file or device: SetInsert. (line 22) * -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. (line 23) * -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-boot El Torito PC-BIOS boot image: Bootable. (line 45) * -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. (line 90) * -hide_iso_path keep a file invisible in ISO tree: SetHide. (line 31) -* -hppa-bootloader HP-PA bootloader file: SystemArea. (line 327) -* -hppa-cmdline HP-PA PALO command line: SystemArea. (line 321) -* -hppa-hdrversion HP-PA PALO header version: SystemArea. (line 335) -* -hppa-kernel_32 HP-PA kernel_32 file: SystemArea. (line 329) -* -hppa-kernel_64 HP-PA kernel_64 file: SystemArea. (line 331) -* -hppa-ramdisk HP-PA ramdisk file: SystemArea. (line 333) +* -hppa-bootloader HP-PA bootloader file: SystemArea. (line 337) +* -hppa-cmdline HP-PA PALO command line: SystemArea. (line 331) +* -hppa-hdrversion HP-PA PALO header version: SystemArea. (line 345) +* -hppa-kernel_32 HP-PA kernel_32 file: SystemArea. (line 339) +* -hppa-kernel_64 HP-PA kernel_64 file: SystemArea. (line 341) +* -hppa-ramdisk HP-PA ramdisk file: SystemArea. (line 343) * -input-charset set character set of disk file names: Charset. (line 17) * -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. (line 61) * -md5-list set path of input checksum file: Jigdo. (line 81) -* -mips-boot MIPS Big Endian boot image: SystemArea. (line 289) -* -mipsel-boot MIPS Little Endian boot image: SystemArea. (line 295) +* -mips-boot MIPS Big Endian boot image: SystemArea. (line 299) +* -mipsel-boot MIPS Little Endian boot image: SystemArea. (line 305) * -N omit version number in ISO file names: SetCompl. (line 64) * -no-emul-boot El Torito boot image emulation: Bootable. (line 86) * -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. (line 122) * -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) * -prev-session set path for loading existing ISO image: Loading. (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) * -rr_reloc_dir set deep directory relocation target: SetExtras. (line 74) -* -sparc-boot SUN SPARC boot images: SystemArea. (line 311) -* -sparc-label SUN Disk Label text: SystemArea. (line 313) +* -sparc-boot SUN SPARC boot images: SystemArea. (line 321) +* -sparc-label SUN Disk Label text: SystemArea. (line 323) * -sysid set System Id: ImageId. (line 43) * -transparent-compression enable recognition of zisofs files: SetInsert. (line 63) @@ -2276,7 +2286,7 @@ File: xorrisofs.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top * Abstract File, set path, -abstract: ImageId. (line 57) * ACL, record and load, --acl: SetExtras. (line 103) * APM, mark appended partitions, -appended_part_as_apm: SystemArea. - (line 244) + (line 253) * APM, _definition: SystemArea. (line 16) * Application Id, set, -A, -appid: ImageId. (line 34) * Backup, enable fidelity, --for_backup: SetExtras. (line 92) @@ -2301,30 +2311,30 @@ File: xorrisofs.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top (line 104) * Bootability, bootable MBR partition, --mbr-force-bootable: SystemArea. (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, -alpha-boot: SystemArea. (line 338) +* Bootability, control, -alpha-boot: SystemArea. (line 348) * 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, -eltorito-platform: Bootable. (line 63) -* Bootability, control, -hppa-bootloader: SystemArea. (line 327) -* Bootability, control, -hppa-cmdline: SystemArea. (line 321) -* Bootability, control, -hppa-hdrversion: SystemArea. (line 335) -* Bootability, control, -hppa-kernel_32: SystemArea. (line 329) -* Bootability, control, -hppa-kernel_64: SystemArea. (line 331) -* Bootability, control, -hppa-ramdisk: SystemArea. (line 333) -* Bootability, control, -mips-boot: SystemArea. (line 289) -* Bootability, control, -mipsel-boot: SystemArea. (line 295) +* Bootability, control, -hppa-bootloader: SystemArea. (line 337) +* Bootability, control, -hppa-cmdline: SystemArea. (line 331) +* Bootability, control, -hppa-hdrversion: SystemArea. (line 345) +* Bootability, control, -hppa-kernel_32: SystemArea. (line 339) +* Bootability, control, -hppa-kernel_64: SystemArea. (line 341) +* Bootability, control, -hppa-ramdisk: SystemArea. (line 343) +* Bootability, control, -mips-boot: SystemArea. (line 299) +* Bootability, control, -mipsel-boot: SystemArea. (line 305) * Bootability, El Torito section id string, -eltorito-id: Bootable. (line 93) * Bootability, El Torito selection criteria, -eltorito-selcrit: Bootable. (line 100) * Bootability, fill System Area e.g. by MBR, -G, --embedded-boot, -generic-boot: SystemArea. (line 68) -* Bootability, for CHRP, -chrp-boot-part: SystemArea. (line 273) -* Bootability, for EFI, -efi-boot-part: SystemArea. (line 250) -* Bootability, for PReP, -prep-boot-part: SystemArea. (line 284) +* Bootability, for CHRP, -chrp-boot-part: SystemArea. (line 283) +* Bootability, for EFI, -efi-boot-part: SystemArea. (line 260) +* Bootability, for PReP, -prep-boot-part: SystemArea. (line 294) * Bootability, GPT Legacy BIOS bootable, --gpt-iso-bootable: SystemArea. (line 159) * 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) * Bootability, patch System Area partition table, --protective-msdos-label: SystemArea. (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. (line 129) * 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, -m, -exclude, -x, -old-exclude: SetInsert. (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) * ECMA-119, _definition: Standards. (line 6) * El Torito, _definition: Bootable. (line 13) @@ -2524,26 +2534,26 @@ Node: SetProduct15465 Node: SetCompl21036 Node: SetExtras23628 Node: SetHide35237 -Node: ImageId37234 -Node: Bootable41516 -Node: SystemArea47802 -Node: Charset66861 -Node: Jigdo67886 -Node: Miscellaneous72856 -Node: Examples74501 -Node: ExSimple74995 -Node: ExGraft75478 -Node: ExMkisofs76778 -Node: ExGrowisofs78586 -Node: ExIncBackup79776 -Node: ExIncBckAcc82952 -Node: ExBootable84657 -Node: Files88839 -Node: Environ89934 -Node: Seealso90807 -Node: Bugreport91458 -Node: Legal92051 -Node: CommandIdx92948 -Node: ConceptIdx110086 +Node: ImageId37236 +Node: Bootable41518 +Node: SystemArea47804 +Node: Charset67532 +Node: Jigdo68557 +Node: Miscellaneous73527 +Node: Examples75172 +Node: ExSimple75666 +Node: ExGraft76149 +Node: ExMkisofs77449 +Node: ExGrowisofs79257 +Node: ExIncBackup80447 +Node: ExIncBckAcc83623 +Node: ExBootable85328 +Node: Files89510 +Node: Environ90605 +Node: Seealso91478 +Node: Bugreport92129 +Node: Legal92722 +Node: CommandIdx93619 +Node: ConceptIdx110757  End Tag Table diff --git a/xorriso/xorrisofs.texi b/xorriso/xorrisofs.texi index e26831d8..f6214a38 100644 --- a/xorriso/xorrisofs.texi +++ b/xorriso/xorrisofs.texi @@ -50,7 +50,7 @@ @c man .\" First parameter, NAME, should be all caps @c man .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection @c man .\" other parameters are allowed: see man(7), man(1) -@c man .TH XORRISOFS 1 "Version 1.5.7, Nov 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 .\" @c man .\" Some roff macros, for reference: @@ -1201,7 +1201,7 @@ These values may be combined. E.g.: joliet:hfsplus @* This command does not apply to the boot catalog. -Rather use: boot-catalog-hide +Rather use: @minus{}@minus{}boot-catalog-hide @end table @c man .TP @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 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 @item -appended_part_as_apm @kindex -appended_part_as_apm Appended partitions in APM @cindex APM, mark appended partitions, -appended_part_as_apm 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 because of other options and -part_like_isohybrid is enabled. @@ -2965,7 +2977,7 @@ Thomas Schmitt for libburnia-project.org @c man .SH 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 modified in sync with the technical properties of xorriso. If you make use