exipick

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 < EXIPICK(8)