The Open Group Base Specifications Issue 8
IEEE Std 1003.1-2024
Copyright © 2001-2024 The IEEE and The Open Group

NAME

siglongjmp — non-local goto with signal handling

SYNOPSIS

[CX] [Option Start] #include <setjmp.h>

_Noreturn void siglongjmp(sigjmp_buf
env, int val); [Option End]

DESCRIPTION

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

RETURN VALUE

After siglongjmp() is completed, thread 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.

Issue 8

Austin Group Defect 1302 is applied, adding _Noreturn to the SYNOPSIS.

End of informative text.

 

return to top of page

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