Juerd Waalboer > Qmail-Deliverable-1.07 > Qmail::Deliverable::Client

Download:
Qmail-Deliverable-1.07.tar.gz

Dependencies

Annotate this POD

View/Report Bugs
Source  

NAME ^

Qmail::Deliverable::Client - Client for qmail-deliverabled

SYNOPSIS ^

    use Qmail::Deliverable::Client qw(deliverable);

    $Qmail::Deliverable::Client::SERVER = "127.0.0.1:8998";

    if (deliverable "foo@example.com") { ... }

DESCRIPTION ^

Qmail::Deliverable comes with a daemon program called qmail-deliverabled. This module is a front end to it.

This module requires LWP (libwww-perl), available from CPAN.

Error reporting

The error message for communication failure is reported via a warning, but also available via $Qmail::Deliverable::Client::ERROR.

Configuration

$Qmail::Deliverable::Client::SERVER

IP adress and port of the qmail-deliverabled server, joined by a colon. Defaults to 127.0.0.1:8998, just like the daemon.

This variable can also be assigned a code reference, in which case it is called in scalar context for each remote call, using the returned value.

If the value is undef, then a connection failure is faked, but without the warning.

Functions

All documented functions are exportable, and a tag :all is available for convenience.

Unless documented differently, these functions follow the interfaces described in Qmail::Deliverable.

qmail_local $address

As Qmail::Deliverable::qmail_local. Warns and returns "" on communication failure.

deliverable $address
deliverable $local

As Qmail::Deliverable::deliverable. Warns and returns 0x2f on communication failure.

PERFORMANCE ^

The server on which I benchmarked this, the client+daemon combination (on localhost) reached 300 deliverability checks per second for assigned/virtual users. Real users are slower: around 150 checks per second.

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.

AUTHOR ^

Juerd Waalboer <#####@juerd.nl>

syntax highlighting: