NAME

       rcvstore - asynchronously incorporate mail into a folder

SYNOPSIS

       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 mh 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 mh 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 mmh 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 and -nopublic switches may
       be used to force these sequences to be public or private sequences.

FILES

       $HOME/.mmh/profile         The user profile

PROFILE COMPONENTS

       Path:                To determine the user's mail storage
       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), mh-sequence(7)

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
       mmh  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.