Added a "client data" void* to the poll API so that an app

can associate application context with each file descriptor
(e.g., map each descriptor to the filter that should process
that descriptor once it's signalled)


git-svn-id: http://svn.apache.org/repos/asf/apr/apr/trunk@63772 13f79535-47bb-0310-9956-ffa450edef68

1 files changed, 4 insertions, 0 deletions

diff --git a/include/apr_poll.h b/include/apr_poll.h
index 7320d57e7..5ddde025b 100644
--- a/include/apr_poll.h
+++ b/include/apr_poll.h
@@ -111,6 +111,7 @@ struct apr_pollfd_t {
     apr_int16_t reqevents;
     apr_int16_t rtnevents;
     apr_descriptor desc;
+    void *client_data; /* allows app to associate context with a descriptor */
 };
 
 /**
@@ -249,6 +250,9 @@ APR_DECLARE(apr_status_t) apr_pollset_destroy(apr_pollset_t *pollset);
  * Add a socket or file descriptor to a pollset
  * @param pollset The pollset to which to add the descriptor
  * @param descriptor The descriptor to add
+ * @param 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().
  */
 APR_DECLARE(apr_status_t) apr_pollset_add(apr_pollset_t *pollset,
                                           const apr_pollfd_t *descriptor);