The Open Group Base Specifications Issue 7
IEEE Std 1003.1, 2013 Edition
Copyright © 2001-2013 The IEEE and The Open Group

#### NAME

> siglongjmp - non-local goto with signal handling

#### SYNOPSIS

> ``[CX] #include <setjmp.h>
> void siglongjmp(sigjmp_buf` env`, int` val`);``
> `
> `

#### DESCRIPTION

> The siglongjmp() function shall be equivalent to the longjmp() function, except as follows:

> - References to setjmp() shall be equivalent to sigsetjmp().

> - The siglongjmp() function shall restore the saved signal mask if and only if the env argument was initialized by a call to sigsetjmp() with a non-zero savemask argument.

#### RETURN VALUE

> After siglongjmp() is completed, program execution shall continue as if the corresponding invocation of sigsetjmp() had just returned the value specified by val. The siglongjmp() function shall not cause sigsetjmp() to return 0; if val is 0, sigsetjmp() shall return the value 1.

#### ERRORS

> No errors are defined.

The following sections are informative.

#### EXAMPLES

> None.

#### APPLICATION USAGE

> The distinction between setjmp() or longjmp() and sigsetjmp() or siglongjmp() is only significant for programs which use sigaction(), sigprocmask(), or sigsuspend().

#### RATIONALE

> None.

#### FUTURE DIRECTIONS

> None.

#### SEE ALSO

> longjmp, pthread_sigmask, setjmp, sigsetjmp, sigsuspend

> XBD <setjmp.h>

#### CHANGE HISTORY

> First released in Issue 3. Included for alignment with the ISO POSIX-1 standard.

#### Issue 5

> The DESCRIPTION is updated for alignment with the POSIX Threads Extension.

#### Issue 6

> The DESCRIPTION is rewritten in terms of longjmp().

> The SYNOPSIS is marked CX since the presence of this function in the <setjmp.h> header is an extension over the ISO C standard.

End of informative text.

return to top of page

UNIX ® is a registered Trademark of The Open Group.
POSIX ® is a registered Trademark of The IEEE.
Copyright © 2001-2013 The IEEE and The Open Group, All Rights Reserved
[ Main Index | XBD | XSH | XCU | XRAT ]