rpcinfo

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

DESCRIPTION

The rpcinfo(1) utility makes a remote procedure call (RPC) to an RPC server and reports what it finds.

OPTIONS

-p

Probe the port mapper 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 User Datagram Protocol (UDP), and report whether a response was received.

-t

Make an RPC call to procedure 0 of program on the specified host using transmission control protocol (TCP), and report whether a response was received.

-n portnum

Use portnum as the port number for the -t and -u options instead of the port number given by the port mapper.

-b

Make an RPC broadcast to procedure 0 of the specified program and version using UDP, and report all hosts that respond. The version number is required for this option.

-d

Delete registration for the RPC service of the specified program and version. The version number is required for this option.

The program argument can be either a name or a number.

If a version is specified, rpcinfo(1) attempts to call that version of the specified program. Otherwise, rpcinfo(1) 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(1) attempts to obtain this information by calling an extremely high version number instead) and attempts to call each registered version. The version number is required for -b and -d options.

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 computer named klaxon use:

$ rpcinfo -p klaxon

To show all computers on the local net that are running the Yellow Pages service use:

$ rpcinfo -b ypserv 'version' | uniq

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

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

$ rpcinfo -d walld 1

SEE ALSO

rpc(5)

RPC Programming Guide