👤
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 nistest (opensolaris section 1)

nistest(1)				  User Commands 			       nistest(1)

NAME
       nistest - return the state of the NIS+ namespace using a conditional expression

SYNOPSIS
       nistest [-ALMP] [-a rights | -t type] object

       nistest [-ALMP] [-a rights] indexedname

       nistest -c dir1 op dir2

DESCRIPTION
       nistest	provides  a  way  for shell scripts and other programs to test for the existence,
       type, and access rights of objects and entries.	Entries are named  using  indexed  names.
       See  nismatch(1).  With	the -c option, directory names can be compared to test where they
       lie in relation to each other in the namespace.

OPTIONS
       The following options are supported:

       -a rights    This option is used to verify that the current process has	the   desired  or
		    required  access rights on the named object or entries. The access rights are
		    specified in the same way as the nischmod(1) command.

       -A	    All data. This option specifies that the data within the  table  and  all  of
		    the  data  in  tables  in the initial table's concatenation path be returned.
		    This option is only valid when using indexed names or following links.

       -L	    Follow links.  If the object named by object or the  tablename  component  of
		    indexedname names a  LINK type object,  the link is followed when this switch
		    is present.

       -M	    Master server only. This option specifies that the lookup should be  sent  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.

       -P	    Follow concatenation path. This option specifies that the lookup should  fol-
		    low the concatenation path of a table if the initial search is  unsuccessful.
		    This option is only valid when using indexed names or following links.

       -t type	    This  option  tests  the  type of object. The value of type can be one of the
		    following:

		    D	 Return true if the object is a directory object.

		    G	 Return true if the object is a group object.

		    L	 Return true if the object is a link object.

		    P	 Return true if the object is a private object.

		    T	 Return true if the object is a table object.

       -c	    Test whether or not two directory names have a certain relationship  to  each
		    other,  for  example, higher than (ht) or lower than (lt).	The complete list
		    of values for op can be displayed by using the -c option with no arguments.

EXAMPLES
       Example 1 Using the nistest Command

       When testing for access rights,	nistest returns success (0) if the specified  rights  are
       granted to the current user. Thus, testing for access rights:

	 example% nistest -a w=mr skippy.domain

       Tests  that all authenticated NIS+ clients have read and modify access to the object named
       skippy.domain.

       Testing for access on a particular entry in a table can be accomplished using the  indexed
       name  syntax.  The following example tests to see if an entry in the password table can be
       modified:

	 example% nistest -a o=m '[uid=99],passwd.org_dir'

       To test if a directory lies higher in the namespace than another  directory,  use  the  -c
       option  with  an  op  of  ht (higher than) as in the following example (which would return
       true):

	 example% nistest -c dom.com. ht lower.dom.com.

ENVIRONMENT VARIABLES
       NIS_PATH     If this variable is set, and the NIS+  name  is  not  fully  qualified,  each
		    directory  specified  will	be searched until the object is found. See nisde-
		    faults(1).

EXIT STATUS
       The following exit values are returned:

       0    Successful operation.

       1    Failure due to object not present, not of specified type, and/or no such access.

       2    Failure due to illegal usage.

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWnisu			   |
       +-----------------------------+-----------------------------+

SEE ALSO
       NIS+(1), nischmod(1), nisdefaults(1), nismatch(1), attributes(5)

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				       nistest(1)


All times are GMT -4. The time now is 12:50 AM.



All times are GMT -4. The time now is 12:50 AM.

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