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       -v, --version
34              displays the version
35
36       -a alignment-type, --align alignment-type
37              Set  alignment  for  newly  created  partitions, valid alignment
38              types are:
39
40              none   Use the minimum alignment allowed by the disk type.
41
42              cylinder
43                     Align partitions to cylinders.
44
45              minimal
46                     Use minimum alignment  as  given  by  the  disk  topology
47                     information.  This  and  the  opt  value  will use layout
48                     information provided by the disk  to  align  the  logical
49                     partition  table  addresses  to actual physical blocks on
50                     the disks.  The min value is the minimum alignment needed
51                     to align the partition properly to physical blocks, which
52                     avoids performance degradation.
53
54              optimal
55                     Use optimum alignment  as  given  by  the  disk  topology
56                     information.  This  aligns  to a multiple of the physical
57                     block size in a way that guarantees optimal performance.
58
59

COMMANDS

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

REPORTING BUGS

144       Report bugs to <bug-parted@gnu.org>
145

SEE ALSO

147       fdisk(8),  mkfs(8),  The  parted  program  is  fully  documented in the
148       info(1) format GNU partitioning software manual.
149

AUTHOR

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