# QMail::QueueHandler

Perl library for dealing with QMail queues

## Introduction

QMail::QueueHandler is a Perl library for handling QMail mail queues.

It is based on [qmHandle](http://qmhandle.sourceforge.net/), a command line program written
by Michele Beltrame, but rewritten to take advantage of modern Perl techniques.

The QMail::QueueHandler distribution contains a new version of qmHandle which has much
the same functionality as the original version.

## Installation

You need a working installation of Qmail for this to work properly. It
looks for QMail queues in all the standard places.

## qmHandle

qmHandle accepts a number of command-line options.

* a: (Attempt to) send all queued messages
* l: List message queues
* L: List local message queue
* R: List remote message queue
* N: List message numbers only
* c: Coloured output
* s: Show statistics of queues
* m <id>: Display message with given number
* f <id>: Delete messages from given sender
* F <id>: Delete messages from given sender (regex match)
* d <id>: Delete message with given number
* S <subj>: Delete messages with matching subject
* h <header>: Delete messages with matching header (case insensitive)
* b <body>: Delete messages with matching body (case insensitive)
* H <body>: Delete messages with matching header (case sensitive)
* B <body>: Delete messages with matching body (case sensitive)
* t <email_addr>: Flag messages with matching recipients
* D: Delete all messages in queues
* V: Display program version
* ?: Display help

## Author

QMail::QueueHandler is written by Dave Cross - dave(at)perlhacks.com, based on
original work by Michele Beltrame.