mirror of
git://sourceware.org/git/lvm2.git
synced 2025-03-11 20:58:50 +03:00
353718785f
With to use .TP where it's easy and doesn't change layout (since .HP is marked as deprecated) - but .TP is not always perfetc match. Avoid submitting empty lines to troff and replace them mostly with .P and use '.' at line start to preserve 'visual' presence of empty line while editing man page manually when there is no extra space needed. Fix some markup. Add some missing SEE ALSO section. Drop some white-space at end-of-lines. Improve hyphenation logic so we do not split options. Use '.IP numbers' only with first one the row (others in row automatically derive this value) Use automatic enumeration for .SH titles. Guidelines in-use: https://man7.org/linux/man-pages/man7/groff.7.html https://www.gnu.org/software/groff/manual/html_node/Man-usage.html https://www.gnu.org/software/groff/manual/html_node/Lists-in-ms.html
120 lines
2.9 KiB
Plaintext
120 lines
2.9 KiB
Plaintext
.TH "LVMLOCKCTL" "8" "LVM TOOLS #VERSION#" "Red Hat, Inc" "\""
|
|
.
|
|
.SH NAME
|
|
.
|
|
lvmlockctl \(em Control for lvmlockd
|
|
.
|
|
.SH SYNOPSIS
|
|
.
|
|
.BR lvmlockctl " [" \fIoptions ]
|
|
.
|
|
.SH DESCRIPTION
|
|
.
|
|
This command interacts with
|
|
.BR lvmlockd (8).
|
|
.
|
|
.SH OPTIONS
|
|
.
|
|
.TP
|
|
.BR -h | --help
|
|
Show this help information.
|
|
.
|
|
.TP
|
|
.BR -q | --quit
|
|
Tell lvmlockd to quit.
|
|
.
|
|
.TP
|
|
.BR -i | --info
|
|
Print lock state information from lvmlockd.
|
|
.
|
|
.TP
|
|
.BR -d | --dump
|
|
Print log buffer from lvmlockd.
|
|
.
|
|
.TP
|
|
.BR -w | --wait\ 0 | 1
|
|
Wait option for other commands.
|
|
.
|
|
.TP
|
|
.BR -f | --force\ 0 | 1
|
|
Force option for other commands.
|
|
.
|
|
.TP
|
|
.BR -k | --kill " " \fIvgname
|
|
Kill access to the VG when sanlock cannot renew lease.
|
|
.
|
|
.TP
|
|
.BR -r | --drop " " \fIvgname
|
|
Clear locks for the VG when it is unused after kill (-k).
|
|
.
|
|
.TP
|
|
.BR -E | --gl-enable " " \fIvgname
|
|
Tell lvmlockd to enable the global lock in a sanlock VG.
|
|
.
|
|
.TP
|
|
.BR -D | --gl-disable " " \fIvgname
|
|
Tell lvmlockd to disable the global lock in a sanlock VG.
|
|
.
|
|
.TP
|
|
.BR -S | --stop-lockspaces
|
|
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.
|
|
.
|
|
.SH SEE ALSO
|
|
.
|
|
.BR lvm (8),
|
|
.BR lvmlockd (8)
|