ericonr
/
util-linux
mirror of https://github.com/ericonr/util-linux.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

Manual pages: sfdisk.8: Minor wording and formatting fixes 

Signed-off-by: Michael Kerrisk (man-pages) <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk (man-pages) 2020-07-24 12:06:10 +02:00 committed by Karel Zak
parent 8be2cc8171
commit b382d543ed
1 changed files with 27 additions and 11 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

38
disk-utils/sfdisk.8
View File

@ -26,7 +26,7 @@ sfdisk \- display or manipulate a disk partition table
.SH DESCRIPTION .SH DESCRIPTION
.B sfdisk .B sfdisk
is a script-oriented tool for partitioning any block device. It is a script-oriented tool for partitioning any block device. It
runs in interactive mode if executed on terminal (stdin refers to a terminal). runs in interactive mode if executed on a terminal (stdin refers to a terminal).
Since version 2.26 Since version 2.26
.B sfdisk .B sfdisk
@ -45,11 +45,15 @@ to alignment if the start offset is specified exactly in sectors and partition
size relative or by multiplicative suffixes. size relative or by multiplicative suffixes.
The recommended way is not to specify start offsets at all and specify 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 partition size in MiB, GiB (or so). In this case
.B sfdisk
aligns all partitions
to block-device I/O limits (or when I/O limits are too small then to megabyte 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 boundary to keep disk layout portable). If this default behaviour is unwanted
(usually for very small partitions) then specify offsets and sizes in (usually for very small partitions) then specify offsets and sizes in
sectors. In this case sfdisk entirely follows specified numbers without any sectors. In this case
.B sfdisk
entirely follows specified numbers without any
optimization. optimization.
.sp .sp
.B sfdisk .B sfdisk
@ -62,11 +66,15 @@ partitions.
.B sfdisk .B sfdisk
uses BLKRRPART (reread partition table) ioctl to make sure that the device is uses BLKRRPART (reread partition table) ioctl to make sure that the device is
not used by system or other tools (see also \-\-no-reread). It's possible that not used by system or other tools (see also \-\-no-reread). It's possible that
this feature or another sfdisk activity races with \fBudevd\fR. The recommended way this feature or another
.B sfdisk
activity races with \fBudevd\fR. The recommended way
how to avoid possible collisions is to use \fB\-\-lock\fR option. how to avoid possible collisions is to use \fB\-\-lock\fR option.
The exclusive lock will cause udevd to skip the event handling on the device. The exclusive lock will cause udevd to skip the event handling on the device.
.PP .PP
The sfdisk prompt is only a hint for users and a displayed partition number does The
.B sfdisk
prompt is only a hint for users and a displayed partition number does
not mean that the same partition table entry will be created (if -N not not mean that the same partition table entry will be created (if -N not
specified), especially for tables with gaps. specified), especially for tables with gaps.
@ -96,8 +104,10 @@ bootable flag on all unspecified partitions. The special placeholder '\-'
may be used instead of the partition numbers to switch off the bootable flag may be used instead of the partition numbers to switch off the bootable flag
on all partitions. on all partitions.
The activation command is supported for MBR and PMBR only. If GPT label is detected The activation command is supported for MBR and PMBR only.
than sfdisk prints warning and automatically enter PMBR. If a GPT label is detected, then
.B sfdisk
prints warning and automatically enters PMBR.
If no \fIpartition-number\fR is specified, then list the partitions with an If no \fIpartition-number\fR is specified, then list the partitions with an
enabled flag. enabled flag.
@ -267,7 +277,9 @@ and the last command reorders partitions to match disk order
.TP .TP
.B \-\-move\-use\-fsync .B \-\-move\-use\-fsync
Use fsync system call after each write when move data to a new location by Use the
.BR fsync (2)
system call after each write when moving data to a new location by
\fB\-\-move\-data\fR. \fB\-\-move\-data\fR.
.TP .TP
.BR \-o , " \-\-output " \fIlist .BR \-o , " \-\-output " \fIlist
@ -305,7 +317,7 @@ to avoid possible collisions. The argument \fIwhen\fR can be \fBauto\fR,
except the old partition-table signatures which are always wiped before create except the old partition-table signatures which are always wiped before create
a new partition-table if the argument \fIwhen\fR is not \fBnever\fR. In all a new partition-table if the argument \fIwhen\fR is not \fBnever\fR. In all
cases detected signatures are reported by warning messages before a new cases detected signatures are reported by warning messages before a new
partition table is created. See also partition table is created. See also the
.BR wipefs (8) .BR wipefs (8)
command. command.
@ -418,7 +430,9 @@ The partition
is given in hex for MBR (DOS) where 0x prefix is optional; a GUID string for is given in hex for MBR (DOS) where 0x prefix is optional; a GUID string for
GPT; a shortcut or an alias. It's recommended to use two letters for MBR hex codes to GPT; a shortcut or an alias. It's recommended to use two letters for MBR hex codes to
avoid collision between deprecated shortcut 'E' and '0E' MBR hex code. For backward avoid collision between deprecated shortcut 'E' and '0E' MBR hex code. For backward
compatibility sfdisk tries to interpret compatibility
.B sfdisk
tries to interpret
.I type .I type
as a shortcut as a first possibility in partitioning scripts although on other places (e.g. as a shortcut as a first possibility in partitioning scripts although on other places (e.g.
\fB\-\-part-type command)\fR it tries shortcuts as the last possibility. \fB\-\-part-type command)\fR it tries shortcuts as the last possibility.
@ -601,7 +615,9 @@ The welcome message.
.SH ENVIRONMENT .SH ENVIRONMENT
.IP SFDISK_DEBUG=all .IP SFDISK_DEBUG=all
enables sfdisk debug output. enablescw
.B sfdisk
debug output.
.IP LIBFDISK_DEBUG=all .IP LIBFDISK_DEBUG=all
enables libfdisk debug output. enables libfdisk debug output.
.IP LIBBLKID_DEBUG=all .IP LIBBLKID_DEBUG=all