Manual page for IXSEARCH(1)
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 .Hr -url ../html1/ixbuild.1.html 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.
Created by unroff & hp-tools.
© somebody (See intro for details). All Rights Reserved.
Last modified 11/5/97
