RPCINFO Messages

This chapter describes the messages issued by the RPCINFO program. It includes these sections:

• Message Format

Describes the standard format for messages issued by the RPCINFO program.

• RPCINFO Messages

Lists all RPCINFO messages.

Message Format

Messages have this format:

RPC###t dow mon dd hh:mm:ss yyyy text 

Syntax Description

###	Three-digit message number
t	One of these message types: I - Informative E - Error W - Warning D - Debug
dow	Day of the week
mon	Month of the year
dd	Date
hh	Hours
mm	Minutes
ss	Seconds
yyyy	Year
text	message text

RPCINFO Messages

This section lists the text of all RPCINFO messages in alphabetical order.

100I PROGRAM d_value1 VERSION d_value2 IS NOT AVAILABLE

RPCINFO finds that a particular RPC program is not available on a designated machine.

d_value1	RPC program number
d_value2	Version number of the RPC program in question

The difference between this message and message number 203 is that all communications worked with the portmapper--this message simply indicates that the RPC server is not executing on the selected machine.

101I PROGRAM d_value1 VERSION d_value2 is READY AND WAITING

The selected RPC server is running and ready for requests on the selected host.

d_value1	RPC program number
d_value2	Version number of the RPC program in question

102I NO REMOTE PROGRAMS REGISTERED

Explanation    The selected host does not have any RPC servers registered with its local portmapper daemon.

103I COULD NOT DELETE REGISTRATION FOR PROGRAM d_value1 VERSION d_value2

When trying to delete the registration of an RPC service with the local portmapper, the request was ignored by the portmapper because the service for the requested version of the requested was not currently registered.

d_value1	RPC program number
d_value2	Version number of the RPC program in question

105I - 106I 105I number version protocol portname
106I d_value1 d_value2 string1 d_value3 string2

RPCINFO requests a dump of a selected portmapper's registration tables.

d_value1	RPC program number
d_value2	Version number
string1	Either UDP or TCP, or the protocol number of the selected service
d_value3	Port number on which the service is listening for requests
string2	Either blank if the service is not known to the DNR, or else the name of the service as known by the DNR

107I-110I 107I RPCINFO PROTO(protocol) HOST(hostname) PROG(prognum) {VERS(versnum)}
    {PORT(portnum)} {SYSID(subsystem_id)}
108I RPCINFO HOST(hostname) {SYSID(subsystem_id)}
110I RPCINFO DELETE PROG(prognum) VERS(vers_num) {SYSID(subsystem_id)}

Explanation    These messages are issued when the RPCINFO program is called with invalid parameters.

Recommended Action    Reissue the command with the proper parameter configuration.

200E COULD NOT LOCATE LOCALHOST name

Explanation    The RPCINFO program could not locate the local host's name using DNR.

201E UDP SOCKET

Explanation    RPCINFO could not open a UDP socket. This message is issued by perror() to provide more information as to the cause of the failure.

202E PROGRAM d_value IS NOT AVAILABLE

Explanation    RPCINFO finds that a particular RPC program is not available on a designated machine. The d_value is the RPC program number.

203E PROGRAM d_value1 VERSION d_value2 IS NOT AVAILABLE

d_value1	RPC program number
d_value2	Version number of the RPC program in question

Explanation    RPCINFO finds that a particular RPC program is not available on a designated machine.

204E CAN'T CONTACT PORTMAPPER

Explanation    RPCINFO could not properly communicate with the selected host's portmapper.

Recommended Action    Ensure that the selected host is running a portmapper daemon.

207E string IS UNKNOWN RPC SERVICE

Explanation    When trying to look up the name or program number of an RPCINFO program, the name or number could not be located. The string is the value of the entity being requested.

208E string IS UNKNOWN HOST

Explanation    The DNR could not locate the Internet address for a host. The string is the name of the host.

210E EXITING DUE TO PREVIOUS ERROR

Explanation    When a fatal error is detected by RPCINFO, this error follows an error message that provides more detailed information about the error. The RPCINFO program exits with a return code of 16 instead of 0 (a normal exit return code).

2xxE CAN'T CONTACT PORTMAPPER

Explanation    RPCINFO could not properly communicate with the selected host's portmapper. This message is formatted by clnt_pcreateerror() before it is issued.

Recommended Action    Ensure that the selected host is running a portmapper daemon.

2xxE TCP CREATE

Explanation    RPCINFO could not create a TCP client RPC handle. The message is formatted by clnt_pcreateerror() before it is issued by the default rpclog() module. The message number 2xx is replaced with the sum of 250 plus the RPC library error number.

2xxE UDP CREATE

Explanation    RPCINFO could not create a UDP client RPC handle. The message is formatted by clnt_pcreateerror() before it is issued by the default rpclog() module. The message number 2xx is replaced with the sum of 250 plus the RPC library error number.