Sun Internet Mail Server 3.5 Reference Manual: 3

Available SMTP Channel Options

The available options are listed in TABLE 3-10.

TABLE 3-10 SMTP Channel Options

Option
Description

ALLOW_TRANSACTIONS_PER_SESSION (Integer)

Set a limit on the number of messages allowed per connection. The default is no limit.

ALLOW_RECIPIENTS_PER_TRANSACTION (Integer)

Set a limit on the number of recipients allowed per message. The default is no limit.

ATTEMPT_TRANSACTIONS_PER_SESSION (Integer)

Set a limit on the number of messages IMTA will attempt to transfer during any one connection session.

COMMAND_RECEIVE_TIME (Integer)

This option specifies, in minutes, how long to wait to receive general SMTP commands (commands other than those with explicitly specified time-out values set using other specifically named options).

COMMAND_TRANSMIT_TIME (Integer)

This option specifies, in minutes, how long to spend transmitting general SMTP commands (commands other than those with explicitly specified time-out values set using other specifically named options).

CONTINUATION_CHARS
(List of Integers)

Additional characters that act like the continuation character specified using the contchar channel keyword. This is a list of integer values.

DATA_RECEIVE_TIME (Integer)

This option specifies, in minutes, how long to wait to receive data during an SMTP dialogue. The default is 60.

DATA_TRANSMIT_TIME (Integer)

This option specifies, in minutes, how long to spend transmitting data during an SMTP dialogue. The default is 10.

DISABLE_ADDRESS (0 or 1)

The IMTA SMTP server implements a private command XADR. This command returns information about how an address is routed internally by IMTA as well as general channel information. Releasing such information may constitute a breach of security for some sites. Setting the DISABLE_ADDRESS option to 1 disables the XADR command. The default is 0, which enables the XADR command.

DISABLE_EXPAND (0 or 1)

The SMTP EXPN command is used to expand mailing lists. Exposing the contents of mailing lists to outside scrutiny may constitute a breach of security for some sites. The DISABLE_EXPAND option, when set to 1, disables the EXPN command completely. The default value is 0, which causes the EXPN command to work normally. Note that mailing list expansion can also be blocked on a list-by-list basis by setting the expandable attribute to False in the list's directory entry.

DISABLE_STATUS (0 or 1)

The IMTA SMTP server implements a private command XSTA. This command returns status information about the number of messages processed and currently in the IMTA channel queues. Releasing such information may consisted a breach of security for some sites. Setting the DISABLE_STATUS option to 1 disables the XSTA command. The default is 0, which enables the XSTA command.

DOT_TRANSMIT_TIME (Integer)

This option specifies, in minutes, how long to spend transmitting the dot (.) terminating the data in an SMTP dialogue. The default is 10.

HIDE_VERIFY (0 or 1)

The SMTP VRFY command can be used to establish the legality of an address before using it. Unfortunately this command has been abused by automated query engines in some cases. The HIDE_VERIFY option, when set to 1, tells IMTA not to return any useful information in the VRFY command result. The default value is 0, which causes VRFY to act normally.

MAIL_TRANSMIT_TIME (Integer)

This option specifies, in minutes, how long to spend transmitting the SMTP command MAIL FROM:. The default is 10.

MAX_CLIENT_THREADS

An integer number indicating the maximum number of simultaneous outbound connections that the client channel program will allow. Note that multiple processes may be used for outbound connections, depending on how you have channel-processing queues setup. This option controls the number of threads per process. The default if this option is not specified is 10.

MAX_SERVER_THREADS

An integer number indicating the maximum number of simultaneous inbound connections that the SMTP server program will allow. Note that since only one server process is allowed, this option effectively controls the total number of simultaneous inbound SMTP connections IMTA can handle. The default if this option is not specified is 40.

RCPT_TRANSMIT_TIME (Integer)

This option specifies, in minutes, how long to spend transmitting the SMTP command RCPT TO:. The default is 10.

STATUS_DATA_RECEIVE_TIME (Integer)

This option specifies, in minutes, how long to wait to receive the SMTP response to your sent data--that is, how long to wait to receive a "550" (or other) response to the dot-terminating-sent data. The default value is 10. See also the STATUS_DATA_RECV_PER_ADDR_TIME, STATUS_DATA_RECV_PER_BLOCK_TIME, and STATUS_DATA_RECV_PER_ADDR_PER_BLOCK_TIME options.

STATUS_DATA_RECV_PER_ADDR_TIME
(Floating Point Value)

This option specifies an adjustment factor for how long to wait to receive the SMTP response to your sent data based on the number of addresses in the MAIL TO: command. This value is multiplied by the number of addresses and added to the base wait time (specified with the STATUS_DATA_RECV_TIME option). The default is 0.083333.

STATUS_DATA_RECV_PER_BLOCK_TIME (Floating Point Value)

This option specifies an adjustment factor for how long to wait to receive the SMTP response to your sent data based on the number of blocks sent. This value is multiplied by the number of blocks and added to the base wait time (specified with the STATUS_DATA_RECV_TIME option). The default is 0.001666.

STATUS_DATA_RECV_PER_ADDR_PER_BLOCK_TIME (Floating Point Value)

This option specifies an adjustment factor for how long to wait to receive the SMTP response to your sent data based on the number of addresses (in the MAIL TO: command) per number of blocks sent. This value is multiplied by the number of addresses per block and added to the base wait time (specified with the STATUS_DATA_RECV_TIME option). The default is 0.003333.

STATUS_MAIL_RECEIVE_TIME (Integer)

This option specifies, in minutes, how long to wait to receive the SMTP response to a sent MAIL FROM: command. The default is 10.

STATUS_RCPT_RECEIVE_TIME (Integer)

This option specifies, in minutes, how long to wait to receive the SMTP response to a sent RCPT TO: command. The default value is 10.

STATUS_RECEIVE_TIME (Integer)

This option specifies, in minutes, how long to wait to receive a banner line upon connection. The default value is 10.

STATUS_TRANSMIT_TIME (Integer)

This option specifies, in minutes, how long to spend transmitting the banner line upon receiving a request to open an SMTP connection.

Option	Description
`ALLOW_TRANSACTIONS_PER_SESSION` (Integer)	Set a limit on the number of messages allowed per connection. The default is no limit.
`ALLOW_RECIPIENTS_PER_TRANSACTION` (Integer)	Set a limit on the number of recipients allowed per message. The default is no limit.
`ATTEMPT_TRANSACTIONS_PER_SESSION` (Integer)	Set a limit on the number of messages IMTA will attempt to transfer during any one connection session.
`COMMAND_RECEIVE_TIME` (Integer)	This option specifies, in minutes, how long to wait to receive general SMTP commands (commands other than those with explicitly specified time-out values set using other specifically named options).
`COMMAND_TRANSMIT_TIME` (Integer)	This option specifies, in minutes, how long to spend transmitting general SMTP commands (commands other than those with explicitly specified time-out values set using other specifically named options).
`CONTINUATION_CHARS` (List of Integers)	Additional characters that act like the continuation character specified using the `contchar` channel keyword. This is a list of integer values.
`DATA_RECEIVE_TIME` (Integer)	This option specifies, in minutes, how long to wait to receive data during an SMTP dialogue. The default is 60.
`DATA_TRANSMIT_TIME` (Integer)	This option specifies, in minutes, how long to spend transmitting data during an SMTP dialogue. The default is 10.
`DISABLE_ADDRESS` (0 or 1)	The IMTA SMTP server implements a private command `XADR`. This command returns information about how an address is routed internally by IMTA as well as general channel information. Releasing such information may constitute a breach of security for some sites. Setting the `DISABLE_ADDRESS` option to 1 disables the `XADR` command. The default is 0, which enables the `XADR` command.
`DISABLE_EXPAND` (0 or 1)	The SMTP `EXPN` command is used to expand mailing lists. Exposing the contents of mailing lists to outside scrutiny may constitute a breach of security for some sites. The `DISABLE_EXPAND` option, when set to 1, disables the `EXPN` command completely. The default value is 0, which causes the `EXPN` command to work normally. Note that mailing list expansion can also be blocked on a list-by-list basis by setting the expandable attribute to `False` in the list's directory entry.
`DISABLE_STATUS` (0 or 1)	The IMTA SMTP server implements a private command `XSTA`. This command returns status information about the number of messages processed and currently in the IMTA channel queues. Releasing such information may consisted a breach of security for some sites. Setting the `DISABLE_STATUS` option to 1 disables the `XSTA` command. The default is 0, which enables the `XSTA` command.
`DOT_TRANSMIT_TIME` (Integer)	This option specifies, in minutes, how long to spend transmitting the dot (`.`) terminating the data in an SMTP dialogue. The default is 10.
`HIDE_VERIFY` (0 or 1)	The SMTP `VRFY` command can be used to establish the legality of an address before using it. Unfortunately this command has been abused by automated query engines in some cases. The `HIDE_VERIFY` option, when set to 1, tells IMTA not to return any useful information in the `VRFY` command result. The default value is 0, which causes `VRFY` to act normally.
`MAIL_TRANSMIT_TIME` (Integer)	This option specifies, in minutes, how long to spend transmitting the SMTP command `MAIL FROM:`. The default is 10.
`MAX_CLIENT_THREADS`	An integer number indicating the maximum number of simultaneous outbound connections that the client channel program will allow. Note that multiple processes may be used for outbound connections, depending on how you have channel-processing queues setup. This option controls the number of threads per process. The default if this option is not specified is 10.
`MAX_SERVER_THREADS`	An integer number indicating the maximum number of simultaneous inbound connections that the SMTP server program will allow. Note that since only one server process is allowed, this option effectively controls the total number of simultaneous inbound SMTP connections IMTA can handle. The default if this option is not specified is 40.
`RCPT_TRANSMIT_TIME` (Integer)	This option specifies, in minutes, how long to spend transmitting the SMTP command `RCPT TO:`. The default is 10.
`STATUS_DATA_RECEIVE_TIME` (Integer)	This option specifies, in minutes, how long to wait to receive the SMTP response to your sent data--that is, how long to wait to receive a "550" (or other) response to the dot-terminating-sent data. The default value is 10. See also the `STATUS_DATA_RECV_PER_ADDR_TIME`, `STATUS_DATA_RECV_PER_BLOCK_TIME`, and `STATUS_DATA_RECV_PER_ADDR_PER_BLOCK_TIME` options.
`STATUS_DATA_RECV_PER_ADDR_TIME` (Floating Point Value)	This option specifies an adjustment factor for how long to wait to receive the SMTP response to your sent data based on the number of addresses in the `MAIL TO:` command. This value is multiplied by the number of addresses and added to the base wait time (specified with the `STATUS_DATA_RECV_TIME` option). The default is 0.083333.
`STATUS_DATA_RECV_PER_BLOCK_TIME` (Floating Point Value)	This option specifies an adjustment factor for how long to wait to receive the SMTP response to your sent data based on the number of blocks sent. This value is multiplied by the number of blocks and added to the base wait time (specified with the `STATUS_DATA_RECV_TIME` option). The default is 0.001666.
`STATUS_DATA_RECV_PER_ADDR_PER_BLOCK_TIME` (Floating Point Value)	This option specifies an adjustment factor for how long to wait to receive the SMTP response to your sent data based on the number of addresses (in the `MAIL TO:` command) per number of blocks sent. This value is multiplied by the number of addresses per block and added to the base wait time (specified with the `STATUS_DATA_RECV_TIME` option). The default is 0.003333.
`STATUS_MAIL_RECEIVE_TIME` (Integer)	This option specifies, in minutes, how long to wait to receive the SMTP response to a sent `MAIL FROM:` command. The default is 10.
`STATUS_RCPT_RECEIVE_TIME` (Integer)	This option specifies, in minutes, how long to wait to receive the SMTP response to a sent `RCPT TO:` command. The default value is 10.
`STATUS_RECEIVE_TIME` (Integer)	This option specifies, in minutes, how long to wait to receive a banner line upon connection. The default value is 10.
`STATUS_TRANSMIT_TIME` (Integer)	This option specifies, in minutes, how long to spend transmitting the banner line upon receiving a request to open an SMTP connection.