ess.exe is the Entrian Source Search command line tool. You can use it to:
Usage-wise, let's allow ess.exe to speak for itself:
> ess.exe
Usage:
Create a new index, for one or more root source directories:
ess create <switches>
where <switches> are:
-index=C:\path\to\new.index (or -i=...) [required]
-root=C:\path\to\my\code (or -r=...) [required] [can be repeated]
-watch (or -w)
-include=*.c,*.h (or -inc=...) [can be repeated]
-exclude=*.xml;*.yaml (or -exc=...) [can be repeated]
-ignoreglobalinclusions (or -igi)
-ignoreglobalexclusions (or -ige)
-log=log.txt (or -l=...)
Update an index: scan the code for changes; optionally wait for further changes:
ess update <switches>
where <switches> are:
-index=C:\path\to\the.index (or -i=...) [required]
-watch (or -w)
-log=log.txt (or -l=...)
Search an index:
ess search <switches>
where <switches> are:
-index=C:\path\to\the.index (or -i=...) [required] [can be repeated]
-verbosity=1-100 (or -v=...)
-fuzzy (or -f)
-case (or -c)
-log=log.txt (or -l=...)
-showcount (or -s)
Unlock an index that's been left locked after a crash:
ess unlock <switches>
where <switches> are:
-index=C:\path\to\the.index (or -i=...) [required]
-log=log.txt (or -l=...)
Check whether an index is corrupt, and optionally fix it (can be slow!):
ess check <switches>
where <switches> are:
-index=C:\path\to\the.index (or -i=...) [required]
-fix (or -f)
Commands can be abbreviated: (c)reate, (up)date, (s)earch, (un)lock, (ch)eck
>
When you search using ess.exe, the results are nicely highlighed:
> ess search -index=C:\src\ess.index search * query ext:cs C:\src\IM\EntrianSourceSearch\SearchForm.cs(765): name = "Search query"; C:\src\IM\IndexCore\Index.cs(1491): Hits hits = indexSearcher.Search(query); C:\src\IM\IndexCore\Index.cs(2304): indexSearcher.search(query, hits); C:\src\IM\IndexCore\Index.cs(2962): // Did they only enter filters and no search query? C:\src\IM\IndexCore\Index.cs(3059): int count = searcher.Search(query).Length(); C:\src\IM\IndexCore\Index.cs(3077): int count = searcher.Search(query).Length(); C:\src\IM\IndexCore\Index.cs(3120): searcher.Search(query, filter, hits); C:\src\IM\IndexCore\Index.cs(3124): searcher.Search(query, hits); C:\src\IM\IndexCore\QueryParser.cs(211): // an "Enter a search term as well as filter" error if the query has >
ess.exe sets the errorlevel like this:
Entrian Source Search makes Visual Studio faster and more
productive to use.
and try it for yourself.