rpcinfo(1M) ONC/NFS 5.4R3.00 rpcinfo(1M)
NAME
rpcinfo - report RPC information
SYNOPSIS
/etc/rpcinfo -p [ host ]
/etc/rpcinfo [ -n portnum ] -u host program [ version ]
/etc/rpcinfo [ -n portnum ] -t host program [ version ]
/etc/rpcinfo -b program version
/etc/rpcinfo -d program version
DESCRIPTION
The rpcinfo command, which is located in /etc, 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
superuser.
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% /etc/rpcinfo -p
Licensed material--property of copyright holder(s) 1
rpcinfo(1M) ONC/NFS 5.4R3.00 rpcinfo(1M)
To show all of the RPC services registered on the machine named
klaxon use:
example% /etc/rpcinfo -p klaxon
To show all machines on the local net that are running the Network
Information Service service use:
example% /etc/rpcinfo -b ypserv 'version' | uniq
where 'version' is the current Network Information Service version
obtained from the results of the -p switch above.
To delete the registration for version 1 of the walld service use:
example% /etc/rpcinfo -d walld 1
SEE ALSO
portmap(1M), rpc(4).
Managing ONC/NFS and Its Facilities on the DG/UX System
BUGS
In releases prior to NFSSRC 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.
Licensed material--property of copyright holder(s) 2