RPCINFO(8C)                                           RPCINFO(8C)


NAME
       rpcinfo - report RPC information

SYNOPSIS
       rpcinfo -p [ host ]

       rpcinfo [ -n portnum ] -u host program [ version ]

       rpcinfo [ -n portnum ] -t host program [ version ]

       rpcinfo -b program version

       rpcinfo -d program version

DESCRIPTION
       rpcinfo  makes  an  RPC  call 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 speci-
              fied, it defaults to the value  returned  by  host-
              name(1).

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

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

       -n     Use  portnum  as  the port number for the -t and -u
              options instead of the port  number  given  by  the
              portmapper.

       -b     Make  an RPC broadcast to procedure 0 of the speci-
              fied program and version using UDP and  report  all
              hosts that respond.

       -d     Delete  registration  for  the  RPC  service of the
              specified program and version.  This option can  be
              exercised only by the super-user.

       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 the registered version numbers for
       the specified program by calling version 0 (which is  pre-
       sumed  not to exist; if it does exist, rpcinfo attempts to
       obtain this information by calling an extremely high  ver-
       sion  number instead) and attempts to call each registered
       version.  Note: the version number is required for -b  and



                         17 December 1987                       1

RPCINFO(8C)                                           RPCINFO(8C)


       -d options.

EXAMPLES
       To  show  all  of the RPC services registered on the local
       machine use:

              example% rpcinfo -p

       To show all of the RPC services registered on the  machine
       named klaxon use:

              example% rpcinfo -p klaxon

       To show all machines on the local net that are running the
       Yellow Pages service use:

              example% rpcinfo -b ypserv 'version' | uniq

       where  'version'  is  the  current  Yellow  Pages  version
       obtained from the results of the -p switch above.

       To delete the registration for version 1 of the walld ser-
       vice use:

              example% rpcinfo -d walld 1

SEE ALSO
       rpc(5), portmap(8C)

       RPC Programming Guide

BUGS
       In releases prior to SunOS 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.





















                         17 December 1987                       2