2010-04-02 08:52:45 -05:00
|
|
|
.\" Copyright 2010 Jason Borden <jborden@bluehost.com>
|
|
|
|
.\"
|
|
|
|
.\" This file may be copied under the terms of the GNU Public License.
|
|
|
|
.\"
|
2011-08-18 15:18:34 -05:00
|
|
|
.TH SWAPLABEL 8 "April 2010" "util-linux" "System Administration"
|
2010-04-02 08:52:45 -05:00
|
|
|
.SH NAME
|
2011-08-18 15:18:34 -05:00
|
|
|
swaplabel \- print or change the label or UUID of a swap area
|
2010-04-02 08:52:45 -05:00
|
|
|
.SH SYNOPSIS
|
|
|
|
.B swaplabel
|
|
|
|
.RB [ \-L
|
|
|
|
.IR label ]
|
|
|
|
.RB [ \-U
|
|
|
|
.IR UUID ]
|
|
|
|
.I device
|
|
|
|
.SH DESCRIPTION
|
|
|
|
.B swaplabel
|
2011-08-18 15:18:34 -05:00
|
|
|
will display or change the label or UUID of a swap partition located on
|
2014-04-20 19:30:27 -05:00
|
|
|
.I device
|
2010-04-02 08:52:45 -05:00
|
|
|
(or regular file).
|
|
|
|
.PP
|
|
|
|
If the optional arguments
|
2014-04-20 19:30:27 -05:00
|
|
|
.B \-L
|
2010-04-02 08:52:45 -05:00
|
|
|
and
|
2014-04-20 19:30:27 -05:00
|
|
|
.B \-U
|
2011-08-28 04:14:42 -05:00
|
|
|
are not given,
|
2010-04-02 08:52:45 -05:00
|
|
|
.B swaplabel
|
2011-08-28 04:14:42 -05:00
|
|
|
will simply display the current swap-area label and UUID of
|
2010-04-02 08:52:45 -05:00
|
|
|
.IR device .
|
|
|
|
.PP
|
|
|
|
If an optional argument is present, then
|
|
|
|
.B swaplabel
|
2011-08-28 04:14:42 -05:00
|
|
|
will change the appropriate value on
|
2010-04-02 08:52:45 -05:00
|
|
|
.IR device .
|
|
|
|
These values can also be set during swap creation using
|
|
|
|
.BR mkswap (8).
|
|
|
|
The
|
|
|
|
.B swaplabel
|
2020-07-09 20:39:09 -05:00
|
|
|
utility allows changing the label or UUID on an actively used swap device.
|
2010-04-02 08:52:45 -05:00
|
|
|
.SH OPTIONS
|
2011-08-28 04:14:42 -05:00
|
|
|
.TP
|
|
|
|
.BR \-h , " \-\-help"
|
|
|
|
Display help text and exit.
|
|
|
|
.TP
|
|
|
|
.BR \-L , " \-\-label " \fIlabel\fR
|
|
|
|
Specify a new \fIlabel\fR for the device.
|
2010-04-02 08:52:45 -05:00
|
|
|
Swap partition labels can be at most 16 characters long. If
|
2011-08-28 04:14:42 -05:00
|
|
|
.I label
|
2010-04-02 08:52:45 -05:00
|
|
|
is longer than 16 characters,
|
2011-08-28 04:14:42 -05:00
|
|
|
.B swaplabel
|
2010-04-02 08:52:45 -05:00
|
|
|
will truncate it and print a warning message.
|
2011-08-28 04:14:42 -05:00
|
|
|
.TP
|
|
|
|
.BR \-U , " \-\-uuid " \fIUUID\fR
|
|
|
|
Specify a new \fIUUID\fR for the device.
|
|
|
|
The \fI UUID\fR
|
2011-01-05 13:54:19 -06:00
|
|
|
must be in the standard 8-4-4-4-12 character format, such as is output by
|
2016-11-10 04:59:49 -06:00
|
|
|
.BR uuidgen (1).
|
2012-09-04 08:58:02 -05:00
|
|
|
.SH ENVIRONMENT
|
2014-11-03 06:13:54 -06:00
|
|
|
.IP LIBBLKID_DEBUG=all
|
|
|
|
enables libblkid debug output.
|
2020-05-21 02:28:21 -05:00
|
|
|
.SH AUTHORS
|
|
|
|
.B swaplabel
|
|
|
|
was written by Jason Borden <jborden@bluehost.com> and Karel Zak <kzak@redhat.com>.
|
2010-04-02 08:52:45 -05:00
|
|
|
.SH SEE ALSO
|
2016-11-10 04:59:27 -06:00
|
|
|
.BR uuidgen (1),
|
2010-04-02 08:52:45 -05:00
|
|
|
.BR mkswap (8),
|
2016-11-10 04:59:27 -06:00
|
|
|
.BR swapon (8)
|
2020-05-21 02:28:21 -05:00
|
|
|
.SH AVAILABILITY
|
|
|
|
The swaplabel command is part of the util-linux package and is available from
|
|
|
|
https://www.kernel.org/pub/linux/utils/util-linux/.
|