get_Rx_cserrno(3N)

get_Rx_cserrno, set_Rx_cserrno -- get/set Rx_cserrno value

Synopsis

cc [options] file -lnsl

#include <rx.h>
#include <cs.h>

int get_Rx_cserrno(void);

int set_Rx_cserrno(int value);

Description

The functions get_Rx_cserrno and set_Rx_cserrno retrieve and set the value of Rx_cserrno in multi-threaded programs. These functions are needed in multi-threaded environments because each thread keeps its own copy of Rx_cserrno.

After a failed call to rexecve, if Rx_errno is set to RXE_CONNPROB, then the value of Rx_cserrno indicates the specific connection server problem.

Usage

While get_Rx_cserrno and set_Rx_cserrno are designed for use in multi-threaded applications, they are available for use in non-reentrant code, and may be incorporated if a need is anticipated to convert to reentrant code at a later date.

Return values

get_Rx_cserrno returns the value of Rx_cserrno, or -1 in case of error.

set_Rx_cserrno sets Rx_cserrno to value, and returns 0 for success and -1 for failure.

References

cs(1Mbnu), intro(2), intro(3N), cs_connect(3N), get_Rx_errno(3N), rexecve(3N)