This documentation is for PicLan-IP build 2.0.0(135) and later. A number of configuration parameters for email functions have changed as of this release.
The PicLan-IP mail server functions can be used to:
|DNS||...||You must configure DNS parameter fields in order to have PicLan-IP send mail directly.||none|
|LOCAL HOST NAME=||system name
|The name of the PicLan-IP system.||none|
|IP address or
This configuration parameter is now a part of
the EMAIL,ROUTE file.
|MAIL TIMEOUT=||hh:mm:ss||The amount of time that the mail server will wait for any single response from a destination server.||10 minutes|
|MAIL LONG TIMEOUT=||hh:mm:ss||The total amount of time that the mail server will take sending to a single SMTP address||20 minutes|
|MAIL CONN OUT=||##||The total number of simultanious network SMTP connections that the mail server will make concurrently.||20|
|MAIL RETRY TIME=||hh:mm:ss||The amount of time between retries of outbound mail messages||20 minutes|
|MAIL WARN TIME=||hh:mm:ss||The amount of time before a non-delivered mail warning message is sent to the sender.||24 hours
|MAIL MAX TIME=||hh:mm:ss||The amount of time before a message is discarded and a mail failure message is send to the sender||120 hours
|MAIL WARN MAX=||hh:mm:ss||The maximum amount of time that a mail warning or failure return message is retried||6 hours|
|MAIL MAX HOPS=||##||The maximum number of hops that a message can forward through before being discarded.||20|
This will setup an SMTP listen for the default IP address for the PicLan-IP host on TCP port 25 (which is the default for SMTP).SMTP LISTEN=*:25
The single line MAILBOX ... specifies that inbound messages to "email@example.com" should be saved in a mailbox named "DOUG". If you wish to create email addresses that go to multiple local mailboxes, you could use a mailbox like:firstname.lastname@example.org 001 MAILBOX DOUG
Inbound SMTP rules can also be used to cause messages to be forwarded to other SMTP mail host systems:email@example.com 001 MAILBOX JOHN 002 MAILBOX GEORGE 003 MAILBOX JERRY 004 MAILBOX SAMANTHA
firstname.lastname@example.org 001 FWD email@example.com FWD.PARAMETERS
The FWD.PARAMETER can consist of the following strings:
This can be used either seperately or in conjunction with local mailboxes:
MX - Forward based on DNS MX record lookups
###.###.###.### - Forward to a specific SMTP host by IP address
You may also specify several IP addresses seperated by spaces. In this case, PicLan-IP will load-share outbound mail messages between the specified servers.
These routing rules are typically used for specific mailbox destinations. If you wish to accept inbound messages for generic addresses, then additional rules are often used to control mail relaying and access:firstname.lastname@example.org 001 FWD email@example.com MX 002 MAILBOX GEORGE
The ALLOW keyword provides a mechanism to refuse forwarded mail except from your local users. You specify what is a local user by supplying an IP network and sub-net mask. This example would allow forwarding from users with IP addresses from 22.214.171.124 thru 126.96.36.199. If you have multiple local network address ranges, then you can specify multiple ALLOW lines. If an inbound mail message comes from an address that is not allowed, then a "550 we do not forward" error will be generated and the mail message will be refused.*@* 001 ALLOW 188.8.131.52 255.255.255.0 002 FWD *@* MX
The reason that you setup a general *@* record is to allow email client applications like Pegasus and Eudora to send mail using the PicLan-IP mail server as the sending SMTP server. The reason that you want to restrict mail forwarding is to prevent bulk emailers from using your mail server to send their email messages over the internet using your bandwidth instead of their bandwidth.
|Item ID||The name of the mailbox. Mailboxes should be upper-case only.|
|001||POP3 Password||The password required for POP3 access to the mailbox. If you do not specify a POP3 password, then the mail will not be accessible over POP3. Passwords are case sensitive|
|002||Max Messages||The maximum number of message allowed to be stored in the mailbox. A null entry allows unlimited storage. (not currently implemented)|
|003||Max Message Size||The maximum total size of messages allowed to be stored in the mailbox. A null entry allows unlimited storage. (not currently implemneted)|
|004||Event Subroutine Name||The name of a subroutine that will be called when a message arrives. A single parameter with the message ID number is passed to the subroutine.|
|005||Event TCL Command||A TCL command that is executed when a message arrives. A single parameter with the message ID number is appended to the TCL command.|
|...||Attributes above 11 are for the internal use of the PicLan-IP mail server and should not be modified manually|
|011||List of messages in Mailbox||A multi-value list of message IDs currently stored for this mailbox.|
|012||List of message sizes in Mailbox||A multi-value list of message sizes currently stored for this mailbox.|
|013||Total size of messages in Mailbox||The total size in bytes of messages stored in this mailbox.|
|014||Lock Handle||A handle that indicates that the mailbox is "locked" by POP3.|
As of build 113, some email functions are not implemented, so not all of the above elements may be active.
This will setup a POP3 listen on the default IP address and TCP port 110 (which is the default for POP3). POP3 users will then be able to access any mailbox with a POP3 password.POP3 LISTEN=*:110