imgrep(1p)

imgrep1p

Search for mail/news messages

Usage

imgrep [OPTIONS] [FOLDER] [RANGE]

Overview

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.

Releases

11 releases since Debian 3.1 (Sarge); the text changed 8 times.

  1. 3.1
  2. 4.0
  3. 5.0
  4. 6.0
  5. 7
  6. 8
  7. 9
  8. 10
  9. 11–13

From im 1:153-4 in Debian 13 (Trixie). Parsed by carta from the page's man source.