NAME

       csearch - like grep(1) over all indexed files

SYNOPSIS

       csearch [-c] [-f fileregexp] [-h] [-i] [-l] [-n] regexp

DESCRIPTION

       Csearch  behaves  like  grep  over all indexed files, searching for regexp, an RE2 (nearly
       PCRE) regular expression.

       The -c, -h, -i, -l, and -n flags are as in grep, although  note  that  as  per  Go's  flag
       parsing  convention,  they cannot be combined: the option pair -i -n cannot be abbreviated
       to -in.

       The -f flag restricts the search to files whose names match  the  RE2  regular  expression
       fileregexp.

       Csearch relies on the existence of an up-to-date index created ahead of time.  To build or
       rebuild the index that csearch uses, run:

            cindex path...

       where path... is a list of directories or individual files to be included in the index. If
       no  index  exists, this command creates one. If an index already exists, cindex overwrites
       it. See cindex(1) for more details.

OPTIONS

       -c     Suppress normal output; instead print a count of  matching  lines  for  each  input
              file.

       -f fileregexp
              Restricts  the  search  to  files  whose  names  match  the  RE2 regular expression
              fileregexp.

       -h     Suppress the prefixing of file names on output.

       -i     Ignore case distinctions in both the regexp and the input files.

       -l     Suppress normal output; instead print the name of each input file from which output
              would normally have been printed.

       -n     Prefix each line of output with the 1-based line number within its input file.

ENVIRONMENT

       Csearch  uses  the  index  stored in $CSEARCHINDEX or, if that variable is unset or empty,
       $HOME/.csearchindex.

SEE ALSO

       cindex(1), cgrep(1), grep(1).

AUTHOR

       This manual page was written by Michael Stapelberg <stapelberg@debian.org>, for the Debian
       project (and may be used by others).

                                            2013-06-23                                 CSEARCH(1)