delivery-queue¶

Name¶

delivery-queue — LMTP/SMTP frontend for local delivery

Synopsis¶

delivery-queue [-c config]

Description¶

delivery-queue is an additional mail queue in front of delivery(8gx). It may be removed in a future version.

Options¶

-c config: Read configuration directives from the given file. If this option is not specified, /etc/gromox/smtp.cfg will be read if it exists.
-?: Display option summary.

Configuration directives¶

The usual config file location is /etc/gromox/smtp.cfg. (Deviation from the process name due to compatibility with older installations.)

block_interval_sessions: The amount of time a source IP address is blocked from connecting to the service because it tried to queue too many messages.

Default: 1 minute
command_protocol: Selects what kind of hello command is accepted of clients. Can be lmtp, smtp or both.

Default: both
config_file_path: Colon-separated list of directories which will be scanned when locating further configuration files, especially those used by plugin instances.

Default: /etc/gromox/smtp:/etc/gromox
context_average_mem: Default: 256K
context_max_mem: Default: 2M
context_num: Default: 200
data_file_path: Colon-separated list of directories which will be scanned when locating data files.

Default: /usr/share/gromox/smtp
default_domain: Default: (system domainname)
host_id: A unique identifier for this system. It is used for greeting lines emitted by delivery-queue on the network.

Default: (system hostname)
lda_listen_addr: AF_INET6 socket address to bind the LDA service to.

Default: ::
lda_listen_port: The TCP port to export the SMTP protocol service on.

Default: 25
lda_listen_tls_port: The TCP port to expose the implicit-TLS SMTP protocol service on.

Default: (unset)
lda_log_file: Target for log messages here. Special values: "-" (stderr/syslog depending on parent PID) or "syslog" are recognized.

Default: - (auto)
lda_log_level: Maximum verbosity of logging. 1=crit, 2=error, 3=warn, 4=notice, 5=info, 6=debug.

Default: 4 (notice)
lda_thread_charge_num: The maximum number of connections that each thread is allowed to process.

Default: 40
lda_thread_init_num: The minimum number of client processing threads to keep around.

Default: 1
mail_max_length: Maximum permitted length of a message.

Default: 64M
running_identity: An unprivileged user account to switch the process to after startup. To inhibit the switch, assign the empty value.

Default: gromox
smtp_certificate_passwd: The password to unlock TLS certificates.

Default: (unset)
smtp_certificate_path: Filesystem path to a certificate file for use with encrypted connection. The complete certificate chain should be present (as there is no other config directive to pull CA certs in).

Default: (unset)
smtp_conn_timeout: If an SMTP connection stalls for the given period, the connection is terminated.

Default: 3 minutes
smtp_force_starttls: This flag controls whether clients must utilize TLS, either by way of implicit TLS (cf. lda_listen_tls_port), or through the STARTTLS command.

Default: false
smtp_max_mail_num: The maximum number of messages that a client is allowed to queue within one connection before its source IP address is blocked.

Default: 10
smtp_private_key_path: Filesystem path to the key file needed to unlock the TLS certificate.

Default: (unset)
smtp_support_pipeline: This flag controls the offering of the PIPELINING extension (RFC 2920) to clients.

Default: true
smtp_support_starttls: This flag controls the offering of the STARTTLS extension (RFC 3027) to clients.

Default: false
state_path: Directory for runtime variadic data.

Default: /var/lib/gromox
tls_min_proto: The lowest TLS version to offer. Possible values are: tls1.0, tls1.1, tls1.2, and, if supported by the system, tls1.3.

Default: tls1.2

Files¶

data_file_path/smtp_code.txt: Mapping from internal SMTP error codes to textual descriptions.
/usr/lib/gromox/libgxs_*.so: flusher plugins
/usr/lib/gromox/libgxs_*.so: service plugins