1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
|
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>Changes since</title>
<link rel="stylesheet" href="../../../doc/src/boostbook.css" type="text/css">
<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
<link rel="home" href="../index.html" title="The Boost C++ Libraries BoostBook Documentation Subset">
<link rel="up" href="../thread.html" title="Chapter 28. Thread">
<link rel="prev" href="../thread.html" title="Chapter 28. Thread">
<link rel="next" href="future.html" title="Future">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table cellpadding="2" width="100%"><tr>
<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../boost.png"></td>
<td align="center"><a href="../../../index.html">Home</a></td>
<td align="center"><a href="../../../libs/libraries.htm">Libraries</a></td>
<td align="center"><a href="http://www.boost.org/users/people.html">People</a></td>
<td align="center"><a href="http://www.boost.org/users/faq.html">FAQ</a></td>
<td align="center"><a href="../../../more/index.htm">More</a></td>
</tr></table>
<hr>
<div class="spirit-nav">
<a accesskey="p" href="../thread.html"><img src="../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../thread.html"><img src="../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="future.html"><img src="../../../doc/src/images/next.png" alt="Next"></a>
</div>
<div class="section">
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
<a name="thread.changes"></a><a class="link" href="changes.html" title="Changes since">Changes since</a>
</h2></div></div></div>
<h4>
<a name="thread.changes.h0"></a>
<span><a name="thread.changes.changes_since_boost_1_41"></a></span><a class="link" href="changes.html#thread.changes.changes_since_boost_1_41">Changes
since boost 1.41</a>
</h4>
<p>
Fixed Bugs:
</p>
<div class="itemizedlist"><ul class="itemizedlist" type="disc">
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/2309" target="_top">#2309</a>
Lack of g++ symbol visibility support in Boost.Thread.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/2639" target="_top">#2639</a>
documentation should be extended(defer_lock, try_to_lock, ...).
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/3639" target="_top">#3639</a>
Boost.Thread doesn't build with Sun-5.9 on Linux.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/3762" target="_top">#3762</a>
Thread can't be compiled with winscw (Codewarrior by Nokia).
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/3885" target="_top">#3885</a>
document about mix usage of boost.thread and native thread api.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/3975" target="_top">#3975</a>
Incorrect precondition for promise::set_wait_callback().
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/4048" target="_top">#4048</a>
thread::id formatting involves locale
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/4315" target="_top">#4315</a>
gcc 4.4 Warning: inline ... declared as dllimport: attribute ignored.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/4480" target="_top">#4480</a>
OpenVMS patches for compiler issues workarounds.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/4819" target="_top">#4819</a>
boost.thread's documentation misprints.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/5040" target="_top">#5040</a>
future.hpp in boost::thread does not compile with /clr.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/5423" target="_top">#5423</a>
thread issues with C++0x.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/5502" target="_top">#5502</a>
race condition between shared_mutex timed_lock and lock_shared.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/5594" target="_top">#5594</a>
boost::shared_mutex not fully compatible with Windows CE.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/5617" target="_top">#5617</a>
boost::thread::id copy ctor.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/5739" target="_top">#5739</a>
set-but-not-used warnings with gcc-4.6.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/5826" target="_top">#5826</a>
threads.cpp: resource leak on threads creation failure.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/5839" target="_top">#5839</a>
thread.cpp: ThreadProxy leaks on exceptions.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/5859" target="_top">#5859</a>
win32 shared_mutex constructor leaks on exceptions.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/6100" target="_top">#6100</a>
Compute hardware_concurrency() using get_nprocs() on GLIBC systems.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/6141" target="_top">#6141</a>
Compilation error when boost.thread and boost.move are used together.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/6168" target="_top">#6168</a>
recursive_mutex is using wrong config symbol (possible typo).
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/6175" target="_top">#6175</a>
Compile error with SunStudio.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/6200" target="_top">#6200</a>
patch to have condition_variable and mutex error better handle EINTR.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/6207" target="_top">#6207</a>
shared_lock swap compiler error on clang 3.0 c++11.
</li>
<li class="listitem">
<a href="http://svn.boost.org/trac/boost/ticket/6208" target="_top">#6208</a>
try_lock_wrapper swap compiler error on clang 3.0 c++11.
</li>
</ul></div>
<h4>
<a name="thread.changes.h1"></a>
<span><a name="thread.changes.changes_since_boost_1_40"></a></span><a class="link" href="changes.html#thread.changes.changes_since_boost_1_40">Changes
since boost 1.40</a>
</h4>
<p>
The 1.41.0 release of Boost adds futures to the thread library. There are also
a few minor changes.
</p>
<h4>
<a name="thread.changes.h2"></a>
<span><a name="thread.changes.changes_since_boost_1_35"></a></span><a class="link" href="changes.html#thread.changes.changes_since_boost_1_35">Changes
since boost 1.35</a>
</h4>
<p>
The 1.36.0 release of Boost includes a few new features in the thread library:
</p>
<div class="itemizedlist"><ul class="itemizedlist" type="disc">
<li class="listitem">
New generic <a class="link" href="synchronization.html#thread.synchronization.lock_functions.lock_multiple" title="Non-member function lock(Lockable1,Lockable2,...)"><code class="computeroutput"><span class="identifier">lock</span><span class="special">()</span></code></a>
and <a class="link" href="synchronization.html#thread.synchronization.lock_functions.try_lock_multiple" title="Non-member function try_lock(Lockable1,Lockable2,...)"><code class="computeroutput"><span class="identifier">try_lock</span><span class="special">()</span></code></a>
functions for locking multiple mutexes at once.
</li>
<li class="listitem">
Rvalue reference support for move semantics where the compilers supports
it.
</li>
<li class="listitem">
A few bugs fixed and missing functions added (including the serious win32
condition variable bug).
</li>
<li class="listitem">
<code class="computeroutput"><span class="identifier">scoped_try_lock</span></code> types are
now backwards-compatible with Boost 1.34.0 and previous releases.
</li>
<li class="listitem">
Support for passing function arguments to the thread function by supplying
additional arguments to the <a class="link" href="thread_management.html#thread.thread_management.thread" title="Class thread"><code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">thread</span></code></a> constructor.
</li>
<li class="listitem">
Backwards-compatibility overloads added for <code class="computeroutput"><span class="identifier">timed_lock</span></code>
and <code class="computeroutput"><span class="identifier">timed_wait</span></code> functions
to allow use of <code class="computeroutput"><span class="identifier">xtime</span></code> for
timeouts.
</li>
</ul></div>
<h4>
<a name="thread.changes.h3"></a>
<span><a name="thread.changes.changes_since_boost_1_34"></a></span><a class="link" href="changes.html#thread.changes.changes_since_boost_1_34">Changes
since boost 1.34</a>
</h4>
<p>
Almost every line of code in <span class="bold"><strong>Boost.Thread</strong></span>
has been changed since the 1.34 release of boost. However, most of the interface
changes have been extensions, so the new code is largely backwards-compatible
with the old code. The new features and breaking changes are described below.
</p>
<h4>
<a name="thread.changes.h4"></a>
<span><a name="thread.changes.new_features"></a></span><a class="link" href="changes.html#thread.changes.new_features">New
Features</a>
</h4>
<div class="itemizedlist"><ul class="itemizedlist" type="disc">
<li class="listitem">
Instances of <a class="link" href="thread_management.html#thread.thread_management.thread" title="Class thread"><code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">thread</span></code></a> and of the various lock
types are now movable.
</li>
<li class="listitem">
Threads can be interrupted at <a class="link" href="thread_management.html#interruption_points"><span class="emphasis"><em>interruption
points</em></span></a>.
</li>
<li class="listitem">
Condition variables can now be used with any type that implements the
<a class="link" href="synchronization.html#thread.synchronization.mutex_concepts.lockable" title="Lockable Concept"><code class="computeroutput"><span class="identifier">Lockable</span></code> concept</a>, through the
use of <code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">condition_variable_any</span></code> (<code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">condition</span></code> is a <code class="computeroutput"><span class="keyword">typedef</span></code>
to <code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">condition_variable_any</span></code>, provided for
backwards compatibility). <code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">condition_variable</span></code>
is provided as an optimization, and will only work with <code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">unique_lock</span><span class="special"><</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">mutex</span><span class="special">></span></code> (<code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">mutex</span><span class="special">::</span><span class="identifier">scoped_lock</span></code>).
</li>
<li class="listitem">
Thread IDs are separated from <a class="link" href="thread_management.html#thread.thread_management.thread" title="Class thread"><code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">thread</span></code></a>, so a thread can obtain
it's own ID (using <code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">this_thread</span><span class="special">::</span><span class="identifier">get_id</span><span class="special">()</span></code>), and IDs can be used as keys in associative
containers, as they have the full set of comparison operators.
</li>
<li class="listitem">
Timeouts are now implemented using the Boost DateTime library, through
a typedef <code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">system_time</span></code> for absolute timeouts, and
with support for relative timeouts in many cases. <code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">xtime</span></code>
is supported for backwards compatibility only.
</li>
<li class="listitem">
Locks are implemented as publicly accessible templates <code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">lock_guard</span></code>,
<code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">unique_lock</span></code>, <code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">shared_lock</span></code>,
and <code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">upgrade_lock</span></code>, which are templated on
the type of the mutex. The <a class="link" href="synchronization.html#thread.synchronization.mutex_concepts.lockable" title="Lockable Concept"><code class="computeroutput"><span class="identifier">Lockable</span></code> concept</a> has been extended
to include publicly available <a class="link" href="synchronization.html#thread.synchronization.mutex_concepts.lockable.lock" title="void lock()"><code class="computeroutput"><span class="identifier">lock</span><span class="special">()</span></code></a>
and <a class="link" href="synchronization.html#thread.synchronization.mutex_concepts.lockable.unlock" title="void unlock()"><code class="computeroutput"><span class="identifier">unlock</span><span class="special">()</span></code></a>
member functions, which are used by the lock types.
</li>
</ul></div>
<h4>
<a name="thread.changes.h5"></a>
<span><a name="thread.changes.breaking_changes"></a></span><a class="link" href="changes.html#thread.changes.breaking_changes">Breaking
Changes</a>
</h4>
<p>
The list below should cover all changes to the public interface which break
backwards compatibility.
</p>
<div class="itemizedlist"><ul class="itemizedlist" type="disc">
<li class="listitem">
<a class="link" href="synchronization.html#thread.synchronization.mutex_types.try_mutex" title="Typedef try_mutex"><code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">try_mutex</span></code></a> has been removed, and
the functionality subsumed into <a class="link" href="synchronization.html#thread.synchronization.mutex_types.mutex" title="Class mutex"><code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">mutex</span></code></a>. <a class="link" href="synchronization.html#thread.synchronization.mutex_types.try_mutex" title="Typedef try_mutex"><code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">try_mutex</span></code></a> is left as a <code class="computeroutput"><span class="keyword">typedef</span></code>, but is no longer a separate class.
</li>
<li class="listitem">
<a class="link" href="synchronization.html#thread.synchronization.mutex_types.recursive_try_mutex" title="Typedef recursive_try_mutex"><code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">recursive_try_mutex</span></code></a> has been removed,
and the functionality subsumed into <a class="link" href="synchronization.html#thread.synchronization.mutex_types.recursive_mutex" title="Class recursive_mutex"><code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">recursive_mutex</span></code></a>. <a class="link" href="synchronization.html#thread.synchronization.mutex_types.recursive_try_mutex" title="Typedef recursive_try_mutex"><code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">recursive_try_mutex</span></code></a> is left as
a <code class="computeroutput"><span class="keyword">typedef</span></code>, but is no longer
a separate class.
</li>
<li class="listitem">
<code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">detail</span><span class="special">::</span><span class="identifier">thread</span><span class="special">::</span><span class="identifier">lock_ops</span></code> has been removed. Code that
relies on the <code class="computeroutput"><span class="identifier">lock_ops</span></code>
implementation detail will no longer work, as this has been removed, as
it is no longer necessary now that mutex types now have public <a class="link" href="synchronization.html#thread.synchronization.mutex_concepts.lockable.lock" title="void lock()"><code class="computeroutput"><span class="identifier">lock</span><span class="special">()</span></code></a>
and <a class="link" href="synchronization.html#thread.synchronization.mutex_concepts.lockable.unlock" title="void unlock()"><code class="computeroutput"><span class="identifier">unlock</span><span class="special">()</span></code></a>
member functions.
</li>
<li class="listitem">
<code class="computeroutput"><span class="identifier">scoped_lock</span></code> constructors
with a second parameter of type <code class="computeroutput"><span class="keyword">bool</span></code>
are no longer provided. With previous boost releases,
<pre class="programlisting"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">mutex</span><span class="special">::</span><span class="identifier">scoped_lock</span> <span class="identifier">some_lock</span><span class="special">(</span><span class="identifier">some_mutex</span><span class="special">,</span><span class="keyword">false</span><span class="special">);</span></pre>
could be used to create a lock object that was associated with a mutex,
but did not lock it on construction. This facility has now been replaced
with the constructor that takes a <code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">defer_lock_type</span></code>
as the second parameter:
<pre class="programlisting"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">mutex</span><span class="special">::</span><span class="identifier">scoped_lock</span> <span class="identifier">some_lock</span><span class="special">(</span><span class="identifier">some_mutex</span><span class="special">,</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">defer_lock</span><span class="special">);</span></pre>
</li>
<li class="listitem">
The <code class="computeroutput"><span class="identifier">locked</span><span class="special">()</span></code>
member function of the <code class="computeroutput"><span class="identifier">scoped_lock</span></code>
types has been renamed to <a class="link" href="synchronization.html#thread.synchronization.locks.unique_lock.owns_lock" title="bool owns_lock() const"><code class="computeroutput"><span class="identifier">owns_lock</span><span class="special">()</span></code></a>.
</li>
<li class="listitem">
You can no longer obtain a <a class="link" href="thread_management.html#thread.thread_management.thread" title="Class thread"><code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">thread</span></code></a> instance representing the
current thread: a default-constructed <a class="link" href="thread_management.html#thread.thread_management.thread" title="Class thread"><code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">thread</span></code></a> object is not associated
with any thread. The only use for such a thread object was to support the
comparison operators: this functionality has been moved to <a class="link" href="thread_management.html#thread.thread_management.thread.id" title="Class boost::thread::id"><code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">thread</span><span class="special">::</span><span class="identifier">id</span></code></a>.
</li>
<li class="listitem">
The broken <code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">read_write_mutex</span></code> has been replaced with
<a class="link" href="synchronization.html#thread.synchronization.mutex_types.shared_mutex" title="Class shared_mutex"><code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">shared_mutex</span></code></a>.
</li>
<li class="listitem">
<a class="link" href="synchronization.html#thread.synchronization.mutex_types.mutex" title="Class mutex"><code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">mutex</span></code></a> is now never recursive.
For Boost releases prior to 1.35 <a class="link" href="synchronization.html#thread.synchronization.mutex_types.mutex" title="Class mutex"><code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">mutex</span></code></a> was recursive on Windows
and not on POSIX platforms.
</li>
<li class="listitem">
When using a <a class="link" href="synchronization.html#thread.synchronization.mutex_types.recursive_mutex" title="Class recursive_mutex"><code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">recursive_mutex</span></code></a> with a call to
<a class="link" href="synchronization.html#thread.synchronization.condvar_ref.condition_variable_any.wait" title="template<typename lock_type> void wait(lock_type& lock)"><code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">condition_variable_any</span><span class="special">::</span><span class="identifier">wait</span><span class="special">()</span></code></a>,
the mutex is only unlocked one level, and not completely. This prior behaviour
was not guaranteed and did not feature in the tests.
</li>
</ul></div>
</div>
<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
<td align="left"></td>
<td align="right"><div class="copyright-footer">Copyright © 2007 -8 Anthony Williams<p>
Distributed under the Boost Software License, Version 1.0. (See accompanying
file LICENSE_1_0.txt or copy at <a href="http://www.boost.org/LICENSE_1_0.txt" target="_top">http://www.boost.org/LICENSE_1_0.txt</a>)
</p>
</div></td>
</tr></table>
<hr>
<div class="spirit-nav">
<a accesskey="p" href="../thread.html"><img src="../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../thread.html"><img src="../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="future.html"><img src="../../../doc/src/images/next.png" alt="Next"></a>
</div>
</body>
</html>
|
