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