Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
RCVSTORE(1)		    General Commands Manual		   RCVSTORE(1)

       rcvstore	- asynchronously incorporate mail into an nmh folder

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

       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

       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-

       $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 message
       Unseen-Sequence:	    To name sequences denoting unseen messages

       mh-sequence(5),	procmailex(5),	procmailrc(5), rcvdist(1), rcvpack(1),

       `+folder' defaults to "Inbox" profile entry

       No context changes will be attempted, with the  exception  of  sequence

nmh-1.7.1			  2013-02-19			   RCVSTORE(1)


Want to link to this manual page? Use this URL:

home | help