1 /* Copyright  (C) 2010-2020 The RetroArch team
2  *
3  * ---------------------------------------------------------------------------------------
4  * The following license statement only applies to this file (libco.h).
5  * ---------------------------------------------------------------------------------------
6  *
7  * Permission is hereby granted, free of charge,
8  * to any person obtaining a copy of this software and associated documentation files (the "Software"),
9  * to deal in the Software without restriction, including without limitation the rights to
10  * use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software,
11  * and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
12  *
13  * The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
14  *
15  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
16  * INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
18  * IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
19  * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
21  */
22 
23 #ifndef LIBCO_H
24 #define LIBCO_H
25 
26 #include <retro_common_api.h>
27 
28 #ifdef LIBCO_C
29   #ifdef LIBCO_MP
30     #define thread_local __thread
31   #else
32     #define thread_local
33   #endif
34 #endif
35 
36 RETRO_BEGIN_DECLS
37 
38 typedef void* cothread_t;
39 
40 /**
41  * co_active:
42  *
43  * Gets the currently active context.
44  *
45  * Returns: active context.
46  **/
47 cothread_t co_active(void);
48 
49 /**
50  * co_create:
51  * @int                : stack size
52  * @funcptr            : thread entry function callback
53  *
54  * Create a co_thread.
55  *
56  * Returns: cothread if successful, otherwise NULL.
57  */
58 cothread_t co_create(unsigned int, void (*)(void));
59 
60 /**
61  * co_delete:
62  * @cothread           : cothread object
63  *
64  * Frees a co_thread.
65  */
66 void co_delete(cothread_t cothread);
67 
68 /**
69  * co_switch:
70  * @cothread           : cothread object to switch to
71  *
72  * Do a context switch to @cothread.
73  */
74 void co_switch(cothread_t cothread);
75 
76 RETRO_END_DECLS
77 
78 /* ifndef LIBCO_H */
79 #endif
80