1niscat(1)                        User Commands                       niscat(1)
2
3
4

NAME

6       niscat - display NIS+ tables and objects
7

SYNOPSIS

9       niscat [-AhLMv] [-s sep] tablename...
10
11
12       niscat [-ALMP] -o name...
13
14

DESCRIPTION

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

OPTIONS

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

EXAMPLES

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

ENVIRONMENT VARIABLES

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

EXIT STATUS

162       niscat returns the following values:
163
164       0    Successful completion
165
166
167       1    An error occurred.
168
169

ATTRIBUTES

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

SEE ALSO

183       NIS+(1),  nisdefaults(1), nismatch(1), nistbladm(1), nis_objects(3NSL),
184       nis_tables(3NSL), attributes(5)
185

NOTES

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)
Impressum