Man Linux: Main Page and Category List

NAME

       GNU Parted - a partition manipulation program

SYNOPSIS

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

DESCRIPTION

       parted  is  a  disk  partitioning  and  partition resizing program.  It
       allows you to create, destroy, resize, move and copy ext2,  linux-swap,
       FAT,  FAT32,  and reiserfs partitions.  It can create, resize, and move
       Macintosh HFS partitions, as well as detect jfs,  ntfs,  ufs,  and  xfs
       partitions.  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; see near the bottom.

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 aligment  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:

              check partition
                     Do a simple check on partition.

              cp [source-device] source dest
                     Copy  the  source partition's filesystem on source-device
                     (or the current device if no other device was  specified)
                     to the dest partition on the current device.

              help [command]
                     Print general help, or help on command if specified.

              mkfs partition fs-type
                     Make  a  filesystem  fs-type on partition. fs-type can be
                     one  of  "fat16",  "fat32",  "ext2",   "linux-swap",   or
                     "reiserfs".

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

              mkpart part-type [fs-type] start end
                     Make  a  part-type  partition with filesystem fs-type (if
                     specified), beginning at start  and  ending  at  end  (by
                     default  in  megabytes).   fs-type can be one of "fat16",
                     "fat32", "ext2", "HFS", "linux-swap", "NTFS", "reiserfs",
                     or   "ufs".    part-type  should  be  one  of  "primary",
                     "logical", or "extended".

              mkpartfs part-type fs-type start end
                     Make  a  part-type  partition  with  filesystem   fs-type
                     beginning  at  start  and  ending  at  end (by default in
                     megabytes).  Using this command is discouraged.   Instead
                     use  mkpart  to  create  an empty partition, and then use
                     external tools like mke2fs(8) to create the filesystem.

              move partition start end
                     Move partition so that it begins at  start  and  ends  at
                     end.  Note: move never changes the minor number.

              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 quotes, if necessary.

              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.

              resize partition start end
                     Resize the filesystem on partition so that it  begins  at
                     start and ends at end (by default in megabytes).

              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", 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", "GB",  "TB",  "%"
                     (percentage  of  device  size),  "cyl" (cylinders), "chs"
                     (cylinders, heads, sectors), or "compact" (megabytes  for
                     input, and a human-friendly form for output).

              version
                     Display version information and a copyright message.

KNOWN ISSUES

       ext3  filesystem functionality does not currently work.  To manage ext3
       type filesystems use tools like resize2fs(8) or mke2fs(8).   Note  that
       the  currently  supported  ext2 filesystem will be deprecated once ext3
       support is finalized.  Further note that ext3 support will have limited
       functionality  that  is yet to be defined.  Use tools like resize2fs(8)
       and mke2fs(8) to manage these types of filesystems.

       To  manually  resize  an  ext3  filesystem  and/or  a   partition   use
       resize2fs(8),  fdisk(8) or similar tools.  For LVM situations, you will
       need to use the LVM commands to resize the LVM elements.

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 which is distributed
       with the parted-doc Debian package.

AUTHOR

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