man-pages/man8/parted.8.html
2021-03-31 01:06:50 +01:00

230 lines
7.6 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of PARTED</TITLE>
</HEAD><BODY>
<H1>PARTED</H1>
Section: GNU Parted Manual (8)<BR>Updated: 2007 March 29<BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
parted - a partition manipulation program
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<B>parted</B>
[options] [device [command [options...]...]]
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>
<B>parted</B>
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.
<P>
This manual page documents <B>parted</B> briefly. Complete documentation is
distributed with the package in GNU Info format.
<A NAME="lbAE">&nbsp;</A>
<H2>OPTIONS</H2>
<DL COMPACT>
<DT id="1"><B>-h, --help</B>
<DD>
displays a help message
<DT id="2"><B>-l, --list</B>
<DD>
lists partition layout on all block devices
<DT id="3"><B>-m, --machine</B>
<DD>
displays machine parseable output
<DT id="4"><B>-s, --script</B>
<DD>
never prompts for user intervention
<DT id="5"><B>-v, --version</B>
<DD>
displays the version
<DT id="6"><B>-a </B><I>alignment-type</I>, --align <I>alignment-type</I>
<DD>
Set alignment for newly created partitions, valid alignment types are:
<DL COMPACT><DT id="7"><DD>
<DL COMPACT>
<DT id="8">none<DD>
Use the minimum alignment allowed by the disk type.
<DT id="9">cylinder<DD>
Align partitions to cylinders.
<DT id="10">minimal<DD>
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.
<DT id="11">optimal<DD>
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.
</DL>
</DL>
<P>
</DL>
<A NAME="lbAF">&nbsp;</A>
<H2>COMMANDS</H2>
<DL COMPACT>
<DT id="12"><B>[device]</B>
<DD>
The block device to be used. When none is given, <B>parted</B> will use the
first block device it finds.
<DT id="13"><B>[command [options]]</B>
<DD>
Specifies the command to be executed. If no command is given,
<B>parted</B>
will present a command prompt. Possible commands are:
<DL COMPACT><DT id="14"><DD>
<DL COMPACT>
<DT id="15"><B>help </B><I>[command]</I>
<DD>
Print general help, or help on <I>command</I> if specified.
<DT id="16"><B>align-check </B><I>type</I> <I>partition</I>
<DD>
Check if <I>partition</I> satisfies the alignment constraint of <I>type</I>.
<I>type</I> must be &quot;minimal&quot; or &quot;optimal&quot;.
<DT id="17"><B>mklabel </B><I>label-type</I>
<DD>
Create a new disklabel (partition table) of <I>label-type</I>. <I>label-type</I>
should be one of &quot;aix&quot;, &quot;amiga&quot;, &quot;bsd&quot;, &quot;dvh&quot;, &quot;gpt&quot;, &quot;loop&quot;, &quot;mac&quot;, &quot;msdos&quot;,
&quot;pc98&quot;, or &quot;sun&quot;.
<DT id="18"><B>mkpart [</B><I>part-type</I> <I>name</I> <I>fs-type</I>] <I>start</I> <I>end</I>
<DD>
Create a new partition. <I>part-type</I> may be specified only with msdos and
dvh partition tables, it should be one of &quot;primary&quot;, &quot;logical&quot;, or &quot;extended&quot;.
<I>name</I> is required for GPT partition tables and <I>fs-type</I> is optional.
<I>fs-type</I> can be one of &quot;btrfs&quot;, &quot;ext2&quot;, &quot;ext3&quot;, &quot;ext4&quot;, &quot;fat16&quot;, &quot;fat32&quot;,
&quot;hfs&quot;, &quot;hfs+&quot;, &quot;linux-swap&quot;, &quot;ntfs&quot;, &quot;reiserfs&quot;, &quot;udf&quot;, or &quot;xfs&quot;.
<DT id="19"><B>name </B><I>partition</I> <I>name</I>
<DD>
Set the name of <I>partition</I> to <I>name</I>. 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.
<DT id="20"><B>print</B>
<DD>
Display the partition table.
<DT id="21"><B>quit</B>
<DD>
Exit from <B>parted</B>.
<DT id="22"><B>rescue </B><I>start</I> <I>end</I>
<DD>
Rescue a lost partition that was located somewhere between <I>start</I> and
<I>end</I>. If a partition is found, <B>parted</B> will ask if you want to
create an entry for it in the partition table.
<DT id="23"><B>resizepart </B><I>partition</I> <I>end</I>
<DD>
Change the <I>end</I> position of <I>partition</I>. Note that this does not
modify any filesystem present in the partition.
<DT id="24"><B>rm </B><I>partition</I>
<DD>
Delete <I>partition</I>.
<DT id="25"><B>select </B><I>device</I>
<DD>
Choose <I>device</I> as the current device to edit. <I>device</I> should usually
be a Linux hard disk device, but it can be a partition, software raid device,
or an LVM logical volume if necessary.
<DT id="26"><B>set </B><I>partition</I> <I>flag</I> <I>state</I>
<DD>
Change the state of the <I>flag</I> on <I>partition</I> to <I>state</I>.
Supported flags are: &quot;boot&quot;, &quot;root&quot;, &quot;swap&quot;, &quot;hidden&quot;, &quot;raid&quot;, &quot;lvm&quot;, &quot;lba&quot;,
&quot;legacy_boot&quot;, &quot;irst&quot;, &quot;msftres&quot;, &quot;esp&quot;, &quot;chromeos_kernel&quot; and &quot;palo&quot;.
<I>state</I> should be either &quot;on&quot; or &quot;off&quot;.
<DT id="27"><B>unit </B><I>unit</I>
<DD>
Set <I>unit</I> 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.
<I>unit</I> can be one of &quot;s&quot; (sectors), &quot;B&quot; (bytes), &quot;kB&quot;, &quot;MB&quot;, &quot;MiB&quot;, &quot;GB&quot;,
&quot;GiB&quot;, &quot;TB&quot;, &quot;TiB&quot;, &quot;%&quot; (percentage of device size), &quot;cyl&quot; (cylinders), &quot;chs&quot;
(cylinders, heads, sectors), or &quot;compact&quot; (megabytes for input, and a
human-friendly form for output).
<DT id="28"><B>toggle </B><I>partition</I> <I>flag</I>
<DD>
Toggle the state of <I>flag</I> on <I>partition</I>.
<DT id="29"><B>version</B>
<DD>
Display version information and a copyright message.
</DL>
</DL>
</DL>
<A NAME="lbAG">&nbsp;</A>
<H2>REPORTING BUGS</H2>
Report bugs to &lt;<A HREF="mailto:bug-parted@gnu.org">bug-parted@gnu.org</A>&gt;
<A NAME="lbAH">&nbsp;</A>
<H2>SEE ALSO</H2>
<B><A HREF="/cgi-bin/man/man2html?8+fdisk">fdisk</A></B>(8),
<B><A HREF="/cgi-bin/man/man2html?8+mkfs">mkfs</A></B>(8),
The <I>parted</I> program is fully documented in the
<B><A HREF="/cgi-bin/man/man2html?1+info">info</A>(1)</B>
format
<I>GNU partitioning software</I>
manual which is distributed with the parted-doc Debian package.
<A NAME="lbAI">&nbsp;</A>
<H2>AUTHOR</H2>
This manual page was written by Timshel Knoll &lt;<A HREF="mailto:timshel@debian.org">timshel@debian.org</A>&gt;,
for the Debian GNU/Linux system (but may be used by others).
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="30"><A HREF="#lbAB">NAME</A><DD>
<DT id="31"><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT id="32"><A HREF="#lbAD">DESCRIPTION</A><DD>
<DT id="33"><A HREF="#lbAE">OPTIONS</A><DD>
<DT id="34"><A HREF="#lbAF">COMMANDS</A><DD>
<DT id="35"><A HREF="#lbAG">REPORTING BUGS</A><DD>
<DT id="36"><A HREF="#lbAH">SEE ALSO</A><DD>
<DT id="37"><A HREF="#lbAI">AUTHOR</A><DD>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 00:06:15 GMT, March 31, 2021
</BODY>
</HTML>