LVMPOLLD(8) System Manager's Manual LVMPOLLD(8)
NAME
lvmpolld -- LVM poll daemon
SYNOPSIS
lvmpolld [-l|--log {all|wire|debug}] [-p|--pidfile pidfile_path]
[-s|--socket socket_path] [-B|--binary lvm_binary_path] [-t|--timeout
timeout_value] [-f|--foreground] [-h|--help] [-V|--version]
lvmpolld [--dump]
DESCRIPTION
lvmpolld is polling daemon for LVM. The daemon receives requests for
polling of already initialised operations originating in LVM2 command
line tool. The requests for polling originate in the lvconvert, pv-
move, lvchange or vgchange LVM2 commands.
The purpose of lvmpolld is to reduce the number of spawned background
processes per otherwise unique polling operation. There should be only
one. It also eliminates the possibility of unsolicited termination of
background process by external factors.
lvmpolld is used by LVM only if it is enabled in lvm.conf(5) by speci-
fying the global/use_lvmpolld setting. If this is not defined in the
LVM configuration explicitly then default setting is used instead (see
the output of lvmconfig --type default global/use_lvmpolld command).
OPTIONS
To run the daemon in a test environment both the pidfile_path and the
socket_path should be changed from the defaults.
-f, --foreground
Don't fork, but run in the foreground.
-h, --help
Show help information.
-l, --log {all|wire|debug}
Select the type of log messages to generate. Messages are
logged by syslog. Additionally, when -f is given they are also
sent to standard error. There are two classes of messages: wire
and debug. Selecting 'all' supplies both and is equivalent to a
comma-separated list -l wire,debug.
-p, --pidfile pidfile_path
Path to the pidfile. This overrides both the built-in default
(/run/lvmpolld.pid) and the environment variable LVM_LVM-
POLLD_PIDFILE. This file is used to prevent more than one in-
stance of the daemon running simultaneously.
-s, --socket socket_path
Path to the socket file. This overrides both the built-in de-
fault (/run/lvm/lvmpolld.socket) and the environment variable
LVM_LVMPOLLD_SOCKET.
-t, --timeout timeout_value
The daemon may shutdown after being idle for the given time (in
seconds). When the option is omitted or the value given is zero
the daemon never shutdowns on idle.
-B, --binary lvm_binary_path
Optional path to alternative LVM binary (default: /lvm). Use for
testing purposes only.
-V, --version
Display the version of lvmpolld daemon.
--dump Contact the running lvmpolld daemon to obtain the complete state
and print it out in a raw format.
ENVIRONMENT VARIABLES
LVM_LVMPOLLD_PIDFILE
Path for the pid file.
LVM_LVMPOLLD_SOCKET
Path for the socket file.
SEE ALSO
lvm(8), lvm.conf(5)
Red Hat Inc LVM TOOLS 2.03.07(2) (2019-11-30) LVMPOLLD(8)