From 0083c9d56c584135b1fe2eca508b539e2bdf9666 Mon Sep 17 00:00:00 2001 From: Chadwick Boulay Date: Mon, 9 Mar 2015 21:12:25 -0400 Subject: [PATCH] Added pthreads-w32 to externals. Added external/msvc-support for lack of C99-compliance workarounds. Changes to test_tracker to support MSVC because it cannot create dynamically-sized arrays. Defined _USE_MATH_DEFINES in CMakeLists for MSVC. Fixes lack of math constants when importing math.h in MSVC. Add gettimeofday for MSVC. Taken from http://stackoverflow.com/a/26085827/1256069 , implied no license. Further small changes to support MSVC. Added instructions for MSVC. Moved MSVC implementation of usleep into unistd for easier use in other targets. Replaced __func__ with __FUNCTION__ for universal platform support. Replaced sleep with usleep for cross-platform support in psmovepair. Clarified some instructions in README.msvc. Also fixed MSVC building of OpenCV. Huge change to CMakeLists. More logical sectioning. Support for MSVC, and using PS3EYEDriver in Windows. Moved sprintf fix to msvc-support/unistd.h. Made small tweaks to example programs to make them MSVC-compatible. Now everything builds successfully in MSVC. Changed OSX's libusb path back. I tried but failed to build more recent versions. Added registry file necessary for Windows PS3EYEDriver support. Added README for MinGW 64. Renamed README files to make their use-cases more obvious. Fixed regression in CMakeLists regarding libusb's include directory. Only applied to MinGW builds. --- CMakeLists.txt | 449 +- README.win32 => README.win32_mingw64 | 0 README.win64_mingw64 | 76 + README.win64_msvc2013 | 68 + WINDOWS_EXTRA | 56 + examples/c/battery_check.c | 2 +- examples/c/test_record_video.c | 4 +- examples/c/test_roi_size.c | 26 +- examples/c/test_tracker.c | 5 +- external/README | 21 + external/msvc-support/getopt.c | 1258 ++++ external/msvc-support/getopt.h | 188 + external/msvc-support/stdint.h | 235 + external/msvc-support/unistd.c | 19 + external/msvc-support/unistd.h | 56 + external/pthreads-w32/ANNOUNCE | 483 ++ external/pthreads-w32/BUGS | 141 + external/pthreads-w32/CONTRIBUTORS | 140 + external/pthreads-w32/COPYING | 150 + external/pthreads-w32/COPYING.LIB | 504 ++ external/pthreads-w32/ChangeLog | 5211 +++++++++++++++++ external/pthreads-w32/FAQ | 451 ++ external/pthreads-w32/MAINTAINERS | 4 + external/pthreads-w32/NEWS | 1241 ++++ external/pthreads-w32/PROGRESS | 4 + external/pthreads-w32/README | 601 ++ external/pthreads-w32/README.Borland | 57 + external/pthreads-w32/README.CV | 3036 ++++++++++ external/pthreads-w32/README.NONPORTABLE | 783 +++ external/pthreads-w32/README.Watcom | 62 + external/pthreads-w32/README.WinCE | 6 + external/pthreads-w32/WinCE-PORT | 222 + external/pthreads-w32/dll/x64/pthreadGC2.dll | Bin 0 -> 185976 bytes external/pthreads-w32/dll/x64/pthreadVC2.dll | Bin 0 -> 82944 bytes external/pthreads-w32/dll/x86/pthreadGC2.dll | Bin 0 -> 119888 bytes external/pthreads-w32/dll/x86/pthreadGCE2.dll | Bin 0 -> 121953 bytes external/pthreads-w32/dll/x86/pthreadVC2.dll | Bin 0 -> 55808 bytes external/pthreads-w32/dll/x86/pthreadVCE2.dll | Bin 0 -> 61952 bytes external/pthreads-w32/dll/x86/pthreadVSE2.dll | Bin 0 -> 57344 bytes external/pthreads-w32/include/pthread.h | 1368 +++++ external/pthreads-w32/include/sched.h | 183 + external/pthreads-w32/include/semaphore.h | 169 + external/pthreads-w32/lib/x64/libpthreadGC2.a | Bin 0 -> 93692 bytes external/pthreads-w32/lib/x64/pthreadVC2.lib | Bin 0 -> 29738 bytes external/pthreads-w32/lib/x86/libpthreadGC2.a | Bin 0 -> 93480 bytes .../pthreads-w32/lib/x86/libpthreadGCE2.a | Bin 0 -> 93486 bytes external/pthreads-w32/lib/x86/pthreadVC2.lib | Bin 0 -> 30334 bytes external/pthreads-w32/lib/x86/pthreadVCE2.lib | Bin 0 -> 30460 bytes external/pthreads-w32/lib/x86/pthreadVSE2.lib | Bin 0 -> 30460 bytes ps3eye_settings.reg | Bin 0 -> 728 bytes src/psmove.c | 39 +- src/psmove_calibration.c | 2 + src/psmove_private.h | 4 +- src/tracker/psmove_tracker.c | 4 + src/utils/psmovepair.c | 2 +- 55 files changed, 17160 insertions(+), 170 deletions(-) rename README.win32 => README.win32_mingw64 (100%) create mode 100644 README.win64_mingw64 create mode 100644 README.win64_msvc2013 create mode 100644 WINDOWS_EXTRA create mode 100644 external/msvc-support/getopt.c create mode 100644 external/msvc-support/getopt.h create mode 100644 external/msvc-support/stdint.h create mode 100644 external/msvc-support/unistd.c create mode 100644 external/msvc-support/unistd.h create mode 100644 external/pthreads-w32/ANNOUNCE create mode 100644 external/pthreads-w32/BUGS create mode 100644 external/pthreads-w32/CONTRIBUTORS create mode 100644 external/pthreads-w32/COPYING create mode 100644 external/pthreads-w32/COPYING.LIB create mode 100644 external/pthreads-w32/ChangeLog create mode 100644 external/pthreads-w32/FAQ create mode 100644 external/pthreads-w32/MAINTAINERS create mode 100644 external/pthreads-w32/NEWS create mode 100644 external/pthreads-w32/PROGRESS create mode 100644 external/pthreads-w32/README create mode 100644 external/pthreads-w32/README.Borland create mode 100644 external/pthreads-w32/README.CV create mode 100644 external/pthreads-w32/README.NONPORTABLE create mode 100644 external/pthreads-w32/README.Watcom create mode 100644 external/pthreads-w32/README.WinCE create mode 100644 external/pthreads-w32/WinCE-PORT create mode 100644 external/pthreads-w32/dll/x64/pthreadGC2.dll create mode 100644 external/pthreads-w32/dll/x64/pthreadVC2.dll create mode 100644 external/pthreads-w32/dll/x86/pthreadGC2.dll create mode 100644 external/pthreads-w32/dll/x86/pthreadGCE2.dll create mode 100644 external/pthreads-w32/dll/x86/pthreadVC2.dll create mode 100644 external/pthreads-w32/dll/x86/pthreadVCE2.dll create mode 100644 external/pthreads-w32/dll/x86/pthreadVSE2.dll create mode 100644 external/pthreads-w32/include/pthread.h create mode 100644 external/pthreads-w32/include/sched.h create mode 100644 external/pthreads-w32/include/semaphore.h create mode 100644 external/pthreads-w32/lib/x64/libpthreadGC2.a create mode 100644 external/pthreads-w32/lib/x64/pthreadVC2.lib create mode 100644 external/pthreads-w32/lib/x86/libpthreadGC2.a create mode 100644 external/pthreads-w32/lib/x86/libpthreadGCE2.a create mode 100644 external/pthreads-w32/lib/x86/pthreadVC2.lib create mode 100644 external/pthreads-w32/lib/x86/pthreadVCE2.lib create mode 100644 external/pthreads-w32/lib/x86/pthreadVSE2.lib create mode 100644 ps3eye_settings.reg diff --git a/CMakeLists.txt b/CMakeLists.txt index 2f1cd3d3..18cf0bf2 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -6,22 +6,32 @@ project(PSMOVEAPI) include_directories(${PSMOVEAPI_SOURCE_DIR}/external/hidapi/hidapi) include_directories(${PSMOVEAPI_SOURCE_DIR}/external/glm) +# +# SETUP - variables, options, definitions +# + +# VARIABLES - Initialize API build variables. + +# API version set(PSMOVEAPI_MAJOR_VERSION "3") set(PSMOVEAPI_MINOR_VERSION "1") set(PSMOVEAPI_PATCH_VERSION "0") set(PSMOVEAPI_VERSION "${PSMOVEAPI_MAJOR_VERSION}.${PSMOVEAPI_MINOR_VERSION}.${PSMOVEAPI_PATCH_VERSION}") set(PSMOVEAPI_VERSION_SONAME "${PSMOVEAPI_MAJOR_VERSION}") +# API dependencies and source files will be added to these variables set(PSMOVEAPI_REQUIRED_LIBS) set(PSMOVEAPI_PLATFORM_SRC) +# Tracker dependencies and source files will be added to these variables set(PSMOVEAPI_TRACKER_REQUIRED_LIBS) set(PSMOVEAPI_TRACKER_PLATFORM_SRC) +# Targets to build will be added to this variable. set(PSMOVEAPI_INSTALL_TARGETS) -# Put any other libraries that you might need in here -link_directories(${PSMOVEAPI_SOURCE_DIR}/external/libs) + +# OPTIONS - Define CMake options # Language bindings option(PSMOVE_BUILD_QT_BINDINGS "Build the Qt bindings" OFF) @@ -30,16 +40,20 @@ option(PSMOVE_BUILD_CSHARP_BINDINGS "Build the C# bindings" OFF) option(PSMOVE_BUILD_PROCESSING_BINDINGS "Build the Processing bindings" OFF) option(PSMOVE_BUILD_PYTHON_BINDINGS "Build the Python bindings" ON) - -# Build the OpenCV-based camera tracking module? (see psmove_tracker.h) -option(PSMOVE_BUILD_TRACKER "Build the Tracker module (needs OpenCV)" ON) - # Additional applications that can be used to test the library option(PSMOVE_BUILD_EXAMPLES "Build the C examples" ON) option(PSMOVE_BUILD_OPENGL_EXAMPLES "Build the OpenGL examples" OFF) option(PSMOVE_BUILD_TESTS "Build the C tests" ON) option(PSMOVE_BUILD_TUIO_SERVER "Build the TUIO server" OFF) +# Make a debug build with helpful output for debugging / maintenance +option(PSMOVE_USE_DEBUG "Build for debugging" OFF) + +# Build the OpenCV-based camera tracking module? (see psmove_tracker.h) +option(PSMOVE_BUILD_TRACKER "Build the Tracker module (needs OpenCV)" ON) + +# Option to statically link OpenCV instead of using the system-wide install +option(PSMOVE_USE_LOCAL_OPENCV "Use locally-built OpenCV (static linking)" OFF) # Enable tweaks (e.g. registry settings on Windows, ...) for PS Eye option(PSMOVE_USE_PSEYE "Enable tweaks for the PS Eye camera" ON) @@ -53,21 +67,13 @@ option(PSMOVE_USE_PS3EYE_DRIVER "Use the PS3EYEDriver on OS X" OFF) # To show the OpenCV camera capture window everytime (useful for debugging) option(PSMOVE_USE_DEBUG_CAPTURE "Always show camera capture input" OFF) -# Make a debug build with helpful output for debugging / maintenance -option(PSMOVE_USE_DEBUG "Build for debugging" OFF) - # Write debugging images for tracking calibration to home directory option(PSMOVE_USE_TRACKER_TRACE "Write tracker calibration images to disk" OFF) # Madgwick's orientation algorithm (GPL-licensed) option(PSMOVE_USE_MADGWICK_AHRS "Use AHRS algorithm (GPL license)" OFF) -# We recommend using MinGW-w64 for the Windows builds which generates -# position-independent code by default, so skip this for Windows builds. -if(NOT ${CMAKE_SYSTEM_NAME} MATCHES "Windows") - # https://github.com/thp/psmoveapi/issues/29 - add_definitions(-fPIC) -endif() +# DEFINITIONS - typically preprocessor definitions (-D) and other flags # Required by pthread, must be defined before include of any standard header. # It's easier to do this here once instead of multiple times in different source/header files. @@ -80,98 +86,74 @@ if(${CMAKE_SYSTEM_NAME} MATCHES "Windows") add_definitions(-DWIN32_LEAN_AND_MEAN) endif() +# MinGW-w64 generates position-independent code by default, so skip this for Windows builds. +if(NOT MINGW) + # https://github.com/thp/psmoveapi/issues/29 + add_definitions(-fPIC) +endif() + +# Windows' math include does not define constants by default. +# Set this definition so it does. +# Also set NOMINMAX so the min and max functions are not overwritten with macros. +IF(MSVC) + add_definitions(-D_USE_MATH_DEFINES) + add_definitions(-DNOMINMAX) +ENDIF() + # Debugging output if(PSMOVE_USE_DEBUG) add_definitions(-DPSMOVE_DEBUG) add_definitions(-g -O0 -Wall) set(INFO_USE_DEBUG "Yes") else() - add_definitions(-O2 -Wall -Wno-unused) + add_definitions(-O2 -Wall) + if(NOT MSVC) + add_definitions(-Wno-unused) + endif(NOT MSVC) set(INFO_USE_DEBUG "No") endif() +# Camera debugging +if (PSMOVE_USE_DEBUG_CAPTURE) + add_definitions(-DCAMERA_CONTROL_DEBUG_CAPTURED_IMAGE) +endif() + # AHRS algorithm if(PSMOVE_USE_MADGWICK_AHRS) add_definitions(-DPSMOVE_WITH_MADGWICK_AHRS) - set(INFO_LICENSE "GPL") set(INFO_AHRS_ALGORITHM "Madgwick AHRS") set(PSMOVEAPI_ALGORITHM_SRC ${PSMOVEAPI_SOURCE_DIR}/external/MadgwickAHRS/MadgwickAHRS.c ) else() - if (PSMOVE_USE_PS3EYE_DRIVER) - # PS3EYEDriver is based on GPL'd code as well - set(INFO_LICENSE "GPL") - else() - set(INFO_LICENSE "BSD") - endif() set(INFO_AHRS_ALGORITHM "None") set(PSMOVEAPI_ALGORITHM_SRC) endif() +# INFO_LICENSE +set(INFO_LICENSE "BSD") #Default +if((PSMOVE_USE_MADGWICK_AHRS) OR (PSMOVE_USE_PS3EYE_DRIVER) OR (MSVC)) + # Each of the above uses GPL'd code. + set(INFO_LICENSE "GPL") +endif() + # Linker commands to put into the .pc file (when installing) set(PSMOVEAPI_PKGCONFIG_LIBS "-lpsmoveapi") -# Tracker support -if(PSMOVE_BUILD_TRACKER) - FIND_PACKAGE(OpenCV QUIET) - if(OpenCV_FOUND) - list(APPEND PSMOVEAPI_TRACKER_REQUIRED_LIBS ${OpenCV_LIBS}) - - set(INFO_BUILD_TRACKER "Yes") - set(PSMOVEAPI_PKGCONFIG_LIBS "${PSMOVEAPI_PKGCONFIG_LIBS} -lpsmoveapi_tracker") - else() - set(INFO_BUILD_TRACKER "No (OpenCV not found)") - set(PSMOVE_BUILD_TRACKER OFF) - endif() -else() - set(INFO_BUILD_TRACKER "No (disabled)") -endif() +# Put any other libraries that you might need in here +link_directories(${PSMOVEAPI_SOURCE_DIR}/external/libs) -# Option to statically link OpenCV instead of using the system-wide install -option(PSMOVE_USE_LOCAL_OPENCV "Use locally-built OpenCV (static linking)" OFF) -if (PSMOVE_USE_LOCAL_OPENCV) - # Force tracker build with a locally-built opencv library installation - set(OPENCV_SRC_DIR ${CMAKE_CURRENT_SOURCE_DIR}/opencv) - link_directories(${OPENCV_SRC_DIR}/build/lib) - link_directories(${OPENCV_SRC_DIR}/build/3rdparty/lib) - include_directories(${OPENCV_SRC_DIR}/modules/core/include) - include_directories(${OPENCV_SRC_DIR}/modules/imgproc/include) - include_directories(${OPENCV_SRC_DIR}/modules/highgui/include) - set(PSMOVE_BUILD_TRACKER ON) - set(INFO_BUILD_TRACKER "Yes (with local OpenCV)") - - if (${CMAKE_SYSTEM_NAME} MATCHES "Darwin") - find_library(QUARTZCORE QuartzCore) - find_library(APPKIT AppKit) - find_library(QTKIT QTKit) - find_library(AVFOUNDATION AVFoundation) - - list(APPEND PSMOVEAPI_TRACKER_REQUIRED_LIBS - opencv_core opencv_highgui opencv_imgproc - libjpeg libpng zlib stdc++ - ${QUARTZCORE} - ${APPKIT} - ${QTKIT} - ${AVFOUNDATION}) - elseif(${CMAKE_SYSTEM_NAME} MATCHES "Windows") - list(APPEND PSMOVEAPI_TRACKER_REQUIRED_LIBS - opencv_highgui2410 opencv_imgproc2410 opencv_core2410 - libjpeg libpng zlib stdc++ - vfw32 comctl32) - else() - # XXX: OpenCV dependencies for Linux - endif() -endif() +# This should be on by default in latest MinGW and MSVC >= 2013, but just in case. +IF(${CMAKE_SYSTEM_NAME} MATCHES "Windows") + set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -std=c++11") +ENDIF() -if (PSMOVE_USE_DEBUG_CAPTURE) - add_definitions(-DCAMERA_CONTROL_DEBUG_CAPTURED_IMAGE) -endif() +# +# PSMOVEAPI - Platform Support +# -set(INFO_USE_CL_EYE_SDK "No (Windows only)") -set(INFO_USE_PS3EYE_DRIVER "No (OS X only)") +# frameworks, source, HID, threading, bluetooth set(INFO_BLUEZ5_SUPPORT "No") - IF(${CMAKE_SYSTEM_NAME} MATCHES "Darwin") find_library(FOUNDATION Foundation) find_library(AVFOUNDATION AVFoundation) @@ -183,89 +165,59 @@ IF(${CMAKE_SYSTEM_NAME} MATCHES "Darwin") list(APPEND PSMOVEAPI_REQUIRED_LIBS ${IOKIT}) list(APPEND PSMOVEAPI_REQUIRED_LIBS ${COREFOUNDATION}) list(APPEND PSMOVEAPI_REQUIRED_LIBS ${IOBLUETOOTH}) - + + list(APPEND PSMOVEAPI_PLATFORM_SRC + ${PSMOVEAPI_SOURCE_DIR}/src/platform/psmove_osxsupport.m) + set(HIDAPI_SRC ${PSMOVEAPI_SOURCE_DIR}/external/hidapi/mac/hid.c) - + # Build Universal Binaries for OS X set(CMAKE_OSX_ARCHITECTURES "x86_64") - list(APPEND PSMOVEAPI_PLATFORM_SRC - ${PSMOVEAPI_SOURCE_DIR}/src/platform/psmove_osxsupport.m) - - list(APPEND PSMOVEAPI_TRACKER_PLATFORM_SRC - ${PSMOVEAPI_SOURCE_DIR}/src/tracker/platform/psmove_osxsupport.m - ${PSMOVEAPI_SOURCE_DIR}/src/tracker/platform/camera_control_macosx.c) - - if(PSMOVE_USE_PS3EYE_DRIVER) - add_definitions(-DCAMERA_CONTROL_USE_PS3EYE_DRIVER) - list(APPEND PSMOVEAPI_TRACKER_PLATFORM_SRC - ${PSMOVEAPI_SOURCE_DIR}/external/PS3EYEDriver/src/ps3eye.cpp - ${PSMOVEAPI_SOURCE_DIR}/external/PS3EYEDriver/src/ps3eyedriver.cpp) - include_directories(${PSMOVEAPI_SOURCE_DIR}/external/PS3EYEDriver/src) - - # Option to statically link OpenCV instead of using the system-wide install - option(PSMOVE_USE_LOCAL_LIBUSB "Use locally-built libusb (static linking)" OFF) - if (PSMOVE_USE_LOCAL_LIBUSB) - set(INFO_USE_PS3EYE_DRIVER "Yes (static libusb)") - # Assume the user has built libusb in external/libusb-1.0.9/ - list(APPEND PSMOVEAPI_TRACKER_REQUIRED_LIBS - ${PSMOVEAPI_SOURCE_DIR}/external/libusb-1.0.9/build/libusb/.libs/libusb-1.0.a) - include_directories(${PSMOVEAPI_SOURCE_DIR}/external/libusb-1.0.9/libusb) - else() - set(INFO_USE_PS3EYE_DRIVER "Yes") - # Use pkg-config to link against libusb-1.0 - find_package(PkgConfig REQUIRED) - pkg_check_modules(LIBUSB REQUIRED libusb-1.0) - - list(APPEND PSMOVEAPI_TRACKER_REQUIRED_LIBS ${LIBUSB_LIBRARIES}) - include_directories(${LIBUSB_INCLUDE_DIRS}) - link_directories(${LIBUSB_LIBDIR}) - endif() - else() - set(INFO_USE_PS3EYE_DRIVER "No (disabled)") - endif() ELSEIF(${CMAKE_SYSTEM_NAME} MATCHES "Windows") list(APPEND PSMOVEAPI_REQUIRED_LIBS setupapi bthprops kernel32 ws2_32 winmm) - + + if(MINGW) # http://stackoverflow.com/questions/4702732/the-program-cant-start-because-libgcc-s-dw2-1-dll-is-missing set(CMAKE_EXE_LINKER_FLAGS "${CMAKE_EXE_LINKER_FLAGS} -static -static-libgcc -static-libstdc++") set(CMAKE_SHARED_LINKER_FLAGS "${CMAKE_SHARED_LINKER_FLAGS} -static -static-libgcc -static-libstdc++") set(CMAKE_STATIC_LIBRARY_FLAGS "${CMAKE_STATIC_LIBRARY_FLAGS} -static -static-libgcc -static-libstdc++") + endif() - if (NOT CMAKE_TOOLCHAIN_FILE) + if ((NOT CMAKE_TOOLCHAIN_FILE) AND (MINGW)) # Only include these if we are NOT cross-compiling on Linux include_directories(${CMAKE_CURRENT_SOURCE_DIR}/external/mingw-w64-headers) link_directories(${CMAKE_CURRENT_SOURCE_DIR}/external/mingw-w64-headers) endif() - IF(PSMOVE_USE_CL_EYE_SDK) - find_path(CL_EYE_SDK_PATH Bin/CLEyeMulticam.dll - HINTS "C:/Program Files/Code Laboratories/CL-Eye Platform SDK" - "C:/Program Files (x86)/Code Laboratories/CL-Eye Platform SDK") - IF(CL_EYE_SDK_PATH) - add_definitions(-DCAMERA_CONTROL_USE_CL_DRIVER) - list(APPEND PSMOVEAPI_TRACKER_REQUIRED_LIBS CLEyeMulticam) - file(COPY ${CL_EYE_SDK_PATH}/Bin/CLEyeMulticam.dll - DESTINATION ${PSMOVEAPI_SOURCE_DIR}/external/libs) - set(INFO_USE_CL_EYE_SDK "Yes") - - # XXX: If this crashes, disable compiler optimizations - else() - set(INFO_USE_CL_EYE_SDK "No (SDK not found)") - ENDIF() - else() - set(INFO_USE_CL_EYE_SDK "No (disabled)") - ENDIF() - - set(HIDAPI_SRC ${PSMOVEAPI_SOURCE_DIR}/external/hidapi/windows/hid.c) - list(APPEND PSMOVEAPI_PLATFORM_SRC ${PSMOVEAPI_SOURCE_DIR}/src/platform/psmove_winsupport.c) + + set(HIDAPI_SRC ${PSMOVEAPI_SOURCE_DIR}/external/hidapi/windows/hid.c) + + # Threading and other libraries that come free with linux, osx, and MinGW but not MSVC. + if (MSVC) + set(PTHREADS_DIR ${CMAKE_CURRENT_SOURCE_DIR}/external/pthreads-w32) + include_directories(${PTHREADS_DIR}/include) + if(CMAKE_SIZEOF_VOID_P EQUAL 8) + link_directories(${PTHREADS_DIR}/lib/x64) + else() + link_directories(${PTHREADS_DIR}/lib/x86) + endif() + list(APPEND PSMOVEAPI_REQUIRED_LIBS pthreadVC2) + include_directories(${CMAKE_CURRENT_SOURCE_DIR}/external/msvc-support) + list(APPEND PSMOVEAPI_PLATFORM_SRC ${PSMOVEAPI_SOURCE_DIR}/external/msvc-support/getopt.c) + list(APPEND PSMOVEAPI_PLATFORM_SRC ${PSMOVEAPI_SOURCE_DIR}/external/msvc-support/unistd.c) + endif() - list(APPEND PSMOVEAPI_TRACKER_PLATFORM_SRC - ${PSMOVEAPI_SOURCE_DIR}/src/tracker/platform/camera_control_win32.c) ELSE() # Linux + + list(APPEND PSMOVEAPI_PLATFORM_SRC + ${PSMOVEAPI_SOURCE_DIR}/src/platform/psmove_linuxsupport.c) + + set(HIDAPI_SRC ${PSMOVEAPI_SOURCE_DIR}/external/hidapi/linux/hid.c) + find_package(PkgConfig REQUIRED) find_package(Threads REQUIRED) list(APPEND PSMOVEAPI_REQUIRED_LIBS ${CMAKE_THREAD_LIBS_INIT}) @@ -287,17 +239,186 @@ ELSE() include_directories(${BLUEZ_INCLUDE_DIRS}) list(APPEND PSMOVEAPI_REQUIRED_LIBS ${BLUEZ_LIBRARIES}) + +ENDIF() - set(HIDAPI_SRC ${PSMOVEAPI_SOURCE_DIR}/external/hidapi/linux/hid.c) - list(APPEND PSMOVEAPI_PLATFORM_SRC - ${PSMOVEAPI_SOURCE_DIR}/src/platform/psmove_linuxsupport.c) +# +# TRACKER - Platform support +# +# 1 - Source +IF(${CMAKE_SYSTEM_NAME} MATCHES "Darwin") + list(APPEND PSMOVEAPI_TRACKER_PLATFORM_SRC + ${PSMOVEAPI_SOURCE_DIR}/src/tracker/platform/psmove_osxsupport.m + ${PSMOVEAPI_SOURCE_DIR}/src/tracker/platform/camera_control_macosx.c) +ELSEIF(${CMAKE_SYSTEM_NAME} MATCHES "Windows") + list(APPEND PSMOVEAPI_TRACKER_PLATFORM_SRC + ${PSMOVEAPI_SOURCE_DIR}/src/tracker/platform/camera_control_win32.c) + if(MSVC) + include_directories(${CMAKE_CURRENT_SOURCE_DIR}/external/msvc-support) + list(APPEND PSMOVEAPI_TRACKER_PLATFORM_SRC ${PSMOVEAPI_SOURCE_DIR}/external/msvc-support/getopt.c) + list(APPEND PSMOVEAPI_TRACKER_PLATFORM_SRC ${PSMOVEAPI_SOURCE_DIR}/external/msvc-support/unistd.c) + endif(MSVC) +ELSE() list(APPEND PSMOVEAPI_TRACKER_PLATFORM_SRC ${PSMOVEAPI_SOURCE_DIR}/src/tracker/platform/psmove_linuxsupport.c ${PSMOVEAPI_SOURCE_DIR}/src/tracker/platform/camera_control_linux.c) ENDIF() +# 2 - OpenCV +if(PSMOVE_BUILD_TRACKER) + # OpenCV required. Either system or local. + if (NOT PSMOVE_USE_LOCAL_OPENCV) # System OpenCV must be present. + FIND_PACKAGE(OpenCV QUIET) + if(OpenCV_FOUND) + list(APPEND PSMOVEAPI_TRACKER_REQUIRED_LIBS ${OpenCV_LIBS}) + set(INFO_BUILD_TRACKER "Yes") + set(PSMOVEAPI_PKGCONFIG_LIBS "${PSMOVEAPI_PKGCONFIG_LIBS} -lpsmoveapi_tracker") + else() # System OpenCV specified but not found. Cannot build tracker. + set(INFO_BUILD_TRACKER "No (OpenCV not found)") + set(PSMOVE_BUILD_TRACKER OFF) + endif() + else() #PSMOVE_USE_LOCAL_OPENCV + + # Force tracker build with a locally-built opencv library installation + set(OPENCV_SRC_DIR ${CMAKE_CURRENT_SOURCE_DIR}/opencv) + + #MSVC adds /Release to the OpenCV build directories. Can be fixed with CMAKE_LIBRARY_OUTPUT_DIRECTORY but we don't want to edit OpenCV's CMakeLists.txt + set(MSVC_SUFFIX "") + if (MSVC) + set(MSVC_SUFFIX "/Release") + endif() + + link_directories(${OPENCV_SRC_DIR}/build/lib${MSVC_SUFFIX}) + link_directories(${OPENCV_SRC_DIR}/build/3rdparty/lib${MSVC_SUFFIX}) + + #include_directories(${OPENCV_INSTALL_DIR}/include) + include_directories(${OPENCV_SRC_DIR}/modules/core/include) + include_directories(${OPENCV_SRC_DIR}/modules/imgproc/include) + include_directories(${OPENCV_SRC_DIR}/modules/highgui/include) + + set(PSMOVE_BUILD_TRACKER ON) + set(INFO_BUILD_TRACKER "Yes (with local OpenCV)") + + #Platform-specific settings for OpenCV + if (${CMAKE_SYSTEM_NAME} MATCHES "Darwin") + find_library(QUARTZCORE QuartzCore) + find_library(APPKIT AppKit) + find_library(QTKIT QTKit) + find_library(AVFOUNDATION AVFoundation) + + list(APPEND PSMOVEAPI_TRACKER_REQUIRED_LIBS + opencv_core opencv_highgui opencv_imgproc + libjpeg libpng zlib stdc++ + ${QUARTZCORE} + ${APPKIT} + ${QTKIT} + ${AVFOUNDATION}) + elseif(${CMAKE_SYSTEM_NAME} MATCHES "Windows") + list(APPEND PSMOVEAPI_TRACKER_REQUIRED_LIBS + opencv_highgui2411 opencv_imgproc2411 opencv_core2411 + libjpeg libpng zlib + vfw32 comctl32) + if (MINGW) + list(APPEND PSMOVEAPI_TRACKER_REQUIRED_LIBS stdc++) + endif() + else() + # XXX: OpenCV dependencies for Linux + endif() + endif() #PSMOVE_USE_LOCAL_OPENCV +else() # PSMOVE_BUILD_TRACKER + set(INFO_BUILD_TRACKER "No (disabled)") +endif() + +# 3 - Cameras +# Darwin: PSEYE with PS3EYEDriver, or other (e.g., iSight) +# Windows: PSEYE with CL_EYE_SDK (32-bit only), PSEYE with PS3EYEDriver (32- and 64-bit), or other (webcam) +# Linux: No specific settings as PSEYE is supported in kernel. + +set(INFO_USE_PS3EYE_DRIVER "No (Windows and OS X only)") +IF (PSMOVE_USE_PS3EYE_DRIVER AND (${CMAKE_SYSTEM_NAME} MATCHES "Darwin" OR ${CMAKE_SYSTEM_NAME} MATCHES "Windows")) + add_definitions(-DCAMERA_CONTROL_USE_PS3EYE_DRIVER) + list(APPEND PSMOVEAPI_TRACKER_PLATFORM_SRC + ${PSMOVEAPI_SOURCE_DIR}/external/PS3EYEDriver/src/ps3eye.cpp + ${PSMOVEAPI_SOURCE_DIR}/external/PS3EYEDriver/src/ps3eyedriver.cpp) + include_directories(${PSMOVEAPI_SOURCE_DIR}/external/PS3EYEDriver/src) + + # Option to statically link libusb-1.0 instead of using the system-wide install + option(PSMOVE_USE_LOCAL_LIBUSB "Use locally-built libusb (static linking)" OFF) + if (PSMOVE_USE_LOCAL_LIBUSB) + set(INFO_USE_PS3EYE_DRIVER "Yes (static libusb)") + + #Annoyingly, each platform builds to a slightly different directory + if(${CMAKE_SYSTEM_NAME} MATCHES "Darwin") + # Assume the user has built libusb in external/libusb-1.0.9/ + include_directories(${PSMOVEAPI_SOURCE_DIR}/external/libusb-1.0.9/libusb) + list(APPEND PSMOVEAPI_TRACKER_REQUIRED_LIBS + ${PSMOVEAPI_SOURCE_DIR}/external/libusb-1.0.9/build/libusb/.libs/libusb-1.0.a) + elseif(${CMAKE_SYSTEM_NAME} MATCHES "Windows") + # Assume the user has built libusb in external/libusb-1.0/ + if(MSVC) + include_directories(${PSMOVEAPI_SOURCE_DIR}/external/libusb-1.0/libusb) + if (${CMAKE_C_SIZEOF_DATA_PTR} EQUAL 8) + list(APPEND PSMOVEAPI_TRACKER_REQUIRED_LIBS + ${PSMOVEAPI_SOURCE_DIR}/external/libusb-1.0/x64/Release/lib/libusb-1.0.lib) + else() + list(APPEND PSMOVEAPI_TRACKER_REQUIRED_LIBS + ${PSMOVEAPI_SOURCE_DIR}/external/libusb-1.0/Win32/Release/lib/libusb-1.0.lib) + endif() + else() # MinGW, using pre-built binaries + include_directories(${PSMOVEAPI_SOURCE_DIR}/external/libusb-1.0/include/libusb-1.0) + if (${CMAKE_C_SIZEOF_DATA_PTR} EQUAL 8) + list(APPEND PSMOVEAPI_TRACKER_REQUIRED_LIBS + ${PSMOVEAPI_SOURCE_DIR}/external/libusb-1.0/MinGW64/static/libusb-1.0.a) + else() # TODO: Detect target bitness when cross-compiling? + list(APPEND PSMOVEAPI_TRACKER_REQUIRED_LIBS + ${PSMOVEAPI_SOURCE_DIR}/external/libusb-1.0/MinGW32/static/libusb-1.0.a) + endif() + endif() + endif() + + else() #e.g., using homebrew + set(INFO_USE_PS3EYE_DRIVER "Yes") + # Use pkg-config to link against libusb-1.0 + find_package(PkgConfig REQUIRED) + pkg_check_modules(LIBUSB REQUIRED libusb-1.0) + + list(APPEND PSMOVEAPI_TRACKER_REQUIRED_LIBS ${LIBUSB_LIBRARIES}) + include_directories(${LIBUSB_INCLUDE_DIRS}) + link_directories(${LIBUSB_LIBDIR}) + + endif() #PSMOVE_USE_LOCAL_LIBUSB + +else() + set(INFO_USE_PS3EYE_DRIVER "No (disabled)") +endif() + +set(INFO_USE_CL_EYE_SDK "No (Windows only)") +IF(PSMOVE_USE_CL_EYE_SDK AND ${CMAKE_SYSTEM_NAME} MATCHES "Windows") + #TODO: Check to see that this doesn't collide with PS3EYE_DRIVER + find_path(CL_EYE_SDK_PATH Bin/CLEyeMulticam.dll + HINTS "C:/Program Files/Code Laboratories/CL-Eye Platform SDK" + "C:/Program Files (x86)/Code Laboratories/CL-Eye Platform SDK") + IF(CL_EYE_SDK_PATH) + add_definitions(-DCAMERA_CONTROL_USE_CL_DRIVER) + list(APPEND PSMOVEAPI_TRACKER_REQUIRED_LIBS CLEyeMulticam) + file(COPY ${CL_EYE_SDK_PATH}/Bin/CLEyeMulticam.dll + DESTINATION ${PSMOVEAPI_SOURCE_DIR}/external/libs) + set(INFO_USE_CL_EYE_SDK "Yes") + + # XXX: If this crashes, disable compiler optimizations + else() + set(INFO_USE_CL_EYE_SDK "No (SDK not found)") + ENDIF() +else() + set(INFO_USE_CL_EYE_SDK "No (disabled)") +ENDIF() + +# +# Library and tracker headers and source +# + include_directories(${PSMOVEAPI_SOURCE_DIR}/include) file(GLOB PSMOVEAPI_MOVED_SRC @@ -327,6 +448,10 @@ list(APPEND PSMOVEAPI_LIBRARY_SRC ${PSMOVEAPI_MOVED_SRC}) list(APPEND PSMOVEAPI_LIBRARY_SRC ${PSMOVEAPI_PLATFORM_SRC}) list(APPEND PSMOVEAPI_LIBRARY_SRC ${PSMOVEAPI_ALGORITHM_SRC}) +# +# CONFIGURE TARGETS +# + # Shared library add_library(psmoveapi SHARED ${PSMOVEAPI_LIBRARY_SRC}) @@ -336,6 +461,9 @@ set_target_properties(psmoveapi PROPERTIES SOVERSION ${PSMOVEAPI_VERSION_SONAME}) set_target_properties(psmoveapi PROPERTIES COMPILE_FLAGS -DBUILDING_SHARED_LIBRARY) + if(MINGW) + set_target_properties(psmoveapi PROPERTIES LINK_FLAGS "-Wl,--output-def,libpsmoveapi.def") #Facilitate making .lib files for MSVC linking + endif(MINGW) list(APPEND PSMOVEAPI_INSTALL_TARGETS psmoveapi) # Static library @@ -358,6 +486,9 @@ if(PSMOVE_BUILD_TRACKER) SOVERSION ${PSMOVEAPI_VERSION_SONAME}) set_target_properties(psmoveapi_tracker PROPERTIES COMPILE_FLAGS -DBUILDING_SHARED_LIBRARY) + if(MINGW) + set_target_properties(psmoveapi_tracker PROPERTIES LINK_FLAGS "-Wl,--output-def,libpsmoveapi_tracker.def") #Facilitate making .lib files for MSVC linking + endif(MINGW) list(APPEND PSMOVEAPI_INSTALL_TARGETS psmoveapi_tracker) add_library(psmoveapi_tracker_static STATIC @@ -373,7 +504,11 @@ endif() # Essential utilities foreach(UTILITY moved psmovepair magnetometer_calibration psmove_dfu_mode psmove_auth_response psmove_get_firmware_info) - add_executable(${UTILITY} src/utils/${UTILITY}.c) + if(NOT MSVC) + add_executable(${UTILITY} src/utils/${UTILITY}.c) + else(NOT MSVC) + add_executable(${UTILITY} src/utils/${UTILITY}.c ${PSMOVEAPI_SOURCE_DIR}/external/msvc-support/getopt.c ${PSMOVEAPI_SOURCE_DIR}/external/msvc-support/unistd.c) + endif() target_link_libraries(${UTILITY} psmoveapi_static) set_target_properties(${UTILITY} PROPERTIES COMPILE_FLAGS -DUSING_STATIC_LIBRARY) @@ -384,7 +519,11 @@ endforeach() # C examples if(PSMOVE_BUILD_EXAMPLES) foreach(EXAMPLE example multiple dump_calibration battery_check) - add_executable(${EXAMPLE} examples/c/${EXAMPLE}.c) + if(NOT MSVC) + add_executable(${EXAMPLE} examples/c/${EXAMPLE}.c) + else(NOT MSVC) + add_executable(${EXAMPLE} examples/c/${EXAMPLE}.c ${PSMOVEAPI_SOURCE_DIR}/external/msvc-support/getopt.c ${PSMOVEAPI_SOURCE_DIR}/external/msvc-support/unistd.c) + endif() target_link_libraries(${EXAMPLE} psmoveapi) endforeach() @@ -413,7 +552,11 @@ if(PSMOVE_BUILD_EXAMPLES) if(PSMOVE_BUILD_TRACKER) foreach(EXAMPLE distance_calibration) - add_executable(${EXAMPLE} examples/c/${EXAMPLE}.c) + if(NOT MSVC) + add_executable(${EXAMPLE} examples/c/${EXAMPLE}.c) + else(NOT MSVC) + add_executable(${EXAMPLE} examples/c/${EXAMPLE}.c ${PSMOVEAPI_SOURCE_DIR}/external/msvc-support/getopt.c ${PSMOVEAPI_SOURCE_DIR}/external/msvc-support/unistd.c) + endif() target_link_libraries(${EXAMPLE} psmoveapi psmoveapi_tracker) endforeach() endif() @@ -423,13 +566,21 @@ endif() # C test programs if(PSMOVE_BUILD_TESTS) foreach(TESTNAME led_update read_performance calibration responsiveness extension led_pwm_frequency) - add_executable(test_${TESTNAME} examples/c/test_${TESTNAME}.c) + if(NOT MSVC) + add_executable(test_${TESTNAME} examples/c/test_${TESTNAME}.c) + else(NOT MSVC) + add_executable(test_${TESTNAME} examples/c/test_${TESTNAME}.c ${PSMOVEAPI_SOURCE_DIR}/external/msvc-support/getopt.c ${PSMOVEAPI_SOURCE_DIR}/external/msvc-support/unistd.c) + endif() target_link_libraries(test_${TESTNAME} psmoveapi) endforeach(TESTNAME) if(PSMOVE_BUILD_TRACKER) foreach(TESTNAME tracker capture_performance record_video roi_size end2end_latency) - add_executable(test_${TESTNAME} examples/c/test_${TESTNAME}.c) + if(NOT MSVC) + add_executable(test_${TESTNAME} examples/c/test_${TESTNAME}.c) + else(NOT MSVC) + add_executable(test_${TESTNAME} examples/c/test_${TESTNAME}.c ${PSMOVEAPI_SOURCE_DIR}/external/msvc-support/getopt.c ${PSMOVEAPI_SOURCE_DIR}/external/msvc-support/unistd.c) + endif() target_link_libraries(test_${TESTNAME} psmoveapi psmoveapi_tracker) endforeach(TESTNAME) diff --git a/README.win32 b/README.win32_mingw64 similarity index 100% rename from README.win32 rename to README.win32_mingw64 diff --git a/README.win64_mingw64 b/README.win64_mingw64 new file mode 100644 index 00000000..3bbb6fff --- /dev/null +++ b/README.win64_mingw64 @@ -0,0 +1,76 @@ +Requirements +------------ + +- MinGW + http://mingw-w64.sourceforge.net/ + (Actually I used tdm64-gcc-4.9.2-3 but this should make no difference. http://tdm-gcc.tdragon.net/download) + See README.win32 for instructions on how to get MinGW-w64, be sure to get the 64-bit Windows archive. + +- CMake + http://www.cmake.org/cmake/resources/software.html +- OpenCV + http://sourceforge.net/projects/opencvlibrary/files/opencv-win/ +- Git + http://code.google.com/p/msysgit/ + +1. Clone the PS Move API repository + + git clone --recursive https://github.com/cboulay/psmoveapi.git + cd psmoveapi + +2. Get libusb-1.0 built binaries (Needed for PS3EYEDriver use in tracker) + http://libusb.info/ + Downloads -> latest windows binaries + Unpack into psmoveapi\external\libusb-1.0 + +3. Build OpenCV repository (Needed for tracker) + Download opencv-2.4.11.zip from http://sourceforge.net/projects/opencvlibrary/files/opencv-unix/ + (Yes, I know it says unix, but all we need are the sources.) + Unpack it into psmoveapi\ and trim the version off the directory name (i.e. psmoveapi\opencv) + Open a MinGW command prompt to the psmoveapi\opencv directory. + mkdir build + cd build + cmake .. -G "MinGW Makefiles" -DBUILD_SHARED_LIBS=0 -DBUILD_PERF_TESTS=OFF -DBUILD_TESTS=OFF -DBUILD_DOCS=OFF -DBUILD_opencv_flann=OFF -DBUILD_opencv_features2d=OFF -DBUILD_opencv_objdetect=OFF -DBUILD_opencv_photo=OFF -DBUILD_opencv_ts=OFF -DBUILD_opencv_ml=OFF -DBUILD_opencv_video=OFF -DBUILD_opencv_java=OFF -DWITH_OPENEXR=OFF -DWITH_FFMPEG=OFF -DWITH_JASPER=OFF -DWITH_TIFF=OFF + mingw32-make -j4 + mingw32-make install + +4. Build psmoveapi + + cd ..\.. + mkdir build + cd build + SET CMAKE_CXX_FLAGS=%CMAKE_CXX_FLAGS% -std=c++11 + cmake .. -G "MinGW Makefiles" -DPSMOVE_BUILD_PYTHON_BINDINGS=0 -DPSMOVE_USE_LOCAL_OPENCV=1 -DPSMOVE_USE_MADGWICK_AHRS=1 -DPSMOVE_USE_PS3EYE_DRIVER=1 -DPSMOVE_USE_LOCAL_LIBUSB=1 + mingw32-make + +5. Read WINDOWS_EXTRA for windows-specific information on pairing and connecting the psmove controller and on using the PS3Eye camera. + +6. Start one of the desired test applications + + If you previously chose to build the example applications (which is the + default), you can then run + + example.exe + + for a basic example. + +For questions, please read the archives of the PS Move Mailing List. If you +cannot find an answer to your question in the archives, send an e-mail: + + https://groups.google.com/forum/#!aboutgroup/psmove + +7. If you intend to build the libraries with MinGW but use with MSVC, http://www.mingw.org/wiki/MSVC_and_MinGW_DLLs + +Option 1 to create the DEF files is to edit CMakeLists.txt. For example, +if (MINGW) + set_target_properties(psmoveapi_tracker PROPERTIES LINK_FLAGS "-Wl,--output-def,libpsmoveapi_tracker.def") +endif (MINGW) + +Option 2 is to hand-craft them. https://wiki.videolan.org/GenerateLibFromDll +Open a MSVC command prompt to the directory where you built the libraries. +dumpbin /exports libpsmoveapi.dll > libpsmoveapi.def +dumpbin /exports libpsmoveapi_tracker.dll > libpsmoveapi_tracker.def +Now edit each def so the first line is EXPORTS and the remaining lines are the symbol names. + + lib /MACHINE:X64 /DEF:libpsmoveapi.def + lib /MACHINE:X64 /DEF:libpsmoveapi_tracker.def \ No newline at end of file diff --git a/README.win64_msvc2013 b/README.win64_msvc2013 new file mode 100644 index 00000000..511b27c4 --- /dev/null +++ b/README.win64_msvc2013 @@ -0,0 +1,68 @@ +Requirements +------------ + +- Visual Studio Community 2013 + http://www.visualstudio.com/en-us/news/vs2013-community-vs.aspx +- CMake + http://www.cmake.org/cmake/resources/software.html +- OpenCV + http://sourceforge.net/projects/opencvlibrary/files/opencv-win/ +- Git + http://code.google.com/p/msysgit/ + +1. Clone the PS Move API repository + `git clone --recursive https://github.com/cboulay/psmoveapi.git` + `cd psmoveapi` + +2. Get libusb-1.0 + Go to http://libusb.info/ and download the latest source (tarball). + Unpack the folder into psmoveapi\external\ and rename the folder to libusb-1.0 + i.e. psmoveapi\external\libusb-1.0 + + In that folder, open msvc\libusb_2013.sln + Change the target to Release x64 (at the top of the Visual Studio window). + Build the solution. + +3. OpenCV + Download opencv-2.4.11.zip from http://sourceforge.net/projects/opencvlibrary/files/opencv-unix/ + (Yes, I know it says unix, but all we need are the sources.) + Unpack it into psmoveapi\ and trim the version off the directory name (i.e. psmoveapi\opencv) + + Open a VS2013 command prompt to the psmoveapi\opencv directory: + + `mkdir build` + `cd build` + `cmake .. -G "Visual Studio 12 Win64" -DBUILD_SHARED_LIBS=0 -DBUILD_WITH_STATIC_CRT=OFF -DBUILD_PERF_TESTS=OFF -DBUILD_TESTS=OFF -DBUILD_DOCS=OFF -DBUILD_opencv_apps=OFF -DBUILD_opencv_flann=OFF -DBUILD_opencv_features2d=OFF -DBUILD_opencv_objdetect=OFF -DBUILD_opencv_photo=OFF -DBUILD_opencv_ts=OFF -DBUILD_opencv_ml=OFF -DBUILD_opencv_video=OFF -DBUILD_opencv_java=OFF -DWITH_OPENEXR=OFF -DWITH_FFMPEG=OFF -DWITH_JASPER=OFF -DWITH_TIFF=OFF` + + Open the solution in psmoveapi\opencv\build\OpenCV.sln + Change the target to Release (at the top of the Visual Studio window). + Build the solution. + +4. Build psmoveapi + + Still in the VS2013 command prompt: + + `cd ..\..` + `mkdir build ` + `cd build` + `cmake .. -G "Visual Studio 12 Win64" -DPSMOVE_BUILD_PYTHON_BINDINGS=0 -DPSMOVE_USE_LOCAL_OPENCV=1 -DPSMOVE_USE_MADGWICK_AHRS=1 -DPSMOVE_USE_PS3EYE_DRIVER=1 -DPSMOVE_USE_LOCAL_LIBUSB=1` + + Open the solution file. + Change the target to Release. + Build the projects psmoveapi, psmoveapi_tracker, and test_tracker (others untested). + +5. Read WINDOWS_EXTRA for windows-specific information on pairing and connecting the psmove controller and on using the PS3Eye camera. + +6. Start one of the desired test applications + + If you previously chose to build the example applications (which is the + default), you can then run + + example.exe + + for a basic example. + +For questions, please read the archives of the PS Move Mailing List. If you +cannot find an answer to your question in the archives, send an e-mail: + + https://groups.google.com/forum/#!aboutgroup/psmove diff --git a/WINDOWS_EXTRA b/WINDOWS_EXTRA new file mode 100644 index 00000000..a56af91a --- /dev/null +++ b/WINDOWS_EXTRA @@ -0,0 +1,56 @@ +There are a few quirks in Windows that make it somewhat difficult to use the psmoveapi. +While we continue to work to make it simpler, the following work-arounds may be necessary. + +Pairing the controller to the host +================================== + +Using the controllers' Bluetooth capabilities requires you to pair the +controller to the host computer first. That is what the psmovepair utility +is for. It is automatically built as part of the PS Move API. + +Make sure that Bluetooth is enabled on your computer, then connect a Move +controller via USB and run + +psmovepair.exe + +to store the host's Bluetooth device address in the Move and register the +controller. + +Try the remaining onscreen instructions but pairing is likely to fail at this point, then just Ctrl+C out of the program. + +Reboot your computer. (Maybe not necessary, but it reportedly helps some.) + +In Windows 8.1: + + Open "Devices and Printers." + You should see a grayed out Motion Controller device. + Double click on it to open its properties. + Click on the "Services" tab. We are looking for a checkbox "Drivers for keyboard, mice, etc (HID)" + If the box is unavailable, try pressing the PS button on your controller. + If that still does not make the box available, try running [psmove-pair-win](https://github.com/nitsch/psmove-pair-win). + When the box is available, check it. + Click OK. + Open regedit. + Navigate to HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\HidBth\Parameters\Devices + You will likely only have one key there for your device. Change its VirtuallyCabled DWORD value to 1. + Reboot. + +You should now be able to pair immediately by pressing the PS button on the controller. +If that fails then try the [psmove-pair-win] utility again. + +PS3EYE Camera +============= + +The PS3EYE Camera works in Windows using either the CLEyeDriver (32-bit programs only, non-free) +or the PS3EYEDriver. The PS3EYEDriver should work with 32-bit or 64-bit programs, and it is free. + +If you intend to use the PS3Eye camera then you currently need a registry entry for it. +Double click the provided ps3eye_settings.reg to enter the registry settings. + +In Windows 8.1: + The camera shows up as two interfaces to a single device. + The two interfaces are not distinguishable except that only the camera can be opened. + We have modified the PS3EYEDriver to work around this behaviour. + + If you are still getting crashes when trying to use the PS3EYEDriver in Windows, + then please report the problem in github. \ No newline at end of file diff --git a/examples/c/battery_check.c b/examples/c/battery_check.c index 6bdc8cd7..cb9ff713 100644 --- a/examples/c/battery_check.c +++ b/examples/c/battery_check.c @@ -87,7 +87,7 @@ int main(int argc, char* argv[]) if(buttons & Btn_PS) running = false; } - sleep(1); + usleep(1000000); } for(i=0; i. + Ditto for AIX 3.2 and . */ +#ifndef _NO_PROTO +# define _NO_PROTO +#endif + +#ifdef HAVE_CONFIG_H +# include +#endif + +#if !defined __STDC__ || !__STDC__ +/* This is a separate conditional since some stdc systems + reject `defined (const)'. */ +# ifndef const +# define const +# endif +#endif + +#include + +/* Comment out all this code if we are using the GNU C Library, and are not + actually compiling the library itself. This code is part of the GNU C + Library, but also included in many other GNU distributions. Compiling + and linking in this code is a waste when using the GNU C library + (especially if it is a shared library). Rather than having every GNU + program understand `configure --with-gnu-libc' and omit the object files, + it is simpler to just do this in the source for each such file. */ + +#define GETOPT_INTERFACE_VERSION 2 +#if !defined _LIBC && defined __GLIBC__ && __GLIBC__ >= 2 +# include +# if _GNU_GETOPT_INTERFACE_VERSION == GETOPT_INTERFACE_VERSION +# define ELIDE_CODE +# endif +#endif + +#ifndef ELIDE_CODE + + +/* This needs to come after some library #include + to get __GNU_LIBRARY__ defined. */ +#ifdef __GNU_LIBRARY__ +/* Don't include stdlib.h for non-GNU C libraries because some of them + contain conflicting prototypes for getopt. */ +# include +# include +#endif /* GNU C library. */ + +#ifdef VMS +# include +# if HAVE_STRING_H - 0 +# include +# endif +#endif + +#ifndef _ +/* This is for other GNU distributions with internationalized messages. */ +# if (HAVE_LIBINTL_H && ENABLE_NLS) || defined _LIBC +# include +# ifndef _ +# define _(msgid) gettext (msgid) +# endif +# else +# define _(msgid) (msgid) +# endif +# if defined _LIBC && defined USE_IN_LIBIO +# include +# endif +#endif + +/* This version of `getopt' appears to the caller like standard Unix `getopt' + but it behaves differently for the user, since it allows the user + to intersperse the options with the other arguments. + + As `getopt' works, it permutes the elements of ARGV so that, + when it is done, all the options precede everything else. Thus + all application programs are extended to handle flexible argument order. + + Setting the environment variable POSIXLY_CORRECT disables permutation. + Then the behavior is completely standard. + + GNU application programs can use a third alternative mode in which + they can distinguish the relative order of options and other arguments. */ + +#include "getopt.h" + +/* For communication from `getopt' to the caller. + When `getopt' finds an option that takes an argument, + the argument value is returned here. + Also, when `ordering' is RETURN_IN_ORDER, + each non-option ARGV-element is returned here. */ + +char *optarg; + +/* Index in ARGV of the next element to be scanned. + This is used for communication to and from the caller + and for communication between successive calls to `getopt'. + + On entry to `getopt', zero means this is the first call; initialize. + + When `getopt' returns -1, this is the index of the first of the + non-option elements that the caller should itself scan. + + Otherwise, `optind' communicates from one call to the next + how much of ARGV has been scanned so far. */ + +/* 1003.2 says this must be 1 before any call. */ +int optind = 1; + +/* Formerly, initialization of getopt depended on optind==0, which + causes problems with re-calling getopt as programs generally don't + know that. */ + +int __getopt_initialized; + +/* The next char to be scanned in the option-element + in which the last option character we returned was found. + This allows us to pick up the scan where we left off. + + If this is zero, or a null string, it means resume the scan + by advancing to the next ARGV-element. */ + +static char *nextchar; + +/* Callers store zero here to inhibit the error message + for unrecognized options. */ + +int opterr = 1; + +/* Set to an option character which was unrecognized. + This must be initialized on some systems to avoid linking in the + system's own getopt implementation. */ + +int optopt = '?'; + +/* Describe how to deal with options that follow non-option ARGV-elements. + + If the caller did not specify anything, + the default is REQUIRE_ORDER if the environment variable + POSIXLY_CORRECT is defined, PERMUTE otherwise. + + REQUIRE_ORDER means don't recognize them as options; + stop option processing when the first non-option is seen. + This is what Unix does. + This mode of operation is selected by either setting the environment + variable POSIXLY_CORRECT, or using `+' as the first character + of the list of option characters. + + PERMUTE is the default. We permute the contents of ARGV as we scan, + so that eventually all the non-options are at the end. This allows options + to be given in any order, even with programs that were not written to + expect this. + + RETURN_IN_ORDER is an option available to programs that were written + to expect options and other ARGV-elements in any order and that care about + the ordering of the two. We describe each non-option ARGV-element + as if it were the argument of an option with character code 1. + Using `-' as the first character of the list of option characters + selects this mode of operation. + + The special argument `--' forces an end of option-scanning regardless + of the value of `ordering'. In the case of RETURN_IN_ORDER, only + `--' can cause `getopt' to return -1 with `optind' != ARGC. */ + +static enum +{ + REQUIRE_ORDER, PERMUTE, RETURN_IN_ORDER +} ordering; + +/* Value of POSIXLY_CORRECT environment variable. */ +static char *posixly_correct; + +#ifdef __GNU_LIBRARY__ +/* We want to avoid inclusion of string.h with non-GNU libraries + because there are many ways it can cause trouble. + On some systems, it contains special magic macros that don't work + in GCC. */ +# include +# define my_index strchr +#else + +# if HAVE_STRING_H || WIN32 /* Pete Wilson mod 7/28/02 */ +# include +# else +# include +# endif + +/* Avoid depending on library functions or files + whose names are inconsistent. */ + +#ifndef getenv +extern char *getenv (); +#endif + +static char * +my_index (str, chr) + const char *str; + int chr; +{ + while (*str) + { + if (*str == chr) + return (char *) str; + str++; + } + return 0; +} + +/* If using GCC, we can safely declare strlen this way. + If not using GCC, it is ok not to declare it. */ +#ifdef __GNUC__ +/* Note that Motorola Delta 68k R3V7 comes with GCC but not stddef.h. + That was relevant to code that was here before. */ +# if (!defined __STDC__ || !__STDC__) && !defined strlen +/* gcc with -traditional declares the built-in strlen to return int, + and has done so at least since version 2.4.5. -- rms. */ +extern int strlen (const char *); +# endif /* not __STDC__ */ +#endif /* __GNUC__ */ + +#endif /* not __GNU_LIBRARY__ */ + +/* Handle permutation of arguments. */ + +/* Describe the part of ARGV that contains non-options that have + been skipped. `first_nonopt' is the index in ARGV of the first of them; + `last_nonopt' is the index after the last of them. */ + +static int first_nonopt; +static int last_nonopt; + +#ifdef _LIBC +/* Stored original parameters. + XXX This is no good solution. We should rather copy the args so + that we can compare them later. But we must not use malloc(3). */ +extern int __libc_argc; +extern char **__libc_argv; + +/* Bash 2.0 gives us an environment variable containing flags + indicating ARGV elements that should not be considered arguments. */ + +# ifdef USE_NONOPTION_FLAGS +/* Defined in getopt_init.c */ +extern char *__getopt_nonoption_flags; + +static int nonoption_flags_max_len; +static int nonoption_flags_len; +# endif + +# ifdef USE_NONOPTION_FLAGS +# define SWAP_FLAGS(ch1, ch2) \ + if (nonoption_flags_len > 0) \ + { \ + char __tmp = __getopt_nonoption_flags[ch1]; \ + __getopt_nonoption_flags[ch1] = __getopt_nonoption_flags[ch2]; \ + __getopt_nonoption_flags[ch2] = __tmp; \ + } +# else +# define SWAP_FLAGS(ch1, ch2) +# endif +#else /* !_LIBC */ +# define SWAP_FLAGS(ch1, ch2) +#endif /* _LIBC */ + +/* Exchange two adjacent subsequences of ARGV. + One subsequence is elements [first_nonopt,last_nonopt) + which contains all the non-options that have been skipped so far. + The other is elements [last_nonopt,optind), which contains all + the options processed since those non-options were skipped. + + `first_nonopt' and `last_nonopt' are relocated so that they describe + the new indices of the non-options in ARGV after they are moved. */ + +#if defined __STDC__ && __STDC__ +static void exchange (char **); +#endif + +static void +exchange (argv) + char **argv; +{ + int bottom = first_nonopt; + int middle = last_nonopt; + int top = optind; + char *tem; + + /* Exchange the shorter segment with the far end of the longer segment. + That puts the shorter segment into the right place. + It leaves the longer segment in the right place overall, + but it consists of two parts that need to be swapped next. */ + +#if defined _LIBC && defined USE_NONOPTION_FLAGS + /* First make sure the handling of the `__getopt_nonoption_flags' + string can work normally. Our top argument must be in the range + of the string. */ + if (nonoption_flags_len > 0 && top >= nonoption_flags_max_len) + { + /* We must extend the array. The user plays games with us and + presents new arguments. */ + char *new_str = malloc (top + 1); + if (new_str == NULL) + nonoption_flags_len = nonoption_flags_max_len = 0; + else + { + memset (__mempcpy (new_str, __getopt_nonoption_flags, + nonoption_flags_max_len), + '\0', top + 1 - nonoption_flags_max_len); + nonoption_flags_max_len = top + 1; + __getopt_nonoption_flags = new_str; + } + } +#endif + + while (top > middle && middle > bottom) + { + if (top - middle > middle - bottom) + { + /* Bottom segment is the short one. */ + int len = middle - bottom; + register int i; + + /* Swap it with the top part of the top segment. */ + for (i = 0; i < len; i++) + { + tem = argv[bottom + i]; + argv[bottom + i] = argv[top - (middle - bottom) + i]; + argv[top - (middle - bottom) + i] = tem; + SWAP_FLAGS (bottom + i, top - (middle - bottom) + i); + } + /* Exclude the moved bottom segment from further swapping. */ + top -= len; + } + else + { + /* Top segment is the short one. */ + int len = top - middle; + register int i; + + /* Swap it with the bottom part of the bottom segment. */ + for (i = 0; i < len; i++) + { + tem = argv[bottom + i]; + argv[bottom + i] = argv[middle + i]; + argv[middle + i] = tem; + SWAP_FLAGS (bottom + i, middle + i); + } + /* Exclude the moved top segment from further swapping. */ + bottom += len; + } + } + + /* Update records for the slots the non-options now occupy. */ + + first_nonopt += (optind - last_nonopt); + last_nonopt = optind; +} + +/* Initialize the internal data when the first call is made. */ + +#if defined __STDC__ && __STDC__ +static const char *_getopt_initialize (int, char *const *, const char *); +#endif +static const char * +_getopt_initialize (argc, argv, optstring) + int argc; + char *const *argv; + const char *optstring; +{ + /* Start processing options with ARGV-element 1 (since ARGV-element 0 + is the program name); the sequence of previously skipped + non-option ARGV-elements is empty. */ + + first_nonopt = last_nonopt = optind; + + nextchar = NULL; + + posixly_correct = getenv ("POSIXLY_CORRECT"); + + /* Determine how to handle the ordering of options and nonoptions. */ + + if (optstring[0] == '-') + { + ordering = RETURN_IN_ORDER; + ++optstring; + } + else if (optstring[0] == '+') + { + ordering = REQUIRE_ORDER; + ++optstring; + } + else if (posixly_correct != NULL) + ordering = REQUIRE_ORDER; + else + ordering = PERMUTE; + +#if defined _LIBC && defined USE_NONOPTION_FLAGS + if (posixly_correct == NULL + && argc == __libc_argc && argv == __libc_argv) + { + if (nonoption_flags_max_len == 0) + { + if (__getopt_nonoption_flags == NULL + || __getopt_nonoption_flags[0] == '\0') + nonoption_flags_max_len = -1; + else + { + const char *orig_str = __getopt_nonoption_flags; + int len = nonoption_flags_max_len = strlen (orig_str); + if (nonoption_flags_max_len < argc) + nonoption_flags_max_len = argc; + __getopt_nonoption_flags = + (char *) malloc (nonoption_flags_max_len); + if (__getopt_nonoption_flags == NULL) + nonoption_flags_max_len = -1; + else + memset (__mempcpy (__getopt_nonoption_flags, orig_str, len), + '\0', nonoption_flags_max_len - len); + } + } + nonoption_flags_len = nonoption_flags_max_len; + } + else + nonoption_flags_len = 0; +#endif + + return optstring; +} + +/* Scan elements of ARGV (whose length is ARGC) for option characters + given in OPTSTRING. + + If an element of ARGV starts with '-', and is not exactly "-" or "--", + then it is an option element. The characters of this element + (aside from the initial '-') are option characters. If `getopt' + is called repeatedly, it returns successively each of the option characters + from each of the option elements. + + If `getopt' finds another option character, it returns that character, + updating `optind' and `nextchar' so that the next call to `getopt' can + resume the scan with the following option character or ARGV-element. + + If there are no more option characters, `getopt' returns -1. + Then `optind' is the index in ARGV of the first ARGV-element + that is not an option. (The ARGV-elements have been permuted + so that those that are not options now come last.) + + OPTSTRING is a string containing the legitimate option characters. + If an option character is seen that is not listed in OPTSTRING, + return '?' after printing an error message. If you set `opterr' to + zero, the error message is suppressed but we still return '?'. + + If a char in OPTSTRING is followed by a colon, that means it wants an arg, + so the following text in the same ARGV-element, or the text of the following + ARGV-element, is returned in `optarg'. Two colons mean an option that + wants an optional arg; if there is text in the current ARGV-element, + it is returned in `optarg', otherwise `optarg' is set to zero. + + If OPTSTRING starts with `-' or `+', it requests different methods of + handling the non-option ARGV-elements. + See the comments about RETURN_IN_ORDER and REQUIRE_ORDER, above. + + Long-named options begin with `--' instead of `-'. + Their names may be abbreviated as long as the abbreviation is unique + or is an exact match for some defined option. If they have an + argument, it follows the option name in the same ARGV-element, separated + from the option name by a `=', or else the in next ARGV-element. + When `getopt' finds a long-named option, it returns 0 if that option's + `flag' field is nonzero, the value of the option's `val' field + if the `flag' field is zero. + + The elements of ARGV aren't really const, because we permute them. + But we pretend they're const in the prototype to be compatible + with other systems. + + LONGOPTS is a vector of `struct option' terminated by an + element containing a name which is zero. + + LONGIND returns the index in LONGOPT of the long-named option found. + It is only valid when a long-named option has been found by the most + recent call. + + If LONG_ONLY is nonzero, '-' as well as '--' can introduce + long-named options. */ + +int +_getopt_internal (argc, argv, optstring, longopts, longind, long_only) + int argc; + char *const *argv; + const char *optstring; + const struct option *longopts; + int *longind; + int long_only; +{ + int print_errors = opterr; + if (optstring[0] == ':') + print_errors = 0; + + if (argc < 1) + return -1; + + optarg = NULL; + + if (optind == 0 || !__getopt_initialized) + { + if (optind == 0) + optind = 1; /* Don't scan ARGV[0], the program name. */ + optstring = _getopt_initialize (argc, argv, optstring); + __getopt_initialized = 1; + } + + /* Test whether ARGV[optind] points to a non-option argument. + Either it does not have option syntax, or there is an environment flag + from the shell indicating it is not an option. The later information + is only used when the used in the GNU libc. */ +#if defined _LIBC && defined USE_NONOPTION_FLAGS +# define NONOPTION_P (argv[optind][0] != '-' || argv[optind][1] == '\0' \ + || (optind < nonoption_flags_len \ + && __getopt_nonoption_flags[optind] == '1')) +#else +# define NONOPTION_P (argv[optind][0] != '-' || argv[optind][1] == '\0') +#endif + + if (nextchar == NULL || *nextchar == '\0') + { + /* Advance to the next ARGV-element. */ + + /* Give FIRST_NONOPT and LAST_NONOPT rational values if OPTIND has been + moved back by the user (who may also have changed the arguments). */ + if (last_nonopt > optind) + last_nonopt = optind; + if (first_nonopt > optind) + first_nonopt = optind; + + if (ordering == PERMUTE) + { + /* If we have just processed some options following some non-options, + exchange them so that the options come first. */ + + if (first_nonopt != last_nonopt && last_nonopt != optind) + exchange ((char **) argv); + else if (last_nonopt != optind) + first_nonopt = optind; + + /* Skip any additional non-options + and extend the range of non-options previously skipped. */ + + while (optind < argc && NONOPTION_P) + optind++; + last_nonopt = optind; + } + + /* The special ARGV-element `--' means premature end of options. + Skip it like a null option, + then exchange with previous non-options as if it were an option, + then skip everything else like a non-option. */ + + if (optind != argc && !strcmp (argv[optind], "--")) + { + optind++; + + if (first_nonopt != last_nonopt && last_nonopt != optind) + exchange ((char **) argv); + else if (first_nonopt == last_nonopt) + first_nonopt = optind; + last_nonopt = argc; + + optind = argc; + } + + /* If we have done all the ARGV-elements, stop the scan + and back over any non-options that we skipped and permuted. */ + + if (optind == argc) + { + /* Set the next-arg-index to point at the non-options + that we previously skipped, so the caller will digest them. */ + if (first_nonopt != last_nonopt) + optind = first_nonopt; + return -1; + } + + /* If we have come to a non-option and did not permute it, + either stop the scan or describe it to the caller and pass it by. */ + + if (NONOPTION_P) + { + if (ordering == REQUIRE_ORDER) + return -1; + optarg = argv[optind++]; + return 1; + } + + /* We have found another option-ARGV-element. + Skip the initial punctuation. */ + + nextchar = (argv[optind] + 1 + + (longopts != NULL && argv[optind][1] == '-')); + } + + /* Decode the current option-ARGV-element. */ + + /* Check whether the ARGV-element is a long option. + + If long_only and the ARGV-element has the form "-f", where f is + a valid short option, don't consider it an abbreviated form of + a long option that starts with f. Otherwise there would be no + way to give the -f short option. + + On the other hand, if there's a long option "fubar" and + the ARGV-element is "-fu", do consider that an abbreviation of + the long option, just like "--fu", and not "-f" with arg "u". + + This distinction seems to be the most useful approach. */ + + if (longopts != NULL + && (argv[optind][1] == '-' + || (long_only && (argv[optind][2] || !my_index (optstring, argv[optind][1]))))) + { + char *nameend; + const struct option *p; + const struct option *pfound = NULL; + int exact = 0; + int ambig = 0; + int indfound = -1; + int option_index; + + for (nameend = nextchar; *nameend && *nameend != '='; nameend++) + /* Do nothing. */ ; + + /* Test all long options for either exact match + or abbreviated matches. */ + for (p = longopts, option_index = 0; p->name; p++, option_index++) + if (!strncmp (p->name, nextchar, nameend - nextchar)) + { + if ((unsigned int) (nameend - nextchar) + == (unsigned int) strlen (p->name)) + { + /* Exact match found. */ + pfound = p; + indfound = option_index; + exact = 1; + break; + } + else if (pfound == NULL) + { + /* First nonexact match found. */ + pfound = p; + indfound = option_index; + } + else if (long_only + || pfound->has_arg != p->has_arg + || pfound->flag != p->flag + || pfound->val != p->val) + /* Second or later nonexact match found. */ + ambig = 1; + } + + if (ambig && !exact) + { + if (print_errors) + { +#if defined _LIBC && defined USE_IN_LIBIO + char *buf; + + __asprintf (&buf, _("%s: option `%s' is ambiguous\n"), + argv[0], argv[optind]); + + if (_IO_fwide (stderr, 0) > 0) + __fwprintf (stderr, L"%s", buf); + else + fputs (buf, stderr); + + free (buf); +#else + fprintf (stderr, _("%s: option `%s' is ambiguous\n"), + argv[0], argv[optind]); +#endif + } + nextchar += strlen (nextchar); + optind++; + optopt = 0; + return '?'; + } + + if (pfound != NULL) + { + option_index = indfound; + optind++; + if (*nameend) + { + /* Don't test has_arg with >, because some C compilers don't + allow it to be used on enums. */ + if (pfound->has_arg) + optarg = nameend + 1; + else + { + if (print_errors) + { +#if defined _LIBC && defined USE_IN_LIBIO + char *buf; +#endif + + if (argv[optind - 1][1] == '-') + { + /* --option */ +#if defined _LIBC && defined USE_IN_LIBIO + __asprintf (&buf, _("\ +%s: option `--%s' doesn't allow an argument\n"), + argv[0], pfound->name); +#else + fprintf (stderr, _("\ +%s: option `--%s' doesn't allow an argument\n"), + argv[0], pfound->name); +#endif + } + else + { + /* +option or -option */ +#if defined _LIBC && defined USE_IN_LIBIO + __asprintf (&buf, _("\ +%s: option `%c%s' doesn't allow an argument\n"), + argv[0], argv[optind - 1][0], + pfound->name); +#else + fprintf (stderr, _("\ +%s: option `%c%s' doesn't allow an argument\n"), + argv[0], argv[optind - 1][0], pfound->name); +#endif + } + +#if defined _LIBC && defined USE_IN_LIBIO + if (_IO_fwide (stderr, 0) > 0) + __fwprintf (stderr, L"%s", buf); + else + fputs (buf, stderr); + + free (buf); +#endif + } + + nextchar += strlen (nextchar); + + optopt = pfound->val; + return '?'; + } + } + else if (pfound->has_arg == 1) + { + if (optind < argc) + optarg = argv[optind++]; + else + { + if (print_errors) + { +#if defined _LIBC && defined USE_IN_LIBIO + char *buf; + + __asprintf (&buf, + _("%s: option `%s' requires an argument\n"), + argv[0], argv[optind - 1]); + + if (_IO_fwide (stderr, 0) > 0) + __fwprintf (stderr, L"%s", buf); + else + fputs (buf, stderr); + + free (buf); +#else + fprintf (stderr, + _("%s: option `%s' requires an argument\n"), + argv[0], argv[optind - 1]); +#endif + } + nextchar += strlen (nextchar); + optopt = pfound->val; + return optstring[0] == ':' ? ':' : '?'; + } + } + nextchar += strlen (nextchar); + if (longind != NULL) + *longind = option_index; + if (pfound->flag) + { + *(pfound->flag) = pfound->val; + return 0; + } + return pfound->val; + } + + /* Can't find it as a long option. If this is not getopt_long_only, + or the option starts with '--' or is not a valid short + option, then it's an error. + Otherwise interpret it as a short option. */ + if (!long_only || argv[optind][1] == '-' + || my_index (optstring, *nextchar) == NULL) + { + if (print_errors) + { +#if defined _LIBC && defined USE_IN_LIBIO + char *buf; +#endif + + if (argv[optind][1] == '-') + { + /* --option */ +#if defined _LIBC && defined USE_IN_LIBIO + __asprintf (&buf, _("%s: unrecognized option `--%s'\n"), + argv[0], nextchar); +#else + fprintf (stderr, _("%s: unrecognized option `--%s'\n"), + argv[0], nextchar); +#endif + } + else + { + /* +option or -option */ +#if defined _LIBC && defined USE_IN_LIBIO + __asprintf (&buf, _("%s: unrecognized option `%c%s'\n"), + argv[0], argv[optind][0], nextchar); +#else + fprintf (stderr, _("%s: unrecognized option `%c%s'\n"), + argv[0], argv[optind][0], nextchar); +#endif + } + +#if defined _LIBC && defined USE_IN_LIBIO + if (_IO_fwide (stderr, 0) > 0) + __fwprintf (stderr, L"%s", buf); + else + fputs (buf, stderr); + + free (buf); +#endif + } + nextchar = (char *) ""; + optind++; + optopt = 0; + return '?'; + } + } + + /* Look at and handle the next short option-character. */ + + { + char c = *nextchar++; + char *temp = my_index (optstring, c); + + /* Increment `optind' when we start to process its last character. */ + if (*nextchar == '\0') + ++optind; + + if (temp == NULL || c == ':') + { + if (print_errors) + { +#if defined _LIBC && defined USE_IN_LIBIO + char *buf; +#endif + + if (posixly_correct) + { + /* 1003.2 specifies the format of this message. */ +#if defined _LIBC && defined USE_IN_LIBIO + __asprintf (&buf, _("%s: illegal option -- %c\n"), + argv[0], c); +#else + fprintf (stderr, _("%s: illegal option -- %c\n"), argv[0], c); +#endif + } + else + { +#if defined _LIBC && defined USE_IN_LIBIO + __asprintf (&buf, _("%s: invalid option -- %c\n"), + argv[0], c); +#else + fprintf (stderr, _("%s: invalid option -- %c\n"), argv[0], c); +#endif + } + +#if defined _LIBC && defined USE_IN_LIBIO + if (_IO_fwide (stderr, 0) > 0) + __fwprintf (stderr, L"%s", buf); + else + fputs (buf, stderr); + + free (buf); +#endif + } + optopt = c; + return '?'; + } + /* Convenience. Treat POSIX -W foo same as long option --foo */ + if (temp[0] == 'W' && temp[1] == ';') + { + char *nameend; + const struct option *p; + const struct option *pfound = NULL; + int exact = 0; + int ambig = 0; + int indfound = 0; + int option_index; + + /* This is an option that requires an argument. */ + if (*nextchar != '\0') + { + optarg = nextchar; + /* If we end this ARGV-element by taking the rest as an arg, + we must advance to the next element now. */ + optind++; + } + else if (optind == argc) + { + if (print_errors) + { + /* 1003.2 specifies the format of this message. */ +#if defined _LIBC && defined USE_IN_LIBIO + char *buf; + + __asprintf (&buf, _("%s: option requires an argument -- %c\n"), + argv[0], c); + + if (_IO_fwide (stderr, 0) > 0) + __fwprintf (stderr, L"%s", buf); + else + fputs (buf, stderr); + + free (buf); +#else + fprintf (stderr, _("%s: option requires an argument -- %c\n"), + argv[0], c); +#endif + } + optopt = c; + if (optstring[0] == ':') + c = ':'; + else + c = '?'; + return c; + } + else + /* We already incremented `optind' once; + increment it again when taking next ARGV-elt as argument. */ + optarg = argv[optind++]; + + /* optarg is now the argument, see if it's in the + table of longopts. */ + + for (nextchar = nameend = optarg; *nameend && *nameend != '='; nameend++) + /* Do nothing. */ ; + + /* Test all long options for either exact match + or abbreviated matches. */ + for (p = longopts, option_index = 0; p->name; p++, option_index++) + if (!strncmp (p->name, nextchar, nameend - nextchar)) + { + if ((unsigned int) (nameend - nextchar) == strlen (p->name)) + { + /* Exact match found. */ + pfound = p; + indfound = option_index; + exact = 1; + break; + } + else if (pfound == NULL) + { + /* First nonexact match found. */ + pfound = p; + indfound = option_index; + } + else + /* Second or later nonexact match found. */ + ambig = 1; + } + if (ambig && !exact) + { + if (print_errors) + { +#if defined _LIBC && defined USE_IN_LIBIO + char *buf; + + __asprintf (&buf, _("%s: option `-W %s' is ambiguous\n"), + argv[0], argv[optind]); + + if (_IO_fwide (stderr, 0) > 0) + __fwprintf (stderr, L"%s", buf); + else + fputs (buf, stderr); + + free (buf); +#else + fprintf (stderr, _("%s: option `-W %s' is ambiguous\n"), + argv[0], argv[optind]); +#endif + } + nextchar += strlen (nextchar); + optind++; + return '?'; + } + if (pfound != NULL) + { + option_index = indfound; + if (*nameend) + { + /* Don't test has_arg with >, because some C compilers don't + allow it to be used on enums. */ + if (pfound->has_arg) + optarg = nameend + 1; + else + { + if (print_errors) + { +#if defined _LIBC && defined USE_IN_LIBIO + char *buf; + + __asprintf (&buf, _("\ +%s: option `-W %s' doesn't allow an argument\n"), + argv[0], pfound->name); + + if (_IO_fwide (stderr, 0) > 0) + __fwprintf (stderr, L"%s", buf); + else + fputs (buf, stderr); + + free (buf); +#else + fprintf (stderr, _("\ +%s: option `-W %s' doesn't allow an argument\n"), + argv[0], pfound->name); +#endif + } + + nextchar += strlen (nextchar); + return '?'; + } + } + else if (pfound->has_arg == 1) + { + if (optind < argc) + optarg = argv[optind++]; + else + { + if (print_errors) + { +#if defined _LIBC && defined USE_IN_LIBIO + char *buf; + + __asprintf (&buf, _("\ +%s: option `%s' requires an argument\n"), + argv[0], argv[optind - 1]); + + if (_IO_fwide (stderr, 0) > 0) + __fwprintf (stderr, L"%s", buf); + else + fputs (buf, stderr); + + free (buf); +#else + fprintf (stderr, + _("%s: option `%s' requires an argument\n"), + argv[0], argv[optind - 1]); +#endif + } + nextchar += strlen (nextchar); + return optstring[0] == ':' ? ':' : '?'; + } + } + nextchar += strlen (nextchar); + if (longind != NULL) + *longind = option_index; + if (pfound->flag) + { + *(pfound->flag) = pfound->val; + return 0; + } + return pfound->val; + } + nextchar = NULL; + return 'W'; /* Let the application handle it. */ + } + if (temp[1] == ':') + { + if (temp[2] == ':') + { + /* This is an option that accepts an argument optionally. */ + if (*nextchar != '\0') + { + optarg = nextchar; + optind++; + } + else + optarg = NULL; + nextchar = NULL; + } + else + { + /* This is an option that requires an argument. */ + if (*nextchar != '\0') + { + optarg = nextchar; + /* If we end this ARGV-element by taking the rest as an arg, + we must advance to the next element now. */ + optind++; + } + else if (optind == argc) + { + if (print_errors) + { + /* 1003.2 specifies the format of this message. */ +#if defined _LIBC && defined USE_IN_LIBIO + char *buf; + + __asprintf (&buf, + _("%s: option requires an argument -- %c\n"), + argv[0], c); + + if (_IO_fwide (stderr, 0) > 0) + __fwprintf (stderr, L"%s", buf); + else + fputs (buf, stderr); + + free (buf); +#else + fprintf (stderr, + _("%s: option requires an argument -- %c\n"), + argv[0], c); +#endif + } + optopt = c; + if (optstring[0] == ':') + c = ':'; + else + c = '?'; + } + else + /* We already incremented `optind' once; + increment it again when taking next ARGV-elt as argument. */ + optarg = argv[optind++]; + nextchar = NULL; + } + } + return c; + } +} + +int +getopt (argc, argv, optstring) + int argc; + char *const *argv; + const char *optstring; +{ + return _getopt_internal (argc, argv, optstring, + (const struct option *) 0, + (int *) 0, + 0); +} + +#endif /* Not ELIDE_CODE. */ + + +/* Compile with -DTEST to make an executable for use in testing + the above definition of `getopt'. */ + +/* #define TEST */ /* Pete Wilson mod 7/28/02 */ +#ifdef TEST + +#ifndef exit /* Pete Wilson mod 7/28/02 */ + int exit(int); /* Pete Wilson mod 7/28/02 */ +#endif /* Pete Wilson mod 7/28/02 */ + +int +main (argc, argv) + int argc; + char **argv; +{ + int c; + int digit_optind = 0; + + while (1) + { + int this_option_optind = optind ? optind : 1; + + c = getopt (argc, argv, "abc:d:0123456789"); + if (c == -1) + break; + + switch (c) + { + case '0': + case '1': + case '2': + case '3': + case '4': + case '5': + case '6': + case '7': + case '8': + case '9': + if (digit_optind != 0 && digit_optind != this_option_optind) + printf ("digits occur in two different argv-elements.\n"); + digit_optind = this_option_optind; + printf ("option %c\n", c); + break; + + case 'a': + printf ("option a\n"); + break; + + case 'b': + printf ("option b\n"); + break; + + case 'c': + printf ("option c with value `%s'\n", optarg); + break; + + case '?': + break; + + default: + printf ("?? getopt returned character code 0%o ??\n", c); + } + } + + if (optind < argc) + { + printf ("non-option ARGV-elements: "); + while (optind < argc) + printf ("%s ", argv[optind++]); + printf ("\n"); + } + + exit (0); +} + +#endif /* TEST */ diff --git a/external/msvc-support/getopt.h b/external/msvc-support/getopt.h new file mode 100644 index 00000000..8a45c8b1 --- /dev/null +++ b/external/msvc-support/getopt.h @@ -0,0 +1,188 @@ + +/* getopt.h */ +/* Declarations for getopt. + Copyright (C) 1989-1994, 1996-1999, 2001 Free Software + Foundation, Inc. This file is part of the GNU C Library. + + The GNU C Library is free software; you can redistribute + it and/or modify it under the terms of the GNU Lesser + General Public License as published by the Free Software + Foundation; either version 2.1 of the License, or + (at your option) any later version. + + The GNU C Library is distributed in the hope that it will + be useful, but WITHOUT ANY WARRANTY; without even the + implied warranty of MERCHANTABILITY or FITNESS FOR A + PARTICULAR PURPOSE. See the GNU Lesser General Public + License for more details. + + You should have received a copy of the GNU Lesser General + Public License along with the GNU C Library; if not, write + to the Free Software Foundation, Inc., 59 Temple Place, + Suite 330, Boston, MA 02111-1307 USA. */ + + + + +#ifndef _GETOPT_H + +#ifndef __need_getopt +# define _GETOPT_H 1 +#endif + +/* If __GNU_LIBRARY__ is not already defined, either we are being used + standalone, or this is the first header included in the source file. + If we are being used with glibc, we need to include , but + that does not exist if we are standalone. So: if __GNU_LIBRARY__ is + not defined, include , which will pull in for us + if it's from glibc. (Why ctype.h? It's guaranteed to exist and it + doesn't flood the namespace with stuff the way some other headers do.) */ +#if !defined __GNU_LIBRARY__ +# include +#endif + +#ifdef __cplusplus +extern "C" { +#endif + +/* For communication from `getopt' to the caller. + When `getopt' finds an option that takes an argument, + the argument value is returned here. + Also, when `ordering' is RETURN_IN_ORDER, + each non-option ARGV-element is returned here. */ + +extern char *optarg; + +/* Index in ARGV of the next element to be scanned. + This is used for communication to and from the caller + and for communication between successive calls to `getopt'. + + On entry to `getopt', zero means this is the first call; initialize. + + When `getopt' returns -1, this is the index of the first of the + non-option elements that the caller should itself scan. + + Otherwise, `optind' communicates from one call to the next + how much of ARGV has been scanned so far. */ + +extern int optind; + +/* Callers store zero here to inhibit the error message `getopt' prints + for unrecognized options. */ + +extern int opterr; + +/* Set to an option character which was unrecognized. */ + +extern int optopt; + +#ifndef __need_getopt +/* Describe the long-named options requested by the application. + The LONG_OPTIONS argument to getopt_long or getopt_long_only is a vector + of `struct option' terminated by an element containing a name which is + zero. + + The field `has_arg' is: + no_argument (or 0) if the option does not take an argument, + required_argument (or 1) if the option requires an argument, + optional_argument (or 2) if the option takes an optional argument. + + If the field `flag' is not NULL, it points to a variable that is set + to the value given in the field `val' when the option is found, but + left unchanged if the option is not found. + + To have a long-named option do something other than set an `int' to + a compiled-in constant, such as set a value from `optarg', set the + option's `flag' field to zero and its `val' field to a nonzero + value (the equivalent single-letter option character, if there is + one). For long options that have a zero `flag' field, `getopt' + returns the contents of the `val' field. */ + +struct option +{ +# if (defined __STDC__ && __STDC__) || defined __cplusplus + const char *name; +# else + char *name; +# endif + /* has_arg can't be an enum because some compilers complain about + type mismatches in all the code that assumes it is an int. */ + int has_arg; + int *flag; + int val; +}; + +/* Names for the values of the `has_arg' field of `struct option'. */ + +# define no_argument 0 +# define required_argument 1 +# define optional_argument 2 +#endif /* need getopt */ + + +/* Get definitions and prototypes for functions to process the + arguments in ARGV (ARGC of them, minus the program name) for + options given in OPTS. + + Return the option character from OPTS just read. Return -1 when + there are no more options. For unrecognized options, or options + missing arguments, `optopt' is set to the option letter, and '?' is + returned. + + The OPTS string is a list of characters which are recognized option + letters, optionally followed by colons, specifying that that letter + takes an argument, to be placed in `optarg'. + + If a letter in OPTS is followed by two colons, its argument is + optional. This behavior is specific to the GNU `getopt'. + + The argument `--' causes premature termination of argument + scanning, explicitly telling `getopt' that there are no more + options. + + If OPTS begins with `--', then non-option arguments are treated as + arguments to the option '\0'. This behavior is specific to the GNU + `getopt'. */ + +#if (defined __STDC__ && __STDC__) || defined __cplusplus +# ifdef __GNU_LIBRARY__ +/* Many other libraries have conflicting prototypes for getopt, with + differences in the consts, in stdlib.h. To avoid compilation + errors, only prototype getopt for the GNU C library. */ +extern int getopt (int ___argc, char *const *___argv, const char *__shortopts); +# else /* not __GNU_LIBRARY__ */ +extern int getopt (); +# endif /* __GNU_LIBRARY__ */ + +# ifndef __need_getopt +extern int getopt_long (int ___argc, char *const *___argv, + const char *__shortopts, + const struct option *__longopts, int *__longind); +extern int getopt_long_only (int ___argc, char *const *___argv, + const char *__shortopts, + const struct option *__longopts, int *__longind); + +/* Internal only. Users should not call this directly. */ +extern int _getopt_internal (int ___argc, char *const *___argv, + const char *__shortopts, + const struct option *__longopts, int *__longind, + int __long_only); +# endif +#else /* not __STDC__ */ +extern int getopt (); +# ifndef __need_getopt +extern int getopt_long (); +extern int getopt_long_only (); + +extern int _getopt_internal (); +# endif +#endif /* __STDC__ */ + +#ifdef __cplusplus +} +#endif + +/* Make sure we later can get all the definitions and declarations. */ +#undef __need_getopt + +#endif /* getopt.h */ diff --git a/external/msvc-support/stdint.h b/external/msvc-support/stdint.h new file mode 100644 index 00000000..45f1e2a3 --- /dev/null +++ b/external/msvc-support/stdint.h @@ -0,0 +1,235 @@ +/* ISO C9x 7.18 Integer types + * Based on ISO/IEC SC22/WG14 9899 Committee draft (SC22 N2794) + * + * THIS SOFTWARE IS NOT COPYRIGHTED + * + * Contributor: Danny Smith + * + * This source code is offered for use in the public domain. You may + * use, modify or distribute it freely. + * + * This code is distributed in the hope that it will be useful but + * WITHOUT ANY WARRANTY. ALL WARRANTIES, EXPRESS OR IMPLIED ARE HEREBY + * DISCLAIMED. This includes but is not limited to warranties of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. + * + * Date: 2000-12-02 + * + * mwb: This was modified in the following ways: + * + * - make it compatible with Visual C++ 6 (which uses + * non-standard keywords and suffixes for 64-bit types) + * - some environments need stddef.h included (for wchar stuff?) + * - handle the fact that Microsoft's limits.h header defines + * SIZE_MAX + * - make corrections for SIZE_MAX, INTPTR_MIN, INTPTR_MAX, UINTPTR_MAX, + * PTRDIFF_MIN, PTRDIFF_MAX, SIG_ATOMIC_MIN, and SIG_ATOMIC_MAX + * to be 64-bit aware. + */ + + +#ifndef _STDINT_H +#define _STDINT_H +#define __need_wint_t +#define __need_wchar_t +#include +#include + +#if _MSC_VER && (_MSC_VER < 1300) +/* using MSVC 6 or earlier - no "long long" type, but might have _int64 type */ +#define __STDINT_LONGLONG __int64 +#define __STDINT_LONGLONG_SUFFIX i64 +#else +#define __STDINT_LONGLONG long long +#define __STDINT_LONGLONG_SUFFIX LL +#endif + +#if !defined( PASTE) +#define PASTE2( x, y) x##y +#define PASTE( x, y) PASTE2( x, y) +#endif /* PASTE */ + + +/* 7.18.1.1 Exact-width integer types */ +typedef signed char int8_t; +typedef unsigned char uint8_t; +typedef short int16_t; +typedef unsigned short uint16_t; +typedef int int32_t; +typedef unsigned uint32_t; +typedef __STDINT_LONGLONG int64_t; +typedef unsigned __STDINT_LONGLONG uint64_t; + +/* 7.18.1.2 Minimum-width integer types */ +typedef signed char int_least8_t; +typedef unsigned char uint_least8_t; +typedef short int_least16_t; +typedef unsigned short uint_least16_t; +typedef int int_least32_t; +typedef unsigned uint_least32_t; +typedef __STDINT_LONGLONG int_least64_t; +typedef unsigned __STDINT_LONGLONG uint_least64_t; + +/* 7.18.1.3 Fastest minimum-width integer types + * Not actually guaranteed to be fastest for all purposes + * Here we use the exact-width types for 8 and 16-bit ints. + */ +typedef char int_fast8_t; +typedef unsigned char uint_fast8_t; +typedef short int_fast16_t; +typedef unsigned short uint_fast16_t; +typedef int int_fast32_t; +typedef unsigned int uint_fast32_t; +typedef __STDINT_LONGLONG int_fast64_t; +typedef unsigned __STDINT_LONGLONG uint_fast64_t; + +/* 7.18.1.4 Integer types capable of holding object pointers */ +#ifndef _INTPTR_T_DEFINED +#define _INTPTR_T_DEFINED +#ifdef _WIN64 +typedef __STDINT_LONGLONG intptr_t +#else +typedef int intptr_t; +#endif /* _WIN64 */ +#endif /* _INTPTR_T_DEFINED */ + +#ifndef _UINTPTR_T_DEFINED +#define _UINTPTR_T_DEFINED +#ifdef _WIN64 +typedef unsigned __STDINT_LONGLONG uintptr_t +#else +typedef unsigned int uintptr_t; +#endif /* _WIN64 */ +#endif /* _UINTPTR_T_DEFINED */ + +/* 7.18.1.5 Greatest-width integer types */ +typedef __STDINT_LONGLONG intmax_t; +typedef unsigned __STDINT_LONGLONG uintmax_t; + +/* 7.18.2 Limits of specified-width integer types */ +#if !defined ( __cplusplus) || defined (__STDC_LIMIT_MACROS) + +/* 7.18.2.1 Limits of exact-width integer types */ +#define INT8_MIN (-128) +#define INT16_MIN (-32768) +#define INT32_MIN (-2147483647 - 1) +#define INT64_MIN (PASTE( -9223372036854775807, __STDINT_LONGLONG_SUFFIX) - 1) + +#define INT8_MAX 127 +#define INT16_MAX 32767 +#define INT32_MAX 2147483647 +#define INT64_MAX (PASTE( 9223372036854775807, __STDINT_LONGLONG_SUFFIX)) + +#define UINT8_MAX 0xff /* 255U */ +#define UINT16_MAX 0xffff /* 65535U */ +#define UINT32_MAX 0xffffffff /* 4294967295U */ +#define UINT64_MAX (PASTE( 0xffffffffffffffffU, __STDINT_LONGLONG_SUFFIX)) /* 18446744073709551615ULL */ + +/* 7.18.2.2 Limits of minimum-width integer types */ +#define INT_LEAST8_MIN INT8_MIN +#define INT_LEAST16_MIN INT16_MIN +#define INT_LEAST32_MIN INT32_MIN +#define INT_LEAST64_MIN INT64_MIN + +#define INT_LEAST8_MAX INT8_MAX +#define INT_LEAST16_MAX INT16_MAX +#define INT_LEAST32_MAX INT32_MAX +#define INT_LEAST64_MAX INT64_MAX + +#define UINT_LEAST8_MAX UINT8_MAX +#define UINT_LEAST16_MAX UINT16_MAX +#define UINT_LEAST32_MAX UINT32_MAX +#define UINT_LEAST64_MAX UINT64_MAX + +/* 7.18.2.3 Limits of fastest minimum-width integer types */ +#define INT_FAST8_MIN INT8_MIN +#define INT_FAST16_MIN INT16_MIN +#define INT_FAST32_MIN INT32_MIN +#define INT_FAST64_MIN INT64_MIN + +#define INT_FAST8_MAX INT8_MAX +#define INT_FAST16_MAX INT16_MAX +#define INT_FAST32_MAX INT32_MAX +#define INT_FAST64_MAX INT64_MAX + +#define UINT_FAST8_MAX UINT8_MAX +#define UINT_FAST16_MAX UINT16_MAX +#define UINT_FAST32_MAX UINT32_MAX +#define UINT_FAST64_MAX UINT64_MAX + +/* 7.18.2.4 Limits of integer types capable of holding + object pointers */ +#ifdef _WIN64 +#define INTPTR_MIN INT64_MIN +#define INTPTR_MAX INT64_MAX +#define UINTPTR_MAX UINT64_MAX +#else +#define INTPTR_MIN INT32_MIN +#define INTPTR_MAX INT32_MAX +#define UINTPTR_MAX UINT32_MAX +#endif /* _WIN64 */ + +/* 7.18.2.5 Limits of greatest-width integer types */ +#define INTMAX_MIN INT64_MIN +#define INTMAX_MAX INT64_MAX +#define UINTMAX_MAX UINT64_MAX + +/* 7.18.3 Limits of other integer types */ +#define PTRDIFF_MIN INTPTR_MIN +#define PTRDIFF_MAX INTPTR_MAX + +#define SIG_ATOMIC_MIN INTPTR_MIN +#define SIG_ATOMIC_MAX INTPTR_MAX + +/* we need to check for SIZE_MAX already defined because MS defines it in limits.h */ +#ifndef SIZE_MAX +#define SIZE_MAX UINTPTR_MAX +#endif + +#ifndef WCHAR_MIN /* also in wchar.h */ +#define WCHAR_MIN 0 +#define WCHAR_MAX ((wchar_t)-1) /* UINT16_MAX */ +#endif + +/* + * wint_t is unsigned short for compatibility with MS runtime + */ +#define WINT_MIN 0 +#define WINT_MAX ((wint_t)-1) /* UINT16_MAX */ + +#endif /* !defined ( __cplusplus) || defined __STDC_LIMIT_MACROS */ + + +/* 7.18.4 Macros for integer constants */ +#if !defined ( __cplusplus) || defined (__STDC_CONSTANT_MACROS) + +/* 7.18.4.1 Macros for minimum-width integer constants + + Accoding to Douglas Gwyn : + "This spec was changed in ISO/IEC 9899:1999 TC1; in ISO/IEC + 9899:1999 as initially published, the expansion was required + to be an integer constant of precisely matching type, which + is impossible to accomplish for the shorter types on most + platforms, because C99 provides no standard way to designate + an integer constant with width less than that of type int. + TC1 changed this to require just an integer constant + *expression* with *promoted* type." +*/ + +#define INT8_C(val) ((int8_t) + (val)) +#define UINT8_C(val) ((uint8_t) + (val##U)) +#define INT16_C(val) ((int16_t) + (val)) +#define UINT16_C(val) ((uint16_t) + (val##U)) + +#define INT32_C(val) val##L +#define UINT32_C(val) val##UL +#define INT64_C(val) (PASTE( val, __STDINT_LONGLONG_SUFFIX)) +#define UINT64_C(val)(PASTE( PASTE( val, U), __STDINT_LONGLONG_SUFFIX)) + +/* 7.18.4.2 Macros for greatest-width integer constants */ +#define INTMAX_C(val) INT64_C(val) +#define UINTMAX_C(val) UINT64_C(val) + +#endif /* !defined ( __cplusplus) || defined __STDC_CONSTANT_MACROS */ + +#endif \ No newline at end of file diff --git a/external/msvc-support/unistd.c b/external/msvc-support/unistd.c new file mode 100644 index 00000000..0b71cc3a --- /dev/null +++ b/external/msvc-support/unistd.c @@ -0,0 +1,19 @@ +#include "unistd.h" + +/* usleep for MSVC taken from http://stackoverflow.com/a/17283549/1256069 */ +#ifdef _MSC_VER +#include +int usleep(__int64 useconds) +{ + HANDLE timer; + LARGE_INTEGER ft; + + ft.QuadPart = -(10*useconds); // Convert to 100 nanosecond interval, negative value indicates relative time + + timer = CreateWaitableTimer(NULL, TRUE, NULL); + SetWaitableTimer(timer, &ft, 0, NULL, NULL, 0); + WaitForSingleObject(timer, INFINITE); + CloseHandle(timer); + return 0; +}; +#endif \ No newline at end of file diff --git a/external/msvc-support/unistd.h b/external/msvc-support/unistd.h new file mode 100644 index 00000000..91519c9a --- /dev/null +++ b/external/msvc-support/unistd.h @@ -0,0 +1,56 @@ +#ifndef _UNISTD_H +#define _UNISTD_H 1 + +/* This file intended to serve as a drop-in replacement for + * unistd.h on Windows + * Please add functionality as needed + */ + +#include +#include +#include /* getopt at: https://gist.github.com/ashelly/7776712 */ +#include /* for getpid() and the exec..() family */ +#include /* for _getcwd() and _chdir() */ + +#define srandom srand +#define random rand + +/* Values for the second argument to access. + These may be OR'd together. */ +#define R_OK 4 /* Test for read permission. */ +#define W_OK 2 /* Test for write permission. */ +//#define X_OK 1 /* execute permission - unsupported in windows*/ +#define F_OK 0 /* Test for existence. */ + +#define access _access +#define dup2 _dup2 +#define execve _execve +#define ftruncate _chsize +#define unlink _unlink +#define fileno _fileno +#define getcwd _getcwd +#define chdir _chdir +#define isatty _isatty +#define lseek _lseek +/* read, write, and close are NOT being #defined here, because while there are file handle specific versions for Windows, they probably don't work for sockets. You need to look at your app and consider whether to call e.g. closesocket(). */ + +#define ssize_t int + +#define STDIN_FILENO 0 +#define STDOUT_FILENO 1 +#define STDERR_FILENO 2 +/* should be in some equivalent to */ +typedef __int8 int8_t; +typedef __int16 int16_t; +typedef __int32 int32_t; +typedef __int64 int64_t; +typedef unsigned __int8 uint8_t; +typedef unsigned __int16 uint16_t; +typedef unsigned __int32 uint32_t; +typedef unsigned __int64 uint64_t; + +#define snprintf _snprintf // Not exactly the same, but close enough. + +int usleep(__int64 useconds); + +#endif /* unistd.h */ \ No newline at end of file diff --git a/external/pthreads-w32/ANNOUNCE b/external/pthreads-w32/ANNOUNCE new file mode 100644 index 00000000..23dbb956 --- /dev/null +++ b/external/pthreads-w32/ANNOUNCE @@ -0,0 +1,483 @@ +PTHREADS-WIN32 RELEASE 2.9.0 (2012-05-25) +----------------------------------------- +Web Site: http://sourceware.org/pthreads-win32/ +FTP Site: ftp://sourceware.org/pub/pthreads-win32 +Maintainer: Ross Johnson + + +We are pleased to announce the availability of a new release of +Pthreads-win32, an Open Source Software implementation of the +Threads component of the POSIX 1003.1 2001 Standard for Microsoft's +Win32 environment. Some functions from other sections of POSIX +1003.1 2001 are also supported including semaphores and scheduling +functions. + +Some common non-portable functions are also implemented for +additional compatibility, as are a few functions specific +to pthreads-win32 for easier integration with Win32 applications. + +Pthreads-win32 is free software, distributed under the GNU Lesser +General Public License (LGPL). + + +Acknowledgements +---------------- +This library is based originally on a Win32 pthreads +implementation contributed by John Bossom. + +The implementation of Condition Variables uses algorithms developed +by Alexander Terekhov and Louis Thomas. + +The implementation of POSIX mutexes has been improved by Thomas Pfaff +and later by Alexander Terekhov. + +The implementation of Spinlocks and Barriers was contributed +by Ross Johnson. + +The implementation of read/write locks was contributed by +Aurelio Medina and improved by Alexander Terekhov. + +Many others have contributed significant time and effort to solve crutial +problems in order to make the library workable, robust and reliable. + +Thanks to Xavier Leroy for granting permission to use and modify his +LinuxThreads manual pages. + +Thanks to The Open Group for making the Single Unix Specification +publicly available - many of the manual pages included in the package +were extracted from it. + +There is also a separate CONTRIBUTORS file. This file and others are +on the web site: + + http://sourceware.org/pthreads-win32 + +As much as possible, the ChangeLog file acknowledges contributions to the +code base in more detail. + + +Changes since the last release +------------------------------ +These are now documented in the NEWS file. +See the ChangeLog file also. + + +Known Bugs +---------- +These are now documented in the BUGS file. + + +Level of standards conformance +------------------------------ + +The following POSIX 1003.1 2001 options are defined and set to 200112L: + + _POSIX_THREADS + _POSIX_THREAD_SAFE_FUNCTIONS + _POSIX_THREAD_ATTR_STACKSIZE + _POSIX_THREAD_PRIORITY_SCHEDULING + _POSIX_SEMAPHORES + _POSIX_READER_WRITER_LOCKS + _POSIX_SPIN_LOCKS + _POSIX_BARRIERS + + +The following POSIX 1003.1 2001 options are defined and set to -1: + + _POSIX_THREAD_ATTR_STACKADDR + _POSIX_THREAD_PRIO_INHERIT + _POSIX_THREAD_PRIO_PROTECT + _POSIX_THREAD_PROCESS_SHARED + + +The following POSIX 1003.1 2001 limits are defined and set: + + _POSIX_THREAD_THREADS_MAX + _POSIX_SEM_VALUE_MAX + _POSIX_SEM_NSEMS_MAX + _POSIX_THREAD_KEYS_MAX + _POSIX_THREAD_DESTRUCTOR_ITERATIONS + PTHREAD_STACK_MIN + PTHREAD_THREADS_MAX + SEM_VALUE_MAX + SEM_NSEMS_MAX + PTHREAD_KEYS_MAX + PTHREAD_DESTRUCTOR_ITERATIONS + + +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_mutexattr_gettype + pthread_mutexattr_settype (types: PTHREAD_MUTEX_DEFAULT + PTHREAD_MUTEX_NORMAL + PTHREAD_MUTEX_ERRORCHECK + PTHREAD_MUTEX_RECURSIVE ) + pthread_mutexattr_getrobust + pthread_mutexattr_setrobust (values: PTHREAD_MUTEX_STALLED + PTHREAD_MUTEX_ROBUST) + pthread_mutex_init + pthread_mutex_destroy + pthread_mutex_lock + pthread_mutex_trylock + pthread_mutex_timedlock + pthread_mutex_unlock + pthread_mutex_consistent + + --------------------------- + 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 + + --------------------------- + Read/Write Locks + --------------------------- + pthread_rwlock_init + pthread_rwlock_destroy + pthread_rwlock_tryrdlock + pthread_rwlock_trywrlock + pthread_rwlock_rdlock + pthread_rwlock_timedrdlock + pthread_rwlock_rwlock + pthread_rwlock_timedwrlock + pthread_rwlock_unlock + pthread_rwlockattr_init + pthread_rwlockattr_destroy + pthread_rwlockattr_getpshared + pthread_rwlockattr_setpshared + + --------------------------- + Spin Locks + --------------------------- + pthread_spin_init + pthread_spin_destroy + pthread_spin_lock + pthread_spin_unlock + pthread_spin_trylock + + --------------------------- + Barriers + --------------------------- + pthread_barrier_init + pthread_barrier_destroy + pthread_barrier_wait + pthread_barrierattr_init + pthread_barrierattr_destroy + pthread_barrierattr_getpshared + pthread_barrierattr_setpshared + + --------------------------- + Semaphores + --------------------------- + sem_init + sem_destroy + sem_post + sem_wait + sem_trywait + sem_timedwait + sem_getvalue (# free if +ve, # of waiters if -ve) + sem_open (returns an error ENOSYS) + sem_close (returns an error ENOSYS) + sem_unlink (returns an error ENOSYS) + + --------------------------- + RealTime Scheduling + --------------------------- + pthread_attr_getschedparam + pthread_attr_setschedparam + pthread_attr_getinheritsched + pthread_attr_setinheritsched + pthread_attr_getschedpolicy (only supports SCHED_OTHER) + pthread_attr_setschedpolicy (only supports SCHED_OTHER) + pthread_getschedparam + pthread_setschedparam + pthread_getconcurrency + pthread_setconcurrency + pthread_attr_getscope + pthread_attr_setscope (only supports PTHREAD_SCOPE_SYSTEM) + sched_get_priority_max + sched_get_priority_min + sched_rr_get_interval (returns an error ENOTSUP) + sched_setscheduler (only supports SCHED_OTHER) + sched_getscheduler (only supports SCHED_OTHER) + sched_yield + + --------------------------- + Signals + --------------------------- + pthread_sigmask + pthread_kill (only supports zero sig value, + for thread validity checking) + + --------------------------- + Non-portable routines (see the README.NONPORTABLE file for usage) + --------------------------- + pthread_getw32threadhandle_np + pthread_timechange_handler_np + pthread_delay_np + pthread_getunique_np + pthread_mutexattr_getkind_np + pthread_mutexattr_setkind_np (types: PTHREAD_MUTEX_FAST_NP, + PTHREAD_MUTEX_ERRORCHECK_NP, + PTHREAD_MUTEX_RECURSIVE_NP, + PTHREAD_MUTEX_ADAPTIVE_NP, + PTHREAD_MUTEX_TIMED_NP) + pthread_num_processors_np + (The following four routines may be required when linking statically. + The process_* routines should not be needed for MSVC or GCC.) + pthread_win32_process_attach_np + pthread_win32_process_detach_np + (The following routines should only be needed to manage implicit + POSIX handles i.e. when Win native threads call POSIX thread routines + (other than pthread_create)) + pthread_win32_thread_attach_np + pthread_win32_thread_detach_np + + --------------------------- + Static Initializers + --------------------------- + PTHREAD_ONCE_INIT + PTHREAD_MUTEX_INITIALIZER + PTHREAD_RECURSIVE_MUTEX_INITIALIZER + PTHREAD_RECURSIVE_MUTEX_INITIALIZER_NP + PTHREAD_ERRORCHECK_MUTEX_INITIALIZER + PTHREAD_ERRORCHECK_MUTEX_INITIALIZER_NP + PTHREAD_COND_INITIALIZER + PTHREAD_RWLOCK_INITIALIZER + PTHREAD_SPINLOCK_INITIALIZER + + +The library includes two non-API functions for creating cancellation +points in applications and libraries: + + pthreadCancelableWait + pthreadCancelableTimedWait + + +The following functions are not implemented: + + --------------------------- + RealTime Scheduling + --------------------------- + 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 + --------------------------- + sigtimedwait + sigwait + sigwaitinfo + + --------------------------- + General + --------------------------- + sysconf + + --------------------------- + Thread-Safe C Runtime Library (macros) + --------------------------- + strtok_r + asctime_r + ctime_r + gmtime_r + localtime_r + rand_r + + +Availability +------------ + +The prebuilt DLL, export libs (for both MSVC and Mingw32), and the header +files (pthread.h, semaphore.h, sched.h) are available along with the +complete source code. + +The source code can be found at: + + ftp://sources.redhat.com/pub/pthreads-win32 + +and as individual source code files at + + ftp://sources.redhat.com/pub/pthreads-win32/source + +The pre-built DLL, export libraries and include files can be found at: + + ftp://sources.redhat.com/pub/pthreads-win32/dll-latest + + + +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 +------------------------------------ + +See the README file for more information. + +MSVC: +MSVC using SEH works. Distribute pthreadVSE.dll with your application. +MSVC using C++ EH works. Distribute pthreadVCE.dll with your application. +MSVC using C setjmp/longjmp works. Distribute pthreadVC.dll with your application. + + +Mingw32: +See the FAQ, Questions 6 and 10. + +Mingw using C++ EH works. Distribute pthreadGCE.dll with your application. +Mingw using C setjmp/longjmp works. Distribute pthreadGC.dll with your application. + + +Cygwin: (http://sourceware.cygnus.com/cygwin/) +Developers using Cygwin do not need pthreads-win32 since it has POSIX threads +support. Refer to its documentation for details and extent. + + +UWIN: +UWIN is a complete Unix-like environment for Windows from AT&T. Pthreads-win32 +doesn't currently support UWIN (and vice versa), but that may change in the +future. + +Generally: +For convenience, the following pre-built files are available on the FTP site +(see Availability above): + + pthread.h - for POSIX threads + semaphore.h - for POSIX semaphores + sched.h - for POSIX scheduling + pthreadVCE.dll - built with MSVC++ compiler using C++ EH + pthreadVCE.lib + pthreadVC.dll - built with MSVC compiler using C setjmp/longjmp + pthreadVC.lib + pthreadVSE.dll - built with MSVC compiler using SEH + pthreadVSE.lib + pthreadGCE.dll - built with Mingw32 G++ 2.95.2-1 + pthreadGC.dll - built with Mingw32 GCC 2.95.2-1 using setjmp/longjmp + libpthreadGCE.a - derived from pthreadGCE.dll + libpthreadGC.a - derived from pthreadGC.dll + gcc.dll - needed if distributing applications that use + pthreadGCE.dll (but see the FAQ Q 10 for the latest + related information) + +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. + + +Documentation +------------- + +For the authoritative reference, see the online POSIX +standard reference at: + + http://www.OpenGroup.org + +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) + +On the web: see the links at the bottom of the pthreads-win32 site: + + http://sources.redhat.com/pthreads-win32/ + + Currently, there is no documentation included in the package apart + from the copious comments in the source code. + + + +Enjoy! + +Ross Johnson diff --git a/external/pthreads-w32/BUGS b/external/pthreads-w32/BUGS new file mode 100644 index 00000000..5bdc2a98 --- /dev/null +++ b/external/pthreads-w32/BUGS @@ -0,0 +1,141 @@ +---------- +Known bugs +---------- + +1. Not strictly a bug, more of a gotcha. + + Under MS VC++ (only tested with version 6.0), a term_func + set via the standard C++ set_terminate() function causes the + application to abort. + + Notes from the MSVC++ manual: + 1) A term_func() should call exit(), otherwise + abort() will be called on return to the caller. + A call to abort() raises SIGABRT and the default signal handler + for all signals terminates the calling program with + exit code 3. + 2) A term_func() must not throw an exception. Therefore + term_func() should not call pthread_exit(), which + works by throwing an exception (pthreadVCE or pthreadVSE) + or by calling longjmp (pthreadVC). + + Workaround: avoid using pthread_exit() in C++ applications. Exit + threads by dropping through the end of the thread routine. + +2. Cancellation problems in C++ builds + - Milan Gardian + + [Note: It's not clear if this problem isn't simply due to the context + switch in pthread_cancel() which occurs unless the QueueUserAPCEx + library and driver are installed and used. Just like setjmp/longjmp, + this is probably not going to work well in C++. In any case, unless for + some very unusual reason you really must use the C++ build then please + use the C build pthreadVC2.dll or pthreadGC2.dll, i.e. for C++ + applications.] + + This is suspected to be a compiler bug in VC6.0, and also seen in + VC7.0 and VS .NET 2003. The GNU C++ compiler does not have a problem + with this, and it has been reported that the Intel C++ 8.1 compiler + and Visual C++ 2005 Express Edition Beta2 pass tests\semaphore4.c + (which exposes the bug). + + Workaround [rpj - 2 Feb 2002] + ----------------------------- + [Please note: this workaround did not solve a similar problem in + snapshot-2004-11-03 or later, even though similar symptoms were seen. + tests\semaphore4.c fails in that snapshot for the VCE version of the + DLL.] + + The problem disappears when /Ob0 is used, i.e. /O2 /Ob0 works OK, + but if you want to use inlining optimisation you can be much more + specific about where it's switched off and on by using a pragma. + + So the inlining optimisation is interfering with the way that cleanup + handlers are run. It appears to relate to auto-inlining of class methods + since this is the only auto inlining that is performed at /O1 optimisation + (functions with the "inline" qualifier are also inlined, but the problem + doesn't appear to involve any such functions in the library or testsuite). + + In order to confirm the inlining culprit, the following use of pragmas + eliminate the problem but I don't know how to make it transparent, putting + it in, say, pthread.h where pthread_cleanup_push defined as a macro. + + #pragma inline_depth(0) + pthread_cleanup_push(handlerFunc, (void *) &arg); + + /* ... */ + + pthread_cleanup_pop(0); + #pragma inline_depth() + + Note the empty () pragma value after the pop macro. This resets depth to the + default. Or you can specify a non-zero depth here. + + The pragma is also needed (and now used) within the library itself wherever + cleanup handlers are used (condvar.c and rwlock.c). + + Use of these pragmas allows compiler optimisations /O1 and /O2 to be + used for either or both the library and applications. + + Experimenting further, I found that wrapping the actual cleanup handler + function with #pragma auto_inline(off|on) does NOT work. + + MSVC6.0 doesn't appear to support the C99 standard's _Pragma directive, + however, later versions may. This form is embeddable inside #define + macros, which would be ideal because it would mean that it could be added + to the push/pop macro definitions in pthread.h and hidden from the + application programmer. + + [/rpj] + + Original problem description + ---------------------------- + + The cancellation (actually, cleanup-after-cancel) tests fail when using VC + (professional) optimisation switches (/O1 or /O2) in pthreads library. I + have not investigated which concrete optimisation technique causes this + problem (/Og, /Oi, /Ot, /Oy, /Ob1, /Gs, /Gf, /Gy, etc.), but here is a + summary of builds and corresponding failures: + + * pthreads VSE (optimised tests): OK + * pthreads VCE (optimised tests): Failed "cleanup1" test (runtime) + + * pthreads VSE (DLL in CRT, optimised tests): OK + * pthreads VCE (DLL in CRT, optimised tests): Failed "cleanup1" test + (runtime) + + Please note that while in VSE version of the pthreads library the + optimisation does not really have any impact on the tests (they pass OK), in + VCE version addition of optimisation (/O2 in this case) causes the tests to + fail uniformly - either in "cleanup0" or "cleanup1" test cases. + + Please note that all the tests above use default pthreads DLL (no + optimisations, linked with either static or DLL CRT, based on test type). + Therefore the problem lies not within the pthreads DLL but within the + compiled client code (the application using pthreads -> involvement of + "pthread.h"). + + I think the message of this section is that usage of VCE version of pthreads + in applications relying on cancellation/cleanup AND using optimisations for + creation of production code is highly unreliable for the current version of + the pthreads library. + +3. The Borland Builder 5.5 version of the library produces memory read exceptions +in some tests. + +4. pthread_barrier_wait() can deadlock if the number of potential calling +threads for a particular barrier is greater than the barrier count parameter +given to pthread_barrier_init() for that barrier. + +This is due to the very lightweight implementation of pthread-win32 barriers. +To cope with more than "count" possible waiters, barriers must effectively +implement all the same safeguards as condition variables, making them much +"heavier" than at present. + +The workaround is to ensure that no more than "count" threads attempt to wait +at the barrier. + +5. Canceling a thread blocked on pthread_once appears not to work in the MSVC++ +version of the library "pthreadVCE.dll". The test case "once3.c" hangs. I have no +clues on this at present. All other versions pass this test ok - pthreadsVC.dll, +pthreadsVSE.dll, pthreadsGC.dll and pthreadsGCE.dll. diff --git a/external/pthreads-w32/CONTRIBUTORS b/external/pthreads-w32/CONTRIBUTORS new file mode 100644 index 00000000..0f8a2742 --- /dev/null +++ b/external/pthreads-w32/CONTRIBUTORS @@ -0,0 +1,140 @@ +Contributors (in approximate order of appearance) + +[See also the ChangeLog file where individuals are +attributed in log entries. Likewise in the FAQ file.] + +Ben Elliston bje at cygnus dot com + Initiated the project; + setup the project infrastructure (CVS, web page, etc.); + early prototype routines. +Ross Johnson Ross dot Johnson at dot homemail dot com dot au + early prototype routines; + ongoing project coordination/maintenance; + implementation of spin locks and barriers; + various enhancements; + bug fixes; + documentation; + testsuite. +Robert Colquhoun rjc at trump dot net dot au + Early bug fixes. +John E. Bossom John dot Bossom at cognos dot com + Contributed substantial original working implementation; + bug fixes; + ongoing guidance and standards interpretation. +Anders Norlander anorland at hem2 dot passagen dot se + Early enhancements and runtime checking for supported + Win32 routines. +Tor Lillqvist tml at iki dot fi + General enhancements; + early bug fixes to condition variables. +Scott Lightner scott at curriculum dot com + Bug fix. +Kevin Ruland Kevin dot Ruland at anheuser-busch dot com + Various bug fixes. +Mike Russo miker at eai dot com + Bug fix. +Mark E. Armstrong avail at pacbell dot net + Bug fixes. +Lorin Hochstein lmh at xiphos dot ca + general bug fixes; bug fixes to condition variables. +Peter Slacik Peter dot Slacik at tatramed dot sk + Bug fixes. +Mumit Khan khan at xraylith dot wisc dot edu + Fixes to work with Mingw32. +Milan Gardian mg at tatramed dot sk + Bug fixes and reports/analyses of obscure problems. +Aurelio Medina aureliom at crt dot com + First implementation of read-write locks. +Graham Dumpleton Graham dot Dumpleton at ra dot pad dot otc dot telstra dot com dot au + Bug fix in condition variables. +Tristan Savatier tristan at mpegtv dot com + WinCE port. +Erik Hensema erik at hensema dot xs4all dot nl + Bug fixes. +Rich Peters rpeters at micro-magic dot com +Todd Owen towen at lucidcalm dot dropbear dot id dot au + Bug fixes to dll loading. +Jason Nye jnye at nbnet dot nb dot ca + Implementation of async cancelation. +Fred Forester fforest at eticomm dot net +Kevin D. Clark kclark at cabletron dot com +David Baggett dmb at itasoftware dot com + Bug fixes. +Paul Redondo paul at matchvision dot com +Scott McCaskill scott at 3dfx dot com + Bug fixes. +Jef Gearhart jgearhart at tpssys dot com + Bug fix. +Arthur Kantor akantor at bexusa dot com + Mutex enhancements. +Steven Reddie smr at essemer dot com dot au + Bug fix. +Alexander Terekhov TEREKHOV at de dot ibm dot com + Re-implemented and improved read-write locks; + (with Louis Thomas) re-implemented and improved + condition variables; + enhancements to semaphores; + enhancements to mutexes; + new mutex implementation in 'futex' style; + suggested a robust implementation of pthread_once + similar to that implemented by V.Kliathcko; + system clock change handling re CV timeouts; + bug fixes. +Thomas Pfaff tpfaff at gmx dot net + Changes to make C version usable with C++ applications; + re-implemented mutex routines to avoid Win32 mutexes + and TryEnterCriticalSection; + procedure to fix Mingw32 thread-safety issues. +Franco Bez franco dot bez at gmx dot de + procedure to fix Mingw32 thread-safety issues. +Louis Thomas lthomas at arbitrade dot com + (with Alexander Terekhov) re-implemented and improved + condition variables. +David Korn dgk at research dot att dot com + Ported to UWIN. +Phil Frisbie, Jr. phil at hawksoft dot com + Bug fix. +Ralf Brese Ralf dot Brese at pdb4 dot siemens dot de + Bug fix. +prionx at juno dot com prionx at juno dot com + Bug fixes. +Max Woodbury mtew at cds dot duke dot edu + POSIX versioning conditionals; + reduced namespace pollution; + idea to separate routines to reduce statically + linked image sizes. +Rob Fanner rfanner at stonethree dot com + Bug fix. +Michael Johnson michaelj at maine dot rr dot com + Bug fix. +Nicolas Barry boozai at yahoo dot com + Bug fixes. +Piet van Bruggen pietvb at newbridges dot nl + Bug fix. +Makoto Kato raven at oldskool dot jp + AMD64 port. +Panagiotis E. Hadjidoukas peh at hpclab dot ceid dot upatras dot gr + phadjido at cs dot uoi dot gr + Contributed the QueueUserAPCEx package which + makes preemptive async cancelation possible. +Will Bryant will dot bryant at ecosm dot com + Borland compiler patch and makefile. +Anuj Goyal anuj dot goyal at gmail dot com + Port to Digital Mars compiler. +Gottlob Frege gottlobfrege at gmail dot com + re-implemented pthread_once (version 2) + (pthread_once cancellation added by rpj). +Vladimir Kliatchko vladimir at kliatchko dot com + reimplemented pthread_once with the same form + as described by A.Terekhov (later version 2); + implementation of MCS (Mellor-Crummey/Scott) locks. +Ramiro Polla ramiro.polla at gmail dot com + static library auto init/cleanup on application + start/exit via RT hooks (MSC and GCC compilers only). +Daniel Richard G. skunk at iSKUNK dot org + Patches and cleanups for x86 and x64, particularly + across a range of MS build environments. +John Kamp john dot kamp at globalgraphics dot com + Patches to fix various problems on x64; brutal testing + particularly using high memory run environments. + diff --git a/external/pthreads-w32/COPYING b/external/pthreads-w32/COPYING new file mode 100644 index 00000000..af8e3db9 --- /dev/null +++ b/external/pthreads-w32/COPYING @@ -0,0 +1,150 @@ + pthreads-win32 - a POSIX threads library for Microsoft Windows + + +This file is Copyrighted +------------------------ + + This file is covered under the following Copyright: + + Copyright (C) 2001,2006 Ross P. Johnson + All rights reserved. + + Everyone is permitted to copy and distribute verbatim copies + of this license document, but changing it is not allowed. + +Pthreads-win32 is covered by the GNU Lesser General Public License +------------------------------------------------------------------ + + Pthreads-win32 is open software; you can redistribute it and/or + modify it under the terms of the GNU Lesser General Public License + as published by the Free Software Foundation version 2.1 of the + License. + + Pthreads-win32 is several binary link libraries, several modules, + associated interface definition files and scripts used to control + its compilation and installation. + + Pthreads-win32 is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU Lesser General Public License for more details. + + A copy of the GNU Lesser General Public License is distributed with + pthreads-win32 under the filename: + + COPYING.LIB + + You should have received a copy of the version 2.1 GNU Lesser General + Public License with pthreads-win32; if not, write to: + + Free Software Foundation, Inc. + 59 Temple Place + Suite 330 + Boston, MA 02111-1307 + USA + + The contact addresses for pthreads-win32 is as follows: + + Web: http://sources.redhat.com/pthreads-win32 + Email: Ross Johnson + Please use: Firstname.Lastname@homemail.com.au + + + +Pthreads-win32 copyrights and exception files +--------------------------------------------- + + With the exception of the files listed below, Pthreads-win32 + is covered under the following GNU Lesser General Public License + Copyrights: + + Pthreads-win32 - POSIX Threads Library for Win32 + Copyright(C) 1998 John E. Bossom + Copyright(C) 1999,2006 Pthreads-win32 contributors + + The current list of contributors is contained + in the file CONTRIBUTORS included with the source + code distribution. The current list of CONTRIBUTORS + can also be seen at the following WWW location: + http://sources.redhat.com/pthreads-win32/contributors.html + + Contact Email: Ross Johnson + Please use: Firstname.Lastname@homemail.com.au + + These files are not covered under one of the Copyrights listed above: + + COPYING + COPYING.LIB + tests/rwlock7.c + + This file, COPYING, is distributed under the Copyright found at the + top of this file. It is important to note that you may distribute + verbatim copies of this file but you may not modify this file. + + The file COPYING.LIB, which contains a copy of the version 2.1 + GNU Lesser General Public License, is itself copyrighted by the + Free Software Foundation, Inc. Please note that the Free Software + Foundation, Inc. does NOT have a copyright over Pthreads-win32, + only the COPYING.LIB that is supplied with pthreads-win32. + + The file tests/rwlock7.c is derived from code written by + Dave Butenhof for his book 'Programming With POSIX(R) Threads'. + The original code was obtained by free download from his website + http://home.earthlink.net/~anneart/family/Threads/source.html + and did not contain a copyright or author notice. It is assumed to + be freely distributable. + + In all cases one may use and distribute these exception files freely. + And because one may freely distribute the LGPL covered files, the + entire pthreads-win32 source may be freely used and distributed. + + + +General Copyleft and License info +--------------------------------- + + For general information on Copylefts, see: + + http://www.gnu.org/copyleft/ + + For information on GNU Lesser General Public Licenses, see: + + http://www.gnu.org/copyleft/lesser.html + http://www.gnu.org/copyleft/lesser.txt + + +Why pthreads-win32 did not use the GNU General Public License +------------------------------------------------------------- + + The goal of the pthreads-win32 project has been to + provide a quality and complete implementation of the POSIX + threads API for Microsoft Windows within the limits imposed + by virtue of it being a stand-alone library and not + linked directly to other POSIX compliant libraries. For + example, some functions and features, such as those based + on POSIX signals, are missing. + + Pthreads-win32 is a library, available in several different + versions depending on supported compilers, and may be used + as a dynamically linked module or a statically linked set of + binary modules. It is not an application on it's own. + + It was fully intended that pthreads-win32 be usable with + commercial software not covered by either the GPL or the LGPL + licenses. Pthreads-win32 has many contributors to it's + code base, many of whom have done so because they have + used the library in commercial or proprietry software + projects. + + Releasing pthreads-win32 under the LGPL ensures that the + library can be used widely, while at the same time ensures + that bug fixes and improvements to the pthreads-win32 code + itself is returned to benefit all current and future users + of the library. + + Although pthreads-win32 makes it possible for applications + that use POSIX threads to be ported to Win32 platforms, the + broader goal of the project is to encourage the use of open + standards, and in particular, to make it just a little easier + for developers writing Win32 applications to consider + widening the potential market for their products. diff --git a/external/pthreads-w32/COPYING.LIB b/external/pthreads-w32/COPYING.LIB new file mode 100644 index 00000000..cbee875b --- /dev/null +++ b/external/pthreads-w32/COPYING.LIB @@ -0,0 +1,504 @@ + GNU LESSER GENERAL PUBLIC LICENSE + Version 2.1, February 1999 + + Copyright (C) 1991, 1999 Free Software Foundation, Inc. + 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + Everyone is permitted to copy and distribute verbatim copies + of this license document, but changing it is not allowed. + +[This is the first released version of the Lesser GPL. It also counts + as the successor of the GNU Library Public License, version 2, hence + the version number 2.1.] + + Preamble + + The licenses for most software are designed to take away your +freedom to share and change it. By contrast, the GNU General Public +Licenses are intended to guarantee your freedom to share and change +free software--to make sure the software is free for all its users. + + This license, the Lesser General Public License, applies to some +specially designated software packages--typically libraries--of the +Free Software Foundation and other authors who decide to use it. You +can use it too, but we suggest you first think carefully about whether +this license or the ordinary General Public License is the better +strategy to use in any particular case, based on the explanations below. + + When we speak of free software, we are referring to freedom of use, +not price. Our General Public Licenses are designed to make sure that +you have the freedom to distribute copies of free software (and charge +for this service if you wish); that you receive source code or can get +it if you want it; that you can change the software and use pieces of +it in new free programs; and that you are informed that you can do +these things. + + To protect your rights, we need to make restrictions that forbid +distributors to deny you these rights or to ask you to surrender these +rights. These restrictions translate to certain responsibilities for +you if you distribute copies of the library or if you modify it. + + For example, if you distribute copies of the library, whether gratis +or for a fee, you must give the recipients all the rights that we gave +you. You must make sure that they, too, receive or can get the source +code. If you link other code with the library, you must provide +complete object files to the recipients, so that they can relink them +with the library after making changes to the library and recompiling +it. And you must show them these terms so they know their rights. + + We protect your rights with a two-step method: (1) we copyright the +library, and (2) we offer you this license, which gives you legal +permission to copy, distribute and/or modify the library. + + To protect each distributor, we want to make it very clear that +there is no warranty for the free library. Also, if the library is +modified by someone else and passed on, the recipients should know +that what they have is not the original version, so that the original +author's reputation will not be affected by problems that might be +introduced by others. + + Finally, software patents pose a constant threat to the existence of +any free program. We wish to make sure that a company cannot +effectively restrict the users of a free program by obtaining a +restrictive license from a patent holder. Therefore, we insist that +any patent license obtained for a version of the library must be +consistent with the full freedom of use specified in this license. + + Most GNU software, including some libraries, is covered by the +ordinary GNU General Public License. This license, the GNU Lesser +General Public License, applies to certain designated libraries, and +is quite different from the ordinary General Public License. We use +this license for certain libraries in order to permit linking those +libraries into non-free programs. + + When a program is linked with a library, whether statically or using +a shared library, the combination of the two is legally speaking a +combined work, a derivative of the original library. The ordinary +General Public License therefore permits such linking only if the +entire combination fits its criteria of freedom. The Lesser General +Public License permits more lax criteria for linking other code with +the library. + + We call this license the "Lesser" General Public License because it +does Less to protect the user's freedom than the ordinary General +Public License. It also provides other free software developers Less +of an advantage over competing non-free programs. These disadvantages +are the reason we use the ordinary General Public License for many +libraries. However, the Lesser license provides advantages in certain +special circumstances. + + For example, on rare occasions, there may be a special need to +encourage the widest possible use of a certain library, so that it becomes +a de-facto standard. To achieve this, non-free programs must be +allowed to use the library. A more frequent case is that a free +library does the same job as widely used non-free libraries. In this +case, there is little to gain by limiting the free library to free +software only, so we use the Lesser General Public License. + + In other cases, permission to use a particular library in non-free +programs enables a greater number of people to use a large body of +free software. For example, permission to use the GNU C Library in +non-free programs enables many more people to use the whole GNU +operating system, as well as its variant, the GNU/Linux operating +system. + + Although the Lesser General Public License is Less protective of the +users' freedom, it does ensure that the user of a program that is +linked with the Library has the freedom and the wherewithal to run +that program using a modified version of the Library. + + The precise terms and conditions for copying, distribution and +modification follow. Pay close attention to the difference between a +"work based on the library" and a "work that uses the library". The +former contains code derived from the library, whereas the latter must +be combined with the library in order to run. + + GNU LESSER GENERAL PUBLIC LICENSE + TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION + + 0. This License Agreement applies to any software library or other +program which contains a notice placed by the copyright holder or +other authorized party saying it may be distributed under the terms of +this Lesser General Public License (also called "this License"). +Each licensee is addressed as "you". + + A "library" means a collection of software functions and/or data +prepared so as to be conveniently linked with application programs +(which use some of those functions and data) to form executables. + + The "Library", below, refers to any such software library or work +which has been distributed under these terms. A "work based on the +Library" means either the Library or any derivative work under +copyright law: that is to say, a work containing the Library or a +portion of it, either verbatim or with modifications and/or translated +straightforwardly into another language. (Hereinafter, translation is +included without limitation in the term "modification".) + + "Source code" for a work means the preferred form of the work for +making modifications to it. For a library, complete source code means +all the source code for all modules it contains, plus any associated +interface definition files, plus the scripts used to control compilation +and installation of the library. + + Activities other than copying, distribution and modification are not +covered by this License; they are outside its scope. The act of +running a program using the Library is not restricted, and output from +such a program is covered only if its contents constitute a work based +on the Library (independent of the use of the Library in a tool for +writing it). Whether that is true depends on what the Library does +and what the program that uses the Library does. + + 1. You may copy and distribute verbatim copies of the Library's +complete source code as you receive it, in any medium, provided that +you conspicuously and appropriately publish on each copy an +appropriate copyright notice and disclaimer of warranty; keep intact +all the notices that refer to this License and to the absence of any +warranty; and distribute a copy of this License along with the +Library. + + You may charge a fee for the physical act of transferring a copy, +and you may at your option offer warranty protection in exchange for a +fee. + + 2. You may modify your copy or copies of the Library or any portion +of it, thus forming a work based on the Library, and copy and +distribute such modifications or work under the terms of Section 1 +above, provided that you also meet all of these conditions: + + a) The modified work must itself be a software library. + + b) You must cause the files modified to carry prominent notices + stating that you changed the files and the date of any change. + + c) You must cause the whole of the work to be licensed at no + charge to all third parties under the terms of this License. + + d) If a facility in the modified Library refers to a function or a + table of data to be supplied by an application program that uses + the facility, other than as an argument passed when the facility + is invoked, then you must make a good faith effort to ensure that, + in the event an application does not supply such function or + table, the facility still operates, and performs whatever part of + its purpose remains meaningful. + + (For example, a function in a library to compute square roots has + a purpose that is entirely well-defined independent of the + application. Therefore, Subsection 2d requires that any + application-supplied function or table used by this function must + be optional: if the application does not supply it, the square + root function must still compute square roots.) + +These requirements apply to the modified work as a whole. If +identifiable sections of that work are not derived from the Library, +and can be reasonably considered independent and separate works in +themselves, then this License, and its terms, do not apply to those +sections when you distribute them as separate works. But when you +distribute the same sections as part of a whole which is a work based +on the Library, the distribution of the whole must be on the terms of +this License, whose permissions for other licensees extend to the +entire whole, and thus to each and every part regardless of who wrote +it. + +Thus, it is not the intent of this section to claim rights or contest +your rights to work written entirely by you; rather, the intent is to +exercise the right to control the distribution of derivative or +collective works based on the Library. + +In addition, mere aggregation of another work not based on the Library +with the Library (or with a work based on the Library) on a volume of +a storage or distribution medium does not bring the other work under +the scope of this License. + + 3. You may opt to apply the terms of the ordinary GNU General Public +License instead of this License to a given copy of the Library. To do +this, you must alter all the notices that refer to this License, so +that they refer to the ordinary GNU General Public License, version 2, +instead of to this License. (If a newer version than version 2 of the +ordinary GNU General Public License has appeared, then you can specify +that version instead if you wish.) Do not make any other change in +these notices. + + Once this change is made in a given copy, it is irreversible for +that copy, so the ordinary GNU General Public License applies to all +subsequent copies and derivative works made from that copy. + + This option is useful when you wish to copy part of the code of +the Library into a program that is not a library. + + 4. You may copy and distribute the Library (or a portion or +derivative of it, under Section 2) in object code or executable form +under the terms of Sections 1 and 2 above provided that you accompany +it with the complete corresponding machine-readable source code, which +must be distributed under the terms of Sections 1 and 2 above on a +medium customarily used for software interchange. + + If distribution of object code is made by offering access to copy +from a designated place, then offering equivalent access to copy the +source code from the same place satisfies the requirement to +distribute the source code, even though third parties are not +compelled to copy the source along with the object code. + + 5. A program that contains no derivative of any portion of the +Library, but is designed to work with the Library by being compiled or +linked with it, is called a "work that uses the Library". Such a +work, in isolation, is not a derivative work of the Library, and +therefore falls outside the scope of this License. + + However, linking a "work that uses the Library" with the Library +creates an executable that is a derivative of the Library (because it +contains portions of the Library), rather than a "work that uses the +library". The executable is therefore covered by this License. +Section 6 states terms for distribution of such executables. + + When a "work that uses the Library" uses material from a header file +that is part of the Library, the object code for the work may be a +derivative work of the Library even though the source code is not. +Whether this is true is especially significant if the work can be +linked without the Library, or if the work is itself a library. The +threshold for this to be true is not precisely defined by law. + + If such an object file uses only numerical parameters, data +structure layouts and accessors, and small macros and small inline +functions (ten lines or less in length), then the use of the object +file is unrestricted, regardless of whether it is legally a derivative +work. (Executables containing this object code plus portions of the +Library will still fall under Section 6.) + + Otherwise, if the work is a derivative of the Library, you may +distribute the object code for the work under the terms of Section 6. +Any executables containing that work also fall under Section 6, +whether or not they are linked directly with the Library itself. + + 6. As an exception to the Sections above, you may also combine or +link a "work that uses the Library" with the Library to produce a +work containing portions of the Library, and distribute that work +under terms of your choice, provided that the terms permit +modification of the work for the customer's own use and reverse +engineering for debugging such modifications. + + You must give prominent notice with each copy of the work that the +Library is used in it and that the Library and its use are covered by +this License. You must supply a copy of this License. If the work +during execution displays copyright notices, you must include the +copyright notice for the Library among them, as well as a reference +directing the user to the copy of this License. Also, you must do one +of these things: + + a) Accompany the work with the complete corresponding + machine-readable source code for the Library including whatever + changes were used in the work (which must be distributed under + Sections 1 and 2 above); and, if the work is an executable linked + with the Library, with the complete machine-readable "work that + uses the Library", as object code and/or source code, so that the + user can modify the Library and then relink to produce a modified + executable containing the modified Library. (It is understood + that the user who changes the contents of definitions files in the + Library will not necessarily be able to recompile the application + to use the modified definitions.) + + b) Use a suitable shared library mechanism for linking with the + Library. A suitable mechanism is one that (1) uses at run time a + copy of the library already present on the user's computer system, + rather than copying library functions into the executable, and (2) + will operate properly with a modified version of the library, if + the user installs one, as long as the modified version is + interface-compatible with the version that the work was made with. + + c) Accompany the work with a written offer, valid for at + least three years, to give the same user the materials + specified in Subsection 6a, above, for a charge no more + than the cost of performing this distribution. + + d) If distribution of the work is made by offering access to copy + from a designated place, offer equivalent access to copy the above + specified materials from the same place. + + e) Verify that the user has already received a copy of these + materials or that you have already sent this user a copy. + + For an executable, the required form of the "work that uses the +Library" must include any data and utility programs needed for +reproducing the executable from it. However, as a special exception, +the materials to be distributed need not include anything that is +normally distributed (in either source or binary form) with the major +components (compiler, kernel, and so on) of the operating system on +which the executable runs, unless that component itself accompanies +the executable. + + It may happen that this requirement contradicts the license +restrictions of other proprietary libraries that do not normally +accompany the operating system. Such a contradiction means you cannot +use both them and the Library together in an executable that you +distribute. + + 7. You may place library facilities that are a work based on the +Library side-by-side in a single library together with other library +facilities not covered by this License, and distribute such a combined +library, provided that the separate distribution of the work based on +the Library and of the other library facilities is otherwise +permitted, and provided that you do these two things: + + a) Accompany the combined library with a copy of the same work + based on the Library, uncombined with any other library + facilities. This must be distributed under the terms of the + Sections above. + + b) Give prominent notice with the combined library of the fact + that part of it is a work based on the Library, and explaining + where to find the accompanying uncombined form of the same work. + + 8. You may not copy, modify, sublicense, link with, or distribute +the Library except as expressly provided under this License. Any +attempt otherwise to copy, modify, sublicense, link with, or +distribute the Library is void, and will automatically terminate your +rights under this License. However, parties who have received copies, +or rights, from you under this License will not have their licenses +terminated so long as such parties remain in full compliance. + + 9. You are not required to accept this License, since you have not +signed it. However, nothing else grants you permission to modify or +distribute the Library or its derivative works. These actions are +prohibited by law if you do not accept this License. Therefore, by +modifying or distributing the Library (or any work based on the +Library), you indicate your acceptance of this License to do so, and +all its terms and conditions for copying, distributing or modifying +the Library or works based on it. + + 10. Each time you redistribute the Library (or any work based on the +Library), the recipient automatically receives a license from the +original licensor to copy, distribute, link with or modify the Library +subject to these terms and conditions. You may not impose any further +restrictions on the recipients' exercise of the rights granted herein. +You are not responsible for enforcing compliance by third parties with +this License. + + 11. If, as a consequence of a court judgment or allegation of patent +infringement or for any other reason (not limited to patent issues), +conditions are imposed on you (whether by court order, agreement or +otherwise) that contradict the conditions of this License, they do not +excuse you from the conditions of this License. If you cannot +distribute so as to satisfy simultaneously your obligations under this +License and any other pertinent obligations, then as a consequence you +may not distribute the Library at all. For example, if a patent +license would not permit royalty-free redistribution of the Library by +all those who receive copies directly or indirectly through you, then +the only way you could satisfy both it and this License would be to +refrain entirely from distribution of the Library. + +If any portion of this section is held invalid or unenforceable under any +particular circumstance, the balance of the section is intended to apply, +and the section as a whole is intended to apply in other circumstances. + +It is not the purpose of this section to induce you to infringe any +patents or other property right claims or to contest validity of any +such claims; this section has the sole purpose of protecting the +integrity of the free software distribution system which is +implemented by public license practices. Many people have made +generous contributions to the wide range of software distributed +through that system in reliance on consistent application of that +system; it is up to the author/donor to decide if he or she is willing +to distribute software through any other system and a licensee cannot +impose that choice. + +This section is intended to make thoroughly clear what is believed to +be a consequence of the rest of this License. + + 12. If the distribution and/or use of the Library is restricted in +certain countries either by patents or by copyrighted interfaces, the +original copyright holder who places the Library under this License may add +an explicit geographical distribution limitation excluding those countries, +so that distribution is permitted only in or among countries not thus +excluded. In such case, this License incorporates the limitation as if +written in the body of this License. + + 13. The Free Software Foundation may publish revised and/or new +versions of the Lesser General Public License from time to time. +Such new versions will be similar in spirit to the present version, +but may differ in detail to address new problems or concerns. + +Each version is given a distinguishing version number. If the Library +specifies a version number of this License which applies to it and +"any later version", you have the option of following the terms and +conditions either of that version or of any later version published by +the Free Software Foundation. If the Library does not specify a +license version number, you may choose any version ever published by +the Free Software Foundation. + + 14. If you wish to incorporate parts of the Library into other free +programs whose distribution conditions are incompatible with these, +write to the author to ask for permission. For software which is +copyrighted by the Free Software Foundation, write to the Free +Software Foundation; we sometimes make exceptions for this. Our +decision will be guided by the two goals of preserving the free status +of all derivatives of our free software and of promoting the sharing +and reuse of software generally. + + NO WARRANTY + + 15. BECAUSE THE LIBRARY IS LICENSED FREE OF CHARGE, THERE IS NO +WARRANTY FOR THE LIBRARY, TO THE EXTENT PERMITTED BY APPLICABLE LAW. +EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR +OTHER PARTIES PROVIDE THE LIBRARY "AS IS" WITHOUT WARRANTY OF ANY +KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE +IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR +PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE +LIBRARY IS WITH YOU. SHOULD THE LIBRARY PROVE DEFECTIVE, YOU ASSUME +THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION. + + 16. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN +WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY +AND/OR REDISTRIBUTE THE LIBRARY AS PERMITTED ABOVE, BE LIABLE TO YOU +FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR +CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE +LIBRARY (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING +RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A +FAILURE OF THE LIBRARY TO OPERATE WITH ANY OTHER SOFTWARE), EVEN IF +SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH +DAMAGES. + + END OF TERMS AND CONDITIONS + + How to Apply These Terms to Your New Libraries + + If you develop a new library, and you want it to be of the greatest +possible use to the public, we recommend making it free software that +everyone can redistribute and change. You can do so by permitting +redistribution under these terms (or, alternatively, under the terms of the +ordinary General Public License). + + To apply these terms, attach the following notices to the library. It is +safest to attach them to the start of each source file to most effectively +convey the exclusion of warranty; and each file should have at least the +"copyright" line and a pointer to where the full notice is found. + + + Copyright (C) + + This library is free software; you can redistribute it and/or + modify it under the terms of the GNU Lesser General Public + License as published by the Free Software Foundation; either + version 2.1 of the License, or (at your option) any later version. + + This library is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + Lesser General Public License for more details. + + You should have received a copy of the GNU Lesser General Public + License along with this library; if not, write to the Free Software + Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + +Also add information on how to contact you by electronic and paper mail. + +You should also get your employer (if you work as a programmer) or your +school, if any, to sign a "copyright disclaimer" for the library, if +necessary. Here is a sample; alter the names: + + Yoyodyne, Inc., hereby disclaims all copyright interest in the + library `Frob' (a library for tweaking knobs) written by James Random Hacker. + + , 1 April 1990 + Ty Coon, President of Vice + +That's all there is to it! + + diff --git a/external/pthreads-w32/ChangeLog b/external/pthreads-w32/ChangeLog new file mode 100644 index 00000000..7c6ba395 --- /dev/null +++ b/external/pthreads-w32/ChangeLog @@ -0,0 +1,5211 @@ +2012-03-18 Ross Johnson + + * create.c (pthread_create): add __cdecl attribute to thread routine + arg + * implement.h (pthread_key_t): add __cdecl attribute to destructor + element + (ThreadParms): likewise for start element + * pthread.h (pthread_create): add __cdecl to prototype start arg + (pthread_once): likewise for init_routine arg + (pthread_key_create): likewise for destructor arg + (ptw32_cleanup_push): replace type of routine arg with previously + defined ptw32_cleanup_callback_t + * pthread_key_create.c: add __cdecl attribute to destructor arg + * pthread_once.c: add __cdecl attribute to init_routine arg + * ptw32_threadStart.c (start): add __cdecl to start variable type + + +2011-07-06 Ross Johnson + + * pthread_cond_wait.c (pragma inline_depth): this is almost redundant + now nevertheless fixed thei controlling MSC_VER from "< 800" to + "< 1400" (i.e. any prior to VC++ 8.0). + * pthread_once.ci (pragma inline_depth): Likewise. + * pthread_rwlock_timedwrlock.ci (pragma inline_depth): Likewise. + * pthread_rwlock_wrlock.ci (pragma inline_depth): Likewise. + * sem_timedwait.ci (pragma inline_depth): Likewise. + * sem_wait.ci (pragma inline_depth): Likewise. + +2011-07-05 Ross Johnson + + * pthread_win32_attach_detach_np.c: Use strncat_s if available + to removei a compile warning; MingW supports this routine but we + continue to use strncat anyway there because it is secure if + given the correct parameters; fix strncat param 3 to avoid + buffer overrun exploitation potential. + +2011-07-03 Ross Johnson + + * pthread_spin_unlock.c (EPERM): Return success if unlocking a lock + that is not locked, because single CPU machines wrap a + PTHREAD_MUTEX_NORMAL mutex, which returns success in this case. + * pthread_win32_attach_detach_np.c (QUSEREX.DLL): Load from an + absolute path only which must be the Windows System folder. + +2011-07-03 Daniel Richard G. + + * Makefile (_WIN32_WINNT): Removed; duplicate definition in + implement.h; more cleanup and enhancements. + +2011-07-02 Daniel Richard G. + + * Makefile: Cleanups and implovements. + * ptw32_MCS_locks.c: Casting fixes. + * implement.h: Interlocked call and argument casting macro fixes + to support older and newer build environments. + +2011-07-01 Ross Johnson + + * *.[ch] (PTW32_INTERLOCKED_*): Redo 23 and 64 bit versions of these + macros and re-apply in code to undo the incorrect changes from + 2011-06-29; remove some size_t casts which should not be required + and may be problematic.a + There are now two sets of macros: + PTW32_INTERLOCKED_*_LONG which work only on 32 bit integer variables; + PTW32_INTERLOCKED_*_SIZE which work on size_t integer variables, i.e. + LONG for 32 bit systems and LONGLONG for 64 bit systems. + * implement.h (MCS locks): nextFlag and waitFlag are now HANDLE type. + * ptw32_MCS_locks.c: Likewise. + * pthread.h (#include ): Removed. + * ptw32_throw.c (#include ): Added. + * ptw32_threadStart.c (#include ): Added. + * implement.h (#include ): Added. + +2011-06-30 Ross Johnson + + * pthread_once.c: Tighten 'if' statement casting; fix interlocked + pointer cast for 64 bit compatibility (missed yesterday); remove + the superfluous static cleanup routine and call the release routine + directly if popped. + * create.c (stackSize): Now type size_t. + * pthread.h (struct ptw32_thread_t_): Rearrange to fix element alignments. + +2011-06-29 Daniel Richard G. + + * ptw32_relmillisecs.c (ftime): + _ftime64_s() is only available in MSVC 2005 or later; + _ftime64() is available in MinGW or MSVC 2002 or later; + _ftime() is always available. + * pthread.h (long long): Not defined in older MSVC 6. + * implement.h (long long): Likewise. + * pthread_getunique_np.c (long long): Likewise. + +2011-06-29 Ross Johnson + + * *.[ch] (PTW32_INTERLOCKED_*): These macros should now work for + both 32 and 64 bit builds. The MingW versions are all inlined asm + while the MSVC versions expand to their Interlocked* or Interlocked*64 + counterparts appropriately. The argument type have also been changed + to cast to the appropriate value or pointer size for the architecture. + +2011-05-29 Ross Johnson + + * *.[ch] (#ifdef): Extended cleanup to whole project. + +2011-05-29 Daniel Richard G. + + * Makefile (CC): Define CC to allow use of other compatible + compilers such as the Intel compilter icl. + * implement.h (#if): Fix forms like #if HAVE_SOMETHING. + * pthread.h: Likewise. + * sched.h: Likewise; PTW32_LEVEL_* becomes PTW32_SCHED_LEVEL_*. + * semaphore.h: Likewise. + +2011-05-11 Ross Johnson + + * ptw32_callUserDestroyRoutines.c (terminate): Altered includes + to match ptw32_threadStart.c. + * GNUmakefile (GCE-inlined-debug, DOPT): Fixed. + +2011-04-31 Ross Johnson + + * (robust mutexes): Added this API. The API is not + mandatory for implementations that don't support PROCESS_SHARED + mutexes, nevertheless it was considered useful both functionally + and for source-level compatibility. + +2011-03-26 Ross Johnson + + * pthread_getunique_np.c: New non-POSIX interface for compatibility + with some other implementations; returns a 64 bit sequence number + that is unique to each thread in the process. + * pthread.h (pthread_getunique_np): Added. + * global.c: Add global sequence counter for above. + * implement.h: Likewise. + +2011-03-25 Ross Johnson + + * (cancelLock): Convert to an MCS lock and rename to stateLock. + * (threadLock): Likewise. + * (keyLock): Likewise. + * pthread_mutex*.c: First working robust mutexes. + +2011-03-11 Ross Johnson + + * implement.h (PTW32_INTERLOCKED_*CREMENT macros): increment/decrement + using ++/-- instead of add/subtract 1. + * ptw32_MCS_lock.c: Make casts consistent. + +2011-03-09 Ross Johnson + + * implement.h (ptw32_thread_t_): Add process unique sequence number. + * global.c: Replace global Critical Section objects with MCS + queue locks. + * implement.h: Likewise. + * pthread_cond_destroy.c: Likewise. + * pthread_cond_init.c: Likewise. + * pthread_detach.c: Likewise. + * pthread_join.c: Likewise. + * pthread_kill.c: Likewise. + * pthread_mutex_destroy.c: Likewise. + * pthread_rwlock_destroy.c: Likewise. + * pthread_spin_destroy.c: Likewise. + * pthread_timechange_handler_np.c: Likewise. + * ptw32_cond_check_need_init.c: Likewise. + * ptw32_mutex_check_need_init.c: Likewise. + * ptw32_processInitialize.c: Likewise. + * ptw32_processTerminate.c: Likewise. + * ptw32_reuse.c: Likewise. + * ptw32_rwlock_check_need_init.c: Likewise. + * ptw32_spinlock_check_need_init.c: Likewise. + +2011-03-06 Ross Johnson + + * several (MINGW64): Cast and call fixups for 64 bit compatibility; + clean build via x86_64-w64-mingw32 cross toolchain on Linux i686 + targeting x86_64 win64. + * ptw32_threadStart.c (ptw32_threadStart): Routine no longer attempts + to pass [unexpected C++] exceptions out of scope but ends the thread + normally setting EINTR as the exit status. + * ptw32_throw.c: Fix C++ exception throwing warnings; ignore + informational warning. + * implement.h: Likewise with the corresponding header definition. + +2011-03-04 Ross Johnson + + * implement.h (PTW32_INTERLOCKED_*): Mingw32 does not provide + the __sync_* intrinsics so implemented them here as macro + assembler routines. MSVS Interlocked* are emmitted as intrinsics + wherever possible, so we want mingw to match it; Extended to + include all interlocked routines used by the library; implemented + x86_64 versions also. + * ptw32_InterlockedCompareExchange.c: No code remaining here. + * ptw32_MCS_lock.c: Converted interlocked calls to use new macros. + * pthread_barrier_wait.c: Likewise. + * pthread_once.c: Likewise. + * ptw32_MCS_lock.c (ptw32_mcs_node_substitute): Name changed to + ptw32_mcs_node_transfer. + +2011-02-28 Ross Johnson + + * ptw32_relmillisecs.c: If possible, use _ftime64_s or _ftime64 + before resorting to _ftime. + +2011-02-27 Ross Johnson + + * sched_setscheduler.c: Ensure the handle is closed after use. + * sched_getscheduler.c: Likewise. + * pthread.h: Remove POSIX compatibility macros; don't define + timespec if already defined. + * context.h: Changes for 64 bit. + * pthread_cancel.c: Likewise. + * pthread_exit.c: Likewise. + * pthread_spin_destroy.c: Likewise. + * pthread_timechange_handler_np.c: Likewise. + * ptw32_MCS_lock.c: Likewise; some of these changes may + not be compatible with pre Windows 2000 systems; reverse the order of + the includes. + * ptw32_threadStart.c: Likewise. + * ptw32_throw.c: Likewise. + +2011-02-13 Ross Johnson + + * pthread_self: Add comment re returning 'nil' value to + indicate failure only to win32 threads that call us. + * pthread_attr_setstackaddr: Fix comments; note this + function and it's compliment are now removed from SUSv4. + +2011-02-12 Ross Johnson + + README.NONPORTABLE: Record a description of an obvious + method for nulling/comparing/hashing pthread_t using a + union; plus and investigation of a change of type for + pthread_t (to a union) to neutralise any padding bits and + bytes if they occur in pthread_t (the current pthread_t struct + does not contain padding AFAIK, but porting the library to a + future architecture may introduce them). Padding affects + byte-by-byte copies and compare operations. + +2010-11-16 Ross Johnson + + * ChangeLog: Add this entry ;-) + Restore entries from 2007 through 2009 that went missing + at the last update. + +2010-06-19 Ross Johnson + + * ptw32_MCS_lock.c (ptw32_mcs_node_substitute): Fix variable + names to avoid using C++ keyword ("new"). + * implement.h (ptw32_mcs_node_substitute): Likewise. + * pthread_barrier_wait.c: Fix signed/unsigned comparison warning. + +2010-06-18 Ramiro Polla + + * autostatic.c: New file; call pthread_win32_process_*() + libary init/cleanup routines automatically on application start + when statically linked. + * pthread.c (autostatic.c): Included. + * pthread.h (declspec): Remove import/export defines if compiler + is MINGW. + * sched.h (declspec): Likewise. + * semaphore.h (declspec): Likewise. + * need_errno.h (declspec): Likewise. + * Makefile (autostatic.obj): Add for small static builds. + * GNUmakefile (autostatic.o): Likewise. + * NEWS (Version 2.9.0): Add changes. + * README.NONPORTABLE (pthread_win32_process_*): Update + description. + +2010-06-15 Ramiro Polla + + * Makefile: Remove linkage with the winsock library by default. + * GNUmakefile: Likewise. + * pthread_getspecific.c: Likewise by removing calls to WSA + functions. + * config.h (RETAIN_WSALASTERROR): Can be defined if necessary. + +2010-01-26 Ross Johnson + + * ptw32_MCS_lock.c (ptw32_mcs_node_substitute): New routine + to allow relocating the lock owners thread-local node to somewhere + else, e.g. to global space so that another thread can release the + lock. Used in pthread_barrier_wait. + (ptw32_mcs_lock_try_acquire): New routine. + * pthread_barrier_init: Only one semaphore is used now. + * pthread_barrier_wait: Added an MCS guard lock with the last thread + to leave the barrier releasing the lock. This removes a deadlock bug + observed when there are greater than barrier-count threads + attempting to cross. + * pthread_barrier_destroy: Added an MCS guard lock. + +2009-03-03 Stephan O'Farrill + + * pthread_attr_getschedpolicy.c: Add "const" to function parameter + in accordance with SUSv3 (POSIX). + * pthread_attr_getinheritsched.c: Likewise. + * pthread_mutexattr_gettype.c: Likewise. + +2008-06-06 Robert Kindred + + * ptw32_throw.c (ptw32_throw): Remove possible reference to NULL + pointer. (At the same time made the switch block conditionally + included only if exitCode is needed - RPJ.) + * pthread_testcancel.c (pthread_testcancel): Remove duplicate and + misplaced pthread_mutex_unlock(). + +2008-02-21 Sebastian Gottschalk + + * pthread_attr_getdetachstate.c (pthread_attr_getdetachstate): + Remove potential and superfluous null pointer assignment. + +2007-11-22 Ivan Pizhenko + + * pthread.h (gmtime_r): gmtime returns 0 if tm represents a time + prior to 1/1/1970. Notice this to prevent raising an exception. + * pthread.h (localtime_r): Likewise for localtime. + +2007-07-14 Marcel Ruff + + * errno.c (_errno): Fix test for pthread_self() success. + * need_errno.h: Remove unintentional line wrap from #if line. + +2007-07-14 Mike Romanchuk + + * pthread.h (timespec): Fix tv_sec type. + +2007-01-07 Sinan Kaya + + * need_errno.h: Fix declaration of _errno - the local version of + _errno() is used, e.g. by WinCE. + +2007-01-06 Ross Johnson + + * ptw32_semwait.c: Add check for invalid sem_t after acquiring the + sem_t state guard mutex and before affecting changes to sema state. + +2007-01-06 Marcel Ruff + + * error.c: Fix reference to pthread handle exitStatus member for + builds that use NEED_ERRNO (i.e. WINCE). + * context.h: Add support for ARM processor (WinCE). + * mutex.c (process.h): Exclude for WINCE. + * create.c: Likewise. + * exit.c: Likewise. + * implement.h: Likewise. + * pthread_detach.c (signal.h): Exclude for WINCE. + * pthread_join.c: Likewise. + * pthread_kill.c: Likewise. + * pthread_rwlock_init.c (errno.h): Remove - included by pthread.h. + * pthread_rwlock_destroy.c: Likewise. + * pthread_rwlock_rdlock.c: Likewise. + * pthread_rwlock_timedrdlock.c: Likewise. + * pthread_rwlock_timedwrlock.c: Likewise. + * pthread_rwlock_tryrdlock.c: Likewise. + * pthread_rwlock_trywrlock.c: likewise. + * pthread_rwlock_unlock.c: Likewise. + * pthread_rwlock_wrlock.c: Likewise. + * pthread_rwlockattr_destroy.c: Likewise. + * pthread_rwlockattr_getpshared.c: Likewise. + * pthread_rwlockattr_init.c: Likewise. + * pthread_rwlockattr_setpshared.c: Likewise. + +2007-01-06 Romano Paolo Tenca + + * pthread_cond_destroy.c: Replace sem_wait() with non-cancelable + ptw32_semwait() since pthread_cond_destroy() is not a cancelation + point. + * implement.h (ptw32_spinlock_check_need_init): Add prototype. + * ptw32_MCS_lock.c: Reverse order of includes. + +2007-01-06 Eric Berge + + * pthread_cond_destroy.c: Add LeaveCriticalSection before returning + after errors. + +2007-01-04 Ross Johnson + + * ptw32_InterlockedCompareExchange.c: Conditionally skip for + Win64 as not required. + * pthread_win32_attach_detach_np.c (pthread_win32_process_attach_np): + Test for InterlockedCompareExchange is not required for Win64. + * context.h: New file. Included by pthread_cancel.h and any tests + that need it (e.g. context1.c). + * pthread_cancel.c: Architecture-dependent context macros moved + to context.h. + +2007-01-04 Kip Streithorst + + * implement.h (PTW32_INTERLOCKED_COMPARE_EXCHANGE): Add Win64 + support. + +2006-12-20 Ross Johnson + + * sem_destroy.c: Fix the race involving invalidation of the sema; + fix incorrect return of EBUSY resulting from the mutex trylock + on the private mutex guard. + * sem_wait.c: Add check for invalid sem_t after acquiring the + sem_t state guard mutex and before affecting changes to sema state. + * sem_trywait.c: Likewise. + * sem_timedwait.c: Likewise. + * sem_getvalue.c: Likewise. + * sem_post.c: Similar. + * sem_post_multiple.c: Likewise. + * sem_init.c: Set max Win32 semaphore count to SEM_VALUE_MAX (was + _POSIX_SEM_VALUE_MAX, which is a lower value - the minimum). + + * pthread_win32_attach_detach_np.c (pthread_win32_process_attach_np): + Load COREDLL.DLL under WINCE to check existence of + InterlockedCompareExchange() routine. This used to be done to test + for TryEnterCriticalSection() but was removed when this was no + longer needed. + +2006-01-25 Prashant Thakre + + * pthread_cancel.c: Added _M_IA64 register context support. + +2005-05-13 Ross Johnson + + * pthread_kill.c (pthread_kill): Remove check for Win32 thread + priority (to confirm HANDLE validity). Useless since thread HANDLEs + a not recycle-unique. + +2005-05-30 Vladimir Kliatchko + + * pthread_once.c: Re-implement using an MCS queue-based lock. The form + of pthread_once is as proposed by Alexander Terekhov (see entry of + 2005-03-13). The MCS lock implementation does not require a unique + 'name' to identify the lock between threads. Attempts to get the Event + or Semaphore based versions of pthread_once to a satisfactory level + of robustness have thus far failed. The last problem (avoiding races + involving non recycle-unique Win32 HANDLEs) was giving everyone + grey hair trying to solve it. + + * ptw32_MCS_lock.c: New MCS queue-based lock implementation. These + locks are efficient: they have very low overhead in the uncontended case; + are efficient in contention and minimise cache-coherence updates in + managing the user level FIFO queue; do not require an ABI change in the + library. + +2005-05-27 Alexander Gottwald + + * pthread.h: Some things, like HANDLE, were only defined if + PTW32_LEVEL was >= 3. They should always be defined. + +2005-05-25 Vladimir Kliatchko + + * pthread_once.c: Eliminate all priority operations and other + complexity by replacing the event with a semaphore. The advantage + of the change is the ability to release just one waiter if the + init_routine thread is cancelled yet still release all waiters when + done. Simplify once_control state checks to improve efficiency + further. + +2005-05-24 Mikael Magnusson + + * GNUmakefile: Patched to allow cross-compile with mingw32 on Linux. + It uses macros instead of referencing dlltool, gcc and g++ directly; + added a call to ranlib. For example the GC static library can be + built with: + make CC=i586-mingw32msvc-gcc RC=i586-mingw32msvc-windres \ + RANLIB=i586-mingw32msvc-ranlib clean GC-static + +2005-05-13 Ross Johnson + + * pthread_win32_attach_detach_np.c (pthread_win32_thread_detach_np): + Move on-exit-only stuff from ptw32_threadDestroy() to here. + * ptw32_threadDestroy.c: It's purpose is now only to reclaim thread + resources for detached threads, or via pthread_join() or + pthread_detach() on joinable threads. + * ptw32_threadStart.c: Calling user destruct routines has moved to + pthread_win32_thread_detach_np(); call pthread_win32_thread_detach_np() + directly if statically linking, otherwise do so via dllMain; store + thread return value in thread struct for all cases, including + cancellation and exception exits; thread abnormal exits go via + pthread_win32_thread_detach_np. + * pthread_join.c (pthread_join): Don't try to get return code from + Win32 thread - always get it from he thread struct. + * pthread_detach.c (pthread_detach): reduce extent of the thread + existence check since we now don't care if the Win32 thread HANDLE has + been closed; reclaim thread resources if the thread has exited already. + * ptw32_throw.c (ptw32_throw): For Win32 threads that are not implicit, + only Call thread cleanup if statically linking, otherwise leave it to + dllMain. + * sem_post.c (_POSIX_SEM_VALUE_MAX): Change to SEM_VALUE_MAX. + * sem_post_multiple.c: Likewise. + * sem_init.c: Likewise. + +2005-05-10 Ross Johnson + + * pthread_join.c (pthread_join): Add missing check for thread ID + reference count in thread existence test; reduce extent of the + existence test since we don't care if the Win32 thread HANDLE has + been closed. + +2005-05-09 Ross Johnson + + * ptw32_callUserDestroyRoutines.c: Run destructor process (i.e. + loop over all keys calling destructors) up to + PTHREAD_DESTRUCTOR_ITERATIONS times if TSD value isn't NULL yet; + modify assoc management. + * pthread_key_delete.c: Modify assoc management. + * ptw32_tkAssocDestroy.c: Fix error in assoc removal from chains. + * pthread.h + (_POSIX_THREAD_DESTRUCTOR_ITERATIONS): Define to value specified by + POSIX. + (_POSIX_THREAD_KEYS_MAX): Define to value specified by POSIX. + (PTHREAD_KEYS_MAX): Redefine [upward] to minimum required by POSIX. + (SEM_NSEMS_MAX): Define to implementation value. + (SEM_VALUE_MAX): Define to implementation value. + (_POSIX_SEM_NSEMS_MAX): Redefine to value specified by POSIX. + (_POSIX_SEM_VALUE_MAX): Redefine to value specified by POSIX. + +2005-05-06 Ross Johnson + + * signal.c (sigwait): Add a cancellation point to this otherwise + no-op. + * sem_init.c (sem_init): Check for and return ERANGE error. + * sem_post.c (sem_post): Likewise. + * sem_post_multiple.c (sem_post_multiple): Likewise. + * manual (directory): Added; see ChangeLog inside. + +2005-05-02 Ross Johnson + + * implement.h (struct pthread_key_t_): Change threadsLock to keyLock + so as not to be confused with the per thread lock 'threadlock'; + change all references to it. + * implement.h (struct ThreadKeyAssoc): Remove lock; add prevKey + and prevThread pointers; re-implemented all routines that use this + struct. The effect of this is to save one handle per association, + which could potentially equal the number of keys multiplied by the + number of threads, accumulating over time - and to free the + association memory as soon as it is no longer referenced by either + the key or the thread. Previously, the handle and memory were + released only after BOTH key and thread no longer referenced the + association. That is, often no association resources were released + until the process itself exited. In addition, at least one race + condition has been removed - where two threads could attempt to + release the association resources simultaneously - one via + ptw32_callUserDestroyRoutines and the other via + pthread_key_delete. + - thanks to Richard Hughes at Aculab for discovering the problem. + * pthread_key_create.c: See above. + * pthread_key_delete.c: See above. + * pthread_setspecific.c: See above. + * ptw32_callUserDestroyRoutines.c: See above. + * ptw32_tkAssocCreate.c: See above. + * ptw32_tkAssocDestroy.c: See above. + +2005-04-27 Ross Johnson + + * sem_wait.c (ptw32_sem_wait_cleanup): after cancellation re-attempt + to acquire the semaphore to avoid a race with a late sem_post. + * sem_timedwait.c: Modify comments. + +2005-04-25 Ross Johnson + + * ptw32_relmillisecs.c: New module; converts future abstime to + milliseconds relative to 'now'. + * pthread_mutex_timedlock.c: Use new ptw32_relmillisecs routine in + place of internal code; remove the NEED_SEM code - this routine is now + implemented for builds that define NEED_SEM (WinCE etc) + * sem_timedwait.c: Likewise; after timeout or cancellation, + re-attempt to acquire the semaphore in case one has been posted since + the timeout/cancel occurred. Thanks to Stefan Mueller. + * Makefile: Add ptw32_relmillisecs.c module; remove + ptw32_{in,de}crease_semaphore.c modules. + * GNUmakefile: Likewise. + * Bmakefile: Likewise. + + * sem_init.c: Re-write the NEED_SEM code to be consistent with the + non-NEED_SEM code, but retaining use of an event in place of the w32 sema + for w32 systems that don't include semaphores (WinCE); + the NEED_SEM versions of semaphores has been broken for a long time but is + now fixed and supports all of the same routines as the non-NEED_SEM case. + * sem_destroy.c: Likewise. + * sem_wait.c: Likewise. + * sem_post.c: Likewise. + * sem_post_multple.c: Likewise. + * implement.h: Likewise. + * sem_timedwait.c: Likewise; this routine is now + implemented for builds that define NEED_SEM (WinCE etc). + * sem_trywait.c: Likewise. + * sem_getvalue.c: Likewise. + + * pthread_once.c: Yet more changes, reverting closer to Gottlob Frege's + first design, but retaining cancellation, priority boosting, and adding + preservation of W32 error codes to make pthread_once transparent to + GetLastError. + +2005-04-11 Ross Johnson + + * pthread_once.c (pthread_once): Added priority boosting to + solve starvation problem after once_routine cancellation. + See notes in file. + +2005-04-06 Kevin Lussier + + * Makefile: Added debug targets for all versions of the library. + +2005-04-01 Ross Johnson + + * GNUmakefile: Add target to build libpthreadGC1.a as a static link + library. + * Makefile: Likewise for pthreadGC1.lib. + +2005-04-01 Kevin Lussier + + * sem_timedwait.c (sem_timedwait): Increase size of temp variables to + avoid int overflows for large timeout values. + * implement.h (int64_t): Include or define. + +2005-03-31 Dimitar Panayotov ^M + + * pthread.h: Fix conditional defines for static linking. + * sched.h: Liekwise. + * semaphore.h: Likewise. + * dll.c (PTW32_STATIC_LIB): Module is conditionally included + in the build. + +2005-03-16 Ross Johnson ^M + + * pthread_setcancelstate.c: Undo the last change. + +2005-03-16 Ross Johnson ^M + + * pthread_setcancelstate.c: Don't check for an async cancel event + if the library is using alertable async cancel.. + +2005-03-14 Ross Johnson + + * pthread_once.c (pthread_once): Downgrade interlocked operations to simple + memory operations where these are protected by the critical section; edit + comments. + +2005-03-13 Ross Johnson + + * pthread_once.c (pthread_once): Completely redesigned; a change was + required to the ABI (pthread_once_t_), and resulting in a version + compatibility index increment. + + NOTES: + The design (based on pseudo code contributed by Gottlob Frege) avoids + creating a kernel object if there is no contention. See URL for details:- + http://sources.redhat.com/ml/pthreads-win32/2005/msg00029.html + This uses late initialisation similar to the technique already used for + pthreads-win32 mutexes and semaphores (from Alexander Terekhov). + + The subsequent cancelation cleanup additions (by rpj) could not be implemented + without sacrificing some of the efficiency in Gottlob's design. In particular, + although each once_control uses it's own event to block on, a global CS is + required to manage it - since the event must be either re-usable or + re-creatable under cancelation. This is not needed in the non-cancelable + design because it is able to mark the event as closed (forever). + + When uncontested, a CS operation is equivalent to an Interlocked operation + in speed. So, in the final design with cancelability, an uncontested + once_control operation involves a minimum of five interlocked operations + (including the LeaveCS operation). + + ALTERNATIVES: + An alternative design from Alexander Terekhov proposed using a named mutex, + as sketched below:- + + if (!once_control) { // May be in TLS + named_mutex::guard guard(&once_control2); + if (!once_control2) { + + once_control2 = true; + } + once_control = true; + } + + A more detailed description of this can be found here:- + http://groups.yahoo.com/group/boost/message/15442 + + [Although the definition of a suitable PTHREAD_ONCE_INIT precludes use of the + TLS located flag, this is not critical.] + + There are three primary concerns though:- + 1) The [named] mutex is 'created' even in the uncontended case. + 2) A system wide unique name must be generated. + 3) Win32 mutexes are VERY slow even in the uncontended case. An uncontested + Win32 mutex lock operation can be 50 (or more) times slower than an + uncontested EnterCS operation. + + Ultimately, the named mutex trick is making use of the global locks maintained + by the kernel. + + * pthread.h (pthread_once_t_): One flag and an event HANDLE added. + (PTHREAD_ONCE_INIT): Additional values included. + +2005-03-08 Ross Johnson + + * pthread_once.c (pthread_once): Redesigned to elliminate potential + starvation problem. + - reported by Gottlob Frege + + * ptw32_threadDestroy.c (ptw32_threadDestroy): Implicit threads were + not closing their Win32 thread duplicate handle. + - reported by Dmitrii Semii + +2005-01-25 Ralf Kubis + + * Attempted acquisition of recursive mutex was causing waiting + threads to not be woken when the mutex is released. + + * GNUmakefile (GCE): Generate correct version resource comments. + +2005-01-01 Konstantin Voronkov + + * pthread_mutex_lock.c (pthread_mutex_lock): The new atomic exchange + mutex algorithm is known to allow a thread to steal the lock off + FIFO waiting threads. The next waiting FIFO thread gets a spurious + wake-up and must attempt to re-acquire the lock. The woken thread + was setting itself as the mutex's owner before the re-acquisition. + +2004-11-22 Ross Johnson + + * pthread_cond_wait.c (ptw32_cond_wait_cleanup): Undo change + from 2004-11-02. + * Makefile (DLL_VER): Added for DLL naming suffix - see README. + * GNUmakefile (DLL_VER): Likewise. + * Wmakefile (DLL_VER): Likewise. + * Bmakefile (DLL_VER): Likewise. + * pthread.dsw (version.rc): Added to MSVS workspace. + +2004-11-20 Boudewijn Dekker + + * pthread_getspecific.c (pthread_getspecific): Check for + invalid (NULL) key argument. + +2004-11-19 Ross Johnson + + * config.h (PTW32_THREAD_ID_REUSE_INCREMENT): Added to allow + building the library for either unique thread IDs like Solaris + or non-unique thread IDs like Linux; allows application developers + to override the library's default insensitivity to some apps + that may not be strictly POSIX compliant. + * version.rc: New resource module to encode version information + within the DLL. + * pthread.h: Added PTW32_VERSION* defines and grouped sections + required by resource compiler together; bulk of file is skipped + if RC_INVOKED. Defined some error numbers and other names for + Borland compiler. + +2004-11-02 Ross Johnson + + * pthread_cond_wait.c (ptw32_cond_wait_cleanup): Lock CV mutex at + start of cleanup handler rather than at the end. + * implement.h (PTW32_THREAD_REUSE_EMPTY): Renamed from *_BOTTOM. + (ptw32_threadReuseBottom): New global variable. + * global.c (ptw32_threadReuseBottom): Declare new variable. + * ptw32_reuse.c (ptw32_reuse): Change reuse LIFO stack to LILO queue + to more evenly distribute use of reusable thread IDs; use renamed + PTW32_THREAD_REUSE_EMPTY. + * ptw32_processTerminate.c (ptw2_processTerminate): Use renamed + PTW32_THREAD_REUSE_EMPTY. + +2004-10-31 Ross Johnson + + * implement.h (PThreadState): Add new state value + 'PThreadStateCancelPending'. + * pthread_testcancel.c (pthread_testcancel): Use new thread + 'PThreadStateCancelPending' state as short cut to avoid entering + kernel space via WaitForSingleObject() call. This was obviated + by user space sema acquisition in sem_wait() and sem_timedwait(), + which are also cancelation points. A call to pthread_testcancel() + was required, which introduced a kernel call, effectively nullifying + any gains made by the user space sem acquisition checks. + * pthread_cancel.c (pthread_cancel): Set new thread + 'PThreadStateCancelPending' state. + +2004-10-29 Ross Johnson + + * implement.h (pthread_t): Renamed to ptw32_thread_t; struct contains + all thread state. + * pthread.h (ptw32_handle_t): New general purpose struct to serve + as a handle for various reusable object IDs - currently only used + by pthread_t; contains a pointer to ptw32_thread_t (thread state) + and a general purpose uint for use as a reuse counter or flags etc. + (pthread_t): typedef'ed to ptw32_handle_t; the uint is the reuse + counter that allows the library to maintain unique POSIX thread IDs. + When the pthread struct reuse stack was introduced, threads would + often acquire an identical ID to a previously destroyed thread. The + same was true for the pre-reuse stack library, by virtue of pthread_t + being the address of the thread struct. The new pthread_t retains + the reuse stack but provides virtually unique thread IDs. + * sem_wait.c (ptw32_sem_wait_cleanup): New routine used for + cancelation cleanup. + * sem_timedwait.c (ptw32_sem_timedwait_cleanup): Likewise. + +2004-10-22 Ross Johnson + + * sem_init.c (sem_init): Introduce a 'lock' element in order to + replace the interlocked operations with conventional serialisation. + This is needed in order to be able to atomically modify the sema + value and perform Win32 sema release operations. Win32 semaphores are + used instead of events in order to support efficient multiple posting. + If the whole modify/release isn't atomic, a race between + sem_timedwait() and sem_post() could result in a release when there is + no waiting semaphore, which would cause too many threads to proceed. + * sem_wait.c (sem_wait): Use new 'lock'element. + * sem_timedwait.c (sem_timedwait): Likewise. + * sem_trywait.c (sem_trywait): Likewise. + * sem_post.c (sem_post): Likewise. + * sem_post_multiple.c (sem_post_multiple): Likewise. + * sem_getvalue.c (sem_getvalue): Likewise. + * ptw32_semwait.c (ptw32_semwait): Likewise. + * sem_destroy.c (sem_destroy): Likewise; also tightened the conditions + for semaphore destruction; in particular, a semaphore will not be + destroyed if it has waiters. + * sem_timedwait.c (sem_timedwait): Added cancel cleanup handler to + restore sema value when cancelled. + * sem_wait.c (sem_wait): Likewise. + +2004-10-21 Ross Johnson + + * pthread_mutex_unlock.c (pthread_mutex_unlock): Must use PulseEvent() + rather than SetEvent() to reset the event if there are no waiters. + +2004-10-19 Ross Johnson + + * sem_init.c (sem_init): New semaphore model based on the same idea + as mutexes, i.e. user space interlocked check to avoid + unnecessarily entering kernel space. Wraps the Win32 semaphore and + keeps it's own counter. Although the motivation to do this has existed + for a long time, credit goes to Alexander Terekhov for providing + the logic. I have deviated slightly from AT's logic to add the waiters + count, which has made the code more complicated by adding cancelation + cleanup. This also appears to have broken the VCE (C++ EH) version of + the library (the same problem as previously reported - see BUGS #2), + only apparently not fixable using the usual workaround, nor by turning + all optimisation off. The GCE version works fine, so it is presumed to + be a bug in MSVC++ 6.0. The cancelation exception is thrown and caught + correctly, but the cleanup class destructor is never called. The failing + test is tests\semaphore4.c. + * sem_wait.c (sem_wait): Implemented user space check model. + * sem_post.c (sem_post): Likewise. + * sem_trywait.c (sem_trywait): Likewise. + * sem_timedwait.c (sem_timedwait): Likewise. + * sem_post_multiple.c (sem_post_multiple): Likewise. + * sem_getvalue.c (sem_getvalue): Likewise. + * ptw32_semwait.c (ptw32_semwait): Likewise. + * implement.h (sem_t_): Add counter element. + +2004-10-15 Ross Johnson + + * implement.h (pthread_mutex_t_): Use an event in place of + the POSIX semaphore. + * pthread_mutex_init.c: Create the event; remove semaphore init. + * pthread_mutex_destroy.c: Delete the event. + * pthread_mutex_lock.c: Replace the semaphore wait with the event wait. + * pthread_mutex_trylock.c: Likewise. + * pthread_mutex_timedlock.c: Likewise. + * pthread_mutex_unlock.c: Set the event. + +2004-10-14 Ross Johnson + + * pthread_mutex_lock.c (pthread_mutex_lock): New algorithm using + Terekhov's xchg based variation of Drepper's cmpxchg model. + Theoretically, xchg uses fewer clock cycles than cmpxchg (using IA-32 + as a reference), however, in my opinion bus locking dominates the + equation on smp systems, so the model with the least number of bus + lock operations in the execution path should win, which is Terekhov's + variant. On IA-32 uni-processor systems, it's faster to use the + CMPXCHG instruction without locking the bus than to use the XCHG + instruction, which always locks the bus. This makes the two variants + equal for the non-contended lock (fast lane) execution path on up + IA-32. Testing shows that the xchg variant is faster on up IA-32 as + well if the test forces higher lock contention frequency, even though + kernel calls should be dominating the times (on up IA-32, both + variants used CMPXCHG instructions and neither locked the bus). + * pthread_mutex_timedlock.c pthread_mutex_timedlock(): Similarly. + * pthread_mutex_trylock.c (pthread_mutex_trylock): Similarly. + * pthread_mutex_unlock.c (pthread_mutex_unlock): Similarly. + * ptw32_InterlockedCompareExchange.c (ptw32_InterlockExchange): New + function. + (PTW32_INTERLOCKED_EXCHANGE): Sets up macro to use inlined + ptw32_InterlockedExchange. + * implement.h (PTW32_INTERLOCKED_EXCHANGE): Set default to + InterlockedExchange(). + * Makefile: Building using /Ob2 so that asm sections within inline + functions are inlined. + +2004-10-08 Ross Johnson + + * pthread_mutex_destroy.c (pthread_mutex_destroy): Critical Section + element is no longer required. + * pthread_mutex_init.c (pthread_mutex_init): Likewise. + * pthread_mutex_lock.c (pthread_mutex_lock): New algorithm following + Drepper's paper at http://people.redhat.com/drepper/futex.pdf, but + using the existing semaphore in place of the futex described in the + paper. Idea suggested by Alexander Terekhov - see: + http://sources.redhat.com/ml/pthreads-win32/2003/msg00108.html + * pthread_mutex_timedlock.c pthread_mutex_timedlock(): Similarly. + * pthread_mutex_trylock.c (pthread_mutex_trylock): Similarly. + * pthread_mutex_unlock.c (pthread_mutex_unlock): Similarly. + * pthread_barrier_wait.c (pthread_barrier_wait): Use inlined version + of InterlockedCompareExchange() if possible - determined at + build-time. + * pthread_spin_destroy.c pthread_spin_destroy(): Likewise. + * pthread_spin_lock.c pthread_spin_lock():Likewise. + * pthread_spin_trylock.c (pthread_spin_trylock):Likewise. + * pthread_spin_unlock.c (pthread_spin_unlock):Likewise. + * ptw32_InterlockedCompareExchange.c: Sets up macro for inlined use. + * implement.h (pthread_mutex_t_): Remove Critical Section element. + (PTW32_INTERLOCKED_COMPARE_EXCHANGE): Set to default non-inlined + version of InterlockedCompareExchange(). + * private.c: Include ptw32_InterlockedCompareExchange.c first for + inlining. + * GNUmakefile: Add commandline option to use inlined + InterlockedCompareExchange(). + * Makefile: Likewise. + +2004-09-27 Ross Johnson + + * pthread_mutex_lock.c (pthread_mutex_lock): Separate + PTHREAD_MUTEX_NORMAL logic since we do not need to keep or check some + state required by other mutex types; do not check mutex pointer arg + for validity - leave this to the system since we are only checking + for NULL pointers. This should improve speed of NORMAL mutexes and + marginally improve speed of other type. + * pthread_mutex_trylock.c (pthread_mutex_trylock): Likewise. + * pthread_mutex_unlock.c (pthread_mutex_unlock): Likewise; also avoid + entering the critical section for the no-waiters case, with approx. + 30% reduction in lock/unlock overhead for this case. + * pthread_mutex_timedlock.c (pthread_mutex_timedlock): Likewise; also + no longer keeps mutex if post-timeout second attempt succeeds - this + will assist applications that wish to impose strict lock deadlines, + rather than simply to escape from frozen locks. + +2004-09-09 Tristan Savatier + * pthread.h (struct pthread_once_t_): Qualify the 'done' element + as 'volatile'. + * pthread_once.c: Concerned about possible race condition, + specifically on MPU systems re concurrent access to multibyte types. + [Maintainer's note: the race condition is harmless on SPU systems + and only a problem on MPU systems if concurrent access results in an + exception (presumably generated by a hardware interrupt). There are + other instances of similar harmless race conditions that have not + been identified as issues.] + +2004-09-09 Ross Johnson + + * pthread.h: Declare additional types as volatile. + +2004-08-27 Ross Johnson + + * pthread_barrier_wait.c (pthread_barrier_wait): Remove excessive code + by substituting the internal non-cancelable version of sem_wait + (ptw32_semwait). + +2004-08-25 Ross Johnson + + * pthread_join.c (pthread_join): Rewrite and re-order the conditional + tests in an attempt to improve efficiency and remove a race + condition. + +2004-08-23 Ross Johnson + + * create.c (pthread_create): Don't create a thread if the thread + id pointer location (first arg) is inaccessible. A memory + protection fault will result if the thread id arg isn't an accessible + location. This is consistent with GNU/Linux but different to + Solaris or MKS (and possibly others), which accept NULL as meaning + 'don't return the created thread's ID'. Applications that run + using pthreads-win32 will run on all other POSIX threads + implementations, at least w.r.t. this feature. + + It was decided not to copy the Solaris et al behaviour because, + although it would have simplified some application porting (but only + from Solaris to Windows), the feature is not technically necessary, + and the alternative segfault behaviour helps avoid buggy application + code. + +2004-07-01 Anuj Goyal + + * builddmc.bat: New; Windows bat file to build the library. + * config.h (__DMC__): Support for Digital Mars compiler. + * create.c (__DMC__): Likewise. + * pthread_exit.c (__DMC__): Likewise. + * pthread_join.c (__DMC__): Likewise. + * ptw32_threadDestroy.c (__DMC__): Likewise. + * ptw32_threadStart.c (__DMC__): Likewise. + * ptw32_throw.c (__DMC__): Likewise. + +2004-06-29 Anuj Goyal + + * pthread.h (__DMC__): Initial support for Digital Mars compiler. + +2004-06-29 Will Bryant + + * README.Borland: New; description of Borland changes. + * Bmakefile: New makefile for the Borland make utility. + * ptw32_InterlockedCompareExchange.c: + Add Borland compatible asm code. + +2004-06-26 Jason Bard + + * pthread.h (HAVE_STRUCT_TIMESPEC): If undefined, define it + to avoid timespec struct redefined errors elsewhere in an + application. + +2004-06-21 Ross Johnson + + * pthread.h (PTHREAD_RECURSIVE_MUTEX_INITIALIZER): Mutex + initialiser added for compatibility with Linux threads and + others; currently not included in SUSV3. + * pthread.h (PTHREAD_ERRORCHECK_MUTEX_INITIALIZER): Likewise. + * pthread.h (PTHREAD_RECURSIVE_MUTEX_INITIALIZER_NP): Likewise. + * pthread.h (PTHREAD_ERRORCHECK_MUTEX_INITIALIZER_NP): Likewise. + + * ptw32_mutex_check_need_init.c (ptw32_mutex_check_need_init): + Add new initialisers. + + * pthread_mutex_lock.c (pthread_mutex_lock): Check for new + initialisers. + * pthread_mutex_trylock.c (pthread_mutex_trylock): Likewise. + * pthread_mutex_timedlock.c (pthread_mutex_timedlock): Likewise. + * pthread_mutex_unlock.c (pthread_mutex_unlock): Likewise. + * pthread_mutex_destroy.c (pthread_mutex_destroy): Likewise. + +2004-05-20 Ross Johnson + + * README.NONPORTABLE: Document pthread_win32_test_features_np(). + * FAQ: Update various answers. + +2004-05-19 Ross Johnson + + * Makefile: Don't define _WIN32_WINNT on compiler command line. + * GNUmakefile: Likewise. + +2004-05-16 Ross Johnson + + * pthread_cancel.c (pthread_cancel): Adapted to use auto-detected + QueueUserAPCEx features at run-time. + (ptw32_RegisterCancelation): Drop in replacement for QueueUserAPCEx() + if it can't be used. Provides older style non-preemptive async + cancelation. + * pthread_win32_attach_detach_np.c (pthread_win32_attach_np): + Auto-detect quserex.dll and the availability of alertdrv.sys; + initialise and close on process attach/detach. + * global.c (ptw32_register_cancelation): Pointer to either + QueueUserAPCEx() or ptw32_RegisterCancelation() depending on + availability. QueueUserAPCEx makes pre-emptive async cancelation + possible. + * implement.h: Add definitions and prototypes related to QueueUserAPC. + +2004-05-16 Panagiotis E. Hadjidoukas + + * QueueUserAPCEx (separate contributed package): Provides preemptive + APC feature. + * pthread_cancel.c (pthread_cancel): Initial integration of + QueueUserAPCEx into pthreads-win32 to provide true pre-emptive + async cancelation of threads, including blocked threads. + +2004-05-06 Makoto Kato + + * pthread.h (DWORD_PTR): Define typedef for older MSVC. + * pthread_cancel.c (AMD64): Add architecture specific Context register. + * ptw32_getprocessors.c: Use correct types (DWORD_PTR) for mask + variables. + +2004-04-06 P. van Bruggen + + * ptw32_threadDestroy.c: Destroy threadLock mutex to + close a memory leak. + +2004-02-13 Gustav Hallberg + + * pthread_equal.c: Remove redundant equality logic. + +2003-12-10 Philippe Di Cristo + + * sem_timedwait.c (sem_timedwait): Fix timeout calculations. + +2003-10-20 Alexander Terekhov + + * pthread_mutex_timedlock.c (ptw32_semwait): Move to individual module. + * ptw32_semwait.c: New module. + * pthread_cond_wait.c (ptw32_cond_wait_cleanup): Replace cancelable + sem_wait() call with non-cancelable ptw32_semwait() call. + * pthread.c (private.c): Re-order for inlining. GNU C warned that + function ptw32_semwait() was defined 'inline' after it was called. + * pthread_cond_signal.c (ptw32_cond_unblock): Likewise. + * pthread_delay_np.c: Disable Watcom warning with comment. + * *.c (process.h): Remove include from .c files. This is conditionally + included by the common project include files. + +2003-10-20 James Ewing + + * ptw32_getprocessors.c: Some Win32 environments don't have + GetProcessAffinityMask(), so always return CPU count = 1 for them. + * config.h (NEED_PROCESSOR_AFFINITY_MASK): Define for WinCE. + +2003-10-15 Ross Johnson + + * Re-indented all .c files using default GNU style to remove assorted + editor ugliness (used GNU indent utility in default style). + +2003-10-15 Alex Blanco + + * sem_init.c (sem_init): Would call CreateSemaphore even if the sema + struct calloc failed; was not freeing calloced memory if either + CreateSemaphore or CreateEvent failed. + +2003-10-14 Ross Johnson + + * pthread.h: Add Watcom compiler compatibility. Esssentially just add + the cdecl attribute to all exposed function prototypes so that Watcom + generates function call code compatible with non-Watcom built libraries. + By default, Watcom uses registers to pass function args if possible rather + than pushing to stack. + * semaphore.h: Likewise. + * sched.h: Likewise. + * pthread_cond_wait.c (ptw32_cond_wait_cleanup): Define with cdecl attribute + for Watcom compatibility. This routine is called via pthread_cleanup_push so + it had to match function arg definition. + * Wmakefile: New makefile for Watcom builds. + +2003-09-14 Ross Johnson + + * pthread_setschedparam.c (pthread_setschedparam): Attempt to map + all priority levels between max and min (as returned by + sched_get_priority_min/max) to reasonable Win32 priority levels - i.e. + levels between THREAD_PRIORITY_LOWEST/IDLE to THREAD_PRIORITY_LOWEST and + between THREAD_PRIORITY_HIGHEST/TIME_CRITICAL to THREAD_PRIORITY_HIGHEST + while others remain unchanged; record specified thread priority level + for return by pthread_getschedparam. + + Note that, previously, specified levels not matching Win32 priority levels + would silently leave the current thread priority unaltered. + + * pthread_getschedparam.c (pthread_getschedparam): Return the priority + level specified by the latest pthread_setschedparam or pthread_create rather + than the actual running thread priority as returned by GetThreadPriority - as + required by POSIX. I.e. temporary or adjusted actual priority levels are not + returned by this routine. + + * pthread_create.c (pthread_create): For priority levels specified via + pthread attributes, attempt to map all priority levels between max and + min (as returned by sched_get_priority_min/max) to reasonable Win32 + priority levels; record priority level given via attributes, or + inherited from parent thread, for later return by pthread_getschedparam. + + * ptw32_new.c (ptw32_new): Initialise pthread_t_ sched_priority element. + + * pthread_self.c (pthread_self): Set newly created implicit POSIX thread + sched_priority to Win32 thread's current actual priority. Temporarily + altered priorities can't be avoided in this case. + + * implement.h (struct pthread_t_): Add new sched_priority element. + +2003-09-12 Ross Johnson + + * sched_get_priority_min.c (sched_get_priority_min): On error should return -1 + with errno set. + * sched_get_priority_max.c (sched_get_priority_max): Likewise. + +2003-09-03 Ross Johnson + + * w32_cancelableWait.c (ptw32_cancelable_wait): Allow cancelation + of implicit POSIX threads as well. + +2003-09-02 Ross Johnson + + * pthread_win32_attach_detach_np.c (pthread_win32_thread_detach_np): + Add comment. + + * pthread_exit.c (pthread_exit): Fix to recycle the POSIX thread handle in + addition to calling user TSD destructors. Move the implicit POSIX thread exit + handling to ptw32_throw to centralise the logic. + + * ptw32_throw.c (ptw32_throw): Implicit POSIX threads have no point + to jump or throw to, so cleanup and exit the thread here in this case. For + processes using the C runtime, the exit code will be set to the POSIX + reason for the throw (i.e. PTHREAD_CANCEL or the value given to pthread_exit). + Note that pthread_exit() already had similar logic, which has been moved to + here. + + * ptw32_threadDestroy.c (ptw32_threadDestroy): Don't close the Win32 handle + of implicit POSIX threads - expect this to be done by Win32? + +2003-09-01 Ross Johnson + + * pthread_self.c (pthread_self): The newly aquired pthread_t must be + assigned to the reuse stack, not freed, if the routine fails somehow. + +2003-08-13 Ross Johnson + + * pthread_getschedparam.c (pthread_getschedparam): An invalid thread ID + parameter was returning an incorrect error value; now uses a more exhaustive + check for validity. + + * pthread_setschedparam.c (pthread_setschedparam): Likewise. + + * pthread_join.c (pthread_join): Now uses a more exhaustive + check for validity. + + * pthread_detach.c (pthread_detach): Likewise. + + * pthread_cancel.c (pthread_cancel): Likewise. + + * ptw32_threadDestroy.c (ptw32_threadDestroy): pthread_t structs are + never freed - push them onto a stack for reuse. + + * ptw32_new.c (ptw32_new): Check for reusable pthread_t before dynamically + allocating new memory for the struct. + + * pthread_kill.c (pthread_kill): New file; new routine; takes only a zero + signal arg so that applications can check the thread arg for validity; checks + that the underlying Win32 thread HANDLE is valid. + + * pthread.h (pthread_kill): Add prototype. + + * ptw32_reuse.c (ptw32_threadReusePop): New file; new routine; pop a + pthread_t off the reuse stack. pthread_t_ structs that have been destroyed, i.e. + have exited detached or have been joined, are cleaned up and put onto a reuse + stack. Consequently, thread IDs are no longer freed once calloced. The library + will attempt to get a struct off this stack before asking the system to alloc + new memory when creating threads. The stack is guarded by a global mutex. + (ptw32_threadReusePush): New routine; push a pthread_t onto the reuse stack. + + * implement.h (ptw32_threadReusePush): Add new prototype. + (ptw32_threadReusePop): Likewise. + (pthread_t): Add new element. + + * ptw32_processTerminate.c (ptw32_processTerminate): Delete the thread + reuse lock; free all thread ID structs on the thread reuse stack. + + * ptw32_processInitialize.c (ptw32_processInitialize): Initialise the + thread reuse lock. + +2003-07-19 Ross Johnson + + * GNUmakefile: modified to work under MsysDTK environment. + * pthread_spin_lock.c (pthread_spin_lock): Check for NULL arg. + * pthread_spin_unlock.c (pthread_spin_unlock): Likewise. + * pthread_spin_trylock.c (pthread_spin_trylock): Likewise; + fix incorrect pointer value if lock is dynamically initialised by + this function. + * sem_init.c (sem_init): Initialise sem_t value to quell compiler warning. + * sem_destroy.c (sem_destroy): Likewise. + * ptw32_threadStart.c (non-MSVC code sections): Include rather + than old-style ; fix all std:: namespace entities such as + std::terminate_handler instances and associated methods. + * ptw32_callUserDestroyRoutines.c (non-MSVC code sections): Likewise. + +2003-06-24 Piet van Bruggen + + * pthread_spin_destroy.c (pthread_spin_destroy): Was not freeing the + spinlock struct. + +2003-06-22 Nicolas Barry + + * pthread_mutex_destroy.c (pthread_mutex_destroy): When called + with a recursive mutex that was locked by the current thread, the + function was failing with a success return code. + +2003-05-15 Steven Reddie + + * pthread_win32_attach_detach_np.c (pthread_win32_process_detach_np): + NULLify ptw32_selfThreadKey after the thread is destroyed, otherwise + destructors calling pthreads routines might resurrect it again, creating + memory leaks. Call the underlying Win32 Tls routine directly rather than + pthread_setspecific(). + (pthread_win32_thread_detach_np): Likewise. + +2003-05-14 Viv + + * pthread.dsp: Change /MT compile flag to /MD. + +2003-03-04 Alexander Terekhov + + * pthread_mutex_timedlock.c (pthread_mutex_timedlock): Fix failure to + set ownership of mutex on second grab after abstime timeout. + - bug reported by Robert Strycek + +2002-12-17 Thomas Pfaff + + * pthread_mutex_lock.c (ptw32_semwait): New static routine to provide + a non-cancelable sem_wait() function. This is consistent with the + way that pthread_mutex_timedlock.c does it. + (pthread_mutex_lock): Use ptw32_semwait() instead of sem_wait(). + +2002-12-11 Thomas Pfaff + + * pthread_mutex_trylock.c: Should return EBUSY rather than EDEADLK. + * pthread_mutex_destroy.c: Remove redundant ownership test (the + trylock call does this for us); do not destroy a recursively locked + mutex. + +2002-09-20 Michael Johnson + + * pthread_cond_destroy.c (pthread_cond_destroy): + When two different threads exist, and one is attempting to + destroy a condition variable while the other is attempting to + initialize a condition variable that was created with + PTHREAD_COND_INITIALIZER, a deadlock can occur. Shrink + the ptw32_cond_list_lock critical section to fix it. + +2002-07-31 Ross Johnson + + * ptw32_threadStart.c (ptw32_threadStart): Thread cancelLock + destruction moved to ptw32_threadDestroy(). + + * ptw32_threadDestroy.c (ptw32_threadDestroy): Destroy + the thread's cancelLock. Moved here from ptw32_threadStart.c + to cleanup implicit threads as well. + +2002-07-30 Alexander Terekhov + + * pthread_cond_wait.c (ptw32_cond_wait_cleanup): + Remove code designed to avoid/prevent spurious wakeup + problems. It is believed that the sem_timedwait() call + is consuming a CV signal that it shouldn't and this is + breaking the avoidance logic. + +2002-07-30 Ross Johnson + + * sem_timedwait.c (sem_timedwait): Tighten checks for + unreasonable abstime values - that would result in + unexpected timeout values. + + * w32_CancelableWait.c (ptw32_cancelable_wait): + Tighten up return value checking and add comments. + + +2002-06-08 Ross Johnson + + * sem_getvalue.c (sem_getvalue): Now returns a value for the + NEED_SEM version (i.e. earlier versions of WinCE). + + +2002-06-04 Rob Fanner + + * sem_getvalue.c (sem_getvalue): The Johnson M. Hart + approach didn't work - we are forced to take an + intrusive approach. We try to decrement the sema + and then immediately release it again to get the + value. There is a small probability that this may + block other threads, but only momentarily. + +2002-06-03 Ross Johnson + + * sem_init.c (sem_init): Initialise Win32 semaphores + to _POSIX_SEM_VALUE_MAX (which this implementation + defines in pthread.h) so that sem_getvalue() can use + the trick described in the comments in sem_getvalue(). + * pthread.h (_POSIX_SEM_VALUE_MAX): Defined. + (_POSIX_SEM_NSEMS_MAX): Defined - not used but may be + useful for source code portability. + +2002-06-03 Rob Fanner + + * sem_getvalue.c (sem_getvalue): Did not work on NT. + Use approach suggested by Johnson M. Hart in his book + "Win32 System Programming". + +2002-02-28 Ross Johnson + + * errno.c: Compiler directive was incorrectly including code. + * pthread.h: Conditionally added some #defines from config.h + needed when not building the library. e.g. NEED_ERRNO, NEED_SEM. + (PTW32_DLLPORT): Now only defined if _DLL defined. + (_errno): Compiler directive was incorrectly including prototype. + * sched.h: Conditionally added some #defines from config.h + needed when not building the library. + * semaphore.h: Replace an instance of NEED_SEM that should + have been NEED_ERRNO. This change currently has nil effect. + + * GNUmakefile: Correct some recent changes. + + * Makefile: Add rule to generate pre-processor output. + +2002-02-23 Ross Johnson + + * pthread_rwlock_timedrdlock.c: New - untested. + * pthread_rwlock_timedwrlock.c: New - untested. + + * Testsuite passed (except known MSVC++ problems) + + * pthread_cond_destroy.c: Expand the time change + critical section to solve deadlock problem. + + * pthread.c: Add all remaining C modules. + * pthread.h: Use dllexport/dllimport attributes on functions + to avoid using pthread.def. + * sched.h: Likewise. + * semaphore.h: Likewise. + * GNUmakefile: Add new targets for single translation + unit build to maximise inlining potential; generate + pthread.def automatically. + * Makefile: Likewise, but no longer uses pthread.def. + +2002-02-20 Ross Johnson + + * pthread_cond_destroy.c (pthread_cond_destroy): + Enter the time change critical section earlier. + +2002-02-17 Ross Johnson + + * nonportable.c (pthread_delay_np): Make a true + cancelation point. Deferred cancels will interrupt the + wait. + +2002-02-07 Ross Johnson + + Reduced name space pollution. + ----------------------------- + When the appropriate symbols are defined, the headers + will restrict the definitions of new names. In particular, + it must be possible to NOT include the + header and related definitions with some combination + of symbol definitions. Secondly, it should be possible + that additional definitions should be limited to POSIX + compliant symbols by the definition of appropriate symbols. + + * pthread.h: POSIX conditionals. + * sched.h: POSIX conditionals. + * semaphore.h: POSIX conditionals. + + * semaphore.c: Included . + (sem_init): Changed magic 0x7FFFFFFFL to INT_MAX. + (sem_getvalue): Trial version. + + Reduce executable size. + ----------------------- + When linking with the static library, only those + routines actually called, either directly or indirectly + should be included. + + [Gcc has the -ffunction-segments option to do this but MSVC + doesn't have this feature as far as I can determine. Other + compilers are undetermined as well. - rpj] + + * semaphore.c: All routines are now in separate compilation units; + This file is used to congregate the separate modules for + potential inline optimisation and backward build compatibility. + * sem_close.c: Separated routine from semaphore.c. + * ptw32_decrease_semaphore.c: Likewise. + * sem_destroy.c: Likewise. + * sem_getvalue.c: Likewise. + * ptw32_increase_semaphore.c: Likewise. + * sem_init.c: Likewise. + * sem_open.c: Likewise. + * sem_post.c: Likewise. + * sem_post_multiple.c: Likewise. + * sem_timedwait.c: Likewise. + * sem_trywait.c: Likewise. + * sem_unlink.c: Likewise. + * sem_wait.c: Likewise. + +2002-02-04 Ross Johnson + + The following extends the idea above to the rest of pthreads-win32 - rpj + + * attr.c: All routines are now in separate compilation units; + This file is used to congregate the separate modules for + potential inline optimisation and backward build compatibility. + * pthread_attr_destroy.c: Separated routine from attr.c. + * pthread_attr_getdetachstate.c: Likewise. + * pthread_attr_getscope.c: Likewise. + * pthread_attr_getstackaddr.c: Likewise. + * pthread_attr_getstacksize.c: Likewise. + * pthread_attr_init.c: Likewise. + * pthread_attr_is_attr.c: Likewise. + * pthread_attr_setdetachstate.c: Likewise. + * pthread_attr_setscope.c: Likewise. + * pthread_attr_setstackaddr.c: Likewise. + * pthread_attr_setstacksize.c: Likewise. + + * pthread.c: Agregation of agregate modules for super-inlineability. + +2002-02-02 Ross Johnson + + * cancel.c: Rearranged some code and introduced checks + to disable cancelation at the start of a thread's cancelation + run to prevent double cancelation. The main problem + arises if a thread is canceling and then receives a subsequent + async cancel request. + * private.c: Likewise. + * condvar.c: Place pragmas around cleanup_push/pop to turn + off inline optimisation (/Obn where n>0 - MSVC only). Various + optimisation switches in MSVC turn this on, which interferes with + the way that cleanup handlers are run in C++ EH and SEH + code. Application code compiled with inline optimisation must + also wrap cleanup_push/pop blocks with the pragmas, e.g. + #pragma inline_depth(0) + pthread_cleanup_push(...) + ... + pthread_cleanup_pop(...) + #pragma inline_depth(8) + * rwlock.c: Likewise. + * mutex.c: Remove attempts to inline some functions. + * signal.c: Modify misleading comment. + +2002-02-01 Ross Johnson + + * semaphore.c (sem_trywait): Fix missing errno return + for systems that define NEED_SEM (e.g. early WinCE). + * mutex.c (pthread_mutex_timedlock): Return ENOTSUP + for systems that define NEED_SEM since they don't + have sem_trywait(). + +2002-01-27 Ross Johnson + + * mutex.c (pthread_mutex_timedlock): New function suggested by + Alexander Terekhov. The logic required to implement this + properly came from Alexander, with some collaboration + with Thomas Pfaff. + (pthread_mutex_unlock): Wrap the waiters check and sema + post in a critical section to prevent a race with + pthread_mutex_timedlock. + (ptw32_timed_semwait): New function; + returns a special result if the absolute timeout parameter + represents a time already passed when called; used by + pthread_mutex_timedwait(). Have deliberately not reused + the name "ptw32_sem_timedwait" because they are not the same + routine. + * condvar.c (ptw32_cond_timedwait): Use the new sem_timedwait() + instead of ptw32_sem_timedwait(), which now has a different + function. See previous. + * implement.h: Remove prototype for ptw32_sem_timedwait. + See next. + (pthread_mutex_t_): Add critical section element for access + to lock_idx during mutex post-timeout processing. + * semaphore.h (sem_timedwait): See next. + * semaphore.c (sem_timedwait): See next. + * private.c (ptw32_sem_timedwait): Move to semaphore.c + and rename as sem_timedwait(). + +2002-01-18 Ross Johnson + + * sync.c (pthread_join): Was getting the exit code from the + calling thread rather than the joined thread if + defined(__MINGW32__) && !defined(__MSVCRT__). + +2002-01-15 Ross Johnson + + * pthread.h: Unless the build explicitly defines __CLEANUP_SEH, + __CLEANUP_CXX, or __CLEANUP_C, then the build defaults to + __CLEANUP_C style cleanup. This style uses setjmp/longjmp + in the cancelation and thread exit implementations and therefore + won't do stack unwinding if linked to applications that have it + (e.g. C++ apps). This is currently consistent with most/all + commercial Unix POSIX threads implementations. + + * spin.c (pthread_spin_init): Edit renamed function call. + * nonportable.c (pthread_num_processors_np): New. + (pthread_getprocessors_np): Renamed to ptw32_getprocessors + and moved to private.c. + * private.c (pthread_getprocessors): Moved here from + nonportable.c. + * pthread.def (pthread_getprocessors_np): Removed + from export list. + + * rwlock.c (pthread_rwlockattr_init): New. + (pthread_rwlockattr_destroy): New. + (pthread_rwlockattr_getpshared): New. + (pthread_rwlockattr_setpshared): New. + +2002-01-14 Ross Johnson + + * attr.c (pthread_attr_setscope): Fix struct pointer + indirection error introduced 2002-01-04. + (pthread_attr_getscope): Likewise. + +2002-01-12 Ross Johnson + + * pthread.dsp (SOURCE): Add missing source files. + +2002-01-08 Ross Johnson + + * mutex.c (pthread_mutex_trylock): use + ptw32_interlocked_compare_exchange function pointer + rather than ptw32_InterlockedCompareExchange() directly + to retain portability to non-iX86 processors, + e.g. WinCE etc. The pointer will point to the native + OS version of InterlockedCompareExchange() if the + OS supports it (see ChangeLog entry of 2001-10-17). + +2002-01-07 Thomas Pfaff , Alexander Terekhov + + * mutex.c (pthread_mutex_init): Remove critical + section calls. + (pthread_mutex_destroy): Likewise. + (pthread_mutex_unlock): Likewise. + (pthread_mutex_trylock): Likewise; uses + ptw32_InterlockedCompareExchange() to avoid need for + critical section; library is no longer i386 compatible; + recursive mutexes now increment the lock count rather + than return EBUSY; errorcheck mutexes return EDEADLCK + rather than EBUSY. This behaviour is consistent with the + Solaris pthreads implementation. + * implement.h (pthread_mutex_t_): Remove critical + section element - no longer needed. + + +2002-01-04 Ross Johnson + + * attr.c (pthread_attr_setscope): Add more error + checking and actually store the scope value even + though it's not really necessary. + (pthread_attr_getscope): Return stored value. + * implement.h (pthread_attr_t_): Add new scope element. + * ANNOUNCE: Fix out of date comment next to + pthread_attr_setscope in conformance section. + +2001-12-21 Alexander Terekhov + + * mutex.c (pthread_mutex_lock): Decrementing lock_idx was + not thread-safe. + (pthread_mutex_trylock): Likewise. + +2001-10-26 prionx@juno.com + + * semaphore.c (sem_init): Fix typo and missing bracket + in conditionally compiled code. Only older versions of + WinCE require this code, hence it doesn't normally get + tested; somehow when sem_t reverted to an opaque struct + the calloc NULL check was left in the conditionally included + section. + (sem_destroy): Likewise, the calloced sem_t wasn't being freed. + +2001-10-25 Ross Johnson + + * GNUmakefile (libwsock32): Add to linker flags for + WSAGetLastError() and WSASetLastError(). + * Makefile (wsock32.lib): Likewise. + * create.c: Minor mostly inert changes. + * implement.h (PTW32_MAX): Move into here and renamed + from sched.h. + (PTW32_MIN): Likewise. + * GNUmakefile (TEST_ICE): Define if testing internal + implementation of InterlockedCompareExchange. + * Makefile (TEST_ICE): Likewise. + * private.c (TEST_ICE): Likewise. + +2001-10-24 Ross Johnson + + * attr.c (pthread_attr_setstacksize): Quell warning + from LCC by conditionally compiling the stacksize + validity check. LCC correctly warns that the condition + (stacksize < PTHREAD_STACK_MIN) is suspicious + because STACK_MIN is 0 and stacksize is of type + size_t (or unsigned int). + +2001-10-17 Ross Johnson + + * barrier.c: Move _LONG and _LPLONG defines into + implement.h; rename to PTW32_INTERLOCKED_LONG and + PTW32_INTERLOCKED_LPLONG respectively. + * spin.c: Likewise; ptw32_interlocked_compare_exchange used + in place of InterlockedCompareExchange directly. + * global.c (ptw32_interlocked_compare_exchange): Add + prototype for this new routine pointer to be used when + InterlockedCompareExchange isn't supported by Windows. + * nonportable.c (pthread_win32_process_attach_np): Check for + support of InterlockedCompareExchange in kernel32 and assign its + address to ptw32_interlocked_compare_exchange if it exists, or + our own ix86 specific implementation ptw32_InterlockedCompareExchange. + *private.c (ptw32_InterlockedCompareExchange): An + implementation of InterlockedCompareExchange() which is + specific to ix86; written directly in assembler for either + MSVC or GNU C; needed because Windows 95 doesn't support + InterlockedCompareExchange(). + + * sched.c (sched_get_priority_min): Extend to return + THREAD_PRIORITY_IDLE. + (sched_get_priority_max): Extend to return + THREAD_PRIORITY_CRITICAL. + +2001-10-15 Ross Johnson + + * spin.c (pthread_spin_lock): PTHREAD_SPINLOCK_INITIALIZER + was causing a program fault. + (pthread_spin_init): Could have alloced memory + without freeing under some error conditions. + + * mutex.c (pthread_mutex_init): Move memory + allocation of mutex struct after checking for + PROCESS_SHARED. + +2001-10-12 Ross Johnson + + * spin.c (pthread_spin_unlock): Was not returning + EPERM if the spinlock was not locked, for multi CPU + machines. + +2001-10-08 Ross Johnson + + * spin.c (pthread_spin_trylock): Was not returning + EBUSY for multi CPU machines. + +2001-08-24 Ross Johnson + + * condvar.c (pthread_cond_destroy): Remove cv element + that is no longer used. + * implement.h: Likewise. + +2001-08-23 Alexander Terekhov + + * condvar.c (pthread_cond_destroy): fix bug with + respect to deadlock in the case of concurrent + _destroy/_unblock; a condition variable can be destroyed + immediately after all the threads that are blocked on + it are awakened. + +2001-08-23 Phil Frisbie, Jr. + + * tsd.c (pthread_getspecific): Preserve the last + winsock error [from WSAGetLastError()]. + +2001-07-18 Scott McCaskill + + * mutex.c (pthread_mutexattr_init): Return ENOMEM + immediately and don't dereference the NULL pointer + if calloc fails. + (pthread_mutexattr_getpshared): Don't dereference + a pointer that is possibly NULL. + * barrier.c (pthread_barrierattr_init): Likewise + (pthread_barrierattr_getpshared): Don't dereference + a pointer that is possibly NULL. + * condvar.c (pthread_condattr_getpshared): Don't dereference + a pointer that is possibly NULL. + +2001-07-15 Ross Johnson + + * rwlock.c (pthread_rwlock_wrlock): Is allowed to be + a cancelation point; re-enable deferred cancelability + around the CV call. + +2001-07-10 Ross Johnson + + * barrier.c: Still more revamping. The exclusive access + mutex isn't really needed so it has been removed and replaced + by an InterlockedDecrement(). nSerial has been removed. + iStep is now dual-purpose. The process shared attribute + is now stored in the barrier struct. + * implement.h (pthread_barrier_t_): Lost some/gained one + elements. + * private.c (ptw32_threadStart): Removed some comments. + +2001-07-10 Ross Johnson + + * barrier.c: Revamped to fix the race condition. Two alternating + semaphores are used instead of the PulseEvent. Also improved + overall throughput by returning PTHREAD_BARRIER_SERIAL_THREAD + to the first waking thread. + * implement.h (pthread_barrier_t_): Revamped. + +2001-07-09 Ross Johnson + + * barrier.c: Fix several bugs in all routines. Now passes + tests/barrier5.c which is fairly rigorous. There is still + a non-optimal work-around for a race condition between + the barrier breeched event signal and event wait. Basically + the last (signalling) thread to hit the barrier yields + to allow any other threads, which may have lost the race, + to complete. + +2001-07-07 Ross Johnson + + * barrier.c: Changed synchronisation mechanism to a + Win32 manual reset Event and use PulseEvent to signal + waiting threads. If the implementation continued to use + a semaphore it would require a second semaphore and + some management to use them alternately as barriers. A + single semaphore allows threads to cascade from one barrier + through the next, leaving some threads blocked at the first. + * implement.h (pthread_barrier_t_): As per above. + * general: Made a number of other routines inlinable. + +2001-07-07 Ross Johnson + + * spin.c: Revamped and working; included static initialiser. + Now beta level. + * barrier.c: Likewise. + * condvar.c: Macro constant change; inline auto init routine. + * mutex.c: Likewise. + * rwlock.c: Likewise. + * private.c: Add support for spinlock initialiser. + * global.c: Likewise. + * implement.h: Likewise. + * pthread.h (PTHREAD_SPINLOCK_INITIALIZER): Fix typo. + +2001-07-05 Ross Johnson + + * barrier.c: Remove static initialisation - irrelevent + for this object. + * pthread.h (PTHREAD_BARRIER_INITIALIZER): Removed. + * rwlock.c (pthread_rwlock_wrlock): This routine is + not a cancelation point - disable deferred + cancelation around call to pthread_cond_wait(). + +2001-07-05 Ross Johnson + + * spin.c: New module implementing spin locks. + * barrier.c: New module implementing barriers. + * pthread.h (_POSIX_SPIN_LOCKS): defined. + (_POSIX_BARRIERS): Defined. + (pthread_spin_*): Defined. + (pthread_barrier*): Defined. + (PTHREAD_BARRIER_SERIAL_THREAD): Defined. + * implement.h (pthread_spinlock_t_): Defined. + (pthread_barrier_t_): Defined. + (pthread_barrierattr_t_): Defined. + + * mutex.c (pthread_mutex_lock): Return with the error + if an auto-initialiser initialisation fails. + + * nonportable.c (pthread_getprocessors_np): New; gets the + number of available processors for the current process. + +2001-07-03 Ross Johnson + + * pthread.h (_POSIX_READER_WRITER_LOCKS): Define it + if not already defined. + +2001-07-01 Alexander Terekhov + + * condvar.c: Fixed lost signal bug reported by Timur Aydin + (taydin@snet.net). + [RPJ (me) didn't translate the original algorithm + correctly.] + * semaphore.c: Added sem_post_multiple; this is a useful + routine, but it doesn't appear to be standard. For now it's + not an exported function. + +2001-06-25 Ross Johnson + + * create.c (pthread_create): Add priority inheritance + attributes. + * mutex.c (pthread_mutex_lock): Remove some overhead for + PTHREAD_MUTEX_NORMAL mutex types. Specifically, avoid + calling pthread_self() and pthread_equal() to check/set + the mutex owner. Introduce a new pseudo owner for this + type. Test results suggest increases in speed of up to + 90% for non-blocking locks. + This is the default type of mutex used internally by other + synchronising objects, ie. condition variables and + read-write locks. The test rwlock7.c shows about a + 30-35% speed increase over snapshot 2001-06-06. The + price of this is that the application developer + must ensure correct behaviour, or explicitly set the + mutex to a safer type such as PTHREAD_MUTEX_ERRORCHECK. + For example, PTHREAD_MUTEX_NORMAL (or PTHREAD_MUTEX_DEFAULT) + type mutexes will not return an error if a thread which is not + the owner calls pthread_mutex_unlock. The call will succeed + in unlocking the mutex if it is currently locked, but a + subsequent unlock by the true owner will then fail with EPERM. + This is however consistent with some other implementations. + (pthread_mutex_unlock): Likewise. + (pthread_mutex_trylock): Likewise. + (pthread_mutex_destroy): Likewise. + * attr.c (pthread_attr_init): PTHREAD_EXPLICIT_SCHED is the + default inheritance attribute; THREAD_PRIORITY_NORMAL is + the default priority for new threads. + * sched.c (pthread_attr_setschedpolicy): Added routine. + (pthread_attr_getschedpolicy): Added routine. + (pthread_attr_setinheritsched): Added routine. + (pthread_attr_getinheritsched): Added routine. + * pthread.h (sched_rr_set_interval): Added as a macro; + returns -1 with errno set to ENOSYS. + +2001-06-23 Ross Johnson + + *sched.c (pthread_attr_setschedparam): Add priority range + check. + (sched_setscheduler): New function; checks for a valid + pid and policy; checks for permission to set information + in the target process; expects pid to be a Win32 process ID, + not a process handle; the only scheduler policy allowed is + SCHED_OTHER. + (sched_getscheduler): Likewise, but checks for permission + to query. + * pthread.h (SCHED_*): Moved to sched.h as defined in the + POSIX standard. + * sched.h (SCHED_*): Moved from pthread.h. + (pid_t): Defined if necessary. + (sched_setscheduler): Defined. + (sched_getscheduler): Defined. + * pthread.def (sched_setscheduler): Exported. + (sched_getscheduler): Likewise. + +2001-06-23 Ralf Brese + + * create.c (pthread_create): Set thread priority from + thread attributes. + +2001-06-18 Ross Johnson + + * Made organisational-only changes to UWIN additions. + * dll.c (dllMain): Moved UWIN process attach code + to pthread_win32_process_attach_np(); moved + instance of pthread_count to global.c. + * global.c (pthread_count): Moved from dll.c. + * nonportable.c (pthread_win32_process_attach_np): + Moved _UWIN code to here from dll.c. + * implement.h (pthread_count): Define extern int. + * create.c (pthread_count): Remove extern int. + * private.c (pthread_count): Likewise. + * exit.c (pthread_count): Likewise. + +2001-06-18 David Korn + + * dll.c: Added changes necessary to work with UWIN. + * create.c: Likewise. + * pthread.h: Likewise. + * misc.c: Likewise. + * exit.c: Likewise. + * private.c: Likewise. + * implement.h: Likewise. + There is some room at the start of struct pthread_t_ + to implement the signal semantics in UWIN's posix.dll + although this is not yet complete. + * Nmakefile: Compatible with UWIN's Nmake utility. + * Nmakefile.tests: Likewise - for running the tests. + +2001-06-08 Ross Johnson + + * semaphore.h (sem_t): Fixed for compile and test. + * implement.h (sem_t_): Likewise. + * semaphore.c: Likewise. + * private.c (ptw32_sem_timedwait): Updated to use new + opaque sem_t. + +2001-06-06 Ross Johnson + + * semaphore.h (sem_t): Is now an opaque pointer; + moved actual definition to implement.h. + * implement.h (sem_t_): Move here from semaphore.h; + was the definition of sem_t. + * semaphore.c: Wherever necessary, changed use of sem + from that of a pointer to a pointer-pointer; added + extra checks for a valid sem_t; NULL sem_t when + it is destroyed; added extra checks when creating + and destroying sem_t elements in the NEED_SEM + code branches; changed from using a pthread_mutex_t + ((*sem)->mutex) to CRITICAL_SECTION ((*sem)->sem_lock_cs) + in NEED_SEM branches for access serialisation. + +2001-06-06 Ross Johnson + + * mutex.c (pthread_mutexattr_init): Remove + ptw32_mutex_default_kind. + +2001-06-05 Ross Johnson + + * nonportable.c (pthread_mutex_setdefaultkind_np): + Remove - should not have been included in the first place. + (pthread_mutex_getdefaultkind_np): Likewise. + * global.c (ptw32_mutex_default_kind): Likewise. + * mutex.c (pthread_mutex_init): Remove use of + ptw32_mutex_default_kind. + * pthread.h (pthread_mutex_setdefaultkind_np): Likewise. + (pthread_mutex_getdefaultkind_np): Likewise. + * pthread.def (pthread_mutexattr_setkind_np): Added. + (pthread_mutexattr_getkind_np): Likewise. + + * README: Many changes that should have gone in before + the last snapshot. + * README.NONPORTABLE: New - referred to by ANNOUNCE + but never created; documents the non-portable routines + included in the library - moved from README with new + routines added. + * ANNOUNCE (pthread_mutexattr_setkind_np): Added to + compliance list. + (pthread_mutexattr_getkind_np): Likewise. + +2001-06-04 Ross Johnson + + * condvar.c: Add original description of the algorithm as + developed by Terekhov and Thomas, plus reference to + README.CV. + +2001-06-03 Alexander Terekhov , Louis Thomas + + * condvar.c (pthread_cond_init): Completely revamped. + (pthread_cond_destroy): Likewise. + (ptw32_cond_wait_cleanup): Likewise. + (ptw32_cond_timedwait): Likewise. + (ptw32_cond_unblock): New general signaling routine. + (pthread_cond_signal): Now calls ptw32_cond_unblock. + (pthread_cond_broadcast): Likewise. + * implement.h (pthread_cond_t_): Revamped. + * README.CV: New; explanation of the above changes. + +2001-05-30 Ross Johnson + + * pthread.h (rand_r): Fake using _seed argument to quell + compiler warning (compiler should optimise this away later). + + * GNUmakefile (OPT): Leave symbolic information out of the library + and increase optimisation level - for smaller faster prebuilt + dlls. + +2001-05-29 Milan Gardian + + * Makefile: fix typo. + * pthreads.h: Fix problems with stdcall/cdecl conventions, in particular + remove the need for PT_STDCALL everywhere; remove warning supression. + * (errno): Fix the longstanding "inconsistent dll linkage" problem + with errno; now also works with /MD debugging libs - + warnings emerged when compiling pthreads library with /MD (or /MDd) + compiler switch, instead of /MT (or /MTd) (i.e. when compiling pthreads + using Multithreaded DLL CRT instead of Multithreaded statically linked + CRT). + * create.c (pthread_create): Likewise; fix typo. + * private.c (ptw32_threadStart): Eliminate use of terminate() which doesn't + throw exceptions. + * Remove unnecessary #includes from a number of modules - + [I had to #include malloc.h in implement.h for gcc - rpj]. + +2001-05-29 Thomas Pfaff + + * pthread.h (PTHREAD_MUTEX_DEFAULT): New; equivalent to + PTHREAD_MUTEX_DEFAULT_NP. + * (PTHREAD_MUTEX_NORMAL): Similarly. + * (PTHREAD_MUTEX_ERRORCHECK): Similarly. + * (PTHREAD_MUTEX_RECURSIVE): Similarly. + * (pthread_mutex_setdefaultkind_np): New; Linux compatibility stub + for pthread_mutexattr_settype. + * (pthread_mutexattr_getkind_np): New; Linux compatibility stub + for pthread_mutexattr_gettype. + * mutex.c (pthread_mutexattr_settype): New; allow + the following types of mutex: + PTHREAD_MUTEX_DEFAULT_NP + PTHREAD_MUTEX_NORMAL_NP + PTHREAD_MUTEX_ERRORCHECK_NP + PTHREAD_MUTEX_RECURSIVE_NP + * Note that PTHREAD_MUTEX_DEFAULT is equivalent to + PTHREAD_MUTEX_NORMAL - ie. mutexes should no longer + be recursive by default, and a thread will deadlock if it + tries to relock a mutex it already owns. This is inline with + other pthreads implementations. + * (pthread_mutex_lock): Process the lock request + according to the mutex type. + * (pthread_mutex_init): Eliminate use of Win32 mutexes as the + basis of POSIX mutexes - instead, a combination of one critical section + and one semaphore are used in conjunction with Win32 Interlocked* routines. + * (pthread_mutex_destroy): Likewise. + * (pthread_mutex_lock): Likewise. + * (pthread_mutex_trylock): Likewise. + * (pthread_mutex_unlock): Likewise. + * Use longjmp/setjmp to implement cancelation when building the library + using a C compiler which doesn't support exceptions, e.g. gcc -x c (note + that gcc -x c++ uses exceptions). + * Also fixed some of the same typos and eliminated PT_STDCALL as + Milan Gardian's patches above. + +2001-02-07 Alexander Terekhov + + * rwlock.c: Revamped. + * implement.h (pthread_rwlock_t_): Redefined. + This implementation does not have reader/writer starvation problem. + Rwlock attempts to behave more like a normal mutex with + races and scheduling policy determining who is more important; + It also supports recursive locking, + has less synchronization overhead (no broadcasts at all, + readers are not blocked on any condition variable) and seem to + be faster than the current implementation [W98 appears to be + approximately 15 percent faster at least - on top of speed increase + from Thomas Pfaff's changes to mutex.c - rpj]. + +2000-12-29 Ross Johnson + + * Makefile: Back-out "for" loops which don't work. + + * GNUmakefile: Remove the fake.a target; add the "realclean" + target; don't remove built libs under the "clean" target. + + * config.h: Add a guard against multiple inclusion. + + * semaphore.h: Add some defines from config.h to make + semaphore.h independent of config.h when building apps. + + * pthread.h (_errno): Back-out previous fix until we know how to + fix it properly. + + * implement.h (lockCount): Add missing element to pthread_mutex_t_. + + * sync.c (pthread_join): Spelling fix in comment. + + * private.c (ptw32_threadStart): Reset original termination + function (C++). + (ptw32_threadStart): Cleanup detached threads early in case + the library is statically linked. + (ptw32_callUserDestroyRoutines): Remove [SEH] __try block from + destructor call so that unhandled exceptions will be passed through + to the system; call terminate() from [C++] try block for the same + reason. + + * tsd.c (pthread_getspecific): Add comment. + + * mutex.c (pthread_mutex_init): Initialise new elements in + pthread_mutex_t. + (pthread_mutex_unlock): Invert "pthread_equal()" test. + +2000-12-28 Ross Johnson + + * semaphore.c (mode_t): Use ifndef HAVE_MODE_T to include definition. + + * config.h.in (HAVE_MODE_T): Added. + (_UWIN): Start adding defines for the UWIN package. + + * private.c (ptw32_threadStart): Unhandled exceptions are + now passed through to the system to deal with. This is consistent + with normal Windows behaviour. C++ applications may use + set_terminate() to override the default behaviour which is + to call ptw32_terminate(). Ptw32_terminate() cleans up some + POSIX thread stuff before calling the system default function + which calls abort(). The users termination function should conform + to standard C++ semantics which is to not return. It should + exit the thread (call pthread_exit()) or exit the application. + * private.c (ptw32_terminate): Added as the default set_terminate() + function. It calls the system default function after cleaning up + some POSIX thread stuff. + + * implement.h (ptw32_try_enter_critical_section): Move + declaration. + * global.c (ptw32_try_enter_critical_section): Moved + from dll.c. + * dll.c: Move process and thread attach/detach code into + functions in nonportable.c. + * nonportable.c (pthread_win32_process_attach_np): Process + attach code from dll.c is now available to static linked + applications. + * nonportable.c (pthread_win32_process_detach_np): Likewise. + * nonportable.c (pthread_win32_thread_attach_np): Likewise. + * nonportable.c (pthread_win32_thread_detach_np): Likewise. + + * pthread.h: Add new non-portable prototypes for static + linked applications. + + * GNUmakefile (OPT): Increase optimisation flag and remove + debug info flag. + + * pthread.def: Add new non-portable exports for static + linked applications. + +2000-12-11 Ross Johnson + + * FAQ: Update Answer 6 re getting a fully working + Mingw32 built library. + +2000-10-10 Steven Reddie + + * misc.c (pthread_self): Restore Win32 "last error" + cleared by TlsGetValue() call in + pthread_getspecific() + +2000-09-20 Arthur Kantor + + * mutex.c (pthread_mutex_lock): Record the owner + of the mutex. This requires also keeping count of + recursive locks ourselves rather than leaving it + to Win32 since we need to know when to NULL the + thread owner when the mutex is unlocked. + (pthread_mutex_trylock): Likewise. + (pthread_mutex_unlock): Check that the calling + thread owns the mutex, decrement the recursive + lock count, and NULL the owner if zero. Return + EPERM if the mutex is owned by another thread. + * implement.h (pthread_mutex_t_): Add ownerThread + and lockCount members. + +2000-09-13 Jef Gearhart + + * mutex.c (pthread_mutex_init): Call + TryEnterCriticalSection through the pointer + rather than directly so that the dll can load + on Windows versions that can't resolve the + function, eg. Windows 95 + +2000-09-09 Ross Johnson + + * pthread.h (ctime_r): Fix arg. + +2000-09-08 Ross Johnson + + * GNUmakefile(_WIN32_WINNT=0x400): Define in CFLAGS; + doesn't seem to be needed though. + + * cancel.c (pthread_cancel): Must get "self" through + calling pthread_self() which will ensure a POSIX thread + struct is built for non-POSIX threads; return an error + if this fails + - Ollie Leahy + (pthread_setcancelstate): Likewise. + (pthread_setcanceltype): Likewise. + * misc.c (ptw32_cancelable_wait): Likewise. + + * private.c (ptw32_tkAssocCreate): Remove unused #if 0 + wrapped code. + + * pthread.h (ptw32_get_exception_services_code): + Needed to be forward declared unconditionally. + +2000-09-06 Ross Johnson + + * cancel.c (pthread_cancel): If called from the main + thread "self" would be NULL; get "self" via pthread_self() + instead of directly from TLS so that an implicit + pthread object is created. + + * misc.c (pthread_equal): Strengthen test for NULLs. + +2000-09-02 Ross Johnson + + * condvar.c (ptw32_cond_wait_cleanup): Ensure that all + waking threads check if they are the last, and notify + the broadcaster if so - even if an error occurs in the + waiter. + + * semaphore.c (_decrease_semaphore): Should be + a call to ptw32_decrease_semaphore. + (_increase_semaphore): Should be a call to + ptw32_increase_semaphore. + + * misc.c (ptw32_cancelable_wait): Renamed from + CancelableWait. + * rwlock.c (_rwlock_check*): Renamed to + ptw32_rwlock_check*. + * mutex.c (_mutex_check*): Renamed to ptw32_mutex_check*. + * condvar.c (cond_timed*): Renamed to ptw32_cond_timed*. + (_cond_check*): Renamed to ptw32_cond_check*. + (cond_wait_cleanup*): Rename to ptw32_cond_wait_cleanup*. + (ptw32_cond_timedwait): Add comments. + +2000-08-22 Ross Johnson + + * private.c (ptw32_throw): Fix exception test; + move exceptionInformation declaration. + + * tsd.c (pthread_key_create): newkey wrongly declared. + + * pthread.h: Fix comment block. + +2000-08-18 Ross Johnson + + * mutex.c (pthread_mutex_destroy): Check that the mutex isn't + held; invalidate the mutex as early as possible to avoid + contention; not perfect - FIXME! + + * rwlock.c (pthread_rwlock_init): Remove redundant assignment + to "rw". + (pthread_rwlock_destroy): Invalidate the rwlock before + freeing up any of it's resources - to avoid contention. + + * private.c (ptw32_tkAssocCreate): Change assoc->lock + to use a dynamically initialised mutex - only consumes + a W32 mutex or critical section when first used, + not before. + + * mutex.c (pthread_mutex_init): Remove redundant assignment + to "mx". + (pthread_mutexattr_destroy): Set attribute to NULL + before freeing it's memory - to avoid contention. + + * implement.h (PTW32_EPS_CANCEL/PTW32_EPS_EXIT): + Must be defined for all compilers - used as generic + exception selectors by ptw32_throw(). + + * Several: Fix typos from scripted edit session + yesterday. + + * nonportable.c (pthread_mutexattr_setforcecs_np): + Moved this function from mutex.c. + (pthread_getw32threadhandle_np): New function to + return the win32 thread handle that the POSIX + thread is using. + * mutex.c (pthread_mutexattr_setforcecs_np): + Moved to new file "nonportable.c". + + * pthread.h (PTW32_BUILD): Only redefine __except + and catch compiler keywords if we aren't building + the library (ie. PTW32_BUILD is not defined) - + this is safer than defining and then undefining + if not building the library. + * implement.h: Remove __except and catch undefines. + * Makefile (CFLAGS): Define PTW32_BUILD. + * GNUmakefile (CFLAGS): Define PTW32_BUILD. + + * All appropriate: Change Pthread_exception* to + ptw32_exception* to be consistent with internal + identifier naming. + + * private.c (ptw32_throw): New function to provide + a generic exception throw for all internal + exceptions and EH schemes. + (ptw32_threadStart): pthread_exit() value is now + returned via the thread structure exitStatus + element. + * exit.c (pthread_exit): pthread_exit() value is now + returned via the thread structure exitStatus + element. + * cancel.c (ptw32_cancel_self): Now uses ptw32_throw. + (pthread_setcancelstate): Ditto. + (pthread_setcanceltype): Ditto. + (pthread_testcancel): Ditto. + (pthread_cancel): Ditto. + * misc.c (CancelableWait): Ditto. + * exit.c (pthread_exit): Ditto. + * All applicable: Change PTW32_ prefix to + PTW32_ prefix to remove leading underscores + from private library identifiers. + +2000-08-17 Ross Johnson + + * All applicable: Change _pthread_ prefix to + ptw32_ prefix to remove leading underscores + from private library identifiers (single + and double leading underscores are reserved in the + ANSI C standard for compiler implementations). + + * tsd.c (pthread_create_key): Initialise temporary + key before returning it's address to avoid race + conditions. + +2000-08-13 Ross Johnson + + * errno.c: Add _MD precompile condition; thus far + had no effect when using /MD compile option but I + thnk it should be there. + + * exit.c: Add __cplusplus to various #if lines; + was compiling SEH code even when VC++ had + C++ compile options. + + * private.c: ditto. + + * create.c (pthread_create): Add PT_STDCALL macro to + function pointer arg in _beginthread(). + + * pthread.h: PT_STDCALL really does need to be defined + in both this and impliment.h; don't set it to __cdecl + - this macro is only used to extend function pointer + casting for functions that will be passed as parameters. + (~PThreadCleanup): add cast and group expression. + (_errno): Add _MD compile conditional. + (PtW32NoCatchWarn): Change pragma message. + + * implement.h: Move and change PT_STDCALL define. + + * need_errno.h: Add _MD to compilation conditional. + + * GNUmakefile: Substantial rewrite for new naming + convention; set for nil optimisation (turn it up + when we have a working library build; add target + "fake.a" to build a libpthreadw32.a from the VC++ + built DLL pthreadVCE.dll. + + * pthread.def (LIBRARY): Don't specify in the .def + file - it is specified on the linker command line + since we now use the same .def file for variously + named .dlls. + + * Makefile: Substantial rewrite for new naming + convention; default nmake target only issues a + help message; run nmake with specific target + corresponding to the EH scheme being used. + + * README: Update information; add naming convention + explanation. + + * ANNOUNCE: Update information. + +2000-08-12 Ross Johnson + + * pthread.h: Add compile-time message when using + MSC_VER compiler and C++ EH to warn application + programmers to use PtW32Catch instead of catch(...) + if they want cancelation and pthread_exit to work. + + * implement.h: Remove #include ; we + use our own local semaphore.h. + +2000-08-10 Ross Johnson + + * cleanup.c (pthread_pop_cleanup): Remove _pthread + prefix from __except and catch keywords; implement.h + now simply undefines ptw32__except and + ptw32_catch if defined; VC++ was not textually + substituting ptw32_catch etc back to catch as + it was redefined; the reason for using the prefixed + version was to make it clear that it was not using + the pthread.h redefined catch keyword. + + * private.c (ptw32_threadStart): Ditto. + (ptw32_callUserDestroyRoutines): Ditto. + + * implement.h (ptw32__except): Remove #define. + (ptw32_catch): Remove #define. + + * GNUmakefile (pthread.a): New target to build + libpthread32.a from pthread.dll using dlltool. + + * buildlib.bat: Duplicate cl commands with args to + build C++ EH version of pthread.dll; use of .bat + files is redundant now that nmake compatible + Makefile is included; used as a kludge only now. + + * Makefile: Localise some macros and fix up the clean: + target to extend it and work properly. + + * CONTRIBUTORS: Add contributors. + + * ANNOUNCE: Updated. + + * README: Updated. + +2000-08-06 Ross Johnson + + * pthread.h: Remove #warning - VC++ doesn't accept it. + +2000-08-05 Ross Johnson + + * pthread.h (PtW32CatchAll): Add macro. When compiling + applications using VC++ with C++ EH rather than SEH + 'PtW32CatchAll' must be used in place of any 'catch( ... )' + if the application wants pthread cancelation or + pthread_exit() to work. + +2000-08-03 Ross Johnson + + * pthread.h: Add a base class ptw32_exception for + library internal exceptions and change the "catch" + re-define macro to use it. + +2000-08-02 Ross Johnson + + * GNUmakefile (CFLAGS): Add -mthreads. + Add new targets to generate cpp and asm output. + + * sync.c (pthread_join): Remove dead code. + +2000-07-25 Tristan Savatier + + * sched.c (sched_get_priority_max): Handle different WinCE and + Win32 priority values together. + (sched_get_priority_min): Ditto. + +2000-07-25 Ross Johnson + + * create.c (pthread_create): Force new threads to wait until + pthread_create has the new thread's handle; we also retain + a local copy of the handle for internal use until + pthread_create returns. + + * private.c (ptw32_threadStart): Initialise ei[]. + (ptw32_threadStart): When beginthread is used to start the + thread, force waiting until the creator thread had the + thread handle. + + * cancel.c (ptw32_cancel_thread): Include context switch + code for defined(_X86_) environments in addition to _M_IX86. + + * rwlock.c (pthread_rwlock_destroy): Assignment changed + to avoid compiler warning. + + * private.c (ptw32_get_exception_services_code): Cast + NULL return value to avoid compiler warning. + + * cleanup.c (pthread_pop_cleanup): Initialise "cleanup" variable + to avoid compiler warnings. + + * misc.c (ptw32_new): Change "new" variable to "t" to avoid + confusion with the C++ keyword of the same name. + + * condvar.c (cond_wait_cleanup): Initialise lastWaiter variable. + (cond_timedwait): Remove unused local variables. to avoid + compiler warnings. + + * dll.c (dllMain): Remove 2000-07-21 change - problem + appears to be in pthread_create(). + +2000-07-22 Ross Johnson + + * tsd.c (pthread_key_create): If a destructor was given + and the pthread_mutex_init failed, then would try to + reference a NULL pointer (*key); eliminate this section of + code by using a dynamically initialised mutex + (PTHREAD_MUTEX_INITIALIZER). + + * tsd.c (pthread_setspecific): Return an error if + unable to set the value; simplify cryptic conditional. + + * tsd.c (pthread_key_delete): Locking threadsLock relied + on mutex_lock returning an error if the key has no destructor. + ThreadsLock is only initialised if the key has a destructor. + Making this mutex a static could reduce the number of mutexes + used by an application since it is actually created only at + first use and it's often destroyed soon after. + +2000-07-22 Ross Johnson + + * FAQ: Added Q5 and Q6. + +2000-07-21 David Baggett + + * dll.c: Include resource leakage work-around. This is a + partial FIXME which doesn't stop all leakage. The real + problem needs to be found and fixed. + +2000-07-21 Ross Johnson + + * create.c (pthread_create): Set threadH to 0 (zero) + everywhere. Some assignments were using NULL. Maybe + it should be NULL everywhere - need to check. (I know + they are nearly always the same thing - but not by + definition.) + + * misc.c (pthread_self): Try to catch NULL thread handles + at the point where they might be generated, even though + they should always be valid at this point. + + * tsd.c (pthread_setspecific): return an error value if + pthread_self() returns NULL. + + * sync.c (pthread_join): return an error value if + pthread_self() returns NULL. + + * signal.c (pthread_sigmask): return an error value if + pthread_self() returns NULL. + +2000-03-02 Ross Johnson + + * attr.c (pthread_attr_init): Set default stacksize to zero (0) + rather than PTHREAD_STACK_MIN even though these are now the same. + + * pthread.h (PTHREAD_STACK_MIN): Lowered to 0. + +2000-01-28 Ross Johnson + + * mutex.c (pthread_mutex_init): Free mutex if it has been alloced; + if critical sections can be used instead of Win32 mutexes, test + that the critical section works and return an error if not. + +2000-01-07 Ross Johnson + + * cleanup.c (pthread_pop_cleanup): Include SEH code only if MSC is not + compiling as C++. + (pthread_push_cleanup): Include SEH code only if MSC is not + compiling as C++. + + * pthread.h: Include SEH code only if MSC is not + compiling as C++. + + * implement.h: Include SEH code only if MSC is not + compiling as C++. + + * cancel.c (ptw32_cancel_thread): Add _M_IX86 check. + (pthread_testcancel): Include SEH code only if MSC is not + compiling as C++. + (ptw32_cancel_self): Include SEH code only if MSC is not + compiling as C++. + +2000-01-06 Erik Hensema + + * Makefile: Remove inconsistencies in 'cl' args + +2000-01-04 Ross Johnson + + * private.c (ptw32_get_exception_services_code): New; returns + value of EXCEPTION_PTW32_SERVICES. + (ptw32_processInitialize): Remove initialisation of + ptw32_exception_services which is no longer needed. + + * pthread.h (ptw32_exception_services): Remove extern. + (ptw32_get_exception_services_code): Add function prototype; + use this to return EXCEPTION_PTW32_SERVICES value instead of + using the ptw32_exception_services variable which I had + trouble exporting through pthread.def. + + * global.c (ptw32_exception_services): Remove declaration. + +1999-11-22 Ross Johnson + + * implement.h: Forward declare ptw32_new(); + + * misc.c (ptw32_new): New; alloc and initialise a new pthread_t. + (pthread_self): New thread struct is generated by new routine + ptw32_new(). + + * create.c (pthread_create): New thread struct is generated + by new routine ptw32_new(). + +1999-11-21 Ross Johnson + + * global.c (ptw32_exception_services): Declare new variable. + + * private.c (ptw32_threadStart): Destroy thread's + cancelLock mutex; make 'catch' and '__except' usageimmune to + redfinitions in pthread.h. + (ptw32_processInitialize): Init new constant ptw32_exception_services. + + * create.c (pthread_create): Initialise thread's cancelLock + mutex. + + * cleanup.c (pthread_pop_cleanup): Make 'catch' and '__except' + usage immune to redfinition s in pthread.h. + + * private.c: Ditto. + + * pthread.h (catch): Redefine 'catch' so that C++ applications + won't catch our internal exceptions. + (__except): ditto for __except. + + * implement.h (ptw32_catch): Define internal version + of 'catch' because 'catch' is redefined by pthread.h. + (__except): ditto for __except. + (struct pthread_t_): Add cancelLock mutex for async cancel + safety. + +1999-11-21 Jason Nye , Erik Hensema + + * cancel.c (ptw32_cancel_self): New; part of the async + cancellation implementation. + (ptw32_cancel_thread): Ditto; this function is X86 + processor specific. + (pthread_setcancelstate): Add check for pending async + cancel request and cancel the calling thread if + required; add async-cancel safety lock. + (pthread_setcanceltype): Ditto. + +1999-11-13 Erik Hensema + + * configure.in (AC_OUTPUT): Put generated output into GNUmakefile + rather than Makefile. Makefile will become the MSC nmake compatible + version + +1999-11-13 John Bossom (John.Bossom@cognos.com> + + * misc.c (pthread_self): Add a note about GetCurrentThread + returning a pseudo-handle + +1999-11-10 Todd Owen + + * dll.c (dllMain): Free kernel32 ASAP. + If TryEnterCriticalSection is not being used, then free + the kernel32.dll handle now, rather than leaving it until + DLL_PROCESS_DETACH. + + Note: this is not a pedantic exercise in freeing unused + resources! It is a work-around for a bug in Windows 95 + (see microsoft knowledge base article, Q187684) which + does Bad Things when FreeLibrary is called within + the DLL_PROCESS_DETACH code, in certain situations. + Since w95 just happens to be a platform which does not + provide TryEnterCriticalSection, the bug will be + effortlessly avoided. + +1999-11-10 Ross Johnson + + * sync.c (pthread_join): Make it a deferred cancelation point. + + * misc.c (pthread_self): Explicitly initialise implicitly + created thread state to default values. + +1999-11-05 Tristan Savatier + + * pthread.h (winsock.h): Include unconditionally. + (ETIMEDOUT): Change fallback value to that defined by winsock.h. + + * general: Patched for portability to WinCE. The details are + described in the file WinCE-PORT. Follow the instructions + in README.WinCE to make the appropriate changes in config.h. + +1999-10-30 Erik Hensema + + * create.c (pthread_create): Explicitly initialise thread state to + default values. + + * cancel.c (pthread_setcancelstate): Check for NULL 'oldstate' + for compatibility with Solaris pthreads; + (pthread_setcanceltype): ditto: + +1999-10-23 Erik Hensema + + * pthread.h (ctime_r): Fix incorrect argument "_tm" + +1999-10-21 Aurelio Medina + + * pthread.h (_POSIX_THREADS): Only define it if it isn't + already defined. Projects may need to define this on + the CC command line under Win32 as it doesn't have unistd.h + +1999-10-17 Ross Johnson + + * rwlock.c (pthread_rwlock_destroy): Add cast to remove compile + warning. + + * condvar.c (pthread_cond_broadcast): Only release semaphores + if there are waiting threads. + +1999-10-15 Lorin Hochstein , Peter Slacik + + * condvar.c (cond_wait_cleanup): New static cleanup handler for + cond_timedwait; + (cond_timedwait): pthread_cleanup_push args changed; + canceling a thread while it's in pthread_cond_wait + will now decrement the waiters count and cleanup if it's the + last waiter. + +1999-10-15 Graham Dumpleton + + * condvar.c (cond_wait_cleanup): the last waiter will now reset the CV's + wasBroadcast flag + +Thu Sep 16 1999 Ross Johnson + + * rwlock.c (pthread_rwlock_destroy): Add serialisation. + (_rwlock_check_need_init): Check for detroyed rwlock. + * rwlock.c: Check return codes from _rwlock_check_need_init(); + modify comments; serialise access to rwlock objects during + operations; rename rw_mutex to rw_lock. + * implement.h: Rename rw_mutex to rw_lock. + * mutex.c (pthread_mutex_destroy): Add serialisation. + (_mutex_check_need_init): Check for detroyed mutex. + * condvar.c (pthread_cond_destroy): Add serialisation. + (_cond_check_need_init): Check for detroyed condvar. + * mutex.c: Modify comments. + * condvar.c: Modify comments. + +1999-08-10 Aurelio Medina + + * implement.h (pthread_rwlock_t_): Add. + * pthread.h (pthread_rwlock_t): Add. + (PTHREAD_RWLOCK_INITIALIZER): Add. + Add rwlock function prototypes. + * rwlock.c: New module. + * pthread.def: Add new rwlock functions. + * private.c (ptw32_processInitialize): initialise + ptw32_rwlock_test_init_lock critical section. + * global.c (ptw32_rwlock_test_init_lock): Add. + + * mutex.c (pthread_mutex_destroy): Don't free mutex memory + if mutex is PTHREAD_MUTEX_INITIALIZER and has not been + initialised yet. + +1999-08-08 Milan Gardian + + * mutex.c (pthread_mutex_destroy): Free mutex memory. + +1999-08-22 Ross Johnson + + * exit.c (pthread_exit): Fix reference to potentially + uninitialised pointer. + +1999-08-21 Ross Johnson + + * private.c (ptw32_threadStart): Apply fix of 1999-08-19 + this time to C++ and non-trapped C versions. Ommitted to + do this the first time through. + +1999-08-19 Ross Johnson + + * private.c (ptw32_threadStart): Return exit status from + the application thread startup routine. + - Milan Gardian + +1999-08-18 John Bossom + + * exit.c (pthread_exit): Put status into pthread_t->exitStatus + * private.c (ptw32_threadStart): Set pthread->exitStatus + on exit of try{} block. + * sync.c (pthread_join): use pthread_exitStatus value if the + thread exit doesn't return a value (for Mingw32 CRTDLL + which uses endthread instead of _endthreadex). + +Tue Aug 17 20:17:58 CDT 1999 Mumit Khan + + * create.c (pthread_create): Add CRTDLL suppport. + * exit.c (pthread_exit): Likewise. + * private.c (ptw32_threadStart): Likewise. + (ptw32_threadDestroy): Likewise. + * sync.c (pthread_join): Likewise. + * tests/join1.c (main): Warn about partial support for CRTDLL. + +Tue Aug 17 20:00:08 1999 Mumit Khan + + * Makefile.in (LD): Delete entry point. + * acconfig.h (STDCALL): Delete unused macro. + * configure.in: Remove test for STDCALL. + * config.h.in: Regenerate. + * errno.c (_errno): Fix self type. + * pthread.h (PT_STDCALL): Move from here to + * implement.h (PT_STDCALL): here. + (ptw32_threadStart): Fix prototype. + * private.c (ptw32_threadStart): Likewise. + +1999-08-14 Ross Johnson + + * exit.c (pthread_exit): Don't call pthread_self() but + get thread handle directly from TSD for efficiency. + +1999-08-12 Ross Johnson + + * private.c (ptw32_threadStart): ei[] only declared if _MSC_VER. + + * exit.c (pthread_exit): Check for implicitly created threads + to avoid raising an unhandled exception. + +1999-07-12 Peter Slacik + + * condvar.c (pthread_cond_destroy): Add critical section. + (cond_timedwait): Add critical section; check for timeout + waiting on semaphore. + (pthread_cond_broadcast): Add critical section. + +1999-07-09 Lorin Hochstein , John Bossom + + The problem was that cleanup handlers were not executed when + pthread_exit() was called. + + * implement.h (pthread_t_): Add exceptionInformation element for + C++ per-thread exception information. + (general): Define and rename exceptions. + +1999-07-09 Ross Johnson + + * misc.c (CancelableWait): PTW32_EPS_CANCEL (SEH) and + ptw32_exception_cancel (C++) used to identify the exception. + + * cancel.c (pthread_testcancel): PTW32_EPS_CANCEL (SEH) and + ptw32_exception_cancel (C++) used to identify the exception. + + * exit.c (pthread_exit): throw/raise an exception to return to + ptw32_threadStart() to exit the thread. PTW32_EPS_EXIT (SEH) + and ptw32_exception_exit (C++) used to identify the exception. + + * private.c (ptw32_threadStart): Add pthread_exit exception trap; + clean up and exit the thread directly rather than via pthread_exit(). + +Sun May 30 00:25:02 1999 Ross Johnson + + * semaphore.h (mode_t): Conditionally typedef it. + +Fri May 28 13:33:05 1999 Mark E. Armstrong + + * condvar.c (pthread_cond_broadcast): Fix possible memory fault + +Thu May 27 13:08:46 1999 Peter Slacik + + * condvar.c (pthread_cond_broadcast): Fix logic bug + +Thu May 27 13:08:46 1999 Bossom, John + + * condvar.c (pthread_cond_broadcast): optimise sem_post loop + +Fri May 14 12:13:18 1999 Mike Russo + + * attr.c (pthread_attr_setdetachstate): Fix logic bug + +Sat May 8 09:42:30 1999 Ross Johnson + + * pthread.def (sem_open): Add. + (sem_close): Add. + (sem_unlink): Add. + (sem_getvalue): Add. + + * FAQ (Question 3): Add. + +Thu Apr 8 01:16:23 1999 Ross Johnson + + * semaphore.c (sem_open): New function; returns an error (ENOSYS). + (sem_close): ditto. + (sem_unlink): ditto. + (sem_getvalue): ditto. + + * semaphore.h (_POSIX_SEMAPHORES): define. + +Wed Apr 7 14:09:52 1999 Ross Johnson + + * errno.c (_REENTRANT || _MT): Invert condition. + + * pthread.h (_errno): Conditionally include prototype. + +Wed Apr 7 09:37:00 1999 Ross Johnson + + * *.c (comments): Remove individual attributions - these are + documented sufficiently elsewhere. + + * implement.h (pthread.h): Remove extraneous include. + +Sun Apr 4 11:05:57 1999 Ross Johnson + + * sched.c (sched.h): Include. + + * sched.h: New file for POSIX 1b scheduling. + + * pthread.h: Move opaque structures to implement.h; move sched_* + prototypes out and into sched.h. + + * implement.h: Add opaque structures from pthread.h. + + * sched.c (sched_yield): New function. + + * condvar.c (ptw32_sem_*): Rename to sem_*; except for + ptw32_sem_timedwait which is an private function. + +Sat Apr 3 23:28:00 1999 Ross Johnson + + * Makefile.in (OBJS): Add errno.o. + +Fri Apr 2 11:08:50 1999 Ross Johnson + + * implement.h (ptw32_sem_*): Remove prototypes now defined in + semaphore.h. + + * pthread.h (sempahore.h): Include. + + * semaphore.h: New file for POSIX 1b semaphores. + + * semaphore.c (ptw32_sem_timedwait): Moved to private.c. + + * pthread.h (ptw32_sem_t): Change to sem_t. + + * private.c (ptw32_sem_timedwait): Moved from semaphore.c; + set errno on error. + + * pthread.h (pthread_t_): Add per-thread errno element. + +Fri Apr 2 11:08:50 1999 John Bossom + + * semaphore.c (ptw32_sem_*): Change to sem_*; these functions + will be exported from the library; set errno on error. + + * errno.c (_errno): New file. New function. + +Fri Mar 26 14:11:45 1999 Tor Lillqvist + + * semaphore.c (ptw32_sem_timedwait): Check for negative + milliseconds. + +Wed Mar 24 11:32:07 1999 John Bossom + + * misc.c (CancelableWait): Initialise exceptionInformation[2]. + (pthread_self): Get a real Win32 thread handle for implicit threads. + + * cancel.c (pthread_testcancel): Initialise exceptionInformation[2]. + + * implement.h (SE_INFORMATION): Fix values. + + * private.c (ptw32_threadDestroy): Close the thread handle. + +Fri Mar 19 12:57:27 1999 Ross Johnson + + * cancel.c (comments): Update and cleanup. + +Fri Mar 19 09:12:59 1999 Ross Johnson + + * private.c (ptw32_threadStart): status returns PTHREAD_CANCELED. + + * pthread.h (PTHREAD_CANCELED): defined. + +Tue Mar 16 1999 Ross Johnson + + * all: Add GNU LGPL and Copyright and Warranty. + +Mon Mar 15 00:20:13 1999 Ross Johnson + + * condvar.c (pthread_cond_init): fix possible uninitialised use + of cv. + +Sun Mar 14 21:01:59 1999 Ross Johnson + + * condvar.c (pthread_cond_destroy): don't do full cleanup if + static initialised cv has never been used. + (cond_timedwait): check result of auto-initialisation. + +Thu Mar 11 09:01:48 1999 Ross Johnson + + * pthread.h (pthread_mutex_t): revert to (pthread_mutex_t *); + define a value to serve as PTHREAD_MUTEX_INITIALIZER. + (pthread_mutex_t_): remove staticinit and valid elements. + (pthread_cond_t): revert to (pthread_cond_t_ *); + define a value to serve as PTHREAD_COND_INITIALIZER. + (pthread_cond_t_): remove staticinit and valid elements. + + * mutex.c (pthread_mutex_t args): adjust indirection of references. + (all functions): check for PTHREAD_MUTEX_INITIALIZER value; + check for NULL (invalid). + + * condvar.c (pthread_cond_t args): adjust indirection of references. + (all functions): check for PTHREAD_COND_INITIALIZER value; + check for NULL (invalid). + +Wed Mar 10 17:18:12 1999 Ross Johnson + + * misc.c (CancelableWait): Undo changes from Mar 8 and 7. + +Mon Mar 8 11:18:59 1999 Ross Johnson + + * misc.c (CancelableWait): Ensure cancelEvent handle is the lowest + indexed element in the handles array. Enhance test for abandoned + objects. + + * pthread.h (PTHREAD_MUTEX_INITIALIZER): Trailing elements not + initialised are set to zero by the compiler. This avoids the + problem of initialising the opaque critical section element in it. + (PTHREAD_COND_INITIALIZER): Ditto. + + * semaphore.c (ptw32_sem_timedwait): Check sem == NULL earlier. + +Sun Mar 7 12:31:14 1999 Ross Johnson + + * condvar.c (pthread_cond_init): set semaphore initial value + to 0, not 1. cond_timedwait was returning signaled immediately. + + * misc.c (CancelableWait): Place the cancel event handle first + in the handle table for WaitForMultipleObjects. This ensures that + the cancel event is recognised and acted apon if both objects + happen to be signaled together. + + * private.c (ptw32_cond_test_init_lock): Initialise and destroy. + + * implement.h (ptw32_cond_test_init_lock): Add extern. + + * global.c (ptw32_cond_test_init_lock): Add declaration. + + * condvar.c (pthread_cond_destroy): check for valid initialised CV; + flag destroyed CVs as invalid. + (pthread_cond_init): pthread_cond_t is no longer just a pointer. + This is because PTHREAD_COND_INITIALIZER needs state info to reside + in pthread_cond_t so that it can initialise on first use. Will work on + making pthread_cond_t (and other objects like it) opaque again, if + possible, later. + (cond_timedwait): add check for statically initialisation of + CV; initialise on first use. + (pthread_cond_signal): check for valid CV. + (pthread_cond_broadcast): check for valid CV. + (_cond_check_need_init): Add. + + * pthread.h (PTHREAD_COND_INITIALIZER): Fix. + (pthread_cond_t): no longer a pointer to pthread_cond_t_. + (pthread_cond_t_): add 'staticinit' and 'valid' elements. + +Sat Mar 6 1999 Ross Johnson + + * implement.h: Undate comments. + +Sun Feb 21 1999 Ross Johnson + + * pthread.h (PTHREAD_MUTEX_INITIALIZER): missing braces around + cs element initialiser. + +1999-02-21 Ben Elliston + + * pthread.h (pthread_exit): The return type of this function is + void, not int. + + * exit.c (pthread_exit): Do not return 0. + +Sat Feb 20 16:03:30 1999 Ross Johnson + + * dll.c (DLLMain): Expand TryEnterCriticalSection support test. + + * mutex.c (pthread_mutex_trylock): The check for + ptw32_try_enter_critical_section == NULL should have been + removed long ago. + +Fri Feb 19 16:03:30 1999 Ross Johnson + + * sync.c (pthread_join): Fix pthread_equal() test. + + * mutex.c (pthread_mutex_trylock): Check mutex != NULL before + using it. + +Thu Feb 18 16:17:30 1999 Ross Johnson + + * misc.c (pthread_equal): Fix inverted result. + + * Makefile.in: Use libpthread32.a as the name of the DLL export + library instead of pthread.lib. + + * condvar.c (pthread_cond_init): cv could have been used unitialised; + initialise. + + * create.c (pthread_create): parms could have been used unitialised; + initialise. + + * pthread.h (struct pthread_once_t_): Remove redefinition. + +Sat Feb 13 03:03:30 1999 Ross Johnson + + * pthread.h (struct pthread_once_t_): Replaced. + + * misc.c (pthread_once): Replace with John Bossom's version; + has lighter weight serialisation; fixes problem of not holding + competing threads until after the init_routine completes. + +Thu Feb 11 13:34:14 1999 Ross Johnson + + * misc.c (CancelableWait): Change C++ exception throw. + + * sync.c (pthread_join): Change FIXME comment - issue resolved. + +Wed Feb 10 12:49:11 1999 Ross Johnson + + * configure: Various temporary changes. + - Kevin Ruland + + * README: Update. + + * pthread.def (pthread_attr_getstackaddr): uncomment + (pthread_attr_setstackaddr): uncomment + +Fri Feb 5 13:42:30 1999 Ross Johnson + + * semaphore.c: Comment format changes. + +Thu Feb 4 10:07:28 1999 Ross Johnson + + * global.c: Remove ptw32_exception instantiation. + + * cancel.c (pthread_testcancel): Change C++ exception throw. + + * implement.h: Remove extern declaration. + +Wed Feb 3 13:04:44 1999 Ross Johnson + + * cleanup.c: Rename ptw32_*_cleanup() to pthread_*_cleanup(). + + * pthread.def: Ditto. + + * pthread.h: Ditto. + + * pthread.def (pthread_cleanup_push): Remove from export list; + the function is defined as a macro under all compilers. + (pthread_cleanup_pop): Ditto. + + * pthread.h: Remove #if defined(). + +Wed Feb 3 10:13:48 1999 Ross Johnson + + * sync.c (pthread_join): Check for NULL value_ptr arg; + check for detached threads. + +Tue Feb 2 18:07:43 1999 Ross Johnson + + * implement.h: Add #include . + Change sem_t to ptw32_sem_t. + +Tue Feb 2 18:07:43 1999 Kevin Ruland + + * signal.c (pthread_sigmask): Add and modify casts. + Reverse LHS/RHS bitwise assignments. + + * pthread.h: Remove #include . + (PTW32_ATTR_VALID): Add cast. + (struct pthread_t_): Add sigmask element. + + * dll.c: Add "extern C" for DLLMain. + (DllMain): Add cast. + + * create.c (pthread_create): Set sigmask in thread. + + * condvar.c: Remove #include. Change sem_* to ptw32_sem_*. + + * attr.c: Changed #include. + + * Makefile.in: Additional targets and changes to build the library + as a DLL. + +Fri Jan 29 11:56:28 1999 Ross Johnson + + * Makefile.in (OBJS): Add semaphore.o to list. + + * semaphore.c (ptw32_sem_timedwait): Move from private.c. + Rename sem_* to ptw32_sem_*. + + * pthread.h (pthread_cond_t): Change type of sem_t. + _POSIX_SEMAPHORES no longer defined. + + * semaphore.h: Contents moved to implement.h. + Removed from source tree. + + * implement.h: Add semaphore function prototypes and rename all + functions to prepend 'ptw32_'. They are + now private to the pthreads-win32 implementation. + + * private.c: Change #warning. + Move ptw32_sem_timedwait() to semaphore.c. + + * cleanup.c: Change #warning. + + * misc.c: Remove #include + + * pthread.def: Cleanup CVS merge conflicts. + + * global.c: Ditto. + + * ChangeLog: Ditto. + + * cleanup.c: Ditto. + +Sun Jan 24 01:34:52 1999 Ross Johnson + + * semaphore.c (sem_wait): Remove second arg to + pthreadCancelableWait() call. + +Sat Jan 23 17:36:40 1999 Ross Johnson + + * pthread.def: Add new functions to export list. + + * pthread.h (PTHREAD_MUTEX_AUTO_CS_NP): New. + (PTHREAD_MUTEX_FORCE_CS_NP): New. + + * README: Updated. + +Fri Jan 22 14:31:59 1999 Ross Johnson + + * Makefile.in (CFLAGS): Remove -fhandle-exceptions. Not needed + with egcs. Add -g for debugging. + + * create.c (pthread_create): Replace __stdcall with PT_STDCALL + macro. This is a hack and must be fixed. + + * misc.c (CancelableWait): Remove redundant statement. + + * mutex.c (pthread_mutexattr_init): Cast calloc return value. + + * misc.c (CancelableWait): Add cast. + (pthread_self): Add cast. + + * exit.c (pthread_exit): Add cast. + + * condvar.c (pthread_condattr_init): Cast calloc return value. + + * cleanup.c: Reorganise conditional compilation. + + * attr.c (pthread_attr_init): Remove unused 'result'. + Cast malloc return value. + + * private.c (ptw32_callUserDestroyRoutines): Redo conditional + compilation. + + * misc.c (CancelableWait): C++ version uses 'throw'. + + * cancel.c (pthread_testcancel): Ditto. + + * implement.h (class ptw32_exception): Define for C++. + + * pthread.h: Fix C, C++, and Win32 SEH condition compilation + mayhem around pthread_cleanup_* defines. C++ version now uses John + Bossom's cleanup handlers. + (pthread_attr_t): Make 'valid' unsigned. + Define '_timeb' as 'timeb' for Ming32. + Define PT_STDCALL as nothing for Mingw32. May be temporary. + + * cancel.c (pthread_testcancel): Cast return value. + +Wed Jan 20 09:31:28 1999 Ross Johnson + + * pthread.h (pthread_mutexattr_t): Changed to a pointer. + + * mutex.c (pthread_mutex_init): Conditionally create Win32 mutex + - from John Bossom's implementation. + (pthread_mutex_destroy): Conditionally close Win32 mutex + - from John Bossom's implementation. + (pthread_mutexattr_init): Replaced by John Bossom's version. + (pthread_mutexattr_destroy): Ditto. + (pthread_mutexattr_getpshared): New function from John Bossom's + implementation. + (pthread_mutexattr_setpshared): New function from John Bossom's + implementation. + +Tue Jan 19 18:27:42 1999 Ross Johnson + + * pthread.h (pthreadCancelableTimedWait): New prototype. + (pthreadCancelableWait): Remove second argument. + + * misc.c (CancelableWait): New static function is + pthreadCancelableWait() renamed. + (pthreadCancelableWait): Now just calls CancelableWait() with + INFINITE timeout. + (pthreadCancelableTimedWait): Just calls CancelableWait() + with passed in timeout. + +Tue Jan 19 18:27:42 1999 Scott Lightner + + * private.c (ptw32_sem_timedwait): 'abstime' arg really is + absolute time. Calculate relative time to wait from current + time before passing timeout to new routine + pthreadCancelableTimedWait(). + +Tue Jan 19 10:27:39 1999 Ross Johnson + + * pthread.h (pthread_mutexattr_setforcecs_np): New prototype. + + * mutex.c (pthread_mutexattr_init): Init 'pshared' and 'forcecs' + attributes to 0. + (pthread_mutexattr_setforcecs_np): New function (not portable). + + * pthread.h (pthread_mutex_t): + Add 'mutex' element. Set to NULL in PTHREAD_MUTEX_INITIALIZER. + The pthread_mutex_*() routines will try to optimise performance + by choosing either mutexes or critical sections as the basis + for pthread mutexes for each indevidual mutex. + (pthread_mutexattr_t_): Add 'forcecs' element. + Some applications may choose to force use of critical sections + if they know that:- + the mutex is PROCESS_PRIVATE and, + either the OS supports TryEnterCriticalSection() or + pthread_mutex_trylock() will never be called on the mutex. + This attribute will be setable via a non-portable routine. + + Note: We don't yet support PROCESS_SHARED mutexes, so the + implementation as it stands will default to Win32 mutexes only if + the OS doesn't support TryEnterCriticalSection. On Win9x, and early + versions of NT 'forcecs' will need to be set in order to get + critical section based mutexes. + +Sun Jan 17 12:01:26 1999 Ross Johnson + + * pthread.h (PTHREAD_MUTEX_INITIALIZER): Init new 'staticinit' + value to '1' and existing 'valid' value to '1'. + + * global.c (ptw32_mutex_test_init_lock): Add. + + * implement.h (ptw32_mutex_test_init_lock.): Add extern. + + * private.c (ptw32_processInitialize): Init critical section for + global lock used by _mutex_check_need_init(). + (ptw32_processTerminate): Ditto (:s/Init/Destroy/). + + * dll.c (dllMain): Move call to FreeLibrary() so that it is only + called once when the process detaches. + + * mutex.c (_mutex_check_need_init): New static function to test + and init PTHREAD_MUTEX_INITIALIZER mutexes. Provides serialised + access to the internal state of the uninitialised static mutex. + Called from pthread_mutex_trylock() and pthread_mutex_lock() which + do a quick unguarded test to check if _mutex_check_need_init() + needs to be called. This is safe as the test is conservative + and is repeated inside the guarded section of + _mutex_check_need_init(). Thus in all calls except the first + calls to lock static mutexes, the additional overhead to lock any + mutex is a single memory fetch and test for zero. + + * pthread.h (pthread_mutex_t_): Add 'staticinit' member. Mutexes + initialised by PTHREAD_MUTEX_INITIALIZER aren't really initialised + until the first attempt to lock it. Using the 'valid' + flag (which flags the mutex as destroyed or not) to record this + information would be messy. It is possible for a statically + initialised mutex such as this to be destroyed before ever being + used. + + * mutex.c (pthread_mutex_trylock): Call _mutex_check_need_init() + to test/init PTHREAD_MUTEX_INITIALIZER mutexes. + (pthread_mutex_lock): Ditto. + (pthread_mutex_unlock): Add check to ensure we don't try to unlock + an unitialised static mutex. + (pthread_mutex_destroy): Add check to ensure we don't try to delete + a critical section that we never created. Allows us to destroy + a static mutex that has never been locked (and hence initialised). + (pthread_mutex_init): Set 'staticinit' flag to 0 for the new mutex. + +Sun Jan 17 12:01:26 1999 Ross Johnson + + * private.c (ptw32_sem_timedwait): Move from semaphore.c. + + * semaphore.c : Remove redundant #includes. + (ptw32_sem_timedwait): Move to private.c. + (sem_wait): Add missing abstime arg to pthreadCancelableWait() call. + +Fri Jan 15 23:38:05 1999 Ross Johnson + + * condvar.c (cond_timedwait): Remove comment. + +Fri Jan 15 15:41:28 1999 Ross Johnson + + * pthread.h: Add new 'abstime' arg to pthreadCancelableWait() + prototype. + + * condvar.c (cond_timedwait): New generalised function called by + both pthread_cond_wait() and pthread_cond_timedwait(). This is + essentially pthread_cond_wait() renamed and modified to add the + 'abstime' arg and call the new ptw32_sem_timedwait() instead of + sem_wait(). + (pthread_cond_wait): Now just calls the internal static + function cond_timedwait() with an INFINITE wait. + (pthread_cond_timedwait): Now implemented. Calls the internal + static function cond_timedwait(). + + * implement.h (ptw32_sem_timedwait): New internal function + prototype. + + * misc.c (pthreadCancelableWait): Added new 'abstime' argument + to allow shorter than INFINITE wait. + + * semaphore.c (ptw32_sem_timedwait): New function for internal + use. This is essentially sem_wait() modified to add the + 'abstime' arg and call the modified (see above) + pthreadCancelableWait(). + +Thu Jan 14 14:27:13 1999 Ross Johnson + + * cleanup.c: Correct _cplusplus to __cplusplus wherever used. + + * Makefile.in: Add CC=g++ and add -fhandle-exceptions to CFLAGS. + The derived Makefile will compile all units of the package as C++ + so that those which include try/catch exception handling should work + properly. The package should compile ok if CC=gcc, however, exception + handling will not be included and thus thread cancellation, for + example, will not work. + + * cleanup.c (ptw32_pop_cleanup): Add #warning to compile this + file as C++ if using a cygwin32 environment. Perhaps the whole package + should be compiled using g++ under cygwin. + + * private.c (ptw32_threadStart): Change #error directive + into #warning and bracket for __CYGWIN__ and derivative compilers. + +Wed Jan 13 09:34:52 1999 Ross Johnson + + * build.bat: Delete old binaries before compiling/linking. + +Tue Jan 12 09:58:38 1999 Tor Lillqvist + + * dll.c: The Microsoft compiler pragmas probably are more + appropriately protected by _MSC_VER than by _WIN32. + + * pthread.h: Define ETIMEDOUT. This should be returned by + pthread_cond_timedwait which is not implemented yet as of + snapshot-1999-01-04-1305. It was implemented in the older version. + The Microsoft compiler pragmas probably are more appropriately + protected by _MSC_VER than by _WIN32. + + * pthread.def: pthread_mutex_destroy was missing from the def file + + * condvar.c (pthread_cond_broadcast): Ensure we only wait on threads + if there were any waiting on the condition. + I think pthread_cond_broadcast should do the WaitForSingleObject + only if cv->waiters > 0? Otherwise it seems to hang, at least in the + testg thread program from glib. + +Tue Jan 12 09:58:38 1999 Ross Johnson + + * condvar.c (pthread_cond_timedwait): Fix function description + comments. + + * semaphore.c (sem_post): Correct typo in comment. + +Mon Jan 11 20:33:19 1999 Ross Johnson + + * pthread.h: Re-arrange conditional compile of pthread_cleanup-* + macros. + + * cleanup.c (ptw32_push_cleanup): Provide conditional + compile of cleanup->prev. + +1999-01-11 Tor Lillqvist + + * condvar.c (pthread_cond_init): Invert logic when testing the + return value from calloc(). + +Sat Jan 9 14:32:08 1999 Ross Johnson + + * implement.h: Compile-time switch for CYGWIN derived environments + to use CreateThread instead of _beginthreadex. Ditto for ExitThread. + Patch provided by Anders Norlander . + +Tue Jan 5 16:33:04 1999 Ross Johnson + + * cleanup.c (ptw32_pop_cleanup): Add C++ version of __try/__except + block. Move trailing "}" out of #ifdef _WIN32 block left there by + (rpj's) mistake. + + * private.c: Remove #include which is included by pthread.h. + +1998-12-11 Ben Elliston + + * README: Update info about subscribing to the mailing list. + +Mon Jan 4 11:23:40 1999 Ross Johnson + + * all: No code changes, just cleanup. + - remove #if 0 /* Pre Bossom */ enclosed code. + - Remove some redundant #includes. + * pthread.h: Update implemented/unimplemented routines list. + * Tag the bossom merge branch getting ready to merge back to main + trunk. + +Tue Dec 29 13:11:16 1998 Ross Johnson + + * implement.h: Move the following struct definitions to pthread.h: + pthread_t_, pthread_attr_t_, pthread_mutex_t_, pthread_mutex_t_, + pthread_mutexattr_t_, pthread_key_t_, pthread_cond_t_, + pthread_condattr_t_, pthread_once_t_. + + * pthread.h: Add "_" prefix to pthread_push_cleanup and + pthread_pop_cleanup internal routines, and associated struct and + typedefs. + + * buildlib.bat: Add compile command for semaphore.c + + * pthread.def: Comment out pthread_atfork routine name. + Now unimplemented. + + * tsd.c (pthread_setspecific): Rename tkAssocCreate to + ptw32_tkAssocCreate. + (pthread_key_delete): Rename tkAssocDestroy to + ptw32_tkAssocDestroy. + + * sync.c (pthread_join): Rename threadDestroy to ptw32_threadDestroy + + * sched.c (is_attr): attr is now **attr (was *attr), so add extra + NULL pointer test. + (pthread_attr_setschedparam): Increase redirection for attr which is + now a **. + (pthread_attr_getschedparam): Ditto. + (pthread_setschedparam): Change thread validation and rename "thread" + Win32 thread Handle element name to match John Bossom's version. + (pthread_getschedparam): Ditto. + + * private.c (ptw32_threadDestroy): Rename call to + callUserDestroyRoutines() as ptw32_callUserDestroyRoutines() + + * misc.c: Add #include "implement.h". + + * dll.c: Remove defined(KLUDGE) wrapped code. + + * fork.c: Remove redefinition of ENOMEM. + Remove pthread_atfork() and fork() with #if 0/#endif. + + * create.c (pthread_create): Rename threadStart and threadDestroy calls + to ptw32_threadStart and ptw32_threadDestroy. + + * implement.h: Rename "detachedstate" to "detachstate". + + * attr.c: Rename "detachedstate" to "detachstate". + +Mon Dec 28 09:54:39 1998 John Bossom + + * semaphore.c: Initial version. + * semaphore.h: Initial version. + +Mon Dec 28 09:54:39 1998 Ross Johnson + + * pthread.h (pthread_attr_t_): Change to *pthread_attr_t. + +Mon Dec 28 09:54:39 1998 John Bossom, Ben Elliston + + * attr.c (pthread_attr_setstacksize): Merge with John's version. + (pthread_attr_getstacksize): Merge with John's version. + (pthread_attr_setstackaddr): Merge with John's version. + (pthread_attr_getstackaddr): Merge with John's version. + (pthread_attr_init): Merge with John's version. + (pthread_attr_destroy): Merge with John's version. + (pthread_attr_getdetachstate): Merge with John's version. + (pthread_attr_setdetachstate): Merge with John's version. + (is_attr): attr is now **attr (was *attr), so add extra NULL pointer + test. + +Mon Dec 28 09:54:39 1998 Ross Johnson + + * implement.h (pthread_attr_t_): Add and rename elements in JEB's + version to correspond to original, so that it can be used with + original attr routines. + + * pthread.h: Add #endif at end which was truncated in merging. + +Sun Dec 20 14:51:58 1998 Ross Johnson + + * misc.c (pthreadCancelableWait): New function by John Bossom. Non-standard + but provides a hook that can be used to implement cancellation points in + applications that use this library. + + * pthread.h (pthread_cleanup_pop): C++ (non-WIN32) version uses + try/catch to emulate John Bossom's WIN32 __try/__finally behaviour. + In the WIN32 version __finally block, add a test for AbnormalTermination otherwise + cleanup is only run if the cleanup_pop execute arg is non-zero. Cancellation + should cause the cleanup to run irrespective of the execute arg. + + * condvar.c (pthread_condattr_init): Replaced by John Bossom's version. + (pthread_condattr_destroy): Replaced by John Bossom's version. + (pthread_condattr_getpshared): Replaced by John Bossom's version. + (pthread_condattr_setpshared): Replaced by John Bossom's version. + (pthread_cond_init): Replaced by John Bossom's version. + Fix comment (refered to mutex rather than condition variable). + (pthread_cond_destroy): Replaced by John Bossom's version. + (pthread_cond_wait): Replaced by John Bossom's version. + (pthread_cond_timedwait): Replaced by John Bossom's version. + (pthread_cond_signal): Replaced by John Bossom's version. + (pthread_cond_broadcast): Replaced by John Bossom's version. + +Thu Dec 17 19:10:46 1998 Ross Johnson + + * tsd.c (pthread_key_create): Replaced by John Bossom's version. + (pthread_key_delete): Replaced by John Bossom's version. + (pthread_setspecific): Replaced by John Bossom's version. + (pthread_getspecific): Replaced by John Bossom's version. + +Mon Dec 7 09:44:40 1998 John Bossom + + * cancel.c (pthread_setcancelstate): Replaced. + (pthread_setcanceltype): Replaced. + (pthread_testcancel): Replaced. + (pthread_cancel): Replaced. + + * exit.c (pthread_exit): Replaced. + + * misc.c (pthread_self): Replaced. + (pthread_equal): Replaced. + + * sync.c (pthread_detach): Replaced. + (pthread_join): Replaced. + + * create.c (pthread_create): Replaced. + + * private.c (ptw32_processInitialize): New. + (ptw32_processTerminate): New. + (ptw32_threadStart): New. + (ptw32_threadDestroy): New. + (ptw32_cleanupStack): New. + (ptw32_tkAssocCreate): New. + (ptw32_tkAssocDestroy): New. + (ptw32_callUserDestroyRoutines): New. + + * implement.h: Added non-API structures and declarations. + + * dll.c (PthreadsEntryPoint): Cast return value of GetProcAddress + to resolve compile warning from MSVC. + + * dll.c (DLLmain): Replaced. + * dll.c (PthreadsEntryPoint): + Re-applied Anders Norlander's patch:- + Initialize ptw32_try_enter_critical_section at startup + and release kernel32 handle when DLL is being unloaded. + +Sun Dec 6 21:54:35 1998 Ross Johnson + + * buildlib.bat: Fix args to CL when building the .DLL + + * cleanup.c (ptw32_destructor_run_all): Fix TSD key management. + This is a tidy-up before TSD and Thread management is completely + replaced by John Bossom's code. + + * tsd.c (pthread_key_create): Fix TSD key management. + + * global.c (ptw32_key_virgin_next): Initialise. + + * build.bat: New DOS script to compile and link a pthreads app + using Microsoft's CL compiler linker. + * buildlib.bat: New DOS script to compile all the object files + and create pthread.lib and pthread.dll using Microsoft's CL + compiler linker. + +1998-12-05 Anders Norlander + + * implement.h (ptw32_try_enter_critical_section): New extern + * dll.c (ptw32_try_enter_critical_section): New pointer to + TryEnterCriticalSection if it exists; otherwise NULL. + * dll.c (PthreadsEntryPoint): + Initialize ptw32_try_enter_critical_section at startup + and release kernel32 handle when DLL is being unloaded. + * mutex.c (pthread_mutex_trylock): Replaced check for NT with + a check if ptw32_try_enter_critical_section is valid + pointer to a function. Call ptw32_try_enter_critical_section + instead of TryEnterCriticalSection to avoid errors on Win95. + +Thu Dec 3 13:32:00 1998 Ross Johnson + + * README: Correct cygwin32 compatibility statement. + +Sun Nov 15 21:24:06 1998 Ross Johnson + + * cleanup.c (ptw32_destructor_run_all): Declare missing void * arg. + Fixup CVS merge conflicts. + +1998-10-30 Ben Elliston + + * condvar.c (cond_wait): Fix semantic error. Test for equality + instead of making an assignment. + +Fri Oct 30 15:15:50 1998 Ross Johnson + + * cleanup.c (ptw32_handler_push): Fixed bug appending new + handler to list reported by Peter Slacik + . + (new_thread): Rename poorly named local variable to + "new_handler". + +Sat Oct 24 18:34:59 1998 Ross Johnson + + * global.c: Add TSD key management array and index declarations. + + * implement.h: Ditto for externs. + +Fri Oct 23 00:08:09 1998 Ross Johnson + + * implement.h (PTW32_TSD_KEY_REUSE): Add enum. + + * private.c (ptw32_delete_thread): Add call to + ptw32_destructor_run_all() to clean up the threads keys. + + * cleanup.c (ptw32_destructor_run_all): Check for no more dirty + keys to run destructors on. Assume that the destructor call always + succeeds and set the key value to NULL. + +Thu Oct 22 21:44:44 1998 Ross Johnson + + * tsd.c (pthread_setspecific): Add key management code. + (pthread_key_create): Ditto. + (pthread_key_delete): Ditto. + + * implement.h (struct ptw32_tsd_key): Add status member. + + * tsd.c: Add description of pthread_key_delete() from the + standard as a comment. + +Fri Oct 16 17:38:47 1998 Ross Johnson + + * cleanup.c (ptw32_destructor_run_all): Fix and improve + stepping through the key table. + +Thu Oct 15 14:05:01 1998 Ross Johnson + + * private.c (ptw32_new_thread): Remove init of destructorstack. + No longer an element of pthread_t. + + * tsd.c (pthread_setspecific): Fix type declaration and cast. + (pthread_getspecific): Ditto. + (pthread_getspecific): Change error return value to NULL if key + is not in use. + +Thu Oct 15 11:53:21 1998 Ross Johnson + + * global.c (ptw32_tsd_key_table): Fix declaration. + + * implement.h(ptw32_TSD_keys_TlsIndex): Add missing extern. + (ptw32_tsd_mutex): Ditto. + + * create.c (ptw32_start_call): Fix "keys" array declaration. + Add comment. + + * tsd.c (pthread_setspecific): Fix type declaration and cast. + (pthread_getspecific): Ditto. + + * cleanup.c (ptw32_destructor_run_all): Declare missing loop + counter. + +Wed Oct 14 21:09:24 1998 Ross Johnson + + * private.c (ptw32_new_thread): Increment ptw32_threads_count. + (ptw32_delete_thread): Decrement ptw32_threads_count. + Remove some comments. + + * exit.c (ptw32_exit): : Fix two pthread_mutex_lock() calls that + should have been pthread_mutex_unlock() calls. + (ptw32_vacuum): Remove call to ptw32_destructor_pop_all(). + + * create.c (pthread_create): Fix two pthread_mutex_lock() calls that + should have been pthread_mutex_unlock() calls. + + * global.c (ptw32_tsd_mutex): Add mutex for TSD operations. + + * tsd.c (pthread_key_create): Add critical section. + (pthread_setspecific): Ditto. + (pthread_getspecific): Ditto. + (pthread_key_delete): Ditto. + + * sync.c (pthread_join): Fix two pthread_mutex_lock() calls that + should have been pthread_mutex_unlock() calls. + +Mon Oct 12 00:00:44 1998 Ross Johnson + + * implement.h (ptw32_tsd_key_table): New. + + * create.c (ptw32_start_call): Initialise per-thread TSD keys + to NULL. + + * misc.c (pthread_once): Correct typo in comment. + + * implement.h (ptw32_destructor_push): Remove. + (ptw32_destructor_pop): Remove. + (ptw32_destructor_run_all): Rename from ptw32_destructor_pop_all. + (PTW32_TSD_KEY_DELETED): Add enum. + (PTW32_TSD_KEY_INUSE): Add enum. + + * cleanup.c (ptw32_destructor_push): Remove. + (ptw32_destructor_pop): Remove. + (ptw32_destructor_run_all): Totally revamped TSD. + + * dll.c (ptw32_TSD_keys_TlsIndex): Initialise. + + * tsd.c (pthread_setspecific): Totally revamped TSD. + (pthread_getspecific): Ditto. + (pthread_create): Ditto. + (pthread_delete): Ditto. + +Sun Oct 11 22:44:55 1998 Ross Johnson + + * global.c (ptw32_tsd_key_table): Add new global. + + * implement.h (ptw32_tsd_key_t and struct ptw32_tsd_key): + Add. + (struct _pthread): Remove destructorstack. + + * cleanup.c (ptw32_destructor_run_all): Rename from + ptw32_destructor_pop_all. The key destructor stack was made + global rather than per-thread. No longer removes destructor nodes + from the stack. Comments updated. + +1998-10-06 Ben Elliston + + * condvar.c (cond_wait): Use POSIX, not Win32 mutex calls. + (pthread_cond_broadcast): Likewise. + (pthread_cond_signal): Likewise. + +1998-10-05 Ben Elliston + + * pthread.def: Update. Some functions aren't available yet, others + are macros in . + + * tests/join.c: Remove; useless. + +Mon Oct 5 14:25:08 1998 Ross Johnson + + * pthread.def: New file for building the DLL. + +1998-10-05 Ben Elliston + + * misc.c (pthread_equal): Correct inverted logic bug. + (pthread_once): Use the POSIX mutex primitives, not Win32. Remove + irrelevant FIXME comment. + + * global.c (PTHREAD_MUTEX_INITIALIZER): Move to pthread.h. + + * pthread.h (PTHREAD_MUTEX_INITIALIZER): Define. + (pthread_mutex_t): Reimplement as a struct containing a valid + flag. If the flag is ever down upon entry to a mutex operation, + we call pthread_mutex_create() to initialise the object. This + fixes the problem of how to handle statically initialised objects + that can't call InitializeCriticalSection() due to their context. + (PTHREAD_ONCE_INIT): Define. + + * mutex.c (pthread_mutex_init): Set valid flag. + (pthread_mutex_destroy): Clear valid flag. + (pthread_mutex_lock): Check and handle the valid flag. + (pthread_mutex_unlock): Likewise. + (pthread_mutex_trylock): Likewise. + + * tests/mutex3.c: New file; test for the static initialisation + macro. Passes. + + * tests/create1.c: New file; test pthread_create(). Passes. + + * tests/equal.c: Poor test; remove. + + * tests/equal1.c New file; test pthread_equal(). Passes. + + * tests/once1.c: New file; test for pthread_once(). Passes. + + * tests/self.c: Remove; rename to self1.c. + + * tests/self1.c: This is the old self.c. + + * tests/self2.c: New file. Test pthread_self() with a single + thread. Passes. + + * tests/self3.c: New file. Test pthread_self() with a couple of + threads to ensure their thread IDs differ. Passes. + +1998-10-04 Ben Elliston + + * tests/mutex2.c: Test pthread_mutex_trylock(). Passes. + + * tests/mutex1.c: New basic test for mutex functions (it passes). + (main): Eliminate warning. + + * configure.in: Test for __stdcall, not _stdcall. Typo. + + * configure: Regenerate. + + * attr.c (pthread_attr_setstackaddr): Remove FIXME comment. Win32 + does know about ENOSYS after all. + (pthread_attr_setstackaddr): Likewise. + +1998-10-03 Ben Elliston + + * configure.in: Test for the `_stdcall' keyword. Define `STDCALL' + to `_stdcall' if we have it, null otherwise. + + * configure: Regenerate. + + * acconfig.h (STDCALL): New define. + + * config.h.in: Regenerate. + + * create.c (ptw32_start_call): Add STDCALL prefix. + + * mutex.c (pthread_mutex_init): Correct function signature. + + * attr.c (pthread_attr_init): Only zero out the `sigmask' member + if we have the sigset_t type. + + * pthread.h: No need to include . It doesn't even exist + on Win32! Again, an artifact of cross-compilation. + (pthread_sigmask): Only provide if we have the sigset_t type. + + * process.h: Remove. This was a stand-in before we started doing + native compilation under Win32. + + * pthread.h (pthread_mutex_init): Make `attr' argument const. + +1998-10-02 Ben Elliston + + * COPYING: Remove. + + * COPYING.LIB: Add. This library is under the LGPL. + +1998-09-13 Ben Elliston + + * configure.in: Test for required system features. + + * configure: Generate. + + * acconfig.h: New file. + + * config.h.in: Generate. + + * Makefile.in: Renamed from Makefile. + + * COPYING: Import from a recent GNU package. + + * config.guess: Likewise. + + * config.sub: Likewise. + + * install-sh: Likewise. + + * config.h: Remove. + + * Makefile: Likewise. + +1998-09-12 Ben Elliston + + * windows.h: No longer needed; remove. + + * windows.c: Likewise. + +Sat Sep 12 20:09:24 1998 Ross Johnson + + * windows.h: Remove error number definitions. These are in + + * tsd.c: Add comment explaining rationale for not building + POSIX TSD on top of Win32 TLS. + +1998-09-12 Ben Elliston + + * {most}.c: Include to get POSIX error values. + + * signal.c (pthread_sigmask): Only provide if HAVE_SIGSET_T is + defined. + + * config.h: #undef features, don't #define them. This will be + generated by autoconf very soon. + +1998-08-11 Ben Elliston + + * Makefile (LIB): Define. + (clean): Define target. + (all): Build a library not just the object files. + + * pthread.h: Provide a definition for struct timespec if we don't + already have one. + + * windows.c (TlsGetValue): Bug fix. + +Thu Aug 6 15:19:22 1998 Ross Johnson + + * misc.c (pthread_once): Fix arg 1 of EnterCriticalSection() + and LeaveCriticalSection() calls to pass address-of lock. + + * fork.c (pthread_atfork): Typecast (void (*)(void *)) funcptr + in each ptw32_handler_push() call. + + * exit.c (ptw32_exit): Fix attr arg in + pthread_attr_getdetachstate() call. + + * private.c (ptw32_new_thread): Typecast (HANDLE) NULL. + (ptw32_delete_thread): Ditto. + + * implement.h: (PTW32_MAX_THREADS): Add define. This keeps + changing in an attempt to make thread administration data types + opaque and cleanup DLL startup. + + * dll.c (PthreadsEntryPoint): + (ptw32_virgins): Remove malloc() and free() calls. + (ptw32_reuse): Ditto. + (ptw32_win32handle_map): Ditto. + (ptw32_threads_mutex_table): Ditto. + + * global.c (_POSIX_THREAD_THREADS_MAX): Initialise with + PTW32_MAX_THREADS. + (ptw32_virgins): Ditto. + (ptw32_reuse): Ditto. + (ptw32_win32handle_map): Ditto. + (ptw32_threads_mutex_table): Ditto. + + * create.c (pthread_create): Typecast (HANDLE) NULL. + Typecast (unsigned (*)(void *)) start_routine. + + * condvar.c (pthread_cond_init): Add address-of operator & to + arg 1 of pthread_mutex_init() call. + (pthread_cond_destroy): Add address-of operator & to + arg 1 of pthread_mutex_destroy() call. + + * cleanup.c (ptw32_destructor_pop_all): Add (int) cast to + pthread_getspecific() arg. + (ptw32_destructor_pop): Add (void *) cast to "if" conditional. + (ptw32_destructor_push): Add (void *) cast to + ptw32_handler_push() "key" arg. + (malloc.h): Add include. + + * implement.h (ptw32_destructor_pop): Add prototype. + + * tsd.c (implement.h): Add include. + + * sync.c (pthread_join): Remove target_thread_mutex and it's + initialisation. Rename getdetachedstate to getdetachstate. + Remove unused variable "exitcode". + (pthread_detach): Remove target_thread_mutex and it's + initialisation. Rename getdetachedstate to getdetachstate. + Rename setdetachedstate to setdetachstate. + + * signal.c (pthread_sigmask): Rename SIG_SET to SIG_SETMASK. + Cast "set" to (long *) in assignment to passify compiler warning. + Add address-of operator & to thread->attr.sigmask in memcpy() call + and assignment. + (pthread_sigmask): Add address-of operator & to thread->attr.sigmask + in memcpy() call and assignment. + + * windows.h (THREAD_PRIORITY_ERROR_RETURN): Add. + (THREAD_PRIORITY_LOWEST): Add. + (THREAD_PRIORITY_HIGHEST): Add. + + * sched.c (is_attr): Add function. + (implement.h): Add include. + (pthread_setschedparam): Rename all instances of "sched_policy" + to "sched_priority". + (pthread_getschedparam): Ditto. + +Tue Aug 4 16:57:58 1998 Ross Johnson + + * private.c (ptw32_delete_thread): Fix typo. Add missing ';'. + + * global.c (ptw32_virgins): Change types from pointer to + array pointer. + (ptw32_reuse): Ditto. + (ptw32_win32handle_map): Ditto. + (ptw32_threads_mutex_table): Ditto. + + * implement.h(ptw32_virgins): Change types from pointer to + array pointer. + (ptw32_reuse): Ditto. + (ptw32_win32handle_map): Ditto. + (ptw32_threads_mutex_table): Ditto. + + * private.c (ptw32_delete_thread): Fix "entry" should be "thread". + + * misc.c (pthread_self): Add extern for ptw32_threadID_TlsIndex. + + * global.c: Add comment. + + * misc.c (pthread_once): Fix member -> dereferences. + Change ptw32_once_flag to once_control->flag in "if" test. + +Tue Aug 4 00:09:30 1998 Ross Johnson + + * implement.h(ptw32_virgins): Add extern. + (ptw32_virgin_next): Ditto. + (ptw32_reuse): Ditto. + (ptw32_reuse_top): Ditto. + (ptw32_win32handle_map): Ditto. + (ptw32_threads_mutex_table): Ditto. + + * global.c (ptw32_virgins): Changed from array to pointer. + Storage allocation for the array moved into dll.c. + (ptw32_reuse): Ditto. + (ptw32_win32handle_map): Ditto. + (ptw32_threads_mutex_table): Ditto. + + * dll.c (PthreadsEntryPoint): Set up thread admin storage when + DLL is loaded. + + * fork.c (pthread_atfork): Fix function pointer arg to all + ptw32_handler_push() calls. Change "arg" arg to NULL in child push. + + * exit.c: Add windows.h and process.h includes. + (ptw32_exit): Add local detachstate declaration. + (ptw32_exit): Fix incorrect name for pthread_attr_getdetachstate(). + + * pthread.h (_POSIX_THREAD_ATTR_STACKSIZE): Move from global.c + (_POSIX_THREAD_ATTR_STACKADDR): Ditto. + + * create.c (pthread_create): Fix #if should be #ifdef. + (ptw32_start_call): Remove usused variables. + + * process.h: Create. + + * windows.h: Move _beginthreadex and _endthreadex into + process.h + +Mon Aug 3 21:19:57 1998 Ross Johnson + + * condvar.c (pthread_cond_init): Add NULL attr to + pthread_mutex_init() call - default attributes will be used. + (cond_wait): Fix typo. + (cond_wait): Fix typo - cv was ev. + (pthread_cond_broadcast): Fix two identical typos. + + * cleanup.c (ptw32_destructor_pop_all): Remove _ prefix from + PTHREAD_DESTRUCTOR_ITERATIONS. + + * pthread.h: Move _POSIX_* values into posix.h + + * pthread.h: Fix typo in pthread_mutex_init() prototype. + + * attr.c (pthread_attr_init): Fix error in priority member init. + + * windows.h (THREAD_PRIORITY_NORMAL): Add. + + * pthread.h (sched_param): Add missing ';' to struct definition. + + * attr.c (pthread_attr_init): Remove obsolete pthread_attr_t + member initialisation - cancelstate, canceltype, cancel_pending. + (is_attr): Make arg "attr" a const. + + * implement.h (PTW32_HANDLER_POP_LIFO): Remove definition. + (PTW32_HANDLER_POP_FIFO): Ditto. + (PTW32_VALID): Add missing newline escape (\). + (ptw32_handler_node): Make element "next" a pointer. + +1998-08-02 Ben Elliston + + * windows.h: Remove duplicate TlsSetValue() prototype. Add + TlsGetValue() prototype. + (FALSE): Define. + (TRUE): Likewise. + Add forgotten errno values. Guard against multiple #includes. + + * windows.c: New file. Implement stubs for Win32 functions. + + * Makefile (SRCS): Remove. Not explicitly needed. + (CFLAGS): Add -Wall for all warnings with GCC. + +Sun Aug 2 19:03:42 1998 Ross Johnson + + * config.h: Create. This is a temporary stand-in for autoconf yet + to be done. + (HAVE_SIGNAL_H): Add. + + * pthread.h: Minor rearrangement for temporary config.h. + +Fri Jul 31 14:00:29 1998 Ross Johnson + + * cleanup.c (ptw32_destructor_pop): Implement. Removes + destructors associated with a key without executing them. + (ptw32_destructor_pop_all): Add FIXME comment. + + * tsd.c (pthread_key_delete): Add call to ptw32_destructor_pop(). + +Fri Jul 31 00:05:45 1998 Ross Johnson + + * tsd.c (pthread_key_create): Update to properly associate + the destructor routine with the key. + (pthread_key_delete): Add FIXME comment. + + * exit.c (ptw32_vacuum): Add call to + ptw32_destructor_pop_all(). + + * implement.h (ptw32_handler_pop_all): Add prototype. + (ptw32_destructor_pop_all): Ditto. + + * cleanup.c (ptw32_destructor_push): Implement. This is just a + call to ptw32_handler_push(). + (ptw32_destructor_pop_all): Implement. This is significantly + different to ptw32_handler_pop_all(). + + * Makefile (SRCS): Create. Preliminary. + + * windows.h: Create. Contains Win32 definitions for compile + testing. This is just a standin for the real one. + + * pthread.h (SIG_UNBLOCK): Fix typo. Was SIG_BLOCK. + (windows.h): Add include. Required for CRITICAL_SECTION. + (pthread_cond_t): Move enum declaration outside of struct + definition. + (unistd.h): Add include - may be temporary. + + * condvar.c (windows.h): Add include. + + * implement.h (PTW32_THIS): Remove - no longer required. + (PTW32_STACK): Use pthread_self() instead of PTW32_THIS. + +Thu Jul 30 23:12:45 1998 Ross Johnson + + * implement.h: Remove ptw32_find_entry() prototype. + + * private.c: Extend comments. + Remove ptw32_find_entry() - no longer needed. + + * create.c (ptw32_start_call): Add call to TlsSetValue() to + store the thread ID. + + * dll.c (PthreadsEntryPoint): Implement. This is called + whenever a process loads the DLL. Used to initialise thread + local storage. + + * implement.h: Add ptw32_threadID_TlsIndex. + Add ()s around PTW32_VALID expression. + + * misc.c (pthread_self): Re-implement using Win32 TLS to store + the threads own ID. + +Wed Jul 29 11:39:03 1998 Ross Johnson + + * private.c: Corrections in comments. + (ptw32_new_thread): Alter "if" flow to be more natural. + + * cleanup.c (ptw32_handler_push): Same as below. + + * create.c (pthread_create): Same as below. + + * private.c (ptw32_new_thread): Rename "new" to "new_thread". + Since when has a C programmer been required to know C++? + +Tue Jul 28 14:04:29 1998 Ross Johnson + + * implement.h: Add PTW32_VALID macro. + + * sync.c (pthread_join): Modify to use the new thread + type and ptw32_delete_thread(). Rename "target" to "thread". + Remove extra local variable "target". + (pthread_detach): Ditto. + + * signal.c (pthread_sigmask): Move init of "us" out of inner block. + Fix instance of "this" should have been "us". Rename "us" to "thread". + + * sched.c (pthread_setschedparam): Modify to use the new thread + type. + (pthread_getschedparam): Ditto. + + * private.c (ptw32_find_thread): Fix return type and arg. + + * implement.h: Remove PTW32_YES and PTW32_NO. + (ptw32_new_thread): Add prototype. + (ptw32_find_thread): Ditto. + (ptw32_delete_thread): Ditto. + (ptw32_new_thread_entry): Remove prototype. + (ptw32_find_thread_entry): Ditto. + (ptw32_delete_thread_entry): Ditto. + ( PTW32_NEW, PTW32_INUSE, PTW32_EXITED, PTW32_REUSE): + Add. + + + * create.c (pthread_create): Minor rename "us" to "new" (I need + these cues but it doesn't stop me coming out with some major bugs + at times). + Load start_routine and arg into the thread so the wrapper can + call it. + + * exit.c (pthread_exit): Fix pthread_this should be pthread_self. + + * cancel.c (pthread_setcancelstate): Change + ptw32_threads_thread_t * to pthread_t and init with + pthread_this(). + (pthread_setcanceltype): Ditto. + + * exit.c (ptw32_exit): Add new pthread_t arg. + Rename ptw32_delete_thread_entry to ptw32_delete_thread. + Rename "us" to "thread". + (pthread_exit): Call ptw32_exit with added thread arg. + + * create.c (ptw32_start_call): Insert missing ")". + Add "us" arg to ptw32_exit() call. + (pthread_create): Modify to use new thread allocation scheme. + + * private.c: Added detailed explanation of the new thread + allocation scheme. + (ptw32_new_thread): Totally rewritten to use + new thread allocation scheme. + (ptw32_delete_thread): Ditto. + (ptw32_find_thread): Obsolete. + +Mon Jul 27 17:46:37 1998 Ross Johnson + + * create.c (pthread_create): Start of rewrite. Not completed yet. + + * private.c (ptw32_new_thread_entry): Start of rewrite. Not + complete. + + * implement.h (ptw32_threads_thread): Rename, remove thread + member, add win32handle and ptstatus members. + (ptw32_t): Add. + + * pthread.h: pthread_t is no longer mapped directly to a Win32 + HANDLE type. This is so we can let the Win32 thread terminate and + reuse the HANDLE while pthreads holds it's own thread ID until + the last waiting join exits. + +Mon Jul 27 00:20:37 1998 Ross Johnson + + * private.c (ptw32_delete_thread_entry): Destroy the thread + entry attribute object before deleting the thread entry itself. + + * attr.c (pthread_attr_init): Initialise cancel_pending = FALSE. + (pthread_attr_setdetachstate): Rename "detached" to "detachedstate". + (pthread_attr_getdetachstate): Ditto. + + * exit.c (ptw32_exit): Fix incorrect check for detachedstate. + + * implement.h (ptw32_call_t): Remove env member. + +Sun Jul 26 13:06:12 1998 Ross Johnson + + * implement.h (ptw32_new_thread_entry): Fix prototype. + (ptw32_find_thread_entry): Ditto. + (ptw32_delete_thread_entry): Ditto. + (ptw32_exit): Add prototype. + + * exit.c (ptw32_exit): New function. Called from pthread_exit() + and ptw32_start_call() to exit the thread. It allows an extra + argument which is the return code passed to _endthreadex(). + (ptw32_exit): Move thread entry delete call from ptw32_vacuum() + into here. Add more explanation of thread entry deletion. + (ptw32_exit): Clarify comment. + + * create.c (ptw32_start_call): Change pthread_exit() call to + ptw32_exit() call. + + * exit.c (ptw32_vacuum): Add thread entry deletion code + moved from ptw32_start_call(). See next item. + (pthread_exit): Remove longjmp(). Add mutex lock around thread table + manipulation code. This routine now calls _enthreadex(). + + * create.c (ptw32_start_call): Remove setjmp() call and move + cleanup code out. Call pthread_exit(NULL) to terminate the thread. + +1998-07-26 Ben Elliston + + * tsd.c (pthread_getspecific): Update comments. + + * mutex.c (pthread_mutexattr_setpshared): Not supported; remove. + (pthread_mutexattr_getpshared): Likewise. + + * pthread.h (pthread_mutexattr_setpshared): Remove prototype. + (pthread_mutexattr_getpshared): Likewise. + +Sun Jul 26 00:09:59 1998 Ross Johnson + + * sync.c: Rename all instances of ptw32_count_mutex to + ptw32_table_mutex. + + * implement.h: Rename ptw32_count_mutex to + ptw32_table_mutex. + + * global.c: Rename ptw32_count_mutex to + ptw32_table_mutex. + + * create.c (pthread_create): Add critical sections. + (ptw32_start_call): Rename ptw32_count_mutex to + ptw32_table_mutex. + + * cancel.c (pthread_setcancelstate): Fix indirection bug and rename + "this" to "us". + + * signal.c (pthread_sigmask): Rename "this" to "us" and fix some + minor syntax errors. Declare "us" and initialise it. + + * sync.c (pthread_detach): Rename "this" to "target". + + * pthread.h: Converting PTHREAD_* defines to alias the (const int) + values in global.c. + + * global.c: Started converting PTHREAD_* defines to (const int) as + a part of making the eventual pthreads DLL binary compatible + through version changes. + + * condvar.c (cond_wait): Add cancelation point. This applies the + point to both pthread_cond_wait() and pthread_cond_timedwait(). + + * exit.c (pthread_exit): Rename "this" to "us". + + * implement.h: Add comment. + + * sync.c (pthread_join): I've satisfied myself that pthread_detach() + does set the detached attribute in the thread entry attributes + to PTHREAD_CREATE_DETACHED. "if" conditions were changed to test + that attribute instead of a separate flag. + + * create.c (pthread_create): Rename "this" to "us". + (pthread_create): cancelstate and canceltype are not attributes + so the copy to thread entry attribute storage was removed. + Only the thread itself can change it's cancelstate or canceltype, + ie. the thread must exist already. + + * private.c (ptw32_delete_thread_entry): Mutex locks removed. + Mutexes must be applied at the caller level. + (ptw32_new_thread_entry): Ditto. + (ptw32_new_thread_entry): Init cancelstate, canceltype, and + cancel_pending to default values. + (ptw32_new_thread_entry): Rename "this" to "new". + (ptw32_find_thread_entry): Rename "this" to "entry". + (ptw32_delete_thread_entry): Rename "thread_entry" to "entry". + + * create.c (ptw32_start_call): Mutexes changed to + ptw32_count_mutex. All access to the threads table entries is + under the one mutex. Otherwise chaos reigns. + +Sat Jul 25 23:16:51 1998 Ross Johnson + + * implement.h (ptw32_threads_thread): Move cancelstate and + canceltype members out of pthread_attr_t into here. + + * fork.c (fork): Add comment. + +1998-07-25 Ben Elliston + + * fork.c (fork): Autoconfiscate. + +Sat Jul 25 00:00:13 1998 Ross Johnson + + * create.c (ptw32_start_call): Set thread priority. Ensure our + thread entry is removed from the thread table but only if + pthread_detach() was called and there are no waiting joins. + (pthread_create): Set detach flag in thread entry if the + thread is created PTHREAD_CREATE_DETACHED. + + * pthread.h (pthread_attr_t): Rename member "detachedstate". + + * attr.c (pthread_attr_init): Rename attr members. + + * exit.c (pthread_exit): Fix indirection mistake. + + * implement.h (PTW32_THREADS_TABLE_INDEX): Add. + + * exit.c (ptw32_vacuum): Fix incorrect args to + ptw32_handler_pop_all() calls. + Make thread entry removal conditional. + + * sync.c (pthread_join): Add multiple join and async detach handling. + + * implement.h (PTW32_THREADS_TABLE_INDEX): Add. + + * global.c (ptw32_threads_mutex_table): Add. + + * implement.h (ptw32_once_flag): Remove. + (ptw32_once_lock): Ditto. + (ptw32_threads_mutex_table): Add. + + * global.c (ptw32_once_flag): Remove. + (ptw32_once_lock): Ditto. + + * sync.c (pthread_join): Fix tests involving new return value + from ptw32_find_thread_entry(). + (pthread_detach): Ditto. + + * private.c (ptw32_find_thread_entry): Failure return code + changed from -1 to NULL. + +Fri Jul 24 23:09:33 1998 Ross Johnson + + * create.c (pthread_create): Change . to -> in sigmask memcpy() args. + + * pthread.h: (pthread_cancel): Add function prototype. + (pthread_testcancel): Ditto. + +1998-07-24 Ben Elliston + + * pthread.h (pthread_condattr_t): Rename dummy structure member. + (pthread_mutexattr_t): Likewise. + +Fri Jul 24 21:13:55 1998 Ross Johnson + + * cancel.c (pthread_cancel): Implement. + (pthread_testcancel): Implement. + + * exit.c (pthread_exit): Add comment explaining the longjmp(). + + * implement.h (ptw32_threads_thread_t): New member cancelthread. + (PTW32_YES): Define. + (PTW32_NO): Define. + (RND_SIZEOF): Remove. + + * create.c (pthread_create): Rename cancelability to cancelstate. + + * pthread.h (pthread_attr_t): Rename cancelability to cancelstate. + (PTHREAD_CANCELED): Define. + +1998-07-24 Ben Elliston + + * pthread.h (SIG_BLOCK): Define if not already defined. + (SIG_UNBLOCK): Likewise. + (SIG_SETMASK): Likewise. + (pthread_attr_t): Add signal mask member. + (pthread_sigmask): Add function prototype. + + * signal.c (pthread_sigmask): Implement. + + * create.c: #include to get a prototype for memcpy(). + (pthread_create): New threads inherit their creator's signal + mask. Copy the signal mask to the new thread structure if we know + about signals. + +Fri Jul 24 16:33:17 1998 Ross Johnson + + * fork.c (pthread_atfork): Add all the necessary push calls. + Local implementation semantics: + If we get an ENOMEM at any time then ALL handlers + (including those from previous pthread_atfork() calls) will be + popped off each of the three atfork stacks before we return. + (fork): Add all the necessary pop calls. Add the thread cancellation + and join calls to the child fork. + Add #includes. + + * implement.h: (ptw32_handler_push): Fix return type and stack arg + type in prototype. + (ptw32_handler_pop): Fix stack arg type in prototype. + (ptw32_handler_pop_all): Fix stack arg type in prototype. + + * cleanup.c (ptw32_handler_push): Change return type to int and + return ENOMEM if malloc() fails. + + * sync.c (pthread_detach): Use equality test, not assignment. + + * create.c (ptw32_start_call): Add call to Win32 CloseHandle() + if thread is detached. + +1998-07-24 Ben Elliston + + * sync.c (pthread_detach): Close the Win32 thread handle to + emulate detached (or daemon) threads. + +Fri Jul 24 03:00:25 1998 Ross Johnson + + * sync.c (pthread_join): Save valueptr arg in joinvalueptr for + pthread_exit() to use. + + * private.c (ptw32_new_thread_entry): Initialise joinvalueptr to + NULL. + + * create.c (ptw32_start_call): Rewrite to facilitate joins. + pthread_exit() will do a longjmp() back to here. Does appropriate + cleanup and exit/return from the thread. + (pthread_create): _beginthreadex() now passes a pointer to our + thread table entry instead of just the call member of that entry. + + * implement.h (ptw32_threads_thread): New member + void ** joinvalueptr. + (ptw32_call_t): New member jmpbuf env. + + * exit.c (pthread_exit): Major rewrite to handle joins and handing + value pointer to joining thread. Uses longjmp() back to + ptw32_start_call(). + + * create.c (pthread_create): Ensure values of new attribute members + are copied to the thread attribute object. + + * attr.c (pthread_attr_destroy): Fix merge conflicts. + (pthread_attr_getdetachstate): Fix merge conflicts. + (pthread_attr_setdetachstate): Fix merge conflicts. + + * pthread.h: Fix merge conflicts. + + * sync.c (pthread_join): Fix merge conflicts. + +Fri Jul 24 00:21:21 1998 Ross Johnson + + * sync.c (pthread_join): Add check for valid and joinable + thread. + (pthread_detach): Implement. After checking for a valid and joinable + thread, it's still a no-op. + + * private.c (ptw32_find_thread_entry): Bug prevented returning + an error value in some cases. + + * attr.c (pthread_attr_setdetachedstate): Implement. + (pthread_attr_getdetachedstate): Implement. + + * implement.h: Move more hidden definitions into here from + pthread.h. + +1998-07-24 Ben Elliston + + * pthread.h (PTHREAD_CREATE_JOINABLE): Define. + (PTHREAD_CREATE_DETACHED): Likewise. + (pthread_attr_t): Add new structure member `detached'. + (pthread_attr_getdetachstate): Add function prototype. + (pthread_attr_setdetachstate): Likewise. + + * sync.c (pthread_join): Return if the target thread is detached. + + * attr.c (pthread_attr_init): Initialise cancelability and + canceltype structure members. + (pthread_attr_getdetachstate): Implement. + (pthread_attr_setdetachstate): Likewise. + + * implement.h (PTW32_CANCEL_DEFAULTS): Remove. Bit fields + proved to be too cumbersome. Set the defaults in attr.c using the + public PTHREAD_CANCEL_* constants. + + * cancel.c: New file. + + * pthread.h (sched_param): Define this type. + (pthread_attr_getschedparam): Add function prototype. + (pthread_attr_setschedparam): Likewise. + (pthread_setcancelstate): Likewise. + (pthread_setcanceltype): Likewise. + (sched_get_priority_min): Likewise. + (sched_get_priority_max): Likewise. + (pthread_mutexattr_setprotocol): Remove; not supported. + (pthread_mutexattr_getprotocol): Likewise. + (pthread_mutexattr_setprioceiling): Likewise. + (pthread_mutexattr_getprioceiling): Likewise. + (pthread_attr_t): Add canceltype member. Update comments. + (SCHED_OTHER): Define this scheduling policy constant. + (SCHED_FIFO): Likewise. + (SCHED_RR): Likewise. + (SCHED_MIN): Define the lowest possible value for this constant. + (SCHED_MAX): Likewise, the maximum possible value. + (PTHREAD_CANCEL_ASYNCHRONOUS): Redefine. + (PTHREAD_CANCEL_DEFERRED): Likewise. + + * sched.c: New file. + (pthread_setschedparam): Implement. + (pthread_getschedparam): Implement. + (sched_get_priority_max): Validate policy argument. + (sched_get_priority_min): Likewise. + + * mutex.c (pthread_mutexattr_setprotocol): Remove; not supported. + (pthread_mutexattr_getprotocol): Likewise. + (pthread_mutexattr_setprioceiling): Likewise. + (pthread_mutexattr_getprioceiling): Likewise. + +Fri Jul 24 00:21:21 1998 Ross Johnson + + * create.c (pthread_create): Arg to ptw32_new_thread_entry() + changed. See next entry. Move mutex locks out. Changes made yesterday + and today allow us to start the new thread running rather than + temporarily suspended. + + * private.c (ptw32_new_thread_entry): ptw32_thread_table + was changed back to a table of thread structures rather than pointers. + As such we're trading storage for increaded speed. This routine + was modified to work with the new table. Mutex lock put in around + global data accesses. + (ptw32_find_thread_entry): Ditto + (ptw32_delete_thread_entry): Ditto + +Thu Jul 23 23:25:30 1998 Ross Johnson + + * global.c: New. Global data objects declared here. These moved from + pthread.h. + + * pthread.h: Move implementation hidden definitions into + implement.h. + + * implement.h: Move implementation hidden definitions from + pthread.h. Add constants to index into the different handler stacks. + + * cleanup.c (ptw32_handler_push): Simplify args. Restructure. + (ptw32_handler_pop): Simplify args. Restructure. + (ptw32_handler_pop_all): Simplify args. Restructure. + +Wed Jul 22 00:16:22 1998 Ross Johnson + + * attr.c, implement.h, pthread.h, ChangeLog: Resolve CVS merge + conflicts. + + * private.c (ptw32_find_thread_entry): Changes to return type + to support leaner ptw32_threads_table[] which now only stores + ptw32_thread_thread_t *. + (ptw32_new_thread_entry): Internal changes. + (ptw32_delete_thread_entry): Internal changes to avoid contention. + Calling routines changed accordingly. + + * pthread.h: Modified cleanup macros to use new generic push and pop. + Added destructor and atfork stacks to ptw32_threads_thread_t. + + * cleanup.c (ptw32_handler_push, ptw32_handler_pop, + ptw32_handler_pop_all): Renamed cleanup push and pop routines + and made generic to handle destructors and atfork handlers as + well. + + * create.c (ptw32_start_call): New function is a wrapper for + all new threads. It allows us to do some cleanup when the thread + returns, ie. that is otherwise only done if the thread is cancelled. + + * exit.c (ptw32_vacuum): New function contains code from + pthread_exit() that we need in the new ptw32_start_call() + as well. + + * implement.h: Various additions and minor changes. + + * pthread.h: Various additions and minor changes. + Change cleanup handler macros to use generic handler push and pop + functions. + + * attr.c: Minor mods to all functions. + (is_attr): Implemented missing function. + + * create.c (pthread_create): More clean up. + + * private.c (ptw32_find_thread_entry): Implement. + (ptw32_delete_thread_entry): Implement. + (ptw32_new_thread_entry): Implement. + These functions manipulate the implementations internal thread + table and are part of general code cleanup and modularisation. + They replace ptw32_getthreadindex() which was removed. + + * exit.c (pthread_exit): Changed to use the new code above. + + * pthread.h: Add cancelability constants. Update comments. + +1998-07-22 Ben Elliston + + * attr.c (pthread_setstacksize): Update test of attr argument. + (pthread_getstacksize): Likewise. + (pthread_setstackaddr): Likewise. + (pthread_getstackaddr): Likewise. + (pthread_attr_init): No need to allocate any storage. + (pthread_attr_destroy): No need to free any storage. + + * mutex.c (is_attr): Not likely to be needed; remove. + (remove_attr): Likewise. + (insert_attr): Likewise. + + * implement.h (ptw32_mutexattr_t): Moved to a public definition + in pthread.h. There was little gain in hiding these details. + (ptw32_condattr_t): Likewise. + (ptw32_attr_t): Likewise. + + * pthread.h (pthread_atfork): Add function prototype. + (pthread_attr_t): Moved here from implement.h. + + * fork.c (pthread_atfork): Preliminary implementation. + (ptw32_fork): Likewise. + +Wed Jul 22 00:16:22 1998 Ross Johnson + + * cleanup.c (ptw32_cleanup_push): Implement. + (ptw32_cleanup_pop): Implement. + (ptw32_do_cancellation): Implement. + These are private to the implementation. The real cleanup functions + are macros. See below. + + * pthread.h (pthread_cleanup_push): Implement as a macro. + (pthread_cleanup_pop): Implement as a macro. + Because these are macros which start and end a block, the POSIX scoping + requirement is observed. See the comment in the file. + + * exit.c (pthread_exit): Refine the code. + + * create.c (pthread_create): Code cleanup. + + * implement.h (RND_SIZEOF): Add RND_SIZEOF(T) to round sizeof(T) + up to multiple of DWORD. + Add function prototypes. + + * private.c (ptw32_getthreadindex): "*thread" should have been + "thread". Detect empty slot fail condition. + +1998-07-20 Ben Elliston + + * misc.c (pthread_once): Implement. Don't use a per-application + flag and mutex--make `pthread_once_t' contain these elements in + their structure. The earlier version had incorrect semantics. + + * pthread.h (ptw32_once_flag): Add new variable. Remove. + (ptw32_once_lock): Add new mutex lock to ensure integrity of + access to ptw32_once_flag. Remove. + (pthread_once): Add function prototype. + (pthread_once_t): Define this type. + +Mon Jul 20 02:31:05 1998 Ross Johnson + + * private.c (ptw32_getthreadindex): Implement. + + * pthread.h: Add application static data dependent on + _PTHREADS_BUILD_DLL define. This is needed to avoid allocating + non-sharable static data within the pthread DLL. + + * implement.h: Add ptw32_cleanup_stack_t, ptw32_cleanup_node_t + and PTW32_HASH_INDEX. + + * exit.c (pthread_exit): Begin work on cleanup and de-allocate + thread-private storage. + + * create.c (pthread_create): Add thread to thread table. + Keep a thread-private copy of the attributes with default values + filled in when necessary. Same for the cleanup stack. Make + pthread_create C run-time library friendly by using _beginthreadex() + instead of CreateThread(). Fix error returns. + +Sun Jul 19 16:26:23 1998 Ross Johnson + + * implement.h: Rename pthreads_thread_count to ptw32_threads_count. + Create ptw32_threads_thread_t struct to keep thread specific data. + + * create.c: Rename pthreads_thread_count to ptw32_threads_count. + (pthread_create): Handle errors from CreateThread(). + +1998-07-19 Ben Elliston + + * condvar.c (pthread_cond_wait): Generalise. Moved from here .. + (cond_wait): To here. + (pthread_cond_timedwait): Implement; use generalised cond_wait(). + + * pthread.h (pthread_key_t): Define this type. + (pthread_key_create): Add function prototype. + (pthread_setspecific): Likewise. + (pthread_getspecific): Likwise. + (pthread_key_delete): Likewise. + + * tsd.c (pthread_key_create): Implement. + (pthread_setspecific): Likewise. + (pthread_getspecific): Likewise. + (pthread_key_delete): Likewise. + + * mutex.c (pthread_mutex_trylock): Return ENOSYS if this function + is called on a Win32 platform which is not Windows NT. + +1998-07-18 Ben Elliston + + * condvar.c (pthread_condattr_init): Do not attempt to malloc any + storage; none is needed now that condattr_t is an empty struct. + (pthread_condattr_destory): Likewise; do not free storage. + (pthread_condattr_setpshared): No longer supported; return ENOSYS. + (pthread_condattr_getpshared): Likewise. + (pthread_cond_init): Implement with help from Douglas Schmidt. + Remember to initialise the cv's internal mutex. + (pthread_cond_wait): Likewise. + (pthread_cond_signal): Likewise. + (pthread_cond_broadcast): Likewise. + (pthread_cond_timedwait): Preliminary implementation, but I need + to see some API documentation for `WaitForMultipleObject'. + (pthread_destory): Implement. + + * pthread.h (pthread_cond_init): Add function protoype. + (pthread_cond_broadcast): Likewise. + (pthread_cond_signal): Likewise. + (pthread_cond_timedwait): Likewise. + (pthread_cond_wait): Likewise. + (pthread_cond_destroy): Likewise. + (pthread_cond_t): Define this type. Fix for u_int. Do not assume + that the mutex contained withing the pthread_cond_t structure will + be a critical section. Use our new POSIX type! + + * implement.h (ptw32_condattr_t): Remove shared attribute. + +1998-07-17 Ben Elliston + + * pthread.h (PTHREADS_PROCESS_PRIVATE): Remove. + (PTHREAD_PROCESS_SHARED): Likewise. No support for mutexes shared + across processes for now. + (pthread_mutex_t): Use a Win32 CRITICAL_SECTION type for better + performance. + + * implement.h (ptw32_mutexattr_t): Remove shared attribute. + + * mutex.c (pthread_mutexattr_setpshared): This optional function + is no longer supported, since we want to implement POSIX mutex + variables using the much more efficient Win32 critical section + primitives. Critical section objects in Win32 cannot be shared + between processes. + (pthread_mutexattr_getpshared): Likewise. + (pthread_mutexattr_init): No need to malloc any storage; the + attributes structure is now empty. + (pthread_mutexattr_destroy): This is now a nop. + (pthread_mutex_init): Use InitializeCriticalSection(). + (pthread_mutex_destroy): Use DeleteCriticalSection(). + (pthread_mutex_lock): Use EnterCriticalSection(). + (pthread_mutex_trylock): Use TryEnterCriticalSection(). This is + not supported by Windows 9x, but trylock is a hack anyway, IMHO. + (pthread_mutex_unlock): Use LeaveCriticalSection(). + +1998-07-14 Ben Elliston + + * attr.c (pthread_attr_setstacksize): Implement. + (pthread_attr_getstacksize): Likewise. + (pthread_attr_setstackaddr): Likewise. + (pthread_attr_getstackaddr): Likewise. + (pthread_attr_init): Likewise. + (pthread_attr_destroy): Likewise. + + * condvar.c (pthread_condattr_init): Add `_cond' to function name. + + * mutex.c (pthread_mutex_lock): Add `_mutex' to function name. + (pthread_mutex_trylock): Likewise. + (pthread_mutex_unlock): Likewise. + + * pthread.h (pthread_condattr_setpshared): Fix typo. + (pthread_attr_init): Add function prototype. + (pthread_attr_destroy): Likewise. + (pthread_attr_setstacksize): Likewise. + (pthread_attr_getstacksize): Likewise. + (pthread_attr_setstackaddr): Likewise. + (pthread_attr_getstackaddr): Likewise. + +Mon Jul 13 01:09:55 1998 Ross Johnson + + * implement.h: Wrap in #ifndef _IMPLEMENT_H + + * create.c (pthread_create): Map stacksize attr to Win32. + + * mutex.c: Include implement.h + +1998-07-13 Ben Elliston + + * condvar.c (pthread_condattr_init): Implement. + (pthread_condattr_destroy): Likewise. + (pthread_condattr_setpshared): Likewise. + (pthread_condattr_getpshared): Likewise. + + * implement.h (PTHREAD_THREADS_MAX): Remove trailing semicolon. + (PTHREAD_STACK_MIN): Specify; needs confirming. + (ptw32_attr_t): Define this type. + (ptw32_condattr_t): Likewise. + + * pthread.h (pthread_mutex_t): Define this type. + (pthread_condattr_t): Likewise. + (pthread_mutex_destroy): Add function prototype. + (pthread_lock): Likewise. + (pthread_trylock): Likewise. + (pthread_unlock): Likewise. + (pthread_condattr_init): Likewise. + (pthread_condattr_destroy): Likewise. + (pthread_condattr_setpshared): Likewise. + (pthread_condattr_getpshared): Likewise. + + * mutex.c (pthread_mutex_init): Implement. + (pthread_mutex_destroy): Likewise. + (pthread_lock): Likewise. + (pthread_trylock): Likewise. + (pthread_unlock): Likewise. + +1998-07-12 Ben Elliston + + * implement.h (ptw32_mutexattr_t): Define this implementation + internal type. Application programmers only see a mutex attribute + object as a void pointer. + + * pthread.h (pthread_mutexattr_t): Define this type. + (pthread_mutexattr_init): Add function prototype. + (pthread_mutexattr_destroy): Likewise. + (pthread_mutexattr_setpshared): Likewise. + (pthread_mutexattr_getpshared): Likewise. + (pthread_mutexattr_setprotocol): Likewise. + (pthread_mutexattr_getprotocol): Likewise. + (pthread_mutexattr_setprioceiling): Likewise. + (pthread_mutexattr_getprioceiling): Likewise. + (PTHREAD_PROCESS_PRIVATE): Define. + (PTHREAD_PROCESS_SHARED): Define. + + * mutex.c (pthread_mutexattr_init): Implement. + (pthread_mutexattr_destroy): Implement. + (pthread_mutexattr_setprotocol): Implement. + (pthread_mutexattr_getprotocol): Likewise. + (pthread_mutexattr_setprioceiling): Likewise. + (pthread_mutexattr_getprioceiling): Likewise. + (pthread_mutexattr_setpshared): Likewise. + (pthread_mutexattr_getpshared): Likewise. + (insert_attr): New function; very preliminary implementation! + (is_attr): Likewise. + (remove_attr): Likewise. + +Sat Jul 11 14:48:54 1998 Ross Johnson + + * implement.h: Preliminary implementation specific defines. + + * create.c (pthread_create): Preliminary implementation. + +1998-07-11 Ben Elliston + + * sync.c (pthread_join): Implement. + + * misc.c (pthread_equal): Likewise. + + * pthread.h (pthread_join): Add function prototype. + (pthread_equal): Likewise. + +1998-07-10 Ben Elliston + + * misc.c (pthread_self): Implement. + + * exit.c (pthread_exit): Implement. + + * pthread.h (pthread_exit): Add function prototype. + (pthread_self): Likewise. + (pthread_t): Define this type. + +1998-07-09 Ben Elliston + + * create.c (pthread_create): A dummy stub right now. + + * pthread.h (pthread_create): Add function prototype. diff --git a/external/pthreads-w32/FAQ b/external/pthreads-w32/FAQ new file mode 100644 index 00000000..d7399c3e --- /dev/null +++ b/external/pthreads-w32/FAQ @@ -0,0 +1,451 @@ + ========================================= + PTHREADS-WIN32 Frequently Asked Questions + ========================================= + +INDEX +----- + +Q 1 What is it? + +Q 2 Which of the several dll versions do I use? + or, + What are all these pthread*.dll and pthread*.lib files? + +Q 3 What is the library naming convention? + +Q 4 Cleanup code default style or: it used to work when I built + the library myself, but now it doesn't - why? + +Q 5 Why is the default library version now less exception-friendly? + +Q 6 Should I use Cygwin or Mingw32 as a development environment? + +Q 7 Now that pthreads-win32 builds under Mingw32, why do I get + memory access violations (segfaults)? + +Q 8 How do I use pthread.dll for Win32 (Visual C++ 5.0) + +Q 9 Cancelation doesn't work for me, why? + +Q 10 How do I generate pthreadGCE.dll and libpthreadw32.a for use + with Mingw32? + +Q 11 Why isn't pthread_t defined as a scalar (e.g. pointer or int) + like it is for other POSIX threads implementations? + +============================================================================= + +Q 1 What is it? +--- + +Pthreads-win32 is an Open Source Software 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. The library also supports +some of the functionality of the Open Group's Single Unix +specification, version 2, namely mutex types. + +See the file "ANNOUNCE" for more information including standards +conformance details and list of supported routines. + + +------------------------------------------------------------------------------ + +Q 2 Which of the several dll versions do I use? +--- or, + What are all these pthread*.dll and pthread*.lib files? + +Simply, you only use one of them, but you need to choose carefully. + +The most important choice you need to make is whether to use a +version that uses exceptions internally, or not (there are versions +of the library that use exceptions as part of the thread +cancelation and cleanup implementation, and one that uses +setjmp/longjmp instead). + +There is some contension amongst POSIX threads experts as +to how POSIX threads cancelation and exit should work +with languages that include exceptions and handlers, e.g. +C++ and even C (Microsoft's Structured Exceptions). + +The issue is: should cancelation of a thread in, say, +a C++ application cause object destructors and C++ exception +handlers to be invoked as the stack unwinds during thread +exit, or not? + +There seems to be more opinion in favour of using the +standard C version of the library (no EH) with C++ applications +since this appears to be the assumption commercial pthreads +implementations make. Therefore, if you use an EH version +of pthreads-win32 then you may be under the illusion that +your application will be portable, when in fact it is likely to +behave very differently linked with other pthreads libraries. + +Now you may be asking: why have you kept the EH versions of +the library? + +There are a couple of reasons: +- there is division amongst the experts and so the code may + be needed in the future. (Yes, it's in the repository and we + can get it out anytime in the future, but ...) +- pthreads-win32 is one of the few implementations, and possibly + the only freely available one, that has EH versions. It may be + useful to people who want to play with or study application + behaviour under these conditions. + + +------------------------------------------------------------------------------ + +Q 3 What is the library naming convention? +--- + +Because the library is being built using various exception +handling schemes and compilers - and because the library +may not work reliably if these are mixed in an application, +each different version of the library has it's own name. + +Note 1: the incompatibility is really between EH implementations +of the different compilers. It should be possible to use the +standard C version from either compiler with C++ applications +built with a different compiler. If you use an EH version of +the library, then you must use the same compiler for the +application. This is another complication and dependency that +can be avoided by using only the standard C library version. + +Note 2: if you use a standard C pthread*.dll with a C++ +application, then any functions that you define that are +intended to be called via pthread_cleanup_push() must be +__cdecl. + +Note 3: the intention is to also name either the VC or GC +version (it should be arbitrary) as pthread.dll, including +pthread.lib and libpthread.a as appropriate. + +In general: + pthread[VG]{SE,CE,C}.dll + pthread[VG]{SE,CE,C}.lib + +where: + [VG] indicates the compiler + V - MS VC + G - GNU C + + {SE,CE,C} indicates the exception handling scheme + SE - Structured EH + CE - C++ EH + C - no exceptions - uses setjmp/longjmp + +For example: + pthreadVSE.dll (MSVC/SEH) + pthreadGCE.dll (GNUC/C++ EH) + pthreadGC.dll (GNUC/not dependent on exceptions) + +The GNU library archive file names have changed to: + + libpthreadGCE.a + libpthreadGC.a + + +------------------------------------------------------------------------------ + +Q 4 Cleanup code default style or: it used to work when I built +--- the library myself, but now it doesn't - why? + +Up to and including snapshot 2001-07-12, if not defined, the cleanup +style was determined automatically from the compiler used, and one +of the following was defined accordingly: + + __CLEANUP_SEH MSVC only + __CLEANUP_CXX C++, including MSVC++, GNU G++ + __CLEANUP_C C, including GNU GCC, not MSVC + +These defines determine the style of cleanup (see pthread.h) and, +most importantly, the way that cancelation and thread exit (via +pthread_exit) is performed (see the routine ptw32_throw() in private.c). + +In short, the exceptions versions of the library throw an exception +when a thread is canceled or exits (via pthread_exit()), which is +caught by a handler in the thread startup routine, so that the +the correct stack unwinding occurs regardless of where the thread +is when it's canceled or exits via pthread_exit(). + +After snapshot 2001-07-12, unless your build explicitly defines (e.g. +via a compiler option) __CLEANUP_SEH, __CLEANUP_CXX, or __CLEANUP_C, then +the build now ALWAYS defaults to __CLEANUP_C style cleanup. This style +uses setjmp/longjmp in the cancelation and pthread_exit implementations, +and therefore won't do stack unwinding even when linked to applications +that have it (e.g. C++ apps). This is for consistency with most/all +commercial Unix POSIX threads implementations. + +Although it was not clearly documented before, it is still necessary to +build your application using the same __CLEANUP_* define as was +used for the version of the library that you link with, so that the +correct parts of pthread.h are included. That is, the possible +defines require the following library versions: + + __CLEANUP_SEH pthreadVSE.dll + __CLEANUP_CXX pthreadVCE.dll or pthreadGCE.dll + __CLEANUP_C pthreadVC.dll or pthreadGC.dll + +THE POINT OF ALL THIS IS: if you have not been defining one of these +explicitly, then the defaults have been set according to the compiler +and language you are using, as described at the top of this +section. + +THIS NOW CHANGES, as has been explained above. For example: + +If you were building your application with MSVC++ i.e. using C++ +exceptions (rather than SEH) and not explicitly defining one of +__CLEANUP_*, then __CLEANUP_C++ was defined for you in pthread.h. +You should have been linking with pthreadVCE.dll, which does +stack unwinding. + +If you now build your application as you had before, pthread.h will now +set __CLEANUP_C as the default style, and you will need to link +with pthreadVC.dll. Stack unwinding will now NOT occur when a +thread is canceled, nor when the thread calls pthread_exit(). + +Your application will now most likely behave differently to previous +versions, and in non-obvious ways. Most likely is that local +objects may not be destroyed or cleaned up after a thread +is canceled. + +If you want the same behaviour as before, then you must now define +__CLEANUP_C++ explicitly using a compiler option and link with +pthreadVCE.dll as you did before. + + +------------------------------------------------------------------------------ + +Q 5 Why is the default library version now less exception-friendly? +--- + +Because most commercial Unix POSIX threads implementations don't allow you to +choose to have stack unwinding. (Compaq's TRU64 Unix is possibly an exception.) + +Therefore, providing it in pthread-win32 as a default could be dangerous +and non-portable. We still provide the choice but you must now consciously +make it. + +WHY NOT REMOVE THE EXCEPTIONS VERSIONS OF THE LIBRARY ALTOGETHER? +There are a few reasons: +- because there are well respected POSIX threads people who believe + that POSIX threads implementations should be exceptions-aware and + do the expected thing in that context. (There are equally respected + people who believe it should not be easily accessible, if it's there + at all.) +- because pthreads-win32 is one of the few implementations that has + the choice, perhaps the only freely available one, and so offers + a laboratory to people who may want to explore the effects; +- although the code will always be around somewhere for anyone who + wants it, once it's removed from the current version it will not be + nearly as visible to people who may have a use for it. + + +------------------------------------------------------------------------------ + +Q 6 Should I use Cygwin or Mingw32 as a development environment? +--- + +Important: see Q7 also. + +Use Mingw32 with the MSVCRT library to build applications that use +the pthreads DLL. + +Cygwin's own internal support for POSIX threads is growing. +Consult that project's documentation for more information. + +------------------------------------------------------------------------------ + +Q 7 Now that pthreads-win32 builds under Mingw32, why do I get +--- memory access violations (segfaults)? + +The latest Mingw32 package has thread-safe exception handling (see Q10). +Also, see Q6 above. + +------------------------------------------------------------------------------ + +Q 8 How do I use pthread.dll for Win32 (Visual C++ 5.0) +--- + +> +> I'm a "rookie" when it comes to your pthread implementation. I'm currently +> desperately trying to install the prebuilt .dll file into my MSVC compiler. +> Could you please provide me with explicit instructions on how to do this (or +> direct me to a resource(s) where I can acquire such information)? +> +> Thank you, +> + +You should have a .dll, .lib, .def, and three .h files. It is recommended +that you use pthreadVC.dll, rather than pthreadVCE.dll or pthreadVSE.dll +(see Q2 above). + +The .dll can go in any directory listed in your PATH environment +variable, so putting it into C:\WINDOWS should work. + +The .lib file can go in any directory listed in your LIB environment +variable. + +The .h files can go in any directory listed in your INCLUDE +environment variable. + +Or you might prefer to put the .lib and .h files into a new directory +and add its path to LIB and INCLUDE. You can probably do this easiest +by editing the file:- + +C:\Program Files\DevStudio\vc\bin\vcvars32.bat + +The .def file isn't used by anything in the pre-compiled version but +is included for information. + +Cheers. +Ross + +------------------------------------------------------------------------------ + +Q 9 Cancelation doesn't work for me, why? +--- + +> I'm investigating a problem regarding thread cancelation. The thread I want +> to cancel has PTHREAD_CANCEL_ASYNCHRONOUS, however, this piece of code +> blocks on the join(): +> +> if ((retv = Pthread_cancel( recvThread )) == 0) +> { +> retv = Pthread_join( recvThread, 0 ); +> } +> +> Pthread_* are just macro's; they call pthread_*. +> +> The thread recvThread seems to block on a select() call. It doesn't get +> cancelled. +> +> Two questions: +> +> 1) is this normal behaviour? +> +> 2) if not, how does the cancel mechanism work? I'm not very familliar to +> win32 programming, so I don't really understand how the *Event() family of +> calls work. + +The answer to your first question is, normal POSIX behaviour would +be to asynchronously cancel the thread. However, even that doesn't +guarantee cancelation as the standard only says it should be +cancelled as soon as possible. + +Snapshot 99-11-02 or earlier only partially supports asynchronous cancellation. +Snapshots since then simulate async cancelation by poking the address of +a cancelation routine into the PC of the threads context. This requires +the thread to be resumed in some way for the cancelation to actually +proceed. This is not true async cancelation, but it is as close as we've +been able to get to it. + +If the thread you're trying to cancel is blocked (for instance, it could be +waiting for data from the network), it will only get cancelled when it unblocks +(when the data arrives). For true pre-emptive cancelation in these cases, +pthreads-win32 from snapshot 2004-05-16 can automatically recognise and use the +QueueUserAPCEx package by Panagiotis E. Hadjidoukas. This package is available +from the pthreads-win32 ftp site and is included in the pthreads-win32 +self-unpacking zip from 2004-05-16 onwards. + +Using deferred cancelation would normally be the way to go, however, +even though the POSIX threads standard lists a number of C library +functions that are defined as deferred cancelation points, there is +no hookup between those which are provided by Windows and the +pthreads-win32 library. + +Incidently, it's worth noting for code portability that the older POSIX +threads standards cancelation point lists didn't include "select" because +(as I read in Butenhof) it wasn't part of POSIX. However, it does appear in +the SUSV3. + +Effectively, the only mandatory cancelation points that pthreads-win32 +recognises are those the library implements itself, ie. + + pthread_testcancel + pthread_cond_wait + pthread_cond_timedwait + pthread_join + sem_wait + sem_timedwait + pthread_delay_np + +The following routines from the non-mandatory list in SUSV3 are +cancelation points in pthreads-win32: + + pthread_rwlock_wrlock + pthread_rwlock_timedwrlock + +The following routines from the non-mandatory list in SUSV3 are not +cancelation points in pthreads-win32: + + pthread_rwlock_rdlock + pthread_rwlock_timedrdlock + +Pthreads-win32 also provides two functions that allow you to create +cancelation points within your application, but only for cases where +a thread is going to block on a Win32 handle. These are: + + pthreadCancelableWait(HANDLE waitHandle) /* Infinite wait */ + + pthreadCancelableTimedWait(HANDLE waitHandle, DWORD timeout) + +------------------------------------------------------------------------------ + + +Q 10 How do I create thread-safe applications using +---- pthreadGCE.dll, libpthreadw32.a and Mingw32? + +This should not be a problem with recent versions of MinGW32. + +For early versions, see Thomas Pfaff's email at: +http://sources.redhat.com/ml/pthreads-win32/2002/msg00000.html +------------------------------------------------------------------------------ + +Q 11 Why isn't pthread_t defined as a scalar (e.g. pointer or int) + like it is for other POSIX threads implementations? +---- + +Originally pthread_t was defined as a pointer (to the opaque pthread_t_ +struct) and later it was changed to a struct containing the original +pointer plus a sequence counter. This is allowed under both the original +POSIX Threads Standard and the current Single Unix Specification. + +When pthread_t is a simple pointer to a struct some very difficult to +debug problems arise from the process of freeing and later allocing +thread structs because new pthread_t handles can acquire the identity of +previously detached threads. The change to a struct was made, along with +some changes to their internal managment, in order to guarantee (for +practical applications) that the pthread_t handle will be unique over the +life of the running process. + +Where application code attempts to compare one pthread_t against another +directly, a compiler error will be emitted because structs can't be +compared at that level. This should signal a potentially serious problem +in the code design, which would go undetected if pthread_t was a scalar. + +The POSIX Threading API provides a function named pthread_equal() to +compare pthread_t thread handles. + +Other pthreads implementations, such as Sun's, use an int as the handle +but do guarantee uniqueness within the process scope. Win32 scalar typed +thread handles also guarantee uniqueness in system scope. It wasn't clear +how well the internal management of these handles would scale as the +number of threads and the fragmentation of the sequence numbering +increased for applications where thousands or millions of threads are +created and detached over time. The current management of threads within +pthreads-win32 using structs for pthread_t, and reusing without ever +freeing them, reduces the management time overheads to a constant, which +could be important given that pthreads-win32 threads are built on top of +Win32 threads and will therefore include that management overhead on top +of their own. The cost is that the memory resources used for thread +handles will remain at the peak level until the process exits. + +While it may be inconvenient for developers to be forced away from making +assumptions about the internals of pthread_t, the advantage for the +future development of pthread-win32, as well as those applications that +use it and other pthread implementations, is that the library is free to +change pthread_t internals and management as better methods arise. + diff --git a/external/pthreads-w32/MAINTAINERS b/external/pthreads-w32/MAINTAINERS new file mode 100644 index 00000000..5b04e43f --- /dev/null +++ b/external/pthreads-w32/MAINTAINERS @@ -0,0 +1,4 @@ +CVS Repository maintainers + +Ross Johnson rpj@ise.canberra.edu.au +Ben Elliston bje@cygnus.com diff --git a/external/pthreads-w32/NEWS b/external/pthreads-w32/NEWS new file mode 100644 index 00000000..5ed91378 --- /dev/null +++ b/external/pthreads-w32/NEWS @@ -0,0 +1,1241 @@ +RELEASE 2.9.0 +------------- +(2012-05-25) + +General +------- +New bug fixes in this release since 2.8.0 have NOT been applied to the +1.x.x series. + +Some changes post 2011-02-26 in CVS may not be compatible with pre +Windows 2000 systems. + +Use of other than the "C" version of the library is now discouraged. +That is, the "C++" version fails some tests and does not provide any +additional functionality. + +Testing and verification +------------------------ +This version has been tested on SMP architecture (Intel x64 Hex Core) +by completing the included test suite, stress and bench tests. + +New Features +------------ +DLL properties now properly includes the target architecture, i.e. +right-click on the file pthreadVC2.dll in explorer and choose the Detail +tab will show the compiler and architecture in the description field, e.g. +"MS C x64" or "MS C x86". +- Ross Johnson + +(MSC and GNU builds) The statically linked library now automatically +initialises and cleans up on program start/exit, i.e. statically linked +applications need not call the routines pthread_win32_process_attach_np() +and pthread_win32_process_detach_np() explicitly. The per-thread routine +pthread_win32_thread_detach_np() is also called at program exit to cleanup +POSIX resources acquired by the primary Windows native thread, if I (RJ) +understand the process correctly. Other Windows native threads that call +POSIX API routines may need to call the thread detach routine on thread +exit if the application depends on reclaimed POSIX resources or running +POSIX TSD (TLS) destructors. +See README.NONPORTABLE for descriptions of these routines. +- Ramiro Polla + +Robust mutexes are implemented within the PROCESS_PRIVATE scope. NOTE that +pthread_mutex_* functions may return different error codes for robust +mutexes than they otherwise do in normal usage, e.g. pthread_mutex_unlock +is required to check ownership for all mutex types when the mutex is +robust, whereas this does not occur for the "normal" non-robust mutex type. +- Ross Johnson + +pthread_getunique_np is implemented for source level compatibility +with some other implementations. This routine returns a 64 bit +sequence number that is uniquely associated with a thread. It can be +used by applications to order or hash POSIX thread handles. +- Ross Johnson + +Bug fixes +--------- +Many more changes for 64 bit systems. +- Kai Tietz + +Various modifications and fixes to build and test for WinCE. +- Marcel Ruff, Sinan Kaya + +Fix pthread_cond_destroy() - should not be a cancellation point. Other +minor build problems fixed. +- Romano Paolo Tenca + +Remove potential deadlock condition from pthread_cond_destroy(). +- Eric Berge + +Various modifications to build and test for Win64. +- Kip Streithorst + +Various fixes to the QueueUserAPCEx async cancellation helper DLL +(this is a separate download) and pthreads code cleanups. +- Sebastian Gottschalk + +Removed potential NULL pointer reference. +- Robert Kindred + +Removed the requirement that applications restrict the number of threads +calling pthread_barrier_wait to just the barrier count. Also reduced the +contention between barrier_wait and barrier_destroy. This change will have +slowed barriers down slightly but halves the number of semaphores consumed +per barrier to one. +- Ross Johnson + +Fixed a handle leak in sched_[gs]etscheduler. +- Mark Pizzolato + +Removed all of the POSIX re-entrant function compatibility macros from pthread.h. +Some were simply not semanticly correct. +- Igor Lubashev + +Threads no longer attempt to pass uncaught exceptions out of thread scope (C++ +and SEH builds only). Uncaught exceptions now cause the thread to exit with +the return code PTHREAD_CANCELED. +- Ross Johnson + +Lots of casting fixes particularly for x64, Interlocked fixes and reworking +for x64. +- Daniel Richard G., John Kamp + +Other changes +------------- +Dependence on the winsock library is now discretionary via +#define RETAIN_WSALASTERROR in config.h. It is undefined by default unless +WINCE is defined (because RJ is unsure of the dependency there). +- Ramiro Polla + +Several static POSIX mutexes used for internal management were replaced by +MCS queue-based locks to reduce resource consumption, in particular use of Win32 +objects. +- Ross Johnson + +For security, the QuserEx.dll if used must now be installed in the Windows System +folder. +- Ross Johnson + +New tests +--------- +robust[1-5].c - Robust mutexes +sequence1.c - per-thread unique sequence numbers + +Modified tests and benchtests +----------------------------- +All mutex*.c tests wherever appropriate have been modified to also test +robust mutexes under the same conditions. +Added robust mutex benchtests to benchtest*.c wherever appropriate. + + +RELEASE 2.8.0 +------------- +(2006-12-22) + +General +------- +New bug fixes in this release since 2.7.0 have not been applied to the +version 1.x.x series. It is probably time to drop version 1. + +Testing and verification +------------------------ +This release has not yet been tested on SMP architechtures. All tests pass +on a uni-processor system. + +Bug fixes +--------- +Sem_destroy could return EBUSY even though no threads were waiting on the +semaphore. Other races around invalidating semaphore structs (internally) +have been removed as well. + +New tests +--------- +semaphore5.c - tests the bug fix referred to above. + + +RELEASE 2.7.0 +------------- +(2005-06-04) + +General +------- +All new features in this release have been back-ported in release 1.11.0, +including the incorporation of MCS locks in pthread_once, however, versions +1 and 2 remain incompatible even though they are now identical in +performance and functionality. + +Testing and verification +------------------------ +This release has been tested (passed the test suite) on both uni-processor +and multi-processor systems. +- Tim Theisen + +Bug fixes +--------- +Pthread_once has been re-implemented to remove priority boosting and other +complexity to improve robustness. Races for Win32 handles that are not +recycle-unique have been removed. The general form of pthread_once is now +the same as that suggested earlier by Alexander Terekhov, but instead of the +'named mutex', a queue-based lock has been implemented which has the required +properties of dynamic self initialisation and destruction. This lock is also +efficient. The ABI is unaffected in as much as the size of pthread_once_t has +not changed and PTHREAD_ONCE_INIT has not changed, however, applications that +peek inside pthread_once_t, which is supposed to be opaque, will break. +- Vladimir Kliatchko + +New features +------------ +* Support for Mingw cross development tools added to GNUmakefile. +Mingw cross tools allow building the libraries on Linux. +- Mikael Magnusson + + +RELEASE 2.6.0 +------------- +(2005-05-19) + +General +------- +All of the bug fixes and new features in this release have been +back-ported in release 1.10.0. + +Testing and verification +------------------------ +This release has been tested (passed the test suite) on both uni-processor +and multi-processor systems. Thanks to Tim Theisen at TomoTherapy for +exhaustively running the MP tests and for providing crutial observations +and data when faults are detected. + +Bugs fixed +---------- + +* pthread_detach() now reclaims remaining thread resources if called after +the target thread has terminated. Previously, this routine did nothing in +this case. + +New tests +--------- + +* detach1.c - tests that pthread_detach properly invalidates the target +thread, which indicates that the thread resources have been reclaimed. + + +RELEASE 2.5.0 +------------- +(2005-05-09) + +General +------- + +The package now includes a reference documentation set consisting of +HTML formatted Unix-style manual pages that have been edited for +consistency with Pthreads-w32. The set can also be read online at: +http://sources.redhat.com/pthreads-win32/manual/index.html + +Thanks again to Tim Theisen for running the test suite pre-release +on an MP system. + +All of the bug fixes and new features in this release have been +back-ported in release 1.9.0. + +Bugs fixed +---------- + +* Thread Specific Data (TSD) key management has been ammended to +eliminate a source of (what was effectively) resource leakage (a HANDLE +plus memory for each key destruct routine/thread association). This was +not a true leak because these resources were eventually reclaimed when +pthread_key_delete was run AND each thread referencing the key had exited. +The problem was that these two conditions are often not met until very +late, and often not until the process is about to exit. + +The ammended implementation avoids the need for the problematic HANDLE +and reclaims the memory as soon as either the key is deleted OR the +thread exits, whichever is first. + +Thanks to Richard Hughes at Aculab for identifying and locating the leak. + +* TSD key destructors are now processed up to PTHREAD_DESTRUCTOR_ITERATIONS +times instead of just once. PTHREAD_DESTRUCTOR_ITERATIONS has been +defined in pthread.h for some time but not used. + +* Fix a semaphore accounting race between sem_post/sem_post_multiple +and sem_wait cancellation. This is the same issue as with +sem_timedwait that was fixed in the last release. + +* sem_init, sem_post, and sem_post_multiple now check that the +semaphore count never exceeds _POSIX_SEM_VALUE_MAX. + +* Although sigwait() is nothing more than a no-op, it should at least +be a cancellation point to be consistent with the standard. + +New tests +--------- + +* stress1.c - attempts to expose problems in condition variable +and semaphore timed wait logic. This test was inspired by Stephan +Mueller's sample test code used to identify the sem_timedwait bug +from the last release. It's not a part of the regular test suite +because it can take awhile to run. To run it: +nmake clean VC-stress + +* tsd2.c - tests that key destructors are re-run if the tsd key value is +not NULL after the destructor routine has run. Also tests that +pthread_setspecific() and pthread_getspecific() are callable from +destructors. + + +RELEASE 2.4.0 +------------- +(2005-04-26) + +General +------- + +There is now no plan to release a version 3.0.0 to fix problems in +pthread_once(). Other possible implementations of pthread_once +will still be investigated for a possible future release in an attempt +to reduce the current implementation's complexity. + +All of the bug fixes and new features in this release have been +back-ported for release 1.8.0. + +Bugs fixed +---------- + +* Fixed pthread_once race (failures on an MP system). Thanks to +Tim Theisen for running exhaustive pre-release testing on his MP system +using a range of compilers: + VC++ 6 + VC++ 7.1 + Intel C++ version 8.0 +All tests passed. +Some minor speed improvements were also done. + +* Fix integer overrun error in pthread_mutex_timedlock() - missed when +sem_timedwait() was fixed in release 2.2.0. This routine no longer returns +ENOTSUP when NEED_SEM is defined - it is supported (NEED_SEM is only +required for WinCE versions prior to 3.0). + +* Fix timeout bug in sem_timedwait(). +- Thanks to Stephan Mueller for reporting, providing diagnostic output +and test code. + +* Fix several problems in the NEED_SEM conditionally included code. +NEED_SEM included code is provided for systems that don't implement W32 +semaphores, such as WinCE prior to version 3.0. An alternate implementation +of POSIX semaphores is built using W32 events for these systems when +NEED_SEM is defined. This code has been completely rewritten in this +release to reuse most of the default POSIX semaphore code, and particularly, +to implement all of the sem_* routines supported by pthreads-win32. Tim +Theisen also run the test suite over the NEED_SEM code on his MP system. All +tests passed. + +* The library now builds without errors for the Borland Builder 5.5 compiler. + +New features +------------ + +* pthread_mutex_timedlock() and all sem_* routines provided by +pthreads-win32 are now implemented for WinCE versions prior to 3.0. Those +versions did not implement W32 semaphores. Define NEED_SEM in config.h when +building the library for these systems. + +Known issues in this release +---------------------------- + +* pthread_once is too complicated - but it works as far as testing can +determine.. + +* The Borland version of the dll fails some of the tests with a memory read +exception. The cause is not yet known but a compiler bug has not been ruled +out. + + +RELEASE 2.3.0 +------------- +(2005-04-12) + +General +------- + +Release 1.7.0 is a backport of features and bug fixes new in +this release. See earlier notes under Release 2.0.0/General. + +Bugs fixed +---------- + +* Fixed pthread_once potential for post once_routine cancellation +hanging due to starvation. See comments in pthread_once.c. +Momentary priority boosting is used to ensure that, after a +once_routine is cancelled, the thread that will run the +once_routine is not starved by higher priority waiting threads at +critical times. Priority boosting occurs only AFTER a once_routine +cancellation, and is applied only to that once_control. The +once_routine is run at the thread's normal base priority. + +New tests +--------- + +* once4.c: Aggressively tests pthread_once() under realtime +conditions using threads with varying priorities. Windows' +random priority boosting does not occur for threads with realtime +priority levels. + + +RELEASE 2.2.0 +------------- +(2005-04-04) + +General +------- + +* Added makefile targets to build static link versions of the library. +Both MinGW and MSVC. Please note that this does not imply any change +to the LGPL licensing, which still imposes psecific conditions on +distributing software that has been statically linked with this library. + +* There is a known bug in pthread_once(). Cancellation of the init_routine +exposes a potential starvation (i.e. deadlock) problem if a waiting thread +has a higher priority than the initting thread. This problem will be fixed +in version 3.0.0 of the library. + +Bugs fixed +---------- + +* Fix integer overrun error in sem_timedwait(). +Kevin Lussier + +* Fix preprocessor directives for static linking. +Dimitar Panayotov + + +RELEASE 2.1.0 +------------- +(2005-03-16) + +Bugs fixed +---------- + +* Reverse change to pthread_setcancelstate() in 2.0.0. + + +RELEASE 2.0.0 +------------- +(2005-03-16) + +General +------- + +This release represents an ABI change and the DLL version naming has +incremented from 1 to 2, e.g. pthreadVC2.dll. + +Version 1.4.0 back-ports the new functionality included in this +release. Please distribute DLLs built from that version with updates +to applications built on pthreads-win32 version 1.x.x. + +The package naming has changed, replacing the snapshot date with +the version number + descriptive information. E.g. this +release is "pthreads-w32-2-0-0-release". + +Bugs fixed +---------- + +* pthread_setcancelstate() no longer checks for a pending +async cancel event if the library is using alertable async +cancel. See the README file (Prerequisites section) for info +on adding alertable async cancelation. + +New features +------------ + +* pthread_once() now supports init_routine cancellability. + +New tests +--------- + +* Agressively test pthread_once() init_routine cancellability. + + +SNAPSHOT 2005-03-08 +------------------- +Version 1.3.0 + +Bug reports (fixed) +------------------- + +* Implicitly created threads leave Win32 handles behind after exiting. +- Dmitrii Semii + +* pthread_once() starvation problem. +- Gottlob Frege + +New tests +--------- + +* More intense testing of pthread_once(). + + +SNAPSHOT 2005-01-25 +------------------- +Version 1.2.0 + +Bug fixes +--------- + +* Attempted acquisition of a recursive mutex could cause waiting threads +to not be woken when the mutex was released. +- Ralf Kubis + +* Various package omissions have been fixed. + + +SNAPSHOT 2005-01-03 +------------------- +Version 1.1.0 + +Bug fixes +--------- + +* Unlocking recursive or errorcheck mutexes would sometimes +unexpectedly return an EPERM error (bug introduced in +snapshot-2004-11-03). +- Konstantin Voronkov + + +SNAPSHOT 2004-11-22 +------------------- +Version 1.0.0 + +This snapshot primarily fixes the condvar bug introduced in +snapshot-2004-11-03. DLL versioning has also been included to allow +applications to runtime check the Microsoft compatible DLL version +information, and to extend the DLL naming system for ABI and major +(non-backward compatible) API changes. See the README file for details. + +Bug fixes +--------- + +* Condition variables no longer deadlock (bug introduced in +snapshot-2004-11-03). +- Alexander Kotliarov and Nicolas at saintmac + +* DLL naming extended to avoid 'DLL hell' in the future, and to +accommodate the ABI change introduced in snapshot-2004-11-03. Snapshot +2004-11-03 will be removed from FTP sites. + +New features +------------ + +* A Microsoft-style version resource has been added to the DLL for +applications that wish to check DLL compatibility at runtime. + +* Pthreads-win32 DLL naming has been extended to allow incompatible DLL +versions to co-exist in the same filesystem. See the README file for details, +but briefly: while the version information inside the DLL will change with +each release from now on, the DLL version names will only change if the new +DLL is not backward compatible with older applications. + +The versioning scheme has been borrowed from GNU Libtool, and the DLL +naming scheme is from Cygwin. Provided the Libtool-style numbering rules are +honoured, the Cygwin DLL naming scheme automatcally ensures that DLL name +changes are minimal and that applications will not load an incompatible +pthreads-win32 DLL. + +Those who use the pre-built DLLs will find that the DLL/LIB names have a new +suffix (1) in this snapshot. E.g. pthreadVC1.dll etc. + +* The POSIX thread ID reuse uniqueness feature introduced in the last snapshot +has been kept as default, but the behaviour can now be controlled when the DLL +is built to effectively switch it off. This makes the library much more +sensitive to applications that assume that POSIX thread IDs are unique, i.e. +are not strictly compliant with POSIX. See the PTW32_THREAD_ID_REUSE_INCREMENT +macro comments in config.h for details. + +Other changes +------------- +Certain POSIX macros have changed. + +These changes are intended to conform to the Single Unix Specification version 3, +which states that, if set to 0 (zero) or not defined, then applications may use +sysconf() to determine their values at runtime. Pthreads-win32 does not +implement sysconf(). + +The following macros are no longer undefined, but defined and set to -1 +(not implemented): + + _POSIX_THREAD_ATTR_STACKADDR + _POSIX_THREAD_PRIO_INHERIT + _POSIX_THREAD_PRIO_PROTECT + _POSIX_THREAD_PROCESS_SHARED + +The following macros are defined and set to 200112L (implemented): + + _POSIX_THREADS + _POSIX_THREAD_SAFE_FUNCTIONS + _POSIX_THREAD_ATTR_STACKSIZE + _POSIX_THREAD_PRIORITY_SCHEDULING + _POSIX_SEMAPHORES + _POSIX_READER_WRITER_LOCKS + _POSIX_SPIN_LOCKS + _POSIX_BARRIERS + +The following macros are defined and set to appropriate values: + + _POSIX_THREAD_THREADS_MAX + _POSIX_SEM_VALUE_MAX + _POSIX_SEM_NSEMS_MAX + PTHREAD_DESTRUCTOR_ITERATIONS + PTHREAD_KEYS_MAX + PTHREAD_STACK_MIN + PTHREAD_THREADS_MAX + + +SNAPSHOT 2004-11-03 +------------------- + +DLLs produced from this snapshot cannot be used with older applications without +recompiling the application, due to a change to pthread_t to provide unique POSIX +thread IDs. + +Although this snapshot passes the extended test suite, many of the changes are +fairly major, and some applications may show different behaviour than previously, +so adopt with care. Hopefully, any changed behaviour will be due to the library +being better at it's job, not worse. + +Bug fixes +--------- + +* pthread_create() no longer accepts NULL as the thread reference arg. +A segfault (memory access fault) will result, and no thread will be +created. + +* pthread_barrier_wait() no longer acts as a cancelation point. + +* Fix potential race condition in pthread_once() +- Tristan Savatier + +* Changes to pthread_cond_destroy() exposed some coding weaknesses in several +test suite mini-apps because pthread_cond_destroy() now returns EBUSY if the CV +is still in use. + +New features +------------ + +* Added for compatibility: +PTHREAD_RECURSIVE_MUTEX_INITIALIZER, +PTHREAD_ERRORCHECK_MUTEX_INITIALIZER, +PTHREAD_RECURSIVE_MUTEX_INITIALIZER_NP, +PTHREAD_ERRORCHECK_MUTEX_INITIALIZER_NP + +* Initial support for Digital Mars compiler +- Anuj Goyal + +* Faster Mutexes. These have been been rewritten following a model provided by +Alexander Terekhov that reduces kernel space checks, and eliminates some additional +critical sections used to manage a race between timedlock expiration and unlock. +Please be aware that the new mutexes do not enforce strict absolute FIFO scheduling +of mutexes, however any out-of-order lock acquisition should be very rare. + +* Faster semaphores. Following a similar model to mutexes above, these have been +rewritten to use preliminary users space checks. + +* sem_getvalue() now returns the number of waiters. + +* The POSIX thread ID now has much stronger uniqueness characteristics. The library +garrantees not to reuse the same thread ID for at least 2^(wordsize) thread +destruction/creation cycles. + +New tests +--------- + +* semaphore4.c: Tests cancelation of the new sem_wait(). + +* semaphore4t.c: Likewise for sem_timedwait(). + +* rwlock8.c: Tests and times the slow execution paths of r/w locks, and the CVs, +mutexes, and semaphores that they're built on. + + +SNAPSHOT 2004-05-16 +------------------- + +Attempt to add Watcom to the list of compilers that can build the library. +This failed in the end due to it's non-thread-aware errno. The library +builds but the test suite fails. See README.Watcom for more details. + +Bug fixes +--------- +* Bug and memory leak in sem_init() +- Alex Blanco + +* ptw32_getprocessors() now returns CPU count of 1 for WinCE. +- James Ewing + +* pthread_cond_wait() could be canceled at a point where it should not +be cancelable. Fixed. +- Alexander Terekhov + +* sem_timedwait() had an incorrect timeout calculation. +- Philippe Di Cristo + +* Fix a memory leak left behind after threads are destroyed. +- P. van Bruggen + +New features +------------ +* Ported to AMD64. +- Makoto Kato + +* True pre-emptive asynchronous cancelation of threads. This is optional +and requires that Panagiotis E. Hadjidoukas's QueueUserAPCEx package be +installed. This package is included in the pthreads-win32 self-unpacking +Zip archive starting from this snapshot. See the README.txt file inside +the package for installation details. + +Note: If you don't use async cancelation in your application, or don't need +to cancel threads that are blocked on system resources such as network I/O, +then the default non-preemptive async cancelation is probably good enough. +However, pthreads-win32 auto-detects the availability of these components +at run-time, so you don't need to rebuild the library from source if you +change your mind later. + +All of the advice available in books and elsewhere on the undesirability +of using async cancelation in any application still stands, but this +feature is a welcome addition with respect to the library's conformance to +the POSIX standard. + +SNAPSHOT 2003-09-18 +------------------- + +Cleanup of thread priority management. In particular, setting of thread +priority now attempts to map invalid Win32 values within the range returned +by sched_get_priority_min/max() to useful values. See README.NONPORTABLE +under "Thread priority". + +Bug fixes +--------- +* pthread_getschedparam() now returns the priority given by the most recent +call to pthread_setschedparam() or established by pthread_create(), as +required by the standard. Previously, pthread_getschedparam() incorrectly +returned the running thread priority at the time of the call, which may have +been adjusted or temporarily promoted/demoted. + +* sched_get_priority_min() and sched_get_priority_max() now return -1 on error +and set errno. Previously, they incorrectly returned the error value directly. + + +SNAPSHOT 2003-09-04 +------------------- + +Bug fixes +--------- +* ptw32_cancelableWait() now allows cancelation of waiting implicit POSIX +threads. + +New test +-------- +* cancel8.c tests cancelation of Win32 threads waiting at a POSIX cancelation +point. + + +SNAPSHOT 2003-09-03 +------------------- + +Bug fixes +--------- +* pthread_self() would free the newly created implicit POSIX thread handle if +DuplicateHandle failed instead of recycle it (very unlikely). + +* pthread_exit() was neither freeing nor recycling the POSIX thread struct +for implicit POSIX threads. + +New feature - Cancelation of/by Win32 (non-POSIX) threads +--------------------------------------------------------- +Since John Bossom's original implementation, the library has allowed non-POSIX +initialised threads (Win32 threads) to call pthreads-win32 routines and +therefore interact with POSIX threads. This is done by creating an on-the-fly +POSIX thread ID for the Win32 thread that, once created, allows fully +reciprical interaction. This did not extend to thread cancelation (async or +deferred). Now it does. + +Any thread can be canceled by any other thread (Win32 or POSIX) if the former +thread's POSIX pthread_t value is known. It's TSD destructors and POSIX +cleanup handlers will be run before the thread exits with an exit code of +PTHREAD_CANCELED (retrieved with GetExitCodeThread()). + +This allows a Win32 thread to, for example, call POSIX CV routines in the same way +that POSIX threads would/should, with pthread_cond_wait() cancelability and +cleanup handlers (pthread_cond_wait() is a POSIX cancelation point). + +By adding cancelation, Win32 threads should now be able to call all POSIX +threads routines that make sense including semaphores, mutexes, condition +variables, read/write locks, barriers, spinlocks, tsd, cleanup push/pop, +cancelation, pthread_exit, scheduling, etc. + +Note that these on-the-fly 'implicit' POSIX thread IDs are initialised as detached +(not joinable) with deferred cancelation type. The POSIX thread ID will be created +automatically by any POSIX routines that need a POSIX handle (unless the routine +needs a pthread_t as a parameter of course). A Win32 thread can discover it's own +POSIX thread ID by calling pthread_self(), which will create the handle if +necessary and return the pthread_t value. + +New tests +--------- +Test the above new feature. + + +SNAPSHOT 2003-08-19 +------------------- + +This snapshot fixes some accidental corruption to new test case sources. +There are no changes to the library source code. + + +SNAPSHOT 2003-08-15 +------------------- + +Bug fixes +--------- + +* pthread.dsp now uses correct compile flags (/MD). +- Viv + +* pthread_win32_process_detach_np() fixed memory leak. +- Steven Reddie + +* pthread_mutex_destroy() fixed incorrect return code. +- Nicolas Barry + +* pthread_spin_destroy() fixed memory leak. +- Piet van Bruggen + +* Various changes to tighten arg checking, and to work with later versions of +MinGW32 and MsysDTK. + +* pthread_getschedparam() etc, fixed dangerous thread validity checking. +- Nicolas Barry + +* POSIX thread handles are now reused and their memory is not freed on thread exit. +This allows for stronger thread validity checking. + +New standard routine +-------------------- + +* pthread_kill() added to provide thread validity checking to applications. +It does not accept any non zero values for the signal arg. + +New test cases +-------------- + +* New test cases to confirm validity checking, pthread_kill(), and thread reuse. + + +SNAPSHOT 2003-05-10 +------------------- + +Bug fixes +--------- + +* pthread_mutex_trylock() now returns correct error values. +pthread_mutex_destroy() will no longer destroy a recursively locked mutex. +pthread_mutex_lock() is no longer inadvertantly behaving as a cancelation point. +- Thomas Pfaff + +* pthread_mutex_timedlock() no longer occasionally sets incorrect mutex +ownership, causing deadlocks in some applications. +- Robert Strycek and Alexander Terekhov + + +SNAPSHOT 2002-11-04 +------------------- + +Bug fixes +--------- + +* sem_getvalue() now returns the correct value under Win NT and WinCE. +- Rob Fanner + +* sem_timedwait() now uses tighter checks for unreasonable +abstime values - that would result in unexpected timeout values. + +* ptw32_cond_wait_cleanup() no longer mysteriously consumes +CV signals but may produce more spurious wakeups. It is believed +that the sem_timedwait() call is consuming a CV signal that it +shouldn't. +- Alexander Terekhov + +* Fixed a memory leak in ptw32_threadDestroy() for implicit threads. + +* Fixed potential for deadlock in pthread_cond_destroy(). +A deadlock could occur for statically declared CVs (PTHREAD_COND_INITIALIZER), +when one thread is attempting to destroy the condition variable while another +is attempting to dynamically initialize it. +- Michael Johnson + + +SNAPSHOT 2002-03-02 +------------------- + +Cleanup code default style. (IMPORTANT) +---------------------------------------------------------------------- +Previously, if not defined, the cleanup style was determined automatically +from the compiler/language, and one of the following was defined accordingly: + + __CLEANUP_SEH MSVC only + __CLEANUP_CXX C++, including MSVC++, GNU G++ + __CLEANUP_C C, including GNU GCC, not MSVC + +These defines determine the style of cleanup (see pthread.h) and, +most importantly, the way that cancelation and thread exit (via +pthread_exit) is performed (see the routine ptw32_throw() in private.c). + +In short, the exceptions versions of the library throw an exception +when a thread is canceled or exits (via pthread_exit()), which is +caught by a handler in the thread startup routine, so that the +the correct stack unwinding occurs regardless of where the thread +is when it's canceled or exits via pthread_exit(). + +In this and future snapshots, unless the build explicitly defines (e.g. +via a compiler option) __CLEANUP_SEH, __CLEANUP_CXX, or __CLEANUP_C, then +the build NOW always defaults to __CLEANUP_C style cleanup. This style +uses setjmp/longjmp in the cancelation and pthread_exit implementations, +and therefore won't do stack unwinding even when linked to applications +that have it (e.g. C++ apps). This is for consistency with most +current commercial Unix POSIX threads implementations. Compaq's TRU64 +may be an exception (no pun intended) and possible future trend. + +Although it was not clearly documented before, it is still necessary to +build your application using the same __CLEANUP_* define as was +used for the version of the library that you link with, so that the +correct parts of pthread.h are included. That is, the possible +defines require the following library versions: + + __CLEANUP_SEH pthreadVSE.dll + __CLEANUP_CXX pthreadVCE.dll or pthreadGCE.dll + __CLEANUP_C pthreadVC.dll or pthreadGC.dll + +E.g. regardless of whether your app is C or C++, if you link with +pthreadVC.lib or libpthreadGC.a, then you must define __CLEANUP_C. + + +THE POINT OF ALL THIS IS: if you have not been defining one of these +explicitly, then the defaults as described at the top of this +section were being used. + +THIS NOW CHANGES, as has been explained above, but to try to make this +clearer here's an example: + +If you were building your application with MSVC++ i.e. using C++ +exceptions and not explicitly defining one of __CLEANUP_*, then +__CLEANUP_C++ was automatically defined for you in pthread.h. +You should have been linking with pthreadVCE.dll, which does +stack unwinding. + +If you now build your application as you had before, pthread.h will now +automatically set __CLEANUP_C as the default style, and you will need to +link with pthreadVC.dll. Stack unwinding will now NOT occur when a thread +is canceled, or the thread calls pthread_exit(). + +Your application will now most likely behave differently to previous +versions, and in non-obvious ways. Most likely is that locally +instantiated objects may not be destroyed or cleaned up after a thread +is canceled. + +If you want the same behaviour as before, then you must now define +__CLEANUP_C++ explicitly using a compiler option and link with +pthreadVCE.dll as you did before. + + +WHY ARE WE MAKING THE DEFAULT STYLE LESS EXCEPTION-FRIENDLY? +Because no commercial Unix POSIX threads implementation allows you to +choose to have stack unwinding. Therefore, providing it in pthread-win32 +as a default is dangerous. We still provide the choice but unless +you consciously choose to do otherwise, your pthreads applications will +now run or crash in similar ways irrespective of the threads platform +you use. Or at least this is the hope. + + +WHY NOT REMOVE THE EXCEPTIONS VERSIONS OF THE LIBRARY ALTOGETHER? +There are a few reasons: +- because there are well respected POSIX threads people who believe + that POSIX threads implementations should be exceptions aware and + do the expected thing in that context. (There are equally respected + people who believe it should not be easily accessible, if it's there + at all, for unconditional conformity to other implementations.) +- because pthreads-win32 is one of the few implementations that has + the choice, perhaps the only freely available one, and so offers + a laboratory to people who may want to explore the effects; +- although the code will always be around somewhere for anyone who + wants it, once it's removed from the current version it will not be + nearly as visible to people who may have a use for it. + + +Source module splitting +----------------------- +In order to enable smaller image sizes to be generated +for applications that link statically with the library, +most routines have been separated out into individual +source code files. + +This is being done in such a way as to be backward compatible. +The old source files are reused to congregate the individual +routine files into larger translation units (via a bunch of +# includes) so that the compiler can still optimise wherever +possible, e.g. through inlining, which can only be done +within the same translation unit. + +It is also possible to build the entire library by compiling +the single file named "pthread.c", which just #includes all +the secondary congregation source files. The compiler +may be able to use this to do more inlining of routines. + +Although the GNU compiler is able to produce libraries with +the necessary separation (the -ffunction-segments switch), +AFAIK, the MSVC and other compilers don't have this feature. + +Finally, since I use makefiles and command-line compilation, +I don't know what havoc this reorganisation may wreak amongst +IDE project file users. You should be able to continue +using your existing project files without modification. + + +New non-portable functions +-------------------------- +pthread_num_processors_np(): + Returns the number of processors in the system that are + available to the process, as determined from the processor + affinity mask. + +pthread_timechange_handler_np(): + To improve tolerance against operator or time service initiated + system clock changes. + + This routine can be called by an application when it + receives a WM_TIMECHANGE message from the system. At present + it broadcasts all condition variables so that waiting threads + can wake up and re-evaluate their conditions and restart + their timed waits if required. + - Suggested by Alexander Terekhov + + +Platform dependence +------------------- +As Win95 doesn't provide one, the library now contains +it's own InterlockedCompareExchange() routine, which is used +whenever Windows doesn't provide it. InterlockedCompareExchange() +is used to implement spinlocks and barriers, and also in mutexes. +This routine relies on the CMPXCHG machine instruction which +is not available on i386 CPUs. This library (from snapshot +20010712 onwards) is therefore no longer supported on i386 +processor platforms. + + +New standard routines +--------------------- +For source code portability only - rwlocks cannot be process shared yet. + + pthread_rwlockattr_init() + pthread_rwlockattr_destroy() + pthread_rwlockattr_setpshared() + pthread_rwlockattr_getpshared() + +As defined in the new POSIX standard, and the Single Unix Spec version 3: + + sem_timedwait() + pthread_mutex_timedlock() - Alexander Terekhov and Thomas Pfaff + pthread_rwlock_timedrdlock() - adapted from pthread_rwlock_rdlock() + pthread_rwlock_timedwrlock() - adapted from pthread_rwlock_wrlock() + + +pthread.h no longer includes windows.h +-------------------------------------- +[Not yet for G++] + +This was done to prevent conflicts. + +HANDLE, DWORD, and NULL are temporarily defined within pthread.h if +they are not already. + + +pthread.h, sched.h and semaphore.h now use dllexport/dllimport +-------------------------------------------------------------- +Not only to avoid the need for the pthread.def file, but to +improve performance. Apparently, declaring functions with dllimport +generates a direct call to the function and avoids the overhead +of a stub function call. + +Bug fixes +--------- +* Fixed potential NULL pointer dereferences in pthread_mutexattr_init, +pthread_mutexattr_getpshared, pthread_barrierattr_init, +pthread_barrierattr_getpshared, and pthread_condattr_getpshared. +- Scott McCaskill + +* Removed potential race condition in pthread_mutex_trylock and +pthread_mutex_lock; +- Alexander Terekhov + +* The behaviour of pthread_mutex_trylock in relation to +recursive mutexes was inconsistent with commercial implementations. +Trylock would return EBUSY if the lock was owned already by the +calling thread regardless of mutex type. Trylock now increments the +recursion count and returns 0 for RECURSIVE mutexes, and will +return EDEADLK rather than EBUSY for ERRORCHECK mutexes. This is +consistent with Solaris. +- Thomas Pfaff + +* Found a fix for the library and workaround for applications for +the known bug #2, i.e. where __CLEANUP_CXX or __CLEANUP_SEH is defined. +See the "Known Bugs in this snapshot" section below. + +This could be made transparent to applications by replacing the macros that +define the current C++ and SEH versions of pthread_cleanup_push/pop +with the C version, but AFAIK cleanup handlers would not then run in the +correct sequence with destructors and exception cleanup handlers when +an exception occurs. + +* Cancelation once started in a thread cannot now be inadvertantly +double canceled. That is, once a thread begins it's cancelation run, +cancelation is disabled and a subsequent cancel request will +return an error (ESRCH). + +* errno: An incorrect compiler directive caused a local version +of errno to be used instead of the Win32 errno. Both instances are +thread-safe but applications checking errno after a pthreads-win32 +call would be wrong. Fixing this also fixed a bad compiler +option in the testsuite (/MT should have been /MD) which is +needed to link with the correct library MSVCRT.LIB. + + +SNAPSHOT 2001-07-12 +------------------- + +To be added + + +SNAPSHOT 2001-07-03 +------------------- + +To be added + + +SNAPSHOT 2000-08-13 +------------------- + +New: +- Renamed DLL and LIB files: + pthreadVSE.dll (MS VC++/Structured EH) + pthreadVSE.lib + pthreadVCE.dll (MS VC++/C++ EH) + pthreadVCE.lib + pthreadGCE.dll (GNU G++/C++ EH) + libpthreadw32.a + + Both your application and the pthread dll should use the + same exception handling scheme. + +Bugs fixed: +- MSVC++ C++ exception handling. + +Some new tests have been added. + + +SNAPSHOT 2000-08-10 +------------------- + +New: +- asynchronous cancelation on X86 (Jason Nye) +- Makefile compatible with MS nmake to replace + buildlib.bat +- GNUmakefile for Mingw32 +- tests/Makefile for MS nmake replaces runall.bat +- tests/GNUmakefile for Mingw32 + +Bugs fixed: +- kernel32 load/free problem +- attempt to hide internel exceptions from application + exception handlers (__try/__except and try/catch blocks) +- Win32 thread handle leakage bug + (David Baggett/Paul Redondo/Eyal Lebedinsky) + +Some new tests have been added. + + +SNAPSHOT 1999-11-02 +------------------- + +Bugs fixed: +- ctime_r macro had an incorrect argument (Erik Hensema), +- threads were not being created + PTHREAD_CANCEL_DEFERRED. This should have + had little effect as deferred is the only + supported type. (Ross Johnson). + +Some compatibility improvements added, eg. +- pthread_setcancelstate accepts NULL pointer + for the previous value argument. Ditto for + pthread_setcanceltype. This is compatible + with Solaris but should not affect + standard applications (Erik Hensema) + +Some new tests have been added. + + +SNAPSHOT 1999-10-17 +------------------- + +Bug fix - Cancelation of threads waiting on condition variables +now works properly (Lorin Hochstein and Peter Slacik) + + +SNAPSHOT 1999-08-12 +------------------- + +Fixed exception stack cleanup if calling pthread_exit() +- (Lorin Hochstein and John Bossom). + +Fixed bugs in condition variables - (Peter Slacik): + - additional contention checks + - properly adjust number of waiting threads after timed + condvar timeout. + + +SNAPSHOT 1999-05-30 +------------------- + +Some minor bugs have been fixed. See the ChangeLog file for details. + +Some more POSIX 1b functions are now included but ony return an +error (ENOSYS) if called. They are: + + sem_open + sem_close + sem_unlink + sem_getvalue + + +SNAPSHOT 1999-04-07 +------------------- + +Some POSIX 1b functions which were internally supported are now +available as exported functions: + + sem_init + sem_destroy + sem_wait + sem_trywait + sem_post + sched_yield + sched_get_priority_min + sched_get_priority_max + +Some minor bugs have been fixed. See the ChangeLog file for details. + + +SNAPSHOT 1999-03-16 +------------------- + +Initial release. + diff --git a/external/pthreads-w32/PROGRESS b/external/pthreads-w32/PROGRESS new file mode 100644 index 00000000..3e90bec7 --- /dev/null +++ b/external/pthreads-w32/PROGRESS @@ -0,0 +1,4 @@ +Please see the ANNOUNCE file "Level of Standards Conformance" +or the web page: + +http://sources.redhat.com/pthreads-win32/conformance.html diff --git a/external/pthreads-w32/README b/external/pthreads-w32/README new file mode 100644 index 00000000..3436789b --- /dev/null +++ b/external/pthreads-w32/README @@ -0,0 +1,601 @@ +PTHREADS-WIN32 +============== + +Pthreads-win32 is free software, distributed under the GNU Lesser +General Public License (LGPL). See the file 'COPYING.LIB' for terms +and conditions. Also see the file 'COPYING' for information +specific to pthreads-win32, copyrights and the LGPL. + + +What is it? +----------- + +Pthreads-win32 is an Open Source Software implementation of the +Threads component of the POSIX 1003.1c 1995 Standard (or later) +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. The +library also supports some of the functionality of the Open +Group's Single Unix specification, version 2, namely mutex types, +plus some common and pthreads-win32 specific non-portable +routines (see README.NONPORTABLE). + +See the file "ANNOUNCE" for more information including standards +conformance details and the list of supported and unsupported +routines. + + +Prerequisites +------------- +MSVC or GNU C (MinGW32 MSys development kit) + To build from source. + +QueueUserAPCEx by Panagiotis E. Hadjidoukas + To support any thread cancelation in C++ library builds or + to support cancelation of blocked threads in any build. + This library is not required otherwise. + + For true async cancelation of threads (including blocked threads). + This is a DLL and Windows driver that provides pre-emptive APC + by forcing threads into an alertable state when the APC is queued. + Both the DLL and driver are provided with the pthreads-win32.exe + self-unpacking ZIP, and on the pthreads-win32 FTP site (in source + and pre-built forms). Currently this is a separate LGPL package to + pthreads-win32. See the README in the QueueUserAPCEx folder for + installation instructions. + + Pthreads-win32 will automatically detect if the QueueUserAPCEx DLL + QuserEx.DLL is available and whether the driver AlertDrv.sys is + loaded. If it is not available, pthreads-win32 will simulate async + cancelation, which means that it can async cancel only threads that + are runnable. The simulated async cancellation cannot cancel blocked + threads. + + [FOR SECURITY] To be found Quserex.dll MUST be installed in the + Windows System Folder. This is not an unreasonable constraint given a + driver must also be installed and loaded at system startup. + + +Library naming +-------------- + +Because the library is being built using various exception +handling schemes and compilers - and because the library +may not work reliably if these are mixed in an application, +each different version of the library has it's own name. + +Note 1: the incompatibility is really between EH implementations +of the different compilers. It should be possible to use the +standard C version from either compiler with C++ applications +built with a different compiler. If you use an EH version of +the library, then you must use the same compiler for the +application. This is another complication and dependency that +can be avoided by using only the standard C library version. + +Note 2: if you use a standard C pthread*.dll with a C++ +application, then any functions that you define that are +intended to be called via pthread_cleanup_push() must be +__cdecl. + +Note 3: the intention was to also name either the VC or GC +version (it should be arbitrary) as pthread.dll, including +pthread.lib and libpthread.a as appropriate. This is no longer +likely to happen. + +Note 4: the compatibility number was added so that applications +can differentiate between binary incompatible versions of the +libs and dlls. + +In general: + pthread[VG]{SE,CE,C}[c].dll + pthread[VG]{SE,CE,C}[c].lib + +where: + [VG] indicates the compiler + V - MS VC, or + G - GNU C + + {SE,CE,C} indicates the exception handling scheme + SE - Structured EH, or + CE - C++ EH, or + C - no exceptions - uses setjmp/longjmp + + c - DLL compatibility number indicating ABI and API + compatibility with applications built against + a snapshot with the same compatibility number. + See 'Version numbering' below. + +The name may also be suffixed by a 'd' to indicate a debugging version +of the library. E.g. pthreadVC2d.lib. Debugging versions contain +additional information for debugging (symbols etc) and are often not +optimised in any way (compiled with optimisation turned off). + +Examples: + pthreadVSE.dll (MSVC/SEH) + pthreadGCE.dll (GNUC/C++ EH) + pthreadGC.dll (GNUC/not dependent on exceptions) + pthreadVC1.dll (MSVC/not dependent on exceptions - not binary + compatible with pthreadVC.dll) + pthreadVC2.dll (MSVC/not dependent on exceptions - not binary + compatible with pthreadVC1.dll or pthreadVC.dll) + +The GNU library archive file names have correspondingly changed to: + + libpthreadGCEc.a + libpthreadGCc.a + + +Versioning numbering +-------------------- + +Version numbering is separate from the snapshot dating system, and +is the canonical version identification system embedded within the +DLL using the Microsoft version resource system. The versioning +system chosen follows the GNU Libtool system. See +http://www.gnu.org/software/libtool/manual.html section 6.2. + +See the resource file 'version.rc'. + +Microsoft version numbers use 4 integers: + + 0.0.0.0 + +Pthreads-win32 uses the first 3 following the Libtool convention. +The fourth is commonly used for the build number, but will be reserved +for future use. + + current.revision.age.0 + +The numbers are changed as follows: + +1. If the library source code has changed at all since the last update, + then increment revision (`c:r:a' becomes `c:r+1:a'). +2. If any interfaces have been added, removed, or changed since the last + update, increment current, and set revision to 0. +3. If any interfaces have been added since the last public release, then + increment age. +4. If any interfaces have been removed or changed since the last public + release, then set age to 0. + + +DLL compatibility numbering is an attempt to ensure that applications +always load a compatible pthreads-win32 DLL by using a DLL naming system +that is consistent with the version numbering system. It also allows +older and newer DLLs to coexist in the same filesystem so that older +applications can continue to be used. For pre .NET Windows systems, +this inevitably requires incompatible versions of the same DLLs to have +different names. + +Pthreads-win32 has adopted the Cygwin convention of appending a single +integer number to the DLL name. The number used is based on the library +version number and is computed as 'current' - 'age'. + +(See http://home.att.net/~perlspinr/libversioning.html for a nicely +detailed explanation.) + +Using this method, DLL name/s will only change when the DLL's +backwards compatibility changes. Note that the addition of new +'interfaces' will not of itself change the DLL's compatibility for older +applications. + + +Which of the several dll versions to use? +----------------------------------------- +or, +--- +What are all these pthread*.dll and pthread*.lib files? +------------------------------------------------------- + +Simple, use either pthreadGCv.* if you use GCC, or pthreadVCv.* if you +use MSVC - where 'v' is the DLL versioning (compatibility) number. + +Otherwise, you need to choose carefully and know WHY. + +The most important choice you need to make is whether to use a +version that uses exceptions internally, or not. There are versions +of the library that use exceptions as part of the thread +cancelation and exit implementation. The default version uses +setjmp/longjmp. + +There is some contension amongst POSIX threads experts as +to how POSIX threads cancelation and exit should work +with languages that use exceptions, e.g. C++ and even C +(Microsoft's Structured Exceptions). + +The issue is: should cancelation of a thread in, say, +a C++ application cause object destructors and C++ exception +handlers to be invoked as the stack unwinds during thread +exit, or not? + +There seems to be more opinion in favour of using the +standard C version of the library (no EH) with C++ applications +for the reason that this appears to be the assumption commercial +pthreads implementations make. Therefore, if you use an EH version +of pthreads-win32 then you may be under the illusion that +your application will be portable, when in fact it is likely to +behave differently when linked with other pthreads libraries. + +Now you may be asking: then why have you kept the EH versions of +the library? + +There are a couple of reasons: +- there is division amongst the experts and so the code may + be needed in the future. Yes, it's in the repository and we + can get it out anytime in the future, but it would be difficult + to find. +- pthreads-win32 is one of the few implementations, and possibly + the only freely available one, that has EH versions. It may be + useful to people who want to play with or study application + behaviour under these conditions. + +Notes: + +[If you use either pthreadVCE or pthreadGCE] + +1. [See also the discussion in the FAQ file - Q2, Q4, and Q5] + +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 when using versions of the library that use C++ exceptions +for cancelation and thread exit. + +This is due to what is believed to be a C++ compliance error in VC++ +whereby you may not have multiple handlers for the same exception in +the same try/catch block. GNU G++ doesn't have this restriction. + + +Other name changes +------------------ + +All snapshots prior to and including snapshot 2000-08-13 +used "_pthread_" as the prefix to library internal +functions, and "_PTHREAD_" to many library internal +macros. These have now been changed to "ptw32_" and "PTW32_" +respectively so as to not conflict with the ANSI standard's +reservation of identifiers beginning with "_" and "__" for +use by compiler implementations only. + +If you have written any applications and you are linking +statically with the pthreads-win32 library then you may have +included a call to _pthread_processInitialize. You will +now have to change that to ptw32_processInitialize. + + +Cleanup code default style +-------------------------- + +Previously, if not defined, the cleanup style was determined automatically +from the compiler used, and one of the following was defined accordingly: + + __CLEANUP_SEH MSVC only + __CLEANUP_CXX C++, including MSVC++, GNU G++ + __CLEANUP_C C, including GNU GCC, not MSVC + +These defines determine the style of cleanup (see pthread.h) and, +most importantly, the way that cancelation and thread exit (via +pthread_exit) is performed (see the routine ptw32_throw()). + +In short, the exceptions versions of the library throw an exception +when a thread is canceled, or exits via pthread_exit(). This exception is +caught by a handler in the thread startup routine, so that the +the correct stack unwinding occurs regardless of where the thread +is when it's canceled or exits via pthread_exit(). + +In this snapshot, unless the build explicitly defines (e.g. via a +compiler option) __CLEANUP_SEH, __CLEANUP_CXX, or __CLEANUP_C, then +the build NOW always defaults to __CLEANUP_C style cleanup. This style +uses setjmp/longjmp in the cancelation and pthread_exit implementations, +and therefore won't do stack unwinding even when linked to applications +that have it (e.g. C++ apps). This is for consistency with most/all +commercial Unix POSIX threads implementations. + +Although it was not clearly documented before, it is still necessary to +build your application using the same __CLEANUP_* define as was +used for the version of the library that you link with, so that the +correct parts of pthread.h are included. That is, the possible +defines require the following library versions: + + __CLEANUP_SEH pthreadVSE.dll + __CLEANUP_CXX pthreadVCE.dll or pthreadGCE.dll + __CLEANUP_C pthreadVC.dll or pthreadGC.dll + +It is recommended that you let pthread.h use it's default __CLEANUP_C +for both library and application builds. That is, don't define any of +the above, and then link with pthreadVC.lib (MSVC or MSVC++) and +libpthreadGC.a (MinGW GCC or G++). The reason is explained below, but +another reason is that the prebuilt pthreadVCE.dll is currently broken. +Versions built with MSVC++ later than version 6 may not be broken, but I +can't verify this yet. + +WHY ARE WE MAKING THE DEFAULT STYLE LESS EXCEPTION-FRIENDLY? +Because no commercial Unix POSIX threads implementation allows you to +choose to have stack unwinding. Therefore, providing it in pthread-win32 +as a default is dangerous. We still provide the choice but unless +you consciously choose to do otherwise, your pthreads applications will +now run or crash in similar ways irrespective of the pthreads platform +you use. Or at least this is the hope. + + +Building under VC++ using C++ EH, Structured EH, or just C +---------------------------------------------------------- + +From the source directory run nmake without any arguments to list +help information. E.g. + +$ nmake + +Microsoft (R) Program Maintenance Utility Version 6.00.8168.0 +Copyright (C) Microsoft Corp 1988-1998. All rights reserved. + +Run one of the following command lines: +nmake clean VCE (to build the MSVC dll with C++ exception handling) +nmake clean VSE (to build the MSVC dll with structured exception handling) +nmake clean VC (to build the MSVC dll with C cleanup code) +nmake clean VCE-inlined (to build the MSVC inlined dll with C++ exception handling) +nmake clean VSE-inlined (to build the MSVC inlined dll with structured exception handling) +nmake clean VC-inlined (to build the MSVC inlined dll with C cleanup code) +nmake clean VC-static (to build the MSVC static lib with C cleanup code) +nmake clean VCE-debug (to build the debug MSVC dll with C++ exception handling) +nmake clean VSE-debug (to build the debug MSVC dll with structured exception handling) +nmake clean VC-debug (to build the debug MSVC dll with C cleanup code) +nmake clean VCE-inlined-debug (to build the debug MSVC inlined dll with C++ exception handling) +nmake clean VSE-inlined-debug (to build the debug MSVC inlined dll with structured exception handling) +nmake clean VC-inlined-debug (to build the debug MSVC inlined dll with C cleanup code) +nmake clean VC-static-debug (to build the debug MSVC static lib with C cleanup code) + + +The pre-built dlls are normally built using the *-inlined targets. + +You can run the testsuite by changing to the "tests" directory and +running nmake. E.g.: + +$ cd tests +$ nmake + +Microsoft (R) Program Maintenance Utility Version 6.00.8168.0 +Copyright (C) Microsoft Corp 1988-1998. All rights reserved. + +Run one of the following command lines: +nmake clean VC (to test using VC dll with VC (no EH) applications) +nmake clean VCX (to test using VC dll with VC++ (EH) applications) +nmake clean VCE (to test using the VCE dll with VC++ EH applications) +nmake clean VSE (to test using VSE dll with VC (SEH) applications) +nmake clean VC-bench (to benchtest using VC dll with C bench app) +nmake clean VCX-bench (to benchtest using VC dll with C++ bench app) +nmake clean VCE-bench (to benchtest using VCE dll with C++ bench app) +nmake clean VSE-bench (to benchtest using VSE dll with SEH bench app) +nmake clean VC-static (to test using VC static lib with VC (no EH) applications) + + +Building under Mingw32 +---------------------- + +The dll can be built easily with recent versions of Mingw32. +(The distributed versions are built using Mingw32 and MsysDTK +from www.mingw32.org.) + +From the source directory, run make for help information. E.g.: + +$ make +Run one of the following command lines: +make clean GC (to build the GNU C dll with C cleanup code) +make clean GCE (to build the GNU C dll with C++ exception handling) +make clean GC-inlined (to build the GNU C inlined dll with C cleanup code) +make clean GCE-inlined (to build the GNU C inlined dll with C++ exception handling) +make clean GC-static (to build the GNU C inlined static lib with C cleanup code) +make clean GC-debug (to build the GNU C debug dll with C cleanup code) +make clean GCE-debug (to build the GNU C debug dll with C++ exception handling) +make clean GC-inlined-debug (to build the GNU C inlined debug dll with C cleanup code) +make clean GCE-inlined-debug (to build the GNU C inlined debug dll with C++ exception handling) +make clean GC-static-debug (to build the GNU C inlined static debug lib with C cleanup code) + + +The pre-built dlls are normally built using the *-inlined targets. + +You can run the testsuite by changing to the "tests" directory and +running make for help information. E.g.: + +$ cd tests +$ make +Run one of the following command lines: +make clean GC (to test using GC dll with C (no EH) applications) +make clean GCX (to test using GC dll with C++ (EH) applications) +make clean GCE (to test using GCE dll with C++ (EH) applications) +make clean GC-bench (to benchtest using GNU C dll with C cleanup code) +make clean GCE-bench (to benchtest using GNU C dll with C++ exception handling) +make clean GC-static (to test using GC static lib with C (no EH) applications) + + +Building under Linux using the Mingw32 cross development tools +-------------------------------------------------------------- + +You can build the library without leaving Linux by using the Mingw32 cross +development toolchain. See http://www.libsdl.org/extras/win32/cross/ for +tools and info. The GNUmakefile contains some support for this, for example: + +make CROSS=i386-mingw32msvc- clean GC-inlined + +will build pthreadGCn.dll and libpthreadGCn.a (n=version#), provided your +cross-tools/bin directory is in your PATH (or use the cross-make.sh script +at the URL above). + + +Building the library as a statically linkable library +----------------------------------------------------- + +General: PTW32_STATIC_LIB must be defined for both the library build and the +application build. The makefiles supplied and used by the following 'make' +command lines will define this for you. + +MSVC (creates pthreadVCn.lib as a static link lib): + +nmake clean VC-static + + +MinGW32 (creates libpthreadGCn.a as a static link lib): + +make clean GC-static + + +Define PTW32_STATIC_LIB when building your application. Also, your +application must call a two non-portable routines to initialise the +some state on startup and cleanup before exit. One other routine needs +to be called to cleanup after any Win32 threads have called POSIX API +routines. See README.NONPORTABLE or the html reference manual pages for +details on these routines: + +BOOL pthread_win32_process_attach_np (void); +BOOL pthread_win32_process_detach_np (void); +BOOL pthread_win32_thread_attach_np (void); // Currently a no-op +BOOL pthread_win32_thread_detach_np (void); + + +The tests makefiles have the same targets but only check that the +static library is statically linkable. They don't run the full +testsuite. To run the full testsuite, build the dlls and run the +dll test targets. + + +Building the library under Cygwin +--------------------------------- + +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 + pthreadVC.dll - built with MSVC compiler using C setjmp/longjmp + pthreadVC.lib + pthreadVCE.dll - built with MSVC++ compiler using C++ EH + pthreadVCE.lib + pthreadVSE.dll - built with MSVC compiler using SEH + pthreadVSE.lib + pthreadGC.dll - built with Mingw32 GCC + libpthreadGC.a - derived from pthreadGC.dll + pthreadGCE.dll - built with Mingw32 G++ + libpthreadGCE.a - derived from pthreadGCE.dll + +As of August 2003 pthreads-win32 pthreadG* versions are built and tested +using the MinGW + MsysDTK environment current as of that date or later. +The following file MAY be needed for older MinGW environments. + + gcc.dll - needed to build and run applications that use + pthreadGCE.dll. + + +Building applications with GNU compilers +---------------------------------------- + +If you're using pthreadGC.dll: + +With the three header files, pthreadGC.dll and libpthreadGC.a 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. -lpthreadGC + myapp + +Or put pthreadGC.dll in an appropriate directory in your PATH, +put libpthreadGC.a in your system lib directory, and +put the three header files in your system include directory, +then use: + + gcc -o myapp.exe myapp.c -lpthreadGC + myapp + + +If you're using pthreadGCE.dll: + +With the three header files, pthreadGCE.dll, gcc.dll and libpthreadGCE.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. -lpthreadGCE + myapp + +Or put pthreadGCE.dll and gcc.dll in an appropriate directory in +your PATH, put libpthreadGCE.a in your system lib directory, and +put the three header files in your system include directory, +then use: + + gcc -x c++ -o myapp.exe myapp.c -lpthreadGCE + 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 +---------------- + +See the ANNOUNCE file for acknowledgements. +See the 'CONTRIBUTORS' file for the list of contributors. + +As much as possible, the ChangeLog file attributes +contributions and patches that have been incorporated +in the library to the individuals responsible. + +Finally, thanks to all those who work on and contribute to the +POSIX and Single Unix Specification standards. The maturity of an +industry can be measured by it's open standards. + +---- +Ross Johnson + + + + + + + + + diff --git a/external/pthreads-w32/README.Borland b/external/pthreads-w32/README.Borland new file mode 100644 index 00000000..5f836cd1 --- /dev/null +++ b/external/pthreads-w32/README.Borland @@ -0,0 +1,57 @@ +In ptw32_InterlockedCompareExchange.c, I've added a section for +Borland's compiler; it's identical to that for the MS compiler except +that it uses /* ... */ comments instead of ; comments. + +[RPJ: need to define HAVE_TASM32 in config.h to use the above.] + + +The other file is a makefile suitable for use with Borland's compiler +(run "make -fBmakefile" in the directory). It builds a single version +of the library, pthreadBC.dll and the corresponding pthreadBC.lib +import library, which is comparable to the pthreadVC version; I can't +personally see any demand for the versions that include structured or +C++ exception cancellation handling so I haven't attempted to build +those versions of the library. (I imagine a static version might be +of use to some, but we can't legally use that on my commercial +projects so I can't try that out, unfortunately.) + +[RPJ: Added tests\Bmakefile as well.] + +Borland C++ doesn't define the ENOSYS constant used by pthreads-win32; +rather than make more extensive patches to the pthreads-win32 source I +have a mostly-arbitrary constant for it in the makefile. However this +doesn't make it visible to the application using the library, so if +anyone actually wants to use this constant in their apps (why?) +someone might like to make a seperate NEED_BCC_something define to add +this stuff. + +The makefile also #defines EDEADLK as EDEADLOCK, _timeb as timeb, and +_ftime as ftime, to deal with the minor differences between the two +RTLs' naming conventions, and sets the compiler flags as required to +get a normal compile of the library. + +[RPJ: Moved errno values and _timeb etc to pthread.h, so apps will also +use them.] + +(While I'm on the subject, the reason Borland users should recompile +the library, rather than using the impdef/implib technique suggested +previously on the mailing list, is that a) the errno constants are +different, so the results returned by the pthread_* functions can be +meaningless, and b) the errno variable/pseudo-variable itself is +different in the MS & BCC runtimes, so you can't access the +pthreadVC's errno from a Borland C++-compiled host application +correctly - I imagine there are other potential problems from the RTL +mismatch too.) + +[RPJ: Make sure you use the same RTL in both dll and application builds. +The dll and tests Bmakefiles use cw32mti.lib. Having some trouble with +memory read exceptions running the test suite using BCC55.] + +Best regards, +Will + +-- +Will Bryant +Systems Architect, eCOSM Limited +Cell +64 21 655 443, office +64 3 365 4176 +http://www.ecosm.com/ diff --git a/external/pthreads-w32/README.CV b/external/pthreads-w32/README.CV new file mode 100644 index 00000000..522fa602 --- /dev/null +++ b/external/pthreads-w32/README.CV @@ -0,0 +1,3036 @@ +README.CV -- Condition Variables +-------------------------------- + +The original implementation of condition variables in +pthreads-win32 was based on a discussion paper: + +"Strategies for Implementing POSIX Condition Variables +on Win32": http://www.cs.wustl.edu/~schmidt/win32-cv-1.html + +The changes suggested below were made on Feb 6 2001. This +file is included in the package for the benefit of anyone +interested in understanding the pthreads-win32 implementation +of condition variables and the (sometimes subtle) issues that +it attempts to resolve. + +Thanks go to the individuals whose names appear throughout +the following text. + +Ross Johnson + +-------------------------------------------------------------------- + +fyi.. (more detailed problem description/demos + possible fix/patch) + +regards, +alexander. + + +Alexander Terekhov +31.01.2001 17:43 + +To: ace-bugs@cs.wustl.edu +cc: +From: Alexander Terekhov/Germany/IBM@IBMDE +Subject: Implementation of POSIX CVs: spur.wakeups/lost + signals/deadlocks/unfairness + + + + ACE VERSION: + + 5.1.12 (pthread-win32 snapshot 2000-12-29) + + HOST MACHINE and OPERATING SYSTEM: + + IBM IntelliStation Z Pro, 2 x XEON 1GHz, Win2K + + TARGET MACHINE and OPERATING SYSTEM, if different from HOST: + COMPILER NAME AND VERSION (AND PATCHLEVEL): + + Microsoft Visual C++ 6.0 + + AREA/CLASS/EXAMPLE AFFECTED: + + Implementation of POSIX condition variables - OS.cpp/.h + + DOES THE PROBLEM AFFECT: + + EXECUTION? YES! + + SYNOPSIS: + + a) spurious wakeups (minor problem) + b) lost signals + c) broadcast deadlock + d) unfairness (minor problem) + + DESCRIPTION: + + Please see attached copy of discussion thread + from comp.programming.threads for more details on + some reported problems. (i've also posted a "fyi" + message to ace-users a week or two ago but + unfortunately did not get any response so far). + + It seems that current implementation suffers from + two essential problems: + + 1) cond.waiters_count does not accurately reflect + number of waiters blocked on semaphore - w/o + proper synchronisation that could result (in the + time window when counter is not accurate) + in spurious wakeups organised by subsequent + _signals and _broadcasts. + + 2) Always having (with no e.g. copy_and_clear/..) + the same queue in use (semaphore+counter) + neither signal nor broadcast provide 'atomic' + behaviour with respect to other threads/subsequent + calls to signal/broadcast/wait. + + Each problem and combination of both could produce + various nasty things: + + a) spurious wakeups (minor problem) + + it is possible that waiter(s) which was already + unblocked even so is still counted as blocked + waiter. signal and broadcast will release + semaphore which will produce a spurious wakeup + for a 'real' waiter coming later. + + b) lost signals + + signalling thread ends up consuming its own + signal. please see demo/discussion below. + + c) broadcast deadlock + + last_waiter processing code does not correctly + handle the case with multiple threads + waiting for the end of broadcast. + please see demo/discussion below. + + d) unfairness (minor problem) + + without SignalObjectAndWait some waiter(s) + may end up consuming broadcasted signals + multiple times (spurious wakeups) because waiter + thread(s) can be preempted before they call + semaphore wait (but after count++ and mtx.unlock). + + REPEAT BY: + + See below... run problem demos programs (tennis.cpp and + tennisb.cpp) number of times concurrently (on multiprocessor) + and in multiple sessions or just add a couple of "Sleep"s + as described in the attached copy of discussion thread + from comp.programming.threads + + SAMPLE FIX/WORKAROUND: + + See attached patch to pthread-win32.. well, I can not + claim that it is completely bug free but at least my + test and tests provided by pthreads-win32 seem to work. + Perhaps that will help. + + regards, + alexander. + + +>> Forum: comp.programming.threads +>> Thread: pthread_cond_* implementation questions +. +. +. +David Schwartz wrote: + +> terekhov@my-deja.com wrote: +> +>> BTW, could you please also share your view on other perceived +>> "problems" such as nested broadcast deadlock, spurious wakeups +>> and (the latest one) lost signals?? +> +>I'm not sure what you mean. The standard allows an implementation +>to do almost whatever it likes. In fact, you could implement +>pthread_cond_wait by releasing the mutex, sleeping a random +>amount of time, and then reacquiring the mutex. Of course, +>this would be a pretty poor implementation, but any code that +>didn't work under that implementation wouldn't be strictly +>compliant. + +The implementation you suggested is indeed correct +one (yes, now I see it :). However it requires from +signal/broadcast nothing more than to "{ return 0; }" +That is not the case for pthread-win32 and ACE +implementations. I do think that these implementations +(basically the same implementation) have some serious +problems with wait/signal/broadcast calls. I am looking +for help to clarify whether these problems are real +or not. I think that I can demonstrate what I mean +using one or two small sample programs. +. +. +. +========== +tennis.cpp +========== + +#include "ace/Synch.h" +#include "ace/Thread.h" + +enum GAME_STATE { + + START_GAME, + PLAYER_A, // Player A playes the ball + PLAYER_B, // Player B playes the ball + GAME_OVER, + ONE_PLAYER_GONE, + BOTH_PLAYERS_GONE + +}; + +enum GAME_STATE eGameState; +ACE_Mutex* pmtxGameStateLock; +ACE_Condition< ACE_Mutex >* pcndGameStateChange; + +void* + playerA( + void* pParm + ) +{ + + // For access to game state variable + pmtxGameStateLock->acquire(); + + // Play loop + while ( eGameState < GAME_OVER ) { + + // Play the ball + cout << endl << "PLAYER-A" << endl; + + // Now its PLAYER-B's turn + eGameState = PLAYER_B; + + // Signal to PLAYER-B that now it is his turn + pcndGameStateChange->signal(); + + // Wait until PLAYER-B finishes playing the ball + do { + + pcndGameStateChange->wait(); + + if ( PLAYER_B == eGameState ) + cout << endl << "----PLAYER-A: SPURIOUS WAKEUP!!!" << endl; + + } while ( PLAYER_B == eGameState ); + + } + + // PLAYER-A gone + eGameState = (GAME_STATE)(eGameState+1); + cout << endl << "PLAYER-A GONE" << endl; + + // No more access to state variable needed + pmtxGameStateLock->release(); + + // Signal PLAYER-A gone event + pcndGameStateChange->broadcast(); + + return 0; + +} + +void* + playerB( + void* pParm + ) +{ + + // For access to game state variable + pmtxGameStateLock->acquire(); + + // Play loop + while ( eGameState < GAME_OVER ) { + + // Play the ball + cout << endl << "PLAYER-B" << endl; + + // Now its PLAYER-A's turn + eGameState = PLAYER_A; + + // Signal to PLAYER-A that now it is his turn + pcndGameStateChange->signal(); + + // Wait until PLAYER-A finishes playing the ball + do { + + pcndGameStateChange->wait(); + + if ( PLAYER_A == eGameState ) + cout << endl << "----PLAYER-B: SPURIOUS WAKEUP!!!" << endl; + + } while ( PLAYER_A == eGameState ); + + } + + // PLAYER-B gone + eGameState = (GAME_STATE)(eGameState+1); + cout << endl << "PLAYER-B GONE" << endl; + + // No more access to state variable needed + pmtxGameStateLock->release(); + + // Signal PLAYER-B gone event + pcndGameStateChange->broadcast(); + + return 0; + +} + + +int +main (int, ACE_TCHAR *[]) +{ + + pmtxGameStateLock = new ACE_Mutex(); + pcndGameStateChange = new ACE_Condition< ACE_Mutex >( *pmtxGameStateLock +); + + // Set initial state + eGameState = START_GAME; + + // Create players + ACE_Thread::spawn( playerA ); + ACE_Thread::spawn( playerB ); + + // Give them 5 sec. to play + Sleep( 5000 );//sleep( 5 ); + + // Set game over state + pmtxGameStateLock->acquire(); + eGameState = GAME_OVER; + + // Let them know + pcndGameStateChange->broadcast(); + + // Wait for players to stop + do { + + pcndGameStateChange->wait(); + + } while ( eGameState < BOTH_PLAYERS_GONE ); + + // Cleanup + cout << endl << "GAME OVER" << endl; + pmtxGameStateLock->release(); + delete pcndGameStateChange; + delete pmtxGameStateLock; + + return 0; + +} + +=========== +tennisb.cpp +=========== +#include "ace/Synch.h" +#include "ace/Thread.h" + +enum GAME_STATE { + + START_GAME, + PLAYER_A, // Player A playes the ball + PLAYER_B, // Player B playes the ball + GAME_OVER, + ONE_PLAYER_GONE, + BOTH_PLAYERS_GONE + +}; + +enum GAME_STATE eGameState; +ACE_Mutex* pmtxGameStateLock; +ACE_Condition< ACE_Mutex >* pcndGameStateChange; + +void* + playerA( + void* pParm + ) +{ + + // For access to game state variable + pmtxGameStateLock->acquire(); + + // Play loop + while ( eGameState < GAME_OVER ) { + + // Play the ball + cout << endl << "PLAYER-A" << endl; + + // Now its PLAYER-B's turn + eGameState = PLAYER_B; + + // Signal to PLAYER-B that now it is his turn + pcndGameStateChange->broadcast(); + + // Wait until PLAYER-B finishes playing the ball + do { + + pcndGameStateChange->wait(); + + if ( PLAYER_B == eGameState ) + cout << endl << "----PLAYER-A: SPURIOUS WAKEUP!!!" << endl; + + } while ( PLAYER_B == eGameState ); + + } + + // PLAYER-A gone + eGameState = (GAME_STATE)(eGameState+1); + cout << endl << "PLAYER-A GONE" << endl; + + // No more access to state variable needed + pmtxGameStateLock->release(); + + // Signal PLAYER-A gone event + pcndGameStateChange->broadcast(); + + return 0; + +} + +void* + playerB( + void* pParm + ) +{ + + // For access to game state variable + pmtxGameStateLock->acquire(); + + // Play loop + while ( eGameState < GAME_OVER ) { + + // Play the ball + cout << endl << "PLAYER-B" << endl; + + // Now its PLAYER-A's turn + eGameState = PLAYER_A; + + // Signal to PLAYER-A that now it is his turn + pcndGameStateChange->broadcast(); + + // Wait until PLAYER-A finishes playing the ball + do { + + pcndGameStateChange->wait(); + + if ( PLAYER_A == eGameState ) + cout << endl << "----PLAYER-B: SPURIOUS WAKEUP!!!" << endl; + + } while ( PLAYER_A == eGameState ); + + } + + // PLAYER-B gone + eGameState = (GAME_STATE)(eGameState+1); + cout << endl << "PLAYER-B GONE" << endl; + + // No more access to state variable needed + pmtxGameStateLock->release(); + + // Signal PLAYER-B gone event + pcndGameStateChange->broadcast(); + + return 0; + +} + + +int +main (int, ACE_TCHAR *[]) +{ + + pmtxGameStateLock = new ACE_Mutex(); + pcndGameStateChange = new ACE_Condition< ACE_Mutex >( *pmtxGameStateLock +); + + // Set initial state + eGameState = START_GAME; + + // Create players + ACE_Thread::spawn( playerA ); + ACE_Thread::spawn( playerB ); + + // Give them 5 sec. to play + Sleep( 5000 );//sleep( 5 ); + + // Make some noise + pmtxGameStateLock->acquire(); + cout << endl << "---Noise ON..." << endl; + pmtxGameStateLock->release(); + for ( int i = 0; i < 100000; i++ ) + pcndGameStateChange->broadcast(); + cout << endl << "---Noise OFF" << endl; + + // Set game over state + pmtxGameStateLock->acquire(); + eGameState = GAME_OVER; + cout << endl << "---Stopping the game..." << endl; + + // Let them know + pcndGameStateChange->broadcast(); + + // Wait for players to stop + do { + + pcndGameStateChange->wait(); + + } while ( eGameState < BOTH_PLAYERS_GONE ); + + // Cleanup + cout << endl << "GAME OVER" << endl; + pmtxGameStateLock->release(); + delete pcndGameStateChange; + delete pmtxGameStateLock; + + return 0; + +} +. +. +. +David Schwartz wrote: +>> > It's compliant +>> +>> That is really good. +> +>> Tomorrow (I have to go urgently now) I will try to +>> demonstrate the lost-signal "problem" of current +>> pthread-win32 and ACE-(variant w/o SingleObjectAndWait) +>> implementations: players start suddenly drop their balls :-) +>> (with no change in source code). +> +>Signals aren't lost, they're going to the main thread, +>which isn't coded correctly to handle them. Try this: +> +> // Wait for players to stop +> do { +> +> pthread_cond_wait( &cndGameStateChange,&mtxGameStateLock ); +>printf("Main thread stole a signal\n"); +> +> } while ( eGameState < BOTH_PLAYERS_GONE ); +> +>I bet everytime you thing a signal is lost, you'll see that printf. +>The signal isn't lost, it was stolen by another thread. + +well, you can probably loose your bet.. it was indeed stolen +by "another" thread but not the one you seem to think of. + +I think that what actually happens is the following: + +H:\SA\UXX\pt\PTHREADS\TESTS>tennis3.exe + +PLAYER-A + +PLAYER-B + +----PLAYER-B: SPURIOUS WAKEUP!!! + +PLAYER-A GONE + +PLAYER-B GONE + +GAME OVER + +H:\SA\UXX\pt\PTHREADS\TESTS> + +here you can see that PLAYER-B after playing his first +ball (which came via signal from PLAYER-A) just dropped +it down. What happened is that his signal to player A +was consumed as spurious wakeup by himself (player B). + +The implementation has a problem: + +================ +waiting threads: +================ + +{ /** Critical Section + + inc cond.waiters_count + +} + + /* + /* Atomic only if using Win32 SignalObjectAndWait + /* + cond.mtx.release + + /*** ^^-- A THREAD WHICH DID SIGNAL MAY ACQUIRE THE MUTEX, + /*** GO INTO WAIT ON THE SAME CONDITION AND OVERTAKE + /*** ORIGINAL WAITER(S) CONSUMING ITS OWN SIGNAL! + + cond.sem.wait + +Player-A after playing game's initial ball went into +wait (called _wait) but was pre-empted before reaching +wait semaphore. He was counted as waiter but was not +actually waiting/blocked yet. + +=============== +signal threads: +=============== + +{ /** Critical Section + + waiters_count = cond.waiters_count + +} + + if ( waiters_count != 0 ) + + sem.post 1 + + endif + +Player-B after he received signal/ball from Player A +called _signal. The _signal did see that there was +one waiter blocked on the condition (Player-A) and +released the semaphore.. (but it did not unblock +Player-A because he was not actually blocked). +Player-B thread continued its execution, called _wait, +was counted as second waiter BUT was allowed to slip +through opened semaphore gate (which was opened for +Player-B) and received his own signal. Player B remained +blocked followed by Player A. Deadlock happened which +lasted until main thread came in and said game over. + +It seems to me that the implementation fails to +correctly implement the following statement +from specification: + +http://www.opengroup.org/ +onlinepubs/007908799/xsh/pthread_cond_wait.html + +"These functions atomically release mutex and cause +the calling thread to block on the condition variable +cond; atomically here means "atomically with respect +to access by another thread to the mutex and then the +condition variable". That is, if another thread is +able to acquire the mutex after the about-to-block +thread has released it, then a subsequent call to +pthread_cond_signal() or pthread_cond_broadcast() +in that thread behaves as if it were issued after +the about-to-block thread has blocked." + +Question: Am I right? + +(I produced the program output above by simply +adding ?Sleep( 1 )?: + +================ +waiting threads: +================ + +{ /** Critical Section + + inc cond.waiters_count + +} + + /* + /* Atomic only if using Win32 SignalObjectAndWait + /* + cond.mtx.release + +Sleep( 1 ); // Win32 + + /*** ^^-- A THREAD WHICH DID SIGNAL MAY ACQUIRE THE MUTEX, + /*** GO INTO WAIT ON THE SAME CONDITION AND OVERTAKE + /*** ORIGINAL WAITER(S) CONSUMING ITS OWN SIGNAL! + + cond.sem.wait + +to the source code of pthread-win32 implementation: + +http://sources.redhat.com/cgi-bin/cvsweb.cgi/pthreads/ +condvar.c?rev=1.36&content-type=text/ +x-cvsweb-markup&cvsroot=pthreads-win32 + + + /* + * We keep the lock held just long enough to increment the count of + * waiters by one (above). + * Note that we can't keep it held across the + * call to sem_wait since that will deadlock other calls + * to pthread_cond_signal + */ + cleanup_args.mutexPtr = mutex; + cleanup_args.cv = cv; + cleanup_args.resultPtr = &result; + + pthread_cleanup_push (ptw32_cond_wait_cleanup, (void *) +&cleanup_args); + + if ((result = pthread_mutex_unlock (mutex)) == 0) + {((result +Sleep( 1 ); // @AT + + /* + * Wait to be awakened by + * pthread_cond_signal, or + * pthread_cond_broadcast, or + * a timeout + * + * Note: + * ptw32_sem_timedwait is a cancelation point, + * hence providing the + * mechanism for making pthread_cond_wait a cancelation + * point. We use the cleanup mechanism to ensure we + * re-lock the mutex and decrement the waiters count + * if we are canceled. + */ + if (ptw32_sem_timedwait (&(cv->sema), abstime) == -1) { + result = errno; + } + } + + pthread_cleanup_pop (1); /* Always cleanup */ + + +BTW, on my system (2 CPUs) I can manage to get +signals lost even without any source code modification +if I run the tennis program many times in different +shell sessions. +. +. +. +David Schwartz wrote: +>terekhov@my-deja.com wrote: +> +>> well, it might be that the program is in fact buggy. +>> but you did not show me any bug. +> +>You're right. I was close but not dead on. I was correct, however, +>that the code is buggy because it uses 'pthread_cond_signal' even +>though not any thread waiting on the condition variable can do the +>job. I was wrong in which thread could be waiting on the cv but +>unable to do the job. + +Okay, lets change 'pthread_cond_signal' to 'pthread_cond_broadcast' +but also add some noise from main() right before declaring the game +to be over (I need it in order to demonstrate another problem of +pthread-win32/ACE implementations - broadcast deadlock)... +. +. +. +It is my understanding of POSIX conditions, +that on correct implementation added noise +in form of unnecessary broadcasts from main, +should not break the tennis program. The +only 'side effect' of added noise on correct +implementation would be 'spurious wakeups' of +players (in fact they are not spurious, +players just see them as spurious) unblocked, +not by another player but by main before +another player had a chance to acquire the +mutex and change the game state variable: +. +. +. + +PLAYER-B + +PLAYER-A + +---Noise ON... + +PLAYER-B + +PLAYER-A + +. +. +. + +PLAYER-B + +PLAYER-A + +----PLAYER-A: SPURIOUS WAKEUP!!! + +PLAYER-B + +PLAYER-A + +---Noise OFF + +PLAYER-B + +---Stopping the game... + +PLAYER-A GONE + +PLAYER-B GONE + +GAME OVER + +H:\SA\UXX\pt\PTHREADS\TESTS> + +On pthread-win32/ACE implementations the +program could stall: + +. +. +. + +PLAYER-A + +PLAYER-B + +PLAYER-A + +PLAYER-B + +PLAYER-A + +PLAYER-B + +PLAYER-A + +PLAYER-B + +---Noise ON... + +PLAYER-A + +---Noise OFF +^C +H:\SA\UXX\pt\PTHREADS\TESTS> + + +The implementation has problems: + +================ +waiting threads: +================ + +{ /** Critical Section + + inc cond.waiters_count + +} + + /* + /* Atomic only if using Win32 SignalObjectAndWait + /* + cond.mtx.release + cond.sem.wait + + /*** ^^-- WAITER CAN BE PREEMPTED AFTER BEING UNBLOCKED... + +{ /** Critical Section + + dec cond.waiters_count + + /*** ^^- ...AND BEFORE DECREMENTING THE COUNT (1) + + last_waiter = ( cond.was_broadcast && + cond.waiters_count == 0 ) + + if ( last_waiter ) + + cond.was_broadcast = FALSE + + endif + +} + + if ( last_waiter ) + + /* + /* Atomic only if using Win32 SignalObjectAndWait + /* + cond.auto_reset_event_or_sem.post /* Event for Win32 + cond.mtx.acquire + + /*** ^^-- ...AND BEFORE CALL TO mtx.acquire (2) + + /*** ^^-- NESTED BROADCASTS RESULT IN A DEADLOCK + + + else + + cond.mtx.acquire + + /*** ^^-- ...AND BEFORE CALL TO mtx.acquire (3) + + endif + + +================== +broadcast threads: +================== + +{ /** Critical Section + + waiters_count = cond.waiters_count + + if ( waiters_count != 0 ) + + cond.was_broadcast = TRUE + + endif + +} + +if ( waiters_count != 0 ) + + cond.sem.post waiters_count + + /*** ^^^^^--- SPURIOUS WAKEUPS DUE TO (1) + + cond.auto_reset_event_or_sem.wait /* Event for Win32 + + /*** ^^^^^--- DEADLOCK FOR FURTHER BROADCASTS IF THEY + HAPPEN TO GO INTO WAIT WHILE PREVIOUS + BROADCAST IS STILL IN PROGRESS/WAITING + +endif + +a) cond.waiters_count does not accurately reflect +number of waiters blocked on semaphore - that could +result (in the time window when counter is not accurate) +in spurios wakeups organised by subsequent _signals +and _broadcasts. From standard compliance point of view +that is OK but that could be a real problem from +performance/efficiency point of view. + +b) If subsequent broadcast happen to go into wait on +cond.auto_reset_event_or_sem before previous +broadcast was unblocked from cond.auto_reset_event_or_sem +by its last waiter, one of two blocked threads will +remain blocked because last_waiter processing code +fails to unblock both threads. + +In the situation with tennisb.c the Player-B was put +in a deadlock by noise (broadcast) coming from main +thread. And since Player-B holds the game state +mutex when it calls broadcast, the whole program +stalled: Player-A was deadlocked on mutex and +main thread after finishing with producing the noise +was deadlocked on mutex too (needed to declare the +game over) + +(I produced the program output above by simply +adding ?Sleep( 1 )?: + +================== +broadcast threads: +================== + +{ /** Critical Section + + waiters_count = cond.waiters_count + + if ( waiters_count != 0 ) + + cond.was_broadcast = TRUE + + endif + +} + +if ( waiters_count != 0 ) + +Sleep( 1 ); //Win32 + + cond.sem.post waiters_count + + /*** ^^^^^--- SPURIOUS WAKEUPS DUE TO (1) + + cond.auto_reset_event_or_sem.wait /* Event for Win32 + + /*** ^^^^^--- DEADLOCK FOR FURTHER BROADCASTS IF THEY + HAPPEN TO GO INTO WAIT WHILE PREVIOUS + BROADCAST IS STILL IN PROGRESS/WAITING + +endif + +to the source code of pthread-win32 implementation: + +http://sources.redhat.com/cgi-bin/cvsweb.cgi/pthreads/ +condvar.c?rev=1.36&content-type=text/ +x-cvsweb-markup&cvsroot=pthreads-win32 + + if (wereWaiters) + {(wereWaiters)sroot=pthreads-win32eb.cgi/pthreads/Yem...m + /* + * Wake up all waiters + */ + +Sleep( 1 ); //@AT + +#ifdef NEED_SEM + + result = (ptw32_increase_semaphore( &cv->sema, cv->waiters ) + ? 0 + : EINVAL); + +#else /* NEED_SEM */ + + result = (ReleaseSemaphore( cv->sema, cv->waiters, NULL ) + ? 0 + : EINVAL); + +#endif /* NEED_SEM */ + + } + + (void) pthread_mutex_unlock(&(cv->waitersLock)); + + if (wereWaiters && result == 0) + {(wereWaiters + /* + * Wait for all the awakened threads to acquire their part of + * the counting semaphore + */ + + if (WaitForSingleObject (cv->waitersDone, INFINITE) + == WAIT_OBJECT_0) + { + result = 0; + } + else + { + result = EINVAL; + } + + } + + return (result); + +} + +BTW, on my system (2 CPUs) I can manage to get +the program stalled even without any source code +modification if I run the tennisb program many +times in different shell sessions. + +=================== +pthread-win32 patch +=================== +struct pthread_cond_t_ { + long nWaitersBlocked; /* Number of threads blocked +*/ + long nWaitersUnblocked; /* Number of threads unblocked +*/ + long nWaitersToUnblock; /* Number of threads to unblock +*/ + sem_t semBlockQueue; /* Queue up threads waiting for the +*/ + /* condition to become signalled +*/ + sem_t semBlockLock; /* Semaphore that guards access to +*/ + /* | waiters blocked count/block queue +*/ + /* +-> Mandatory Sync.LEVEL-1 +*/ + pthread_mutex_t mtxUnblockLock; /* Mutex that guards access to +*/ + /* | waiters (to)unblock(ed) counts +*/ + /* +-> Optional* Sync.LEVEL-2 +*/ +}; /* Opt*) for _timedwait and +cancellation*/ + +int +pthread_cond_init (pthread_cond_t * cond, const pthread_condattr_t * attr) + int result = EAGAIN; + pthread_cond_t cv = NULL; + + if (cond == NULL) + {(cond + return EINVAL; + } + + if ((attr != NULL && *attr != NULL) && + ((*attr)->pshared == PTHREAD_PROCESS_SHARED)) + { + /* + * Creating condition variable that can be shared between + * processes. + */ + result = ENOSYS; + + goto FAIL0; + } + + cv = (pthread_cond_t) calloc (1, sizeof (*cv)); + + if (cv == NULL) + {(cv + result = ENOMEM; + goto FAIL0; + } + + cv->nWaitersBlocked = 0; + cv->nWaitersUnblocked = 0; + cv->nWaitersToUnblock = 0; + + if (sem_init (&(cv->semBlockLock), 0, 1) != 0) + {(sem_init + goto FAIL0; + } + + if (sem_init (&(cv->semBlockQueue), 0, 0) != 0) + {(sem_init + goto FAIL1; + } + + if (pthread_mutex_init (&(cv->mtxUnblockLock), 0) != 0) + {(pthread_mutex_init + goto FAIL2; + } + + + result = 0; + + goto DONE; + + /* + * ------------- + * Failed... + * ------------- + */ +FAIL2: + (void) sem_destroy (&(cv->semBlockQueue)); + +FAIL1: + (void) sem_destroy (&(cv->semBlockLock)); + +FAIL0: +DONE: + *cond = cv; + + return (result); + +} /* pthread_cond_init */ + +int +pthread_cond_destroy (pthread_cond_t * cond) +{ + int result = 0; + pthread_cond_t cv; + + /* + * Assuming any race condition here is harmless. + */ + if (cond == NULL + || *cond == NULL) + { + return EINVAL; + } + + if (*cond != (pthread_cond_t) PTW32_OBJECT_AUTO_INIT) + {(*cond + cv = *cond; + + /* + * Synchronize access to waiters blocked count (LEVEL-1) + */ + if (sem_wait(&(cv->semBlockLock)) != 0) + {(sem_wait(&(cv->semBlockLock)) + return errno; + } + + /* + * Synchronize access to waiters (to)unblock(ed) counts (LEVEL-2) + */ + if ((result = pthread_mutex_lock(&(cv->mtxUnblockLock))) != 0) + {((result + (void) sem_post(&(cv->semBlockLock)); + return result; + } + + /* + * Check whether cv is still busy (still has waiters blocked) + */ + if (cv->nWaitersBlocked - cv->nWaitersUnblocked > 0) + {(cv->nWaitersBlocked + (void) sem_post(&(cv->semBlockLock)); + (void) pthread_mutex_unlock(&(cv->mtxUnblockLock)); + return EBUSY; + } + + /* + * Now it is safe to destroy + */ + (void) sem_destroy (&(cv->semBlockLock)); + (void) sem_destroy (&(cv->semBlockQueue)); + (void) pthread_mutex_unlock (&(cv->mtxUnblockLock)); + (void) pthread_mutex_destroy (&(cv->mtxUnblockLock)); + + free(cv); + *cond = NULL; + } + else + { + /* + * See notes in ptw32_cond_check_need_init() above also. + */ + EnterCriticalSection(&ptw32_cond_test_init_lock); + + /* + * Check again. + */ + if (*cond == (pthread_cond_t) PTW32_OBJECT_AUTO_INIT) + {(*cond + /* + * This is all we need to do to destroy a statically + * initialised cond that has not yet been used (initialised). + * If we get to here, another thread + * waiting to initialise this cond will get an EINVAL. + */ + *cond = NULL; + } + else + { + /* + * The cv has been initialised while we were waiting + * so assume it's in use. + */ + result = EBUSY; + } + + LeaveCriticalSection(&ptw32_cond_test_init_lock); + } + + return (result); +} + +/* + * Arguments for cond_wait_cleanup, since we can only pass a + * single void * to it. + */ +typedef struct { + pthread_mutex_t * mutexPtr; + pthread_cond_t cv; + int * resultPtr; +} ptw32_cond_wait_cleanup_args_t; + +static void +ptw32_cond_wait_cleanup(void * args) +{ + ptw32_cond_wait_cleanup_args_t * cleanup_args = +(ptw32_cond_wait_cleanup_args_t *) args; + pthread_cond_t cv = cleanup_args->cv; + int * resultPtr = cleanup_args->resultPtr; + int eLastSignal; /* enum: 1=yes 0=no -1=cancelled/timedout w/o signal(s) +*/ + int result; + + /* + * Whether we got here as a result of signal/broadcast or because of + * timeout on wait or thread cancellation we indicate that we are no + * longer waiting. The waiter is responsible for adjusting waiters + * (to)unblock(ed) counts (protected by unblock lock). + * Unblock lock/Sync.LEVEL-2 supports _timedwait and cancellation. + */ + if ((result = pthread_mutex_lock(&(cv->mtxUnblockLock))) != 0) + {((result + *resultPtr = result; + return; + } + + cv->nWaitersUnblocked++; + + eLastSignal = (cv->nWaitersToUnblock == 0) ? + -1 : (--cv->nWaitersToUnblock == 0); + + /* + * No more LEVEL-2 access to waiters (to)unblock(ed) counts needed + */ + if ((result = pthread_mutex_unlock(&(cv->mtxUnblockLock))) != 0) + {((result + *resultPtr = result; + return; + } + + /* + * If last signal... + */ + if (eLastSignal == 1) + {(eLastSignal + /* + * ...it means that we have end of 'atomic' signal/broadcast + */ + if (sem_post(&(cv->semBlockLock)) != 0) + {(sem_post(&(cv->semBlockLock)) + *resultPtr = errno; + return; + } + } + /* + * If not last signal and not timed out/cancelled wait w/o signal... + */ + else if (eLastSignal == 0) + { + /* + * ...it means that next waiter can go through semaphore + */ + if (sem_post(&(cv->semBlockQueue)) != 0) + {(sem_post(&(cv->semBlockQueue)) + *resultPtr = errno; + return; + } + } + + /* + * XSH: Upon successful return, the mutex has been locked and is owned + * by the calling thread + */ + if ((result = pthread_mutex_lock(cleanup_args->mutexPtr)) != 0) + {((result + *resultPtr = result; + } + +} /* ptw32_cond_wait_cleanup */ + +static int +ptw32_cond_timedwait (pthread_cond_t * cond, + pthread_mutex_t * mutex, + const struct timespec *abstime) +{ + int result = 0; + pthread_cond_t cv; + ptw32_cond_wait_cleanup_args_t cleanup_args; + + if (cond == NULL || *cond == NULL) + {(cond + return EINVAL; + } + + /* + * We do a quick check to see if we need to do more work + * to initialise a static condition variable. We check + * again inside the guarded section of ptw32_cond_check_need_init() + * to avoid race conditions. + */ + if (*cond == (pthread_cond_t) PTW32_OBJECT_AUTO_INIT) + {(*cond + result = ptw32_cond_check_need_init(cond); + } + + if (result != 0 && result != EBUSY) + {(result + return result; + } + + cv = *cond; + + /* + * Synchronize access to waiters blocked count (LEVEL-1) + */ + if (sem_wait(&(cv->semBlockLock)) != 0) + {(sem_wait(&(cv->semBlockLock)) + return errno; + } + + cv->nWaitersBlocked++; + + /* + * Thats it. Counted means waiting, no more access needed + */ + if (sem_post(&(cv->semBlockLock)) != 0) + {(sem_post(&(cv->semBlockLock)) + return errno; + } + + /* + * Setup this waiter cleanup handler + */ + cleanup_args.mutexPtr = mutex; + cleanup_args.cv = cv; + cleanup_args.resultPtr = &result; + + pthread_cleanup_push (ptw32_cond_wait_cleanup, (void *) &cleanup_args); + + /* + * Now we can release 'mutex' and... + */ + if ((result = pthread_mutex_unlock (mutex)) == 0) + {((result + + /* + * ...wait to be awakened by + * pthread_cond_signal, or + * pthread_cond_broadcast, or + * timeout, or + * thread cancellation + * + * Note: + * + * ptw32_sem_timedwait is a cancellation point, + * hence providing the mechanism for making + * pthread_cond_wait a cancellation point. + * We use the cleanup mechanism to ensure we + * re-lock the mutex and adjust (to)unblock(ed) waiters + * counts if we are cancelled, timed out or signalled. + */ + if (ptw32_sem_timedwait (&(cv->semBlockQueue), abstime) != 0) + {(ptw32_sem_timedwait + result = errno; + } + } + + /* + * Always cleanup + */ + pthread_cleanup_pop (1); + + + /* + * "result" can be modified by the cleanup handler. + */ + return (result); + +} /* ptw32_cond_timedwait */ + + +static int +ptw32_cond_unblock (pthread_cond_t * cond, + int unblockAll) +{ + int result; + pthread_cond_t cv; + + if (cond == NULL || *cond == NULL) + {(cond + return EINVAL; + } + + cv = *cond; + + /* + * No-op if the CV is static and hasn't been initialised yet. + * Assuming that any race condition is harmless. + */ + if (cv == (pthread_cond_t) PTW32_OBJECT_AUTO_INIT) + {(cv + return 0; + } + + /* + * Synchronize access to waiters blocked count (LEVEL-1) + */ + if (sem_wait(&(cv->semBlockLock)) != 0) + {(sem_wait(&(cv->semBlockLock)) + return errno; + } + + /* + * Synchronize access to waiters (to)unblock(ed) counts (LEVEL-2) + * This sync.level supports _timedwait and cancellation + */ + if ((result = pthread_mutex_lock(&(cv->mtxUnblockLock))) != 0) + {((result + return result; + } + + /* + * Adjust waiters blocked and unblocked counts (collect garbage) + */ + if (cv->nWaitersUnblocked != 0) + {(cv->nWaitersUnblocked + cv->nWaitersBlocked -= cv->nWaitersUnblocked; + cv->nWaitersUnblocked = 0; + } + + /* + * If (after adjustment) there are still some waiters blocked counted... + */ + if ( cv->nWaitersBlocked > 0) + {( + /* + * We will unblock first waiter and leave semBlockLock/LEVEL-1 locked + * LEVEL-1 access is left disabled until last signal/unblock +completes + */ + cv->nWaitersToUnblock = (unblockAll) ? cv->nWaitersBlocked : 1; + + /* + * No more LEVEL-2 access to waiters (to)unblock(ed) counts needed + * This sync.level supports _timedwait and cancellation + */ + if ((result = pthread_mutex_unlock(&(cv->mtxUnblockLock))) != 0) + {((result + return result; + } + + + /* + * Now, with LEVEL-2 lock released let first waiter go through +semaphore + */ + if (sem_post(&(cv->semBlockQueue)) != 0) + {(sem_post(&(cv->semBlockQueue)) + return errno; + } + } + /* + * No waiter blocked - no more LEVEL-1 access to blocked count needed... + */ + else if (sem_post(&(cv->semBlockLock)) != 0) + { + return errno; + } + /* + * ...and no more LEVEL-2 access to waiters (to)unblock(ed) counts needed +too + * This sync.level supports _timedwait and cancellation + */ + else + { + result = pthread_mutex_unlock(&(cv->mtxUnblockLock)); + } + + return(result); + +} /* ptw32_cond_unblock */ + +int +pthread_cond_wait (pthread_cond_t * cond, + pthread_mutex_t * mutex) +{ + /* The NULL abstime arg means INFINITE waiting. */ + return(ptw32_cond_timedwait(cond, mutex, NULL)); +} /* pthread_cond_wait */ + + +int +pthread_cond_timedwait (pthread_cond_t * cond, + pthread_mutex_t * mutex, + const struct timespec *abstime) +{ + if (abstime == NULL) + {(abstime + return EINVAL; + } + + return(ptw32_cond_timedwait(cond, mutex, abstime)); +} /* pthread_cond_timedwait */ + + +int +pthread_cond_signal (pthread_cond_t * cond) +{ + /* The '0'(FALSE) unblockAll arg means unblock ONE waiter. */ + return(ptw32_cond_unblock(cond, 0)); +} /* pthread_cond_signal */ + +int +pthread_cond_broadcast (pthread_cond_t * cond) +{ + /* The '1'(TRUE) unblockAll arg means unblock ALL waiters. */ + return(ptw32_cond_unblock(cond, 1)); +} /* pthread_cond_broadcast */ + + + + +TEREKHOV@de.ibm.com on 17.01.2001 01:00:57 + +Please respond to TEREKHOV@de.ibm.com + +To: pthreads-win32@sourceware.cygnus.com +cc: schmidt@uci.edu +Subject: win32 conditions: sem+counter+event = broadcast_deadlock + + spur.wakeup/unfairness/incorrectness ?? + + + + + + + +Hi, + +Problem 1: broadcast_deadlock + +It seems that current implementation does not provide "atomic" +broadcasts. That may lead to "nested" broadcasts... and it seems +that nested case is not handled correctly -> producing a broadcast +DEADLOCK as a result. + +Scenario: + +N (>1) waiting threads W1..N are blocked (in _wait) on condition's +semaphore. + +Thread B1 calls pthread_cond_broadcast, which results in "releasing" N +W threads via incrementing semaphore counter by N (stored in +cv->waiters) BUT cv->waiters counter does not change!! The caller +thread B1 remains blocked on cv->waitersDone event (auto-reset!!) BUT +condition is not protected from starting another broadcast (when called +on another thread) while still waiting for the "old" broadcast to +complete on thread B1. + +M (>=0, waiters counter. + +L (N-M) "late" waiter W threads are a) still blocked/not returned from +their semaphore wait call or b) were preempted after sem_wait but before +lock( &cv->waitersLock ) or c) are blocked on cv->waitersLock. + +cv->waiters is still > 0 (= L). + +Another thread B2 (or some W thread from M group) calls +pthread_cond_broadcast and gains access to counter... neither a) nor b) +prevent thread B2 in pthread_cond_broadcast from gaining access to +counter and starting another broadcast ( for c) - it depends on +cv->waitersLock scheduling rules: FIFO=OK, PRTY=PROBLEM,... ) + +That call to pthread_cond_broadcast (on thread B2) will result in +incrementing semaphore by cv->waiters (=L) which is INCORRECT (all +W1..N were in fact already released by thread B1) and waiting on +_auto-reset_ event cv->waitersDone which is DEADLY WRONG (produces a +deadlock)... + +All late W1..L threads now have a chance to complete their _wait call. +Last W_L thread sets an auto-reselt event cv->waitersDone which will +release either B1 or B2 leaving one of B threads in a deadlock. + +Problem 2: spur.wakeup/unfairness/incorrectness + +It seems that: + +a) because of the same problem with counter which does not reflect the +actual number of NOT RELEASED waiters, the signal call may increment +a semaphore counter w/o having a waiter blocked on it. That will result +in (best case) spurious wake ups - performance degradation due to +unnecessary context switches and predicate re-checks and (in worth case) +unfairness/incorrectness problem - see b) + +b) neither signal nor broadcast prevent other threads - "new waiters" +(and in the case of signal, the caller thread as well) from going into +_wait and overtaking "old" waiters (already released but still not returned +from sem_wait on condition's semaphore). Win semaphore just [API DOC]: +"Maintains a count between zero and some maximum value, limiting the number +of threads that are simultaneously accessing a shared resource." Calling +ReleaseSemaphore does not imply (at least not documented) that on return +from ReleaseSemaphore all waiters will in fact become released (returned +from their Wait... call) and/or that new waiters calling Wait... afterwards +will become less importance. It is NOT documented to be an atomic release +of +waiters... And even if it would be there is still a problem with a thread +being preempted after Wait on semaphore and before Wait on cv->waitersLock +and scheduling rules for cv->waitersLock itself +(??WaitForMultipleObjects??) +That may result in unfairness/incorrectness problem as described +for SetEvent impl. in "Strategies for Implementing POSIX Condition +Variables +on Win32": http://www.cs.wustl.edu/~schmidt/win32-cv-1.html + +Unfairness -- The semantics of the POSIX pthread_cond_broadcast function is +to wake up all threads currently blocked in wait calls on the condition +variable. The awakened threads then compete for the external_mutex. To +ensure +fairness, all of these threads should be released from their +pthread_cond_wait calls and allowed to recheck their condition expressions +before other threads can successfully complete a wait on the condition +variable. + +Unfortunately, the SetEvent implementation above does not guarantee that +all +threads sleeping on the condition variable when cond_broadcast is called +will +acquire the external_mutex and check their condition expressions. Although +the Pthreads specification does not mandate this degree of fairness, the +lack of fairness can cause starvation. + +To illustrate the unfairness problem, imagine there are 2 threads, C1 and +C2, +that are blocked in pthread_cond_wait on condition variable not_empty_ that +is guarding a thread-safe message queue. Another thread, P1 then places two +messages onto the queue and calls pthread_cond_broadcast. If C1 returns +from +pthread_cond_wait, dequeues and processes the message, and immediately +waits +again then it and only it may end up acquiring both messages. Thus, C2 will +never get a chance to dequeue a message and run. + +The following illustrates the sequence of events: + +1. Thread C1 attempts to dequeue and waits on CV non_empty_ +2. Thread C2 attempts to dequeue and waits on CV non_empty_ +3. Thread P1 enqueues 2 messages and broadcasts to CV not_empty_ +4. Thread P1 exits +5. Thread C1 wakes up from CV not_empty_, dequeues a message and runs +6. Thread C1 waits again on CV not_empty_, immediately dequeues the 2nd + message and runs +7. Thread C1 exits +8. Thread C2 is the only thread left and blocks forever since + not_empty_ will never be signaled + +Depending on the algorithm being implemented, this lack of fairness may +yield +concurrent programs that have subtle bugs. Of course, application +developers +should not rely on the fairness semantics of pthread_cond_broadcast. +However, +there are many cases where fair implementations of condition variables can +simplify application code. + +Incorrectness -- A variation on the unfairness problem described above +occurs +when a third consumer thread, C3, is allowed to slip through even though it +was not waiting on condition variable not_empty_ when a broadcast occurred. + +To illustrate this, we will use the same scenario as above: 2 threads, C1 +and +C2, are blocked dequeuing messages from the message queue. Another thread, +P1 +then places two messages onto the queue and calls pthread_cond_broadcast. +C1 +returns from pthread_cond_wait, dequeues and processes the message. At this +time, C3 acquires the external_mutex, calls pthread_cond_wait and waits on +the events in WaitForMultipleObjects. Since C2 has not had a chance to run +yet, the BROADCAST event is still signaled. C3 then returns from +WaitForMultipleObjects, and dequeues and processes the message in the +queue. +Thus, C2 will never get a chance to dequeue a message and run. + +The following illustrates the sequence of events: + +1. Thread C1 attempts to dequeue and waits on CV non_empty_ +2. Thread C2 attempts to dequeue and waits on CV non_empty_ +3. Thread P1 enqueues 2 messages and broadcasts to CV not_empty_ +4. Thread P1 exits +5. Thread C1 wakes up from CV not_empty_, dequeues a message and runs +6. Thread C1 exits +7. Thread C3 waits on CV not_empty_, immediately dequeues the 2nd + message and runs +8. Thread C3 exits +9. Thread C2 is the only thread left and blocks forever since + not_empty_ will never be signaled + +In the above case, a thread that was not waiting on the condition variable +when a broadcast occurred was allowed to proceed. This leads to incorrect +semantics for a condition variable. + + +COMMENTS??? + +regards, +alexander. + +----------------------------------------------------------------------------- + +Subject: RE: FYI/comp.programming.threads/Re: pthread_cond_* + implementation questions +Date: Wed, 21 Feb 2001 11:54:47 +0100 +From: TEREKHOV@de.ibm.com +To: lthomas@arbitrade.com +CC: rpj@ise.canberra.edu.au, Thomas Pfaff , + Nanbor Wang + +Hi Louis, + +generation number 8.. + +had some time to revisit timeouts/spurious wakeup problem.. +found some bugs (in 7.b/c/d) and something to improve +(7a - using IPC semaphores but it should speedup Win32 +version as well). + +regards, +alexander. + +---------- Algorithm 8a / IMPL_SEM,UNBLOCK_STRATEGY == UNBLOCK_ALL ------ +given: +semBlockLock - bin.semaphore +semBlockQueue - semaphore +mtxExternal - mutex or CS +mtxUnblockLock - mutex or CS +nWaitersGone - int +nWaitersBlocked - int +nWaitersToUnblock - int + +wait( timeout ) { + + [auto: register int result ] // error checking omitted + [auto: register int nSignalsWasLeft ] + [auto: register int nWaitersWasGone ] + + sem_wait( semBlockLock ); + nWaitersBlocked++; + sem_post( semBlockLock ); + + unlock( mtxExternal ); + bTimedOut = sem_wait( semBlockQueue,timeout ); + + lock( mtxUnblockLock ); + if ( 0 != (nSignalsWasLeft = nWaitersToUnblock) ) { + if ( bTimeout ) { // timeout (or canceled) + if ( 0 != nWaitersBlocked ) { + nWaitersBlocked--; + } + else { + nWaitersGone++; // count spurious wakeups + } + } + if ( 0 == --nWaitersToUnblock ) { + if ( 0 != nWaitersBlocked ) { + sem_post( semBlockLock ); // open the gate + nSignalsWasLeft = 0; // do not open the gate below +again + } + else if ( 0 != (nWaitersWasGone = nWaitersGone) ) { + nWaitersGone = 0; + } + } + } + else if ( INT_MAX/2 == ++nWaitersGone ) { // timeout/canceled or spurious +semaphore :-) + sem_wait( semBlockLock ); + nWaitersBlocked -= nWaitersGone; // something is going on here - +test of timeouts? :-) + sem_post( semBlockLock ); + nWaitersGone = 0; + } + unlock( mtxUnblockLock ); + + if ( 1 == nSignalsWasLeft ) { + if ( 0 != nWaitersWasGone ) { + // sem_adjust( -nWaitersWasGone ); + while ( nWaitersWasGone-- ) { + sem_wait( semBlockLock ); // better now than spurious +later + } + } + sem_post( semBlockLock ); // open the gate + } + + lock( mtxExternal ); + + return ( bTimedOut ) ? ETIMEOUT : 0; +} + +signal(bAll) { + + [auto: register int result ] + [auto: register int nSignalsToIssue] + + lock( mtxUnblockLock ); + + if ( 0 != nWaitersToUnblock ) { // the gate is closed!!! + if ( 0 == nWaitersBlocked ) { // NO-OP + return unlock( mtxUnblockLock ); + } + if (bAll) { + nWaitersToUnblock += nSignalsToIssue=nWaitersBlocked; + nWaitersBlocked = 0; + } + else { + nSignalsToIssue = 1; + nWaitersToUnblock++; + nWaitersBlocked--; + } + } + else if ( nWaitersBlocked > nWaitersGone ) { // HARMLESS RACE CONDITION! + sem_wait( semBlockLock ); // close the gate + if ( 0 != nWaitersGone ) { + nWaitersBlocked -= nWaitersGone; + nWaitersGone = 0; + } + if (bAll) { + nSignalsToIssue = nWaitersToUnblock = nWaitersBlocked; + nWaitersBlocked = 0; + } + else { + nSignalsToIssue = nWaitersToUnblock = 1; + nWaitersBlocked--; + } + } + else { // NO-OP + return unlock( mtxUnblockLock ); + } + + unlock( mtxUnblockLock ); + sem_post( semBlockQueue,nSignalsToIssue ); + return result; +} + +---------- Algorithm 8b / IMPL_SEM,UNBLOCK_STRATEGY == UNBLOCK_ONEBYONE +------ +given: +semBlockLock - bin.semaphore +semBlockQueue - bin.semaphore +mtxExternal - mutex or CS +mtxUnblockLock - mutex or CS +nWaitersGone - int +nWaitersBlocked - int +nWaitersToUnblock - int + +wait( timeout ) { + + [auto: register int result ] // error checking omitted + [auto: register int nWaitersWasGone ] + [auto: register int nSignalsWasLeft ] + + sem_wait( semBlockLock ); + nWaitersBlocked++; + sem_post( semBlockLock ); + + unlock( mtxExternal ); + bTimedOut = sem_wait( semBlockQueue,timeout ); + + lock( mtxUnblockLock ); + if ( 0 != (nSignalsWasLeft = nWaitersToUnblock) ) { + if ( bTimeout ) { // timeout (or canceled) + if ( 0 != nWaitersBlocked ) { + nWaitersBlocked--; + nSignalsWasLeft = 0; // do not unblock next waiter +below (already unblocked) + } + else { + nWaitersGone = 1; // spurious wakeup pending!! + } + } + if ( 0 == --nWaitersToUnblock && + if ( 0 != nWaitersBlocked ) { + sem_post( semBlockLock ); // open the gate + nSignalsWasLeft = 0; // do not open the gate below +again + } + else if ( 0 != (nWaitersWasGone = nWaitersGone) ) { + nWaitersGone = 0; + } + } + } + else if ( INT_MAX/2 == ++nWaitersGone ) { // timeout/canceled or spurious +semaphore :-) + sem_wait( semBlockLock ); + nWaitersBlocked -= nWaitersGone; // something is going on here - +test of timeouts? :-) + sem_post( semBlockLock ); + nWaitersGone = 0; + } + unlock( mtxUnblockLock ); + + if ( 1 == nSignalsWasLeft ) { + if ( 0 != nWaitersWasGone ) { + // sem_adjust( -1 ); + sem_wait( semBlockQueue ); // better now than spurious +later + } + sem_post( semBlockLock ); // open the gate + } + else if ( 0 != nSignalsWasLeft ) { + sem_post( semBlockQueue ); // unblock next waiter + } + + lock( mtxExternal ); + + return ( bTimedOut ) ? ETIMEOUT : 0; +} + +signal(bAll) { + + [auto: register int result ] + + lock( mtxUnblockLock ); + + if ( 0 != nWaitersToUnblock ) { // the gate is closed!!! + if ( 0 == nWaitersBlocked ) { // NO-OP + return unlock( mtxUnblockLock ); + } + if (bAll) { + nWaitersToUnblock += nWaitersBlocked; + nWaitersBlocked = 0; + } + else { + nWaitersToUnblock++; + nWaitersBlocked--; + } + unlock( mtxUnblockLock ); + } + else if ( nWaitersBlocked > nWaitersGone ) { // HARMLESS RACE CONDITION! + sem_wait( semBlockLock ); // close the gate + if ( 0 != nWaitersGone ) { + nWaitersBlocked -= nWaitersGone; + nWaitersGone = 0; + } + if (bAll) { + nWaitersToUnblock = nWaitersBlocked; + nWaitersBlocked = 0; + } + else { + nWaitersToUnblock = 1; + nWaitersBlocked--; + } + unlock( mtxUnblockLock ); + sem_post( semBlockQueue ); + } + else { // NO-OP + unlock( mtxUnblockLock ); + } + + return result; +} + +---------- Algorithm 8c / IMPL_EVENT,UNBLOCK_STRATEGY == UNBLOCK_ONEBYONE +--------- +given: +hevBlockLock - auto-reset event +hevBlockQueue - auto-reset event +mtxExternal - mutex or CS +mtxUnblockLock - mutex or CS +nWaitersGone - int +nWaitersBlocked - int +nWaitersToUnblock - int + +wait( timeout ) { + + [auto: register int result ] // error checking omitted + [auto: register int nSignalsWasLeft ] + [auto: register int nWaitersWasGone ] + + wait( hevBlockLock,INFINITE ); + nWaitersBlocked++; + set_event( hevBlockLock ); + + unlock( mtxExternal ); + bTimedOut = wait( hevBlockQueue,timeout ); + + lock( mtxUnblockLock ); + if ( 0 != (SignalsWasLeft = nWaitersToUnblock) ) { + if ( bTimeout ) { // timeout (or canceled) + if ( 0 != nWaitersBlocked ) { + nWaitersBlocked--; + nSignalsWasLeft = 0; // do not unblock next waiter +below (already unblocked) + } + else { + nWaitersGone = 1; // spurious wakeup pending!! + } + } + if ( 0 == --nWaitersToUnblock ) + if ( 0 != nWaitersBlocked ) { + set_event( hevBlockLock ); // open the gate + nSignalsWasLeft = 0; // do not open the gate below +again + } + else if ( 0 != (nWaitersWasGone = nWaitersGone) ) { + nWaitersGone = 0; + } + } + } + else if ( INT_MAX/2 == ++nWaitersGone ) { // timeout/canceled or spurious +event :-) + wait( hevBlockLock,INFINITE ); + nWaitersBlocked -= nWaitersGone; // something is going on here - +test of timeouts? :-) + set_event( hevBlockLock ); + nWaitersGone = 0; + } + unlock( mtxUnblockLock ); + + if ( 1 == nSignalsWasLeft ) { + if ( 0 != nWaitersWasGone ) { + reset_event( hevBlockQueue ); // better now than spurious +later + } + set_event( hevBlockLock ); // open the gate + } + else if ( 0 != nSignalsWasLeft ) { + set_event( hevBlockQueue ); // unblock next waiter + } + + lock( mtxExternal ); + + return ( bTimedOut ) ? ETIMEOUT : 0; +} + +signal(bAll) { + + [auto: register int result ] + + lock( mtxUnblockLock ); + + if ( 0 != nWaitersToUnblock ) { // the gate is closed!!! + if ( 0 == nWaitersBlocked ) { // NO-OP + return unlock( mtxUnblockLock ); + } + if (bAll) { + nWaitersToUnblock += nWaitersBlocked; + nWaitersBlocked = 0; + } + else { + nWaitersToUnblock++; + nWaitersBlocked--; + } + unlock( mtxUnblockLock ); + } + else if ( nWaitersBlocked > nWaitersGone ) { // HARMLESS RACE CONDITION! + wait( hevBlockLock,INFINITE ); // close the gate + if ( 0 != nWaitersGone ) { + nWaitersBlocked -= nWaitersGone; + nWaitersGone = 0; + } + if (bAll) { + nWaitersToUnblock = nWaitersBlocked; + nWaitersBlocked = 0; + } + else { + nWaitersToUnblock = 1; + nWaitersBlocked--; + } + unlock( mtxUnblockLock ); + set_event( hevBlockQueue ); + } + else { // NO-OP + unlock( mtxUnblockLock ); + } + + return result; +} + +---------- Algorithm 8d / IMPL_EVENT,UNBLOCK_STRATEGY == UNBLOCK_ALL ------ +given: +hevBlockLock - auto-reset event +hevBlockQueueS - auto-reset event // for signals +hevBlockQueueB - manual-reset even // for broadcasts +mtxExternal - mutex or CS +mtxUnblockLock - mutex or CS +eBroadcast - int // 0: no broadcast, 1: broadcast, 2: +broadcast after signal(s) +nWaitersGone - int +nWaitersBlocked - int +nWaitersToUnblock - int + +wait( timeout ) { + + [auto: register int result ] // error checking omitted + [auto: register int eWasBroadcast ] + [auto: register int nSignalsWasLeft ] + [auto: register int nWaitersWasGone ] + + wait( hevBlockLock,INFINITE ); + nWaitersBlocked++; + set_event( hevBlockLock ); + + unlock( mtxExternal ); + bTimedOut = waitformultiple( hevBlockQueueS,hevBlockQueueB,timeout,ONE ); + + lock( mtxUnblockLock ); + if ( 0 != (SignalsWasLeft = nWaitersToUnblock) ) { + if ( bTimeout ) { // timeout (or canceled) + if ( 0 != nWaitersBlocked ) { + nWaitersBlocked--; + nSignalsWasLeft = 0; // do not unblock next waiter +below (already unblocked) + } + else if ( 1 != eBroadcast ) { + nWaitersGone = 1; + } + } + if ( 0 == --nWaitersToUnblock ) { + if ( 0 != nWaitersBlocked ) { + set_event( hevBlockLock ); // open the gate + nSignalsWasLeft = 0; // do not open the gate below +again + } + else { + if ( 0 != (eWasBroadcast = eBroadcast) ) { + eBroadcast = 0; + } + if ( 0 != (nWaitersWasGone = nWaitersGone ) { + nWaitersGone = 0; + } + } + } + else if ( 0 != eBroadcast ) { + nSignalsWasLeft = 0; // do not unblock next waiter +below (already unblocked) + } + } + else if ( INT_MAX/2 == ++nWaitersGone ) { // timeout/canceled or spurious +event :-) + wait( hevBlockLock,INFINITE ); + nWaitersBlocked -= nWaitersGone; // something is going on here - +test of timeouts? :-) + set_event( hevBlockLock ); + nWaitersGone = 0; + } + unlock( mtxUnblockLock ); + + if ( 1 == nSignalsWasLeft ) { + if ( 0 != eWasBroadcast ) { + reset_event( hevBlockQueueB ); + } + if ( 0 != nWaitersWasGone ) { + reset_event( hevBlockQueueS ); // better now than spurious +later + } + set_event( hevBlockLock ); // open the gate + } + else if ( 0 != nSignalsWasLeft ) { + set_event( hevBlockQueueS ); // unblock next waiter + } + + lock( mtxExternal ); + + return ( bTimedOut ) ? ETIMEOUT : 0; +} + +signal(bAll) { + + [auto: register int result ] + [auto: register HANDLE hevBlockQueue ] + + lock( mtxUnblockLock ); + + if ( 0 != nWaitersToUnblock ) { // the gate is closed!!! + if ( 0 == nWaitersBlocked ) { // NO-OP + return unlock( mtxUnblockLock ); + } + if (bAll) { + nWaitersToUnblock += nWaitersBlocked; + nWaitersBlocked = 0; + eBroadcast = 2; + hevBlockQueue = hevBlockQueueB; + } + else { + nWaitersToUnblock++; + nWaitersBlocked--; + return unlock( mtxUnblockLock ); + } + } + else if ( nWaitersBlocked > nWaitersGone ) { // HARMLESS RACE CONDITION! + wait( hevBlockLock,INFINITE ); // close the gate + if ( 0 != nWaitersGone ) { + nWaitersBlocked -= nWaitersGone; + nWaitersGone = 0; + } + if (bAll) { + nWaitersToUnblock = nWaitersBlocked; + nWaitersBlocked = 0; + eBroadcast = 1; + hevBlockQueue = hevBlockQueueB; + } + else { + nWaitersToUnblock = 1; + nWaitersBlocked--; + hevBlockQueue = hevBlockQueueS; + } + } + else { // NO-OP + return unlock( mtxUnblockLock ); + } + + unlock( mtxUnblockLock ); + set_event( hevBlockQueue ); + return result; +} +---------------------- Forwarded by Alexander Terekhov/Germany/IBM on +02/21/2001 09:13 AM --------------------------- + +Alexander Terekhov +02/20/2001 04:33 PM + +To: Louis Thomas +cc: + +From: Alexander Terekhov/Germany/IBM@IBMDE +Subject: RE: FYI/comp.programming.threads/Re: pthread_cond_* implementatio + n questions +Importance: Normal + +>Sorry, gotta take a break and work on something else for a while. +>Real work +>calls, unfortunately. I'll get back to you in two or three days. + +ok. no problem. here is some more stuff for pauses you might have +in between :) + +---------- Algorithm 7d / IMPL_EVENT,UNBLOCK_STRATEGY == UNBLOCK_ALL ------ +given: +hevBlockLock - auto-reset event +hevBlockQueueS - auto-reset event // for signals +hevBlockQueueB - manual-reset even // for broadcasts +mtxExternal - mutex or CS +mtxUnblockLock - mutex or CS +bBroadcast - int +nWaitersGone - int +nWaitersBlocked - int +nWaitersToUnblock - int + +wait( timeout ) { + + [auto: register int result ] // error checking omitted + [auto: register int bWasBroadcast ] + [auto: register int nSignalsWasLeft ] + + wait( hevBlockLock,INFINITE ); + nWaitersBlocked++; + set_event( hevBlockLock ); + + unlock( mtxExternal ); + bTimedOut = waitformultiple( hevBlockQueueS,hevBlockQueueB,timeout,ONE ); + + lock( mtxUnblockLock ); + if ( 0 != (SignalsWasLeft = nWaitersToUnblock) ) { + if ( bTimeout ) { // timeout (or canceled) + if ( 0 != nWaitersBlocked ) { + nWaitersBlocked--; + nSignalsWasLeft = 0; // do not unblock next waiter +below (already unblocked) + } + else if ( !bBroadcast ) { + wait( hevBlockQueueS,INFINITE ); // better now than spurious +later + } + } + if ( 0 == --nWaitersToUnblock ) { + if ( 0 != nWaitersBlocked ) { + if ( bBroadcast ) { + reset_event( hevBlockQueueB ); + bBroadcast = false; + } + set_event( hevBlockLock ); // open the gate + nSignalsWasLeft = 0; // do not open the gate below +again + } + else if ( false != (bWasBroadcast = bBroadcast) ) { + bBroadcast = false; + } + } + else { + bWasBroadcast = bBroadcast; + } + } + else if ( INT_MAX/2 == ++nWaitersGone ) { // timeout/canceled or spurious +event :-) + wait( hevBlockLock,INFINITE ); + nWaitersBlocked -= nWaitersGone; // something is going on here - +test of timeouts? :-) + set_event( hevBlockLock ); + nWaitersGone = 0; + } + unlock( mtxUnblockLock ); + + if ( 1 == nSignalsWasLeft ) { + if ( bWasBroadcast ) { + reset_event( hevBlockQueueB ); + } + set_event( hevBlockLock ); // open the gate + } + else if ( 0 != nSignalsWasLeft && !bWasBroadcast ) { + set_event( hevBlockQueueS ); // unblock next waiter + } + + lock( mtxExternal ); + + return ( bTimedOut ) ? ETIMEOUT : 0; +} + +signal(bAll) { + + [auto: register int result ] + [auto: register HANDLE hevBlockQueue ] + + lock( mtxUnblockLock ); + + if ( 0 != nWaitersToUnblock ) { // the gate is closed!!! + if ( 0 == nWaitersBlocked ) { // NO-OP + return unlock( mtxUnblockLock ); + } + if (bAll) { + nWaitersToUnblock += nWaitersBlocked; + nWaitersBlocked = 0; + bBroadcast = true; + hevBlockQueue = hevBlockQueueB; + } + else { + nWaitersToUnblock++; + nWaitersBlocked--; + return unlock( mtxUnblockLock ); + } + } + else if ( nWaitersBlocked > nWaitersGone ) { // HARMLESS RACE CONDITION! + wait( hevBlockLock,INFINITE ); // close the gate + if ( 0 != nWaitersGone ) { + nWaitersBlocked -= nWaitersGone; + nWaitersGone = 0; + } + if (bAll) { + nWaitersToUnblock = nWaitersBlocked; + nWaitersBlocked = 0; + bBroadcast = true; + hevBlockQueue = hevBlockQueueB; + } + else { + nWaitersToUnblock = 1; + nWaitersBlocked--; + hevBlockQueue = hevBlockQueueS; + } + } + else { // NO-OP + return unlock( mtxUnblockLock ); + } + + unlock( mtxUnblockLock ); + set_event( hevBlockQueue ); + return result; +} + + +---------------------------------------------------------------------------- + +Subject: RE: FYI/comp.programming.threads/Re: pthread_cond_* implementatio + n questions +Date: Mon, 26 Feb 2001 22:20:12 -0600 +From: Louis Thomas +To: "'TEREKHOV@de.ibm.com'" +CC: rpj@ise.canberra.edu.au, Thomas Pfaff , + Nanbor Wang + + +Sorry all. Busy week. + +> this insures the fairness +> which POSIX does not (e.g. two subsequent broadcasts - the gate does +insure +> that first wave waiters will start the race for the mutex before waiters +> from the second wave - Linux pthreads process/unblock both waves +> concurrently...) + +I'm not sure how we are any more fair about this than Linux. We certainly +don't guarantee that the threads released by the first broadcast will get +the external mutex before the threads of the second wave. In fact, it is +possible that those threads will never get the external mutex if there is +enough contention for it. + +> e.g. i was thinking about implementation with a pool of +> N semaphores/counters [...] + +I considered that too. The problem is as you mentioned in a). You really +need to assign threads to semaphores once you know how you want to wake them +up, not when they first begin waiting which is the only time you can assign +them. + +> well, i am not quite sure that i've fully understood your scenario, + +Hmm. Well, it think it's an important example, so I'll try again. First, we +have thread A which we KNOW is waiting on a condition. As soon as it becomes +unblocked for any reason, we will know because it will set a flag. Since the +flag is not set, we are 100% confident that thread A is waiting on the +condition. We have another thread, thread B, which has acquired the mutex +and is about to wait on the condition. Thus it is pretty clear that at any +point, either just A is waiting, or A and B are waiting. Now thread C comes +along. C is about to do a broadcast on the condition. A broadcast is +guaranteed to unblock all threads currently waiting on a condition, right? +Again, we said that either just A is waiting, or A and B are both waiting. +So, when C does its broadcast, depending upon whether B has started waiting +or not, thread C will unblock A or unblock A and B. Either way, C must +unblock A, right? + +Now, you said anything that happens is correct so long as a) "a signal is +not lost between unlocking the mutex and waiting on the condition" and b) "a +thread must not steal a signal it sent", correct? Requirement b) is easy to +satisfy: in this scenario, thread C will never wait on the condition, so it +won't steal any signals. Requirement a) is not hard either. The only way we +could fail to meet requirement a) in this scenario is if thread B was +started waiting but didn't wake up because a signal was lost. This will not +happen. + +Now, here is what happens. Assume thread C beats thread B. Thread C looks to +see how many threads are waiting on the condition. Thread C sees just one +thread, thread A, waiting. It does a broadcast waking up just one thread +because just one thread is waiting. Next, before A can become unblocked, +thread B begins waiting. Now there are two threads waiting, but only one +will be unblocked. Suppose B wins. B will become unblocked. A will not +become unblocked, because C only unblocked one thread (sema_post cond, 1). +So at the end, B finishes and A remains blocked. + +We have met both of your requirements, so by your rules, this is an +acceptable outcome. However, I think that the spec says this is an +unacceptable outcome! We know for certain that A was waiting and that C did +a broadcast, but A did not become unblocked! Yet, the spec says that a +broadcast wakes up all waiting threads. This did not happen. Do you agree +that this shows your rules are not strict enough? + +> and what about N2? :) this one does allow almost everything. + +Don't get me started about rule #2. I'll NEVER advocate an algorithm that +uses rule 2 as an excuse to suck! + +> but it is done (decrement)under mutex protection - this is not a subject +> of a race condition. + +You are correct. My mistake. + +> i would remove "_bTimedOut=false".. after all, it was a real timeout.. + +I disagree. A thread that can't successfully retract its waiter status can't +really have timed out. If a thread can't return without executing extra code +to deal with the fact that someone tried to unblock it, I think it is a poor +idea to pretend we +didn't realize someone was trying to signal us. After all, a signal is more +important than a time out. + +> when nSignaled != 0, it is possible to update nWaiters (--) and do not +> touch nGone + +I realize this, but I was thinking that writing it the other ways saves +another if statement. + +> adjust only if nGone != 0 and save one cache memory write - probably much +slower than 'if' + +Hmm. You are probably right. + +> well, in a strange (e.g. timeout test) program you may (theoretically) +> have an overflow of nWaiters/nGone counters (with waiters repeatedly +timing +> out and no signals at all). + +Also true. Not only that, but you also have the possibility that one could +overflow the number of waiters as well! However, considering the limit you +have chosen for nWaitersGone, I suppose it is unlikely that anyone would be +able to get INT_MAX/2 threads waiting on a single condition. :) + +Analysis of 8a: + +It looks correct to me. + +What are IPC semaphores? + +In the line where you state, "else if ( nWaitersBlocked > nWaitersGone ) { +// HARMLESS RACE CONDITION!" there is no race condition for nWaitersGone +because nWaitersGone is never modified without holding mtxUnblockLock. You +are correct that there is a harmless race on nWaitersBlocked, which can +increase and make the condition become true just after we check it. If this +happens, we interpret it as the wait starting after the signal. + +I like your optimization of this. You could improve Alg. 6 as follows: +---------- Algorithm 6b ---------- +signal(bAll) { + _nSig=0 + lock counters + // this is safe because nWaiting can only be decremented by a thread that + // owns counters and nGone can only be changed by a thread that owns +counters. + if (nWaiting>nGone) { + if (0==nSignaled) { + sema_wait gate // close gate if not already closed + } + if (nGone>0) { + nWaiting-=nGone + nGone=0 + } + _nSig=bAll?nWaiting:1 + nSignaled+=_nSig + nWaiting-=_nSig + } + unlock counters + if (0!=_nSig) { + sema_post queue, _nSig + } +} +---------- ---------- ---------- +I guess this wouldn't apply to Alg 8a because nWaitersGone changes meanings +depending upon whether the gate is open or closed. + +In the loop "while ( nWaitersWasGone-- ) {" you do a sema_wait on +semBlockLock. Perhaps waiting on semBlockQueue would be a better idea. + +What have you gained by making the last thread to be signaled do the waits +for all the timed out threads, besides added complexity? It took me a long +time to figure out what your objective was with this, to realize you were +using nWaitersGone to mean two different things, and to verify that you +hadn't introduced any bug by doing this. Even now I'm not 100% sure. + +What has all this playing about with nWaitersGone really gained us besides a +lot of complexity (it is much harder to verify that this solution is +correct), execution overhead (we now have a lot more if statements to +evaluate), and space overhead (more space for the extra code, and another +integer in our data)? We did manage to save a lock/unlock pair in an +uncommon case (when a time out occurs) at the above mentioned expenses in +the common cases. + +As for 8b, c, and d, they look ok though I haven't studied them thoroughly. +What would you use them for? + + Later, + -Louis! :) + +----------------------------------------------------------------------------- + +Subject: RE: FYI/comp.programming.threads/Re: pthread_cond_* implementatio + n questions +Date: Tue, 27 Feb 2001 15:51:28 +0100 +From: TEREKHOV@de.ibm.com +To: Louis Thomas +CC: rpj@ise.canberra.edu.au, Thomas Pfaff , + Nanbor Wang + +Hi Louis, + +>> that first wave waiters will start the race for the mutex before waiters +>> from the second wave - Linux pthreads process/unblock both waves +>> concurrently...) +> +>I'm not sure how we are any more fair about this than Linux. We certainly +>don't guarantee that the threads released by the first broadcast will get +>the external mutex before the threads of the second wave. In fact, it is +>possible that those threads will never get the external mutex if there is +>enough contention for it. + +correct. but gate is nevertheless more fair than Linux because of the +barrier it establishes between two races (1st and 2nd wave waiters) for +the mutex which under 'normal' circumstances (e.g. all threads of equal +priorities,..) will 'probably' result in fair behaviour with respect to +mutex ownership. + +>> well, i am not quite sure that i've fully understood your scenario, +> +>Hmm. Well, it think it's an important example, so I'll try again. ... + +ok. now i seem to understand this example. well, now it seems to me +that the only meaningful rule is just: + +a) "a signal is not lost between unlocking the mutex and waiting on the +condition" + +and that the rule + +b) "a thread must not steal a signal it sent" + +is not needed at all because a thread which violates b) also violates a). + +i'll try to explain.. + +i think that the most important thing is how POSIX defines waiter's +visibility: + +"if another thread is able to acquire the mutex after the about-to-block +thread +has released it, then a subsequent call to pthread_cond_signal() or +pthread_cond_broadcast() in that thread behaves as if it were issued after +the about-to-block thread has blocked. " + +my understanding is the following: + +1) there is no guarantees whatsoever with respect to whether +signal/broadcast +will actually unblock any 'waiter' if it is done w/o acquiring the mutex +first +(note that a thread may release it before signal/broadcast - it does not +matter). + +2) it is guaranteed that waiters become 'visible' - eligible for unblock as +soon +as signalling thread acquires the mutex (but not before!!) + +so.. + +>So, when C does its broadcast, depending upon whether B has started +waiting +>or not, thread C will unblock A or unblock A and B. Either way, C must +>unblock A, right? + +right. but only if C did acquire the mutex prior to broadcast (it may +release it before broadcast as well). + +implementation will violate waiters visibility rule (signal will become +lost) +if C will not unblock A. + +>Now, here is what happens. Assume thread C beats thread B. Thread C looks +to +>see how many threads are waiting on the condition. Thread C sees just one +>thread, thread A, waiting. It does a broadcast waking up just one thread +>because just one thread is waiting. Next, before A can become unblocked, +>thread B begins waiting. Now there are two threads waiting, but only one +>will be unblocked. Suppose B wins. B will become unblocked. A will not +>become unblocked, because C only unblocked one thread (sema_post cond, 1). +>So at the end, B finishes and A remains blocked. + +thread C did acquire the mutex ("Thread C sees just one thread, thread A, +waiting"). beginning from that moment it is guaranteed that subsequent +broadcast will unblock A. Otherwise we will have a lost signal with respect +to A. I do think that it does not matter whether the signal was physically +(completely) lost or was just stolen by another thread (B) - in both cases +it was simply lost with respect to A. + +>..Do you agree that this shows your rules are not strict enough? + +probably the opposite.. :-) i think that it shows that the only meaningful +rule is + +a) "a signal is not lost between unlocking the mutex and waiting on the +condition" + +with clarification of waiters visibility as defined by POSIX above. + +>> i would remove "_bTimedOut=false".. after all, it was a real timeout.. +> +>I disagree. A thread that can't successfully retract its waiter status +can't +>really have timed out. If a thread can't return without executing extra +code +>to deal with the fact that someone tried to unblock it, I think it is a +poor +>idea to pretend we +>didn't realize someone was trying to signal us. After all, a signal is +more +>important than a time out. + +a) POSIX does allow timed out thread to consume a signal (cancelled is +not). +b) ETIMEDOUT status just says that: "The time specified by abstime to +pthread_cond_timedwait() has passed." +c) it seem to me that hiding timeouts would violate "The +pthread_cond_timedwait() +function is the same as pthread_cond_wait() except that an error is +returned if +the absolute time specified by abstime passes (that is, system time equals +or +exceeds abstime) before the condition cond is signaled or broadcasted" +because +the abs. time did really pass before cond was signaled (waiter was +released via semaphore). however, if it really matters, i could imaging +that we +can save an abs. time of signal/broadcast and compare it with timeout after +unblock to find out whether it was a 'real' timeout or not. absent this +check +i do think that hiding timeouts would result in technical violation of +specification.. but i think that this check is not important and we can +simply +trust timeout error code provided by wait since we are not trying to make +'hard' realtime implementation. + +>What are IPC semaphores? + + +int semctl(int, int, int, ...); +int semget(key_t, int, int); +int semop(int, struct sembuf *, size_t); + +they support adjustment of semaphore counter (semvalue) +in one single call - imaging Win32 ReleaseSemaphore( hsem,-N ) + +>In the line where you state, "else if ( nWaitersBlocked > nWaitersGone ) { +>// HARMLESS RACE CONDITION!" there is no race condition for nWaitersGone +>because nWaitersGone is never modified without holding mtxUnblockLock. You +>are correct that there is a harmless race on nWaitersBlocked, which can +>increase and make the condition become true just after we check it. If +this +>happens, we interpret it as the wait starting after the signal. + +well, the reason why i've asked on comp.programming.threads whether this +race +condition is harmless or not is that in order to be harmless it should not +violate the waiters visibility rule (see above). Fortunately, we increment +the counter under protection of external mutex.. so that any (signalling) +thread which will acquire the mutex next, should see the updated counter +(in signal) according to POSIX memory visibility rules and mutexes +(memory barriers). But i am not so sure how it actually works on +Win32/INTEL +which does not explicitly define any memory visibility rules :( + +>I like your optimization of this. You could improve Alg. 6 as follows: +>---------- Algorithm 6b ---------- +>signal(bAll) { +> _nSig=0 +> lock counters +> // this is safe because nWaiting can only be decremented by a thread +that +> // owns counters and nGone can only be changed by a thread that owns +>counters. +> if (nWaiting>nGone) { +> if (0==nSignaled) { +> sema_wait gate // close gate if not already closed +> } +> if (nGone>0) { +> nWaiting-=nGone +> nGone=0 +> } +> _nSig=bAll?nWaiting:1 +> nSignaled+=_nSig +> nWaiting-=_nSig +> } +> unlock counters +> if (0!=_nSig) { +> sema_post queue, _nSig +> } +>} +>---------- ---------- ---------- +>I guess this wouldn't apply to Alg 8a because nWaitersGone changes +meanings +>depending upon whether the gate is open or closed. + +agree. + +>In the loop "while ( nWaitersWasGone-- ) {" you do a sema_wait on +>semBlockLock. Perhaps waiting on semBlockQueue would be a better idea. + +you are correct. my mistake. + +>What have you gained by making the last thread to be signaled do the waits +>for all the timed out threads, besides added complexity? It took me a long +>time to figure out what your objective was with this, to realize you were +>using nWaitersGone to mean two different things, and to verify that you +>hadn't introduced any bug by doing this. Even now I'm not 100% sure. +> +>What has all this playing about with nWaitersGone really gained us besides +a +>lot of complexity (it is much harder to verify that this solution is +>correct), execution overhead (we now have a lot more if statements to +>evaluate), and space overhead (more space for the extra code, and another +>integer in our data)? We did manage to save a lock/unlock pair in an +>uncommon case (when a time out occurs) at the above mentioned expenses in +>the common cases. + +well, please consider the following: + +1) with multiple waiters unblocked (but some timed out) the trick with +counter +seem to ensure potentially higher level of concurrency by not delaying +most of unblocked waiters for semaphore cleanup - only the last one +will be delayed but all others would already contend/acquire/release +the external mutex - the critical section protected by mtxUnblockLock is +made smaller (increment + couple of IFs is faster than system/kernel call) +which i think is good in general. however, you are right, this is done +at expense of 'normal' waiters.. + +2) some semaphore APIs (e.g. POSIX IPC sems) do allow to adjust the +semaphore counter in one call => less system/kernel calls.. imagine: + +if ( 1 == nSignalsWasLeft ) { + if ( 0 != nWaitersWasGone ) { + ReleaseSemaphore( semBlockQueue,-nWaitersWasGone ); // better now +than spurious later + } + sem_post( semBlockLock ); // open the gate + } + +3) even on win32 a single thread doing multiple cleanup calls (to wait) +will probably result in faster execution (because of processor caching) +than multiple threads each doing a single call to wait. + +>As for 8b, c, and d, they look ok though I haven't studied them +thoroughly. +>What would you use them for? + +8b) for semaphores which do not allow to unblock multiple waiters +in a single call to post/release (e.g. POSIX realtime semaphores - +) + +8c/8d) for WinCE prior to 3.0 (WinCE 3.0 does have semaphores) + +ok. so, which one is the 'final' algorithm(s) which we should use in +pthreads-win32?? + +regards, +alexander. + +---------------------------------------------------------------------------- + +Louis Thomas on 02/27/2001 05:20:12 AM + +Please respond to Louis Thomas + +To: Alexander Terekhov/Germany/IBM@IBMDE +cc: rpj@ise.canberra.edu.au, Thomas Pfaff , Nanbor Wang + +Subject: RE: FYI/comp.programming.threads/Re: pthread_cond_* implementatio + n questions + +Sorry all. Busy week. + +> this insures the fairness +> which POSIX does not (e.g. two subsequent broadcasts - the gate does +insure +> that first wave waiters will start the race for the mutex before waiters +> from the second wave - Linux pthreads process/unblock both waves +> concurrently...) + +I'm not sure how we are any more fair about this than Linux. We certainly +don't guarantee that the threads released by the first broadcast will get +the external mutex before the threads of the second wave. In fact, it is +possible that those threads will never get the external mutex if there is +enough contention for it. + +> e.g. i was thinking about implementation with a pool of +> N semaphores/counters [...] + +I considered that too. The problem is as you mentioned in a). You really +need to assign threads to semaphores once you know how you want to wake +them +up, not when they first begin waiting which is the only time you can assign +them. + +> well, i am not quite sure that i've fully understood your scenario, + +Hmm. Well, it think it's an important example, so I'll try again. First, we +have thread A which we KNOW is waiting on a condition. As soon as it +becomes +unblocked for any reason, we will know because it will set a flag. Since +the +flag is not set, we are 100% confident that thread A is waiting on the +condition. We have another thread, thread B, which has acquired the mutex +and is about to wait on the condition. Thus it is pretty clear that at any +point, either just A is waiting, or A and B are waiting. Now thread C comes +along. C is about to do a broadcast on the condition. A broadcast is +guaranteed to unblock all threads currently waiting on a condition, right? +Again, we said that either just A is waiting, or A and B are both waiting. +So, when C does its broadcast, depending upon whether B has started waiting +or not, thread C will unblock A or unblock A and B. Either way, C must +unblock A, right? + +Now, you said anything that happens is correct so long as a) "a signal is +not lost between unlocking the mutex and waiting on the condition" and b) +"a +thread must not steal a signal it sent", correct? Requirement b) is easy to +satisfy: in this scenario, thread C will never wait on the condition, so it +won't steal any signals. Requirement a) is not hard either. The only way +we +could fail to meet requirement a) in this scenario is if thread B was +started waiting but didn't wake up because a signal was lost. This will not +happen. + +Now, here is what happens. Assume thread C beats thread B. Thread C looks +to +see how many threads are waiting on the condition. Thread C sees just one +thread, thread A, waiting. It does a broadcast waking up just one thread +because just one thread is waiting. Next, before A can become unblocked, +thread B begins waiting. Now there are two threads waiting, but only one +will be unblocked. Suppose B wins. B will become unblocked. A will not +become unblocked, because C only unblocked one thread (sema_post cond, 1). +So at the end, B finishes and A remains blocked. + +We have met both of your requirements, so by your rules, this is an +acceptable outcome. However, I think that the spec says this is an +unacceptable outcome! We know for certain that A was waiting and that C did +a broadcast, but A did not become unblocked! Yet, the spec says that a +broadcast wakes up all waiting threads. This did not happen. Do you agree +that this shows your rules are not strict enough? + +> and what about N2? :) this one does allow almost everything. + +Don't get me started about rule #2. I'll NEVER advocate an algorithm that +uses rule 2 as an excuse to suck! + +> but it is done (decrement)under mutex protection - this is not a subject +> of a race condition. + +You are correct. My mistake. + +> i would remove "_bTimedOut=false".. after all, it was a real timeout.. + +I disagree. A thread that can't successfully retract its waiter status +can't +really have timed out. If a thread can't return without executing extra +code +to deal with the fact that someone tried to unblock it, I think it is a +poor +idea to pretend we +didn't realize someone was trying to signal us. After all, a signal is more +important than a time out. + +> when nSignaled != 0, it is possible to update nWaiters (--) and do not +> touch nGone + +I realize this, but I was thinking that writing it the other ways saves +another if statement. + +> adjust only if nGone != 0 and save one cache memory write - probably much +slower than 'if' + +Hmm. You are probably right. + +> well, in a strange (e.g. timeout test) program you may (theoretically) +> have an overflow of nWaiters/nGone counters (with waiters repeatedly +timing +> out and no signals at all). + +Also true. Not only that, but you also have the possibility that one could +overflow the number of waiters as well! However, considering the limit you +have chosen for nWaitersGone, I suppose it is unlikely that anyone would be +able to get INT_MAX/2 threads waiting on a single condition. :) + +Analysis of 8a: + +It looks correct to me. + +What are IPC semaphores? + +In the line where you state, "else if ( nWaitersBlocked > nWaitersGone ) { +// HARMLESS RACE CONDITION!" there is no race condition for nWaitersGone +because nWaitersGone is never modified without holding mtxUnblockLock. You +are correct that there is a harmless race on nWaitersBlocked, which can +increase and make the condition become true just after we check it. If this +happens, we interpret it as the wait starting after the signal. + +I like your optimization of this. You could improve Alg. 6 as follows: +---------- Algorithm 6b ---------- +signal(bAll) { + _nSig=0 + lock counters + // this is safe because nWaiting can only be decremented by a thread that + // owns counters and nGone can only be changed by a thread that owns +counters. + if (nWaiting>nGone) { + if (0==nSignaled) { + sema_wait gate // close gate if not already closed + } + if (nGone>0) { + nWaiting-=nGone + nGone=0 + } + _nSig=bAll?nWaiting:1 + nSignaled+=_nSig + nWaiting-=_nSig + } + unlock counters + if (0!=_nSig) { + sema_post queue, _nSig + } +} +---------- ---------- ---------- +I guess this wouldn't apply to Alg 8a because nWaitersGone changes meanings +depending upon whether the gate is open or closed. + +In the loop "while ( nWaitersWasGone-- ) {" you do a sema_wait on +semBlockLock. Perhaps waiting on semBlockQueue would be a better idea. + +What have you gained by making the last thread to be signaled do the waits +for all the timed out threads, besides added complexity? It took me a long +time to figure out what your objective was with this, to realize you were +using nWaitersGone to mean two different things, and to verify that you +hadn't introduced any bug by doing this. Even now I'm not 100% sure. + +What has all this playing about with nWaitersGone really gained us besides +a +lot of complexity (it is much harder to verify that this solution is +correct), execution overhead (we now have a lot more if statements to +evaluate), and space overhead (more space for the extra code, and another +integer in our data)? We did manage to save a lock/unlock pair in an +uncommon case (when a time out occurs) at the above mentioned expenses in +the common cases. + +As for 8b, c, and d, they look ok though I haven't studied them thoroughly. +What would you use them for? + + Later, + -Louis! :) + diff --git a/external/pthreads-w32/README.NONPORTABLE b/external/pthreads-w32/README.NONPORTABLE new file mode 100644 index 00000000..0821104d --- /dev/null +++ b/external/pthreads-w32/README.NONPORTABLE @@ -0,0 +1,783 @@ +This file documents non-portable functions and other issues. + +Non-portable functions included in pthreads-win32 +------------------------------------------------- + +BOOL +pthread_win32_test_features_np(int mask) + + This routine allows an application to check which + run-time auto-detected features are available within + the library. + + The possible features are: + + PTW32_SYSTEM_INTERLOCKED_COMPARE_EXCHANGE + Return TRUE if the native version of + InterlockedCompareExchange() is being used. + This feature is not meaningful in recent + library versions as MSVC builds only support + system implemented ICE. Note that all Mingw + builds use inlined asm versions of all the + Interlocked routines. + PTW32_ALERTABLE_ASYNC_CANCEL + Return TRUE is the QueueUserAPCEx package + QUSEREX.DLL is available and the AlertDrv.sys + driver is loaded into Windows, providing + alertable (pre-emptive) asyncronous threads + cancelation. If this feature returns FALSE + then the default async cancel scheme is in + use, which cannot cancel blocked threads. + + Features may be Or'ed into the mask parameter, in which case + the routine returns TRUE if any of the Or'ed features would + return TRUE. At this stage it doesn't make sense to Or features + but it may some day. + + +void * +pthread_timechange_handler_np(void *) + + To improve tolerance against operator or time service + initiated system clock changes. + + This routine can be called by an application when it + receives a WM_TIMECHANGE message from the system. At + present it broadcasts all condition variables so that + waiting threads can wake up and re-evaluate their + conditions and restart their timed waits if required. + + It has the same return type and argument type as a + thread routine so that it may be called directly + through pthread_create(), i.e. as a separate thread. + + Parameters + + Although a parameter must be supplied, it is ignored. + The value NULL can be used. + + Return values + + It can return an error EAGAIN to indicate that not + all condition variables were broadcast for some reason. + Otherwise, 0 is returned. + + If run as a thread, the return value is returned + through pthread_join(). + + The return value should be cast to an integer. + + +HANDLE +pthread_getw32threadhandle_np(pthread_t thread); + + Returns the win32 thread handle that the POSIX + thread "thread" is running as. + + Applications can use the win32 handle to set + win32 specific attributes of the thread. + +DWORD +pthread_getw32threadid_np (pthread_t thread) + + Returns the Windows native thread ID that the POSIX + thread "thread" is running as. + + Only valid when the library is built where + ! (defined(__MINGW64__) || defined(__MINGW32__)) || defined (__MSVCRT__) || defined (__DMC__) + and otherwise returns 0. + + +int +pthread_mutexattr_setkind_np(pthread_mutexattr_t * attr, int kind) + +int +pthread_mutexattr_getkind_np(pthread_mutexattr_t * attr, int *kind) + + These two routines are included for Linux compatibility + and are direct equivalents to the standard routines + pthread_mutexattr_settype + pthread_mutexattr_gettype + + pthread_mutexattr_setkind_np accepts the following + mutex kinds: + PTHREAD_MUTEX_FAST_NP + PTHREAD_MUTEX_ERRORCHECK_NP + PTHREAD_MUTEX_RECURSIVE_NP + + These are really just equivalent to (respectively): + PTHREAD_MUTEX_NORMAL + PTHREAD_MUTEX_ERRORCHECK + PTHREAD_MUTEX_RECURSIVE + +int +pthread_delay_np (const struct timespec *interval); + + This routine causes a thread to delay execution for a specific period of time. + This period ends at the current time plus the specified interval. The routine + will not return before the end of the period is reached, but may return an + arbitrary amount of time after the period has gone by. This can be due to + system load, thread priorities, and system timer granularity. + + Specifying an interval of zero (0) seconds and zero (0) nanoseconds is + allowed and can be used to force the thread to give up the processor or to + deliver a pending cancelation request. + + This routine is a cancelation point. + + The timespec structure contains the following two fields: + + tv_sec is an integer number of seconds. + tv_nsec is an integer number of nanoseconds. + + Return Values + + If an error condition occurs, this routine returns an integer value + indicating the type of error. Possible return values are as follows: + + 0 Successful completion. + [EINVAL] The value specified by interval is invalid. + +int +pthread_num_processors_np (void) + + This routine (found on HPUX systems) returns the number of processors + in the system. This implementation actually returns the number of + processors available to the process, which can be a lower number + than the system's number, depending on the process's affinity mask. + +BOOL +pthread_win32_process_attach_np (void); + +BOOL +pthread_win32_process_detach_np (void); + +BOOL +pthread_win32_thread_attach_np (void); + +BOOL +pthread_win32_thread_detach_np (void); + + These functions contain the code normally run via dllMain + when the library is used as a dll but which need to be + called explicitly by an application when the library + is statically linked. As of version 2.9.0 of the library, static + builds using either MSC or GCC will call pthread_win32_process_* + automatically at application startup and exit respectively. + + Otherwise, you will need to call pthread_win32_process_attach_np() + before you can call any pthread routines when statically linking. + You should call pthread_win32_process_detach_np() before + exiting your application to clean up. + + pthread_win32_thread_attach_np() is currently a no-op, but + pthread_win32_thread_detach_np() is needed to clean up + the implicit pthread handle that is allocated to a Win32 thread if + it calls any pthreads routines. Call this routine when the + Win32 thread exits. + + Threads created through pthread_create() do not need to call + pthread_win32_thread_detach_np(). + + These functions invariably return TRUE except for + pthread_win32_process_attach_np() which will return FALSE + if pthreads-win32 initialisation fails. + +int +pthreadCancelableWait (HANDLE waitHandle); + +int +pthreadCancelableTimedWait (HANDLE waitHandle, DWORD timeout); + + These two functions provide hooks into the pthread_cancel + mechanism that will allow you to wait on a Windows handle + and make it a cancellation point. Both functions block + until either the given w32 handle is signaled, or + pthread_cancel has been called. It is implemented using + WaitForMultipleObjects on 'waitHandle' and a manually + reset w32 event used to implement pthread_cancel. + + +Non-portable issues +------------------- + +Thread priority + + POSIX defines a single contiguous range of numbers that determine a + thread's priority. Win32 defines priority classes and priority + levels relative to these classes. Classes are simply priority base + levels that the defined priority levels are relative to such that, + changing a process's priority class will change the priority of all + of it's threads, while the threads retain the same relativity to each + other. + + A Win32 system defines a single contiguous monotonic range of values + that define system priority levels, just like POSIX. However, Win32 + restricts individual threads to a subset of this range on a + per-process basis. + + The following table shows the base priority levels for combinations + of priority class and priority value in Win32. + + Process Priority Class Thread Priority Level + ----------------------------------------------------------------- + 1 IDLE_PRIORITY_CLASS THREAD_PRIORITY_IDLE + 1 BELOW_NORMAL_PRIORITY_CLASS THREAD_PRIORITY_IDLE + 1 NORMAL_PRIORITY_CLASS THREAD_PRIORITY_IDLE + 1 ABOVE_NORMAL_PRIORITY_CLASS THREAD_PRIORITY_IDLE + 1 HIGH_PRIORITY_CLASS THREAD_PRIORITY_IDLE + 2 IDLE_PRIORITY_CLASS THREAD_PRIORITY_LOWEST + 3 IDLE_PRIORITY_CLASS THREAD_PRIORITY_BELOW_NORMAL + 4 IDLE_PRIORITY_CLASS THREAD_PRIORITY_NORMAL + 4 BELOW_NORMAL_PRIORITY_CLASS THREAD_PRIORITY_LOWEST + 5 IDLE_PRIORITY_CLASS THREAD_PRIORITY_ABOVE_NORMAL + 5 BELOW_NORMAL_PRIORITY_CLASS THREAD_PRIORITY_BELOW_NORMAL + 5 Background NORMAL_PRIORITY_CLASS THREAD_PRIORITY_LOWEST + 6 IDLE_PRIORITY_CLASS THREAD_PRIORITY_HIGHEST + 6 BELOW_NORMAL_PRIORITY_CLASS THREAD_PRIORITY_NORMAL + 6 Background NORMAL_PRIORITY_CLASS THREAD_PRIORITY_BELOW_NORMAL + 7 BELOW_NORMAL_PRIORITY_CLASS THREAD_PRIORITY_ABOVE_NORMAL + 7 Background NORMAL_PRIORITY_CLASS THREAD_PRIORITY_NORMAL + 7 Foreground NORMAL_PRIORITY_CLASS THREAD_PRIORITY_LOWEST + 8 BELOW_NORMAL_PRIORITY_CLASS THREAD_PRIORITY_HIGHEST + 8 NORMAL_PRIORITY_CLASS THREAD_PRIORITY_ABOVE_NORMAL + 8 Foreground NORMAL_PRIORITY_CLASS THREAD_PRIORITY_BELOW_NORMAL + 8 ABOVE_NORMAL_PRIORITY_CLASS THREAD_PRIORITY_LOWEST + 9 NORMAL_PRIORITY_CLASS THREAD_PRIORITY_HIGHEST + 9 Foreground NORMAL_PRIORITY_CLASS THREAD_PRIORITY_NORMAL + 9 ABOVE_NORMAL_PRIORITY_CLASS THREAD_PRIORITY_BELOW_NORMAL + 10 Foreground NORMAL_PRIORITY_CLASS THREAD_PRIORITY_ABOVE_NORMAL + 10 ABOVE_NORMAL_PRIORITY_CLASS THREAD_PRIORITY_NORMAL + 11 Foreground NORMAL_PRIORITY_CLASS THREAD_PRIORITY_HIGHEST + 11 ABOVE_NORMAL_PRIORITY_CLASS THREAD_PRIORITY_ABOVE_NORMAL + 11 HIGH_PRIORITY_CLASS THREAD_PRIORITY_LOWEST + 12 ABOVE_NORMAL_PRIORITY_CLASS THREAD_PRIORITY_HIGHEST + 12 HIGH_PRIORITY_CLASS THREAD_PRIORITY_BELOW_NORMAL + 13 HIGH_PRIORITY_CLASS THREAD_PRIORITY_NORMAL + 14 HIGH_PRIORITY_CLASS THREAD_PRIORITY_ABOVE_NORMAL + 15 HIGH_PRIORITY_CLASS THREAD_PRIORITY_HIGHEST + 15 HIGH_PRIORITY_CLASS THREAD_PRIORITY_TIME_CRITICAL + 15 IDLE_PRIORITY_CLASS THREAD_PRIORITY_TIME_CRITICAL + 15 BELOW_NORMAL_PRIORITY_CLASS THREAD_PRIORITY_TIME_CRITICAL + 15 NORMAL_PRIORITY_CLASS THREAD_PRIORITY_TIME_CRITICAL + 15 ABOVE_NORMAL_PRIORITY_CLASS THREAD_PRIORITY_TIME_CRITICAL + 16 REALTIME_PRIORITY_CLASS THREAD_PRIORITY_IDLE + 17 REALTIME_PRIORITY_CLASS -7 + 18 REALTIME_PRIORITY_CLASS -6 + 19 REALTIME_PRIORITY_CLASS -5 + 20 REALTIME_PRIORITY_CLASS -4 + 21 REALTIME_PRIORITY_CLASS -3 + 22 REALTIME_PRIORITY_CLASS THREAD_PRIORITY_LOWEST + 23 REALTIME_PRIORITY_CLASS THREAD_PRIORITY_BELOW_NORMAL + 24 REALTIME_PRIORITY_CLASS THREAD_PRIORITY_NORMAL + 25 REALTIME_PRIORITY_CLASS THREAD_PRIORITY_ABOVE_NORMAL + 26 REALTIME_PRIORITY_CLASS THREAD_PRIORITY_HIGHEST + 27 REALTIME_PRIORITY_CLASS 3 + 28 REALTIME_PRIORITY_CLASS 4 + 29 REALTIME_PRIORITY_CLASS 5 + 30 REALTIME_PRIORITY_CLASS 6 + 31 REALTIME_PRIORITY_CLASS THREAD_PRIORITY_TIME_CRITICAL + + Windows NT: Values -7, -6, -5, -4, -3, 3, 4, 5, and 6 are not supported. + + + As you can see, the real priority levels available to any individual + Win32 thread are non-contiguous. + + An application using pthreads-win32 should not make assumptions about + the numbers used to represent thread priority levels, except that they + are monotonic between the values returned by sched_get_priority_min() + and sched_get_priority_max(). E.g. Windows 95, 98, NT, 2000, XP make + available a non-contiguous range of numbers between -15 and 15, while + at least one version of WinCE (3.0) defines the minimum priority + (THREAD_PRIORITY_LOWEST) as 5, and the maximum priority + (THREAD_PRIORITY_HIGHEST) as 1. + + Internally, pthreads-win32 maps any priority levels between + THREAD_PRIORITY_IDLE and THREAD_PRIORITY_LOWEST to THREAD_PRIORITY_LOWEST, + or between THREAD_PRIORITY_TIME_CRITICAL and THREAD_PRIORITY_HIGHEST to + THREAD_PRIORITY_HIGHEST. Currently, this also applies to + REALTIME_PRIORITY_CLASSi even if levels -7, -6, -5, -4, -3, 3, 4, 5, and 6 + are supported. + + If it wishes, a Win32 application using pthreads-win32 can use the Win32 + defined priority macros THREAD_PRIORITY_IDLE through + THREAD_PRIORITY_TIME_CRITICAL. + + +The opacity of the pthread_t datatype +------------------------------------- +and possible solutions for portable null/compare/hash, etc +---------------------------------------------------------- + +Because pthread_t is an opague datatype an implementation is permitted to define +pthread_t in any way it wishes. That includes defining some bits, if it is +scalar, or members, if it is an aggregate, to store information that may be +extra to the unique identifying value of the ID. As a result, pthread_t values +may not be directly comparable. + +If you want your code to be portable you must adhere to the following contraints: + +1) Don't assume it is a scalar data type, e.g. an integer or pointer value. There +are several other implementations where pthread_t is also a struct. See our FAQ +Question 11 for our reasons for defining pthread_t as a struct. + +2) You must not compare them using relational or equality operators. You must use +the API function pthread_equal() to test for equality. + +3) Never attempt to reference individual members. + + +The problem + +Certain applications would like to be able to access only the 'pure' pthread_t +id values, primarily to use as keys into data structures to manage threads or +thread-related data, but this is not possible in a maximally portable and +standards compliant way for current POSIX threads implementations. + +For implementations that define pthread_t as a scalar, programmers often employ +direct relational and equality operators on pthread_t. This code will break when +ported to an implementation that defines pthread_t as an aggregate type. + +For implementations that define pthread_t as an aggregate, e.g. a struct, +programmers can use memcmp etc., but then face the prospect that the struct may +include alignment padding bytes or bits as well as extra implementation-specific +members that are not part of the unique identifying value. + +[While this is not currently the case for pthreads-win32, opacity also +means that an implementation is free to change the definition, which should +generally only require that applications be recompiled and relinked, not +rewritten.] + + +Doesn't the compiler take care of padding? + +The C89 and later standards only effectively guarrantee element-by-element +equivalence following an assignment or pass by value of a struct or union, +therefore undefined areas of any two otherwise equivalent pthread_t instances +can still compare differently, e.g. attempting to compare two such pthread_t +variables byte-by-byte, e.g. memcmp(&t1, &t2, sizeof(pthread_t) may give an +incorrect result. In practice I'm reasonably confident that compilers routinely +also copy the padding bytes, mainly because assignment of unions would be far +too complicated otherwise. But it just isn't guarranteed by the standard. + +Illustration: + +We have two thread IDs t1 and t2 + +pthread_t t1, t2; + +In an application we create the threads and intend to store the thread IDs in an +ordered data structure (linked list, tree, etc) so we need to be able to compare +them in order to insert them initially and also to traverse. + +Suppose pthread_t contains undefined padding bits and our compiler copies our +pthread_t [struct] element-by-element, then for the assignment: + +pthread_t temp = t1; + +temp and t1 will be equivalent and correct but a byte-for-byte comparison such as +memcmp(&temp, &t1, sizeof(pthread_t)) == 0 may not return true as we expect because +the undefined bits may not have the same values in the two variable instances. + +Similarly if passing by value under the same conditions. + +If, on the other hand, the undefined bits are at least constant through every +assignment and pass-by-value then the byte-for-byte comparison +memcmp(&temp, &t1, sizeof(pthread_t)) == 0 will always return the expected result. +How can we force the behaviour we need? + + +Solutions + +Adding new functions to the standard API or as non-portable extentions is +the only reliable and portable way to provide the necessary operations. +Remember also that POSIX is not tied to the C language. The most common +functions that have been suggested are: + +pthread_null() +pthread_compare() +pthread_hash() + +A single more general purpose function could also be defined as a +basis for at least the last two of the above functions. + +First we need to list the freedoms and constraints with restpect +to pthread_t so that we can be sure our solution is compatible with the +standard. + +What is known or may be deduced from the standard: +1) pthread_t must be able to be passed by value, so it must be a single object. +2) from (1) it must be copyable so cannot embed thread-state information, locks +or other volatile objects required to manage the thread it associates with. +3) pthread_t may carry additional information, e.g. for debugging or to manage +itself. +4) there is an implicit requirement that the size of pthread_t is determinable +at compile-time and size-invariant, because it must be able to copy the object +(i.e. through assignment and pass-by-value). Such copies must be genuine +duplicates, not merely a copy of a pointer to a common instance such as +would be the case if pthread_t were defined as an array. + + +Suppose we define the following function: + +/* This function shall return it's argument */ +pthread_t* pthread_normalize(pthread_t* thread); + +For scalar or aggregate pthread_t types this function would simply zero any bits +within the pthread_t that don't uniquely identify the thread, including padding, +such that client code can return consistent results from operations done on the +result. If the additional bits are a pointer to an associate structure then +this function would ensure that the memory used to store that associate +structure does not leak. After normalization the following compare would be +valid and repeatable: + +memcmp(pthread_normalize(&t1),pthread_normalize(&t2),sizeof(pthread_t)) + +Note 1: such comparisons are intended merely to order and sort pthread_t values +and allow them to index various data structures. They are not intended to reveal +anything about the relationships between threads, like startup order. + +Note 2: the normalized pthread_t is also a valid pthread_t that uniquely +identifies the same thread. + +Advantages: +1) In most existing implementations this function would reduce to a no-op that +emits no additional instructions, i.e after in-lining or optimisation, or if +defined as a macro: +#define pthread_normalise(tptr) (tptr) + +2) This single function allows an application to portably derive +application-level versions of any of the other required functions. + +3) It is a generic function that could enable unanticipated uses. + +Disadvantages: +1) Less efficient than dedicated compare or hash functions for implementations +that include significant extra non-id elements in pthread_t. + +2) Still need to be concerned about padding if copying normalized pthread_t. +See the later section on defining pthread_t to neutralise padding issues. + +Generally a pthread_t may need to be normalized every time it is used, +which could have a significant impact. However, this is a design decision +for the implementor in a competitive environment. An implementation is free +to define a pthread_t in a way that minimises or eliminates padding or +renders this function a no-op. + +Hazards: +1) Pass-by-reference directly modifies 'thread' so the application must +synchronise access or ensure that the pointer refers to a copy. The alternative +of pass-by-value/return-by-value was considered but then this requires two copy +operations, disadvantaging implementations where this function is not a no-op +in terms of speed of execution. This function is intended to be used in high +frequency situations and needs to be efficient, or at least not unnecessarily +inefficient. The alternative also sits awkwardly with functions like memcmp. + +2) [Non-compliant] code that uses relational and equality operators on +arithmetic or pointer style pthread_t types would need to be rewritten, but it +should be rewritten anyway. + + +C implementation of null/compare/hash functions using pthread_normalize(): + +/* In pthread.h */ +pthread_t* pthread_normalize(pthread_t* thread); + +/* In user code */ +/* User-level bitclear function - clear bits in loc corresponding to mask */ +void* bitclear (void* loc, void* mask, size_t count); + +typedef unsigned int hash_t; + +/* User-level hash function */ +hash_t hash(void* ptr, size_t count); + +/* + * User-level pthr_null function - modifies the origin thread handle. + * The concept of a null pthread_t is highly implementation dependent + * and this design may be far from the mark. For example, in an + * implementation "null" may mean setting a special value inside one + * element of pthread_t to mean "INVALID". However, if that value was zero and + * formed part of the id component then we may get away with this design. + */ +pthread_t* pthr_null(pthread_t* tp) +{ + /* + * This should have the same effect as memset(tp, 0, sizeof(pthread_t)) + * We're just showing that we can do it. + */ + void* p = (void*) pthread_normalize(tp); + return (pthread_t*) bitclear(p, p, sizeof(pthread_t)); +} + +/* + * Safe user-level pthr_compare function - modifies temporary thread handle copies + */ +int pthr_compare_safe(pthread_t thread1, pthread_t thread2) +{ + return memcmp(pthread_normalize(&thread1), pthread_normalize(&thread2), sizeof(pthread_t)); +} + +/* + * Fast user-level pthr_compare function - modifies origin thread handles + */ +int pthr_compare_fast(pthread_t* thread1, pthread_t* thread2) +{ + return memcmp(pthread_normalize(&thread1), pthread_normalize(&thread2), sizeof(pthread_t)); +} + +/* + * Safe user-level pthr_hash function - modifies temporary thread handle copy + */ +hash_t pthr_hash_safe(pthread_t thread) +{ + return hash((void *) pthread_normalize(&thread), sizeof(pthread_t)); +} + +/* + * Fast user-level pthr_hash function - modifies origin thread handle + */ +hash_t pthr_hash_fast(pthread_t thread) +{ + return hash((void *) pthread_normalize(&thread), sizeof(pthread_t)); +} + +/* User-level bitclear function - modifies the origin array */ +void* bitclear(void* loc, void* mask, size_t count) +{ + int i; + for (i=0; i < count; i++) { + (unsigned char) *loc++ &= ~((unsigned char) *mask++); + } +} + +/* Donald Knuth hash */ +hash_t hash(void* str, size_t count) +{ + hash_t hash = (hash_t) count; + unsigned int i = 0; + + for(i = 0; i < len; str++, i++) + { + hash = ((hash << 5) ^ (hash >> 27)) ^ (*str); + } + return hash; +} + +/* Example of advantage point (3) - split a thread handle into its id and non-id values */ +pthread_t id = thread, non-id = thread; +bitclear((void*) &non-id, (void*) pthread_normalize(&id), sizeof(pthread_t)); + + +A pthread_t type change proposal to neutralise the effects of padding + +Even if pthread_nornalize() is available, padding is still a problem because +the standard only garrantees element-by-element equivalence through +copy operations (assignment and pass-by-value). So padding bit values can +still change randomly after calls to pthread_normalize(). + +[I suspect that most compilers take the easy path and always byte-copy anyway, +partly because it becomes too complex to do (e.g. unions that contain sub-aggregates) +but also because programmers can easily design their aggregates to minimise and +often eliminate padding]. + +How can we eliminate the problem of padding bytes in structs? Could +defining pthread_t as a union rather than a struct provide a solution? + +In fact, the Linux pthread.h defines most of it's pthread_*_t objects (but not +pthread_t itself) as unions, possibly for this and/or other reasons. We'll +borrow some element naming from there but the ideas themselves are well known +- the __align element used to force alignment of the union comes from K&R's +storage allocator example. + +/* Essentially our current pthread_t renamed */ +typedef struct { + struct thread_state_t * __p; + long __x; /* sequence counter */ +} thread_id_t; + +Ensuring that the last element in the above struct is a long ensures that the +overall struct size is a multiple of sizeof(long), so there should be no trailing +padding in this struct or the union we define below. +(Later we'll see that we can handle internal but not trailing padding.) + +/* New pthread_t */ +typedef union { + char __size[sizeof(thread_id_t)]; /* array as the first element */ + thread_id_t __tid; + long __align; /* Ensure that the union starts on long boundary */ +} pthread_t; + +This guarrantees that, during an assignment or pass-by-value, the compiler copies +every byte in our thread_id_t because the compiler guarrantees that the __size +array, which we have ensured is the equal-largest element in the union, retains +equivalence. + +This means that pthread_t values stored, assigned and passed by value will at least +carry the value of any undefined padding bytes along and therefore ensure that +those values remain consistent. Our comparisons will return consistent results and +our hashes of [zero initialised] pthread_t values will also return consistent +results. + +We have also removed the need for a pthread_null() function; we can initialise +at declaration time or easily create our own const pthread_t to use in assignments +later: + +const pthread_t null_tid = {0}; /* braces are required */ + +pthread_t t; +... +t = null_tid; + + +Note that we don't have to explicitly make use of the __size array at all. It's +there just to force the compiler behaviour we want. + + +Partial solutions without a pthread_normalize function + + +An application-level pthread_null and pthread_compare proposal +(and pthread_hash proposal by extention) + +In order to deal with the problem of scalar/aggregate pthread_t type disparity in +portable code I suggest using an old-fashioned union, e.g.: + +Contraints: +- there is no padding, or padding values are preserved through assignment and + pass-by-value (see above); +- there are no extra non-id values in the pthread_t. + + +Example 1: A null initialiser for pthread_t variables... + +typedef union { + unsigned char b[sizeof(pthread_t)]; + pthread_t t; +} init_t; + +const init_t initial = {0}; + +pthread_t tid = initial.t; /* init tid to all zeroes */ + + +Example 2: A comparison function for pthread_t values + +typedef union { + unsigned char b[sizeof(pthread_t)]; + pthread_t t; +} pthcmp_t; + +int pthcmp(pthread_t left, pthread_t right) +{ + /* + * Compare two pthread handles in a way that imposes a repeatable but arbitrary + * ordering on them. + * I.e. given the same set of pthread_t handles the ordering should be the same + * each time but the order has no particular meaning other than that. E.g. + * the ordering does not imply the thread start sequence, or any other + * relationship between threads. + * + * Return values are: + * 1 : left is greater than right + * 0 : left is equal to right + * -1 : left is less than right + */ + int i; + pthcmp_t L, R; + L.t = left; + R.t = right; + for (i = 0; i < sizeof(pthread_t); i++) + { + if (L.b[i] > R.b[i]) + return 1; + else if (L.b[i] < R.b[i]) + return -1; + } + return 0; +} + +It has been pointed out that the C99 standard allows for the possibility that +integer types also may include padding bits, which could invalidate the above +method. This addition to C99 was specifically included after it was pointed +out that there was one, presumably not particularly well known, architecture +that included a padding bit in it's 32 bit integer type. See section 6.2.6.2 +of both the standard and the rationale, specifically the paragraph starting at +line 16 on page 43 of the rationale. + + +An aside + +Certain compilers, e.g. gcc and one of the IBM compilers, include a feature +extention: provided the union contains a member of the same type as the +object then the object may be cast to the union itself. + +We could use this feature to speed up the pthrcmp() function from example 2 +above by casting rather than assigning the pthread_t arguments to the union, e.g.: + +int pthcmp(pthread_t left, pthread_t right) +{ + /* + * Compare two pthread handles in a way that imposes a repeatable but arbitrary + * ordering on them. + * I.e. given the same set of pthread_t handles the ordering should be the same + * each time but the order has no particular meaning other than that. E.g. + * the ordering does not imply the thread start sequence, or any other + * relationship between threads. + * + * Return values are: + * 1 : left is greater than right + * 0 : left is equal to right + * -1 : left is less than right + */ + int i; + for (i = 0; i < sizeof(pthread_t); i++) + { + if (((pthcmp_t)left).b[i] > ((pthcmp_t)right).b[i]) + return 1; + else if (((pthcmp_t)left).b[i] < ((pthcmp_t)right).b[i]) + return -1; + } + return 0; +} + + +Result thus far + +We can't remove undefined bits if they are there in pthread_t already, but we have +attempted to render them inert for comparison and hashing functions by making them +consistent through assignment, copy and pass-by-value. + +Note: Hashing pthread_t values requires that all pthread_t variables be initialised +to the same value (usually all zeros) before being assigned a proper thread ID, i.e. +to ensure that any padding bits are zero, or at least the same value for all +pthread_t. Since all pthread_t values are generated by the library in the first +instance this need not be an application-level operation. + + +Conclusion + +I've attempted to resolve the multiple issues of type opacity and the possible +presence of undefined bits and bytes in pthread_t values, which prevent +applications from comparing or hashing pthread handles. + +Two complimentary partial solutions have been proposed, one an application-level +scheme to handle both scalar and aggregate pthread_t types equally, plus a +definition of pthread_t itself that neutralises padding bits and bytes by +coercing semantics out of the compiler to eliminate variations in the values of +padding bits. + +I have not provided any solution to the problem of handling extra values embedded +in pthread_t, e.g. debugging or trap information that an implementation is entitled +to include. Therefore none of this replaces the portability and flexibility of API +functions but what functions are needed? The threads standard is unlikely to +include that can be implemented by a combination of existing features and more +generic functions (several references in the threads rationale suggest this. +Therefore I propose that the following function could replace the several functions +that have been suggested in conversations: + +pthread_t * pthread_normalize(pthread_t * handle); + +For most existing pthreads implementations this function, or macro, would reduce to +a no-op with zero call overhead. diff --git a/external/pthreads-w32/README.Watcom b/external/pthreads-w32/README.Watcom new file mode 100644 index 00000000..24955165 --- /dev/null +++ b/external/pthreads-w32/README.Watcom @@ -0,0 +1,62 @@ +Watcom compiler notes +===================== + +Status +------ +Not yet usable. Although the library builds under Watcom it +substantially fails the test suite. + +There is a working Wmakefile for wmake for the library build. + +invoke as any of: +wmake -f Wmakefile clean WC +wmake -f Wmakefile clean WC-inlined +wmake -f Wmakefile clean WCE +wmake -f Wmakefile clean WCE-inlined + +These build pthreadWC.dll and pthreadWCE.dll. + +There is a working Wmakefile for wmake for the test suite. + +invoke as any of: +wmake -f Wmakefile clean WC +wmake -f Wmakefile clean WCX +wmake -f Wmakefile clean WCE +wmake -f Wmakefile clean WC-bench +wmake -f Wmakefile clean WCX-bench +wmake -f Wmakefile clean WCE-bench + + +Current known problems +---------------------- + +Library build: +The Watcom compiler uses a different default call convention to MS C or GNU C and so +applications are not compatible with pthreadVC.dll etc using pre 2003-10-14 versions +of pthread.h, sched.h, or semaphore.h. The cdecl attribute can be used on exposed +function prototypes to force compatibility with MS C built DLLs. + +However, there appear to be other incompatibilities. Errno.h, for example, defines +different values for the standard C and POSIX errors to those defined by the MS C +errno.h. It may be that references to Watcom's threads compatible 'errno' do set +and return translated numbers consistently, but I have not verified this. + +Watcom defines errno as a dereferenced pointer returned by the function +_get_errno_ptr(). This is similar to both the MS and GNU C environments for +multithreaded use. However, the Watcom version appears to have a number of problems: + +- different threads return the same pointer value. Compare with the MS and GNU C +versions which correctly return different values (since each thread must maintain +a thread specific errno value). + +- an errno value set within the DLL appears as zero in the application even though +both share the same thread. + +Therefore applications built using the Watcom compiler may need to use +a Watcom built version of the library (pthreadWC.dll). If this is the case, then +the cdecl function attribute should not be required. + +Application builds: +The test suite fails with the Watcom compiler. + +Test semaphore1.c fails for pthreadWC.dll because errno returns 0 instead of EAGAIN. diff --git a/external/pthreads-w32/README.WinCE b/external/pthreads-w32/README.WinCE new file mode 100644 index 00000000..1e064297 --- /dev/null +++ b/external/pthreads-w32/README.WinCE @@ -0,0 +1,6 @@ +WinCE port +---------- +(See the file WinCE-PORT for a detailed explanation.) + +Make sure you define "WINCE" amongst your compiler flags (eg. -DWINCE). +The config.h file will define all the necessary defines for you. diff --git a/external/pthreads-w32/WinCE-PORT b/external/pthreads-w32/WinCE-PORT new file mode 100644 index 00000000..16daa8d3 --- /dev/null +++ b/external/pthreads-w32/WinCE-PORT @@ -0,0 +1,222 @@ +NOTE: The comments in this file relate to the original WinCE port +done by Tristan Savatier. The semaphore routines have been +completely rewritten since (2005-04-25), having been progressively +broken more and more by changes to the library. All of the semaphore +routines implemented for W9x/WNT/2000 and up should now also work for +WinCE. Also, pthread_mutex_timedlock should now work. + +Additional WinCE updates have been applied since this as well. Check the +ChangeLog file and search for WINCE for example. (2007-01-07) + +[RPJ] + +---- + +Some interesting news: + +I have been able to port pthread-win32 to Windows-CE, +which uses a subset of the WIN32 API. + +Since we intend to keep using pthread-win32 for our +Commercial WinCE developments, I would be very interested +if WinCE support could be added to the main source tree +of pthread-win32. Also, I would like to be credited +for this port :-) + +Now, here is the story... + +The port was performed and tested on a Casio "Cassiopeia" +PalmSize PC, which runs a MIP processor. The OS in the +Casio is WinCE version 2.11, but I used VC++ 6.0 with +the WinCE SDK for version 2.01. + +I used pthread-win32 to port a heavily multithreaded +commercial application (real-time MPEG video player) +from Linux to WinCE. I consider the changes that +I have done to be quite well tested. + +Overall the modifications that we had to do are minor. + +The WinCE port were based on pthread-win32-snap-1999-05-30, +but I am certain that they can be integrated very easiely +to more recent versions of the source. + +I have attached the modified source code: +pthread-win32-snap-1999-05-30-WinCE. + +All the changes do not affect the code compiled on non-WinCE +environment, provided that the macros used for WinCE compilation +are not used, of course! + +Overall description of the WinCE port: +------------------------------------- + +Most of the changes had to be made in areas where +pthread-win32 was relying on some standard-C librairies +(e.g. _ftime, calloc, errno), which are not available +on WinCE. We have changed the code to use native Win32 +API instead (or in some cases we made wrappers). + +The Win32 Semaphores are not available, +so we had to re-implement Semaphores using mutexes +and events. + +Limitations / known problems of the WinCE port: +---------------------------------------------- + +Not all the semaphore routines have been ported +(semaphores are defined by Posix but are not part +pf pthread). I have just done enough to make +pthread routines (that rely internally on semaphores) +work, like signal conditions. + +I noticed that the Win32 threads work slightly +differently on WinCE. This may have some impact +on some tricky parts of pthread-win32, but I have +not really investigated. For example, on WinCE, +the process is killed if the main thread falls off +the bottom (or calls pthread_exit), regardless +of the existence of any other detached thread. +Microsoft manual indicates that this behavior is +deffirent from that of Windows Threads for other +Win32 platforms. + + +Detailed descriptions of the changes and rationals: + +------------------------------------ +- use a new macro NEED_ERRNO. + +If defined, the code in errno.c that defines a reentrant errno +is compiled, regardless of _MT and _REENTRANT. + +Rational: On WinCE, there is no support for , or +any other standard C library, i.e. even if _MT or _REENTRANT +is defined, errno is not provided by any library. NEED_ERRNO +must be set to compile for WinCE. + +------------------------------------ +- In implement.h, change #include to #include "semaphore.h". + +Rational: semaphore.h is provided in pthread-win32 and should not +be searched in the systems standard include. would not compile. +This change does not seem to create problems on "classic" win32 +(e.g. win95). + +------------------------------------ +- use a new macro NEED_CALLOC. + +If defined, some code in misc.c will provide a replacement +for calloc, which is not available on Win32. + + +------------------------------------ +- use a new macro NEED_CREATETHREAD. + +If defined, implement.h defines the macro _beginthreadex +and _endthreadex. + +Rational: On WinCE, the wrappers _beginthreadex and _endthreadex +do not exist. The native Win32 routines must be used. + +------------------------------------ +- in misc.c: + +#ifdef NEED_DUPLICATEHANDLE + /* DuplicateHandle does not exist on WinCE */ + self->threadH = GetCurrentThread(); +#else + if( !DuplicateHandle( + GetCurrentProcess(), + GetCurrentThread(), + GetCurrentProcess(), + &self->threadH, + 0, + FALSE, + DUPLICATE_SAME_ACCESS ) ) + { + free( self ); + return (NULL); + } +#endif + +Rational: On WinCE, DuplicateHandle does not exist. I could not understand +why DuplicateHandle must be used. It seems to me that getting the current +thread handle with GetCurrentThread() is sufficient, and it seems to work +perfectly fine, so maybe DuplicateHandle was just plain useless to begin with ? + +------------------------------------ +- In private.c, added some code at the beginning of ptw32_processInitialize +to detect the case of multiple calls to ptw32_processInitialize. + +Rational: In order to debug pthread-win32, it is easier to compile +it as a regular library (it is not possible to debug DLL's on winCE). +In that case, the application must call ptw32_rocessInitialize() +explicitely, to initialize pthread-win32. It is safer in this circumstance +to handle the case where ptw32_processInitialize() is called on +an already initialized library: + +int +ptw32_processInitialize (void) +{ + if (ptw32_processInitialized) { + /* + * ignore if already initialized. this is useful for + * programs that uses a non-dll pthread + * library. such programs must call ptw32_processInitialize() explicitely, + * since this initialization routine is automatically called only when + * the dll is loaded. + */ + return TRUE; + } + ptw32_processInitialized = TRUE; + [...] +} + +------------------------------------ +- in private.c, if macro NEED_FTIME is defined, add routines to +convert timespec_to_filetime and filetime_to_timespec, and modified +code that was using _ftime() to use Win32 API instead. + +Rational: _ftime is not available on WinCE. It is necessary to use +the native Win32 time API instead. + +Note: the routine timespec_to_filetime is provided as a convenience and a mean +to test that filetime_to_timespec works, but it is not used by the library. + +------------------------------------ +- in semaphore.c, if macro NEED_SEM is defined, add code for the routines +_increase_semaphore and _decrease_semaphore, and modify significantly +the implementation of the semaphores so that it does not use CreateSemaphore. + +Rational: CreateSemaphore is not available on WinCE. I had to re-implement +semaphores using mutexes and Events. + +Note: Only the semaphore routines that are used by pthread are implemented +(i.e. signal conditions rely on a subset of the semaphores routines, and +this subset works). Some other semaphore routines (e.g. sem_trywait) are +not yet supported on my WinCE port (and since I don't need them, I am not +planning to do anything about them). + +------------------------------------ +- in tsd.c, changed the code that defines TLS_OUT_OF_INDEXES + +/* TLS_OUT_OF_INDEXES not defined on WinCE */ +#ifndef TLS_OUT_OF_INDEXES +#define TLS_OUT_OF_INDEXES 0xffffffff +#endif + +Rational: TLS_OUT_OF_INDEXES is not defined in any standard include file +on WinCE. + +------------------------------------ +- added file need_errno.h + +Rational: On WinCE, there is no errno.h file. need_errno.h is just a +copy of windows version of errno.h, with minor modifications due to the fact +that some of the error codes are defined by the WinCE socket library. +In pthread.h, if NEED_ERRNO is defined, the file need_errno.h is +included (instead of ). + + +-- eof diff --git a/external/pthreads-w32/dll/x64/pthreadGC2.dll b/external/pthreads-w32/dll/x64/pthreadGC2.dll new file mode 100644 index 0000000000000000000000000000000000000000..841d4a21699017e835f330b3262e5b46e988a753 GIT binary patch literal 185976 zcmeFad3;pW`9D4ZB2ktbiUUCqV~rYIFmX);bpi?8XwWFAh+Etccf=dPiWoXG!tHfz zY}IO|EwPGFn;O;uw<3z7SjE=mUI!GlBA_zA_xm~L&fJ-V#c$isU%$MRx%cen zInQ>U=Q-z&8rK@?914ZH;Qw?w6q<`){zc^9o&VEBw+29^M_A1j&H`awh zm)^E_=#!@xoffL?6gp&&P-s)=pwe!gI)y{qQRp!IzgH;qL~r~Svyyo+|CQ%XYTSG+ z4B>@;#h4A+s4_asyh5Q;Nmg~GK;FAI`9w(s!|=gGNa9>KrTP-D~JOE0o6LgEw5C@u)e zw7cLp@D~X+whf-73Su|_fiAa4yK<4i7vFG$R0WJf6}kC-lP#g9w!xRF_5?kUzrj8y%E8?l=|;ea&($y4=Sdl&eznn8@+ZMmgfcmi%%N%(vo5 zq26z^y-G=;Q@w-Py<&IQKA-E3OW&cClm&>;P|3CdV zAuxJg2#ah+H}89t4j#M`VxOy`7?h8KjMXHMlhW4}mfo{QenZ<+R5mOSP_RkGQ23V(#h=$1}K zY%i3aw;yV_Gqyp1v91j5f(y^DId4gHTY)4sr!F&{E(caH*O^dM*~az`Ujr6VnP%VB zX7#ejvjtWq#;{;mL8z|s!&JBNtw=Ru=*b^QgS}oV&O$|0Ykt2n?G( zQEzXW&l0Bnc6wE`@RWgQlGBq(ovY@kW^bd#)H9~j!#x=7U-GdufCaVck@harPGg$A z+>Cx!WLAGQxwq-;!9G4`LV6XFZrq4&+(wQzS@;mD@DGo_(2vQ&d-anV>^*qPABJ-_7L7$WnDNzicq!zZX`feCYT8rFD(u%y`|7eP)3(aW zP5bW+_N8T!276iaMNZ+l`(lMQW0d7s5%)KrghKVUYrkXKTiw=1c403!Vt+(u(Qi9j z*T>gc*Vvnqg%_cD^qDptcHyvD2mP21dTDUbI!0|SG4=~3hNq)j3T`ZMhoj}_w*@uE zT}zvP;~tm-Ebl?SdkUV|iS=-%-;(dsX(lzlnEGWVv9lyvW8#~Q*iX=NCSxx&U@!N^ zBMt4<#XdA*r>p$R)ttqPr^%Gm%X8mJP4%+s(@@Ae5M?Vjdk0JPh`*Y!(j%Ai95 zNi8nPtg!$sBvbLNx1LD!F8ufz<}%5&V`U{6NjiM(Nu+Vp(RCf& z;PjXDuuC82}4tGBRz1ho5dlQ>Hf}~n( z+Fm-Gg5r>RLg;C}8YvPlz}QmjG2aPTpvU%M)$=g2gr>1Z!Wf{qx@@ebuqG2IQfh*h zu*y{c9w@!Gj0{p9%H?53G04@b0;ue9MLuAni%ayNeBkVX{yEyjRmGK?In8ESLCbWy zK2LGMv3GYGORCQR*<~JNRxhz0G^0yo#SX=I ztOL}F_4O`CF=M|L0Z4R8Q9-}W(T_WO)ktj(c6OfMnaj=&;G7STzJ?$p^|$PLN#f&} zig!KQkR_C)`?;>K5Q8)F6v%)j1>_f_WV*o?vDHhXy&WOAlH z=}q%lFhM|5BWzv}^G!XVz0BmW5&>{>Sh4=4Di|_nV79BR<2dw5xfm!aK>!2a zRWmAzL zA1{*Mg=NL^`)FASejDru%S!p~aM6v}x!}5HVk*i1J+O;ueF{SJsG)ylK4d25lyT!h z&Mv>nSeZ*EjXx95>jTeg{b$Gm#VL+gtCS?Rf|r6%2tPbtV=PGcSi&`NZEdZ!=<#p`~50pc|`* z7Y$%G@s$?&-f`-^T)&?x?|L~P1!XxLy&R5S4o5G?^rc+AzA?=E7YLN1nA3!gMmELR;89XUO95|_|IU>BlRRevh^#d86Rl_M7u5L%0D@vOT(?+&%DffIZ$epQ7Cw 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 literal 0 HcmV?d00001 diff --git a/external/pthreads-w32/dll/x64/pthreadVC2.dll b/external/pthreads-w32/dll/x64/pthreadVC2.dll new file mode 100644 index 0000000000000000000000000000000000000000..165b4d26ec41c4e563782f116b4a2e96936b0fef GIT binary patch literal 82944 zcmeF43t&{m)%a&gHd#W#24pe37Y!O;7ztJ)QnQf24QxtKP!y0LpdhFbb`^^V7*brX zsnkcc*3Z&vtG2d9Ygdyn#M!zkYuLbMM@F z&pBt#oH=u5w(P<+Dn%)kinDE{*7KIXBK@C|O zp1bU+3nR1mUNUV;q(X;pjSSJ>=SMEq?~C2|*^&AB`y4m?T=zX$zt5RJd!Cfpwg=@U zO3nFNx;pNWjT61NCUs1>TbB%_>Iu2R3C(|+ceeJg@X1U3U6k_6gFo-B)(|VeATwxeEKg;>xM3xGb=Vrsj+7g)P$49{s!0LuZUI;b&{#q z(uv3i3<9Pc-Yx!$l&T$C=_CwDodT|&y!*CGS2T3KTcE%K7^&{OPi~j4cIcwTi)It0 zVFwIVfR8iVr7Ie`Xzs!*N%#Yz6)@H98{ID5Xo>#+>2HVpHT0gQR6~zhJZ|pA<9MLd z@XRqhE*D?U2|NmNcswdj-kJgPx^!@9vd8W-?LdyvQP8DI_5Z|Cu9 z5szmi$*&mq4L5@OhLk)WPaVtSTm5+K9>n8!U*$3WP9DDojSb;2k5A6wu_eLdDu!l5 zrsTMWfzz-^Vn6#5kGsTo-?=ZJiaTB zo3G^YKq-%5C-WF^J&z?){9o_q@!oYjK01v@?sOiv%;&LPiXYO4$C`2;CrP0{5Rj~t zZ0`sRet8OyVNiC%3<2j|(%)k*=J9zAk3L`F5tFdrUBhF%q0uGU0M}7mB$)^WIrjs_hKI3 zn9Czm0Ji@w9*a)oae03pcgbUuVBz_1@%Tt8irve@mb|au%_GFnX=plw#{@xl?;bpQ zjOX$2w|V^X93I1l@%SI<){-#JnomzTcmGi-pa$jf=AQ&JbrW;kKPhC zSTOU>XdXvj&f`rq$A>jH(+*vy8{oEZX?AlHr+G~ruRYV9 zCeA!a6O(NfPwV!+W|&>gSEUK(254w}pkZzjI2Rft>tlIF&4e85gpX}InS^e*UC4I3 z@MKgVcKEF*sMR1E4TweqqR|13R%3sCzuKz3+3kB_RBwwNWtf7;ShtlU-m_~r$5RSw zH?8+6rP?QN(LcldctbvkpoN<8FWRAx1zu1?_WDd6nrw5yE+av6mIRDMd7fcT#BbzC zy{Sebl4m5w5l|jB%n4J808>sx*hq|-s(VhCAdPr)9%P7O}GuF8&OX^!+5vB5z_sxxQ^*>nbnCAx~v z;IK%?b^wP-I)auJ;So42uYipNS1n5sqMsNrYNl)j8GDVYjbL&{J#MFwDBJ3^yhm^q zav2GyJecfL$56YdbEv&y2ync%wSd~sbp&m@A5TY6bNKl661&X~{eXAF#?Nh7=(ubL zlQRQmx2QQgV24%`X?A0jnoV|SAs~zpcI~E{i>&XI7_*iMizUq?VoQ}MJx!t)vlj6w$qLrEb>c)lGHg4Gi~1q?MMtq>7h6_rqz zFxn$yUrEb0wLr$pI)XNB#?#!Uoeh8ZM9TYT#?%e1>TEHlW_fj%x2khpk`p-ua3Znh zvYZkIN%cic-cd7_TM;!E=FW?nb8;&U^T}LRztH<*xoh?No?Mn&GFvQ(%$(7|l-g#- zIP&@Lgn*W3iwx60CI~4OY&H_bNPM%I?bq)a{)<;{_-(&2#>!{H-%VG>{y&QVy77~q z(6h18I@?I87s06}nj1Fe*IF_wq}1D?H;ZMYPR|Voe_5QHS2ll-#6(l-OGoax{`AO6 zd#XOM<2mc$#n5q-x(aq!<5+e>A4StPQL+~}EE$LZLoL zi`Eq978x~@b4O^Vdo@9bKtrVd5s3I3L@G3@UyP+h>{=sbSNyNV38Y1l&!%l!-_0TO zgUa*C`h;w@@;;6>NZFx#$AAO`m2QpY(=I`m|&oIm) zz|~>plKyBneb7yxj+Bfn*0FhXw~y#k}xEwFmqweHwXWW5uR;pD|Q2~7Vh zgf@qP@6yCH)-Vfl&I9d51^XE0AYAeqiPI8S1xjls)Pri=;wGGh+iR@OdR7vEa)G^| zn&q0eV4m-xdg4gI(U#6pU2ccQ=rji$p|BOI2kRJ6ovl6B<(3;}=$;9#u3G1nZ+=Z3*JF zKZ#)BC3c#bB#0~688aY=3K3yo2Pn=q7hTj0-G3Czo#%7#6#!r0Y;jI$Vre)sSrBKK zrxm;l;tJB~zed>t(8aLSs9PW?%aN$69U5gbTA&OPpXH(KoljuT7i-T&*@k(2PQk9o`gQPk0BF^-d^Zw=C$7)2$L1JyV;w1EY#tj~ zr0{P`71SQ^#nRB@gd3SPPydMo$sor6L+yXAL#&I3n0J{G5lQEJU4~uhoUmI+ziD8mOtvY*0uwDIvUi5VHpb5crTOkQ!Kf;40DMAOKNQoMI|V`_0?cA%Lk zqKVnr=zq`98N*UPYujgQD*M}^Qz@;~{0)j64exw&i$EMvIEGLR#0`c^_+JZgS6*>c zrpPOQvqO&vx@lG$dBr#^f#sm`%0x>3Ps=N?UnoS2709(qx>bGLWqDd+Qfg=NAn8MH zdRLAvB`xA%$8xl=_oO`Ql<%YbgUYj%ua^OyoE|ucfYwqzYO#KS@Z)}Hvk@xXZuR{= zI{lqcl^x1F-G`>O9(1M&@vuq~@&ECgctloy(gj`#Om1$QYugFKT9#lDkaSQB2E-JS-|o3s)`?#)s-E zp2-tVosfV{rKT5=lk^(!awoP$%R2T7XsIk}7Qsczsc;f%E>=TYH7{Cua}v5TCjb^R zI;XVoMyWU6O%(B^i52qk*ABa)D}*%AT*8A=Yex6pR5&THj3P_(){{$V;KckJ1mfm1 z9hc$K%NIwF(*L4BvU1>IuDDA8>%dFH$NL~i#;+YpD{z+LBV;L_ub1MD!(=J0`xS$? z5nQm1{Q;x;nOGNlqmfb@|Iidd>R`{VC1!L1$=2-HVTSIuWrcg}iz8nQ-d@`x#>v&e zdaB3p4*Anzu_xU>fq94Psh`sA{{{T1-THa|>-}nntdt?uj_F8Was`RZRsG%db1xz2 zAW~nKtGm{9A)83G?Q**KCx2)9g8m2LLmp0DSnB#a(iem~uUZ!&`8%sWd^q*X{;bFc z*|JHSAIyf_-xuLP)M5p@O3nJ<39MbLiZ^Tl%rx`H8yO5R zbjJI1nPq_{RGdH40a)8WuiKrzW&FSdugO@CF$m%r)!9?eRP>W%Q1-JB~P6!(v+i;)`O)v2XtD!4+$hO z29abjl8BU*U_xSP;*|M!bW8U4&vUl-=LzSl-WFVS861G^{eY}OSSqovua!;F!dW@N zRTqF&e1YJqiTKzu;c<|s9 zwBA*1m96&*+G+J@QBZB0f*#NXIl!vkqqnskV42UwQhJ-d5V+&n&jXLE+5D{E;o{U>FD~~T>X;YYGI{bf}@K63qK#f0F!u6ISc}Hlt$OFYjF!S~u*HFbct>_0J6e(=h8g(~K?E(H&{VF3>SDPiRlpYwt^yANgXvWxZiu z5N3U%aq_IeTor%U)la_QX}W-#w9M05)21`qs=J22B;3x+;V3CFGH^E7w+)eo1HQzl zS3aO>CZi${Z~R*b9Qs`O&R&g2X2#bOt&vz7q*7HkU`~A zW`}y}=A)Z;zq`oy%FR;dVJO?(`LMmxtz7H55j>btiW75C{paY485Z-P)`gG=vzp&9 zKW{v3gXl1|$Z3aWYa||khXq%ORzULRiCPPiVoh!~p*mwd>HjuZc9dj>T^p&H~I4v*|3m9(LPzd5H1?5Xz6?FxuFaOu++#G#0iiHKP9$G7* zf6=5+LZ4gjDxY0Nv?!rN-vBFb5?|J(G@eaupU00fYC_@nWVAhRUG_YZ zV}0XsM0}?0D&{7019YyeWrT`_(q7$=ZLz_ief}ddWS^C6tZus4 zJDHxQkj@VMlrU$NvvRY5;0xfuB0n274_YF`t$ZgN$+>FO@7~dHzC?@BOJGi;ULi!o z`7Bqoro96_IBy)3g!4YUI^8~6>+zi;Bk@>n9vP#F`*TO|7I+s~cRg#{1^c2kGf}dM z2@exC^KA?{gGXMJ`88a+x|_HE)M}b-xdGKrs%*7q*lGi+myYge(0@P&^q~K}_ArR* z#^rHxhCpxkuJtV1ZmaJ-deEHMVMfVKqbe!2>S^J}l;{8;wqT86u9l#v87MU;<&|L| zU7EO-X<$4nk8PrsMI|f3k~u!x3lQlEwd@+nCu&)Aw2oRpzrhQO< z`yXdOI+XrX9dJ)>Sf~Ul&*$yYuaMRZ$E@9pVpeV$>V0+24E`6!2q^O0{gLp>LT$ef zDtE<>DmJ@BYKnqY2L@h~UYv;Z?^qGovAhwP64ATshIv9s!Mml%n-R0#{2*c;C^7$l zUh|r?NKMK6jX^u~8$j-;)*|MXk@dlwzXX+3ect7obgh7sB#*aAa?4SYR!2#)a+cB9GeOLFB z)mx_%@d~05d>pZp0q?HgSY%zKWAKz|Pg%fxmGpHq4&beO4ATB+i zJ?UCpVh0Qf$LhI7%Pv{wZ`+F~Nw$jg)J8;U$6IfuoL0P*mM6_9j@R|F7XRX{DBSUh zeq98?oG8+Jc#0mLH4o?Rb!JV6-4!xYSwOz^2VtYkCd~s!uN|GyvpTeicp1=9^Y;<+ zZ-O6h7SJR%?6$GFDSJyKYl8wgh4!Ivii zWjrCGq~88VeW^FRiX!G4){M=zU2M*DcJd-spQObCiPa)BHFho3?_f!jo=B1d%SevG zA`#2=C@d0%(okU}Q>~{du{p6bT`~%p>(K2^J{rsRR#sTva7~t~4Y1mc?fETB%}bW* zEM-6Els{%y^H`b95u<+2!P%jY2#f@?Q**T(lAH{++*j#NhL>^zR$5(=Oju#9-lS*4 zb;9~sXa104WHwyle&5Y^w8okIOtx*Og-gxFd8Ovk{4#U)h*I+{VIlwPwM3%duNw8n zo6tloV?F4Go3Mu?!yvz4Po2M(7zwR8H;kd9j0psfp8u?ijH4b223ZWEEmvt2Q zec=f)O}0Z5NryTnG3slS0$#>Ar4)davvd*lvQqNbEYU@LON!8XWr}$AX{U%xDPoV2 z7%)MKuw#B}(?&Rs|71R8Jr(wpMs4;r4wvJ$nUBwpOpZ)JFkT^mFh@QAds(Ev8$2N< zi{$rzzq>>M)V)LfU9eSs-fG z8RkojE@>tfItv9=zoD7Hm?LATGA;=&r&{YLwL;j%xl^Nwp^faCl(A@el5~doa-!Oq zZL@aoRm!^VX(yp!B!&j_fPv8a3aT>_W066H;ujzcZGrIfh2WVn5A)dI;i9Kqx}tNn zq{P{e_Y1a_vY&~{2>W$sLup>*B6ORqq8IflWnFy<{S;G>VD&L<$cTRBVYl^H3dy>i>GOel|9$(@2ZHD7!duC8wmW z$!Yi-{fU~F=9wFtB4S?~s5;Pvt+1)f8uk#Qi6qJxFSi<=vTZr!YvxDIC4u6a`CU$W zE?CXV71`<60)g1&jEh0QE=}xBs8#wgKM>1$Lfge0z%J$u7`&*!82QCsi_b_l_~IS{ zuwZpJDn@o}ZqCD!#10K3UYFG{k`!#FWv={0N()xA|K!z+C17?mu_Oo0bK%#PNEcX4 z1*>I2E32r6kMOu4MxX==ja!m{HUM!rKCrkDb+17BIS10uk;Q@ZCdvHnCHgNoXcb?{ zdJom#BCo$^C;Pi7TNB8jR()OP^mQz8y04ArXo_i^;Pf>|DS&cdS8SW@Bol&8+{dxqo8+8AN0*pj7 zH*oHh^EDS)Qi3^iRpDob`R9oFISSuJLF=?9VHyX7FdJbShS^WF84rSaVG)()V)iuT z=oy2gf)i;sqG*C5R}vq28ZW$JWQho1caT|VAVqk^jeGV!n31vh!R#@P z>dWCULCs;h78foJH1u(K3bn){$tI$>Y}3R?9#1y$zAU$i!RpIcP_}61(_-;ioLCCS zS)9{wv#=nh36`re#!H0b1Xn#RppYraT0yTP=zEJ#`lDf%Gl`)Ox;=Lt@xf|Fg$ve* zS?7RqlrHZ6+_fYq*mudAQZp5EpdAUi(SMMi9%+r3z6Yv{kS zKH0UcnaQr*g2dmV;c@uw1bEXoNujH0_%Th?7-{%EzLmDaq3*=*w9M&>HpzokVUmYt z=NHcKy($}7DRC9r9X(7NF4mcn1G%($AbTl_NFh)wx5k4A2g{m6d-KT1_z2Pe2yg@e z9&jAaQQ4MD?k1V$lE253q>dz8)Duw2$Ungr$D}sM=I(ku0X>P&tEB_@_wwK$Sx-VF z?~((J0gVO@v~ev&KMxa}>zlwF__CG5ek_FdSmWG?S=)k0)&P8jsel93cu7ZHGOC^u zXfir6q)g*^C~j!hwLClO4sAH3=)IRjE}Hp;pV0X4Vy127W7Z4IAbpVPG3BZH;Y&&N+rb-ez*A7`NT>p$lj0{y z_^Rhz&V!}Xf>dhi;Oc%g%yhe&b|jK_O=*mk(f<>Y=k zo5~wzOHJSkj^7mA7|{Z1hPJhC81FWsLZ)P4E>Yeqcv~Z>4QbVBx62VDC+%<~zmwvH ztl&A7upreiODLQJ|5|LU%!w9i?h!>LAFO^@mv}AecZVNu<6ERc-J?qD)t@DM)FG`& zj~rUl{L&;hODhoq1u7Jn!09 zM#4yMb&)U)SNrR+@Cq;=ShqbQbc)#oHZKid9A<73qebhrpTZjCl*Efh)t42veiArm z9fDlwtK@bTAy1gB^R7>`w#P7#L7?q~|PHU+G0B=R&p2fdo8H9i4N9|4UN@yDO&deC<` zHN4qHvvdp`$71^_e~n&k(~`9THrMX4lTIBDKJroziH}km*8(5iG@y4A*tpe99|c;L zFUz%S6X0X{V3v&8h*FW7atKXx0wptS0&T-mP_O6n^upJfJ-sqN(_Z5g?B`Dw-G z#+uaABKzwT=_ODV^XkOx;*nd-S0cf$?4&z(sE^x~6V7PUl^xVUSGv-bY)zSV=w*=C zA&Dc&{ZpsLr2nv3Gy^V?ejs$p{INhr8C{?4s_?P=Wg*BW*&IxRZh9CfSWt09s8~P{ zA8LhYwjDZ&mNwhMGZs;(kfjytfTGPo)*mP&G0^;VBi8DF0~XCmn)B-s+!5Y73u|fr z7b`cMgA+gqMQvB>ZUJm<9K)1u8@fO^=yTRH$I3yT9wVQL{nhl1d?ubW8mu~y!WlV+ ztiw;g`6JtQMWBP;(9pVN0?ISp{nKGsx!D{figeke&saHv8FfP+y;&w+-(9NAlqwsx zQd`G6s;$d!)!!*@f6Ltd{tyV$-!X=H)Z@}$ud^BU*4SWNPkSqTsAjy|L&55L5lVE2 zH+jaBe^;l4o>=8^o)bZBvSYZ6pm=)hSy@D35dV=e^7+`Yn9T09;`Grlnao9`!ekbj zpP*sVuuvo)HZ@MDojor(t-;O;~YWB}9 zMK00hiJ<3*iSO#2D6|wAx?C)vwZg3M8jN_~q`%}1u6j*6UNaF>vMGD5vwuj_Y9_En zJY}6VjE|@}ZE6`4VXzeaL9BO~IW3#dIJTUxGUHm;Kg57&!uWWdy90!&an-Y8nW-(A z*SQ-;W$QcxA*&|a^g1J<|}1zBwhdgD`6 ziTmOqGgxZwwnOjn`M6AMXlaVy7YRrJWNwMpAkL%UW;@5xY)}7B2}3SFW;4Bo zV9hi(|H^(DP0TnO_e(OpfMcB%e;PX+jjcr4L>aG_V;n%dcYOZ>DkvG}8js%miBL%i z*-B9D>dj?77-U>u<6Tl|hps18lw$>nlHY+4HVbFe#WAWY`<+%@Pn9zGK<}k}CD_hA zUsseTtjMXlgjrjfP_kc)Udx`Qx0;qtCfj~VBGhu4bVtbG6g)3jMGwko(tFTO29Fdd z=2W-!&ws3IrarC~+gNEWoFr=^k&6aV@}KM}z_XsJ0pnByaQ=l>`Ds<-Q4yPwSMsWy zMW1SLMVC2M+ZLSyLCGeG;7D%@WL@dq`;%#}6f!Gvy zo9!toT|mDP0>jDx zDw8HhC4bTehJNV{K1xqsR1zUib7F_~lLi&9?3a->G25~@ou6KKdLO zD_>+i?u*mpGu>PI2{@2^7KfQmtnaMV{hPs=6+m~g*-Z-hIqV+t$x7L1ev}x4#GFWJ zyxgwUibB3?A~pfj%`vHkDZ#I6C5v1|yubm(G1%>BOh0etSbHg6hMCj|PTa+(Ie|ME zU}pXkx+TV>Qd62ak`mMHZcY_q`}MqazvPt@h({x;Wt*>B6%Ihz-v7SPm%d-4b-`q7 zQ&+=9l#oyAFoF8`D?`!!T{o?PC$2nRb%{59Bmosse z1sdm4d5QU_hNTQ)qvqz^71Y2EjB5mSvB4Jw=j$@_t*_lH9k^KwGcuK81oeGNmmp2U zPSC9q1e3r5i%D_19IHadC~%GP7LW$>9Bc_)V?RO&mcW9@$V_cA@}H88gy@RS6LDi6 z=U_dFqd*WIRi2__4!CEWP+MZpg?`ohh-UZqf)(ZfF!P2$r!1ADL(!>^D)pD*h>Rq)w)fdaQC#HI9`=Xg* zHk23$=j2{r;TabKP+11Vy2-H}k#V$P(egZu`+YOMC?><Xq zQh;rBPaZ}J%qu#Ly9h@034;a`q&vq#$+$=#RDJCq! zY&&st*WJP^JlPa#k*0doaw&D_EAfz>Tu}V$DdX@;l=X$S@nenQTwOSR1FMRf30qk^ zw7R~K!=I;0lwM0r3q;IMg$K%VVyn9rri;ntglJG&-&)veIkAlBj%|0R=@@Kx$7|1k z1&@;wikPP*l0OI{;6arlgDgQm$IMf`Q3B=M`VYh-@`|*s;eX_-W0n=}?`vE=$c5S3%qe@l;>qwLUPp$kegM_5tPH;yJ5 z10wB&6t4G5H4Ef;9?`{#W37{Qd5nR9gk+nqSQY`K z2N7q9tSac5^i~!(?m=}~+#vf@v>-V^-R>&Jnbgvp!y&ok3g<%(sqFuqA-}?aE(3f1 ze}iq};ZUHfpM;VIIZ`LLXK4(2+QpSibKm^&!@*cLkC|{>+Z@y1l|d(<$-6Fh1h78V z3VqW-bNn=WOjx6qofE6y-y{@71UL(_H8G~YRYN+4rg^}s!UqANpmF3&N&+^Ax(_7~-h9ePy`j}Swu6Rk@mR)(n^x(4VadkOH{ zY#`Q^kcwl;=>j-wDEUN-@u*vvb@m->#vjOzan~y|-~`G79zXvFK_LBQYF*f3Q>KV> z7fk$b&}a8j54|%JTr~#DftcV1jOUZsIiP0jhSDM{OqP zEzC1AL6@7GTAYhQC z3TGruc2zi)cqKl!Q|(Q6O0a&ihG}e_%q$d|)D0b?aV=P#47G@9>6XZs2d~9P+8gE zkSQ~c#&Dq9!Zw3WIG{~O^^Mw%h`wHYa-R5y@Pj-gzc5wg>~aQI73)#bLoa|vh`;I? z(X<9QmB^*B+*_FNu8m!Qw)Nb45e742Sv4gnx);d4S&@j+?p++v&PX&vh3UZ?ZWSPj z#&NM_ZC$M%c+M*9Q_{@ES7!1N-Hgy zNzX@W(c9_o0mS*48 zXUv2z#li zEx#ZI@2e=T8OS;4N(xREZj(y8S|6EVx z{er3Q@26dTzICzINJq{?qo;qU3k?f+=VEx2Q~S|RLBYXQXQc@I7CjmtDYR|-kZIFPzX{O2suLR)>wjNEf!m*Q;jf5 z#eEcPX4jTF7xI*Cl>saFd+9|p(py=rx0zjUeU%K!gl*P1*}D3B^q#fsUEigs7#esi zcP&0hpaKQkMOvfJ;!Wx=Ou0VKdh90MQnbRi{7zb`+c}TG$dkgmip{15lXo=nW$WIA zmvoMoG}}rzfn7P@M_{puYMhQ9PXWc|UVxaXzYA$N-$vnpZ~aiSznCU^VJ&klq?%!ByN|B&1Mp71Nj`)Ec(x zV1KF9R8zJW0y%(d!dVcC+%So$GH;K4m0|@@h{cPp!F|Uzh5nLBvQ@?dn7q$ zmn1pztb2b`d1>M-VgF%A&NrN{t7usrkVzGf3Z8wyn%e- z?f<`B3ktov69Hw;$)RKCTe^fm%y!wniDdPp^2TN=JWY~j-W z%h@3e7mmqUj@{0LKw@dGZy`C_|TMJ%rC;-{t{*=#hzW*7qfuUcZW>2fYzIx5d?V5#mLVs*o8~ zxL+%gsikuB0Zzjno|{71;K zU8O>wE%j-#$TZB;r`(6wZHr!KUp&>^-`EfR@XJir+VHRF6?|APG})mz-ny~cCaLPP zF0md}pZQ{$k3%15aaID79s9m^J72z7U-Q=(ICjOrF~CncHl~=@YbLTxBWTon-vd3! zB}I1Vt=$x^SJ=F8~cr0##kpTH-K z=_IC{T>SV>1@@96>zRMH#@!&qpW|9fvSL9Yem){0&Forb`-0WuwR|`R%6}|(1rWhl zPUcma@e}a_xF(#1xsYuAt|5V3(;?$v0g?r2JT*@8nwzzN#Ue@Umk68ix^(8!A{f|)Y1kkri2Q5Z{7_eQGXGLHKPEWq zq?%5t>l|`hA6)NImo`+kLk|On9byuiY`bs|k)rns7vg@ImLk;f6`gl-J5BNqZOM+c zP=aU=l0PF^5t)HajI*F`8~U#x@qcR>osXyefViXa#8`?2gd+dtc*@o(T8$?eH_mtxU*XSWR0XU1^OT;n98Y_89&$X*BgtWpr)|qRC$*Ur z#CTZ3PMy#@<0<}vH=Y&{=Z>efcsm?VFKB>`DsuBPo=#8ZKgrF{c&dZheFvl5!)jpY)SU^@__=2m_7$h>;*r7^-+f6Tr&2wwN+Kxt&1_9^knnzuEH&r6=VF{A7?tVeMtP&8`A?cZ9dhn*+2(sRjE) zEdAMb4{;AYn?&4i@wP#nBN1c?F3eHaJ7tKxxj31BzMCJE-HW$#logTN+Iw{yl-&)W z580h|3EKDX^*dYj@1<>C|F%g>9kKg!ydC!M6pigs_c~=r|87g>Pq_K%-&1%y?_UME zE!DPv8-Pi><{vTudxMqlD8E46zw-`W1^j&Ps@x`IM!Bn9F0RAWu-vDz`DUTEkmg2f z2KX_+bZyL@jbfgb15>a==MyQS(alc&f*sapgD7X^W~t!tRLwJfWo4dWc>-rYliV|JHCSY9>KO)d-qruuv*nAMegDcTlGcqnXoYY~qx;Ncd~{ znS8PSaUCaeJuZDy7-TC=z;NeY%3}HKUOE*8ui@myc`a_eTz2`YKe0P z!r$<=836rlTa`h2y9-)uG<7IPMD3^;0$6#=ZBKEF~dP;Bv|(8VNa?H4$=f4Wy}2X zp!D0_1ds)dj03g>R&HK_M@Gycna2O21bV-z_3zi#_|Lu-WF@bkZ*`w)E>VYhpXxU@ z3!Jso)zJx}n{;$XTCsUL24;J{_O!ZB^;eamN^Sh7?^7LpRgzZGtU0n@a@+9LP115S zf6jrPsiG76f)rvR>3ZjLPG7!8>itNp#ZQ!pHy=CNXCO|k)w+yExm@Ktx_x4&f%+>T z66(u9N~^W_by&mNjqbS<8f~7>MS{)|`<$?+J7V^zl_`ZEqSD7EtW+5h_?nE%h6rnBJijqFowdVRRobpS=Ioma*w#3{4N0D}&BF*0_Ta^3YIX1tA`IKxV z=--=k*iiBN&eeKm*;an1f#h0IwTaZt(titWlsD-(zrx#@z~5WS=~Up)*0CK3{D0Xf z*=Y7}@xXmtwo`S0IR%66_EU*$QMcTjYOh&&{fZ==mATVfQp&H?)s0GgT{^9oyI-rN zUaefbPFmmyQ;*Xa@I{Y6y^x4VSIGkXNS{l|fV|r;D ze$?WFKy7TpsH*6X`en;6Ce|F!26yC?r+IQtxjZ?2G&>o zw%-^TpcOJU%U5nZdvs9kZ*YISaHHMRtlMY}N;wcQ)%;qE*)!#UH4Dro2Pj7<7(H<= z2_d`t+hi5GbZ7O-r2k8wkobfmxky~m1W}dhqc=4ZSZYs}EfB0%tScA5W@P{nQn1f_ zUJrp!RVPCrD)nxQ^AqqedRM*3F&WvL(DoXJ^^%n5-gk{nZM*XlbDxrCjk?}U4uz$^ z@`l1y#JNM^2YA~Ih3;CMdYP_x>s`R3>7DWLrDP!|yM-_wW=UP0j)xR-TldXxGahD8 zz8(*5SMxgPs^P zfiYdK^LlYE>3FpG-|*J!t^8DhfWP8KUe0<;&T?6I19iQrwL$S|*4O!ON;tPG+o9c0 z2(89W=S+}DtUfZTl^%}QkTbW12FYhww;ycTtf2~&)e z-Ot|1GsN$2eV=kLppBhYm9-sjmqzF%Ys;m&90}mCY85X#^ajmD$f)yIN)G;H@hHGB zSUlGD;JtFQKF(#Gf8V{%q5%@NCU;pBQpdj!|+$aZ`xNkn-N&tdD`*>w+}Feb;k*$t0z z8j`C?_!9P%FQ!t-6A%(J$BStZ{`ZocOmCjN`>}gAs?w4qtC`QAT68yAstcgHF=5gw z0n(+U)438Qvf^7n$G!}JHGhYi%41k54m;a#2fp!D$J#U0bbb+cViX?nPV zua4{Y8ppPboVG;5Ix}a5Xx7ozxn5DNO0mxJ;OZR|Y(JQq zL+ZxJuA9v8;V**8yX(E=c_gv$k#jKS`_?6bzT~BN_x+;9nHJ_axyc_cP(i~u*`Uvg zY_0%~_3#gUDV_wuqbAOR*M#PhyX7S(g@kg+$s)r%{n3?z5dX1q(O>6sT9YH$H}sHIHS7eubC3SL?j`S`W^EbHK#vN*mmpQ>^^=Y0p-(-g=KfF}eB@ zO)02tIP+gSU+CYT(e^K3!u{Qu1T+Nd8g(X|#>G}%m#u0M23o94vxp##F#|O!6X-uQz zxGI6)iOJ>;&$69l-f4YEEsb6E`lYdpxyid2EDSlY!vD|z){D>!KTzbH0Vywdx6HKk zwQ{d9q$^pp23Lt8kt25nS82lsNA}t~-5aklKk`@n4EX_U#tmslGIn#UeIx)hK|5W4 zUavo8k;i5Bo?{D zdd^S0VSV9GWms!&c?({KwIOBcn-@&YEe&hWg+eSltRGI3;Z2P)s%dn8nv62$W$S*Y z)!a36-#Us5aQlCy)+1VXlZ9)TDjN!5PD$e)S*0)|xIO7mg8A15qDO2P@p-eph0z-K z^E-0AH#H1y5uB`)`7IBlk%dzdTEPFeK^HrPk8s4El`W`3wk{bu|8U_O$Yqx+# zzV7EMSxnMX)Z(_SSX)8$MDix(li`|<&R)5^&G}@RJ+Vt(eSxG6R%b~vc)t*4xy&gQ z)PAyg%BTjey@A=ZGica_Yu~`IbvoDERB&$II2e z(DhUyqIvwzYSbJu{Hs!(|6)2PRK*klK{1;3?3-(cdOge@jG37$S84=)oTR8xc*(u* zT8E+-&O4m>H!)Ri(4ctl_Zn)NPmHbk)agguUpOv&-5(0J(X2Z*TIIS!G)pGO#LOIf z9O@1F-Ku{{fPcZB=KC?+3r*S~b&5umyZUH@)GTKph)5(CUYM^4!s>N~V0FO5toe#Y zfb}#H8n0|{yZL5_aA1vp4$TdGr}{xFHu3Nb~l)JQ#L<`Rw68cJ-5)OS6ko=vuh zdrwNikCI58hc{}TGFa!<*9ko5Aoa2H1gXLhWz$1A4OjHY&6el$dlOr%^&h)<%@n-u zWyTVn6zJU}=)LNE2s?>cO&iTU`~tCQ56OXc?I9UFxu-@>X@*N=tK#*jxh+!l)`7@A zl^Qi)j2#u>hM}_A<*EDYqbV;Mv$sZ%eX(@*rtxO4Y_>46W!pSuLSSDcB^b*L{vwi6 zwYSN*E1I%3TCly;+y<_=9Q$-SEV^C!g;FL*B3`sOcG7~Q?68L{0lrR$FTwa`6ld*AIcEd{aI^;T&T=tNY^>d(pX6t7c{rnJA+C%=R zpY{5=T|b}X$+dc^L-MJF9ZRSGkBikS=dOs9YxZPN-}WH>gny2nXZ$7d0$T_JzQ$vX zs$-SaH;tg0tO>lVePRevlU2aW`ZEu$VASgpgWnxaOoeOBL-1O{zEMS3q%KaV0rmpB z%-qW@Q``zvEr()F|LIq2)$-SmmG*2cHvf|FA45>G#oPxOXv{W7Zi@ANTr}BEJDqK~ z0e3A0U~e_1IoH*j{v~{K-EA!R_#irK{fd@0d{+jWnN>p+zq|N=5cXbla9oHeKsU3d z>xi!tQD%M`2bfHnWOvT=}LsK6jX<>FQ+}D!Z4t?UleYf!6g#Qn` z5~F^~Q+_F{`YmbXYW>~tDt;!pmw9ogVX(RmPZCb%U)n=zK2^Jrx`G0Mlwbc0m+7C# zC-YIJ1E)JcVB?ojR9au6wwkPs!&zYXk0%YVQ`TifGnuX;!JP#zlDUUut%A>S=&i!OAX0u`wL?3-2tK@DH6tF zXnnRYh^aED^w~ST*`A~=`2mxm}wV-6?j8!-}7twboYh{|@wdlrUXT}-z# z3ic4(@Vo;zgtU*lAf%c88_uAiG>W?k&3c*g#PA(tKp|VqS4A4i=ggNI1;Ny`jQR%W za-1m4dgG@9pVP>uZ6~ZaamkN&nCs9Jhp0@h`R(RKMC_N4_x)9NO8ksug-?@se|^7g z$3APmhJ+Os{l5Qo!3yon_L6z+ZA_zQNUe4L30DD0{+yW-Afg%6Km>mI&abaFuZQ$V zEHw{cwPd~zCB^;L1B@(w^-g~Dj%(~>znBsnZB@f+M|#q~_k;ULYT;v6>?eHR4WS#kzgbfwk{Muh=hgI2%rd&71KbX^m4RFe6mQb2XW#L zN6F7GZBe3ZELCtJ*Aoy><1vQ0%CYuK`0u9yMvePfRSU!MpC&=3|0a1Q{GR|5NzYcf ze11yVb^cuhc1=~ab^aarguKb%tCSSQa(9mZvnw5cr5(EPK8B+IEb=*m?w0_PY{-o# zT=*cYo_iGds2bIqL=c*jt~=@M(5FOfkgD_s!f}#k4r?$N3Jmy=aOinzbU2^m9(Q(?2TMimsc|K*+p+k4dzC0>HP^@*w2mDWL-Q;)>7MKdryS^W6Dn2SZeN+ zkQ)VT1O?5aTsCO;@2uME<1UL@2ZHtxMUU(u9{_)Q$lLn)ihgd@&ka1G9pIJYz{~WH zyBv5`&B@JI#?!;T_q$WRbrRnr>$odp|4wK=pXkP`WuprNk!fp*6S!lK{9QS2TwhwS z#}0i+u;(w5B%~hU1)M=ZlsqG%+!42)*7HZmvGvCK0=K&8$lpcLPDB#}HY`L3vi~J~ z>+w00f|DKM$Uq64KpAYKi5B0OZesgRaStI#d+KMZe(t+h!$Ch^*UugL`4mr&l8(HOK;Q@jjzHiD1dc%9 z2n3Em;0OecK;Q@jjzHiD1dc%92n3Em;0Of%FF>G3?ivjnCYL+EXe7$=uq?rK)r&Bf8Pn=L?hR>-;k=K#9bknfxr<69D%?Q2poaHKL`PJw+JT+`lbLZo5>aXHGxo%EgPPUvuT61&b?Z&7M2Ge6n#)Nu>DP zp~dqT#}>`MI3Aljy)rg$(cD>c7AHMJhk4%f#ta);Ip^XIsyq^O1Oi7Oa0CKJAn;E> zz?bS%siTz|Od0vTm70kA@KdM2!Tv7FA4_W&?n~>U(uQ@(_hqE2jNxf2V^|tTmzXCH z_1&VbiattRi;I2c*3~yt^?f^2_1>MOdT#EnGGieXnA1z84nIn@P3y}_QCV-MHKmq2 zdHaND&!R5*_iUgKPLN8r(Q9klx7(I>ZFbWMJZg_qY8!6y=WZKi_TSCnC)(FO&PjXr z@k$N%(rfr-=`vb{pO&UhqnrTcq|V7~SC+49it2iUzdY6LjI?E4o>C{Cz=^9?WoNVt z_hqN4?8%ubdw4gMy(qInTJGzUq58zKR3GZ}OItcNZm32P6g9;`e24yLK#oUST3JfMQ-baQCOOY6Pc(o)+p zy>xBfgM+DxA6o|rT~!muzj|`^YqKpqrLTgI4#It$kLx!H)N3YRi>XM*#d&~$dYvV55-D)SkCg-6rA zeyOS-V^7AJw7o5z>h_GHJ-FRo-K3N6_2RrR-RF$<;R4@SK>6o%Q$=mc(LCV>>J&Qk zou!->@ZC2<^^FBp-#Oh?-^p33?{LQKt-WidebSz$BCZ~bD7D1rlOP=?-`~YmB*T!T z!B4wzJytphPwm1O$!J%$uSc5dK^uC|h8~NuYQ6fxW0X1r_ja;A=X(NSJG?L{bNH8a zx_05QvsBwMd>LI-hHsSa&x&HDzJt3??j+}Lu&fMXV^#ZbC*9kmt!SBc^EjQqRd{x) z$|gK8r=)#cPO8coUaV3(sKeJYMfLQJR!N!}n5hPWpMl_KAg~z-Yz8jsyEkWNGmgUJ zp%GlY*Cv5QEJL*o?~sq=WvRT)6I5PoyvmzXs`7>#D$iG}`s_V=XGo76XoR!)1+i4s zpRtq5ydrgr zQQU`K9eo3;?}wQxv^z^>!Jh+jLhaJ{y8Bi4H#7DID$~o;@}&p#u~$I#nv<=1O%AGF z!@H|qk2d$Me7aI!#jS!@$)D6K-z77Yn&X8D4ZNLAeMh&C3&V?d_fWky=cvH&-l}bR zzD&Q$^z~H!rj$yDgV7$3Uv|W6bz5mKJiHfp>NU)1Yg-=E5g&B=*+E{-8@j?9fFI@d zrQE*5n(1!sY^9#XRr);`FqdvlXL3zb?c#(t5$Eq9&S{f7ceuPc*;lvE0^g>&N-e#F zIozvH`10d554+`lJ84#w|iky9(=yTaClcy zn=*WXR82?7Iht!}++Cy8&v7|joBJ={1zftrlpmK&a&k3FJ8EJF=GNoR? z-Q%@S;IKKPUAR+57JM!f8tA5aEpqvs$PVzQj5gzA-EyT~#bsuAuwZT{UAu6puY+)h zHzCu)|60n8YgRBma5pE*orxRK&4UL#d-qYmq$f9h2K-k!Oho_xCytwP31$t3O6Fy23Bpt zJB1Zjflc@k@{N~Y_XRnTd84UqoNg;}Vh3@aOepZ*OL^lTW=)tZ6TVKKcHx4T4#GQ< zL)4GC@Q}s{5^aKG5?`Oa14XUvL=` zZeh>n_T~H%9OH(!2$Sy;Tz@Z2+PpbSr)w7u4BM9he$d4!VB4-v!4Gl%4&pR^7Io3< zfQt1>ZNXVy8-VY-e1{%K_v3|0S-ZRIIlo<;z>_w&E643i+wiusW0F=p{TuZs!vl9o)lfM|lr-Jt*Y~M(tW|s@tek#;cN>Ft6@Hr^*i~?ySnMTa_*$O?YMl(k++j4kX&myr5|}7fx!O_2zd4w>-+iiIFhBIxWLgq zW${a*Tl@OdRXq{^abLlmjytV~QoFL*PvU(PZYAz9zMm!T0{lP4{}iq#-(2pk_7c{B z-^PDCZ$Iz;yl3FX6Zco%h{h^|@IUbVd)~jnJxW*(-)G=I3wIIz2=Ds{pUL|{-g&&A zA^dgx%kY1M|6BMs;WzQG$1TBsEN%z>Z}UEm_#1d5imO}jpNUH)F2MV7!Y<`KjCTs} zU*Z$YAzUqP7p@VPKFFsA z;0kdD?gHFA+|{@$+}*f!xXrlNaQksR!ag++cN(r3HwkwcZUyc(+z)V1;dbL1a4Ca* zDvTS2y8yQscN6Xb+-BTf+{d_H$N1D>+z4D0cQI}m?k?OTxb3*TxP7=D$NJQ%xN*3- zxJ9@G?mM_&;CA5l;{Jw9&-JN3xS_bwxGA{BxZ7|)!|lSokINq7Q^Rn@xbtyW;Hq(V z;eLesC2k|`Io#{Gw{Y*^{)S6G&Zk1S!MKxgGDCL3!YP%X{!LTqDxkWm4Ao6#sw~xA z1y#1{p?a#L6q-_g^WkWfqxz`6s-Nnw2B?8*kP558>KJvb%2h+uaq4*X!%k2qs*}{o z>J&9poyxxKX=<1%P{Y;f>PzYjH9{4tGu23SmKvqLtj<O6J6nyM~P7piG$x|*RbQZrSBnx!sQv(+3mS6!km zRrAz*b(vbA7OKnD73xY=sjgCs)M6D=adox2M!6P8VqG+6;X?0o%&aSB&s{j{;)Qc3 z&%b=`obzX4Mdqe#j%pb?b5<<&|Jpkf*f^>?j6Yvsst85pXlSEmMZ?u{m?Y4YawPSU zq&UHfLrBZ9Uhj_A6YtJWW_PidQg8tQqEK8EP|9hJLc&qpk|K_v8mJ%wN=!KfRjNh^ zDk?>dp%F#U(*FK4Z+71vrV^^!ita|Azi@xTpfA}^=nH8x_l3ln`ch1)(HB3hsxK0)-Ip+>tS|jB&$F%S*$Lxi-3)`n z#*{~Ou;v__X-u`79gKO#Oq$8H4&>KKvn$KR{S{c8sd&aoMEku=ED?`oOOxV;{R&aXEsj8N z4i(>88}deHtPx|S(i{#S&wHNb7$*ne8cR^3t`)Zj?0B(mVtL2jkhjd^6C7T+An+#+ z#+*cI##B3DmRp~(onp;HRv{WM@2G_6tY!3l$Sz%pqG^1QBQjfAY?78!n)@K3a`J;{ z*{BDhR3<)DY)26CXTMh5E7XYQo$6rCb>UYYE{q|Yg=Sz_g)FH7_?{dr@lm!;(j z#`Ud~Qr+!vwawg&8s}cALK0_e25Du@aPsM>>t*6rHkQCM$Bn^8tOL>JE%6Ns^B`T&}AH8PYnyVow5H5$x88=dEbUmEC%2HV? zHBem3%tLUoEdP8hhRY^NqBX7!glk+IBwBfG$hx*uHF0qJ?^$K5H>f_i z@Xc7ePBts&Y8mCC8MQ{@mYcIPP87HP`8MYVSF?ni5R${qxY2mZiaB|?)ccWqcCZ-o zXT`6^_3RAalM2yvY(&)xbD1rMeUVRDeAAQfRUA2(Un5kotyDr~tu)8VWG!EX7gLGS z^z&n>e30PJtwi}Q!eJ0@hHFzOxJajRwwnqvmp)V_ohkP}PDL}*wlm}x^JAZl+XD4o z)JLE`0`(F2za9a(b0V*hE493Dlpp#vyDivX7SSBWLk|D@gx{PS`R%|f^5@lpSD0Ss z|FID`SgCnnl06gV{t4MfF$#7P7rq>9M~}lteL<CMw|N&WPifEW3V3)7d`<@qDSFvp!pxP6>dD1@kF;B z$Gv@UAbRY0rCtVe(UAo_w+HjlE_??#8ogu@a{(5ir{KSWLdKrH(6KY7k(bRgLY5mxeHiFo+EhSF__w(V~K_6Q9X|NnE-1IHR5-of- zn2Q$P0$S0g|6aWOp+{eM7;GhvFgJ_UI9m8va5Z`q4*mJUq0e4;x|6Jpv=bicV&2ih zd%zsDaLY34MGGGQc1!)sSsN>;pSbCh7a#q{V3N4->8CSB=yCYnm6Sz~t)h=-Fh@;j z_{|>H9@_M#i|;-3vkQ-`;dv5ygl`7x(870t4z%f67w`Iw-(h_b7rqN@Lr;8{Hk{3P zHaC>{#ZBM2_|LCAkM5C2_ztiLE&MYOk+M;xE&`j-WAGt;j5&GFBc(HE-qr`=GfE3#FREy{O1h9>`@M^Fb?ZT&KSfgmuLoHtF6J7d`$65GVa5P%@ zZg3!4_+g;Xrtew2(R)4GLtOY^e9I}c={Xj^bLdMp{mbHSUIsoOzwiin3oZNxm_iG` z4Yr|8f3fL77LW3c;6i-L!aQzKgW_3+TfrK%=@&Nr#^NoWQ{cGd5k4MFp@lC3+oYZg zl)3>NiT`&J{?qq(_KRL}A~yl{OFJAFIsp9n1wcdrlucN z{HlH6F7gQPcRinjXyJL_LbT~E6%XpZn-mY#d6o$u1a^~W0*?NK^OyJ-eA?KxNs|L2JJK2m3nStu7G$!g;$L;Cd7qr0=v-D@P4-k zeox_rU=jI+zYQYjK6uZa%stxlZ;FreEHFh}Slz?;qlLc&Hll^)|MMI{?}886LL1Pg z_fkBVtM27kcpims0<+Mjhtl_1-pAMy-vr+a`q07?pc`#^B*jB{1$cqD@C4Y37JeLz zqfLLK_#-!i`S=)x9|Nsu;YqNU{H6y{JdfW86XX$o8f-)h{{f7kh2I7VwD8AZIlAXT zc!KXs=rQ=2pR*p&kzXkF`-eC#{zB6yC_coOz((T2;zJxon|?&`B_@B#IYM0c25>T3 z_yKSvddb6Fm%t?2^zw<1P<($qc=1gCpXnVGuiyk|CXetgFikze?}43Y;Sa!ewCTxv z=8?efH$_>~+b90NOTo>=g`WjiqJ?*W9D4C%tOxJ`TD;Yd0(AiA7rY0wqWL>L>IN_i zy$OEz2|jnwd*Ne##dlJ48=M9gqFwm0Nv?#du?dp!@x$gc<@$(o#^_jJ_7X-sE@#Zas(Fl zm##bgNxt7$^1D$fcEJ$8Tg6N7E8F(kV35{FK6&+MK2h_bnp-vRT_5DzrTHn%cWb^* z^Cg-+&F5(D*1SOTp_=#C{GlDxzgzR`nzw7-s`*yUS7{#6oY35%`_-fQJk2@HmubFE z^SI{CnxE4AN6mXRe@@qbu;z&7HqEDM?$KO1-v2A_PtyHapn1OLFKT|DwIr`ynqSoX zu;$I0H)*~~^F^9n&1*HU(%hkWf#xGM&(XZU=4Qc*}riS=^y&j1Gvk;lxGJEdKVEv`&AZC2gfKSa7er zA!>P^!(FQ_5{tV9ezzm$Bm#SgHNriDCNX2IPrK@YhG@T)w4GAgEiI{xla#dOExw~q zz1f1H)``b*9CBsv+V<7Qx3&2`UA1o$Mi6Nre!85xyfG>kjhyAB)fFWjwbXlZeDRy$ zLd#>TyR{)2OJ|d~QsfUqez_qUZI6Z~pU_;xod$`!?z*^}>#|c+tGbAAB&0l-^q?Slj+$&LW8PSG;Ow@^`vAEDL%M-t)I=fkXAL71SPHs%b8OJ~P`;AdQdP`GO zN0QCGR<84WG5O(fZWmk1a^Gpl-O{u0qjqJyUfW5gtTX!8Tk)K_M78@~LchpTrCw`Z zlgd)XTHm+ws=QkkzME|BO<9(!RyGpq32bUh2L@!+3M*sTA%0VCAf?@RO@-gN z>b24_cQE6z$`2-%&8Mxf)X?uoQm%F6blv-MhZEx<)v(lV| zu6mzvPFHI4P%x|X{nVyzjJ|qoINteETW zl7$|=f3bNDr-SV5Gqh#t1+E^Fe$1HM*t8=QqMXSVGq+F z`7BZ~qVis9_TaPpqb7Ja?8mz)wM=#U^dZB%dGyfI?*?e&FlA(}BE+SRG5Qtj-Ni|CcJp7OGCf}_dUN%?+`nWH|L>j>i%?4{!w zh&sI3HyI7d&({e5XzUkZf8BBX%NqR(dvmN`TawiB@yoJXZ`dF0g&gNN>goUuoM|!& z;pmsn2A=KsXVMx{Wo)y|ag0`!*2aF#6LPB6U-c3AY>vRR_^)^_b?4MiUzg{#Z4K<1 Pg~k_;L-p5Zd<6apgZj`N literal 0 HcmV?d00001 diff --git a/external/pthreads-w32/dll/x86/pthreadGC2.dll b/external/pthreads-w32/dll/x86/pthreadGC2.dll new file mode 100644 index 0000000000000000000000000000000000000000..67b9289dfd9f6f1ad12c1d137f4e57ad1a54271c GIT binary patch literal 119888 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

PI35m#66 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 literal 0 HcmV?d00001 diff --git a/external/pthreads-w32/dll/x86/pthreadGCE2.dll b/external/pthreads-w32/dll/x86/pthreadGCE2.dll new file mode 100644 index 0000000000000000000000000000000000000000..9e18ea24b8b99b7de0998b4f2f2cebce93583edb GIT binary patch literal 121953 zcmeFa3wTu3)i*v#28bkPf{qw9>ZoH45;4(OlNvRUfKj6kmjFssP(V-wgc(5vgw8}f zJ>>1wVymqe@Jd^(XsN|}BuJ#yiqt9&biMEDNi%283i_^^;+qqi>6<>&*Ko;b-}SR5PZ@IX!TtRj zbYQs4)s%CX>!-hY=@Qq(9M|uG$aYuX;|g+e2fEgyP;rjSmFseiFXlV`-;V!XD`v_& z(up@p$dfs)IwbaWxxU?zEB$i0e5xKRus;6eQIX>s>%ot@9M{%-JZI;)`~;Tyw>ZZY zA%VL4o0#J&$&z>bP{1Q%-TVy+PMIG>UTr)6Awujc@J{`k=&G1FWb&loBqUZaV>|vw z_gt^w|CGNvS4I1fIjW$W`MdBx`|{hALU={Fx>KuE+S+6J1cE+1e$V&hAIlB7YVKU7 zwDTWd_Kqxe)wK_qqS_T&f~L}!PgyDXC-A1Lazg7mlKmmN14Au!z;;BuIdaa*Fhdzqsx_MDfjJ4DL0(s){cB1 zp1v&Q&OBYpZ6PmhM?QJGE=#%UGo@UgK6vaxKFc>|DOaQV5fB+bXGoWeGs{(gE|sSd zU_1XQMmhF-RAxEQrSddE@Ylr4heG6oG1R{Xn7ihkd54*Kt?j|T$2Y5NNxU&;c>UI4&$(QkeOQNWce?$2 zSpAS1-r$|EsUr%w>79kG+d@Y; z&3hsdz%hpJuqMajadY^NwkdliTyf>5^@Xms8`;caHnZwkm+L{nw>@}uCsOc}NUvPC zYsE|;>}4yR4SvyuXequK%~-piLe(>#26&xIW+EPEXgu13wR4C(>WZ1MN24Md z=-AOqcJ6@4n)mqk;DNf{99NF3E$H_eL5zK=-)dGcIwSs9LDl`M&`X_DuW~Bemuw)6 z30HJPO*9T9yrv8P4qQ_GX}o=d=gxM|Q|%qmbsWWxsflMZxNgbLdyt6M*Wl5*%@a8a zh1weYzNa~>7@fv@e}5P)FUF555;EdnhFAXK^>+2fSMnnN+Sd9P<6-Px$Kp$iDJI4o zcX)l_i{OR0@yagG6W;-92XUlKa9E&iwZN&2@AAB~(A66EL>>YFb9AA3UGdWs@mkq# zy#M!~8>0({8`l+g)|d1{T4z1T1ai7CG~gajWIuixhvlATTv*>_XOnnvKB-C`Zx)*MT6~ znU(E$%d;;*DZ(YXsB4Vzms&FfZoY~4*yG?O<7hWJZNnyw_lA?yFV%Q;5`wWA2%H1d z4mN82)j)kWZj%pK$U;ajy-2o$16dB!lWF`}@uu2_;sR~UhOm0WDpS5&rB8D7z`jucg|4lhqO8;ebp z-2@OLRh0{h&HS376~R+#hE@eD%to(?CL~|Abb;4wbk__m43-)|(f%RS8R;~#0_8)S zjgeKc-^uSn$qpi$GD&#|@0?*Oc1KouYr7{h43cH6he*^Rr3_t`X}0aMQpjjSTa&-h zX!84z-GuDYXdL-a+I1+`#D3!0sGkjdwvF-EEj^S{fvR=J1(b{|+;{^}8dVtw`}x2I z)s%`K!TK=p8n{60LRyU4Z!I* zeh+O3jyF{iW!lQ-EO+?jd}D^6IJ6K4Jjd&&n6H&vjLoRz2OnPKGF~Rl-(p4dkiww) z7sM!J@81ZbAqpOI)}{Pm9}7vqc%q>m<*@0{@n_3&yLg+sM~BV@N?u^t*_$o@P-+pG|clTx8=sLDs!CMyuc0S zsWo$<3?Z2%)&r8xB-$xdvB;Zp8PVX09;ID8m3Q=bN_$BblV29U0 z!0ebEF1;G#540`tkE#3wojKL8T0ikb=m2F_@kHJP?!eC4{wor8BYsVdY9b6#^}fRi zBdbbXjXL9inQDq!_;59tZ)a&r%?LN4$|!Js721rC@z+9}s_g(;MOv9?N<2N0S`I~% zzZ4(`P_2IqfTA$_+I`j7qdXbvHk7Fw!)5l{5%b)eyhgGd`6KOx z04VcYkGf$$>>=ugPQy|ILaW6SIYs04-^gyZCmj%O)@ltaL(hDlu)uD2B0FFo_qoGA zDSSR0iK+bNK^4t!p0x7cQT+40FB1Io9hozdaxn&3ihmOGI&D7kc?_&eg#%`dV=$qT zO00a9hsI0nqtMMnKA30cmsyMK>=; zhe)$Y$Og@TFc9krkO;(J4Xg{Z1;0gM@CvYpQn5u7eWg;qeQ9bsN`LxG={+lM!)w64 zF0}wEzNQP{^%*H}GYUYTS+gI-3^f=3U>qu8kJH-lTQ8stbW=`lrGup*6+QQ=@32 zgyvf7wqO$`$x_s`mOmzDT4QIOGF$7E)mo?MsO&RXZ{RgoXPv}hI$iW5j6A|EnIQhl zK;+5~_!F$C-&5Kv5|21v`5?jm>k>7T8_GU@z8XzPv_wM|n-2m<@2yCD7^i+;sow$1 zDc`IsG;%>em4f*QyxUWq@aH)<_EUwUutiZ*)k(B*q{dOVVFug)nQs(lw9##O;A;fj z0yh<>Zp#Pq{{{GPT7Y*deA8tHN)nKyPoP^Ue_aK}17#b72dUy}UUHkxZ~{_zXDLOR zBkx%6cm4vhwH`j$rFjRy}#OQkjE6?-CxCAglYERs$z z4*lX@h{YCMnBBnp-Ou16BPP`!RmQ_A&HdFtV{3RrtysFf&#}umE` zvI(kpBF1wvBP+*2p>k3_!kNSwFf5>?G^uz(+l6!o=v7mIiF(?Yqw{`a_fi)8%KUu~Ny1YBd3*a+OMLdI|?Zf_$k1drwH<#6$`>%m3pMU>Hk_i2M~v zXd$-U=z!->XT^FO0E|+PCif=ZcVt30{KABM4Q>^J^;;QAnf zD#{<<1z9|m>fm0$r##+(tg#7PTPb;!pH#-}X?TemR38IsI)YKK9rXj_D@EE)z5*pc z>jU8dw{BmF0ePSR5_$$j;4{d==-6uTS|0`&$>#R^V8|p_0LeE|i1ze_isw@7=~8Q* z$^#8cW4{DGj;?Q!xJb|Ad%!yWEHt8Yyc0|f&ikf;R9L+!fm9B8iym?bp$2DWAMW-C zp)j4H?w#J&T_~?~zY`nvL~du((ESnQ1?+lIF-7-3n4OEb=&E(ehOv%AT}Lak)l&{%ys_*GPcwX_W0ECMWuIDUW(rT#xh&ct;}8n;G##ndfh(-*Wt8+wydNip=0Ckb*Q@`kR;Fkm-J4dLQBFivI9UVHq z30ROlM);`(1|!SZl~g4Mz+crGz{@g$h%RAFjJo7RWCarRYi)-ZLznEe-=sV{x&$i< z_}N9D^s_fI`M~ta+7+r3>H1_L^~p+P1w@}<4wwkU93#9K8OBDaou*{0yz&!!E^$lI zJ#@*_bkBIyqwYBhylIXoG{+WWQlcwq-2unHvb}PP{X$wDJy-fvJ?bUw= zgJq1)56{of3C`-QcjVQ1=1Wz8m#1ckX#h`#sP_VkYq2DBYW#C+lDwcU4aIP=WXc~A?I4Hl^o&_x3Q&w zrTq++b$Wj(A<=g_Dy`?KE|m6@L21XQ>cNNlZ%lmuS9~biB(z=7744&iKhMqPb7_CK zYkBdB>fGYgCH+;$w&_~F8=sC5^M%Hj2H37J%G z!pz>kG4v4{h}s1hWQ?hOx_SzJb@?6YIbJ;x51>D-;x$DWnr!i!ukRs;s(20b6&TWq z*F5dR&&u{^nA$czr*(HQ*Vy{T2j_=&t1^O>)7Qfqp<$0(pK2#&@oVj$YJU4Sef66F z=l>d?VU$#i=a}^P3)VK^%(d^^9Nu1$h#@%i=^-`*PMznBcPG}1*frKq;kh1SO2z+1 zOv#(ct39;iO>0N%TeYBC2EAJj#VTqGng@vc5e0BtAN(yIhx^q({B`cUgHu&p6fXSV zI{UJ(=IBP_aIFQWM!|_7V{z`hgVuSF8QxIXVLfy=6*I$d>%i>s*k47L>2m$oeTFoa zi(0p&7i6MiuLcpDSl}OTw)k6UFFlVsH605FJWHslzCSbPOXjT~w$&Gf_ZN7UZa^9I zt`zf7yln)RW_|csj#MU7iSy~_6M+h!@mJYCP+?r#jXTo>Gy@RDGTA#I0q-TK3#!So zuQ@_Cn9M{e%#2{RD~&4}E4NVrXSy*zVUrnaSe{5Z@HF7s?YIlhN3wI#w)(HwpWBw9 z7S>Tq?NiyI8(l(#*!>4!gO*r#0Vd}&wVpy7Sk_ZGchWvsg6x1T%SZ5m>5&hpdD#>B z2}lQ9kUq}g(1R)l($^lU+6VDU$@cdBEOsC^N{Lmh@kqu%U@NH@$X7pxx0n_K(J}s= z$N)t_$ddH^2{5iUt30uV(|FsDfKz%zxGmtVq;!E_l!RJw$%r z`g=3a9B2d(myNxG{$=nax~~MMih{%NncMo=P7EQe5{OPb_r^mq*c31zKgG{7+>$cB zsNG^#J8i#%o4@$^LIv)LpgpP`-gi%~Ga z#gC&5ex$h3Uh4*Fimd02-G3msRcPGE-(HFFk-rP*2OLe@Vy%fLkaP%>0GdCk}>KKj3M3jqbQEH|CZS{kg$G8P&7e; zwEnGH{FKldkhUKEp|m!?yVl_I($3HVIKZh|+97j^H4W8M(3g3FI|T#Xq*rH2PnXv* z5cx?~JIXO&3C8B?R~Z?cxUWIFvZgM2mUa`#Oz8%K{ApQtpgS+4r&F<4a?x~Syt|Wb zvC9}zxh*NmQ==IYA2ksHSLzyj($VO1or%0DHjT6@F=8OC+|TD_~>|Gr)Fh)mg0TCQO&Nk4VT{iXm_$^Xk+Ja zR~}mf02?6fYE)6QQt{(4{>iAz4V3?(IMJa%FC$KL9n|x|=txP;XsiW{04dQNJs#JK z#7)%83>^q+cByR~tC5kZUsUk#Nz7w`);PAa0tmEkv$5Zaa`!$jSqo4*GdA=p+9H9b zA+K3xon(y0te1(tS*qpJZbCmuZR^OlLFYu%$yhQyyOem6iWLrb*+Y;naC^~t#n#rS z!jbcLvFMc|`o3QgP3XOskR6Dvg6!PVkP|vBK}(uRcA8=nUMjZk5_nu!D7L-CuHJ_U ztO6BlQH6t1t)EqVf(r2A>`+6ep5p;cn z7BCrZjC2J`SLxEm=ZpdT7s`d#r*E6|MAjmevby2>=q!S? zK@DRr)|z(0`#?Zp&kUV^=p zp2(%(3hYtit|gvfXge>zM}u9NHl=FEFU7uFhP)H#1R#BCCGr?9jV*$XK}rS2k!rHU zyb@d8^)|q~a68TUZbbo0VqAc(=yv7vM7CG?3AzpgMD45Mo;6bDCx4XvG8KsPRf(ZB zSnX-MgB{NB2b5;px(vWbMG1>@`<$+FdX_4l2%`!Vk(H=6QuV6!WTct>nEHhPQ#6K3 z?v=(29U)L>{8sn4yWOLw6K*<%9|C%!#M7er*x#20ZPn9H5#_mWB?1=i6T)~}HrurI}^tGQ3B;nm}qT5u*frYY^d4| zDcA3~p8qZ4SShf$*OSbOhnQ(6s0Jl6o|;~u(qk{DChonR6v&qiqlvZIl`V+Yp^-x< z&TFtGud@$RC=Dyer)1qJSxjLTzNplg+*QuXMyPMhi}kau zCQd~Fx$iFp`d{RPKJBUnf^)L#x}B&py0gzjjkUA7*IRtUdX7ycc!mDfe2&3mNFHZj zuH?Y6#e(-I`I4I<(2G3#dNoeH40x$ES~rxwkaq%=Rvog&#vV@{z%!(DzCBw(S6qOi zN2~PMEAW3-va>+AP@IFX+QXzs04d|ZIhu~cY@M^8ak=1;PPJ349S|q^<_ZSl$k?@H1F_}`OjI`?{A>7NBAlC=**)!Y_mOs<2mrgxgQfGEf7WddIgNjOEQbGyzi5;5M0cQ9c>i`Q?#{LUBU>%$4ssnz8 zz_!I-pWYchvz$sPxz?vc_Y!_$xrg!PW&xHa41hlz_f? zA7xbe!BnNzB>Wg@;w`NA*+Q20r1M6oSnCkA9S;2!J|Ux+lX02v#3 z_7iqii}&Lt7&5cI7U+(B0f@(AN24#{cDM1_(tHzVy3nEZC^Jr#In69Khn1Mu78;io znvFb_)z_S#Z`_oRf8n0x8J85EHM}r=_m(y69vpr&Yt zt)ghG6^(Hs=E;Cw=b{QJOn;JlisTI5Ez}@BqzCL6Kwyq!_e9F_U3QH6Qgo z5XTh;NU7DaSTj8g5OuJQliy%Yeru2wNZ~~>|4OZuQiJASsXYaaQw5R6tkSCTV(pxl zCPQnm^R+iI&WB0HIvH;gvojA9<+%m>#B*Fg0F&0#XoA-Uqb!i<8=l{g6FlFUsQOrE zLH#<4yOYf>*K@{uw+eYtCpW%1ssD+83VbtA%n{Uk44!;B>qu==pkju^5KXx1*l8B5 zo_mP(2DH3IPac6p99TyF{@mc;@cz7Dk#2;^;4|w{lvIVH*6Wx&o%hZU67P-=i@la- z9nE>!6M2lG*cNDW?xpZVco?1z<&#LJFifSJd!d_d?gYLf!p7<461=w|m;}w-t^B3> zxo7kk!hdWLNG3aOo!waK{Eu4t>einH|5a!Sujp37M+$6s%g*wECj#r=WzMXCJ9KQ# zKG@snFK%{nZDg?4eYOHkSgHQcihQ~{N4NB4~ihEny>&C#hxH|w3F zo5r+!G?Hfw$M&2G%$>ggsOSr*3x)1@iM`1soqTIK+T|Rf*1!_mP6rc>Lcg^T*#UbH zm;`(PoO?0{tws$idDhkwS&uGL)~f_itH^rgUT8lR;NtdFCzQ#(LD|*cUlsrh(U@sl zsDd|UFTM`NM}oy#ccD4pP1ZtZ-D(c`Epnl{xFdaU_~U{UdeJOd{7+>OUBIE5%?L>A zC6L}|<=$jL2oe2d@#}&=26xd{=Gn5~LNT8E*^@!ARGmgC15eRc=9(dnKj00q&V!NO z3sq&5KD{M%l;~A?$SlusyfI2|BRdfL`GG)ss0$=@J_~VM0ksVI&9eA3HTnWa+YW$; zDf5@{y}>`(tgt`BmZ$_+UG4Cc zYBVM@^Y`5>LkCV!i=G%;S>LQkXxf*=phXm2RAYEU1&w1X_O_bqJrOJnxfVB$$?2?< zfGdbwZXJhKjr#G{(|~StT1WEdM(Y>&h4xD*Q+Rsu;FIA&SKEd8hyfMKDnsS{K6SOmBj&|@=@H_k3Yvs0titzc*4C5%_;zPDv(ku1Do3_Puf z32v#)Ou{zU#4$e&KdQ%MdA6KmH=|0?T}- z4pY8oX$P^aZCwQmBpe^?iCl+lQuui^Z2t=X^h!6-p~PyKm#L|+f7=sT2k6vPryzT@ z6MwMIg4i;k@Y1#}0C)M^*X)C%sUo&sXV_k4nK$SrsfEZ0k{EBlhvEr?yK1kbNkAI_DL@ zX90Lm-!i!k-xvNo9=t+qx~Cy?9Q6LQ^$w@4H>5Fm>a0R;H>P5;xR&`DR2ykZXRmy1B>)#7g>u@Ny&f0UzyKN&n7VYIzUR!?ZF39 ze3it!&IM;sq$g{MTEiNsTcY))oE6OL!C{n?JT?~lWrF#%v$AKd!|$aM4q-k9PeLlb z?Hm;Q&*)>Kn(%C?^}MdeqYo?fo}eK17t2&~0`zA%?piR|)A|NLEj^3#3ikTSii7Op zof@qV?oQn*6tyra-7tLXtK#h}-1oLp#_5a)*pX)e`w~y&Lp($=nsW*}hY7J9Z#9sQ zYesnC2=6Sppzy2_wd!(&%J!vs&?g2@oJGxgaeOz;K~R9a(H`DDP>!oX_N7soQlY2c zhEhfBK#>4}I}nfzFpm&0Jhu_G_F$yIB4Ps-a)|R}3Tx#$%IVWu zLqk||7Eodr9Y%>Qb@uT(Pwt_W{&qmuLq1_Y*d=Jf*}DQd?c0jU0~huHD!eP%|F9RT z4K|67ds=Lp`p@y zHskYk347#}Zr!sd(KKDZs^nqIYs2S!Iq%YEsotQE%emT_dXS2fRCYBo6|hEfCrV=d zExffGf9v`?btBd-~#dTtvD?ue}-^&2@= zawl{xeQ54M#MzGoLP>q(i8P}Qs8p?e4RuDZuYCfO;R^-a*zE0zTmT3c;J~yHLk{ux zinC~}$+HyRT;EBCSI%avWF)f2#i9ZyWsWYj>ZFbeu#^G~12L2c;;)t4>{UQR=3^vF zz{RV|rk&4%&5Kp{V@xbl!?^t-9vl@uD=&Dousp}_i9;KMC%hA)xc~|pB=@my2I*7Q zeQ;j^I7YAg2%%teasNgyEels%tXofV1y}tf=yn#e#>O51lr)|wml}#E=m912!AQj_ zFV+rx84KoJS7l&*oI?to*Sc-~1QsSWoZ!ioGtg5W*g4-QX+!8FWlmh9CZlTFdc`RA zY$@u+`bK3#n>COXOV*)%#I$(zmD;No`&jQadoRsaK&e|D*k~GnT$Wq+d;~W)7XeA1 zQNe|J0wbrbf}a9@@9yJU+0TWeZR|(g zFb|&`Uxu1Fn^_~S#oezcKLF(s?;FDo-i$QRdyGKhmR`T-Mcit2H_G`?jvLVYH7M`- z{1_I7X5T zEG9c}g6{~7&~q;|odm>TJu4XSUR3Nz{Y2dcJ--FmL;P;i&qhAs#Wmm{abkY!{!rqU z>6lBQ=$o8_#LDM4hr>>W&Uvv9I!J%}$$or+zx|TDNYslabOY)(%JipigxUlGWuN}8 zK~rKy|2LQl{Gr*RjaCC_#GPzdiop0#rvfy#o4k|*dqv%KWR3q6Ou_AO*dZ3)3!m~) zcN!zT3#j6arf|~+AcL-?_^VK~+EuM4BUOp3O6D4bpW&}zyw(%DW*3b!#24vp<6 zfK3_x1fAMwyqy+%@kFM9k8m|)K4L=|F73>hD3G4k@1={)IACvlW$Y6rqy&eXR?N8~ zIM<=Ebt!_gZ_qap8_zXe#ikx<0&(9A*`MEo=zmhZw<*xbK5vU1( zs|2d`ao8&2)V@l6mZpUvE}d;y6|vY9YiB<-XTd2Zaqig zlEMNDNoZ;ta8zob6dGsulmwwiAPX}I#SQj)Zs-oQr+lJcqtIxfy?qJ_Nqlh>*gKli z2JgTyFZ6N&#*H$H&DM&3-Zuop%6;JF=7?UkGvXg!>!HcQYGu&8<&K8linQKYtsF|) z4;J$-D7^K2^rox^j_KTU!DeMz^b%|a!tMb~&1Q|5T2U{dY+7GMFXT!$j4S4~SDzOp zZ7HF89W>Sy9mtJ9DLQ;b66PL+|6{MR{$BeDfQwo`wMBVROlnn(Z$B+gjttjofTj<$ zq9Id@A{jD&Gf?2%9sWAU)B00jAhE2y_T6YE(@w^IIE4p5dF=uecKD8Sx79&)V>bZx zsM3{cq^JOwfj7JIS)GLS-eg`w(ha`N%5g$vFAA6I~n%WfR3 z`M3g8NGczfCwsIQj_$-8__vQml!3|-&E-plCI;- zX@eF7PtGYeZ>nu|hAQ~&j36S~D@6MVVoSWpYqfz45HohiE{7Z>!;Gk~ZLf1Sq89zc zdIT)li^OL935Vjk{P0(>8SlezdRiAlMiMq-@P-#eB$YWe*=bbktRqyLkeBzK7iZ22 z>wqNq#9_*eIC@IgaMh_Bt*6IGqg)Aaz@WWvwAL}R+Y2GaPNbv9i=3Qg<xz4yU$(gr^ru?xs0I!)+@v#c*3ADLF@c68=cVKGRk~5nKnQvm0)| zyb^F>_p~xnfpro!G;LGx3p6!vDG7IC3p=Kdeqyb~F?`m~cYxbuQ6u~h*pXoX7rn=F zO7G1^btru~SOVRbuJa@s{@r!ddsNPz*1iCMc}XulJda;W=mG6yr58L)uRvGLa%IuM zO5+}Y@K>d+GOq~dKAcS~7BxfHRG#3IUif=C~HJ4f}?diz5PP=>7*@}=7kpV(WV z37;c*$HQVK*G+cLU#>J$Co2JU^7fb8Fl7ViB*?ajZ#;w5)VXYW%B#Pz7B}6sIvrf zFequfY#)yjxT}CvRWmjNSq@00B80bgw`j5|_Id-_$zkBu56~^GO@4)9W7TMWjv@)T z!85YJye}Q*!c>^UfLHA2pjikntP6t5J^anj3EtPTJBmY&bJsczUWy9fC?GQ1@A{fqJ#f1 zxda*<$guIz3FlU=B=IwxXQH#Wxp1oV3jhaJdrPQ?VouS82GmUBkw<(zWx zPfyD^GqUTm_b#J8!*b3UpdprX@)e8psCS=49i?{@t2q_axep+Hls$ukL4}OHXTgUV zT?R98kH#R8KkU(%quNM|Ud#rfNU=bJpERFCaJ=eCXIVx1t+ z1S5fgP#7wup+n81Q1Ec`7}DX>kC1b@ERdH=)PsqCLSod~Hy%n&E-QGESjM&`+gpJ4 zaQC{&ov!m*_b!^tfGhUJ81PWG!=PZyDs;7ZE|+_j0dwZ-`1Sn z28`%MyvkL~~H$?g@us9JoM6 z%|(aA^DwXZR6+YQ%#2a=TWvs7hyT#2lmNMc&zMWte;M$r6x@R{548Km& zqSg;O^T+@!zZTmcojCAh6q1u#zadlYFAjdp=3GzRL9ZdfPwn`8pPneMrG>*ZrOWj_O7do(w#| z`!`E06V;N2PGTdZW9S446??bYft3MZVbo)@7Z#_-ml#L$_sTK&hg7}~B`}}+F!8Bt z8rA;B;G`~7+AJ!|0stO|rIuenor4cDma(EQa%#as*)n9mSf<_=-0m z#?{^(uQ?cVcv1MPcyP{=g#t1-pooE@{kkZjy@P}XZMb-m~8*NBq?Ue%|Vw?%sxieNP8-< zLBHL2=$*Nx)|*mEEK}R3^MRl24_ZYQ-DtO=eQW=j^QzZ-;}R;I~{w*B<$;78Nu3?QzX-Wdzz2ztyGk8)P~`P_W)5Fbb3+TMTe# zbFnd$7a#5=F;930gF5E`+3P14Wn-`DWUr;j3fS{B`{0pauaHzy>{W?$bGUaTc zV<#i@T809RnuE>Z?waAQx#wVN%G{fAMHeOXO9PX`_$H7i6Ld58JBi%hO*0be*o3PU zJQs+HRm4y2K~|}6%HGFZi+wWAeC>(wF6ETH7#GO+=gHZ3#QwBB(SloV*2ARXDpoM_ zCJ?1?U$_wJk(_WMUThkwXuc;t6@;TGOkPbtzE?#PbRn|TAy3dw@U4WOd@pq)4|Bc5 z{Rlo;L_SnLG?*Av)IDFo=Er{13l3JXZeN`b!P}z z$s;Lq=7{d~6A82$8;sSQnO!e!eT(_ASAhG!ua`~&%H8OtmVZqz{qcOvtO>nzECw2S zsekX|Z9RmFnR;m*g%bpiBCkiibbf|jqQL+CFPf0YcF_gP|ERLCM-cK(s(%+L_6-N9 zp#IsIO+gKp`43qEd#37d`ur!Al!D^sY%(Mzh^Vd-!L;wpqI~Yv)i~?j*X^9w3r|@e zYf^liou?viGXFosQ-3%QqMm)O`xkj?2_Potx?@4S1LUayDt5^cPb&Y+jMYurR zhLg-9Y>OXdo_?`$Iz?sN78s3t=bw}eAL!V}Rl~u}Dz4->KgwPgInXhS*H8%Y9;_(7 zL}2{^%o>EW)Nsh74xcZ;{z`=DmOvGm2z`1YVk~`*r2dF0Qv>$sna{uq_+OKrdG~jP z`hdVlOmiuh4qb`{%ro0Y6k~2I;oQm#z-cQpC}z!TKyC@o;2nvdZ6mx4GhjzTO<&LV z&qYdSKZ-W2BdK~Ewi(d?Zw1WCZEYiD8(g7Iyhrs!{C8B4aN-`$0f_B+BG)3f<_vnp zIG2hU*Bo17;&RkLNzEDb?LCo6l8ClTj6f-!xefIwMT;Sr{xODkiD=d{+{dFcIFk`N z-fZ!+PmzaFl<&zK?l6vt?a(SLAJv^EY5uth=t>~xpCFRc>-repvmi1TUFw3!BZPA| zP!Gg@iZwY+I2S;WaN~gx?q=20c?;)OI4ZJn)h<@L)K}hyUBcR;KVs5B%mWb*=^RlD4u~kw`vjhO~?v3@g&ZF z7&>jhd#$xnkGjljAF9T*r*>c;dac>It>j)Ob!K!WiB$-DSQ^X$G}yF>dvec2FOojA zC-TE2d3dS{bcHlMD3Pci!7-KJr4Lfv?4PRN4y@oYsc@Dj;e4XtqzwB#s2Npi0YNh! zJxvfm?`-&0ooGggjMqN*00}Tl>ZD$3#5)D%QM0xnDX$!}!^G=hK*MbBbC&Ul`6JYLyB4-oh!YOuW%&lA^kO#9(&l)@#4R$?;bI{?uqa-hT(SV z-R^xUtP|*)-734i{pdopl)e?h6X|q;mya^@5W=TkVPqK$=QBooJL`SO!)^}7=I{_< zZM)DbH$(KV*%-=?4Zyn7&qco>x)S_5z72o_Gzb;lIJ*(Zx*2SSya&ZZkX3QGA$fIY z)w@Ft*ag&fowx0llGJUjze7V^6rlu@qUT_f9ClzAz5qUm$NFUYhLw9`_w_QW))>H0 za+uuJ5kZR-#5&{!l5~)-S%|7m+rJTZhNSgFGb|LOZ7G0Fj$|;5ykYsGPX_=ew^qeioUHAUrDTy zfx7|cDjE^N791V%M1D+mxW!B7wpwCOFf-4C)r4XfN`zryol&2EfpI8HY|bb*Nn!a)?8_T$PCAC`HqHO|5JVQO5cijEato=x2Q02 zQG$~N8?zn(;Ls_0m1`J+MAE1Cu~Pzl<(Br-2>&Bo^%Cv}@2|t96(O9BccWSN z*%;AtgQMBQ8$+cGuUhTD9ElUiLMa8Z0TMNw*-kK4Gp8t9k zNi1|Tm+(7Te>UGbu*k>L)}fWO3x9@p2qnWURDHIgUNN~8d;1>kUzCnnd6KsC_dZ?+8#R!4#e(E=o76p!%|Br&5O|z2kqGna5;C=xELW57^^>uG#OIx!UXGX`Nhfa zcPu8T>V=})c1uB2StesofZyfY%Y2)0CIWW?+A-WvFpfkhJG&X}Tj#KG?nTnE`BD={ zD=^yAMG;&rO71>TMho9)31k7Oi_Bh zqW}d5Sg~)5qRYn^CA5oPYfIO4hu|9)076}drl{>+)`DhSr(26fvG+)HU4?dG?P+M- zS}JW2mrL}xF&=kOzsb2vv#vyy!Ktln!4EN!cR4`16qsd-j%xKpwAzfT zAJrFC3Y>$ay{@-fd(O~Io4jkZ4Xu#l{u^0=RNPw|&{s(2Bs`qha`1bQ{c6|<+|%TI zk8eB*pntu{tO!leXg>*8G8dBgf2GQ-u+F-JL^uA(q(7jyW}p$s@M{p%lh*hu5J3F)r$~xvZi8Ro zoo}4S9jOb9^9s2;qJy9=&c}DSjQR$CiVFash6!>Rvb5>hSziGV*pe_FW9tRNyik!J zU?{|Ue%()TNd!I|>1^`wuwif>#D;Lb1RP8ghd9|)KfzZja7p;WbAU&c0d2V#6?jwe zY@8M~@Ws6Fh8Edk1-*%TULa-GmzaF?r=?XE$HlqB_ihF6)-`}v9d1|Oy4Vc_fgCrC z$J^?8Epr`yHnAIcB91A~20n3(ZyowwAuF_1IF?b@?S;^h)73Q5m^@9!c?h`kSc9`C z>k*WKA_52WLr%3Zx)EYf2M%jc)r{RF{W?_4T%YhnEJ_k+awK2`?04`Bi{JzBh=RoB z*6G;ZWY*Educm0(6OaR1RBp0IvW!r`!d(#f=F3A0G2T*LYcm$oJ1<+SPg8P~SYz-+ zeg!aw7x55ejj|6>GJ$p~z~q$}#|lrRionPCn;<`@VWiJeeuaIkD(j44^?dXUN^4Ce zwl)_4s_jKRk?q=C{^ZtPj7={yRJqkpBS}YF)>lMr4KWH~X8?A(1HtV}=sd_q$?E@JnWf0q$=kTK&MK@dR*kcy(Ec|n-Pn`f`;cJ&GiuRp;gFPw zQpHSySSecIuv|`b65j~IiWv5h;%@8-7>5-5Md{ss2Y8PfhNQ&$^3>FJsdtMYb+X6C zMpnAs)q8BVN*%Sw=E^RdP-3l1=Et6bD26|G2ft-qfdO?i&Q*8^5h11H@dl31jlX3z zKNqU(x2+5KvL8-)u%7#i2a&!5k=9wyH5c5Ai1+aC%Wb&P@Wkmqk4Ma6l}>^Z@vGm^cstGjn|Qmn!{kCm7%0=#R}rxdKP)WQQJ`H z_e82!>lMhg3M9*U&blU0<4g&qP$D>h4r&luYFW82yvE$wY?phJL`T zg-d9+8qI7&`KtMjn>;uuu}`9P$Wowa}?Zz+0TDVZ{~iuqEy39*u=C>?q) z`ZmUy-P&~>D9SigMPlzq??-Zej5fttkF{8k1L=PK*Nlhv4| zZ&r}|#y2BttbCg!fib|ZmkRl@<*A8}>BLu3{C*7b7?>j5$J+DF@I3qQdGcG|-Csd- zDq6`n05JjlelS`pt+^22_}Pozy+G#>DVZBav0oP%nH;9viMKGPajCXBF`@Ari$J_5 z@>#1;E0f(Vv_W=Xj=WL!l^AfWTRi$pDmise6Lc$Qlu}TJRsyww_273^{_luB?SLd2 zNxr+B%#%D%p}v!c^A!B_2JR`s7h%AQdu20K@3_mHXmM6a%*C7&x$ks}fqD3k$O`Z~ zdE%SekAdg$PJv0HCVN8BxVD^1tW^S!u6>EkFAY0ur#J%xxTna#*z&nQp{{5yvl@c zd@E+3ajAw{sIeEGl5q)e(n^dA{%wp9>Mp`D0M001)8PtN*!uYUy@gN z+qJnUpL*{zL0YRgCX}dhYUXVH0*XGJCJAN%r=YXesueTihw<)xaIkca6}s?cb|xkvAywVZ=}tOtl^I)*6p|)nIgBR%Usac{sR!_e32-}ZKNsZ71bWuzT&qX z2-6$|EXXvB#+4*K3MlIa`N$d>kHFJX|1S(}ge6p#7!chm;r;Jx^6 zGLMN$sO;9PnsEY9O50}SiQEHr58u+16TFPp9~kji;@!o%$=FTliM)b(newJsvM*b4 zuKdClf{CvUx0R)l9xQW0I+vnDz#$A zB{^NKvz-Gr9Yapvimbqa$V;j9a8@W{J>5Yl>GA^D5vh>6&W6NUIuYw^iVxMg&oT1N zST13Fmm{qX(EZ^>3=bDbE;rfjIf)HUH*!+jJHJ1j33Z?kWbn=i!4bly7`#)1Ij75N zxXr4Q^Bg+;8bpb!Rs|yTblzaIT2 zHa5Ss|B#pddF-H9+PqJ-dGFwV?#<@tCd_=N0(V5wL|iI>hl-+2(q7VTK-JEIp7Y7k z#V7|haRgf3+2#BKZ&~}kfO68o!ViJ@Nb4h{Bx|5d+lBmGnGfVFM;kN|VYtW>GK)b{ zI$!`s=2WEvx&+Lx1>j5#un|?YZ#1W?q~cqEnX#KX_QwZEqt|iPl+P)4~72B>ur0v=4OyItZ$#IZ&qxP^CsgkQX; zZO9rcv-5!fdN?Z}CI853wnwC*OZk@y8Q#+@otTjSS`+(Atl1A>EU|zT?1Pn#8=ZUY z6hpVweM9q9e@I9flWLaOUJA?Wo0_Mk))T14Ayj9t6Xq$m6dEv3e}e1)G|CttevmnW z;rcN~u5m>`*{U~U%ibIgAlMN*mPCMO2}Fd!L*vseG@b7Oebn~~ushIrM|s|A4K*_^ zuIE1hY<4*FXP-FpU)tWnpuY=OS5T^cdlaM!l5~g2hGU-vy(zYt^7;G5UO=(yP)rIP zQS)+e84W%90J4!kD3k3#o6AE9mKA@e)LMX6lnq-d-)lM$W~-JusXjlAvr9N-ortV) z2jcTve?L-)ayUTp%C-UQwSM`rSB2dcyIN+G=e5sQv6LdMm>X?G81CQCBniY^(9i_?%KfTh0n2y=Dm<#-~ zVRr<<_)Ri7pJ{yzqmKRu<4Nki**v)(maG3>Y)I+#qS-$mD%Zai<4!j(e1mFEumjL8 zMf03XjC1IhoWBAci_bp=crbwW z3)=V!49Y)Gu(1f&$V;$pUF^ASE)yQWbsi1qL=!M!9IxCB-wMAQ@Vf%Pd9{Iyn-ENO zg57}cK&0`16%fA%;L3@}SpWw7D79WQ-{aj@$?>2wQ- z>I1!;ZBKV22nHG)Z0#8UY#DTIk(hwg17YYG9t5I{5u$(#TX?55WM1NcGt}Cc^&3`} z^BpQh`5RUG3`HGEv(KUv@T}%<;9P~)%8m8v90l(hKeeq1iTXp+Fo+ZPjlT}~qoMC> z<%;_wNv$Ygn7GXiBs>Rw9#aze=p5Dc*6lZBJUu$HQ-pvAB%_QV5yavgrJM?-*mfK)$Mc0)i|-Y^VbB zQ4rc@a_1D= zPH_x&o!00Ljz(|dicVsVO$ew;iCWtV&Pf)#U56=9=lfM4war{L(a=} z`%Q@$U{c2`*?^7@PSY2Kemhexu)~UMA^M%lSoFKvtCU?nz7N>c@o*otjz1C%XdYwp zhEI`^URbci8UqlH-UcrrdiiM5?~yl3K7{BfXfSMv^`cZ!3vgGdW)z=;yB-90LFAt8!sjK{?a6AfmBQx| z#=HUjBA-8fP=e31>Gz+5-MZKBWbAc%?FMHD7Rd!nRC+KA~HEKC~x&?&$Gg z7d`$_h8~{^g2-6^`+EFbP~?9?kN*XZZBmc_8bbv=zQWf)EE4X{cU9?F5yb-Z@V%=)fw~{te*??^B(=YOFx(C=L-E?F3)D;BkbhEoeEsv!~v?%K(m=1 zoov|Sy(+M}?&+ib>P_mK#i#?+dD~U^?AxJ(bA$am`^XDt0qj{kq%nA|IO1V^tA&-Y zj_(buoVnx+{u|r@{Vn$#;sea#4!24TeUetg#MgIWGI4Gp9W*9~027?MG(M_q-_#Ms zlh-H~w}lGLqifNfa7P_9u0(4P{h+-hl|jqr@aaWs18T!G%XhAep`JmK^&I{IEIIns zguU@^wQdR(v`yIqb8(a2`;(6#va4qi(3xlYo&XoFh2GKaq#-d~6N zWA?l8&AjFvAfwvqE**H2bxnZ4MxW+(LTC{P#i#}l#`}MN2(``T_Fx16@I6Cv9&f!L zzJru7ho=Crj#E_~B(Y9{>dr6FKnO>i(f2pmcYcw`>0|lI#TYd(8rHM9nzyL~I;s!T zNa}U&-799E@+P)GhWGbd^yg>QTfw49=GlD3NvZ<#jIDgz8$3I@#``_v0A7o5O_ z+Yt!J*<}{z9cnahf0`44@wr8967I-XMd$q4X*6mc{4T+43LX0FcDzJ+L@@MAKmZ#) ziVZ_>usp5&cnr?VsLG!31)$10wv~q?Fa;*;ofR|9(fLb0h@-9W=f%Mh;m>`+o5G*x z2TMAK??9ppMC6u^S~Ov8f&@oBPgU>hT#THcf641E037uClD`T5Rc9KZ9kFuor{^~) z<3gd(q(QG6|6F1-Kj$;!q8)5x5*s-Ijf4h2O`2h_Eq=QsR%#Xx`t6dxO5xo`^9~^a zbMHYex*^1^+3HzZjb`nIAPm|962KxI3Hg{LD_%{oFOzrBhkW*-5Bq?zgo;{OwjJH4 zU3w(o;B)5u-4<{ghe<{qDQOE2qrAxM(R+T6fyIHw<6)N+PL0OB_cG8;V;r+Q|yP)XhJquE)!M@ z^=q55f5H`;I?zfKDb_TsIgT`sUd7yP!IPuv`_bRU)I16w2$t`dw})`pB$y9=fC9!Q z;tBbP#J}wTI28Z_8Yud%`{y)=+d0h3zl4sU4xrhCYDCV8;$PX*aVE7u9&{M?JUcM| zfaU`$i4!+I3vy0YJF>766#JRPnPLw(^t?RZY4RZ5BxFhVF@icH&BLURTi~DO)@%(G z#D+!9{F*-nk1^Jp!??`#nN$37cHY5Teesam_bG+FQ0+S`65ED~4+@r>V}DkCcXW78 z@SHjL2z_3tkHveyM5W63TU?tGR2xHfXCICV;F2r?*alewF|76L-UJU-Wk@p(B-yVG zNF9Z{f8!_4&~r&pKWFRbH2ncIZ;3B z^mE-%H77o&pRefW9{t>@pUd>~cK!6}`d{kbh5C1~emgRI( z+$>Mn6mI#pW^jOfCbPh-b5r5OKbRWrfGo?z=z|AeVOF+X>P~JO3Z9tV_u&O0f$#<& z<`&MMa%cL$nwNq*+ioaiYym+mbre2NVzRy1j?mwwRwF>teoWt*d@!R&XCP}->~XQP zm1}~;GAW-AE)`t_`LI?FgPDqBZihh0osV~D2iQ;e+X~%AVc@$wT}S5}^1Ym|U>1D8 zpZne7oTd4%!)~K2$X`63b698sERmetzvQ`A%!IcPr^}z=pB0Sab`y7BIR!6*t#@@>9b6=k8^IQae9w%1J zxCr*pk8?`5_i=5@S%PW#vpzbb9@`~;lhfzF`?wy;T?>`E+sUX#jqm38-st0cKF36j z51fp%fYSXreKz%REt4AWFynv!{vV(Kct@DL7)C@X{%4n%=KNvukw5qAD$hy(-{=1u z6qqsns%x&k`pUUiPM&w#DV0Me&zRx5^2#|=u9-eJIAzY2Q|C;&e#({8XHK2vl7iQs zQhAyxbHR;Qj?$&-XH1$qcgkGUn>;03O;^jv=F!7P4Ie+Gp{dC=GBhPLrFrg@IYR^W z!{=xGyz=~+(}S65Bc{)s?i!pz?sB}BZCo+)qUkfQndh4mni-sa{S@ESNz-S9=1loc zf0xfUcKV!PXwnR{HRmSDm@?Tnb=Dl;iIaU--4vWM*EcEXn>2ayoGEkX`c9lp&^}-D z%(nm5xod+wCbyKe{M_>jg}!sG!64&vz=T9n_KJM7>-x%2zKj4}*H`;c6R|6fI!dOQ4Cjp~+SMnwp{Nik9Yc%U8(mlubT#7t{V01f z%i^yN|F_`(Vw^Ltpb? znuL=5T&rKklKO1$X!?1McV?xb_bA8d`oV@Y5S#T!Fg%)ElKFdqvahPuM z$9_yhS_ElVF(tJh6*JPhab2<-s{g3B2K8j(N4;<^yM9T3^t8y`(NNIHw~iurJqRE# z0MD`8ih366ovYiEdRORbLkli-3X@iDjL(-Sdm78)k7*@HD?K_rtsH5!NE;%hRJl5& zjn7CMgS22q+BBp^Gtw3yZ8g%cT|)lYZd9jn4&fii?IEOXKso6Px_@2&BKNR@i;G|Z zOa2Dr??686Zq%Ww)Z2=drUlj3hUsHa!`l?t3cXdCIHSgfIwRM zk=}rGp^q~LXhi5eObCy$Q1l3(Y!k|+(r7Z$rlqu13z+kf7D3u3j8j(Gs4oiSuFt|{ z^#v|YBAbDKu`eF~3iaJ(-SXOmGvJ&{e~0b@jv!d z|BWmi1@5fB1NGna$K#9_bw}&GOS7q=hJx{^;)gTUg8dlB>GqdW58g&S7Isq_AMFo9 z78OE)r;4p1@fDa-yLta zBYz_DQ~B*pq%A<2!`mDe3u$*{l=~8CYctY{F>sqR()>ukm=qTKCBb7iF6gS0(pm$n@Ls7Kczjks`JdeWnlQuL_w zU$@C-_{X#_`2%fY^PT*a;@@Jd5xJ4povx`sKKt0+cm$ANjr`Q{n2fYBNJ|}$`AD0M zv{aqD3~5oMouTm|jw_J1Hly5Hq`jGu_6pMWq@>lM?z>3y;`s4c!UJ<=@NFoAZHE<% zO6S@VRP$kw$^hd;!l*AQ#>^wO1!+}_yei~TM>=`K3Py|G9fPD6^>F ztiuv;{eX4@`vct~xay z{}}Tf>C;NxnQ8;p7fsB4ElXPs1-WyxfF+R{0csuKR%4&hV!RWswoR#yho%@*GIR;U z5bB(H+DsIF;{4zS%o%|7Z7QyAaLhX~o5|Nu!1^?#Cu8yG&7SD_w=8`G29%=+>hG_K z$Aft1957Psm-)(yLDECWZ~9I={#cgzXGGD8{M@H9IDQ!W*=4$sxo{U?t-%i0?LFc8 zMRr`vfJ;Ro=J>PYarQfn?iDjr$X+jWX+hbEC_BCfc|%{b$eYs7_n`j#bK`NG*but- z@K}Si#YlTZr;U>NGWT+MAgvt#zlk#Lx_BJnV389L!#%u!B}Z^(rfsPHh5XDw5%V|myBfPV{biG`6S;lCJUZC8r zMm-DlPU;@d0Jx?LJ%<)RYj+XQp#{00WJ!j7xd3gI6oKy=<8glvW0$?H>?-2CEKLpN zm~_EwSV05YzYFa*UVuf_EIbbpnU=xd^#vDZPz|!h`ExtqL~(3N>;?R$yzN2Sn@AJe z1@sr4Jq4B;toX&q_aaKa1Nm*;_kAMV?5?PTq$`-5;mme7f8@$!lfgQmKj*5ufWxkf zuuRZB4uRQO+8SCgJqu#>1=WDL6EIg`f7(X8r^&7_7j8nrpND&Jeu|nLDzaP#VwMNu z@q2XLEPA}6B`ZGY3+hZm{o7H$ipE@a9Sgtu;A}$HP_Q6NmxgAYi-s2DeJ+YRgR1D$ z#4JD>_%%Y8djRa5%i{5Q-Ru8A?xd{MZ|$bbGKMXHTX$tVUev=FF3JL+z974_Q0J}z z%r7Sn@uFgE*?Bs{qbaFPJxj z_G$6>&HqAu^3ev=-*9a_etZx0bBAZ?R6|xB0$owh!d(VT_#e*Vf*J8RV_e^xiN!)Ms%H3TGM{>__;50jwvP zI*`Xtg*f^sHyQPLXwcFckurom0X}=c$I@jQA7rBxh>yc4{$(@)yBh0Bu(IUA0$QC` z1_EXqoJ9CRg#YF+>CaY%Iv{dC!oPdX(9j#%51Rx^gM=CKzh;2z zd7XY0vLRPuuk$U-l_4k0Gru+%hz@ zAMKd;J6ZEG=6NDRreX0hQx=mViT7fpWBRS4@ACdUEAK%ZL(9OtF0VOb)`@m*4|pHE zeQ4;9)Xp8x%6skl44kPPQ(yizcqH!}8hVR(jD9iO9%jt*-HZ|8gS@mNkTuc^Aa5mJ z{c`N?p`l-symPb4%Nl1inb-%z`0wjOLv!J_+U8<7C(%8w^u6ygU`QrA@$k^l(?p=G zp%i23Q0lvRJ;=t7+7#lq4g8QC`^rX7v}CIB%4DlA;Ct`OY3JPz{&#bH?XmB+5VKeD z1Uq%j{ic~wtTA7y#@?O{vmfJ<3v?*@JX*c#Z!HX+>dXre{yDS(usaa1qfHpU%z_Pb45sxi;Fn=d24*e7?g6&u zO8C!2x!3?dKjgKc{aOXuBDC}H-vT=cdlHNf?pI*%hur}CC~SrTG;=!2=gp`S1BlBO z#NktD!=6IFvKc(CMtR+VvH16p2GAaZ>4%vHeH1`e^`r261o9B)?aZ&`HNa%&VFafACldQ@8|rg05%Y4*%P*c2^2|m{=9~RHFZaT>xGS zpvQs)Xbhwg*vcgG4ENpx826;0W6*4W5NSZ(>*X4o3R48L1ZEw~W|-Sy_QU)H=53fi z!<>qzC1=AdgINzV2y+X}ewY_v-hg=zWtVcvlGH<-&%%5KW)IAhFfYOU7Us_|Q|4%_6lOk58%z);4)ZyfJ7M<2`~c?H zF#irSX0FDj!_>lj0_JL%oiGo=9ESNVj5beWXTX%h)WNKR>4mu#=60CJVP1xL2S&rw za;L$R!nDHlz+4aWMVJR*4#NB#=JzmK4fF;x17<+HJD96JSLq48`27Aq#P$?Q~i8k@qVveVfaXot>ZXR)(cAv*`v?>wAg zIiFp?F2uQoi`d2N60C<`%8J-5REH8)%4TB^wVYM3N>;_@u(@m=#{D(yGB%$rV707{ z)w2fH$QH6i*kfs8OW5VCnJs0@SPRw;KE~QuJH~p;*$Q?A`odLgHM2{E3}44Flm8b z_O!q=TUu9ZU51 zqLF~n8ISq{UH*iVDI88u7Y8L-97%-MMf_nqhdD+k zVgpiAIjkTVQ%|{b;&O|;A-C-A2r!lY0Dms40X?8 z2+yq1fS(kNNUGPs5%4Y?7LUdg?lhw?IxTB_BdJkoj7(Tcfr-TflHyI2XWlSg8{-*6 z#Rsy4i4SBBk(TYI^o+C_OM?ht6^Ha3cll;Wx|MtBp%TGxw_TQz52CS@`&S#5GKtU( zZ3Ey8Z3Cg{Z9^g!iYS@KK`H(mkurcI$+Viq!88ryxdSsnb`mMCyU^&Y3mT&7iMxx} z#!v)L1DHjR`e}?cvipm6RP`sZMmO4EJRBjFUcp{8d|A1h-frgfhyof-=P?BXPjmEz zP(RR`1*k$0MJyUKy23$!Bt=a=iMo}k<+2b1|E!K7;gVJxdIDlZXm8gyy|CbE#?t0))fXe1J8;yxUj9j zdVsBTVTXZT11!_E7x)t}&%?Y9^B#<^USowYMKEaTZp+N3|&)T&xBbF(_vy^*jr(4g*gOs943De z(hO4t(+sl)CJaN@M>_go9ksD~s?m%2AdP*7)$;*YV;=@jwT#_w-nR#P{jr{CJP7Qk ztbvcf>e0Z2y8PkxU>AR`>UXRm6~hb*15=aRG1eHt6L0B+Y^}C19t<{zI^+KM0Q-)% zD44A01JGov7!t5&RIDk$zUM+a_*9g!XB7;D>~DlNWANV?k4NK-jrZVwX*7T)O~ei9 zs3nX9){2ML7^|}oj7n;|yQv);Sn5w;HERR;v=3lR+1n6`Bf-)5KrP!$sE9~?6e;b; zI?#;{)@nAw>~&8QScUvyOd8XbQKUBq{e23|O7v#TUrZe#wkf>@t*ND-m-RN}fj<$n zGlsF>07KKwvyQR1=q}Y8wDfe5x83%uC$~#Ge!5RfN65kKbPRgi!@*#TZS}UN(AP%- zCi5?PJHm4Q6yxFT~gw%?L$18C&G>cShq$*6u;^=BZla5l;wqdb+#A=yI`~ z=;@|JvH?%`MpOj2_IP?t>X$uO*@&Pbuw$OSZuG^GWH+@(B2`Slym1nVrDk0d=i66hZxKUD(&xi1k|TH^+vtY{_2A zH&%D7SXNSO7+wAS{?1TeNl7K#^t`D-qd$Y5Ol@TUpwg8hOd_O`vTMf@Grz%;5An_@ zhOz5SKb{>1bkfzsZZI*@F1q<(KgNwoECbwV;>akIlCdwESUiZli*95)&3kc&wQJn3 z>+d&Wc#JfPDLV~%`mmPEs1N=xYA$bVTh`b-TP&g>s*@1Uk(%B_UspWIpC4v3z{hPe zJcrDxL36SO;Sm0_bB3wg^crZX7)nZFwsAXs>u)W@QX}Qgr^ryk5}D;97wl9Rt6O zd~c@-`#j5V--O?VaMSg)_h0@-az|r#%5Bf*zSyUPO+M~xCYRHWy`DIBfg%`hEQB4# z&QKHXy0IICeN#?TjImZRcB07cr1)bm>1;@AMaU@jl2X`FN+LFX>>}|Y4t!b==O*kw z6=E-{2XsOBVm$%(#5oT83NAH(yNw)gMyN&D$)am6_SDk(uK*9)n+hQWRj^X*niV2e z^jpGzDP|1&W)#*+OM0m6;X1Hm=Y(s3v;@*cx``ommQ;)tk<#UmS&x0YOJMh7m#zZ# z45VJ@aU*u{O0lzt;Rs5C#`T%xv5!CtVV9Y=YfvqY^&cq&ms zS_Cc%-wByX@S`$N2rY@dQk)sUPO6nQ(gx9E(!ix*I{;;A7XA{hbXln>;@sB3SJqzw zyRjR&wkaQHfmZ_z)kD&PrG2NC;5-MfVIA-#-6oJne#F8lGo!uxs0w~`{r{=~H28ET zb#(E>;u*y?#aoLXFFsuS9W>@Uu~XZ9`B)E9~~z8gz#DIHb5sv=bJ$%@-6{-NTniqBN$R$W>3>8jVN z{<-RwIkV=r&Hen`JLdk|+&|6r&KooD$MZH5|w^Te(@kGVJiWe*1srZ+QcPsSDsg>td zR#Y}suBqHm*;jdW<(DcSul#A{JC*rWQ>!kiDyv#p)mD|N+FSLPsu^=@=YDG5HPv6O zeyI9T^~=?-SHD|*Va+`?sK}@jjGb2cOlimLjkDL5FRoZyacku>l}G1|s$O&1CY&K+ zYX!}r(zi^>N!<&56yjNZez{Pn#V})LCDn@n^?TB_-DnFXRn#PY4$+*!{y&D|4#Y$%YRb- zzsg@P|6Tb%mzP!4RD8Umt74$y>56}>_<7|&RsOAVR8@Y}sa5Adn-x_xRsO1Y)hDZN zue!f#f7R<%f2}%m&XPHSIh*I)HRqdio}Kf;oZrs*;~Z`7w7JD|FPpo3?z*{&x%VL^ zC+3ctS1|9id6n}npLfN)tLNP|@1c2b&UbC0D)t%Mr ztK-#IS8uMqvHIrfTdMD>exUl%>L;qdSN%M4?U&VWR{vA=AFBUc?Wq}4Goj}6nsaL| zt|_gVTT@rFq^7NAbxmi@`kHvn)is-IZmhYv=9ZefY96S0wC0JL@6|kC^K#8EYu>E+ zr%FYBK_IDgChTj%ed&yI-l=qt`goq)cMi}QE~io+$bl4MDL$u%W|C0k0i z;w+anX1cOupyYh22L(8j1Z(`9$LFNx)z;ir^QW4c%O1LnwPO7jxVP9>j73FW-dQo- z<&%W}XBV9_6yqzinJ>VrVo^4%OZeZND@I~ir@=h&Ny`(q@c-f|mj6D?CI8|YunGSl zo`ewm>2u4Z4te-~6H{F|TO9r=w*zD@X%<3B_L)J%x%qCBq4!H6LoUg{4;>f1Wn zlYYELEykV)ils6-it#5n4Rhg=;^ReDc^Cyf?!(J+VPhF^AYvrL2`tVbz>6G8hVf#! z09K;et$1gI=^MaW=fl=5_IR<1dCM2w+*)z{}yVm4A=oholIv=hM9ssi^5i zdZ1?7!>Ag(j0As;v=j@5W>-}h=IiP3PCcy7`bhr4I-1*UZIieaT-+dzr9KDOS{TD< zTfVHLX=$U;+TOUlp~YxxY;LJHnw#1?jK*aRhQS}+9gYg;RzJG_<1}zLSUdIqCfu3T z+eotS(;aphQr)ZzrEXzUb0hl^91T~rv^DTIfL+nFtgfY{nY{&+J5IpSx}v42f#rc~ zvv5v@b8+pm1_Zwl&eo=-wTl|5@EG;A&CPYS^_Q~{@D;UfjmwrVWxqu!jNw26H8@7M zDCY0-Xj<*e$8jeju?a3K5;!F-BEb-e<;^Y27O}B*bf&>&M(1KU&FI7}N~5)-jZwds zDRNH&H=IZ}G_^I>ceJ#vnqA61i+E@Dxi_;9`>`vfO;neJf{(z-6?}}a))fn>E-^L= zqMddHXVy`p)I9#-)h4QCHjE zRBtpbTiDXJw6>$EWf?XU8O!R~4^K0qr(j`)NAwIhV##ckr~MT=)( zzp2;gD`DRpo}iRXLbhk*&{v9dF`PvvRai~tZrpXJB3%Ze04HPb!8lFbCvYcJF$kAc zLhdCumEFI-$EV^f*DRccp3i(7nKO!)3eUCV_MC^?E{ekz&f+}pC>;C6xggJV z!rM2>=nnhWG0*kFKOgrYocQtFAnpqg95SdC^lTN-B(O+zqk=KdX9Y54l#%R>bw}{J zT;{n^FrJ3Ee+RMl@#^CF95tsNPmWN8Ncbq85?Lu)uBkYlGLPo7y#?SCfz*&bQQ*CA zT!Uo$tTOL?lVa%Ot+V%cuaZW*-tKS|JH9^AJm;(!jS?{0>oY5Yxc8ZLA!jG~>Y3Wb zoQLx3;pg=>;TIdy_|2mZAdfl;?m~`v1JM+Y+p~PDdH3cfsD&T90waK>tsSd`bJ=pd z8(1T-sg!xRUB+~>+sg0)9kQ!f4%zjqST5NOwH=LY6uIi!(Rlkf*3{lw+fl!mji$TC zwzifwHinZ>FO^3wM5C#8SqICfo8`+cU)FNPGB%cO8XD`-lsB_+bkkJA3OEHEmOA!b?gXdC+NJD!=1of*dS~{m%d4@$XsKI*W{w@QX&mf1juAhL z>iZn2U&wwS9L?<*4;&U`5N2@MLp<^;cu&d(3n_{s@q=arSG6@RWP^jeOh9*yZ7ZON z!9h_rnwuLJA*=8XRGw^cyR^3ba?l9Q9jjU!3BWD$xrYOxgjJvV3 z≫⃒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

tXN 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 z literal 0 HcmV?d00001 diff --git a/external/pthreads-w32/dll/x86/pthreadVC2.dll b/external/pthreads-w32/dll/x86/pthreadVC2.dll new file mode 100644 index 0000000000000000000000000000000000000000..fcb5d9dcc1c18b0be18845a34c3aaf0ae37be200 GIT binary patch literal 55808 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 literal 0 HcmV?d00001 diff --git a/external/pthreads-w32/dll/x86/pthreadVSE2.dll b/external/pthreads-w32/dll/x86/pthreadVSE2.dll new file mode 100644 index 0000000000000000000000000000000000000000..8129116fd41891ebbeccaef3422b1636b28f2b21 GIT binary patch literal 57344 zcmeHw3w%_?z5j%4!U7Aszy?>15OHIpA|}~QvYX8dNkUKvn}qCwNMay?BtR0AJv^)g z=_c0GSf{#?R#TMhoB$9# z9`;5Q!fgSy+gi7}83nH!jRfF|m+Ku=?&9c_k*DD>u!sH*Uu$OU@SA5Ldb|$NPv#)n zhmmr4KFDx5r5I7g8Hm~o5dEbdQQ;y)H%>+L4mjZO#}^^GI~mb)RPI~>Q4B?^snVY; zK{P!bQSOnslpo}`InRxZ^9aMPjd5B`D_eUuDCm8;4 z`8q_;Uxw({(-Fm9i0H{lh&B*d9hr#!gZlie7tx=Ygmlv5W%4kBC@H{KM@XYT7&4f^ASyf_eegg!RraM>)m2}PqBgFuZQM$ z)>DkJ4#hNKA#coAQ6Zg0l{Yf6Mc1hKy9{n+e?*@nJ9h4%exc;xJ}s%P8q}#FAy*SC zDy0hva_X~5n(A$2fp(o&c^Oqt^|&ik*j-0`=lgdWJo4ZA6~(^;2u2CQvcF3|7}3>L zOP37W1>i?7&9mxk`^w#AqF!_xL^ooc+R*XdGrRl;BS}U01VScC4Dqt+rWaP>Y+T5}k9F0oi2+5#TDx4s?GoXq;fwp8trWv&-0F#w4ThPmqY-KuK!A zofuee?dxVOJeWJxs!?f( zdx+h~YC|+ImjONtHD*)F-9Sbv`kjN|K(MRB#?|9nM7{8eC7~gMwBRsT+1ZOa>}v1Q zy!cbcvvd@rve4=nrgMGq>dO!biBeYQF=NO1v0#T{olWtg#T;;Z8Fi`HRp*B;|rmIIN<>>W>@l{5d8oJIK)S=<9MXja+Szc|V?T>&HAYFlRd-%B%pqxh! zyd{bzsa+?XCN0pFgX}3v!sRF+$hPJ+bvPEhiG@+Ftp^r z6qG4Lw~G;Au2jHg5N3zPFMz>PlT@sYd58^+;u4cI!FeSO-&v`2N5glPT`D$9r3SS? zP;!7loGmnbOAMG7XzYe?Is^4{_`nxI_)^?K_-G*gm*Cad8TedL2IAJ(aU)XIzVc3f z11uk&K~ciOn!`X#^UDy_9Bv?RYSKs;l8eC2W@hX>`!hwMxyQf5F^up$$vilc zH8ckNN6cGN4>FT&2Lzv~Lb@EHakk#${b?hMOWHD;)fZfBWd41u+%3P^1ZgskbS7!G zu3m=dbeBn=%0EDI?9s`eLI4`dl>|GD4-7v{M3|y6I<%7VGJ3t&_%P)?`_tIo$Nu~M~!-nH$KEqKGf!`yA_LPBD7)e@xXw6vk2`SR3l z@Ba1oeG%;AKcc58L+^$t)|c6iDG9JlnIKMUNt|~1k}+%QY`eKOLi20q)4rHlv0cJ( zq?@Fj;@B!osNLJfVUp!{U)BQ;DWnG5G1mzp9>7ki>TXO_5>mN7qjT*P^wnIUsp@`& z^dGTB55-YzF^DZDvBWHvSb7*~NaE<~VYC*m1a%(sO_1Wzd%dbq`9^QUqLWp1_aFup z;sGDYG0>+6wmZg#sSLo7K7xv-a{bJr>1QU;gM_JGDlmvKq^wc(5m*glL3@7!e?Qor zc(uG%OPv3c7~x$=S5y>!QM)_o`vp3xg7;w1i>LBFyMqOhJv2|EwHj=XZ2&v8D zC~13DH-{-zjFEN@p$8*V=dm3Fv8PBeU<8v}Obam&y`gaywKdeAhR*~}enE70-gF}~)ouX*%v2mOS8##v4HWHi2TFBi@>Luly+4l$nLS0l4@_dFK;lvnW#EnC4eCCe~5vL4c%Sz!LIGTC*6;{~(O{G+uZ40ntz1{$QdmUg2z{*8y2 zZ>&`Gx?8F2g+Ns~ba2r~pufRA@tdpAY7n>#c44B#5}3M*S#q%S49f2fn(WxxLQE7{ za0{hGya;})sPuR_kEkqn%%;exhZSWDgPH)Y^Y_R2&cZSmn4kp6?s##$4!6>Jlh|UG zS`6AM>vAjX9+*}w>Kc={%v2sUIUt=_?;@4;R?1PV7ghrY8hNBwt08nq2aN3WSHLI1 zN8=-rKs2bMN-jh5QoBK_GBsWSR+67z!I(P#R+(Z-O=7#Dr`SRU9e2MjJ)pG1s1Qjmgc1A{j1Eah_JKf}O701dsO0mFSQm@6u6 z2W;;;F9*lOFAdC|vZR|75VPwupII91>h?|WJ7R<})l0Xf0K6sLp2ozWeMLG7V!J*R zCV}P5VrtbBG-Fg_urKKrr;1fNvC4v43V1EqQh`n^)=NhJ27Qchk^focg1wC<(W6&Y z8?o3TF49SeQ>9XixY!_hEEp={W%|BYu}WWoKe5W7uHnUEv#VQ}=y`$+7onNPc1-Jq z+JUb?@Bu|VjfSZC5GvO&^C9%EAtsIg-{(W>pREgX=V{Uy#1m--?cBG1jQ`V7n{;BC zCZ56rK2+Y!%TG|t`{Jd!I&tiv*%tBy^>ew8$}RjAK1rjAv6!eg#ffDD^qYwC3A{W< zH!NeLrCEA$RFp6RtvZiEo^fpwQ&pUQm(n-JEnoK*A0e<$aqBE{V!AIJ1*xan6R(f^ z0eB@0QzXerUP8Z`Woc9zWBgq@Oz>oo#bU!}wC(fvk22o+bl_see{fUxw$34H;qRNI zi!FRo647f^`$}4_3~YZfPQ}h%SbPICN*wF|9vk26RcS@=Alm zjg;{cl>IC9WM$k9{6puz(op5RI7f&_zIaK_&{gvK7-?u-LQugGx$Y{k-(^Ghspvvt6R=I#2KKo zi%)eztfaFp4!sgd?mg;U7*68#kN07cJ7!i#Rqq$zMlaTYniBG@$ada(Ta&{t2TJjobZ-(0LD zv_S4*r^n%eO@`cGl!Vnt0Wi~)gnHcBcKiF|jJIwN_{Lz1g?b{Uq8C-&keRd_hNcb7 zH!;{rQW$vl@Wuo5dbswnPxe*YKWRHb1T~^svYQ8aVL)#Oq4b;PmsQvfh?iS+s)j`h z*5Ynju<5;S`I^5$tz2zQ^zWb{IQ=Q&4o{;#O2NW>H!V<^M4T| zyj&e9`VOU1%4y&?i`Wix4OJqhp}f?MJW`{}wv3Os)kgPwQiZ34feCjK-khFyB^(Zfcp{eJ*r5>;g)Wcz9ZV>mUa`ku{ zO;ErT)gZxjOrXF(!znPwP>mjdt9>A#7*7VlM9))XTGPz#fC@c=9blBygKbc4=uH%h zb+|Q%?b!WOGf*3DsIo8XlmAFkC1{jFJ0}^yt$(9|89R=lP5(w6?vCJ2GZ4<#m&xCG z9mvG;7uduq^v}rDcIdR_wiFN4CzboV65aA=2NcC4Hz39s#7=>MuZB{vCcv2c4lk$e zxFu0!0SPXxf|X%urS7UktmsVLpdu zdrj?>iIS)RhN{^lo_uDg(P2%H;Fk;9{^ctetnk0+95jxc)L)43*FK?>iL% zRIl!a{zrle258z~qTMf#)UPC5jhiaad#Da@9ZQPmR#%VLEspM)L+cpUGe@spv<-Vw z3SB#WXZzcAOh^DxNr+&-67pm}rTLC6kvuxltNW7ecdRe{xtBxT0Pnnt7Pef0dyM|c zZuxAL8a;88M2&B$4dulJ^C*e(VE%|$px*zN==JyMQZ9{P+D~nvB_lWn2J{m#!qL#y zl*(=9Q(A$_yH_)D9{+Lu00XZVo4A zLb}RKkfn)O@nip;`IS+=@sPkiF1C|^^kc;fV|&>nx)MKY$98N`|!9Xp;E}RYtSAbG*?$)Q{$paH1zc>8biUy!AryjG9N5M zz*kK$XaH9E#x+732fJ>thI>vv1|;}#<^B}75_!VCH=yrr3%^p||J(c94Yxnw`f1&% zInr%DvKJ@_vQUS051u^IL)O=E#Q@d0J-~_~2Hw$1!gVAvuzo4?^mJHv08u6yiu5h0QzYc^IaR7$`&Fi#F*j@CYI5s=N&8c&zUXOxZ)w8nf$IxcO-G z6{}LD3@(z6`KI8731uWeqnQ6O(l9jU=%`xg8!xR*f#3}?2x%6!uEtom%G{U3{iM)p zMSwqo#?;uVTS|L%i{NYdHQ73Z0WwC~6xh9Qd zFOzL*EffKh?ZB4xkfi>un2EVp<7O*8dA(x%7J6!o@j_=1+e^guLa}{bPqCY8RqaV) zd!pFx5ZiNtwkRu{Jx(X*0gs`qT)zHgl9PIBYpHGDl5TE`l=ctr4HW_-bOU;Z?W@=_u& zo*G~{!#i32{u9Ea`XtyXE9CELK=k(|`TM^>vXv*-hLXp)o)O}n;)a5=G~W^IL2x_n ze%CY7g)~)S7l9aoteGz(D?;bEb6dCm3+8jql2rW!)rja7xE{(AuTXTUgFl3 zFLIv{lRK~=sZ3r&PjD0~@0nwvJzu#NJO?|re^UmX)g&$WUFe1<4Tr3+kxu#sD0MEkXC!I%3=3vr zvbve1F@Z9p|I?}K;^7~3N=tbE5euqJ1pa8jTuJJtos>;-(BqRPxm8H-L5)~9dK)d; z`^G8zLo0mOQRDUh0b;1xWCIwOed9Hhed7Igga5>djiaBSeX2gA|AcYlSpSJp?Qu_F z7GYSb(ZpjZ^FNJ!JpT*8F_aEz4zX?}G-U^8PvHz+CeSiPt_K;Qs08;?EVPcai0eww zdvlq5$-rC;R&LC|h_!tAlyy?7M9IHfxcrm%{TUse2k951Nxun|W%BX8s;rg!Mq{}Y z8>pWWQfN^CcWUW+s*tblgHqcKhdd-x4qvhCl&8%z=&U z5f$hlYo&a3ln#aFP?{zj;S52D?8dkw#|BV<%nIrPg)(4Z*soeSf+mL1Ptm#$T2h2{ zVZ3HtARCD7n5Zg7ir}ES@IGyT0p7U4dc(=zG;X0q5>0Pk3vxc^aE_ui z%7vP^?+vX{DuN4MSZ|EdI)l_~B2;tLNB%RKhmQ0P=CekQpE1P?#o|KPxQIr%sfM;ZsYZb!aYTp}fq{PvW~ zmN2P#`ynEIg&T~YpmGgH1Ru@tc%S0hSfN!f-})>81pj6$K(hGT=P}_7shG4)^3gOt zMZ&L-7@x1{@wNkw4I}`{Fx@8+(7XJHu@a~4{<*&Ck$XnfeAB23Tx*4@`ujPgs-}=1 zIXSUe2@^2z`~mM_fM5zO#T0rz^@esX;gg~>20DV7P?pJx&{I5*IxdeRCLk1ntD;t# zLnzx33$f^R7+H}*OGp5iN}%Fu$AzvAx~dvC@1T6^b9@9>b3q*h>y=^+EJ#;cX=3rw zttEX08hw+Zpb5OV-Le@I7Z5jSOdS3U-nkJC_>UOK9%q({2ug08f%qTGp@Nag&<&ln zHK9_T23i2W-~>$P#?DC)eAw3)m{g_rb{;TZ_c72TTq@;~R?`^cA)A}A<1HYOzVYA> zy?Bt$;?k?wOdpiMQ{C8kEl8*p5&ntJVGgi$xsc|Re(ruMaNLDUaeJCyQo3(lby=Af92kHUtUR$oPu30&7?T30>5~d*Sd-Y7Da>M!Z=nHkCo)#TP5`a>5X& z;c2eVjGZN5+n6dcFNerjDX->bi1(!9bY+sqv??|RT`8wH|nrL$ZF90 zCRfVV$a;Lw^d*PY=b;dy0zWngyl{p_ctAipsJYw?_;*tG4Uzqg7+n7gZ%JN|(rvN5 z>(Be5b+Si}0}3P=vH>RjPCv;7uaqZMWBbE+ofGT=f@$pTRoQ(B$}}q4Ln$7lb!JRA zE+QD{8+1a5eTGmAgHO;2!PvQn3k$F9U8+dfMdowzg)?;HE-bO+7rIr+LFNlD6t^U7 z7+FKyc$&D*AXb}t=I~J*t^?~h=Q@Kh&GnpcCZEimbM(f}kI-by99={)6&SVuaL1v( z8#}%WjvLVb**gaHA9gE(T!O!Zxt3i1yM&|%1mjc&O zRKjNnC_;{%LAmoiX+dz6TD{~65;{S$Y5GC+nO#f#2d}T<8Um+ht}1QP2!PON^T^lo z#tdO%$cMITr0(^C$n<4an9yYJC2^BfR#ASK_67*o>T2Cxf$2jg6mrosjZFFDl}IuZ zN72;5y8}~Ek`yZy4B^zmcX8p=vORF6;(vQnU)+<_b?H6mvB{ArB#B`K8f6JPT9|r% zhX&NTv6gIPkjp`Ioi5EG>~S$2jV=rl{pJ%?KeRGUl$MoOXq+t9b9fB!*wU*0UnqXQ z6r?hIfVtX=eJX)@G5zzs9sh|hjQ$zKOI2Jd-Ax#D(W*>iaAU`r$Tf-yRHitHeNqQv zkrF*I(hjk_<|zz>c9XN%VC>wE+FYL+J0HQ7)Q~Yssm|E>ES}JU_O)uLA@KpEho>EC z;%=l2(ZpCZ!Bq!%NunKLsp~aiF|=Vg8IAHktpmgG*;Nrv_g2cccM&V=@qwHM(cz0A zkg$y+#GyArK_jb_*Q#YAz}}ETJvlr9Mb!=fSgsK8UGNi%k1ugGjR5m8C4VUazF~o& zKI-4dz5xBWLQ4AQe-Jvt`ey~Y8qz--S?7WE%b%d$SBABY>6m~ztVo3ER(|{mz$g~e zL~Rf~CQWy9yAQD5lCQ;~*7j zF3;mC5|^FA^ss=aM04_`gWG_V=LDuPg6@PAu5U=eulD-pBRbGHxFqec(wQ?A9(l^+ zKuK>sJz=?JaQDQKOBqpENw9FO(wEw3sJ{m0U|N3if>3o6`Gz2AiDbvoV~`}G@K!Pr z_r-BDvXpU?`ue2$)!df+%GPU;%k%uXbjyUZd*bNkV;t%ONljbdWL)lvqiWCt)@Q3< zsJ@Hrcx5k|o5(8&zt{JyKbIHxjrMbIxKYyeRz0Apf*T2~f3cq2yn{ghmPZu#|A7pH zL;msJGH`rPF*l3KS3FAI5tku`pcvjy1B?*%znc3Pl_viyI}IExLe`y2AgiCiU}`l< zqrhi+-05Hlz?|9wx`9WB_r>Dk*}%m!rpU>G_9?1Ikm!JXfqT=E?m(5ULT)4a_hZ1r z6(QeQ#DuddO@YYAxdU z^wKx{^4~Z%u>2LKI^%s4F)Ha}eRbi8t%!K9{P{NC!;`rz&}JgOoVTe}ULUG*MpSih z0>4z}6=USz1Z!NHpDh`{cq zsQ{Oj;{e&rN04ApCIr?`0mi3eOjO9q!yNc;jPYo|qTo?i)nseO=F1HMG|PRiAWG$n z!Pr4}td#^%0yx&}mK)Sw1({2lfO5*F3tn|SyXkys`|;k`7sLtRopW40?Qn9!GG3)> z5XAHH0*e6RV+0~N9maZ#2Ic`@a*z{6i;A(wXsR5T_?5UV8g_ajZ3Y&WcYRBwjSRS5 zsIE%qS9k*JbRPLquz3*dbPvIuD6jp`h;dT2q&hTC@cm4_ya>5K4Y`_$4w6RIP~o}v zVPwI<9T_Htj}IuO<@|fDd9;^0-Xr@oBy|b-QYN<4NL2~k0qlT*8b`q(1X1GqNQ$q< zm0XRgU}lOHCir&(r1dHre(9HPYKH)d&I6g0E2W|rS^g6W+_Gt&z=xir$iku-A=(qs zRQqIVW)g44{U?s4DtyOtvZjLY&EfFP(%`#AMKKqQnJP%Uof6-fCBBIz!s)yTqgo2p z)3otrEvfL}`(SD^5wo6N{aOYKSc5!`_m&(>PX`+&xk^p=AZcx3>G8jwdCdRzJN}(u z(kHQ$Cigg6NL11ei5a$8`qGR{^O`A!K1MS`RKpJu^QKwzgG(xxD<9(M;QKa-!)+tO zX%a$vjogI7fPL&X7{=%`TywVz93_}sSZpEH8cYQs_zDHv7H+u%Uo>Ij!CPc>#yZ~@ z2Ol1hrj8_HN9Z@7KFEvk`nC}){0_!;YG4@l`^w3xq4-D=$>9_lT&W(ftJjw(-;UO~ z=^N{L;ZlrR4jeYAlDegSba(2>c7g?*1mSy5nyIbLHBMVKtb(jFx3^5P|RKI9%09G0()umLYf6E-`^%gQ%N zu73dPsatNr1(e0^tyE_6e;T_s?olEhwyrIYkm_;4F4%)&Kap}qiw;;yFA?6aR`-$y z)T}yKU98+i-*n910lbhOpGVzNDVKK=`imY?w;LY&BLQN@?gGgVY3W1WK;<@VVGg&H z^QoX$JHaO~{~`W0U1e9fd06v4 z^`onr>rbCOP}D04N95a2z|&kJn0iZmQ?Q(X+nZFmN4zSfZ-P{`M_iwRb5-W=kv62z z%j%buFx6=OLQ>CwPa)?YvOO>7%>+PiEj?8ytRX3LYKc+vHT1hGO~0$I3eJ*Tm--Qy zCOB{X)vL~1Pu@rPA5yD1};r?NE<%aN?8+KO?A6rMc zN6w%L2WEj(Ttd5Z+O8aLRZ)2adv9G!F;OOBsde!Mv?m8Cjw5`CSN3pAv3!A+9F5Lz z{b^|WT=@G)`jC-{=)>J!3G?KL6sFHPC>)}X8}y-lS&;~HFUnE*uSKAjK=vWGP5-R~ zs^ZKBukJ8`w&45kAqeyXE%{p~NmPZ=^zq0)`mIJ8E+KXR!DRI5k2Q8~BchPEX}|-0 z=?0V|VbDG=#@KNaFGjmfw2{pVMGp*lC1@Ch?2x46P(K>^>V?o9A$YVH? z=nyvOFUHQFfzRdi-*DY=igxY_^$Z>R*>|X8)^68PVVvtzVKjG1=o@9DLzWEc^qhzn zImX@Chn#|{Xc!nfX-|cm1js`GUcodT_}(jjaR3$GM1P{F5cEm^YMug#QJw-Pkx5W& z;nJaj_~^MRh*G;A)3qLq!cQY4iJD6i8e1;RTi*p2=ICC7oUl6q9E)2{;s`b2eFI*L zs(wkZ`clhNq<^_y*f?48Sj)wB>>bf&0+hiCeR|H#x~p~YlGlS#F^BEpcqM}*8Gaxl zL5>MpW#5Q3zLl3fQU>?-Ii@ZX0eL+^K7@>_hKikn)v=zzQHN&rF%k}?Q1)WR#d&W0 z+Ye}~FWt+z=wzSdM)g}m3oKUnu1|~?OLe>^FJBWRLL21WIjvmkRo%Kn{z6Oec@!_| zam&?eqbIWq1sg4+g$Z0TR>4Tr2A#6q?1h(_SzgAgfbq#U2C7sMBU`-GM3c5YP^922 zfWEnKf7slvgLxxg$PHA%^SJBReDLEPv%12^huN^%VG#^WrPynZMLZ39q4P z3mmn*vMreAqc6qy8!>o;K9jThcbYu%C%+h2HE|;^XrijemC5&qT92nz#ZhP%SwTR* z<`u4gpODYQ+hB28@*6u|#~m&EcI`Wedp0zTTvETkWuP~ z-KSKq9>&zSY*q=EH%Ng6aUm48_Kks3eCN06S3xLG(-4?iA)ls#F72d~L4iXe$$2=I z6t-Mm`B*7Wt9P_AL9Mr4Um+j72NO##secEsWy4SZbn@yU8htpof!tXo3)y3;x+~-d zP#R_FLGv*Brijzytrr+t_6NGe}if-@!M=E?rdC zsH?Pf)yGc4y3Q@mwurM+u}47Igg>E0Y$Kyd5^7BV7t(e+{JfaELf*;AXo8YXqExk` zeC*#j4iK1pW&FD+=|g-OW#wN+VGmh8K@=>sx`+5OY6fUXUq)d#jtzgNhr%=>u(6+)&B+QV6G}B3sAvg6^=sZ;8fH1RU^y;jHJ&Z~rH;>&{lJ0UYpVl0Cre(*`E5 z)visr%BQOjlJfByW_k-jL3kHoK$TICn!hpBS*tV}J|g|tdi@oV7|IIfFu1;c^7G)J z8sqQZWbBM1R`FS_oD-d;dSSA&ROg$3eM{gjFv|!OnYzV`Fntwb!m^ghKi(1^Nkz^k zi|Tg@aqq#oOXOOrZs8WHbKYbz3-xfFpVwqN(DxiZqChbuW4Q6!sR+MA3#PJq`c6dt z9hxD1Bmaw5op@1S+!JKPi}HykyG_)AGoUwYYlA)u{p4;AF}JM^>k}1v z`pw((aeCo4|6k9Xef+RAp<%ZSO~kwX(@D~&+y6B!_S4u;WE*h7SEh+*){GPR48eMC z*Xkj)&TH)akgyH?CA{V&WgIMoqXWq~bUalw$T?K+j#i%J_dvyOLFKbVseCD#+RfE% zsNH-y8gdTBx4Y{(@93&kGp2^9NARH#A&P5zzQnNSC}I6hEmQrP9&cDR|53k|@oh80 zDb@#jG|7J8-R!Qv4dVh|Pu+YMP@hqc2aFGrmyod5z&&L4#q27a9#{~A@+R5ck8*1* zuyXM-!ar2oGpIm9-C^(; zOxEm|wBuGTErnx=@6tdUcBTFfE(}sQ&l$UMsz;u12k+ujG%u(f3vXiMOjkfeQxKR* zI7|Nf?P}TZ4q>=#PZ13q))PyJkhh^EzCpvA0AC`Z`zj7KP{)A3-{gA_YYq(?VEC^L zw`yOP2ieyx!=3+Eq?c0V3~(vrbyCQjD_XEuKfuzA^ZB@K_hFUUrCxFAA?Sjg*8(_c zzTWGM5zdqU@>7lo6#@O(z=F!a&RP?VPHC7XN$@eWjI{ER_Qksj=%^uZwgsER_dNYBY*QP~!|C}fi% zrPS+;1!eMYJ7vmDl_#l%VT->+6nXfBen=jpQbN3c<3WB5$e>pkjERz!?mP5Y!{!?b;BI_vS( zYVJosTl1uwawAPWeYq!}@e`sDG*U&NGyM(a;xu`JN?a@OkLLzPCMtZLOq zn%DZZIT!oOWbwe~@RyTt^9Ic`z5>kU+$!^O=vW7+1?OXaGN05SGn@BP-}j%S{(kua zi2Kjrixb}}+Tg~tx!luejruwrtrpX~fJuBT|LRmHF)S6k=o5`%J#Eq8Tpuy7ryv84}{t34bULSpJ&QM>Z{WUs3;FuF5+=XArgPWQijLMD&f-#D}A=1PHIfsVo)pnjvz}#;zVXLVg2zn%bjo2v*4Xw{YxM z%9-j-2(3_Cpd7i?H6rQ4@^wGLDYnI&ep13}q==rxEp#P4ihlK=#p2H;MVW~ilnfr@ zdNZlVZn<0~BPsh!mxRH?cH*7ikP5@UuIcj_JSkAZa8xPR%^}F{re!!j{l(`cwhL8M}* z0Obh+Xicxd94GCB(q#;qhs>&1CCN$uH(KKi&mCW$Q|ZA08poWg>3rL&K+zQVl!2GM zu4jA+&J-Mf3j2wAlm#Et$j#-;3p(ZYRsMmm>tjJJ6&}+|yDMl(fs-}xb)DE`wjDrO zT8g;75Jo>n<@!?jDI6Dx%{sB!A~x&A=HTjLjv2>iO!Ph$wN8MkGEe%<^@iZU@~pB# zK2B8DYD~n^tkNwjH-?gY7gWfjRUYxkCpdL<8YKab1q4}w^KgRzfsi(32}V7w2ZO0! zj<{1S0c_%YCVplKMkfwpp%F>DU8=F0cDtZt7&{&XRoSxXZTeP&Yq^eOTBVmfbx3ff8YvwO8tEB_N8(8SAP?Y zh9WcopmAQC-tWL-TeJj61exOGnW$A85yjAFr5;G&(1_6djMWkGH4YOv1)6BIP&-V+ z7f0jV3}}Fe=<^fq(?I-&=O;XWJ%{(?w!)x9_!=Oq>x-0AUSCLmkv_m$9g78QwfvPh zU_$3^W5-Ll^M9fU_zkmO4!Dl5C*WVwZ!&g1M&&XC?Iy4MoTSo^pZ~@8IItERc&t0Q zHvcMEP!!S8{HG(Zg#i1J zeW=3dLlnQ#00Y1N{Rczv>s>0Yq;JTtXQ6I%`rpQ{eBTu+{S3aPdoKCkPVvZZsI7v~ zD#LYfh8t+3^T;#Q(F8@gPAN8QZa0vLrNS%BERTHQ_c?wBxm3c?<%9!v19-%>y*(a$g5N2iNpyRAO3h?>xUrf!eNPu^BRf_?utMu9aYOKHbl|% z&2NRKmA&Qvtu&1svO~+``6^OFlp0PRf6<{)bVzyJ4tht(<3IR$;UVSm&B%)oPkyy% zP(1mxH@}8>8XCSe!G3G=&27YYgXFPCJ}X#G*ihl+a%CJ+f*pkd{@V9~2=J(#^|#}L z!`Waue1tR>l0=(u{OtzTo>d|LMlCP(dtmCCAm5=q@_9!N;7O|+e*UzIRO_S|<}C~) zd~^~?yi>kcl4;eZ{&1?2Og}N_8c)AkCye^A`|tr>#E)V_KOwg<)3{xT4LBFF(5gHB z=F=utar{j-n|*Se+jZ8yW#az*hv33kL%iKoz=I!|d6sZqB6)#~>k{ZAT7DXbZQt?td4ncg_xH`hJ>|gYfEr9M_PzL*7vFiYciaKt zBjg`NrxK-I$gv!MJNCua3HWlwyiVUb8sD*)*2a|D_DMSz2&0d`cD&dB8e39Tjb1Cs z^s8}_0tu%GW<@YT`&9&ez5WK+>IpgWE+7UjCri8cD9JN8{z&0flF2n+Nv5-Gm1O!t zRY@lIl-ez1H|mxYPyIExfwMRg7vl$#l>`RU>Q?p^qN9i4xQ8RLY+VKTM(SK9&x~XE zg}+rWFQyNfc=yV1NP3qCUiAhc-5K{gD1q(gsI4jE=}B6o^VfaO zqzw8f=&2)U;xH{3ZC!`ENce6vz(xE)+|^3ssf*HLomv#$Ic{FOZz6ul<~068gX(@Y ztZZI*zjO)z>>J%vM2l3m<#p8CIEs#K9Md>Wo)M2#ytCf)5Rj#RfWD@sd@3l9L)PNO zB)PAGdRDLdBZ{#50o4(LO3a{wwgZcuOAUe^&G0YWooDHQ9$#WTUF6YJ5Dkq7RXm^x z_7ah-aL^C)@3~Lb-OoearLWS)qqCc+zQgyUb4mu0LCW|XM|ml)kb4qT4nNNz(qPN9 z7c+oZWD=L^{e3#uQbTL0-^F|%!mSA8bjJD)D>izuUri8WmCAm#QsosTgX*BXSETv< z&iVAKVnur2!{U6CI3JbjrQW{Z5SQ@{zr|_|oFzDO*t)h7YMe!%3wpPP7w`!_N#6}$ zo<>vsb(n?a=fITGC(;MlAwnjWL$=*eO2mu;aI9GLx$Aww;DEN`t%y3#!FSfjC}d^N|$Py>;8)fu!*dQJio;#b^DF;*4KYoO=)A71t;1<(Kh0 z_~op-`6cd7eo4NKUoN}_mpgBa+l31b+S>X!zv{Mj;fk}~x9*|m&V!%Bm>j3aJsoen zg)+B3j^Wx9cR%7WI@Z+__Ym$lyOO{WJA3iU7CXOv9k)ut5%B3&hBq5ykv-Ds}ApBU;Y zIKK=W7Kca!Cuyi89D+<)+*jMEmzUCOM3f-EgI83RrvY&=P;?OAa2;|J2{K6HDX+NY zbMOxKDX^QU2#1tcIG-!RLEO<$iKg!BvK?LNMoa(16>Ol2X1!bvOwjMF9PeFR0t=+# z*>>9_%=F}KkJ6Fj{jQyDMly8M>9PJEo$EyF`{c-pQg=UwQg=Uol2S@C327yn#0$wjID6urxWpEL$@?5CwBX0hr0-Ct$*3}Ju(h7Tj4CR@L$8h{1EpU(lW7%%vh5(fI75A0$600b?>XLT1+np@3r^Bgj- z;P=O@+vRD;_xcaUXha!oG~q+lwr{f&(zHwc9UzQUt@u#e>PoVnV^_yx#^cYy7-4Mf z*`xkyAvg+uG_jKpY5?JagJJMK#}60+Dn;m*im?3RzcmOc8~RPd?#R9ZgZMJ8Op^@S z>Gl4)elAWbyib+BUGNy}S&D*vtMQ%PzA?x5Zlw{|SLX>7^~1^IAjXR%d~OpU;#<&L z+fmq_wCf?{*^Z)Nl#{7k(MPtTqqd{i*c$!h0@U1R>iiJD#<6q!#5s&@KWG|vRLr2E zef$+MgId9cB#p&>8Xn0X@%Si@kMLOLF?shZ$uyZO$>egPB$x1b9*^mRL?xNd+o)Nv4fmC3!WE2@)mQ$K&-pzM99^@VJA=*YWsz9^b@c2aoMM zPUZ0o9;fiw%Ht#+C-T_BV>6FUJT~xH&tn~r8ISn{oJ_I_c;GQfH6@t@o{~(sRgwwY zN;1(Sl4C~hM=&sgfe{RhU|<9TBN!OLzz7CLFff9F5e$rAU<3mr7#P982nPO#V}MM7 zBYz_p7{R~@2L7!WsJRi_W+Q(i7#M&7=L6dpP!gRAunfVBO?30G7%LO%gu2SMy4G3l z*+uKCiyN96sMx^txlIkeA<}sgyS%KjqNu!R(agem^VAf^Xgip;iRqa(gQ;EYo6=$F ztOVif{?W$MP21EB=C51F|AqI;D+()K`11<3D86ytwg-Rs^Uv=Yn?!V&n|*nCb6eZx z>zZ3vwYAhNue;p6u%x_bR$;}=!iF|qYr`_ZS9f`fufDaernW6~Gc!GS>!~P8pV?AN zJT&q*GzLsJ4xK)dI)Z@_42)pl|0)LHy+)rqux;8k_WI$YG2s2X#gpgzr0D#;1K!_pvzmVsuJ<4W;n*{v z+|S`M8wqD`M850C%v6d%`6GW{9RorAw||GKkFG}*6iT`nOL>|xJ<>}jG4`E_jO_!K zzlZPy?yp4JYJ_dLe;#RfBkaWUFK|^5=!AwuJU@v1R)p7Z|2KrQ5fO-49~a0$Y#2p=MUJHmSilMogl?Lw4IK{$$_M_LoEHzECLg#SRe9bpfG8|h;a zX5d~z_%6!ch2X;dy$G)&?+19+;eHIlLWCTotwh?VxPBkuK7=pud?Ui?xc@b->9`)k z^*Mxl@Xi5*eBAdV6yV;1@FdDC$F&||Dblm>oQC^HaD5YD7s6Y3{siF`oBa|UDB8UjLA>4y-baYrjea0F5Xup%5n2&C5pG8KEy8w$mk|DmpdchX%h>q{g$OkW?FhFc zJcRHZf{YON9QYH#g;0sG3}FL80AVY_lL&u7_yA$t9+XAMLMTUQLAVa#mk19cJd1D; z;W)y0oO5tCLMB29!et1}2!4bgBRqug62eCalm867A(SDsA#@_#hHxLkPK3W896{(u z81(|i48oZRR)h-?G7(A;JP6AW)*#Tx9)(q=j>WNfHk#?#7&exTV+J;!O<+a{&xvdj zo6O8CflXnjF$+7Lox#pziR>&kl}%$w>})ojox`jwnVrkN!&2CJ?0j|so53z*GucHf zm8G$CW@C1i!7^DEb1)~%W-gY)a#HY&BcM znpiVyVOO$N*2a8HU~AbrrmfQWimZ0^>frP2nx^G-t8136u3Ol!rmogogQdGxG@KQg zT3zGwwN}^GVfoj*Ay`yRTv_Ldbn_C9Ag!Y%Os;RAQ9b6aXv^88c;2jt;LSU<~w4DSNpH z-MoBNs2^$)r~Xjsts90&6`BSo4#^k1@*rcZY5?O#kTEKAAk#->wl*&lB3L~t&$l5$ zzJ+rJgB|3y;kz-!*b7&P%wfBMyr^z832UlbTAP>GwY4?3wnf4WW(-T#)^&u&K~sg6 z90h@v)><2dcrBF^?<864T8DhAb;B_4v~C#sjR9oWS|76PkldiY5M+me6pzRq0`wsD z2ENr+w|Yg0mq7T+{+6IgdNV8fR5LBY2xutsf>bjaH zfkZt|5!&iQNt`OYnwHjvX6Q*9s@K%4XG0}J%!ZQrjj*~7svhZ8Xj!FiMAC+ay4AI; zt!@q4YHq9JcR^uFsp$IJn$?1u!D&mW&_&P;Zd#fln}RnG(yM(9EvwbS;YpS9L2^Ew z(mg2M(6oxb#?wgO9{C%=zz7CLF!0}t0ovE3K!3q2-P4{k{pqo1Y(`L@7^BZ6|9JXS zg~4Z-S@~b^dF1*(3j>Akhx>cTFZgpUwTAWT3#NeFg?5(E#zxBd4l`u8-#LkPb? zxE7%Wp$fr`a4|wA!np_*gcHE?UlH~pJd5xs!u<%pM7R^-283%7u15GKeA1Y}CQE z^x*Qs4i$aPn&u{EkA=QXorBrJ$4;lVNO{MSUcig@kE$lk*jLxOhW#;oUtPzZiK(tx z)3y@TlG9UKOm+3_mX<}!TYSY0t5KYN7DE+cA+=0cxe~Uy`sU_U*eO6cz8I*cMH}i~ z(OlhBvj!^$^u4Z?%vUU+BQ=_g8B0(a-EVHNa%9!xt4j^fV{<^nk8nbzNNxD;|X;w`xO} zwPFR~cEkLdHejYJ20632Nh?@@jiS=?U=A#5ZEbF4?3&mGSe}7f z+_sbMi;3ad2vZR?{V}$@rlE}xq^{f;`yrKB$UT~7Hv^OFfzxZL{Q+sqVyMD-4a-_< zS~swwAUwbeR+Zr8pN8vkYYRGdL%5z$n#>A?7TC6764a=&BLW_^Q3fsxV?|8^h|H)f zuWJiY{&B79Cw3m}sajt_(PrvL#Rgc}))Y3hg67Sw8)mT+vE{JN)wI=B z)UBy$sc&w@`21HSh37WGqPK=~*<@;2SW_45-=n$;0TzU&S}ozX8V`l4LaXnvB0i+t zuoKeAc$O8`(GUwhcj*>lcr`Qu6G76l{kqB~)euk{qLDVR*e?jf!)M3NZ7b9Uof{;f zZvQG49*nIU+;y!hnp@Y9-FbGi!29wePML<~t9Sx-xWX7(2=O$l4UO_05_V}(d1=u+ zTe>PwzR7Gg^6q~>24c9PZ-GdO?h74Q#IT1qI2}g|ai7$dm>BjrIjN5PofHF)$J&wa z!A@p1;v&AMIT!nzrFfo;xES~J_k`|WCul`BhOflJ*Ll16qfgo3JYirGfS1r5I4sj^O0iWkgr(p-w}(8*esa4^_ZUst>)X!R{%< z9{$|uR|V=>#FDTFTaR*e$b}sZ&s1|Ou3p}1EuPl#^m%w|4t8+qFB^Nw1MByo4%(A# zz#B~{laAfuB=m~nG#*pWpgZ$-gRl&IYxwsr#@=;I2nU5|tqpJyZdw3cuvLZ~<_fep z8=(ReDZzC;_NOy>+XWaAF&uwB-rFWXy*dIjR8trmMAss~F%$dP^El)s{QU*I)s-AS z^nMT)s!hf4m(^2`o%I;>u^HuC@KzJs5YY?xry#WssRTna=+_EJ>$Im8=;J!PLo`c5 zI@PfTWtz|*AL>a$Pv?MEL@6J3?qhIQ2kxPsQj0ApLs+9-bxi+5q$T04+1T+<(m1FQ z?-K{9tu^6}-d~0`eW;IUo&+qZJ^}F6fyY1)Ho^v#$284b!?qWA=OX;KMZgt=W+ty~ zC32(j*9NbHbsXC^v~v;aDny9Eh$Acnu^%24@Qr}y13Yn%OSo+Vjo<^!3}X70~?GxJ#H7n$~~vMgWLrmRP^ z;vLU8K5%^E_^$I7=N-;RoPTwG;f&2bJv%MikzJ7eo9w5vcW1wqeI$Fl>kOC8wc6F` zy5990*CE#zE?v&_oXt7k&)JdlM$Vy}QMtC%>bldq?yvo(zm83 z+nl!bwwrCE?33)%>=)W++n3tEYroaL)&8daef#J3xQxt6 z>&%BUpU!*^a2vBy9d3u{c+nv{Qk`CBqw_&$w{xE}H~ZG?JF>TD|0BCNr!(idoXNRG zxj)E#2t7WLdqJKn?~=TS@+|qY@*DFvBs_F(!H+g#g9 zyJ-KB{Vw|->|OR}?0f9{><8@su*>%M?8oh&+2b<|8K-5OmvK>s4ct+fQJZ;7<};aR zXSIMI%#JL_amQ4r&H1?VpUz_N<@v65*MqKIt}!_;<`{BM%T3CCBzG;a_Jh0^^Lq1Q z^C#!0<>%$k&A*p$bp>pjxD=-PQtwL5OS>n{n0`@uUi$p>Md>x^Ytw&`UTC}Dw%7JI z+k3W8fVxQcV`&3QQIA2|uR8M$xf>hkn?hCEZ=FY+GE z`#5i6zBRut|0U{Q3+#lr7*qYJ&!oPT`nOa$^^4RQX{~AF)6Ym>kiHC*eZaQg_7B@< zwmka+`zrhQ?Kj!a%gD{B%vhIkt2T}%XD-gXDf5NQwHQZ%tPithI(&`_(D3`t$=PRQ zPsfP9Ec@Q*@)Po>0fVLa z>>A!Zc5&*RsrRLRmTF7CJbk<^*XFkU(Dn-b9+hpr-EV)?{scxc%bbFUfc3d-7N13;9>&Z_2+FlH%$7z4>qC|DAAg z6X+C!eTvkHsnb)lQx~KzOua0%HFX_u^P|+Crrw?UaOxAOFQy(&jY%7wc1Buu+NEip zw5qgg(*kKXr~M@DuC(8#J)ZWLw71hvq?M(&r|(QZk*>3iwV7;FY>BpWZ0Fn3Yz|w# zt=Kl-R%u&mtFv8cyUMo7)@i%ZcAIUh?LON>wjH+Jwij$K+xl!D*gnN?`i!?*>{IP& z;EFQ)O8X{o@lN}5_9GZkri>{W+cKWWcmdGIWRA{k%JgMkm3d9(4>SLe`9Wp^WXQ~{ z%&feuOS0NPm1`m2ZU)cXm32?nZ?f*s`p>M#v!2e{mG$SWm$F{VI+*o#){(3avih@5 zWa%7Z9VW*VN1|i8BgHY(VRvLZ3LM3bd5&_(p(;nMqtVggSnIeNGV(gd4O~v%4IccR z;{gY7ct2m;F@x=vjN3AfWE{=t%6&ceARIH3@(S{<$h#)*?z~^;{Vs1;-l04>59JTS S9*;{>sx=jtk-z`J82EocyWblC literal 0 HcmV?d00001 diff --git a/external/pthreads-w32/include/pthread.h b/external/pthreads-w32/include/pthread.h new file mode 100644 index 00000000..436ea8b6 --- /dev/null +++ b/external/pthreads-w32/include/pthread.h @@ -0,0 +1,1368 @@ +/* This is an implementation of the threads API of POSIX 1003.1-2001. + * + * -------------------------------------------------------------------------- + * + * Pthreads-win32 - POSIX Threads Library for Win32 + * Copyright(C) 1998 John E. Bossom + * Copyright(C) 1999,2005 Pthreads-win32 contributors + * + * Contact Email: rpj@callisto.canberra.edu.au + * + * The current list of contributors is contained + * in the file CONTRIBUTORS included with the source + * code distribution. The list can also be seen at the + * following World Wide Web location: + * http://sources.redhat.com/pthreads-win32/contributors.html + * + * This library is free software; you can redistribute it and/or + * modify it under the terms of the GNU Lesser General Public + * License as published by the Free Software Foundation; either + * version 2 of the License, or (at your option) any later version. + * + * This library is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + * Lesser General Public License for more details. + * + * You should have received a copy of the GNU Lesser General Public + * License along with this library in the file COPYING.LIB; + * if not, write to the Free Software Foundation, Inc., + * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA + */ + +#if !defined( PTHREAD_H ) +#define PTHREAD_H + +/* + * See the README file for an explanation of the pthreads-win32 version + * numbering scheme and how the DLL is named etc. + */ +#define PTW32_VERSION 2,9,1,0 +#define PTW32_VERSION_STRING "2, 9, 1, 0\0" + +/* There are three implementations of cancel cleanup. + * Note that pthread.h is included in both application + * compilation units and also internally for the library. + * The code here and within the library aims to work + * for all reasonable combinations of environments. + * + * The three implementations are: + * + * WIN32 SEH + * C + * C++ + * + * Please note that exiting a push/pop block via + * "return", "exit", "break", or "continue" will + * lead to different behaviour amongst applications + * depending upon whether the library was built + * using SEH, C++, or C. For example, a library built + * with SEH will call the cleanup routine, while both + * C++ and C built versions will not. + */ + +/* + * Define defaults for cleanup code. + * Note: Unless the build explicitly defines one of the following, then + * we default to standard C style cleanup. This style uses setjmp/longjmp + * in the cancelation and thread exit implementations and therefore won't + * do stack unwinding if linked to applications that have it (e.g. + * C++ apps). This is currently consistent with most/all commercial Unix + * POSIX threads implementations. + */ +#if !defined( __CLEANUP_SEH ) && !defined( __CLEANUP_CXX ) && !defined( __CLEANUP_C ) +# define __CLEANUP_C +#endif + +#if defined( __CLEANUP_SEH ) && ( !defined( _MSC_VER ) && !defined(PTW32_RC_MSC)) +#error ERROR [__FILE__, line __LINE__]: SEH is not supported for this compiler. +#endif + +/* + * Stop here if we are being included by the resource compiler. + */ +#if !defined(RC_INVOKED) + +#undef PTW32_LEVEL + +#if defined(_POSIX_SOURCE) +#define PTW32_LEVEL 0 +/* Early POSIX */ +#endif + +#if defined(_POSIX_C_SOURCE) && _POSIX_C_SOURCE >= 199309 +#undef PTW32_LEVEL +#define PTW32_LEVEL 1 +/* Include 1b, 1c and 1d */ +#endif + +#if defined(INCLUDE_NP) +#undef PTW32_LEVEL +#define PTW32_LEVEL 2 +/* Include Non-Portable extensions */ +#endif + +#define PTW32_LEVEL_MAX 3 + +#if ( defined(_POSIX_C_SOURCE) && _POSIX_C_SOURCE >= 200112 ) || !defined(PTW32_LEVEL) +#define PTW32_LEVEL PTW32_LEVEL_MAX +/* Include everything */ +#endif + +#if defined(_UWIN) +# define HAVE_STRUCT_TIMESPEC 1 +# define HAVE_SIGNAL_H 1 +# undef HAVE_PTW32_CONFIG_H +# pragma comment(lib, "pthread") +#endif + +/* + * ------------------------------------------------------------- + * + * + * Module: pthread.h + * + * Purpose: + * Provides an implementation of PThreads based upon the + * standard: + * + * POSIX 1003.1-2001 + * and + * The Single Unix Specification version 3 + * + * (these two are equivalent) + * + * in order to enhance code portability between Windows, + * various commercial Unix implementations, and Linux. + * + * See the ANNOUNCE file for a full list of conforming + * routines and defined constants, and a list of missing + * routines and constants not defined in this implementation. + * + * Authors: + * There have been many contributors to this library. + * The initial implementation was contributed by + * John Bossom, and several others have provided major + * sections or revisions of parts of the implementation. + * Often significant effort has been contributed to + * find and fix important bugs and other problems to + * improve the reliability of the library, which sometimes + * is not reflected in the amount of code which changed as + * result. + * As much as possible, the contributors are acknowledged + * in the ChangeLog file in the source code distribution + * where their changes are noted in detail. + * + * Contributors are listed in the CONTRIBUTORS file. + * + * As usual, all bouquets go to the contributors, and all + * brickbats go to the project maintainer. + * + * Maintainer: + * The code base for this project is coordinated and + * eventually pre-tested, packaged, and made available by + * + * Ross Johnson + * + * QA Testers: + * Ultimately, the library is tested in the real world by + * a host of competent and demanding scientists and + * engineers who report bugs and/or provide solutions + * which are then fixed or incorporated into subsequent + * versions of the library. Each time a bug is fixed, a + * test case is written to prove the fix and ensure + * that later changes to the code don't reintroduce the + * same error. The number of test cases is slowly growing + * and therefore so is the code reliability. + * + * Compliance: + * See the file ANNOUNCE for the list of implemented + * and not-implemented routines and defined options. + * Of course, these are all defined is this file as well. + * + * Web site: + * The source code and other information about this library + * are available from + * + * http://sources.redhat.com/pthreads-win32/ + * + * ------------------------------------------------------------- + */ + +/* Try to avoid including windows.h */ +#if (defined(__MINGW64__) || defined(__MINGW32__)) && defined(__cplusplus) +#define PTW32_INCLUDE_WINDOWS_H +#endif + +#if defined(PTW32_INCLUDE_WINDOWS_H) +#include +#endif + +#if defined(_MSC_VER) && _MSC_VER < 1300 || defined(__DMC__) +/* + * VC++6.0 or early compiler's header has no DWORD_PTR type. + */ +typedef unsigned long DWORD_PTR; +typedef unsigned long ULONG_PTR; +#endif +/* + * ----------------- + * autoconf switches + * ----------------- + */ + +#if defined(HAVE_PTW32_CONFIG_H) +#include "config.h" +#endif /* HAVE_PTW32_CONFIG_H */ + +#if !defined(NEED_FTIME) +#include +#else /* NEED_FTIME */ +/* use native WIN32 time API */ +#endif /* NEED_FTIME */ + +#if defined(HAVE_SIGNAL_H) +#include +#endif /* HAVE_SIGNAL_H */ + +#include + +/* + * Boolean values to make us independent of system includes. + */ +enum { + PTW32_FALSE = 0, + PTW32_TRUE = (! PTW32_FALSE) +}; + +/* + * This is a duplicate of what is in the autoconf config.h, + * which is only used when building the pthread-win32 libraries. + */ + +#if !defined(PTW32_CONFIG_H) +# if defined(WINCE) +# define NEED_ERRNO +# define NEED_SEM +# endif +# if defined(__MINGW64__) +# define HAVE_STRUCT_TIMESPEC +# define HAVE_MODE_T +# elif defined(_UWIN) || defined(__MINGW32__) +# define HAVE_MODE_T +# endif +#endif + +/* + * + */ + +#if PTW32_LEVEL >= PTW32_LEVEL_MAX +#if defined(NEED_ERRNO) +#include "need_errno.h" +#else +#include +#endif +#endif /* PTW32_LEVEL >= PTW32_LEVEL_MAX */ + +/* + * Several systems don't define some error numbers. + */ +#if !defined(ENOTSUP) +# define ENOTSUP 48 /* This is the value in Solaris. */ +#endif + +#if !defined(ETIMEDOUT) +# define ETIMEDOUT 10060 /* Same as WSAETIMEDOUT */ +#endif + +#if !defined(ENOSYS) +# define ENOSYS 140 /* Semi-arbitrary value */ +#endif + +#if !defined(EDEADLK) +# if defined(EDEADLOCK) +# define EDEADLK EDEADLOCK +# else +# define EDEADLK 36 /* This is the value in MSVC. */ +# endif +#endif + +/* POSIX 2008 - related to robust mutexes */ +#if !defined(EOWNERDEAD) +# define EOWNERDEAD 43 +#endif +#if !defined(ENOTRECOVERABLE) +# define ENOTRECOVERABLE 44 +#endif + +#include + +/* + * To avoid including windows.h we define only those things that we + * actually need from it. + */ +#if !defined(PTW32_INCLUDE_WINDOWS_H) +#if !defined(HANDLE) +# define PTW32__HANDLE_DEF +# define HANDLE void * +#endif +#if !defined(DWORD) +# define PTW32__DWORD_DEF +# define DWORD unsigned long +#endif +#endif + +#if !defined(HAVE_STRUCT_TIMESPEC) +#define HAVE_STRUCT_TIMESPEC +#if !defined(_TIMESPEC_DEFINED) +#define _TIMESPEC_DEFINED +struct timespec { + time_t tv_sec; + long tv_nsec; +}; +#endif /* _TIMESPEC_DEFINED */ +#endif /* HAVE_STRUCT_TIMESPEC */ + +#if !defined(SIG_BLOCK) +#define SIG_BLOCK 0 +#endif /* SIG_BLOCK */ + +#if !defined(SIG_UNBLOCK) +#define SIG_UNBLOCK 1 +#endif /* SIG_UNBLOCK */ + +#if !defined(SIG_SETMASK) +#define SIG_SETMASK 2 +#endif /* SIG_SETMASK */ + +#if defined(__cplusplus) +extern "C" +{ +#endif /* __cplusplus */ + +/* + * ------------------------------------------------------------- + * + * POSIX 1003.1-2001 Options + * ========================= + * + * Options are normally set in , which is not provided + * with pthreads-win32. + * + * For conformance with the Single Unix Specification (version 3), all of the + * options below are defined, and have a value of either -1 (not supported) + * or 200112L (supported). + * + * These options can neither be left undefined nor have a value of 0, because + * either indicates that sysconf(), which is not implemented, may be used at + * runtime to check the status of the option. + * + * _POSIX_THREADS (== 200112L) + * If == 200112L, you can use threads + * + * _POSIX_THREAD_ATTR_STACKSIZE (== 200112L) + * If == 200112L, you can control the size of a thread's + * stack + * pthread_attr_getstacksize + * pthread_attr_setstacksize + * + * _POSIX_THREAD_ATTR_STACKADDR (== -1) + * If == 200112L, you can allocate and control a thread's + * stack. If not supported, the following functions + * will return ENOSYS, indicating they are not + * supported: + * pthread_attr_getstackaddr + * pthread_attr_setstackaddr + * + * _POSIX_THREAD_PRIORITY_SCHEDULING (== -1) + * If == 200112L, you can use realtime scheduling. + * This option indicates that the behaviour of some + * implemented functions conforms to the additional TPS + * requirements in the standard. E.g. rwlocks favour + * writers over readers when threads have equal priority. + * + * _POSIX_THREAD_PRIO_INHERIT (== -1) + * If == 200112L, you can create priority inheritance + * mutexes. + * pthread_mutexattr_getprotocol + + * pthread_mutexattr_setprotocol + + * + * _POSIX_THREAD_PRIO_PROTECT (== -1) + * If == 200112L, you can create priority ceiling mutexes + * Indicates the availability of: + * pthread_mutex_getprioceiling + * pthread_mutex_setprioceiling + * pthread_mutexattr_getprioceiling + * pthread_mutexattr_getprotocol + + * pthread_mutexattr_setprioceiling + * pthread_mutexattr_setprotocol + + * + * _POSIX_THREAD_PROCESS_SHARED (== -1) + * If set, you can create mutexes and condition + * variables that can be shared with another + * process.If set, indicates the availability + * of: + * pthread_mutexattr_getpshared + * pthread_mutexattr_setpshared + * pthread_condattr_getpshared + * pthread_condattr_setpshared + * + * _POSIX_THREAD_SAFE_FUNCTIONS (== 200112L) + * If == 200112L you can use the special *_r library + * functions that provide thread-safe behaviour + * + * _POSIX_READER_WRITER_LOCKS (== 200112L) + * If == 200112L, you can use read/write locks + * + * _POSIX_SPIN_LOCKS (== 200112L) + * If == 200112L, you can use spin locks + * + * _POSIX_BARRIERS (== 200112L) + * If == 200112L, you can use barriers + * + * + These functions provide both 'inherit' and/or + * 'protect' protocol, based upon these macro + * settings. + * + * ------------------------------------------------------------- + */ + +/* + * POSIX Options + */ +#undef _POSIX_THREADS +#define _POSIX_THREADS 200809L + +#undef _POSIX_READER_WRITER_LOCKS +#define _POSIX_READER_WRITER_LOCKS 200809L + +#undef _POSIX_SPIN_LOCKS +#define _POSIX_SPIN_LOCKS 200809L + +#undef _POSIX_BARRIERS +#define _POSIX_BARRIERS 200809L + +#undef _POSIX_THREAD_SAFE_FUNCTIONS +#define _POSIX_THREAD_SAFE_FUNCTIONS 200809L + +#undef _POSIX_THREAD_ATTR_STACKSIZE +#define _POSIX_THREAD_ATTR_STACKSIZE 200809L + +/* + * The following options are not supported + */ +#undef _POSIX_THREAD_ATTR_STACKADDR +#define _POSIX_THREAD_ATTR_STACKADDR -1 + +#undef _POSIX_THREAD_PRIO_INHERIT +#define _POSIX_THREAD_PRIO_INHERIT -1 + +#undef _POSIX_THREAD_PRIO_PROTECT +#define _POSIX_THREAD_PRIO_PROTECT -1 + +/* TPS is not fully supported. */ +#undef _POSIX_THREAD_PRIORITY_SCHEDULING +#define _POSIX_THREAD_PRIORITY_SCHEDULING -1 + +#undef _POSIX_THREAD_PROCESS_SHARED +#define _POSIX_THREAD_PROCESS_SHARED -1 + + +/* + * POSIX 1003.1-2001 Limits + * =========================== + * + * These limits are normally set in , which is not provided with + * pthreads-win32. + * + * PTHREAD_DESTRUCTOR_ITERATIONS + * Maximum number of attempts to destroy + * a thread's thread-specific data on + * termination (must be at least 4) + * + * PTHREAD_KEYS_MAX + * Maximum number of thread-specific data keys + * available per process (must be at least 128) + * + * PTHREAD_STACK_MIN + * Minimum supported stack size for a thread + * + * PTHREAD_THREADS_MAX + * Maximum number of threads supported per + * process (must be at least 64). + * + * SEM_NSEMS_MAX + * The maximum number of semaphores a process can have. + * (must be at least 256) + * + * SEM_VALUE_MAX + * The maximum value a semaphore can have. + * (must be at least 32767) + * + */ +#undef _POSIX_THREAD_DESTRUCTOR_ITERATIONS +#define _POSIX_THREAD_DESTRUCTOR_ITERATIONS 4 + +#undef PTHREAD_DESTRUCTOR_ITERATIONS +#define PTHREAD_DESTRUCTOR_ITERATIONS _POSIX_THREAD_DESTRUCTOR_ITERATIONS + +#undef _POSIX_THREAD_KEYS_MAX +#define _POSIX_THREAD_KEYS_MAX 128 + +#undef PTHREAD_KEYS_MAX +#define PTHREAD_KEYS_MAX _POSIX_THREAD_KEYS_MAX + +#undef PTHREAD_STACK_MIN +#define PTHREAD_STACK_MIN 0 + +#undef _POSIX_THREAD_THREADS_MAX +#define _POSIX_THREAD_THREADS_MAX 64 + + /* Arbitrary value */ +#undef PTHREAD_THREADS_MAX +#define PTHREAD_THREADS_MAX 2019 + +#undef _POSIX_SEM_NSEMS_MAX +#define _POSIX_SEM_NSEMS_MAX 256 + + /* Arbitrary value */ +#undef SEM_NSEMS_MAX +#define SEM_NSEMS_MAX 1024 + +#undef _POSIX_SEM_VALUE_MAX +#define _POSIX_SEM_VALUE_MAX 32767 + +#undef SEM_VALUE_MAX +#define SEM_VALUE_MAX INT_MAX + + +#if defined(__GNUC__) && !defined(__declspec) +# error Please upgrade your GNU compiler to one that supports __declspec. +#endif + +/* + * When building the library, you should define PTW32_BUILD so that + * the variables/functions are exported correctly. When using the library, + * do NOT define PTW32_BUILD, and then the variables/functions will + * be imported correctly. + */ +#if !defined(PTW32_STATIC_LIB) +# if defined(PTW32_BUILD) +# define PTW32_DLLPORT __declspec (dllexport) +# else +# define PTW32_DLLPORT __declspec (dllimport) +# endif +#else +# define PTW32_DLLPORT +#endif + +/* + * The Open Watcom C/C++ compiler uses a non-standard calling convention + * that passes function args in registers unless __cdecl is explicitly specified + * in exposed function prototypes. + * + * We force all calls to cdecl even though this could slow Watcom code down + * slightly. If you know that the Watcom compiler will be used to build both + * the DLL and application, then you can probably define this as a null string. + * Remember that pthread.h (this file) is used for both the DLL and application builds. + */ +#define PTW32_CDECL __cdecl + +#if defined(_UWIN) && PTW32_LEVEL >= PTW32_LEVEL_MAX +# include +#else +/* + * Generic handle type - intended to extend uniqueness beyond + * that available with a simple pointer. It should scale for either + * IA-32 or IA-64. + */ +typedef struct { + void * p; /* Pointer to actual object */ + unsigned int x; /* Extra information - reuse count etc */ +} ptw32_handle_t; + +typedef ptw32_handle_t pthread_t; +typedef struct pthread_attr_t_ * pthread_attr_t; +typedef struct pthread_once_t_ pthread_once_t; +typedef struct pthread_key_t_ * pthread_key_t; +typedef struct pthread_mutex_t_ * pthread_mutex_t; +typedef struct pthread_mutexattr_t_ * pthread_mutexattr_t; +typedef struct pthread_cond_t_ * pthread_cond_t; +typedef struct pthread_condattr_t_ * pthread_condattr_t; +#endif +typedef struct pthread_rwlock_t_ * pthread_rwlock_t; +typedef struct pthread_rwlockattr_t_ * pthread_rwlockattr_t; +typedef struct pthread_spinlock_t_ * pthread_spinlock_t; +typedef struct pthread_barrier_t_ * pthread_barrier_t; +typedef struct pthread_barrierattr_t_ * pthread_barrierattr_t; + +/* + * ==================== + * ==================== + * POSIX Threads + * ==================== + * ==================== + */ + +enum { +/* + * pthread_attr_{get,set}detachstate + */ + PTHREAD_CREATE_JOINABLE = 0, /* Default */ + PTHREAD_CREATE_DETACHED = 1, + +/* + * pthread_attr_{get,set}inheritsched + */ + PTHREAD_INHERIT_SCHED = 0, + PTHREAD_EXPLICIT_SCHED = 1, /* Default */ + +/* + * pthread_{get,set}scope + */ + PTHREAD_SCOPE_PROCESS = 0, + PTHREAD_SCOPE_SYSTEM = 1, /* Default */ + +/* + * pthread_setcancelstate paramters + */ + PTHREAD_CANCEL_ENABLE = 0, /* Default */ + PTHREAD_CANCEL_DISABLE = 1, + +/* + * pthread_setcanceltype parameters + */ + PTHREAD_CANCEL_ASYNCHRONOUS = 0, + PTHREAD_CANCEL_DEFERRED = 1, /* Default */ + +/* + * pthread_mutexattr_{get,set}pshared + * pthread_condattr_{get,set}pshared + */ + PTHREAD_PROCESS_PRIVATE = 0, + PTHREAD_PROCESS_SHARED = 1, + +/* + * pthread_mutexattr_{get,set}robust + */ + PTHREAD_MUTEX_STALLED = 0, /* Default */ + PTHREAD_MUTEX_ROBUST = 1, + +/* + * pthread_barrier_wait + */ + PTHREAD_BARRIER_SERIAL_THREAD = -1 +}; + +/* + * ==================== + * ==================== + * Cancelation + * ==================== + * ==================== + */ +#define PTHREAD_CANCELED ((void *)(size_t) -1) + + +/* + * ==================== + * ==================== + * Once Key + * ==================== + * ==================== + */ +#define PTHREAD_ONCE_INIT { PTW32_FALSE, 0, 0, 0} + +struct pthread_once_t_ +{ + int done; /* indicates if user function has been executed */ + void * lock; + int reserved1; + int reserved2; +}; + + +/* + * ==================== + * ==================== + * Object initialisers + * ==================== + * ==================== + */ +#define PTHREAD_MUTEX_INITIALIZER ((pthread_mutex_t)(size_t) -1) +#define PTHREAD_RECURSIVE_MUTEX_INITIALIZER ((pthread_mutex_t)(size_t) -2) +#define PTHREAD_ERRORCHECK_MUTEX_INITIALIZER ((pthread_mutex_t)(size_t) -3) + +/* + * Compatibility with LinuxThreads + */ +#define PTHREAD_RECURSIVE_MUTEX_INITIALIZER_NP PTHREAD_RECURSIVE_MUTEX_INITIALIZER +#define PTHREAD_ERRORCHECK_MUTEX_INITIALIZER_NP PTHREAD_ERRORCHECK_MUTEX_INITIALIZER + +#define PTHREAD_COND_INITIALIZER ((pthread_cond_t)(size_t) -1) + +#define PTHREAD_RWLOCK_INITIALIZER ((pthread_rwlock_t)(size_t) -1) + +#define PTHREAD_SPINLOCK_INITIALIZER ((pthread_spinlock_t)(size_t) -1) + + +/* + * Mutex types. + */ +enum +{ + /* Compatibility with LinuxThreads */ + PTHREAD_MUTEX_FAST_NP, + PTHREAD_MUTEX_RECURSIVE_NP, + PTHREAD_MUTEX_ERRORCHECK_NP, + PTHREAD_MUTEX_TIMED_NP = PTHREAD_MUTEX_FAST_NP, + PTHREAD_MUTEX_ADAPTIVE_NP = PTHREAD_MUTEX_FAST_NP, + /* For compatibility with POSIX */ + PTHREAD_MUTEX_NORMAL = PTHREAD_MUTEX_FAST_NP, + PTHREAD_MUTEX_RECURSIVE = PTHREAD_MUTEX_RECURSIVE_NP, + PTHREAD_MUTEX_ERRORCHECK = PTHREAD_MUTEX_ERRORCHECK_NP, + PTHREAD_MUTEX_DEFAULT = PTHREAD_MUTEX_NORMAL +}; + + +typedef struct ptw32_cleanup_t ptw32_cleanup_t; + +#if defined(_MSC_VER) +/* Disable MSVC 'anachronism used' warning */ +#pragma warning( disable : 4229 ) +#endif + +typedef void (* PTW32_CDECL ptw32_cleanup_callback_t)(void *); + +#if defined(_MSC_VER) +#pragma warning( default : 4229 ) +#endif + +struct ptw32_cleanup_t +{ + ptw32_cleanup_callback_t routine; + void *arg; + struct ptw32_cleanup_t *prev; +}; + +#if defined(__CLEANUP_SEH) + /* + * WIN32 SEH version of cancel cleanup. + */ + +#define pthread_cleanup_push( _rout, _arg ) \ + { \ + ptw32_cleanup_t _cleanup; \ + \ + _cleanup.routine = (ptw32_cleanup_callback_t)(_rout); \ + _cleanup.arg = (_arg); \ + __try \ + { \ + +#define pthread_cleanup_pop( _execute ) \ + } \ + __finally \ + { \ + if( _execute || AbnormalTermination()) \ + { \ + (*(_cleanup.routine))( _cleanup.arg ); \ + } \ + } \ + } + +#else /* __CLEANUP_SEH */ + +#if defined(__CLEANUP_C) + + /* + * C implementation of PThreads cancel cleanup + */ + +#define pthread_cleanup_push( _rout, _arg ) \ + { \ + ptw32_cleanup_t _cleanup; \ + \ + ptw32_push_cleanup( &_cleanup, (ptw32_cleanup_callback_t) (_rout), (_arg) ); \ + +#define pthread_cleanup_pop( _execute ) \ + (void) ptw32_pop_cleanup( _execute ); \ + } + +#else /* __CLEANUP_C */ + +#if defined(__CLEANUP_CXX) + + /* + * C++ version of cancel cleanup. + * - John E. Bossom. + */ + + class PThreadCleanup { + /* + * PThreadCleanup + * + * Purpose + * This class is a C++ helper class that is + * used to implement pthread_cleanup_push/ + * pthread_cleanup_pop. + * The destructor of this class automatically + * pops the pushed cleanup routine regardless + * of how the code exits the scope + * (i.e. such as by an exception) + */ + ptw32_cleanup_callback_t cleanUpRout; + void * obj; + int executeIt; + + public: + PThreadCleanup() : + cleanUpRout( 0 ), + obj( 0 ), + executeIt( 0 ) + /* + * No cleanup performed + */ + { + } + + PThreadCleanup( + ptw32_cleanup_callback_t routine, + void * arg ) : + cleanUpRout( routine ), + obj( arg ), + executeIt( 1 ) + /* + * Registers a cleanup routine for 'arg' + */ + { + } + + ~PThreadCleanup() + { + if ( executeIt && ((void *) cleanUpRout != (void *) 0) ) + { + (void) (*cleanUpRout)( obj ); + } + } + + void execute( int exec ) + { + executeIt = exec; + } + }; + + /* + * C++ implementation of PThreads cancel cleanup; + * This implementation takes advantage of a helper + * class who's destructor automatically calls the + * cleanup routine if we exit our scope weirdly + */ +#define pthread_cleanup_push( _rout, _arg ) \ + { \ + PThreadCleanup cleanup((ptw32_cleanup_callback_t)(_rout), \ + (void *) (_arg) ); + +#define pthread_cleanup_pop( _execute ) \ + cleanup.execute( _execute ); \ + } + +#else + +#error ERROR [__FILE__, line __LINE__]: Cleanup type undefined. + +#endif /* __CLEANUP_CXX */ + +#endif /* __CLEANUP_C */ + +#endif /* __CLEANUP_SEH */ + +/* + * =============== + * =============== + * Methods + * =============== + * =============== + */ + +/* + * PThread Attribute Functions + */ +PTW32_DLLPORT int PTW32_CDECL pthread_attr_init (pthread_attr_t * attr); + +PTW32_DLLPORT int PTW32_CDECL pthread_attr_destroy (pthread_attr_t * attr); + +PTW32_DLLPORT int PTW32_CDECL pthread_attr_getdetachstate (const pthread_attr_t * attr, + int *detachstate); + +PTW32_DLLPORT int PTW32_CDECL pthread_attr_getstackaddr (const pthread_attr_t * attr, + void **stackaddr); + +PTW32_DLLPORT int PTW32_CDECL pthread_attr_getstacksize (const pthread_attr_t * attr, + size_t * stacksize); + +PTW32_DLLPORT int PTW32_CDECL pthread_attr_setdetachstate (pthread_attr_t * attr, + int detachstate); + +PTW32_DLLPORT int PTW32_CDECL pthread_attr_setstackaddr (pthread_attr_t * attr, + void *stackaddr); + +PTW32_DLLPORT int PTW32_CDECL pthread_attr_setstacksize (pthread_attr_t * attr, + size_t stacksize); + +PTW32_DLLPORT int PTW32_CDECL pthread_attr_getschedparam (const pthread_attr_t *attr, + struct sched_param *param); + +PTW32_DLLPORT int PTW32_CDECL pthread_attr_setschedparam (pthread_attr_t *attr, + const struct sched_param *param); + +PTW32_DLLPORT int PTW32_CDECL pthread_attr_setschedpolicy (pthread_attr_t *, + int); + +PTW32_DLLPORT int PTW32_CDECL pthread_attr_getschedpolicy (const pthread_attr_t *, + int *); + +PTW32_DLLPORT int PTW32_CDECL pthread_attr_setinheritsched(pthread_attr_t * attr, + int inheritsched); + +PTW32_DLLPORT int PTW32_CDECL pthread_attr_getinheritsched(const pthread_attr_t * attr, + int * inheritsched); + +PTW32_DLLPORT int PTW32_CDECL pthread_attr_setscope (pthread_attr_t *, + int); + +PTW32_DLLPORT int PTW32_CDECL pthread_attr_getscope (const pthread_attr_t *, + int *); + +/* + * PThread Functions + */ +PTW32_DLLPORT int PTW32_CDECL pthread_create (pthread_t * tid, + const pthread_attr_t * attr, + void *(PTW32_CDECL *start) (void *), + void *arg); + +PTW32_DLLPORT int PTW32_CDECL pthread_detach (pthread_t tid); + +PTW32_DLLPORT int PTW32_CDECL pthread_equal (pthread_t t1, + pthread_t t2); + +PTW32_DLLPORT void PTW32_CDECL pthread_exit (void *value_ptr); + +PTW32_DLLPORT int PTW32_CDECL pthread_join (pthread_t thread, + void **value_ptr); + +PTW32_DLLPORT pthread_t PTW32_CDECL pthread_self (void); + +PTW32_DLLPORT int PTW32_CDECL pthread_cancel (pthread_t thread); + +PTW32_DLLPORT int PTW32_CDECL pthread_setcancelstate (int state, + int *oldstate); + +PTW32_DLLPORT int PTW32_CDECL pthread_setcanceltype (int type, + int *oldtype); + +PTW32_DLLPORT void PTW32_CDECL pthread_testcancel (void); + +PTW32_DLLPORT int PTW32_CDECL pthread_once (pthread_once_t * once_control, + void (PTW32_CDECL *init_routine) (void)); + +#if PTW32_LEVEL >= PTW32_LEVEL_MAX +PTW32_DLLPORT ptw32_cleanup_t * PTW32_CDECL ptw32_pop_cleanup (int execute); + +PTW32_DLLPORT void PTW32_CDECL ptw32_push_cleanup (ptw32_cleanup_t * cleanup, + ptw32_cleanup_callback_t routine, + void *arg); +#endif /* PTW32_LEVEL >= PTW32_LEVEL_MAX */ + +/* + * Thread Specific Data Functions + */ +PTW32_DLLPORT int PTW32_CDECL pthread_key_create (pthread_key_t * key, + void (PTW32_CDECL *destructor) (void *)); + +PTW32_DLLPORT int PTW32_CDECL pthread_key_delete (pthread_key_t key); + +PTW32_DLLPORT int PTW32_CDECL pthread_setspecific (pthread_key_t key, + const void *value); + +PTW32_DLLPORT void * PTW32_CDECL pthread_getspecific (pthread_key_t key); + + +/* + * Mutex Attribute Functions + */ +PTW32_DLLPORT int PTW32_CDECL pthread_mutexattr_init (pthread_mutexattr_t * attr); + +PTW32_DLLPORT int PTW32_CDECL pthread_mutexattr_destroy (pthread_mutexattr_t * attr); + +PTW32_DLLPORT int PTW32_CDECL pthread_mutexattr_getpshared (const pthread_mutexattr_t + * attr, + int *pshared); + +PTW32_DLLPORT int PTW32_CDECL pthread_mutexattr_setpshared (pthread_mutexattr_t * attr, + int pshared); + +PTW32_DLLPORT int PTW32_CDECL pthread_mutexattr_settype (pthread_mutexattr_t * attr, int kind); +PTW32_DLLPORT int PTW32_CDECL pthread_mutexattr_gettype (const pthread_mutexattr_t * attr, int *kind); + +PTW32_DLLPORT int PTW32_CDECL pthread_mutexattr_setrobust( + pthread_mutexattr_t *attr, + int robust); +PTW32_DLLPORT int PTW32_CDECL pthread_mutexattr_getrobust( + const pthread_mutexattr_t * attr, + int * robust); + +/* + * Barrier Attribute Functions + */ +PTW32_DLLPORT int PTW32_CDECL pthread_barrierattr_init (pthread_barrierattr_t * attr); + +PTW32_DLLPORT int PTW32_CDECL pthread_barrierattr_destroy (pthread_barrierattr_t * attr); + +PTW32_DLLPORT int PTW32_CDECL pthread_barrierattr_getpshared (const pthread_barrierattr_t + * attr, + int *pshared); + +PTW32_DLLPORT int PTW32_CDECL pthread_barrierattr_setpshared (pthread_barrierattr_t * attr, + int pshared); + +/* + * Mutex Functions + */ +PTW32_DLLPORT int PTW32_CDECL pthread_mutex_init (pthread_mutex_t * mutex, + const pthread_mutexattr_t * attr); + +PTW32_DLLPORT int PTW32_CDECL pthread_mutex_destroy (pthread_mutex_t * mutex); + +PTW32_DLLPORT int PTW32_CDECL pthread_mutex_lock (pthread_mutex_t * mutex); + +PTW32_DLLPORT int PTW32_CDECL pthread_mutex_timedlock(pthread_mutex_t * mutex, + const struct timespec *abstime); + +PTW32_DLLPORT int PTW32_CDECL pthread_mutex_trylock (pthread_mutex_t * mutex); + +PTW32_DLLPORT int PTW32_CDECL pthread_mutex_unlock (pthread_mutex_t * mutex); + +PTW32_DLLPORT int PTW32_CDECL pthread_mutex_consistent (pthread_mutex_t * mutex); + +/* + * Spinlock Functions + */ +PTW32_DLLPORT int PTW32_CDECL pthread_spin_init (pthread_spinlock_t * lock, int pshared); + +PTW32_DLLPORT int PTW32_CDECL pthread_spin_destroy (pthread_spinlock_t * lock); + +PTW32_DLLPORT int PTW32_CDECL pthread_spin_lock (pthread_spinlock_t * lock); + +PTW32_DLLPORT int PTW32_CDECL pthread_spin_trylock (pthread_spinlock_t * lock); + +PTW32_DLLPORT int PTW32_CDECL pthread_spin_unlock (pthread_spinlock_t * lock); + +/* + * Barrier Functions + */ +PTW32_DLLPORT int PTW32_CDECL pthread_barrier_init (pthread_barrier_t * barrier, + const pthread_barrierattr_t * attr, + unsigned int count); + +PTW32_DLLPORT int PTW32_CDECL pthread_barrier_destroy (pthread_barrier_t * barrier); + +PTW32_DLLPORT int PTW32_CDECL pthread_barrier_wait (pthread_barrier_t * barrier); + +/* + * Condition Variable Attribute Functions + */ +PTW32_DLLPORT int PTW32_CDECL pthread_condattr_init (pthread_condattr_t * attr); + +PTW32_DLLPORT int PTW32_CDECL pthread_condattr_destroy (pthread_condattr_t * attr); + +PTW32_DLLPORT int PTW32_CDECL pthread_condattr_getpshared (const pthread_condattr_t * attr, + int *pshared); + +PTW32_DLLPORT int PTW32_CDECL pthread_condattr_setpshared (pthread_condattr_t * attr, + int pshared); + +/* + * Condition Variable Functions + */ +PTW32_DLLPORT int PTW32_CDECL pthread_cond_init (pthread_cond_t * cond, + const pthread_condattr_t * attr); + +PTW32_DLLPORT int PTW32_CDECL pthread_cond_destroy (pthread_cond_t * cond); + +PTW32_DLLPORT int PTW32_CDECL pthread_cond_wait (pthread_cond_t * cond, + pthread_mutex_t * mutex); + +PTW32_DLLPORT int PTW32_CDECL pthread_cond_timedwait (pthread_cond_t * cond, + pthread_mutex_t * mutex, + const struct timespec *abstime); + +PTW32_DLLPORT int PTW32_CDECL pthread_cond_signal (pthread_cond_t * cond); + +PTW32_DLLPORT int PTW32_CDECL pthread_cond_broadcast (pthread_cond_t * cond); + +/* + * Scheduling + */ +PTW32_DLLPORT int PTW32_CDECL pthread_setschedparam (pthread_t thread, + int policy, + const struct sched_param *param); + +PTW32_DLLPORT int PTW32_CDECL pthread_getschedparam (pthread_t thread, + int *policy, + struct sched_param *param); + +PTW32_DLLPORT int PTW32_CDECL pthread_setconcurrency (int); + +PTW32_DLLPORT int PTW32_CDECL pthread_getconcurrency (void); + +/* + * Read-Write Lock Functions + */ +PTW32_DLLPORT int PTW32_CDECL pthread_rwlock_init(pthread_rwlock_t *lock, + const pthread_rwlockattr_t *attr); + +PTW32_DLLPORT int PTW32_CDECL pthread_rwlock_destroy(pthread_rwlock_t *lock); + +PTW32_DLLPORT int PTW32_CDECL pthread_rwlock_tryrdlock(pthread_rwlock_t *); + +PTW32_DLLPORT int PTW32_CDECL pthread_rwlock_trywrlock(pthread_rwlock_t *); + +PTW32_DLLPORT int PTW32_CDECL pthread_rwlock_rdlock(pthread_rwlock_t *lock); + +PTW32_DLLPORT int PTW32_CDECL pthread_rwlock_timedrdlock(pthread_rwlock_t *lock, + const struct timespec *abstime); + +PTW32_DLLPORT int PTW32_CDECL pthread_rwlock_wrlock(pthread_rwlock_t *lock); + +PTW32_DLLPORT int PTW32_CDECL pthread_rwlock_timedwrlock(pthread_rwlock_t *lock, + const struct timespec *abstime); + +PTW32_DLLPORT int PTW32_CDECL pthread_rwlock_unlock(pthread_rwlock_t *lock); + +PTW32_DLLPORT int PTW32_CDECL pthread_rwlockattr_init (pthread_rwlockattr_t * attr); + +PTW32_DLLPORT int PTW32_CDECL pthread_rwlockattr_destroy (pthread_rwlockattr_t * attr); + +PTW32_DLLPORT int PTW32_CDECL pthread_rwlockattr_getpshared (const pthread_rwlockattr_t * attr, + int *pshared); + +PTW32_DLLPORT int PTW32_CDECL pthread_rwlockattr_setpshared (pthread_rwlockattr_t * attr, + int pshared); + +#if PTW32_LEVEL >= PTW32_LEVEL_MAX - 1 + +/* + * Signal Functions. Should be defined in but MSVC and MinGW32 + * already have signal.h that don't define these. + */ +PTW32_DLLPORT int PTW32_CDECL pthread_kill(pthread_t thread, int sig); + +/* + * Non-portable functions + */ + +/* + * Compatibility with Linux. + */ +PTW32_DLLPORT int PTW32_CDECL pthread_mutexattr_setkind_np(pthread_mutexattr_t * attr, + int kind); +PTW32_DLLPORT int PTW32_CDECL pthread_mutexattr_getkind_np(pthread_mutexattr_t * attr, + int *kind); + +/* + * Possibly supported by other POSIX threads implementations + */ +PTW32_DLLPORT int PTW32_CDECL pthread_delay_np (struct timespec * interval); +PTW32_DLLPORT int PTW32_CDECL pthread_num_processors_np(void); +PTW32_DLLPORT unsigned __int64 PTW32_CDECL pthread_getunique_np(pthread_t thread); + +/* + * Useful if an application wants to statically link + * the lib rather than load the DLL at run-time. + */ +PTW32_DLLPORT int PTW32_CDECL pthread_win32_process_attach_np(void); +PTW32_DLLPORT int PTW32_CDECL pthread_win32_process_detach_np(void); +PTW32_DLLPORT int PTW32_CDECL pthread_win32_thread_attach_np(void); +PTW32_DLLPORT int PTW32_CDECL pthread_win32_thread_detach_np(void); + +/* + * Features that are auto-detected at load/run time. + */ +PTW32_DLLPORT int PTW32_CDECL pthread_win32_test_features_np(int); +enum ptw32_features { + PTW32_SYSTEM_INTERLOCKED_COMPARE_EXCHANGE = 0x0001, /* System provides it. */ + PTW32_ALERTABLE_ASYNC_CANCEL = 0x0002 /* Can cancel blocked threads. */ +}; + +/* + * Register a system time change with the library. + * Causes the library to perform various functions + * in response to the change. Should be called whenever + * the application's top level window receives a + * WM_TIMECHANGE message. It can be passed directly to + * pthread_create() as a new thread if desired. + */ +PTW32_DLLPORT void * PTW32_CDECL pthread_timechange_handler_np(void *); + +#endif /*PTW32_LEVEL >= PTW32_LEVEL_MAX - 1 */ + +#if PTW32_LEVEL >= PTW32_LEVEL_MAX + +/* + * Returns the Win32 HANDLE for the POSIX thread. + */ +PTW32_DLLPORT HANDLE PTW32_CDECL pthread_getw32threadhandle_np(pthread_t thread); +/* + * Returns the win32 thread ID for POSIX thread. + */ +PTW32_DLLPORT DWORD PTW32_CDECL pthread_getw32threadid_np (pthread_t thread); + + +/* + * Protected Methods + * + * This function blocks until the given WIN32 handle + * is signaled or pthread_cancel had been called. + * This function allows the caller to hook into the + * PThreads cancel mechanism. It is implemented using + * + * WaitForMultipleObjects + * + * on 'waitHandle' and a manually reset WIN32 Event + * used to implement pthread_cancel. The 'timeout' + * argument to TimedWait is simply passed to + * WaitForMultipleObjects. + */ +PTW32_DLLPORT int PTW32_CDECL pthreadCancelableWait (HANDLE waitHandle); +PTW32_DLLPORT int PTW32_CDECL pthreadCancelableTimedWait (HANDLE waitHandle, + DWORD timeout); + +#endif /* PTW32_LEVEL >= PTW32_LEVEL_MAX */ + +/* + * Thread-Safe C Runtime Library Mappings. + */ +#if !defined(_UWIN) +# if defined(NEED_ERRNO) + PTW32_DLLPORT int * PTW32_CDECL _errno( void ); +# else +# if !defined(errno) +# if (defined(_MT) || defined(_DLL)) + __declspec(dllimport) extern int * __cdecl _errno(void); +# define errno (*_errno()) +# endif +# endif +# endif +#endif + +/* + * Some compiler environments don't define some things. + */ +#if defined(__BORLANDC__) +# define _ftime ftime +# define _timeb timeb +#endif + +#if defined(__cplusplus) + +/* + * Internal exceptions + */ +class ptw32_exception {}; +class ptw32_exception_cancel : public ptw32_exception {}; +class ptw32_exception_exit : public ptw32_exception {}; + +#endif + +#if PTW32_LEVEL >= PTW32_LEVEL_MAX + +/* FIXME: This is only required if the library was built using SEH */ +/* + * Get internal SEH tag + */ +PTW32_DLLPORT DWORD PTW32_CDECL ptw32_get_exception_services_code(void); + +#endif /* PTW32_LEVEL >= PTW32_LEVEL_MAX */ + +#if !defined(PTW32_BUILD) + +#if defined(__CLEANUP_SEH) + +/* + * Redefine the SEH __except keyword to ensure that applications + * propagate our internal exceptions up to the library's internal handlers. + */ +#define __except( E ) \ + __except( ( GetExceptionCode() == ptw32_get_exception_services_code() ) \ + ? EXCEPTION_CONTINUE_SEARCH : ( E ) ) + +#endif /* __CLEANUP_SEH */ + +#if defined(__CLEANUP_CXX) + +/* + * Redefine the C++ catch keyword to ensure that applications + * propagate our internal exceptions up to the library's internal handlers. + */ +#if defined(_MSC_VER) + /* + * WARNING: Replace any 'catch( ... )' with 'PtW32CatchAll' + * if you want Pthread-Win32 cancelation and pthread_exit to work. + */ + +#if !defined(PtW32NoCatchWarn) + +#pragma message("Specify \"/DPtW32NoCatchWarn\" compiler flag to skip this message.") +#pragma message("------------------------------------------------------------------") +#pragma message("When compiling applications with MSVC++ and C++ exception handling:") +#pragma message(" Replace any 'catch( ... )' in routines called from POSIX threads") +#pragma message(" with 'PtW32CatchAll' or 'CATCHALL' if you want POSIX thread") +#pragma message(" cancelation and pthread_exit to work. For example:") +#pragma message("") +#pragma message(" #if defined(PtW32CatchAll)") +#pragma message(" PtW32CatchAll") +#pragma message(" #else") +#pragma message(" catch(...)") +#pragma message(" #endif") +#pragma message(" {") +#pragma message(" /* Catchall block processing */") +#pragma message(" }") +#pragma message("------------------------------------------------------------------") + +#endif + +#define PtW32CatchAll \ + catch( ptw32_exception & ) { throw; } \ + catch( ... ) + +#else /* _MSC_VER */ + +#define catch( E ) \ + catch( ptw32_exception & ) { throw; } \ + catch( E ) + +#endif /* _MSC_VER */ + +#endif /* __CLEANUP_CXX */ + +#endif /* ! PTW32_BUILD */ + +#if defined(__cplusplus) +} /* End of extern "C" */ +#endif /* __cplusplus */ + +#if defined(PTW32__HANDLE_DEF) +# undef HANDLE +#endif +#if defined(PTW32__DWORD_DEF) +# undef DWORD +#endif + +#undef PTW32_LEVEL +#undef PTW32_LEVEL_MAX + +#endif /* ! RC_INVOKED */ + +#endif /* PTHREAD_H */ diff --git a/external/pthreads-w32/include/sched.h b/external/pthreads-w32/include/sched.h new file mode 100644 index 00000000..f36a97a6 --- /dev/null +++ b/external/pthreads-w32/include/sched.h @@ -0,0 +1,183 @@ +/* + * Module: sched.h + * + * Purpose: + * Provides an implementation of POSIX realtime extensions + * as defined in + * + * POSIX 1003.1b-1993 (POSIX.1b) + * + * -------------------------------------------------------------------------- + * + * Pthreads-win32 - POSIX Threads Library for Win32 + * Copyright(C) 1998 John E. Bossom + * Copyright(C) 1999,2005 Pthreads-win32 contributors + * + * Contact Email: rpj@callisto.canberra.edu.au + * + * The current list of contributors is contained + * in the file CONTRIBUTORS included with the source + * code distribution. The list can also be seen at the + * following World Wide Web location: + * http://sources.redhat.com/pthreads-win32/contributors.html + * + * This library is free software; you can redistribute it and/or + * modify it under the terms of the GNU Lesser General Public + * License as published by the Free Software Foundation; either + * version 2 of the License, or (at your option) any later version. + * + * This library is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + * Lesser General Public License for more details. + * + * You should have received a copy of the GNU Lesser General Public + * License along with this library in the file COPYING.LIB; + * if not, write to the Free Software Foundation, Inc., + * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA + */ +#if !defined(_SCHED_H) +#define _SCHED_H + +#undef PTW32_SCHED_LEVEL + +#if defined(_POSIX_SOURCE) +#define PTW32_SCHED_LEVEL 0 +/* Early POSIX */ +#endif + +#if defined(_POSIX_C_SOURCE) && _POSIX_C_SOURCE >= 199309 +#undef PTW32_SCHED_LEVEL +#define PTW32_SCHED_LEVEL 1 +/* Include 1b, 1c and 1d */ +#endif + +#if defined(INCLUDE_NP) +#undef PTW32_SCHED_LEVEL +#define PTW32_SCHED_LEVEL 2 +/* Include Non-Portable extensions */ +#endif + +#define PTW32_SCHED_LEVEL_MAX 3 + +#if ( defined(_POSIX_C_SOURCE) && _POSIX_C_SOURCE >= 200112 ) || !defined(PTW32_SCHED_LEVEL) +#define PTW32_SCHED_LEVEL PTW32_SCHED_LEVEL_MAX +/* Include everything */ +#endif + + +#if defined(__GNUC__) && !defined(__declspec) +# error Please upgrade your GNU compiler to one that supports __declspec. +#endif + +/* + * When building the library, you should define PTW32_BUILD so that + * the variables/functions are exported correctly. When using the library, + * do NOT define PTW32_BUILD, and then the variables/functions will + * be imported correctly. + */ +#if !defined(PTW32_STATIC_LIB) +# if defined(PTW32_BUILD) +# define PTW32_DLLPORT __declspec (dllexport) +# else +# define PTW32_DLLPORT __declspec (dllimport) +# endif +#else +# define PTW32_DLLPORT +#endif + +/* + * This is a duplicate of what is in the autoconf config.h, + * which is only used when building the pthread-win32 libraries. + */ + +#if !defined(PTW32_CONFIG_H) +# if defined(WINCE) +# define NEED_ERRNO +# define NEED_SEM +# endif +# if defined(__MINGW64__) +# define HAVE_STRUCT_TIMESPEC +# define HAVE_MODE_T +# elif defined(_UWIN) || defined(__MINGW32__) +# define HAVE_MODE_T +# endif +#endif + +/* + * + */ + +#if PTW32_SCHED_LEVEL >= PTW32_SCHED_LEVEL_MAX +#if defined(NEED_ERRNO) +#include "need_errno.h" +#else +#include +#endif +#endif /* PTW32_SCHED_LEVEL >= PTW32_SCHED_LEVEL_MAX */ + +#if (defined(__MINGW64__) || defined(__MINGW32__)) || defined(_UWIN) +# if PTW32_SCHED_LEVEL >= PTW32_SCHED_LEVEL_MAX +/* For pid_t */ +# include +/* Required by Unix 98 */ +# include +# else + typedef int pid_t; +# endif +#else + typedef int pid_t; +#endif + +/* Thread scheduling policies */ + +enum { + SCHED_OTHER = 0, + SCHED_FIFO, + SCHED_RR, + SCHED_MIN = SCHED_OTHER, + SCHED_MAX = SCHED_RR +}; + +struct sched_param { + int sched_priority; +}; + +#if defined(__cplusplus) +extern "C" +{ +#endif /* __cplusplus */ + +PTW32_DLLPORT int __cdecl sched_yield (void); + +PTW32_DLLPORT int __cdecl sched_get_priority_min (int policy); + +PTW32_DLLPORT int __cdecl sched_get_priority_max (int policy); + +PTW32_DLLPORT int __cdecl sched_setscheduler (pid_t pid, int policy); + +PTW32_DLLPORT int __cdecl sched_getscheduler (pid_t pid); + +/* + * Note that this macro returns ENOTSUP rather than + * ENOSYS as might be expected. However, returning ENOSYS + * should mean that sched_get_priority_{min,max} are + * not implemented as well as sched_rr_get_interval. + * This is not the case, since we just don't support + * round-robin scheduling. Therefore I have chosen to + * return the same value as sched_setscheduler when + * SCHED_RR is passed to it. + */ +#define sched_rr_get_interval(_pid, _interval) \ + ( errno = ENOTSUP, (int) -1 ) + + +#if defined(__cplusplus) +} /* End of extern "C" */ +#endif /* __cplusplus */ + +#undef PTW32_SCHED_LEVEL +#undef PTW32_SCHED_LEVEL_MAX + +#endif /* !_SCHED_H */ + diff --git a/external/pthreads-w32/include/semaphore.h b/external/pthreads-w32/include/semaphore.h new file mode 100644 index 00000000..c6e9407e --- /dev/null +++ b/external/pthreads-w32/include/semaphore.h @@ -0,0 +1,169 @@ +/* + * Module: semaphore.h + * + * Purpose: + * Semaphores aren't actually part of the PThreads standard. + * They are defined by the POSIX Standard: + * + * POSIX 1003.1b-1993 (POSIX.1b) + * + * -------------------------------------------------------------------------- + * + * Pthreads-win32 - POSIX Threads Library for Win32 + * Copyright(C) 1998 John E. Bossom + * Copyright(C) 1999,2005 Pthreads-win32 contributors + * + * Contact Email: rpj@callisto.canberra.edu.au + * + * The current list of contributors is contained + * in the file CONTRIBUTORS included with the source + * code distribution. The list can also be seen at the + * following World Wide Web location: + * http://sources.redhat.com/pthreads-win32/contributors.html + * + * This library is free software; you can redistribute it and/or + * modify it under the terms of the GNU Lesser General Public + * License as published by the Free Software Foundation; either + * version 2 of the License, or (at your option) any later version. + * + * This library is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + * Lesser General Public License for more details. + * + * You should have received a copy of the GNU Lesser General Public + * License along with this library in the file COPYING.LIB; + * if not, write to the Free Software Foundation, Inc., + * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA + */ +#if !defined( SEMAPHORE_H ) +#define SEMAPHORE_H + +#undef PTW32_SEMAPHORE_LEVEL + +#if defined(_POSIX_SOURCE) +#define PTW32_SEMAPHORE_LEVEL 0 +/* Early POSIX */ +#endif + +#if defined(_POSIX_C_SOURCE) && _POSIX_C_SOURCE >= 199309 +#undef PTW32_SEMAPHORE_LEVEL +#define PTW32_SEMAPHORE_LEVEL 1 +/* Include 1b, 1c and 1d */ +#endif + +#if defined(INCLUDE_NP) +#undef PTW32_SEMAPHORE_LEVEL +#define PTW32_SEMAPHORE_LEVEL 2 +/* Include Non-Portable extensions */ +#endif + +#define PTW32_SEMAPHORE_LEVEL_MAX 3 + +#if !defined(PTW32_SEMAPHORE_LEVEL) +#define PTW32_SEMAPHORE_LEVEL PTW32_SEMAPHORE_LEVEL_MAX +/* Include everything */ +#endif + +#if defined(__GNUC__) && ! defined (__declspec) +# error Please upgrade your GNU compiler to one that supports __declspec. +#endif + +/* + * When building the library, you should define PTW32_BUILD so that + * the variables/functions are exported correctly. When using the library, + * do NOT define PTW32_BUILD, and then the variables/functions will + * be imported correctly. + */ +#if !defined(PTW32_STATIC_LIB) +# if defined(PTW32_BUILD) +# define PTW32_DLLPORT __declspec (dllexport) +# else +# define PTW32_DLLPORT __declspec (dllimport) +# endif +#else +# define PTW32_DLLPORT +#endif + +/* + * This is a duplicate of what is in the autoconf config.h, + * which is only used when building the pthread-win32 libraries. + */ + +#if !defined(PTW32_CONFIG_H) +# if defined(WINCE) +# define NEED_ERRNO +# define NEED_SEM +# endif +# if defined(__MINGW64__) +# define HAVE_STRUCT_TIMESPEC +# define HAVE_MODE_T +# elif defined(_UWIN) || defined(__MINGW32__) +# define HAVE_MODE_T +# endif +#endif + +/* + * + */ + +#if PTW32_SEMAPHORE_LEVEL >= PTW32_SEMAPHORE_LEVEL_MAX +#if defined(NEED_ERRNO) +#include "need_errno.h" +#else +#include +#endif +#endif /* PTW32_SEMAPHORE_LEVEL >= PTW32_SEMAPHORE_LEVEL_MAX */ + +#define _POSIX_SEMAPHORES + +#if defined(__cplusplus) +extern "C" +{ +#endif /* __cplusplus */ + +#if !defined(HAVE_MODE_T) +typedef unsigned int mode_t; +#endif + + +typedef struct sem_t_ * sem_t; + +PTW32_DLLPORT int __cdecl sem_init (sem_t * sem, + int pshared, + unsigned int value); + +PTW32_DLLPORT int __cdecl sem_destroy (sem_t * sem); + +PTW32_DLLPORT int __cdecl sem_trywait (sem_t * sem); + +PTW32_DLLPORT int __cdecl sem_wait (sem_t * sem); + +PTW32_DLLPORT int __cdecl sem_timedwait (sem_t * sem, + const struct timespec * abstime); + +PTW32_DLLPORT int __cdecl sem_post (sem_t * sem); + +PTW32_DLLPORT int __cdecl sem_post_multiple (sem_t * sem, + int count); + +PTW32_DLLPORT int __cdecl sem_open (const char * name, + int oflag, + mode_t mode, + unsigned int value); + +PTW32_DLLPORT int __cdecl sem_close (sem_t * sem); + +PTW32_DLLPORT int __cdecl sem_unlink (const char * name); + +PTW32_DLLPORT int __cdecl sem_getvalue (sem_t * sem, + int * sval); + +#if defined(__cplusplus) +} /* End of extern "C" */ +#endif /* __cplusplus */ + +#undef PTW32_SEMAPHORE_LEVEL +#undef PTW32_SEMAPHORE_LEVEL_MAX + +#endif /* !SEMAPHORE_H */ diff --git a/external/pthreads-w32/lib/x64/libpthreadGC2.a b/external/pthreads-w32/lib/x64/libpthreadGC2.a new file mode 100644 index 0000000000000000000000000000000000000000..430162364f91f802273c5b43f3e5eab1387a04fc GIT binary patch literal 93692 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 XhP_oe8dzW@lCAa`K+EQ_udn-GKJPZ- literal 0 HcmV?d00001 diff --git a/external/pthreads-w32/lib/x64/pthreadVC2.lib b/external/pthreads-w32/lib/x64/pthreadVC2.lib new file mode 100644 index 0000000000000000000000000000000000000000..1b07e0e9aa43b91f04d2884e2f594bbeca4fdac1 GIT binary patch literal 29738 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 literal 0 HcmV?d00001 diff --git a/external/pthreads-w32/lib/x86/libpthreadGC2.a b/external/pthreads-w32/lib/x86/libpthreadGC2.a new file mode 100644 index 0000000000000000000000000000000000000000..df211759f80f37494af2d8fcea749957bb51aaa3 GIT binary patch literal 93480 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 literal 0 HcmV?d00001 diff --git a/external/pthreads-w32/lib/x86/libpthreadGCE2.a b/external/pthreads-w32/lib/x86/libpthreadGCE2.a new file mode 100644 index 0000000000000000000000000000000000000000..9c56202c582c7a21945cf0b5f9e6d835414bf259 GIT binary patch literal 93486 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 literal 0 HcmV?d00001 diff --git a/external/pthreads-w32/lib/x86/pthreadVSE2.lib b/external/pthreads-w32/lib/x86/pthreadVSE2.lib new file mode 100644 index 0000000000000000000000000000000000000000..3f3335d46981ea9ed40ad3e648a05c210ee77014 GIT binary patch literal 30460 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 literal 0 HcmV?d00001 diff --git a/ps3eye_settings.reg b/ps3eye_settings.reg new file mode 100644 index 0000000000000000000000000000000000000000..a74bd16c6992ec58a4615774b000af05a38e0da4 GIT binary patch literal 728 zcmcJNL2JTL5QM+8(ElL$0a6h!f(H!}K@dsRAX-YOi3T(&Mv4A;b>2%4UYbgwJRZsH zW_D+GbGrs4q^!v($f@HKu~97N$bpL@17#DTOt{Wm`Gc~Fa4OuU!K=;-HG7u~8Huyt z1DBcV`9fo+!ZY6V?z7S}BUa6VP}L$uCW^I`y$HFA?root_kXKwR7BEnv=i9KQ`yU* z$I1HbNso&|R}(0#|1}-!);KOt)9QQVcz@so^q=fA;LMk_YK^frYW{+s`CeuJ-}(Mie52tG&}?s& literal 0 HcmV?d00001 diff --git a/src/psmove.c b/src/psmove.c index eec2637c..6d1145db 100644 --- a/src/psmove.c +++ b/src/psmove.c @@ -39,7 +39,11 @@ #include #include #include +#ifdef _MSC_VER +#include +#else #include +#endif #include #include #include @@ -81,6 +85,33 @@ #include "daemon/moved_client.h" #include "hidapi.h" +/* Add gettimeofday for MSVC http://stackoverflow.com/a/26085827/1256069 */ +#ifdef _MSC_VER +int gettimeofday(struct timeval * tp, struct timezone * tzp) +{ + // Note: some broken versions only have 8 trailing zero's, the correct epoch has 9 trailing zero's + static const uint64_t EPOCH = ((uint64_t) 116444736000000000ULL); + + SYSTEMTIME system_time; + FILETIME file_time; + uint64_t time; + + GetSystemTime( &system_time ); + SystemTimeToFileTime( &system_time, &file_time ); + time = ((uint64_t)file_time.dwLowDateTime ) ; + time += ((uint64_t)file_time.dwHighDateTime) << 32; + + tp->tv_sec = (long) ((time - EPOCH) / 10000000L); + tp->tv_usec = (long) (system_time.wMilliseconds * 1000); + return 0; +} +#endif + +#ifdef _MSC_VER +#define STIN static __inline // Used in psmove_decode_16bit +#else +#define STIN static inline +#endif /* Begin private definitions */ @@ -163,7 +194,7 @@ typedef struct { #define TWELVE_BIT_SIGNED(x) (((x) & 0x800)?(-(((~(x)) & 0xFFF) + 1)):(x)) /* Decode 16-bit signed value from data pointer and offset */ -static inline int +STIN int psmove_decode_16bit(char *data, int offset) { unsigned char low = data[offset] & 0xFF; @@ -2110,7 +2141,7 @@ psmove_util_get_file_path(const char *filename) char *result; struct stat st; -#ifndef __WIN32 +#ifndef _WIN32 // if run as root, use system-wide data directory if (geteuid() == 0) { parent = PSMOVE_SYSTEM_DATA_DIR; @@ -2225,7 +2256,7 @@ _psmove_normalize_btaddr(const char *addr, int lowercase, char separator) return result; } -#if defined(__APPLE__) +#if defined(__APPLE__) || defined(_MSC_VER) #define CLOCK_MONOTONIC 0 @@ -2240,7 +2271,7 @@ clock_gettime(int unused, struct timespec *ts) return 0; } -#endif /* __APPLE__ */ +#endif /* __APPLE__ || _MSC_VER */ PSMove_timestamp _psmove_timestamp() diff --git a/src/psmove_calibration.c b/src/psmove_calibration.c index c3c6619c..318301d0 100644 --- a/src/psmove_calibration.c +++ b/src/psmove_calibration.c @@ -36,7 +36,9 @@ #include #include #include +#ifndef _MSC_VER #include +#endif #include #define PSMOVE_CALIBRATION_EXTENSION ".calibration" diff --git a/src/psmove_private.h b/src/psmove_private.h index d606088d..31eb4924 100755 --- a/src/psmove_private.h +++ b/src/psmove_private.h @@ -74,13 +74,13 @@ extern "C" { #define psmove_CRITICAL(x) \ psmove_PRINTF("PSMOVE CRITICAL", \ "Assertion fail in %s: %s\n", \ - __func__, x) + __FUNCTION__, x) /* Macro: Deprecated functions */ #define psmove_DEPRECATED(x) \ psmove_PRINTF("PSMOVE DEPRECATED", \ "%s is deprecated: %s\n", \ - __func__, x) + __FUNCTION__, x) /* Macros: Return immediately if an assertion fails + log */ #define psmove_return_if_fail(expr) \ diff --git a/src/tracker/psmove_tracker.c b/src/tracker/psmove_tracker.c index 4ea8139e..b4765724 100644 --- a/src/tracker/psmove_tracker.c +++ b/src/tracker/psmove_tracker.c @@ -50,6 +50,10 @@ # include "platform/psmove_linuxsupport.h" #endif +#ifdef _MSC_VER +#include +#endif + //#define DEBUG_WINDOWS // shall additional windows be shown #define ROIS 4 // the number of levels of regions of interest (roi) #define BLINKS 2 // number of diff images to create during calibration diff --git a/src/utils/psmovepair.c b/src/utils/psmovepair.c index 826204f6..aeb2534d 100644 --- a/src/utils/psmovepair.c +++ b/src/utils/psmovepair.c @@ -132,7 +132,7 @@ int run_daemon() #else // On non-Linux systems we just try to pair every 5 seconds for now while (1) { - sleep(5); + usleep(5000000); pair(NULL); } #endif // __linux