SYNOPSIS
cfdisk-linux [ -agvz ] [ -c cylinders ] [ -h heads ] [ -s sectors-per-
track ] [ -P opt ] [ device ]
DESCRIPTION
cfdisk is a curses based program for partitioning any hard disk drive.
Typical values of the device argument are:
/dev/ad0 [default]
/dev/ad1
/dev/da0
/dev/da1
In order to write the partition table cfdisk needs something called the
`geometry' of the disk: the number of `heads' and the number of `sec-
tors per track'. Linux does not use any geometry, so if the disk will
not be accessed by other operating systems, you can safely accept the
defaults that cfdisk chooses for you. The geometry used by cfdisk is
found as follows. First the partition table is examined, to see what
geometry was used by the previous program that changed it. If the par-
tition table is empty, or contains garbage, or does not point at a con-
sistent geometry, the kernel is asked for advice. If nothing works 255
heads and 63 sectors/track is assumed. The geometry can be overridden
on the command line or by use of the `g' command. When partitioning an
empty large modern disk, picking 255 heads and 63 sectors/track is
always a good idea. There is no need to set the number of cylinders,
since cfdisk knows the disk size.
Next, cfdisk tries to read the current partition table from the disk
drive. If it is unable to figure out the partition table, an error is
displayed and the program will exit. This might also be caused by
incorrect geometry information, and can be overridden on the command
line. Another way around this problem is with the -z option. This
will ignore the partition table on the disk.
The main display is composed of four sections, from top to bottom: the
header, the partitions, the command line and a warning line. The
header contains the program name and version number followed by the
disk drive and its geometry. The partitions section always displays
the current partition table. The command line is the place where com-
mands and text are entered. The available commands are usually dis-
played in brackets. The warning line is usually empty except when
there is important information to be displayed. The current partition
is highlighted with reverse video (or an arrow if the -a option is
given). All partition specific commands apply to the current parti-
tion.
The format of the partition table in the partitions section is, from
left to right: Name, Flags, Partition Type, Filesystem Type and Size.
The name is the partition device name. The flags can be Boot, which
designates a bootable partition or NC, which stands for "Not Compatible
with DOS or OS/2". DOS, OS/2 and possibly other operating systems
mary partitions are used). When this is detected, the filesystem type
is displayed as Unusable. The size field displays the size of the par-
tition in megabytes (by default). It can also display the size in sec-
tors and cylinders (see the change units command below). If an aster-
isks (*) appears after the size, this means that the partition is not
aligned on cylinder boundaries.
DOS 6.x WARNING
The DOS 6.x FORMAT command looks for some information in the first sec-
tor of the data area of the partition, and treats this information as
more reliable than the information in the partition table. DOS FORMAT
expects DOS FDISK to clear the first 512 bytes of the data area of a
partition whenever a size change occurs. DOS FORMAT will look at this
extra information even if the /U flag is given -- we consider this a
bug in DOS FORMAT and DOS FDISK.
The bottom line is that if you use cfdisk or fdisk to change the size
of a DOS partition table entry, then you must also use dd to zero the
first 512 bytes of that partition before using DOS FORMAT to format the
partition. For example, if you were using cfdisk to make a DOS parti-
tion table entry for /dev/ad0s1, then (after exiting fdisk or cfdisk
and rebooting Linux so that the partition table information is valid)
you would use the command "dd if=/dev/zero of=/dev/ad0s1 bs=512
count=1" to zero the first 512 bytes of the partition. Note:
BE EXTREMELY CAREFUL if you use the dd command, since a small typo can
make all of the data on your disk useless.
For best results, you should always use an OS-specific partition table
program. For example, you should make DOS partitions with the DOS
FDISK program and Linux partitions with the Linux fdisk or Linux cfdisk
program.
COMMANDS
cfdisk commands can be entered by pressing the desired key (pressing
Enter after the command is not necessary). Here is a list of the
available commands:
b Toggle bootable flag of the current partition. This allows you
to select which primary partition is bootable on the drive.
d Delete the current partition. This will convert the current
partition into free space and merge it with any free space imme-
diately surrounding the current partition. A partition already
marked as free space or marked as unusable cannot be deleted.
g Change the disk geometry (cylinders, heads, or sectors-per-
track). WARNING: This option should only be used by people who
know what they are doing. A command line option is also avail-
able to change the disk geometry. While at the change disk
geometry command line, you can choose to change cylinders (c),
h Print the help screen.
m Maximize disk usage of the current partition. This command will
recover the the unused space between the partition table and the
beginning of the partition, but at the cost of making the parti-
tion incompatible with DOS, OS/2 and possibly other operating
systems. This option will toggle between maximal disk usage and
DOS, OS/2, etc. compatible disk usage. The default when creat-
ing a partition is to create DOS, OS/2, etc. compatible parti-
tions.
n Create new partition from free space. If the partition type is
Primary or Logical, a partition of that type will be created,
but if the partition type is Pri/Log, you will be prompted for
the type you want to create. Be aware that (1) there are only
four slots available for primary partitions and (2) since there
can be only one extended partition, which contains all of the
logical drives, all of the logical drives must be contiguous
(with no intervening primary partition). cfdisk next prompts
you for the size of the partition you want to create. The
default size, equal to the entire free space of the current par-
tition, is display in megabytes. You can either press the Enter
key to accept the default size or enter a different size at the
prompt. cfdisk accepts size entries in megabytes (M) [default],
kilobytes (K), cylinders (C) and sectors (S) by entering the
number immediately followed by one of (M, K, C or S). If the
partition fills the free space available, the partition is cre-
ated and you are returned to the main command line. Otherwise,
the partition can be created at the beginning or the end of the
free space, and cfdisk will ask you to choose where to place the
partition. After the partition is created, cfdisk automatically
adjusts the other partition's partition types if all of the pri-
mary partitions are used.
p Print the partition table to the screen or to a file. There are
several different formats for the partition that you can choose
from:
r Raw data format (exactly what would be written to disk)
s Partition table in sector order format
t Partition table in raw format
The raw data format will print the sectors that would be written
to disk if a write command is selected. First, the primary par-
tition table is printed, followed by the partition tables asso-
ciated with each logical partition. The data is printed in hex
byte by byte with 16 bytes per line.
The partition table in sector order format will print the parti-
by an operating system that either does not align partitions to
cylinder boundaries or that used different disk geometry infor-
mation. If you know the disk geometry of the other operating
system, you could enter the geometry information with the change
geometry command (g).
For the first partition on the disk and for all logical parti-
tions, if the offset from the beginning of the partition is not
equal to the number of sectors per track (i.e., the data does
not start on the first head), a number sign (#) is printed after
the offset. For the remaining partitions, if the offset is not
zero, a number sign will be printed after the offset. This cor-
responds to the NC flag in the partitions section of the main
display.
The partition table in raw format will print the partition table
ordered by partition number. It will leave out all free and
unusable space. The fields, from left to right, are the number
of the partition, the flags (in hex), the starting head, sector
and cylinder, the filesystem ID (in hex), the ending head, sec-
tor and cylinder, the starting sector in the partition and the
number of sectors in the partition. The information in this ta-
ble can be directly translated to the raw data format.
The partition table entries only have 10 bits available to rep-
resent the starting and ending cylinders. Thus, when the abso-
lute starting (ending) sector number is on a cylinder greater
than 1023, the maximal values for starting (ending) head, sector
and cylinder are printed. This is the method used by OS/2, and
thus fixes the problems associated with OS/2's fdisk rewriting
the partition table when it is not in this format. Since Linux
and OS/2 use absolute sector counts, the values in the starting
and ending head, sector and cylinder are not used.
q Quit program. This will exit the program without writing any
data to disk.
t Change the filesystem type. By default, new partitions are cre-
ated as Linux partitions, but since cfdisk can create partitions
for other operating systems, change partition type allows you to
enter the hex value of the filesystem you desire. A list of the
know filesystem types is displayed. You can type in the
filesystem type at the prompt or accept the default filesystem
type [Linux].
u Change units of the partition size display. It will rotate
through megabytes, sectors and cylinders.
W Write partition table to disk (must enter an upper case W).
Since this might destroy data on the disk, you must either con-
firm or deny the write by entering `yes' or `no'. If you enter
`yes', cfdisk will write the partition table to disk and the
CTRL-L Redraws the screen. In case something goes wrong and you cannot
read anything, you can refresh the screen from the main command
line.
? Print the help screen.
All of the commands can be entered with either upper or lower case let-
ters (except for Writes). When in a sub-menu or at a prompt to enter a
filename, you can hit the ESC key to return to the main command line.
OPTIONS
-a Use an arrow cursor instead of reverse video for highlighting
the current partition.
-g Do not use the geometry given by the disk driver, but try to
guess a geometry from the partition table.
-v Print the version number and copyright.
-z Start with zeroed partition table. This option is useful when
you want to repartition your entire disk. Note: this option
does not zero the partition table on the disk; rather, it simply
starts the program without reading the existing partition table.
-c cylinders
-h heads
-s sectors-per-track
Override the number of cylinders, heads and sectors per track
read from the BIOS. If your BIOS or adapter does not supply
this information or if it supplies incorrect information, use
these options to set the disk geometry values.
-P opt Prints the partition table in specified formats. opt can be one
or more of "r", "s" or "t". See the print command (above) for
more information on the print formats.
EXIT STATUS
0: No errors; 1: Invocation error; 2: I/O error; 3: cannot get geome-
try; 4: bad partition table on disk.
SEE ALSO
fdisk-linux(8), newfs(8), fdisk(8), sfdisk-linux(8)
BUGS
The current version does not support multiple disks.
AUTHOR
Kevin E. Martin (martin@cs.unc.edu)
Man(1) output converted with
man2html