Manual page for nismatch(1)
nismatch, nisgrep - utilities for searching NIS+ tables
can be used to search
differs from the
command in its ability to accept regular expressions
for the search criteria rather than simple text matches.
uses a callback function,
it is not constrained to searching only those columns that are specifically
made searchable at the time of table creation.
This makes it
more flexible, but slower, than
In nismatch, the server does the searching; wheareas in nisgrep,
the server returns all the readable entries and then the client
does the pattern-matching.
In both commands, the parameter
name of the table to be searched.
If only one key or key pattern is specified without the column name,
then it is applied searching the first column.
Specific named columns can be searched by using the
When multiple columns are searched, only entries that match
in all columns are returned.
This is the equivalent of a logical join operation.
accepts an additional form of search criteria,
which is a
indexed name of the form:
[ colname=value, ... ],tablename
Return the data within the table and all of
the data in tables in the initial table's concatenation path.
Print only a count of the number of entries that matched the search criteria.
Display a header line before the matching entries that contains the names
of the table's columns
Master server only.
Send the lookup to the master server of the named data.
This guarantees that the most up to date information is seen
at the possible expense that the master server may be busy.
Display the internal representation of the matching
Follow concatenation path.
Specify that the lookup should follow the concatenation
path of a table if the initial search is unsuccessful.
Do not suppress the output of binary data when displaying matching entries.
Without this option binary data is displayed as the string
Successfully matches some entries.
Successfully searches the table and no
matches are found.
An error condition occurs.
An error message is also printed.
This example searches a table named
subdirectory of the
It returns the entry that has the username of
In this example, all the work is done on the server.
example% nismatch name=skippy passwd.org_dir.zotz.com.
This example is similar to the one above except that it uses
to find all users in the table named
that are using either
example% nisgrep 'shell=[ck]sh' passwd.org_dir.zotz.com.
If this variable is set, and the
table name is not fully qualified, each directory specified will be searched
until the table is found (see
- No memory
An attempt to allocate some memory for the search failed.
- tablename is not a table
The object with the name tablename was not a table object.
- Can't compile regular expression
The regular expression in keypat was malformed.
- column not found: colname
The column named colname does not exist in the table named
Created by unroff & hp-tools.
© by Hans-Peter Bischof. All Rights Reserved (1997).
Last modified 21/April/97