mirror of
https://github.com/boostorg/thread.git
synced 2026-01-23 06:02:14 +00:00
78 lines
4.0 KiB
HTML
78 lines
4.0 KiB
HTML
<html>
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
|
|
<link rel="stylesheet" type="text/css" href="../../../boost.css">
|
|
<title>{{Library}} - Overview</title>
|
|
</head>
|
|
<body link="#0000ff" vlink="#800080">
|
|
<table border="0" cellpadding="7" cellspacing="0" width="100%" summary=
|
|
"header">
|
|
<tr>
|
|
<td valign="top" width="300">
|
|
<h3><a href="../../../index.htm"><img height="86" width="277" alt="C++ Boost" src="../../../c++boost.gif" border="0"></a></h3>
|
|
</td>
|
|
<td valign="top">
|
|
<h1 align="center">Boost.Threads</h1>
|
|
<h2 align="center">Building and Testing</h2>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
<hr>
|
|
<dl class="index">
|
|
<dt><a href="#introduction">Introduction</a></dt>
|
|
<dt><a href="#topic1">First topic</a></dt>
|
|
<dt><a href="#topic2">Second topic</a></dt>
|
|
<dt><a href="#footnotes">Footnotes</a></dt>
|
|
</dl>
|
|
<h2><a name="introduction"></a>Introduction</h2>
|
|
<p>How you build the Boost.Threads libraries, and how you build your own applications
|
|
that use those libraries, are some of the most frequently asked questions. Build
|
|
processes are difficult to deal with in a portable manner. That's one reason
|
|
why Boost.Threads makes use of <a href="../../../tools/build/index.html">Boost.Build</a>.
|
|
In general you should refer to the documentation for <a href="../../../tools/build/index.html">Boost.Build</a>.
|
|
This document will only supply you with some simple usage examples for how to
|
|
use <em>bjam</em> to build and test Boost.Threads. In addition, this document
|
|
will try and explain the build requirements so that users may create their own
|
|
build processes (for instance, create an IDE specific project), both for building
|
|
and testing Boost.Threads, as well as for building their own projects using
|
|
Boost.Threads. </p>
|
|
<h2><a name="topic1"></a>Building the Boost.Threads Libraries</h2>
|
|
<p>To build the Boost.Thread libraries using Boost.Build, simply change to the
|
|
directory <em>boost_root</em>/libs/thread/build and execute the command:</p>
|
|
<pre>bjam -sTOOLS=<em>toolset</em></pre>
|
|
<p>This will create four variants of the Boost.Threads library with the permuations
|
|
of debug/release and runtime-link-dynamic/runtime-link-static. <em><strong>Note:</strong></em>
|
|
Invoking the above command in <em>boost_root</em> will build all of the Boost
|
|
distribution, including Boost.Threads.</p>
|
|
<p>The Jamfile supplied with Boost.Threads produces a static library named <em>libboostthread</em>.
|
|
In addition, on Win32 platforms a <em>boostthreadmon.dll</em> and a coresponding
|
|
import library are created. The source files that are used to create the <em>libboostthread</em>
|
|
library are all of the *.cpp files found in <em>boost_root</em>/libs/thread/src,
|
|
except for <em>threadmon.cpp</em>. These need to be built with the compiler's
|
|
and linker's multi-threading support enabled. On Win32 platforms the <em>boostthreadmon.dll</em>
|
|
is created from <em>boost_root</em>/libs/thread/src/threadmon.cpp. This, too,
|
|
needs to be built with the compiler's and linker's multi-threading support enabled.
|
|
If you want to create your own build solution you'll have to follow these same
|
|
guidelines. One of the most frequently reported problems when trying to do this
|
|
occurs from not enabling the compiler's and linker's support for multi-threading.</p>
|
|
<h2><a name="topic2"></a>Testing the Boost.Threads Libraries</h2>
|
|
<p>To test the Boost.Threads libraries using Boost.Build, simply change to the
|
|
directory <em>boost_root</em>/libs/thread/test and execute the command:</p>
|
|
<pre><code>bjam -sTOOLS=<em>toolset</em> test</code></pre>
|
|
<p> </p>
|
|
<h2><a name="footnotes"></a>Footnotes</h2>
|
|
<dl>
|
|
<dt><a name="footnote1" class="footnote">(1)</a> {{text}}</dt>
|
|
<dt><a name="footnote2" class="footnote">(2)</a> {{text}}</dt>
|
|
</dl>
|
|
<hr>
|
|
<p>Revised
|
|
<!--webbot bot="Timestamp" S-Type="EDITED" S-Format="%d %B, %Y" startspan -->
|
|
05 November, 2001
|
|
<!--webbot bot="Timestamp" endspan i-checksum="39359" -->
|
|
</p>
|
|
<p><i>© Copyright <a href="mailto:{{address}}">{{author}}</a>
|
|
2002. All Rights Reserved.</i></p>
|
|
</body>
|
|
</html>
|