Skip to content

qmail rspawn.8

Manvendra Bhangui edited this page Feb 25, 2024 · 7 revisions

NAME

qmail-rspawn - schedule remote deliveries

SYNOPSIS

qmail-rspawn

DESCRIPTION

qmail-rspawn reads a series of remote delivery commands from descriptor 0, invokes qmail-remote to perform the deliveries, and prints the results to descriptor 1. If the environment variable QMAILREMOTE is defined, the executable defined by QMAILREMOTE is invoked instead.

qmail-rspawn sets the environment variable MESSID pointing to the message file in the queue.

qmail-rspawn invokes qmail-remote or the path defined by QMAILREMOTE environment variable asynchronously, so the results may not be in the same order as the commands.

qmail-rspawn runs as qmailr user, qmail group and with supplementary groups defined for qmailr user if the environment variable USE_SETGROUPS is set for qmail-start(8).

Virtual Package Functionality

qmail-rspawn can load an external library to add functionality. The virtual package can be loaded by setting the environment variable VIRTUAL_PKG_LIB or by using the control file libindimail. The value in libindimail is set to libindimail.so by default. If there is any problem loading the library or loading symbols required, qmail-lspawn will exit with -3.

Following functions should be provided by the shared library for adding features to qmail-lspawn - get_real_domain(), is_distributed_domain(), findhost(). If such a library is opened qmail-rspawn connects to MySQL(1). For a clustered domain, it queries hostcntrl in MySQL(1) to figure out the host where it needs to send out the mail using SMTP / QMTP. It sets the SMTPROUTE environment variable if the environment variable ROUTES is set as "smtp". It sets the QMTPROUTE environment variable if the environment variable ROUTES is set as "qmtp". To turn off this behaviour of setting dynamically SMTPROUTE/QMTPROUTE variable, set the environment variable ROUTES=static. If SMTPROUTE is set qmail-remote uses SMTPROUTE variables instead of control file smtproutes and uses SMTP. If QMTPROUTE is set qmail-remote uses QMTPROUTE variables instead of control file qmtproutes and uses QMTP. qmail-remote prefers QMTP over SMTP.

SEE ALSO

qscheduler(8), qmail-start(8), qmail-send(8), todo-proc(8), qmail-remote(8)

Clone this wiki locally