1. Manuals
  2. Tumbleweed
  3. gromox
  4. gromox.cfg(5)

Scroll to navigation

gromox.cfg(5) Gromox admin reference gromox.cfg(5)

Name

gromox.cfg — Central configuration file for Gromox services

Description

The common configuration file utilized by all services. Historically, each service had separate configuration files, but the number of directives that needed explicit configuration were reduced over time to the point that there were too many distinct files for little value, and so, gromox.cfg came to be.

Configuration directives

This manpage does not describe all possible directives. Please also consult the manpages of gromox daemons and command-line utilities for more.

If an autoreply message (other than a bounce report, e.g. out-of-office) is to be generated, that return message will be suppressed if another autoreply for the given {From, To} address pair was produced within the given time period previously. (Unlike the response_audit_capacity directive, autoreply pairs are stored persistently, in the message database.)
Default: 1day
Out-of-office replies use the subject that was set alongside the OOF message. Clients which configure OOF over EWS cannot set one, because SetUserOofSettings has no field for it. When no subject is stored, this prefix plus the subject of the incoming message is used instead. Set to the empty string to send such replies without a subject.
Default: Out of Office:
Try to fill the PR_TRANSPORT_MESSAGE_HEADERS property when messages are submitted. Turning this option on requires extra storage (usually between 0.5KB and 1KB per sent message). Transport headers for sent messages can be generated on the fly from the regular MAPI message data structures e.g. via gromox-export(8) for analysis, so unless there is a need to retain the results from older generator versions, you should leave this off.
Default: off
This directive defines the Envelope-From and From addresses for system-generated bounce messages such as Non-Delivery-Reports (autoresponse messages about e.g. mailbox being full, or a target email address being invalid). RFC-5321-5322-consuming components like SMTP, IMAP and EAS want to have an SMTP-looking address in this field. Preferably, it should point to the administrator's mailbox (or an alias thereto).
When the value set here has no domain part and ends in just '@', the domain is taken from a re-resolution of the system hostname (so as to cope with an unqualified hostname in /etc/hosts that many system installations use).
Default: postmaster@
A semicolon-separated list of header/value matches that make delivery(8) place incoming messages into the junk folder rather than Inbox. Each entry in this list has the form Header=val (`:` may be used in place of `=`). Header names and values are compared case-insensitively. Values are checked both against the full header value and individual comma/semicolon separated tokens; use an empty value to match any header value.
Default: (empty)
Example: X-Spam-Flag=YES; X-MC-Relay=; X-SG-EID=
In a split domain setup, a domain is defined in this system, but only some of its addresses have a mailbox here; the remaining addresses are hosted on a foreign system, and the MTA carries the routing information to get there. When this directive is enabled, messages which delivery(8gx) generates itself (out-of-office autoreplies, non-delivery reports) for an address without a mailbox are handed to the MTA (cf. outgoing_smtp_url) rather than discarded. The MTA must route such addresses away from this host (e.g. with Postfix transport_maps); otherwise the message comes back via SMTP and is bounced to its originator. Messages that arrived via SMTP are not affected, since the MTA has already made its routing decision for them; messages to the bounce_postmaster address are not affected either, so that double bounces stay local.
Default: off
If the execution of an RPC takes longer than the specified time, the client will sever the connection and return an error to the calling program. The timeout covers the complete response transfer, not just the pause between two bursts of bytes. The special value 0 disables RPC timeout checking, which means clients may wait indefinitely on a exmdb server that is erroneously stuck or legitimately busy (e.g. a long-running gromox-mbop(8gx) "vacuum" call).
Default: 0
A string which selects how outgoing messages are handed to a mail transfer agent. The syntax follows the Common Internet Scheme for URIs (RFC 1738 section 3.1), so something like "sendmail://localhost" or "smtp://[::1]:25/" can be used.
The sendmail:// transport selects the local maildrop queue (hostname is ignored). Maildrop is perhaps best known to administrators by the command /usr/sbin/sendmail. This transport is the most robust one, because local maildrop implementations generally accept messages even if the MTA is not running (assuming everything else is fine, e.g. there is enough free disk space). Partial Delivery Failure handling then is also the MTA's responsibility, and the MTA will consistently emit NDR/DSN for unreachable recipients.
Other recognized schemes are smtp:, smtp+tls: (STARTTLS), smtp+unverifiedtls: (STARTTLS but ignore validation issues) and smtps: (always-on/implicit TLS). These are only meant for developers who want to avoid running an MTA for having faster turnarounds. All SMTP transport drivers are locally unqueued, which means that, if the SMTP server is unavailable due to network issues, pressing the "Send" button will immediately produce an error in always-online MUAs, and the user has to save the message as a draft and try again later on their own accord. MAPI also has no way to be conveyed Partial Delivery Failure occuring in SMTP conversations, so a multi-recipient message with one bad recipient can lead to three bad characteristics all at once: valid recipients will receive a message copy; the sender got the Send button error; no Non-Delivery Report is generated for users in the local mail system. The proper way to use a custom outgoing SMTP server is to configre the localhost MTA to perform relaying.
Default: sendmail://localhost
Make the "TWOSTEP" Client-Side Inbox Rule Processor emit information about the conditions it is evaluating and the actions it is carrying out. The surrounding process also needs to have log level set to at least 6 (debug) to see anything, i.e. delivery.cfg:lda_log_level=6 in case of delivery(8gx), or --loglevel=6 in case of command-line tools like case of gromox-import(8). [The Rule Processor implementation inside exmdb_provider(8gx) logs unconditionally, and its log messages will be seen, provided level 6 is set with http.cfg:http_log_level=6.]
Default: off

Default: 15.00.0847.4040
Gromox already uses VMIME in some established capacity. This setting enables even more code under development.
Arbitrary identifier for converting between usernames and ESSDNs ("Enterprise/site/server distinguished name") a.k.a. LegacyDNs, which are an archaic form to refer to user entities (and/or their mailbox). New installations should not set this directive anymore. If the value is customized though, the value needs to be consistent across the entire Gromox cluster. Changing the value after any mailbox has been created can invalidate references to participants in existing messages and calendar events.
Default: (unspecified, i.e. do not rely on observing any particular value)

See also

gromox(7)

Gromox