# rcvstore - man(1) - [phpMan]

[_RCVSTORE_(1mh)](https://www.chedong.com/phpMan.php/man/RCVSTORE/1mh/markdown)                                                                          [_RCVSTORE_(1mh)](https://www.chedong.com/phpMan.php/man/RCVSTORE/1mh/markdown)

## NAME
       rcvstore - asynchronously incorporate mail into an nmh folder

## SYNOPSIS


       **/usr/lib/mh/rcvstore **[**-help**] [**-version**] [_+folder_] [**-create **| **-nocreate**] [**-unseen **| **-nounseen**]
            [**-zero **| **-nozero**] [**-sequence _**name_ ...]  [**-public **| **-nopublic**]

## DESCRIPTION
       **rcvstore  **incorporates a message from the standard input into an **nmh **folder.  This command is
       typically used in conjunction with mail filtering programs such as **slocal  **and  **procmail**,  to
       filter your mail into different folders.

       You  may  specify which folder to use with _+folder_.  If no folder is specified, **rcvstore **will
       use the folder given by a non-empty “Inbox:” entry in the user's profile, else  it  will  use
       the folder named “inbox”.

       If  the  switch **-create **is given (it is the default) and if the specified (or default) folder
       does not exist, then it will be created.  You may disable this with the **-nocreate **option.  In
       this case **rcvstore **will exit if the specified folder does not exist.

       When the new message is incorporated into the folder, it is assigned the next highest  number
       for that folder.

       **rcvstore  **will  incorporate  anything except zero length messages into the user's **nmh **folder.
       It will not change the message in any way.

       If the user's profile contains a “_Msg-Protect:_ _nnn_” entry, it will be used  as  the  mode  to
       use,  in  octal,  on  the  newly created message, otherwise the **nmh **default mode of 0600, see
       [_chmod_(1)](https://www.chedong.com/phpMan.php/man/chmod/1/markdown), will be used (on filesystems that support it).  For all  subsequent  operations  on
       this message, this initially assigned mode will be preserved.

       If  the  switch  **-unseen **is given (it is on by default), and if the profile entry “Unseen-Se‐
       quence” is present and non-empty, then **rcvstore **will add the newly  incorporated  message  to
       each sequence named by this profile entry.  You may use the switch **-nounseen **to disable this.
       These sequences will not be zeroed by **rcvstore **prior to adding the new message.

       Furthermore, the incoming messages may be added to additional sequences as they arrive by the
       use  of  the  **-sequence  **switch.   As  with  the commands **pick **and **mark**, you may also use the
       switches **-zero **and **-nozero **to specify whether to zero old sequences or not.   Similarly,  use
       of  the  **-public  **and **-nopublic **switches may be used to force these sequences to be public or
       private sequences.

### Locking and sequences
       If you use the “Unseen-Sequence” profile entry, or if you use the **-sequence  **argument,  **rcvs‐**
       **tore  **might  try  to update its sequence state while another **nmh **process is also trying to do
       so.  This can cause one of those updates to be lost.  To avoid this (just  between  asynchro‐
       nous  invocations  of  **rcvstore**),  always use it with an external locking mechanism.  A _proc‐_
       [_mailrc_(5)](https://www.chedong.com/phpMan.php/man/mailrc/5/markdown) local lockfile would work, or if not using procmail, then consider  using  _dotlock‐_
       [_file_(1)](https://www.chedong.com/phpMan.php/man/file/1/markdown) or [_flock_(1)](https://www.chedong.com/phpMan.php/man/flock/1/markdown).

## FILES
       $HOME/.mh_profile          The user profile

## PROFILE COMPONENTS
       Path:                To determine the user's nmh directory
       Folder-Protect:      To set mode when creating a new folder
       Inbox:               To find the default inbox
       Msg-Protect:         To set mode when creating a new message
       Unseen-Sequence:     To name sequences denoting unseen messages

## SEE ALSO
       [_mh-sequence_(5)](https://www.chedong.com/phpMan.php/man/mh-sequence/5/markdown), [_procmailex_(5)](https://www.chedong.com/phpMan.php/man/procmailex/5/markdown), [_procmailrc_(5)](https://www.chedong.com/phpMan.php/man/procmailrc/5/markdown), [_rcvdist_(1)](https://www.chedong.com/phpMan.php/man/rcvdist/1/markdown), [_rcvpack_(1)](https://www.chedong.com/phpMan.php/man/rcvpack/1/markdown), [_rcvtty_(1)](https://www.chedong.com/phpMan.php/man/rcvtty/1/markdown)

## DEFAULTS
       `**+folder**' defaults to “Inbox” profile entry
       `**-create**'
       `**-unseen**'
       `**-nozero**'

## CONTEXT
       No context changes will be attempted, with the exception of sequence manipulation.

nmh-1.8                                      2013-02-19                                [_RCVSTORE_(1mh)](https://www.chedong.com/phpMan.php/man/RCVSTORE/1mh/markdown)