---
name: "rcvstore"
section: "1"
platform: "linux"
package: "nmh"
version: "1.5-release-0.2"
release: "Debian 7 (Wheezy)"
platforms: ["linux"]
url: "https://new.carta.tech/rcvstore"
---

# rcvstore(1)

asynchronously incorporate mail into a folder

## NAME

rcvstore - asynchronously incorporate mail into a folder

## SYNOPSIS

**/usr/lib/mh/rcvstore** \[*+folder*\] \[**-create** \| **-nocreate**\] \[**-unseen** \| **-nounseen**\] \[**-zero** \| **-nozero**\] \[**-sequence** *name* ...\] \[**-public** \| **-nopublic**\] \[**-version**\] \[**-help**\]

## 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 protection on the newly created message, otherwise the **nmh** default of 0644 will be used.  For all subsequent operations on this message, this initially assigned protection will be preserved.

If the switch **-unseen** is given (it is on by default), and if the profile entry “Unseen-Sequence” 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 zero'ed by **rcvstore** prior to adding the new message.

Furthermore, the incoming message 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.

## 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

[rcvdist(1)](/rcvdist/1.md), [rcvpack(1)](/rcvpack/1.md), [rcvtty(1)](/rcvtty/1.md), [mh-sequence(5)](/mh-sequence/5.md)

## DEFAULTS

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

## CONTEXT

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

## BUGS

If you use the “Unseen-Sequence” profile entry, **rcvstore** could try to update the context while another **nmh** process is also trying to do so.  This can cause the context to become corrupted.  To avoid this, do not use **rcvstore** if you use the “Unseen-Sequence” profile entry.