RPCINFO
Section: Maintenance Commands (8)
BSD mandoc
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
rpcinfo
makes an
RPC
call to an
RPC
server and reports what it finds.
OPTIONS
- -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).
- -u
-
Make an
RPC
call to procedure 0 of
program
on the specified
host
using
UDP
and report whether a response was received.
- -t
-
Make an
RPC
call to procedure 0 of
program
on the specified
host
using
TCP
and report whether a response was received.
- -n
-
Use
portnum
as the port number for the
-t
and
-u
options instead of the port number given by the portmapper.
- -b
-
Make an
RPC
broadcast to procedure 0 of the specified
program
and
version
using
UDP
and report all hosts that respond.
- -d
-
Delete registration for the
RPC
service of the specified
program
and
version
This option can be exercised only by the super-user.
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:
example% rpcinfo -p
To show all of the
RPC
services registered on the machine named
klaxon
use:
example% rpcinfo -p klaxon
To show all machines on the local net that are running the Yellow Pages
service use:
example% 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:
example% rpcinfo -d walld 1
SEE ALSO
rpc(5),
portmap(8)
-
"RPC Programming Guide"
BUGS
In releases prior to SunOS 3.0, the Network File System (NFS) did not
register itself with the portmapper;
rpcinfo
cannot be used to make
RPC
calls to the
NFS
server on hosts running such releases.
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- OPTIONS
-
- EXAMPLES
-
- SEE ALSO
-
- BUGS
-
This document was created by
man2html,
using the manual pages.
Time: 07:35:42 GMT, March 26, 2013