usr/src/man/man1m/parted.1m

   1 '\" te
   2 .\" Portions Copyright (c) 2009, Sun Microsystems, Inc. All Rights Reserved
   3 .\" Copyright (C) 1999, 2000, 2007 Free Software Foundation, Inc.
   4 .\" This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.  This program is distributed
   5 .\" in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.  You should have received a copy of the GNU General Public License along with this program.
   6 .\" If not, see: http://www.gnu.org/copyleft/gpl.html
   7 .TH PARTED 1M "May 27, 2009"
   8 .SH NAME
   9 parted \- partition manipulation program
  10 .SH SYNOPSIS
  11 .LP
  12 .nf
  13 \fBparted\fR [\fIoptions\fR] [\fIdevice\fR [\fIoptions\fR...]...]]
  14 .fi
  15
  16 .SH DESCRIPTION
  17 .sp
  18 .LP
  19 \fBparted\fR is a disk partitioning and partition resizing  program. It allows
  20 you to create, destroy, resize, move, and copy \fBext2\fR, \fBext3\fR,
  21 \fBlinux-swap\fR, \fBFAT\fR, \fBFAT32\fR, and \fBreiserfs\fR  partitions. It
  22 can create, resize, and move Macintosh HFS  partitions, as well as detect
  23 \fBjfs\fR, \fBntfs\fR, \fBufs\fR, and \fBxfs\fR partitions. It is useful for
  24 creating space for new operating systems, reorganizing disk usage, and copying
  25 data to new hard disks.
  26 .sp
  27 .LP
  28 This manual page documents \fBparted\fR briefly. Complete  \fBparted\fR
  29 documentation is distributed with the package in "GNU Info"  format.
  30 .sp
  31 .LP
  32 \fBparted\fR is implemented with a set of top-level options and a set of
  33 subcommands, most of which have their own options and operands. These
  34 subcommands are described below. \fBparted\fR has an optional operand:
  35 .sp
  36 .ne 2
  37 .na
  38 \fB\fIdevice\fR\fR
  39 .ad
  40 .RS 10n
  41 The block device to be used. When none is given, \fBparted\fR uses the first
  42 block device it finds.
  43 .RE
  44
  45 .SH OPTIONS
  46 .sp
  47 .LP
  48 The following options are supported:
  49 .sp
  50 .ne 2
  51 .na
  52 \fB\fB-h\fR, \fB--help\fR\fR
  53 .ad
  54 .sp .6
  55 .RS 4n
  56 Displays a help message.
  57 .RE
  58
  59 .sp
  60 .ne 2
  61 .na
  62 \fB\fB-i\fR, \fB--interactive\fR\fR
  63 .ad
  64 .sp .6
  65 .RS 4n
  66 Prompts for user intervention.
  67 .RE
  68
  69 .sp
  70 .ne 2
  71 .na
  72 \fB\fB-l\fR, \fB--list\fR\fR
  73 .ad
  74 .sp .6
  75 .RS 4n
  76 Lists partition layout on all block devices.
  77 .RE
  78
  79 .sp
  80 .ne 2
  81 .na
  82 \fB\fB-m\fR, \fB--machine\fR\fR
  83 .ad
  84 .sp .6
  85 .RS 4n
  86 Displays machine-parseable output.
  87 .RE
  88
  89 .sp
  90 .ne 2
  91 .na
  92 \fB\fB-s\fR, \fB--script\fR\fR
  93 .ad
  94 .sp .6
  95 .RS 4n
  96 Never prompts for user intervention.
  97 .RE
  98
  99 .sp
 100 .ne 2
 101 .na
 102 \fB\fB-v\fR, \fB--version\fR\fR
 103 .ad
 104 .sp .6
 105 .RS 4n
 106 Displays the version number.
 107 .RE
 108
 109 .SH SUB-COMMANDS
 110 .sp
 111 .LP
 112 If you omit a subcommand in a \fBparted\fR command line, the utility issues a
 113 command prompt.
 114 .sp
 115 .ne 2
 116 .na
 117 \fB\fBcheck\fR \fIpartition\fR\fR
 118 .ad
 119 .sp .6
 120 .RS 4n
 121 Do a simple check on \fIpartition\fR.
 122 .RE
 123
 124 .sp
 125 .ne 2
 126 .na
 127 \fB\fBcp\fR [\fIsource-device\fR] \fIsource\fR \fIdest\fR\fR
 128 .ad
 129 .sp .6
 130 .RS 4n
 131 Copy the source partition's filesystem on \fIsource-device\fR (or the current
 132 device if no other device was specified) to the \fIdest\fR partition on the
 133 current device.
 134 .RE
 135
 136 .sp
 137 .ne 2
 138 .na
 139 \fB\fBhelp\fR \fIcommand\fR\fR
 140 .ad
 141 .sp .6
 142 .RS 4n
 143 Display general help, or help on a command, if specified.
 144 .RE
 145
 146 .sp
 147 .ne 2
 148 .na
 149 \fB\fBmkfs\fR \fIpartition\fR \fIfs-type\fR\fR
 150 .ad
 151 .sp .6
 152 .RS 4n
 153 Make a filesystem \fIfs-type\fR on partition. \fIfs-type\fR can be one of
 154 \fBfat16\fR, \fBfat32\fR, \fBext2\fR, \fBlinux-wap\fR, or \fBreiserfs\fR.
 155 .RE
 156
 157 .sp
 158 .ne 2
 159 .na
 160 \fB\fBmklabel\fR \fIlabel-type\fR\fR
 161 .ad
 162 .sp .6
 163 .RS 4n
 164 Create a new disk label (partition table) of \fIlabel-type\fR. \fIlabel-type\fR
 165 should be one of \fBbsd\fR, \fBdvh\fR, \fBgpt\fR, \fBloop\fR, \fBmac\fR,
 166 \fBmsdos\fR, \fBpc98\fR, or \fBsun\fR.
 167 .RE
 168
 169 .sp
 170 .ne 2
 171 .na
 172 \fB\fBmkpart\fR \fIpart-type\fR [\fIfs-type\fR] \fIstart\fR \fIend\fR\fR
 173 .ad
 174 .sp .6
 175 .RS 4n
 176 Make a \fIpart-type\fR partition with file system \fIfs-type\fR (if specified),
 177 beginning at \fIstart\fR and ending at \fIend\fR (by default, in megabytes).
 178 \fIfs-type\fR can be one of \fBfat16\fR, \fBfat32\fR, \fBext2\fR, \fBHFS\fR,
 179 \fBlinux-swap\fR, \fBNTFS\fR, \fBreiserfs\fR, or \fBufs\fR. \fIpart-type\fR
 180 should be one of \fBprimary\fR, \fBlogical\fR, or \fBextended\fR.
 181 .RE
 182
 183 .sp
 184 .ne 2
 185 .na
 186 \fB\fBmkpartfs\fR \fIpart-type\fR \fIfs-type\fR \fIstart\fR \fIend\fR\fR
 187 .ad
 188 .sp .6
 189 .RS 4n
 190 Make a \fIpart-type\fR partition with file system \fIfs-type\fR, beginning at
 191 \fIstart\fR and ending at \fIend\fR (by default, in megabytes).
 192 .RE
 193
 194 .sp
 195 .ne 2
 196 .na
 197 \fB\fBmove\fR \fIpartition\fR \fIstart\fR \fIend\fR\fR
 198 .ad
 199 .sp .6
 200 .RS 4n
 201 Move partition so that it begins at \fIstart\fR and ends at \fIend\fR. Note
 202 that \fBmove\fR never changes the minor number.
 203 .RE
 204
 205 .sp
 206 .ne 2
 207 .na
 208 \fB\fBname\fR \fIpartition\fR \fIname\fR\fR
 209 .ad
 210 .sp .6
 211 .RS 4n
 212 Set the name of partition to \fIname\fR. This option works only on Mac, PC98,
 213 and GPT disk labels. The name can be placed in quotes, if necessary.
 214 .RE
 215
 216 .sp
 217 .ne 2
 218 .na
 219 \fB\fBprint\fR\fR
 220 .ad
 221 .sp .6
 222 .RS 4n
 223 Display the partition table.
 224 .RE
 225
 226 .sp
 227 .ne 2
 228 .na
 229 \fB\fBquit\fR\fR
 230 .ad
 231 .sp .6
 232 .RS 4n
 233 Exit from \fBparted\fR.
 234 .RE
 235
 236 .sp
 237 .ne 2
 238 .na
 239 \fB\fBrescue\fR \fIstart\fR \fIend\fR\fR
 240 .ad
 241 .sp .6
 242 .RS 4n
 243 Rescue a lost partition that was located somewhere between \fIstart\fR and
 244 \fIend\fR. If a partition is found, \fBparted\fR will ask if you want to create
 245 an entry for it in the partition table.
 246 .RE
 247
 248 .sp
 249 .ne 2
 250 .na
 251 \fB\fBresize\fR \fIpartition\fR \fIstart\fR \fIend\fR\fR
 252 .ad
 253 .sp .6
 254 .RS 4n
 255 Resize the file system on \fIpartition\fR so that it begins at \fIstart\fR and
 256 ends at \fIend\fR (by default, in megabytes).
 257 .RE
 258
 259 .sp
 260 .ne 2
 261 .na
 262 \fB\fBrm\fR \fIpartition\fR\fR
 263 .ad
 264 .sp .6
 265 .RS 4n
 266 Delete \fIpartition\fR.
 267 .RE
 268
 269 .sp
 270 .ne 2
 271 .na
 272 \fB\fBselect\fR \fIdevice\fR\fR
 273 .ad
 274 .sp .6
 275 .RS 4n
 276 Choose \fIdevice\fR as the current device to edit.  \fIdevice\fR should usually
 277 be a Solaris or Linux hard disk device, but it can be a partition, software
 278 raid device, or an SVM or LVM logical volume if necessary.
 279 .RE
 280
 281 .sp
 282 .ne 2
 283 .na
 284 \fB\fBset\fR \fIpartition\fR \fIflag\fR \fIstate\fR\fR
 285 .ad
 286 .sp .6
 287 .RS 4n
 288 Change the state of the \fIflag\fR on \fIpartition\fR to \fIstate\fR. Supported
 289 flags are: \fBboot\fR, \fBroot\fR, \fBswap\fR, \fBhidden\fR, \fBraid\fR,
 290 \fBlvm\fR, \fBlba\fR, and \fBpalo\fR. \fIstate\fR should be either \fBon\fR or
 291 \fBoff\fR.
 292 .RE
 293
 294 .sp
 295 .ne 2
 296 .na
 297 \fB\fBunit\fR \fIunit\fR\fR
 298 .ad
 299 .sp .6
 300 .RS 4n
 301 Set \fIunit\fR as the unit to use when displaying locations and sizes, and for
 302 interpreting those given by the user when not suffixed with an explicit unit.
 303 \fIunit\fR can be one of \fBs\fR (sectors), \fBB\fR (bytes), \fBkB\fR,
 304 \fBMB\fR, \fBGB\fR, \fBTB\fR, \fB%\fR (percentage of device size), \fBcyl\fR
 305 (cylinders), \fBchs\fR (cylinders, heads, sectors), or \fBcompact\fR (megabytes
 306 for input, and a human-friendly form for output).
 307 .RE
 308
 309 .sp
 310 .ne 2
 311 .na
 312 \fB\fBversion\fR\fR
 313 .ad
 314 .sp .6
 315 .RS 4n
 316 Display version information and a copyright message.
 317 .RE
 318
 319 .SH ATTRIBUTES
 320 .sp
 321 .LP
 322 See \fBattributes\fR(5) for descriptions of the following attributes:
 323 .sp
 324
 325 .sp
 326 .TS
 327 box;
 328 c | c
 329 l | l .
 330 ATTRIBUTE TYPE  ATTRIBUTE VALUE
 331 _
 332 Interface Stability     Uncommitted
 333 .TE
 334
 335 .SH SEE ALSO
 336 .sp
 337 .LP
 338 \fBfdisk\fR(1M), \fBmkfs\fR(1M), \fBattributes\fR(5)
 339 .sp
 340 .LP
 341 The \fBparted\fR program is fully documented in the \fBinfo(1)\fR format GNU
 342 partitioning software manual.
 343 .SH AUTHOR
 344 .sp
 345 .LP
 346 This manual page was written by Timshel Knoll for the Debian GNU/Linux system.
 347 It is here adapted for the Solaris operating system.