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