2 .\" Copyright 2007 Karel Zak <kzak@redhat.com>
3 .\" Copyright 2007 Red Hat, Inc.
4 .\" Copyright 2010 Davidlohr Bueso <dave@gnu.org>
5 .\" May be distributed under the GNU General Public License
7 .TH PARTX "8" "December 2014" "util-linux" "System Administration"
9 partx \- tell the Linux kernel about the presence and numbering of on-disk partitions
12 .RB [ \-a | \-d | \-s | \-u ]
13 .RB [ \-t " \fItype\fR]"
14 .RB [ \-n " \fIM" : \fIN\fR]
18 .RB [ \-a | \-d | \-s | \-u ]
19 .RB [ \-t " \fItype\fR]"
20 .IR partition " [" disk ]
22 Given a device or disk-image,
24 tries to parse the partition table and list its contents. It
25 optionally adds or removes partitions.
29 argument is optional when a
31 argument is provided. To force scanning a partition as if it were a whole disk
32 (for example to list nested subpartitions), use the argument "\-" (hyphen-minus). For example:
36 partx \-\-show \- /dev/sda3
39 This will see sda3 as a whole-disk rather than a partition.
42 .B partx is not an fdisk program
43 \(en adding and removing partitions does not change the disk, it just
44 tells the kernel about the presence and numbering of on-disk
49 Add the specified partitions, or read the disk and add all partitions.
51 .BR \-b , " \-\-bytes"
52 Print the SIZE column in bytes rather than in human-readable format.
54 .BR \-d , " \-\-delete"
55 Delete the specified partitions or all partitions.
57 .BR \-g , " \-\-noheadings"
58 Do not print a header line.
61 List the partitions. Note that all numbers are in 512-byte sectors.
62 This output format is DEPRECATED in favour of
64 Do not use it in newly written scripts.
66 .BR \-n , " \-\-nr " \fIM : \fIN
67 Specify the range of partitions. For backward compatibility also the
68 format \fIM\fB\-\fIN\fR is supported.
69 The range may contain negative numbers, for example
71 means the last partition, and
73 means the last two partitions. Supported range specifications are:
77 Specifies just one partition (e.g.\& \fB\-\-nr 3\fR).
80 Specifies the lower limit only (e.g.\& \fB\-\-nr 2:\fR).
83 Specifies the upper limit only (e.g.\& \fB\-\-nr :4\fR).
86 Specifies the lower and upper limits (e.g.\& \fB\-\-nr 2:4\fR).
89 .BR \-o , " \-\-output " \fIlist
90 Define the output columns to use for
94 output. If no output arrangement is specified, then a default set is
99 of all supported columns. This option cannot be combined with the
106 .BR \-P , " \-\-pairs"
107 Output using key="value" format.
110 Use the raw output format.
113 List the partitions. All numbers (except SIZE) are in 512-byte sectors.
114 The output columns can be rearranged with the \fB\-\-output\fR option.
116 .BR \-t , " \-\-type " \fItype
117 Specify the partition table type, which can be one of
131 .BR \-u , " \-\-update"
132 Update the specified partitions.
134 .BR \-v , " \-\-verbose"
137 .BR \-V , " \-\-version"
138 Display version information and exit.
140 .BR \-h , " \-\-help"
141 Display help text and exit.
144 partx \-\-show /dev/sdb3
146 partx \-\-show \-\-nr 3 /dev/sdb
148 partx \-\-show /dev/sdb3 /dev/sdb
149 All three commands list partition 3 of /dev/sdb.
151 partx \-\-show \- /dev/sdb3
152 Lists all subpartitions on /dev/sdb3 (the device is used as
155 partx \-o START \-g \-\-nr 5 /dev/sdb
156 Prints the start sector of partition 5 on /dev/sdb without header.
158 partx \-o SECTORS,SIZE /dev/sda5 /dev/sda
159 Lists the length in sectors and human-readable size of partition 5 on
162 partx \-\-add \-\-nr 3:5 /dev/sdd
163 Adds all available partitions from 3 to 5 (inclusive) on /dev/sdd.
165 partx \-d \-\-nr :\-1 /dev/sdd
166 Removes the last partition on /dev/sdd.
182 The original version was written by
187 .IP LIBBLKID_DEBUG=all
188 enables libblkid debug output.
190 The partx command is part of the util-linux package and is available from
191 .UR ftp://\:ftp.kernel.org\:/pub\:/linux\:/utils\:/util-linux/