nistest(1)                                                       nistest(1)




 NAME    [Toc]    [Back]
      nistest - return the state of the NIS+ namespace using a conditional
      expression

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

      nistest [ -ALMP ] [ -a rights ] indexedname

 DESCRIPTION    [Toc]    [Back]
      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    [Toc]    [Back]
           -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 11i Version 2: August 2003






 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    [Toc]    [Back]
           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    [Toc]    [Back]
      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    [Toc]    [Back]
    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)).

 WARNINGS    [Toc]    [Back]
      HP-UX 11i Version 2 is the last HP-UX release on which NIS+ is
      supported.

      LDAP is the recommended replacement for NIS+.  HP fully supports the
      industry standard naming services based on LDAP.

 AUTHOR    [Toc]    [Back]
      nistest was developed by Sun Microsystems, Inc.

 SEE ALSO    [Toc]    [Back]
      nis+(1), nischmod(1), nisdefaults(1).


 Hewlett-Packard Company            - 2 -   HP-UX 11i Version 2: August 2003