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