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

NAME | SYNOPSIS | DESCRIPTION | FILES | PROFILE COMPONENTS | SEE ALSO | DEFAULTS | CONTEXT

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

home | help