View Source: longjmp(3) - Waikato Linux Users Group

Edit PageHistory Diff Info LikePages

LONGJMP
!!!LONGJMP
NAME
SYNOPSIS
DESCRIPTION
RETURN VALUE
CONFORMING TO
NOTES
SEE ALSO
----
!!NAME


longjmp, siglongjmp - non-local jump to a saved stack context
!!SYNOPSIS


__#include __


void longjmp(jmp_buf ''env''__, int__ ''val''__);
void siglongjmp(sigjmp_buf__ ''env''__, int__ ''val''__);
__
!!DESCRIPTION


__longjmp()__ and __setjmp()__ are useful for dealing
with errors and interrupts encountered in a low-level
subroutine of a program. __longjmp()__ restores the
environment saved by the last call of __setjmp()__ with
the corresponding ''env'' argument. After
__longjmp()__ is completed, program execution continues
as if the corresponding call of __setjmp()__ had just
returned the value ''val''. __longjmp()__ cannot cause
0 to be returned. If longjmp is invoked with a second
argument of 0, 1 will be returned instead.


__siglongjmp()__ is similar to __longjmp()__ except
for the type of its ''env'' argument. If the
__sigsetjmp()__ call that set this ''env'' used a
nonzero ''savesigs'' flag, __siglongjmp()__ also
restores the set of blocked signals.
!!RETURN VALUE


These functions never return.
!!CONFORMING TO


POSIX
!!NOTES


POSIX does not specify whether __longjmp__ will restore
the signal context. If you want to save and restore signal
masks, use __siglongjmp__.


__longjmp()__ and __siglongjmp()__ make programs hard
to understand and maintain. If possible an alternative
should be used.
!!SEE ALSO


setjmp(3), sigsetjmp(3)
----

7 pages link to longjmp(3):

This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.

Last edited on Tuesday, June 4, 2002 12:24:27 am by "perry"

Edit PageHistory Diff Info LikePages