Files

Xeams DevNullSMTP on Gentoo
===========================

The xeams-devnullsmtp launcher always enables upstream's console mode and
forces Java into headless mode. A safe starting point for an isolated Bongo
test is:

  install -d /tmp/bongo-devnull-mail
  xeams-devnullsmtp -p 2526 -d example.test \
    -s /tmp/bongo-devnull-mail -tr terminate@me.please

The arguments are:

  -p PORT       listen on PORT (upstream defaults to privileged port 25)
  -d DOMAINS    comma-separated accepted domains
  -s DIRECTORY  save accepted messages instead of discarding them
  -tr ADDRESS   terminate when a message uses ADDRESS as envelope sender

DevNullSMTP intentionally behaves as an open relay when -d is omitted. It does
not provide an option to select a listen address, so use a firewall, network
namespace or container network to keep the test listener private. Never expose
it to an untrusted network.

STARTTLS with a self-signed certificate is enabled by default. The additional
xeams-devnullsmtp-no-tls launcher disables STARTTLS for an explicit plaintext
test. A custom PKCS#12 certificate can be configured in:

  /etc/java-config-2/launcher.d/xeams-devnullsmtp-bin

For example:

  gjl_java_args="-Djava.awt.headless=true -Ddevnull.cert.pwd=secret \
    -Ddevnull.cert.type=PKCS12 -Ddevnull.cert.file=/path/to/test-cert.p12"

The tool embeds old third-party Java libraries. Run it only inside an isolated,
short-lived test environment.