1PARTED(8)                      GNU Parted Manual                     PARTED(8)
2
3
4

NAME

6       GNU Parted - a partition manipulation program
7

SYNOPSIS

9       parted [options] [device [command [options...]...]]
10

DESCRIPTION

12       parted  is  a  disk  partitioning  and  partition resizing program.  It
13       allows you to create, destroy, resize, move and copy ext2,  linux-swap,
14       FAT,  FAT32,  and reiserfs partitions.  It can create, resize, and move
15       Macintosh HFS partitions, as well as detect jfs,  ntfs,  ufs,  and  xfs
16       partitions.  It is useful for creating space for new operating systems,
17       reorganising disk usage, and copying data to new hard disks.
18
19       This manual page documents parted briefly.  Complete  documentation  is
20       distributed with the package in GNU Info format; see near the bottom.
21

OPTIONS

23       -h, --help
24              displays a help message
25
26       -l, --list
27              lists partition layout on all block devices
28
29       -m, --machine
30              displays machine parseable output
31
32       -s, --script
33              never prompts for user intervention
34
35       -v, --version
36              displays the version
37
38       -a alignment-type, --align alignment-type
39              Set  alignment  for  newly  created  partitions, valid alignment
40              types are:
41
42              none   Use the minimum alignment allowed by the disk type.
43
44              cylinder
45                     Align partitions to cylinders.
46
47              minimal
48                     Use minimum alignment  as  given  by  the  disk  topology
49                     information.  This  and  the  opt  value  will use layout
50                     information provided by the disk  to  align  the  logical
51                     partition  table  addresses  to actual physical blocks on
52                     the disks.  The min value is the minimum aligment  needed
53                     to align the partition properly to physical blocks, which
54                     avoids performance degradation.
55
56              optimal
57                     Use optimum alignment  as  given  by  the  disk  topology
58                     information.  This  aligns  to a multiple of the physical
59                     block size in a way that guarantees optimal performance.
60
61

COMMANDS

63       [device]
64              The block device to be used.  When none is  given,  parted  will
65              use the first block device it finds.
66
67       [command [options]]
68              Specifies  the  command to be executed.  If no command is given,
69              parted will present a command prompt.  Possible commands are:
70
71              check partition
72                     Do a simple check on partition.
73
74              cp [source-device] source dest
75                     Copy the source partition's filesystem  on  source-device
76                     (or  the current device if no other device was specified)
77                     to the dest partition on the current device.
78
79              help [command]
80                     Print general help, or help on command if specified.
81
82              mkfs partition fs-type
83                     Make a filesystem fs-type on partition.  fs-type  can  be
84                     one  of "fat16", "fat32", "ext2", "linux-swap", or "reis‐
85                     erfs".
86
87              mklabel label-type
88                     Create a new disklabel (partition table)  of  label-type.
89                     label-type  should be one of "bsd", "dvh", "gpt", "loop",
90                     "mac", "msdos", "pc98", or "sun".
91
92              mkpart part-type [fs-type] start end
93                     Make a part-type partition with  filesystem  fs-type  (if
94                     specified),  beginning  at  start  and  ending at end (by
95                     default in megabytes).  fs-type can be  one  of  "fat16",
96                     "fat32", "ext2", "HFS", "linux-swap", "NTFS", "reiserfs",
97                     or "ufs".  part-type should be one of  "primary",  "logi‐
98                     cal", or "extended".
99
100              mkpartfs part-type fs-type start end
101                     Make a part-type partition with filesystem fs-type begin‐
102                     ning  at  start  and  ending  at  end  (by   default   in
103                     megabytes).   Using this command is discouraged.  Instead
104                     use mkpart to create an empty  partition,  and  then  use
105                     external tools like mke2fs(8) to create the filesystem.
106
107              move partition start end
108                     Move  partition  so  that  it begins at start and ends at
109                     end.  Note: move never changes the minor number.
110
111              name partition name
112                     Set the name of partition to name. This option works only
113                     on  Mac, PC98, and GPT disklabels. The name can be placed
114                     in quotes, if necessary.
115
116              print  Display the partition table.
117
118              quit   Exit from parted.
119
120              rescue start end
121                     Rescue  a  lost  partition  that  was  located  somewhere
122                     between  start  and end.  If a partition is found, parted
123                     will ask if you want to create an entry  for  it  in  the
124                     partition table.
125
126              resize partition start end
127                     Resize  the  filesystem on partition so that it begins at
128                     start and ends at end (by default in megabytes).
129
130              rm partition
131                     Delete partition.
132
133              select device
134                     Choose device as  the  current  device  to  edit.  device
135                     should usually be a Linux hard disk device, but it can be
136                     a partition, software raid device, or an LVM logical vol‐
137                     ume if necessary.
138
139              set partition flag state
140                     Change the state of the flag on partition to state.  Sup‐
141                     ported  flags  are:  "boot",  "root",  "swap",  "hidden",
142                     "raid", "lvm", "lba", and "palo".  state should be either
143                     "on" or "off".
144
145              unit unit
146                     Set unit as the unit to use when displaying locations and
147                     sizes,  and for interpreting those given by the user when
148                     not suffixed with an explicit unit.  unit can be  one  of
149                     "s"  (sectors),  "B" (bytes), "kB", "MB", "GB", "TB", "%"
150                     (percentage of device  size),  "cyl"  (cylinders),  "chs"
151                     (cylinders,  heads, sectors), or "compact" (megabytes for
152                     input, and a human-friendly form for output).
153
154              version
155                     Display version information and a copyright message.
156

KNOWN ISSUES

158       ext3 filesystem functionality does not currently work.  To manage  ext3
159       type  filesystems  use tools like resize2fs(8) or mke2fs(8).  Note that
160       the currently supported ext2 filesystem will be  deprecated  once  ext3
161       support is finalized.  Further note that ext3 support will have limited
162       functionality that is yet to be defined.  Use tools  like  resize2fs(8)
163       and mke2fs(8) to manage these types of filesystems.
164
165       To   manually   resize  an  ext3  filesystem  and/or  a  partition  use
166       resize2fs(8), fdisk(8) or similar tools.  For LVM situations, you  will
167       need to use the LVM commands to resize the LVM elements.
168

REPORTING BUGS

170       Report bugs to <bug-parted@gnu.org>
171

SEE ALSO

173       fdisk(8),  mkfs(8),  The  parted  program  is  fully  documented in the
174       info(1) format GNU partitioning software manual.
175

AUTHOR

177       This manual page was written by Timshel Knoll <timshel@debian.org>, for
178       the Debian GNU/Linux system (but may be used by others).
179
180
181
182parted                           2007 March 29                       PARTED(8)
Impressum