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$
  34 .\"
  35 .Dd June 6, 1993
  36 .Dt DISKPART 8
  37 .Os BSD 4
  38 .Sh NAME
  39 .Nm diskpart
  40 .Nd calculate default disk partition sizes
  41 .Sh SYNOPSIS
  42 .Nm diskpart
  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
  72 .Xr bad144 8
  73 type of
  74 bad-sector forwarding,
  75 space is normally left in the last partition on the disk
  76 for a bad sector forwarding table, although this space
  77 is not reflected in the tables produced.  The space reserved
  78 is one track for the replicated copies of the table and
  79 sufficient tracks to hold a pool of 126 sectors to which bad sectors
  80 are mapped.  For more information, see
  81 .Xr bad144 8 .
  82 The
  83 .Fl s
  84 option is intended for other controllers which reserve some space at the end
  85 of the disk for bad-sector replacements or other control areas,
  86 even if not a multiple of cylinders.
  87 .Pp
  88 The disk partition sizes are based on the total amount of
  89 space on the disk as given in the table below (all values
  90 are supplied in units of sectors).  The
  91 .Ql c
  92 partition
  93 is, by convention, used to access the entire physical disk.
  94 The device driver tables include
  95 the space reserved for the bad sector forwarding table in the
  96 .Ql c
  97 partition;
  98 those used in the disktab and default formats exclude reserved tracks.
  99 In normal operation, either the
 100 .Ql g
 101 partition is used, or the
 102 .Ql d ,
 103 .Ql e ,
 104 and
 105 .Ql f
 106 partitions are used.  The
 107 .Ql g
 108 and
 109 .Ql f
 110 partitions
 111 are variable-sized, occupying whatever space remains after allocation
 112 of the fixed sized partitions.
 113 If the disk is smaller than 20 Megabytes, then
 114 .Nm
 115 aborts with the message
 116 .Dq Li disk too small, calculate by hand .
 117 .Bl -column Partition 20-60\ MB 61-205\ MB 206-355\ MB 356+\ MB
 118 Partition       20-60 MB        61-205 MB       206-355 MB      356+ MB
 119 a       15884   15884   15884   15884
 120 b       10032   33440   33440   66880
 121 d       15884   15884   15884   15884
 122 e       unused  55936   55936   307200
 123 h       unused  unused  291346  291346
 124 .El
 125 .Pp
 126 If an unknown disk type is specified,
 127 .Nm
 128 will prompt for the required disk geometry information.
 129 .Sh SEE ALSO
 130 .Xr disktab 5 ,
 131 .Xr bad144 8
 132 .Sh BUGS
 133 Most default partition sizes are based on historical artifacts
 134 (like the RP06), and may result in unsatisfactory layouts.
 135 .Pp
 136 When using the
 137 .Fl d
 138 flag, alternate disk names are not included
 139 in the output.
 140 .Sh HISTORY
 141 The
 142 .Nm
 143 command appeared in
 144 .Bx 4.2 .