projects / thirdparty / util-linux.git / blame
| Commit | Line | Data |
|---|---|---|
| 4dddc2d4 JB |
1 | .\" Copyright 2010 Jason Borden <jborden@bluehost.com> |
| 2 | .\" | |
| 3 | .\" This file may be copied under the terms of the GNU Public License. | |
| 4 | .\" | |
| 232dc924 | 5 | .TH SWAPLABEL 8 "April 2010" "util-linux" "System Administration" |
| 4dddc2d4 | 6 | .SH NAME |
| 232dc924 | 7 | swaplabel \- print or change the label or UUID of a swap area |
| 4dddc2d4 JB |
8 | .SH SYNOPSIS |
| 9 | .B swaplabel | |
| 10 | .RB [ \-L | |
| 11 | .IR label ] | |
| 12 | .RB [ \-U | |
| 13 | .IR UUID ] | |
| 14 | .I device | |
| 15 | .SH DESCRIPTION | |
| 16 | .B swaplabel | |
| 232dc924 | 17 | will display or change the label or UUID of a swap partition located on |
| 46b11619 | 18 | .I device |
| 4dddc2d4 JB |
19 | (or regular file). |
| 20 | .PP | |
| 21 | If the optional arguments | |
| 46b11619 | 22 | .B \-L |
| 4dddc2d4 | 23 | and |
| 46b11619 | 24 | .B \-U |
| 449a215f | 25 | are not given, |
| 4dddc2d4 | 26 | .B swaplabel |
| 449a215f | 27 | will simply display the current swap-area label and UUID of |
| 4dddc2d4 JB |
28 | .IR device . |
| 29 | .PP | |
| 30 | If an optional argument is present, then | |
| 31 | .B swaplabel | |
| 449a215f | 32 | will change the appropriate value on |
| 4dddc2d4 JB |
33 | .IR device . |
| 34 | These values can also be set during swap creation using | |
| 35 | .BR mkswap (8). | |
| 36 | The | |
| 37 | .B swaplabel | |
| 449a215f | 38 | utility allows to change the label or UUID on an actively used swap device. |
| 4dddc2d4 | 39 | .SH OPTIONS |
| 449a215f BS |
40 | .TP |
| 41 | .BR \-h , " \-\-help" | |
| 42 | Display help text and exit. | |
| 43 | .TP | |
| 44 | .BR \-L , " \-\-label " \fIlabel\fR | |
| 45 | Specify a new \fIlabel\fR for the device. | |
| 4dddc2d4 | 46 | Swap partition labels can be at most 16 characters long. If |
| 449a215f | 47 | .I label |
| 4dddc2d4 | 48 | is longer than 16 characters, |
| 449a215f | 49 | .B swaplabel |
| 4dddc2d4 | 50 | will truncate it and print a warning message. |
| 449a215f BS |
51 | .TP |
| 52 | .BR \-U , " \-\-uuid " \fIUUID\fR | |
| 53 | Specify a new \fIUUID\fR for the device. | |
| 54 | The \fI UUID\fR | |
| 16493c3e | 55 | must be in the standard 8-4-4-4-12 character format, such as is output by |
| b2cc2a7f | 56 | .BR uuidgen (1). |
| 4dddc2d4 | 57 | .PP |
| ddfeda98 | 58 | .SH ENVIRONMENT |
| 68e422ec KZ |
59 | .IP LIBBLKID_DEBUG=all |
| 60 | enables libblkid debug output. | |
| ade04bb8 MK |
61 | .SH AUTHORS |
| 62 | .B swaplabel | |
| 63 | was written by Jason Borden <jborden@bluehost.com> and Karel Zak <kzak@redhat.com>. | |
| 4dddc2d4 | 64 | .SH SEE ALSO |
| f053ff1e | 65 | .BR uuidgen (1), |
| 4dddc2d4 | 66 | .BR mkswap (8), |
| f053ff1e | 67 | .BR swapon (8) |
| ade04bb8 MK |
68 | .SH AVAILABILITY |
| 69 | The swaplabel command is part of the util-linux package and is available from | |
| 70 | https://www.kernel.org/pub/linux/utils/util-linux/. |