rcvstore - asynchronously incorporate mail into a folder
[-create] [-nocreate] [-unseen] [-nounseen]
[-zero] [-nozero] [-public] [-nopublic]
[-sequence name ...] [-version] [-help]
Rcvstore incorporates a message from the standard input into an nmh
folder. This command is typically used in conjunction with mail fil-
tering programs such as slocal and procmail, to filter your mail into
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 speci-
fied (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 pro-
file 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
Furthermore, the incoming message may be added to additional sequences
as they arrive by the use of the `-sequence' switch. As with the com-
mands 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.
$HOME/.mh_profile The user profile
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
rcvdist(1), rcvpack(1), rcvtty(1), mh-sequence(5)
`+folder' defaults to "Inbox" profile entry
No context changes will be attempted, with the exception of sequence
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.
[nmh-1.0.4] MH.6.8 RCVSTORE(1)
Man(1) output converted with