{
    "content": [
        {
            "type": "text",
            "text": "# dotlock.mailutils(1) (man)\n\n**Summary:** dotlock.mailutils - lock mail spool files.\n\n**Synopsis:** dotlock.mailutils [OPTION...] FILE\n\n## Flags\n\n| Flag | Long | Arg | Description |\n|------|------|-----|-------------|\n| -d | — | — | print details of failure reasons to stderr |\n| -f | --force | — | forcibly break an existing lock older than a certain time |\n| -p | — | — | check if the PID of lock owner is still active |\n| -r | --retry | — | retry the lock a few times |\n| -t | --delay | — | delay between two successive locking attempts (in seconds) |\n| -u | — | — | unlock Global debugging settings --debug-level=LEVEL set Mailutils debugging level --[no-]debug-line-info show source in |\n| — | --config-lint | — | check configuration file syntax and exit |\n| — | --config-verbose | — | verbosely log parsing of the configuration files |\n| — | --no-config | — | do not load site and user configuration files |\n| — | --no-site-config | — | do not load site-wide configuration file |\n| — | --no-user-config | — | do not load user configuration file --set=PARAM=VALUE set configuration parameter Informational options |\n| — | --config-help | — | show configuration file summary |\n| — | --show-config-options | — | show compilation options -?, --help give this help list |\n| — | --usage | — | give a short usage message |\n| -V | --version | — | print program version Mandatory or optional arguments to long options are also mandatory or optional for any corre‐ spon |\n\n## See Also\n\n- DOTLOCK.MAILUTILS(1)\n\n## Section Outline\n\n- **NAME** (2 lines)\n- **SYNOPSIS** (2 lines)\n- **DESCRIPTION** (2 lines) — 15 subsections\n  - -d --[no-]debug (2 lines)\n  - -f --force (2 lines)\n  - -p --[no-]pid-check (2 lines)\n  - -r --retry (2 lines)\n  - -t --delay (2 lines)\n  - -u --[no-]unlock (14 lines)\n  - --config-lint (2 lines)\n  - --config-verbose (2 lines)\n  - --no-config (2 lines)\n  - --no-site-config (2 lines)\n  - --no-user-config (7 lines)\n  - --config-help (2 lines)\n  - --show-config-options (5 lines)\n  - --usage (2 lines)\n  - -V --version (8 lines)\n- **REPORTING BUGS** (4 lines)\n- **COPYRIGHT** (5 lines)\n- **SEE ALSO** (14 lines)\n\n## Full Content\n\n### NAME\n\ndotlock.mailutils - lock mail spool files.\n\n### SYNOPSIS\n\ndotlock.mailutils [OPTION...] FILE\n\n### DESCRIPTION\n\nGNU dotlock -- lock mail spool files.\n\n#### -d --[no-]debug\n\nprint details of failure reasons to stderr\n\n#### -f --force\n\nforcibly break an existing lock older than a certain time\n\n#### -p --[no-]pid-check\n\ncheck if the PID of lock owner is still active\n\n#### -r --retry\n\nretry the lock a few times\n\n#### -t --delay\n\ndelay between two successive locking attempts (in seconds)\n\n#### -u --[no-]unlock\n\nunlock\n\nGlobal debugging settings\n\n--debug-level=LEVEL\nset Mailutils debugging level\n\n--[no-]debug-line-info show source info with debugging messages\n\nConfiguration handling\n\n--config-file=FILE\nload this configuration file; implies --no-config\n\n#### --config-lint\n\ncheck configuration file syntax and exit\n\n#### --config-verbose\n\nverbosely log parsing of the configuration files\n\n#### --no-config\n\ndo not load site and user configuration files\n\n#### --no-site-config\n\ndo not load site-wide configuration file\n\n#### --no-user-config\n\ndo not load user configuration file\n\n--set=PARAM=VALUE\nset configuration parameter\n\nInformational options\n\n#### --config-help\n\nshow configuration file summary\n\n#### --show-config-options\n\nshow compilation options\n\n-?, --help\ngive this help list\n\n#### --usage\n\ngive a short usage message\n\n#### -V --version\n\nprint program version\n\nMandatory or optional arguments to long options are also mandatory or optional for any corre‐\nsponding short options.\n\nReturns 0 on success, 3 if locking the file fails because it's already locked, and 1 if  some\nother kind of error occurred.\n\n### REPORTING BUGS\n\nReport bugs to <bug-mailutils@gnu.org>.\nGNU Mailutils home page: <http://mailutils.org>\nGeneral help using GNU software: <http://www.gnu.org/gethelp/>\n\n### COPYRIGHT\n\nCopyright  ©  2007-2022  Free Software Foundation, inc.  License GPLv3+: GNU GPL version 3 or\nlater <http://gnu.org/licenses/gpl.html>\nThis is free software: you are free to change and redistribute it.  There is NO WARRANTY,  to\nthe extent permitted by law.\n\n### SEE ALSO\n\nThe complete GNU mailutils documentation is maintained as a Texinfo manual. If the mailutils-\ndoc package is installed, the command\n\ninfo mailutils\n\nshould give you access to the complete manual.\nYou can also find this manual online in the GNU mailutils webpage:\nhttps://www.gnu.org/software/mailutils/manual/index.html.\nPlease note this manpage was automatically generated by the Debian  mailutils  packagers.  Do\nnot file bugs for its content to the GNU Mailutils upstream authors.\n\n\n\nFSF                                         January 2022                        DOTLOCK.MAILUTILS(1)\n\n"
        }
    ],
    "structuredContent": {
        "command": "dotlock.mailutils",
        "section": "1",
        "mode": "man",
        "summary": "dotlock.mailutils - lock mail spool files.",
        "synopsis": "dotlock.mailutils [OPTION...] FILE",
        "tldr_summary": null,
        "tldr_examples": [],
        "tldr_source": null,
        "flags": [
            {
                "flag": "-d",
                "long": null,
                "arg": null,
                "description": "print details of failure reasons to stderr"
            },
            {
                "flag": "-f",
                "long": "--force",
                "arg": null,
                "description": "forcibly break an existing lock older than a certain time"
            },
            {
                "flag": "-p",
                "long": null,
                "arg": null,
                "description": "check if the PID of lock owner is still active"
            },
            {
                "flag": "-r",
                "long": "--retry",
                "arg": null,
                "description": "retry the lock a few times"
            },
            {
                "flag": "-t",
                "long": "--delay",
                "arg": null,
                "description": "delay between two successive locking attempts (in seconds)"
            },
            {
                "flag": "-u",
                "long": null,
                "arg": null,
                "description": "unlock Global debugging settings --debug-level=LEVEL set Mailutils debugging level --[no-]debug-line-info show source info with debugging messages Configuration handling --config-file=FILE load this configuration file; implies --no-config"
            },
            {
                "flag": "",
                "long": "--config-lint",
                "arg": null,
                "description": "check configuration file syntax and exit"
            },
            {
                "flag": "",
                "long": "--config-verbose",
                "arg": null,
                "description": "verbosely log parsing of the configuration files"
            },
            {
                "flag": "",
                "long": "--no-config",
                "arg": null,
                "description": "do not load site and user configuration files"
            },
            {
                "flag": "",
                "long": "--no-site-config",
                "arg": null,
                "description": "do not load site-wide configuration file"
            },
            {
                "flag": "",
                "long": "--no-user-config",
                "arg": null,
                "description": "do not load user configuration file --set=PARAM=VALUE set configuration parameter Informational options"
            },
            {
                "flag": "",
                "long": "--config-help",
                "arg": null,
                "description": "show configuration file summary"
            },
            {
                "flag": "",
                "long": "--show-config-options",
                "arg": null,
                "description": "show compilation options -?, --help give this help list"
            },
            {
                "flag": "",
                "long": "--usage",
                "arg": null,
                "description": "give a short usage message"
            },
            {
                "flag": "-V",
                "long": "--version",
                "arg": null,
                "description": "print program version Mandatory or optional arguments to long options are also mandatory or optional for any corre‐ sponding short options. Returns 0 on success, 3 if locking the file fails because it's already locked, and 1 if some other kind of error occurred."
            }
        ],
        "examples": [],
        "see_also": [
            {
                "name": "DOTLOCK.MAILUTILS",
                "section": "1",
                "url": "https://www.chedong.com/phpMan.php/man/DOTLOCK.MAILUTILS/1/json"
            }
        ],
        "section_outline": [
            {
                "name": "NAME",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "SYNOPSIS",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "DESCRIPTION",
                "lines": 2,
                "subsections": [
                    {
                        "name": "-d --[no-]debug",
                        "lines": 2,
                        "flag": "-d"
                    },
                    {
                        "name": "-f --force",
                        "lines": 2,
                        "flag": "-f",
                        "long": "--force"
                    },
                    {
                        "name": "-p --[no-]pid-check",
                        "lines": 2,
                        "flag": "-p"
                    },
                    {
                        "name": "-r --retry",
                        "lines": 2,
                        "flag": "-r",
                        "long": "--retry"
                    },
                    {
                        "name": "-t --delay",
                        "lines": 2,
                        "flag": "-t",
                        "long": "--delay"
                    },
                    {
                        "name": "-u --[no-]unlock",
                        "lines": 14,
                        "flag": "-u"
                    },
                    {
                        "name": "--config-lint",
                        "lines": 2,
                        "long": "--config-lint"
                    },
                    {
                        "name": "--config-verbose",
                        "lines": 2,
                        "long": "--config-verbose"
                    },
                    {
                        "name": "--no-config",
                        "lines": 2,
                        "long": "--no-config"
                    },
                    {
                        "name": "--no-site-config",
                        "lines": 2,
                        "long": "--no-site-config"
                    },
                    {
                        "name": "--no-user-config",
                        "lines": 7,
                        "long": "--no-user-config"
                    },
                    {
                        "name": "--config-help",
                        "lines": 2,
                        "long": "--config-help"
                    },
                    {
                        "name": "--show-config-options",
                        "lines": 5,
                        "long": "--show-config-options"
                    },
                    {
                        "name": "--usage",
                        "lines": 2,
                        "long": "--usage"
                    },
                    {
                        "name": "-V --version",
                        "lines": 8,
                        "flag": "-V",
                        "long": "--version"
                    }
                ]
            },
            {
                "name": "REPORTING BUGS",
                "lines": 4,
                "subsections": []
            },
            {
                "name": "COPYRIGHT",
                "lines": 5,
                "subsections": []
            },
            {
                "name": "SEE ALSO",
                "lines": 14,
                "subsections": []
            }
        ]
    }
}