|
Hopefully, this page is exactly what you are looking for, but if not, you can always find further assistance on Unix/Linux Forum!
User Commands nismatch(1)
NAME
nismatch, nisgrep - utilities for searching NIS+ tables
SYNOPSIS
nismatch [-AchMoPv] [-s sep] key tablename
nismatch [-AchMoPv] [-s sep] colname = key... tablename
nismatch [-AchMoPv] [-s sep] indexedname
nisgrep [-AchiMov] [-s sep] keypat tablename
nisgrep [-AchiMov] [-s sep] colname = keypat... tablename
DESCRIPTION
The utilities nismatch and nisgrep can be used to search
NIS+ tables. The command nisgrep differs from the nismatch
command in its ability to accept regular expressions keypat
for the search criteria rather than simple text matches.
Because nisgrep uses a callback function, it is not con-
strained to searching only those columns that are specifi-
cally made searchable at the time of table creation. This
makes it more flexible, but slower, than nismatch.
In nismatch, the server does the searching, whereas in nis-
grep the server returns all the readable entries and then
the client does the pattern-matching.
In both commands, the parameter tablename is the NIS+ 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 colname=key syntax. When multiple
columns are searched, only entries that match in all columns
are returned. This is the equivalent of a logical join
operation.
nismatch accepts an additional form of search criteria,
indexedname, which is a NIS+ indexed name of the form:
[ colname=value, ... ],tablename
OPTIONS
The following options are supported:
-A All data. Return the data within the table
and all of the data in tables in the initial
table's concatenation path.
SunOS 5.10 Last change: 2 Dec 2005 1
User Commands nismatch(1)
-c Print only a count of the number of entries
that matched the search criteria.
-h Display a header line before the matching
entries that contains the names of the
table's columns
-i Ignore upper/lower case distinction during
comparisons.
-M Master server only. Send the lookup to the
master server of the named data. This
guarantees that the most up to date informa-
tion is seen at the possible expense that
the master server may be busy.
-o Display the internal representation of the
matching NIS+ object(s).
-P Follow concatenation path. Specify that the
lookup should follow the concatenation path
of a table if the initial search is unsuc-
cessful.
-s sep This option specifies the character to use
to separate the table columns. If no charac-
ter is specified, the default separator for
the table is used.
-v Verbose. Do not suppress the output of
binary data when displaying matching
entries. Without this option binary data is
displayed as the string *BINARY*.
EXAMPLES
SunOS 5.10 Last change: 2 Dec 2005 2
User Commands nismatch(1)
Example 1: Searching a table for a username
This example searches a table named passwd in the org_dir
subdirectory of the zotz.com. domain. It returns the entry
that has the username of skippy. In this example, all the
work is done on the server:
example% nismatch name=skippy passwd.org_dir.zotz.com.
Example 2: Finding users using specific shells
This example is similar to the one above, except that it
uses nisgrep to find all users in the table named passwd
that are using either ksh(1) or csh(1):
example% nisgrep 'shell=[ck]sh' passwd.org_dir.zotz.com.
ENVIRONMENT VARIABLES
NIS_PATH If this variable is set, and the
NIS+ table name is not fully quali-
fied, each directory specified will
be searched until the table is found
(see nisdefaults(1)).
EXIT STATUS
The following exit values are returned:
0 Successfully matches some entries.
1 Successfully searches the table and no matches are
found.
2 An error condition occurs. An error message is also
printed.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
SunOS 5.10 Last change: 2 Dec 2005 3
User Commands nismatch(1)
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | SUNWnisu |
|_____________________________|_____________________________|
SEE ALSO
niscat(1), nisdefaults(1), nisls(1), nistbladm(1),
nis_objects(3NSL), attributes(5)
DIAGNOSTICS
No memory An attempt to allo-
cate 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 expres-
sion in keypat was
malformed.
column not found: colname The column named
colname does not
exist in the table
named tablename.
NOTES
NIS+ might not be supported in future releases of the
Solaris operating system. Tools to aid the migration from
NIS+ to LDAP are available in the current Solaris release.
For more information, visit
http://www.sun.com/directory/nisplus/transition.html.
SunOS 5.10 Last change: 2 Dec 2005 4
Man(1) output converted with
man2html and wrapped by fishsponge
This page was generated on Wed Sep 12 11:25:09 GMT 2007
|
Your favourite pages:
No pages logged yet.
Trying to save cookie... Top 10 most popular pages:
sqlite3 man page (5333 hits)
(openSUSE 10.2)
svn man page (5208 hits)
(FreeBSD 6.2)
adv_cap_autoneg man page (4870 hits)
(Solaris 10 11_06)
CPAN man page (4607 hits)
(Suse Linux 10.1)
ssh man page (4342 hits)
(Suse Linux 10.1)
ssh-socks5-proxy-connect man page (2874 hits)
(Solaris 10 11_06)
netcat man page (2717 hits)
(Suse Linux 10.1)
pprosetup man page (2487 hits)
(Solaris 10 11_06)
startproc man page (2471 hits)
(Suse Linux 10.1)
signal man page (2406 hits)
(Suse Linux 10.1)
|
Man Pages 
