*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->HP-UX 11i man pages -> nistest (1)              


 nistest(1)                                                       nistest(1)

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

 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

           -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

 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

 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'

    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

      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
[ Back ]
 Similar pages
Name OS Title
info IRIX Return information about the state of the Tcl interpreter
sigprocmask IRIX alter and return previous state of the set of blocked signals (POSIX)
[ Tru64 Evaluates conditional expressions
dhcp-eval FreeBSD ISC DHCP conditional evaluation
test Tru64 Evaluates conditional expressions
csmg IRIX Performs a conditional scalar merge
cvmg IRIX Conditional vector merge functions
nisrm HP-UX remove NIS+ objects from the namespace
delete_child HP-UX Deletes a child pointer from the namespace
extattr_string_to_namespace OpenBSD convert an extended attribute namespace identifier to a string and vice versa
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service