1LVMPOLLD(8)                 System Manager's Manual                LVMPOLLD(8)
2
3
4

NAME

6       lvmpolld — LVM poll daemon
7

SYNOPSIS

9       lvmpolld [-l|--log all|wire|debug] [-p|--pidfile pidfile_path]
10       [-s|--socket socket_path] [-B|--binary lvm_binary_path] [-t|--timeout
11       timeout_value] [-f|--foreground] [-h|--help] [-V|--version]
12
13       lvmpolld [--dump]
14

DESCRIPTION

16       lvmpolld  is  polling  daemon for LVM. The daemon receives requests for
17       polling of already initialised operations originating in  LVM2  command
18       line  tool.   The  requests for polling originate in the lvconvert, pv‐
19       move, lvchange or vgchange LVM2 commands.
20
21       The purpose of lvmpolld is to reduce the number of  spawned  background
22       processes  per otherwise unique polling operation. There should be only
23       one. It also eliminates the possibility of unsolicited  termination  of
24       background process by external factors.
25
26       lvmpolld  is used by LVM only if it is enabled in lvm.conf(5) by speci‐
27       fying the global/use_lvmpolld setting. If this is not  defined  in  the
28       LVM  configuration explicitly then default setting is used instead (see
29       the output of lvmconfig --type default global/use_lvmpolld command).
30

OPTIONS

32       To run the daemon in a test environment both the pidfile_path  and  the
33       socket_path should be changed from the defaults.
34
35       -f|--foreground
36              Don't fork, but run in the foreground.
37
38       -h|--help
39              Show help information.
40
41       -l|--log all|wire|debug
42              Select  the  type  of  log  messages  to generate.  Messages are
43              logged by syslog.  Additionally, when -f is given they are  also
44              sent to standard error.  There are two classes of messages: wire
45              and debug. Selecting 'all' supplies both and is equivalent to  a
46              comma-separated list -l wire,debug.
47
48       -p|--pidfile pidfile_path
49              Path  to  the  pidfile. This overrides both the built-in default
50              (/run/lvmpolld.pid)  and  the  environment   variable   LVM_LVM‐
51              POLLD_PIDFILE.   This  file is used to prevent more than one in‐
52              stance of the daemon running simultaneously.
53
54       -s|--socket socket_path
55              Path to the socket file. This overrides both  the  built-in  de‐
56              fault  (/run/lvm/lvmpolld.socket)  and  the environment variable
57              LVM_LVMPOLLD_SOCKET.
58
59       -t|--timeout timeout_value
60              The daemon may shutdown after being idle for the given time  (in
61              seconds).  When the option is omitted or the value given is zero
62              the daemon never shutdowns on idle.
63
64       -B|--binary lvm_binary_path
65              Optional path to alternative LVM binary (default: /usr/bin/lvm).
66              Use for testing purposes only.
67
68       -V|--version
69              Display the version of lvmpolld daemon.
70
71       --dump Contact the running lvmpolld daemon to obtain the complete state
72              and print it out in a raw format.
73

ENVIRONMENT VARIABLES

75       LVM_LVMPOLLD_PIDFILE
76              Path for the pid file.
77
78       LVM_LVMPOLLD_SOCKET
79              Path for the socket file.
80

SEE ALSO

82       lvm(8), lvm.conf(5)
83
84
85
86Red Hat Inc            LVM TOOLS 2.03.22(2) (2023-08-02)           LVMPOLLD(8)
Impressum