include/ucontext.h

   1 /* Copyright (C) 1997, 1998, 1999, 2000 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 /* The System V ABI user-level context switching support functions
  19    are marked obsolescent by SuSv3.  */
  20
  21 #ifndef _UCONTEXT_H
  22 #define _UCONTEXT_H     1
  23
  24 #include <features.h>
  25
  26 #ifdef __UCLIBC_HAS_CONTEXT_FUNCS__
  27
  28 /* Get machine dependent definition of data structures.  */
  29 #include <sys/ucontext.h>
  30
  31 __BEGIN_DECLS
  32
  33 /* Get user context and store it in variable pointed to by UCP.  */
  34 extern int getcontext (ucontext_t *__ucp) __THROWNL;
  35
  36 /* Set user context from information of variable pointed to by UCP.  */
  37 extern int setcontext (const ucontext_t *__ucp) __THROWNL;
  38
  39 /* Save current context in context variable pointed to by OUCP and set
  40    context from variable pointed to by UCP.  */
  41 extern int swapcontext (ucontext_t *__restrict __oucp,
  42                         const ucontext_t *__restrict __ucp) __THROWNL;
  43
  44 /* Manipulate user context UCP to continue with calling functions FUNC
  45    and the ARGC-1 parameters following ARGC when the context is used
  46    the next time in `setcontext' or `swapcontext'.
  47
  48    We cannot say anything about the parameters FUNC takes; `void'
  49    is as good as any other choice.  */
  50 extern void makecontext (ucontext_t *__ucp, void (*__func) (void),
  51                          int __argc, ...) __THROW;
  52
  53 __END_DECLS
  54
  55 #endif
  56
  57 #endif /* ucontext.h */