usr.sbin/diskpart/diskpart.8

   1 .\" Copyright (c) 1983, 1991, 1993
   2 .\"     The Regents of the University of California.  All rights reserved.
   3 .\"
   4 .\" Redistribution and use in source and binary forms, with or without
   5 .\" modification, are permitted provided that the following conditions
   6 .\" are met:
   7 .\" 1. Redistributions of source code must retain the above copyright
   8 .\"    notice, this list of conditions and the following disclaimer.
   9 .\" 2. Redistributions in binary form must reproduce the above copyright
  10 .\"    notice, this list of conditions and the following disclaimer in the
  11 .\"    documentation and/or other materials provided with the distribution.
  12 .\" 3. All advertising materials mentioning features or use of this software
  13 .\"    must display the following acknowledgement:
  14 .\"     This product includes software developed by the University of
  15 .\"     California, Berkeley and its contributors.
  16 .\" 4. Neither the name of the University nor the names of its contributors
  17 .\"    may be used to endorse or promote products derived from this software
  18 .\"    without specific prior written permission.
  19 .\"
  20 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  21 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  22 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  23 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  24 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  25 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  26 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  27 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  28 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  29 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  30 .\" SUCH DAMAGE.
  31 .\"
  32 .\"     @(#)diskpart.8  8.1 (Berkeley) 6/6/93
  33 .\" $FreeBSD: src/usr.sbin/diskpart/diskpart.8,v 1.5.2.3 2001/08/16 15:55:54 ru Exp $
  34 .\"
  35 .Dd June 6, 1993
  36 .Dt DISKPART 8
  37 .Os
  38 .Sh NAME
  39 .Nm diskpart
  40 .Nd calculate default disk partition sizes
  41 .Sh SYNOPSIS
  42 .Nm
  43 .Op Fl p
  44 .Op Fl d
  45 .Op Fl s Ar size
  46 .Ar disk-type
  47 .Sh DESCRIPTION
  48 .Nm Diskpart
  49 is used to calculate the disk partition sizes based on the
  50 default rules used at Berkeley.
  51 .Pp
  52 Available options and operands:
  53 .Bl -tag -width Fl
  54 .It Fl p
  55 Tables suitable for inclusion in a device driver
  56 are produced.
  57 .It Fl d
  58 An entry suitable for inclusion in the disk
  59 description file
  60 .Pa /etc/disktab
  61 is generated; for example,
  62 .Xr disktab 5 .
  63 .It Fl s Ar size
  64 The size of the disk may be limited to
  65 .Ar size
  66 with the
  67 .Fl s
  68 option.
  69 .El
  70 .Pp
  71 On disks that use bad-sector forwarding,
  72 space is normally left in the last partition on the disk
  73 for a bad sector forwarding table, although this space
  74 is not reflected in the tables produced.  The space reserved
  75 is one track for the replicated copies of the table and
  76 sufficient tracks to hold a pool of 126 sectors to which bad sectors
  77 are mapped.
  78 The
  79 .Fl s
  80 option is intended for other controllers which reserve some space at the end
  81 of the disk for bad-sector replacements or other control areas,
  82 even if not a multiple of cylinders.
  83 .Pp
  84 The disk partition sizes are based on the total amount of
  85 space on the disk as given in the table below (all values
  86 are supplied in units of sectors).  The
  87 .Ql c
  88 partition
  89 is, by convention, used to access the entire physical disk.
  90 The device driver tables include
  91 the space reserved for the bad sector forwarding table in the
  92 .Ql c
  93 partition;
  94 those used in the disktab and default formats exclude reserved tracks.
  95 In normal operation, either the
  96 .Ql g
  97 partition is used, or the
  98 .Ql d ,
  99 .Ql e ,
 100 and
 101 .Ql f
 102 partitions are used.  The
 103 .Ql g
 104 and
 105 .Ql f
 106 partitions
 107 are variable-sized, occupying whatever space remains after allocation
 108 of the fixed sized partitions.
 109 If the disk is smaller than 20 Megabytes, then
 110 .Nm
 111 aborts with the message
 112 .Dq Li disk too small, calculate by hand .
 113 .Bl -column Partition 20-60\ MB 61-205\ MB 206-355\ MB 356+\ MB
 114 Partition       20-60 MB        61-205 MB       206-355 MB      356+ MB
 115 a       15884   15884   15884   15884
 116 b       10032   33440   33440   66880
 117 d       15884   15884   15884   15884
 118 e       unused  55936   55936   307200
 119 h       unused  unused  291346  291346
 120 .El
 121 .Pp
 122 If an unknown disk type is specified,
 123 .Nm
 124 will prompt for the required disk geometry information.
 125 .Sh SEE ALSO
 126 .Xr disktab 5
 127 .Sh BUGS
 128 Most default partition sizes are based on historical artifacts
 129 (like the RP06), and may result in unsatisfactory layouts.
 130 .Pp
 131 When using the
 132 .Fl d
 133 flag, alternate disk names are not included
 134 in the output.
 135 .Sh HISTORY
 136 The
 137 .Nm
 138 command appeared in
 139 .Bx 4.2 .