unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Page:
Section:
Apropos / Subsearch:
optional field



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

 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)).

    Options
	   -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 follow the concatenation path of a
		     table if the initial search is unsuccessful.  This
		     option is only valid when using indexed names or
		     following links.

	   -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 command.

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

			  G    Return true if the object is a group object.

			  D    Return true if the object is a directory
			       object.





 Hewlett-Packard Company	    - 1 -   HP-UX Release 11i: November 2000






 nistest(1)							  nistest(1)




			  T    Return true if the object is a table object.

			  L    Return true if the object is a link object.

			  P    Return true if the object is a private
			       object.

 RETURN VALUE
	   0	Success.

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

	   2	Failure due to illegal usage.

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

	   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.

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

 EXTERNAL INFLUENCES
    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 nisdefaults(1)).

 AUTHOR
      nistest was developed by Sun Microsystems, Inc.

 SEE ALSO
      nis+(1), nischmod(1), nisdefaults(1).












 Hewlett-Packard Company	    - 2 -   HP-UX Release 11i: November 2000