1RCVSTORE(1)                  [nmh-1.2-20070115cvs]                 RCVSTORE(1)
2
3
4

NAME

6       rcvstore - asynchronously incorporate mail into a folder
7

SYNOPSIS

9       /usr/libexec/nmh/rcvstore [+folder] [-create | -nocreate] [-unseen |
10            -nounseen] [-zero | -nozero] [-sequence name ...]  [-public |
11            -nopublic] [-version] [-help]
12

DESCRIPTION

14       Rcvstore  incorporates  a  message  from the standard input into an nmh
15       folder.  This command is typically used in conjunction with  mail  fil‐
16       tering  programs  such as slocal and procmail, to filter your mail into
17       different folders.
18
19       You may specify which folder to use with  +folder.   If  no  folder  is
20       specified,  rcvstore  will use the folder given by a non-empty “Inbox:”
21       entry in the user's profile, else it will use the folder named “inbox”.
22
23       If the switch -create is given (it is the default) and if the specified
24       (or  default)  folder does not exist, then it will be created.  You may
25       disable this with the -nocreate option.  In  this  case  rcvstore  will
26       exit if the specified folder does not exist.
27
28       When  the  new  message is incorporated into the folder, it is assigned
29       the next highest number for that folder.
30
31       Rcvstore will incorporate anything except zero length messages into the
32       user's nmh folder.  It will not change the message in any way.
33
34       If  the  user's profile contains a “Msg-Protect: nnn” entry, it will be
35       used as the protection on the newly created message, otherwise the  nmh
36       default  of  0644  will be used.  For all subsequent operations on this
37       message, this initially assigned protection will be preserved.
38
39       If the switch -unseen is given (it is on by default), and if  the  pro‐
40       file  entry  “Unseen-Sequence”  is present and non-empty, then rcvstore
41       will add the newly incorporated message to each sequence named by  this
42       profile  entry.   You  may  use  the  switch -nounseen to disable this.
43       These sequences will not be zero'ed by rcvstore prior to adding the new
44       message.
45
46       Furthermore,  the incoming message may be added to additional sequences
47       as they arrive by the use of the -sequence switch.  As  with  the  com‐
48       mands pick and mark, you may also use the switches -zero and -nozero to
49       specify whether to zero old sequences or not.  Similarly,  use  of  the
50       -public  and -nopublic switches may be used to force these sequences to
51       be public or private sequences.
52
53

FILES

55       $HOME/.mh_profile          The user profile
56
57

PROFILE COMPONENTS

59       Path:                To determine the user's nmh directory
60       Folder-Protect:      To set mode when creating a new folder
61       Inbox:               To find the default inbox
62       Msg-Protect:         To set mode when creating a new message
63       Unseen-Sequence:     To name sequences denoting unseen messages
64
65

SEE ALSO

67       rcvdist(1), rcvpack(1), rcvtty(1), mh-sequence(5)
68
69

DEFAULTS

71       `+folder' defaults to “Inbox” profile entry
72       `-create'
73       `-unseen'
74       `-nozero'
75
76

CONTEXT

78       No context changes will be attempted, with the  exception  of  sequence
79       manipulation.
80
81

BUGS

83       If  you  use the “Unseen-Sequence” profile entry, rcvstore could try to
84       update the context while another nmh process is also trying to  do  so.
85       This  can cause the context to become corrupted.  To avoid this, do not
86       use rcvstore if you use the “Unseen-Sequence” profile entry.
87
88
89
90MH.6.8                            1 Jul 2003                       RCVSTORE(1)
Impressum