ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/libcoro/coro.h
(Generate patch)

Comparing libcoro/coro.h (file contents):
Revision 1.38 by root, Fri Nov 14 05:27:08 2008 UTC vs.
Revision 1.45 by root, Mon May 30 02:21:54 2011 UTC

1/* 1/*
2 * Copyright (c) 2001-2008 Marc Alexander Lehmann <schmorp@schmorp.de> 2 * Copyright (c) 2001-2009 Marc Alexander Lehmann <schmorp@schmorp.de>
3 * 3 *
4 * Redistribution and use in source and binary forms, with or without modifica- 4 * Redistribution and use in source and binary forms, with or without modifica-
5 * tion, are permitted provided that the following conditions are met: 5 * tion, are permitted provided that the following conditions are met:
6 * 6 *
7 * 1. Redistributions of source code must retain the above copyright notice, 7 * 1. Redistributions of source code must retain the above copyright notice,
64 * coro_create now allows one to create source coro_contexts. 64 * coro_create now allows one to create source coro_contexts.
65 * do not rely on makecontext passing a void * correctly. 65 * do not rely on makecontext passing a void * correctly.
66 * try harder to get _setjmp/_longjmp. 66 * try harder to get _setjmp/_longjmp.
67 * major code cleanup/restructuring. 67 * major code cleanup/restructuring.
68 * 2008-11-10 the .cfi hacks are no longer needed. 68 * 2008-11-10 the .cfi hacks are no longer needed.
69 * 2008-11-16 work around a freebsd pthread bug.
70 * 2008-11-19 define coro_*jmp symbols for easier porting.
71 * 2009-06-23 tentative win32-backend support for mingw32 (Yasuhiro Matsumoto).
72 * 2010-12-03 tentative support for uclibc (which lacks all sorts of things).
73 * 2011-05-30 set initial callee-saved-registers to zero with CORO_ASM.
69 */ 74 */
70 75
71#ifndef CORO_H 76#ifndef CORO_H
72#define CORO_H 77#define CORO_H
78
79#if __cplusplus
80extern "C" {
81#endif
73 82
74#define CORO_VERSION 2 83#define CORO_VERSION 2
75 84
76/* 85/*
77 * Changes since API version 1: 86 * Changes since API version 1:
115 * SGI's version of Microsoft's NT ;) 124 * SGI's version of Microsoft's NT ;)
116 * 125 *
117 * -DCORO_ASM 126 * -DCORO_ASM
118 * 127 *
119 * Handcoded assembly, known to work only on a few architectures/ABI: 128 * Handcoded assembly, known to work only on a few architectures/ABI:
120 * ELF Linux x86 && amd64 when gcc is used and optimisation is turned on. 129 * GCC + x86/IA32 and amd64/x86_64 + GNU/Linux and a few BSDs.
121 * 130 *
122 * -DCORO_PTHREAD 131 * -DCORO_PTHREAD
123 * 132 *
124 * Use the pthread API. You have to provide <pthread.h> and -lpthread. 133 * Use the pthread API. You have to provide <pthread.h> and -lpthread.
134 * This is likely the slowest backend, and it also does not support fork(),
135 * so avoid it at all costs.
125 * 136 *
126 * If you define neither of these symbols, coro.h will try to autodetect 137 * If you define neither of these symbols, coro.h will try to autodetect
127 * the model. This currently works for CORO_LOSER only. For the other 138 * the model. This currently works for CORO_LOSER only. For the other
128 * alternatives you should check (e.g. using autoconf) and define the 139 * alternatives you should check (e.g. using autoconf) and define the
129 * following symbols: HAVE_UCONTEXT_H / HAVE_SETJMP_H / HAVE_SIGALTSTACK. 140 * following symbols: HAVE_UCONTEXT_H / HAVE_SETJMP_H / HAVE_SIGALTSTACK.
236# define _XOPEN_UNIX 1 247# define _XOPEN_UNIX 1
237# endif 248# endif
238 249
239# include <setjmp.h> 250# include <setjmp.h>
240 251
252# if _XOPEN_UNIX > 0 || defined (_setjmp)
253# define coro_jmp_buf jmp_buf
254# define coro_setjmp(env) _setjmp (env)
255# define coro_longjmp(env) _longjmp ((env), 1)
256# elif CORO_LOSER
257# define coro_jmp_buf jmp_buf
258# define coro_setjmp(env) setjmp (env)
259# define coro_longjmp(env) longjmp ((env), 1)
260# else
261# define coro_jmp_buf sigjmp_buf
262# define coro_setjmp(env) sigsetjmp (env, 0)
263# define coro_longjmp(env) siglongjmp ((env), 1)
264# endif
265
241struct coro_context { 266struct coro_context {
242#if _XOPEN_UNIX > 0 || CORO_LOSER
243 jmp_buf env; 267 coro_jmp_buf env;
244#else
245 sigjmp_buf env;
246#endif
247}; 268};
248 269
249# if _XOPEN_UNIX > 0
250# define coro_transfer(p,n) do { if (! _setjmp ((p)->env )) _longjmp ((n)->env, 1); } while (0) 270# define coro_transfer(p,n) do { if (!coro_setjmp ((p)->env)) coro_longjmp ((n)->env); } while (0)
251# elif CORO_LOSER
252# define coro_transfer(p,n) do { if (! setjmp ((p)->env )) longjmp ((n)->env, 1); } while (0)
253# else
254# define coro_transfer(p,n) do { if (!sigsetjmp ((p)->env, 0)) siglongjmp ((n)->env, 1); } while (0)
255# endif
256
257# define coro_destroy(ctx) (void *)(ctx) 271# define coro_destroy(ctx) (void *)(ctx)
258 272
259#elif CORO_ASM 273#elif CORO_ASM
260 274
261struct coro_context { 275struct coro_context {
281void coro_transfer (coro_context *prev, coro_context *next); 295void coro_transfer (coro_context *prev, coro_context *next);
282void coro_destroy (coro_context *ctx); 296void coro_destroy (coro_context *ctx);
283 297
284#endif 298#endif
285 299
300#if __cplusplus
301}
286#endif 302#endif
287 303
304#endif
305

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines