SYNOPSIS
exipick [<options>] [<criterion> [<criterion> ...]]
DESCRIPTION
exipick is a tool to display messages in an Exim queue. It is very
similar to exiqgrep and is, in fact, a drop in replacement for
exiqgrep. exipick allows you to select messages to be displayed using
any piece of data stored in an Exim spool file. Matching messages can
be displayed in a variety of formats.
QUICK START
Delete every frozen message from queue:
exipick -zi | xargs exim -Mrm
Show only messages which have not yet been virus scanned:
exipick '$received_protocol ne virus-scanned'
Run the queue in a semi-random order:
exipick -i --random | xargs exim -M
Show the count and total size of all messages which either originated
from localhost or have a received protocol of 'local':
exipick --or --size --bpc \
'$sender_host_address eq 127.0.0.1' \
'$received_protocol eq local'
Display all messages received on the MSA port, ordered first by the
sender's email domain and then by the size of the emails:
exipick --sort sender_address_domain,message_size \
'$received_port == 587'
Display only messages whose every recipient is in the example.com
domain, also listing the IP address of the sending host:
exipick --show-vars sender_host_address \
'$each_recipients = example.com'
Same as above, but show values for all defined variables starting with
sender_ and the number of recipients:
exipick --show-vars ^sender_,recipients_count \
'$each_recipients = example.com'
OPTIONS
--and
Display messages matching all criteria (default)
-b Display messages in brief format (exiqgrep)
-bp Display messages in standard mailq format (default)
-bpa
Same as -bp, show generated addresses also (exim)
-bpc
Same as -bp, but only show undelivered messages (exim)
-c Show a count of matching messages (exiqgrep)
--caseful
Make operators involving '=' honor case
--charset
Override the default local character set for $header_ decoding
-f <regexp>
Same as '$sender_address = <regexp>' (exiqgrep)
--flatq
Use a single-line output format
--freeze <cache file>
Save queue information in an quickly retrievable format
--help
Display this output
-i Display only the message IDs (exiqgrep)
-l Same as -bp (exiqgrep)
--not
Negate all tests.
-o <seconds>
Same as '$message_age > <seconds>' (exiqgrep)
--or
Display messages matching any criteria
-R Same as --reverse (exiqgrep)
-r <regexp>
Same as '$recipients = <regexp>' (exiqgrep)
--random
Display messages in random order
--reverse
Display messages in reverse order
-s <string>
Same as '$shown_message_size eq <string>' (exiqgrep)
--spool <path>
Set the path to the exim spool to use
--show-rules
Show the internal representation of each criterion specified
--thaw <cache file>
Read queue information cached from a previous --freeze run
--sort <variable>[,<variable>...]
Display matching messages sorted according to <variable>
--unsorted
Do not apply any sorting to output
--version
Display the version of this command
-x Same as '!$deliver_freeze' (exiqgrep)
-y Same as '$message_age < |