HP-UX Reference (11i v1 05/09) - 1 User Commands N-Z (vol 2)

n
niscat(1) niscat(1)
NAME
niscat - display NIS+ tables and objects
SYNOPSIS
niscat [ -AhLMv ] tablename ...
niscat [ -ALMP ] -o
name ...
DESCRIPTION
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
-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) charac-
ter followed by the name of each column. The column names are separated by the table separa-
tor 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 option.
-v Display binary data directly. This option displays columns containing binary data on the stan-
dard 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.
EXAMPLES
Display the contents of the hosts table:
niscat -h host.org_dir
# cname name addr comment
client1 client1 129.144.201.100 Joe Smith
crunchy crunchy 129.144.201.44 Jane Smith
crunchy softy 129.144.201.44
The string *NP* is returned in those fields where the user has insufficient access rights.
Display the passwd.org_dir on the standard output:
niscat passwd.org_dir
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.
HP-UX 11i Version 1: September 2005 − 1 − Hewlett-Packard Company Section 1−−615