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 pos-
sible expense that the master server may be
busy.
SunOS 5.11 Last change: 2 Dec 2005 1
User Commands nistest(1)
-P Follow concatenation path. This option speci-
fies that the lookup should follow the con-
catenation 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 exam-
ple, 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
SunOS 5.11 Last change: 2 Dec 2005 2
User Commands nistest(1)
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.orgdir'
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
NISPATH 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).
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.
ATRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
SunOS 5.11 Last change: 2 Dec 2005 3
User Commands nistest(1)
ATRIBUTE TYPE ATRIBUTE VALUE
Availability SUNWnisu
SEE ALSO
NIS](1), nischmod(1), nisdefaults(1), nismatch(1), attri-
butes(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 Last change: 2 Dec 2005 4
|
