RCVSTORE(1)                                                          [nmh-1.5]                                                         RCVSTORE(1)

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  fil-
       tering 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 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.

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.

MH.6.8                                                             11 June 2012                                                        RCVSTORE(1)