From 7a7f234b69cb0333d3ecb92ab763da3dcb60fe10 Mon Sep 17 00:00:00 2001 From: Thomas Schmitt Date: Thu, 3 Mar 2011 18:20:12 +0000 Subject: [PATCH] Updated documentation --- xorriso/xorriso.1 | 10 ++++++ xorriso/xorriso.info | 85 ++++++++++++++++++++++++-------------------- xorriso/xorriso.texi | 14 +++++++- 3 files changed, 70 insertions(+), 39 deletions(-) diff --git a/xorriso/xorriso.1 b/xorriso/xorriso.1 index 973b1689..75e0b6a8 100644 --- a/xorriso/xorriso.1 +++ b/xorriso/xorriso.1 @@ -2531,6 +2531,16 @@ If the product of partition_sec_hd and partition_hd_cyl is too small to describe the image size by at most 1024 cylinders, then appropriate values of partition_hd_cyl are chosen with partition_sec_hd 32 or 63. .br +\fBpartition_cyl_align=\fRmode controls image size alignment to an integer +number of cylinders. It is prescribed by isohybrid specs and it seems to +please program fdisk. +.br +Mode "auto" is default. Alignment by padding happens only with +"isolinux" "partition_table=on". +.br +Mode "on" causes alignment by padding with "partition_table=on" for any type. +Mode "off" disables alignment for any type. +.br \fBmips_path=\fRiso_rr_path declares a data file in the image to be a MIPS Big Endian boot file and causes production of a MIPS Big Endian Volume Header. This is mutually exclusive with production of other boot blocks diff --git a/xorriso/xorriso.info b/xorriso/xorriso.info index 5bf08d45..96172374 100644 --- a/xorriso/xorriso.info +++ b/xorriso/xorriso.info @@ -2252,6 +2252,13 @@ filesystem and announced by an MBR partition table entry. small to describe the image size by at most 1024 cylinders, then appropriate values of partition_hd_cyl are chosen with partition_sec_hd 32 or 63. + *partition_cyl_align=*mode controls image size alignment to an + integer number of cylinders. It is prescribed by isohybrid specs + and it seems to please program fdisk. + Mode "auto" is default. Alignment by padding happens only with + "isolinux" "partition_table=on". + Mode "on" causes alignment by padding with "partition_table=on" + for any type. Mode "off" disables alignment for any type. *mips_path=*iso_rr_path declares a data file in the image to be a MIPS Big Endian boot file and causes production of a MIPS Big Endian Volume Header. This is mutually exclusive with production @@ -4053,7 +4060,7 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top * -alter_date sets timestamps in ISO image: Manip. (line 146) * -alter_date_r sets timestamps in ISO image: Manip. (line 166) * -append_partition adds arbitrary file after image end: Bootable. - (line 190) + (line 197) * -application_id sets application id: SetWrite. (line 117) * -as emulates mkisofs or cdrecord: Emulation. (line 13) * -assert_volid rejects undesired images: Loading. (line 84) @@ -4256,7 +4263,7 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top * ACL, show in ISO image, -getfacl: Navigate. (line 69) * ACL, show in ISO image, -getfacl_r: Navigate. (line 76) * Appendable media, _definition: Media. (line 38) -* Appended Filesystem Image, -append_partition: Bootable. (line 190) +* Appended Filesystem Image, -append_partition: Bootable. (line 197) * Backslash Interpretation, _definition: Processing. (line 49) * Backup, enable fast incremental, -disk_dev_ino: Loading. (line 182) * Backup, enable features, -for_backup: Loading. (line 177) @@ -4274,6 +4281,8 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top * Closed media, _definition: Media. (line 43) * Comment, #: Scripting. (line 128) * Create, new ISO image, _definiton: Methods. (line 6) +* Cylinder alignment, _definiton: Bootable. (line 166) +* Cylinder size, _definiton: Bootable. (line 158) * Delete, from ISO image, -rm: Manip. (line 21) * Delete, from ISO image, -rm_r: Manip. (line 28) * Delete, ISO directory, -rmdir: Manip. (line 32) @@ -4367,7 +4376,7 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top * Media, erase, -blank: Writing. (line 45) * Media, format, -format: Writing. (line 69) * Media, list formats, -list_formats: Writing. (line 107) -* MIPS boot file, activation: Bootable. (line 166) +* MIPS boot file, activation: Bootable. (line 173) * mkisofs, Emulation: Emulation. (line 16) * Modifying, _definition: Methods. (line 27) * Multi-session media, _definition: Media. (line 7) @@ -4446,8 +4455,8 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top * Session, mount command line, -mount_cmd: Inquiry. (line 31) * Session, mount parameters, -mount_opts: Inquiry. (line 47) * Session, select as input, -load: Loading. (line 11) -* SUN Disk Label, production: Bootable. (line 177) -* SUN SPARC boot images, activation: Bootable. (line 211) +* SUN Disk Label, production: Bootable. (line 184) +* SUN SPARC boot images, activation: Bootable. (line 218) * System area, _definiton: Bootable. (line 123) * Table-of-content, search sessions, -rom_toc_scan: Loading. (line 203) * Table-of-content, show, -toc: Inquiry. (line 18) @@ -4509,38 +4518,38 @@ Node: Filter79052 Node: Writing83401 Node: SetWrite89690 Node: Bootable103631 -Node: Jigdo116168 -Node: Charset120426 -Node: Exception123177 -Node: DialogCtl127692 -Node: Inquiry130279 -Node: Navigate134656 -Node: Verify142596 -Node: Restore151185 -Node: Emulation157841 -Node: Scripting167212 -Node: Frontend172774 -Node: Examples174069 -Node: ExDevices175238 -Node: ExCreate175872 -Node: ExDialog177146 -Node: ExGrowing178408 -Node: ExModifying179210 -Node: ExBootable179711 -Node: ExCharset180258 -Node: ExPseudo181086 -Node: ExCdrecord181980 -Node: ExMkisofs182295 -Node: ExGrowisofs183298 -Node: ExException184422 -Node: ExTime184876 -Node: ExIncBackup185335 -Node: ExRestore189256 -Node: ExRecovery190225 -Node: Files190791 -Node: Seealso192019 -Node: Legal192543 -Node: CommandIdx193465 -Node: ConceptIdx207772 +Node: Jigdo116588 +Node: Charset120846 +Node: Exception123597 +Node: DialogCtl128112 +Node: Inquiry130699 +Node: Navigate135076 +Node: Verify143016 +Node: Restore151605 +Node: Emulation158261 +Node: Scripting167632 +Node: Frontend173194 +Node: Examples174489 +Node: ExDevices175658 +Node: ExCreate176292 +Node: ExDialog177566 +Node: ExGrowing178828 +Node: ExModifying179630 +Node: ExBootable180131 +Node: ExCharset180678 +Node: ExPseudo181506 +Node: ExCdrecord182400 +Node: ExMkisofs182715 +Node: ExGrowisofs183718 +Node: ExException184842 +Node: ExTime185296 +Node: ExIncBackup185755 +Node: ExRestore189676 +Node: ExRecovery190645 +Node: Files191211 +Node: Seealso192439 +Node: Legal192963 +Node: CommandIdx193885 +Node: ConceptIdx208192  End Tag Table diff --git a/xorriso/xorriso.texi b/xorriso/xorriso.texi index 1a53b09f..ed36923d 100644 --- a/xorriso/xorriso.texi +++ b/xorriso/xorriso.texi @@ -44,7 +44,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 "Mar 02, 2011" +@c man .TH XORRISO 1 "Mar 03, 2011" @c man .\" Please adjust this date whenever revising the manpage. @c man .\" @c man .\" Some roff macros, for reference: @@ -2992,6 +2992,7 @@ absolute start as well as from the partition start. The offset value of an ISO image gets preserved when a new session is added. So the value defined here is only in effect if a new ISO image gets written. @* +@cindex Cylinder size, _definiton @strong{partition_hd_cyl=}number gives the number of heads per cylinder for partition offset. 0 chooses a default value. @* @@ -3002,6 +3003,17 @@ If the product of partition_sec_hd and partition_hd_cyl is too small to describe the image size by at most 1024 cylinders, then appropriate values of partition_hd_cyl are chosen with partition_sec_hd 32 or 63. @* +@cindex Cylinder alignment, _definiton +@strong{partition_cyl_align=}mode controls image size alignment to an integer +number of cylinders. It is prescribed by isohybrid specs and it seems to +please program fdisk. +@* +Mode "auto" is default. Alignment by padding happens only with +"isolinux" "partition_table=on". +@* +Mode "on" causes alignment by padding with "partition_table=on" for any type. +Mode "off" disables alignment for any type. +@* @cindex MIPS boot file, activation @strong{mips_path=}iso_rr_path declares a data file in the image to be a MIPS Big Endian boot file and causes production of a MIPS Big Endian Volume