get_Rx_errno(3N)                                    get_Rx_errno(3N)


       NAME
             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 Pvalue);

       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.

          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.

       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.

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














                           Copyright 1994 Novell, Inc.               Page 1