src/common/Thread.h

/***************************************************************************
 *                                                                         *
 *   LinuxSampler - modular, streaming capable sampler                     *
 *                                                                         *
 *   Copyright (C) 2003, 2004 by Benno Senoner and Christian Schoenebeck   *
 *   Copyright (C) 2005 - 2007 Christian Schoenebeck                       *
 *                                                                         *
 *   This program is free software; you can redistribute it and/or modify  *
 *   it under the terms of the GNU General Public License as published by  *
 *   the Free Software Foundation; either version 2 of the License, or     *
 *   (at your option) any later version.                                   *
 *                                                                         *
 *   This program is distributed in the hope that it will be useful,       *
 *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
 *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *
 *   GNU General Public License for more details.                          *
 *                                                                         *
 *   You should have received a copy of the GNU General Public License     *
 *   along with this program; if not, write to the Free Software           *
 *   Foundation, Inc., 59 Temple Place, Suite 330, Boston,                 *
 *   MA  02111-1307  USA                                                   *
 ***************************************************************************/

#ifndef __LS_THREAD_H__
#define __LS_THREAD_H__

//FIXME: this is a temorary solution because of problems with condition variables we use a polling lock in SignalStartThread()
#if defined(WIN32)
#define WIN32_SIGNALSTARTTHREAD_WORKAROUND 1
#endif

#include <iostream>
#include <stdio.h>
#include <stdlib.h>

#if defined(WIN32)
#include <windows.h>
#else
#include <sched.h>
#include <sys/mman.h>
#include <memory.h>
#include <pthread.h>
#endif
#include <errno.h>

#include "Condition.h"

namespace LinuxSampler {

/// Abstract base class for classes that need to run in an own thread.
class Thread {
    public:
        Thread(bool LockMemory, bool RealTime, int PriorityMax, int PriorityDelta);
        virtual ~Thread();
        virtual int  StartThread();
        virtual int  StopThread();
        virtual int  SignalStartThread();
        virtual int  SignalStopThread();

                inline int TestCancel() {
#if CONFIG_PTHREAD_TESTCANCEL
                        pthread_testcancel();
#endif
                        return 0;
                }

        virtual bool IsRunning();
        virtual int  SetSchedulingPriority(); //FIXME: should be private
        virtual int  LockMemory();            //FIXME: should be private
        virtual void EnableDestructor();      //FIXME: should be private
        virtual int  Destructor();            //FIXME: should be private
        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

        /**
         * Allocates an aligned block of memory. Allocated memory blocks
         * need to be freed using freeAlignedMem().
         *
         * @param boundary - the alignement boundary, usually a power of 2
         *                   e.g. 4 but it can be an arbitrary number
         *                   between 1 and 128
         * @param size     - size in bytes to be allocated
         * @returns  pointer to the allocated memory block
         */
        static void* allocAlignedMem(size_t boundary, size_t size) {
            unsigned char *ptr = (unsigned char *)malloc(size+boundary);
            size_t offset = boundary - ((size_t)ptr % boundary);
            ptr[offset-1] = (unsigned char)offset;
            return (ptr + offset);
        }

        /**
         * Frees an aligned block of memory allocated with allocAlignedMem()
         *
         * @param ptr - pointer to the memory block
         */
        static void freeAlignedMem(void *ptr) {
            unsigned char *p = (unsigned char *)ptr;
            p -= p[-1];
            free(p);
        }

        /**
         * Locks a region of memory in physical RAM.
         *
         * @param addr - address of the memory block
         * @param size - size of the memory block
         * @return true if the locking succeded, otherwise false
         */
        static bool lockMemory(void *addr, size_t size) {
            #if defined(WIN32)
            return VirtualLock(addr, size);
            #else
            return !mlock(addr, size);
            #endif
        }

        /**
         * Unlocks a region of memory in physical RAM.
         *
         * @param addr - address of the memory block
         * @param size - size of the memory block
         * @return true if the unlocking succeded, otherwise false
         */
        static bool unlockMemory(void *addr, size_t size) {
            #if defined(WIN32)
            return VirtualUnlock(addr, size);
            #else
            return !munlock(addr, size);
            #endif
        }

    private:
    #if defined(WIN32)
        HANDLE hThread;
        DWORD lpThreadId;
        #if defined(WIN32_SIGNALSTARTTHREAD_WORKAROUND)
        bool win32isRunning;
        #endif
    #else
        pthread_attr_t  __thread_attr;
        pthread_t       __thread_id;
        pthread_key_t   __thread_destructor_key;
    #endif
        Condition       RunningCondition;
        int             PriorityMax;
        int             PriorityDelta;
        bool            isRealTime;
        bool            bLockedMemory;  
};

} // namespace LinuxSampler

#endif // __LS_THREAD_H__
1	/***************************************************************************
2	* *
3	* LinuxSampler - modular, streaming capable sampler *
4	* *
5	* Copyright (C) 2003, 2004 by Benno Senoner and Christian Schoenebeck *
6	* Copyright (C) 2005 - 2007 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 int TestCancel() {
61	#if CONFIG_PTHREAD_TESTCANCEL
62	pthread_testcancel();
63	#endif
64	return 0;
65	}
66
67	virtual bool IsRunning();
68	virtual int SetSchedulingPriority(); //FIXME: should be private
69	virtual int LockMemory(); //FIXME: should be private
70	virtual void EnableDestructor(); //FIXME: should be private
71	virtual int Destructor(); //FIXME: should be private
72	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
73
74	/**
75	* Allocates an aligned block of memory. Allocated memory blocks
76	* need to be freed using freeAlignedMem().
77	*
78	* @param boundary - the alignement boundary, usually a power of 2
79	* e.g. 4 but it can be an arbitrary number
80	* between 1 and 128
81	* @param size - size in bytes to be allocated
82	* @returns pointer to the allocated memory block
83	*/
84	static void* allocAlignedMem(size_t boundary, size_t size) {
85	unsigned char ptr = (unsigned char )malloc(size+boundary);
86	size_t offset = boundary - ((size_t)ptr % boundary);
87	ptr[offset-1] = (unsigned char)offset;
88	return (ptr + offset);
89	}
90
91	/**
92	* Frees an aligned block of memory allocated with allocAlignedMem()
93	*
94	* @param ptr - pointer to the memory block
95	*/
96	static void freeAlignedMem(void *ptr) {
97	unsigned char p = (unsigned char )ptr;
98	p -= p[-1];
99	free(p);
100	}
101
102	/**
103	* Locks a region of memory in physical RAM.
104	*
105	* @param addr - address of the memory block
106	* @param size - size of the memory block
107	* @return true if the locking succeded, otherwise false
108	*/
109	static bool lockMemory(void *addr, size_t size) {
110	#if defined(WIN32)
111	return VirtualLock(addr, size);
112	#else
113	return !mlock(addr, size);
114	#endif
115	}
116
117	/**
118	* Unlocks a region of memory in physical RAM.
119	*
120	* @param addr - address of the memory block
121	* @param size - size of the memory block
122	* @return true if the unlocking succeded, otherwise false
123	*/
124	static bool unlockMemory(void *addr, size_t size) {
125	#if defined(WIN32)
126	return VirtualUnlock(addr, size);
127	#else
128	return !munlock(addr, size);
129	#endif
130	}
131
132	private:
133	#if defined(WIN32)
134	HANDLE hThread;
135	DWORD lpThreadId;
136	#if defined(WIN32_SIGNALSTARTTHREAD_WORKAROUND)
137	bool win32isRunning;
138	#endif
139	#else
140	pthread_attr_t __thread_attr;
141	pthread_t __thread_id;
142	pthread_key_t __thread_destructor_key;
143	#endif
144	Condition RunningCondition;
145	int PriorityMax;
146	int PriorityDelta;
147	bool isRealTime;
148	bool bLockedMemory;
149	};
150
151	} // namespace LinuxSampler
152
153	#endif // __LS_THREAD_H__