1
0
mirror of git://sourceware.org/git/lvm2.git synced 2024-12-21 13:34:40 +03:00
lvm2/man/lvmlockctl.8_main
Heinz Mauelshagen 36cac41115 man-generator/man/help: simplify hyphen escaping
Commits a29bb6a14b
    ... 5c199d99f4
narrowed down on addressing the escaping of hyphens
in the dynamic creation of manuals whilst avoiding
them in creating help texts.  This lead to a sequence
of slipping through hyphens adrressed by additional
patches in aforementioned commit series.

On the other hand, postprocessing dynamically man-generator
created and statically provided manuals catches all hyphens
in need of escaping.

Changes:
- revert the above commits whilst keeping man-generator
  streamlining and the detection of any '\' when generating
  help texts in order to avoid escapes to slip in

- Dynamically escape hyphens in manaual pages using sed(1)
  in the respective Makefile targets

- remove any manually added escaping on hyphens from any
  static manual sources or headers
2017-03-27 16:49:39 +02:00

103 lines
2.6 KiB
Plaintext

.TH "LVMLOCKCTL" "8" "LVM TOOLS #VERSION#" "Red Hat, Inc" "\""
.SH NAME
lvmlockctl \(em Control for lvmlockd
.SH DESCRIPTION
This command interacts with
.BR lvmlockd (8).
.SH OPTIONS
lvmlockctl [options]
.B --help | -h
Show this help information.
.B --quit | -q
Tell lvmlockd to quit.
.B --info | -i
Print lock state information from lvmlockd.
.B --dump | -d
Print log buffer from lvmlockd.
.B --wait | -w 0|1
Wait option for other commands.
.B --force | -f 0|1
Force option for other commands.
.B --kill | -k
.I vgname
Kill access to the VG when sanlock cannot renew lease.
.B --drop | -r
.I vgname
Clear locks for the VG when it is unused after kill (-k).
.B --gl-enable | -E
.I vgname
Tell lvmlockd to enable the global lock in a sanlock VG.
.B --gl-disable | -D
.I vgname
Tell lvmlockd to disable the global lock in a sanlock VG.
.B --stop-lockspaces | -S
Stop all lockspaces.
.SH USAGE
.SS info
This collects and displays lock state from lvmlockd. The display is
primitive, incomplete and will change in future version. To print the raw
lock state from lvmlockd, combine this option with --dump|-d.
.SS dump
This collects the circular log buffer of debug statements from lvmlockd
and prints it.
.SS kill
This is run by sanlock when it loses access to the storage holding leases
for a VG. It currently emits a syslog message stating that the VG must
be immediately deactivated. In the future it may automatically attempt to
forcibly deactivate the VG. For more, see
.BR lvmlockd (8).
.SS drop
This should only be run after a VG has been successfully deactivated
following an lvmlockctl --kill command. It clears the stale lockspace
from lvmlockd. In the future, this may become automatic along with an
automatic handling of --kill. For more, see
.BR lvmlockd (8).
.SS gl-enable
This enables the global lock in a sanlock VG. This is necessary if the VG
that previously held the global lock is removed. For more, see
.BR lvmlockd (8).
.SS gl-disable
This disables the global lock in a sanlock VG. This is necessary if the
global lock has mistakenly been enabled in more than one VG. The global
lock should be disabled in all but one sanlock VG. For more, see
.BR lvmlockd (8).
.SS stop-lockspaces
This tells lvmlockd to stop all lockspaces. It can be useful to stop
lockspaces for VGs that the vgchange --lock-stop comand can no longer
see, or to stop the dlm global lockspace which is not directly stopped by
the vgchange command. The wait and force options can be used with this
command.