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