{
    "content": [
        {
            "type": "text",
            "text": "# lvmpolld (man)\n\n## NAME\n\nlvmpolld — LVM poll daemon\n\n## SYNOPSIS\n\nlvmpolld [-l|--log all|wire|debug] [-p|--pidfile pidfilepath] [-s|--socket socketpath]\n[-B|--binary lvmbinarypath] [-t|--timeout timeoutvalue] [-f|--foreground] [-h|--help]\n[-V|--version]\nlvmpolld [--dump]\n\n## DESCRIPTION\n\nlvmpolld  is polling daemon for LVM. The daemon receives requests for polling of already ini‐\ntialised operations originating in LVM2 command line tool.  The requests for  polling  origi‐\nnate in the lvconvert, pvmove, lvchange or vgchange LVM2 commands.\n\n## TLDR\n\n> LVM poll daemon that supervises long-running LVM operations.\n\n- Start the daemon in the foreground:\n  `lvmpolld {{-f|--foreground}}`\n- Start in the foreground with debug logging:\n  `lvmpolld {{-f|--foreground}} {{-l|--log}} debug`\n- Set the idle shutdown timeout (seconds):\n  `lvmpolld {{-t|--timeout}} {{300}}`\n- Use a custom socket path:\n  `lvmpolld {{-s|--socket}} {{/tmp/lvmpolld.socket}}`\n- Use a custom PID file:\n  `lvmpolld {{-p|--pidfile}} {{/tmp/lvmpolld.pid}}`\n- Dump the current state:\n  `lvmpolld --dump`\n\n*Source: tldr-pages*\n\n## Sections\n\n- **NAME**\n- **SYNOPSIS**\n- **DESCRIPTION**\n- **OPTIONS** (8 subsections)\n- **ENVIRONMENT VARIABLES**\n- **SEE ALSO**\n\nUse structuredContent.sections for detailed options, examples, and full documentation.\n"
        }
    ],
    "structuredContent": {
        "command": "lvmpolld",
        "section": "",
        "mode": "man",
        "summary": "lvmpolld — LVM poll daemon",
        "synopsis": "lvmpolld [-l|--log all|wire|debug] [-p|--pidfile pidfilepath] [-s|--socket socketpath]\n[-B|--binary lvmbinarypath] [-t|--timeout timeoutvalue] [-f|--foreground] [-h|--help]\n[-V|--version]\nlvmpolld [--dump]",
        "tldr_summary": "LVM poll daemon that supervises long-running LVM operations.",
        "tldr_examples": [
            {
                "description": "Start the daemon in the foreground",
                "command": "lvmpolld {{-f|--foreground}}"
            },
            {
                "description": "Start in the foreground with debug logging",
                "command": "lvmpolld {{-f|--foreground}} {{-l|--log}} debug"
            },
            {
                "description": "Set the idle shutdown timeout (seconds)",
                "command": "lvmpolld {{-t|--timeout}} {{300}}"
            },
            {
                "description": "Use a custom socket path",
                "command": "lvmpolld {{-s|--socket}} {{/tmp/lvmpolld.socket}}"
            },
            {
                "description": "Use a custom PID file",
                "command": "lvmpolld {{-p|--pidfile}} {{/tmp/lvmpolld.pid}}"
            },
            {
                "description": "Dump the current state",
                "command": "lvmpolld --dump"
            }
        ],
        "tldr_source": "official",
        "flags": [
            {
                "flag": "-f",
                "long": "--foreground",
                "arg": null,
                "description": "Don't fork, but run in the foreground."
            },
            {
                "flag": "-h",
                "long": "--help",
                "arg": null,
                "description": "Show help information."
            },
            {
                "flag": "-l",
                "long": "--log",
                "arg": null,
                "description": "Select the type of log messages to generate. Messages are logged by syslog. Addi‐ tionally, when -f is given they are also sent to standard error. There are two class‐ es of messages: wire and debug. Selecting 'all' supplies both and is equivalent to a comma-separated list -l wire,debug."
            },
            {
                "flag": "-p",
                "long": "--pidfile",
                "arg": null,
                "description": "Path to the pidfile. This overrides both the built-in default (/run/lvmpolld.pid) and the environment variable LVMLVMPOLLDPIDFILE. This file is used to prevent more than one instance of the daemon running simultaneously."
            },
            {
                "flag": "-s",
                "long": "--socket",
                "arg": null,
                "description": "Path to the socket file. This overrides both the built-in default (/run/lvm/lvm‐ polld.socket) and the environment variable LVMLVMPOLLDSOCKET."
            },
            {
                "flag": "-t",
                "long": "--timeout",
                "arg": null,
                "description": "The daemon may shutdown after being idle for the given time (in seconds). When the op‐ tion is omitted or the value given is zero the daemon never shutdowns on idle."
            },
            {
                "flag": "-B",
                "long": "--binary",
                "arg": null,
                "description": "Optional path to alternative LVM binary (default: /usr/bin/lvm). Use for testing pur‐ poses only."
            },
            {
                "flag": "-V",
                "long": "--version",
                "arg": null,
                "description": "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."
            }
        ],
        "examples": [],
        "see_also": [
            {
                "name": "lvm",
                "section": "8",
                "url": "https://www.chedong.com/phpMan.php/man/lvm/8/json"
            },
            {
                "name": "lvm.conf",
                "section": "5",
                "url": "https://www.chedong.com/phpMan.php/man/lvm.conf/5/json"
            }
        ],
        "section_outline": [
            {
                "name": "NAME",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "SYNOPSIS",
                "lines": 6,
                "subsections": []
            },
            {
                "name": "DESCRIPTION",
                "lines": 13,
                "subsections": []
            },
            {
                "name": "OPTIONS",
                "lines": 3,
                "subsections": [
                    {
                        "name": "-f --foreground",
                        "lines": 2,
                        "flag": "-f",
                        "long": "--foreground"
                    },
                    {
                        "name": "-h --help",
                        "lines": 2,
                        "flag": "-h",
                        "long": "--help"
                    },
                    {
                        "name": "-l --log all",
                        "lines": 5,
                        "flag": "-l",
                        "long": "--log"
                    },
                    {
                        "name": "-p --pidfile _",
                        "lines": 4,
                        "flag": "-p",
                        "long": "--pidfile"
                    },
                    {
                        "name": "-s --socket _",
                        "lines": 3,
                        "flag": "-s",
                        "long": "--socket"
                    },
                    {
                        "name": "-t --timeout _",
                        "lines": 3,
                        "flag": "-t",
                        "long": "--timeout"
                    },
                    {
                        "name": "-B --binary _",
                        "lines": 3,
                        "flag": "-B",
                        "long": "--binary"
                    },
                    {
                        "name": "-V --version",
                        "lines": 5,
                        "flag": "-V",
                        "long": "--version"
                    }
                ]
            },
            {
                "name": "ENVIRONMENT VARIABLES",
                "lines": 6,
                "subsections": []
            },
            {
                "name": "SEE ALSO",
                "lines": 3,
                "subsections": []
            }
        ],
        "sections": {
            "NAME": {
                "content": "lvmpolld — LVM poll daemon\n",
                "subsections": []
            },
            "SYNOPSIS": {
                "content": "lvmpolld [-l|--log all|wire|debug] [-p|--pidfile pidfilepath] [-s|--socket socketpath]\n[-B|--binary lvmbinarypath] [-t|--timeout timeoutvalue] [-f|--foreground] [-h|--help]\n[-V|--version]\n\nlvmpolld [--dump]\n",
                "subsections": []
            },
            "DESCRIPTION": {
                "content": "lvmpolld  is polling daemon for LVM. The daemon receives requests for polling of already ini‐\ntialised operations originating in LVM2 command line tool.  The requests for  polling  origi‐\nnate in the lvconvert, pvmove, lvchange or vgchange LVM2 commands.\n\nThe purpose of lvmpolld is to reduce the number of spawned background processes per otherwise\nunique polling operation. There should be only one. It also eliminates the possibility of un‐\nsolicited termination of background process by external factors.\n\nlvmpolld  is  used  by  LVM  only  if  it  is  enabled in lvm.conf(5) by specifying the glob‐\nal/uselvmpolld setting. If this is not defined in the LVM configuration explicitly then  de‐\nfault setting is used instead (see the output of lvmconfig --type default global/uselvmpolld\ncommand).\n",
                "subsections": []
            },
            "OPTIONS": {
                "content": "To  run  the daemon in a test environment both the pidfilepath and the socketpath should be\nchanged from the defaults.\n",
                "subsections": [
                    {
                        "name": "-f --foreground",
                        "content": "Don't fork, but run in the foreground.\n",
                        "flag": "-f",
                        "long": "--foreground"
                    },
                    {
                        "name": "-h --help",
                        "content": "Show help information.\n",
                        "flag": "-h",
                        "long": "--help"
                    },
                    {
                        "name": "-l --log all",
                        "content": "Select the type of log messages to generate.  Messages are logged  by  syslog.   Addi‐\ntionally, when -f is given they are also sent to standard error.  There are two class‐\nes  of  messages: wire and debug. Selecting 'all' supplies both and is equivalent to a\ncomma-separated list -l wire,debug.\n",
                        "flag": "-l",
                        "long": "--log"
                    },
                    {
                        "name": "-p --pidfile _",
                        "content": "Path to the pidfile. This overrides both the built-in default (/run/lvmpolld.pid)  and\nthe environment variable LVMLVMPOLLDPIDFILE.  This file is used to prevent more than\none instance of the daemon running simultaneously.\n",
                        "flag": "-p",
                        "long": "--pidfile"
                    },
                    {
                        "name": "-s --socket _",
                        "content": "Path  to  the  socket  file.  This  overrides both the built-in default (/run/lvm/lvm‐\npolld.socket) and the environment variable LVMLVMPOLLDSOCKET.\n",
                        "flag": "-s",
                        "long": "--socket"
                    },
                    {
                        "name": "-t --timeout _",
                        "content": "The daemon may shutdown after being idle for the given time (in seconds). When the op‐\ntion is omitted or the value given is zero the daemon never shutdowns on idle.\n",
                        "flag": "-t",
                        "long": "--timeout"
                    },
                    {
                        "name": "-B --binary _",
                        "content": "Optional path to alternative LVM binary (default: /usr/bin/lvm). Use for testing  pur‐\nposes only.\n",
                        "flag": "-B",
                        "long": "--binary"
                    },
                    {
                        "name": "-V --version",
                        "content": "Display the version of lvmpolld daemon.\n\n--dump Contact the running lvmpolld daemon to obtain the complete state and print it out in a\nraw format.\n",
                        "flag": "-V",
                        "long": "--version"
                    }
                ]
            },
            "ENVIRONMENT VARIABLES": {
                "content": "LVMLVMPOLLDPIDFILE\nPath for the pid file.\n\nLVMLVMPOLLDSOCKET\nPath for the socket file.\n",
                "subsections": []
            },
            "SEE ALSO": {
                "content": "lvm(8), lvm.conf(5)\n\nRed Hat Inc                       LVM TOOLS 2.03.16(2) (2022-05-18)                      LVMPOLLD(8)",
                "subsections": []
            }
        }
    }
}