1 |
/*************************************************************************** |
2 |
* * |
3 |
* LinuxSampler - modular, streaming capable sampler * |
4 |
* * |
5 |
* Copyright (C) 2003, 2004 by Benno Senoner and Christian Schoenebeck * |
6 |
* Copyright (C) 2005 - 2008 Christian Schoenebeck * |
7 |
* * |
8 |
* This program is free software; you can redistribute it and/or modify * |
9 |
* it under the terms of the GNU General Public License as published by * |
10 |
* the Free Software Foundation; either version 2 of the License, or * |
11 |
* (at your option) any later version. * |
12 |
* * |
13 |
* This program is distributed in the hope that it will be useful, * |
14 |
* but WITHOUT ANY WARRANTY; without even the implied warranty of * |
15 |
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * |
16 |
* GNU General Public License for more details. * |
17 |
* * |
18 |
* You should have received a copy of the GNU General Public License * |
19 |
* along with this program; if not, write to the Free Software * |
20 |
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, * |
21 |
* MA 02111-1307 USA * |
22 |
***************************************************************************/ |
23 |
|
24 |
#ifndef __LS_THREAD_H__ |
25 |
#define __LS_THREAD_H__ |
26 |
|
27 |
//FIXME: this is a temorary solution because of problems with condition variables we use a polling lock in SignalStartThread() |
28 |
#if defined(WIN32) |
29 |
#define WIN32_SIGNALSTARTTHREAD_WORKAROUND 1 |
30 |
#endif |
31 |
|
32 |
#include <iostream> |
33 |
#include <stdio.h> |
34 |
#include <stdlib.h> |
35 |
|
36 |
#if defined(WIN32) |
37 |
#include <windows.h> |
38 |
#else |
39 |
#include <sched.h> |
40 |
#include <sys/mman.h> |
41 |
#include <memory.h> |
42 |
#include <pthread.h> |
43 |
#endif |
44 |
#include <errno.h> |
45 |
|
46 |
#include "Condition.h" |
47 |
|
48 |
namespace LinuxSampler { |
49 |
|
50 |
/// Abstract base class for classes that need to run in an own thread. |
51 |
class Thread { |
52 |
public: |
53 |
Thread(bool LockMemory, bool RealTime, int PriorityMax, int PriorityDelta); |
54 |
virtual ~Thread(); |
55 |
virtual int StartThread(); |
56 |
virtual int StopThread(); |
57 |
virtual int SignalStartThread(); |
58 |
virtual int SignalStopThread(); |
59 |
|
60 |
inline void TestCancel() { |
61 |
#if CONFIG_PTHREAD_TESTCANCEL |
62 |
pthread_testcancel(); |
63 |
#endif |
64 |
} |
65 |
|
66 |
virtual bool IsRunning(); |
67 |
virtual int SetSchedulingPriority(); //FIXME: should be private |
68 |
virtual int LockMemory(); //FIXME: should be private |
69 |
virtual void EnableDestructor(); //FIXME: should be private |
70 |
virtual int Destructor(); //FIXME: should be private |
71 |
virtual int Main() = 0; ///< This method needs to be implemented by the descendant and is the entry point for the new thread. FIXME: should be protected |
72 |
|
73 |
/** |
74 |
* Allocates an aligned block of memory. Allocated memory blocks |
75 |
* need to be freed using freeAlignedMem(). |
76 |
* |
77 |
* @param boundary - the alignement boundary, usually a power of 2 |
78 |
* e.g. 4 but it can be an arbitrary number |
79 |
* between 1 and 128 |
80 |
* @param size - size in bytes to be allocated |
81 |
* @returns pointer to the allocated memory block |
82 |
*/ |
83 |
static void* allocAlignedMem(size_t boundary, size_t size) { |
84 |
unsigned char *ptr = (unsigned char *)malloc(size+boundary); |
85 |
size_t offset = boundary - ((size_t)ptr % boundary); |
86 |
ptr[offset-1] = (unsigned char)offset; |
87 |
return (ptr + offset); |
88 |
} |
89 |
|
90 |
/** |
91 |
* Frees an aligned block of memory allocated with allocAlignedMem() |
92 |
* |
93 |
* @param ptr - pointer to the memory block |
94 |
*/ |
95 |
static void freeAlignedMem(void *ptr) { |
96 |
unsigned char *p = (unsigned char *)ptr; |
97 |
p -= p[-1]; |
98 |
free(p); |
99 |
} |
100 |
|
101 |
/** |
102 |
* Locks a region of memory in physical RAM. |
103 |
* |
104 |
* @param addr - address of the memory block |
105 |
* @param size - size of the memory block |
106 |
* @return true if the locking succeded, otherwise false |
107 |
*/ |
108 |
static bool lockMemory(void *addr, size_t size) { |
109 |
#if defined(WIN32) |
110 |
return VirtualLock(addr, size); |
111 |
#else |
112 |
return !mlock(addr, size); |
113 |
#endif |
114 |
} |
115 |
|
116 |
/** |
117 |
* Unlocks a region of memory in physical RAM. |
118 |
* |
119 |
* @param addr - address of the memory block |
120 |
* @param size - size of the memory block |
121 |
* @return true if the unlocking succeded, otherwise false |
122 |
*/ |
123 |
static bool unlockMemory(void *addr, size_t size) { |
124 |
#if defined(WIN32) |
125 |
return VirtualUnlock(addr, size); |
126 |
#else |
127 |
return !munlock(addr, size); |
128 |
#endif |
129 |
} |
130 |
|
131 |
private: |
132 |
#if defined(WIN32) |
133 |
HANDLE hThread; |
134 |
DWORD lpThreadId; |
135 |
#if defined(WIN32_SIGNALSTARTTHREAD_WORKAROUND) |
136 |
bool win32isRunning; |
137 |
#endif |
138 |
#else |
139 |
pthread_attr_t __thread_attr; |
140 |
pthread_t __thread_id; |
141 |
pthread_key_t __thread_destructor_key; |
142 |
#endif |
143 |
Condition RunningCondition; |
144 |
int PriorityMax; |
145 |
int PriorityDelta; |
146 |
bool isRealTime; |
147 |
bool bLockedMemory; |
148 |
}; |
149 |
|
150 |
} // namespace LinuxSampler |
151 |
|
152 |
#endif // __LS_THREAD_H__ |