NAME

rpcinfo − report RPC information

SYNOPSIS

/usr/etc/rpcinfo -p [host]
/usr/etc/rpcinfo [-n portnum] -u host program [version]
/usr/etc/rpcinfo [-n portnum] -t host program [version]
/usr/etc/rpcinfo -b program version
/usr/etc/rpcinfo -d program version

DESCRIPTION

rpcinfo makes an RPC call to an RPC server and reports what it finds. 

Options

rpcinfo recognizes the following command-line options

-p host 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 (see hostname(1)).

-n portnum Use portnum as the port number for the -t and -u options instead of the port number given by the portmapper. 

-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. 

-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. Only users with appropriate privileges can use this option.

program Can be either a name or a number. 

version If 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, then attempts to call each registered version.  (Version 0 is presumed to not exist, but if version 0 does exist, rpcinfo attempts to obtain the version number information by calling an extremely high version number instead.)  Note that version must be specifed when the -b and -d options are used. 

EXAMPLES

Show all of the RPC services registered on the local machine:

rpcinfo -p

Show all of the RPC services registered on the machine named klaxon:

rpcinfo -p klaxon

Show all machines on the local net that are running the Network Information Service ( NIS ):

rpcinfo -b ypserv 1 | sort | uniq

where 1 is the current NIS version obtained from the results of the -p option in the previous example. 

Delete the registration for version 1 of the walld service:

rpcinfo -d walld 1

[Note that walld is the RPC program name for rwalld (see rwalld(1m))].

WARNINGS

In releases prior to Sun UNIX 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.  Note that this does not apply to any HP releases of NFS. 

AUTHOR

rpcinfo was developed by Sun Microsystems, Inc. 

FILES

/etc/rpcnames for RPC program numbers

SEE ALSO

rpc(4), portmap(1M),
Programming and Protocols for NFS Services.

INTERNATIONAL SUPPORT

8-bit data, 16-bit data, messages

Hewlett-Packard Company  —  HP-UX Release 9.0: August 1992