{
    "content": [
        {
            "type": "text",
            "text": "# maildirquota(7) (man)\n\n**Summary:** maildirquota - voluntary Maildir quotas\n\n**Synopsis:** maildirmake {-q} {10000000S} {./Maildir}\n\n## Flags\n\n| Flag | Long | Arg | Description |\n|------|------|-----|-------------|\n| -f | — | — | the directory name of the maildir folder. Quota enforcement will not work if you do that. |\n\n## See Also\n\n- maildrop(1)\n- maildirmake(1)\n- maildropfilter(5)\n- deliverquota(8)\n\n## Section Outline\n\n- **NAME** (2 lines)\n- **SYNOPSIS** (2 lines)\n- **DESCRIPTION** (51 lines) — 1 subsections\n  - -f (2 lines)\n- **SEE ALSO** (2 lines)\n- **AUTHOR** (1 lines) — 1 subsections\n  - Sam Varshavchik (2 lines)\n- **NOTES** (15 lines)\n\n## Full Content\n\n### NAME\n\nmaildirquota - voluntary Maildir quotas\n\n### SYNOPSIS\n\nmaildirmake {-q} {10000000S} {./Maildir}\n\n### DESCRIPTION\n\nmaildrop has a manual quota enforcement implementation that does use the quota facilities of\nthe host operating system (filesystem-based quotas). This is an option that is set at\nconfiguration time, and may be disabled.\n\nUsing filesystem quotas sometimes leads to problems. After a hard quota is hit, most commands\nissued by mail clients fail, including some commands that poorly-written mail software may\nnot expect to fail, and therefore be unable to gracefully handle the unexpected failure.\n\nWith manual quotas, the only operations that fail are the ones that most mail clients expect\nto fail, when the mailbox is full. However, filesystem-based quotas cannot be used in some\nsituations, such as virtual mailboxes. If this experimental feature is enabled, approximate\nquota enforcement can be implemented by maildrop or deliverquota to whatever extent it's\npossible to do so. Quotas are enabled by the -q option to maildirmake. Both maildrop and\ndeliverquota will observe any maildirmake-requested quota.\n\nLIMITATIONS\nThis quota mechanism will only work as long as maildrop (or deliverquota) are the only\napplications that deliver messages to the maildir, or as long as other applications implement\nthe same quota enforcement mechanism. The quota enforcement mechanism is described separately\nin the README.maildirquota.html file in the source code distribution.\n\nQuota enforcement will still work, to some extent, if there are other applications that\ndeliver or modify messages in the maildir. However, quota enforcement may not kick in\nimmediately when the maildir goes over quota, in fact the maildir can go over quota by a\nnoticeable amount. But eventually, as long as maildrop or deliverquota are responsible for\ndelivering the majority of messages, quota enforcement will kick in. Also, other sources of\nmessages may also result in noticeable performance degradation, because quote recalculation\nwill become noticeably more expensive.\n\nAlso keep in mind that this quota mechanism is generally useless if mail recipients have\ndirect access to their maildirs.\n\nFinally even under the best conditions this quota enforcement does have a small chance of a\nrace condition where a maildir will go over quota by some amount. maildirs are designed for\nspeed, and this quota implementation was designed to have as little additional overhead as\npossible, compared to regular maildirs. To enforce an exact quota you would have to use some\nkind of a locking facility, which will impose a drastic performance degradation on the\noverall maildir performance. A decision has been made to avoid locking, with the only\nnegative side effect being a possibility of going over quota in very low probability\nsituations.\n\nA way to minimize the risk of going over quota is to set reasonable quotas, in relation to\nmaximum message sizes supported by your mail server. If you set your maildir quota to five\ngigabytes, for example, it makes very little sense to configure your mail server to accept\nmessages up to three gigabytes in size. Your maildir quota should be chosen so that it makes\nsense when compared to the maximum message size allowed by your mail server.\n\nFOLDERS\nThis quota implementation is compatible with a popular extension to maildir which defines\nindividual mail folders within a single maildir. However, in order to create a compatible\nfolder, you MUST use the maildirmake command that comes with maildrop, and you MUST use the\n\n#### -f\n\nthe directory name of the maildir folder. Quota enforcement will not work if you do that.\n\n### SEE ALSO\n\nmaildrop(1)[1], maildirmake(1)[2], maildropfilter(5)[3], deliverquota(8)[4].\n\n### AUTHOR\n\n#### Sam Varshavchik\n\nAuthor\n\n### NOTES\n\n1. maildrop(1)\nhttp://www.courier-mta.org/maildrop.html\n\n2. maildirmake(1)\nhttp://www.courier-mta.org/maildirmake.html\n\n3. maildropfilter(5)\nhttp://www.courier-mta.org/maildropfilter.html\n\n4. deliverquota(8)\nhttp://www.courier-mta.org/deliverquota.html\n\n\n\nCourier Mail Server                          07/24/2017                              MAILDIRQUOTA(7)\n\n"
        }
    ],
    "structuredContent": {
        "command": "maildirquota",
        "section": "7",
        "mode": "man",
        "summary": "maildirquota - voluntary Maildir quotas",
        "synopsis": "maildirmake {-q} {10000000S} {./Maildir}",
        "flags": [
            {
                "flag": "-f",
                "long": null,
                "arg": null,
                "description": "the directory name of the maildir folder. Quota enforcement will not work if you do that."
            }
        ],
        "examples": [],
        "see_also": [
            {
                "name": "maildrop",
                "section": "1",
                "url": "https://www.chedong.com/phpMan.php/man/maildrop/1/json"
            },
            {
                "name": "maildirmake",
                "section": "1",
                "url": "https://www.chedong.com/phpMan.php/man/maildirmake/1/json"
            },
            {
                "name": "maildropfilter",
                "section": "5",
                "url": "https://www.chedong.com/phpMan.php/man/maildropfilter/5/json"
            },
            {
                "name": "deliverquota",
                "section": "8",
                "url": "https://www.chedong.com/phpMan.php/man/deliverquota/8/json"
            }
        ],
        "section_outline": [
            {
                "name": "NAME",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "SYNOPSIS",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "DESCRIPTION",
                "lines": 51,
                "subsections": [
                    {
                        "name": "-f",
                        "lines": 2,
                        "flag": "-f"
                    }
                ]
            },
            {
                "name": "SEE ALSO",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "AUTHOR",
                "lines": 1,
                "subsections": [
                    {
                        "name": "Sam Varshavchik",
                        "lines": 2
                    }
                ]
            },
            {
                "name": "NOTES",
                "lines": 15,
                "subsections": []
            }
        ]
    }
}