get_Rx_errno(3N)

get_Rx_errno, set_Rx_errno -- get/set Rx_errno value

Synopsis

cc [options] file -lnsl

#include <rx.h>

long get_Rx_errno(void);

int set_Rx_errno(long value);

Description

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

The value of Rx_errno reflects an error resulting from a call to rexecve and related functions.

Usage

While get_Rx_errno and set_Rx_errno 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 later on.

Return values

get_Rx_errno returns the value of Rx_errno, or RXE_NOERRMEM in case it fails to allocate memory for the thread-specific copy of Rx_errno.

set_Rx_errno sets Rx_errno to value, and returns 0 for success and -1 for failure.

References

intro(2), intro(3N), get_Rx_cserrno(3N), rexecve(3N)