phpMan > info > rcvstore(1)

RCVSTORE(1mh)                                                    RCVSTORE(1mh)

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  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 mode to use, in octal, on the newly created message, other-
       wise  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 pro-
       file 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 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.

   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 proc-
       mailrc(5) local lockfile, if you use the "Unseen-Sequence" profile  en-
       try.

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.7.1                         2013-02-19                     RCVSTORE(1mh)