RCVSTORE(1)                                           RCVSTORE(1)

NAME
       rcvstore - asynchronously incorporate mail into a folder

SYNOPSIS
       /usr/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 mes-
       sages 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  ini-
       tially 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 addi-
       tional  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.

       ^$HOME/.mh_profile~^The user profile ^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 mes-
       sage ^Unseen-Sequence:~^To name sequences denoting  unseen
       messages rcvdist(1), rcvpack(1), rcvtty(1), mh-sequence(5)
       `+folder' defaults  to  "Inbox"  profile  entry  `-create'
       `-unseen'  `-nozero' No context changes will be attempted,
       with the exception of sequence manipulation.  If  you  use
       the "Unseen-Sequence" profile entry, rcvstore could try to
       update the context while another nmh process is also  try-
       ing  to  do so.  This can cause the context to become cor-
       rupted.  To avoid this, do not use rcvstore if you use the
       "Unseen-Sequence" profile entry.

[nmh-0.27]                    MH.6.8                            1