Pfqueue

pfqueue - A queue realtime scanner for MTA

Beschreibung

pfqueue is a simple console tool for managing MTA (Mail Transfer Agent) message queues. It handles queues through 'backends', libraries that interact with the MTA, and displays informations through a console, ncurses based 'frontend'. Currently, pfqueue has backends for Postfix (both 1.x and 2.x) and Exim (both version 3 and 4).

SYNOPSIS

pfqueue [-ehvn] [-b postfix1|postfix2|exim] [-q queue#] [-m maxmsg]  [-s seconds] [-l seconds] [-B backends_path] [-p executables_path] [-c config_path] [-d seconds]

Optionen

pfqueue accepts the following options, which are common to any backend:

-B backends_path Tell pfqueue where backends are located. They should be automatically found, since your installation should have placed them in a standard lib dir. If not so, use this option to force it.

-b backend Load a given backend. It can be autodetect, postfix1, postfix2 or exim. Backends are libraries named pfq_backendname.so, located in the instal‐ lation library path (except for autodetect, which is only a virtual backend that will try to guess what kind of MTA is installed on the ma‐ chine, and to load the proper backend).

-v Show version.

-h Show usage.

-c config Use a custom MTA configuration; note that the meaning of 'configuration' may vary: for example, postfix needs a directory, exim needs a file.

-m max Set the maximum number of messages shown in a queue. The default is 200.

-s seconds Set the display autorefresh rate in seconds. Default is 1.

-e Start reading from/to fields from message envelope instead of headers, if the backend (and MTA) supports it.

-p directory Set MTA executables path.

-q queue_num Start by scanning the queue number queue_num: 1 for deferred, 2 for ac‐ tive, 3 for incoming, 4 for hold, whatever the MTA calls them. Some backends may not support all of these queues.

-l limit Make pfqueue limit the time for scanning the queue tree and for retreiv‐ ing messages informations to this number of seconds; time is not that accurate, since blocking I/O operations may cause lags, but it shouldn't go too far. Obviously, limiting process run time may lead to uncomplete results. Use this option just in case pfqueue takes too long in per‐ forming operations, or you have a very slow machine, or you have very busy queues.

-d seconds Seconds to wait between queue scans. Default is 1.

-n Toggle colors off; note that use of colors can be toggled also when pfqueue is running, with '+' key.

-r Remote host to connect to. This implies a spfqueue instance running on the remote host.

Exit-Status

pfqueue returns 0 if everything goes fine, or:

-1 if pfqueue library cannot be initialized
-2 if frontend cannot be initialized
-3 if you are not root
-4 if pfqueue library cannot be started

Testfragen

Testfrage 1

Antwort1

Testfrage 2

Antwort2

Testfrage 3

Antwort3

Testfrage 4

Antwort4

Testfrage 5

Antwort5

Manpage

PFQUEUE(8) System Manager's Manual PFQUEUE(8)

AUTHOR

Stefano Rivoir <s.rivoir@gts.it>

HISTORY

pfqueue was originally thought as a dedicated Postfix tool, and actually it has been so up to version 0.3.8; since version 0.4.0 it has been extended to use pluggable libraries in order to support virtually any kind of MTA.

January 19, 2007 PFQUEUE(8)