macro and text revision (-mdoc version 3)

[unix-history] / usr / src / usr.sbin / diskpart / diskpart.8

.\" Copyright (c) 1983, 1991 Regents of the University of California.
.\" All rights reserved.
.\"
.\" %sccs.include.redist.man%
.\"
.\"     @(#)diskpart.8	6.6 (Berkeley) %G%
.\"
.Dd 
.Dt DISKPART 8
.Os BSD 4
.Sh NAME
.Nm diskpart
.Nd calculate default disk partition sizes
.Sh SYNOPSIS
.Nm diskpart
.Op Fl p
.Op Fl d
.Op Fl s Ar size
.Ar disk-type
.Sh DESCRIPTION
.Nm Diskpart
is used to calculate the disk partition sizes based on the
default rules used at Berkeley.
.Pp
Available options and operands:
.Bl -tag -width Fl
.It Fl p
Tables suitable for inclusion in a device driver
are produced.
.It Fl d
An entry suitable for inclusion in the disk
description file
.Pa /etc/disktab
is generated; for example,
.Xr disktab 5 .
.It Fl s Ar size
The size of the disk may be limited to
.Ar size
with the
.Fl s
option.
.El
.Pp
On disks that use
.Xr bad144 8
type of
bad-sector forwarding,
space is normally left in the last partition on the disk
for a bad sector forwarding table, although this space
is not reflected in the tables produced.  The space reserved
is one track for the replicated copies of the table and
sufficient tracks to hold a pool of 126 sectors to which bad sectors
are mapped.  For more information, see 
.Xr bad144 8 .
The
.Fl s
option is intended for other controllers which reserve some space at the end
of the disk for bad-sector replacements or other control areas,
even if not a multiple of cylinders.
.Pp
The disk partition sizes are based on the total amount of
space on the disk as given in the table below (all values
are supplied in units of sectors).  The
.Ql c
partition
is, by convention, used to access the entire physical disk.
The device driver tables include
the space reserved for the bad sector forwarding table in the
.Ql c
partition;
those used in the disktab and default formats exclude reserved tracks.
In normal operation, either the
.Ql g
partition is used, or the
.Ql d ,
.Ql e ,
and
.Ql f
partitions are used.  The
.Ql g
and
.Ql f
partitions
are variable-sized, occupying whatever space remains after allocation
of the fixed sized partitions.
If the disk is smaller than 20 Megabytes, then
.Nm diskpart
aborts with the message
.Dq Li disk too small, calculate by hand .
.Bl -column Partition 20-60\ MB 61-205\ MB 206-355\ MB 356+\ MB
Partition	20-60 MB	61-205 MB	206-355 MB	356+ MB
a	15884	15884	15884	15884
b	10032	33440	33440	66880
d	15884	15884	15884	15884
e	unused	55936	55936	307200
h	unused	unused	291346	291346
.El
.Pp
If an unknown disk type is specified, 
.Nm diskpart
will prompt for the required disk geometry information.
.Sh SEE ALSO
.Xr disktab 5 ,
.Xr bad144 8
.Sh BUGS
Most default partition sizes are based on historical artifacts
(like the RP06), and may result in unsatisfactory layouts.
.Pp
When using the
.Fl d
flag, alternate disk names are not included
in the output.
.Sh HISTORY
The
.Nm
command appeared in
.Bx 4.2 .