summaryrefslogtreecommitdiffstats
path: root/disk-utils/swaplabel.8
diff options
context:
space:
mode:
Diffstat (limited to '')
-rw-r--r--disk-utils/swaplabel.887
-rw-r--r--disk-utils/swaplabel.8.adoc60
2 files changed, 147 insertions, 0 deletions
diff --git a/disk-utils/swaplabel.8 b/disk-utils/swaplabel.8
new file mode 100644
index 0000000..808f325
--- /dev/null
+++ b/disk-utils/swaplabel.8
@@ -0,0 +1,87 @@
+'\" t
+.\" Title: swaplabel
+.\" 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 "SWAPLABEL" "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"
+swaplabel \- print or change the label or UUID of a swap area
+.SH "SYNOPSIS"
+.sp
+\fBswaplabel\fP [\fB\-L\fP \fIlabel\fP] [\fB\-U\fP \fIUUID\fP] \fIdevice\fP
+.SH "DESCRIPTION"
+.sp
+\fBswaplabel\fP will display or change the label or UUID of a swap partition located on \fIdevice\fP (or regular file).
+.sp
+If the optional arguments \fB\-L\fP and \fB\-U\fP are not given, \fBswaplabel\fP will simply display the current swap\-area label and UUID of \fIdevice\fP.
+.sp
+If an optional argument is present, then \fBswaplabel\fP will change the appropriate value on \fIdevice\fP. These values can also be set during swap creation using \fBmkswap\fP(8). The \fBswaplabel\fP utility allows changing the label or UUID on an actively used swap device.
+.SH "OPTIONS"
+.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
+.sp
+\fB\-L\fP, \fB\-\-label\fP \fIlabel\fP
+.RS 4
+Specify a new \fIlabel\fP for the device. Swap partition labels can be at most 16 characters long. If \fIlabel\fP is longer than 16 characters, \fBswaplabel\fP will truncate it and print a warning message.
+.RE
+.sp
+\fB\-U\fP, \fB\-\-uuid\fP \fIUUID\fP
+.RS 4
+Specify a new \fIUUID\fP for the device. The \fIUUID\fP must be in the standard 8\-4\-4\-4\-12 character format, such as is output by \fBuuidgen\fP(1).
+.RE
+.SH "ENVIRONMENT"
+.sp
+LIBBLKID_DEBUG=all
+.RS 4
+enables libblkid debug output.
+.RE
+.SH "AUTHORS"
+.sp
+\fBswaplabel\fP was written by \c
+.MTO "jborden\(atbluehost.com" "Jason Borden" ""
+and
+.MTO "kzak\(atredhat.com" "Karel Zak" "."
+.SH "SEE ALSO"
+.sp
+\fBuuidgen\fP(1),
+\fBmkswap\fP(8),
+\fBswapon\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 \fBswaplabel\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/swaplabel.8.adoc b/disk-utils/swaplabel.8.adoc
new file mode 100644
index 0000000..14ab6c4
--- /dev/null
+++ b/disk-utils/swaplabel.8.adoc
@@ -0,0 +1,60 @@
+//po4a: entry man manual
+////
+Copyright 2010 Jason Borden <jborden@bluehost.com>
+This file may be copied under the terms of the GNU Public License.
+////
+= swaplabel(8)
+:doctype: manpage
+:man manual: System Administration
+:man source: util-linux {release-version}
+:page-layout: base
+:command: swaplabel
+
+== NAME
+
+swaplabel - print or change the label or UUID of a swap area
+
+== SYNOPSIS
+
+*swaplabel* [*-L* _label_] [*-U* _UUID_] _device_
+
+== DESCRIPTION
+
+*swaplabel* will display or change the label or UUID of a swap partition located on _device_ (or regular file).
+
+If the optional arguments *-L* and *-U* are not given, *swaplabel* will simply display the current swap-area label and UUID of _device_.
+
+If an optional argument is present, then *swaplabel* will change the appropriate value on _device_. These values can also be set during swap creation using *mkswap*(8). The *swaplabel* utility allows changing the label or UUID on an actively used swap device.
+
+== OPTIONS
+
+include::man-common/help-version.adoc[]
+
+*-L*, *--label* _label_::
+ Specify a new _label_ for the device. Swap partition labels can be at most 16 characters long. If _label_ is longer than 16 characters, *swaplabel* will truncate it and print a warning message.
+
+*-U*, *--uuid* _UUID_::
+ Specify a new _UUID_ for the device. The _UUID_ must be in the standard 8-4-4-4-12 character format, such as is output by *uuidgen*(1).
+
+== ENVIRONMENT
+
+LIBBLKID_DEBUG=all::
+ enables libblkid debug output.
+
+== AUTHORS
+
+*swaplabel* was written by mailto:jborden@bluehost.com[Jason Borden] and mailto:kzak@redhat.com[Karel Zak].
+
+== SEE ALSO
+
+*uuidgen*(1),
+*mkswap*(8),
+*swapon*(8)
+
+include::man-common/bugreports.adoc[]
+
+include::man-common/footer.adoc[]
+
+ifdef::translation[]
+include::man-common/translation.adoc[]
+endif::[]