From f85fca7d65225ed92b3dd187b793819e710656d5 Mon Sep 17 00:00:00 2001 From: Thomas Schmitt Date: Fri, 4 Mar 2011 10:46:40 +0000 Subject: [PATCH] Clarifications about cylinder size and alignment --- libisoburn/trunk/xorriso/xorriso.1 | 18 +++-- libisoburn/trunk/xorriso/xorriso.info | 97 ++++++++++++++------------- libisoburn/trunk/xorriso/xorriso.texi | 18 +++-- 3 files changed, 73 insertions(+), 60 deletions(-) diff --git a/libisoburn/trunk/xorriso/xorriso.1 b/libisoburn/trunk/xorriso/xorriso.1 index 75e0b6a8..cc21f4d0 100644 --- a/libisoburn/trunk/xorriso/xorriso.1 +++ b/libisoburn/trunk/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 "Mar 02, 2011" +.TH XORRISO 1 "Mar 04, 2011" .\" Please adjust this date whenever revising the manpage. .\" .\" Some roff macros, for reference: @@ -2522,18 +2522,22 @@ 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. .br \fBpartition_hd_cyl=\fRnumber gives the number of heads per cylinder for -partition offset. 0 chooses a default value. +partition offset. 0 chooses a default value. Maximum is 255. .br \fBpartition_sec_hd=\fRnumber gives the number of sectors per head for -partition offset. 0 chooses a default value. +partition offset. 0 chooses a default value. Maximum is 63. .br -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. +The product partition_sec_hd * partition_hd_cyl * 512 is the cylinder size. +It should be divisible by 2048 in order to allow exact alignment. +If it 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. If the image is larger than 8,422,686,720 bytes, +then the cylinder size constraints cannot be fulfilled. .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. +please program fdisk. Cylinder size must be divisible by 2048. +Images larger than 8,323,596,288 bytes cannot be aligned. .br Mode "auto" is default. Alignment by padding happens only with "isolinux" "partition_table=on". diff --git a/libisoburn/trunk/xorriso/xorriso.info b/libisoburn/trunk/xorriso/xorriso.info index 96172374..290c3cd2 100644 --- a/libisoburn/trunk/xorriso/xorriso.info +++ b/libisoburn/trunk/xorriso/xorriso.info @@ -2245,16 +2245,21 @@ filesystem and announced by an MBR partition table entry. is added. So the value defined here is only in effect if a new ISO image gets written. *partition_hd_cyl=*number gives the number of heads per cylinder - for partition offset. 0 chooses a default value. + for partition offset. 0 chooses a default value. Maximum is 255. *partition_sec_hd=*number gives the number of sectors per head for - partition offset. 0 chooses a default value. - 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. + partition offset. 0 chooses a default value. Maximum is 63. + The product partition_sec_hd * partition_hd_cyl * 512 is the + cylinder size. It should be divisible by 2048 in order to allow + exact alignment. If it 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. If the + image is larger than 8,422,686,720 bytes, then the cylinder size + constraints cannot be fulfilled. *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. + and it seems to please program fdisk. Cylinder size must be + divisible by 2048. Images larger than 8,323,596,288 bytes cannot + be aligned. Mode "auto" is default. Alignment by padding happens only with "isolinux" "partition_table=on". Mode "on" causes alignment by padding with "partition_table=on" @@ -4060,7 +4065,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 197) + (line 202) * -application_id sets application id: SetWrite. (line 117) * -as emulates mkisofs or cdrecord: Emulation. (line 13) * -assert_volid rejects undesired images: Loading. (line 84) @@ -4263,7 +4268,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 197) +* Appended Filesystem Image, -append_partition: Bootable. (line 202) * Backslash Interpretation, _definition: Processing. (line 49) * Backup, enable fast incremental, -disk_dev_ino: Loading. (line 182) * Backup, enable features, -for_backup: Loading. (line 177) @@ -4281,7 +4286,7 @@ 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 alignment, _definiton: Bootable. (line 169) * Cylinder size, _definiton: Bootable. (line 158) * Delete, from ISO image, -rm: Manip. (line 21) * Delete, from ISO image, -rm_r: Manip. (line 28) @@ -4376,7 +4381,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 173) +* MIPS boot file, activation: Bootable. (line 178) * mkisofs, Emulation: Emulation. (line 16) * Modifying, _definition: Methods. (line 27) * Multi-session media, _definition: Media. (line 7) @@ -4455,8 +4460,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 184) -* SUN SPARC boot images, activation: Bootable. (line 218) +* SUN Disk Label, production: Bootable. (line 189) +* SUN SPARC boot images, activation: Bootable. (line 223) * 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) @@ -4518,38 +4523,38 @@ Node: Filter79052 Node: Writing83401 Node: SetWrite89690 Node: Bootable103631 -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 +Node: Jigdo116943 +Node: Charset121201 +Node: Exception123952 +Node: DialogCtl128467 +Node: Inquiry131054 +Node: Navigate135431 +Node: Verify143371 +Node: Restore151960 +Node: Emulation158616 +Node: Scripting167987 +Node: Frontend173549 +Node: Examples174844 +Node: ExDevices176013 +Node: ExCreate176647 +Node: ExDialog177921 +Node: ExGrowing179183 +Node: ExModifying179985 +Node: ExBootable180486 +Node: ExCharset181033 +Node: ExPseudo181861 +Node: ExCdrecord182755 +Node: ExMkisofs183070 +Node: ExGrowisofs184073 +Node: ExException185197 +Node: ExTime185651 +Node: ExIncBackup186110 +Node: ExRestore190031 +Node: ExRecovery191000 +Node: Files191566 +Node: Seealso192794 +Node: Legal193318 +Node: CommandIdx194240 +Node: ConceptIdx208547  End Tag Table diff --git a/libisoburn/trunk/xorriso/xorriso.texi b/libisoburn/trunk/xorriso/xorriso.texi index ed36923d..4f007867 100644 --- a/libisoburn/trunk/xorriso/xorriso.texi +++ b/libisoburn/trunk/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 03, 2011" +@c man .TH XORRISO 1 "Mar 04, 2011" @c man .\" Please adjust this date whenever revising the manpage. @c man .\" @c man .\" Some roff macros, for reference: @@ -2994,19 +2994,23 @@ 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. +partition offset. 0 chooses a default value. Maximum is 255. @* @strong{partition_sec_hd=}number gives the number of sectors per head for -partition offset. 0 chooses a default value. +partition offset. 0 chooses a default value. Maximum is 63. @* -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. +The product partition_sec_hd * partition_hd_cyl * 512 is the cylinder size. +It should be divisible by 2048 in order to allow exact alignment. +If it 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. If the image is larger than 8,422,686,720 bytes, +then the cylinder size constraints cannot be fulfilled. @* @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. +please program fdisk. Cylinder size must be divisible by 2048. +Images larger than 8,323,596,288 bytes cannot be aligned. @* Mode "auto" is default. Alignment by padding happens only with "isolinux" "partition_table=on".