[asterisk-commits] dlee: branch dlee/performance r399868 - /team/dlee/performance/include/asterisk/

[SVN commits to the Asterisk project]

Author: dlee
Date: Wed Sep 25 17:00:04 2013
New Revision: 399868

URL: http://svnview.digium.com/svn/asterisk?view=rev&rev=399868
Log:
Document life cycle for route data pointers

Modified:
    team/dlee/performance/include/asterisk/stasis_message_router.h

Modified: team/dlee/performance/include/asterisk/stasis_message_router.h
URL: http://svnview.digium.com/svn/asterisk/team/dlee/performance/include/asterisk/stasis_message_router.h?view=diff&rev=399868&r1=399867&r2=399868
==============================================================================
--- team/dlee/performance/include/asterisk/stasis_message_router.h (original)
+++ team/dlee/performance/include/asterisk/stasis_message_router.h Wed Sep 25 17:00:04 2013
@@ -144,6 +144,11 @@
 /*!
  * \brief Remove a route from a message router.
  *
+ * If a route is removed from another thread, there is no notification that
+ * all messages using this route have been processed. This typically means that
+ * the associated \c data pointer for this route must be kept until the
+ * route itself is disposed of.
+ *
  * \param router Router to remove the route from.
  * \param message_type Type of message to route.
  *
@@ -154,6 +159,11 @@
 
 /*!
  * \brief Remove a cache route from a message router.
+ *
+ * If a route is removed from another thread, there is no notification that
+ * all messages using this route have been processed. This typically means that
+ * the associated \c data pointer for this route must be kept until the
+ * route itself is disposed of.
  *
  * \param router Router to remove the route from.
  * \param message_type Type of message to route.