# PARTED - a partition manipulation program - man(8) - [phpMan] [_PARTED_(8)](https://www.chedong.com/phpMan.php/man/PARTED/8/markdown) GNU Parted Manual [_PARTED_(8)](https://www.chedong.com/phpMan.php/man/PARTED/8/markdown) ## NAME 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 for‐ mats, 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 ### -j, --json displays JSON output ### -s, --script never prompts for user intervention ### -f, --fix automatically answer "fix" to exceptions in script mode ### -v, --version displays the version ### -a _ 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 physi‐ cal 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 perfor‐ mance. ## COMMANDS ### [device] The block device to be used. When none is given, **parted **will use the first block de‐ vice 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 par‐ tition 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 depend‐ ing on the shell may need to also be wrapped in single quotes so that the shell doesn't strip off the double quotes. **print _**print-type_ Display the partition table. _print-type_ is optional, and can be one of de‐ vices, free, list, or all. **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", "chromeos_kernel", "bls_boot", "linux-home", "no_automount", "bios_grub", 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 inter‐ preting those given by the user when not suffixed with an explicit unit. _unit_ can be one of "s" (sectors), "B" (bytes), "kB", "MB", "KiB", "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_. **type _**partition_ _id_ **or _**uuid_ On MS-DOS set the type aka. partition id of _partition_ to _id_. The _id_ is a value between "0x01" and "0xff". On GPT the type-uuid of _partition_ to _uuid_. **disk_set _**flag_ _state_ Change a _flag_ on the disk to _state_. A flag can be either "on" or "off". Some or all of these flags will be available, depending on what disk label you are using. Supported flags are: "pmbr_boot" on GPT to enable the boot flag on the GPT's protective MBR partition. **disk_toggle _**flag_ Toggle the state of the disk _flag_. **version** Display version information and a copyright message. ## REPORTING BUGS Report bugs to <> ## SEE ALSO [**fdisk**(8)](https://www.chedong.com/phpMan.php/man/fdisk/8/markdown), [**mkfs**(8)](https://www.chedong.com/phpMan.php/man/mkfs/8/markdown), The _parted_ program is fully documented in the [**info(1)](https://www.chedong.com/phpMan.php/man/info/1/markdown) **format _GNU_ _parti‐_ _tioning_ _software_ manual which is distributed with the parted-doc Debian package. ## AUTHOR This manual page was written by Timshel Knoll <>, for the Debian GNU/Linux system (but may be used by others). parted 2021 September 28 [_PARTED_(8)](https://www.chedong.com/phpMan.php/man/PARTED/8/markdown)