Yolinux.com

parted manpage

Search topic Section


PARTED(8)		       GNU Parted Manual		     PARTED(8)



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:

	      align-check alignment-type partition
		     Determine whether the starting  sector  of	 partition  is
		     aligned  for  the	disk.	alignment-type is "minimal" or
		     "optimal".

	      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 "reis-
		     erfs".

	      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",	"logi-
		     cal", or "extended".

	      mkpartfs part-type fs-type start end
		     Make a part-type partition with filesystem fs-type begin-
		     ning  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 vol-
		     ume if necessary.

	      set partition flag state
		     Change the state of the flag on partition to state.  Sup-
		     ported  flags  are:  "boot",  "root",  "swap",  "hidden",
		     "raid",  "lvm",  "lba",  "legacy_boot" 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.

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



parted				 2007 March 29			     PARTED(8)