delivery(8gx)

💖 NAME 💖

Okay bestie, meet delivery — the backend for local delivery. This is the delivery(8gx) page from the Gromox admin reference, and yes, we're getting through every single flag together. 🫶✨

🛠️ SYNOPSIS 🛠️

delivery [-c config]

✨ OPTIONS ✨

• -c config — Reads configuration directives from the file you point at. If this option is not specified, /etc/gromox/gromox.cfg and /etc/gromox/delivery.cfg will be read. 💅
• -? — Displays an option summary. Short, sweet, iconic. 🎀

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

⚙️ CONFIGURATION DIRECTIVES (gromox.cfg) ⚙️

These 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, this is treated as an alias for lda_fd_limit. Basically a nickname situation. 🙈
• lda_fd_limit — Requests 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.
• outgoing_smtp_url — See gromox.cfg(5):outgoing_smtp_url. Go read that lore. 👑

🎀 CONFIGURATION DIRECTIVES (delivery.cfg) 🎀

These directives are recognized when reading from /etc/gromox/delivery.cfg, or when the -c option is used to specify a custom file:

• admin_mailbox — An e-mail address where to send reports from the "net_failure" code component. Default: (empty).
• config_file_path — Colon-separated list of directories which will be scanned when locating further configuration files, especially those used by subcomponent instances. For example, mysql_adaptor(4gx) would be directed to look at /etc/gromox/delivery/mysql_adaptor.cfg before /etc/gromox/mysql_adaptor.cfg. Default: /etc/gromox/delivery:/etc/gromox.
• data_file_path — Colon-separated list of directories in which static data files will be searched. Default: /usr/share/gromox/delivery.
• dequeue_max_mem — Default: 1024M.
• dequeue_path — Default: /var/lib/gromox/queue.
• free_context_num — Default: 512.
• host_id — A unique identifier for this system. It is used for the DSN text of bounce messages. It is used as the value for the EHLO command if and when connecting to an SMTP service (e.g. inbox rules that do forwarding). Default: (system hostname).
• 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).
• running_identity — An unprivileged user account to switch the process to after startup. Default: gromox.
• work_threads_max — The number of threads that gromox-delivery may spawn to process incoming messages. This number must be less-or-equal to the exmdb_local(4) exmdb_connection_num directive to avoid rejection of messages in a message storm. Default: 5.
• work_threads_min — Default: 1.

📡 SIGNALS 📡

Upon receipt of SIGHUP, configuration files are re-read, but only a few select directives can be changed this way, as many parts do not implement reload. So yeah, not a full hot-reload slay. 😭💀

👀 SEE ALSO 👀

gromox(7)

---

That's the whole page, bestie 💖 Source/version: Gromox, manual: delivery(8gx). There's no separate date line in this footer to copy, so this cute sign-off is carrying the footer energy. 🎀🫶