|
|
Boost-Commit : |
Subject: [Boost-commit] svn:boost r56659 - in sandbox/stm/branches/vbe/libs/stm/doc: . html html/toward_boost_stm html/toward_boost_stm/appendices html/toward_boost_stm/overview html/toward_boost_stm/reference html/toward_boost_stm/users_guide
From: vicente.botet_at_[hidden]
Date: 2009-10-08 15:42:58
Author: viboes
Date: 2009-10-08 15:42:54 EDT (Thu, 08 Oct 2009)
New Revision: 56659
URL: http://svn.boost.org/trac/boost/changeset/56659
Log:
TBoost.Stm vbe
* DRAFT documentation ongoing
Text files modified:
sandbox/stm/branches/vbe/libs/stm/doc/html/index.html | 8
sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/appendices.html | 6
sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/appendices/acknowledgements.html | 14
sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/appendices/appendix_e__tests.html | 16
sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/appendices/appendix_f__tickets.html | 14
sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/appendices/changes.html | 24
sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/appendices/implementation.html | 58 +-
sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/appendices/rationale.html | 239 +++++++------
sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/appendices/todo.html | 68 ++-
sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/examples.html | 7
sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/overview.html | 24
sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/overview/intro.html | 148 ++++----
sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference.html | 9
sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/base_contention_manager_hpp.html | 63 ++-
sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/base_transaction_object_hpp.html | 40 +
sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/cache_fct_hpp.html | 26
sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/data_types_hpp.html | 22
sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/exceptions_hpp.html | 14
sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/language_like_hpp.html | 31 +
sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/non_tx_smart_ptr_hpp.html | 23
sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/transaction_bookkeeping_hpp.html | 14
sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/transaction_hpp.html | 203 ++++++++----
sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/transaction_object_hpp.html | 32 +
sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/transactional_object_hpp.html | 25
sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/tx_ptr_hpp.html | 18
sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/tx_smart_ptr_hpp.html | 28 +
sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/users_guide.html | 15
sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/users_guide/ext_references.html | 12
sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/users_guide/getting_started.html | 68 ++-
sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/users_guide/glosary.html | 10
sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/users_guide/tutorial.html | 674 +++++++++++++++++++++++++++++----------
sandbox/stm/branches/vbe/libs/stm/doc/tutorial.qbk | 317 ++++++++++++++++-
32 files changed, 1531 insertions(+), 739 deletions(-)
Modified: sandbox/stm/branches/vbe/libs/stm/doc/html/index.html
==============================================================================
--- sandbox/stm/branches/vbe/libs/stm/doc/html/index.html (original)
+++ sandbox/stm/branches/vbe/libs/stm/doc/html/index.html 2009-10-08 15:42:54 EDT (Thu, 08 Oct 2009)
@@ -3,9 +3,9 @@
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>Chapter 1. Toward.Boost.STM</title>
<link rel="stylesheet" href="../../../../doc/html/boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
+<meta name="generator" content="DocBook XSL Stylesheets V1.69.1">
<link rel="start" href="index.html" title="Chapter 1. Toward.Boost.STM">
-<link rel="next" href="toward_boost_stm/overview.html" title="Overview">
+<link rel="next" href="toward_boost_stm/overview.html" title=" Overview">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table cellpadding="2" width="100%"><tr>
@@ -31,7 +31,7 @@
<div><p class="copyright">Copyright © 2009 Justin E. Gottchlich</p></div>
<div><p class="copyright">Copyright © 2009 Vicente J. Botet Escriba</p></div>
<div><div class="legalnotice">
-<a name="id4810745"></a><p>
+<a name="id4803237"></a><p>
Distributed under the Boost Software License, Version 1.0. (See accompanying
file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
</p>
@@ -110,7 +110,7 @@
</p>
</div>
<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
-<td align="left"><p><small>Last revised: September 22, 2009 at 16:33:31 GMT</small></p></td>
+<td align="left"><p><small>Last revised: October 08, 2009 at 19:40:30 GMT</small></p></td>
<td align="right"><div class="copyright-footer"></div></td>
</tr></table>
<hr>
Modified: sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/appendices.html
==============================================================================
--- sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/appendices.html (original)
+++ sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/appendices.html 2009-10-08 15:42:54 EDT (Thu, 08 Oct 2009)
@@ -3,11 +3,11 @@
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>Appendices</title>
<link rel="stylesheet" href="../../../../../doc/html/boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
+<meta name="generator" content="DocBook XSL Stylesheets V1.69.1">
<link rel="start" href="../index.html" title="Chapter 1. Toward.Boost.STM">
<link rel="up" href="../index.html" title="Chapter 1. Toward.Boost.STM">
<link rel="prev" href="examples.html" title="Examples">
-<link rel="next" href="appendices/changes.html" title="Appendix A: History">
+<link rel="next" href="appendices/changes.html" title=" Appendix A: History">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table cellpadding="2" width="100%"><tr>
@@ -24,7 +24,7 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
-<a name="toward_boost_stm.appendices"></a><a class="link" href="appendices.html" title="Appendices">Appendices</a>
+<a name="toward_boost_stm.appendices"></a>Appendices
</h2></div></div></div>
<div class="toc"><dl>
<dt><span class="section"> Appendix A: History</span></dt>
Modified: sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/appendices/acknowledgements.html
==============================================================================
--- sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/appendices/acknowledgements.html (original)
+++ sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/appendices/acknowledgements.html 2009-10-08 15:42:54 EDT (Thu, 08 Oct 2009)
@@ -1,13 +1,16 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
-<title>Appendix D: Acknowledgements</title>
+<title> Appendix
+ D: Acknowledgements</title>
<link rel="stylesheet" href="../../../../../../doc/html/boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
+<meta name="generator" content="DocBook XSL Stylesheets V1.69.1">
<link rel="start" href="../../index.html" title="Chapter 1. Toward.Boost.STM">
<link rel="up" href="../appendices.html" title="Appendices">
-<link rel="prev" href="implementation.html" title="Appendix C: Implementation Notes">
-<link rel="next" href="appendix_e__tests.html" title="Appendix E: Tests">
+<link rel="prev" href="implementation.html" title=" Appendix
+ C: Implementation Notes">
+<link rel="next" href="appendix_e__tests.html" title="Appendix
+ E: Tests">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table cellpadding="2" width="100%"><tr>
@@ -24,7 +27,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h3 class="title">
-<a name="toward_boost_stm.appendices.acknowledgements"></a><a class="link" href="acknowledgements.html" title="Appendix D: Acknowledgements"> Appendix
+<a name="toward_boost_stm.appendices.acknowledgements"></a><a href="acknowledgements.html" title=" Appendix
+ D: Acknowledgements"> Appendix
D: Acknowledgements</a>
</h3></div></div></div>
<p>
Modified: sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/appendices/appendix_e__tests.html
==============================================================================
--- sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/appendices/appendix_e__tests.html (original)
+++ sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/appendices/appendix_e__tests.html 2009-10-08 15:42:54 EDT (Thu, 08 Oct 2009)
@@ -1,13 +1,16 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
-<title>Appendix E: Tests</title>
+<title>Appendix
+ E: Tests</title>
<link rel="stylesheet" href="../../../../../../doc/html/boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
+<meta name="generator" content="DocBook XSL Stylesheets V1.69.1">
<link rel="start" href="../../index.html" title="Chapter 1. Toward.Boost.STM">
<link rel="up" href="../appendices.html" title="Appendices">
-<link rel="prev" href="acknowledgements.html" title="Appendix D: Acknowledgements">
-<link rel="next" href="appendix_f__tickets.html" title="Appendix F: Tickets">
+<link rel="prev" href="acknowledgements.html" title=" Appendix
+ D: Acknowledgements">
+<link rel="next" href="appendix_f__tickets.html" title="Appendix
+ F: Tickets">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table cellpadding="2" width="100%"><tr>
@@ -24,13 +27,14 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h3 class="title">
-<a name="toward_boost_stm.appendices.appendix_e__tests"></a><a class="link" href="appendix_e__tests.html" title="Appendix E: Tests">Appendix
+<a name="toward_boost_stm.appendices.appendix_e__tests"></a><a href="appendix_e__tests.html" title="Appendix
+ E: Tests">Appendix
E: Tests</a>
</h3></div></div></div>
<div class="toc"><dl><dt><span class="section">XXX</span></dt></dl></div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="toward_boost_stm.appendices.appendix_e__tests.xxx"></a><a class="link" href="appendix_e__tests.html#toward_boost_stm.appendices.appendix_e__tests.xxx" title="XXX">XXX</a>
+<a name="toward_boost_stm.appendices.appendix_e__tests.xxx"></a>XXX
</h4></div></div></div>
<div class="informaltable"><table class="table">
<colgroup>
Modified: sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/appendices/appendix_f__tickets.html
==============================================================================
--- sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/appendices/appendix_f__tickets.html (original)
+++ sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/appendices/appendix_f__tickets.html 2009-10-08 15:42:54 EDT (Thu, 08 Oct 2009)
@@ -1,13 +1,16 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
-<title>Appendix F: Tickets</title>
+<title>Appendix
+ F: Tickets</title>
<link rel="stylesheet" href="../../../../../../doc/html/boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
+<meta name="generator" content="DocBook XSL Stylesheets V1.69.1">
<link rel="start" href="../../index.html" title="Chapter 1. Toward.Boost.STM">
<link rel="up" href="../appendices.html" title="Appendices">
-<link rel="prev" href="appendix_e__tests.html" title="Appendix E: Tests">
-<link rel="next" href="todo.html" title="Appendix E: Future plans">
+<link rel="prev" href="appendix_e__tests.html" title="Appendix
+ E: Tests">
+<link rel="next" href="todo.html" title=" Appendix E: Future
+ plans">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table cellpadding="2" width="100%"><tr>
@@ -24,7 +27,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h3 class="title">
-<a name="toward_boost_stm.appendices.appendix_f__tickets"></a><a class="link" href="appendix_f__tickets.html" title="Appendix F: Tickets">Appendix
+<a name="toward_boost_stm.appendices.appendix_f__tickets"></a><a href="appendix_f__tickets.html" title="Appendix
+ F: Tickets">Appendix
F: Tickets</a>
</h3></div></div></div>
<div class="informaltable"><table class="table">
Modified: sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/appendices/changes.html
==============================================================================
--- sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/appendices/changes.html (original)
+++ sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/appendices/changes.html 2009-10-08 15:42:54 EDT (Thu, 08 Oct 2009)
@@ -1,13 +1,13 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
-<title>Appendix A: History</title>
+<title> Appendix A: History</title>
<link rel="stylesheet" href="../../../../../../doc/html/boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
+<meta name="generator" content="DocBook XSL Stylesheets V1.69.1">
<link rel="start" href="../../index.html" title="Chapter 1. Toward.Boost.STM">
<link rel="up" href="../appendices.html" title="Appendices">
<link rel="prev" href="../appendices.html" title="Appendices">
-<link rel="next" href="rationale.html" title="Appendix B: Rationale">
+<link rel="next" href="rationale.html" title=" Appendix B: Rationale">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table cellpadding="2" width="100%"><tr>
@@ -24,13 +24,13 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h3 class="title">
-<a name="toward_boost_stm.appendices.changes"></a><a class="link" href="changes.html" title="Appendix A: History"> Appendix A: History</a>
+<a name="toward_boost_stm.appendices.changes"></a> Appendix A: History
</h3></div></div></div>
-<a name="toward_boost_stm.appendices.changes._emphasis_role__bold__version_0_1__xx_yy__2009__emphasis___emphasis_announcement_of_stm__emphasis_"></a><h5>
-<a name="id4898225"></a>
- <a class="link" href="changes.html#toward_boost_stm.appendices.changes._emphasis_role__bold__version_0_1__xx_yy__2009__emphasis___emphasis_announcement_of_stm__emphasis_"><span class="bold"><strong>Version 0.1, XX YY, 2009</strong></span> <span class="emphasis"><em>Announcement of
+<a name="toward_boost_stm.appendices.changes._emphasis_role__bold__version_0_1__xx_yy__2009__emphasis___emphasis_announcement_of_stm__emphasis_"></a><h4>
+<a name="id4858482"></a>
+ <a href="changes.html#toward_boost_stm.appendices.changes._emphasis_role__bold__version_0_1__xx_yy__2009__emphasis___emphasis_announcement_of_stm__emphasis_"><span class="bold"><strong>Version 0.1, XX YY, 2009</strong></span> <span class="emphasis"><em>Announcement of
STM</em></span></a>
- </h5>
+ </h4>
<p>
<span class="bold"><strong>Features:</strong></span>
</p>
@@ -46,10 +46,10 @@
Tested on cygwin gcc 3.4.6.
</li>
</ul></div>
-<a name="toward_boost_stm.appendices.changes._emphasis_role__bold__tickets___emphasis_"></a><h5>
-<a name="id4898297"></a>
- <a class="link" href="changes.html#toward_boost_stm.appendices.changes._emphasis_role__bold__tickets___emphasis_"><span class="bold"><strong>Tickets:</strong></span></a>
- </h5>
+<a name="toward_boost_stm.appendices.changes._emphasis_role__bold__tickets___emphasis_"></a><h4>
+<a name="id4858554"></a>
+ Tickets:
+ </h4>
<p>
<span class="bold"><strong>v0.1#1: .</strong></span>
</p>
Modified: sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/appendices/implementation.html
==============================================================================
--- sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/appendices/implementation.html (original)
+++ sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/appendices/implementation.html 2009-10-08 15:42:54 EDT (Thu, 08 Oct 2009)
@@ -1,13 +1,15 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
-<title>Appendix C: Implementation Notes</title>
+<title> Appendix
+ C: Implementation Notes</title>
<link rel="stylesheet" href="../../../../../../doc/html/boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
+<meta name="generator" content="DocBook XSL Stylesheets V1.69.1">
<link rel="start" href="../../index.html" title="Chapter 1. Toward.Boost.STM">
<link rel="up" href="../appendices.html" title="Appendices">
-<link rel="prev" href="rationale.html" title="Appendix B: Rationale">
-<link rel="next" href="acknowledgements.html" title="Appendix D: Acknowledgements">
+<link rel="prev" href="rationale.html" title=" Appendix B: Rationale">
+<link rel="next" href="acknowledgements.html" title=" Appendix
+ D: Acknowledgements">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table cellpadding="2" width="100%"><tr>
@@ -24,7 +26,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h3 class="title">
-<a name="toward_boost_stm.appendices.implementation"></a><a class="link" href="implementation.html" title="Appendix C: Implementation Notes"> Appendix
+<a name="toward_boost_stm.appendices.implementation"></a><a href="implementation.html" title=" Appendix
+ C: Implementation Notes"> Appendix
C: Implementation Notes</a>
</h3></div></div></div>
<div class="toc"><dl>
@@ -34,7 +37,8 @@
</dl></div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="toward_boost_stm.appendices.implementation.language_like_macro_blocks"></a><a class="link" href="implementation.html#toward_boost_stm.appendices.implementation.language_like_macro_blocks" title="Language-like macro blocks">Language-like
+<a name="toward_boost_stm.appendices.implementation.language_like_macro_blocks"></a><a href="implementation.html#toward_boost_stm.appendices.implementation.language_like_macro_blocks" title="Language-like
+ macro blocks">Language-like
macro blocks</a>
</h4></div></div></div>
<p>
@@ -48,11 +52,11 @@
exceptions. The preprocessor macros used for the locking and transaction
constructs are shown in Figures 6 and 8, respectively.
</p>
-<a name="toward_boost_stm.appendices.implementation.language_like_macro_blocks.locking_macros"></a><h6>
-<a name="id4913883"></a>
- <a class="link" href="implementation.html#toward_boost_stm.appendices.implementation.language_like_macro_blocks.locking_macros">Locking
+<a name="toward_boost_stm.appendices.implementation.language_like_macro_blocks.locking_macros"></a><h5>
+<a name="id4874082"></a>
+ <a href="implementation.html#toward_boost_stm.appendices.implementation.language_like_macro_blocks.locking_macros">Locking
Macros</a>
- </h6>
+ </h5>
<p>
The lock macros use an unoptimized if statement to ensure the variables
inside their local for loop are terminated for nonstandard conforming C++
@@ -71,11 +75,11 @@
until post_step() has been executed. This ensures the lock macro for loops
are executed once and only once.
</p>
-<a name="toward_boost_stm.appendices.implementation.language_like_macro_blocks.transaction_macros"></a><h6>
-<a name="id4913947"></a>
- <a class="link" href="implementation.html#toward_boost_stm.appendices.implementation.language_like_macro_blocks.transaction_macros">Transaction
+<a name="toward_boost_stm.appendices.implementation.language_like_macro_blocks.transaction_macros"></a><h5>
+<a name="id4874131"></a>
+ <a href="implementation.html#toward_boost_stm.appendices.implementation.language_like_macro_blocks.transaction_macros">Transaction
Macros</a>
- </h6>
+ </h5>
<p>
The preprocessor atomic macro for transactions is slightly more complex
than the preprocessor locking macros. The additional complexity behind
@@ -120,11 +124,11 @@
ensures any operations within the before_retry block are executed if the
transaction is aborted.
</p>
-<a name="toward_boost_stm.appendices.implementation.language_like_macro_blocks.correcting_non_compliant_compilers"></a><h6>
-<a name="id4914053"></a>
- <a class="link" href="implementation.html#toward_boost_stm.appendices.implementation.language_like_macro_blocks.correcting_non_compliant_compilers">Correcting
+<a name="toward_boost_stm.appendices.implementation.language_like_macro_blocks.correcting_non_compliant_compilers"></a><h5>
+<a name="id4874218"></a>
+ <a href="implementation.html#toward_boost_stm.appendices.implementation.language_like_macro_blocks.correcting_non_compliant_compilers">Correcting
Non-Compliant Compilers</a>
- </h6>
+ </h5>
<p>
The <code class="computeroutput"><span class="keyword">if</span> <span class="special">(</span><span class="number">0</span> <span class="special">==</span> <span class="identifier">rand</span><span class="special">()+</span><span class="number">1</span><span class="special">)</span>
<span class="special">{}</span> <span class="keyword">else</span></code>
@@ -151,16 +155,16 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="toward_boost_stm.appendices.implementation.cache"></a><a class="link" href="implementation.html#toward_boost_stm.appendices.implementation.cache" title="Cache">Cache</a>
+<a name="toward_boost_stm.appendices.implementation.cache"></a>Cache
</h4></div></div></div>
-<a name="toward_boost_stm.appendices.implementation.cache.dispersed"></a><h6>
-<a name="id4914181"></a>
- <a class="link" href="implementation.html#toward_boost_stm.appendices.implementation.cache.dispersed">Dispersed</a>
- </h6>
-<a name="toward_boost_stm.appendices.implementation.cache.compact"></a><h6>
-<a name="id4914202"></a>
- <a class="link" href="implementation.html#toward_boost_stm.appendices.implementation.cache.compact">Compact</a>
- </h6>
+<a name="toward_boost_stm.appendices.implementation.cache.dispersed"></a><h5>
+<a name="id4874346"></a>
+ Dispersed
+ </h5>
+<a name="toward_boost_stm.appendices.implementation.cache.compact"></a><h5>
+<a name="id4874368"></a>
+ Compact
+ </h5>
</div>
</div>
<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
Modified: sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/appendices/rationale.html
==============================================================================
--- sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/appendices/rationale.html (original)
+++ sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/appendices/rationale.html 2009-10-08 15:42:54 EDT (Thu, 08 Oct 2009)
@@ -1,13 +1,14 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
-<title>Appendix B: Rationale</title>
+<title> Appendix B: Rationale</title>
<link rel="stylesheet" href="../../../../../../doc/html/boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
+<meta name="generator" content="DocBook XSL Stylesheets V1.69.1">
<link rel="start" href="../../index.html" title="Chapter 1. Toward.Boost.STM">
<link rel="up" href="../appendices.html" title="Appendices">
-<link rel="prev" href="changes.html" title="Appendix A: History">
-<link rel="next" href="implementation.html" title="Appendix C: Implementation Notes">
+<link rel="prev" href="changes.html" title=" Appendix A: History">
+<link rel="next" href="implementation.html" title=" Appendix
+ C: Implementation Notes">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table cellpadding="2" width="100%"><tr>
@@ -24,7 +25,7 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h3 class="title">
-<a name="toward_boost_stm.appendices.rationale"></a><a class="link" href="rationale.html" title="Appendix B: Rationale"> Appendix B: Rationale</a>
+<a name="toward_boost_stm.appendices.rationale"></a> Appendix B: Rationale
</h3></div></div></div>
<div class="toc"><dl>
<dt><span class="section"><a href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts">TM-Specific
@@ -81,7 +82,8 @@
</dl></div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="toward_boost_stm.appendices.rationale.tm_specific_concepts"></a><a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts" title="TM-Specific Concepts">TM-Specific
+<a name="toward_boost_stm.appendices.rationale.tm_specific_concepts"></a><a href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts" title="TM-Specific
+ Concepts">TM-Specific
Concepts</a>
</h4></div></div></div>
<div class="toc"><dl>
@@ -113,12 +115,14 @@
transactions to manage with I/O</a></span></dt>
</dl></div>
<div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.appendices.rationale.tm_specific_concepts.optimistic_concurrency"></a><a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.optimistic_concurrency" title="Optimistic concurrency">Optimistic
+<a name="toward_boost_stm.appendices.rationale.tm_specific_concepts.optimistic_concurrency"></a><a href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.optimistic_concurrency" title="Optimistic
+ concurrency">Optimistic
concurrency</a>
</h5></div></div></div></div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.appendices.rationale.tm_specific_concepts.aci_transactions"></a><a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.aci_transactions" title="ACI transactions">ACI
+<a name="toward_boost_stm.appendices.rationale.tm_specific_concepts.aci_transactions"></a><a href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.aci_transactions" title="ACI
+ transactions">ACI
transactions</a>
</h5></div></div></div>
<p>
@@ -168,7 +172,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.appendices.rationale.tm_specific_concepts.stm_synchronization_types"></a><a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.stm_synchronization_types" title="STM Synchronization Types">STM
+<a name="toward_boost_stm.appendices.rationale.tm_specific_concepts.stm_synchronization_types"></a><a href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.stm_synchronization_types" title="STM
+ Synchronization Types">STM
Synchronization Types</a>
</h5></div></div></div>
<p>
@@ -214,7 +219,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.appendices.rationale.tm_specific_concepts.updating_policies"></a><a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.updating_policies" title="Updating policies">Updating
+<a name="toward_boost_stm.appendices.rationale.tm_specific_concepts.updating_policies"></a><a href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.updating_policies" title="Updating
+ policies">Updating
policies</a>
</h5></div></div></div>
<p>
@@ -247,7 +253,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.appendices.rationale.tm_specific_concepts.conflict_detection"></a><a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.conflict_detection" title="Conflict Detection">Conflict
+<a name="toward_boost_stm.appendices.rationale.tm_specific_concepts.conflict_detection"></a><a href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.conflict_detection" title="Conflict
+ Detection">Conflict
Detection</a>
</h5></div></div></div>
<p>
@@ -260,8 +267,8 @@
read).
</p>
<div class="table">
-<a name="id4898826"></a><p class="title"><b>Table 1.1. Comparaison with other STM systems</b></p>
-<div class="table-contents"><table class="table" summary="Comparaison with other STM systems">
+<a name="id4859071"></a><p class="title"><b>Table 1.1. Comparaison with other STM systems</b></p>
+<table class="table" summary="Comparaison with other STM systems">
<colgroup>
<col>
<col>
@@ -320,9 +327,9 @@
</td>
</tr>
</tbody>
-</table></div>
+</table>
</div>
-<br class="table-break"><p>
+<p>
Before determining how to handle a conflict, STM systems must determine
when they will detect conflicts. There are two primary ways to detect
conflicts:
@@ -352,7 +359,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.appendices.rationale.tm_specific_concepts.consistency_checking_policies"></a><a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.consistency_checking_policies" title="Consistency checking policies">Consistency
+<a name="toward_boost_stm.appendices.rationale.tm_specific_concepts.consistency_checking_policies"></a><a href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.consistency_checking_policies" title="Consistency
+ checking policies">Consistency
checking policies</a>
</h5></div></div></div>
<p>
@@ -443,7 +451,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.appendices.rationale.tm_specific_concepts.consistency_versus_updating_policies_composition"></a><a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.consistency_versus_updating_policies_composition" title="Consistency versus Updating policies composition">Consistency
+<a name="toward_boost_stm.appendices.rationale.tm_specific_concepts.consistency_versus_updating_policies_composition"></a><a href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.consistency_versus_updating_policies_composition" title="Consistency
+ versus Updating policies composition">Consistency
versus Updating policies composition</a>
</h5></div></div></div>
<p>
@@ -463,8 +472,8 @@
handle each specific problem with the most appropriate configuration.
</p>
<div class="table">
-<a name="id4899202"></a><p class="title"><b>Table 1.2. Consistency versus Updating policies composition</b></p>
-<div class="table-contents"><table class="table" summary="Consistency versus Updating policies composition">
+<a name="id4859447"></a><p class="title"><b>Table 1.2. Consistency versus Updating policies composition</b></p>
+<table class="table" summary="Consistency versus Updating policies composition">
<colgroup>
<col>
<col>
@@ -523,13 +532,13 @@
</td>
</tr>
</tbody>
-</table></div>
+</table>
</div>
-<br class="table-break">
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.appendices.rationale.tm_specific_concepts.memory_granularity"></a><a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.memory_granularity" title="Memory Granularity">Memory
+<a name="toward_boost_stm.appendices.rationale.tm_specific_concepts.memory_granularity"></a><a href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.memory_granularity" title="Memory
+ Granularity">Memory
Granularity</a>
</h5></div></div></div>
<p>
@@ -546,7 +555,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.appendices.rationale.tm_specific_concepts.memory_rollback_capability"></a><a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.memory_rollback_capability" title="Memory Rollback Capability">Memory
+<a name="toward_boost_stm.appendices.rationale.tm_specific_concepts.memory_rollback_capability"></a><a href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.memory_rollback_capability" title="Memory
+ Rollback Capability">Memory
Rollback Capability</a>
</h5></div></div></div>
<p>
@@ -580,7 +590,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.appendices.rationale.tm_specific_concepts.composable_transactions"></a><a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.composable_transactions" title="Composable transactions">Composable
+<a name="toward_boost_stm.appendices.rationale.tm_specific_concepts.composable_transactions"></a><a href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.composable_transactions" title="Composable
+ transactions">Composable
transactions</a>
</h5></div></div></div>
<p>
@@ -611,12 +622,13 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.appendices.rationale.tm_specific_concepts.contention_management"></a><a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.contention_management" title="Contention management">Contention
+<a name="toward_boost_stm.appendices.rationale.tm_specific_concepts.contention_management"></a><a href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.contention_management" title="Contention
+ management">Contention
management</a>
</h5></div></div></div>
<a name="toward_boost_stm.appendices.rationale.tm_specific_concepts.contention_management.priority_based_tasks"></a><h6>
-<a name="id4899534"></a>
- <a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.contention_management.priority_based_tasks">Priority-Based
+<a name="id4859766"></a>
+ <a href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.contention_management.priority_based_tasks">Priority-Based
Tasks</a>
</h6>
<p>
@@ -630,8 +642,8 @@
cases, user-defined priority-based transactions are necessary.
</p>
<a name="toward_boost_stm.appendices.rationale.tm_specific_concepts.contention_management.approach"></a><h6>
-<a name="id4899573"></a>
- <a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.contention_management.approach">Approach</a>
+<a name="id4859805"></a>
+ Approach
</h6>
<p>
This work extends the prior TM contention management research by concretely
@@ -646,8 +658,8 @@
checking models. Last, we present our experimental results.
</p>
<a name="toward_boost_stm.appendices.rationale.tm_specific_concepts.contention_management.attacking__amp__victim_transactions"></a><h6>
-<a name="id4899611"></a>
- <a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.contention_management.attacking__amp__victim_transactions">Attacking
+<a name="id4859844"></a>
+ <a href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.contention_management.attacking__amp__victim_transactions">Attacking
& Victim Transactions</a>
</h6>
<p>
@@ -666,8 +678,8 @@
transaction since Ta may abort it.
</p>
<a name="toward_boost_stm.appendices.rationale.tm_specific_concepts.contention_management.user_defined_priority_based_transactions"></a><h6>
-<a name="id4899660"></a>
- <a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.contention_management.user_defined_priority_based_transactions">User-Defined
+<a name="id4859892"></a>
+ <a href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.contention_management.user_defined_priority_based_transactions">User-Defined
Priority-Based Transactions</a>
</h6>
<p>
@@ -687,8 +699,8 @@
priority-based transactional environments.
</p>
<a name="toward_boost_stm.appendices.rationale.tm_specific_concepts.contention_management.extensible_polymorphic_contention_management_interface"></a><h6>
-<a name="id4899709"></a>
- <a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.contention_management.extensible_polymorphic_contention_management_interface">Extensible
+<a name="id4859942"></a>
+ <a href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.contention_management.extensible_polymorphic_contention_management_interface">Extensible
Polymorphic Contention Management Interface</a>
</h6>
<p>
@@ -755,7 +767,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.appendices.rationale.tm_specific_concepts.lock_aware_transaction"></a><a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.lock_aware_transaction" title="Lock-aware transaction">Lock-aware
+<a name="toward_boost_stm.appendices.rationale.tm_specific_concepts.lock_aware_transaction"></a><a href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.lock_aware_transaction" title="Lock-aware
+ transaction">Lock-aware
transaction</a>
</h5></div></div></div>
<p>
@@ -781,8 +794,8 @@
of experimental benchmarks on .
</p>
<a name="toward_boost_stm.appendices.rationale.tm_specific_concepts.lock_aware_transaction.introduction"></a><h6>
-<a name="id4900448"></a>
- <a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.lock_aware_transaction.introduction">Introduction</a>
+<a name="id4860648"></a>
+ Introduction
</h6>
<p>
Yet, for all of the benefits of transactional programming, its native
@@ -834,8 +847,8 @@
</li>
</ol></div>
<a name="toward_boost_stm.appendices.rationale.tm_specific_concepts.lock_aware_transaction.background"></a><h6>
-<a name="id4900549"></a>
- <a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.lock_aware_transaction.background">Background</a>
+<a name="id4860748"></a>
+ Background
</h6>
<p>
Transaction-lock interaction does not natively exhibit shared memory
@@ -945,8 +958,8 @@
later sections.
</p>
<a name="toward_boost_stm.appendices.rationale.tm_specific_concepts.lock_aware_transaction.locks_outside_of_transactions__lot_"></a><h6>
-<a name="id4901115"></a>
- <a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.lock_aware_transaction.locks_outside_of_transactions__lot_">Locks
+<a name="id4861322"></a>
+ <a href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.lock_aware_transaction.locks_outside_of_transactions__lot_">Locks
Outside of Transactions (LoT)</a>
</h6>
<p>
@@ -996,8 +1009,8 @@
<span class="number">27</span> <span class="keyword">int</span> <span class="identifier">lock3</span><span class="special">()</span> <span class="special">{</span> <span class="comment">/* no conflict */</span> <span class="special">}</span>
</pre>
<a name="toward_boost_stm.appendices.rationale.tm_specific_concepts.lock_aware_transaction.lot_full_lock_protection"></a><h6>
-<a name="id4902256"></a>
- <a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.lock_aware_transaction.lot_full_lock_protection">LoT
+<a name="id4862463"></a>
+ <a href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.lock_aware_transaction.lot_full_lock_protection">LoT
Full Lock Protection</a>
</h6>
<p>
@@ -1026,8 +1039,8 @@
stalling.
</p>
<a name="toward_boost_stm.appendices.rationale.tm_specific_concepts.lock_aware_transaction.lot_tm_lock_protection"></a><h6>
-<a name="id4902337"></a>
- <a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.lock_aware_transaction.lot_tm_lock_protection">LoT
+<a name="id4862525"></a>
+ <a href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.lock_aware_transaction.lot_tm_lock_protection">LoT
TM-Lock Protection</a>
</h6>
<p>
@@ -1069,8 +1082,8 @@
the third lock protection policy.
</p>
<a name="toward_boost_stm.appendices.rationale.tm_specific_concepts.lock_aware_transaction.lot_tx_lock_protection"></a><h6>
-<a name="id4902510"></a>
- <a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.lock_aware_transaction.lot_tx_lock_protection">LoT
+<a name="id4862699"></a>
+ <a href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.lock_aware_transaction.lot_tx_lock_protection">LoT
TX-Lock Protection</a>
</h6>
<p>
@@ -1112,8 +1125,8 @@
cooperative performance while still adhering to the rule.
</p>
<a name="toward_boost_stm.appendices.rationale.tm_specific_concepts.lock_aware_transaction.locks_inside_of_transactions__lit_"></a><h6>
-<a name="id4903035"></a>
- <a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.lock_aware_transaction.locks_inside_of_transactions__lit_">Locks
+<a name="id4863233"></a>
+ <a href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.lock_aware_transaction.locks_inside_of_transactions__lit_">Locks
Inside of Transactions (LiT)</a>
</h6>
<p>
@@ -1226,8 +1239,8 @@
for the completeness of the example.
</p>
<a name="toward_boost_stm.appendices.rationale.tm_specific_concepts.lock_aware_transaction.lit_full_lock_protection"></a><h6>
-<a name="id4904093"></a>
- <a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.lock_aware_transaction.lit_full_lock_protection">LiT
+<a name="id4864308"></a>
+ <a href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.lock_aware_transaction.lit_full_lock_protection">LiT
Full-Lock Protection</a>
</h6>
<p>
@@ -1256,8 +1269,8 @@
are all allowed to resume.
</p>
<a name="toward_boost_stm.appendices.rationale.tm_specific_concepts.lock_aware_transaction.lit_tm_lock_protection"></a><h6>
-<a name="id4904154"></a>
- <a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.lock_aware_transaction.lit_tm_lock_protection">LiT
+<a name="id4864369"></a>
+ <a href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.lock_aware_transaction.lit_tm_lock_protection">LiT
TM-Lock Protection</a>
</h6>
<p>
@@ -1286,8 +1299,8 @@
LiT protection policy, LiT TX-lock protection.
</p>
<a name="toward_boost_stm.appendices.rationale.tm_specific_concepts.lock_aware_transaction.lit_tx_lock_protection"></a><h6>
-<a name="id4904216"></a>
- <a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.lock_aware_transaction.lit_tx_lock_protection">LiT
+<a name="id4864431"></a>
+ <a href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.lock_aware_transaction.lit_tx_lock_protection">LiT
TX-Lock Protection</a>
</h6>
<p>
@@ -1326,8 +1339,8 @@
passed. When lockL3 completes tx3 begins and runs through to completion.
</p>
<a name="toward_boost_stm.appendices.rationale.tm_specific_concepts.lock_aware_transaction.lock_composition"></a><h6>
-<a name="id4904312"></a>
- <a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.lock_aware_transaction.lock_composition">Lock
+<a name="id4864526"></a>
+ <a href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.lock_aware_transaction.lock_composition">Lock
Composition</a>
</h6>
<p>
@@ -1410,8 +1423,8 @@
lock until the transaction commits.
</p>
<a name="toward_boost_stm.appendices.rationale.tm_specific_concepts.lock_aware_transaction.criticality_of_lit_lock_composition"></a><h6>
-<a name="id4905032"></a>
- <a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.lock_aware_transaction.criticality_of_lit_lock_composition">Criticality
+<a name="id4865247"></a>
+ <a href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.lock_aware_transaction.criticality_of_lit_lock_composition">Criticality
of LiT Lock Composition</a>
</h6>
<p>
@@ -1461,8 +1474,8 @@
cumulative affects of the move() operation.
</p>
<a name="toward_boost_stm.appendices.rationale.tm_specific_concepts.lock_aware_transaction.understanding_lit_lock_composition"></a><h6>
-<a name="id4905643"></a>
- <a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.lock_aware_transaction.understanding_lit_lock_composition">Understanding
+<a name="id4865858"></a>
+ <a href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.lock_aware_transaction.understanding_lit_lock_composition">Understanding
LiT Lock Composition</a>
</h6>
<p>
@@ -1550,8 +1563,8 @@
shared memory x2.
</p>
<a name="toward_boost_stm.appendices.rationale.tm_specific_concepts.lock_aware_transaction.lit_lock_identification"></a><h6>
-<a name="id4906719"></a>
- <a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.lock_aware_transaction.lit_lock_identification">LiT
+<a name="id4866934"></a>
+ <a href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.lock_aware_transaction.lit_lock_identification">LiT
Lock Identification</a>
</h6>
<p>
@@ -1591,13 +1604,15 @@
</p>
</div>
<div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.appendices.rationale.tm_specific_concepts.unrecoverable_transactions_to_manage_with_i_o"></a><a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.unrecoverable_transactions_to_manage_with_i_o" title="Unrecoverable transactions to manage with I/O">Unrecoverable
+<a name="toward_boost_stm.appendices.rationale.tm_specific_concepts.unrecoverable_transactions_to_manage_with_i_o"></a><a href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.unrecoverable_transactions_to_manage_with_i_o" title="Unrecoverable
+ transactions to manage with I/O">Unrecoverable
transactions to manage with I/O</a>
</h5></div></div></div></div>
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="toward_boost_stm.appendices.rationale.c___and_library_specific_concepts"></a><a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.c___and_library_specific_concepts" title="C++ and Library-Specific Concepts">C++
+<a name="toward_boost_stm.appendices.rationale.c___and_library_specific_concepts"></a><a href="rationale.html#toward_boost_stm.appendices.rationale.c___and_library_specific_concepts" title="C++
+ and Library-Specific Concepts">C++
and Library-Specific Concepts</a>
</h4></div></div></div>
<div class="toc"><dl>
@@ -1623,7 +1638,8 @@
</p>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.native_language_compatibility"></a><a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.native_language_compatibility" title="Native Language Compatibility">Native
+<a name="toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.native_language_compatibility"></a><a href="rationale.html#toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.native_language_compatibility" title="Native
+ Language Compatibility">Native
Language Compatibility</a>
</h5></div></div></div>
<p>
@@ -1646,7 +1662,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.memory_management"></a><a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.memory_management" title="Memory Management">Memory
+<a name="toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.memory_management"></a><a href="rationale.html#toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.memory_management" title="Memory
+ Management">Memory
Management</a>
</h5></div></div></div>
<p>
@@ -1692,7 +1709,7 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.raii"></a><a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.raii" title="RAII">RAII</a>
+<a name="toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.raii"></a>RAII
</h5></div></div></div>
<p>
An STM system needs a transaction interface to identify where transactions
@@ -1728,7 +1745,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.mixin_versus_wrapper_helpers"></a><a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.mixin_versus_wrapper_helpers" title="Mixin versus wrapper helpers">Mixin
+<a name="toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.mixin_versus_wrapper_helpers"></a><a href="rationale.html#toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.mixin_versus_wrapper_helpers" title="Mixin
+ versus wrapper helpers">Mixin
versus wrapper helpers</a>
</h5></div></div></div>
<p>
@@ -1855,8 +1873,8 @@
The following table is a compilation of the preceding analysis:
</p>
<div class="table">
-<a name="id4907272"></a><p class="title"><b>Table 1.3. Comparaison with other STM systems</b></p>
-<div class="table-contents"><table class="table" summary="Comparaison with other STM systems">
+<a name="id4867493"></a><p class="title"><b>Table 1.3. Comparaison with other STM systems</b></p>
+<table class="table" summary="Comparaison with other STM systems">
<colgroup><col></colgroup>
<thead><tr>
<th>
@@ -1910,9 +1928,9 @@
<td class="auto-generated"> </td>
</tr>
</tbody>
-</table></div>
+</table>
</div>
-<br class="table-break"><pre class="programlisting"><span class="special">[</span>
+<pre class="programlisting"><span class="special">[</span>
<span class="special">[[*</span><span class="identifier">existing</span> <span class="identifier">variable</span><span class="special">]]</span> <span class="special">[[</span><span class="identifier">No</span><span class="special">]]</span> <span class="special">[[</span><span class="identifier">No</span><span class="special">]]</span> <span class="special">[[*</span><span class="identifier">Yes</span><span class="special">]]</span>
<span class="special">]</span>
<span class="special">[</span>
@@ -1945,7 +1963,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.why___boost_stm_s___cache_uses_now_memcpy_instead_of_copy_constructor_and_assignement"></a><a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.why___boost_stm_s___cache_uses_now_memcpy_instead_of_copy_constructor_and_assignement" title="Why TBoost.STM's cache uses now memcpy instead of copy-constructor and assignement">Why
+<a name="toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.why___boost_stm_s___cache_uses_now_memcpy_instead_of_copy_constructor_and_assignement"></a><a href="rationale.html#toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.why___boost_stm_s___cache_uses_now_memcpy_instead_of_copy_constructor_and_assignement" title="Why
+ TBoost.STM's cache uses now memcpy instead of copy-constructor and assignement">Why
TBoost.STM's cache uses now memcpy instead of copy-constructor and assignement</a>
</h5></div></div></div>
<div class="toc"><dl>
@@ -1977,7 +1996,7 @@
</p>
<div class="section" lang="en">
<div class="titlepage"><div><div><h6 class="title">
-<a name="toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.why___boost_stm_s___cache_uses_now_memcpy_instead_of_copy_constructor_and_assignement.domain"></a><a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.why___boost_stm_s___cache_uses_now_memcpy_instead_of_copy_constructor_and_assignement.domain" title="Domain">Domain</a>
+<a name="toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.why___boost_stm_s___cache_uses_now_memcpy_instead_of_copy_constructor_and_assignement.domain"></a>Domain
</h6></div></div></div>
<p>
It seems a hard limitation to force a STM user to make all its classes
@@ -1986,7 +2005,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h6 class="title">
-<a name="toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.why___boost_stm_s___cache_uses_now_memcpy_instead_of_copy_constructor_and_assignement.exception_safety"></a><a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.why___boost_stm_s___cache_uses_now_memcpy_instead_of_copy_constructor_and_assignement.exception_safety" title="Exception Safety">Exception
+<a name="toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.why___boost_stm_s___cache_uses_now_memcpy_instead_of_copy_constructor_and_assignement.exception_safety"></a><a href="rationale.html#toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.why___boost_stm_s___cache_uses_now_memcpy_instead_of_copy_constructor_and_assignement.exception_safety" title="Exception
+ Safety">Exception
Safety</a>
</h6></div></div></div>
<p>
@@ -2026,7 +2046,7 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h6 class="title">
-<a name="toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.why___boost_stm_s___cache_uses_now_memcpy_instead_of_copy_constructor_and_assignement.performances"></a><a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.why___boost_stm_s___cache_uses_now_memcpy_instead_of_copy_constructor_and_assignement.performances" title="Performances">Performances</a>
+<a name="toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.why___boost_stm_s___cache_uses_now_memcpy_instead_of_copy_constructor_and_assignement.performances"></a>Performances
</h6></div></div></div>
<p>
Another problem with the copy is that we will need to copy the whole
@@ -2078,7 +2098,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.move_semantics"></a><a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.move_semantics" title="Move semantics">Move
+<a name="toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.move_semantics"></a><a href="rationale.html#toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.move_semantics" title="Move
+ semantics">Move
semantics</a>
</h5></div></div></div>
<p>
@@ -2090,7 +2111,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.parametric_polymorphism_and_subtype_polymorphism"></a><a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.parametric_polymorphism_and_subtype_polymorphism" title="Parametric Polymorphism and Subtype Polymorphism">Parametric
+<a name="toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.parametric_polymorphism_and_subtype_polymorphism"></a><a href="rationale.html#toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.parametric_polymorphism_and_subtype_polymorphism" title="Parametric
+ Polymorphism and Subtype Polymorphism">Parametric
Polymorphism and Subtype Polymorphism</a>
</h5></div></div></div>
<p>
@@ -2123,7 +2145,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.language_like_macro_blocks"></a><a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.language_like_macro_blocks" title="Language-like macro blocks">Language-like
+<a name="toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.language_like_macro_blocks"></a><a href="rationale.html#toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.language_like_macro_blocks" title="Language-like
+ macro blocks">Language-like
macro blocks</a>
</h5></div></div></div>
<p>
@@ -2136,8 +2159,8 @@
support in the near future [4].
</p>
<div class="table">
-<a name="id4908420"></a><p class="title"><b>Table 1.4. Comparaison with other STM systems</b></p>
-<div class="table-contents"><table class="table" summary="Comparaison with other STM systems">
+<a name="id4868617"></a><p class="title"><b>Table 1.4. Comparaison with other STM systems</b></p>
+<table class="table" summary="Comparaison with other STM systems">
<colgroup>
<col>
<col>
@@ -2228,14 +2251,14 @@
</td>
</tr>
</tbody>
-</table></div>
+</table>
</div>
-<br class="table-break"><p>
+<p>
Table 1. TBoost.STM Mutual Exclusion Locking Parallel Constructs.
</p>
<a name="toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.language_like_macro_blocks.library_based_lock_implementations"></a><h6>
-<a name="id4908628"></a>
- <a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.language_like_macro_blocks.library_based_lock_implementations">Library-based
+<a name="id4868825"></a>
+ <a href="rationale.html#toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.language_like_macro_blocks.library_based_lock_implementations">Library-based
Lock Implementations</a>
</h6>
<p>
@@ -2282,8 +2305,8 @@
scoping and programmer error.
</p>
<a name="toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.language_like_macro_blocks.pitfalls_in_scoping_of_automatic_object_locks"></a><h6>
-<a name="id4909025"></a>
- <a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.language_like_macro_blocks.pitfalls_in_scoping_of_automatic_object_locks">Pitfalls
+<a name="id4869222"></a>
+ <a href="rationale.html#toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.language_like_macro_blocks.pitfalls_in_scoping_of_automatic_object_locks">Pitfalls
in Scoping of Automatic Object Locks</a>
</h6>
<p>
@@ -2355,8 +2378,8 @@
of locks results in unoptimized performance.
</p>
<a name="toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.language_like_macro_blocks.library_based_transaction_implementations"></a><h6>
-<a name="id4909460"></a>
- <a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.language_like_macro_blocks.library_based_transaction_implementations">Library-based
+<a name="id4869658"></a>
+ <a href="rationale.html#toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.language_like_macro_blocks.library_based_transaction_implementations">Library-based
Transaction Implementations</a>
</h6>
<p>
@@ -2409,8 +2432,8 @@
behaviors.
</p>
<a name="toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.language_like_macro_blocks.pitfalls_in_transactional_execution_of_automatic_objects"></a><h6>
-<a name="id4909847"></a>
- <a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.language_like_macro_blocks.pitfalls_in_transactional_execution_of_automatic_objects">Pitfalls
+<a name="id4870045"></a>
+ <a href="rationale.html#toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.language_like_macro_blocks.pitfalls_in_transactional_execution_of_automatic_objects">Pitfalls
in Transactional Execution of Automatic Objects</a>
</h6>
<p>
@@ -2504,8 +2527,8 @@
of direct language integration of TM instead of API-only approaches.
</p>
<a name="toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.language_like_macro_blocks.disadvantages_of_language_based_transactional_integration"></a><h6>
-<a name="id4910845"></a>
- <a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.language_like_macro_blocks.disadvantages_of_language_based_transactional_integration">Disadvantages
+<a name="id4871056"></a>
+ <a href="rationale.html#toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.language_like_macro_blocks.disadvantages_of_language_based_transactional_integration">Disadvantages
of Language Based Transactional Integration</a>
</h6>
<p>
@@ -2541,8 +2564,8 @@
objects nor language-based parallel abstractions alone can provide.
</p>
<a name="toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.language_like_macro_blocks.parallel_constructs_for_mutually_exclusive_locks"></a><h6>
-<a name="id4910938"></a>
- <a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.language_like_macro_blocks.parallel_constructs_for_mutually_exclusive_locks">Parallel
+<a name="id4871133"></a>
+ <a href="rationale.html#toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.language_like_macro_blocks.parallel_constructs_for_mutually_exclusive_locks">Parallel
Constructs for Mutually Exclusive Locks</a>
</h6>
<p>
@@ -2577,8 +2600,8 @@
in client code.
</p>
<a name="toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.language_like_macro_blocks.exception_based_timed_locks"></a><h6>
-<a name="id4911441"></a>
- <a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.language_like_macro_blocks.exception_based_timed_locks">Exception-based
+<a name="id4871635"></a>
+ <a href="rationale.html#toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.language_like_macro_blocks.exception_based_timed_locks">Exception-based
Timed Locks</a>
</h6>
<p>
@@ -2664,8 +2687,8 @@
<span class="identifier">Figure</span> <span class="number">12.</span> <span class="identifier">Optimized</span> <span class="identifier">Timed</span> <span class="identifier">Locking</span> <span class="identifier">with</span> TBoost.STM<span class="special">.</span>
</pre>
<a name="toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.language_like_macro_blocks.parallel_constructs_for_transactional_memory"></a><h6>
-<a name="id4912700"></a>
- <a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.language_like_macro_blocks.parallel_constructs_for_transactional_memory">Parallel
+<a name="id4872895"></a>
+ <a href="rationale.html#toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.language_like_macro_blocks.parallel_constructs_for_transactional_memory">Parallel
Constructs for Transactional Memory</a>
</h6>
<p>
@@ -2742,8 +2765,8 @@
correct behavior and then throwing an exception upward.
</p>
<a name="toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.language_like_macro_blocks.transaction_nesting"></a><h6>
-<a name="id4913345"></a>
- <a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.language_like_macro_blocks.transaction_nesting">Transaction
+<a name="id4873552"></a>
+ <a href="rationale.html#toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.language_like_macro_blocks.transaction_nesting">Transaction
Nesting</a>
</h6>
<p>
@@ -2798,13 +2821,14 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="toward_boost_stm.appendices.rationale.comparaison_with_other_stm_systems"></a><a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.comparaison_with_other_stm_systems" title="Comparaison with other STM systems">Comparaison
+<a name="toward_boost_stm.appendices.rationale.comparaison_with_other_stm_systems"></a><a href="rationale.html#toward_boost_stm.appendices.rationale.comparaison_with_other_stm_systems" title="Comparaison
+ with other STM systems">Comparaison
with other STM systems</a>
</h4></div></div></div>
<div class="table">
-<a name="id4913465"></a><p class="title"><b>Table 1.5. Comparaison
+<a name="id4873664"></a><p class="title"><b>Table 1.5. Comparaison
with other STM systems</b></p>
-<div class="table-contents"><table class="table" summary="Comparaison
+<table class="table" summary="Comparaison
with other STM systems">
<colgroup>
<col>
@@ -2966,9 +2990,8 @@
</td>
</tr>
</tbody>
-</table></div>
+</table>
</div>
-<br class="table-break">
</div>
</div>
<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
Modified: sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/appendices/todo.html
==============================================================================
--- sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/appendices/todo.html (original)
+++ sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/appendices/todo.html 2009-10-08 15:42:54 EDT (Thu, 08 Oct 2009)
@@ -1,12 +1,14 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
-<title>Appendix E: Future plans</title>
+<title> Appendix E: Future
+ plans</title>
<link rel="stylesheet" href="../../../../../../doc/html/boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
+<meta name="generator" content="DocBook XSL Stylesheets V1.69.1">
<link rel="start" href="../../index.html" title="Chapter 1. Toward.Boost.STM">
<link rel="up" href="../appendices.html" title="Appendices">
-<link rel="prev" href="appendix_f__tickets.html" title="Appendix F: Tickets">
+<link rel="prev" href="appendix_f__tickets.html" title="Appendix
+ F: Tickets">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table cellpadding="2" width="100%"><tr>
@@ -23,7 +25,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h3 class="title">
-<a name="toward_boost_stm.appendices.todo"></a><a class="link" href="todo.html" title="Appendix E: Future plans"> Appendix E: Future
+<a name="toward_boost_stm.appendices.todo"></a><a href="todo.html" title=" Appendix E: Future
+ plans"> Appendix E: Future
plans</a>
</h3></div></div></div>
<div class="toc"><dl>
@@ -36,13 +39,14 @@
</dl></div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="toward_boost_stm.appendices.todo.tasks_to_do_before_review"></a><a class="link" href="todo.html#toward_boost_stm.appendices.todo.tasks_to_do_before_review" title="Tasks to do before review">Tasks
+<a name="toward_boost_stm.appendices.todo.tasks_to_do_before_review"></a><a href="todo.html#toward_boost_stm.appendices.todo.tasks_to_do_before_review" title="Tasks
+ to do before review">Tasks
to do before review</a>
</h4></div></div></div>
-<a name="toward_boost_stm.appendices.todo.tasks_to_do_before_review.interface"></a><h6>
-<a name="id4914537"></a>
- <a class="link" href="todo.html#toward_boost_stm.appendices.todo.tasks_to_do_before_review.interface">Interface</a>
- </h6>
+<a name="toward_boost_stm.appendices.todo.tasks_to_do_before_review.interface"></a><h5>
+<a name="id4874703"></a>
+ Interface
+ </h5>
<div class="itemizedlist"><ul type="disc">
<li>
<span class="bold"><strong>DONE</strong></span> Adding transactional smart pointers.
@@ -58,11 +62,11 @@
types.
</li>
</ul></div>
-<a name="toward_boost_stm.appendices.todo.tasks_to_do_before_review.boostifying_stm"></a><h6>
-<a name="id4914598"></a>
- <a class="link" href="todo.html#toward_boost_stm.appendices.todo.tasks_to_do_before_review.boostifying_stm">Boostifying
+<a name="toward_boost_stm.appendices.todo.tasks_to_do_before_review.boostifying_stm"></a><h5>
+<a name="id4874758"></a>
+ <a href="todo.html#toward_boost_stm.appendices.todo.tasks_to_do_before_review.boostifying_stm">Boostifying
STM</a>
- </h6>
+ </h5>
<div class="itemizedlist"><ul type="disc">
<li>
<span class="bold"><strong>DONE</strong></span> set boost directory architecture
@@ -134,10 +138,10 @@
Replace blom_filter by the Boost.BlomFilter blom_filter
</li>
</ul></div>
-<a name="toward_boost_stm.appendices.todo.tasks_to_do_before_review.implementation"></a><h6>
-<a name="id4914776"></a>
- <a class="link" href="todo.html#toward_boost_stm.appendices.todo.tasks_to_do_before_review.implementation">Implementation</a>
- </h6>
+<a name="toward_boost_stm.appendices.todo.tasks_to_do_before_review.implementation"></a><h5>
+<a name="id4874936"></a>
+ Implementation
+ </h5>
<div class="itemizedlist"><ul type="disc">
<li>
<span class="bold"><strong>DONE</strong></span> Separate the data that is global,
@@ -156,24 +160,24 @@
in order to improve the lookup performance when using smart pointers.
</li>
</ul></div>
-<a name="toward_boost_stm.appendices.todo.tasks_to_do_before_review.tests"></a><h6>
-<a name="id4914835"></a>
- <a class="link" href="todo.html#toward_boost_stm.appendices.todo.tasks_to_do_before_review.tests">Tests</a>
- </h6>
+<a name="toward_boost_stm.appendices.todo.tasks_to_do_before_review.tests"></a><h5>
+<a name="id4874995"></a>
+ Tests
+ </h5>
<div class="itemizedlist"><ul type="disc"><li>
Add unit tests
</li></ul></div>
-<a name="toward_boost_stm.appendices.todo.tasks_to_do_before_review.benchmarks"></a><h6>
-<a name="id4914866"></a>
- <a class="link" href="todo.html#toward_boost_stm.appendices.todo.tasks_to_do_before_review.benchmarks">Benchmarks</a>
- </h6>
+<a name="toward_boost_stm.appendices.todo.tasks_to_do_before_review.benchmarks"></a><h5>
+<a name="id4875026"></a>
+ Benchmarks
+ </h5>
<div class="itemizedlist"><ul type="disc"><li>
Add some specific benchmarks.
</li></ul></div>
-<a name="toward_boost_stm.appendices.todo.tasks_to_do_before_review.documentation"></a><h6>
-<a name="id4914897"></a>
- <a class="link" href="todo.html#toward_boost_stm.appendices.todo.tasks_to_do_before_review.documentation">Documentation</a>
- </h6>
+<a name="toward_boost_stm.appendices.todo.tasks_to_do_before_review.documentation"></a><h5>
+<a name="id4875057"></a>
+ Documentation
+ </h5>
<div class="itemizedlist"><ul type="disc">
<li>
<span class="bold"><strong>DONE</strong></span> Create the empty files and set
@@ -270,7 +274,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="toward_boost_stm.appendices.todo.for_later_releases"></a><a class="link" href="todo.html#toward_boost_stm.appendices.todo.for_later_releases" title="For later releases">For
+<a name="toward_boost_stm.appendices.todo.for_later_releases"></a><a href="todo.html#toward_boost_stm.appendices.todo.for_later_releases" title="For
+ later releases">For
later releases</a>
</h4></div></div></div>
<div class="toc"><dl><dt><span class="section"><a href="todo.html#toward_boost_stm.appendices.todo.for_later_releases.more_recherch_needed">More
@@ -288,7 +293,8 @@
</ul></div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.appendices.todo.for_later_releases.more_recherch_needed"></a><a class="link" href="todo.html#toward_boost_stm.appendices.todo.for_later_releases.more_recherch_needed" title="More recherch needed">More
+<a name="toward_boost_stm.appendices.todo.for_later_releases.more_recherch_needed"></a><a href="todo.html#toward_boost_stm.appendices.todo.for_later_releases.more_recherch_needed" title="More
+ recherch needed">More
recherch needed</a>
</h5></div></div></div>
<div class="itemizedlist"><ul type="disc">
Modified: sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/examples.html
==============================================================================
--- sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/examples.html (original)
+++ sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/examples.html 2009-10-08 15:42:54 EDT (Thu, 08 Oct 2009)
@@ -3,10 +3,11 @@
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>Examples</title>
<link rel="stylesheet" href="../../../../../doc/html/boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
+<meta name="generator" content="DocBook XSL Stylesheets V1.69.1">
<link rel="start" href="../index.html" title="Chapter 1. Toward.Boost.STM">
<link rel="up" href="../index.html" title="Chapter 1. Toward.Boost.STM">
-<link rel="prev" href="reference/transaction_bookkeeping_hpp.html" title="Header <boost/stm/transaction_bookkeeping.hpp>">
+<link rel="prev" href="reference/transaction_bookkeeping_hpp.html" title="
+ Header <boost/stm/transaction_bookkeeping.hpp>">
<link rel="next" href="appendices.html" title="Appendices">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -24,7 +25,7 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
-<a name="toward_boost_stm.examples"></a><a class="link" href="examples.html" title="Examples">Examples</a>
+<a name="toward_boost_stm.examples"></a>Examples
</h2></div></div></div>
<p>
This section includes complete examples using the library.
Modified: sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/overview.html
==============================================================================
--- sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/overview.html (original)
+++ sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/overview.html 2009-10-08 15:42:54 EDT (Thu, 08 Oct 2009)
@@ -1,13 +1,13 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
-<title>Overview</title>
+<title> Overview</title>
<link rel="stylesheet" href="../../../../../doc/html/boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
+<meta name="generator" content="DocBook XSL Stylesheets V1.69.1">
<link rel="start" href="../index.html" title="Chapter 1. Toward.Boost.STM">
<link rel="up" href="../index.html" title="Chapter 1. Toward.Boost.STM">
<link rel="prev" href="../index.html" title="Chapter 1. Toward.Boost.STM">
-<link rel="next" href="overview/intro.html" title="Introduction">
+<link rel="next" href="overview/intro.html" title=" Introduction">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table cellpadding="2" width="100%"><tr>
@@ -24,13 +24,13 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
-<a name="toward_boost_stm.overview"></a><a class="link" href="overview.html" title="Overview"> Overview</a>
+<a name="toward_boost_stm.overview"></a> Overview
</h2></div></div></div>
<div class="toc"><dl><dt><span class="section"> Introduction</span></dt></dl></div>
-<a name="toward_boost_stm.overview.description"></a><h4>
-<a name="id4810667"></a>
- <a class="link" href="overview.html#toward_boost_stm.overview.description">Description</a>
- </h4>
+<a name="toward_boost_stm.overview.description"></a><h3>
+<a name="id4803158"></a>
+ Description
+ </h3>
<p>
Toward An Industrial Strength C++ Software Transactional Memory Library.
</p>
@@ -95,11 +95,11 @@
I/O transactions)
</li>
</ul></div>
-<a name="toward_boost_stm.overview.how_to_use_this_documentation"></a><h4>
-<a name="id4810530"></a>
- <a class="link" href="overview.html#toward_boost_stm.overview.how_to_use_this_documentation">How
+<a name="toward_boost_stm.overview.how_to_use_this_documentation"></a><h3>
+<a name="id4764828"></a>
+ <a href="overview.html#toward_boost_stm.overview.how_to_use_this_documentation">How
to Use This Documentation</a>
- </h4>
+ </h3>
<p>
This documentation makes use of the following naming and formatting conventions.
</p>
Modified: sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/overview/intro.html
==============================================================================
--- sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/overview/intro.html (original)
+++ sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/overview/intro.html 2009-10-08 15:42:54 EDT (Thu, 08 Oct 2009)
@@ -1,13 +1,13 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
-<title>Introduction</title>
+<title> Introduction</title>
<link rel="stylesheet" href="../../../../../../doc/html/boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
+<meta name="generator" content="DocBook XSL Stylesheets V1.69.1">
<link rel="start" href="../../index.html" title="Chapter 1. Toward.Boost.STM">
-<link rel="up" href="../overview.html" title="Overview">
-<link rel="prev" href="../overview.html" title="Overview">
-<link rel="next" href="../users_guide.html" title="Users'Guide">
+<link rel="up" href="../overview.html" title=" Overview">
+<link rel="prev" href="../overview.html" title=" Overview">
+<link rel="next" href="../users_guide.html" title=" Users'Guide">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table cellpadding="2" width="100%"><tr>
@@ -24,13 +24,13 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h3 class="title">
-<a name="toward_boost_stm.overview.intro"></a><a class="link" href="intro.html" title="Introduction"> Introduction</a>
+<a name="toward_boost_stm.overview.intro"></a> Introduction
</h3></div></div></div>
-<a name="toward_boost_stm.overview.intro.transactional_memory"></a><h5>
-<a name="id4848945"></a>
- <a class="link" href="intro.html#toward_boost_stm.overview.intro.transactional_memory">Transactional
+<a name="toward_boost_stm.overview.intro.transactional_memory"></a><h4>
+<a name="id4765111"></a>
+ <a href="intro.html#toward_boost_stm.overview.intro.transactional_memory">Transactional
Memory</a>
- </h5>
+ </h4>
<p>
Transactional memory is a modern type of concurrency control that uses transactions
as its synchronization mechanism. A transaction is a finite sequence of operations
@@ -107,10 +107,10 @@
remainder of this section presents TM from a viewpoint of (1) simplicity,
(2) scalability and (3) modularity.
</p>
-<a name="toward_boost_stm.overview.intro.simplicity"></a><h5>
-<a name="id4849486"></a>
- <a class="link" href="intro.html#toward_boost_stm.overview.intro.simplicity">Simplicity</a>
- </h5>
+<a name="toward_boost_stm.overview.intro.simplicity"></a><h4>
+<a name="id4765653"></a>
+ Simplicity
+ </h4>
<p>
Synchronization problems, such as deadlocks, livelocks and priority inversion
are common in software systems using mutual exclusion. TM avoids many of
@@ -211,11 +211,11 @@
<span class="number">6</span> <span class="identifier">unlock</span><span class="special">(</span><span class="identifier">mutexY</span><span class="special">);</span>
<span class="number">7</span> <span class="identifier">unlock</span><span class="special">(</span><span class="identifier">mutexX</span><span class="special">);</span>
</pre>
-<a name="toward_boost_stm.overview.intro.understanding_concurrency_hazards"></a><h5>
-<a name="id4804185"></a>
- <a class="link" href="intro.html#toward_boost_stm.overview.intro.understanding_concurrency_hazards">Understanding
+<a name="toward_boost_stm.overview.intro.understanding_concurrency_hazards"></a><h4>
+<a name="id4758679"></a>
+ <a href="intro.html#toward_boost_stm.overview.intro.understanding_concurrency_hazards">Understanding
Concurrency Hazards</a>
- </h5>
+ </h4>
<p>
Informally, a concurrency hazard is a condition existing in a set of operations
that, if executed with a specific concurrent interleaving, results in one
@@ -269,11 +269,11 @@
implementations are hidden inside of software libraries, extending these
modules can range from difficult to impossible.
</p>
-<a name="toward_boost_stm.overview.intro.testing__race_conditions_and_interleavings"></a><h5>
-<a name="id4804299"></a>
- <a class="link" href="intro.html#toward_boost_stm.overview.intro.testing__race_conditions_and_interleavings">Testing:
+<a name="toward_boost_stm.overview.intro.testing__race_conditions_and_interleavings"></a><h4>
+<a name="id4758793"></a>
+ <a href="intro.html#toward_boost_stm.overview.intro.testing__race_conditions_and_interleavings">Testing:
Race Conditions and Interleavings</a>
- </h5>
+ </h4>
<p>
A race condition is a common concurrency hazard that exists in parallel or
distributed software. As with all concurrency hazards, race conditions rely
@@ -345,11 +345,11 @@
required as the TM system is required to behave in a consistent manner for
all serial orders.
</p>
-<a name="toward_boost_stm.overview.intro.development__mutual_exclusion_and_tm"></a><h5>
-<a name="id4804665"></a>
- <a class="link" href="intro.html#toward_boost_stm.overview.intro.development__mutual_exclusion_and_tm">Development:
+<a name="toward_boost_stm.overview.intro.development__mutual_exclusion_and_tm"></a><h4>
+<a name="id4759159"></a>
+ <a href="intro.html#toward_boost_stm.overview.intro.development__mutual_exclusion_and_tm">Development:
Mutual Exclusion and TM</a>
- </h5>
+ </h4>
<p>
The development of fine-grained locking is notoriously difficult. Designing
such software is equally as hard. The difficulty in developing and designing
@@ -371,10 +371,10 @@
shown in this section and are never complicated in order to achieve improved
performance, as is commonly found in fine-grained mutual exclusion implementations.
</p>
-<a name="toward_boost_stm.overview.intro.scalability"></a><h5>
-<a name="id4804718"></a>
- <a class="link" href="intro.html#toward_boost_stm.overview.intro.scalability">Scalability</a>
- </h5>
+<a name="toward_boost_stm.overview.intro.scalability"></a><h4>
+<a name="id4759212"></a>
+ Scalability
+ </h4>
<p>
In this section we analyze the scalability of TM compared to mutual exclusion.
We measure scalability by two metrics: consistency and performance. A concurrency
@@ -383,11 +383,11 @@
scalability is measured by the maximum number of consistent processes supported
by a concurrency control type while executing concurrently.
</p>
-<a name="toward_boost_stm.overview.intro.pessimistic_and_optimistic_critical_sections"></a><h5>
-<a name="id4804741"></a>
- <a class="link" href="intro.html#toward_boost_stm.overview.intro.pessimistic_and_optimistic_critical_sections">Pessimistic
+<a name="toward_boost_stm.overview.intro.pessimistic_and_optimistic_critical_sections"></a><h4>
+<a name="id4759236"></a>
+ <a href="intro.html#toward_boost_stm.overview.intro.pessimistic_and_optimistic_critical_sections">Pessimistic
and Optimistic Critical Sections</a>
- </h5>
+ </h4>
<p>
Critical sections can be pessimistic or optimistic. Pessimistic critical
sections limit their critical section execution to a single thread. Locks
@@ -396,11 +396,11 @@
execution. Transactions are an example of a synchronization mechanism that
use optimistic critical sections.
</p>
-<a name="toward_boost_stm.overview.intro.truly_optimistic_critical_sections"></a><h5>
-<a name="id4804773"></a>
- <a class="link" href="intro.html#toward_boost_stm.overview.intro.truly_optimistic_critical_sections">Truly
+<a name="toward_boost_stm.overview.intro.truly_optimistic_critical_sections"></a><h4>
+<a name="id4759268"></a>
+ <a href="intro.html#toward_boost_stm.overview.intro.truly_optimistic_critical_sections">Truly
Optimistic Critical Sections</a>
- </h5>
+ </h4>
<p>
Truly optimistic critical sections are those critical sections which allow
multiple conflicting threads to simultaneously execute the same critical
@@ -453,11 +453,11 @@
the state of g1=0,g2=0 while T1 sets the state of g1=1,g2=1. As the example
addresses, both g1=0,g2=0 and g1=1,g2=1 are legal states.
</p>
-<a name="toward_boost_stm.overview.intro.direct_and_deferred_update"></a><h5>
-<a name="id4805268"></a>
- <a class="link" href="intro.html#toward_boost_stm.overview.intro.direct_and_deferred_update">Direct
+<a name="toward_boost_stm.overview.intro.direct_and_deferred_update"></a><h4>
+<a name="id4759763"></a>
+ <a href="intro.html#toward_boost_stm.overview.intro.direct_and_deferred_update">Direct
and Deferred Update</a>
- </h5>
+ </h4>
<p>
Updating is the process of committing transactional writes to global memory
and is performed in either a direct or deferred manner. Figure 6 presents
@@ -502,11 +502,11 @@
or the earlier arriving writer. This scenario is not possible with direct
update without special effort.
</p>
-<a name="toward_boost_stm.overview.intro.scalability__mutual_exclusion_and_transactional_memory"></a><h5>
-<a name="id4805358"></a>
- <a class="link" href="intro.html#toward_boost_stm.overview.intro.scalability__mutual_exclusion_and_transactional_memory">Scalability:
+<a name="toward_boost_stm.overview.intro.scalability__mutual_exclusion_and_transactional_memory"></a><h4>
+<a name="id4759852"></a>
+ <a href="intro.html#toward_boost_stm.overview.intro.scalability__mutual_exclusion_and_transactional_memory">Scalability:
Mutual Exclusion and Transactional Memory</a>
- </h5>
+ </h4>
<p>
The scalability of mutual exclusion is limited to pessimistic concurrency.
By definition, mutual exclusion's critical sections must be pessimistic,
@@ -583,10 +583,10 @@
throughput via contention management, the above equations capture the indisputable
mathematical limitations in mutual exclusion's performance scalability.
</p>
-<a name="toward_boost_stm.overview.intro.modularity"></a><h5>
-<a name="id4858700"></a>
- <a class="link" href="intro.html#toward_boost_stm.overview.intro.modularity">Modularity</a>
- </h5>
+<a name="toward_boost_stm.overview.intro.modularity"></a><h4>
+<a name="id4813029"></a>
+ Modularity
+ </h4>
<p>
Software modularity is an important aspect of software that is necessary
for its reuse. Formally, software is modular if it can be composed in a new
@@ -604,11 +604,11 @@
is vital for any software paradigm to be practical. Software paradigms that
do not support software modularity are, in short, impractical.
</p>
-<a name="toward_boost_stm.overview.intro.mutual_exclusion_and_software_modularity"></a><h5>
-<a name="id4858744"></a>
- <a class="link" href="intro.html#toward_boost_stm.overview.intro.mutual_exclusion_and_software_modularity">Mutual
+<a name="toward_boost_stm.overview.intro.mutual_exclusion_and_software_modularity"></a><h4>
+<a name="id4813073"></a>
+ <a href="intro.html#toward_boost_stm.overview.intro.mutual_exclusion_and_software_modularity">Mutual
Exclusion and Software Modularity</a>
- </h5>
+ </h4>
<p>
In this section, we show that mutual exclusion, regardless of its implementation,
fails to deliver software modularity. We demonstrate this through a running
@@ -689,11 +689,11 @@
<span class="identifier">Figure</span> <span class="number">9.</span> <span class="identifier">TM</span> <span class="identifier">of</span> <span class="identifier">Increment</span><span class="special">,</span> <span class="identifier">Multiply</span> <span class="keyword">and</span> <span class="identifier">Get</span> <span class="identifier">of</span> <span class="identifier">Shared</span> <span class="identifier">Variable</span><span class="special">.</span>
</pre>
-<a name="toward_boost_stm.overview.intro.summary_of_mutual_exclusion_modularity"></a><h5>
-<a name="id4859757"></a>
- <a class="link" href="intro.html#toward_boost_stm.overview.intro.summary_of_mutual_exclusion_modularity">Summary
+<a name="toward_boost_stm.overview.intro.summary_of_mutual_exclusion_modularity"></a><h4>
+<a name="id4814086"></a>
+ <a href="intro.html#toward_boost_stm.overview.intro.summary_of_mutual_exclusion_modularity">Summary
of Mutual Exclusion Modularity</a>
- </h5>
+ </h4>
<p>
As we presented at the beginning of this section, software modularity can
be informally understood as a component's ability to be used entirely from
@@ -702,11 +702,11 @@
extended, are not modular. As such, the paradigm of mutual exclusion does
not support software modularity.
</p>
-<a name="toward_boost_stm.overview.intro.transactional_memory_and_software_modularity"></a><h5>
-<a name="id4859797"></a>
- <a class="link" href="intro.html#toward_boost_stm.overview.intro.transactional_memory_and_software_modularity">Transactional
+<a name="toward_boost_stm.overview.intro.transactional_memory_and_software_modularity"></a><h4>
+<a name="id4814127"></a>
+ <a href="intro.html#toward_boost_stm.overview.intro.transactional_memory_and_software_modularity">Transactional
Memory and Software Modularity</a>
- </h5>
+ </h4>
<p>
Transactional memory works in a fundamentally different manner than mutual
exclusion, with regard to its interface and implementation. To begin, as
@@ -720,11 +720,11 @@
performance of concurrent programs using various consistency checking methods,
conflict detection times, updating policies, and contention management schemes.
</p>
-<a name="toward_boost_stm.overview.intro.achieving_tm_software_modularity"></a><h5>
-<a name="id4859838"></a>
- <a class="link" href="intro.html#toward_boost_stm.overview.intro.achieving_tm_software_modularity">Achieving
+<a name="toward_boost_stm.overview.intro.achieving_tm_software_modularity"></a><h4>
+<a name="id4814167"></a>
+ <a href="intro.html#toward_boost_stm.overview.intro.achieving_tm_software_modularity">Achieving
TM Software Modularity</a>
- </h5>
+ </h4>
<p>
TM achieves software modularity by allowing transactions to nest. With transactional
nesting, individual transactions can be wrapped inside of other transactions
@@ -798,11 +798,11 @@
implementation. Due to this, mutual exclusion fails to deliver a practical
level of software modularity.
</p>
-<a name="toward_boost_stm.overview.intro.summary_of_transactional_memory_modularity"></a><h5>
-<a name="id4860198"></a>
- <a class="link" href="intro.html#toward_boost_stm.overview.intro.summary_of_transactional_memory_modularity">Summary
+<a name="toward_boost_stm.overview.intro.summary_of_transactional_memory_modularity"></a><h4>
+<a name="id4814528"></a>
+ <a href="intro.html#toward_boost_stm.overview.intro.summary_of_transactional_memory_modularity">Summary
of Transactional Memory Modularity</a>
- </h5>
+ </h4>
<p>
TM supports software modularity by allowing transactions to nest, to any
depth, while logically grouping the shared data accesses within the transactions
@@ -812,11 +812,11 @@
behave in a correct manner regardless of if the transaction is used by itself
or subsumed into a larger transaction.
</p>
-<a name="toward_boost_stm.overview.intro.c___library_language_like_solution"></a><h5>
-<a name="id4860232"></a>
- <a class="link" href="intro.html#toward_boost_stm.overview.intro.c___library_language_like_solution">C++
+<a name="toward_boost_stm.overview.intro.c___library_language_like_solution"></a><h4>
+<a name="id4814561"></a>
+ <a href="intro.html#toward_boost_stm.overview.intro.c___library_language_like_solution">C++
library language-like solution</a>
- </h5>
+ </h4>
<p>
Research in parallel programming has recently seen a flurry of attention.
Among the active research is a push for high-level languages to offer native
Modified: sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference.html
==============================================================================
--- sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference.html (original)
+++ sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference.html 2009-10-08 15:42:54 EDT (Thu, 08 Oct 2009)
@@ -3,11 +3,12 @@
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>Reference</title>
<link rel="stylesheet" href="../../../../../doc/html/boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
+<meta name="generator" content="DocBook XSL Stylesheets V1.69.1">
<link rel="start" href="../index.html" title="Chapter 1. Toward.Boost.STM">
<link rel="up" href="../index.html" title="Chapter 1. Toward.Boost.STM">
-<link rel="prev" href="users_guide/glosary.html" title="Glossary">
-<link rel="next" href="reference/base_contention_manager_hpp.html" title="Header <boost/stm/base_contention_manager.hpp>">
+<link rel="prev" href="users_guide/glosary.html" title=" Glossary">
+<link rel="next" href="reference/base_contention_manager_hpp.html" title="
+ Header <boost/stm/base_contention_manager.hpp>">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table cellpadding="2" width="100%"><tr>
@@ -24,7 +25,7 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
-<a name="toward_boost_stm.reference"></a><a class="link" href="reference.html" title="Reference">Reference</a>
+<a name="toward_boost_stm.reference"></a>Reference
</h2></div></div></div>
<div class="toc"><dl>
<dt><span class="section"><a href="reference/base_contention_manager_hpp.html">
Modified: sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/base_contention_manager_hpp.html
==============================================================================
--- sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/base_contention_manager_hpp.html (original)
+++ sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/base_contention_manager_hpp.html 2009-10-08 15:42:54 EDT (Thu, 08 Oct 2009)
@@ -1,13 +1,15 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
-<title>Header <boost/stm/base_contention_manager.hpp></title>
+<title>
+ Header <boost/stm/base_contention_manager.hpp></title>
<link rel="stylesheet" href="../../../../../../doc/html/boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
+<meta name="generator" content="DocBook XSL Stylesheets V1.69.1">
<link rel="start" href="../../index.html" title="Chapter 1. Toward.Boost.STM">
<link rel="up" href="../reference.html" title="Reference">
<link rel="prev" href="../reference.html" title="Reference">
-<link rel="next" href="base_transaction_object_hpp.html" title="Header <boost/stm/base_transaction_object.hpp>">
+<link rel="next" href="base_transaction_object_hpp.html" title="
+ Header <boost/stm/base_transaction_object.hpp>">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table cellpadding="2" width="100%"><tr>
@@ -24,7 +26,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h3 class="title">
-<a name="toward_boost_stm.reference.base_contention_manager_hpp"></a><a class="link" href="base_contention_manager_hpp.html" title="Header <boost/stm/base_contention_manager.hpp>">
+<a name="toward_boost_stm.reference.base_contention_manager_hpp"></a><a href="base_contention_manager_hpp.html" title="
+ Header <boost/stm/base_contention_manager.hpp>">
Header <code class="computeroutput"><span class="special"><</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">stm</span><span class="special">/</span><span class="identifier">base_contention_manager</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">></span></code></a>
</h3></div></div></div>
<div class="toc"><dl>
@@ -61,7 +64,8 @@
</pre>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="toward_boost_stm.reference.base_contention_manager_hpp.abstract_class__base_contention_manager_"></a><a class="link" href="base_contention_manager_hpp.html#toward_boost_stm.reference.base_contention_manager_hpp.abstract_class__base_contention_manager_" title="Abstract Class base_contention_manager">Abstract
+<a name="toward_boost_stm.reference.base_contention_manager_hpp.abstract_class__base_contention_manager_"></a><a href="base_contention_manager_hpp.html#toward_boost_stm.reference.base_contention_manager_hpp.abstract_class__base_contention_manager_" title="Abstract
+ Class base_contention_manager">Abstract
Class <code class="computeroutput"><span class="identifier">base_contention_manager</span></code></a>
</h4></div></div></div>
<div class="toc"><dl>
@@ -102,12 +106,12 @@
<span class="identifier">boost</span><span class="special">::</span><span class="identifier">stm</span><span class="special">::</span><span class="identifier">base_transaction_object</span> <span class="keyword">const</span> <span class="special">&</span><span class="identifier">in</span><span class="special">)</span> <span class="special">=</span> <span class="number">0</span><span class="special">;</span>
<span class="keyword">virtual</span> <span class="keyword">bool</span> <span class="identifier">abort_before_commit</span><span class="special">(</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">stm</span><span class="special">::</span><span class="identifier">transaction</span> <span class="keyword">const</span> <span class="special">&</span><span class="identifier">t</span><span class="special">)</span> <span class="special">=</span> <span class="number">0</span><span class="special">;</span>
<span class="keyword">virtual</span> <span class="keyword">bool</span> <span class="identifier">permission_to_abort</span><span class="special">(</span>
- <span class="identifier">boost</span><span class="special">::</span><span class="identifier">stm</span><span class="special">::</span><span class="identifier">transaction</span> <span class="keyword">const</span> <span class="special">&</span><span class="identifier">lhs</span><span class="special">,</span>
+ <span class="identifier">boost</span><span class="special">::</span><span class="identifier">stm</span><span class="special">::</span><span class="identifier">transaction</span> <span class="keyword">const</span> <span class="special">&</span><span class="identifier">lhs</span><span class="special">,</span>
<span class="identifier">boost</span><span class="special">::</span><span class="identifier">stm</span><span class="special">::</span><span class="identifier">transaction</span> <span class="keyword">const</span> <span class="special">&</span><span class="identifier">rhs</span><span class="special">)</span> <span class="special">=</span> <span class="number">0</span><span class="special">;</span>
<span class="keyword">virtual</span> <span class="keyword">bool</span> <span class="identifier">allow_lock_to_abort_tx</span><span class="special">(</span>
- <span class="keyword">int</span> <span class="keyword">const</span> <span class="special">&</span> <span class="identifier">lockWaitTime</span><span class="special">,</span>
- <span class="keyword">int</span> <span class="keyword">const</span> <span class="special">&</span><span class="identifier">lockAborted</span><span class="special">,</span>
- <span class="keyword">bool</span> <span class="identifier">txIsIrrevocable</span><span class="special">,</span>
+ <span class="keyword">int</span> <span class="keyword">const</span> <span class="special">&</span> <span class="identifier">lockWaitTime</span><span class="special">,</span>
+ <span class="keyword">int</span> <span class="keyword">const</span> <span class="special">&</span><span class="identifier">lockAborted</span><span class="special">,</span>
+ <span class="keyword">bool</span> <span class="identifier">txIsIrrevocable</span><span class="special">,</span>
<span class="identifier">boost</span><span class="special">::</span><span class="identifier">stm</span><span class="special">::</span><span class="identifier">transaction</span> <span class="keyword">const</span> <span class="special">&</span><span class="identifier">rhs</span><span class="special">)</span> <span class="special">=</span> <span class="number">0</span><span class="special">;</span>
<span class="keyword">virtual</span> <span class="keyword">int</span> <span class="identifier">lock_sleep_time</span><span class="special">();</span>
<span class="keyword">virtual</span> <span class="keyword">void</span> <span class="identifier">perform_isolated_tx_wait_priority_promotion</span><span class="special">(</span>
@@ -119,7 +123,8 @@
</pre>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.base_contention_manager_hpp.abstract_class__base_contention_manager_.virtual_destructor__base_contention_manager_"></a><a class="link" href="base_contention_manager_hpp.html#toward_boost_stm.reference.base_contention_manager_hpp.abstract_class__base_contention_manager_.virtual_destructor__base_contention_manager_" title="Virtual destructor base_contention_manager">Virtual
+<a name="toward_boost_stm.reference.base_contention_manager_hpp.abstract_class__base_contention_manager_.virtual_destructor__base_contention_manager_"></a><a href="base_contention_manager_hpp.html#toward_boost_stm.reference.base_contention_manager_hpp.abstract_class__base_contention_manager_.virtual_destructor__base_contention_manager_" title="Virtual
+ destructor base_contention_manager">Virtual
destructor <code class="computeroutput"><span class="identifier">base_contention_manager</span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">virtual</span> <span class="special">~</span><span class="identifier">base_contention_manager</span><span class="special">();</span>
@@ -127,7 +132,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.base_contention_manager_hpp.abstract_class__base_contention_manager_.virtual_function__abort_on_new_"></a><a class="link" href="base_contention_manager_hpp.html#toward_boost_stm.reference.base_contention_manager_hpp.abstract_class__base_contention_manager_.virtual_function__abort_on_new_" title="Virtual function abort_on_new">Virtual
+<a name="toward_boost_stm.reference.base_contention_manager_hpp.abstract_class__base_contention_manager_.virtual_function__abort_on_new_"></a><a href="base_contention_manager_hpp.html#toward_boost_stm.reference.base_contention_manager_hpp.abstract_class__base_contention_manager_.virtual_function__abort_on_new_" title="Virtual
+ function abort_on_new">Virtual
function <code class="computeroutput"><span class="identifier">abort_on_new</span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">virtual</span> <span class="keyword">void</span> <span class="identifier">abort_on_new</span><span class="special">(</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">stm</span><span class="special">::</span><span class="identifier">transaction</span> <span class="keyword">const</span> <span class="special">&</span><span class="identifier">t</span><span class="special">)</span> <span class="special">=</span> <span class="number">0</span><span class="special">;</span>
@@ -141,7 +147,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.base_contention_manager_hpp.abstract_class__base_contention_manager_.virtual_function__abort_on_delete_"></a><a class="link" href="base_contention_manager_hpp.html#toward_boost_stm.reference.base_contention_manager_hpp.abstract_class__base_contention_manager_.virtual_function__abort_on_delete_" title="Virtual function abort_on_delete">Virtual
+<a name="toward_boost_stm.reference.base_contention_manager_hpp.abstract_class__base_contention_manager_.virtual_function__abort_on_delete_"></a><a href="base_contention_manager_hpp.html#toward_boost_stm.reference.base_contention_manager_hpp.abstract_class__base_contention_manager_.virtual_function__abort_on_delete_" title="Virtual
+ function abort_on_delete">Virtual
function <code class="computeroutput"><span class="identifier">abort_on_delete</span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">virtual</span> <span class="keyword">void</span> <span class="identifier">abort_on_delete</span><span class="special">(</span>
@@ -157,7 +164,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.base_contention_manager_hpp.abstract_class__base_contention_manager_.virtual_function__abort_on_read_"></a><a class="link" href="base_contention_manager_hpp.html#toward_boost_stm.reference.base_contention_manager_hpp.abstract_class__base_contention_manager_.virtual_function__abort_on_read_" title="Virtual function abort_on_read">Virtual
+<a name="toward_boost_stm.reference.base_contention_manager_hpp.abstract_class__base_contention_manager_.virtual_function__abort_on_read_"></a><a href="base_contention_manager_hpp.html#toward_boost_stm.reference.base_contention_manager_hpp.abstract_class__base_contention_manager_.virtual_function__abort_on_read_" title="Virtual
+ function abort_on_read">Virtual
function <code class="computeroutput"><span class="identifier">abort_on_read</span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">virtual</span> <span class="keyword">void</span> <span class="identifier">abort_on_read</span><span class="special">(</span>
@@ -174,7 +182,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.base_contention_manager_hpp.abstract_class__base_contention_manager_.virtual_function__abort_on_write_"></a><a class="link" href="base_contention_manager_hpp.html#toward_boost_stm.reference.base_contention_manager_hpp.abstract_class__base_contention_manager_.virtual_function__abort_on_write_" title="Virtual function abort_on_write">Virtual
+<a name="toward_boost_stm.reference.base_contention_manager_hpp.abstract_class__base_contention_manager_.virtual_function__abort_on_write_"></a><a href="base_contention_manager_hpp.html#toward_boost_stm.reference.base_contention_manager_hpp.abstract_class__base_contention_manager_.virtual_function__abort_on_write_" title="Virtual
+ function abort_on_write">Virtual
function <code class="computeroutput"><span class="identifier">abort_on_write</span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">virtual</span> <span class="keyword">void</span> <span class="identifier">abort_on_write</span><span class="special">(</span>
@@ -191,7 +200,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.base_contention_manager_hpp.abstract_class__base_contention_manager_.virtual_function__abort_before_commit_"></a><a class="link" href="base_contention_manager_hpp.html#toward_boost_stm.reference.base_contention_manager_hpp.abstract_class__base_contention_manager_.virtual_function__abort_before_commit_" title="Virtual function abort_before_commit">Virtual
+<a name="toward_boost_stm.reference.base_contention_manager_hpp.abstract_class__base_contention_manager_.virtual_function__abort_before_commit_"></a><a href="base_contention_manager_hpp.html#toward_boost_stm.reference.base_contention_manager_hpp.abstract_class__base_contention_manager_.virtual_function__abort_before_commit_" title="Virtual
+ function abort_before_commit">Virtual
function <code class="computeroutput"><span class="identifier">abort_before_commit</span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">virtual</span> <span class="keyword">bool</span> <span class="identifier">abort_before_commit</span><span class="special">(</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">stm</span><span class="special">::</span><span class="identifier">transaction</span> <span class="keyword">const</span> <span class="special">&</span><span class="identifier">t</span><span class="special">)</span> <span class="special">=</span> <span class="number">0</span><span class="special">;</span>
@@ -206,11 +216,12 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.base_contention_manager_hpp.abstract_class__base_contention_manager_.virtual_function__permission_to_abort_"></a><a class="link" href="base_contention_manager_hpp.html#toward_boost_stm.reference.base_contention_manager_hpp.abstract_class__base_contention_manager_.virtual_function__permission_to_abort_" title="Virtual function permission_to_abort">Virtual
+<a name="toward_boost_stm.reference.base_contention_manager_hpp.abstract_class__base_contention_manager_.virtual_function__permission_to_abort_"></a><a href="base_contention_manager_hpp.html#toward_boost_stm.reference.base_contention_manager_hpp.abstract_class__base_contention_manager_.virtual_function__permission_to_abort_" title="Virtual
+ function permission_to_abort">Virtual
function <code class="computeroutput"><span class="identifier">permission_to_abort</span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">virtual</span> <span class="keyword">bool</span> <span class="identifier">permission_to_abort</span><span class="special">(</span>
- <span class="identifier">boost</span><span class="special">::</span><span class="identifier">stm</span><span class="special">::</span><span class="identifier">transaction</span> <span class="keyword">const</span> <span class="special">&</span><span class="identifier">lhs</span><span class="special">,</span>
+ <span class="identifier">boost</span><span class="special">::</span><span class="identifier">stm</span><span class="special">::</span><span class="identifier">transaction</span> <span class="keyword">const</span> <span class="special">&</span><span class="identifier">lhs</span><span class="special">,</span>
<span class="identifier">boost</span><span class="special">::</span><span class="identifier">stm</span><span class="special">::</span><span class="identifier">transaction</span> <span class="keyword">const</span> <span class="special">&</span><span class="identifier">rhs</span><span class="special">)</span> <span class="special">=</span> <span class="number">0</span><span class="special">;</span>
</pre>
<p>
@@ -229,19 +240,21 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.base_contention_manager_hpp.abstract_class__base_contention_manager_.virtual_function__allow_lock_to_abort_tx_"></a><a class="link" href="base_contention_manager_hpp.html#toward_boost_stm.reference.base_contention_manager_hpp.abstract_class__base_contention_manager_.virtual_function__allow_lock_to_abort_tx_" title="Virtual function allow_lock_to_abort_tx">Virtual
+<a name="toward_boost_stm.reference.base_contention_manager_hpp.abstract_class__base_contention_manager_.virtual_function__allow_lock_to_abort_tx_"></a><a href="base_contention_manager_hpp.html#toward_boost_stm.reference.base_contention_manager_hpp.abstract_class__base_contention_manager_.virtual_function__allow_lock_to_abort_tx_" title="Virtual
+ function allow_lock_to_abort_tx">Virtual
function <code class="computeroutput"><span class="identifier">allow_lock_to_abort_tx</span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">virtual</span> <span class="keyword">bool</span> <span class="identifier">allow_lock_to_abort_tx</span><span class="special">(</span>
- <span class="keyword">int</span> <span class="keyword">const</span> <span class="special">&</span> <span class="identifier">lockWaitTime</span><span class="special">,</span>
- <span class="keyword">int</span> <span class="keyword">const</span> <span class="special">&</span><span class="identifier">lockAborted</span><span class="special">,</span>
- <span class="keyword">bool</span> <span class="identifier">txIsIrrevocable</span><span class="special">,</span>
+ <span class="keyword">int</span> <span class="keyword">const</span> <span class="special">&</span> <span class="identifier">lockWaitTime</span><span class="special">,</span>
+ <span class="keyword">int</span> <span class="keyword">const</span> <span class="special">&</span><span class="identifier">lockAborted</span><span class="special">,</span>
+ <span class="keyword">bool</span> <span class="identifier">txIsIrrevocable</span><span class="special">,</span>
<span class="identifier">boost</span><span class="special">::</span><span class="identifier">stm</span><span class="special">::</span><span class="identifier">transaction</span> <span class="keyword">const</span> <span class="special">&</span><span class="identifier">rhs</span><span class="special">)</span> <span class="special">=</span> <span class="number">0</span><span class="special">;</span>
</pre>
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.base_contention_manager_hpp.abstract_class__base_contention_manager_.virtual_function__lock_sleep_time_"></a><a class="link" href="base_contention_manager_hpp.html#toward_boost_stm.reference.base_contention_manager_hpp.abstract_class__base_contention_manager_.virtual_function__lock_sleep_time_" title="Virtual function lock_sleep_time">Virtual
+<a name="toward_boost_stm.reference.base_contention_manager_hpp.abstract_class__base_contention_manager_.virtual_function__lock_sleep_time_"></a><a href="base_contention_manager_hpp.html#toward_boost_stm.reference.base_contention_manager_hpp.abstract_class__base_contention_manager_.virtual_function__lock_sleep_time_" title="Virtual
+ function lock_sleep_time">Virtual
function <code class="computeroutput"><span class="identifier">lock_sleep_time</span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">virtual</span> <span class="keyword">int</span> <span class="identifier">lock_sleep_time</span><span class="special">();</span>
@@ -249,7 +262,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.base_contention_manager_hpp.abstract_class__base_contention_manager_.virtual_function__perform_isolated_tx_wait_priority_promotion_"></a><a class="link" href="base_contention_manager_hpp.html#toward_boost_stm.reference.base_contention_manager_hpp.abstract_class__base_contention_manager_.virtual_function__perform_isolated_tx_wait_priority_promotion_" title="Virtual function perform_isolated_tx_wait_priority_promotion">Virtual
+<a name="toward_boost_stm.reference.base_contention_manager_hpp.abstract_class__base_contention_manager_.virtual_function__perform_isolated_tx_wait_priority_promotion_"></a><a href="base_contention_manager_hpp.html#toward_boost_stm.reference.base_contention_manager_hpp.abstract_class__base_contention_manager_.virtual_function__perform_isolated_tx_wait_priority_promotion_" title="Virtual
+ function perform_isolated_tx_wait_priority_promotion">Virtual
function <code class="computeroutput"><span class="identifier">perform_isolated_tx_wait_priority_promotion</span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">virtual</span> <span class="keyword">void</span> <span class="identifier">perform_isolated_tx_wait_priority_promotion</span><span class="special">(</span>
@@ -262,7 +276,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.base_contention_manager_hpp.abstract_class__base_contention_manager_.virtual_function__perform_irrevocable_tx_wait_priority_promotion_"></a><a class="link" href="base_contention_manager_hpp.html#toward_boost_stm.reference.base_contention_manager_hpp.abstract_class__base_contention_manager_.virtual_function__perform_irrevocable_tx_wait_priority_promotion_" title="Virtual function perform_irrevocable_tx_wait_priority_promotion">Virtual
+<a name="toward_boost_stm.reference.base_contention_manager_hpp.abstract_class__base_contention_manager_.virtual_function__perform_irrevocable_tx_wait_priority_promotion_"></a><a href="base_contention_manager_hpp.html#toward_boost_stm.reference.base_contention_manager_hpp.abstract_class__base_contention_manager_.virtual_function__perform_irrevocable_tx_wait_priority_promotion_" title="Virtual
+ function perform_irrevocable_tx_wait_priority_promotion">Virtual
function <code class="computeroutput"><span class="identifier">perform_irrevocable_tx_wait_priority_promotion</span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">virtual</span> <span class="keyword">void</span> <span class="identifier">perform_irrevocable_tx_wait_priority_promotion</span><span class="special">(</span>
Modified: sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/base_transaction_object_hpp.html
==============================================================================
--- sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/base_transaction_object_hpp.html (original)
+++ sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/base_transaction_object_hpp.html 2009-10-08 15:42:54 EDT (Thu, 08 Oct 2009)
@@ -1,13 +1,15 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
-<title>Header <boost/stm/base_transaction_object.hpp></title>
+<title>
+ Header <boost/stm/base_transaction_object.hpp></title>
<link rel="stylesheet" href="../../../../../../doc/html/boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
+<meta name="generator" content="DocBook XSL Stylesheets V1.69.1">
<link rel="start" href="../../index.html" title="Chapter 1. Toward.Boost.STM">
<link rel="up" href="../reference.html" title="Reference">
-<link rel="prev" href="base_contention_manager_hpp.html" title="Header <boost/stm/base_contention_manager.hpp>">
-<link rel="next" href="cache_fct_hpp.html" title="Header <boost/stm/cache_fct.hpp>">
+<link rel="prev" href="base_contention_manager_hpp.html" title="
+ Header <boost/stm/base_contention_manager.hpp>">
+<link rel="next" href="cache_fct_hpp.html" title=" Header <boost/stm/cache_fct.hpp>">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table cellpadding="2" width="100%"><tr>
@@ -24,7 +26,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h3 class="title">
-<a name="toward_boost_stm.reference.base_transaction_object_hpp"></a><a class="link" href="base_transaction_object_hpp.html" title="Header <boost/stm/base_transaction_object.hpp>">
+<a name="toward_boost_stm.reference.base_transaction_object_hpp"></a><a href="base_transaction_object_hpp.html" title="
+ Header <boost/stm/base_transaction_object.hpp>">
Header <code class="computeroutput"><span class="special"><</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">stm</span><span class="special">/</span><span class="identifier">base_transaction_object</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">></span></code></a>
</h3></div></div></div>
<div class="toc"><dl>
@@ -55,7 +58,8 @@
</pre>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="toward_boost_stm.reference.base_transaction_object_hpp.abstract_class__base_transaction_object_"></a><a class="link" href="base_transaction_object_hpp.html#toward_boost_stm.reference.base_transaction_object_hpp.abstract_class__base_transaction_object_" title="Abstract Class base_transaction_object">Abstract
+<a name="toward_boost_stm.reference.base_transaction_object_hpp.abstract_class__base_transaction_object_"></a><a href="base_transaction_object_hpp.html#toward_boost_stm.reference.base_transaction_object_hpp.abstract_class__base_transaction_object_" title="Abstract
+ Class base_transaction_object">Abstract
Class <code class="computeroutput"><span class="identifier">base_transaction_object</span></code></a>
</h4></div></div></div>
<div class="toc"><dl>
@@ -169,7 +173,8 @@
</pre>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.base_transaction_object_hpp.abstract_class__base_transaction_object_.constructor__base_transaction_object___"></a><a class="link" href="base_transaction_object_hpp.html#toward_boost_stm.reference.base_transaction_object_hpp.abstract_class__base_transaction_object_.constructor__base_transaction_object___" title="Constructor base_transaction_object()">Constructor
+<a name="toward_boost_stm.reference.base_transaction_object_hpp.abstract_class__base_transaction_object_.constructor__base_transaction_object___"></a><a href="base_transaction_object_hpp.html#toward_boost_stm.reference.base_transaction_object_hpp.abstract_class__base_transaction_object_.constructor__base_transaction_object___" title="Constructor
+ base_transaction_object()">Constructor
<code class="computeroutput"><span class="identifier">base_transaction_object</span><span class="special">()</span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="identifier">base_transaction_object</span><span class="special">();</span>
@@ -182,7 +187,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.base_transaction_object_hpp.abstract_class__base_transaction_object_.virtual_destructor___base_transaction_object___"></a><a class="link" href="base_transaction_object_hpp.html#toward_boost_stm.reference.base_transaction_object_hpp.abstract_class__base_transaction_object_.virtual_destructor___base_transaction_object___" title="Virtual Destructor ~base_transaction_object()">Virtual
+<a name="toward_boost_stm.reference.base_transaction_object_hpp.abstract_class__base_transaction_object_.virtual_destructor___base_transaction_object___"></a><a href="base_transaction_object_hpp.html#toward_boost_stm.reference.base_transaction_object_hpp.abstract_class__base_transaction_object_.virtual_destructor___base_transaction_object___" title="Virtual
+ Destructor ~base_transaction_object()">Virtual
Destructor <code class="computeroutput"><span class="special">~</span><span class="identifier">base_transaction_object</span><span class="special">()</span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">virtual</span> <span class="special">~</span><span class="identifier">base_transaction_object</span><span class="special">()</span> <span class="special">{};</span>
@@ -196,7 +202,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.base_transaction_object_hpp.abstract_class__base_transaction_object_.virtual_function__copy_state___"></a><a class="link" href="base_transaction_object_hpp.html#toward_boost_stm.reference.base_transaction_object_hpp.abstract_class__base_transaction_object_.virtual_function__copy_state___" title="Virtual function copy_state()">Virtual
+<a name="toward_boost_stm.reference.base_transaction_object_hpp.abstract_class__base_transaction_object_.virtual_function__copy_state___"></a><a href="base_transaction_object_hpp.html#toward_boost_stm.reference.base_transaction_object_hpp.abstract_class__base_transaction_object_.virtual_function__copy_state___" title="Virtual
+ function copy_state()">Virtual
function <code class="computeroutput"><span class="identifier">copy_state</span><span class="special">()</span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">virtual</span> <span class="keyword">void</span> <span class="identifier">copy_state</span><span class="special">(</span><span class="identifier">base_transaction_object</span> <span class="keyword">const</span> <span class="special">*</span> <span class="keyword">const</span> <span class="identifier">rhs</span><span class="special">)</span> <span class="special">=</span> <span class="number">0</span><span class="special">;</span>
@@ -214,7 +221,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.base_transaction_object_hpp.abstract_class__base_transaction_object_.virtual_function__move_state___"></a><a class="link" href="base_transaction_object_hpp.html#toward_boost_stm.reference.base_transaction_object_hpp.abstract_class__base_transaction_object_.virtual_function__move_state___" title="Virtual function move_state()">Virtual
+<a name="toward_boost_stm.reference.base_transaction_object_hpp.abstract_class__base_transaction_object_.virtual_function__move_state___"></a><a href="base_transaction_object_hpp.html#toward_boost_stm.reference.base_transaction_object_hpp.abstract_class__base_transaction_object_.virtual_function__move_state___" title="Virtual
+ function move_state()">Virtual
function <code class="computeroutput"><span class="identifier">move_state</span><span class="special">()</span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">virtual</span> <span class="keyword">void</span> <span class="identifier">move_state</span><span class="special">(</span><span class="identifier">base_transaction_object</span> <span class="special">*</span> <span class="identifier">rhs</span><span class="special">)</span> <span class="special">=</span> <span class="number">0</span><span class="special">;</span>
@@ -227,7 +235,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.base_transaction_object_hpp.abstract_class__base_transaction_object_.static_function__retrieve_mem___"></a><a class="link" href="base_transaction_object_hpp.html#toward_boost_stm.reference.base_transaction_object_hpp.abstract_class__base_transaction_object_.static_function__retrieve_mem___" title="Static function retrieve_mem()">Static
+<a name="toward_boost_stm.reference.base_transaction_object_hpp.abstract_class__base_transaction_object_.static_function__retrieve_mem___"></a><a href="base_transaction_object_hpp.html#toward_boost_stm.reference.base_transaction_object_hpp.abstract_class__base_transaction_object_.static_function__retrieve_mem___" title="Static
+ function retrieve_mem()">Static
function <code class="computeroutput"><span class="identifier">retrieve_mem</span><span class="special">()</span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">static</span> <span class="keyword">void</span><span class="special">*</span> <span class="identifier">retrieve_mem</span><span class="special">(</span><span class="identifier">size_t</span> <span class="identifier">size</span><span class="special">);</span>
@@ -243,7 +252,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.base_transaction_object_hpp.abstract_class__base_transaction_object_.static_function__return_mem___"></a><a class="link" href="base_transaction_object_hpp.html#toward_boost_stm.reference.base_transaction_object_hpp.abstract_class__base_transaction_object_.static_function__return_mem___" title="Static function return_mem()">Static
+<a name="toward_boost_stm.reference.base_transaction_object_hpp.abstract_class__base_transaction_object_.static_function__return_mem___"></a><a href="base_transaction_object_hpp.html#toward_boost_stm.reference.base_transaction_object_hpp.abstract_class__base_transaction_object_.static_function__return_mem___" title="Static
+ function return_mem()">Static
function <code class="computeroutput"><span class="identifier">return_mem</span><span class="special">()</span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">static</span> <span class="keyword">void</span> <span class="identifier">return_mem</span><span class="special">(</span><span class="keyword">void</span> <span class="special">*</span><span class="identifier">mem</span><span class="special">,</span> <span class="identifier">size_t</span> <span class="identifier">size</span><span class="special">);</span>
@@ -259,7 +269,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.base_transaction_object_hpp.abstract_class__base_transaction_object_.static_function__alloc_size___"></a><a class="link" href="base_transaction_object_hpp.html#toward_boost_stm.reference.base_transaction_object_hpp.abstract_class__base_transaction_object_.static_function__alloc_size___" title="Static function alloc_size()">Static
+<a name="toward_boost_stm.reference.base_transaction_object_hpp.abstract_class__base_transaction_object_.static_function__alloc_size___"></a><a href="base_transaction_object_hpp.html#toward_boost_stm.reference.base_transaction_object_hpp.abstract_class__base_transaction_object_.static_function__alloc_size___" title="Static
+ function alloc_size()">Static
function <code class="computeroutput"><span class="identifier">alloc_size</span><span class="special">()</span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">static</span> <span class="keyword">void</span> <span class="identifier">alloc_size</span><span class="special">(</span><span class="identifier">size_t</span> <span class="identifier">size</span><span class="special">);</span>
@@ -276,7 +287,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.base_transaction_object_hpp.abstract_class__base_transaction_object_.virtual_function__cache_deallocate___"></a><a class="link" href="base_transaction_object_hpp.html#toward_boost_stm.reference.base_transaction_object_hpp.abstract_class__base_transaction_object_.virtual_function__cache_deallocate___" title="Virtual function cache_deallocate()">Virtual
+<a name="toward_boost_stm.reference.base_transaction_object_hpp.abstract_class__base_transaction_object_.virtual_function__cache_deallocate___"></a><a href="base_transaction_object_hpp.html#toward_boost_stm.reference.base_transaction_object_hpp.abstract_class__base_transaction_object_.virtual_function__cache_deallocate___" title="Virtual
+ function cache_deallocate()">Virtual
function <code class="computeroutput"><span class="identifier">cache_deallocate</span><span class="special">()</span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">virtual</span> <span class="keyword">void</span> <span class="identifier">cache_deallocate</span><span class="special">()=</span><span class="number">0</span><span class="special">;</span>
Modified: sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/cache_fct_hpp.html
==============================================================================
--- sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/cache_fct_hpp.html (original)
+++ sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/cache_fct_hpp.html 2009-10-08 15:42:54 EDT (Thu, 08 Oct 2009)
@@ -1,13 +1,14 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
-<title>Header <boost/stm/cache_fct.hpp></title>
+<title> Header <boost/stm/cache_fct.hpp></title>
<link rel="stylesheet" href="../../../../../../doc/html/boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
+<meta name="generator" content="DocBook XSL Stylesheets V1.69.1">
<link rel="start" href="../../index.html" title="Chapter 1. Toward.Boost.STM">
<link rel="up" href="../reference.html" title="Reference">
-<link rel="prev" href="base_transaction_object_hpp.html" title="Header <boost/stm/base_transaction_object.hpp>">
-<link rel="next" href="data_types_hpp.html" title="Header <boost/stm/data_types.hpp>">
+<link rel="prev" href="base_transaction_object_hpp.html" title="
+ Header <boost/stm/base_transaction_object.hpp>">
+<link rel="next" href="data_types_hpp.html" title=" Header <boost/stm/data_types.hpp>">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table cellpadding="2" width="100%"><tr>
@@ -24,7 +25,7 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h3 class="title">
-<a name="toward_boost_stm.reference.cache_fct_hpp"></a><a class="link" href="cache_fct_hpp.html" title="Header <boost/stm/cache_fct.hpp>"> Header <code class="computeroutput"><span class="special"><</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">stm</span><span class="special">/</span><span class="identifier">cache_fct</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">></span></code></a>
+<a name="toward_boost_stm.reference.cache_fct_hpp"></a> Header <boost/stm/cache_fct.hpp>
</h3></div></div></div>
<div class="toc"><dl>
<dt><span class="section"><a href="cache_fct_hpp.html#toward_boost_stm.reference.cache_fct_hpp.template_function__cache_clone_____">Template
@@ -50,7 +51,8 @@
</pre>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="toward_boost_stm.reference.cache_fct_hpp.template_function__cache_clone_____"></a><a class="link" href="cache_fct_hpp.html#toward_boost_stm.reference.cache_fct_hpp.template_function__cache_clone_____" title="Template Function cache_clone<>()">Template
+<a name="toward_boost_stm.reference.cache_fct_hpp.template_function__cache_clone_____"></a><a href="cache_fct_hpp.html#toward_boost_stm.reference.cache_fct_hpp.template_function__cache_clone_____" title="Template
+ Function cache_clone<>()">Template
Function <code class="computeroutput"><span class="identifier">cache_clone</span><span class="special"><>()</span></code></a>
</h4></div></div></div>
<pre class="programlisting"><span class="keyword">template</span> <span class="special"><</span><span class="keyword">class</span> <span class="identifier">T</span><span class="special">></span>
@@ -76,7 +78,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="toward_boost_stm.reference.cache_fct_hpp.template_function__cache_copy_____"></a><a class="link" href="cache_fct_hpp.html#toward_boost_stm.reference.cache_fct_hpp.template_function__cache_copy_____" title="Template Function cache_copy<>()">Template
+<a name="toward_boost_stm.reference.cache_fct_hpp.template_function__cache_copy_____"></a><a href="cache_fct_hpp.html#toward_boost_stm.reference.cache_fct_hpp.template_function__cache_copy_____" title="Template
+ Function cache_copy<>()">Template
Function <code class="computeroutput"><span class="identifier">cache_copy</span><span class="special"><>()</span></code></a>
</h4></div></div></div>
<pre class="programlisting"><span class="keyword">template</span> <span class="special"><</span><span class="keyword">class</span> <span class="identifier">T</span><span class="special">></span>
@@ -99,7 +102,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="toward_boost_stm.reference.cache_fct_hpp.function__cache_release_____"></a><a class="link" href="cache_fct_hpp.html#toward_boost_stm.reference.cache_fct_hpp.function__cache_release_____" title="Function cache_release<>()">Function
+<a name="toward_boost_stm.reference.cache_fct_hpp.function__cache_release_____"></a><a href="cache_fct_hpp.html#toward_boost_stm.reference.cache_fct_hpp.function__cache_release_____" title="Function
+ cache_release<>()">Function
<code class="computeroutput"><span class="identifier">cache_release</span><span class="special"><>()</span></code></a>
</h4></div></div></div>
<pre class="programlisting"><span class="keyword">void</span> <span class="identifier">cache_release</span><span class="special">(</span><span class="identifier">base_transaction_object</span><span class="special">*</span> <span class="identifier">ptr</span><span class="special">)</span> <span class="special">{</span>
@@ -111,7 +115,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="toward_boost_stm.reference.cache_fct_hpp.template_function__cache_allocate_____"></a><a class="link" href="cache_fct_hpp.html#toward_boost_stm.reference.cache_fct_hpp.template_function__cache_allocate_____" title="Template Function cache_allocate<>()">Template
+<a name="toward_boost_stm.reference.cache_fct_hpp.template_function__cache_allocate_____"></a><a href="cache_fct_hpp.html#toward_boost_stm.reference.cache_fct_hpp.template_function__cache_allocate_____" title="Template
+ Function cache_allocate<>()">Template
Function <code class="computeroutput"><span class="identifier">cache_allocate</span><span class="special"><>()</span></code></a>
</h4></div></div></div>
<pre class="programlisting"><span class="keyword">template</span> <span class="special"><</span><span class="keyword">class</span> <span class="identifier">T</span><span class="special">></span>
@@ -126,7 +131,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="toward_boost_stm.reference.cache_fct_hpp.template_function__cache_deallocate_____"></a><a class="link" href="cache_fct_hpp.html#toward_boost_stm.reference.cache_fct_hpp.template_function__cache_deallocate_____" title="Template Function cache_deallocate<>()">Template
+<a name="toward_boost_stm.reference.cache_fct_hpp.template_function__cache_deallocate_____"></a><a href="cache_fct_hpp.html#toward_boost_stm.reference.cache_fct_hpp.template_function__cache_deallocate_____" title="Template
+ Function cache_deallocate<>()">Template
Function <code class="computeroutput"><span class="identifier">cache_deallocate</span><span class="special"><>()</span></code></a>
</h4></div></div></div>
<pre class="programlisting"><span class="keyword">template</span> <span class="special"><</span><span class="keyword">class</span> <span class="identifier">T</span><span class="special">></span>
Modified: sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/data_types_hpp.html
==============================================================================
--- sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/data_types_hpp.html (original)
+++ sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/data_types_hpp.html 2009-10-08 15:42:54 EDT (Thu, 08 Oct 2009)
@@ -1,13 +1,13 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
-<title>Header <boost/stm/data_types.hpp></title>
+<title> Header <boost/stm/data_types.hpp></title>
<link rel="stylesheet" href="../../../../../../doc/html/boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
+<meta name="generator" content="DocBook XSL Stylesheets V1.69.1">
<link rel="start" href="../../index.html" title="Chapter 1. Toward.Boost.STM">
<link rel="up" href="../reference.html" title="Reference">
-<link rel="prev" href="cache_fct_hpp.html" title="Header <boost/stm/cache_fct.hpp>">
-<link rel="next" href="exceptions_hpp.html" title="Header <boost/stm/exceptions.hpp>">
+<link rel="prev" href="cache_fct_hpp.html" title=" Header <boost/stm/cache_fct.hpp>">
+<link rel="next" href="exceptions_hpp.html" title=" Header <boost/stm/exceptions.hpp>">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table cellpadding="2" width="100%"><tr>
@@ -24,7 +24,7 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h3 class="title">
-<a name="toward_boost_stm.reference.data_types_hpp"></a><a class="link" href="data_types_hpp.html" title="Header <boost/stm/data_types.hpp>"> Header <code class="computeroutput"><span class="special"><</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">stm</span><span class="special">/</span><span class="identifier">data_types</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">></span></code></a>
+<a name="toward_boost_stm.reference.data_types_hpp"></a> Header <boost/stm/data_types.hpp>
</h3></div></div></div>
<div class="toc"><dl>
<dt><span class="section"><a href="data_types_hpp.html#toward_boost_stm.reference.data_types_hpp.enum__transaction_type_">Enum
@@ -45,7 +45,8 @@
</pre>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="toward_boost_stm.reference.data_types_hpp.enum__transaction_type_"></a><a class="link" href="data_types_hpp.html#toward_boost_stm.reference.data_types_hpp.enum__transaction_type_" title="Enum transaction_type">Enum
+<a name="toward_boost_stm.reference.data_types_hpp.enum__transaction_type_"></a><a href="data_types_hpp.html#toward_boost_stm.reference.data_types_hpp.enum__transaction_type_" title="Enum
+ transaction_type">Enum
<code class="computeroutput"><span class="identifier">transaction_type</span></code></a>
</h4></div></div></div>
<pre class="programlisting"> <span class="keyword">enum</span> <span class="identifier">transaction_type</span>
@@ -58,7 +59,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="toward_boost_stm.reference.data_types_hpp.enum__latm_type_"></a><a class="link" href="data_types_hpp.html#toward_boost_stm.reference.data_types_hpp.enum__latm_type_" title="Enum latm_type">Enum
+<a name="toward_boost_stm.reference.data_types_hpp.enum__latm_type_"></a><a href="data_types_hpp.html#toward_boost_stm.reference.data_types_hpp.enum__latm_type_" title="Enum
+ latm_type">Enum
<code class="computeroutput"><span class="identifier">latm_type</span></code></a>
</h4></div></div></div>
<pre class="programlisting"><span class="keyword">enum</span> <span class="identifier">latm_type</span>
@@ -71,7 +73,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="toward_boost_stm.reference.data_types_hpp.enum__transaction_state_"></a><a class="link" href="data_types_hpp.html#toward_boost_stm.reference.data_types_hpp.enum__transaction_state_" title="Enum transaction_state">Enum
+<a name="toward_boost_stm.reference.data_types_hpp.enum__transaction_state_"></a><a href="data_types_hpp.html#toward_boost_stm.reference.data_types_hpp.enum__transaction_state_" title="Enum
+ transaction_state">Enum
<code class="computeroutput"><span class="identifier">transaction_state</span></code></a>
</h4></div></div></div>
<pre class="programlisting"><span class="keyword">enum</span> <span class="identifier">transaction_state</span>
@@ -86,7 +89,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="toward_boost_stm.reference.data_types_hpp.typedef__thread_id_t_"></a><a class="link" href="data_types_hpp.html#toward_boost_stm.reference.data_types_hpp.typedef__thread_id_t_" title="Typedef thread_id_t">Typedef
+<a name="toward_boost_stm.reference.data_types_hpp.typedef__thread_id_t_"></a><a href="data_types_hpp.html#toward_boost_stm.reference.data_types_hpp.typedef__thread_id_t_" title="Typedef
+ thread_id_t">Typedef
<code class="computeroutput"><span class="identifier">thread_id_t</span></code></a>
</h4></div></div></div>
<pre class="programlisting"><span class="keyword">typedef</span> <span class="identifier">platform_specific</span> <span class="identifier">thread_id_t</span><span class="special">;</span>
Modified: sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/exceptions_hpp.html
==============================================================================
--- sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/exceptions_hpp.html (original)
+++ sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/exceptions_hpp.html 2009-10-08 15:42:54 EDT (Thu, 08 Oct 2009)
@@ -1,13 +1,14 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
-<title>Header <boost/stm/exceptions.hpp></title>
+<title> Header <boost/stm/exceptions.hpp></title>
<link rel="stylesheet" href="../../../../../../doc/html/boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
+<meta name="generator" content="DocBook XSL Stylesheets V1.69.1">
<link rel="start" href="../../index.html" title="Chapter 1. Toward.Boost.STM">
<link rel="up" href="../reference.html" title="Reference">
-<link rel="prev" href="data_types_hpp.html" title="Header <boost/stm/data_types.hpp>">
-<link rel="next" href="language_like_hpp.html" title="Header <boost/stm/language_like.hpp>">
+<link rel="prev" href="data_types_hpp.html" title=" Header <boost/stm/data_types.hpp>">
+<link rel="next" href="language_like_hpp.html" title=" Header
+ <boost/stm/language_like.hpp>">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table cellpadding="2" width="100%"><tr>
@@ -24,7 +25,7 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h3 class="title">
-<a name="toward_boost_stm.reference.exceptions_hpp"></a><a class="link" href="exceptions_hpp.html" title="Header <boost/stm/exceptions.hpp>"> Header <code class="computeroutput"><span class="special"><</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">stm</span><span class="special">/</span><span class="identifier">exceptions</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">></span></code></a>
+<a name="toward_boost_stm.reference.exceptions_hpp"></a> Header <boost/stm/exceptions.hpp>
</h3></div></div></div>
<div class="toc"><dl><dt><span class="section"><a href="exceptions_hpp.html#toward_boost_stm.reference.exceptions_hpp.class__aborted_transaction_exception_">Class
<code class="computeroutput"><span class="identifier">aborted_transaction_exception</span></code></a></span></dt></dl></div>
@@ -33,7 +34,8 @@
<span class="special">}}</span>
</pre>
<div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title">
-<a name="toward_boost_stm.reference.exceptions_hpp.class__aborted_transaction_exception_"></a><a class="link" href="exceptions_hpp.html#toward_boost_stm.reference.exceptions_hpp.class__aborted_transaction_exception_" title="Class aborted_transaction_exception">Class
+<a name="toward_boost_stm.reference.exceptions_hpp.class__aborted_transaction_exception_"></a><a href="exceptions_hpp.html#toward_boost_stm.reference.exceptions_hpp.class__aborted_transaction_exception_" title="Class
+ aborted_transaction_exception">Class
<code class="computeroutput"><span class="identifier">aborted_transaction_exception</span></code></a>
</h4></div></div></div></div>
</div>
Modified: sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/language_like_hpp.html
==============================================================================
--- sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/language_like_hpp.html (original)
+++ sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/language_like_hpp.html 2009-10-08 15:42:54 EDT (Thu, 08 Oct 2009)
@@ -1,13 +1,15 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
-<title>Header <boost/stm/language_like.hpp></title>
+<title> Header
+ <boost/stm/language_like.hpp></title>
<link rel="stylesheet" href="../../../../../../doc/html/boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
+<meta name="generator" content="DocBook XSL Stylesheets V1.69.1">
<link rel="start" href="../../index.html" title="Chapter 1. Toward.Boost.STM">
<link rel="up" href="../reference.html" title="Reference">
-<link rel="prev" href="exceptions_hpp.html" title="Header <boost/stm/exceptions.hpp>">
-<link rel="next" href="transaction_hpp.html" title="Header <boost/stm/transaction.hpp>">
+<link rel="prev" href="exceptions_hpp.html" title=" Header <boost/stm/exceptions.hpp>">
+<link rel="next" href="transaction_hpp.html" title=" Header
+ <boost/stm/transaction.hpp>">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table cellpadding="2" width="100%"><tr>
@@ -24,7 +26,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h3 class="title">
-<a name="toward_boost_stm.reference.language_like_hpp"></a><a class="link" href="language_like_hpp.html" title="Header <boost/stm/language_like.hpp>"> Header
+<a name="toward_boost_stm.reference.language_like_hpp"></a><a href="language_like_hpp.html" title=" Header
+ <boost/stm/language_like.hpp>"> Header
<code class="computeroutput"><span class="special"><</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">stm</span><span class="special">/</span><span class="identifier">language_like</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">></span></code></a>
</h3></div></div></div>
<div class="toc"><dl>
@@ -109,7 +112,8 @@
</pre>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="toward_boost_stm.reference.language_like_hpp.macro__atomic_"></a><a class="link" href="language_like_hpp.html#toward_boost_stm.reference.language_like_hpp.macro__atomic_" title="Macro atomic">Macro
+<a name="toward_boost_stm.reference.language_like_hpp.macro__atomic_"></a><a href="language_like_hpp.html#toward_boost_stm.reference.language_like_hpp.macro__atomic_" title="Macro
+ atomic">Macro
<code class="computeroutput"><span class="identifier">atomic</span></code></a>
</h4></div></div></div>
<p>
@@ -127,7 +131,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="toward_boost_stm.reference.language_like_hpp.macro__try_atomic_"></a><a class="link" href="language_like_hpp.html#toward_boost_stm.reference.language_like_hpp.macro__try_atomic_" title="Macro try_atomic">Macro
+<a name="toward_boost_stm.reference.language_like_hpp.macro__try_atomic_"></a><a href="language_like_hpp.html#toward_boost_stm.reference.language_like_hpp.macro__try_atomic_" title="Macro
+ try_atomic">Macro
<code class="computeroutput"><span class="identifier">try_atomic</span></code></a>
</h4></div></div></div>
<pre class="programlisting"><span class="preprocessor">#define</span> <span class="identifier">try_atomic</span><span class="special">(</span><span class="identifier">T</span><span class="special">)</span> <span class="special">\</span>
@@ -139,7 +144,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="toward_boost_stm.reference.language_like_hpp.macro__use_atomic_"></a><a class="link" href="language_like_hpp.html#toward_boost_stm.reference.language_like_hpp.macro__use_atomic_" title="Macro use_atomic">Macro
+<a name="toward_boost_stm.reference.language_like_hpp.macro__use_atomic_"></a><a href="language_like_hpp.html#toward_boost_stm.reference.language_like_hpp.macro__use_atomic_" title="Macro
+ use_atomic">Macro
<code class="computeroutput"><span class="identifier">use_atomic</span></code></a>
</h4></div></div></div>
<pre class="programlisting"><span class="preprocessor">#define</span> <span class="identifier">use_atomic</span><span class="special">(</span><span class="identifier">T</span><span class="special">)</span> <span class="special">\</span>
@@ -150,7 +156,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="toward_boost_stm.reference.language_like_hpp.macro__catch_before_retry_"></a><a class="link" href="language_like_hpp.html#toward_boost_stm.reference.language_like_hpp.macro__catch_before_retry_" title="Macro catch_before_retry">Macro
+<a name="toward_boost_stm.reference.language_like_hpp.macro__catch_before_retry_"></a><a href="language_like_hpp.html#toward_boost_stm.reference.language_like_hpp.macro__catch_before_retry_" title="Macro
+ catch_before_retry">Macro
<code class="computeroutput"><span class="identifier">catch_before_retry</span></code></a>
</h4></div></div></div>
<pre class="programlisting"><span class="preprocessor">#define</span> <span class="identifier">catch_before_retry</span><span class="special">(</span><span class="identifier">E</span><span class="special">)</span> <span class="keyword">catch</span> <span class="special">(</span><span class="identifier">aborted_tx</span> <span class="special">&</span><span class="identifier">E</span><span class="special">)</span>
@@ -169,7 +176,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="toward_boost_stm.reference.language_like_hpp.macro__before_retry_"></a><a class="link" href="language_like_hpp.html#toward_boost_stm.reference.language_like_hpp.macro__before_retry_" title="Macro before_retry">Macro
+<a name="toward_boost_stm.reference.language_like_hpp.macro__before_retry_"></a><a href="language_like_hpp.html#toward_boost_stm.reference.language_like_hpp.macro__before_retry_" title="Macro
+ before_retry">Macro
<code class="computeroutput"><span class="identifier">before_retry</span></code></a>
</h4></div></div></div>
<pre class="programlisting"><span class="preprocessor">#define</span> <span class="identifier">before_retry</span> <span class="keyword">catch</span> <span class="special">(</span><span class="identifier">aborted_tx</span> <span class="special">&)</span>
@@ -184,7 +192,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="toward_boost_stm.reference.language_like_hpp.macro__end_atom_"></a><a class="link" href="language_like_hpp.html#toward_boost_stm.reference.language_like_hpp.macro__end_atom_" title="Macro end_atom">Macro
+<a name="toward_boost_stm.reference.language_like_hpp.macro__end_atom_"></a><a href="language_like_hpp.html#toward_boost_stm.reference.language_like_hpp.macro__end_atom_" title="Macro
+ end_atom">Macro
<code class="computeroutput"><span class="identifier">end_atom</span></code></a>
</h4></div></div></div>
<pre class="programlisting"><span class="preprocessor">#define</span> <span class="identifier">end_atom</span> <span class="keyword">catch</span> <span class="special">(</span><span class="identifier">aborted_tx</span> <span class="special">&)</span> <span class="special">{}</span>
Modified: sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/non_tx_smart_ptr_hpp.html
==============================================================================
--- sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/non_tx_smart_ptr_hpp.html (original)
+++ sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/non_tx_smart_ptr_hpp.html 2009-10-08 15:42:54 EDT (Thu, 08 Oct 2009)
@@ -1,13 +1,16 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
-<title>Header <boost/stm/non_tx_smart_ptr.hpp></title>
+<title> Header
+ <boost/stm/non_tx_smart_ptr.hpp></title>
<link rel="stylesheet" href="../../../../../../doc/html/boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
+<meta name="generator" content="DocBook XSL Stylesheets V1.69.1">
<link rel="start" href="../../index.html" title="Chapter 1. Toward.Boost.STM">
<link rel="up" href="../reference.html" title="Reference">
-<link rel="prev" href="tx_smart_ptr_hpp.html" title="Header <boost/stm/tx_smart_ptr.hpp>">
-<link rel="next" href="transaction_bookkeeping_hpp.html" title="Header <boost/stm/transaction_bookkeeping.hpp>">
+<link rel="prev" href="tx_smart_ptr_hpp.html" title=" Header
+ <boost/stm/tx_smart_ptr.hpp>">
+<link rel="next" href="transaction_bookkeeping_hpp.html" title="
+ Header <boost/stm/transaction_bookkeeping.hpp>">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table cellpadding="2" width="100%"><tr>
@@ -24,7 +27,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h3 class="title">
-<a name="toward_boost_stm.reference.non_tx_smart_ptr_hpp"></a><a class="link" href="non_tx_smart_ptr_hpp.html" title="Header <boost/stm/non_tx_smart_ptr.hpp>"> Header
+<a name="toward_boost_stm.reference.non_tx_smart_ptr_hpp"></a><a href="non_tx_smart_ptr_hpp.html" title=" Header
+ <boost/stm/non_tx_smart_ptr.hpp>"> Header
<code class="computeroutput"><span class="special"><</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">stm</span><span class="special">/</span><span class="identifier">non_tx_smart_ptr</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">></span></code></a>
</h3></div></div></div>
<div class="toc"><dl>
@@ -62,7 +66,8 @@
</p>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="toward_boost_stm.reference.non_tx_smart_ptr_hpp.template_class__rd_ptr___"></a><a class="link" href="non_tx_smart_ptr_hpp.html#toward_boost_stm.reference.non_tx_smart_ptr_hpp.template_class__rd_ptr___" title="Template Class rd_ptr<>">Template
+<a name="toward_boost_stm.reference.non_tx_smart_ptr_hpp.template_class__rd_ptr___"></a><a href="non_tx_smart_ptr_hpp.html#toward_boost_stm.reference.non_tx_smart_ptr_hpp.template_class__rd_ptr___" title="Template
+ Class rd_ptr<>">Template
Class <code class="computeroutput"><span class="identifier">rd_ptr</span><span class="special"><></span></code></a>
</h4></div></div></div>
<p>
@@ -105,7 +110,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="toward_boost_stm.reference.non_tx_smart_ptr_hpp.template_class__upgrd_ptr___"></a><a class="link" href="non_tx_smart_ptr_hpp.html#toward_boost_stm.reference.non_tx_smart_ptr_hpp.template_class__upgrd_ptr___" title="Template Class upgrd_ptr<>">Template
+<a name="toward_boost_stm.reference.non_tx_smart_ptr_hpp.template_class__upgrd_ptr___"></a><a href="non_tx_smart_ptr_hpp.html#toward_boost_stm.reference.non_tx_smart_ptr_hpp.template_class__upgrd_ptr___" title="Template
+ Class upgrd_ptr<>">Template
Class <code class="computeroutput"><span class="identifier">upgrd_ptr</span><span class="special"><></span></code></a>
</h4></div></div></div>
<p>
@@ -148,7 +154,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="toward_boost_stm.reference.non_tx_smart_ptr_hpp.template_class__wr_ptr___"></a><a class="link" href="non_tx_smart_ptr_hpp.html#toward_boost_stm.reference.non_tx_smart_ptr_hpp.template_class__wr_ptr___" title="Template Class wr_ptr<>">Template
+<a name="toward_boost_stm.reference.non_tx_smart_ptr_hpp.template_class__wr_ptr___"></a><a href="non_tx_smart_ptr_hpp.html#toward_boost_stm.reference.non_tx_smart_ptr_hpp.template_class__wr_ptr___" title="Template
+ Class wr_ptr<>">Template
Class <code class="computeroutput"><span class="identifier">wr_ptr</span><span class="special"><></span></code></a>
</h4></div></div></div>
<p>
Modified: sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/transaction_bookkeeping_hpp.html
==============================================================================
--- sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/transaction_bookkeeping_hpp.html (original)
+++ sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/transaction_bookkeeping_hpp.html 2009-10-08 15:42:54 EDT (Thu, 08 Oct 2009)
@@ -1,12 +1,14 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
-<title>Header <boost/stm/transaction_bookkeeping.hpp></title>
+<title>
+ Header <boost/stm/transaction_bookkeeping.hpp></title>
<link rel="stylesheet" href="../../../../../../doc/html/boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
+<meta name="generator" content="DocBook XSL Stylesheets V1.69.1">
<link rel="start" href="../../index.html" title="Chapter 1. Toward.Boost.STM">
<link rel="up" href="../reference.html" title="Reference">
-<link rel="prev" href="non_tx_smart_ptr_hpp.html" title="Header <boost/stm/non_tx_smart_ptr.hpp>">
+<link rel="prev" href="non_tx_smart_ptr_hpp.html" title=" Header
+ <boost/stm/non_tx_smart_ptr.hpp>">
<link rel="next" href="../examples.html" title="Examples">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -24,7 +26,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h3 class="title">
-<a name="toward_boost_stm.reference.transaction_bookkeeping_hpp"></a><a class="link" href="transaction_bookkeeping_hpp.html" title="Header <boost/stm/transaction_bookkeeping.hpp>">
+<a name="toward_boost_stm.reference.transaction_bookkeeping_hpp"></a><a href="transaction_bookkeeping_hpp.html" title="
+ Header <boost/stm/transaction_bookkeeping.hpp>">
Header <code class="computeroutput"><span class="special"><</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">stm</span><span class="special">/</span><span class="identifier">transaction_bookkeeping</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">></span></code></a>
</h3></div></div></div>
<div class="toc"><dl><dt><span class="section"><a href="transaction_bookkeeping_hpp.html#toward_boost_stm.reference.transaction_bookkeeping_hpp.class__transaction_bookkeeping_">Class
@@ -35,7 +38,8 @@
</pre>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="toward_boost_stm.reference.transaction_bookkeeping_hpp.class__transaction_bookkeeping_"></a><a class="link" href="transaction_bookkeeping_hpp.html#toward_boost_stm.reference.transaction_bookkeeping_hpp.class__transaction_bookkeeping_" title="Class transaction_bookkeeping">Class
+<a name="toward_boost_stm.reference.transaction_bookkeeping_hpp.class__transaction_bookkeeping_"></a><a href="transaction_bookkeeping_hpp.html#toward_boost_stm.reference.transaction_bookkeeping_hpp.class__transaction_bookkeeping_" title="Class
+ transaction_bookkeeping">Class
<code class="computeroutput"><span class="identifier">transaction_bookkeeping</span></code></a>
</h4></div></div></div>
<pre class="programlisting"><span class="keyword">class</span> <span class="identifier">transaction_bookkeeping</span>
Modified: sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/transaction_hpp.html
==============================================================================
--- sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/transaction_hpp.html (original)
+++ sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/transaction_hpp.html 2009-10-08 15:42:54 EDT (Thu, 08 Oct 2009)
@@ -1,13 +1,16 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
-<title>Header <boost/stm/transaction.hpp></title>
+<title> Header
+ <boost/stm/transaction.hpp></title>
<link rel="stylesheet" href="../../../../../../doc/html/boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
+<meta name="generator" content="DocBook XSL Stylesheets V1.69.1">
<link rel="start" href="../../index.html" title="Chapter 1. Toward.Boost.STM">
<link rel="up" href="../reference.html" title="Reference">
-<link rel="prev" href="language_like_hpp.html" title="Header <boost/stm/language_like.hpp>">
-<link rel="next" href="transaction_object_hpp.html" title="Header <boost/stm/transaction_object.hpp>">
+<link rel="prev" href="language_like_hpp.html" title=" Header
+ <boost/stm/language_like.hpp>">
+<link rel="next" href="transaction_object_hpp.html" title=" Header
+ <boost/stm/transaction_object.hpp>">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table cellpadding="2" width="100%"><tr>
@@ -24,7 +27,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h3 class="title">
-<a name="toward_boost_stm.reference.transaction_hpp"></a><a class="link" href="transaction_hpp.html" title="Header <boost/stm/transaction.hpp>"> Header
+<a name="toward_boost_stm.reference.transaction_hpp"></a><a href="transaction_hpp.html" title=" Header
+ <boost/stm/transaction.hpp>"> Header
<code class="computeroutput"><span class="special"><</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">stm</span><span class="special">/</span><span class="identifier">transaction</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">></span></code></a>
</h3></div></div></div>
<div class="toc"><dl>
@@ -164,7 +168,8 @@
</pre>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_"></a><a class="link" href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_" title="Class transaction">Class
+<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_"></a><a href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_" title="Class
+ transaction">Class
<code class="computeroutput"><span class="identifier">transaction</span></code></a>
</h4></div></div></div>
<div class="toc"><dl>
@@ -396,7 +401,8 @@
</pre>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__initialize___"></a><a class="link" href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__initialize___" title="Static Function initialize()">Static
+<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__initialize___"></a><a href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__initialize___" title="Static
+ Function initialize()">Static
Function <code class="computeroutput"><span class="identifier">initialize</span><span class="special">()</span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">static</span> <span class="keyword">void</span> <span class="identifier">initialize</span><span class="special">();</span>
@@ -408,7 +414,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__initialize_thread___"></a><a class="link" href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__initialize_thread___" title="Static Function initialize_thread()">Static
+<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__initialize_thread___"></a><a href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__initialize_thread___" title="Static
+ Function initialize_thread()">Static
Function <code class="computeroutput"><span class="identifier">initialize_thread</span><span class="special">()</span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">static</span> <span class="keyword">void</span> <span class="identifier">initialize_thread</span><span class="special">();</span>
@@ -421,7 +428,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__terminate_thread___"></a><a class="link" href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__terminate_thread___" title="Static Function terminate_thread()">Static
+<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__terminate_thread___"></a><a href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__terminate_thread___" title="Static
+ Function terminate_thread()">Static
Function <code class="computeroutput"><span class="identifier">terminate_thread</span><span class="special">()</span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">static</span> <span class="keyword">void</span> <span class="identifier">terminate_thread</span><span class="special">();</span>
@@ -435,7 +443,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__contention_manager_"></a><a class="link" href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__contention_manager_" title="Static Function contention_manager">Static
+<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__contention_manager_"></a><a href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__contention_manager_" title="Static
+ Function contention_manager">Static
Function <code class="computeroutput"><span class="identifier">contention_manager</span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">static</span> <span class="keyword">void</span> <span class="identifier">contention_manager</span><span class="special">(</span><span class="identifier">base_contention_manager</span> <span class="special">*</span><span class="identifier">rhs</span><span class="special">);</span>
@@ -450,7 +459,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__get_contention_manager_"></a><a class="link" href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__get_contention_manager_" title="Static Function get_contention_manager">Static
+<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__get_contention_manager_"></a><a href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__get_contention_manager_" title="Static
+ Function get_contention_manager">Static
Function <code class="computeroutput"><span class="identifier">get_contention_manager</span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">static</span> <span class="identifier">base_contention_manager</span><span class="special">*</span> <span class="identifier">get_contention_manager</span><span class="special">();</span>
@@ -463,7 +473,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__enable_dynamic_priority_assignment_"></a><a class="link" href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__enable_dynamic_priority_assignment_" title="Static Function enable_dynamic_priority_assignment">Static
+<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__enable_dynamic_priority_assignment_"></a><a href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__enable_dynamic_priority_assignment_" title="Static
+ Function enable_dynamic_priority_assignment">Static
Function <code class="computeroutput"><span class="identifier">enable_dynamic_priority_assignment</span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">static</span> <span class="keyword">bool</span> <span class="identifier">enable_dynamic_priority_assignment</span><span class="special">();</span>
@@ -471,7 +482,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__disable_dynamic_priority_assignment_"></a><a class="link" href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__disable_dynamic_priority_assignment_" title="Static Function disable_dynamic_priority_assignment">Static
+<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__disable_dynamic_priority_assignment_"></a><a href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__disable_dynamic_priority_assignment_" title="Static
+ Function disable_dynamic_priority_assignment">Static
Function <code class="computeroutput"><span class="identifier">disable_dynamic_priority_assignment</span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">static</span> <span class="keyword">bool</span> <span class="identifier">disable_dynamic_priority_assignment</span><span class="special">();</span>
@@ -479,7 +491,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__doing_dynamic_priority_assignment_"></a><a class="link" href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__doing_dynamic_priority_assignment_" title="Static Function doing_dynamic_priority_assignment">Static
+<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__doing_dynamic_priority_assignment_"></a><a href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__doing_dynamic_priority_assignment_" title="Static
+ Function doing_dynamic_priority_assignment">Static
Function <code class="computeroutput"><span class="identifier">doing_dynamic_priority_assignment</span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">static</span> <span class="keyword">bool</span> <span class="identifier">doing_dynamic_priority_assignment</span><span class="special">();</span>
@@ -487,7 +500,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__enableloggingofabortandcommitsetsize_"></a><a class="link" href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__enableloggingofabortandcommitsetsize_" title="Static Function enableLoggingOfAbortAndCommitSetSize">Static
+<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__enableloggingofabortandcommitsetsize_"></a><a href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__enableloggingofabortandcommitsetsize_" title="Static
+ Function enableLoggingOfAbortAndCommitSetSize">Static
Function <code class="computeroutput"><span class="identifier">enableLoggingOfAbortAndCommitSetSize</span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">static</span> <span class="keyword">void</span> <span class="identifier">enableLoggingOfAbortAndCommitSetSize</span><span class="special">();</span>
@@ -495,7 +509,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__disableloggingofabortandcommitsetsize_"></a><a class="link" href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__disableloggingofabortandcommitsetsize_" title="Static Function disableLoggingOfAbortAndCommitSetSize">Static
+<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__disableloggingofabortandcommitsetsize_"></a><a href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__disableloggingofabortandcommitsetsize_" title="Static
+ Function disableLoggingOfAbortAndCommitSetSize">Static
Function <code class="computeroutput"><span class="identifier">disableLoggingOfAbortAndCommitSetSize</span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">static</span> <span class="keyword">void</span> <span class="identifier">disableLoggingOfAbortAndCommitSetSize</span><span class="special">();</span>
@@ -503,7 +518,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__transaction_bookkeeping_"></a><a class="link" href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__transaction_bookkeeping_" title="Static Function transaction_bookkeeping">Static
+<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__transaction_bookkeeping_"></a><a href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__transaction_bookkeeping_" title="Static
+ Function transaction_bookkeeping">Static
Function <code class="computeroutput"><span class="identifier">transaction_bookkeeping</span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">static</span> <span class="keyword">const</span> <span class="identifier">transaction_bookkeeping</span> <span class="special">&</span> <span class="identifier">bookkeeping</span><span class="special">();</span>
@@ -511,7 +527,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__early_conflict_detection_"></a><a class="link" href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__early_conflict_detection_" title="Static Function early_conflict_detection">Static
+<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__early_conflict_detection_"></a><a href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__early_conflict_detection_" title="Static
+ Function early_conflict_detection">Static
Function <code class="computeroutput"><span class="identifier">early_conflict_detection</span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">static</span> <span class="keyword">bool</span> <span class="identifier">early_conflict_detection</span><span class="special">();</span>
@@ -523,7 +540,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__late_conflict_detection_"></a><a class="link" href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__late_conflict_detection_" title="Static Function late_conflict_detection">Static
+<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__late_conflict_detection_"></a><a href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__late_conflict_detection_" title="Static
+ Function late_conflict_detection">Static
Function <code class="computeroutput"><span class="identifier">late_conflict_detection</span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">static</span> <span class="keyword">bool</span> <span class="identifier">late_conflict_detection</span><span class="special">();</span>
@@ -535,7 +553,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__do_early_conflict_detection_"></a><a class="link" href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__do_early_conflict_detection_" title="Static Function do_early_conflict_detection">Static
+<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__do_early_conflict_detection_"></a><a href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__do_early_conflict_detection_" title="Static
+ Function do_early_conflict_detection">Static
Function <code class="computeroutput"><span class="identifier">do_early_conflict_detection</span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">static</span> <span class="keyword">bool</span> <span class="identifier">do_early_conflict_detection</span><span class="special">();</span>
@@ -548,7 +567,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__do_late_conflict_detection_"></a><a class="link" href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__do_late_conflict_detection_" title="Static Function do_late_conflict_detection">Static
+<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__do_late_conflict_detection_"></a><a href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__do_late_conflict_detection_" title="Static
+ Function do_late_conflict_detection">Static
Function <code class="computeroutput"><span class="identifier">do_late_conflict_detection</span></code></a>
</h5></div></div></div>
<p>
@@ -561,7 +581,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__consistency_checking_string_"></a><a class="link" href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__consistency_checking_string_" title="Static Function consistency_checking_string">Static
+<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__consistency_checking_string_"></a><a href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__consistency_checking_string_" title="Static
+ Function consistency_checking_string">Static
Function <code class="computeroutput"><span class="identifier">consistency_checking_string</span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">static</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span> <span class="identifier">consistency_checking_string</span><span class="special">();</span>
@@ -569,7 +590,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__validating_"></a><a class="link" href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__validating_" title="Static Function validating">Static
+<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__validating_"></a><a href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__validating_" title="Static
+ Function validating">Static
Function <code class="computeroutput"><span class="identifier">validating</span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">static</span> <span class="keyword">bool</span> <span class="identifier">validating</span><span class="special">();</span>
@@ -577,7 +599,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__invalidating_"></a><a class="link" href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__invalidating_" title="Static Function invalidating">Static
+<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__invalidating_"></a><a href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__invalidating_" title="Static
+ Function invalidating">Static
Function <code class="computeroutput"><span class="identifier">invalidating</span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">static</span> <span class="keyword">bool</span> <span class="identifier">invalidating</span><span class="special">();</span>
@@ -585,7 +608,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__direct_updating_"></a><a class="link" href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__direct_updating_" title="Static Function direct_updating">Static
+<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__direct_updating_"></a><a href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__direct_updating_" title="Static
+ Function direct_updating">Static
Function <code class="computeroutput"><span class="identifier">direct_updating</span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">static</span> <span class="keyword">bool</span> <span class="identifier">direct_updating</span><span class="special">()</span>
@@ -596,7 +620,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__deferred_updating_"></a><a class="link" href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__deferred_updating_" title="Static Function deferred_updating">Static
+<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__deferred_updating_"></a><a href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__deferred_updating_" title="Static
+ Function deferred_updating">Static
Function <code class="computeroutput"><span class="identifier">deferred_updating</span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">static</span> <span class="keyword">bool</span> <span class="identifier">deferred_updating</span><span class="special">();</span>
@@ -607,7 +632,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__do_direct_updating_"></a><a class="link" href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__do_direct_updating_" title="Static Function do_direct_updating">Static
+<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__do_direct_updating_"></a><a href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__do_direct_updating_" title="Static
+ Function do_direct_updating">Static
Function <code class="computeroutput"><span class="identifier">do_direct_updating</span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">static</span> <span class="keyword">bool</span> <span class="identifier">do_direct_updating</span><span class="special">();</span>
@@ -620,7 +646,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__do_deferred_updating_"></a><a class="link" href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__do_deferred_updating_" title="Static Function do_deferred_updating">Static
+<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__do_deferred_updating_"></a><a href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__do_deferred_updating_" title="Static
+ Function do_deferred_updating">Static
Function <code class="computeroutput"><span class="identifier">do_deferred_updating</span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">static</span> <span class="keyword">bool</span> <span class="identifier">do_deferred_updating</span><span class="special">();</span>
@@ -633,7 +660,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__update_policy_string_"></a><a class="link" href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__update_policy_string_" title="Static Function update_policy_string">Static
+<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__update_policy_string_"></a><a href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__update_policy_string_" title="Static
+ Function update_policy_string">Static
Function <code class="computeroutput"><span class="identifier">update_policy_string</span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">static</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span> <span class="identifier">update_policy_string</span><span class="special">();</span>
@@ -641,7 +669,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__latm_protection_"></a><a class="link" href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__latm_protection_" title="Static Function latm_protection">Static
+<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__latm_protection_"></a><a href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__latm_protection_" title="Static
+ Function latm_protection">Static
Function <code class="computeroutput"><span class="identifier">latm_protection</span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">static</span> <span class="identifier">latm_type</span> <span class="keyword">const</span> <span class="identifier">latm_protection</span><span class="special">();</span>
@@ -649,7 +678,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__latm_protection_str_"></a><a class="link" href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__latm_protection_str_" title="Static Function latm_protection_str">Static
+<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__latm_protection_str_"></a><a href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__latm_protection_str_" title="Static
+ Function latm_protection_str">Static
Function <code class="computeroutput"><span class="identifier">latm_protection_str</span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">static</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span> <span class="keyword">const</span> <span class="identifier">latm_protection_str</span><span class="special">();</span>
@@ -657,7 +687,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__do_full_lock_protection_"></a><a class="link" href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__do_full_lock_protection_" title="Static Function do_full_lock_protection">Static
+<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__do_full_lock_protection_"></a><a href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__do_full_lock_protection_" title="Static
+ Function do_full_lock_protection">Static
Function <code class="computeroutput"><span class="identifier">do_full_lock_protection</span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">static</span> <span class="keyword">void</span> <span class="identifier">do_full_lock_protection</span><span class="special">();</span>
@@ -665,7 +696,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__do_tm_lock_protection_"></a><a class="link" href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__do_tm_lock_protection_" title="Static Function do_tm_lock_protection">Static
+<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__do_tm_lock_protection_"></a><a href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__do_tm_lock_protection_" title="Static
+ Function do_tm_lock_protection">Static
Function <code class="computeroutput"><span class="identifier">do_tm_lock_protection</span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">static</span> <span class="keyword">void</span> <span class="identifier">do_tm_lock_protection</span><span class="special">();</span>
@@ -673,7 +705,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__do_tx_lock_protection_"></a><a class="link" href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__do_tx_lock_protection_" title="Static Function do_tx_lock_protection">Static
+<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__do_tx_lock_protection_"></a><a href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__do_tx_lock_protection_" title="Static
+ Function do_tx_lock_protection">Static
Function <code class="computeroutput"><span class="identifier">do_tx_lock_protection</span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">static</span> <span class="keyword">void</span> <span class="identifier">do_tx_lock_protection</span><span class="special">();</span>
@@ -681,7 +714,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__doing_tx_lock_protection_"></a><a class="link" href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__doing_tx_lock_protection_" title="Static Function doing_tx_lock_protection">Static
+<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__doing_tx_lock_protection_"></a><a href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__doing_tx_lock_protection_" title="Static
+ Function doing_tx_lock_protection">Static
Function <code class="computeroutput"><span class="identifier">doing_tx_lock_protection</span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">static</span> <span class="keyword">bool</span> <span class="identifier">doing_tx_lock_protection</span><span class="special">();</span>
@@ -689,7 +723,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__doing_full_lock_protection_"></a><a class="link" href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__doing_full_lock_protection_" title="Static Function doing_full_lock_protection">Static
+<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__doing_full_lock_protection_"></a><a href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__doing_full_lock_protection_" title="Static
+ Function doing_full_lock_protection">Static
Function <code class="computeroutput"><span class="identifier">doing_full_lock_protection</span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">static</span> <span class="keyword">bool</span> <span class="identifier">doing_full_lock_protection</span><span class="special">();</span>
@@ -697,7 +732,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__doing_tm_lock_protection_"></a><a class="link" href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__doing_tm_lock_protection_" title="Static Function doing_tm_lock_protection">Static
+<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__doing_tm_lock_protection_"></a><a href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__doing_tm_lock_protection_" title="Static
+ Function doing_tm_lock_protection">Static
Function <code class="computeroutput"><span class="identifier">doing_tm_lock_protection</span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">static</span> <span class="keyword">bool</span> <span class="identifier">doing_tm_lock_protection</span><span class="special">();</span>
@@ -705,7 +741,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__in_flight_transactions_"></a><a class="link" href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__in_flight_transactions_" title="Static Function in_flight_transactions">Static
+<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__in_flight_transactions_"></a><a href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.static_function__in_flight_transactions_" title="Static
+ Function in_flight_transactions">Static
Function <code class="computeroutput"><span class="identifier">in_flight_transactions</span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">static</span> <span class="identifier">InflightTxes</span> <span class="keyword">const</span> <span class="special">&</span> <span class="identifier">in_flight_transactions</span><span class="special">();</span>
@@ -713,7 +750,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.constructor__transaction___"></a><a class="link" href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.constructor__transaction___" title="Constructor transaction()">Constructor
+<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.constructor__transaction___"></a><a href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.constructor__transaction___" title="Constructor
+ transaction()">Constructor
<code class="computeroutput"><span class="identifier">transaction</span><span class="special">()</span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="identifier">transaction</span><span class="special">();</span>
@@ -726,7 +764,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.destructor___transaction___"></a><a class="link" href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.destructor___transaction___" title="Destructor ~transaction()">Destructor
+<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.destructor___transaction___"></a><a href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.destructor___transaction___" title="Destructor
+ ~transaction()">Destructor
<code class="computeroutput"><span class="special">~</span><span class="identifier">transaction</span><span class="special">()</span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="special">~</span><span class="identifier">transaction</span><span class="special">();</span>
@@ -740,7 +779,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.member_function__committed_"></a><a class="link" href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.member_function__committed_" title="Member Function committed">Member
+<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.member_function__committed_"></a><a href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.member_function__committed_" title="Member
+ Function committed">Member
Function <code class="computeroutput"><span class="identifier">committed</span></code></a>
</h5></div></div></div>
<p>
@@ -751,7 +791,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.member_function__aborted_"></a><a class="link" href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.member_function__aborted_" title="Member Function aborted">Member
+<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.member_function__aborted_"></a><a href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.member_function__aborted_" title="Member
+ Function aborted">Member
Function <code class="computeroutput"><span class="identifier">aborted</span></code></a>
</h5></div></div></div>
<p>
@@ -762,7 +803,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.member_function__in_flight_"></a><a class="link" href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.member_function__in_flight_" title="Member Function in_flight">Member
+<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.member_function__in_flight_"></a><a href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.member_function__in_flight_" title="Member
+ Function in_flight">Member
Function <code class="computeroutput"><span class="identifier">in_flight</span></code></a>
</h5></div></div></div>
<p>
@@ -773,7 +815,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.member_function__begin_"></a><a class="link" href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.member_function__begin_" title="Member Function begin">Member
+<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.member_function__begin_"></a><a href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.member_function__begin_" title="Member
+ Function begin">Member
Function <code class="computeroutput"><span class="identifier">begin</span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">void</span> <span class="identifier">begin</span><span class="special">();</span>
@@ -781,7 +824,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.member_function__restart_"></a><a class="link" href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.member_function__restart_" title="Member Function restart">Member
+<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.member_function__restart_"></a><a href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.member_function__restart_" title="Member
+ Function restart">Member
Function <code class="computeroutput"><span class="identifier">restart</span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">bool</span> <span class="identifier">restart</span><span class="special">();</span>
@@ -800,7 +844,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.member_function__restart_if_not_inflight_"></a><a class="link" href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.member_function__restart_if_not_inflight_" title="Member Function restart_if_not_inflight">Member
+<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.member_function__restart_if_not_inflight_"></a><a href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.member_function__restart_if_not_inflight_" title="Member
+ Function restart_if_not_inflight">Member
Function <code class="computeroutput"><span class="identifier">restart_if_not_inflight</span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">bool</span> <span class="identifier">restart_if_not_inflight</span><span class="special">();</span>
@@ -808,7 +853,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.member_function__end_"></a><a class="link" href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.member_function__end_" title="Member Function end">Member
+<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.member_function__end_"></a><a href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.member_function__end_" title="Member
+ Function end">Member
Function <code class="computeroutput"><span class="identifier">end</span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">void</span> <span class="identifier">end</span><span class="special">();</span>
@@ -829,7 +875,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.member_function__no_throw_end_"></a><a class="link" href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.member_function__no_throw_end_" title="Member Function no_throw_end">Member
+<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.member_function__no_throw_end_"></a><a href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.member_function__no_throw_end_" title="Member
+ Function no_throw_end">Member
Function <code class="computeroutput"><span class="identifier">no_throw_end</span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">void</span> <span class="identifier">no_throw_end</span><span class="special">();</span>
@@ -840,7 +887,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.member_function__force_to_abort_"></a><a class="link" href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.member_function__force_to_abort_" title="Member Function force_to_abort">Member
+<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.member_function__force_to_abort_"></a><a href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.member_function__force_to_abort_" title="Member
+ Function force_to_abort">Member
Function <code class="computeroutput"><span class="identifier">force_to_abort</span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">void</span> <span class="identifier">force_to_abort</span><span class="special">();</span>
@@ -848,7 +896,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.member_function__unforce_to_abort_"></a><a class="link" href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.member_function__unforce_to_abort_" title="Member Function unforce_to_abort">Member
+<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.member_function__unforce_to_abort_"></a><a href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.member_function__unforce_to_abort_" title="Member
+ Function unforce_to_abort">Member
Function <code class="computeroutput"><span class="identifier">unforce_to_abort</span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">void</span> <span class="identifier">unforce_to_abort</span><span class="special">();</span>
@@ -856,7 +905,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.member_function__priority_"></a><a class="link" href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.member_function__priority_" title="Member Function priority">Member
+<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.member_function__priority_"></a><a href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.member_function__priority_" title="Member
+ Function priority">Member
Function <code class="computeroutput"><span class="identifier">priority</span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="identifier">std</span><span class="special">::</span><span class="identifier">size_t</span> <span class="keyword">const</span> <span class="special">&</span><span class="identifier">priority</span><span class="special">()</span> <span class="keyword">const</span><span class="special">;</span>
@@ -864,7 +914,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.member_function__set_priority_"></a><a class="link" href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.member_function__set_priority_" title="Member Function set_priority">Member
+<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.member_function__set_priority_"></a><a href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.member_function__set_priority_" title="Member
+ Function set_priority">Member
Function <code class="computeroutput"><span class="identifier">set_priority</span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">void</span> <span class="identifier">set_priority</span><span class="special">(</span><span class="identifier">std</span><span class="special">::</span><span class="identifier">size_t</span> <span class="keyword">const</span> <span class="special">&</span><span class="identifier">rhs</span><span class="special">)</span> <span class="keyword">const</span><span class="special">;</span>
@@ -872,7 +923,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.member_function__raise_priority_"></a><a class="link" href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.member_function__raise_priority_" title="Member Function raise_priority">Member
+<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.member_function__raise_priority_"></a><a href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.member_function__raise_priority_" title="Member
+ Function raise_priority">Member
Function <code class="computeroutput"><span class="identifier">raise_priority</span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">void</span> <span class="identifier">raise_priority</span><span class="special">();</span>
@@ -880,7 +932,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.member_function__make_irrevocable_"></a><a class="link" href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.member_function__make_irrevocable_" title="Member Function make_irrevocable">Member
+<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.member_function__make_irrevocable_"></a><a href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.member_function__make_irrevocable_" title="Member
+ Function make_irrevocable">Member
Function <code class="computeroutput"><span class="identifier">make_irrevocable</span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">void</span> <span class="identifier">make_irrevocable</span><span class="special">();</span>
@@ -888,7 +941,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.member_function__make_isolated_"></a><a class="link" href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.member_function__make_isolated_" title="Member Function make_isolated">Member
+<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.member_function__make_isolated_"></a><a href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.member_function__make_isolated_" title="Member
+ Function make_isolated">Member
Function <code class="computeroutput"><span class="identifier">make_isolated</span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">void</span> <span class="identifier">make_isolated</span><span class="special">();</span>
@@ -896,7 +950,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.member_function__irrevocable_"></a><a class="link" href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.member_function__irrevocable_" title="Member Function irrevocable">Member
+<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.member_function__irrevocable_"></a><a href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.member_function__irrevocable_" title="Member
+ Function irrevocable">Member
Function <code class="computeroutput"><span class="identifier">irrevocable</span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">bool</span> <span class="identifier">irrevocable</span><span class="special">()</span> <span class="keyword">const</span><span class="special">;</span>
@@ -904,7 +959,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.member_function__isolated_"></a><a class="link" href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.member_function__isolated_" title="Member Function isolated">Member
+<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.member_function__isolated_"></a><a href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.member_function__isolated_" title="Member
+ Function isolated">Member
Function <code class="computeroutput"><span class="identifier">isolated</span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">bool</span> <span class="identifier">isolated</span><span class="special">()</span> <span class="keyword">const</span><span class="special">;</span>
@@ -912,7 +968,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.member_function__thread_id_"></a><a class="link" href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.member_function__thread_id_" title="Member Function thread_id">Member
+<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.member_function__thread_id_"></a><a href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.member_function__thread_id_" title="Member
+ Function thread_id">Member
Function <code class="computeroutput"><span class="identifier">thread_id</span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="identifier">thread_id_t</span> <span class="keyword">const</span> <span class="special">&</span> <span class="identifier">thread_id</span><span class="special">()</span> <span class="keyword">const</span><span class="special">;</span>
@@ -920,7 +977,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.template_member_function__find_original___"></a><a class="link" href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.template_member_function__find_original___" title="Template Member Function find_original<>">Template
+<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.template_member_function__find_original___"></a><a href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.template_member_function__find_original___" title="Template
+ Member Function find_original<>">Template
Member Function <code class="computeroutput"><span class="identifier">find_original</span><span class="special"><></span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">template</span> <span class="special"><</span><span class="keyword">typename</span> <span class="identifier">T</span><span class="special">></span> <span class="identifier">T</span><span class="special">&</span> <span class="identifier">find_original</span><span class="special">(</span><span class="identifier">T</span><span class="special">&</span> <span class="identifier">in</span><span class="special">);</span>
@@ -940,7 +998,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.template__function__read___"></a><a class="link" href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.template__function__read___" title="Template Function read<>">Template
+<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.template__function__read___"></a><a href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.template__function__read___" title="Template
+ Function read<>">Template
Function <code class="computeroutput"><span class="identifier">read</span><span class="special"><></span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">template</span> <span class="special"><</span><span class="keyword">typename</span> <span class="identifier">T</span><span class="special">></span> <span class="identifier">T</span> <span class="keyword">const</span> <span class="special">&</span> <span class="identifier">read</span><span class="special">(</span><span class="identifier">T</span> <span class="keyword">const</span> <span class="special">&</span> <span class="identifier">in</span><span class="special">);</span>
@@ -957,7 +1016,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.template__function__read_ptr___"></a><a class="link" href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.template__function__read_ptr___" title="Template Function read_ptr<>">Template
+<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.template__function__read_ptr___"></a><a href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.template__function__read_ptr___" title="Template
+ Function read_ptr<>">Template
Function <code class="computeroutput"><span class="identifier">read_ptr</span><span class="special"><></span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">template</span> <span class="special"><</span><span class="keyword">typename</span> <span class="identifier">T</span><span class="special">></span> <span class="identifier">T</span> <span class="keyword">const</span> <span class="special">*</span> <span class="identifier">read_ptr</span><span class="special">(</span><span class="identifier">T</span> <span class="keyword">const</span> <span class="special">*</span> <span class="identifier">in</span><span class="special">);</span>
@@ -969,7 +1029,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.template__function__write___"></a><a class="link" href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.template__function__write___" title="Template Function write<>">Template
+<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.template__function__write___"></a><a href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.template__function__write___" title="Template
+ Function write<>">Template
Function <code class="computeroutput"><span class="identifier">write</span><span class="special"><></span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">template</span> <span class="special"><</span><span class="keyword">typename</span> <span class="identifier">T</span><span class="special">></span> <span class="identifier">T</span><span class="special">&</span> <span class="identifier">write</span><span class="special">(</span><span class="identifier">T</span><span class="special">&</span> <span class="identifier">in</span><span class="special">);</span>
@@ -986,7 +1047,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.template__function__write_ptr___"></a><a class="link" href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.template__function__write_ptr___" title="Template Function write_ptr<>">Template
+<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.template__function__write_ptr___"></a><a href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.template__function__write_ptr___" title="Template
+ Function write_ptr<>">Template
Function <code class="computeroutput"><span class="identifier">write_ptr</span><span class="special"><></span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">template</span> <span class="special"><</span><span class="keyword">typename</span> <span class="identifier">T</span><span class="special">></span> <span class="identifier">T</span><span class="special">*</span> <span class="identifier">write_ptr</span><span class="special">(</span><span class="identifier">T</span><span class="special">*</span> <span class="identifier">in</span><span class="special">);</span>
@@ -998,7 +1060,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.template__function__get_written___"></a><a class="link" href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.template__function__get_written___" title="Template Function get_written<>">Template
+<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.template__function__get_written___"></a><a href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.template__function__get_written___" title="Template
+ Function get_written<>">Template
Function <code class="computeroutput"><span class="identifier">get_written</span><span class="special"><></span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">template</span> <span class="special"><</span><span class="keyword">typename</span> <span class="identifier">T</span><span class="special">></span> <span class="identifier">T</span><span class="special">*</span> <span class="identifier">get_written</span><span class="special">(</span><span class="identifier">T</span> <span class="keyword">const</span> <span class="special">&</span> <span class="identifier">in</span><span class="special">);</span>
@@ -1006,7 +1069,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.template__function__delete_memory___"></a><a class="link" href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.template__function__delete_memory___" title="Template Function delete_memory<>">Template
+<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.template__function__delete_memory___"></a><a href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.template__function__delete_memory___" title="Template
+ Function delete_memory<>">Template
Function <code class="computeroutput"><span class="identifier">delete_memory</span><span class="special"><></span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">template</span> <span class="special"><</span><span class="keyword">typename</span> <span class="identifier">T</span><span class="special">></span> <span class="keyword">void</span> <span class="identifier">delete_memory</span><span class="special">(</span><span class="identifier">T</span> <span class="special">&</span><span class="identifier">in</span><span class="special">)</span>
@@ -1018,7 +1082,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.template__function__new_memory___"></a><a class="link" href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.template__function__new_memory___" title="Template Function new_memory<>">Template
+<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.template__function__new_memory___"></a><a href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.template__function__new_memory___" title="Template
+ Function new_memory<>">Template
Function <code class="computeroutput"><span class="identifier">new_memory</span><span class="special"><></span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">template</span> <span class="special"><</span><span class="keyword">typename</span> <span class="identifier">T</span><span class="special">></span> <span class="identifier">T</span><span class="special">*</span> <span class="identifier">new_memory</span><span class="special">();</span>
@@ -1039,7 +1104,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.template__function__new_memory_copy___"></a><a class="link" href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.template__function__new_memory_copy___" title="Template Function new_memory_copy<>">Template
+<a name="toward_boost_stm.reference.transaction_hpp.class__transaction_.template__function__new_memory_copy___"></a><a href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.class__transaction_.template__function__new_memory_copy___" title="Template
+ Function new_memory_copy<>">Template
Function <code class="computeroutput"><span class="identifier">new_memory_copy</span><span class="special"><></span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">template</span> <span class="special"><</span><span class="keyword">typename</span> <span class="identifier">T</span><span class="special">></span> <span class="identifier">T</span><span class="special">*</span> <span class="identifier">new_memory_copy</span><span class="special">(</span><span class="identifier">T</span> <span class="keyword">const</span> <span class="special">&</span><span class="identifier">rhs</span><span class="special">);</span>
@@ -1053,7 +1119,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="toward_boost_stm.reference.transaction_hpp.struct__thread_initializer_"></a><a class="link" href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.struct__thread_initializer_" title="Struct thread_initializer">Struct
+<a name="toward_boost_stm.reference.transaction_hpp.struct__thread_initializer_"></a><a href="transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.struct__thread_initializer_" title="Struct
+ thread_initializer">Struct
<code class="computeroutput"><span class="identifier">thread_initializer</span></code></a>
</h4></div></div></div>
<p>
Modified: sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/transaction_object_hpp.html
==============================================================================
--- sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/transaction_object_hpp.html (original)
+++ sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/transaction_object_hpp.html 2009-10-08 15:42:54 EDT (Thu, 08 Oct 2009)
@@ -1,13 +1,16 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
-<title>Header <boost/stm/transaction_object.hpp></title>
+<title> Header
+ <boost/stm/transaction_object.hpp></title>
<link rel="stylesheet" href="../../../../../../doc/html/boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
+<meta name="generator" content="DocBook XSL Stylesheets V1.69.1">
<link rel="start" href="../../index.html" title="Chapter 1. Toward.Boost.STM">
<link rel="up" href="../reference.html" title="Reference">
-<link rel="prev" href="transaction_hpp.html" title="Header <boost/stm/transaction.hpp>">
-<link rel="next" href="transactional_object_hpp.html" title="Header <boost/stm/transactional_object.hpp>">
+<link rel="prev" href="transaction_hpp.html" title=" Header
+ <boost/stm/transaction.hpp>">
+<link rel="next" href="transactional_object_hpp.html" title="
+ Header <boost/stm/transactional_object.hpp>">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table cellpadding="2" width="100%"><tr>
@@ -24,7 +27,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h3 class="title">
-<a name="toward_boost_stm.reference.transaction_object_hpp"></a><a class="link" href="transaction_object_hpp.html" title="Header <boost/stm/transaction_object.hpp>"> Header
+<a name="toward_boost_stm.reference.transaction_object_hpp"></a><a href="transaction_object_hpp.html" title=" Header
+ <boost/stm/transaction_object.hpp>"> Header
<code class="computeroutput"><span class="special"><</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">stm</span><span class="special">/</span><span class="identifier">transaction_object</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">></span></code></a>
</h3></div></div></div>
<div class="toc"><dl>
@@ -50,7 +54,8 @@
</pre>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="toward_boost_stm.reference.transaction_object_hpp.template_class__transaction_object___"></a><a class="link" href="transaction_object_hpp.html#toward_boost_stm.reference.transaction_object_hpp.template_class__transaction_object___" title="Template Class transaction_object<>">Template
+<a name="toward_boost_stm.reference.transaction_object_hpp.template_class__transaction_object___"></a><a href="transaction_object_hpp.html#toward_boost_stm.reference.transaction_object_hpp.template_class__transaction_object___" title="Template
+ Class transaction_object<>">Template
Class <code class="computeroutput"><span class="identifier">transaction_object</span><span class="special"><></span></code></a>
</h4></div></div></div>
<div class="toc"><dl>
@@ -89,7 +94,8 @@
</pre>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_object_hpp.template_class__transaction_object___.virtual_function__clone___"></a><a class="link" href="transaction_object_hpp.html#toward_boost_stm.reference.transaction_object_hpp.template_class__transaction_object___.virtual_function__clone___" title="Virtual function clone()">Virtual
+<a name="toward_boost_stm.reference.transaction_object_hpp.template_class__transaction_object___.virtual_function__clone___"></a><a href="transaction_object_hpp.html#toward_boost_stm.reference.transaction_object_hpp.template_class__transaction_object___.virtual_function__clone___" title="Virtual
+ function clone()">Virtual
function <code class="computeroutput"><span class="identifier">clone</span><span class="special">()</span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">virtual</span> <span class="identifier">base_transaction_object</span><span class="special">*</span> <span class="identifier">clone</span><span class="special">()</span> <span class="keyword">const</span><span class="special">;</span>
@@ -101,7 +107,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_object_hpp.template_class__transaction_object___.virtual_function__copy_state___"></a><a class="link" href="transaction_object_hpp.html#toward_boost_stm.reference.transaction_object_hpp.template_class__transaction_object___.virtual_function__copy_state___" title="Virtual function copy_state()">Virtual
+<a name="toward_boost_stm.reference.transaction_object_hpp.template_class__transaction_object___.virtual_function__copy_state___"></a><a href="transaction_object_hpp.html#toward_boost_stm.reference.transaction_object_hpp.template_class__transaction_object___.virtual_function__copy_state___" title="Virtual
+ function copy_state()">Virtual
function <code class="computeroutput"><span class="identifier">copy_state</span><span class="special">()</span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">virtual</span> <span class="keyword">void</span> <span class="identifier">copy_state</span><span class="special">(</span><span class="identifier">base_transaction_object</span> <span class="keyword">const</span> <span class="special">*</span> <span class="keyword">const</span> <span class="identifier">rhs</span><span class="special">);</span>
@@ -113,7 +120,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_object_hpp.template_class__transaction_object___.virtual_function__move_state___"></a><a class="link" href="transaction_object_hpp.html#toward_boost_stm.reference.transaction_object_hpp.template_class__transaction_object___.virtual_function__move_state___" title="Virtual function move_state()">Virtual
+<a name="toward_boost_stm.reference.transaction_object_hpp.template_class__transaction_object___.virtual_function__move_state___"></a><a href="transaction_object_hpp.html#toward_boost_stm.reference.transaction_object_hpp.template_class__transaction_object___.virtual_function__move_state___" title="Virtual
+ function move_state()">Virtual
function <code class="computeroutput"><span class="identifier">move_state</span><span class="special">()</span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">virtual</span> <span class="keyword">void</span> <span class="identifier">move_state</span><span class="special">(</span><span class="identifier">base_transaction_object</span> <span class="special">*</span> <span class="identifier">rhs</span><span class="special">);</span>
@@ -125,7 +133,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_object_hpp.template_class__transaction_object___.virtual_function__cache_deallocate___"></a><a class="link" href="transaction_object_hpp.html#toward_boost_stm.reference.transaction_object_hpp.template_class__transaction_object___.virtual_function__cache_deallocate___" title="Virtual function cache_deallocate()">Virtual
+<a name="toward_boost_stm.reference.transaction_object_hpp.template_class__transaction_object___.virtual_function__cache_deallocate___"></a><a href="transaction_object_hpp.html#toward_boost_stm.reference.transaction_object_hpp.template_class__transaction_object___.virtual_function__cache_deallocate___" title="Virtual
+ function cache_deallocate()">Virtual
function <code class="computeroutput"><span class="identifier">cache_deallocate</span><span class="special">()</span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">virtual</span> <span class="keyword">void</span> <span class="identifier">cache_deallocate</span><span class="special">();</span>
@@ -138,7 +147,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="toward_boost_stm.reference.transaction_object_hpp.template_class__native_trans___"></a><a class="link" href="transaction_object_hpp.html#toward_boost_stm.reference.transaction_object_hpp.template_class__native_trans___" title="Template Class native_trans<>">Template
+<a name="toward_boost_stm.reference.transaction_object_hpp.template_class__native_trans___"></a><a href="transaction_object_hpp.html#toward_boost_stm.reference.transaction_object_hpp.template_class__native_trans___" title="Template
+ Class native_trans<>">Template
Class <code class="computeroutput"><span class="identifier">native_trans</span><span class="special"><></span></code></a>
</h4></div></div></div>
<pre class="programlisting"><span class="keyword">template</span> <span class="special"><</span><span class="keyword">typename</span> <span class="identifier">T</span><span class="special">></span> <span class="keyword">class</span> <span class="identifier">native_trans</span> <span class="special">:</span> <span class="keyword">public</span> <span class="identifier">transaction_object</span><span class="special"><</span> <span class="identifier">native_trans</span><span class="special"><</span><span class="identifier">T</span><span class="special">></span> <span class="special">></span> <span class="special">{</span>
Modified: sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/transactional_object_hpp.html
==============================================================================
--- sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/transactional_object_hpp.html (original)
+++ sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/transactional_object_hpp.html 2009-10-08 15:42:54 EDT (Thu, 08 Oct 2009)
@@ -1,13 +1,15 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
-<title>Header <boost/stm/transactional_object.hpp></title>
+<title>
+ Header <boost/stm/transactional_object.hpp></title>
<link rel="stylesheet" href="../../../../../../doc/html/boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
+<meta name="generator" content="DocBook XSL Stylesheets V1.69.1">
<link rel="start" href="../../index.html" title="Chapter 1. Toward.Boost.STM">
<link rel="up" href="../reference.html" title="Reference">
-<link rel="prev" href="transaction_object_hpp.html" title="Header <boost/stm/transaction_object.hpp>">
-<link rel="next" href="tx_ptr_hpp.html" title="Header <boost/stm/tx_ptr.hpp>">
+<link rel="prev" href="transaction_object_hpp.html" title=" Header
+ <boost/stm/transaction_object.hpp>">
+<link rel="next" href="tx_ptr_hpp.html" title=" Header <boost/stm/tx_ptr.hpp>">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table cellpadding="2" width="100%"><tr>
@@ -24,7 +26,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h3 class="title">
-<a name="toward_boost_stm.reference.transactional_object_hpp"></a><a class="link" href="transactional_object_hpp.html" title="Header <boost/stm/transactional_object.hpp>">
+<a name="toward_boost_stm.reference.transactional_object_hpp"></a><a href="transactional_object_hpp.html" title="
+ Header <boost/stm/transactional_object.hpp>">
Header <code class="computeroutput"><span class="special"><</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">stm</span><span class="special">/</span><span class="identifier">transactional_object</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">></span></code></a>
</h3></div></div></div>
<div class="toc"><dl>
@@ -54,7 +57,8 @@
</pre>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="toward_boost_stm.reference.transactional_object_hpp.template_class__transactional_object___"></a><a class="link" href="transactional_object_hpp.html#toward_boost_stm.reference.transactional_object_hpp.template_class__transactional_object___" title="Template Class transactional_object<>">Template
+<a name="toward_boost_stm.reference.transactional_object_hpp.template_class__transactional_object___"></a><a href="transactional_object_hpp.html#toward_boost_stm.reference.transactional_object_hpp.template_class__transactional_object___" title="Template
+ Class transactional_object<>">Template
Class <code class="computeroutput"><span class="identifier">transactional_object</span><span class="special"><></span></code></a>
</h4></div></div></div>
<div class="toc"><dl>
@@ -137,7 +141,8 @@
</pre>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transactional_object_hpp.template_class__transactional_object___.virtual_function__copy_state___"></a><a class="link" href="transactional_object_hpp.html#toward_boost_stm.reference.transactional_object_hpp.template_class__transactional_object___.virtual_function__copy_state___" title="Virtual function copy_state()">Virtual
+<a name="toward_boost_stm.reference.transactional_object_hpp.template_class__transactional_object___.virtual_function__copy_state___"></a><a href="transactional_object_hpp.html#toward_boost_stm.reference.transactional_object_hpp.template_class__transactional_object___.virtual_function__copy_state___" title="Virtual
+ function copy_state()">Virtual
function <code class="computeroutput"><span class="identifier">copy_state</span><span class="special">()</span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">virtual</span> <span class="keyword">void</span> <span class="identifier">copy_state</span><span class="special">(</span><span class="identifier">base_transaction_object</span> <span class="keyword">const</span> <span class="special">*</span> <span class="keyword">const</span> <span class="identifier">rhs</span><span class="special">);</span>
@@ -145,7 +150,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transactional_object_hpp.template_class__transactional_object___.virtual_function__move_state___"></a><a class="link" href="transactional_object_hpp.html#toward_boost_stm.reference.transactional_object_hpp.template_class__transactional_object___.virtual_function__move_state___" title="Virtual function move_state()">Virtual
+<a name="toward_boost_stm.reference.transactional_object_hpp.template_class__transactional_object___.virtual_function__move_state___"></a><a href="transactional_object_hpp.html#toward_boost_stm.reference.transactional_object_hpp.template_class__transactional_object___.virtual_function__move_state___" title="Virtual
+ function move_state()">Virtual
function <code class="computeroutput"><span class="identifier">move_state</span><span class="special">()</span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">virtual</span> <span class="keyword">void</span> <span class="identifier">move_state</span><span class="special">(</span><span class="identifier">base_transaction_object</span> <span class="special">*</span> <span class="identifier">rhs</span><span class="special">);</span>
@@ -153,7 +159,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transactional_object_hpp.template_class__transactional_object___.virtual_function__cache_deallocate___"></a><a class="link" href="transactional_object_hpp.html#toward_boost_stm.reference.transactional_object_hpp.template_class__transactional_object___.virtual_function__cache_deallocate___" title="Virtual function cache_deallocate()">Virtual
+<a name="toward_boost_stm.reference.transactional_object_hpp.template_class__transactional_object___.virtual_function__cache_deallocate___"></a><a href="transactional_object_hpp.html#toward_boost_stm.reference.transactional_object_hpp.template_class__transactional_object___.virtual_function__cache_deallocate___" title="Virtual
+ function cache_deallocate()">Virtual
function <code class="computeroutput"><span class="identifier">cache_deallocate</span><span class="special">()</span></code></a>
</h5></div></div></div>
<pre class="programlisting"><span class="keyword">virtual</span> <span class="keyword">void</span> <span class="identifier">cache_deallocate</span><span class="special">()=</span><span class="number">0</span><span class="special">;</span>
Modified: sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/tx_ptr_hpp.html
==============================================================================
--- sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/tx_ptr_hpp.html (original)
+++ sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/tx_ptr_hpp.html 2009-10-08 15:42:54 EDT (Thu, 08 Oct 2009)
@@ -1,13 +1,15 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
-<title>Header <boost/stm/tx_ptr.hpp></title>
+<title> Header <boost/stm/tx_ptr.hpp></title>
<link rel="stylesheet" href="../../../../../../doc/html/boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
+<meta name="generator" content="DocBook XSL Stylesheets V1.69.1">
<link rel="start" href="../../index.html" title="Chapter 1. Toward.Boost.STM">
<link rel="up" href="../reference.html" title="Reference">
-<link rel="prev" href="transactional_object_hpp.html" title="Header <boost/stm/transactional_object.hpp>">
-<link rel="next" href="tx_smart_ptr_hpp.html" title="Header <boost/stm/tx_smart_ptr.hpp>">
+<link rel="prev" href="transactional_object_hpp.html" title="
+ Header <boost/stm/transactional_object.hpp>">
+<link rel="next" href="tx_smart_ptr_hpp.html" title=" Header
+ <boost/stm/tx_smart_ptr.hpp>">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table cellpadding="2" width="100%"><tr>
@@ -24,7 +26,7 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h3 class="title">
-<a name="toward_boost_stm.reference.tx_ptr_hpp"></a><a class="link" href="tx_ptr_hpp.html" title="Header <boost/stm/tx_ptr.hpp>"> Header <code class="computeroutput"><span class="special"><</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">stm</span><span class="special">/</span><span class="identifier">tx_ptr</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">></span></code></a>
+<a name="toward_boost_stm.reference.tx_ptr_hpp"></a> Header <boost/stm/tx_ptr.hpp>
</h3></div></div></div>
<div class="toc"><dl>
<dt><span class="section"><a href="tx_ptr_hpp.html#toward_boost_stm.reference.tx_ptr_hpp.template_class__read_ptr___">Template
@@ -39,7 +41,8 @@
</pre>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="toward_boost_stm.reference.tx_ptr_hpp.template_class__read_ptr___"></a><a class="link" href="tx_ptr_hpp.html#toward_boost_stm.reference.tx_ptr_hpp.template_class__read_ptr___" title="Template Class read_ptr<>">Template
+<a name="toward_boost_stm.reference.tx_ptr_hpp.template_class__read_ptr___"></a><a href="tx_ptr_hpp.html#toward_boost_stm.reference.tx_ptr_hpp.template_class__read_ptr___" title="Template
+ Class read_ptr<>">Template
Class <code class="computeroutput"><span class="identifier">read_ptr</span><span class="special"><></span></code></a>
</h4></div></div></div>
<pre class="programlisting"><span class="keyword">template</span> <span class="special"><</span><span class="keyword">typename</span> <span class="identifier">T</span><span class="special">></span> <span class="keyword">class</span> <span class="identifier">read_ptr</span> <span class="special">{</span>
@@ -56,7 +59,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="toward_boost_stm.reference.tx_ptr_hpp.template_class__write_ptr___"></a><a class="link" href="tx_ptr_hpp.html#toward_boost_stm.reference.tx_ptr_hpp.template_class__write_ptr___" title="Template Class write_ptr<>">Template
+<a name="toward_boost_stm.reference.tx_ptr_hpp.template_class__write_ptr___"></a><a href="tx_ptr_hpp.html#toward_boost_stm.reference.tx_ptr_hpp.template_class__write_ptr___" title="Template
+ Class write_ptr<>">Template
Class <code class="computeroutput"><span class="identifier">write_ptr</span><span class="special"><></span></code></a>
</h4></div></div></div>
<pre class="programlisting"><span class="keyword">template</span> <span class="special"><</span><span class="keyword">typename</span> <span class="identifier">T</span><span class="special">></span> <span class="keyword">class</span> <span class="identifier">write_ptr</span> <span class="special">{</span>
Modified: sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/tx_smart_ptr_hpp.html
==============================================================================
--- sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/tx_smart_ptr_hpp.html (original)
+++ sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/tx_smart_ptr_hpp.html 2009-10-08 15:42:54 EDT (Thu, 08 Oct 2009)
@@ -1,13 +1,15 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
-<title>Header <boost/stm/tx_smart_ptr.hpp></title>
+<title> Header
+ <boost/stm/tx_smart_ptr.hpp></title>
<link rel="stylesheet" href="../../../../../../doc/html/boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
+<meta name="generator" content="DocBook XSL Stylesheets V1.69.1">
<link rel="start" href="../../index.html" title="Chapter 1. Toward.Boost.STM">
<link rel="up" href="../reference.html" title="Reference">
-<link rel="prev" href="tx_ptr_hpp.html" title="Header <boost/stm/tx_ptr.hpp>">
-<link rel="next" href="non_tx_smart_ptr_hpp.html" title="Header <boost/stm/non_tx_smart_ptr.hpp>">
+<link rel="prev" href="tx_ptr_hpp.html" title=" Header <boost/stm/tx_ptr.hpp>">
+<link rel="next" href="non_tx_smart_ptr_hpp.html" title=" Header
+ <boost/stm/non_tx_smart_ptr.hpp>">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table cellpadding="2" width="100%"><tr>
@@ -24,7 +26,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h3 class="title">
-<a name="toward_boost_stm.reference.tx_smart_ptr_hpp"></a><a class="link" href="tx_smart_ptr_hpp.html" title="Header <boost/stm/tx_smart_ptr.hpp>"> Header
+<a name="toward_boost_stm.reference.tx_smart_ptr_hpp"></a><a href="tx_smart_ptr_hpp.html" title=" Header
+ <boost/stm/tx_smart_ptr.hpp>"> Header
<code class="computeroutput"><span class="special"><</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">stm</span><span class="special">/</span><span class="identifier">tx_smart_ptr</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">></span></code></a>
</h3></div></div></div>
<div class="toc"><dl>
@@ -105,7 +108,8 @@
</pre>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="toward_boost_stm.reference.tx_smart_ptr_hpp.template_class__tx_obj___"></a><a class="link" href="tx_smart_ptr_hpp.html#toward_boost_stm.reference.tx_smart_ptr_hpp.template_class__tx_obj___" title="Template Class tx_obj<>">Template
+<a name="toward_boost_stm.reference.tx_smart_ptr_hpp.template_class__tx_obj___"></a><a href="tx_smart_ptr_hpp.html#toward_boost_stm.reference.tx_smart_ptr_hpp.template_class__tx_obj___" title="Template
+ Class tx_obj<>">Template
Class <code class="computeroutput"><span class="identifier">tx_obj</span><span class="special"><></span></code></a>
</h4></div></div></div>
<p>
@@ -141,7 +145,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="toward_boost_stm.reference.tx_smart_ptr_hpp.template_class__tx_ptr___"></a><a class="link" href="tx_smart_ptr_hpp.html#toward_boost_stm.reference.tx_smart_ptr_hpp.template_class__tx_ptr___" title="Template Class tx_ptr<>">Template
+<a name="toward_boost_stm.reference.tx_smart_ptr_hpp.template_class__tx_ptr___"></a><a href="tx_smart_ptr_hpp.html#toward_boost_stm.reference.tx_smart_ptr_hpp.template_class__tx_ptr___" title="Template
+ Class tx_ptr<>">Template
Class <code class="computeroutput"><span class="identifier">tx_ptr</span><span class="special"><></span></code></a>
</h4></div></div></div>
<p>
@@ -186,7 +191,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="toward_boost_stm.reference.tx_smart_ptr_hpp.template_class__rd_ptr___"></a><a class="link" href="tx_smart_ptr_hpp.html#toward_boost_stm.reference.tx_smart_ptr_hpp.template_class__rd_ptr___" title="Template Class rd_ptr<>">Template
+<a name="toward_boost_stm.reference.tx_smart_ptr_hpp.template_class__rd_ptr___"></a><a href="tx_smart_ptr_hpp.html#toward_boost_stm.reference.tx_smart_ptr_hpp.template_class__rd_ptr___" title="Template
+ Class rd_ptr<>">Template
Class <code class="computeroutput"><span class="identifier">rd_ptr</span><span class="special"><></span></code></a>
</h4></div></div></div>
<p>
@@ -228,7 +234,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="toward_boost_stm.reference.tx_smart_ptr_hpp.template_class__upgrd_ptr___"></a><a class="link" href="tx_smart_ptr_hpp.html#toward_boost_stm.reference.tx_smart_ptr_hpp.template_class__upgrd_ptr___" title="Template Class upgrd_ptr<>">Template
+<a name="toward_boost_stm.reference.tx_smart_ptr_hpp.template_class__upgrd_ptr___"></a><a href="tx_smart_ptr_hpp.html#toward_boost_stm.reference.tx_smart_ptr_hpp.template_class__upgrd_ptr___" title="Template
+ Class upgrd_ptr<>">Template
Class <code class="computeroutput"><span class="identifier">upgrd_ptr</span><span class="special"><></span></code></a>
</h4></div></div></div>
<p>
@@ -275,7 +282,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="toward_boost_stm.reference.tx_smart_ptr_hpp.template_class__wr_ptr___"></a><a class="link" href="tx_smart_ptr_hpp.html#toward_boost_stm.reference.tx_smart_ptr_hpp.template_class__wr_ptr___" title="Template Class wr_ptr<>">Template
+<a name="toward_boost_stm.reference.tx_smart_ptr_hpp.template_class__wr_ptr___"></a><a href="tx_smart_ptr_hpp.html#toward_boost_stm.reference.tx_smart_ptr_hpp.template_class__wr_ptr___" title="Template
+ Class wr_ptr<>">Template
Class <code class="computeroutput"><span class="identifier">wr_ptr</span><span class="special"><></span></code></a>
</h4></div></div></div>
<p>
Modified: sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/users_guide.html
==============================================================================
--- sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/users_guide.html (original)
+++ sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/users_guide.html 2009-10-08 15:42:54 EDT (Thu, 08 Oct 2009)
@@ -1,13 +1,14 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
-<title>Users'Guide</title>
+<title> Users'Guide</title>
<link rel="stylesheet" href="../../../../../doc/html/boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
+<meta name="generator" content="DocBook XSL Stylesheets V1.69.1">
<link rel="start" href="../index.html" title="Chapter 1. Toward.Boost.STM">
<link rel="up" href="../index.html" title="Chapter 1. Toward.Boost.STM">
-<link rel="prev" href="overview/intro.html" title="Introduction">
-<link rel="next" href="users_guide/getting_started.html" title="Getting Started">
+<link rel="prev" href="overview/intro.html" title=" Introduction">
+<link rel="next" href="users_guide/getting_started.html" title=" Getting
+ Started">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table cellpadding="2" width="100%"><tr>
@@ -24,7 +25,7 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
-<a name="toward_boost_stm.users_guide"></a><a class="link" href="users_guide.html" title="Users'Guide"> Users'Guide</a>
+<a name="toward_boost_stm.users_guide"></a> Users'Guide
</h2></div></div></div>
<div class="toc"><dl>
<dt><span class="section"><a href="users_guide/getting_started.html"> Getting
@@ -45,8 +46,8 @@
Dynamically Prioritized, Composed Transaction</a></span></dt>
<dt><span class="section"><a href="users_guide/tutorial.html#toward_boost_stm.users_guide.tutorial.can_a_transactional_object_embeed_another_transactional_object_">Can
a transactional object embeed another transactional object?</a></span></dt>
-<dt><span class="section"><a href="users_guide/tutorial.html#toward_boost_stm.users_guide.tutorial.returning_values_from_a_fucntion">Returning
- values from a fucntion</a></span></dt>
+<dt><span class="section"><a href="users_guide/tutorial.html#toward_boost_stm.users_guide.tutorial.returning_values_from_a_function">Returning
+ values from a function</a></span></dt>
<dt><span class="section"><a href="users_guide/tutorial.html#toward_boost_stm.users_guide.tutorial.pointer_to_transactional_objects">Pointer
to transactional objects</a></span></dt>
<dt><span class="section">Polymorphic</span></dt>
Modified: sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/users_guide/ext_references.html
==============================================================================
--- sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/users_guide/ext_references.html (original)
+++ sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/users_guide/ext_references.html 2009-10-08 15:42:54 EDT (Thu, 08 Oct 2009)
@@ -1,13 +1,13 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
-<title>References</title>
+<title> References</title>
<link rel="stylesheet" href="../../../../../../doc/html/boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
+<meta name="generator" content="DocBook XSL Stylesheets V1.69.1">
<link rel="start" href="../../index.html" title="Chapter 1. Toward.Boost.STM">
-<link rel="up" href="../users_guide.html" title="Users'Guide">
-<link rel="prev" href="tutorial.html" title="Tutorial">
-<link rel="next" href="glosary.html" title="Glossary">
+<link rel="up" href="../users_guide.html" title=" Users'Guide">
+<link rel="prev" href="tutorial.html" title=" Tutorial">
+<link rel="next" href="glosary.html" title=" Glossary">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table cellpadding="2" width="100%"><tr>
@@ -24,7 +24,7 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h3 class="title">
-<a name="toward_boost_stm.users_guide.ext_references"></a><a class="link" href="ext_references.html" title="References"> References</a>
+<a name="toward_boost_stm.users_guide.ext_references"></a> References
</h3></div></div></div>
<p>
For an introduction to TM, please refer to
Modified: sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/users_guide/getting_started.html
==============================================================================
--- sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/users_guide/getting_started.html (original)
+++ sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/users_guide/getting_started.html 2009-10-08 15:42:54 EDT (Thu, 08 Oct 2009)
@@ -1,13 +1,14 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
-<title>Getting Started</title>
+<title> Getting
+ Started</title>
<link rel="stylesheet" href="../../../../../../doc/html/boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
+<meta name="generator" content="DocBook XSL Stylesheets V1.69.1">
<link rel="start" href="../../index.html" title="Chapter 1. Toward.Boost.STM">
-<link rel="up" href="../users_guide.html" title="Users'Guide">
-<link rel="prev" href="../users_guide.html" title="Users'Guide">
-<link rel="next" href="tutorial.html" title="Tutorial">
+<link rel="up" href="../users_guide.html" title=" Users'Guide">
+<link rel="prev" href="../users_guide.html" title=" Users'Guide">
+<link rel="next" href="tutorial.html" title=" Tutorial">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table cellpadding="2" width="100%"><tr>
@@ -24,7 +25,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h3 class="title">
-<a name="toward_boost_stm.users_guide.getting_started"></a><a class="link" href="getting_started.html" title="Getting Started"> Getting
+<a name="toward_boost_stm.users_guide.getting_started"></a><a href="getting_started.html" title=" Getting
+ Started"> Getting
Started</a>
</h3></div></div></div>
<div class="toc"><dl>
@@ -35,7 +37,8 @@
</dl></div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="toward_boost_stm.users_guide.getting_started.install"></a><a class="link" href="getting_started.html#toward_boost_stm.users_guide.getting_started.install" title="Installing STM">
+<a name="toward_boost_stm.users_guide.getting_started.install"></a><a href="getting_started.html#toward_boost_stm.users_guide.getting_started.install" title="
+ Installing STM">
Installing STM</a>
</h4></div></div></div>
<p>
@@ -60,11 +63,11 @@
Thank you for considering TBoost.STM and we hope you enjoy exploring transactional
memory!
</p>
-<a name="toward_boost_stm.users_guide.getting_started.install.getting_boost_stm"></a><h6>
-<a name="id4860391"></a>
- <a class="link" href="getting_started.html#toward_boost_stm.users_guide.getting_started.install.getting_boost_stm">Getting
+<a name="toward_boost_stm.users_guide.getting_started.install.getting_boost_stm"></a><h5>
+<a name="id4814721"></a>
+ <a href="getting_started.html#toward_boost_stm.users_guide.getting_started.install.getting_boost_stm">Getting
Boost.STM</a>
- </h6>
+ </h5>
<p>
Visit our Toward Boost.Stm <a href="http://eces.colorado.edu/~gottschl/tboostSTM/index.html" target="_top">home
page</a> be aware of the last news.
@@ -77,11 +80,11 @@
You can also access the latest (unstable?) state from the <a href="https://svn.boost.org/svn/boost/sandbox/stm" target="_top">Boost
Sandbox</a>.
</p>
-<a name="toward_boost_stm.users_guide.getting_started.install.building_boost_stm"></a><h6>
-<a name="id4860444"></a>
- <a class="link" href="getting_started.html#toward_boost_stm.users_guide.getting_started.install.building_boost_stm">Building
+<a name="toward_boost_stm.users_guide.getting_started.install.building_boost_stm"></a><h5>
+<a name="id4814773"></a>
+ <a href="getting_started.html#toward_boost_stm.users_guide.getting_started.install.building_boost_stm">Building
Boost.STM</a>
- </h6>
+ </h5>
<p>
TBoost.STM is not a header only library. You need to compile it before
use.
@@ -89,10 +92,10 @@
<pre class="programlisting"><span class="identifier">cd</span> <span class="identifier">libs</span><span class="special">/</span><span class="identifier">stm</span><span class="special">/</span><span class="identifier">build</span>
<span class="identifier">bjam</span>
</pre>
-<a name="toward_boost_stm.users_guide.getting_started.install.requirements"></a><h6>
-<a name="id4860506"></a>
- <a class="link" href="getting_started.html#toward_boost_stm.users_guide.getting_started.install.requirements">Requirements</a>
- </h6>
+<a name="toward_boost_stm.users_guide.getting_started.install.requirements"></a><h5>
+<a name="id4814835"></a>
+ Requirements
+ </h5>
<p>
The POSIX threads (pthreads) library is needed to use TBoost.STM. Pthreads
is part of the standard deployment for almost all Unix / Linux flavors,
@@ -160,28 +163,28 @@
</p></dd>
</dl>
</div>
-<a name="toward_boost_stm.users_guide.getting_started.install.exceptions_safety"></a><h6>
-<a name="id4860771"></a>
- <a class="link" href="getting_started.html#toward_boost_stm.users_guide.getting_started.install.exceptions_safety">Exceptions
+<a name="toward_boost_stm.users_guide.getting_started.install.exceptions_safety"></a><h5>
+<a name="id4815100"></a>
+ <a href="getting_started.html#toward_boost_stm.users_guide.getting_started.install.exceptions_safety">Exceptions
safety</a>
- </h6>
+ </h5>
<p>
All functions in the library are exception-neutral and provide strong guarantee
of exception safety as long as the underlying parameters provide it.
</p>
-<a name="toward_boost_stm.users_guide.getting_started.install.thread_safety"></a><h6>
-<a name="id4860797"></a>
- <a class="link" href="getting_started.html#toward_boost_stm.users_guide.getting_started.install.thread_safety">Thread
+<a name="toward_boost_stm.users_guide.getting_started.install.thread_safety"></a><h5>
+<a name="id4815127"></a>
+ <a href="getting_started.html#toward_boost_stm.users_guide.getting_started.install.thread_safety">Thread
safety</a>
- </h6>
+ </h5>
<p>
All functions in the library are thread-unsafe except when noted explicitly.
</p>
-<a name="toward_boost_stm.users_guide.getting_started.install.tested_compilers"></a><h6>
-<a name="id4860822"></a>
- <a class="link" href="getting_started.html#toward_boost_stm.users_guide.getting_started.install.tested_compilers">Tested
+<a name="toward_boost_stm.users_guide.getting_started.install.tested_compilers"></a><h5>
+<a name="id4815152"></a>
+ <a href="getting_started.html#toward_boost_stm.users_guide.getting_started.install.tested_compilers">Tested
compilers</a>
- </h6>
+ </h5>
<p>
Currently, <span class="bold"><strong>Boost.STM</strong></span> has been tested in
the following compilers/platforms:
@@ -207,7 +210,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="toward_boost_stm.users_guide.getting_started.hello_world__"></a><a class="link" href="getting_started.html#toward_boost_stm.users_guide.getting_started.hello_world__" title="Hello World!">Hello
+<a name="toward_boost_stm.users_guide.getting_started.hello_world__"></a><a href="getting_started.html#toward_boost_stm.users_guide.getting_started.hello_world__" title="Hello
+ World! ">Hello
World! </a>
</h4></div></div></div>
<p>
Modified: sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/users_guide/glosary.html
==============================================================================
--- sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/users_guide/glosary.html (original)
+++ sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/users_guide/glosary.html 2009-10-08 15:42:54 EDT (Thu, 08 Oct 2009)
@@ -1,12 +1,12 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
-<title>Glossary</title>
+<title> Glossary</title>
<link rel="stylesheet" href="../../../../../../doc/html/boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
+<meta name="generator" content="DocBook XSL Stylesheets V1.69.1">
<link rel="start" href="../../index.html" title="Chapter 1. Toward.Boost.STM">
-<link rel="up" href="../users_guide.html" title="Users'Guide">
-<link rel="prev" href="ext_references.html" title="References">
+<link rel="up" href="../users_guide.html" title=" Users'Guide">
+<link rel="prev" href="ext_references.html" title=" References">
<link rel="next" href="../reference.html" title="Reference">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -24,7 +24,7 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h3 class="title">
-<a name="toward_boost_stm.users_guide.glosary"></a><a class="link" href="glosary.html" title="Glossary"> Glossary</a>
+<a name="toward_boost_stm.users_guide.glosary"></a> Glossary
</h3></div></div></div>
<div class="variablelist">
<p class="title"><b></b></p>
Modified: sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/users_guide/tutorial.html
==============================================================================
--- sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/users_guide/tutorial.html (original)
+++ sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/users_guide/tutorial.html 2009-10-08 15:42:54 EDT (Thu, 08 Oct 2009)
@@ -1,13 +1,14 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
-<title>Tutorial</title>
+<title> Tutorial</title>
<link rel="stylesheet" href="../../../../../../doc/html/boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
+<meta name="generator" content="DocBook XSL Stylesheets V1.69.1">
<link rel="start" href="../../index.html" title="Chapter 1. Toward.Boost.STM">
-<link rel="up" href="../users_guide.html" title="Users'Guide">
-<link rel="prev" href="getting_started.html" title="Getting Started">
-<link rel="next" href="ext_references.html" title="References">
+<link rel="up" href="../users_guide.html" title=" Users'Guide">
+<link rel="prev" href="getting_started.html" title=" Getting
+ Started">
+<link rel="next" href="ext_references.html" title=" References">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table cellpadding="2" width="100%"><tr>
@@ -24,7 +25,7 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h3 class="title">
-<a name="toward_boost_stm.users_guide.tutorial"></a><a class="link" href="tutorial.html" title="Tutorial"> Tutorial</a>
+<a name="toward_boost_stm.users_guide.tutorial"></a> Tutorial
</h3></div></div></div>
<div class="toc"><dl>
<dt><span class="section"><a href="tutorial.html#toward_boost_stm.users_guide.tutorial.a_simple_transaction">A
@@ -35,8 +36,8 @@
Dynamically Prioritized, Composed Transaction</a></span></dt>
<dt><span class="section"><a href="tutorial.html#toward_boost_stm.users_guide.tutorial.can_a_transactional_object_embeed_another_transactional_object_">Can
a transactional object embeed another transactional object?</a></span></dt>
-<dt><span class="section"><a href="tutorial.html#toward_boost_stm.users_guide.tutorial.returning_values_from_a_fucntion">Returning
- values from a fucntion</a></span></dt>
+<dt><span class="section"><a href="tutorial.html#toward_boost_stm.users_guide.tutorial.returning_values_from_a_function">Returning
+ values from a function</a></span></dt>
<dt><span class="section"><a href="tutorial.html#toward_boost_stm.users_guide.tutorial.pointer_to_transactional_objects">Pointer
to transactional objects</a></span></dt>
<dt><span class="section">Polymorphic</span></dt>
@@ -68,7 +69,8 @@
</p>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="toward_boost_stm.users_guide.tutorial.a_simple_transaction"></a><a class="link" href="tutorial.html#toward_boost_stm.users_guide.tutorial.a_simple_transaction" title="A Simple Transaction">A
+<a name="toward_boost_stm.users_guide.tutorial.a_simple_transaction"></a><a href="tutorial.html#toward_boost_stm.users_guide.tutorial.a_simple_transaction" title="A
+ Simple Transaction">A
Simple Transaction</a>
</h4></div></div></div>
<p>
@@ -78,11 +80,11 @@
code calls, the internal insert operation which the exposed insert operation
calls.
</p>
-<a name="toward_boost_stm.users_guide.tutorial.a_simple_transaction.client_invoked_inserts"></a><h6>
-<a name="id4861141"></a>
- <a class="link" href="tutorial.html#toward_boost_stm.users_guide.tutorial.a_simple_transaction.client_invoked_inserts">Client
+<a name="toward_boost_stm.users_guide.tutorial.a_simple_transaction.client_invoked_inserts"></a><h5>
+<a name="id4815470"></a>
+ <a href="tutorial.html#toward_boost_stm.users_guide.tutorial.a_simple_transaction.client_invoked_inserts">Client
Invoked Inserts</a>
- </h6>
+ </h5>
<pre class="programlisting"><span class="identifier">tx_ptr</span><span class="special"><</span><span class="identifier">linked_list</span><span class="special"><</span><span class="keyword">int</span><span class="special">></span> <span class="special">></span> <span class="identifier">llist</span><span class="special">;</span>
<span class="special">...</span>
<span class="keyword">for</span> <span class="special">(</span><span class="keyword">int</span> <span class="identifier">i</span> <span class="special">=</span> <span class="number">0</span><span class="special">;</span> <span class="identifier">i</span> <span class="special"><</span> <span class="number">100</span><span class="special">;</span> <span class="special">++</span><span class="identifier">i</span><span class="special">)</span> <span class="special">{</span>
@@ -101,11 +103,11 @@
linked list insert. Obviously, this simplistic behavior eases the introduction
of TM solutions into algorithms of new and legacy systems.
</p>
-<a name="toward_boost_stm.users_guide.tutorial.a_simple_transaction.linked_list_declaration"></a><h6>
-<a name="id4861371"></a>
- <a class="link" href="tutorial.html#toward_boost_stm.users_guide.tutorial.a_simple_transaction.linked_list_declaration">Linked
+<a name="toward_boost_stm.users_guide.tutorial.a_simple_transaction.linked_list_declaration"></a><h5>
+<a name="id4815701"></a>
+ <a href="tutorial.html#toward_boost_stm.users_guide.tutorial.a_simple_transaction.linked_list_declaration">Linked
list declaration</a>
- </h6>
+ </h5>
<p>
A clasical linked list use a list node chained following the memer next_.
On a transactional context we nedd to state that the pointer to the next
@@ -123,11 +125,11 @@
<span class="identifier">tx_ptr</span><span class="special"><</span><span class="identifier">list_node</span><span class="special"><</span><span class="identifier">T</span><span class="special">></span> <span class="special">></span> <span class="identifier">head_</span><span class="special">;</span>
<span class="special">};</span>
</pre>
-<a name="toward_boost_stm.users_guide.tutorial.a_simple_transaction.insert_retry_transaction"></a><h6>
-<a name="id4861593"></a>
- <a class="link" href="tutorial.html#toward_boost_stm.users_guide.tutorial.a_simple_transaction.insert_retry_transaction">Insert
+<a name="toward_boost_stm.users_guide.tutorial.a_simple_transaction.insert_retry_transaction"></a><h5>
+<a name="id4815923"></a>
+ <a href="tutorial.html#toward_boost_stm.users_guide.tutorial.a_simple_transaction.insert_retry_transaction">Insert
retry transaction</a>
- </h6>
+ </h5>
<pre class="programlisting"><span class="keyword">void</span> <span class="identifier">insert</span><span class="special">(</span><span class="identifier">T</span> <span class="keyword">const</span> <span class="special">&</span><span class="identifier">val</span><span class="special">)</span> <span class="special">{</span>
<span class="keyword">for</span> <span class="special">(</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">stm</span><span class="special">::</span><span class="identifier">transaction</span> <span class="identifier">_</span><span class="special">;</span> <span class="special">!</span><span class="identifier">_</span><span class="special">.</span><span class="identifier">committed</span><span class="special">()</span> <span class="special">&&</span> <span class="identifier">_</span><span class="special">.</span><span class="identifier">restart</span><span class="special">();</span> <span class="identifier">_</span><span class="special">.</span><span class="identifier">no_throw_end</span><span class="special">())</span>
<span class="keyword">try</span> <span class="special">{</span>
@@ -154,11 +156,11 @@
transactions. The above example demonstrates this behavior in practice
with its absorption of aborted transactions and only aborted transactions.
</p>
-<a name="toward_boost_stm.users_guide.tutorial.a_simple_transaction.insert_specific"></a><h6>
-<a name="id4861843"></a>
- <a class="link" href="tutorial.html#toward_boost_stm.users_guide.tutorial.a_simple_transaction.insert_specific">Insert
+<a name="toward_boost_stm.users_guide.tutorial.a_simple_transaction.insert_specific"></a><h5>
+<a name="id4816172"></a>
+ <a href="tutorial.html#toward_boost_stm.users_guide.tutorial.a_simple_transaction.insert_specific">Insert
specific</a>
- </h6>
+ </h5>
<pre class="programlisting"><span class="identifier">upgrd_ptr</span><span class="special"><</span><span class="identifier">list_node</span><span class="special"><</span><span class="identifier">T</span><span class="special">></span> <span class="special">></span> <span class="identifier">prev</span><span class="special">(</span><span class="identifier">_</span><span class="special">,</span> <span class="identifier">head_</span><span class="special">);</span>
<span class="identifier">upgrd_ptr</span><span class="special"><</span><span class="identifier">list_node</span><span class="special"><</span><span class="identifier">T</span><span class="special">></span> <span class="special">></span> <span class="identifier">curr</span><span class="special">(</span><span class="identifier">_</span><span class="special">,</span> <span class="identifier">head_</span><span class="special">-></span><span class="identifier">next_</span><span class="special">);</span>
<span class="keyword">while</span> <span class="special">(</span><span class="identifier">curr</span><span class="special">)</span> <span class="special">{</span>
@@ -246,7 +248,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="toward_boost_stm.users_guide.tutorial.a_composable_transaction"></a><a class="link" href="tutorial.html#toward_boost_stm.users_guide.tutorial.a_composable_transaction" title="A Composable Transaction">A
+<a name="toward_boost_stm.users_guide.tutorial.a_composable_transaction"></a><a href="tutorial.html#toward_boost_stm.users_guide.tutorial.a_composable_transaction" title="A
+ Composable Transaction">A
Composable Transaction</a>
</h4></div></div></div>
<p>
@@ -333,7 +336,8 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="toward_boost_stm.users_guide.tutorial.a_dynamically_prioritized__composed_transaction"></a><a class="link" href="tutorial.html#toward_boost_stm.users_guide.tutorial.a_dynamically_prioritized__composed_transaction" title="A Dynamically Prioritized, Composed Transaction">A
+<a name="toward_boost_stm.users_guide.tutorial.a_dynamically_prioritized__composed_transaction"></a><a href="tutorial.html#toward_boost_stm.users_guide.tutorial.a_dynamically_prioritized__composed_transaction" title="A
+ Dynamically Prioritized, Composed Transaction">A
Dynamically Prioritized, Composed Transaction</a>
</h4></div></div></div>
<p>
@@ -360,21 +364,20 @@
contention manager mechanism to abort a transaction before it commits.
Although TBoost.STM does not yet implement validation, once it becomes
available, client-side validating algorithms which want to avoid priority
- inversion will need to override abort_before_commit() to iterate over in-flight
- transactions and abort the current in-process transaction if another in-flight
- transaction exists of higher priority. All in-flight transactions can be
- accessed by a call to in_flight_transactions() which returns the set of
- active transactions. As such, one could build an overridden abort_before_commit()
- which always caused lower priority committing transactions to abort in
- the event a higher priority transaction is currently in-flight. One possible
- implementation is shown below. For code simplicity, the following code
- has removed some static class accessors and namespaces.
+ inversion will need to override <code class="computeroutput"><span class="identifier">abort_before_commit</span><span class="special">()</span></code> to iterate over in-flight transactions
+ and abort the current in-process transaction if another in-flight transaction
+ exists of higher priority. All in-flight transactions can be accessed by
+ a call to <code class="computeroutput"><span class="identifier">in_flight_transactions</span><span class="special">()</span></code> which returns the set of active transactions.
+ As such, one could build an overridden <code class="computeroutput"><span class="identifier">abort_before_commit</span><span class="special">()</span></code> which always caused lower priority committing
+ transactions to abort in the event a higher priority transaction is currently
+ in-flight. One possible implementation is shown below. For code simplicity,
+ the following code has removed some static class accessors and namespaces.
</p>
<p>
Priority Inversion for Validating Consistency.
</p>
<pre class="programlisting"><span class="keyword">class</span> <span class="identifier">priority_cm</span> <span class="special">:</span>
-<span class="keyword">public</span> <span class="identifier">core</span><span class="special">::</span><span class="identifier">base_contention_manager</span> <span class="special">{</span>
+<span class="keyword">public</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">stm</span><span class="special">::</span><span class="identifier">base_contention_manager</span> <span class="special">{</span>
<span class="keyword">public</span><span class="special">:</span>
<span class="comment">// method invoked prior tx commit
</span> <span class="keyword">bool</span> <span class="identifier">abort_before_commit</span><span class="special">(</span><span class="identifier">transaction</span> <span class="keyword">const</span> <span class="special">&</span><span class="identifier">t</span><span class="special">)</span> <span class="special">{</span>
@@ -398,12 +401,13 @@
the above priority inversion mechanism may be as close to correct as is
possible. This solution is useful for validation, but should never be used
for invalidation. Instead a second and more natural approach for invalidating
- systems to prevent priority inversion is to override the permission_to_abort()
- interface. The permission_to_abort() interface can only be used when TBoost.STM
+ systems to prevent priority inversion is to override the <code class="computeroutput"><span class="identifier">permission_to_abort</span><span class="special">()</span></code>
+ interface. The <code class="computeroutput"><span class="identifier">permission_to_abort</span><span class="special">()</span></code> interface can only be used when TBoost.STM
is performing invalidation.
</p>
<p>
- The permission_to_abort() interface is called from TBoost.STM's end_transaction()
+ The <code class="computeroutput"><span class="identifier">permission_to_abort</span><span class="special">()</span></code> interface is called from TBoost.STM's
+ <code class="computeroutput"><span class="identifier">end_transaction</span><span class="special">()</span></code>
method when a committing transaction has found a second transaction it
needs to abort for consistency. As such, the method takes two parameters,
an lhs (lefthand side), the committing transaction, and an rhs (right-hand
@@ -416,15 +420,15 @@
a completely legal uncommitted state until all consistency is performed.
For direct updating aborts, the system simply follows its normal semantics
of aborting the transaction by restoring global memory to its original
- state. Similar to the prior example, overriding the permission_to_abort()
- method can be done in such a manner which prevents lower priority transaction
- from aborting a higher priority transaction as shown below:
+ state. Similar to the prior example, overriding the <code class="computeroutput"><span class="identifier">permission_to_abort</span><span class="special">()</span></code> method can be done in such a manner which
+ prevents lower priority transaction from aborting a higher priority transaction
+ as shown below:
</p>
<p>
Priority Inversion for Invalidating Consistency.
</p>
<pre class="programlisting"><span class="keyword">class</span> <span class="identifier">priority_cm</span> <span class="special">:</span>
-<span class="keyword">public</span> <span class="identifier">core</span><span class="special">::</span><span class="identifier">base_contention_manager</span> <span class="special">{</span>
+<span class="keyword">public</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">stm</span><span class="special">::</span><span class="identifier">base_contention_manager</span> <span class="special">{</span>
<span class="keyword">public</span><span class="special">:</span>
<span class="comment">// method invoked before lhs transaction
</span> <span class="comment">// aborts rhs transaction
@@ -437,25 +441,25 @@
<p>
With priority inversion preventable for both validating and invalidating
consistency modes, transactions now need some mechanism to control their
- priority. TBoost.STM allows for such control through the raise_priority()
- interface. By iteratively calling raise_priority(), preempted transactions
- can raise their priority at each preemption ensuring their eventual commit.
- The raise_priority() interface is implemented using a size_t type. Additionally,
- TBoost.STM supplies a set_priority() interface taking a size_t parameter
- allowing client code to set the priority directly.
+ priority. TBoost.STM allows for such control through the <code class="computeroutput"><span class="identifier">raise_priority</span><span class="special">()</span></code>
+ interface. By iteratively calling <code class="computeroutput"><span class="identifier">raise_priority</span><span class="special">()</span></code>, preempted transactions can raise their
+ priority at each preemption ensuring their eventual commit. The <code class="computeroutput"><span class="identifier">raise_priority</span><span class="special">()</span></code>
+ interface is implemented using a <code class="computeroutput"><span class="identifier">size_t</span></code>
+ type. Additionally, TBoost.STM supplies a <code class="computeroutput"><span class="identifier">set_priority</span><span class="special">()</span></code> interface taking a <code class="computeroutput"><span class="identifier">size_t</span></code>
+ parameter allowing client code to set the priority directly.
</p>
<p>
- In order for raise_priority() to function correctly, the affected transaction
+ In order for <code class="computeroutput"><span class="identifier">raise_priority</span><span class="special">()</span></code> to function correctly, the affected transaction
must not be destroyed upon transactional abort. If the prioritized transaction
- is destroyed at each transactional abort, raise_priority() will only raise
- the transaction's priority by one each time. In order to demonstrate how
- raise_priority() can be used in practice, we use a wrapper transaction
- around the internal_insert()'s transaction. However, in this case the wrapper
- transaction is not destroyed upon successive iterations. The restart_transaction()
+ is destroyed at each transactional abort, <code class="computeroutput"><span class="identifier">raise_priority</span><span class="special">()</span></code> will only raise the transaction's priority
+ by one each time. In order to demonstrate how <code class="computeroutput"><span class="identifier">raise_priority</span><span class="special">()</span></code> can be used in practice, we use a wrapper
+ transaction around the <code class="computeroutput"><span class="identifier">internal_insert</span><span class="special">()</span></code>'s transaction. However, in this case
+ the wrapper transaction is not destroyed upon successive iterations. The
+ <code class="computeroutput"><span class="identifier">restart_transaction</span><span class="special">()</span></code>
interface must be called for transactions that are not destroyed after
being aborted. This necessary step clears the state from the previously
- failed transactional run. As shown in the below code, the restart_transaction()
- is only called when an aborted exception is caught. This is because end_transaction()
+ failed transactional run. As shown in the below code, the <code class="computeroutput"><span class="identifier">restart_transaction</span><span class="special">()</span></code>
+ is only called when an aborted exception is caught. This is because <code class="computeroutput"><span class="identifier">end_transaction</span><span class="special">()</span></code>
throws an exception when the transaction is aborted. Following this implementation
paradigm, handling aborted transactions is relatively straightforward as
all aborted transactions follow the same exception-based path.
@@ -505,7 +509,7 @@
</p>
<p>
As the above priority assigned transaction demonstrates, the outer transaction
- has increasing priority while the inner transaction, the one within internal_insert(),
+ has increasing priority while the inner transaction, the one within <code class="computeroutput"><span class="identifier">internal_insert</span><span class="special">()</span></code>,
does not. Yet, the inner transaction is not aborted due to the outer transaction's
priority. This is handled internally via TBoost.STM's abort process by
two fundamental ideas.
@@ -557,39 +561,38 @@
<span class="special">}</span>
<span class="special">}</span>
</pre>
-<a name="toward_boost_stm.users_guide.tutorial.a_dynamically_prioritized__composed_transaction.priority_inversion_allowed"></a><h6>
-<a name="id4866234"></a>
- <a class="link" href="tutorial.html#toward_boost_stm.users_guide.tutorial.a_dynamically_prioritized__composed_transaction.priority_inversion_allowed">Priority
+<a name="toward_boost_stm.users_guide.tutorial.a_dynamically_prioritized__composed_transaction.priority_inversion_allowed"></a><h5>
+<a name="id4820854"></a>
+ <a href="tutorial.html#toward_boost_stm.users_guide.tutorial.a_dynamically_prioritized__composed_transaction.priority_inversion_allowed">Priority
Inversion Allowed</a>
- </h6>
+ </h5>
<p>
From the above code examples, one may question why the default behavior
implemented within TBoost.STM does not automatically integrate priority
- into transactions, as it could be integrated within restart_transaction().
- First, each problem is different and integrating priority only into restart_transaction()
- would not cover all cases (e.g., when the outer transaction was terminated).
- Second, building an automatic priority inversion handling scheme would
- eliminate some of the natural optimizations granted from different updating
- policies. For example, deferred updating allows multiple writers of the
- same memory to execute simultaneously. This behavior enables deferred updating
- the ability to process the fastest completing transactions first. If a
- priority system was integrated directly into TBoost.STM, this optimization
- would be lost. In addition, direct updating optimizes writes by writing
- directly to global memory. As such, direct updating suffers greater penalties
- for aborted transactions due to required restoration of global memory.
- In this case, more transactional aborts would occur if TBoost.STM built-in
- a default priority inversion handler. Considering these factors, as well
- as many others, TBoost.STM does not build transactional priority into its
- system. Instead, we leave this implementation up to client-side implementors,
- as they will have a better understanding of their problem domain and be
- able to more correctly implement the right contention manager for their
- specific needs.
- </p>
-<a name="toward_boost_stm.users_guide.tutorial.a_dynamically_prioritized__composed_transaction.the_future_of_parallel_programming"></a><h6>
-<a name="id4866316"></a>
- <a class="link" href="tutorial.html#toward_boost_stm.users_guide.tutorial.a_dynamically_prioritized__composed_transaction.the_future_of_parallel_programming">The
+ into transactions, as it could be integrated within <code class="computeroutput"><span class="identifier">restart_transaction</span><span class="special">()</span></code>. First, each problem is different and
+ integrating priority only into <code class="computeroutput"><span class="identifier">restart_transaction</span><span class="special">()</span></code> would not cover all cases (e.g., when
+ the outer transaction was terminated). Second, building an automatic priority
+ inversion handling scheme would eliminate some of the natural optimizations
+ granted from different updating policies. For example, deferred updating
+ allows multiple writers of the same memory to execute simultaneously. This
+ behavior enables deferred updating the ability to process the fastest completing
+ transactions first. If a priority system was integrated directly into TBoost.STM,
+ this optimization would be lost. In addition, direct updating optimizes
+ writes by writing directly to global memory. As such, direct updating suffers
+ greater penalties for aborted transactions due to required restoration
+ of global memory. In this case, more transactional aborts would occur if
+ TBoost.STM built-in a default priority inversion handler. Considering these
+ factors, as well as many others, TBoost.STM does not build transactional
+ priority into its system. Instead, we leave this implementation up to client-side
+ implementors, as they will have a better understanding of their problem
+ domain and be able to more correctly implement the right contention manager
+ for their specific needs.
+ </p>
+<a name="toward_boost_stm.users_guide.tutorial.a_dynamically_prioritized__composed_transaction.the_future_of_parallel_programming"></a><h5>
+<a name="id4820956"></a>
+ <a href="tutorial.html#toward_boost_stm.users_guide.tutorial.a_dynamically_prioritized__composed_transaction.the_future_of_parallel_programming">The
Future of Parallel Programming</a>
- </h6>
+ </h5>
<p>
An important distinction regarding priority within transactions versus
priority within more classical synchronization mechanisms, like locks,
@@ -612,26 +615,30 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="toward_boost_stm.users_guide.tutorial.can_a_transactional_object_embeed_another_transactional_object_"></a><a class="link" href="tutorial.html#toward_boost_stm.users_guide.tutorial.can_a_transactional_object_embeed_another_transactional_object_" title="Can a transactional object embeed another transactional object?">Can
+<a name="toward_boost_stm.users_guide.tutorial.can_a_transactional_object_embeed_another_transactional_object_"></a><a href="tutorial.html#toward_boost_stm.users_guide.tutorial.can_a_transactional_object_embeed_another_transactional_object_" title="Can
+ a transactional object embeed another transactional object?">Can
a transactional object embeed another transactional object?</a>
</h4></div></div></div>
<p>
- Let me show what happens when we emmend transactional objects: class C
- : public transaction_object<C> {...};
+ Let me show what happens when we embeed transactional objects:
</p>
-<pre class="programlisting"><span class="keyword">class</span> <span class="identifier">E</span> <span class="special">:</span> <span class="keyword">public</span> <span class="identifier">transaction_object</span><span class="special"><</span><span class="identifier">E</span><span class="special">></span> <span class="special">{</span>
+<pre class="programlisting"><span class="keyword">class</span> <span class="identifier">C</span> <span class="special">:</span> <span class="keyword">public</span> <span class="identifier">transaction_object</span><span class="special"><</span><span class="identifier">C</span><span class="special">></span> <span class="special">{...};</span>
+
+<span class="keyword">class</span> <span class="identifier">E</span> <span class="special">:</span> <span class="keyword">public</span> <span class="identifier">transaction_object</span><span class="special"><</span><span class="identifier">E</span><span class="special">></span> <span class="special">{</span>
<span class="identifier">C</span> <span class="identifier">c</span><span class="special">;</span>
<span class="keyword">int</span> <span class="identifier">i</span><span class="special">;</span>
<span class="special">};</span>
+
+<span class="identifier">E</span> <span class="identifier">e</span><span class="special">;</span>
</pre>
<p>
- E e;
- </p>
-<p>
- When a thread T1 modifies e (and possibly the b part) on a transaction
- another thread T2 can modify e.c on another transaction. When the two transactional
- objects overlap the STM system is unable to detect this efficiently, having
- as consequence an inconsistency.
+ Let be <code class="computeroutput"><span class="identifier">T1</span></code> a thread that
+ modifies <code class="computeroutput"><span class="identifier">e</span></code> (and possibly
+ the <code class="computeroutput"><span class="identifier">b</span></code> part) on a transaction
+ and <code class="computeroutput"><span class="identifier">T2</span></code> another thread modifying
+ <code class="computeroutput"><span class="identifier">e</span><span class="special">.</span><span class="identifier">c</span></code> on another transaction. When the two
+ transactional objects overlap the STM system is unable to detect this efficiently,
+ having as consequence an inconsistency.
</p>
<p>
The following pseudo-code shows the
@@ -643,61 +650,138 @@
<span class="number">4</span> <span class="special">}</span>
</pre>
<p>
- When T2 commits on (3) e.c will be modified, but T1 will modify the complete
- E independent of the e.c modification doen by T2, overwriting the e.c with
- its old value. T1 will be coherent, but not T2. If we want to allow such
- a scheme, we have several possibilities
- </p>
-<div class="itemizedlist"><ul type="disc">
-<li>
- implicit: take care of overlaping transactional objects, so we can detect
- when T1 commits that an overlaping TO e.c has been modified, so the transaction
- on T1 is aborted and retried.
- </li>
-<li>
- explicit: the developper of T1 must notify the STM system that the transactional
- object e constains a transactional object e.c
- </li>
-<li>
- declarative: the developper of E would declare that it contains an emmbeed
- transactional object C at E::c, so the STM system will use this explicit
- information when an E is accesses using the STM interface.
- </li>
-</ul></div>
+ When <code class="computeroutput"><span class="identifier">T2</span></code> commits on (3)
+ <code class="computeroutput"><span class="identifier">e</span><span class="special">.</span><span class="identifier">c</span></code> will be modified, but <code class="computeroutput"><span class="identifier">T1</span></code> will modify the complete <code class="computeroutput"><span class="identifier">E</span></code> independent of the <code class="computeroutput"><span class="identifier">e</span><span class="special">.</span><span class="identifier">c</span></code> modification
+ done by <code class="computeroutput"><span class="identifier">T2</span></code>, overwriting
+ the <code class="computeroutput"><span class="identifier">e</span><span class="special">.</span><span class="identifier">c</span></code> with its old value. <code class="computeroutput"><span class="identifier">T1</span></code>
+ will be coherent, but not <code class="computeroutput"><span class="identifier">T2</span></code>.
+ If we want to allow such a scheme, we have several possibilities
+ </p>
+<div class="itemizedlist"><ul type="disc"><li>
+<span class="bold"><strong>implicit</strong></span>: take care of overlaping transactional
+ objects, so we can detect when <code class="computeroutput"><span class="identifier">T1</span></code>
+ commits that an overlaping to <code class="computeroutput"><span class="identifier">e</span><span class="special">.</span><span class="identifier">c</span></code>
+ has been modified, so the transaction on <code class="computeroutput"><span class="identifier">T1</span></code>
+ is aborted and retried.
+ </li></ul></div>
+<pre class="programlisting"> <span class="identifier">T1</span> <span class="identifier">T2</span>
+<span class="number">1</span> <span class="identifier">atomic</span> <span class="special">{</span> <span class="identifier">atomic</span> <span class="special">{</span>
+<span class="number">2</span> <span class="identifier">t</span><span class="special">.</span><span class="identifier">w</span><span class="special">(</span><span class="identifier">e</span><span class="special">).</span><span class="identifier">i</span><span class="special">=</span><span class="number">0</span><span class="special">;</span> <span class="identifier">t</span><span class="special">.</span><span class="identifier">w</span><span class="special">(</span><span class="identifier">e</span><span class="special">.</span><span class="identifier">c</span><span class="special">)=</span><span class="identifier">A</span><span class="special">;</span>
+<span class="number">3</span> <span class="special">}</span>
+<span class="number">4</span> <span class="special">}</span>
+</pre>
+<div class="itemizedlist"><ul type="disc"><li>
+<span class="bold"><strong>explicit</strong></span>: the developper of <code class="computeroutput"><span class="identifier">T1</span></code> must notify the STM system that
+ the transactional object <code class="computeroutput"><span class="identifier">e</span></code>
+ constains a transactional object <code class="computeroutput"><span class="identifier">e</span><span class="special">.</span><span class="identifier">c</span></code>.
+ </li></ul></div>
+<pre class="programlisting"> <span class="identifier">T1</span> <span class="identifier">T2</span>
+<span class="number">1</span> <span class="identifier">atomic</span> <span class="special">{</span> <span class="identifier">atomic</span> <span class="special">{</span>
+<span class="number">3</span> <span class="identifier">t</span><span class="special">.</span><span class="identifier">w</span><span class="special">(</span><span class="identifier">e</span><span class="special">.</span><span class="identifier">c</span><span class="special">);</span>
+<span class="number">2</span> <span class="identifier">t</span><span class="special">.</span><span class="identifier">w</span><span class="special">(</span><span class="identifier">e</span><span class="special">).</span><span class="identifier">i</span><span class="special">=</span><span class="number">0</span><span class="special">;</span> <span class="identifier">t</span><span class="special">.</span><span class="identifier">w</span><span class="special">(</span><span class="identifier">e</span><span class="special">.</span><span class="identifier">c</span><span class="special">)=</span><span class="identifier">A</span><span class="special">;</span>
+<span class="number">3</span> <span class="special">}</span>
+<span class="number">4</span> <span class="special">}</span>
+</pre>
+<p>
+ Note that in this example there is only one embedeed transactional object
+ but in real examples the number can increase horizontaly, direct embeede
+ relation, and verticaly, embeeded transactional objects can embeed themselves
+ other transactional objects.
+ </p>
+<div class="itemizedlist"><ul type="disc"><li>
+<span class="bold"><strong>declarative</strong></span>: the developper of E would
+ declare that it contains an emmbeed transactional object C at E::c, so
+ the STM system will use this explicit information when an E is accesses
+ using the STM interface.
+ </li></ul></div>
+<pre class="programlisting"><span class="identifier">BOOST_STM_EMBEEDS</span><span class="special">(</span><span class="identifier">E</span><span class="special">,</span> <span class="identifier">C</span><span class="special">,</span> <span class="identifier">E</span><span class="special">::</span><span class="identifier">c</span><span class="special">);</span>
+</pre>
<p>
The implicit approach is the more transparent for the user but it is also
- the less efficient. It need to add a virtual function quering the size
- of the class, and to modify the conflic detection algorithm (maybe the
- write_list must be a write_set, ordered by the address)
+ the less efficient. It needs to add a virtual function quering the size
+ of the class, and to modify the conflic detection algorithm (the write_list
+ coukd be a write_set, ordered by the address). In addition it is incompatible
+ with the bloom filters optimization.
</p>
<p>
The explit approach let the user with a lot of burden and risk of error
- when access to an E is done on a transaction. This needs to add the size
- and the algorithm which adds transactional object on the write_list (maybe
- the write_list must be a write_interval_set, ordered by the address).
+ when access to an <code class="computeroutput"><span class="identifier">E</span></code> is
+ done on a transaction. This needs to add the size and the algorithm which
+ adds transactional object on the write_list (maybe the write_list must
+ be a write_interval_set, ordered by the address).
</p>
<p>
- The declarative concentrate on a single place, so the user will be not
+ The declarative concentrate on a single place, so the user will not be
too concerned, and this open possible optimizations.
</p>
<p>
- Supose now that we are able to embeed transactional objects. and that the
- T1 not only opens for writing e, but also e.c either on the same block
- on on a block (or nested transaction). The STM will see both address to
- be written, and even if there should be no risk of incoherence the object
- e.c will be copied twice.
+ Supose now that we are able to embeed transactional objects and that the
+ <code class="computeroutput"><span class="identifier">T1</span></code> not only opens for writing
+ <code class="computeroutput"><span class="identifier">e</span></code>, but also <code class="computeroutput"><span class="identifier">e</span><span class="special">.</span><span class="identifier">c</span></code>
+ either on the same block or on a nested block (or nested transaction).
+ The STM will see both address to be written, and even if there should be
+ no risk of incoherence the object e.c will be copied twice.
+ </p>
+<p>
+ The implicit approach could check that there are not overlaping transactional
+ objects, as it contains the size of each transactional object.
+ </p>
+<p>
+ The explicit approach do not let us detect overlaping transactional objets
+ until we store the size of a transactional object, but this can not be
+ done if we use bloom filters.
+ </p>
+<p>
+ With the declarative approach, we can use
+ </p>
+<p>
+ If STM do not allows embeeded transactional objects, we force the user
+ to use constant pointers to trasactional objects
+ </p>
+<pre class="programlisting"><span class="keyword">class</span> <span class="identifier">C</span> <span class="special">:</span> <span class="keyword">public</span> <span class="identifier">transaction_object</span><span class="special"><</span><span class="identifier">C</span><span class="special">></span> <span class="special">{...};</span>
+
+<span class="keyword">class</span> <span class="identifier">E</span> <span class="special">:</span> <span class="keyword">public</span> <span class="identifier">transaction_object</span><span class="special"><</span><span class="identifier">E</span><span class="special">></span> <span class="special">{</span>
+ <span class="identifier">C</span><span class="special">*</span> <span class="keyword">const</span> <span class="identifier">c</span><span class="special">;</span>
+ <span class="identifier">native_trans</span><span class="special"><</span><span class="keyword">int</span><span class="special">>*</span> <span class="keyword">const</span> <span class="identifier">i</span><span class="special">;</span>
+ <span class="identifier">E</span><span class="special">()</span> <span class="special">:</span> <span class="identifier">c</span><span class="special">(</span><span class="keyword">new</span> <span class="identifier">C</span><span class="special">),</span> <span class="identifier">i</span><span class="special">(</span><span class="keyword">new</span> <span class="identifier">native_trans</span><span class="special"><</span><span class="keyword">int</span><span class="special">>)</span> <span class="special">{}</span>
+ <span class="special">~</span><span class="identifier">E</span><span class="special">()</span> <span class="special">{</span> <span class="keyword">delete</span> <span class="identifier">c</span><span class="special">;</span> <span class="keyword">delete</span> <span class="identifier">i</span><span class="special">;</span> <span class="special">}</span>
+
+<span class="special">};</span>
+
+<span class="identifier">E</span> <span class="identifier">e</span><span class="special">;</span>
+</pre>
+<p>
+ Having the main draback of managing the ownership of the heap allocated
+ transactional objects.
+ </p>
+<pre class="programlisting"> <span class="identifier">T1</span> <span class="identifier">T2</span>
+<span class="number">1</span> <span class="identifier">atomic</span> <span class="special">{</span> <span class="identifier">atomic</span> <span class="special">{</span>
+<span class="number">2</span> <span class="special">*(</span><span class="identifier">e</span><span class="special">.</span><span class="identifier">i</span><span class="special">)=</span><span class="number">0</span><span class="special">;</span> <span class="special">*(</span><span class="identifier">e</span><span class="special">.</span><span class="identifier">c</span><span class="special">)=</span><span class="identifier">A</span><span class="special">;</span>
+<span class="number">3</span> <span class="special">}</span>
+<span class="number">4</span> <span class="special">}</span>
+</pre>
+<p>
+ The advantage of this design is that now both threads do not conflic as
+ the transactional object <code class="computeroutput"><span class="identifier">e</span></code>
+ is not really modified.
+ </p>
+<p>
+ We think that TBoost.STM needs to manage with embeeded transactional objects
+ in a transparent way, and let the user to use pointers when he/she consider
+ it more adapted to their problem solution.
</p>
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="toward_boost_stm.users_guide.tutorial.returning_values_from_a_fucntion"></a><a class="link" href="tutorial.html#toward_boost_stm.users_guide.tutorial.returning_values_from_a_fucntion" title="Returning values from a fucntion">Returning
- values from a fucntion</a>
+<a name="toward_boost_stm.users_guide.tutorial.returning_values_from_a_function"></a><a href="tutorial.html#toward_boost_stm.users_guide.tutorial.returning_values_from_a_function" title="Returning
+ values from a function">Returning
+ values from a function</a>
</h4></div></div></div>
-<a name="toward_boost_stm.users_guide.tutorial.returning_values_from_a_fucntion.returning_from_outside_the_transaction_context"></a><h6>
-<a name="id4866697"></a>
- <a class="link" href="tutorial.html#toward_boost_stm.users_guide.tutorial.returning_values_from_a_fucntion.returning_from_outside_the_transaction_context">Returning
+<a name="toward_boost_stm.users_guide.tutorial.returning_values_from_a_function.returning_from_outside_the_transaction_context"></a><h5>
+<a name="id4822561"></a>
+ <a href="tutorial.html#toward_boost_stm.users_guide.tutorial.returning_values_from_a_function.returning_from_outside_the_transaction_context">Returning
from outside the transaction context</a>
- </h6>
+ </h5>
<p>
The simgle way consists is using a local variable declared outside the
transaction context.
@@ -710,11 +794,11 @@
<span class="keyword">return</span> <span class="identifier">res</span><span class="special">;</span>
<span class="special">}</span>
</pre>
-<a name="toward_boost_stm.users_guide.tutorial.returning_values_from_a_fucntion.returning_from_inside"></a><h6>
-<a name="id4866874"></a>
- <a class="link" href="tutorial.html#toward_boost_stm.users_guide.tutorial.returning_values_from_a_fucntion.returning_from_inside">Returning
+<a name="toward_boost_stm.users_guide.tutorial.returning_values_from_a_function.returning_from_inside"></a><h5>
+<a name="id4822737"></a>
+ <a href="tutorial.html#toward_boost_stm.users_guide.tutorial.returning_values_from_a_function.returning_from_inside">Returning
from inside</a>
- </h6>
+ </h5>
<p>
The following attempt does not work as the transaction will not be commited.
</p>
@@ -741,18 +825,19 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="toward_boost_stm.users_guide.tutorial.pointer_to_transactional_objects"></a><a class="link" href="tutorial.html#toward_boost_stm.users_guide.tutorial.pointer_to_transactional_objects" title="Pointer to transactional objects">Pointer
+<a name="toward_boost_stm.users_guide.tutorial.pointer_to_transactional_objects"></a><a href="tutorial.html#toward_boost_stm.users_guide.tutorial.pointer_to_transactional_objects" title="Pointer
+ to transactional objects">Pointer
to transactional objects</a>
</h4></div></div></div>
<p>
Access to a pointer to a transaction object works, but this do not take
care of modifications of the pointer itself.
</p>
-<a name="toward_boost_stm.users_guide.tutorial.pointer_to_transactional_objects.using_the_mixin_transaction_object_lt__gt_"></a><h6>
-<a name="id4867276"></a>
- <a class="link" href="tutorial.html#toward_boost_stm.users_guide.tutorial.pointer_to_transactional_objects.using_the_mixin_transaction_object_lt__gt_">Using
+<a name="toward_boost_stm.users_guide.tutorial.pointer_to_transactional_objects.using_the_mixin_transaction_object_lt__gt_"></a><h5>
+<a name="id4823140"></a>
+ <a href="tutorial.html#toward_boost_stm.users_guide.tutorial.pointer_to_transactional_objects.using_the_mixin_transaction_object_lt__gt_">Using
the mixin transaction_object<></a>
- </h6>
+ </h5>
<p>
Let B the TO made using the mixin transaction_object.
</p>
@@ -797,7 +882,7 @@
<span class="special">};</span>
</pre>
<p>
- Let declare a pointer to B
+ Let declare a pointer to <code class="computeroutput"><span class="identifier">B</span></code>
</p>
<pre class="programlisting"><span class="identifier">transaction_object_ptr</span><span class="special"><</span><span class="identifier">B</span><span class="special">></span> <span class="identifier">ptr_b</span><span class="special">;</span>
@@ -810,19 +895,19 @@
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="toward_boost_stm.users_guide.tutorial.polymorphic"></a><a class="link" href="tutorial.html#toward_boost_stm.users_guide.tutorial.polymorphic" title="Polymorphic">Polymorphic</a>
+<a name="toward_boost_stm.users_guide.tutorial.polymorphic"></a>Polymorphic
</h4></div></div></div>
<p>
- How the user can defien a transactional class D inheriting from a transactional
- class B
+ How the user can defien a transactional class <code class="computeroutput"><span class="identifier">D</span></code>
+ inheriting from a transactional class <code class="computeroutput"><span class="identifier">B</span></code>
</p>
-<a name="toward_boost_stm.users_guide.tutorial.polymorphic._mixin_using_the_mixin_transaction_object_lt__gt_"></a><h6>
-<a name="id4868388"></a>
- <a class="link" href="tutorial.html#toward_boost_stm.users_guide.tutorial.polymorphic._mixin_using_the_mixin_transaction_object_lt__gt_">:mixin
- Using the mixin transaction_object<></a>
- </h6>
+<a name="toward_boost_stm.users_guide.tutorial.polymorphic.using_the_mixin_transaction_object_lt__gt_"></a><h5>
+<a name="id4824279"></a>
+ <a href="tutorial.html#toward_boost_stm.users_guide.tutorial.polymorphic.using_the_mixin_transaction_object_lt__gt_">Using
+ the mixin transaction_object<></a>
+ </h5>
<p>
- Let B the base class
+ Let <code class="computeroutput"><span class="identifier">B</span></code> the base class
</p>
<pre class="programlisting"><span class="keyword">class</span> <span class="identifier">B</span> <span class="special">:</span> <span class="keyword">public</span> <span class="identifier">transaction_object</span><span class="special"><</span><span class="identifier">B</span><span class="special">></span> <span class="special">{</span>
<span class="keyword">public</span><span class="special">:</span>
@@ -830,41 +915,290 @@
<span class="special">};</span>
</pre>
<p>
- The derived class must declare D as follows:
+ The derived class must declare <code class="computeroutput"><span class="identifier">D</span></code>
+ as follows:
</p>
<pre class="programlisting"><span class="keyword">class</span> <span class="identifier">D</span> <span class="special">:</span> <span class="keyword">public</span> <span class="identifier">transaction_object</span><span class="special"><</span><span class="identifier">D</span><span class="special">,</span><span class="identifier">B</span><span class="special">></span> <span class="special">{</span>
<span class="special">...</span>
<span class="special">};</span>
</pre>
<p>
- How a variable pointing to B must be declared. The fact that B is a transactional
- object do not means that a pointer to it is one.
+ How a variable pointing to <code class="computeroutput"><span class="identifier">B</span></code>
+ must be declared. The fact that <code class="computeroutput"><span class="identifier">B</span></code>
+ is a transactional object do not means that a pointer to it is one.
</p>
-<pre class="programlisting"><span class="identifier">pointer</span><span class="special"><</span><span class="identifier">B</span><span class="special">></span> <span class="identifier">ptr_b</span> <span class="special">=</span> <span class="number">0</span>
+<pre class="programlisting"><span class="identifier">transaction_object_ptr</span><span class="special"><</span><span class="identifier">B</span><span class="special">></span> <span class="identifier">ptr_b</span> <span class="special">=</span> <span class="number">0</span>
</pre>
<p>
- How can we assign a pointer to D?
+ How can we assign a pointer to <code class="computeroutput"><span class="identifier">D</span></code>?
</p>
<pre class="programlisting"><span class="identifier">write_ptr</span><span class="special"><</span><span class="identifier">B</span><span class="special">*></span> <span class="identifier">tx_ptr_b_ptr</span><span class="special">(</span><span class="identifier">_</span><span class="special">,</span><span class="identifier">ptr_b</span><span class="special">);</span>
-<span class="special">*</span><span class="identifier">ptr_b</span> <span class="special">=</span> <span class="identifier">BOOST_STM_NEW</span><span class="special">(</span><span class="identifier">_</span><span class="special">,</span> <span class="identifier">D</span><span class="special">())</span>
+<span class="special">*</span><span class="identifier">ptr_b</span> <span class="special">=</span> <span class="identifier">BOOST_STM_NEW</span><span class="special">(</span><span class="identifier">_</span><span class="special">,</span> <span class="identifier">D</span><span class="special">());</span>
+</pre>
+<a name="toward_boost_stm.users_guide.tutorial.polymorphic.using_the_wrapper_transactional_object_lt__gt_"></a><h5>
+<a name="id4824643"></a>
+ <a href="tutorial.html#toward_boost_stm.users_guide.tutorial.polymorphic.using_the_wrapper_transactional_object_lt__gt_">Using
+ the wrapper transactional_object<></a>
+ </h5>
+<p>
+ Wrapping does not works well with inheritance.
+ </p>
+<p>
+ Given a class D inheriting from B
+ </p>
+<pre class="programlisting"><span class="keyword">class</span> <span class="identifier">B</span> <span class="special">{</span>
+ <span class="special">...</span>
+<span class="special">};</span>
+
+<span class="keyword">class</span> <span class="identifier">D</span><span class="special">:</span> <span class="keyword">public</span> <span class="identifier">B</span> <span class="special">{</span>
+ <span class="special">...</span>
+<span class="special">};</span>
</pre>
-<a name="toward_boost_stm.users_guide.tutorial.polymorphic.__wrapper_using_the_wrapper_transactional_object_lt__gt_"></a><h6>
-<a name="id4868709"></a>
- <a class="link" href="tutorial.html#toward_boost_stm.users_guide.tutorial.polymorphic.__wrapper_using_the_wrapper_transactional_object_lt__gt_">::wrapper
- Using the wrapper transactional_object<></a>
- </h6>
+<p>
+ The C++ type system do not ensures that transactional_object<D> inherits
+ from transactional_object<B>. That is,
+ </p>
+<pre class="programlisting"><span class="identifier">transaction_object_ptr</span><span class="special"><</span><span class="identifier">transactional_object</span><span class="special"><</span><span class="identifier">B</span><span class="special">></span> <span class="special">></span> <span class="identifier">ptr_b</span> <span class="special">=</span> <span class="identifier">BOOST_STM_NEW</span><span class="special">(</span><span class="identifier">_</span><span class="special">,</span> <span class="identifier">D</span><span class="special">());</span>
+</pre>
+<p>
+ does not compile.
+ </p>
+<p>
+ TBoost.STM provides some cast functions that allows us to see a transactional_object<D>
+ as a transactional_object<B>
+ </p>
+<pre class="programlisting"><span class="identifier">transaction_object_ptr</span><span class="special"><</span><span class="identifier">transactional_object</span><span class="special"><</span><span class="identifier">B</span><span class="special">></span> <span class="special">></span> <span class="identifier">ptr_b</span> <span class="special">=</span> <span class="identifier">tx_static_cast</span><span class="special"><</span><span class="identifier">B</span><span class="special">>(</span><span class="identifier">BOOST_STM_NEW</span><span class="special">(</span><span class="identifier">_</span><span class="special">,</span> <span class="identifier">D</span><span class="special">()));</span>
+</pre>
+<p>
+ In addition TBoost.STM provides a smart pointer class tx_ptr
+ </p>
+<pre class="programlisting"><span class="identifier">tx_ptr</span><span class="special"><</span><span class="identifier">B</span><span class="special">></span> <span class="identifier">ptr_b</span> <span class="special">=</span> <span class="identifier">BOOST_STM_NEW</span><span class="special">(</span><span class="identifier">_</span><span class="special">,</span> <span class="identifier">D</span><span class="special">());</span>
+</pre>
+<p>
+ We know that this is not perfect , but this is the better we can do.
+ </p>
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="toward_boost_stm.users_guide.tutorial.can_non_transactional_objets_participate_in_a_transaction_"></a><a class="link" href="tutorial.html#toward_boost_stm.users_guide.tutorial.can_non_transactional_objets_participate_in_a_transaction_" title="Can non transactional objets participate in a transaction?">Can
+<a name="toward_boost_stm.users_guide.tutorial.can_non_transactional_objets_participate_in_a_transaction_"></a><a href="tutorial.html#toward_boost_stm.users_guide.tutorial.can_non_transactional_objets_participate_in_a_transaction_" title="Can
+ non transactional objets participate in a transaction?">Can
non transactional objets participate in a transaction?</a>
</h4></div></div></div>
<p>
- Non transactional objects are the objects that do not inherit from base_transaction_object.
+ Non transactional objects are the objects that do not inherit from <code class="computeroutput"><span class="identifier">base_transaction_object</span></code>. We need an object
+ inheriting from <code class="computeroutput"><span class="identifier">base_transaction_object</span></code>
+ to participate on a <code class="computeroutput"><span class="identifier">transaction</span></code>.
+ The best we can do is to associated a <code class="computeroutput"><span class="identifier">cache</span></code>
+ inheriting from <code class="computeroutput"><span class="identifier">base_transaction_object</span></code>
+ referencing the non transactional object. This association must be stablished
+ as far as a non transactional object is accesed. Smart pointers are useful
+ to implements this kind of access.
+ </p>
+<p>
+ Let me start with a simple and radical case. How can transactional and
+ non transactional share read/write access to an int?
+ </p>
+<pre class="programlisting"><span class="keyword">int</span> <span class="identifier">i</span><span class="special">;</span>
+
+<span class="keyword">void</span> <span class="identifier">tx</span><span class="special">()</span> <span class="special">{</span>
+ <span class="identifier">atomic</span><span class="special">(</span><span class="identifier">_</span><span class="special">)</span> <span class="special">{</span>
+ <span class="identifier">i</span><span class="special">=</span><span class="identifier">i</span><span class="special">+</span><span class="number">1</span><span class="special">;</span>
+ <span class="special">}</span> <span class="identifier">end_atom</span><span class="special">;</span>
+<span class="special">}</span>
+
+<span class="keyword">int</span> <span class="identifier">non_trans</span><span class="special">()</span> <span class="special">{</span>
+ <span class="keyword">int</span> <span class="identifier">times</span><span class="special">=</span><span class="number">0</span><span class="special">;</span>
+ <span class="keyword">while</span> <span class="special">(</span><span class="identifier">i</span><span class="special"><</span><span class="number">10</span><span class="special">)</span> <span class="special">{</span><span class="identifier">times</span><span class="special">++;</span> <span class="identifier">sleep</span><span class="special">(</span><span class="number">1</span><span class="special">);}</span>
+ <span class="keyword">return</span> <span class="identifier">times</span><span class="special">;</span>
+<span class="special">}</span>
+</pre>
+<p>
+ We need a way to transaform the interger <code class="computeroutput"><span class="identifier">i</span></code>
+ on a transactional object, so we can use it on the transaction. The idea
+ is to have a transactional <code class="computeroutput"><span class="identifier">cache</span></code>
+ of the non transactional object which will be used by the STM system.
+ </p>
+<p>
+ We can define non transactional smart pointers which will retrieve the
+ non transactional object from this cache and then work with these smart
+ pointers as usual.
+ </p>
+<pre class="programlisting"><span class="keyword">void</span> <span class="identifier">tx</span><span class="special">()</span> <span class="special">{</span>
+ <span class="identifier">atomic</span><span class="special">(</span><span class="identifier">t</span><span class="special">)</span> <span class="special">{</span>
+ <span class="identifier">t</span><span class="special">.</span><span class="identifier">add_tx_conflicting_lock</span><span class="special">(</span><span class="identifier">L1</span><span class="special">);</span>
+ <span class="identifier">non_tx</span><span class="special">::</span><span class="identifier">wr_ptr</span><span class="special"><</span><span class="keyword">int</span><span class="special">></span> <span class="identifier">tx_i</span><span class="special">(</span><span class="identifier">i</span><span class="special">);</span>
+ <span class="special">*</span><span class="identifier">tx_i</span><span class="special">=*</span><span class="identifier">tx_i</span><span class="special">+</span><span class="number">1</span><span class="special">;</span>
+ <span class="special">}</span> <span class="identifier">end_atom</span><span class="special">;</span>
+<span class="special">}</span>
+
+<span class="keyword">int</span> <span class="identifier">non_trans</span><span class="special">()</span> <span class="special">{</span>
+ <span class="identifier">transaction</span><span class="special">::</span><span class="identifier">scoped_lock</span><span class="special">(</span><span class="identifier">L1</span><span class="special">);</span>
+ <span class="keyword">int</span> <span class="identifier">times</span><span class="special">=</span><span class="number">0</span><span class="special">;</span>
+ <span class="keyword">while</span> <span class="special">(</span><span class="identifier">i</span><span class="special"><</span><span class="number">10</span><span class="special">)</span> <span class="special">{</span><span class="identifier">times</span><span class="special">++;</span> <span class="identifier">sleep</span><span class="special">(</span><span class="number">1</span><span class="special">);}</span>
+ <span class="keyword">return</span> <span class="identifier">times</span><span class="special">;</span>
+<span class="special">}</span>
+</pre>
+<p>
+ The cache will inherit from <code class="computeroutput"><span class="identifier">base_transaction_object</span></code>
+ and contain a reference to the non transactional object.
+ </p>
+<pre class="programlisting"><span class="keyword">namespace</span> <span class="identifier">non_tx</span> <span class="special">{</span> <span class="keyword">namespace</span> <span class="identifier">detail</span> <span class="special">{</span>
+
+<span class="keyword">template</span> <span class="special"><</span><span class="keyword">typename</span> <span class="identifier">T</span><span class="special">></span>
+<span class="keyword">class</span> <span class="identifier">cache</span> <span class="special">:</span> <span class="keyword">public</span> <span class="identifier">base_transaction_object</span> <span class="special">{</span>
+<span class="keyword">public</span><span class="special">:</span>
+ <span class="identifier">T</span><span class="special">*</span> <span class="keyword">const</span> <span class="identifier">value_</span><span class="special">;</span>
+<span class="special">...</span>
+<span class="special">};</span>
+<span class="special">}}</span>
+</pre>
+<p>
+ <code class="computeroutput"><span class="identifier">value_</span></code> is a <code class="computeroutput"><span class="keyword">const</span></code> pointer to the non transactional object
+ and must be initialized at construction time.
+ </p>
+<pre class="programlisting"><span class="identifier">cache</span><span class="special">(</span><span class="identifier">T</span><span class="special">&</span> <span class="identifier">ref</span><span class="special">)</span>
+ <span class="special">:</span> <span class="identifier">base_transaction_object</span><span class="special">()</span>
+ <span class="special">,</span> <span class="identifier">value_</span><span class="special">(&</span><span class="identifier">ref</span><span class="special">),</span> <span class="identifier">ptr_</span><span class="special">(</span><span class="number">0</span><span class="special">)</span> <span class="special">{}</span>
+
+<span class="identifier">cache</span><span class="special">(</span><span class="identifier">T</span><span class="special">*</span> <span class="identifier">ptr</span><span class="special">)</span>
+ <span class="special">:</span> <span class="identifier">base_transaction_object</span><span class="special">()</span>
+ <span class="special">,</span> <span class="identifier">value_</span><span class="special">(</span><span class="identifier">ptr</span><span class="special">),</span> <span class="identifier">ptr_</span><span class="special">(</span><span class="number">0</span><span class="special">)</span> <span class="special">{}</span>
+</pre>
+<p>
+ We need an extra pointer to point to the transaction specific <code class="computeroutput"><span class="identifier">T</span></code>.
+ </p>
+<pre class="programlisting"><span class="keyword">mutable</span> <span class="identifier">T</span><span class="special">*</span> <span class="identifier">ptr_</span><span class="special">;</span>
+</pre>
+<p>
+ This pointer will be initialized on the first time the cache is written
+ on a transaction by the <code class="computeroutput"><span class="identifier">clone</span></code>
+ function
+ </p>
+<pre class="programlisting"><span class="keyword">virtual</span> <span class="identifier">base_transaction_object</span><span class="special">*</span> <span class="identifier">clone</span><span class="special">()</span> <span class="keyword">const</span> <span class="special">{</span>
+ <span class="identifier">cache</span><span class="special">*</span> <span class="identifier">tmp</span> <span class="special">=</span> <span class="identifier">cache_clone</span><span class="special">(*</span><span class="keyword">this</span><span class="special">);</span>
+ <span class="keyword">if</span> <span class="special">(</span><span class="identifier">tmp</span><span class="special">-></span><span class="identifier">value_</span><span class="special">!=</span><span class="number">0</span><span class="special">)</span> <span class="special">{</span>
+ <span class="identifier">tmp</span><span class="special">-></span><span class="identifier">ptr_</span> <span class="special">=</span> <span class="keyword">new</span> <span class="identifier">T</span><span class="special">(*</span><span class="identifier">value_</span><span class="special">);</span>
+ <span class="special">}</span>
+ <span class="keyword">return</span> <span class="identifier">tmp</span><span class="special">;</span>
+<span class="special">}</span>
+</pre>
+<p>
+ This pointer <code class="computeroutput"><span class="identifier">ptr_</span></code> will
+ be deleted either on the destructor,
+ </p>
+<pre class="programlisting"><span class="special">~</span><span class="identifier">cache</span><span class="special">()</span> <span class="special">{</span>
+ <span class="keyword">delete</span> <span class="identifier">ptr_</span><span class="special">;</span>
+<span class="special">}</span>
+</pre>
+<p>
+ or while doing the <code class="computeroutput"><span class="identifier">copy_state</span></code>
+ function
+ </p>
+<pre class="programlisting"><span class="keyword">virtual</span> <span class="keyword">void</span> <span class="identifier">copy_state</span><span class="special">(</span><span class="identifier">base_transaction_object</span> <span class="keyword">const</span> <span class="special">*</span> <span class="keyword">const</span> <span class="identifier">rhs</span><span class="special">)</span> <span class="special">{</span>
+ <span class="keyword">if</span> <span class="special">(</span><span class="identifier">value_</span><span class="special">==</span><span class="number">0</span><span class="special">)</span> <span class="keyword">return</span><span class="special">;</span>
+ <span class="special">*</span><span class="identifier">value_</span><span class="special">=</span> <span class="special">*(</span><span class="keyword">static_cast</span><span class="special"><</span><span class="identifier">cache</span><span class="special"><</span><span class="identifier">T</span><span class="special">></span> <span class="keyword">const</span> <span class="special">*</span> <span class="keyword">const</span><span class="special">>(</span><span class="identifier">rhs</span><span class="special">)-></span><span class="identifier">ptr_</span><span class="special">);</span>
+ <span class="keyword">delete</span> <span class="identifier">ptr_</span><span class="special">;</span>
+ <span class="identifier">ptr_</span><span class="special">=</span><span class="number">0</span><span class="special">;</span>
+<span class="special">}</span>
+</pre>
+<p>
+ Note that the <code class="computeroutput"><span class="identifier">copy_state</span></code>
+ function copy the <code class="computeroutput"><span class="identifier">value_</span></code>
+ field from the pointee <code class="computeroutput"><span class="identifier">ptr_</span></code>.
+ </p>
+<p>
+ In order to access the specific <code class="computeroutput"><span class="identifier">T</span></code>
+ on a transaction we need to use the get function
+ </p>
+<pre class="programlisting"><span class="identifier">T</span><span class="special">*</span> <span class="identifier">get</span><span class="special">()</span> <span class="keyword">const</span> <span class="special">{</span>
+ <span class="keyword">if</span><span class="special">(</span><span class="identifier">ptr_</span><span class="special">!=</span><span class="number">0</span><span class="special">)</span> <span class="keyword">return</span> <span class="identifier">ptr_</span><span class="special">;</span>
+ <span class="keyword">else</span> <span class="keyword">return</span> <span class="identifier">value_</span><span class="special">;</span>
+<span class="special">}</span>
+</pre>
+<p>
+ Next follows how the non transactional write smart pointer looks like
+ </p>
+<pre class="programlisting"><span class="keyword">namespace</span> <span class="identifier">non_tx</span> <span class="special">{</span>
+
+<span class="keyword">template</span> <span class="special"><</span><span class="keyword">typename</span> <span class="identifier">T</span><span class="special">></span>
+<span class="keyword">class</span> <span class="identifier">wr_ptr</span> <span class="special">{</span>
+ <span class="keyword">typedef</span> <span class="identifier">wr_ptr</span><span class="special"><</span><span class="identifier">T</span><span class="special">></span> <span class="identifier">this_type</span><span class="special">;</span>
+<span class="keyword">public</span><span class="special">:</span>
+ <span class="keyword">mutable</span> <span class="identifier">transaction</span><span class="special">&</span> <span class="identifier">tx_</span><span class="special">;</span>
+ <span class="keyword">mutable</span> <span class="identifier">detail</span><span class="special">::</span><span class="identifier">cache</span><span class="special"><</span><span class="identifier">T</span><span class="special">>*</span> <span class="identifier">ptr_</span><span class="special">;</span>
+
+ <span class="identifier">wr_ptr</span><span class="special">(</span><span class="identifier">transaction</span> <span class="special">&</span><span class="identifier">t</span><span class="special">,</span> <span class="identifier">T</span><span class="special">*</span> <span class="identifier">ptr</span><span class="special">)</span> <span class="special">:</span> <span class="identifier">tx_</span><span class="special">(</span><span class="identifier">t</span><span class="special">),</span>
+ <span class="identifier">ptr_</span><span class="special">(</span><span class="identifier">t</span><span class="special">.</span><span class="identifier">write_ptr</span><span class="special">(</span><span class="identifier">detail</span><span class="special">::</span><span class="identifier">cache_map</span><span class="special">::</span><span class="identifier">get</span><span class="special">(</span><span class="identifier">ptr</span><span class="special">)))</span>
+ <span class="special">{}</span>
+
+ <span class="identifier">wr_ptr</span><span class="special">(</span><span class="identifier">transaction</span> <span class="special">&</span><span class="identifier">t</span><span class="special">,</span> <span class="identifier">T</span><span class="special">&</span> <span class="identifier">obj</span><span class="special">)</span> <span class="special">:</span> <span class="identifier">tx_</span><span class="special">(</span><span class="identifier">t</span><span class="special">),</span>
+ <span class="identifier">ptr_</span><span class="special">(</span><span class="identifier">t</span><span class="special">.</span><span class="identifier">write_ptr</span><span class="special">(</span><span class="identifier">detail</span><span class="special">::</span><span class="identifier">cache_map</span><span class="special">::</span><span class="identifier">get</span><span class="special">(&</span><span class="identifier">obj</span><span class="special">)))</span>
+ <span class="special">{}</span>
+
+
+ <span class="identifier">T</span><span class="special">*</span> <span class="identifier">get</span><span class="special">()</span> <span class="special">{</span>
+ <span class="keyword">if</span> <span class="special">(</span><span class="identifier">tx_</span><span class="special">.</span><span class="identifier">forced_to_abort</span><span class="special">())</span> <span class="special">{</span>
+ <span class="identifier">tx_</span><span class="special">.</span><span class="identifier">lock_and_abort</span><span class="special">();</span>
+ <span class="keyword">throw</span> <span class="identifier">aborted_transaction_exception</span><span class="special">(</span><span class="string">"aborting transaction"</span><span class="special">);</span>
+ <span class="special">}</span>
+ <span class="keyword">return</span> <span class="identifier">ptr_</span><span class="special">-></span><span class="identifier">get</span><span class="special">();</span>
+ <span class="special">}</span>
+
+ <span class="identifier">T</span><span class="special">&</span> <span class="keyword">operator</span><span class="special">*()</span> <span class="special">{</span> <span class="keyword">return</span> <span class="special">*</span><span class="identifier">get</span><span class="special">();</span> <span class="special">}</span>
+ <span class="identifier">T</span><span class="special">*</span> <span class="keyword">operator</span><span class="special">->()</span> <span class="special">{</span> <span class="keyword">return</span> <span class="identifier">get</span><span class="special">();</span> <span class="special">}</span>
+
+ <span class="keyword">typedef</span> <span class="identifier">detail</span><span class="special">::</span><span class="identifier">cache</span><span class="special"><</span><span class="identifier">T</span><span class="special">>*</span> <span class="identifier">this_type</span><span class="special">::*</span><span class="identifier">unspecified_bool_type</span><span class="special">;</span>
+
+ <span class="keyword">operator</span> <span class="identifier">unspecified_bool_type</span><span class="special">()</span> <span class="keyword">const</span> <span class="special">{</span>
+ <span class="keyword">return</span> <span class="identifier">ptr_</span> <span class="special">==</span> <span class="number">0</span><span class="special">?</span> <span class="number">0</span><span class="special">:</span> <span class="special">&</span><span class="identifier">this_type</span><span class="special">::</span><span class="identifier">ptr_</span><span class="special">;</span>
+ <span class="special">}</span>
+<span class="special">};</span>
+<span class="special">}</span>
+</pre>
+<p>
+ The <code class="computeroutput"><span class="identifier">cache_map</span></code> could be
+ defined as
+ </p>
+<pre class="programlisting"><span class="keyword">namespace</span> <span class="identifier">non_tx</span> <span class="special">{</span> <span class="keyword">namespace</span> <span class="identifier">detail</span> <span class="special">{</span>
+<span class="keyword">class</span> <span class="identifier">cache_map</span> <span class="special">{</span>
+ <span class="keyword">typedef</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">map</span><span class="special"><</span><span class="keyword">void</span><span class="special">*,</span> <span class="identifier">base_transaction_object</span><span class="special">*></span> <span class="identifier">map_type</span><span class="special">;</span>
+ <span class="keyword">static</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">map</span><span class="special"><</span><span class="keyword">void</span><span class="special">*,</span> <span class="identifier">base_transaction_object</span><span class="special">*></span> <span class="identifier">map_</span><span class="special">;</span>
+<span class="keyword">public</span><span class="special">:</span>
+ <span class="keyword">template</span> <span class="special"><</span><span class="keyword">typename</span> <span class="identifier">T</span><span class="special">></span>
+ <span class="keyword">static</span> <span class="identifier">cache</span><span class="special"><</span><span class="identifier">T</span><span class="special">>*</span> <span class="identifier">get</span><span class="special">(</span><span class="identifier">T</span><span class="special">*</span> <span class="identifier">ptr</span><span class="special">)</span> <span class="special">{</span>
+ <span class="identifier">map_type</span><span class="special">::</span><span class="identifier">iterator</span> <span class="identifier">it</span> <span class="special">=</span> <span class="identifier">map_</span><span class="special">.</span><span class="identifier">find</span><span class="special">(</span><span class="identifier">ptr</span><span class="special">);</span>
+ <span class="identifier">cache</span><span class="special"><</span><span class="identifier">T</span><span class="special">>*</span> <span class="identifier">res</span><span class="special">=</span><span class="number">0</span><span class="special">;</span>
+ <span class="keyword">if</span> <span class="special">(</span><span class="identifier">it</span> <span class="special">==</span> <span class="identifier">map_</span><span class="special">.</span><span class="identifier">end</span><span class="special">())</span> <span class="special">{</span>
+ <span class="identifier">res</span><span class="special">=</span> <span class="keyword">new</span> <span class="identifier">cache</span><span class="special"><</span><span class="identifier">T</span><span class="special">>(</span><span class="identifier">ptr</span><span class="special">);</span>
+ <span class="identifier">map_</span><span class="special">.</span><span class="identifier">insert</span><span class="special">(</span><span class="identifier">std</span><span class="special">::</span><span class="identifier">make_pair</span><span class="special">(</span><span class="identifier">ptr</span><span class="special">,</span> <span class="identifier">res</span><span class="special">));</span>
+ <span class="special">}</span> <span class="keyword">else</span> <span class="special">{</span>
+ <span class="identifier">res</span><span class="special">=</span><span class="keyword">static_cast</span><span class="special"><</span><span class="identifier">cache</span><span class="special"><</span><span class="identifier">T</span><span class="special">>*>(</span><span class="identifier">it</span><span class="special">-></span><span class="identifier">second</span><span class="special">);</span>
+ <span class="special">}</span>
+ <span class="keyword">return</span> <span class="identifier">res</span><span class="special">;</span>
+ <span class="special">}</span>
+ <span class="keyword">template</span> <span class="special"><</span><span class="keyword">typename</span> <span class="identifier">T</span><span class="special">></span>
+ <span class="keyword">static</span> <span class="identifier">cache</span><span class="special"><</span><span class="identifier">T</span><span class="special">>*</span> <span class="identifier">get</span><span class="special">(</span><span class="identifier">T</span> <span class="keyword">const</span><span class="special">*</span> <span class="identifier">ptr</span><span class="special">)</span> <span class="special">{</span>
+ <span class="identifier">map_type</span><span class="special">::</span><span class="identifier">iterator</span> <span class="identifier">it</span> <span class="special">=</span> <span class="identifier">map_</span><span class="special">.</span><span class="identifier">find</span><span class="special">(</span><span class="keyword">const_cast</span><span class="special"><</span><span class="identifier">T</span><span class="special">*>(</span><span class="identifier">ptr</span><span class="special">));</span>
+ <span class="identifier">cache</span><span class="special"><</span><span class="identifier">T</span><span class="special">>*</span> <span class="identifier">res</span><span class="special">=</span><span class="number">0</span><span class="special">;</span>
+ <span class="keyword">if</span> <span class="special">(</span><span class="identifier">it</span> <span class="special">==</span> <span class="identifier">map_</span><span class="special">.</span><span class="identifier">end</span><span class="special">())</span> <span class="special">{</span>
+ <span class="identifier">res</span><span class="special">=</span> <span class="keyword">new</span> <span class="identifier">cache</span><span class="special"><</span><span class="identifier">T</span><span class="special">>(</span><span class="keyword">const_cast</span><span class="special"><</span><span class="identifier">T</span><span class="special">*>(</span><span class="identifier">ptr</span><span class="special">));</span>
+ <span class="identifier">map_</span><span class="special">.</span><span class="identifier">insert</span><span class="special">(</span><span class="identifier">std</span><span class="special">::</span><span class="identifier">make_pair</span><span class="special">(</span><span class="keyword">const_cast</span><span class="special"><</span><span class="identifier">T</span><span class="special">*>(</span><span class="identifier">ptr</span><span class="special">),</span> <span class="identifier">res</span><span class="special">));</span>
+ <span class="special">}</span> <span class="keyword">else</span> <span class="special">{</span>
+ <span class="identifier">res</span><span class="special">=</span><span class="keyword">static_cast</span><span class="special"><</span><span class="identifier">cache</span><span class="special"><</span><span class="identifier">T</span><span class="special">>*>(</span><span class="identifier">it</span><span class="special">-></span><span class="identifier">second</span><span class="special">);</span>
+ <span class="special">}</span>
+ <span class="keyword">return</span> <span class="identifier">res</span><span class="special">;</span>
+ <span class="special">}</span>
+<span class="special">};</span>
+<span class="special">}}</span>
+</pre>
+<p>
+ We think that lock aware STM systems need to provide access to non transactional
+ objects, otherwise we don't see the interest of LATM systems.
</p>
</div>
<div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title">
-<a name="toward_boost_stm.users_guide.tutorial.lock_aware"></a><a class="link" href="tutorial.html#toward_boost_stm.users_guide.tutorial.lock_aware" title="Lock aware">Lock
+<a name="toward_boost_stm.users_guide.tutorial.lock_aware"></a><a href="tutorial.html#toward_boost_stm.users_guide.tutorial.lock_aware" title="Lock
+ aware">Lock
aware</a>
</h4></div></div></div></div>
</div>
Modified: sandbox/stm/branches/vbe/libs/stm/doc/tutorial.qbk
==============================================================================
--- sandbox/stm/branches/vbe/libs/stm/doc/tutorial.qbk (original)
+++ sandbox/stm/branches/vbe/libs/stm/doc/tutorial.qbk 2009-10-08 15:42:54 EDT (Thu, 08 Oct 2009)
@@ -190,13 +190,12 @@
The following subsection discusses how priority inversion is handled within __Boost_STM__ using dynamic priority assignment. Two solutions are presented for the different consistency models, one for validation and one for invalidation. Following the two examples which detail how to override contention management interfaces, a dynamically prioritized transaction is presented, demonstrating how transactions interact with the prior implementations. Priority inversion in transactional memory occurs when a lower priority transaction causes a higher priority transaction to abort. With STM lock-based (and non-blocking) systems, priority inversion does not happen on the same scale as that of direct lock-based solutions. The different cases of priority inversion between direct locking solutions and TM solutions are due to TM's natural avoidance of critical sections. However, priority inversion in TM can easily occur if, for example, a long running transaction is continually preempted by shorter running transactions
which always commit before the longer transaction.
-In order to prevent such priority inversion scenarios, two extensible contention manager (CM) virtual methods are provided to allow client-side implementations a way to handle different scenarios based on the consistency model currently in use. The first interface, abort_before_commit(), allows a user-defined contention manager mechanism to abort a transaction before it commits. Although __Boost_STM__ does not yet implement validation, once it becomes available, client-side validating algorithms which want to avoid priority inversion will need to override abort_before_commit() to iterate over in-flight transactions and abort the current in-process transaction if another in-flight transaction exists of higher priority. All in-flight transactions can be accessed by a call to in_flight_transactions() which returns the set of active transactions. As such, one could build an overridden abort_before_commit() which always caused lower priority committing transactions to abort in the event a higher priority transac
tion is currently in-flight. One possible implementation is shown below. For code simplicity, the following code has removed some static class accessors and namespaces.
-
+In order to prevent such priority inversion scenarios, two extensible contention manager (CM) virtual methods are provided to allow client-side implementations a way to handle different scenarios based on the consistency model currently in use. The first interface, abort_before_commit(), allows a user-defined contention manager mechanism to abort a transaction before it commits. Although __Boost_STM__ does not yet implement validation, once it becomes available, client-side validating algorithms which want to avoid priority inversion will need to override `abort_before_commit()` to iterate over in-flight transactions and abort the current in-process transaction if another in-flight transaction exists of higher priority. All in-flight transactions can be accessed by a call to `in_flight_transactions()` which returns the set of active transactions. As such, one could build an overridden `abort_before_commit()` which always caused lower priority committing transactions to abort in the event a higher priority t
ransaction is currently in-flight. One possible implementation is shown below. For code simplicity, the following code has removed some static class accessors and namespaces.
Priority Inversion for Validating Consistency.
class priority_cm :
- public core::base_contention_manager {
+ public boost::stm::base_contention_manager {
public:
// method invoked prior tx commit
bool abort_before_commit(transaction const &t) {
@@ -210,14 +209,14 @@
}
};
-While the above approach is necessary for a validating system, it is largely a poor way to perform priority inversion checking. Firstly, it has the side-effect of causing unnecessary aborts for transactions which do not necessarily conflict, but simply have differing priority levels. Secondly, it is slow in that all transactions must be walked through each time a transaction commits. However, as an ad hoc solution for a validating system, the above priority inversion mechanism may be as close to correct as is possible. This solution is useful for validation, but should never be used for invalidation. Instead a second and more natural approach for invalidating systems to prevent priority inversion is to override the permission_to_abort() interface. The permission_to_abort() interface can only be used when __Boost_STM__ is performing invalidation.
+While the above approach is necessary for a validating system, it is largely a poor way to perform priority inversion checking. Firstly, it has the side-effect of causing unnecessary aborts for transactions which do not necessarily conflict, but simply have differing priority levels. Secondly, it is slow in that all transactions must be walked through each time a transaction commits. However, as an ad hoc solution for a validating system, the above priority inversion mechanism may be as close to correct as is possible. This solution is useful for validation, but should never be used for invalidation. Instead a second and more natural approach for invalidating systems to prevent priority inversion is to override the `permission_to_abort()` interface. The `permission_to_abort()` interface can only be used when __Boost_STM__ is performing invalidation.
-The permission_to_abort() interface is called from __Boost_STM_s__ end_transaction() method when a committing transaction has found a second transaction it needs to abort for consistency. As such, the method takes two parameters, an lhs (lefthand side), the committing transaction, and an rhs (right-hand side), the transaction requested to be aborted. If permission is granted to abort the second transaction, the method returns true and the second transaction is aborted. If permission is not granted to abort the second transaction, the method returns false and upon returning the committing transaction aborts itself. All consistency checking for deferred updating is performed prior to any updating operation and thus memory is still in a completely legal uncommitted state until all consistency is performed. For direct updating aborts, the system simply follows its normal semantics of aborting the transaction by restoring global memory to its original state. Similar to the prior example, overriding the permissio
n_to_abort() method can be done in such a manner which prevents lower priority transaction from aborting a higher priority transaction as shown below:
+The `permission_to_abort()` interface is called from __Boost_STM_s__ `end_transaction()` method when a committing transaction has found a second transaction it needs to abort for consistency. As such, the method takes two parameters, an lhs (lefthand side), the committing transaction, and an rhs (right-hand side), the transaction requested to be aborted. If permission is granted to abort the second transaction, the method returns true and the second transaction is aborted. If permission is not granted to abort the second transaction, the method returns false and upon returning the committing transaction aborts itself. All consistency checking for deferred updating is performed prior to any updating operation and thus memory is still in a completely legal uncommitted state until all consistency is performed. For direct updating aborts, the system simply follows its normal semantics of aborting the transaction by restoring global memory to its original state. Similar to the prior example, overriding the `perm
ission_to_abort()` method can be done in such a manner which prevents lower priority transaction from aborting a higher priority transaction as shown below:
Priority Inversion for Invalidating Consistency.
class priority_cm :
- public core::base_contention_manager {
+ public boost::stm::base_contention_manager {
public:
// method invoked before lhs transaction
// aborts rhs transaction
@@ -227,9 +226,9 @@
}
};
-With priority inversion preventable for both validating and invalidating consistency modes, transactions now need some mechanism to control their priority. __Boost_STM__ allows for such control through the raise_priority() interface. By iteratively calling raise_priority(), preempted transactions can raise their priority at each preemption ensuring their eventual commit. The raise_priority() interface is implemented using a size_t type. Additionally, __Boost_STM__ supplies a set_priority() interface taking a size_t parameter allowing client code to set the priority directly.
+With priority inversion preventable for both validating and invalidating consistency modes, transactions now need some mechanism to control their priority. __Boost_STM__ allows for such control through the `raise_priority()` interface. By iteratively calling `raise_priority()`, preempted transactions can raise their priority at each preemption ensuring their eventual commit. The `raise_priority()` interface is implemented using a `size_t` type. Additionally, __Boost_STM__ supplies a `set_priority()` interface taking a `size_t` parameter allowing client code to set the priority directly.
-In order for raise_priority() to function correctly, the affected transaction must not be destroyed upon transactional abort. If the prioritized transaction is destroyed at each transactional abort, raise_priority() will only raise the transaction's priority by one each time. In order to demonstrate how raise_priority() can be used in practice, we use a wrapper transaction around the internal_insert()'s transaction. However, in this case the wrapper transaction is not destroyed upon successive iterations. The restart_transaction() interface must be called for transactions that are not destroyed after being aborted. This necessary step clears the state from the previously failed transactional run. As shown in the below code, the restart_transaction() is only called when an aborted exception is caught. This is because end_transaction() throws an exception when the transaction is aborted. Following this implementation paradigm, handling aborted transactions is relatively straightforward as all aborted transact
ions follow the same exception-based path.
+In order for `raise_priority()` to function correctly, the affected transaction must not be destroyed upon transactional abort. If the prioritized transaction is destroyed at each transactional abort, `raise_priority()` will only raise the transaction's priority by one each time. In order to demonstrate how `raise_priority()` can be used in practice, we use a wrapper transaction around the `internal_insert()`'s transaction. However, in this case the wrapper transaction is not destroyed upon successive iterations. The `restart_transaction()` interface must be called for transactions that are not destroyed after being aborted. This necessary step clears the state from the previously failed transactional run. As shown in the below code, the `restart_transaction()` is only called when an aborted exception is caught. This is because `end_transaction()` throws an exception when the transaction is aborted. Following this implementation paradigm, handling aborted transactions is relatively straightforward as all ab
orted transactions follow the same exception-based path.
The below example combines all of these aspects together into a dynamically prioritized composed transaction. The composition is slightly different than what has been shown previously - instead of using composition for wrapping two methods into a larger transaction, we use composition to override the internal transaction's implementation to improve the richness of its behavior, a relatively novel concept for composition.
@@ -255,7 +254,7 @@
__Boost_STM_s__ Internal Write-Write Abort Process.
-As the above priority assigned transaction demonstrates, the outer transaction has increasing priority while the inner transaction, the one within internal_insert(), does not. Yet, the inner transaction is not aborted due to the outer transaction's priority. This is handled internally via __Boost_STM_s__ abort process by two fundamental ideas.
+As the above priority assigned transaction demonstrates, the outer transaction has increasing priority while the inner transaction, the one within `internal_insert()`, does not. Yet, the inner transaction is not aborted due to the outer transaction's priority. This is handled internally via __Boost_STM_s__ abort process by two fundamental ideas.
# As previously explained, all transactions of the same thread share transactional memory, this allows the outer transaction to be seen as using the same memory as the inner transaction. Thus, when the inner transaction is flagged to be aborted, the outer transaction must also be flagged to be aborted as well, since it would have the same memory conflicts. However, when checking the outer transaction's priority, the contention manager's priority method would see the outer transaction as having higher priority than the committing transaction if it had already been aborted once and the committing transaction had not. The priority analysis of the outer transaction compared to the committing transaction would thereby force the committing transaction to abort instead of the outer transaction.
@@ -285,7 +284,7 @@
[heading Priority Inversion Allowed]
-From the above code examples, one may question why the default behavior implemented within __Boost_STM__ does not automatically integrate priority into transactions, as it could be integrated within restart_transaction(). First, each problem is different and integrating priority only into restart_transaction() would not cover all cases (e.g., when the outer transaction was terminated). Second, building an automatic priority inversion handling scheme would eliminate some of the natural optimizations granted from different updating policies. For example, deferred updating allows multiple writers of the same memory to execute simultaneously. This behavior enables deferred updating the ability to process the fastest completing transactions first. If a priority system was integrated directly into __Boost_STM__, this optimization would be lost. In addition, direct updating optimizes writes by writing directly to global memory. As such, direct updating suffers greater penalties for aborted transactions due to requ
ired restoration of global memory. In this case, more transactional aborts would occur if __Boost_STM__ built-in a default priority inversion handler. Considering these factors, as well as many others, __Boost_STM__ does not build transactional priority into its system. Instead, we leave this implementation up to client-side implementors, as they will have a better understanding of their problem domain and be able to more correctly implement the right contention manager for their specific needs.
+From the above code examples, one may question why the default behavior implemented within __Boost_STM__ does not automatically integrate priority into transactions, as it could be integrated within `restart_transaction()`. First, each problem is different and integrating priority only into `restart_transaction()` would not cover all cases (e.g., when the outer transaction was terminated). Second, building an automatic priority inversion handling scheme would eliminate some of the natural optimizations granted from different updating policies. For example, deferred updating allows multiple writers of the same memory to execute simultaneously. This behavior enables deferred updating the ability to process the fastest completing transactions first. If a priority system was integrated directly into __Boost_STM__, this optimization would be lost. In addition, direct updating optimizes writes by writing directly to global memory. As such, direct updating suffers greater penalties for aborted transactions due to
required restoration of global memory. In this case, more transactional aborts would occur if __Boost_STM__ built-in a default priority inversion handler. Considering these factors, as well as many others, __Boost_STM__ does not build transactional priority into its system. Instead, we leave this implementation up to client-side implementors, as they will have a better understanding of their problem domain and be able to more correctly implement the right contention manager for their specific needs.
[heading The Future of Parallel Programming]
@@ -295,7 +294,8 @@
[section Can a transactional object embeed another transactional object?]
-Let me show what happens when we emmend transactional objects:
+Let me show what happens when we embeed transactional objects:
+
class C : public transaction_object<C> {...};
class E : public transaction_object<E> {
@@ -303,9 +303,9 @@
int i;
};
-E e;
+ E e;
-When a thread T1 modifies e (and possibly the b part) on a transaction another thread T2 can modify e.c on another transaction. When the two transactional objects overlap the STM system is unable to detect this efficiently, having as consequence an inconsistency.
+Let be `T1` a thread that modifies `e` (and possibly the `b` part) on a transaction and `T2` another thread modifying `e.c` on another transaction. When the two transactional objects overlap the STM system is unable to detect this efficiently, having as consequence an inconsistency.
The following pseudo-code shows the
@@ -316,24 +316,74 @@
4 }
-When T2 commits on (3) e.c will be modified, but T1 will modify the complete E independent of the e.c modification doen by T2, overwriting the e.c with its old value. T1 will be coherent, but not T2. If we want to allow such a scheme, we have several possibilities
+When `T2` commits on (3) `e.c` will be modified, but `T1` will modify the complete `E` independent of the `e.c` modification done by `T2`, overwriting the `e.c` with its old value. `T1` will be coherent, but not `T2`. If we want to allow such a scheme, we have several possibilities
+
+* [*implicit]: take care of overlaping transactional objects, so we can detect when `T1` commits that an overlaping to `e.c` has been modified, so the transaction on `T1` is aborted and retried.
+
+ T1 T2
+ 1 atomic { atomic {
+ 2 t.w(e).i=0; t.w(e.c)=A;
+ 3 }
+ 4 }
+
+* [*explicit]: the developper of `T1` must notify the STM system that the transactional object `e` constains a transactional object `e.c`.
+
+ T1 T2
+ 1 atomic { atomic {
+ 3 t.w(e.c);
+ 2 t.w(e).i=0; t.w(e.c)=A;
+ 3 }
+ 4 }
+
+Note that in this example there is only one embedeed transactional object but in real examples the number can increase horizontaly, direct embeede relation, and verticaly, embeeded transactional objects can embeed themselves other transactional objects.
-* implicit: take care of overlaping transactional objects, so we can detect when T1 commits that an overlaping TO e.c has been modified, so the transaction on T1 is aborted and retried.
-* explicit: the developper of T1 must notify the STM system that the transactional object e constains a transactional object e.c
-* declarative: the developper of E would declare that it contains an emmbeed transactional object C at E::c, so the STM system will use this explicit information when an E is accesses using the STM interface.
+* [*declarative]: the developper of E would declare that it contains an emmbeed transactional object C at E::c, so the STM system will use this explicit information when an E is accesses using the STM interface.
-The implicit approach is the more transparent for the user but it is also the less efficient. It need to add a virtual function quering the size of the class, and to modify the conflic detection algorithm (maybe the write_list must be a write_set, ordered by the address)
+ BOOST_STM_EMBEEDS(E, C, E::c);
+
+The implicit approach is the more transparent for the user but it is also the less efficient. It needs to add a virtual function quering the size of the class, and to modify the conflic detection algorithm (the write_list coukd be a write_set, ordered by the address). In addition it is incompatible with the bloom filters optimization.
-The explit approach let the user with a lot of burden and risk of error when access to an E is done on a transaction. This needs to add the size and the algorithm which adds transactional object on the write_list (maybe the write_list must be a write_interval_set, ordered by the address).
+The explit approach let the user with a lot of burden and risk of error when access to an `E` is done on a transaction. This needs to add the size and the algorithm which adds transactional object on the write_list (maybe the write_list must be a write_interval_set, ordered by the address).
-The declarative concentrate on a single place, so the user will be not too concerned, and this open possible optimizations.
+The declarative concentrate on a single place, so the user will not be too concerned, and this open possible optimizations.
+Supose now that we are able to embeed transactional objects and that the `T1` not only opens for writing `e`, but also `e.c` either on the same block or on a nested block (or nested transaction). The STM will see both address to be written, and even if there should be no risk of incoherence the object e.c will be copied twice.
-Supose now that we are able to embeed transactional objects. and that the T1 not only opens for writing e, but also e.c either on the same block on on a block (or nested transaction). The STM will see both address to be written, and even if there should be no risk of incoherence the object e.c will be copied twice.
+The implicit approach could check that there are not overlaping transactional objects, as it contains the size of each transactional object.
+
+The explicit approach do not let us detect overlaping transactional objets until we store the size of a transactional object, but this can not be done if we use bloom filters.
+
+With the declarative approach, we can use
+
+If STM do not allows embeeded transactional objects, we force the user to use constant pointers to trasactional objects
+
+ class C : public transaction_object<C> {...};
+
+ class E : public transaction_object<E> {
+ C* const c;
+ native_trans<int>* const i;
+ E() : c(new C), i(new native_trans<int>) {}
+ ~E() { delete c; delete i; }
+
+ };
+
+ E e;
+
+Having the main draback of managing the ownership of the heap allocated transactional objects.
+
+ T1 T2
+ 1 atomic { atomic {
+ 2 *(e.i)=0; *(e.c)=A;
+ 3 }
+ 4 }
+
+The advantage of this design is that now both threads do not conflic as the transactional object `e` is not really modified.
+
+We think that __Boost_STM__ needs to manage with embeeded transactional objects in a transparent way, and let the user to use pointers when he/she consider it more adapted to their problem solution.
[endsect]
-[section Returning values from a fucntion]
+[section Returning values from a function]
[heading Returning from outside the transaction context]
@@ -416,7 +466,7 @@
inline TO* operator->() const { return get(); }
};
-Let declare a pointer to B
+Let declare a pointer to `B`
transaction_object_ptr<B> ptr_b;
@@ -431,39 +481,240 @@
[section Polymorphic]
-How the user can defien a transactional class D inheriting from a transactional class B
+How the user can defien a transactional class `D` inheriting from a transactional class `B`
-[heading:mixin Using the mixin transaction_object<>]
+[heading Using the mixin transaction_object<>]
-Let B the base class
+Let `B` the base class
class B : public transaction_object<B> {
public:
void virtaul fct();
};
-The derived class must declare D as follows:
+The derived class must declare `D` as follows:
class D : public transaction_object<D,B> {
...
};
-How a variable pointing to B must be declared. The fact that B is a transactional object do not means that a pointer to it is one.
+How a variable pointing to `B` must be declared. The fact that `B` is a transactional object do not means that a pointer to it is one.
- pointer<B> ptr_b = 0
+ transaction_object_ptr<B> ptr_b = 0
-How can we assign a pointer to D?
+How can we assign a pointer to `D`?
write_ptr<B*> tx_ptr_b_ptr(_,ptr_b);
- *ptr_b = BOOST_STM_NEW(_, D())
+ *ptr_b = BOOST_STM_NEW(_, D());
+
+[heading Using the wrapper transactional_object<>]
+
+Wrapping does not works well with inheritance.
+
+Given a class D inheriting from B
+
+ class B {
+ ...
+ };
+
+ class D: public B {
+ ...
+ };
+
+The C++ type system do not ensures that transactional_object<D> inherits from transactional_object<B>. That is,
+
+ transaction_object_ptr<transactional_object<B> > ptr_b = BOOST_STM_NEW(_, D());
+
+does not compile.
+
+__Boost_STM__ provides some cast functions that allows us to see a transactional_object<D> as a transactional_object<B>
+
+ transaction_object_ptr<transactional_object<B> > ptr_b = tx_static_cast<B>(BOOST_STM_NEW(_, D()));
+
+In addition __Boost_STM__ provides a smart pointer class tx_ptr
+
+ tx_ptr<B> ptr_b = BOOST_STM_NEW(_, D());
+
+We know that this is not perfect , but this is the better we can do.
+
-[heading::wrapper Using the wrapper transactional_object<>]
[endsect]
[section Can non transactional objets participate in a transaction?]
-Non transactional objects are the objects that do not inherit from base_transaction_object.
+Non transactional objects are the objects that do not inherit from `base_transaction_object`. We need an object inheriting from `base_transaction_object` to participate on a `transaction`. The best we can do is to associated a `cache` inheriting from `base_transaction_object` referencing the non transactional object. This association must be stablished as far as a non transactional object is accesed. Smart pointers are useful to implements this kind of access.
+
+Let me start with a simple and radical case. How can transactional and non transactional share read/write access to an int?
+
+ int i;
+
+ void tx() {
+ atomic(_) {
+ i=i+1;
+ } end_atom;
+ }
+
+ int non_trans() {
+ int times=0;
+ while (i<10) {times++; sleep(1);}
+ return times;
+ }
+
+We need a way to transaform the interger `i` on a transactional object, so we can use it on the transaction. The idea is to have a transactional `cache` of the non transactional object which will be used by the STM system.
+
+We can define non transactional smart pointers which will retrieve the non transactional object from this cache and then work with these smart pointers as usual.
+
+ void tx() {
+ atomic(t) {
+ t.add_tx_conflicting_lock(L1);
+ non_tx::wr_ptr<int> tx_i(i);
+ *tx_i=*tx_i+1;
+ } end_atom;
+ }
+
+ int non_trans() {
+ transaction::scoped_lock(L1);
+ int times=0;
+ while (i<10) {times++; sleep(1);}
+ return times;
+ }
+
+The cache will inherit from `base_transaction_object` and contain a reference to the non transactional object.
+
+ namespace non_tx { namespace detail {
+
+ template <typename T>
+ class cache : public base_transaction_object {
+ public:
+ T* const value_;
+ ...
+ };
+ }}
+
+
+`value_` is a `const` pointer to the non transactional object and must be initialized at construction time.
+
+ cache(T& ref)
+ : base_transaction_object()
+ , value_(&ref), ptr_(0) {}
+
+ cache(T* ptr)
+ : base_transaction_object()
+ , value_(ptr), ptr_(0) {}
+
+We need an extra pointer to point to the transaction specific `T`.
+
+ mutable T* ptr_;
+
+This pointer will be initialized on the first time the cache is written on a transaction by the `clone` function
+
+ virtual base_transaction_object* clone() const {
+ cache* tmp = cache_clone(*this);
+ if (tmp->value_!=0) {
+ tmp->ptr_ = new T(*value_);
+ }
+ return tmp;
+ }
+
+This pointer `ptr_` will be deleted either on the destructor,
+
+ ~cache() {
+ delete ptr_;
+ }
+
+or while doing the `copy_state` function
+
+ virtual void copy_state(base_transaction_object const * const rhs) {
+ if (value_==0) return;
+ *value_= *(static_cast<cache<T> const * const>(rhs)->ptr_);
+ delete ptr_;
+ ptr_=0;
+ }
+
+Note that the `copy_state` function copy the `value_` field from the pointee `ptr_`.
+
+In order to access the specific `T` on a transaction we need to use the get function
+
+ T* get() const {
+ if(ptr_!=0) return ptr_;
+ else return value_;
+ }
+
+Next follows how the non transactional write smart pointer looks like
+
+ namespace non_tx {
+
+ template <typename T>
+ class wr_ptr {
+ typedef wr_ptr<T> this_type;
+ public:
+ mutable transaction& tx_;
+ mutable detail::cache<T>* ptr_;
+
+ wr_ptr(transaction &t, T* ptr) : tx_(t),
+ ptr_(t.write_ptr(detail::cache_map::get(ptr)))
+ {}
+
+ wr_ptr(transaction &t, T& obj) : tx_(t),
+ ptr_(t.write_ptr(detail::cache_map::get(&obj)))
+ {}
+
+
+ T* get() {
+ if (tx_.forced_to_abort()) {
+ tx_.lock_and_abort();
+ throw aborted_transaction_exception("aborting transaction");
+ }
+ return ptr_->get();
+ }
+
+ T& operator*() { return *get(); }
+ T* operator->() { return get(); }
+
+ typedef detail::cache<T>* this_type::*unspecified_bool_type;
+
+ operator unspecified_bool_type() const {
+ return ptr_ == 0? 0: &this_type::ptr_;
+ }
+ };
+ }
+
+The `cache_map` could be defined as
+
+ namespace non_tx { namespace detail {
+ class cache_map {
+ typedef std::map<void*, base_transaction_object*> map_type;
+ static std::map<void*, base_transaction_object*> map_;
+ public:
+ template <typename T>
+ static cache<T>* get(T* ptr) {
+ map_type::iterator it = map_.find(ptr);
+ cache<T>* res=0;
+ if (it == map_.end()) {
+ res= new cache<T>(ptr);
+ map_.insert(std::make_pair(ptr, res));
+ } else {
+ res=static_cast<cache<T>*>(it->second);
+ }
+ return res;
+ }
+ template <typename T>
+ static cache<T>* get(T const* ptr) {
+ map_type::iterator it = map_.find(const_cast<T*>(ptr));
+ cache<T>* res=0;
+ if (it == map_.end()) {
+ res= new cache<T>(const_cast<T*>(ptr));
+ map_.insert(std::make_pair(const_cast<T*>(ptr), res));
+ } else {
+ res=static_cast<cache<T>*>(it->second);
+ }
+ return res;
+ }
+ };
+ }}
+
+We think that lock aware STM systems need to provide access to non transactional objects, otherwise we don't see the interest of LATM systems.
[endsect]
Boost-Commit list run by bdawes at acm.org, david.abrahams at rcn.com, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk