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

FreeBSD Manual Pages

  
 
  

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

NAME
       rcvstore	- asynchronously incorporate mail into an nmh folder

SYNOPSIS

       /usr/local/libexec/nmh/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 sequences
       If you use the "Unseen-Sequence"	profile	entry, or if you use the  -se-
       quence  argument, rcvstore might	try to update its sequence state while
       another nmh process is also trying to do	so.  This  can	cause  one  of
       those updates to	be lost.  To avoid this	(just between asynchronous in-
       vocations  of  rcvstore), always	use it with an external	locking	mecha-
       nism.  A	procmailrc(5) local lockfile would work, or if not using proc-
       mail, then consider using dotlockfile(1)	or flock(1).

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.8+dev			  2013-02-19			   RCVSTORE(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=rcvstore&sektion=1&manpath=FreeBSD+Ports+14.3.quarterly>

home | help