RCVSTORE(1) [nmh-1.0.4] (MH.6.8) RCVSTORE(1)
NAME
rcvstore - asynchronously incorporate mail into a folder
SYNOPSIS
/usr/freeware/lib/nmh/rcvstore [+folder]
[-create] [-nocreate] [-unseen] [-nounseen]
[-zero] [-nozero] [-public] [-nopublic]
[-sequence name ...] [-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'
Page 1 (printed 2/1/01)
RCVSTORE(1) [nmh-1.0.4] (MH.6.8) RCVSTORE(1)
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), rcvpack(1), rcvtty(1), mh-sequence(5)
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.
Page 2 (printed 2/1/01)