qmHandle 1.0.0
                              ==============


INTRO
-----

This is a simple program that allows you to view and manage (withing some
limits) the qmail queue, both remote and local.

With this program you can:

  * Read the qmail queue, like you do with the qmail-qread program. However,
    the output of this program is improved over qmail-qread, with the output
    of the message subjects and color capabilities.
  * Print queue statistics, like qmail-qstat, with color capabilities
  * View a message in the queue.
  * Remove one or more messages from the queue.


CONFIGURATION
-------------

There are only a few variables to configure, and this has to be done depending
on your system and qmail installation. You can find the variables at the top of
the Perl script qmHandle (there's a configuration section properly marked).
The variables are:

1) my ($queue) = '/var/qmail/queue/';
This is the path of your qmail queue directory. It's located here on 99.9%
of qmail installation. If yours seems not to be there, try using the "find"
command to locate it.

2) my ($stopqmail) = '/etc/init.d/qmail stop';
This is the name of the script/command which stops qmail. The one you
see works on Debian GNU/Linux, if you have other you need to change it.
In the script configuration section you'll find some examples of
common options, including the one using DJB's daemontools. If you
don't have any script to stop qmail, you *must leave this string
empty*:
	$stopqmail = '';

3) my ($startqmail) = "/etc/init.d/qmail start";
This is the name of the script/command which stops qmail. The one you
see works on Debian GNU/Linux, if you have other you need to change it.
In the script configuration section you'll find some examples of
common options, including the one using DJB's daemontools and the
standard qmail distribution.

4) my ($pidcmd) = 'pidof qmail-send';
This is the command used to obtain qmail process id. The default
should work on most Unix systems, but if on yours doesn't you can
change it.

Please note that variables from 2 to 4 are only needed to set properly
if you need to use qmHandle to delete messages in the queue. The first
one is however needed in any case.


USAGE
-----

Usage is fairly simple. Here goes the help screen:

Available parameters are:
  -l   : list message queues
  -L   : list local message queue
  -R   : list remote message queue
  -s   : show some statistics
  -vN  : display message number N
  -dN  : delete message number N
  -D   : delete all messages in the queue (local & remote)

Additional (optional) parameters are:
  -c  : display colored output
  -N  : list message numbers only
        (to be used either with -l, -L or -R)

It's possible to specify multiple parameters for multiple actions, in any
order.

Please note that you'll have to be superuser (root) in order to use this
program.

A typical output of the command:

	qmHandle -l

could be:

-------------------------------------------------
143874 (9, R)
  Return-path: m.beltrame@betamag.com
  From: Michele Beltrame <m.beltrame@betamag.com>
  To: beta-reg@nice.it
  Subject: Re: [beta-reg] Server news pubblico.
  Date: Fri, 10 Apr 1998 09:04:32 +0200
  Size: 1600 bytes
-------------------------------------------------

The first line shows the number the message has in queue (the name of the
files in which it's stored) and, between parentheses, the directory number
where it's located and the queue he's in (L=local, R=remote).


GPL SOFTWARE
------------

This is open source software under the GPL. For more information on the license
have a look at:

http://www.gnu.org

If you use it please send me and e-mail (mick@io.com), so that I know how many
people are using my software.

I like travelling, so I'd also appreciate a postcard, although is not required
by the license. ;-)
The address is:

	Michele Beltrame
	Via S. Francesco, 16
	33085 Maniago PN
	Italy