rpcinfo(NADM)                   19 June 1992                   rpcinfo(NADM)


 Name

    rpcinfo - report RPC information

 Syntax

    rpcinfo -p [ host ]

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

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

    rpcinfo -b 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 specified, it defaults to the
             value returned by hostname(TC).

    -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

    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 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 version
    number is required for the -b option.

 Examples

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

       $ rpcinfo -p

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

       $ rpcinfo -p klaxon

    To show all machines on the local net which are running the network in-
    formation service, use:

       $ rpcinfo -b ypserv version | uniq

    where version is the current network information service version obtained
    from the results of the -p switch above.

 See also

    rpc(NF), portmap(NADM)

 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.