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

KNOWN ISSUES

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

REPORTING BUGS

175       Report bugs to <bug-parted@gnu.org>
176

SEE ALSO

178       fdisk(8),  mkfs(8),  The  parted  program  is  fully  documented in the
179       info(1) format GNU partitioning software manual.
180

AUTHOR

182       This manual page was written by Timshel Knoll <timshel@debian.org>, for
183       the Debian GNU/Linux system (but may be used by others).
184
185
186
187parted                           2007 March 29                       PARTED(8)
Impressum