clnt_sperror()

Format

#include <rpc.h>
 
char *
clnt_sperror(clnt, s)
CLIENT *clnt;
char *s;

Parameters

clnt: Indicates the pointer to a client handle that was previously obtained using clnt_create(), clntudp_create(), clnttcp_create(), or clntraw_create().
s: Indicates a null or null-terminated character string. If s is nonnull, clnt_sperror() prints the string s followed by a colon, followed by a space, followed by the error message, and terminated with a new line. If s is null or points to a null string, just the error message and the new line are output.

Usage

The clnt_sperror() call returns the address of a message indicating why an RPC failed. This procedure should be used after clnt_call(), if there is an error.

Return codes

Pointer to a character string ending with a new line.

Context

clnt_call()
clnt_create()
clnt_geterr()
clnt_pcreateerror()
clnt_perrno()
clnt_perror()
clnt_spcreateerror()
clnt_sperrno()
clntraw_create()
clnttcp_create()
clntudp_create()