RPCINFO(8)              COMMAND REFERENCE              RPCINFO(8)



NAME
     rpcinfo - report RPC information

SYNOPSIS
     rpcinfo -p [ host ]
     rpcinfo -u host program [ version ]
     rpcinfo -t host program [ version ]

DESCRIPTION
     The program rpcinfo makes a Remote Procedure Call (RPC) to
     an RPC server and reports what it finds.

OPTIONS
     -p   Probe the portmapper on host, and print a list of all
          registered RPC programs.  If host is not specified, it
          defaults to the value returned by hostname(1n).

     -u   Make an RPC call to procedure 0 of program on the
          specified host using User Datagram Protocol (UDP), and
          report whether a response was received.

     -t   Make an RPC call to procedure 0 of program on the
          specified host using TCP (Transmission Control
          Protocol), and report whether a response was received.

     The program argument can be either a name or a number.

     If a version is specified, rpcinfo attempts to call that
     version of the specified program.  Otherwise, rpcinfo
     attempts to find all registered version numbers for the
     specified program by calling version 0 (which is presumed
     not to exist; if it does exist, rpcinfo attempts to obtain
     this information by calling an extremely high version number
     instead) and attempts to call each registered version.

     Note: rpcinfo, without a host name, generates an Ethernet
     broadcast packet, so information returned is limited to
     hosts on the local Ethernet; hosts accessible through
     gateways will not be included.  If you specify a valid host
     name an IP packet is generated and rpcinfo can give
     information about a host that is accessible via a gateway as
     well as information about a host on the local Ethernet.

EXAMPLES
     Here is an example of the output generated by the command:

          rpcinfo -p sunny
          program   vers   proto   port
          100003     2      udp    2049   nfs
          100024     1      udp    1028   status
          100024     1      tcp    1024   status
          100021     1      tcp    1025   nlockmgr



Printed 4/6/89                                                  1

RPCINFO(8)              COMMAND REFERENCE              RPCINFO(8)



          100021     1      udp    1033   nlockmgr
          100020     1      udp    1036   llockmgr
          100020     1      tcp    1026   llockmgr
          100021     2      tcp    1027   nlockmgr
          100012     1      udp    1059   sprayd
          100005     1      udp    1063   mountd
          100008     1      udp    1065   walld
          100002     1      udp    1067   rusersd
          100002     2      udp    1067   rusersd
          100001     1      udp    1070   rstatd
          100001     2      udp    1070   rstatd
          100001     3      udp    1070   rstatd

     This is an example of the output generated by the command:

          rpcinfo -u sunny nfs
          program 100003 version 2 ready and waiting

     Here is an example of the output generated by the command:

          rpcinfo -t sunny llockmgr
          program 100020 version 1 ready and waiting

     Here is an example of the ERROR messages generated by
     rpcinfo:

          rpcinfo -t sunny nfs
          rpcinfo: RPC: Program not registered
          program 100003 is not available

FILES
     /etc/rpc       names for RPC program numbers

CAVEATS
     In releases prior to UNIXr 3.0, the Network File System
     (NFS) did not register itself with the portmapper; rpcinfo
     cannot be used to make RPC calls to the NFS server on hosts
     running such releases.

SEE ALSO
     rpc(5), portmap(8c).

     See the RPC Programming Guide in the Network File System
     reference manual.











Printed 4/6/89                                                  2

%%index%%
na:312,84;
sy:396,547;
de:943,303;
op:1246,2101;
ex:3347,416;4147,1168;
fi:5315,119;
ca:5434,367;
se:5801,297;
%%index%%000000000144