apr-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From pque...@apache.org
Subject svn commit: r232554 - /apr/apr/branches/1.2.x/include/apr_poll.h
Date Sun, 14 Aug 2005 00:44:18 GMT
Author: pquerna
Date: Sat Aug 13 17:44:18 2005
New Revision: 232554

URL: http://svn.apache.org/viewcvs?rev=232554&view=rev
Log:
Merge documentation update from trunk's r224442

Modified:
    apr/apr/branches/1.2.x/include/apr_poll.h

Modified: apr/apr/branches/1.2.x/include/apr_poll.h
URL: http://svn.apache.org/viewcvs/apr/apr/branches/1.2.x/include/apr_poll.h?rev=232554&r1=232553&r2=232554&view=diff
==============================================================================
--- apr/apr/branches/1.2.x/include/apr_poll.h (original)
+++ apr/apr/branches/1.2.x/include/apr_poll.h Sat Aug 13 17:44:18 2005
@@ -123,6 +123,15 @@
  * @remark If you set client_data in the descriptor, that value
  *         will be returned in the client_data field whenever this
  *         descriptor is signalled in apr_pollset_poll().
+ * @remark If the pollset has been created with APR_POLLSET_THREADSAFE
+ *         and thread T1 is blocked in a call to apr_pollset_poll() for
+ *         this same pollset that is being modified via apr_pollset_add()
+ *         in thread T2, the currently executing apr_pollset_poll() call in
+ *         T1 will either: (1) automatically include the newly added descriptor
+ *         in the set of descriptors it is watching or (2) return immediately
+ *         with APR_EINTR.  Option (1) is recommended, but option (2) is
+ *         allowed for implementations where option (1) is impossible
+ *         or impractical.
  */
 APR_DECLARE(apr_status_t) apr_pollset_add(apr_pollset_t *pollset,
                                           const apr_pollfd_t *descriptor);
@@ -131,6 +140,15 @@
  * Remove a descriptor from a pollset
  * @param pollset The pollset from which to remove the descriptor
  * @param descriptor The descriptor to remove
+ * @remark If the pollset has been created with APR_POLLSET_THREADSAFE
+ *         and thread T1 is blocked in a call to apr_pollset_poll() for
+ *         this same pollset that is being modified via apr_pollset_remove()
+ *         in thread T2, the currently executing apr_pollset_poll() call in
+ *         T1 will either: (1) automatically exclude the newly added descriptor
+ *         in the set of descriptors it is watching or (2) return immediately
+ *         with APR_EINTR.  Option (1) is recommended, but option (2) is
+ *         allowed for implementations where option (1) is impossible
+ *         or impractical.
  */
 APR_DECLARE(apr_status_t) apr_pollset_remove(apr_pollset_t *pollset,
                                              const apr_pollfd_t *descriptor);



Mime
View raw message