diff options
author | Karel Zak | 2014-03-10 14:15:36 +0100 |
---|---|---|
committer | Karel Zak | 2014-03-11 11:35:15 +0100 |
commit | 4ddd86d5d96f75b8b5191add9b1eaeebb9a548bd (patch) | |
tree | ea7c8c5a9be354ec689562028546a8adad2ba19d /disk-utils/cfdisk.8 | |
parent | fdisk: merge fdisk-ask.c to fdisk.c (diff) | |
download | kernel-qcow2-util-linux-4ddd86d5d96f75b8b5191add9b1eaeebb9a548bd.tar.gz kernel-qcow2-util-linux-4ddd86d5d96f75b8b5191add9b1eaeebb9a548bd.tar.xz kernel-qcow2-util-linux-4ddd86d5d96f75b8b5191add9b1eaeebb9a548bd.zip |
build-sys: ove fdisks to disk-utils
Signed-off-by: Karel Zak <kzak@redhat.com>
Diffstat (limited to 'disk-utils/cfdisk.8')
-rw-r--r-- | disk-utils/cfdisk.8 | 145 |
1 files changed, 145 insertions, 0 deletions
diff --git a/disk-utils/cfdisk.8 b/disk-utils/cfdisk.8 new file mode 100644 index 000000000..2fae5925f --- /dev/null +++ b/disk-utils/cfdisk.8 @@ -0,0 +1,145 @@ +.\" cfdisk.8 -- man page for cfdisk +.\" Copyright 1994 Kevin E. Martin (martin@cs.unc.edu) +.\" Copyright (C) 2014 Karel Zak <kzak@redhat.com> +.\" +.\" Permission is granted to make and distribute verbatim copies of this +.\" manual provided the copyright notice and this permission notice are +.\" preserved on all copies. +.\" +.\" Permission is granted to copy and distribute modified versions of this +.\" manual under the conditions for verbatim copying, provided that the +.\" entire resulting derived work is distributed under the terms of a +.\" permission notice identical to this one. +.\" +.\" " for hilit mode +.TH CFDISK 8 "March 2014" "util-linux" "System Administration" +.SH NAME +cfdisk \- display or manipulate disk partition table +.SH SYNOPSIS +.B cfdisk +.RB [ options ] +.RI [ device ] +.SH DESCRIPTION +.B cfdisk +is a curses-based program for partitioning any block device. +The default device is /dev/sda. + +Note that +.B cfdisk +provides basic partitioning functionality by user friendly interface. If you +need advanced features then use +.BR fdisk (8). + +Since version 2.25 +.BR cfdisk (8) +supports MBR (DOS), GPT, SUN and SGI disk labels, but it does not provides any +functionality in regards to CHS (Cylinder-Head-Sector) addressing. CHS has +never been important for Linux and this addressing concept does not make any +sense for new devices. + +Since version 2.25 +.BR cfdisk (8) +also does not provide a 'print' command. This functionality is provided by +utils +.BR partx (8) +and +.BR lsblk (8) +in very comfortable and rich way. + +If you want to remove an old partition table from device than use +.BR wipefs (8). + +.SH OPTIONS +.IP "\fB\-h, \-\-help\fP" +Display help text and exit. +.IP "\fB\-L\fR, \fB\-\-color\fR[=\fIwhen\fR]" +Colorize output, enabled by default. The optional argument \fIwhen\fP can be +\fBauto\fR, \fBnever\fR or \fBalways\fR. If the \fIwhen\fR argument is omitted, +then it defaults to \fBauto\fR. +.IP "\fB-V, \-\-version" +Display version information and exit. + +.SH COMMANDS +.B cfdisk +commands can be entered by pressing the desired key (pressing +.I Enter +after the command is not necessary). Here is a list of the available +commands: +.TP +.B b +Toggle bootable flag of the current partition. This allows you to +select which primary partition is bootable on the drive. This command does not +have to available for all partition label types. +.TP +.B d +Delete the current partition. This will convert the current partition +into free space and merge it with any free space immediately +surrounding the current partition. A partition already marked as free +space or marked as unusable cannot be deleted. +.TP +.B h +Print the help screen. +.TP +.B n +Create a new partition from free space. +.B cfdisk +next prompts you for the size of the partition you want to create. +The default size is equal to the entire available free space at the current +position. + +The size may be followed by the multiplicative suffixes KiB=1024, +MiB=1024*1024, and so on for GiB, TiB, PiB, EiB, ZiB and YiB (the "iB" +is optional, e.g. "K" has the same meaning as "KiB") +.TP +.B q +Quit program. This will exit the program without writing any data to +disk. +.TP +.B t +Change the partition type. By default, new partitions are created as +.I Linux +partitions. +.TP +.B W +Write the partition table to disk (you must enter an uppercase W). Since +this might destroy data on the disk, you must either confirm or deny +the write by entering `yes' or `no'. If you enter `yes', +.B cfdisk +will write the partition table to disk and then tell the kernel to re-read the +partition table from the disk. + +The re-reading of the partition table does not work in some cases. In such a +case you need to inform the kernel about new partitions by +.BR partprobe (8), +.BR kpartx (8) +or reboot the system. +.TP +.IR "Up Arrow" , " Down Arrow" +Move the cursor to the previous or next partition. If there are more +partitions than can be displayed on a screen, you can display the next +(previous) set of partitions by moving down (up) at the last (first) +partition displayed on the screen. + +.PP +All of the commands can be entered with either upper or lower case +letters (except for +.BR W rite). +When in a sub-menu or at a prompt to enter a filename, you can hit the +.I ESC +key to return to the main command line. + +.SH "SEE ALSO" +.BR fdisk (8), +.BR sfdisk (8), +.BR parted (8), +.BR partprobe (8), +.BR partx(8) +.SH AUTHOR +Karel Zak <kzak@redhat.com> +.PP +The current cfdisk implemntation is based on the original cfdisk +from Kevin E. Martin (martin@cs.unc.edu). + +.SH AVAILABILITY +The cfdisk command is part of the util-linux package and is available from +ftp://ftp.kernel.org/pub/linux/utils/util-linux/. |