HP-UX Reference (11i v2 03/08) - 1M System Administration Commands N-Z (vol 4)

r
rpcinfo(1M) rpcinfo(1M)
NAME
rpcinfo - report RPC information
SYNOPSIS
rpcinfo [ -m ][-s
][host ]
rpcinfo -p [ host ]
rpcinfo -T transport host prognum [ versnum ]
rpcinfo -l [ -T transport ] host prognum [ versnum ]
rpcinfo [ -n portnum ] -u
host prognum [ versnum ]
rpcinfo [ -n portnum ] -t
host prognum [ versnum ]
rpcinfo -a serv_address -T transport prognum [ versnum ]
rpcinfo -b [ -T transport ] prognum versnum
rpcinfo -d [ -T transport ] prognum versnum
DESCRIPTION
rpcinfo makes an RPC call to an RPC server and reports what it finds.
In the first synopsis,
rpcinfo lists all the registered RPC services with rpcbind on host.Ifhost is
not specified, the local host is the default. If
-s is used, the information is displayed in a concise format.
In the second synopsis,
rpcinfo lists all the RPC services registered with rpcbind, version 2. Also
note that the format of the information is different in the first and the second synopsis. This is because
the second synopsis is an older protocol used to collect the information displayed (version 2 of the
rpcbind protocol).
The third synopsis makes an RPC call to procedure
0 of prognum and versnum on the specified host and
reports whether a response was received. transport is the transport which has to be used for contacting
the given service. The remote address of the service is obtained by making a call to the remote
rpcbind.
The prognum argument is a number that represents an RPC program number (see rpc(4)).
If a versnum is specified,
rpcinfo attempts to call that version of the specified prognum.Otherwise,
rpcinfo attempts to find all the registered version numbers for the specified prognum 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 that the
version number is required for -b and -d options.
The other ways of using
rpcinfo are described in the EXAMPLES section.
Options
-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, the transport in the netconfig(4) database is used. This is a generic
option, and can be used in conjunction with other options as shown in the SYNOPSIS.
-a serv_address
Use serv_address as the (universal) address for the service on transport to ping pro-
cedure 0 of the specified prognum and report whether a response was received. The -T
option is required with the -a option.
If versnum is not specified,
rpcinfo tries to ping all available version numbers for that
program number. This option avoids calls to remote rpcbind to find the 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 prognum and versnum and
report all hosts that respond. If transport is specified, it broadcasts its request only on
the specified transport. If broadcasting is not supported by any transport, an error mes-
sage is printed. Use of broadcasting should be limited because of the potential for
adverse effect on other systems.
HP-UX 11i Version 2: August 2003 − 1 − Hewlett-Packard Company Section 1M−−699