NAME
Mail::Qmail::Queue::README - Overview of Mail::Qmail::Queue
SYNOPSIS
"Mail::Qmail::Queue" is a small collection of modules to help with
talking to qmail-queue and/or writing replacements for it. It also
contains some handy command-line tools for testing "qmail-queue" or its
replacements.
Writing "qmail-queue" replacements is a popular way to replace parts of
the functionality of the functionality of qmail
(<http://cr.yp.to/qmail.html>). Because of qmail's modular style, it's
easy to swap out individual components to change their behavior.
This is commonly done with Bruce Guenter's QMAILQUEUE patch
(<http://www.qmail.org/top.html#qmailqueue>), also included in netqmail
(<http://www.qmail.org/netqmail/>). This patch lets you override the
standard "qmail-queue" program by setting the environment variable
"QMAILQUEUE". It can also be done by renaming the original
"qmail-queue", installing your script in its place, and having your
script call the renamed "qmail-queue" to inject the message.
MODULES
Mail::Qmail::Queue::Message
Easy-to-use module for sending and receiving messages.
Mail::Qmail::Queue::Receive::Envelope
Receive the envelope of a message.
Mail::Qmail::Queue::Receive::Body
Receive the body of a message.
Mail::Qmail::Queue::Send
Send a message body and envelope.
Mail::Qmail::Queue::Error
Utilities for handling errors.
UTILITIES
These utilities are useful for debugging and testing.
qqtest
Test a "qmail-queue" replacement.
qqdump
Dump the information sent to a "qmail-queue" replacement.
BUGS
By convention, Perl modules start with an upper-case letter. Therefore,
this module is called "Mail::Qmail::Queue", even though that's not the
proper capitalization for "qmail".