rcvstore



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  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 speci-
       fied (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 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 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 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 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.



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)


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



[nmh-1.0.4]                         MH.6.8                         RCVSTORE(1)

Man(1) output converted with man2html