Mercurial > sdl-ios-xcode
annotate README @ 3069:caefe2344f65
Date: Thu, 27 Dec 2007 07:38:25 +0000
From: John Bartholomew
Subject: [SDL] SDL Semaphore implementation broken on Windows?
Hi,
Over the past couple of days, I've been battling with SDL, SDL_Mixer and SMPEG to try to find an audio hang bug. I believe I've found the problem, which I think is a race condition inside SDL's semaphore implementation (at least the Windows implementation). The semaphore code uses Windows' built in semaphore functions, but it also maintains a separate count value. This count value is updated with bare increment and decrement operations in SemPost and SemWaitTimeout - no locking primitives to protect them.
In tracking down the apparent audio bug, I found that at some point a semaphore's count value was being decremented to -1, which is clearly not a valid value for it to take.
I'm still not certain exactly what sequence of operations is occuring for this to happen, but I believe that overall it's a race condition between a thread calling SemPost (which increments the count) and the thread on the other end calling SemWait (which decrements it).
I will try to make a test case to verify this, but I'm not sure if I'll be able to (threading errors being difficult to reproduce even in the best circumstances).
However, assuming this is the cause of my problems, there is a very
simple fix:
Windows provides InterlockedIncrement() and InterlockedDecrement()
functions to perform increments and decrements which are guaranteed to be atomic. So the fix is in thread/win32/SDL_syssem.c: replace occurrences of --sem->count with InterlockedDecrement(&sem->count); and replace occurrences of ++sem->count with InterlockedIncrement(&sem->count);
This is using SDL v1.2.12, built with VC++ 2008 Express, running on a
Core 2 duo processor.
author | Sam Lantinga <slouken@libsdl.org> |
---|---|
date | Tue, 17 Feb 2009 05:39:18 +0000 |
parents | c9aa6bcb26f3 |
children | a67a961e2171 8582c6a5ca16 |
rev | line source |
---|---|
0 | 1 |
2 Simple DirectMedia Layer | |
3 | |
4 (SDL) | |
5 | |
6 Version 1.2 | |
7 | |
8 --- | |
9 http://www.libsdl.org/ | |
10 | |
602
a24bd700f92e
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
579
diff
changeset
|
11 This is the Simple DirectMedia Layer, a general API that provides low |
0 | 12 level access to audio, keyboard, mouse, joystick, 3D hardware via OpenGL, |
13 and 2D framebuffer across multiple platforms. | |
14 | |
1763
1c8672065e3b
Updated to include new languages and platform support
Sam Lantinga <slouken@libsdl.org>
parents:
1621
diff
changeset
|
15 The current version supports Linux, Windows, Windows CE, BeOS, MacOS, |
1c8672065e3b
Updated to include new languages and platform support
Sam Lantinga <slouken@libsdl.org>
parents:
1621
diff
changeset
|
16 Mac OS X, FreeBSD, NetBSD, OpenBSD, BSD/OS, Solaris, IRIX, and QNX. |
2062
c9aa6bcb26f3
Removed AmigaOS code for 1.3 branch.
Ryan C. Gordon <icculus@icculus.org>
parents:
1763
diff
changeset
|
17 The code contains support for Dreamcast, Atari, AIX, OSF/Tru64, |
1763
1c8672065e3b
Updated to include new languages and platform support
Sam Lantinga <slouken@libsdl.org>
parents:
1621
diff
changeset
|
18 RISC OS, SymbianOS, and OS/2, but these are not officially supported. |
0 | 19 |
1763
1c8672065e3b
Updated to include new languages and platform support
Sam Lantinga <slouken@libsdl.org>
parents:
1621
diff
changeset
|
20 SDL is written in C, but works with C++ natively, and has bindings to |
1c8672065e3b
Updated to include new languages and platform support
Sam Lantinga <slouken@libsdl.org>
parents:
1621
diff
changeset
|
21 several other languages, including Ada, C#, Eiffel, Erlang, Euphoria, |
1c8672065e3b
Updated to include new languages and platform support
Sam Lantinga <slouken@libsdl.org>
parents:
1621
diff
changeset
|
22 Guile, Haskell, Java, Lisp, Lua, ML, Objective C, Pascal, Perl, PHP, |
1c8672065e3b
Updated to include new languages and platform support
Sam Lantinga <slouken@libsdl.org>
parents:
1621
diff
changeset
|
23 Pike, Pliant, Python, Ruby, and Smalltalk. |
0 | 24 |
25 This library is distributed under GNU LGPL version 2, which can be | |
26 found in the file "COPYING". This license allows you to use SDL | |
27 freely in commercial programs as long as you link with the dynamic | |
28 library. | |
29 | |
30 The best way to learn how to use SDL is to check out the header files in | |
31 the "include" subdirectory and the programs in the "test" subdirectory. | |
32 The header files and test programs are well commented and always up to date. | |
1763
1c8672065e3b
Updated to include new languages and platform support
Sam Lantinga <slouken@libsdl.org>
parents:
1621
diff
changeset
|
33 More documentation is available in HTML format in "docs/index.html", and |
1c8672065e3b
Updated to include new languages and platform support
Sam Lantinga <slouken@libsdl.org>
parents:
1621
diff
changeset
|
34 a documentation wiki is available online at: |
1c8672065e3b
Updated to include new languages and platform support
Sam Lantinga <slouken@libsdl.org>
parents:
1621
diff
changeset
|
35 http://www.libsdl.org/cgi/docwiki.cgi |
0 | 36 |
37 The test programs in the "test" subdirectory are in the public domain. | |
38 | |
39 Frequently asked questions are answered online: | |
369
e405cf8bf580
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
362
diff
changeset
|
40 http://www.libsdl.org/faq.php |
0 | 41 |
42 If you need help with the library, or just want to discuss SDL related | |
43 issues, you can join the developers mailing list: | |
369
e405cf8bf580
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
362
diff
changeset
|
44 http://www.libsdl.org/mailing-list.php |
0 | 45 |
46 Enjoy! | |
47 Sam Lantinga (slouken@libsdl.org) | |
48 |