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 | .\" | |
| 5 | .TH SWAPLABEL 8 "2 April 2010" "Linux" "Linux Programmer's Manual" | |
| 6 | .SH NAME | |
| 7 | swaplabel \- Print or change the label / UUID of a swap area | |
| 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 | |
| 17 | will display or change the label / UUID of a swap partition located on | |
| 18 | .IR device | |
| 19 | (or regular file). | |
| 20 | .PP | |
| 21 | If the optional arguments | |
| 22 | .B \-L | |
| 23 | and | |
| 24 | .B \-U | |
| 25 | are not present, | |
| 26 | .B swaplabel | |
| 86af3b70 | 27 | will simply display the swap area label and UUID of |
| 4dddc2d4 JB |
28 | .IR device . |
| 29 | .PP | |
| 30 | If an optional argument is present, then | |
| 31 | .B swaplabel | |
| 32 | will change the appropriate value of | |
| 33 | .IR device . | |
| 34 | These values can also be set during swap creation using | |
| 35 | .BR mkswap (8). | |
| 36 | The | |
| 37 | .B swaplabel | |
| 38 | utility allows to change the label or UUID on actively used swap device. | |
| 39 | .SH OPTIONS | |
| 40 | .IP "\fB\-h, \-\-help\fP" | |
| 41 | Print help and exit. | |
| 42 | .IP "\fB\-L, \-\-label\fP \fIlabel\fP" | |
| 43 | Specify a new label for | |
| 44 | .IR device . | |
| 45 | Swap partition labels can be at most 16 characters long. If | |
| 46 | .IR label | |
| 47 | is longer than 16 characters, | |
| 48 | .B swapinfo | |
| 49 | will truncate it and print a warning message. | |
| 50 | .IP "\fB\-U, \-\-uuid\fP \fIuuid\fP" | |
| 51 | Specify a new UUID for | |
| 52 | .IR device . | |
| 53 | .IR UUID | |
| 16493c3e | 54 | must be in the standard 8-4-4-4-12 character format, such as is output by |
| 4dddc2d4 JB |
55 | .BR uuidgen (1) . |
| 56 | .PP | |
| 57 | .SH AUTHOR | |
| 58 | .B swaplabel | |
| 59 | was written by Jason Borden <jborden@bluehost.com> and Karel Zak <kzak@redhat.com>. | |
| 60 | .SH AVAILABILITY | |
| 61 | .B swaplabel | |
| 601d12fb | 62 | is part of the util-linux package and is available from ftp://ftp.kernel.org/pub/linux/utils/util-linux/. |
| 4dddc2d4 JB |
63 | .SH SEE ALSO |
| 64 | .BR mkswap (8), | |
| 65 | .BR swapon (8), | |
| 66 | .BR uuidgen (1) |