688
edits
Changes
Jump to navigation
Jump to search
Created page with "<span id="_top">Qpsmtpd#Plugins</span> = NAME = qmail_deliverable - Check that the recipient address is deliverable = DESCRIPTION = See the desc..."
<span id="_top">[[Qpsmtpd#Plugins]]</span>
= [[#___top|NAME]] =
qmail_deliverable - Check that the recipient address is deliverable
= [[#___top|DESCRIPTION]] =
See the description of Qmail::Deliverable.
This '''qpsmtpd plugin''' uses the client/server interface and needs a running qmail-deliverabled. If no connection can be made, deliverability is simply assumed.
The modules LWP (libwww-perl) and HTTP::Daemon, available from CPAN, are required for qmail-deliverabled and Qmail::Deliverable::Client.
= [[#___top|CONFIGURATION]] =
<dl>
<dt>server host:port
<dd><p>Hostname (or IP address), and port (both!) of the qmail-deliverabled server. If none is specified, the default (127.0.0.1:8998) is used.</p>
<dt>server smtproutes:host:port
<dd><p>If the specification is prepended by the literal text <tt>smtproutes:</tt>, then for recipient domains listed in your /var/qmail/control/smtproutes use their respective hosts for the check. For other domains, the given host is used. The port has to be the same across all servers.</p>
<p>Example:</p>
<pre> qmail_deliverable server smtproutes:127.0.0.1:8998</pre>
<p>Use "smtproutes:8998" (no second colon) to simply skip the deliverability check for domains not listed in smtproutes.</p>
<dt>vpopmail_ext [ 0 | 1 ]
<dd><p>Is vpopmail configured with the qmail-ext feature enabled? If so, this config option must be enabled in order for user-ext@example.org addresses to work.</p>
<p>Default: 0</p>
<dt>reject
<dd><p>karma reject [ 0 | 1 | connect | naughty ]</p>
<p>''0'' will not reject any connections.</p>
<p>''1'' will reject naughty senders.</p>
<p>''connect'' is the most efficient setting.</p>
<p>To reject at any other connection hook, use the ''naughty'' setting and the '''naughty''' plugin.</p></dl>
= [[#___top|CAVEATS]] =
Given a null host in smtproutes, the normal MX lookup should be used. This plugin does not do this, because we don't want to harrass arbitrary servers.
Connection failure is *faked* when there is no smtproute.
= [[#___top|LEGAL]] =
This software is released into the public domain, and does not come with warranty or guarantee of any kind. Use it at your own risk.
= [[#___top|AUTHOR]] =
Juerd <#####@juerd.nl>
= [[#___top|SEE ALSO]] =
[http://search.cpan.org/perldoc?Qmail%3A%3ADeliverable Qmail::Deliverable], [http://search.cpan.org/perldoc?qmail-deliverabled qmail-deliverabled], [http://search.cpan.org/perldoc?Qmail%3A%3ADeliverable%3A%3AClient Qmail::Deliverable::Client]
<!-- Generated Sat Apr 13 15:41:52 EDT 2019 using
perldoc -T -ohtml $plugins/$1 \|pandoc -f html -t mediawiki \|sed '1 i\\n\n\n<span id="_top">[[Qpsmtpd#Plugins]]</span>' \|sed -e 's#</d.>##'
-->
----
[[Category:Qpsmtpd|qmail_deliverable]]
= [[#___top|NAME]] =
qmail_deliverable - Check that the recipient address is deliverable
= [[#___top|DESCRIPTION]] =
See the description of Qmail::Deliverable.
This '''qpsmtpd plugin''' uses the client/server interface and needs a running qmail-deliverabled. If no connection can be made, deliverability is simply assumed.
The modules LWP (libwww-perl) and HTTP::Daemon, available from CPAN, are required for qmail-deliverabled and Qmail::Deliverable::Client.
= [[#___top|CONFIGURATION]] =
<dl>
<dt>server host:port
<dd><p>Hostname (or IP address), and port (both!) of the qmail-deliverabled server. If none is specified, the default (127.0.0.1:8998) is used.</p>
<dt>server smtproutes:host:port
<dd><p>If the specification is prepended by the literal text <tt>smtproutes:</tt>, then for recipient domains listed in your /var/qmail/control/smtproutes use their respective hosts for the check. For other domains, the given host is used. The port has to be the same across all servers.</p>
<p>Example:</p>
<pre> qmail_deliverable server smtproutes:127.0.0.1:8998</pre>
<p>Use "smtproutes:8998" (no second colon) to simply skip the deliverability check for domains not listed in smtproutes.</p>
<dt>vpopmail_ext [ 0 | 1 ]
<dd><p>Is vpopmail configured with the qmail-ext feature enabled? If so, this config option must be enabled in order for user-ext@example.org addresses to work.</p>
<p>Default: 0</p>
<dt>reject
<dd><p>karma reject [ 0 | 1 | connect | naughty ]</p>
<p>''0'' will not reject any connections.</p>
<p>''1'' will reject naughty senders.</p>
<p>''connect'' is the most efficient setting.</p>
<p>To reject at any other connection hook, use the ''naughty'' setting and the '''naughty''' plugin.</p></dl>
= [[#___top|CAVEATS]] =
Given a null host in smtproutes, the normal MX lookup should be used. This plugin does not do this, because we don't want to harrass arbitrary servers.
Connection failure is *faked* when there is no smtproute.
= [[#___top|LEGAL]] =
This software is released into the public domain, and does not come with warranty or guarantee of any kind. Use it at your own risk.
= [[#___top|AUTHOR]] =
Juerd <#####@juerd.nl>
= [[#___top|SEE ALSO]] =
[http://search.cpan.org/perldoc?Qmail%3A%3ADeliverable Qmail::Deliverable], [http://search.cpan.org/perldoc?qmail-deliverabled qmail-deliverabled], [http://search.cpan.org/perldoc?Qmail%3A%3ADeliverable%3A%3AClient Qmail::Deliverable::Client]
<!-- Generated Sat Apr 13 15:41:52 EDT 2019 using
perldoc -T -ohtml $plugins/$1 \|pandoc -f html -t mediawiki \|sed '1 i\\n\n\n<span id="_top">[[Qpsmtpd#Plugins]]</span>' \|sed -e 's#</d.>##'
-->
----
[[Category:Qpsmtpd|qmail_deliverable]]