Pfhandle mail queue manager

From SME Server
Jump to navigationJump to search






pfHandle
NeedImage.svg
pfHandle logo
MaintainerUnnilennium
Source:smeserver-pfhandle
Source:pfHandle
Licenceopen source
Category

Mail

Tags Monitoring Manager



pfHandle mail queue manager

Overview

The pfHandle rpm will install a Mail queue manager panel in server manager. We have rewritten this tool (previously qmHandle) to work now with postfix, since this is the new mail service since SME11.

Version

smecontribs 11:
smeserver-pfhandle
The latest version of smeserver-pfhandle is available in the SME repository, click on the version number(s) for more information.


smecontribs 11:
pfHandle
The latest version of pfHandle is available in the SME repository, click on the version number(s) for more information.


Installation

dnf install smeserver-pfhandle --enablerepo=smecontribs

The post upgrade event and reboot are not required.

Usage

Installing the rpm will add a panel to server manager that controls the mail queue.

You should preferably use the server manager panel.


You can also control the mail queue using pfHandle at the command prompt with the following parameters:

pfHandle option pfHandle action equivalent in qmhandle
-a list the current active mail queue
-b list the current bounce mail queue
-c list the current corrupt mail queue
-d list the current deferred mail queue
-D # delete the email message -d#
-f try to reprocess queued messages now -a
-F sender delete all mail from this email address -fsender
-h show this help message --help
-l list all the current mail queues -l
-m # display the email message -m#
-N display only the message IDs -N
-P [hold|incoming|active|deferred] purge all messages from the mail queue -D
-s display the mail queue statistics -s
-S subject delete all mail with this in the subject -Ssubject

compared to qmHandle we are missing these functions

 -L       : list local message queue 
 -R       : list remote message queue 
 -f're'   : delete message from senders matching regular expression re
 -Stext   : delete all messages that have/contain text as Subject 
 -h're'   : delete all messages with headers matching regular expression re (case insensitive)
 -b're'   : delete all messages with body matching regular expression re (case insensitive)
 -H're'   : delete all messages with headers matching regular expression re (case sensitive)
 -B're'   : delete all messages with body matching regular expression re (case sensitive)
 -t're'   : flag messages with recipients in regular expression 're' for earlier retry (note: this lengthens the time message can stay in queue)



Examples of usage syntax would be:

To list all the messages in the queues

pfHandle -l

To list all the messages in the queue counting the number of messages with the same subject

pfHandle -l|grep Subject|sort| uniq -c|sort -n

Removal

Remove (uninstall) the rpm with the command

dnf remove  smeserver-pfhandle


Bugs

Please raise bugs under the SME-Contribs section in bugzilla and select the smeserver-pfhandle component or use this link


"No open bugs found."

Changelog

Only versions released in smecontrib are listed here.

smeserver-pfhandle-11.0-5.el8.sme Changelog: SME 11 (smecontribs)
2026/05/27 Jean-Philippe Pialasse 11.0-5.sme
- remove SM1 panel [SME: 13349]
2025/11/13 Vasarhelyi Zsolt 11.0-3.sme
- Fix server-manager US locale [SME: 13274]
2025/11/05 Brian Read 11.0-2.sme
- Refactor filenames, routes etc to bring it into line with other modules, v11 to reflect SME11 [SME: 13274]
2025/11/03 Vasarhelyi Zsolt 1.0-1.sme
- Initial release [SME: 12853]