LVMLOCKCTL(8)                                                  LVMLOCKCTL(8)

NAME         top

       lvmlockctl — Control for lvmlockd

DESCRIPTION         top

       This command interacts with lvmlockd(8).

OPTIONS         top

       lvmlockctl [options]

       --help | -h
               Show this help information.

       --quit | -q
               Tell lvmlockd to quit.

       --info | -i
               Print lock state information from lvmlockd.

       --dump | -d
               Print log buffer from lvmlockd.

       --wait | -w 0|1
               Wait option for other commands.

       --force | -f 0|1
               Force option for other commands.

       --kill | -k vgname
               Kill access to the VG when sanlock cannot renew lease.

       --drop | -r vgname
               Clear locks for the VG when it is unused after kill (-k).

       --gl-enable | -E vgname
               Tell lvmlockd to enable the global lock in a sanlock VG.

       --gl-disable | -D vgname
               Tell lvmlockd to disable the global lock in a sanlock VG.

       --stop-lockspaces | -S
               Stop all lockspaces.

USAGE         top

       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.

       This collects the circular log buffer of debug statements from
       lvmlockd and prints it.

       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

       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

       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 lvmlockd(8).

       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 lvmlockd(8).

       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.

COLOPHON         top

       This page is part of the lvm2 (Logical Volume Manager 2) project.
       Information about the project can be found at 
       ⟨⟩.  If you have a bug report for this
       manual page, send it to  This page was obtained
       from the project's upstream Git repository 
       ⟨⟩ on 2017-03-13.  If you
       discover any rendering problems in this HTML version of the page, or
       you believe there is a better or more up-to-date source for the page,
       or you have corrections or improvements to the information in this
       COLOPHON (which is not part of the original manual page), send a mail

Red Hat, Inc       LVM TOOLS 2.02.169(2)-git (2016-11-30)      LVMLOCKCTL(8)