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

sfdisk: adjust more wordings and formatting in the man page 

Signed-off-by: Benno Schulenberg <bensberg@justemail.net>
This commit is contained in:
Benno Schulenberg 2016-03-08 10:07:51 +01:00 committed by Karel Zak
parent c3cd675108
commit c805c36923
1 changed files with 34 additions and 29 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

63
disk-utils/sfdisk.8
View File

@ -64,14 +64,15 @@ Note that it's possible to address an unused partition with \fB\-N\fR.
For example, an MBR always contains 4 partitions, but the number of used For example, an MBR always contains 4 partitions, but the number of used
partitions may be smaller. In this case \fBsfdisk\fR follows the default partitions may be smaller. In this case \fBsfdisk\fR follows the default
values from the partition table and does not use built-in defaults for the values from the partition table and does not use built-in defaults for the
unused partition given with \fB\-N\fR. See also \fB\---append\fR. unused partition given with \fB\-N\fR. See also \fB\-\-append\fR.
.TP .TP
.BR \-A , " \-\-activate \fIdevice\fR [" \fIpartition-number\fR...] .BR \-A , " \-\-activate \fIdevice " [ \fIpartition-number ...]
Switch on the bootable flag. If no \fIpartition-number\fR is specified, Switch on the bootable flag for the specified partitions.
then all partitions with an enabled flag are listed. If no \fIpartition-number\fR is specified,
then list the partitions with an enabled flag.
.TP .TP
.BR " \-\-delete \fIdevice\fR [" \fIpartition-number\fR...] .BR "\-\-delete \fIdevice " [ \fIpartition-number ...]
Delete all or specified partitions. Delete all or the specified partitions.
.TP .TP
.BR \-d , " \-\-dump " \fIdevice\fR .BR \-d , " \-\-dump " \fIdevice\fR
Dump the partitions of a device in a format that is usable as input to \fBsfdisk\fR. Dump the partitions of a device in a format that is usable as input to \fBsfdisk\fR.
@ -91,30 +92,30 @@ together with \fB\-\-verify\fR.
.BR \-F , " \-\-list-free " [ \fIdevice ...] .BR \-F , " \-\-list-free " [ \fIdevice ...]
List the free unpartitioned areas on all or the specified devices. List the free unpartitioned areas on all or the specified devices.
.TP .TP
.BR \-\-part\-attrs " \fIdevice partno [" \fIattrs ] .BR "\-\-part\-attrs \fIdevice partition-number " [ \fIattributes ]
Change the GPT partition attribute bits. If \fIattrs\fR is not specified, Change the GPT partition attribute bits. If \fIattributes\fR is not specified,
then print the current partition settings. The \fIattrs\fR argument is a then print the current partition settings. The \fIattributes\fR argument is a
comma- or space-delimited list of bits. The currently supported attribute comma- or space-delimited list of bits. The currently supported attribute
bits are: RequiredPartiton, NoBlockIOProtocol, LegacyBIOSBootable bits are: RequiredPartiton, NoBlockIOProtocol, LegacyBIOSBootable
and GUID-specific bits in the range from 48 to 63. For example, the string and GUID-specific bits in the range from 48 to 63. For example, the string
"RequiredPartiton,50,51" sets three bits. "RequiredPartiton,50,51" sets three bits.
.TP .TP
.BR \-\-part\-label " \fIdevice partno [" \fIlabel ] .BR "\-\-part\-label \fIdevice partition-number " [ \fIlabel ]
Change the GPT partition name (label). If \fIlabel\fR is not specified, Change the GPT partition name (label). If \fIlabel\fR is not specified,
then print the current partition label. then print the current partition label.
.TP .TP
.BR \-\-part\-type " \fIdevice partno [" \fItype ] .BR "\-\-part\-type \fIdevice partition-number " [ \fItype ]
Change the partition type. If \fItype\fR is not specified, then print the Change the partition type. If \fItype\fR is not specified, then print the
current partition type. The \fItype\fR argument is hexadecimal for MBR, current partition type. The \fItype\fR argument is hexadecimal for MBR,
or a GUID for GPT. For backward compatibility the options \fB\-c\fR and or a GUID for GPT. For backward compatibility the options \fB\-c\fR and
\fB\-\-id\fR have the same meaning. \fB\-\-id\fR have the same meaning as this one.
.TP .TP
.BR \-\-part\-uuid " \fIdevice partno [" \fIuuid ] .BR "\-\-part\-uuid \fIdevice partition-number " [ \fIuuid ]
Change the GPT partition UUID. If \fIuuid\fR is not specified, Change the GPT partition UUID. If \fIuuid\fR is not specified,
then print the current partition UUID. then print the current partition UUID.
.TP .TP
.BR \-r , " \-\-reorder " \fIdevice .BR \-r , " \-\-reorder " \fIdevice
Fix partitions order by start offset. Renumber the partitions, ordering them by their start offset.
.TP .TP
.BR \-s , " \-\-show\-size " [ \fIdevice ...] .BR \-s , " \-\-show\-size " [ \fIdevice ...]
List the sizes of all or the specified devices. List the sizes of all or the specified devices.
@ -155,26 +156,27 @@ Do everything except writing to the device.
.B \-\-no\-reread .B \-\-no\-reread
Do not check through the re-read-partition-table ioctl whether the device is in use. Do not check through the re-read-partition-table ioctl whether the device is in use.
.TP .TP
.BR \-O , " \-\-backup\-file " \fIpath\fR .BR \-O , " \-\-backup\-file " \fIpath
Override the default backup file name. Note that the device name and offset Override the default backup file name. Note that the device name and offset
are always appended to the file name. are always appended to the file name.
.TP .TP
.BR \-\-move-data [ =\fIpath ] .BR \-\-move-data [ =\fIpath ]
Move data after partition relocation, for example when move begin of the Move data after partition relocation, for example when moving the beginning
partition to another place on the disk. The size of the partition has to be the of a partition to another place on the disk. The size of the partition has
same, the new and old location may overlap. The option requires \fB\-N\fR to be to remain the same, the new and old location may overlap. This option requires
processed on one specified partition only. option \fB\-N\fR in order to be processed on one specific partition only.
The \fIpath\fR overrides the default log file name The \fIpath\fR overrides the default log file name
(the default is ~/sfdisk-<devname>.move). The log file contains information (the default is ~/sfdisk-<devname>.move). The log file contains information
about all read/write oprations with the partition data. about all read/write operations on the partition data.
Note that this operation is ricky and not atomic. \fBDon't forget to backup your data!\fR Note that this operation is risky and not atomic. \fBDon't forget to backup your data!\fR
The example below creates 100MiB free area before the first partition and moves In the example below, the first command creates a 100MiB free area before
data (e.g. filesystem), the next command creates a new partition from the free the first partition and moves the data it contains (e.g. a filesystem),
space (at offset 2048) and the last command reorder partitions to match disk the next command creates a new partition from the free space (at offset 2048),
order (original sdc1 will be sdc2). and the last command reorders partitions to match disk order
(the original sdc1 will become sdc2).
.RS .RS
.sp .sp
.B "echo '+100M,' | sfdisk --move-data /dev/sdc -N 1" .B "echo '+100M,' | sfdisk --move-data /dev/sdc -N 1"
@ -277,7 +279,7 @@ given, the default for each field is its previous value.
The default value of The default value of
.I start .I start
is the first non-assigned sector aligned according to device I/O limits. is the first non-assigned sector aligned according to device I/O limits.
The default start offset for the first partition is 1 MiB. The offset may The default start offset for the first partition is 1 MiB. The offset may
be followed by the multiplicative suffixes (KiB, MiB, GiB, TiB, PiB, be followed by the multiplicative suffixes (KiB, MiB, GiB, TiB, PiB,
EiB, ZiB and YiB) then the number is interpreted as offset in bytes. EiB, ZiB and YiB) then the number is interpreted as offset in bytes.
.sp .sp
@ -342,7 +344,7 @@ more readable.
.RE .RE
The The
.I device .I device
field is optional. \fBsfdisk\fRextracts the partition number from the field is optional. \fBsfdisk\fR extracts the partition number from the
device name. It allows to specify the partitions in random order. device name. It allows to specify the partitions in random order.
This functionality is mostly used by \fB\-\-dump\fR. This functionality is mostly used by \fB\-\-dump\fR.
Don't use it if you are not sure. Don't use it if you are not sure.
@ -419,7 +421,10 @@ For example:
The GPT header can later be restored by: The GPT header can later be restored by:
.RS .RS
.sp .sp
.B dd if=~/sfdisk-sda-0x00000200.bak of=/dev/sda seek=$((0x00000200)) bs=1 conv=notrunc .nf
.B "dd if=~/sfdisk-sda-0x00000200.bak of=/dev/sda \e"
.B " seek=$((0x00000200)) bs=1 conv=notrunc"
.fi
.sp .sp
.RE .RE
Note that \fBsfdisk\fR since version 2.26 no longer provides the \fB\-I\fR option to Note that \fBsfdisk\fR since version 2.26 no longer provides the \fB\-I\fR option to