blob: 228f817cadd89f07ace5508e9920302a7e13fbd5 (
plain)
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
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
|
/* +------------------------------------+
* | Inspire Internet Relay Chat Daemon |
* +------------------------------------+
*
* InspIRCd: (C) 2002-2009 InspIRCd Development Team
* See: http://wiki.inspircd.org/Credits
*
* This program is free but copyrighted software; see
* the file COPYING for details.
*
* ---------------------------------------------------
*/
#ifndef __THREADENGINE__
#define __THREADENGINE__
#include <vector>
#include <string>
#include <map>
#include "inspircd_config.h"
#include "base.h"
class InspIRCd;
class Thread;
/** The ThreadEngine class has the responsibility of initialising
* Thread derived classes. It does this by creating operating system
* level threads which are then associated with the class transparently.
* This allows Thread classes to be derived without needing to know how
* the OS implements threads. You should ensure that any sections of code
* that use threads are threadsafe and do not interact with any other
* parts of the code which are NOT known threadsafe! If you really MUST
* access non-threadsafe code from a Thread, use the Mutex class to wrap
* access to the code carefully.
*/
class CoreExport ThreadEngine : public Extensible
{
protected:
/** Creator instance
*/
InspIRCd* ServerInstance;
public:
/** Constructor.
* @param Instance Creator object
*/
ThreadEngine(InspIRCd* Instance);
/** Destructor
*/
virtual ~ThreadEngine();
/** Create a new thread. This takes an already allocated
* Thread* pointer and initializes it to use this threading
* engine. On failure, this function may throw a CoreException.
* @param thread_to_init Pointer to a newly allocated Thread
* derived object.
*/
virtual void Start(Thread* thread_to_init) = 0;
/** Returns the thread engine's name for display purposes
* @return The thread engine name
*/
virtual const std::string GetName()
{
return "<pure-virtual>";
}
};
/** The Mutex class represents a mutex, which can be used to keep threads
* properly synchronised. Use mutexes sparingly, as they are a good source
* of thread deadlocks etc, and should be avoided except where absolutely
* neccessary. Note that the internal behaviour of the mutex varies from OS
* to OS depending on the thread engine, for example in windows a Mutex
* in InspIRCd uses critical sections, as they are faster and simpler to
* manage.
*/
class CoreExport Mutex
{
protected:
/** Enable or disable the Mutex. This method has somewhat confusing
* wording (e.g. the function name and parameters) so it is protected
* in preference of the Lock() and Unlock() methods which are user-
* accessible.
*
* @param enable True to enable the mutex (enter it) and false to
* disable the mutex (leave it).
*/
virtual void Enable(bool enable) = 0;
public:
/** Constructor.
*/
Mutex();
/** Enter/enable the mutex lock.
*/
void Lock() { Enable(true); }
/** Leave/disable the mutex lock.
*/
void Unlock() { Enable(false); }
/** Destructor
*/
~Mutex() { }
};
class CoreExport ThreadData
{
public:
virtual void FreeThread(Thread* thread) { }
};
/** Derive from this class to implement your own threaded sections of
* code. Be sure to keep your code thread-safe and not prone to deadlocks
* and race conditions if you MUST use threading!
*/
class CoreExport Thread : public Extensible
{
private:
/** Set to true when the thread is to exit
*/
bool ExitFlag;
public:
/** Opaque thread state managed by threading engine
*/
ThreadData* state;
/** Set Creator to NULL at this point
*/
Thread() : ExitFlag(false), state(NULL)
{
}
/** If this thread has a Creator set, call it to
* free the thread
*/
virtual ~Thread()
{
if (state)
{
state->FreeThread(this);
delete state;
}
}
/** Override this method to put your actual
* threaded code here.
*/
virtual void Run() = 0;
/** Signal the thread to exit gracefully.
*/
void SetExitFlag(bool value)
{
ExitFlag = value;
}
/** Get thread's current exit status.
* (are we being asked to exit?)
*/
bool GetExitFlag()
{
return ExitFlag;
}
};
#endif
|
