IXSEARCH(1)IXSEARCH(1)NAMEixsearch - evaluate a query against an indexed subtree of a filesystem
and print names of files matching the query
SYNOPSIS
/usr/bin/ixsearch [ -abcdfglopqrw ] [ -Llanguage ] [ -yattribute ]
query [ path ... ]
DESCRIPTIONixsearch performs a query against the named files or directories,
looking for files whose contents (or names) match query and printing
their names to standard output. By default, query is parsed as though
it were the contents of a file, and a whole word search is performed;
all words in query must exist in a file for it to match.
ixsearch expects to find an index named .index.store, as created by the
ixbuild(1) command or by the Digital Librarian application. If the
current directory for a file has no index, ixsearch proceeds up through
the filesystem, using the first index it finds in a subtree containing
path. ixsearch does not look for indexes in subdirectories. If no
index is found, the files are opened and read as needed, unless the -b
option is specified. The -o option prevents ixsearch from using
indexes altogether.
If the -a option is used, query will be matched as a literal string
against the contents of files; indexes are not used in this case (that
is, this option implies the -o option). If the -q option is used,
query must be an expression in the Indexing Kit query language. In
this case, it is evaluated and used for the search.
If an index exists for a specified path, ixsearch updates it if
necessary. Use the -p option to suppress automatic updating of
indexes.
The pairs of options listed below are mutually exclusive. Using
mutually exclusive options will result in the last one listed being
used. See the Indexing Kit documentation in Digital Librarian for more
information.
-a and -q Literal search vs query expression.
-c and -f File contents vs names.
-f and -q You can't use a query expression against filenames.
OPTIONS-- Lists these options.
-a query is literal substring search (implies -o).
-b Don't look for out-of-date files.
-c Search against file contents only (default, excludes -f).
-d Cross device boundaries (mounted disks, for example).
-f Search against file names only (excludes -c and -q).
-g Sort ascending, not descending.
-l Traverse symbolic links.
-Llanguage Set target language for query parsing to language.
-o Search without index, even if index present.
-p Don't update index for out of date files.
-q query is query language expression (excludes -a and -f).
-r Print query relative file names.
-w Resolve wildcards in file names.
-x Verify read access before printing file name.
-yattribute
Sort by weight for the supplied attribute (for example,
“FileSize” or “Author”).
FILES
.index.store an index file created by ixbuild(1)SEE ALSOixbuild(1), parse(1), Indexing Kit Documentation in NEXTSTEP General
Reference
BUGS
Not all features of the Indexing Kit query language are implemented in
NEXTSTEP Release 3.
NeXT Computer, Inc. July 14, 1992 IXSEARCH(1)
