
qmail-remove 0.9:

qmail-remove will remove messages containing a particular string from 
your qmail queue.

Why?:

  This is a useful thing to do in a number of situations.  For 
instance, if you are hit with a spamming attack, you can temporarily
instate a second qmail installation (once the spam run is finished),
allow it to take over mail receipt, and then use this tool to clean
the offending mails out of the queue before switching over to the main
qmail installation once again.
  Occasionally, viruses will get past scanners before the signatures
get updated; if they exist in large numbers, it is often practical to
stop the qmail install briefly in order to clean out all messages 
containing a signature related to the virus.

Whatever the reason to pull items from your mail queue, this program
will delete them in such a manner that will let you restore them easily.

"Removed" Emails:

Mails are *not* deleted from the queue!  They are only stored, temporarily,
in $qmail-queue/yanked/, where you can view them individually and
restore them back to the queue manually.  There is currently no support
for restoring them automatically.  You must create the yanked directory
before calling qmail-remove with the -r option.

By default, qmail-remove assumes that your qmail queue is stored in
/var/qmail/queue, but this can be changed with a command line option.
Similarly, qmail-remove assumes that your queue "split" is 23 by
default, among other things.

See qmail-remove -h for more commandline options.

Deleting Emails:

Hussain Ali has submitted a patch which has been included with this version,
that allows you to use the -d option to delete mail from the queue rather than
yanking it into the yanked directory.  If you use this option and do not specify
a pattern, all mail will be deleted from the queue.

WARNING: YOU MUST STOP QMAIL BEFORE USING THIS PROGRAM.

Support:

WARNING: Although this program was tested in certain environments, you
are using this program at your own risk.  If you blow up your qmail
queue, lose emails, or any other adverse affects, we are not
responsible.  Having said that, as long as your mailer is not running,
you SHOULD be fine.  Please report any bugs immediately to
support@linuxmagic.com.
