1niscat(1) User Commands niscat(1)
2
3
4
6 niscat - display NIS+ tables and objects
7
9 niscat [-AhLMv] [-s sep] tablename...
10
11
12 niscat [-ALMP] -o name...
13
14
16 In the first synopsis, niscat displays the contents of the NIS+ tables
17 named by tablename. In the second synopsis, it displays the internal
18 representation of the NIS+ objects named by name.
19
20
21 Columns without values in the table are displayed by two adjacent sepa‐
22 rator characters.
23
25 The following options are supported:
26
27 -A Displays the data within the table and all of the data in
28 tables in the initial table's concatenation path.
29
30
31 -h Displays the header line prior to displaying the table. The
32 header consists of the `#' (hash) character followed by the
33 name of each column. The column names are separated by the
34 table separator character.
35
36
37 -L Follows links. When this option is specified, if tablename
38 or name names a LINK type object, the link is followed and
39 the object or table named by the link is displayed.
40
41
42 -M Master server only. This option specifies that the request
43 should be sent to the master server of the named data. This
44 guarantees that the most up-to-date information is seen at
45 the possible expense of increasing the load on the master
46 server and increasing the possibility of the NIS+ server
47 being unavailable or busy for updates.
48
49
50 -o name Displays the internal representation of the named NIS+
51 object(s). If name is an indexed name (see nismatch(1)),
52 then each of the matching entry objects is displayed. This
53 option is used to display access rights and other attributes
54 of individual columns.
55
56
57 -P Follows concatenation path. This option specifies that the
58 request should follow the concatenation path of a table if
59 the initial search is unsuccessful. This option is only use‐
60 ful when using an indexed name for name and the -o option.
61
62
63 -s sep This option specifies the character to use to separate the
64 table columns. If no character is specified, the default
65 separator for the table is used.
66
67
68 -v Displays binary data directly. This option displays columns
69 containing binary data on the standard output. Without this
70 option binary data is displayed as the string *BINARY*.
71
72
74 Example 1 Displaying the Contents of the Hosts Table
75
76
77 The following example displays the contents of the hosts table:
78
79
80 example% niscat -h hosts.org_dir
81 # cname name addr comment
82 client1 client1 192.168.201.100 Joe Smith
83 crunchy crunchy 192.168.201.44 Jane Smith
84 crunchy softy 192.168.201.44
85
86
87
88
89 The string *NP* is returned in those fields where the user has insuffi‐
90 cient access rights.
91
92
93 Example 2 Displaying on the Standard Output
94
95
96 The following displays the passwd.org_dir on the standard output.
97
98
99 example% niscat passwd.org_dir
100
101
102
103 Example 3 Displaying Table Contents
104
105
106 Display the contents of table frodo and the contents of all tables in
107 its concatenation path.
108
109
110 example% niscat -A frodo
111
112
113
114 Example 4 Displaying Table Entries
115
116
117 The following example diisplays the entries in the table groups.org_dir
118 as NIS+ objects. Notice that the brackets are protected from the shell
119 by single quotes.
120
121
122 example% niscat -o '[ ]groups.org_dir'
123
124
125
126 Example 5 Displaying the Table Object
127
128
129 The following example displays the table object of the passwd.org_dir
130 table.
131
132
133 example% niscat -o passwd.org_dir
134
135
136
137
138 The previous example displays the passwd table object and not the
139 passwd table. The table object includes information such as the number
140 of columns, column type, searchable or not searchable separator, access
141 rights, and other defaults.
142
143
144 Example 6 Displaying the Directory Object
145
146
147 The following example displays the directory object for org_dir, which
148 includes information such as the access rights and replica information.
149
150
151 example% niscat -o org_dir
152
153
154
156 NIS_PATH If this variable is set, and the NIS+ table name is not
157 fully qualified, each directory specified will be searched
158 until the table is found (see nisdefaults(1)).
159
160
162 niscat returns the following values:
163
164 0 Successful completion
165
166
167 1 An error occurred.
168
169
171 See attributes(5) for descriptions of the following attributes:
172
173
174
175
176 ┌─────────────────────────────┬─────────────────────────────┐
177 │ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
178 ├─────────────────────────────┼─────────────────────────────┤
179 │Availability │SUNWnisu │
180 └─────────────────────────────┴─────────────────────────────┘
181
183 NIS+[22m(1), nisdefaults(1), nismatch(1), nistbladm(1), nis_objects(3NSL),
184 nis_tables(3NSL), attributes(5)
185
187 NIS+ might not be supported in future releases of the Solaris operating
188 system. Tools to aid the migration from NIS+ to LDAP are available in
189 the current Solaris release. For more information, visit
190 http://www.sun.com/directory/nisplus/transition.html.
191
192
193
194SunOS 5.11 2 Dec 2005 niscat(1)