]>
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) |