{
    "mode": "man",
    "parameter": "rcvstore",
    "section": "1",
    "url": "https://www.chedong.com/phpMan.php/man/rcvstore/1/json",
    "generated": "2026-06-03T03:49:14Z",
    "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 -unseen",
                    "content": "If you use the “Unseen-Sequence” profile entry, rcvstore could try to read and update its se‐\nquence  state while another nmh process is also trying to do so.  This can cause the sequence\nstate to lose track.  To avoid this, just between asynchronous invocations  of  rcvstore,  do\nnot  use  it  without an external locking mechanism, for example, a procmailrc(5) local lock‐\nfile, if you use the “Unseen-Sequence” profile entry.\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\n\n\nnmh-1.7.1                                    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"
        }
    ]
}