rpcinfo(1tcp)

rpcinfo -- report RPC information

Synopsis

rpcinfo [-ms] [host]

rpcinfo -p [host]

rpcinfo -T transport host program [version]

rpcinfo -l host program version

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

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

rpcinfo -a serv_address -T transport program [version]

rpcinfo -b [-T transport] program version

rpcinfo -d [-T transport] program version

Description

The rpcinfo command makes an RPC call to an RPC server and reports what it finds.

Options

rpcinfo takes the following options:

-T transport: Specifies the transport on which the service is required. If this option is not specified, rpcinfo uses the transport specified in the NETPATH environment variable, or if that is unset or null, in the netconfig database. This is a generic option and can be used in conjunction with any other option. If it is used with the -b option, however, it will succeed only with a transport that supports broadcasting.
-a serv_address: Use serv_address as the (universal) address for the service on transport, ping(1Mtcp) procedure 0 of the specified program, and report whether a response was received. The use of the -T option is required with the -a option.
If version is not specified, rpcinfo tries to ping all the available version numbers for that program number. This option avoids calls to remote rpcbind to find the address of the service. serv_address is specified in the universal address format of the given transport.
-b: Make an RPC broadcast to procedure 0 of program with version number version and report all hosts that respond. If transport is specified, rpcinfo broadcasts its request only on that transport. If broadcasting is not supported by transport, an error message is printed. Only UDP transports support broadcasting.
-d: Delete registration for the RPC service of the specified program and version. If transport is specified, unregister the service on only that transport, otherwise unregister the service on all the transports on which it was registered. This option can be exercised only by a privileged user.
-l: Limit display to information about the specified program and version on the specified host.
-m: Display information about rpcbind operation on the specified host.
-n portnum: Use portnum as the port number for the -t and -u options instead of the port number given by the port map. Use of this option avoids a call to the remote port map to find out the address of the service.
-p: Probe the port map on host, and print a list of all registered RPC programs. If host is not specified, rpcinfo defaults to the local host.
-s: Shorten display by giving all information about each program on a single line.
-t: Make an RPC call to procedure 0 of program on the specified host, using TCP; report whether a response was received.
-u: Make an RPC call to procedure 0 of program on the specified host, using UDP; report whether a response was received.

The program argument is a number.

The version number is required for -b, -d, and -l options. When a version is specified, rpcinfo attempts to call that version of program. If version is not specified, rpcinfo attempts to find all the registered version numbers for the specified program by calling version 0, which is presumed not to exist. If version 0 exists, rpcinfo attempts to find all program's registered version numbers by calling an extremely high version number instead, and then attempts to call each registered version.

Usage

In the first synopsis, rpcinfo lists all RPC services registered with rpcbind on host. If host is not specified, rpcinfo defaults to the local host.

In the second synopsis, or if rpcinfo cannot contact rpcbind, rpcinfo lists all RPC services registered with the port mapper portmap. The format in which the information is printed is different for the first and second synopses since the first gets its information from rpcbind (version 3) and the second from portmap (version 2).

The third synopsis makes an RPC call to procedure 0 of program with version number version on host and reports whether a response was received. transport is the transport which is to be used for contacting the service. The remote address of the service is obtained by making a call to remote rpcbind.

References

rpcbind(1Mtcp), rpc(4tcp)

Examples

Print all RPC services registered on the local machine:

rpcinfo

Print all RPC services registered with rpcbind on the machine named klaxon:

rpcinfo klaxon

To find out if the RPC service with program number prog_no and version vers is registered on machine klaxon for the transport tcp:

rpcinfo -T tcp klaxon prog_no vers

Print all RPC services registered with the port map on the local machine:

rpcinfo -p

ping version 2 of rpcbind (program number 100000) on host sparky:

rpcinfo -t sparky 100000 2

Delete the registration for version 1 of the walld service (program number 100008) for all transports (this option requires privileged access):

rpcinfo -d 100008 1