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
-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
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]
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
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]
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 ]