parted — a partition manipulation program

Synopsis

parted [options] [device [command [options...]...]]

Description

parted is a program to manipulate disk partitions.  It supports multiple partition table formats, including MS-DOS and GPT.  It is useful for creating space for new operating systems, reorganising disk usage, and copying data to new hard disks.

This manual page documents parted briefly.  Complete documentation is distributed with the package in GNU Info format.

Options

-h, --help

displays a help message

-l, --list

lists partition layout on all block devices

-m, --machine

displays machine parseable output

-s, --script

never prompts for user intervention

-v, --version

displays the version

-a alignment-type, --align alignment-type

Set alignment for newly created partitions, valid alignment types are:

none

Use the minimum alignment allowed by the disk type.

cylinder

Align partitions to cylinders.

minimal

Use minimum alignment as given by the disk topology information. This and the opt value will use layout information provided by the disk to align the logical partition table addresses to actual physical blocks on the disks. The min value is the minimum alignment needed to align the partition properly to physical blocks, which avoids performance degradation.

optimal

Use optimum alignment as given by the disk topology information. This aligns to a multiple of the physical block size in a way that guarantees optimal performance.

Commands

[device]

The block device to be used.  When none is given, parted will use the first block device it finds.

[command [options]]

Specifies the command to be executed.  If no command is given, parted will present a command prompt.  Possible commands are:

help [command]

Print general help, or help on command if specified.

align-check type partition

Check if partition satisfies the alignment constraint of type. type must be "minimal" or "optimal".

mklabel label-type

Create a new disklabel (partition table) of label-type.  label-type should be one of "aix", "amiga", "bsd", "dvh", "gpt", "loop", "mac", "msdos", "pc98", or "sun".

mkpart [part-type name fs-type] start end

Create a new partition. part-type may be specified only with msdos and dvh partition tables, it should be one of "primary", "logical", or "extended". name is required for GPT partition tables and fs-type is optional. fs-type can be one of "btrfs", "ext2", "ext3", "ext4", "fat16", "fat32", "hfs", "hfs+", "linux-swap", "ntfs", "reiserfs", "udf", or "xfs".

name partition name

Set the name of partition to name. This option works only on Mac, PC98, and GPT disklabels. The name can be placed in double quotes, if necessary. And depending on the shell may need to also be wrapped in single quotes so that the shell doesn't strip off the double quotes.

print

Display the partition table.

quit

Exit from parted.

rescue start end

Rescue a lost partition that was located somewhere between start and end.  If a partition is found, parted will ask if you want to create an entry for it in the partition table.

resizepart partition end

Change the end position of partition.  Note that this does not modify any filesystem present in the partition.

rm partition

Delete partition.

select device

Choose device as the current device to edit. device should usually be a Linux hard disk device, but it can be a partition, software raid device, or an LVM logical volume if necessary.

set partition flag state

Change the state of the flag on partition to state. Supported flags are: "boot", "root", "swap", "hidden", "raid", "lvm", "lba", "legacy_boot", "irst", "msftres", "esp" and "palo". state should be either "on" or "off".

unit unit

Set unit as the unit to use when displaying locations and sizes, and for interpreting those given by the user when not suffixed with an explicit unit. unit can be one of "s" (sectors), "B" (bytes), "kB", "MB", "MiB", "GB", "GiB", "TB", "TiB", "%" (percentage of device size), "cyl" (cylinders), "chs" (cylinders, heads, sectors), or "compact" (megabytes for input, and a human-friendly form for output).

toggle partition flag

Toggle the state of flag on partition.

version

Display version information and a copyright message.

Reporting Bugs

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

See Also

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

Author

This manual page was written by Timshel Knoll <timshel@debian.org>, for the Debian GNU/Linux system (but may be used by others).

Referenced By

addpart(8), btrfs-filesystem(8), cfdisk(8), cgdisk(8), ddpt(8), delpart(8), fixparts(8), gdisk(8), gparted(8), guestfs(3), nbdkit-partition-filter(1), ntfsresize(8), partprobe(8), partx(8), resizepart(8), salt(7), sfdisk(8), sgdisk(8), virt-alignment-scan(1), virt-rescue(1), virt-resize(1).

2007 March 29 GNU Parted Manual