mirror of
git://sourceware.org/git/lvm2.git
synced 2024-12-22 17:35:59 +03:00
107 lines
2.8 KiB
Plaintext
107 lines
2.8 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 runs the command specified in lvm.conf
|
|
lvmlockctl_kill_command to deactivate LVs in the VG. If the specified
|
|
command is successful, locks will be dropped for the VG in lvmlockd
|
|
(the equivalent of lvmlockctl --drop will be run.) If no command
|
|
is specified, or the command fails, then the user must intervene
|
|
to forcefully deactivate LVs in the VG, and if successful, run
|
|
lvmlockctl --drop. 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. When lvmlockctl_kill_command is used, the --kill
|
|
command may run drop automatically. 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.
|
|
|
|
|