Annotation of src/usr.bin/rpcinfo/rpcinfo.8, Revision 1.14
1.14 ! millert 1: .\" $OpenBSD: rpcinfo.8,v 1.13 2007/05/31 19:20:15 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.14 ! millert 4: .\" Copyright (c) 2010, Oracle America, Inc.
1.11 jmc 5: .\"
1.14 ! millert 6: .\" Redistribution and use in source and binary forms, with or without
! 7: .\" modification, are permitted provided that the following conditions are
! 8: .\" met:
! 9: .\"
! 10: .\" * Redistributions of source code must retain the above copyright
! 11: .\" notice, this list of conditions and the following disclaimer.
! 12: .\" * Redistributions in binary form must reproduce the above
! 13: .\" copyright notice, this list of conditions and the following
! 14: .\" disclaimer in the documentation and/or other materials
! 15: .\" provided with the distribution.
! 16: .\" * Neither the name of the "Oracle America, Inc." nor the names of its
! 17: .\" contributors may be used to endorse or promote products derived
! 18: .\" from this software without specific prior written permission.
! 19: .\"
! 20: .\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
! 21: .\" "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
! 22: .\" LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
! 23: .\" FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
! 24: .\" COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
! 25: .\" INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
! 26: .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
! 27: .\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
! 28: .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
! 29: .\" WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
! 30: .\" NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
! 31: .\" OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
1.10 jmc 32: .\"
1.14 ! millert 33: .Dd $Mdocdate: May 31 2007 $
1.1 deraadt 34: .Dt RPCINFO 8
35: .Os
36: .Sh NAME
37: .Nm rpcinfo
38: .Nd report RPC information
39: .Sh SYNOPSIS
40: .Nm rpcinfo
1.12 jmc 41: .Fl b Ar program version
42: .Nm rpcinfo
43: .Fl d Ar program version
44: .Nm rpcinfo
45: .Fl p Op Ar host
46: .Nm rpcinfo
47: .Fl s Ar program version port
1.1 deraadt 48: .Nm rpcinfo
49: .Op Fl n Ar portnum
1.12 jmc 50: .Fl t Ar host program
1.1 deraadt 51: .Op Ar version
52: .Nm rpcinfo
53: .Op Fl n Ar portnum
1.12 jmc 54: .Fl u Ar host program
1.1 deraadt 55: .Op Ar version
56: .Sh DESCRIPTION
1.5 aaron 57: .Nm
1.1 deraadt 58: makes an
59: .Tn RPC
60: call to an
61: .Tn RPC
62: server and reports what it finds.
1.5 aaron 63: .Pp
64: The options are as follows:
1.8 aaron 65: .Bl -tag -width Ds
1.1 deraadt 66: .It Fl b
67: Make an
68: .Tn RPC
69: broadcast to procedure 0 of the specified
70: .Ar program
71: and
72: .Ar version
73: using
74: .Tn UDP
75: and report all hosts that respond.
76: .It Fl d
77: Delete registration for the
78: .Tn RPC
79: service of the specified
80: .Ar program
81: and
82: .Ar version .
1.7 deraadt 83: Registrations which point at ports numbered below 1024 can only be
84: deleted by the superuser.
1.12 jmc 85: .It Fl n Ar portnum
86: Use
87: .Ar portnum
88: as the port number for the
89: .Fl t
90: and
91: .Fl u
92: options instead of the port number given by the portmapper.
93: .It Fl p
94: Probe the portmapper on
95: .Ar host ,
96: and print a list of all registered
97: .Tn RPC
98: programs.
99: If
100: .Ar host
101: is not specified, it defaults to the value returned by
102: .Xr hostname 1 .
1.7 deraadt 103: .It Fl s
104: Create a registration for the
105: .Tn RPC
106: service of the specified
107: .Ar program
108: and
109: .Ar version ,
110: located at port
111: .Ar port .
112: Registrations which point at ports numbered below 1024 can only be
113: created (or changed) by the superuser.
1.12 jmc 114: .It Fl t
115: Make an
116: .Tn RPC
117: call to procedure 0 of
118: .Ar program
119: on the specified
120: .Ar host
121: using
122: .Tn TCP ,
123: and report whether a response was received.
124: .It Fl u
125: Make an
126: .Tn RPC
127: call to procedure 0 of
128: .Ar program
129: on the specified
130: .Ar host
131: using
132: .Tn UDP ,
133: and report whether a response was received.
1.1 deraadt 134: .El
135: .Pp
136: The
137: .Ar program
138: argument can be either a name or a number.
139: .Pp
140: If a
141: .Ar version
142: is specified,
1.5 aaron 143: .Nm
1.1 deraadt 144: attempts to call that version of the specified
145: .Ar program .
146: Otherwise,
1.5 aaron 147: .Nm
1.1 deraadt 148: attempts to find all the registered version
149: numbers for the specified
150: .Ar program
151: by calling version 0 (which is presumed not
152: to exist; if it does exist,
1.5 aaron 153: .Nm
1.1 deraadt 154: attempts to obtain this information by calling
155: an extremely high version
156: number instead) and attempts to call each registered version.
157: Note: the version number is required for
158: .Fl b
159: and
160: .Fl d
161: options.
162: .Sh EXAMPLES
163: To show all of the
164: .Tn RPC
165: services registered on the local machine use:
166: .Pp
1.9 deraadt 167: .Dl $ rpcinfo -p
1.1 deraadt 168: .Pp
169: To show all of the
170: .Tn RPC
171: services registered on the machine named
172: .Ar klaxon
173: use:
174: .Pp
1.9 deraadt 175: .Dl $ rpcinfo -p klaxon
1.1 deraadt 176: .Pp
177: To show all machines on the local net that are running the Yellow Pages
178: service use:
179: .Pp
1.9 deraadt 180: .Dl $ rpcinfo -b ypserv 'version' | uniq
1.1 deraadt 181: .Pp
182: where 'version' is the current Yellow Pages version obtained from the
183: results of the
184: .Fl p
185: switch above.
186: .Pp
187: To delete the registration for version 1 of the
188: .Nm walld
189: service use:
190: .Pp
1.9 deraadt 191: .Dl $ rpcinfo -d walld 1
1.1 deraadt 192: .Sh SEE ALSO
193: .Xr rpc 5 ,
194: .Xr portmap 8
195: .Rs
196: .%T "RPC Programming Guide"
197: .Re
198: .Sh BUGS
199: In releases prior to SunOS 3.0, the Network File System (NFS) did not
200: register itself with the portmapper;
1.5 aaron 201: .Nm
1.1 deraadt 202: cannot be used to make
203: .Tn RPC
204: calls to the
205: .Tn NFS
206: server on hosts running such releases.