Annotation of src/usr.bin/rpcinfo/rpcinfo.8, Revision 1.10
1.10 ! jmc 1: .\" $OpenBSD: rpcinfo.8,v 1.9 2002/11/14 02:57:28 deraadt 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.
! 5: .\"
! 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.
! 13: .\"
! 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.
! 17: .\"
! 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.
! 21: .\"
! 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.
! 25: .\"
! 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.
! 29: .\"
! 30: .\" Sun Microsystems, Inc.
! 31: .\" 2550 Garcia Avenue
! 32: .\" Mountain View, California 94043
! 33: .\"
1.1 deraadt 34: .Dd December 17, 1987
35: .Dt RPCINFO 8
36: .Os
37: .Sh NAME
38: .Nm rpcinfo
39: .Nd report RPC information
40: .Sh SYNOPSIS
41: .Nm rpcinfo
42: .Fl p
43: .Op Ar host
44: .Nm rpcinfo
45: .Op Fl n Ar portnum
46: .Fl u Ar host
47: .Ar program
48: .Op Ar version
49: .Nm rpcinfo
50: .Op Fl n Ar portnum
1.4 aaron 51: .Fl t Ar host
1.1 deraadt 52: .Ar program
53: .Op Ar version
54: .Nm rpcinfo
55: .Fl b
56: .Ar program version
57: .Nm rpcinfo
58: .Fl d
59: .Ar program version
1.7 deraadt 60: .Nm rpcinfo
61: .Fl s
62: .Ar program version port
1.1 deraadt 63: .Sh DESCRIPTION
1.5 aaron 64: .Nm
1.1 deraadt 65: makes an
66: .Tn RPC
67: call to an
68: .Tn RPC
69: server and reports what it finds.
1.5 aaron 70: .Pp
71: The options are as follows:
1.8 aaron 72: .Bl -tag -width Ds
1.1 deraadt 73: .It Fl p
74: Probe the portmapper on
75: .Ar host ,
76: and print a list of all registered
77: .Tn RPC
1.5 aaron 78: programs.
79: If
1.1 deraadt 80: .Ar host
81: is not specified, it defaults to the value returned by
82: .Xr hostname 1 .
83: .It Fl u
84: Make an
85: .Tn RPC
86: call to procedure 0 of
87: .Ar program
88: on the specified
89: .Ar host
90: using
91: .Tn UDP ,
92: and report whether a response was received.
93: .It Fl t
94: Make an
95: .Tn RPC
96: call to procedure 0 of
97: .Ar program
98: on the specified
99: .Ar host
100: using
101: .Tn TCP ,
102: and report whether a response was received.
103: .It Fl n
104: Use
105: .Ar portnum
106: as the port number for the
107: .Fl t
108: and
109: .Fl u
110: options instead of the port number given by the portmapper.
111: .It Fl b
112: Make an
113: .Tn RPC
114: broadcast to procedure 0 of the specified
115: .Ar program
116: and
117: .Ar version
118: using
119: .Tn UDP
120: and report all hosts that respond.
121: .It Fl d
122: Delete registration for the
123: .Tn RPC
124: service of the specified
125: .Ar program
126: and
127: .Ar version .
1.7 deraadt 128: Registrations which point at ports numbered below 1024 can only be
129: deleted by the superuser.
130: .It Fl s
131: Create a registration for the
132: .Tn RPC
133: service of the specified
134: .Ar program
135: and
136: .Ar version ,
137: located at port
138: .Ar port .
139: Registrations which point at ports numbered below 1024 can only be
140: created (or changed) by the superuser.
1.1 deraadt 141: .El
142: .Pp
143: The
144: .Ar program
145: argument can be either a name or a number.
146: .Pp
147: If a
148: .Ar version
149: is specified,
1.5 aaron 150: .Nm
1.1 deraadt 151: attempts to call that version of the specified
152: .Ar program .
153: Otherwise,
1.5 aaron 154: .Nm
1.1 deraadt 155: attempts to find all the registered version
156: numbers for the specified
157: .Ar program
158: by calling version 0 (which is presumed not
159: to exist; if it does exist,
1.5 aaron 160: .Nm
1.1 deraadt 161: attempts to obtain this information by calling
162: an extremely high version
163: number instead) and attempts to call each registered version.
164: Note: the version number is required for
165: .Fl b
166: and
167: .Fl d
168: options.
169: .Sh EXAMPLES
170: To show all of the
171: .Tn RPC
172: services registered on the local machine use:
173: .Pp
1.9 deraadt 174: .Dl $ rpcinfo -p
1.1 deraadt 175: .Pp
176: To show all of the
177: .Tn RPC
178: services registered on the machine named
179: .Ar klaxon
180: use:
181: .Pp
1.9 deraadt 182: .Dl $ rpcinfo -p klaxon
1.1 deraadt 183: .Pp
184: To show all machines on the local net that are running the Yellow Pages
185: service use:
186: .Pp
1.9 deraadt 187: .Dl $ rpcinfo -b ypserv 'version' | uniq
1.1 deraadt 188: .Pp
189: where 'version' is the current Yellow Pages version obtained from the
190: results of the
191: .Fl p
192: switch above.
193: .Pp
194: To delete the registration for version 1 of the
195: .Nm walld
196: service use:
197: .Pp
1.9 deraadt 198: .Dl $ rpcinfo -d walld 1
1.1 deraadt 199: .Sh SEE ALSO
200: .Xr rpc 5 ,
201: .Xr portmap 8
202: .Rs
203: .%T "RPC Programming Guide"
204: .Re
205: .Sh BUGS
206: In releases prior to SunOS 3.0, the Network File System (NFS) did not
207: register itself with the portmapper;
1.5 aaron 208: .Nm
1.1 deraadt 209: cannot be used to make
210: .Tn RPC
211: calls to the
212: .Tn NFS
213: server on hosts running such releases.