Annotation of src/usr.bin/rpcinfo/rpcinfo.8, Revision 1.13
1.13 ! jmc 1: .\" $OpenBSD: rpcinfo.8,v 1.12 2007/03/26 14:20:03 jmc Exp $
1.1 deraadt 2: .\" from: @(#)rpcinfo.8c 2.2 88/08/03 4.0 RPCSRC; from 1.24 88/02/25 SMI
3: .\"
1.10 jmc 4: .\" Copyright (C) 1986, Sun Microsystems, Inc.
1.11 jmc 5: .\"
1.10 jmc 6: .\"
7: .\" Sun RPC is a product of Sun Microsystems, Inc. and is provided for
8: .\" unrestricted use provided that this legend is included on all tape
9: .\" media and as a part of the software program in whole or part. Users
10: .\" may copy or modify Sun RPC without charge, but are not authorized
11: .\" to license or distribute it to anyone else except as part of a product or
12: .\" program developed by the user.
1.11 jmc 13: .\"
1.10 jmc 14: .\" SUN RPC IS PROVIDED AS IS WITH NO WARRANTIES OF ANY KIND INCLUDING THE
15: .\" WARRANTIES OF DESIGN, MERCHANTIBILITY AND FITNESS FOR A PARTICULAR
16: .\" PURPOSE, OR ARISING FROM A COURSE OF DEALING, USAGE OR TRADE PRACTICE.
1.11 jmc 17: .\"
1.10 jmc 18: .\" Sun RPC is provided with no support and without any obligation on the
19: .\" part of Sun Microsystems, Inc. to assist in its use, correction,
20: .\" modification or enhancement.
1.11 jmc 21: .\"
1.10 jmc 22: .\" SUN MICROSYSTEMS, INC. SHALL HAVE NO LIABILITY WITH RESPECT TO THE
23: .\" INFRINGEMENT OF COPYRIGHTS, TRADE SECRETS OR ANY PATENTS BY SUN RPC
24: .\" OR ANY PART THEREOF.
1.11 jmc 25: .\"
1.10 jmc 26: .\" In no event will Sun Microsystems, Inc. be liable for any lost revenue
27: .\" or profits or other special, indirect and consequential damages, even if
28: .\" Sun has been advised of the possibility of such damages.
1.11 jmc 29: .\"
1.10 jmc 30: .\" Sun Microsystems, Inc.
31: .\" 2550 Garcia Avenue
32: .\" Mountain View, California 94043
1.11 jmc 33: .\"
1.13 ! jmc 34: .Dd $Mdocdate$
1.1 deraadt 35: .Dt RPCINFO 8
36: .Os
37: .Sh NAME
38: .Nm rpcinfo
39: .Nd report RPC information
40: .Sh SYNOPSIS
41: .Nm rpcinfo
1.12 jmc 42: .Fl b Ar program version
43: .Nm rpcinfo
44: .Fl d Ar program version
45: .Nm rpcinfo
46: .Fl p Op Ar host
47: .Nm rpcinfo
48: .Fl s Ar program version port
1.1 deraadt 49: .Nm rpcinfo
50: .Op Fl n Ar portnum
1.12 jmc 51: .Fl t Ar host program
1.1 deraadt 52: .Op Ar version
53: .Nm rpcinfo
54: .Op Fl n Ar portnum
1.12 jmc 55: .Fl u Ar host program
1.1 deraadt 56: .Op Ar version
57: .Sh DESCRIPTION
1.5 aaron 58: .Nm
1.1 deraadt 59: makes an
60: .Tn RPC
61: call to an
62: .Tn RPC
63: server and reports what it finds.
1.5 aaron 64: .Pp
65: The options are as follows:
1.8 aaron 66: .Bl -tag -width Ds
1.1 deraadt 67: .It Fl b
68: Make an
69: .Tn RPC
70: broadcast to procedure 0 of the specified
71: .Ar program
72: and
73: .Ar version
74: using
75: .Tn UDP
76: and report all hosts that respond.
77: .It Fl d
78: Delete registration for the
79: .Tn RPC
80: service of the specified
81: .Ar program
82: and
83: .Ar version .
1.7 deraadt 84: Registrations which point at ports numbered below 1024 can only be
85: deleted by the superuser.
1.12 jmc 86: .It Fl n Ar portnum
87: Use
88: .Ar portnum
89: as the port number for the
90: .Fl t
91: and
92: .Fl u
93: options instead of the port number given by the portmapper.
94: .It Fl p
95: Probe the portmapper on
96: .Ar host ,
97: and print a list of all registered
98: .Tn RPC
99: programs.
100: If
101: .Ar host
102: is not specified, it defaults to the value returned by
103: .Xr hostname 1 .
1.7 deraadt 104: .It Fl s
105: Create a registration for the
106: .Tn RPC
107: service of the specified
108: .Ar program
109: and
110: .Ar version ,
111: located at port
112: .Ar port .
113: Registrations which point at ports numbered below 1024 can only be
114: created (or changed) by the superuser.
1.12 jmc 115: .It Fl t
116: Make an
117: .Tn RPC
118: call to procedure 0 of
119: .Ar program
120: on the specified
121: .Ar host
122: using
123: .Tn TCP ,
124: and report whether a response was received.
125: .It Fl u
126: Make an
127: .Tn RPC
128: call to procedure 0 of
129: .Ar program
130: on the specified
131: .Ar host
132: using
133: .Tn UDP ,
134: and report whether a response was received.
1.1 deraadt 135: .El
136: .Pp
137: The
138: .Ar program
139: argument can be either a name or a number.
140: .Pp
141: If a
142: .Ar version
143: is specified,
1.5 aaron 144: .Nm
1.1 deraadt 145: attempts to call that version of the specified
146: .Ar program .
147: Otherwise,
1.5 aaron 148: .Nm
1.1 deraadt 149: attempts to find all the registered version
150: numbers for the specified
151: .Ar program
152: by calling version 0 (which is presumed not
153: to exist; if it does exist,
1.5 aaron 154: .Nm
1.1 deraadt 155: attempts to obtain this information by calling
156: an extremely high version
157: number instead) and attempts to call each registered version.
158: Note: the version number is required for
159: .Fl b
160: and
161: .Fl d
162: options.
163: .Sh EXAMPLES
164: To show all of the
165: .Tn RPC
166: services registered on the local machine use:
167: .Pp
1.9 deraadt 168: .Dl $ rpcinfo -p
1.1 deraadt 169: .Pp
170: To show all of the
171: .Tn RPC
172: services registered on the machine named
173: .Ar klaxon
174: use:
175: .Pp
1.9 deraadt 176: .Dl $ rpcinfo -p klaxon
1.1 deraadt 177: .Pp
178: To show all machines on the local net that are running the Yellow Pages
179: service use:
180: .Pp
1.9 deraadt 181: .Dl $ rpcinfo -b ypserv 'version' | uniq
1.1 deraadt 182: .Pp
183: where 'version' is the current Yellow Pages version obtained from the
184: results of the
185: .Fl p
186: switch above.
187: .Pp
188: To delete the registration for version 1 of the
189: .Nm walld
190: service use:
191: .Pp
1.9 deraadt 192: .Dl $ rpcinfo -d walld 1
1.1 deraadt 193: .Sh SEE ALSO
194: .Xr rpc 5 ,
195: .Xr portmap 8
196: .Rs
197: .%T "RPC Programming Guide"
198: .Re
199: .Sh BUGS
200: In releases prior to SunOS 3.0, the Network File System (NFS) did not
201: register itself with the portmapper;
1.5 aaron 202: .Nm
1.1 deraadt 203: cannot be used to make
204: .Tn RPC
205: calls to the
206: .Tn NFS
207: server on hosts running such releases.