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