nistest(1) manual page
Table of Contents
nistest - return the state of the NIS+ namespace using a conditional
expression
nistest [ -ALMP ] [ -a rights | -t type ] object
nistest
[ -ALMP ] [ -a rights ] indexedname
SUNWnisu
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)
).
- -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(1)
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.
- 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.
- Success.
- Failure due to object not
present, not of specified type and/or no such access.
- Failure due to illegal
usage.
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
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.org_dir’
- 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)
).
nis+(1)
, nischmod(1)
, nisdefaults(1)
Table of Contents
![[Go to CFHT Home Page]](/images/cfht-icon.gif){kind=icon}
Man Pages 
Back to Software Index 
Manpage Top Level