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) 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
option.
- -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.
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:
Display the contents of table
frodo
and the contents of all tables in its concatenation path:
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:
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:
EXTERNAL INFLUENCES
Environment Variables
- 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
niscat
returns
0
on success and
1
on failure.
AUTHOR
niscat
was developed by Sun Microsystems, Inc.
NOTES
Columns without values in the table are displayed by two adjacent
separator characters.
