rpcinfo(8)                          CLIX                          rpcinfo(8)



  NAME

    rpcinfo - Reports RPC information

  SYNOPSIS

    /etc/rpcinfo -p [host]

    /etc/rpcinfo -u host program-number [version-number]

    /etc/rpcinfo -t host program-number [version-number]

    /etc/rpcinfo -b program version

  FLAGS

    -p   Probes the portmapper on host and displays a list of all registered
         RPC programs.  If host is not specified, it defaults to the nodename
         returned by uname.

    -u   Makes an RPC call to procedure 0 of program-number using the User
         Datagram Protocol (UDP) and reports whether a response was received.

    -t   Makes an RPC call to procedure 0 of program-number using the
         Transmission Control Protocol (TCP) and reports whether a response
         was received.

    -b   Makes an RPC broadcast to procedure 0 of the specified program and
         version using UDP and reports on all hosts that respond.

  DESCRIPTION

    The rpcinfo command makes an RPC to an RPC server and reports what it
    finds.  The program-number 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 and
    attempts to call each registered version.  The version number is required
    for the -b flag.

  EXAMPLES

    1.  To show all of the RPC services registered on the machine named
        target, enter the following:

        rpcinfo -p target


    2.  To show all machines on the local net that are running the Network
        Information Service (NIS), enter the following:



  2/94 - Intergraph Corporation                                              1

  rpcinfo(8)                          CLIX                          rpcinfo(8)



        rpcinfo -b ypserv version | uniq

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

  FILES

    /etc/rpc   Names for RPC program numbers.

  DIAGNOSTICS

    rpcinfo: can't contact portmapper
           The portmap process on the specified system cannot be contacted;
           the system may be unavailable or not running a portmap process.

    program N is unavailable
           Specified program number is not available on the specified host.

    program N version M is unavailable
           Specified program and version number is not available on the
           specified host.

  EXIT VALUES

    The command exits with a 1 if any error occurs.  Otherwise, it exits with
    a 0.

  RELATED INFORMATION

    Commands:  portmap(8)

    Files:  rpc(4)

    CLIX Programming Guide




















  2                                              Intergraph Corporation - 2/94