RPCINFO(8) - System Manager’s Manual #
RPCINFO(8) - System Manager’s Manual
NAME #
rpcinfo - report RPC information
SYNOPSIS #
rpcinfo
-b program version
rpcinfo
-d program version
rpcinfo
-p [host]
rpcinfo
-s program version port
rpcinfo
[-n portnum]
-t host program
[version]
rpcinfo
[-n portnum]
-u host program
[version]
DESCRIPTION #
rpcinfo
makes an
RPC
call to an
RPC
server and reports what it finds.
The options are as follows:
-b
Make an
RPC
broadcast to procedure 0 of the specified program and version usingUDP
and report all hosts that respond.
-d
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.
-n portnum
Use portnum as the port number for the -t and -u options instead of the port number given by the portmapper.
-p
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).
-s
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.
-t
Make an
RPC
call to procedure 0 of program on the specified host usingTCP
, and report whether a response was received.
-u
Make an
RPC
call to procedure 0 of program on the specified host usingUDP
, 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 -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 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' | 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 Programming Guide.
OpenBSD 7.5 - July 21, 2017