rpcinfo Command

The rpcinfo command makes an RPC call to the RPC server and reports the status of the server, which is registered and operational with Portmapper.

Syntax

rpcinfo for a Host

                   ┌─ local_host──┐
─rpcinfo── -p────┼──────────────┼───┬─────────────┬──────────
                   └─ host────────┘   └─ > filename─┘

Using UDP to send rpcinfo for a Host

─rpcinfo────┬─────────────┬─── -u host prognum─┬──────────┬───
              └─ -n portnum─┘                    └─ versnum─┘

─────┬─────────────┬──────────────────────────────────────────
      └─ > filename─┘

Using TCP to send rpcinfo for a Host

─rpcinfo────┬─────────────┬─── -t host prognum─┬──────────┬───
              └─ -n portnum─┘                    └─ versnum─┘

─────┬─────────────┬──────────────────────────────────────────
      └─ > filename─┘

Using UDP to send rpcinfo Broadcast to Hosts

─rpcinfo──┬─────┬── prognum── versnum────┬─────────────┬─────
            └─ -b─┘                        └─ > filename─┘

Parameters

p host

Queries the Portmapper about the specified host and prints a list of all registered RPC programs. If the host is not specified, the system defaults to the local host name. > filename

Specifies a file to which the list of registered RPC programs is redirected. -n portnum

Specifies the port number to be used for the -t and -u parameters. This value replaces the port number that is given by the Portmapper. -u host prognum versnum

prognum

versnum

-t host prognum versnum

prognum

versnum

-b prognum versnum

prognum

versnum

The prognum argument can be either a name or a number. If you specify a versnum, the rpcinfo command tries to call that version of the specified program. Otherwise, it tries to find all the registered version numbers for the program you specify by calling version 0; then it tries to call each registered version.

The TCPIP\ETC\RPC file is associated with the rpcinfo command. This file contains a list of server names and their corresponding RPC program numbers and aliases.

Examples

Use the rpcinfo command as follows to display RPC services registered on the local host:

rpcinfo -p

Examples

Use the rpcinfo command as follows to display RPC services registered on a remote host named charm:

rpcinfo -p charm

Examples

Use the rpcinfo command as follows to display the status of a particular RPC program on the remote host named charm:

rpcinfo -u charm 100003 2

rpcinfo -u charm nfs 2

In the previous examples, the rpcinfo command shows one of the following:

Program 100003 Version 2 ready and waiting

Program 100003 Version 2 is not available

Examples

Use the rpcinfo command as follows to display all hosts on the local network that are running a certain version of a specific RPC server:

rpcinfo -b 100003 2

rpcinfo -b nfsprog 2

In these examples, the rpcinfo command lists all hosts that are running Version 2 of the NFS daemon.

Note: The version number is required for the -b parameter.

[Back: rpcgen Command]
[Next: The enum clnt_stat Structure]