NAME

       lvmlockctl — Control for lvmlockd

DESCRIPTION

       This command interacts with lvmlockd(8).

OPTIONS

       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

   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.

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

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

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

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

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

   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.