Technical Reference: Communications, Volume 1

clnt_perrno Subroutine

Purpose

Specifies the condition of the stat parameter.

Syntax

#include <rpc/rpc.h>

void clnt_perrno ( stat) enum clnt_stat stat;

Description

The clnt_perrno subroutine writes a message to standard error output, corresponding to the condition specified by the stat parameter.

This subroutine is used after a callrpc subroutine fails. The clnt_perrno subroutine translates the failure status (the enum clnt_stat subroutine) into a message.

If the program does not have a standard error output, or the programmer does not want the message to be output with the printf subroutine, or the message format used is different from that supported by the clnt_perrno subroutine, then the clnt_sperrno subroutine is used instead of the clnt_perrno subroutine.

Parameters

stat

Specifies the client error status of the remote procedure call.

Return Values

The clnt_perrno subroutine translates and displays the following enum clnt_stat error status codes:

RPC_SUCCESS = 0	Call succeeded.
RPC_CANTENCODEARGS = 1	Cannot encode arguments.
RPC_CANTDECODERES = 2	Cannot decode results.
RPC_CANTSEND = 3	Failure in sending call.
RPC_CANTRECV = 4	Failure in receiving result.
RPC_TIMEDOUT = 5	Call timed out.

Implementation Specifics

This subroutine is part of Base Operating System (BOS) Runtime.

Related Information

The callrpc subroutine, clnt_sperrno subroutine.

List of RPC Programming References.

Remote Procedure Call (RPC) Overview for Programming in AIX 5L Version 5.1 Communications Programming Concepts.