mpartition.1

   1 .TH mpartition 1 "03Nov09" mtools-4.0.12
   2 .SH Name
   3 mpartition - partition an MSDOS hard disk
   4 '\" t
   5 .de TQ
   6 .br
   7 .ns
   8 .TP \\$1
   9 ..
  10
  11 .tr \(is'
  12 .tr \(if`
  13 .tr \(pd"
  14
  15 .SH Note\ of\ warning
  16 This manpage has been automatically generated from mtools's texinfo
  17 documentation, and may not be entirely accurate or complete.  See the
  18 end of this man page for details.
  19 .PP
  20 .SH Description
  21 .iX "p mpartition"
  22 .iX "c partitions (creating)"
  23 .iX "c Zip disks (partitioning them)"
  24 .iX "c Jaz disks (partitioning them)"
  25 .PP
  26 The \fR\&\f(CWmpartition\fR command is used to create MS-DOS filesystems as
  27 partitions.  This is intended to be used on non-Linux systems,
  28 i.e. systems where fdisk and easy access to Scsi devices are not
  29 available.  This command only works on drives whose partition variable
  30 is set.
  31 .PP
  32 .ft I
  33 .nf
  34 \&\fR\&\f(CWmpartition\fR \fR\&\f(CW-p\fR \fIdrive\fR
  35 \&\fR\&\f(CWmpartition\fR \fR\&\f(CW-r\fR \fIdrive\fR
  36 \&\fR\&\f(CWmpartition\fR \fR\&\f(CW-I\fR [\fR\&\f(CW-B\fR \fIbootSector\fR] \fIdrive\fR
  37 \&\fR\&\f(CWmpartition\fR \fR\&\f(CW-a\fR \fIdrive\fR
  38 \&\fR\&\f(CWmpartition\fR \fR\&\f(CW-d\fR \fIdrive\fR
  39 \&\fR\&\f(CWmpartition\fR \fR\&\f(CW-c\fR [\fR\&\f(CW-s\fR \fIsectors\fR] [\fR\&\f(CW-h\fR \fIheads\fR]
  40 [\fR\&\f(CW-t\fR \fIcylinders\fR] [\fR\&\f(CW-v\fR [\fR\&\f(CW-T\fR \fItype\fR] [\fR\&\f(CW-b\fR
  41 \&\fIbegin\fR] [\fR\&\f(CW-l\fR length] [\fR\&\f(CW-f\fR]
  42 \&\&
  43 .fi
  44 .ft R
  45
  46 .PP
  47 Mpartition supports the following operations:
  48 .TP
  49 \&\fR\&\f(CWp\fR\
  50 Prints a command line to recreate the partition for the drive.  Nothing
  51 is printed if the partition for the drive is not defined, or an
  52 inconsistency has been detected.  If verbose (\fR\&\f(CW-v\fR) is also set,
  53 prints the current partition table.
  54 .TP
  55 \&\fR\&\f(CWr\fR\
  56 Removes the partition described by \fIdrive\fR.
  57 .TP
  58 \&\fR\&\f(CWI\fR\
  59 Initializes the partition table, and removes all partitions.
  60 .TP
  61 \&\fR\&\f(CWc\fR\
  62 Creates the partition described by \fIdrive\fR.
  63 .TP
  64 \&\fR\&\f(CWa\fR\
  65 "Activates" the partition, i.e. makes it bootable.  Only one partition
  66 can be bootable at a time.
  67 .TP
  68 \&\fR\&\f(CWd\fR\
  69 "Desactivates" the partition, i.e. makes it unbootable.
  70 .PP
  71 If no operation is given, the current settings are printed.
  72 .PP
  73 For partition creations, the following options are available:
  74 .TP
  75 \&\fR\&\f(CWs\ \fIsectors\fR\&\f(CW\fR\
  76 The number of sectors per track of the partition (which is also the
  77 number of sectors per track for the whole drive).
  78 .TP
  79 \&\fR\&\f(CWh\ \fIheads\fR\&\f(CW\fR\
  80 The number of heads of the partition (which is also the number of heads
  81 for the whole drive).  By default, the geometry information (number of
  82 sectors and heads) is figured out from neighbouring partition table
  83 entries, or guessed from the size.
  84 .TP
  85 \&\fR\&\f(CWt\ \fIcylinders\fR\&\f(CW\fR\
  86 The number of cylinders of the partition (not the number of cylinders of
  87 the whole drive.
  88 .TP
  89 \&\fR\&\f(CWb\ \fIbegin\fR\&\f(CW\fR\
  90 The starting offset of the partition, expressed in sectors. If begin is
  91 not given, mpartition lets the partition begin at the start of the disk
  92 (partition number 1), or immediately after the end of the previous
  93 partition.
  94 .TP
  95 \&\fR\&\f(CWl\ \fIlength\fR\&\f(CW\fR\
  96 The size (length) of the partition, expressed in sectors.  If end is not
  97 given, mpartition figures out the size from the number of sectors, heads
  98 and cylinders.  If these are not given either, it gives the partition
  99 the biggest possible size, considering disk size and start of the next
 100 partition.
 101 .PP
 102 The following option is available for all operation which modify the
 103 partition table:
 104 .TP
 105 \&\fR\&\f(CWf\fR\
 106 Usually, before writing back any changes to the partition, mpartition
 107 performs certain consistenct checks, such as checking for overlaps and
 108 proper alignment of the partitions.  If any of these checks fails, the
 109 partition table is not changes.  The \fR\&\f(CW-f\fR allows you to override
 110 these safeguards.
 111 .PP
 112 The following options are available for all operations:
 113 .TP
 114 \&\fR\&\f(CWv\fR\
 115 Together with \fR\&\f(CW-p\fR prints the partition table as it is now (no
 116 change operation), or as it is after it is modified.
 117 .TP
 118 \&\fR\&\f(CWvv\fR\
 119 If the verbosity flag is given twice, mpartition will print out a
 120 hexdump of the partition table when reading it from and writing it to
 121 the device.
 122 .PP
 123 The following option is available for partition table initialization:
 124 .TP
 125 \&\fR\&\f(CWB\ \fIbootSector\fR\&\f(CW\fR\
 126 Reads the template master boot record from file \fIbootSector\fR.
 127 .PP
 128 .SH See\ Also
 129 Mtools' texinfo doc
 130 .SH Viewing\ the\ texi\ doc
 131 This manpage has been automatically generated from mtools's texinfo
 132 documentation. However, this process is only approximative, and some
 133 items, such as crossreferences, footnotes and indices are lost in this
 134 translation process.  Indeed, these items have no appropriate
 135 representation in the manpage format.  Moreover, not all information has
 136 been translated into the manpage version.  Thus I strongly advise you to
 137 use the original texinfo doc.  See the end of this manpage for
 138 instructions how to view the texinfo doc.
 139 .TP
 140 * \ \
 141 To generate a printable copy from the texinfo doc, run the following
 142 commands:
 143
 144 .nf
 145 .ft 3
 146 .in +0.3i
 147     ./configure; make dvi; dvips mtools.dvi
 148 .fi
 149 .in -0.3i
 150 .ft R
 151 .lp
 152
 153 \&\fR
 154 .TP
 155 * \ \
 156 To generate a html copy,  run:
 157
 158 .nf
 159 .ft 3
 160 .in +0.3i
 161     ./configure; make html
 162 .fi
 163 .in -0.3i
 164 .ft R
 165 .lp
 166
 167 \&\fRA premade html can be found at
 168 \&\fR\&\f(CW\(ifhttp://www.gnu.org/software/mtools/manual/mtools.html\(is\fR
 169 .TP
 170 * \ \
 171 To generate an info copy (browsable using emacs' info mode), run:
 172
 173 .nf
 174 .ft 3
 175 .in +0.3i
 176     ./configure; make info
 177 .fi
 178 .in -0.3i
 179 .ft R
 180 .lp
 181
 182 \&\fR
 183 .PP
 184 The texinfo doc looks most pretty when printed or as html.  Indeed, in
 185 the info version certain examples are difficult to read due to the
 186 quoting conventions used in info.
 187 .PP