Added all documentation.
[python/dscho.git] / Python / thread_wince.h
blob38ead1291283e7ef8255c18d502333ea760a6914
1 /***********************************************************
2 Copyright 1991-1995 by Stichting Mathematisch Centrum, Amsterdam,
3 The Netherlands.
5 All Rights Reserved
7 Permission to use, copy, modify, and distribute this software and its
8 documentation for any purpose and without fee is hereby granted,
9 provided that the above copyright notice appear in all copies and that
10 both that copyright notice and this permission notice appear in
11 supporting documentation, and that the names of Stichting Mathematisch
12 Centrum or CWI or Corporation for National Research Initiatives or
13 CNRI not be used in advertising or publicity pertaining to
14 distribution of the software without specific, written prior
15 permission.
17 While CWI is the initial source for this software, a modified version
18 is made available by the Corporation for National Research Initiatives
19 (CNRI) at the Internet address ftp://ftp.python.org.
21 STICHTING MATHEMATISCH CENTRUM AND CNRI DISCLAIM ALL WARRANTIES WITH
22 REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF
23 MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL STICHTING MATHEMATISCH
24 CENTRUM OR CNRI BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL
25 DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR
26 PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
27 TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
28 PERFORMANCE OF THIS SOFTWARE.
30 ******************************************************************/
32 /* This code implemented by Mark Hammond (MHammond@skippinet.com.au) */
34 #include <windows.h>
35 #include <limits.h>
36 #include <pydebug.h>
38 long PyThread_get_thread_ident(void);
41 * Change all headers to pure ANSI as no one will use K&R style on an
42 * NT
46 * Initialization of the C package, should not be needed.
48 static void PyThread__init_thread(void)
53 * Thread support.
55 int PyThread_start_new_thread(void (*func)(void *), void *arg)
57 long rv;
58 int success = 0;
60 dprintf(("%ld: PyThread_start_new_thread called\n", PyThread_get_thread_ident()));
61 if (!initialized)
62 PyThread_init_thread();
64 rv = _beginthread(func, 0, arg); /* use default stack size */
66 if (rv != -1) {
67 success = 1;
68 dprintf(("%ld: PyThread_start_new_thread succeeded:\n", PyThread_get_thread_ident()));
71 return success;
75 * Return the thread Id instead of an handle. The Id is said to uniquely identify the
76 * thread in the system
78 long PyThread_get_thread_ident(void)
80 if (!initialized)
81 PyThread_init_thread();
83 return GetCurrentThreadId();
86 static void do_PyThread_exit_thread(int no_cleanup)
88 dprintf(("%ld: do_PyThread_exit_thread called\n", PyThread_get_thread_ident()));
89 if (!initialized)
90 if (no_cleanup)
91 exit(0); /* XXX - was _exit()!! */
92 else
93 exit(0);
94 _endthread();
97 void PyThread_exit_thread(void)
99 do_PyThread_exit_thread(0);
102 void PyThread__exit_thread(void)
104 do_PyThread_exit_thread(1);
107 #ifndef NO_EXIT_PROG
108 static void do_PyThread_exit_prog(int status, int no_cleanup)
110 dprintf(("PyThread_exit_prog(%d) called\n", status));
111 if (!initialized)
112 if (no_cleanup)
113 _exit(status);
114 else
115 exit(status);
118 void PyThread_exit_prog(int status)
120 do_PyThread_exit_prog(status, 0);
123 void PyThread__exit_prog _P1(int status)
125 do_PyThread_exit_prog(status, 1);
127 #endif /* NO_EXIT_PROG */
130 * Lock support. It has to be implemented using Mutexes, as
131 * CE doesnt support semaphores. Therefore we use some hacks to
132 * simulate the non reentrant requirements of Python locks
134 PyThread_type_lock PyThread_allocate_lock(void)
136 HANDLE aLock;
138 dprintf(("PyThread_allocate_lock called\n"));
139 if (!initialized)
140 PyThread_init_thread();
142 aLock = CreateEvent(NULL, /* Security attributes */
143 0, /* Manual-Reset */
144 1, /* Is initially signalled */
145 NULL); /* Name of event */
147 dprintf(("%ld: PyThread_allocate_lock() -> %lx\n", PyThread_get_thread_ident(), (long)aLock));
149 return (PyThread_type_lock) aLock;
152 void PyThread_free_lock(PyThread_type_lock aLock)
154 dprintf(("%ld: PyThread_free_lock(%lx) called\n", PyThread_get_thread_ident(),(long)aLock));
156 CloseHandle(aLock);
160 * Return 1 on success if the lock was acquired
162 * and 0 if the lock was not acquired. This means a 0 is returned
163 * if the lock has already been acquired by this thread!
165 int PyThread_acquire_lock(PyThread_type_lock aLock, int waitflag)
167 int success = 1;
168 DWORD waitResult;
170 dprintf(("%ld: PyThread_acquire_lock(%lx, %d) called\n", PyThread_get_thread_ident(),(long)aLock, waitflag));
172 #ifndef DEBUG
173 waitResult = WaitForSingleObject(aLock, (waitflag == 1 ? INFINITE : 0));
174 #else
175 /* To aid in debugging, we regularly wake up. This allows us to
176 break into the debugger */
177 while (TRUE) {
178 waitResult = WaitForSingleObject(aLock, waitflag ? 3000 : 0);
179 if (waitflag==0 || (waitflag==1 && waitResult == WAIT_OBJECT_0))
180 break;
182 #endif
184 if (waitResult != WAIT_OBJECT_0) {
185 success = 0; /* We failed */
188 dprintf(("%ld: PyThread_acquire_lock(%lx, %d) -> %d\n", PyThread_get_thread_ident(),(long)aLock, waitflag, success));
190 return success;
193 void PyThread_release_lock(PyThread_type_lock aLock)
195 dprintf(("%ld: PyThread_release_lock(%lx) called\n", PyThread_get_thread_ident(),(long)aLock));
197 if (!SetEvent(aLock))
198 dprintf(("%ld: Could not PyThread_release_lock(%lx) error: %l\n", PyThread_get_thread_ident(), (long)aLock, GetLastError()));