-
Notifications
You must be signed in to change notification settings - Fork 0
/
parted.8.html
215 lines (215 loc) · 10.9 KB
/
parted.8.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8"/>
<meta name="viewport" content="width=device-width, initial-scale=1.0"/>
<link rel="stylesheet" href="mandoc.css" type="text/css" media="all"/>
<title>PARTED(8)</title>
</head>
<body>
<table class="head">
<tr>
<td class="head-ltitle">PARTED(8)</td>
<td class="head-vol">GNU Parted Manual</td>
<td class="head-rtitle">PARTED(8)</td>
</tr>
</table>
<div class="manual-text">
<section class="Sh">
<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
<p class="Pp">parted - a partition manipulation program</p>
</section>
<section class="Sh">
<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
<p class="Pp"><b>parted</b> [options] [device [command [options...]...]]</p>
</section>
<section class="Sh">
<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
<p class="Pp"><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>
<p class="Pp">This manual page documents <b>parted</b> briefly. Complete
documentation is distributed with the package in GNU Info format.</p>
</section>
<section class="Sh">
<h1 class="Sh" id="OPTIONS"><a class="permalink" href="#OPTIONS">OPTIONS</a></h1>
<dl class="Bl-tag">
<dt id="h,"><a class="permalink" href="#h,"><b>-h, --help</b></a></dt>
<dd>displays a help message</dd>
<dt id="l,"><a class="permalink" href="#l,"><b>-l, --list</b></a></dt>
<dd>lists partition layout on all block devices</dd>
<dt id="m,"><a class="permalink" href="#m,"><b>-m, --machine</b></a></dt>
<dd>displays machine parseable output</dd>
<dt id="j,"><a class="permalink" href="#j,"><b>-j, --json</b></a></dt>
<dd>displays JSON output</dd>
<dt id="s,"><a class="permalink" href="#s,"><b>-s, --script</b></a></dt>
<dd>never prompts for user intervention</dd>
<dt id="f,"><a class="permalink" href="#f,"><b>-f, --fix</b></a></dt>
<dd>automatically answer "fix" to exceptions in script mode</dd>
<dt id="v,"><a class="permalink" href="#v,"><b>-v, --version</b></a></dt>
<dd>displays the version</dd>
<dt id="a"><a class="permalink" href="#a"><b>-a <i>alignment-type</i>, --align
<i>alignment-type</i></b></a></dt>
<dd>Set alignment for newly created partitions, valid alignment types
are:</dd>
</dl>
<div class="Bd-indent">
<dl class="Bl-tag">
<dt id="none"><a class="permalink" href="#none">none</a></dt>
<dd>Use the minimum alignment allowed by the disk type.</dd>
<dt id="cylinder"><a class="permalink" href="#cylinder">cylinder</a></dt>
<dd>Align partitions to cylinders.</dd>
<dt id="minimal"><a class="permalink" href="#minimal">minimal</a></dt>
<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.</dd>
<dt id="optimal"><a class="permalink" href="#optimal">optimal</a></dt>
<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.</dd>
</dl>
</div>
<p class="Pp"></p>
</section>
<section class="Sh">
<h1 class="Sh" id="COMMANDS"><a class="permalink" href="#COMMANDS">COMMANDS</a></h1>
<dl class="Bl-tag">
<dt><b>[device]</b></dt>
<dd>The block device to be used. When none is given, <b>parted</b> will use
the first block device it finds.</dd>
<dt><b>[command [options]]</b></dt>
<dd>Specifies the command to be executed. If no command is given,
<b>parted</b> will present a command prompt. Possible commands are:</dd>
</dl>
<div class="Bd-indent">
<dl class="Bl-tag">
<dt id="help"><a class="permalink" href="#help"><b>help
<i>[command]</i></b></a></dt>
<dd>Print general help, or help on <i>command</i> if specified.</dd>
<dt id="align-check"><a class="permalink" href="#align-check"><b>align-check
<i>type</i> <i>partition</i></b></a></dt>
<dd>Check if <i>partition</i> satisfies the alignment constraint of
<i>type</i>. <i>type</i> must be "minimal" or
"optimal".</dd>
<dt id="mklabel"><a class="permalink" href="#mklabel"><b>mklabel
<i>label-type</i></b></a></dt>
<dd>Create a new disklabel (partition table) of <i>label-type</i>.
<i>label-type</i> should be one of "aix", "amiga",
"bsd", "dvh", "gpt", "loop",
"mac", "msdos", "pc98", or
"sun".</dd>
<dt id="mkpart"><a class="permalink" href="#mkpart"><b>mkpart
[<i>part-type</i> <i>name</i> <i>fs-type</i>] <i>start</i>
<i>end</i></b></a></dt>
<dd>Create a new partition. <i>part-type</i> may be specified only with msdos
and dvh partition tables, it should be one of "primary",
"logical", or "extended". <i>name</i> is required for
GPT partition tables and <i>fs-type</i> is optional. <i>fs-type</i> can be
one of "btrfs", "ext2", "ext3",
"ext4", "fat16", "fat32", "hfs",
"hfs+", "linux-swap", "ntfs",
"reiserfs", "udf", or "xfs".</dd>
<dt id="name"><a class="permalink" href="#name"><b>name <i>partition</i>
<i>name</i></b></a></dt>
<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.</dd>
<dt id="print"><a class="permalink" href="#print"><b>print
<i>print-type</i></b></a></dt>
<dd>Display the partition table. <i>print-type</i> is optional, and can be one
of devices, free, list, or all.</dd>
<dt id="quit"><a class="permalink" href="#quit"><b>quit</b></a></dt>
<dd>Exit from <b>parted</b>.</dd>
<dt id="rescue"><a class="permalink" href="#rescue"><b>rescue <i>start</i>
<i>end</i></b></a></dt>
<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.</dd>
<dt id="resizepart"><a class="permalink" href="#resizepart"><b>resizepart
<i>partition</i> <i>end</i></b></a></dt>
<dd>Change the <i>end</i> position of <i>partition</i>. Note that this does
not modify any filesystem present in the partition.</dd>
<dt id="rm"><a class="permalink" href="#rm"><b>rm
<i>partition</i></b></a></dt>
<dd>Delete <i>partition</i>.</dd>
<dt id="select"><a class="permalink" href="#select"><b>select
<i>device</i></b></a></dt>
<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.</dd>
<dt id="set"><a class="permalink" href="#set"><b>set <i>partition</i>
<i>flag</i> <i>state</i></b></a></dt>
<dd>Change the state of the <i>flag</i> on <i>partition</i> to <i>state</i>.
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". <i>state</i> should be either "on" or
"off".</dd>
<dt id="unit"><a class="permalink" href="#unit"><b>unit
<i>unit</i></b></a></dt>
<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 "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).</dd>
<dt id="toggle"><a class="permalink" href="#toggle"><b>toggle <i>partition</i>
<i>flag</i></b></a></dt>
<dd>Toggle the state of <i>flag</i> on <i>partition</i>.</dd>
<dt id="type"><a class="permalink" href="#type"><b>type <i>partition</i>
<i>id</i> or <i>uuid</i></b></a></dt>
<dd>On MS-DOS set the type aka. partition id of <i>partition</i> to <i>id</i>.
The <i>id</i> is a value between "0x01" and "0xff". On
GPT the type-uuid of <i>partition</i> to <i>uuid</i>.</dd>
<dt id="disk_set"><a class="permalink" href="#disk_set"><b>disk_set
<i>flag</i> <i>state</i></b></a></dt>
<dd>Change a <i>flag</i> on the disk to <i>state</i>. 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.</dd>
<dt id="disk_toggle"><a class="permalink" href="#disk_toggle"><b>disk_toggle
<i>flag</i></b></a></dt>
<dd>Toggle the state of the disk <i>flag</i>.</dd>
<dt id="version"><a class="permalink" href="#version"><b>version</b></a></dt>
<dd>Display version information and a copyright message.</dd>
</dl>
</div>
</section>
<section class="Sh">
<h1 class="Sh" id="REPORTING_BUGS"><a class="permalink" href="#REPORTING_BUGS">REPORTING
BUGS</a></h1>
<p class="Pp">Report bugs to <bug-parted@gnu.org></p>
</section>
<section class="Sh">
<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
ALSO</a></h1>
<p class="Pp"><b>fdisk</b>(8), <b>mkfs</b>(8), The <i>parted</i> program is
fully documented in the <b>info(1)</b> format <i>GNU partitioning
software</i> manual.</p>
</section>
<section class="Sh">
<h1 class="Sh" id="AUTHOR"><a class="permalink" href="#AUTHOR">AUTHOR</a></h1>
<p class="Pp">This manual page was written by Timshel Knoll
<timshel@debian.org>, for the Debian GNU/Linux system (but may be used
by others).</p>
</section>
</div>
<table class="foot">
<tr>
<td class="foot-date">2021 September 28</td>
<td class="foot-os">parted</td>
</tr>
</table>
</body>
</html>