_longjmp(3C)						   Standard C Library Functions 					      _longjmp(3C)

NAME

       _longjmp, _setjmp - non-local goto

SYNOPSIS

       #include <setjmp.h>

       void _longjmp(jmp_buf env, int val);

       int _setjmp(jmp_buf env);

DESCRIPTION

       The  _longjmp()	and  _setjmp()	functions  are identical to longjmp(3C) and setjmp(3C), respectively, with the additional restriction that
       _longjmp() and _setjmp() do not manipulate the signal mask.

       If _longjmp() is called even though env was never initialized by a call to _setjmp(), or when the last such call was in a function that has
       since returned, the results are undefined.

RETURN VALUES

       Refer to longjmp(3C) and setjmp(3C).

ERRORS

       No errors are defined.

USAGE

       If  _longjmp()  is  executed  and  the environment in which _setjmp() was executed no longer exists, errors can occur. The conditions under
       which the environment of the _setjmp() no longer exists include exiting the function that contains the _setjmp() call, and exiting an inner
       block with temporary storage. This condition might not be detectable, in which case the _longjmp() occurs and, if the environment no longer
       exists, the contents of the temporary storage of an inner block are unpredictable. This condition might also cause unexpected process  ter-
       mination. If the function has returned, the results are undefined.

       Passing longjmp() a pointer to a buffer not created by setjmp(), passing _longjmp() a pointer to a buffer not created by _setjmp(), passing
       siglongjmp(3C) a pointer to a buffer not created by sigsetjmp(3C) or passing any of these three functions a buffer that has  been  modified
       by the user can cause all the problems listed above, and more.

       The  _longjmp()	and _setjmp() functions are included to support programs written to historical system interfaces.  New applications should
       use siglongjmp(3C) and sigsetjmp(3C) respectively.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |ATTRIBUTE TYPE		     |ATTRIBUTE VALUE		   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Standard			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       longjmp(3C), setjmp(3C), siglongjmp(3C), sigsetjmp(3C), attributes(5), standards(5)

SunOS 5.11							    24 Jul 2002 						      _longjmp(3C)