1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
|
/*
* NASPRO - The NASPRO Architecture for Sound PROcessing
* Portable runtime library
*
* Copyright (C) 2007-2014 Stefano D'Angelo
*
* See the COPYING file for license conditions.
*/
/*
Title: Threads
Threading.
*/
#ifndef _NASPRO_CORE_THREAD_H
#define _NASPRO_CORE_THREAD_H
#ifndef _NASPRO_CORE_LIB_H
# error Only <NASPRO/core/lib.h> can be included directly.
#endif
NACORE_BEGIN_C_DECLS
#ifdef _WIN32
typedef struct
{
HANDLE handle;
DWORD id;
} nacore_thread;
#else
typedef pthread_t nacore_thread;
#endif
/*
Type: nacore_thread
Thread identifier.
It is unspecified whether nacore_thread is a pointer, a structure or
whatever.
Two thread identifiers can only be compared using <nacore_thread_equal()>.
*/
/*
Function: nacore_thread_create()
Creates a new thread.
Parameters:
thread - Memory location where to put a thread identifier.
size - Stack size for the new thread or 0 to indicate the
default stack size.
start_routine - Function to be executed by the new thread.
arg - Argument to be passed to start_routine or NULL.
Returns:
0 on success, ENOMEM if there was not enough memory, EINVAL if the system
cannot allocate the requested stack size, EAGAIN if the system lacked the
necessary resources or EPERM if the caller does not have appropriate
permission.
*/
_NACORE_DEF int
nacore_thread_create(nacore_thread *thread, size_t stack_size,
void (*start_routine)(void *arg), void *arg);
/*
Function: nacore_thread_exit()
Terminates the calling thread.
*/
_NACORE_DEF void
nacore_thread_exit();
/*
Function: nacore_thread_self()
Gets an identifier for the calling thread.
Returns:
Thread identifier for the calling thread.
*/
_NACORE_DEF nacore_thread
nacore_thread_self();
/*
Function: nacore_thread_join()
Waits for termination of the specified thread.
Parameters:
thread - Thread identifier.
Returns:
0 on success. Depending on the platform, in case of error it may return
EDEADLK if thread is the calling thread or if a deadlock was detected,
EINVAL if the specified thread is not joinable or another thread is already
waiting to join with it, ESRCH if no thead corresponding to the given
thread identifier was found or <NACORE_EUNKNOWN> if another kind of error
happened.
*/
_NACORE_DEF int
nacore_thread_join(nacore_thread thread);
/*
Function: nacore_thread_equal()
Compares two thread identifiers.
Parameters:
t1 - First thread identifier.
t2 - Second thread identifier.
Returns:
A nonzero value if the two identifiers indicate the same thread, 0
otherwise.
*/
_NACORE_DEF char
nacore_thread_equal(nacore_thread t1, nacore_thread t2);
NACORE_END_C_DECLS
#endif
|
