summaryrefslogtreecommitdiffstats
path: root/disk-utils/sfdisk.8
diff options
context:
space:
mode:
authorKarel Zak2017-03-02 13:44:26 +0100
committerKarel Zak2017-03-02 13:44:26 +0100
commit86800f5d75abd05e12de0b2e1ebd48f049cf256a (patch)
treef1d941271ccdec1969edfbc8d38d3686b5f0790d /disk-utils/sfdisk.8
parentcolumn: make more obvious what is default behavior (diff)
downloadkernel-qcow2-util-linux-86800f5d75abd05e12de0b2e1ebd48f049cf256a.tar.gz
kernel-qcow2-util-linux-86800f5d75abd05e12de0b2e1ebd48f049cf256a.tar.xz
kernel-qcow2-util-linux-86800f5d75abd05e12de0b2e1ebd48f049cf256a.zip
sfdisk: add note about alignment to man page
Addresses: https://github.com/karelzak/util-linux/issues/417 Signed-off-by: Karel Zak <kzak@redhat.com>
Diffstat (limited to 'disk-utils/sfdisk.8')
-rw-r--r--disk-utils/sfdisk.817
1 files changed, 14 insertions, 3 deletions
diff --git a/disk-utils/sfdisk.8 b/disk-utils/sfdisk.8
index e8ecf4838..b72bb3217 100644
--- a/disk-utils/sfdisk.8
+++ b/disk-utils/sfdisk.8
@@ -35,9 +35,20 @@ never been important for Linux, and this addressing concept does not make any
sense for new devices.
.sp
.B sfdisk
-(since version 2.26) aligns the start and end of partitions to
-block-device I/O limits when relative sizes are specified, or when the
-default values are used.
+(since version 2.26)
+.B aligns the start and end of partitions
+to block-device I/O limits when relative sizes are specified, when the default
+values are used or when multiplicative suffixes (e.g MiB) are used for sizes.
+It is possible that partition size will be optimized (reduced or enlarged) due
+to alignment if the start offset is specified exactly in sectors and partition
+size relative or by multiplicative suffixes.
+
+The recommended way is not to specify start offsets at all and specify
+partition size in MiB, GiB (or so). In this case sfdisk align all partitions
+to block-device I/O limits (or when I/O limits are too small then to megabyte
+boundary to keep disk layout portable). If this default behaviour is unwanted
+then specify offsets and sizes in sectors. In this case sfdisk entirely
+follows specified numbers without any optimization.
.sp
.B sfdisk
does not create the standard system partitions for SGI and SUN disk labels like