# parted

## 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 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
    
           **-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** _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** _print-type_
                         Display the partition table.  _print-type_ is
                         optional, and can be one of devices, 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 interpreting 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 abel 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.
    


## UNITS



           **parted** will compute sensible ranges for the locations you specify
           when using units like "GB", "MB", etc. Use the sector unit "s" or
           IEC binary units like "GiB", "MiB", to specify exact locations.
           When you specify start or end values using IEC binary units like
           "MiB", "GiB", "TiB", etc., **parted** treats those values as exact,
           and equivalent to the same number specified in bytes (i.e., with
           the "B" suffix), in that it provides no helpful range of
           sloppiness.  Contrast that with a partition start request of
           "4GB", which may actually resolve to some sector up to 500MB
           before or after that point.  Thus, when creating a partition in an
           exact location you should use units of bytes ("B"), sectors ("s"),
           or IEC binary units like "MiB", "GiB", but not "MB", "GB", etc.
    


* * *