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 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 0600 will be used
       (on filesystems that support it).  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 and -nopublic switches may be used  to  force  these  sequences  to  be
       public or private sequences.

   LOCKING AND -unseen
       If  you use the “Unseen-Sequence” profile entry, rcvstore could try to read and update its
       sequence state while another nmh process is also trying to do  so.   This  can  cause  the
       sequence  state  to  lose  track.   To avoid this just between asynchronous invocations of
       rcvstore,  do  not  use  it  without  an  external  locking  mechanism,  for  example,   a
       procmailrc(5) local lockfile, if you use the “Unseen-Sequence” profile entry.

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), procmailex(5), procmailrc(5)

DEFAULTS

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

CONTEXT

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