cindex - prepares the trigram index for csearch(1)
[-list] [-reset] [ path...
Cindex prepares the trigram index for use by csearch. The index is the file
named by $CSEARCHINDEX, or else $HOME/.csearchindex.
The simplest invocation is
which adds the file or directory tree named by each path to the index. For
cindex $HOME/src /usr/include
If cindex is invoked with no paths, it reindexes the paths that have already
been added, in case the files have changed. Thus, 'cindex' by itself is a
useful command to run in a nightly cron job.
The -list flag causes cindex to list the paths it has indexed and exit.
By default cindex adds the named paths to the index but preserves information
about other paths that might already be indexed (the ones printed by cindex
-list). The -reset flag causes cindex to delete the existing index before
indexing the new paths. With no path arguments, cindex -reset removes the
- List the indexed paths and exit.
- Delete the existing index before indexing the new paths.
With no path arguments, -reset removes the index.
Cindex uses the index stored in $CSEARCHINDEX or, if that variable is unset or
Furthermore, cindex honors the standard TMPDIR environment variable when
creating its temporary files. In case the temporary files exceed the space you
have in /tmp, possibly because /tmp is a tmpfs and thus using your RAM, feel
free to set TMPDIR to a different path than /tmp.
This manual page was written by Michael Stapelberg
<firstname.lastname@example.org>, for the Debian project (and may be used by