OS Manuals

/usr/bin/exipick

EXIM scripts

From exim-scripts 4.100.1-r2 (os), captured 2026-11-05 by running exipick --help (exit 0). permalink

Usage:
      exipick [<options>] [<criterion> [<criterion> ...]]
      exipick --help|--man

Options:
    --and
        Display messages matching all criteria (default)

    -b  Display messages in brief format (exiqgrep)

    -bp | -l
        Display messages in standard mailq format (default). (exiqgrep:
        "-l")

    -bpa
        Same as "-bp", show generated addresses also (exim)

    -bpc
        Show a count of matching messages (exim)

    -bpr
        Same as "-bp --unsorted" (exim)

    -bpra
        Same as "-bpa --unsorted" (exim)

    -bpru
        Same as "-bpu --unsorted" (exim)

    -bpu
        Same as "-bp", but only show undelivered messages (exim)

    -C | --config config
        Use config to determine the proper spool directory. (See "--spool"
        or "--input" for alternative ways to specify the directories to
        operate on.)

    -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). Note that this
        preserves the default case sensitivity of exiqgrep's interface.

    --finput
        Same as "--input-dir Finput". Finput is where exim copies frozen
        messages when compiled with SUPPORT_MOVE_FROZEN_MESSAGES.

    --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)

    --input-dir inputname
        Set the name of the directory under the spool directory. By default
        this is input. If this starts with /, the value of "--spool" is
        ignored. See also "--finput".

    --not
        Negate all tests.

    -o seconds
        Same as "$message_age > <seconds>" (exiqgrep)

    --or
        Display messages matching any criteria

    --queue name
        Name of the queue (default: ''). See "named queues" in the spec.

    -r regexp
        Same as "$recipients =~ /<regexp>/" (exiqgrep). Note that this
        preserves the default case sensitivity of exiqgrep's interface.

    --random
        Display messages in random order

    --reverse | -R
        Display messages in reverse order (exiqgrep: "-R")

    -s string
        Same as "$shown_message_size eq <string>" (exiqgrep)

    --spool path
        Set the path to the exim spool to use. This value will have the
        arguments to "--queue", and "--input" or input appended, or be
        ignored if "--input" is a full path. If not specified, exipick uses
        the value from "exim [-C config] -n -bP spool_directory", and if
        this call fails, the /opt/exim/spool from build time
        (Local/Makefile) is used. See also "--config".

    --show-rules
        Show the internal representation of each criterion specified

    --show-tests
        Show the result of each criterion on each message

    --show-vars variable[,variable...]
        Show the value for variable for each displayed message. variable
        will be a regular expression if it begins with a circumflex.

    --size
        Show the total bytes used by each displayed message

    --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 < <seconds>" (exiqgrep)

    -z  Same as $deliver_freeze (exiqgrep)
Options (35)
OptionDescriptionSource
--andDisplay messages matching all criteria (default)help
-bDisplay messages in brief format (exiqgrep)help
-bpaSame as "-bp", show generated addresses also (exim)help
-bpcShow a count of matching messages (exim)help
-bprSame as "-bp --unsorted" (exim)help
-bpraSame as "-bpa --unsorted" (exim)help
-bpruSame as "-bpu --unsorted" (exim)help
-bpuSame as "-bp", but only show undelivered messages (exim)help
-cShow a count of matching messages (exiqgrep)help
--casefulMake operators involving "=" honor casehelp
--charsetOverride the default local character set for $header_ decodinghelp
-f regexpSame as "$sender_address =~ /<regexp>/" (exiqgrep).help
--finputSame as "--input-dir Finput".help
--flatqUse a single-line output formathelp
--helpDisplay this outputhelp
-iDisplay only the message IDs (exiqgrep)help
--input-dir inputnameSet the name of the directory under the spool directory.help
--notNegate all tests.help
-o secondsSame as "$message_age > <seconds>" (exiqgrep)help
--orDisplay messages matching any criteriahelp
--queue nameName of the queue (default: '').help
-r regexpSame as "$recipients =~ /<regexp>/" (exiqgrep).help
--randomDisplay messages in random orderhelp
-s stringSame as "$shown_message_size eq <string>" (exiqgrep)help
--spool pathSet the path to the exim spool to use.help
--show-rulesShow the internal representation of each criterion specifiedhelp
--show-testsShow the result of each criterion on each messagehelp
--show-vars variableShow the value for variable for each displayed message.help
--sizeShow the total bytes used by each displayed messagehelp
--sort variableDisplay matching messages sorted according to variablehelp
--unsortedDo not apply any sorting to outputhelp
--versionDisplay the version of this commandhelp
-xSame as "!$deliver_freeze" (exiqgrep)help
-ySame as "$message_age < <seconds>" (exiqgrep)help
-zSame as $deliver_freeze (exiqgrep)help

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.