README


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

PTHREADS-WIN32
==============

Pthreads-win32 is free software, distributed under the GNU Library
General Public License (LGPL). See the file 'COPYING.LIB' for terms
and conditions.

Mailing list
------------

There is a mailing list for discussing pthreads on Win32. To join, send
enail to:

	pthreads-win32-subscribe@sourceware.cygnus.com


Acknowledgements
----------------

Pthreads-win32 is based substantially on a Win32 Pthreads implementation
contributed by John E. Bossom <jebossom@cognos.com>.

See the 'MAINTAINERS' file for the list of contributors.


Why you cannot build the library with Cygwin or Mingw32
-------------------------------------------------------

The DLL pthread.dll still cannot be built using g++ due to non thread-safe
exception handling in g++.  Thanks to Kevin Ruland for researching this
one. See the FAQ Question 2 for more information.

However, you can use the export library libpthread32.a built under
Mingw32 (not tested under Cygwin) together with the pthread.dll built
with MSVC. Thanks to Anders Norlander for pointing this out.

For convenience, the following pre-built files can be downloaded from
the FTP site (see under "Availability" below):

	pthread.h	- the standard include file
	pthread.dll	- built with MSVC cl compiler
	pthread.lib	- built with MSVC cl compiler
	libpthread32.a	- built with Mingw32 (use with MSVC pthread.dll)

With these files in the same directory as your application myapp.c,
you could compile, link and run myapp.c under Mingw32 as follows:

	gcc -o myapp.exe myapp.c -I. -L. -lpthread32
	myapp

Or put pthread.dll in an appropriate directory in your PATH,
put libpthread32.a in MINGW_ROOT\i386-mingw32\lib, and
put pthread.h in MINGW_ROOT\i386-mingw32\include, then use:

	gcc -o myapp.exe myapp.c -lpthread32
	myapp


Availability
------------

The complete source code in either unbundled or tar/gzipped format
can be found at:
	ftp://sourceware.cygnus.com/pub/pthreads-win32

The pre-built DLL, export libraries and matching pthread.h can be found at:
	ftp://sourceware.cygnus.com/pub/pthreads-win32/dll-latest

Home page:
	http://sourceware.cygnus.com/pthreads-win32/

----
Ross Johnson
<rpj@ise.canberra.edu.au>