IXSEARCH

Section: User Commands (1)
Updated: July 14, 1992
Index Return to Main Contents

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 -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)

BUGS

Not all features of the Indexing Kit query language are implemented in NEXTSTEP Release 3.

This document was created by man2html, using the manual pages.
Time: 13:53:58 GMT, September 25, 2024