lvmpolld(8) — Linux manual page
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 lv‐
convert, pvmove, lvchange or vgchange LVM2 commands.
The purpose of lvmpolld is to reduce the number of spawned back‐
ground processes per otherwise unique polling operation. There
should be only one. It also eliminates the possibility of unso‐
licited termination of background process by external factors.
lvmpolld is used by LVM only if it is enabled in lvm.conf(5) by
specifying the global/use_lvmpolld setting. If this is not de‐
fined in the LVM configuration explicitly then default setting is
used instead (see the output of lvmconfig --type default glob‐
al/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 de‐
fault (/run/lvmpolld.pid) and the environment variable
LVM_LVMPOLLD_PIDFILE. This file is used to prevent more
than one instance of the daemon running simultaneously.
-s|--socket socket_path
Path to the socket file. This overrides both the built-in
default (/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:
/bin/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)
COLOPHON
This page is part of the lvm2 (Logical Volume Manager 2) project.
Information about the project can be found at
⟨http://www.sourceware.org/lvm2/⟩. If you have a bug report for
this manual page, see ⟨https://github.com/lvmteam/lvm2/issues⟩.
This page was obtained from the project's upstream Git repository
⟨git://sourceware.org/git/lvm2.git⟩ on 2024-06-14. (At that
time, the date of the most recent commit that was found in the
repository was 2024-06-11.) 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 to
man-pages@man7.org
Red Hat Inc LVM TOOLS 2.03.15(2)-git (2021-10-20) LVMPOLLD(8)
Pages that refer to this page: lvchange(8), lvconvert(8), lvcreate(8), lvdisplay(8), lvextend(8), lvm(8), lvmconfig(8), lvmdevices(8), lvmdiskscan(8), lvmdump(8), lvm-fullreport(8), lvm-lvpoll(8), lvreduce(8), lvremove(8), lvrename(8), lvresize(8), lvs(8), lvscan(8), pvchange(8), pvck(8), pvcreate(8), pvdisplay(8), pvmove(8), pvremove(8), pvresize(8), pvs(8), pvscan(8), vgcfgbackup(8), vgcfgrestore(8), vgchange(8), vgck(8), vgconvert(8), vgcreate(8), vgdisplay(8), vgexport(8), vgextend(8), vgimport(8), vgimportclone(8), vgimportdevices(8), vgmerge(8), vgmknodes(8), vgreduce(8), vgremove(8), vgrename(8), vgs(8), vgscan(8), vgsplit(8)