Annotation of src/usr.bin/rpcinfo/rpcinfo.8, Revision 1.12
1.12 ! jmc 1: .\" $OpenBSD: rpcinfo.8,v 1.11 2003/06/10 09:12:11 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.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
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.