summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--ANNOUNCE322
1 files changed, 322 insertions, 0 deletions
diff --git a/ANNOUNCE b/ANNOUNCE
new file mode 100644
index 0000000..daa72d3
--- /dev/null
+++ b/ANNOUNCE
@@ -0,0 +1,322 @@
+
+ PTHREADS-WIN32 SNAPSHOT 1999-03-15
+ ----------------------------------
+ Web Site: http://sourceware.cygnus.com/pthreads-win32/
+ Coordinator: Ross Johnson <rpj@ise.canberra.edu.au>
+
+
+We are pleased to announce the availability of Pthreads-win32, an
+Open Source Software (OSS) implementation of the Threads component
+of the POSIX 1003.1c 1996 Standard for Microsoft's Win32
+environment.
+
+Pthreads-win32 is free software, distributed under the GNU Library
+General Public License (LGPL).
+
+This is the first general announcement of the library in workable
+form. We expect it to be stable in the real world having passed it's
+own test suite, however, if you do find bugs in the library please
+let us know either via the mailing list (see below), or by emailing
+the coordinator directly (see above).
+
+Pthreads-win32 is based substantially on a Win32 pthreads
+implementation contributed by John E. Bossom <jebossom@cognos.com>.
+
+Please see the 'Acknowledgements' section at the end of this
+announcement for the list of contributors.
+
+
+Level of standards conformance
+------------------------------
+
+The following POSIX 1003.1c 1996 options are defined:
+
+ _POSIX_THREADS
+ _POSIX_THREAD_SAFE_FUNCTIONS
+ _POSIX_THREAD_ATTR_STACKSIZE
+
+
+The following POSIX 1003.1c 1996 options are not defined:
+
+ _POSIX_THREAD_ATTR_STACKADDR
+ _POSIX_THREAD_PRIORITY_SCHEDULING
+ _POSIX_THREAD_PRIO_INHERIT
+ _POSIX_THREAD_PRIO_PROTECT
+ _POSIX_THREAD_PROCESS_SHARED
+
+
+The following functions are implemented:
+
+ ---------------------------
+ PThreads
+ ---------------------------
+ pthread_attr_init
+ pthread_attr_destroy
+ pthread_attr_getdetachstate
+ pthread_attr_getstackaddr
+ pthread_attr_getstacksize
+ pthread_attr_setdetachstate
+ pthread_attr_setstackaddr
+ pthread_attr_setstacksize
+
+ pthread_create
+ pthread_detach
+ pthread_equal
+ pthread_exit
+ pthread_join
+ pthread_once
+ pthread_self
+
+ pthread_cancel
+ pthread_cleanup_pop
+ pthread_cleanup_push
+ pthread_setcancelstate
+ pthread_setcanceltype
+ pthread_testcancel
+
+ ---------------------------
+ Thread Specific Data
+ ---------------------------
+ pthread_key_create
+ pthread_key_delete
+ pthread_setspecific
+ pthread_getspecific
+
+ ---------------------------
+ Mutexes
+ ---------------------------
+ pthread_mutexattr_init
+ pthread_mutexattr_destroy
+ pthread_mutexattr_getpshared
+ pthread_mutexattr_setpshared
+
+ pthread_mutex_init
+ pthread_mutex_destroy
+ pthread_mutex_lock
+ pthread_mutex_trylock
+ pthread_mutex_unlock
+
+ ---------------------------
+ Condition Variables
+ ---------------------------
+ pthread_condattr_init
+ pthread_condattr_destroy
+ pthread_condattr_getpshared
+ pthread_condattr_setpshared
+
+ pthread_cond_init
+ pthread_cond_destroy
+ pthread_cond_wait
+ pthread_cond_timedwait
+ pthread_cond_signal
+ pthread_cond_broadcast
+
+ ---------------------------
+ RealTime Scheduling
+ ---------------------------
+ pthread_attr_getschedparam
+ pthread_attr_setschedparam
+ pthread_getschedparam
+ pthread_setschedparam
+ sched_get_priority_max
+ sched_get_priority_min
+
+ ---------------------------
+ Signals
+ ---------------------------
+ pthread_sigmask
+
+ ---------------------------
+ Static Initializers (macros)
+ ---------------------------
+ PTHREAD_ONCE_INIT
+ PTHREAD_MUTEXINITIALIZER
+ PTHREAD_COND_INITIALIZER
+
+ ---------------------------
+ Thread-Safe C Runtime Library (macros)
+ ---------------------------
+ strtok_r
+ asctime_r
+ ctime_r
+ gmtime_r
+ localtime_r
+ rand_r
+
+
+The following functions are not implemented:
+
+ ---------------------------
+ RealTime Scheduling
+ ---------------------------
+ pthread_attr_getinheritsched
+ pthread_attr_getschedpolicy
+ pthread_attr_getscope
+ pthread_attr_setinheritsched
+ pthread_attr_setschedpolicy
+ pthread_attr_setscope
+ pthread_mutex_getprioceiling
+ pthread_mutex_setprioceiling
+ pthread_mutex_attr_getprioceiling
+ pthread_mutex_attr_getprotocol
+ pthread_mutex_attr_setprioceiling
+ pthread_mutex_attr_setprotocol
+
+ ---------------------------
+ Fork Handlers
+ ---------------------------
+ pthread_atfork
+
+ ---------------------------
+ Stdio
+ ---------------------------
+ flockfile
+ ftrylockfile
+ funlockfile
+ getc_unlocked
+ getchar_unlocked
+ putc_unlocked
+ putchar_unlocked
+
+ ---------------------------
+ Thread-Safe C Runtime Library
+ ---------------------------
+ readdir_r
+ getgrgid_r
+ getgrnam_r
+ getpwuid_r
+ getpwnam_r
+
+ ---------------------------
+ Signals
+ ---------------------------
+ pthread_kill
+ sigtimedwait
+ sigwait
+ sigwaitinfo
+
+
+The library includes two non-API functions for creating cancellation
+points in applications and libraries:
+
+ pthreadCancelableWait
+ pthreadCancelableTimedWait
+
+
+Availability
+------------
+
+For the prebuilt DLL, export libs (for both MSVC and Mingw32), and
+pthread.h:
+
+ftp://sourceware.cygnus.com/pub/pthreads-win32/pthreads-dll-1999-03-15
+
+Source tree:
+
+ftp://sourceware.cygnus.com/pub/pthreads-win32/pthreads-snap-1999-03-15.tar.gz
+
+Source files are available in unpacked form at:
+
+ftp://sourceware.cygnus.com/pub/pthreads-win32/sources
+
+
+Mailing List
+------------
+
+There is a mailing list for discussing pthreads on Win32. To join,
+send email to:
+
+ pthreads-win32-subscribe@sourceware.cygnus.com
+
+
+Application Development Environments
+------------------------------------
+
+MSVC:
+MSVC can be used of course.
+
+Mingw32: (ftp://ftp.xraylith.wisc.edu/pub/khan/gnu-win32/mingw32/egcs-1.1.1/)
+Mingw32 must use the thread-safe MSVCRT library. You can link
+against the export library libpthread32.a built under Mingw32
+together with the version of pthread.dll built with MSVC.
+
+Cygwin: (http://sourceware.cygnus.com/cygwin/)
+Cygwin does not have thread-safe libraries and should not be used
+for threaded applications.
+
+Generally:
+For convenience, the following pre-built files can be downloaded from
+the FTP site:
+
+ ftp://sourceware.cygnus.com/pub/pthreads-win32/dll-latest/
+
+ 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)
+
+These are the only files you need in order to build POSIX threads
+applications for Win32 using either MSVC or Mingw32.
+
+See the FAQ file in the source tree for additional information.
+
+
+Building the library with MSVC
+-------------------------------
+
+There is currently no Makefile for building the library under MSVC.
+There is a batch file "buildlib.bat" which will build the library.
+
+
+Why you can't build the library with Cygwin or Mingw32 (yet)
+------------------------------------------------------------
+
+The library makes use of exception handling internally (Win32 SEH if
+compiled with MSVC and C++ EH otherwise). Unfortunately, current
+versions of egcs (g++) do not have thread-safe exception handling
+and therefore the DLL pthread.dll cannot be built under either
+Mingw32 or Cygwin.
+
+
+Documentation
+-------------
+
+Currently, there is no documentation included in the package apart
+from the copious comments in the source code.
+
+For POSIX Thread API programming, several reference books are
+available:
+
+ Programming with POSIX Threads
+ David R. Butenhof
+ Addison-Wesley (pub)
+
+ Pthreads Programming
+ By Bradford Nichols, Dick Buttlar & Jacqueline Proulx Farrell
+ O'Reilly (pub)
+
+
+Acknowledgements
+----------------
+
+This library is based substantially on a Win32 pthreads
+implementation contributed by John Bossom <John.Bossom@cognos.com>.
+
+The implementation of condition variables is derived from the work
+of Douglas Schmidt et al
+(http://www.cs.wustl.edu/~schmidt/win32-cv-1.html).
+
+Project Contributors (in order of appearance):
+
+Ben Elliston <bje@cygnus.com>
+Ross Johnson <rpj@ise.canberra.edu.au>
+Robert Colquhoun <rjc@trump.net.au>
+John E. Bossom <John.Bossom@cognos.com>
+Anders Norlander <anorland@hem2.passagen.se>
+Tor Lillqvist <tml@iki.fi>
+Kevin Ruland <Kevin.Ruland@anheuser-busch.com>
+
+
+Enjoy!
+
+Ross Johnson