report RPC information
-b program version
-d program version
-s program version
-t host program
-u host program
rpcinfo makes an RPC call to an RPC server
and reports what it finds.
The options are as follows:
- Make an RPC broadcast to procedure 0 of the specified program and version using UDP and report all hosts that respond.
- Delete registration for the RPC service of the specified program and version. Registrations which point at ports numbered below 1024 can only be deleted by the superuser.
- Use portnum as the port number for the
-uoptions instead of the port number given by the portmapper.
- 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(1).
- Create a registration for the RPC service of the specified program and version, located at port port. Registrations which point at ports numbered below 1024 can only be created (or changed) by the superuser.
- Make an RPC call to procedure 0 of program on the specified host using TCP, and report whether a response was received.
- Make an RPC call to procedure 0 of program on the specified host using UDP, and report whether a response was received.
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
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 that are running the Yellow Pages service use:
$ rpcinfo -b ypserv 'version' |
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
RPC Programming Guide.