Tree [5f33f0] snap-2000-08-13 /
History



File Date Author Commit
tests 2000-08-14 rpj rpj [218bce] New test.
ANNOUNCE 2000-08-14 rpj rpj [16cb1b] 2000-08-13 Ross Johnson <rpj@special.ise.canb...
CONTRIBUTORS 2000-08-14 rpj rpj [16cb1b] 2000-08-13 Ross Johnson <rpj@special.ise.canb...
COPYING.LIB 1998-10-02 bje bje [74a43f] 1998-10-02 Ben Elliston <bje@cygnus.com>
ChangeLog 2000-08-14 rpj rpj [16cb1b] 2000-08-13 Ross Johnson <rpj@special.ise.canb...
FAQ 2000-08-06 rpj rpj [6eb5bb] 2000-08-06 Ross Johnson <rpj@special.ise.canb...
GNUmakefile 2000-08-14 rpj rpj [16cb1b] 2000-08-13 Ross Johnson <rpj@special.ise.canb...
MAINTAINERS 1999-08-12 rpj rpj [9af51e] Merged patches to main trunk.
Makefile 2000-08-14 rpj rpj [16cb1b] 2000-08-13 Ross Johnson <rpj@special.ise.canb...
Makefile.in 2000-01-04 rpj rpj [a378d9] Main changes (see ChangeLog diff for details an...
Makefile.vc 2000-01-07 rpj rpj [5cdc41] Minor changes.
PROGRESS 2000-02-04 rpj rpj [20aff4] Minor admin changes.
README 2000-08-14 rpj rpj [5f33f0] Fix typos.
README.WinCE 2000-07-25 rpj rpj [e2fd6e] 2000-07-25 Ross Johnson <rpj@special.ise.canb...
TODO 2000-07-25 rpj rpj [e2fd6e] 2000-07-25 Ross Johnson <rpj@special.ise.canb...
WinCE-PORT 1999-11-04 rpj rpj [7fdb90] 1999-11-05 Ross Johnson <rpj@ixobrychus.canbe...
acconfig.h 1999-08-19 rpj rpj [5e87a0] 1999-08-19 Ross Johnson <rpj@ixobrychus.canbe...
attr.c 2000-07-25 rpj rpj [e2fd6e] 2000-07-25 Ross Johnson <rpj@special.ise.canb...
build.bat 1999-01-12 rpj rpj [bc3740] Wed Jan 13 09:34:52 1999 Ross Johnson <rpj@ix...
buildlib.bat 2000-08-14 rpj rpj [16cb1b] 2000-08-13 Ross Johnson <rpj@special.ise.canb...
cancel.c 2000-07-25 rpj rpj [e2fd6e] 2000-07-25 Ross Johnson <rpj@special.ise.canb...
cleanup.c 2000-08-11 rpj rpj [eb45dd] 2000-08-10 Ross Johnson <rpj@special.ise.canb...
condvar.c 2000-07-25 rpj rpj [e2fd6e] 2000-07-25 Ross Johnson <rpj@special.ise.canb...
config.guess 1998-09-13 bje bje [8b3277] 1998-09-13 Ben Elliston <bje@cygnus.com>
config.h 2000-07-25 rpj rpj [e2fd6e] 2000-07-25 Ross Johnson <rpj@special.ise.canb...
config.h.in 2000-07-25 rpj rpj [e2fd6e] 2000-07-25 Ross Johnson <rpj@special.ise.canb...
config.sub 1998-09-13 bje bje [8b3277] 1998-09-13 Ben Elliston <bje@cygnus.com>
configure 1999-10-16 rpj rpj [8c2385] 1999-10-17 Ross Johnson <rpj@ixobrychus.canbe...
configure.in 2000-01-04 rpj rpj [a378d9] Main changes (see ChangeLog diff for details an...
create.c 2000-08-14 rpj rpj [16cb1b] 2000-08-13 Ross Johnson <rpj@special.ise.canb...
dll.c 2000-07-25 rpj rpj [e2fd6e] 2000-07-25 Ross Johnson <rpj@special.ise.canb...
errno.c 2000-08-14 rpj rpj [16cb1b] 2000-08-13 Ross Johnson <rpj@special.ise.canb...
exit.c 2000-08-14 rpj rpj [16cb1b] 2000-08-13 Ross Johnson <rpj@special.ise.canb...
fork.c 1999-03-16 rpj rpj [c5573b] Tue Mar 16 1999 Ross Johnson <rpj@ixobrychus...
global.c 2000-01-04 rpj rpj [a378d9] Main changes (see ChangeLog diff for details an...
implement.h 2000-08-14 rpj rpj [16cb1b] 2000-08-13 Ross Johnson <rpj@special.ise.canb...
install-sh 1998-09-13 bje bje [8b3277] 1998-09-13 Ben Elliston <bje@cygnus.com>
misc.c 2000-08-14 rpj rpj [16cb1b] 2000-08-13 Ross Johnson <rpj@special.ise.canb...
mutex.c 2000-07-25 rpj rpj [e2fd6e] 2000-07-25 Ross Johnson <rpj@special.ise.canb...
need_errno.h 2000-08-14 rpj rpj [16cb1b] 2000-08-13 Ross Johnson <rpj@special.ise.canb...
private.c 2000-08-14 rpj rpj [16cb1b] 2000-08-13 Ross Johnson <rpj@special.ise.canb...
pthread.def 2000-08-14 rpj rpj [16cb1b] 2000-08-13 Ross Johnson <rpj@special.ise.canb...
pthread.h 2000-08-14 rpj rpj [16cb1b] 2000-08-13 Ross Johnson <rpj@special.ise.canb...
rwlock.c 2000-07-25 rpj rpj [e2fd6e] 2000-07-25 Ross Johnson <rpj@special.ise.canb...
sched.c 2000-07-25 rpj rpj [e2fd6e] 2000-07-25 Ross Johnson <rpj@special.ise.canb...
sched.h 1999-11-04 rpj rpj [7fdb90] 1999-11-05 Ross Johnson <rpj@ixobrychus.canbe...
semaphore.c 1999-11-04 rpj rpj [7fdb90] 1999-11-05 Ross Johnson <rpj@ixobrychus.canbe...
semaphore.h 1999-11-04 rpj rpj [7fdb90] 1999-11-05 Ross Johnson <rpj@ixobrychus.canbe...
signal.c 2000-07-25 rpj rpj [e2fd6e] 2000-07-25 Ross Johnson <rpj@special.ise.canb...
sync.c 2000-08-06 rpj rpj [6eb5bb] 2000-08-06 Ross Johnson <rpj@special.ise.canb...
tsd.c 2000-07-25 rpj rpj [e2fd6e] 2000-07-25 Ross Johnson <rpj@special.ise.canb...

Read Me

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.


What is it?
-----------

Pthreads-win32 is an Open Source Software (OSS) implementation of the
Threads component of the POSIX 1003.1c 1995 Standard for Microsoft's
Win32 environment. Some functions from POSIX 1003.1b are also
supported including semaphores. Other related functions include
the set of read-write lock functions.

See the file "ANNOUNCE" for more information including standards
conformance details and list of supported routines.


Library naming
--------------

Because the library is being built using various exception
handling schemes and compilers - and because the library
will not work reliably if these are mixed in an application,
each different version of the library has it's own name.

In general:
	pthread[VG][SC]E.dll
	pthread[VG][SC]E.lib

where:
	[VG] indicates the compiler
	V	- MS VC++
	G	- GNU G++

	[SC] indicates the exception handling scheme
	S	- Structured EH
	C	- C++ EH

For example:
	pthreadVSE.dll	(VC++/SEH)
	pthreadGCE.dll	(G++/C++ EH)

The GNU library archive file name has changed to:

	libpthreadw32.a	(the "32" is now "w32")


Known bugs in this snapshot
---------------------------

1. Running the test "join1.c" with the library built with Mingw32
and the GNUmakefile included, the test fails with a segmentation (invalid
page access) exception. The fault appears to be in the assembler code
emmitted by the compiler [to handle exception contexts] at the
end of the try block in _pthread_threadStart().

2. There are problems using the libpthreadw32.a stub archive derived
from either of pthreadVSE.dll or pthreadVCE.dll. The cleanup1.c test
fails.


Caveats
-------

1. Due to what is believed to be C++ compliance error in VC++,
if your application contains catch(...) blocks in your POSIX threads
then you will need to replace the "catch(...)" with the macro
"PtW32Catch", eg.

	#ifdef PtW32Catch
		PtW32Catch {
			...
		}
	#else
		catch(...) {
			...
		}
	#endif

Otherwise neither pthreads cancelation nor pthread_exit() will work
reliably.


Building under VC++ using either C++ EH or Structured EH
--------------------------------------------------------

From the source directory run one of the following:

nmake clean VCE	(builds the VC++ C++ EH version pthreadVCE.dll)

or:

nmake clean VSE	(builds the VC++ structured EH version pthreadVSE.dll)

You can run the testsuite by changing to the "tests" directory and
running the target corresponding to the DLL version you built:

nmake clean VCE

or:

nmake clean VSE


Building under Mingw32
----------------------

The dll can be built with Mingw32 gcc-2.95.2 or later.
Run "make" in the source directory (uses GNUmakefile). This builds
pthreadGCE.dll and libpthreadw32.a.

To generate the libpthreadw32.a file from pthreadVCE.dll rather than
building the library with G++, run "make fake.a". (You must have
pthreadVCE.dll already built - see above.)
Please note that VC++ and GNU exception handling is implemented
completely differently and so automatic cleanup of objects and
the propagation of exceptions themselves between the two schemes is not
going to happen.

You can run the testsuite by changing to the "tests" directory and
running "make clean" and then "make". See the "Known bugs" section above.


Building the library under Cygwin
---------------------------------

Not tested by me although I think some people have done this.
Not sure how successfully though.

Cygwin is implementing it's own POSIX threads routines and these
will be the ones to use if you develop using Cygwin.


Ready to run binaries
---------------------

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

	pthread.h
	semaphore.h
	sched.h
	pthread.def
	pthreadVCE.dll	- built with MSVC++ compiler using C++ EH
	pthreadVCE.lib
	pthreadVSE.dll	- built with MSVC++ compiler using SEH
	pthreadVSE.lib
	pthreadGCE.dll	- currently a copy of pthreadVCE.dll
	libpthreadw32.a	- derived from pthreadGCE.dll


Building applications with the library
--------------------------------------

Use the appropriate DLL and LIB files to match the exception handing
that you use in your application, or specifically, in your POSIX
threads. Don't mix them or neither thread cancelation nor
pthread_exit() will work reliably if at all.


Building applications with GNU compilers
----------------------------------------

[Please see the section on Known Bugs above and the section
dealing with building the library with Mingw32 before
you build applications using the GNU compilers. Please also
note that the pre-built pthreadGCE.dll is currently only
a copy of the dll built by MSVC++. Note that VC++ and
GNU exception handling is implemented completely differently
and so automatic cleanup of objects and the propagation of
exceptions themselves between the two schemes is not
going to happen. You'll need to wait for the version of
pthreadGCE.dll built be G++ itself which still has problems.]

Use gcc-2.95.2 or later.

With pthreadGCE.dll and libpthreadw32.a in the same directory as your
application myapp.c, you could compile, link and run myapp.c under
Mingw32 as follows:

	gcc -x c++ -o myapp.exe myapp.c -I. -L. -lpthreadw32
	myapp

Or put pthreadGCE.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 -x c++ -o myapp.exe myapp.c -lpthreadw32
	myapp


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

The complete source code in either unbundled, self-extracting
Zip file, or tar/gzipped format can be found at:

	ftp://sources.redhat.com/pub/pthreads-win32

The pre-built DLL, export libraries and matching pthread.h can be found at:

	ftp://sources.redhat.com/pub/pthreads-win32/dll-latest

Home page:

	http://sources.redhat.com/pthreads-win32/


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

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

	pthreads-win32-subscribe@sources.redhat.com

Unsubscribe by sending mail to:

	pthreads-win32-unsubscribe@sources.redhat.com


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

Pthreads-win32 is based substantially on a Win32 Pthreads implementation
contributed by John E. Bossom <jebossom@cognos.com>. Many others
have contributed important new code and bug fixes.

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

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