# lvmpolld

## NAME



           lvmpolld — LVM poll daemon
    


## SYNOPSIS



           **lvmpolld**[**-B** |**--binary** _lvm_binary_path_] [**-f** |**--foreground**]
                    [**-h** |**--help**] [**-l** |**--log all** |**wire** |**debug**]
                    [**-p** |**--pidfile** _pidfile_path_] [**-s** |**--socket** _socket_path_]
                    [**-t** |**--timeout** _timeout_value_] [**-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 defined
           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.
    
           **-B** |**--binary** _lvm_binary_path_
                  Optional path to alternative LVM binary (default:
                  _/bin/lvm_).  Use for testing purposes only.
    
           **--dump** Contact the running lvmpolld daemon to obtain the complete
                  state and print it out in a raw format.
    
           **-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 mes‐
                  sages: 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 giv‐
                  en is zero the daemon never shutdowns on idle.
    
           **-V** |**--version**
                  Display the version of lvmpolld daemon.
    


## ENVIRONMENT VARIABLES



           **LVM_LVMPOLLD_PIDFILE**
                  Path for the pid file.
    
           **LVM_LVMPOLLD_SOCKET**
                  Path for the socket file.
    


* * *