Poster of Linux kernelThe best gift for a Linux geek
PMAILQ

PMAILQ

Section: (8) Updated: 2008-01-29
Local index Up
 

NAME

pmailq - Postfix MAIL Queue manager  

SYNOPSIS

pmailq [OPTION]... [COMMAND]

pmailq --help  

DESCRIPTION

pmailq parses output of mailq command from postfix (ie: postqueue -p) and permits to perform some actions (like removing or displaying in a machine readable format) on a bunch of entries in queue, selected by applying patterns on criterias like email address, error message from smtp server, message size, mail status in queue.  

COMMANDS

Action to perform on selected entries.
list (default command)
show a detailed listing of the selected entries
parse
show a listing of the selected entries in a machine readable format
del
delete (via postsuper -d) selected entries
 

OPTIONS

-e PATTERN, --email=PATTERN
select entries in queue with email matching PATTERN (PATTERN accepts wildcards)
-m PATTERN, --msg=PATTERN
select entries in queue with error message matching PATTERN (PATTERN accepts wildcards)
-l SIZE, --size-lower=SIZE
select entries in queue with size lower than SIZE bytes
-u SIZE, --size-upper=SIZE
select entries in queue with size upper than SIZE bytes
-a
select 'active' entries in queue
-o
select 'on hold' entries in queue
--version
show program's version number and exit
-h, --help
show this help message and exit
 

EXAMPLES

Example nAX1 : display all the mails in queue to ``*@example.com*'' with a size between 3000 and 3200 bytes in a machine readable format :

 # pmailq -u 3000 -l 3200 -e "*@example.com" parse
 7E75214643A4|Fri Aug 31|3154|1|0|edgar@example.com
 B0BDE146B640|Thu Aug 30|3199|1|0|paul@example.com
 B587E146B675|Wed Aug 29|3065|0|0|paul@example.com
 CF3C514656E4|Wed Aug 29|3161|0|0|abuse@example.com
      /\         /\       /\  \  \      
   queue id     date     size  \  \ on hold (or not)
                                \ active (or not)

Example nAX2 : remove all mails in queue not sent because of a connection time out :

 # pmailq -m "*connection*timed*out" del
 deleting 00CF514616D3 [OK]
 deleting 12D911461924 [OK]
 deleting 269EF1461CA9 [OK]
 deleting 288DF1461CA0 [OK]
 deleting 3B3901460F62 [OK]
 deleting 3AE58147019F [OK]

 

SEE ALSO

postsuper(1) privileged queue operations, postqueue(1) mail queue control  

AUTHOR

Emmanuel Bouthenot <kolter@openics.org>  

COPYRIGHT AND LICENSE

Copyright 2007 by Emmanuel Bouthenot <kolter@openics.org>

This program is released under the ``do What The Fuck you want to Public Licence'' Version 2, as published by Sam Hocevar.

See http://sam.zoy.org/wtfpl/COPYING for more details.  

POD ERRORS

Hey! The above document had some coding errors, which are explained below:
Around line 36:
You forgot a '=back' before '=head1'
Around line 72:
You forgot a '=back' before '=head1'
Around line 97:
You forgot a '=back' before '=head1'


 

Index

NAME
SYNOPSIS
DESCRIPTION
COMMANDS
OPTIONS
EXAMPLES
SEE ALSO
AUTHOR
COPYRIGHT AND LICENSE
POD ERRORS

This document was created by man2html, using the manual pages.
Time: 22:02:09 GMT, April 16, 2011