👤
Home Man
Search
Today's Posts
Register

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:
Select Section of Man Page:
Select Man Page Repository:

OpenSolaris 2009.06 - man page for nismatch (opensolaris section 1)

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 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  col-
       name=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 concatena-
		 tion 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 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 qualified, each
		   directory specified will be searched until the  table  is  found  (see  nisde-
		   faults(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:

       +-----------------------------+-----------------------------+
       |      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 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  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.11				    2 Dec 2005				      nismatch(1)


All times are GMT -4. The time now is 09:38 AM.

Unix & Linux Forums Content Copyrightę1993-2018. All Rights Reserved.
×
UNIX.COM Login
Username:
Password:  
Show Password