relay-ctrl-allow(8)

NAME
relay-ctrl-allow - selectively enable SMTP relaying

SYNOPSIS
relay-ctrl-allow command [ arguments ... ]

DESCRIPTION
relay-ctrl-allow looks up the client's IP address from $TCPREMOTEIP and adds it to the directory specified by either $RELAY_CTRL_DIR_FD (set by relay-ctrl-chdir) or $RELAY_CTRL_DIR if the client was authenticated by the server program. It writes the value of the $USER and $DOMAIN variables into that file, if they are set, so that relay-ctrl-check can export them back into the environment. It then executes the command named on the command line.

If $AUTHUSER and $AUTHARGV0 are set, the invoker is determined to be either Courier IMAP or Courier POP3, and relay-ctrl-allow checks the environment for $AUTHENTICATED to determine if authentication succeeded. Otherwise, the invoker is determined to be either qmail-popup or pop3front-auth (or similar) and authentication has succeeded.

RETURN VALUES
Returns 111 (temporary failure) if any operation fails; otherwise the exit value is that of the executed program.

SEE ALSO
relay-ctrl-age(8), relay-ctrl-check(8), qmail-pop3d(8), qmail-popup(8), tcpserver(1), tcp-environ(5)

NOTES
If $RELAY_CTRL_DIR_FD is set, the IP files are created with permissions set to world writeable so that they may be overwritten.