Commit | Line | Data |
---|---|---|
cce18959 C |
1 | .\" from: @(#)rpcinfo.8c 2.2 88/08/03 4.0 RPCSRC; from 1.24 88/02/25 SMI |
2 | .\" $Id: rpcinfo.8,v 1.3 1993/08/01 07:29:21 mycroft Exp $ | |
3 | .\" | |
4 | .Dd December 17, 1987 | |
5 | .Dt RPCINFO 8 | |
6 | .Os | |
7 | .Sh NAME | |
8 | .Nm rpcinfo | |
9 | .Nd report RPC information | |
10 | .Sh SYNOPSIS | |
11 | .Nm rpcinfo | |
12 | .Fl p | |
13 | .Op Ar host | |
14 | .Nm rpcinfo | |
15 | .Op Fl n Ar portnum | |
16 | .Fl u Ar host | |
17 | .Ar program | |
18 | .Op Ar version | |
19 | .Nm rpcinfo | |
20 | .Op Fl n Ar portnum | |
21 | .Fl t Ar host | |
22 | .Ar program | |
23 | .Op Ar version | |
24 | .Nm rpcinfo | |
25 | .Fl b | |
26 | .Ar program version | |
27 | .Nm rpcinfo | |
28 | .Fl d | |
29 | .Ar program version | |
30 | .Sh DESCRIPTION | |
31 | .Nm rpcinfo | |
32 | makes an | |
33 | .Tn RPC | |
34 | call to an | |
35 | .Tn RPC | |
36 | server and reports what it finds. | |
37 | .Sh OPTIONS | |
38 | .Bl -tag -width indent | |
39 | .It Fl p | |
40 | Probe the portmapper on | |
41 | .Ar host , | |
42 | and print a list of all registered | |
43 | .Tn RPC | |
44 | programs. If | |
45 | .Ar host | |
46 | is not specified, it defaults to the value returned by | |
47 | .Xr hostname 1 . | |
48 | .It Fl u | |
49 | Make an | |
50 | .Tn RPC | |
51 | call to procedure 0 of | |
52 | .Ar program | |
53 | on the specified | |
54 | .Ar host | |
55 | using | |
56 | .Tn UDP , | |
57 | and report whether a response was received. | |
58 | .It Fl t | |
59 | Make an | |
60 | .Tn RPC | |
61 | call to procedure 0 of | |
62 | .Ar program | |
63 | on the specified | |
64 | .Ar host | |
65 | using | |
66 | .Tn TCP , | |
67 | and report whether a response was received. | |
68 | .It Fl n | |
69 | Use | |
70 | .Ar portnum | |
71 | as the port number for the | |
72 | .Fl t | |
73 | and | |
74 | .Fl u | |
75 | options instead of the port number given by the portmapper. | |
76 | .It Fl b | |
77 | Make an | |
78 | .Tn RPC | |
79 | broadcast to procedure 0 of the specified | |
80 | .Ar program | |
81 | and | |
82 | .Ar version | |
83 | using | |
84 | .Tn UDP | |
85 | and report all hosts that respond. | |
86 | .It Fl d | |
87 | Delete registration for the | |
88 | .Tn RPC | |
89 | service of the specified | |
90 | .Ar program | |
91 | and | |
92 | .Ar version . | |
93 | This option can be exercised only by the super-user. | |
94 | .El | |
95 | .Pp | |
96 | The | |
97 | .Ar program | |
98 | argument can be either a name or a number. | |
99 | .Pp | |
100 | If a | |
101 | .Ar version | |
102 | is specified, | |
103 | .Nm rpcinfo | |
104 | attempts to call that version of the specified | |
105 | .Ar program . | |
106 | Otherwise, | |
107 | .Nm rpcinfo | |
108 | attempts to find all the registered version | |
109 | numbers for the specified | |
110 | .Ar program | |
111 | by calling version 0 (which is presumed not | |
112 | to exist; if it does exist, | |
113 | .Ar rpcinfo | |
114 | attempts to obtain this information by calling | |
115 | an extremely high version | |
116 | number instead) and attempts to call each registered version. | |
117 | Note: the version number is required for | |
118 | .Fl b | |
119 | and | |
120 | .Fl d | |
121 | options. | |
122 | .Sh EXAMPLES | |
123 | To show all of the | |
124 | .Tn RPC | |
125 | services registered on the local machine use: | |
126 | .Pp | |
127 | .Dl example% rpcinfo -p | |
128 | .Pp | |
129 | To show all of the | |
130 | .Tn RPC | |
131 | services registered on the machine named | |
132 | .Ar klaxon | |
133 | use: | |
134 | .Pp | |
135 | .Dl example% rpcinfo -p klaxon | |
136 | .Pp | |
137 | To show all machines on the local net that are running the Yellow Pages | |
138 | service use: | |
139 | .Pp | |
140 | .Dl example% rpcinfo -b ypserv 'version' | uniq | |
141 | .Pp | |
142 | where 'version' is the current Yellow Pages version obtained from the | |
143 | results of the | |
144 | .Fl p | |
145 | switch above. | |
146 | .Pp | |
147 | To delete the registration for version 1 of the | |
148 | .Nm walld | |
149 | service use: | |
150 | .Pp | |
151 | .Dl example% rpcinfo -d walld 1 | |
152 | .Sh SEE ALSO | |
153 | .Xr rpc 5 , | |
154 | .Xr portmap 8 | |
155 | .Rs | |
156 | .%T "RPC Programming Guide" | |
157 | .Re | |
158 | .Sh BUGS | |
159 | In releases prior to SunOS 3.0, the Network File System (NFS) did not | |
160 | register itself with the portmapper; | |
161 | .Nm rpcinfo | |
162 | cannot be used to make | |
163 | .Tn RPC | |
164 | calls to the | |
165 | .Tn NFS | |
166 | server on hosts running such releases. |