disk-utils/swaplabel.8.adoc

   1 //po4a: entry man manual
   2 ////
   3 Copyright 2010 Jason Borden <jborden@bluehost.com>
   4 This file may be copied under the terms of the GNU Public License.
   5 ////
   6 = swaplabel(8)
   7 :doctype: manpage
   8 :man manual: System Administration
   9 :man source: util-linux {release-version}
  10 :page-layout: base
  11 :command: swaplabel
  12
  13 == NAME
  14
  15 swaplabel - print or change the label or UUID of a swap area
  16
  17 == SYNOPSIS
  18
  19 *swaplabel* [*-L* _label_] [*-U* _UUID_] _device_
  20
  21 == DESCRIPTION
  22
  23 *swaplabel* will display or change the label or UUID of a swap partition located on _device_ (or regular file).
  24
  25 If the optional arguments *-L* and *-U* are not given, *swaplabel* will simply display the current swap-area label and UUID of _device_.
  26
  27 If an optional argument is present, then *swaplabel* will change the appropriate value on _device_. These values can also be set during swap creation using *mkswap*(8). The *swaplabel* utility allows changing the label or UUID on an actively used swap device.
  28
  29 == OPTIONS
  30
  31 include::man-common/help-version.adoc[]
  32
  33 *-L*, *--label* _label_::
  34   Specify a new _label_ for the device. Swap partition labels can be at most 16 characters long. If _label_ is longer than 16 characters, *swaplabel* will truncate it and print a warning message.
  35
  36 *-U*, *--uuid* _UUID_::
  37   Specify a new _UUID_ for the device. The _UUID_ must be in the standard 8-4-4-4-12 character format, such as is output by *uuidgen*(1).
  38
  39 == ENVIRONMENT
  40
  41 LIBBLKID_DEBUG=all::
  42   enables libblkid debug output.
  43
  44 == AUTHORS
  45
  46 *swaplabel* was written by mailto:jborden@bluehost.com[Jason Borden] and mailto:kzak@redhat.com[Karel Zak].
  47
  48 == SEE ALSO
  49
  50 *uuidgen*(1),
  51 *mkswap*(8),
  52 *swapon*(8)
  53
  54 include::man-common/bugreports.adoc[]
  55
  56 include::man-common/footer.adoc[]
  57
  58 ifdef::translation[]
  59 include::man-common/translation.adoc[]
  60 endif::[]