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