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.
|
|
|
|
.\"
|
|
|
|
.TH SWAPLABEL 8 "2 April 2010" "Linux" "Linux Programmer's Manual"
|
|
|
|
.SH NAME
|
|
|
|
swaplabel \- Print or change the label / UUID of a swap area
|
|
|
|
.SH SYNOPSIS
|
|
|
|
.B swaplabel
|
|
|
|
.RB [ \-L
|
|
|
|
.IR label ]
|
|
|
|
.RB [ \-U
|
|
|
|
.IR UUID ]
|
|
|
|
.I device
|
|
|
|
.SH DESCRIPTION
|
|
|
|
.B swaplabel
|
|
|
|
will display or change the label / UUID of a swap partition located on
|
|
|
|
.IR device
|
|
|
|
(or regular file).
|
|
|
|
.PP
|
|
|
|
If the optional arguments
|
|
|
|
.B \-L
|
|
|
|
and
|
|
|
|
.B \-U
|
|
|
|
are not present,
|
|
|
|
.B swaplabel
|
2010-04-07 09:37:59 -05:00
|
|
|
will simply display the 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
|
|
|
|
will change the appropriate value of
|
|
|
|
.IR device .
|
|
|
|
These values can also be set during swap creation using
|
|
|
|
.BR mkswap (8).
|
|
|
|
The
|
|
|
|
.B swaplabel
|
|
|
|
utility allows to change the label or UUID on actively used swap device.
|
|
|
|
.SH OPTIONS
|
|
|
|
.IP "\fB\-h, \-\-help\fP"
|
|
|
|
Print help and exit.
|
|
|
|
.IP "\fB\-L, \-\-label\fP \fIlabel\fP"
|
|
|
|
Specify a new label for
|
|
|
|
.IR device .
|
|
|
|
Swap partition labels can be at most 16 characters long. If
|
|
|
|
.IR label
|
|
|
|
is longer than 16 characters,
|
|
|
|
.B swapinfo
|
|
|
|
will truncate it and print a warning message.
|
|
|
|
.IP "\fB\-U, \-\-uuid\fP \fIuuid\fP"
|
|
|
|
Specify a new UUID for
|
|
|
|
.IR device .
|
|
|
|
.IR UUID
|
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
|
2010-04-02 08:52:45 -05:00
|
|
|
.BR uuidgen (1) .
|
|
|
|
.PP
|
|
|
|
.SH AUTHOR
|
|
|
|
.B swaplabel
|
|
|
|
was written by Jason Borden <jborden@bluehost.com> and Karel Zak <kzak@redhat.com>.
|
|
|
|
.SH AVAILABILITY
|
|
|
|
.B swaplabel
|
2010-11-30 04:41:59 -06:00
|
|
|
is part of the util-linux package and is available from ftp://ftp.kernel.org/pub/linux/utils/util-linux/.
|
2010-04-02 08:52:45 -05:00
|
|
|
.SH SEE ALSO
|
|
|
|
.BR mkswap (8),
|
|
|
|
.BR swapon (8),
|
|
|
|
.BR uuidgen (1)
|