RCVSTORE(%manext1%)

NAME
rcvstore - asynchronously incorporate mail into a folder

SYNOPSIS
%libdir%/rcvstore [+folder] [-create]
[-nocreate] [-sequence name ...] [-public]
[-nopublic] [-zero] [-nozero] [-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. If `+folder' isn't specified, a folder in the user's nmh directory will be used, either that specified by a non-empty “Inbox:” entry in the user's profile, or the folder named “inbox”. If the specified (or default) folder doesn't exist, then it will be created if the `-create' option is specified, otherwise rcvstore will exit. 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. 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 profile entry “Unseen-Sequence” is present and non-empty, then rcvstore will add the newly incorporated message to each sequence named by the profile entry. This is similar to the “Previous-Sequence” profile entry supported by all nmh commands which take `msgs' or `msg' arguments. By default, rcvstore will not zero each sequence prior to adding messages. Furthermore, the incoming messages may be added to user-defined 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. ^$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 `-create' `-nozero' No context changes will be attempted, with the exception of sequence manipulation. 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.