HP-UX Reference (11i v2 07/12) - 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 ver-
sion 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 procedure
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 message is
printed. Use of broadcasting should be limited because of the potential for adverse effect on
other systems.
264 Hewlett-Packard Company − 1 − HP-UX 11i Version 2: December 2007 Update