setjmp.h 4.4 KB

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