include/setjmp.h

   1 /* Copyright (C) 1991-1999,2001,2002,2007,2009 Free Software Foundation, Inc.
   2    This file is part of the GNU C Library.
   3
   4    The GNU C Library is free software; you can redistribute it and/or
   5    modify it under the terms of the GNU Lesser General Public
   6    License as published by the Free Software Foundation; either
   7    version 2.1 of the License, or (at your option) any later version.
   8
   9    The GNU C Library is distributed in the hope that it will be useful,
  10    but WITHOUT ANY WARRANTY; without even the implied warranty of
  11    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  12    Lesser General Public License for more details.
  13
  14    You should have received a copy of the GNU Lesser General Public
  15    License along with the GNU C Library; if not, see
  16    <http://www.gnu.org/licenses/>.  */
  17
  18 /*
  19  *      ISO C99 Standard: 7.13 Nonlocal jumps   <setjmp.h>
  20  */
  21
  22 #ifndef _SETJMP_H
  23 #define _SETJMP_H       1
  24
  25 #include <features.h>
  26
  27 __BEGIN_DECLS
  28
  29 #include <bits/setjmp.h>                /* Get `__jmp_buf'.  */
  30 #include <bits/jmp_buf_tag.h>
  31
  32 __BEGIN_NAMESPACE_STD
  33
  34 typedef struct __jmp_buf_tag jmp_buf[1];
  35
  36 /* Store the calling environment in ENV, also saving the signal mask.
  37    Return 0.  */
  38 extern int setjmp (jmp_buf __env) __THROWNL;
  39
  40 __END_NAMESPACE_STD
  41
  42 /* Store the calling environment in ENV, also saving the
  43    signal mask if SAVEMASK is nonzero.  Return 0.
  44    This is the internal name for `sigsetjmp'.  */
  45 extern int __sigsetjmp (struct __jmp_buf_tag __env[1], int __savemask)
  46     __THROWNL;
  47
  48 /* Store the calling environment in ENV, not saving the signal mask.
  49    Return 0.  */
  50 extern int _setjmp (struct __jmp_buf_tag __env[1]) __THROWNL;
  51
  52 /* Do not save the signal mask.  This is equivalent to the `_setjmp'
  53    BSD function.  */
  54 #define setjmp(env)     _setjmp (env)
  55
  56 __BEGIN_NAMESPACE_STD
  57
  58 /* Jump to the environment saved in ENV, making the
  59    `setjmp' call there return VAL, or 1 if VAL is 0.  */
  60 extern void longjmp (struct __jmp_buf_tag __env[1], int __val)
  61      __THROWNL __attribute__ ((__noreturn__));
  62
  63 __END_NAMESPACE_STD
  64
  65 #if defined __USE_BSD || defined __USE_XOPEN
  66 /* Same.  Usually `_longjmp' is used with `_setjmp', which does not save
  67    the signal mask.  But it is how ENV was saved that determines whether
  68    `longjmp' restores the mask; `_longjmp' is just an alias.  */
  69 extern void _longjmp (struct __jmp_buf_tag __env[1], int __val)
  70      __THROWNL __attribute__ ((__noreturn__));
  71 #endif
  72
  73
  74 #ifdef  __USE_POSIX
  75 /* Use the same type for `jmp_buf' and `sigjmp_buf'.
  76    The `__mask_was_saved' flag determines whether
  77    or not `longjmp' will restore the signal mask.  */
  78 typedef struct __jmp_buf_tag sigjmp_buf[1];
  79
  80 /* Store the calling environment in ENV, also saving the
  81    signal mask if SAVEMASK is nonzero.  Return 0.  */
  82 # define sigsetjmp(env, savemask)       __sigsetjmp (env, savemask)
  83
  84 /* Jump to the environment saved in ENV, making the
  85    sigsetjmp call there return VAL, or 1 if VAL is 0.
  86    Restore the signal mask if that sigsetjmp call saved it.
  87    This is just an alias `longjmp'.  */
  88 extern void siglongjmp (sigjmp_buf __env, int __val)
  89      __THROWNL __attribute__ ((__noreturn__));
  90 #endif /* Use POSIX.  */
  91
  92 __END_DECLS
  93
  94 #ifdef _LIBC
  95 extern void __longjmp(__jmp_buf __env, int __val) __THROWNL attribute_noreturn;
  96 libc_hidden_proto(__longjmp)
  97 extern void __libc_longjmp(struct __jmp_buf_tag __env[1], int __val)
  98   __THROWNL attribute_noreturn;
  99 extern void __libc_siglongjmp(sigjmp_buf __env, int __val)
 100   __THROWNL attribute_noreturn;
 101 extern void _longjmp_unwind(jmp_buf __env, int __val);
 102 libc_hidden_proto(_longjmp_unwind)
 103 extern int __sigjmp_save(sigjmp_buf __env, int __savemask) attribute_hidden;
 104 /* We use the normal longjmp for unwinding */
 105 # define __libc_unwind_longjmp(buf, val) __libc_longjmp(buf, val)
 106 #endif
 107
 108 #endif /* setjmp.h  */