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]

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)

USAGE

During program run, what you see is a window divided into two sections: the up‐ per one is the list of messages found in the current queue, and the lower one is a small selection of details for the current message. A number of operation can then be done on a single message, or on a bunch of selected messages.

UP/DOWN arrow keys Move the cursor up/down.

HOME/END or g/G Move to the top/bottom of the list.

1, 2, 3, 4, 5 Select queue to show. Every MTA handles queues in its own way, so these are general keys that cannot be generically described. For Postfix, they will select respectively 'deferred', 'active', 'incoming', 'hold' and 'corrupt' queues. For Exim, they will have no effect since the backend (and Exim, really) does not archive messages in different queues depend‐ ing on their status.

d Delete message.

h Hold message.

l Release message.

r Requeue message.

m Mark current message: this will "mark" the message as the start of a block, and the following 't' key (see below) will tag all messages be‐ tween that and the tagged one.

t Tag/untag message; tagged messages will be shown in bold. To operate on all the tagged messages at once, use ';' key (see below). If a mark (see above) is present, all messages between the tagged and the marked will be tagged.

a Tag all messages.

u Untag all messages.

Make delete/hold/release/requeue actions work on all of the tagged mes‐

sages at once.

Toggle auto-work-on-tagged: when activated, and if there are tagged mes‐

sages, actions will work on tagged indipendently of work-on-tagged sta‐ tus (';' key).

e Toggle reading from/to fields from envelope or headers, if the backend supports it.

s Show current message details.

/ Find first message matching a POSIX regexp; the regexp you use can be prefixed by one of f:, t:, e:, s: which will limit the search in, re‐ spectively, the From, To, From-or-To, Subject fields. The default is to search everywhere.

n Find next message matching last used regexp.

p Find previous message matching last used regexp.

T Search and tag messages: all messages matching the regexp will be tagged; the same prefixes described in '/' search can be used.

c Enable/disable confirmation request for action on messages.

- Toggle queue scanning on/off. Use it when you have a fast changing situ‐ ation and you want to freeze it for further examination. Note that then scanning is disabled, the messages you see in the list may have gone away (delivered?) in the meantime.

+ Toggle colors on/off.

> Increase body window height.

< Decrease body window height.

, Scroll body window up.

b Show/hide body window.

. Scroll body window down.

B Toggle body automatic show on/off.

s Show body in a new window.

S Sort queue by from/to/subject. Keep in mind that it may slow down inter‐ face, since the full queue must be read in order to be sorted.

ENTER Show body of current message (if automatic show is off): if body window is not enabled, it behaves like 's' key.

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)