{
    "mode": "man",
    "parameter": "rcvstore",
    "section": "1",
    "url": "https://www.chedong.com/phpMan.php/man/rcvstore/1/json",
    "generated": "2026-11-08T04:56:05Z",
    "synopsis": "/usr/lib/mh/rcvstore [-help] [-version] [+folder] [-create | -nocreate] [-unseen | -nounseen]\n[-zero | -nozero] [-sequence name ...]  [-public | -nopublic]",
    "sections": {
        "NAME": {
            "content": "rcvstore - asynchronously incorporate mail into an nmh folder\n",
            "subsections": []
        },
        "SYNOPSIS": {
            "content": "/usr/lib/mh/rcvstore [-help] [-version] [+folder] [-create | -nocreate] [-unseen | -nounseen]\n[-zero | -nozero] [-sequence name ...]  [-public | -nopublic]\n",
            "subsections": []
        },
        "DESCRIPTION": {
            "content": "rcvstore  incorporates a message from the standard input into an nmh folder.  This command is\ntypically used in conjunction with mail filtering programs such as slocal  and  procmail,  to\nfilter your mail into different folders.\n\nYou  may  specify which folder to use with +folder.  If no folder is specified, rcvstore will\nuse the folder given by a non-empty “Inbox:” entry in the user's profile, else  it  will  use\nthe folder named “inbox”.\n\nIf  the  switch -create is given (it is the default) and if the specified (or default) folder\ndoes not exist, then it will be created.  You may disable this with the -nocreate option.  In\nthis case rcvstore will exit if the specified folder does not exist.\n\nWhen the new message is incorporated into the folder, it is assigned the next highest  number\nfor that folder.\n\nrcvstore  will  incorporate  anything except zero length messages into the user's nmh folder.\nIt will not change the message in any way.\n\nIf the user's profile contains a “Msg-Protect: nnn” entry, it will be used  as  the  mode  to\nuse,  in  octal,  on  the  newly created message, otherwise the nmh default mode of 0600, see\nchmod(1), will be used (on filesystems that support it).  For all  subsequent  operations  on\nthis message, this initially assigned mode will be preserved.\n\nIf  the  switch  -unseen is given (it is on by default), and if the profile entry “Unseen-Se‐\nquence” is present and non-empty, then rcvstore will add the newly  incorporated  message  to\neach sequence named by this profile entry.  You may use the switch -nounseen to disable this.\nThese sequences will not be zeroed by rcvstore prior to adding the new message.\n\nFurthermore, the incoming messages may be added to additional sequences as they arrive by the\nuse  of  the  -sequence  switch.   As  with  the commands pick and mark, you may also use the\nswitches -zero and -nozero to specify whether to zero old sequences or not.   Similarly,  use\nof  the  -public  and -nopublic switches may be used to force these sequences to be public or\nprivate sequences.\n",
            "subsections": [
                {
                    "name": "Locking and sequences",
                    "content": "If you use the “Unseen-Sequence” profile entry, or if you use the -sequence  argument,  rcvs‐\ntore  might  try  to update its sequence state while another nmh process is also trying to do\nso.  This can cause one of those updates to be lost.  To avoid this (just  between  asynchro‐\nnous  invocations  of  rcvstore),  always use it with an external locking mechanism.  A proc‐\nmailrc(5) local lockfile would work, or if not using procmail, then consider  using  dotlock‐\nfile(1) or flock(1).\n"
                }
            ]
        },
        "FILES": {
            "content": "$HOME/.mhprofile          The user profile\n",
            "subsections": []
        },
        "PROFILE COMPONENTS": {
            "content": "Path:                To determine the user's nmh directory\nFolder-Protect:      To set mode when creating a new folder\nInbox:               To find the default inbox\nMsg-Protect:         To set mode when creating a new message\nUnseen-Sequence:     To name sequences denoting unseen messages\n",
            "subsections": []
        },
        "SEE ALSO": {
            "content": "mh-sequence(5), procmailex(5), procmailrc(5), rcvdist(1), rcvpack(1), rcvtty(1)\n",
            "subsections": []
        },
        "DEFAULTS": {
            "content": "`+folder' defaults to “Inbox” profile entry\n`-create'\n`-unseen'\n`-nozero'\n",
            "subsections": []
        },
        "CONTEXT": {
            "content": "No context changes will be attempted, with the exception of sequence manipulation.\n\nnmh-1.8                                      2013-02-19                                RCVSTORE(1mh)",
            "subsections": []
        }
    },
    "summary": "rcvstore - asynchronously incorporate mail into an nmh folder",
    "flags": [],
    "examples": [],
    "see_also": [
        {
            "name": "mh-sequence",
            "section": "5",
            "url": "https://www.chedong.com/phpMan.php/man/mh-sequence/5/json"
        },
        {
            "name": "procmailex",
            "section": "5",
            "url": "https://www.chedong.com/phpMan.php/man/procmailex/5/json"
        },
        {
            "name": "procmailrc",
            "section": "5",
            "url": "https://www.chedong.com/phpMan.php/man/procmailrc/5/json"
        },
        {
            "name": "rcvdist",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/rcvdist/1/json"
        },
        {
            "name": "rcvpack",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/rcvpack/1/json"
        },
        {
            "name": "rcvtty",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/rcvtty/1/json"
        }
    ]
}