mingw32/mingw32-pthreads-w32.xml

   1 <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
   2 <software-distribution project="MinGW" home="http://www.mingw.org" issue="@YYYYMMDDNN@">
   3
   4   <!-- File: mingw32-pthreads-w32.xml ~~ mingw-get package description for pthreads-w32 -->
   5
   6   <package-collection subsystem="mingw32">
   7     <download-host uri="http://prdownloads.sourceforge.net/mingw/%F?download" />
   8
   9     <!-- Provides the package descriptions for the pthreads-w32 library, -->
  10     <!-- which is a runtime prerequisite for modern versions of GCC.     -->
  11
  12     <package name="mingw32-pthreads-w32" alias="pthreads-w32 pthreads">
  13       <affiliate group="MinGW Standard Libraries" />
  14       <description lang="en" title="POSIX threading library for Win32" >
  15         <paragraph>
  16           pthreads-w32 seeks to provide a freely available and high-quality
  17           implementation of pthreads for Windows.  Pthreads is an API for
  18           writing multithreaded applications following the POSIX standard.
  19         </paragraph>
  20         <paragraph>
  21           The mingw32-pthreads-w32 package provides the documentation for the
  22           pthreads-w32 library, as well as the related development files.  The
  23           associated mingw32-libpthread package provides the runtime library.
  24         </paragraph>
  25       </description>
  26
  27       <source tarname="pthreads-w32-%-mingw32-%-src.tar" />
  28       <licence tarname="pthreads-w32-%-mingw32-%-lic.tar" />
  29
  30       <component class="dev">
  31         <release tarname="pthreads-w32-2.10-mingw32-pre-20160821-1-dev.tar.xz">
  32           <requires eq="mingw32-libpthreadgc-%-mingw32-%-dev.tar" />
  33           <download tarname="none" />
  34         </release>
  35         <release tarname="pthreads-w32-2.9.1-1-mingw32-dev.tar.lzma">
  36           <requires eq="mingw32-libpthread-%-mingw32-dll-2.tar" />
  37         </release>
  38         <release tarname="pthreads-w32-2.8.0-3-mingw32-dev.tar.lzma" >
  39           <requires eq="mingw32-libpthread-%-mingw32-dll-2.tar" />
  40         </release>
  41         <release tarname="pthreads-w32-2.9.0-mingw32-pre-20110507-2-dev.tar.lzma" >
  42           <requires eq="mingw32-libpthreadgc-%-mingw32-%-dll-2.tar" />
  43         </release>
  44       </component>
  45
  46       <component class="doc">
  47         <release tarname="pthreads-w32-2.10-mingw32-pre-20160821-1-doc.tar.xz" />
  48         <release tarname="pthreads-w32-2.9.1-1-mingw32-doc.tar.lzma" />
  49         <release tarname="pthreads-w32-2.8.0-3-mingw32-doc.tar.lzma" />
  50         <release tarname="pthreads-w32-2.9.0-mingw32-pre-20110507-2-doc.tar.lzma" />
  51       </component>
  52
  53       <component class="lic">
  54         <release tarname="pthreads-w32-2.10-mingw32-pre-20160821-1-lic.tar.xz" />
  55         <release tarname="pthreads-w32-2.9.1-1-mingw32-lic.tar.lzma" />
  56         <release tarname="pthreads-w32-2.9.0-mingw32-pre-20110507-2-lic.tar.lzma" />
  57         <release tarname="pthreads-w32-2.8.0-3-mingw32-lic.tar.lzma" />
  58       </component>
  59     </package>
  60
  61     <package name="mingw32-libpthreadgc" alias="libpthreadgc mingw32-libpthread libpthread">
  62       <affiliate group="MinGW Standard Libraries" />
  63       <description lang="en" title="POSIX threading library for Win32" >
  64         <paragraph>
  65           NOTE: The 2.9.1 release delivers this library as part of the
  66           pthreads-w32-2.9.1-1-mingw32-dll.tar.lzma file.  This DLL file is
  67           a dependency for gcc-core-4.8.1 and will be installed as such when
  68           using mingw-get.
  69         </paragraph>
  70         <paragraph>
  71           pthreads-w32 seeks to provide a freely available and high-quality
  72           implementation of pthreads for Windows.  Pthreads is an API for
  73           writing multithreaded applications following the POSIX standard.
  74         </paragraph>
  75         <paragraph>
  76           There are two mingw32 versions of the pthread-w32 runtime library: the
  77           standard one, provided by this package, is called libpthreadgc but may
  78           also be referred to as 'libpthread'.  The non-standard one uses C++
  79           exception handling, and is called libpthreadgce. (Note that the
  80           standard library may be used successfully with C++ code; indeed, on
  81           most *nix platorms the system pthreads implementation follows the
  82           behavior of mingw32-libpthreadgc, and NOT the behavior of the 'GCE'
  83           version).  We recommend that most users rely on mingw32-libpthreadgc
  84           ('GC') and not mingw32-libpthreadgce ('GCE').
  85         </paragraph>
  86         <paragraph>
  87           The mingw32-libpthreadgc and mingw32-libpthreadgce packages provide
  88           the two runtime libraries (most people need not install the 'GCE'
  89           one).  The associated mingw32-pthreads-w32 package provides the
  90           documentation for the pthreads-w32 library, as well as the related
  91           development files.  The mingw32-libquserex package provides optional
  92           support for enhanced standards conformance of the GCE runtime.
  93         </paragraph>
  94         <paragraph>
  95           mingw32-libpthreadgc is a required component of the MinGW Compiler
  96           Suite.
  97         </paragraph>
  98       </description>
  99
 100       <source tarname="pthreads-w32-%-mingw32-%-src.tar" />
 101       <licence tarname="pthreads-w32-%-mingw32-%-lic.tar" />
 102
 103       <component class="dev">
 104         <release tarname="libpthreadgc-2.10-mingw32-pre-20160821-1-dev.tar.xz">
 105           <download tarname="pthreads-GC-w32-2.10-mingw32-pre-20160821-1-dev.tar.xz" />
 106           <requires eq="mingw32-libpthreadgc-%-mingw32-%-dll-3.tar" />
 107         </release>
 108       </component>
 109
 110       <component class="dll">
 111         <release tarname="libpthreadgc-2.10-mingw32-pre-20160821-1-dll-3.tar.xz">
 112           <download tarname="pthreads-GC-w32-2.10-mingw32-pre-20160821-1-dll-3.tar.xz" />
 113         </release>
 114         <release tarname="libpthread-2.9.1-1-mingw32-dll-2.tar" >
 115           <download tarname="pthreads-w32-2.9.1-1-mingw32-dll.tar.lzma" />
 116         </release>
 117         <release tarname="libpthread-2.8.0-3-mingw32-dll-2.tar.lzma" />
 118         <release tarname="libpthreadgc-2.9.0-mingw32-pre-20110507-2-dll-2.tar.lzma" />
 119       </component>
 120     </package>
 121
 122     <package name="mingw32-libpthreadgce" alias="libpthreadgce" >
 123       <affiliate group="MinGW Standard Libraries" />
 124       <description lang="en" title="POSIX threading library for Win32" >
 125         <paragraph>
 126           NOTE: The 2.9.1 release delivers this library as part of the
 127           pthreads-w32-2.9.1-1-mingw32-dll.tar.lzma file.  This DLL file is
 128           a dependency for gcc-core-4.8.1 and will be installed as such when
 129           using mingw-get.
 130         </paragraph>
 131         <paragraph>
 132           pthreads-w32 seeks to provide a freely available and high-quality
 133           implementation of pthreads for Windows.  Pthreads is an API for
 134           writing multithreaded applications following the POSIX standard.
 135         </paragraph>
 136         <paragraph>
 137           There are two mingw32 versions of the pthread-w32 runtime library: the
 138           non-standard one, provided by this package, is called libpthreadgce,
 139           and uses C++ exception handling.  The standard runtime is called
 140           mingw32-libpthreadgc, and may also be referred to as
 141           mignw32-libpthread. (Note that the standard library may be used
 142           successfully with C++ code; indeed, on most *nix platorms the system
 143           pthreads implementation follows the behavior of mingw32-libpthreadgc,
 144           and NOT the behavior of the 'GCE' version).  We recommend that most
 145           users rely on mingw32-libpthreadgc ('GC') and not
 146           mingw32-libpthreadgce ('GCE').
 147         </paragraph>
 148         <paragraph>
 149           The mingw32-libpthreadgc and mingw32-libpthreadgce packages provide
 150           the two runtime libraries (most people need not install the 'GCE'
 151           one).  The associated mingw32-pthreads-w32 package provides the
 152           documentation for the pthreads-w32 library, as well as the related
 153           development files.  The mingw32-libquserex package provides optional
 154           support for enhanced standards conformance of the GCE runtime.
 155         </paragraph>
 156       </description>
 157
 158       <source tarname="pthreads-w32-%-mingw32-%-src.tar" />
 159       <licence tarname="pthreads-w32-%-mingw32-%-lic.tar" />
 160
 161       <component class="dev">
 162         <release tarname="libpthreadgce-2.10-mingw32-pre-20160821-1-dev.tar.xz">
 163           <download tarname="pthreads-GCE-w32-2.10-mingw32-pre-20160821-1-dev.tar.xz" />
 164           <requires eq="mingw32-libpthreadgce-%-mingw32-%-dll-3.tar" />
 165           <requires eq="mingw32-libpthreadgc-%-mingw32-%-dev.tar" />
 166         </release>
 167       </component>
 168
 169       <component class="dll">
 170         <release tarname="libpthreadgce-2.10-mingw32-pre-20160821-1-dll-3.tar.xz">
 171           <download tarname="pthreads-GCE-w32-2.10-mingw32-pre-20160821-1-dll-3.tar.xz" />
 172         </release>
 173         <release tarname="libpthreadgce-2.9.1-1-mingw32-dll-2.tar" >
 174           <download tarname="none" />
 175           <requires eq="mingw32-libpthread-2.9.1-1-mingw32-dll-2.tar" />
 176         </release>
 177         <release tarname="libpthreadgce-2.9.0-mingw32-pre-20110507-2-dll-2.tar.lzma" />
 178       </component>
 179     </package>
 180
 181     <package name="mingw32-libquserex" alias="libquserex" >
 182       <affiliate group="MinGW Standard Libraries" />
 183       <description lang="en" title="POSIX threading library for Win32" >
 184         <paragraph>
 185           NOTE: The 2.9.1 and later releases do not deliver this library.
 186           This decision was based on the number of downloads for the library
 187           and the fact that it is experimental.
 188         </paragraph>
 189         <paragraph>
 190           pthreads-w32 seeks to provide a freely available and high-quality
 191           implementation of pthreads for Windows.  Pthreads is an API for
 192           writing multithreaded applications following the POSIX standard.
 193           libquserex is an optional library to enable enhanced standards
 194           conformance of the non-standard mingw32-libpthreadgce ('GCE') runtime.
 195           It provides access to a a kernel mode driver, AlertDrv.sys, which if
 196           installed allows ordinary users to exploit the Win32 QueueUserAPCEx
 197           function call.
 198         </paragraph>
 199         <paragraph>
 200           There are two mingw32 versions of the pthread-w32 runtime library: the
 201           non-standard one provided by mingw32-libpthreadgce ('GCE') uses C++
 202           exceptions, and for full POSIX conformance needs a kernel mode driver
 203           installed.  The standard runtime, mingw32-libpthreadgc ('GC') does not
 204           require that driver for full standards conformance, and may be used
 205           with C++ code; we recommend that most users rely on
 206           mingw32-libpthreadgc ('GC') and not mingw32-libpthreadgce ('GCE').
 207         </paragraph>
 208         <paragraph>
 209           However, for those that wish to experiment with the non-standard
 210           ('GCE') runtime, this optional helper library may also be of use --
 211           provided the kernel mode driver, available from mingw.org, is also
 212           installed.  Note that the kernel mode driver can not currently be
 213           installed on W7 (64bit) or Windows Server 2008R2 (64bit) because those
 214           operating systems require kernel mode drivers to be digitally signed,
 215           so this mingw32-libquserex package is rather useless on those
 216           platforms.
 217         </paragraph>
 218         <paragraph>
 219           The kernel mode driver is available at mingw.org or mirror site,
 220           packaged as an InnoSetup installer executable called
 221           QueueUserAPCEx-installer.exe.
 222         </paragraph>
 223       </description>
 224
 225       <source tarname="pthreads-w32-%-mingw32-%-src.tar" />
 226       <licence tarname="pthreads-w32-%-mingw32-%-lic.tar" />
 227
 228       <component class="dll">
 229         <release tarname="libquserex-2.9.0-mingw32-pre-20110507-2-dll.tar.lzma" />
 230       </component>
 231     </package>
 232
 233     <package name="mingw32-libpthread-old" alias="libpthread-old">
 234       <affiliate group="MinGW Standard Libraries" />
 235       <description lang="en" title="POSIX threading library for Win32" >
 236         <paragraph>
 237           pthreads-w32 seeks to provide a freely available and high-quality
 238           implementation of pthreads for Windows.  Pthreads is an API for
 239           writing multithreaded applications following the POSIX standard.
 240         </paragraph>
 241         <paragraph>
 242           The mingw32-libpthread-old package provides the MinGW pthreads-w32
 243           runtime dll associated with MinGW GCC 4.5.2 and older. Due to an
 244           unfortunate naming choice, upgrading to newer GCC will also install
 245           the newer, renamed pthreads-w32 DLLs, removing the old DLL. While the
 246           may not affect the new GCC, threaded applications compiled using the
 247           older compiler will break, as they will miss this runtime library.
 248           Therefore, the old runtime library is provided here using a new
 249           package name: mingw32-libpthread-old, so that it can be (re)installed
 250           parallel to the new pthreads-w32 runtime libraries.
 251         </paragraph>
 252       </description>
 253
 254       <source tarname="pthreads-w32-%-mingw32-src.tar" />
 255       <licence tarname="pthreads-w32-%-mingw32-lic.tar" />
 256
 257       <component class="dll">
 258         <release tarname="libpthread-2.8.0-3-mingw32-dll-2.tar.lzma" />
 259       </component>
 260     </package>
 261
 262   </package-collection>
 263 </software-distribution>
 264 <!-- vim: set nocompatible expandtab fileformat=unix textwidth=80 tabstop=2 shiftwidth=2: -->