Adding upstream version 2.38.1.upstream/2.38.1upstream

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

2 files changed, 377 insertions, 0 deletions

diff --git a/disk-utils/partx.8 b/disk-utils/partx.8
new file mode 100644
index 0000000..3362ff8
--- /dev/null
+++ b/disk-utils/partx.8
@@ -0,0 +1,228 @@
+'\" t
+.\"     Title: partx
+.\"    Author: [see the "AUTHOR(S)" section]
+.\" Generator: Asciidoctor 2.0.15
+.\"      Date: 2022-05-11
+.\"    Manual: System Administration
+.\"    Source: util-linux 2.38.1
+.\"  Language: English
+.\"
+.TH "PARTX" "8" "2022-05-11" "util\-linux 2.38.1" "System Administration"
+.ie \n(.g .ds Aq \(aq
+.el       .ds Aq '
+.ss \n[.ss] 0
+.nh
+.ad l
+.de URL
+\fI\\$2\fP <\\$1>\\$3
+..
+.als MTO URL
+.if \n[.g] \{\
+.  mso www.tmac
+.  am URL
+.    ad l
+.  .
+.  am MTO
+.    ad l
+.  .
+.  LINKSTYLE blue R < >
+.\}
+.SH "NAME"
+partx \- tell the kernel about the presence and numbering of on\-disk partitions
+.SH "SYNOPSIS"
+.sp
+\fBpartx\fP [\fB\-a\fP|\fB\-d\fP|\fB\-P\fP|\fB\-r\fP|\fB\-s\fP|\fB\-u\fP] [\fB\-t\fP \fItype\fP] [\fB\-n\fP \fIM\fP:_N_] [\-] \fIdisk\fP
+.sp
+\fBpartx\fP [\fB\-a\fP|\fB\-d\fP|\fB\-P\fP|\fB\-r\fP|\fB\-s\fP|\fB\-u\fP] [\fB\-t\fP \fItype\fP] \fIpartition\fP [\fIdisk\fP]
+.SH "DESCRIPTION"
+.sp
+Given a device or disk\-image, \fBpartx\fP tries to parse the partition table and list its contents. It can also tell the kernel to add or remove partitions from its bookkeeping.
+.sp
+The \fIdisk\fP argument is optional when a \fIpartition\fP 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:
+.RS 3
+.ll -.6i
+.sp
+partx \-\-show \- /dev/sda3
+.br
+.RE
+.ll
+.sp
+This will see sda3 as a whole\-disk rather than as a partition.
+.sp
+\fBpartx is not an fdisk program\fP \- adding and removing partitions does not change the disk, it just tells the kernel about the presence and numbering of on\-disk partitions.
+.SH "OPTIONS"
+.sp
+\fB\-a\fP, \fB\-\-add\fP
+.RS 4
+Add the specified partitions, or read the disk and add all partitions.
+.RE
+.sp
+\fB\-b\fP, \fB\-\-bytes\fP
+.RS 4
+Print the sizes in bytes rather than in a human\-readable format.
+.sp
+By default, the unit, sizes are expressed in, is byte, and unit prefixes are in
+power of 2^10 (1024). Abbreviations of symbols are exhibited truncated in order
+to reach a better readability, by exhibiting alone the first letter of them;
+examples: "1 KiB" and "1 MiB" are respectively exhibited as "1 K" and "1 M",
+then omitting on purpose the mention "iB", which is part of these abbreviations.
+.RE
+.sp
+\fB\-d\fP, \fB\-\-delete\fP
+.RS 4
+Delete the specified partitions or all partitions. It is not error to remove non\-existing partitions, so this option is possible to use together with large \fB\-\-nr\fP ranges without care about the current partitions set on the device.
+.RE
+.sp
+\fB\-g\fP, \fB\-\-noheadings\fP
+.RS 4
+Do not print a header line with \fB\-\-show\fP or \fB\-\-raw\fP.
+.RE
+.sp
+\fB\-l\fP, \fB\-\-list\fP
+.RS 4
+List the partitions. Note that all numbers are in 512\-byte sectors. This output format is DEPRECATED in favour of \fB\-\-show\fP. Do not use it in newly written scripts.
+.RE
+.sp
+\fB\-n\fP, \fB\-\-nr\fP \fIM\fP\fB:\fP\fIN\fP
+.RS 4
+Specify the range of partitions. For backward compatibility also the format \fIM\fP\fB\-\fP\fIN\fP is supported. The range may contain negative numbers, for example \fB\-\-nr \-1:\-1\fP means the last partition, and \fB\-\-nr \-2:\-1\fP means the last two partitions. Supported range specifications are:
+.sp
+\fIM\fP
+.RS 4
+Specifies just one partition (e.g. \fB\-\-nr 3\fP).
+.RE
+.sp
+\fIM\fP\fB:\fP
+.RS 4
+Specifies the lower limit only (e.g. \fB\-\-nr 2:\fP).
+.RE
+.sp
+\fB:\fP\fIN\fP
+.RS 4
+Specifies the upper limit only (e.g. \fB\-\-nr :4\fP).
+.RE
+.sp
+\fIM\fP\fB:\fP\fIN\fP
+.RS 4
+Specifies the lower and upper limits (e.g. \fB\-\-nr 2:4\fP).
+.RE
+.RE
+.sp
+\fB\-o\fP, \fB\-\-output\fP \fIlist\fP
+.RS 4
+Define the output columns to use for \fB\-\-show\fP, \fB\-\-pairs\fP and \fB\-\-raw\fP output. If no output arrangement is specified, then a default set is used. Use \fB\-\-help\fP to get \fIlist\fP of all supported columns. This option cannot be combined with the \fB\-\-add\fP, \fB\-\-delete\fP, \fB\-\-update\fP or \fB\-\-list\fP options.
+.RE
+.sp
+\fB\-\-output\-all\fP
+.RS 4
+Output all available columns.
+.RE
+.sp
+\fB\-P\fP, \fB\-\-pairs\fP
+.RS 4
+List the partitions using the KEY="value" format.
+.RE
+.sp
+\fB\-r\fP, \fB\-\-raw\fP
+.RS 4
+List the partitions using the raw output format.
+.RE
+.sp
+\fB\-s\fP, \fB\-\-show\fP
+.RS 4
+List the partitions. The output columns can be selected and rearranged with the \fB\-\-output\fP option. All numbers (except SIZE) are in 512\-byte sectors.
+.RE
+.sp
+\fB\-t\fP, \fB\-\-type\fP \fItype\fP
+.RS 4
+Specify the partition table type.
+.RE
+.sp
+\fB\-\-list\-types\fP
+.RS 4
+List supported partition types and exit.
+.RE
+.sp
+\fB\-u\fP, \fB\-\-update\fP
+.RS 4
+Update the specified partitions.
+.RE
+.sp
+\fB\-S\fP, \fB\-\-sector\-size\fP \fIsize\fP
+.RS 4
+Overwrite default sector size.
+.RE
+.sp
+\fB\-v\fP, \fB\-\-verbose\fP
+.RS 4
+Verbose mode.
+.RE
+.sp
+\fB\-h\fP, \fB\-\-help\fP
+.RS 4
+Display help text and exit.
+.RE
+.sp
+\fB\-V\fP, \fB\-\-version\fP
+.RS 4
+Print version and exit.
+.RE
+.SH "ENVIRONMENT"
+.sp
+LIBBLKID_DEBUG=all
+.RS 4
+enables libblkid debug output.
+.RE
+.SH "EXAMPLE"
+.sp
+partx \-\-show /dev/sdb3, partx \-\-show \-\-nr 3 /dev/sdb, partx \-\-show /dev/sdb3 /dev/sdb
+.RS 4
+All three commands list partition 3 of \fI/dev/sdb\fP.
+.RE
+.sp
+partx \-\-show \- /dev/sdb3
+.RS 4
+Lists all subpartitions on \fI/dev/sdb3\fP (the device is used as whole\-disk).
+.RE
+.sp
+partx \-o START \-g \-\-nr 5 /dev/sdb
+.RS 4
+Prints the start sector of partition 5 on \fI/dev/sdb\fP without header.
+.RE
+.sp
+partx \-o SECTORS,SIZE /dev/sda5 /dev/sda
+.RS 4
+Lists the length in sectors and human\-readable size of partition 5 on \fI/dev/sda\fP.
+.RE
+.sp
+partx \-\-add \-\-nr 3:5 /dev/sdd
+.RS 4
+Adds all available partitions from 3 to 5 (inclusive) on \fI/dev/sdd\fP.
+.RE
+.sp
+partx \-d \-\-nr :\-1 /dev/sdd
+.RS 4
+Removes the last partition on \fI/dev/sdd\fP.
+.RE
+.SH "AUTHORS"
+.sp
+.MTO "dave\(atgnu.org" "Davidlohr Bueso" ","
+.MTO "kzak\(atredhat.com" "Karel Zak" ""
+.sp
+The original version was written by \c
+.MTO "aeb\(atcwi.nl" "Andries E. Brouwer" ""
+.SH "SEE ALSO"
+.sp
+\fBaddpart\fP(8),
+\fBdelpart\fP(8),
+\fBfdisk\fP(8),
+\fBparted\fP(8),
+\fBpartprobe\fP(8)
+.SH "REPORTING BUGS"
+.sp
+For bug reports, use the issue tracker at \c
+.URL "https://github.com/util\-linux/util\-linux/issues" "" "."
+.SH "AVAILABILITY"
+.sp
+The \fBpartx\fP command is part of the util\-linux package which can be downloaded from \c
+.URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "Linux Kernel Archive" "."
\ No newline at end of file
diff --git a/disk-utils/partx.8.adoc b/disk-utils/partx.8.adoc
new file mode 100644
index 0000000..bfc0c5a
--- /dev/null
+++ b/disk-utils/partx.8.adoc
@@ -0,0 +1,149 @@
+//po4a: entry man manual
+////
+partx.8 -- man page for partx
+Copyright 2007 Karel Zak <kzak@redhat.com>
+Copyright 2007 Red Hat, Inc.
+Copyright 2010 Davidlohr Bueso <dave@gnu.org>
+May be distributed under the GNU General Public License
+////
+= partx(8)
+:doctype: manpage
+:man manual: System Administration
+:man source: util-linux {release-version}
+:page-layout: base
+:command: partx
+
+== NAME
+
+partx - tell the kernel about the presence and numbering of on-disk partitions
+
+== SYNOPSIS
+
+*partx* [*-a*|*-d*|*-P*|*-r*|*-s*|*-u*] [*-t* _type_] [*-n* _M_:_N_] [-] _disk_
+
+*partx* [*-a*|*-d*|*-P*|*-r*|*-s*|*-u*] [*-t* _type_] _partition_ [_disk_]
+
+== DESCRIPTION
+
+Given a device or disk-image, *partx* tries to parse the partition table and list its contents. It can also tell the kernel to add or remove partitions from its bookkeeping.
+
+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 as a partition.
+
+*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
+
+*-a*, *--add*::
+Add the specified partitions, or read the disk and add all partitions.
+
+*-b*, *--bytes*::
+include::man-common/in-bytes.adoc[]
+
+*-d*, *--delete*::
+Delete the specified partitions or all partitions. It is not error to remove non-existing partitions, so this option is possible to use together with large *--nr* ranges without care about the current partitions set on the device.
+
+*-g*, *--noheadings*::
+Do not print a header line with *--show* or *--raw*.
+
+*-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.
+
+*-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:-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 the lower limit only (e.g. *--nr 2:*).
+**:**__N__;;
+Specifies the upper limit only (e.g. *--nr :4*).
+__M__**:**_N_;;
+Specifies the lower and upper limits (e.g. *--nr 2:4*).
+
+*-o*, *--output* _list_::
+Define the output columns to use for *--show*, *--pairs* 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 the *--add*, *--delete*, *--update* or *--list* options.
+
+*--output-all*::
+Output all available columns.
+
+*-P*, *--pairs*::
+List the partitions using the KEY="value" format.
+
+*-r*, *--raw*::
+List the partitions using the raw output format.
+
+*-s*, *--show*::
+List the partitions. The output columns can be selected and rearranged with the *--output* option. All numbers (except SIZE) are in 512-byte sectors.
+
+*-t*, *--type* _type_::
+Specify the partition table type.
+
+*--list-types*::
+List supported partition types and exit.
+
+*-u*, *--update*::
+Update the specified partitions.
+
+*-S*, *--sector-size* _size_::
+Overwrite default sector size.
+
+*-v*, *--verbose*::
+Verbose mode.
+
+include::man-common/help-version.adoc[]
+
+== ENVIRONMENT
+
+LIBBLKID_DEBUG=all::
+enables libblkid debug output.
+
+== EXAMPLE
+
+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_.
+
+== AUTHORS
+
+mailto:dave@gnu.org[Davidlohr Bueso],
+mailto:kzak@redhat.com[Karel Zak]
+
+The original version was written by mailto:aeb@cwi.nl[Andries E. Brouwer]
+
+== SEE ALSO
+
+*addpart*(8),
+*delpart*(8),
+*fdisk*(8),
+*parted*(8),
+*partprobe*(8)
+
+include::man-common/bugreports.adoc[]
+
+include::man-common/footer.adoc[]
+
+ifdef::translation[]
+include::man-common/translation.adoc[]
+endif::[]