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_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
- service_plugin_ignore_errors
- If set to yes, service plugins that fail to load on startup are ignored. If set to no, the daemon will exit if any plugin cannot be loaded.Default: no
- service_plugin_list
- Path to a text file which lists the filenames of service plugins to load, one per line.Default: (built-in list)
- service_plugin_path
- Path to a secondary directory where service plugins will be loaded from if a primary search in standard directories (as per ld.so(8)) was unsuccessful.Default: /usr/lib/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
See also¶
gromox(7), delivery(8gx), midb_agent(4gx)