pmailq(8) [debian man page]

PMAILQ(8)																 PMAILQ(8)

NAME

       pmailq - Postfix MAIL Queue manager

SYNOPSIS

       pmailq [OPTION]... [COMMAND]

       pmailq --help

DESCRIPTION

       pmailq parses the output of mailq command from postfix (ie: postqueue -p).  It permits to perform some actions on a group of entries in
       queue (like removing or displaying them in a machine readable format). They are selected by applying filters (wildcards are allowed) 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) the 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 1: display all the entries in queue sent to an email address matching "*@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 2: 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-2011 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.

								    2011-01-05								 PMAILQ(8)

MAILQ(1)						      General Commands Manual							  MAILQ(1)

NAME

       mailq - print the mail queue

SYNOPSIS

       mailq [-Ac] [-q...]  [-v]

DESCRIPTION

       Mailq prints a summary of the mail messages queued for future delivery.

       The  first  line printed for each message shows the internal identifier used on this host for the message with a possible status character,
       the size of the message in bytes, the date and time the message was accepted into the queue, and the envelope sender of the  message.   The
       second  line  shows  the error message that caused this message to be retained in the queue; it will not be present if the message is being
       processed for the first time.  The status characters are either * to indicate the job is being processed; X to indicate that  the  load	is
       too  high to process the job; and - to indicate that the job is too young to process.  The following lines show message recipients, one per
       line.

       Mailq is identical to ``sendmail -bp''.

       The relevant options are as follows:

       -Ac    Show the mail submission queue specified in /etc/mail/submit.cf instead of the MTA queue specified in /etc/mail/sendmail.cf.

       -qL    Show the "lost" items in the mail queue instead of the normal queue items.

       -qQ    Show the quarantined items in the mail queue instead of the normal queue items.

       -q[!]I substr
	      Limit processed jobs to those containing substr as a substring of the queue id or not when !  is specified.

       -q[!]Q substr
	      Limit processed jobs to quarantined jobs containing substr as a substring of the quarantine reason or not when !	is specified.

       -q[!]R substr
	      Limit processed jobs to those containing substr as a substring of one of the recipients or not when !  is specified.

       -q[!]S substr
	      Limit processed jobs to those containing substr as a substring of the sender or not when !  is specified.

       -v     Print verbose information.  This adds the priority of the message and a single  character  indicator  (``+''  or	blank)	indicating
	      whether  a  warning  message  has  been sent on the first line of the message.  Additionally, extra lines may be intermixed with the
	      recipients indicating the ``controlling user'' information; this shows who will own any programs that are executed on behalf of this
	      message  and  the name of the alias this command expanded from, if any.  Moreover, status messages for each recipient are printed if
	      available.

       Several sendmail.cf options influence the behavior of the mailq utility: The number of items printed  per  queue  group	is  restricted	by
       MaxQueueRunSize	if  that  value  is set.  The status character * is not printed for some values of QueueSortOrder, e.g., filename, random,
       modification, and none, unless a -q option is used to limit the processed jobs.

       The mailq utility exits 0 on success, and >0 if an error occurs.

SEE ALSO

       sendmail(8)

HISTORY

       The mailq command appeared in 4.0BSD.

							   $Date: 2013-11-22 20:51:55 $ 						  MAILQ(1)