NAME

ixsearch − 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 ... ]
 

DESCRIPTION

ixsearch 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 −qLiteral search vs query expression. 

−c and −fFile contents vs names. 

−f and −qYou can’t use a query expression against filenames. 

OPTIONS

−−Lists these options. 

−aquery is literal substring search (implies −o). 

−bDon’t look for out-of-date files. 

−cSearch against file contents only (default, excludes −f). 

−dCross device boundaries (mounted disks, for example). 

−fSearch against file names only (excludes −c and −q). 

−gSort ascending, not descending. 

−lTraverse symbolic links. 

−LlanguageSet target language for query parsing to language. 

−oSearch without index, even if index present. 

−pDon’t update index for out of date files. 

−qquery is query language expression (excludes −a and −f). 

−rPrint query relative file names. 

−wResolve wildcards in file names. 

−xVerify read access before printing file name. 

−yattributeSort by weight for the supplied attribute (for example, “FileSize” or “Author”). 
 

FILES

.index.storean index file created by ixbuild(1)

SEE ALSO

ixbuild(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