NAME

       imgrep - search for mail/news messages

SYNOPSIS

       imgrep [OPTIONS] [FOLDER] [RANGE]

DESCRIPTION

       The imgrep command enumerates mail/news messages matched given patterns.

       This command is provided by IM (Internet Message).

OPTIONS

       -s, --src=FOLDER,FOLDER...
            message source: "+folder:[range[,range..]]".

            "--src=+xxx" is equivalent to "+xxx".

       -f, --format=STRING
            Output format: "number", "folder", or "path".

            (default: "number" for single target folder, "path" for multiple target folders)

       -c, --casefold={on,off}
            Case sensitivity.  (This option affects both fieldname and pattern.)

            Default value is "on".

       -e, --expression=STRING
            Search expression:

            Usable keyword

                    & &&    logical AND

                    | ||    logical OR

                    !       logical NOT

                    ( )     parens

                    fieldname=pattern       search pattern for the field

            Special fieldname:

                    head    Entire header

                    body    Entire body

                    all     Entire message

       -d, --delimiter=STRING
            Mail header delimiter.

            Default value is "\n\n|\n----\n".

       -D, --dupchecktarget=STRING
            Duplicate check target ('none', 'message-id', or 'message-id+subject').  Default
            value is 'none'.

       -q, --quiet={on,off}
            Do not show any messages.

       -v, --verbose={on,off}
            Print verbose messages when running.

       --debug=DEBUG_OPTION
            Print debug messages when running.

       -h, --help
            Display help message and exit.

       --version
            Output version information and exit.

COPYRIGHT

       IM (Internet Message) is copyrighted by IM developing team.  You can redistribute it
       and/or modify it under the modified BSD license.  See the copyright file for more details.