Boost logo

Boost-Commit :

Subject: [Boost-commit] svn:boost r86464 - in trunk: boost/asio libs/asio/doc
From: chris_at_[hidden]
Date: 2013-10-26 18:39:23


Author: chris_kohlhoff
Date: 2013-10-26 18:39:23 EDT (Sat, 26 Oct 2013)
New Revision: 86464
URL: http://svn.boost.org/trac/boost/changeset/86464

Log:
Add a note to clarify that concurrent invocation is not guaranteed for handlers in different strands.

Text files modified:
   trunk/boost/asio/strand.hpp | 3 +++
   trunk/libs/asio/doc/reference.qbk | 10 ++++++++++
   2 files changed, 13 insertions(+), 0 deletions(-)

Modified: trunk/boost/asio/strand.hpp
==============================================================================
--- trunk/boost/asio/strand.hpp Sat Oct 26 18:35:32 2013 (r86463)
+++ trunk/boost/asio/strand.hpp 2013-10-26 18:39:23 EDT (Sat, 26 Oct 2013) (r86464)
@@ -73,6 +73,9 @@
  * happens-before the other. Therefore none of the above conditions are met and
  * no ordering guarantee is made.
  *
+ * @note The implementation makes no guarantee that handlers posted or
+ * dispatched through different @c strand objects will be invoked concurrently.
+ *
  * @par Thread Safety
  * @e Distinct @e objects: Safe._at_n
  * @e Shared @e objects: Safe.

Modified: trunk/libs/asio/doc/reference.qbk
==============================================================================
--- trunk/libs/asio/doc/reference.qbk Sat Oct 26 18:35:32 2013 (r86463)
+++ trunk/libs/asio/doc/reference.qbk 2013-10-26 18:39:23 EDT (Sat, 26 Oct 2013) (r86464)
@@ -61339,6 +61339,11 @@
 the completion of the first async operation will perform `s.dispatch(a)`, and the second will perform `s.dispatch(b)`, but the order in which those are performed is unspecified. That is, you cannot state whether one happens-before the other. Therefore none of the above conditions are met and no ordering guarantee is made.
 
 
+[heading Remarks]
+
+The implementation makes no guarantee that handlers posted or dispatched through different `strand` objects will be invoked concurrently.
+
+
 [heading Thread Safety]
   
 ['Distinct] ['objects:] Safe.
@@ -93970,6 +93975,11 @@
 the completion of the first async operation will perform `s.dispatch(a)`, and the second will perform `s.dispatch(b)`, but the order in which those are performed is unspecified. That is, you cannot state whether one happens-before the other. Therefore none of the above conditions are met and no ordering guarantee is made.
 
 
+[heading Remarks]
+
+The implementation makes no guarantee that handlers posted or dispatched through different `strand` objects will be invoked concurrently.
+
+
 [heading Thread Safety]
   
 ['Distinct] ['objects:] Safe.


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