plugtest.1

NAME

plugtest - test qmail-smtpd plugins

SYNOPSIS

plugtest -MRD [ -l localip -r remoteip -R remotehost -m mailfrom ] recip ...

DESCRIPTION

plugtest(1) tests SMTP plugins for qmail-smtpd(8). By default plugtest(1) looks for plugins in /usr/lib/indimail/plugins directory. You can change this by defining PLUGINDIR environment variable. You can also load multiple plugins by creating smtpd-plugin0.so, smtpd-plugin1.so, and so on. plugtest(1) uses dlopen(3) to open the plugins and execute the MAIL, RCPT & DATA plugins defined in the shared library representing a plugin. After loading the plugin, the function plugin_init() is executed. The function to be executed can be changed by setting environment variable SMTP_PLUGIN_SYM. The function plugin_init() should return a PLUGIN structure (see plugin_init(3) for details). The PLUGIN structure returns pointer to three functions to be executed in the MAIL FROM, RCPT and DATA phase of SMTP.

OPTIONS

-M
Test plugin for MAIL session

-R
Test plugin for RCPT session

-D
Test plugin for DATA session

-i
Set authenticated flag

-I
Set RELAYCLIENT flag

-r remoteip
Pass remoteip as the remote IP address

-R remotehost
Pass remotehost as the remote IP address

-l localip
Pass localip as the local IP address

-m mailfrom
Pass mailfrom as the return path

recip
Pass recip and following arguments as recipients

SEE ALSO

qmail-smtpd(8), dlopen(3) plugin_init(3), gcc(1)