delivery-queue(8gx)

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.

All time-based command-line options and configuration file directives are subject to the syntax described in gromox(7), section "Duration specifications".

Configuration directives (gromox.cfg)
The following directives are recognized when reading from /etc/gromox/gromox.cfg, or when the -c option is used to specify a custom file:

daemons_fd_limit
    In gromox-delivery-queue, this is treated as an alias for lda_fd_limit.

lda_fd_limit
    Request that the file descriptor table be at least this large. The magic value 0 indicates that the system default hard limit (rlim_max, cf. setrlimit(2)) should be used.
    Default: 0

Configuration directives (smtp.cfg)
The following directives are recognized when reading from /etc/gromox/smtp.cfg, or when the -c option is used to specify a custom file:

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

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_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

See also
gromox(7), delivery(8gx), midb_agent(4gx)