pmailq.pod 2.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114
  1. =head1 NAME
  2. pmailq - Postfix MAIL Queue manager
  3. =head1 SYNOPSIS
  4. pmailq [I<OPTION>]... [I<COMMAND>]
  5. pmailq B<--help>
  6. =head1 DESCRIPTION
  7. pmailq parse output of B<mailq> command from postfix (ie: I<postqueue -p>) and permits
  8. to perform some actions (like removing or displaying in a machine readable format) in
  9. a bunch of entries in queue, selected by applying patterns on criterias like email
  10. address, error message from smtp server, message size, mail status in queue.
  11. =head1 COMMANDS
  12. Action to perform on selected entries.
  13. =over 2
  14. =item B<list> (default command)
  15. show a detailed listing of the selected entries
  16. =item B<parse>
  17. show a listing of the selected entries in a machine readable format
  18. =item B<del>
  19. delete (via I<postsuper -d>) selected entries
  20. =head1 OPTIONS
  21. =over 2
  22. =item B<-e> I<PATTERN>, B<--email>=I<PATTERN>
  23. select entries in queue with email matching PATTERN (PATTERN accepts wildcards)
  24. =item B<-m> I<PATTERN>, B<--msg>=I<PATTERN>
  25. select entries in queue with error message matching PATTERN (PATTERN accepts wildcards)
  26. =item B<-l> I<SIZE>, B<--size-lower>=I<SIZE>
  27. select entries in queue with size lower than SIZE bytes
  28. =item B<-u> I<SIZE>, B<--size-upper>=I<SIZE>
  29. select entries in queue with size upper than SIZE bytes
  30. =item B<-a>
  31. select 'active' entries in queue
  32. =item B<-o>
  33. select 'on hold' entries in queue
  34. =item B<--version>
  35. show program's version number and exit
  36. =item B<-h>, B<--help>
  37. show this help message and exit
  38. =head1 EXAMPLES
  39. =over 1
  40. Example n°1 : display all the mails in queue to "*@example.com*" with a size between 3000 and 3200 bytes in a machine readable format :
  41. # pmailq -u 3000 -l 3200 -e "*@example.com" parse
  42. 7E75214643A4|Fri Aug 31|3154|1|0|edgar@example.com
  43. B0BDE146B640|Thu Aug 30|3199|1|0|paul@example.com
  44. B587E146B675|Wed Aug 29|3065|0|0|paul@example.com
  45. CF3C514656E4|Wed Aug 29|3161|0|0|abuse@example.com
  46. /\ /\ /\ \ \
  47. queue id date size \ \ on hold (or not)
  48. \ active (or not)
  49. Example n°2 : remove all mails in queue not sent because of a connection time out :
  50. # pmailq -m "*connection*timed*out" del
  51. deleting 00CF514616D3 [OK]
  52. deleting 12D911461924 [OK]
  53. deleting 269EF1461CA9 [OK]
  54. deleting 288DF1461CA0 [OK]
  55. deleting 3B3901460F62 [OK]
  56. deleting 3AE58147019F [OK]
  57. =head1 SEE ALSO
  58. L<postsuper(1)> privileged queue operations, L<postqueue(1)> mail queue control
  59. =head1 AUTHOR
  60. Emmanuel Bouthenot <kolter@openics.org>
  61. =head1 COPYRIGHT AND LICENSE
  62. Copyright 2007 by Emmanuel Bouthenot <kolter@openics.org>
  63. This program is released under the "do What The Fuck you want to Public Licence"
  64. Version 2, as published by Sam Hocevar.
  65. See http://sam.zoy.org/wtfpl/COPYING for more details.
  66. =cut