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

NAME

6       parted - a partition manipulation program
7

SYNOPSIS

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

DESCRIPTION

12       parted  is a program to manipulate disk partitions.  It supports multi‐
13       ple partition table formats, including MS-DOS and GPT.   It  is  useful
14       for  creating space for new operating systems, reorganising disk usage,
15       and copying data to new hard disks.
16
17       This manual page documents parted briefly.  Complete  documentation  is
18       distributed with the package in GNU Info format.
19

OPTIONS

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

COMMANDS

64       [device]
65              The block device to be used.  When none is  given,  parted  will
66              use the first block device it finds.
67
68       [command [options]]
69              Specifies  the  command to be executed.  If no command is given,
70              parted will present a command prompt.  Possible commands are:
71
72              help [command]
73                     Print general help, or help on command if specified.
74
75              align-check type partition
76                     Check if partition satisfies the alignment constraint  of
77                     type.  type must be "minimal" or "optimal".
78
79              mklabel label-type
80                     Create  a  new disklabel (partition table) of label-type.
81                     label-type should be one of "aix", "amiga", "bsd", "dvh",
82                     "gpt", "loop", "mac", "msdos", "pc98", or "sun".
83
84              mkpart [part-type name fs-type] start end
85                     Create  a  new partition. part-type may be specified only
86                     with msdos and dvh partition tables, it should be one  of
87                     "primary",  "logical",  or  "extended".  name is required
88                     for GPT partition tables and fs-type  is  optional.   fs-
89                     type  can  be  one  of  "btrfs",  "ext2", "ext3", "ext4",
90                     "fat16", "fat32", "hfs",  "hfs+",  "linux-swap",  "ntfs",
91                     "reiserfs", "udf", or "xfs".
92
93              name partition name
94                     Set the name of partition to name. This option works only
95                     on Mac, PC98, and GPT disklabels. The name can be  placed
96                     in  double  quotes,  if  necessary.  And depending on the
97                     shell may need to also be wrapped  in  single  quotes  so
98                     that the shell doesn't strip off the double quotes.
99
100              print  Display the partition table.
101
102              quit   Exit from parted.
103
104              rescue start end
105                     Rescue  a  lost  partition that was located somewhere be‐
106                     tween start and end.  If a  partition  is  found,  parted
107                     will  ask  if  you  want to create an entry for it in the
108                     partition table.
109
110              resizepart partition end
111                     Change the end position of  partition.   Note  that  this
112                     does not modify any filesystem present in the partition.
113
114              rm partition
115                     Delete partition.
116
117              select device
118                     Choose  device  as  the  current  device  to edit. device
119                     should usually be a Linux hard disk device, but it can be
120                     a partition, software raid device, or an LVM logical vol‐
121                     ume if necessary.
122
123              set partition flag state
124                     Change the state of the flag on partition to state.  Sup‐
125                     ported  flags  are:  "boot",  "root",  "swap",  "hidden",
126                     "raid", "lvm", "lba", "legacy_boot",  "irst",  "msftres",
127                     "esp",  "chromeos_kernel",  "bls_boot" and "palo".  state
128                     should be either "on" or "off".
129
130              unit unit
131                     Set unit as the unit to use when displaying locations and
132                     sizes,  and for interpreting those given by the user when
133                     not suffixed with an explicit unit.  unit can be  one  of
134                     "s"  (sectors),  "B"  (bytes),  "kB",  "MB", "MiB", "GB",
135                     "GiB", "TB", "TiB",  "%"  (percentage  of  device  size),
136                     "cyl"  (cylinders), "chs" (cylinders, heads, sectors), or
137                     "compact" (megabytes for input, and a human-friendly form
138                     for output).
139
140              toggle partition flag
141                     Toggle the state of flag on partition.
142
143              version
144                     Display version information and a copyright message.
145

REPORTING BUGS

147       Report bugs to <bug-parted@gnu.org>
148

SEE ALSO

150       fdisk(8),  mkfs(8),  The  parted  program  is  fully  documented in the
151       info(1) format GNU partitioning software manual.
152

AUTHOR

154       This manual page was written by Timshel Knoll <timshel@debian.org>, for
155       the Debian GNU/Linux system (but may be used by others).
156
157
158
159parted                           2007 March 29                       PARTED(8)
Impressum