---
name: "imgrep"
section: "1p"
platform: "linux"
package: "im"
version: "1:153-4"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/imgrep/1p"
---

# imgrep(1p)

search for mail/news messages

## 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.