unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-5.10)
Page:
Section:
Apropos / Subsearch:
optional field

nismatch(1)                      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  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 nismatch.

       In  nismatch,  the  server  does  the searching, whereas in nisgrep 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 ta-
       ble to be searched. If only one key or key pattern is specified without
       the  column  name,  then it is applied searching the first column. Spe-
       cific named columns can be searched by using  the  colname=key  syntax.
       When multiple columns are searched, only entries that match in all col-
       umns 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.



       -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 information 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 unsuccessful.



       -s sep          This  option specifies the character to use to separate
                       the table columns. If no character  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
       Example 1: Searching a table for a username

       This  example  searches a table named  passwd in the  org_dir subdirec-
       tory of the  zotz.com. domain. It returns the entry that has the  user-
       name 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  qualified,  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 attributes:


       tab()    allbox;    cw(2.750000i)|     cw(2.750000i)     lw(2.750000i)|
       lw(2.750000i).  ATTRIBUTE TYPEATTRIBUTE VALUE AvailabilitySUNWnisu


SEE ALSO
       niscat(1),  nisdefaults(1),  nisls(1), nistbladm(1), nis_objects(3NSL),
       attributes(5)

DIAGNOSTICS
       No memory                               An  attempt  to  allocate  some
                                               memory for the search failed.



       tablename is not a table                The object with the name table-
                                               name was not a table object.



       Can't compile regular expression        The regular expression in  key-
                                               pat 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 SolarisTM Operat-
       ing Environment. Tools to aid the  migration  from  NIS+  to  LDAP  are
       available in the Solaris 9 operating environment. For more information,
       visit http://www.sun.com/directory/nisplus/transition.html.




SunOS 5.10                        10 Dec 2001                      nismatch(1)