rpcinfo(1M) MISC. REFERENCE MANUAL PAGES rpcinfo(1M)
NAME
rpcinfo - report RPC information
SYNOPSIS
rpcinfo [host]
rpcinfo -p [host]
rpcinfo -T transport 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
rpcinfo makes an RPC call to an RPC server and reports what
it finds. In the first synopsis, it lists all the
registered RPC services with rpcbind on host. If host is
not specified, it defaults to the local host. In the second
synopsis, it lists all the RPC services registered with
portmapper. Also note that the format of the information is
different in the first and the second synopsis; this is
because in the first case, rpcbind (version 3) is contacted,
while in the second case portmap (version 2) is contacted
for information. The third synopsis makes an RPC call to
procedure 0 of program and version on the specified host and
reports whether a response was received. transport is the
transport which has to be used for contacting the given ser-
vice. The remote address of the service is obtained by mak-
ing a call to remote rpcbind. The other ways of using
rpcinfo are described below. See EXAMPLES. The following
options are available:
-T transport Specify 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, except the
-b option.
-a serv_address
Use serv_address as the (universal) address
for the service on transport, to ping pro-
cedure 0 of the specified program and report
whether a response was received. The use of
-T option is required with -a option.
If version number 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
Last change: 1
rpcinfo(1M) MISC. REFERENCE MANUAL PAGES rpcinfo(1M)
address of the service. The serv_address is
specified in universal address format of the
given transport.
-b Make an RPC broadcast to procedure 0 of the
specified program and version and report all
hosts that respond. If transport is speci-
fied, it broadcasts its request only on the
transport specified through transport. If
broadcasting is not supported by any tran-
sport, an error message is printed. Only UDP
transports support broadcasting.
-d Delete registration for the RPC service of
the specified program and version. If tran-
sport is specified, unregister the service on
only that transport, otherwise unregister the
services on all the transports on which it
was registered. This option can be exercised
only by the privileged user.
-n Use portnum as the port number for the -t and
-u options instead of the port number given
by the portmapper. Use of this option avoids
a call to the remote portmapper to find out
the address of the service.
-p Probe the portmapper on host, and print a
list of all registered RPC programs. If host
is not specified, it defaults to the local
host.
-t Make an RPC call to procedure 0 of program on
the specified host using TCP, and report
whether a response was received.
-u 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 is a number. If a version is speci-
fied, 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.
Last change: 2
rpcinfo(1M) MISC. REFERENCE MANUAL PAGES rpcinfo(1M)
EXAMPLES
To show all of the RPC services registered on the local
machine use:
$ rpcinfo To show all of the RPC services registered
with rpcbind on the machine named klaxon use:
$ rpcinfo klaxon To show if the RPC service with pro-
gram number prog_no and version vers is registered on
the machine named klaxon for the transport tcp use:
$ rpcinfo -T tcp klaxon prog_no vers To show all of the
RPC services registered with the portmapper on the
local machine use:
$ rpcinfo -p
To ping version 2 of rpcbind (program number 100000) on host
sparky:
$ rpcinfo -t sparky 100000 2
To delete the registration for version 1 of the walld (pro-
gram number 100008) service for all transports use:
# rpcinfo -d 100008 1
SEE ALSO
rpcbind(1M), rpc(4).
Last change: 3