GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  RCVSTORE (1)

NAME

rcvstore - asynchronously incorporate mail into a folder

CONTENTS

Synopsis
Description
     LOCKING AND -unseen
Files
Defaults
Context

SYNOPSIS

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

DESCRIPTION

Rcvstore incorporates a message from the standard input into an nmh folder. This command is typically used in conjunction with mail filtering 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 protection on the newly created message, otherwise the nmh default of 0600 will be used (on filesystems that support it). 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 profile 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 commands 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 procmailrc(5) local lockfile, if you use the “Unseen-Sequence” profile entry.

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), procmailex(5), procmailrc(5)

DEFAULTS

+folder’ defaults to “Inbox” profile entry 
-create-unseen-nozero

CONTEXT

No context changes will be attempted, with the exception of sequence manipulation.
Search for    or go to Top of page |  Section 1 |  Main Index


nmh-1.6 RCVSTORE (1) February 18, 2013

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.