NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | SEE ALSO | AUTHORS | ENVIRONMENT | AVAILABILITY | COLOPHON

PARTX(8)                    System Administration                   PARTX(8)

NAME         top

       partx - tell the Linux kernel about the presence and numbering of on-
       disk partitions

SYNOPSIS         top

       partx [-a | -d | -s | -u] [-t TYPE] [-n M:N] [-] disk
       partx [-a | -d | -s | -u] [-t TYPE] partition [disk]

DESCRIPTION         top

       Given a device or disk-image, partx tries to parse the partition
       table and list its contents.  It optionally adds or removes
       partitions.

       The disk argument is optional when a partition argument is provided.
       To force scanning a partition as if it were a whole disk (for example
       to list nested subpartitions), use the argument "-" (hyphen-minus).
       For example:

              partx --show - /dev/sda3

       This will see sda3 as a whole-disk rather than a partition.

       The partx is not an fdisk program – adding and removing partitions
       does not change the disk, it just tells the kernel about the presence
       and numbering of on-disk partitions.

OPTIONS         top

       -a, --add
              Add the specified partitions, or read the disk and add all
              partitions.

       -b, --bytes
              Print the SIZE column in bytes rather than in human-readable
              format.

       -d, --delete
              Delete the specified partitions or all partitions.

       -u, --update
              Update the specified partitions.

       -g, --noheadings
              Do not print a header line.

       -h, --help
              Display help text and exit.

       -l, --list
              List the partitions.  Note that all numbers are in 512-byte
              sectors.  This output format is DEPRECATED in favour of
              --show.  Do not use it in newly written scripts.

       -o, --output list
              Define the output columns to use for --show and --raw output.
              If no output arrangement is specified, then a default set is
              used.  Use --help to get list of all supported columns.  This
              option cannot be combined with --add, --delete, or --list
              options.

       -P, --pairs
              Output using key="value" format.

       -n, --nr M:N
              Specify the range of partitions.  For backward compatibility
              also the format M–N is supported.  The range may contain
              negative numbers, for example --nr :-1 means the last
              partition, and --nr -2:-1 means the last two partitions.
              Supported range specifications are:

                     M      Specifies just one partition (e.g. --nr 3).

                     M:     Specifies lower limit only (e.g. --nr 2:).

                     :N     Specifies upper limit only (e.g. --nr :4).

                     M:N or
                     M–N    Specifies lower and upper limits (e.g. --nr
                            2:4).

       -r, --raw
              Use the raw output format.

       -s, --show
              List the partitions.  All numbers (except SIZE) are in
              512-byte sectors.  The output columns can be rearranged with
              the --output option.

       -t, --type type
              Specify the partition table type aix, bsd, dos, gpt, mac,
              minix, sgi, solaris_x86, sun, ultrix, or unixware.

       -v, --verbose
              Verbose mode.

EXAMPLES         top

       partx --show /dev/sdb3
       partx --show --nr 3 /dev/sdb
       partx --show /dev/sdb3 /dev/sdb
              All three commands list partition 3 of /dev/sdb.

       partx --show - /dev/sdb3
              Lists all subpartitions on /dev/sdb3 (the device is used as
              whole-disk).

       partx -o START -g --nr 5 /dev/sdb
              Prints the start sector of partition 5 on /dev/sdb without
              header.

       partx -o SECTORS,SIZE /dev/sda5 /dev/sda
              Lists the length in sectors and human-readable size of
              partition 5 on /dev/sda.

       partx --add --nr 3:5 /dev/sdd
              Adds all available partitions from 3 to 5 (inclusive) on
              /dev/sdd.

       partx -d --nr :-1 /dev/sdd
              Removes the last partition on /dev/sdd.

SEE ALSO         top

       addpart(8), delpart(8), fdisk(8), parted(8), partprobe(8)

AUTHORS         top

       Davidlohr Bueso ⟨dave@gnu.org⟩
       Karel Zak ⟨kzak@redhat.com⟩

       The original version was written by Andries E. Brouwer ⟨aeb@cwi.nl⟩.

ENVIRONMENT         top

       LIBBLKID_DEBUG=0xffff
              enables debug output.

AVAILABILITY         top

       The partx command is part of the util-linux package and is available
       from Linux Kernel Archive 
       ⟨ftp://ftp.kernel.org/pub/linux/utils/util-linux/⟩.

COLOPHON         top

       This page is part of the util-linux (a random collection of Linux
       utilities) project.  Information about the project can be found at 
       ⟨https://www.kernel.org/pub/linux/utils/util-linux/⟩.  If you have a
       bug report for this manual page, send it to
       util-linux@vger.kernel.org.  This page was obtained from the
       project's upstream Git repository
       (git://git.kernel.org/pub/scm/utils/util-linux/util-linux.git) on
       2014-07-09.  If you discover any rendering problems in this HTML ver‐
       sion of the page, or you believe there is a better or more up-to-date
       source for the page, or you have corrections or improvements to the
       information in this COLOPHON (which is not part of the original man‐
       ual page), send a mail to man-pages@man7.org

util-linux                        June 2012                         PARTX(8)