rcvstore(1) - man - phpman

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 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-Se‐
       quence” 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 -unseen
       If you use the “Unseen-Sequence” profile entry, rcvstore could try to read and update its se‐
       quence  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 lock‐
       file, 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
       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)