unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-4.1.3)
Page:
Section:
Apropos / Subsearch:
optional field

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

AVAILABILITY
       This  program  is  available  with the Networking software installation
       option.  Refer to for information on how to install optional software.

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 specified, it defaults to the
              value returned by hostname(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 specified 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 regis-
       tered 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: the ver-
       sion number is required for -b and -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 Network
       Information Service (NIS) use:

              example% rpcinfo -b ypserv 'version' | uniq

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

       To delete the registration for version 1 of the walld service use:

              example% rpcinfo -d walld 1

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

       RPC Programming Guide in

BUGS
       In  releases  prior  to  the SunOS 3.0 release, 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.

NOTES
       The Network Information Service (NIS) was formerly known as Sun  Yellow
       Pages  (YP).   The  functionality of the two remains the same; only the
       name has changed.



                               17 December 1987                    RPCINFO(8C)