NAME

       rcvstore - asynchronously incorporate mail into an nmh folder

SYNOPSIS

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

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 mode to use, in octal,
       on the newly created message, otherwise the nmh default mode of 0600, see  chmod(1),  will  be  used  (on
       filesystems  that  support  it).   For all subsequent operations on this message, this initially assigned
       mode 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
       zeroed by rcvstore prior to adding the new message.

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

   Locking and sequences
       If  you use the “Unseen-Sequence” profile entry, or if you use the -sequence argument, rcvstore might try
       to update its sequence state while another nmh process is also trying to do so.  This can  cause  one  of
       those  updates to be lost.  To avoid this (just between asynchronous invocations of rcvstore), always use
       it with an external locking mechanism.  A procmailrc(5) local  lockfile  would  work,  or  if  not  using
       procmail, then consider using dotlockfile(1) or flock(1).

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

       mh-sequence(5), procmailex(5), procmailrc(5), rcvdist(1), rcvpack(1), rcvtty(1)

DEFAULTS

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

CONTEXT

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

nmh-1.8                                            2013-02-19                                      RCVSTORE(1mh)