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