This configuration file must be initialized to contain the UUCP node name that this machine is known to its neighbors. If /etc/courier/uucpme does not exist, Courier uses the first node name of the hostname specified by the /etc/courier/me configuration file.

Note that in addition to creating this configuration file you must also configure your UUCP software to appropriately route UUCP mail to the specified nodes, which is a completely separate task. Blank lines in this file are ignored. Lines that start with the # character are comments, and are also ignored. The remaining lines are in the following format:

node<TAB>flags

node is a UUCP node, such as "apple" or "food!fruits!apple". <TAB> is a single tab character, and flags is zero or more of single character flags described below. The tab character can be ommited if there are no flags.

If there is an entry for node in /etc/courier/uucpneighbors then Courier will accept mail for any address of the form "node!user", but not "node!nodule!user". In order to accept mail for "node!nodule!user" you must enter both "node" and "node!nodule", unless you use the F or the G flag.

The flags are as follows:

F

Unrestricted forwarding. This flag will accept any UUCP path that starts with the specified node. Example:

food<TAB>F

This will accept "food!fruits!apple", "food!fruits!banana", "food!drinks!orangejuice", and so on. You may simply list all your immediate UUCP neighbors using the F flag, and accept mail to any address that's reachable via any neighbor.

G

This is a gateway. This flag is identical to the F flag, except that rmail is executed on the specified node. Normally, Courier will issue a uux request to run rmail on the last node, for example "uux food!fruits!rmail apple". Using G instead of F will run rmail on the listed node, for example "uux food!rmail fruits!apple".

R

This is a relay. This flag is used where neither F or G flags are appropriate, but you want to run rmail on this node. For example:

food!fruits
food<TAB>R

In this example mail to "food!fruits!apple" is sent by executing "uux food!rmail fruits!apple". If the R flag is not specified, then Courier will request "uux food!fruits!rmail apple".

This is the standard Courier module configuration file.

MAXDELS

Maximum simultaneous UUCP deliveries. This setting is a bit misleading. From Courier's viewpoint, a delivery consists only of running uux to queue up the message via UUCP. Once uux returns, the message is delivered, as far as Courier is concerned. UUCP is responsible for getting the message the rest of the way. Therefore, UUCP deliveries tend to be fairly quick, and it is not necessary to configure a large number of concurrent courieruucp processes, since each one will terminate quickly. Once uux terminates, the UUCP software is responsible for queueing and sending the message.

MAXHOST

Maximum simultaneous UUCP deliveries to the same UUCP node. Since UUCP deliveries tend to be fairly quick, it is not usually necessary to use MAXHOST to limit concurrent deliveries to the same UUCP node, so MAXHOST should generally be set to the same value as MAXDELS.

MAXRCPT

Maximum recipients per message. When the same message is sent to multiple recipients on the same UUCP node, Courier is capable of asking to run rmail only one, and listing all the recipients together. MAXRCPT specifies the upper limit on the number of recipients that are batched together. You want to set a limit based on any limitations on the length of command lines that's imposed by the operating system. Sending the same message to different UUCP nodes is always handled as separate deliveries.