NAME

pmx-qman - A Quarantine Manager for PureMessage


SYNOPSIS

 pmx-qman [opts]               # interactive shell
 pmx-qman --approve <msg>
 pmx-qman --save <file>
 pmx-qman --index
 pmx-qman --help


DESCRIPTION

The pmx-qman program is used to manage messages quarantined by PureMessage. It is used to browse, release and make reports of messages quarantined by PureMessage. Unless otherwise specified, the last 10,000 messages are read from the cur folder of the quarantine specified in pmx.conf.

If neither the --approve, --save nor the --help options are specified, then the interactive version of pmx-qman is invoked. See Interactive Mode for more information.

The PureMessage Manager provides an alternative web-based interface for quarantine management. See the 'Quarantine' section of the Manager Reference for further information on this alternative.


OPTIONS

The following options are recognized:

--approve msg
Send the quarantined message to the original recipient and move it to the var/qdir/sent directory. (These messages are eventually deleted (or archived) via pmx-qexpire.) The msg argument is either a message store id or the queue id assigned to the message.

--save file
Save quarantined messages in mbox format to the given file.

--qdir path
Override the quarantine directory specified in the quarantine_dir setting in the pmx.conf configuration file.

--max-messages n
Load no more than n messages from the quarantine. The default is 10,000. The default can also be overridden by the PMX_QMAN_MAX_MESSAGES environment variable.

--first
Load quarantine messages from the start of the quarantine rather than the end.

--index
By default pmx-qman does not ensure that the messages most recently added to the quarantine are included in the results. Setting --index ensures that messages that have been quarantined since the last time pmx-qindex, was run are included in the results.

--help
Print a usage message and quit.

Interactive Mode

When using the interactive version of pmx-qman (which is invoked when no options are specified), enter help or ? at the prompt for a list of commands and usage examples.

Message numbers are dynamically assigned based on the message sort order, filters, grouping, etc. Message numbers are regenerated if these parameters change.


ENVIRONMENT VARIABLES

The following environment variables override the behavior of pmx-qman:

PAGER
Selects which pager program to use. If not set use more.

PMX_QMAN_MAX_MESSAGES
Set this variable to override the default number of messages pmx-qman will attempt to load in interactive mode. The default is to load the last 10,000 messages.


SEE ALSO

the pmx-quarantine manpage, the pmx-qdigest manpage, the pmx-qdigest-approve manpage, the pmx-qdigest-expire manpage, the pmx manpage, PureMessage::Milter::Scanner


COPYRIGHT

Copyright (C) 2000-2008 Sophos Group. All rights reserved. Sophos and PureMessage are trademarks of Sophos Plc and Sophos Group.