~ubuntu-branches/ubuntu/vivid/rpcbind/vivid

« back to all changes in this revision

Viewing changes to man/rpcbindinfo.8

  • Committer: Steve Langasek
  • Date: 2012-01-03 07:35:59 UTC
  • mfrom: (5.1.3 wheezy)
  • Revision ID: steve.langasek@canonical.com-20120103073559-8x1ymw7442ljn7ps
Merge version 0.2.0-7 from Debian

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
.\" @(#)rpcbindinfo.1m 1.23 93/03/29 SMI; from SVr4
2
 
.\" Copyright 1989 AT&T
3
 
.\" Copyright 1991 Sun Microsystems, Inc.
4
 
.\" $NetBSD: rpcbindinfo.8,v 1.11 2001/12/08 19:12:46 wiz Exp $
5
 
.Dd August 18, 1992
6
 
.Dt RPCBINDINFO 8
7
 
.Sh NAME
8
 
.Nm rpcbindinfo
9
 
.Nd report RPC information
10
 
.Sh SYNOPSIS
11
 
.Nm "rpcbindinfo"
12
 
.Op Fl m Li \&| Fl s
13
 
.Op Ar host
14
 
.Nm "rpcbindinfo"
15
 
.Fl p Op Ar host
16
 
.Nm "rpcbindinfo"
17
 
.Fl T Ar transport
18
 
.Ar host Ar prognum
19
 
.Op Ar versnum
20
 
.Nm "rpcbindinfo"
21
 
.Fl l
22
 
.Op Fl T Ar transport
23
 
.Ar host Ar prognum
24
 
.Op Ar versnum
25
 
.Nm "rpcbindinfo"
26
 
.Op Fl n Ar portnum
27
 
.Fl u
28
 
.Ar host Ar prognum
29
 
.Op Ar versnum
30
 
.Nm "rpcbindinfo"
31
 
.Op Fl n Ar portnum
32
 
.Op Fl t
33
 
.Ar host Ar prognum
34
 
.Op Ar versnum
35
 
.Nm "rpcbindinfo"
36
 
.Fl a Ar serv_address
37
 
.Fl T Ar transport
38
 
.Ar prognum
39
 
.Op Ar versnum
40
 
.Nm "rpcbindinfo"
41
 
.Fl b
42
 
.Op Fl T Ar transport
43
 
.Ar prognum Ar versnum
44
 
.Nm "rpcbindinfo"
45
 
.Fl d
46
 
.Op Fl T Ar transport
47
 
.Ar prognum Ar versnum
48
 
.Sh DESCRIPTION
49
 
.Nm
50
 
makes an RPC call to an RPC
51
 
server and reports what it finds.
52
 
.Pp
53
 
In the first synopsis,
54
 
.Nm
55
 
lists all the registered RPC services with
56
 
.Nm rpcbind
57
 
on
58
 
.Ar host .
59
 
If
60
 
.Ar host
61
 
is not specified, the local host is the default.
62
 
If
63
 
.Fl s
64
 
is used, the information is displayed in a concise format.
65
 
.Pp
66
 
In the second synopsis,
67
 
.Nm
68
 
lists all the RPC services registered with
69
 
.Nm rpcbind ,
70
 
version 2.
71
 
Also note that the format of the information
72
 
is different in the first and the second synopsis.
73
 
This is because the second synopsis is an older protocol used to
74
 
collect the information displayed (version 2 of the
75
 
.Nm rpcbind
76
 
protocol).
77
 
.Pp
78
 
The third synopsis makes an RPC call to procedure 0
79
 
of
80
 
.Ar prognum
81
 
and
82
 
.Ar versnum
83
 
on the specified
84
 
.Ar host
85
 
and reports whether a response was received.
86
 
.Ar transport
87
 
is the transport which has to be used for contacting the
88
 
given service.
89
 
The remote address of the service is obtained by
90
 
making a call to the remote
91
 
.Nm rpcbind .
92
 
.Pp
93
 
The
94
 
.Ar prognum
95
 
argument is a number that represents an RPC program number.
96
 
If a
97
 
.Ar versnum
98
 
is specified,
99
 
.Nm
100
 
attempts to call that version of the specified
101
 
.Ar prognum .
102
 
Otherwise,
103
 
.Nm
104
 
attempts to find all the registered version
105
 
numbers for the specified
106
 
.Ar prognum
107
 
by calling version 0,
108
 
which is presumed not to exist;
109
 
if it does exist,
110
 
.Nm
111
 
attempts to obtain this information by calling
112
 
an extremely high version number instead,
113
 
and attempts to call each registered version.
114
 
Note:
115
 
the version number is required for
116
 
.Fl b
117
 
and
118
 
.Fl d
119
 
options.
120
 
.Sh OPTIONS
121
 
.Bl -tag -width indent
122
 
.It Fl T Ar transport
123
 
Specify the transport on which the service is required.
124
 
If this option is not specified,
125
 
.Nm
126
 
uses the transport specified in the
127
 
.Ev NETPATH
128
 
environment variable, or if that is unset or null, the transport
129
 
in the
130
 
.Xr netconfig 5
131
 
database is used.
132
 
This is a generic option,
133
 
and can be used in conjunction with other options as
134
 
shown in the SYNOPSIS.
135
 
.Pp
136
 
.It Fl a Ar serv_address
137
 
Use
138
 
.Ar serv_address
139
 
as the (universal) address for the service on
140
 
.Ar transport
141
 
to ping procedure 0
142
 
of the specified
143
 
.Ar prognum
144
 
and report whether a response was received.
145
 
The
146
 
.Fl T
147
 
option is required with the
148
 
.Fl a
149
 
option.
150
 
.Pp
151
 
If
152
 
.Ar versnum
153
 
is not specified,
154
 
.Nm
155
 
tries to ping all
156
 
available version numbers for that program number.
157
 
This option avoids calls to remote
158
 
.Nm rpcbind
159
 
to find the address of the service.
160
 
The
161
 
.Ar serv_address
162
 
is specified in universal address format of the given transport.
163
 
.Pp
164
 
.It Fl b
165
 
Make an RPC broadcast to procedure 0
166
 
of the specified
167
 
.Ar prognum
168
 
and
169
 
.Ar versnum
170
 
and report all hosts that respond.
171
 
If
172
 
.Ar transport
173
 
is specified, it broadcasts its request only on the
174
 
specified transport.
175
 
If broadcasting is not supported by any
176
 
transport,
177
 
an error message is printed.
178
 
Use of broadcasting should be limited because of the potential for adverse
179
 
effect on other systems.
180
 
.Pp
181
 
.It Fl d
182
 
Delete registration for the RPC service of the specified
183
 
.Ar prognum
184
 
and
185
 
.Ar versnum .
186
 
If
187
 
.Ar transport
188
 
is specified,
189
 
unregister the service on only that transport,
190
 
otherwise unregister the service on all
191
 
the transports on which it was registered.
192
 
Only the owner of a service can delete a registration, except the
193
 
super-user who can delete any service.
194
 
.Pp
195
 
.It Fl l
196
 
Display a list of entries with a given
197
 
.Ar prognum
198
 
and
199
 
.Ar versnum
200
 
on the specified
201
 
.Ar host .
202
 
Entries are returned for all transports
203
 
in the same protocol family as that used to contact the remote
204
 
.Nm rpcbind .
205
 
.Pp
206
 
.It Fl m
207
 
Display a table of statistics of
208
 
.Nm rpcbind
209
 
operations on the given
210
 
.Ar host .
211
 
The table shows statistics for each version of
212
 
.Nm rpcbind
213
 
(versions 2, 3 and 4), giving the number of times each procedure was
214
 
requested and successfully serviced, the number and type of remote call
215
 
requests that were made, and information about RPC address lookups that were
216
 
handled. This is useful for monitoring RPC activities on
217
 
.Ar host .
218
 
.Pp
219
 
.It Fl n Ar portnum
220
 
Use
221
 
.Ar portnum
222
 
as the port number for the
223
 
.Fl t
224
 
and
225
 
.Fl u
226
 
options instead of the port number given by
227
 
.Nm rpcbind .
228
 
Use of this option avoids a call to the remote
229
 
.Nm rpcbind
230
 
to find out the address of the service. This option is made
231
 
obsolete by the
232
 
.Fl a
233
 
option.
234
 
.Pp
235
 
.It Fl p
236
 
Probe
237
 
.Nm rpcbind
238
 
on
239
 
.Ar host
240
 
using version 2 of the
241
 
.Nm rpcbind
242
 
protocol,
243
 
and display a list of all registered RPC programs.
244
 
If
245
 
.Ar host
246
 
is not specified, it defaults to the local host.
247
 
Note: Version 2 of the
248
 
.Nm rpcbind
249
 
protocol was previously known as the portmapper protocol.
250
 
.Pp
251
 
.It Fl s
252
 
Display a concise list of all registered RPC programs on
253
 
.Ar host .
254
 
If
255
 
.Ar host
256
 
is not specified, it defaults to the local host.
257
 
.Pp
258
 
.It Fl t
259
 
Make an RPC call to procedure 0 of
260
 
.Ar prognum
261
 
on the specified
262
 
.Ar host
263
 
using TCP,
264
 
and report whether a response was received. This option is made
265
 
obsolete by the
266
 
.Fl T
267
 
option as shown in the third synopsis.
268
 
.Pp
269
 
.It Fl u
270
 
Make an RPC call to procedure 0 of
271
 
.Ar prognum
272
 
on the specified
273
 
.Ar host
274
 
using UDP,
275
 
and report whether a response was received. This option is made
276
 
obsolete by the
277
 
.Fl T
278
 
option as shown in the third synopsis.
279
 
.El
280
 
.Sh EXAMPLES
281
 
To show all of the RPC services registered on the local machine use:
282
 
.Pp
283
 
.Bd -literal
284
 
        example% rpcbindinfo
285
 
.Ed
286
 
.Pp
287
 
To show all of the RPC
288
 
services registered with
289
 
.Nm rpcbind
290
 
on the machine named
291
 
.Nm klaxon
292
 
use:
293
 
.Pp
294
 
.Bd -literal
295
 
        example% rpcbindinfo klaxon
296
 
.Ed
297
 
.Pp
298
 
The information displayed by the above commands can be quite lengthy.
299
 
Use the
300
 
.Fl s
301
 
option to display a more concise list:
302
 
.Pp
303
 
.Bd -literal
304
 
        example$ rpcbindinfo -s klaxon
305
 
.Ed
306
 
.Bl -column "program" "w,x,y,z" "local,tcp,udp,tcp6,udp6" "nlockmgr" "super-user"
307
 
.It program Ta version(s) Ta netid(s) Ta service Ta owner
308
 
.It 100000 Ta 2,3,4 Ta local,tcp,udp,tcp6,udp6 Ta rpcbind Ta super-user
309
 
.It 100008 Ta 1 Ta udp,tcp,udp6,tcp6 Ta walld Ta super-user
310
 
.It 100002 Ta 2,1 Ta udp,udp6 Ta rusersd Ta super-user
311
 
.It 100001 Ta 2,3,4 Ta udp,udp6 Ta rstatd Ta super-user
312
 
.It 100012 Ta 1 Ta udp,tcp Ta sprayd Ta super-user
313
 
.It 100007 Ta 3 Ta udp,tcp Ta ypbind Ta super-user
314
 
.El
315
 
.Pp
316
 
To show whether the RPC
317
 
service with program number
318
 
.Ar prognum
319
 
and version
320
 
.Ar versnum
321
 
is registered on the machine named
322
 
.Nm klaxon
323
 
for the transport TCP
324
 
use:
325
 
.Pp
326
 
.Bd -literal
327
 
        example% rpcbindinfo -T tcp klaxon prognum versnum
328
 
.Ed
329
 
.Pp
330
 
To show all RPC
331
 
services registered with version 2 of the
332
 
.Nm rpcbind
333
 
protocol on the local machine use:
334
 
.Bd -literal
335
 
        example% rpcbindinfo -p
336
 
.Ed
337
 
.Pp
338
 
To delete the registration for version
339
 
1 of the
340
 
.Nm walld
341
 
(program number 100008 )
342
 
service for all transports use:
343
 
.Bd -literal
344
 
        example# rpcbindinfo -d 100008 1
345
 
.Ed
346
 
.Pp
347
 
or
348
 
.Bd -literal
349
 
        example# rpcbindinfo -d walld 1
350
 
.Ed
351
 
.Sh SEE ALSO
352
 
.Xr rpc 3 ,
353
 
.Xr netconfig 5 ,
354
 
.Xr rpc 5 ,
355
 
.Xr rpcbind 8