RCLGREP(1)

NAME
rclgrep - Print lines that match of patterns

SYNOPSIS
rclgrep -h
rclgrep [OPTION ...] PATTERNS [FILE ...]
rclgrep [OPTION ...] -e PATTERNS ... [FILE ...]
rclgrep [OPTION ...] -f PATTERNS_FILE ... [FILE ...]

DESCRIPTION
rclgrep mimicks the interface and output of the grep(1) command while using the recoll data extraction subsystem, which enables it to look for matches not only in text files, but in mostly any type of document, including nested ones (email attachments, archives, etc.).

The program is mostly an experiment in checking how an index-less pattern search program could be useful. In practise it is slow, and maybe not quite finished.

Some of the options which are shared with grep(1) will not be documented here.

OPTIONS

-h, --help
    Print usage string.

-e, --regexp=PATTERNS
    Patterns to search for. Can be given multiple times. if -e is used, all non-option arguments will be used as paths (no [pattern] argument).

-f, --file=FILE
    Get patterns from the file argument, one per line.

-r, --recurse
    Operate recursively on directories. This is the default except if no paths are given in which case rclgrep searches stdin. -r is needed to cause recursing on the current directory in the absence of a file argument.

--include=FN
    File name pattern for files to be searched. Can be given multiple times.

--exclude=FN
    File name pattern for files not to be searched. Can be given multiple times.

--exclude-from=FN
    Take file name exclusion patterns from FILE.

--config=CONFIGDIR
    Specify configuration directory (default ~/.config/rclgrep). This allows getting data extraction options from an existing recoll configuration directory or from the dedicated rclgrep one.

-v,-w,-x,-c,-L,-l,-H,-n,-A,-B,-C,-q,-s,-R
    See grep manual.

SEE ALSO
grep(1), recollindex(1),