NAME [Toc] [Back]
niscat - display NIS+ tables and objects
SYNOPSIS [Toc] [Back]
niscat [ -AhLMv ] tablename...
niscat [ -ALMP ] -o name...
DESCRIPTION [Toc] [Back]
In the first synopsis, niscat displays the contents of the NIS+ tables
named by tablename. In the second synopsis, it displays the internal
representation of the NIS+ objects named by name.
Options [Toc] [Back]
-A Display the data within the table and all of the data in
tables in the initial table's concatenation path.
-h Display the header line prior to displaying the table. The
header consists of the `#' (hash) character followed by the
name of each column. The column names are separated by the
table separator character.
-L Follow links. When this option is specified, if tablename or
name names a LINK type object, the link is followed and the
object or table named by the link is displayed.
-M Master server only. This option specifies that the request
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 of increasing the load on the master
server and increasing the possibility of the NIS+ server
being unavailable or busy for updates.
-P Follow concatenation path. This option specifies that the
request should follow the concatenation path of a table if
the initial search is unsuccessful. This option is only
useful when using an indexed name for name and the -o
-v Display binary data directly. This option displays columns
containing binary data on the standard output. Without this
option, binary data is displayed as the string *BINARY*.
-o name Display the internal representation of the named NIS+
object(s). If name is an indexed name (see nismatch(1)),
then each of the matching entry objects is displayed. This
option is used to display access rights and other attributes
of individual columns.
Notes [Toc] [Back]
Columns without values in the table are displayed by two adjacent
Hewlett-Packard Company - 1 - HP-UX 11i Version 2: August 2003
EXAMPLES [Toc] [Back]
Display the contents of the hosts table:
niscat -h host.org_dir
# cname name addr comment
client1 client1 188.8.131.52 Joe Smith
crunchy crunchy 184.108.40.206 Jane Smith
crunchy softy 220.127.116.11
The string *NP* is returned in those fields where the user has
insufficient access rights.
Display the passwd.org_dir on the standard output:
Display the contents of table frodo and the contents of all tables in
its concatenation path:
niscat -A frodo
Display the entries in the table group.org_dir as NIS+ objects (note
that the brackets are protected from the shell by single quotes):
niscat -o '[ ]group.org_dir'
Display the table object of the passwd.org_dir table:
niscat -o passwd.org_dir
The previous example displays the passwd table object and not the
passwd table. The table object includes information such as the
number of columns, column type, searchable or not searchable,
separator, access rights, and other defaults.
Display the directory object for org_dir, which includes information
such as the access rights and replica information:
niscat -o org_dir
EXTERNAL INFLUENCES [Toc] [Back]
NIS_PATH If this variable is set and the NIS+ table name is not
fully qualified, each directory specified will be
searched until the table is found (see nisdefaults(1)).
RETURN VALUE [Toc] [Back]
niscat returns 0 on success and 1 on failure.
Hewlett-Packard Company - 2 - HP-UX 11i Version 2: August 2003
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]
niscat was developed by Sun Microsystems, Inc.
SEE ALSO [Toc] [Back]
nis+(1), nismatch(1), nistbladm(1), nisdefaults(1), nis_objects(3N),
Hewlett-Packard Company - 3 - HP-UX 11i Version 2: August 2003 [ Back ]