Apache Portable Runtime: apr_perms

00001 /* Licensed to the Apache Software Foundation (ASF) under one or more
 00002  * contributor license agreements.  See the NOTICE file distributed with
 00003  * this work for additional information regarding copyright ownership.
@@ -75,223 +81,298 @@
 00057 #define APR_POLLSET_THREADSAFE 0x001 /**< Adding or Removing a Descriptor is thread safe */
 00058 #define APR_POLLSET_NOCOPY     0x002 /**< Descriptors passed to apr_pollset_create() are not copied */
 00059 #define APR_POLLSET_WAKEABLE   0x004 /**< Pollset poll operation is interruptable */
-00060 
-00061 /** Used in apr_pollfd_t to determine what the apr_descriptor is */
-00062 typedef enum { 
-00063     APR_NO_DESC,                /**< nothing here */
-00064     APR_POLL_SOCKET,            /**< descriptor refers to a socket */
-00065     APR_POLL_FILE,              /**< descriptor refers to a file */
-00066     APR_POLL_LASTDESC           /**< @deprecated descriptor is the last one in the list */
-00067 } apr_datatype_e ;
-00068 
-00069 /** Union of either an APR file or socket. */
-00070 typedef union {
-00071     apr_file_t *f;              /**< file */
-00072     apr_socket_t *s;            /**< socket */
-00073 } apr_descriptor;
-00074 
-00075 /** @see apr_pollfd_t */
-00076 typedef struct apr_pollfd_t apr_pollfd_t;
-00077 
-00078 /** Poll descriptor set. */
-00079 struct apr_pollfd_t {
-00080     apr_pool_t *p;              /**< associated pool */
-00081     apr_datatype_e desc_type;   /**< descriptor type */
-00082     apr_int16_t reqevents;      /**< requested events */
-00083     apr_int16_t rtnevents;      /**< returned events */
-00084     apr_descriptor desc;        /**< @see apr_descriptor */
-00085     void *client_data;          /**< allows app to associate context */
-00086 };
-00087 
-00088 
-00089 /* General-purpose poll API for arbitrarily large numbers of
-00090  * file descriptors
-00091  */
-00092 
-00093 /** Opaque structure used for pollset API */
-00094 typedef struct apr_pollset_t apr_pollset_t;
-00095 
-00096 /**
-00097  * Setup a pollset object
-00098  * @param pollset  The pointer in which to return the newly created object 
-00099  * @param size The maximum number of descriptors that this pollset can hold
-00100  * @param p The pool from which to allocate the pollset
-00101  * @param flags Optional flags to modify the operation of the pollset.
-00102  *
-00103  * @remark If flags equals APR_POLLSET_THREADSAFE, then a pollset is
-00104  *         created on which it is safe to make concurrent calls to
-00105  *         apr_pollset_add(), apr_pollset_remove() and apr_pollset_poll()
-00106  *         from separate threads.  This feature is only supported on some
-00107  *         platforms; the apr_pollset_create() call will fail with
-00108  *         APR_ENOTIMPL on platforms where it is not supported.
-00109  * @remark If flags contain APR_POLLSET_WAKEABLE, then a pollset is
-00110  *         created with additional internal pipe object used for
-00111  *         apr_pollset_wakeup() call. The actual size of pollset is
-00112  *         in that case size + 1. This feature is only supported on some
-00113  *         platforms; the apr_pollset_create() call will fail with
-00114  *         APR_ENOTIMPL on platforms where it is not supported.
-00115  */
-00116 APR_DECLARE(apr_status_t) apr_pollset_create(apr_pollset_t **pollset,
-00117                                              apr_uint32_t size,
-00118                                              apr_pool_t *p,
-00119                                              apr_uint32_t flags);
-00120 
-00121 /**
-00122  * Destroy a pollset object
-00123  * @param pollset The pollset to destroy
-00124  */
-00125 APR_DECLARE(apr_status_t) apr_pollset_destroy(apr_pollset_t *pollset);
-00126 
-00127 /**
-00128  * Add a socket or file descriptor to a pollset
-00129  * @param pollset The pollset to which to add the descriptor
-00130  * @param descriptor The descriptor to add
-00131  * @remark If you set client_data in the descriptor, that value
-00132  *         will be returned in the client_data field whenever this
-00133  *         descriptor is signalled in apr_pollset_poll().
-00134  * @remark If the pollset has been created with APR_POLLSET_THREADSAFE
-00135  *         and thread T1 is blocked in a call to apr_pollset_poll() for
-00136  *         this same pollset that is being modified via apr_pollset_add()
-00137  *         in thread T2, the currently executing apr_pollset_poll() call in
-00138  *         T1 will either: (1) automatically include the newly added descriptor
-00139  *         in the set of descriptors it is watching or (2) return immediately
-00140  *         with APR_EINTR.  Option (1) is recommended, but option (2) is
-00141  *         allowed for implementations where option (1) is impossible
-00142  *         or impractical.
-00143  */
-00144 APR_DECLARE(apr_status_t) apr_pollset_add(apr_pollset_t *pollset,
-00145                                           const apr_pollfd_t *descriptor);
-00146 
-00147 /**
-00148  * Remove a descriptor from a pollset
-00149  * @param pollset The pollset from which to remove the descriptor
-00150  * @param descriptor The descriptor to remove
-00151  * @remark If the pollset has been created with APR_POLLSET_THREADSAFE
-00152  *         and thread T1 is blocked in a call to apr_pollset_poll() for
-00153  *         this same pollset that is being modified via apr_pollset_remove()
-00154  *         in thread T2, the currently executing apr_pollset_poll() call in
-00155  *         T1 will either: (1) automatically exclude the newly added descriptor
-00156  *         in the set of descriptors it is watching or (2) return immediately
-00157  *         with APR_EINTR.  Option (1) is recommended, but option (2) is
-00158  *         allowed for implementations where option (1) is impossible
-00159  *         or impractical.
-00160  */
-00161 APR_DECLARE(apr_status_t) apr_pollset_remove(apr_pollset_t *pollset,
-00162                                              const apr_pollfd_t *descriptor);
-00163 
-00164 /**
-00165  * Block for activity on the descriptor(s) in a pollset
-00166  * @param pollset The pollset to use
-00167  * @param timeout Timeout in microseconds
-00168  * @param num Number of signalled descriptors (output parameter)
-00169  * @param descriptors Array of signalled descriptors (output parameter)
-00170  * @remark If the pollset has been created with APR_POLLSET_WAKEABLE
-00171  *         and the wakeup has been called while waiting for activity
-00172  *         return value is APR_EINTR in case there was no signaled
-00173  *         descriptors at the time of wakeup call.
-00174  */
-00175 APR_DECLARE(apr_status_t) apr_pollset_poll(apr_pollset_t *pollset,
-00176                                            apr_interval_time_t timeout,
-00177                                            apr_int32_t *num,
-00178                                            const apr_pollfd_t **descriptors);
-00179 
-00180 /**
-00181  * Interrupt the blocked apr_pollset_poll call.
-00182  * @param pollset The pollset to use
-00183  * @remark If the pollset was not created with APR_POLLSET_WAKEABLE the
-00184  *         return value is APR_EINIT.
-00185  */
-00186 APR_DECLARE(apr_status_t) apr_pollset_wakeup(apr_pollset_t *pollset);
-00187 
-00188 /**
-00189  * Poll the descriptors in the poll structure
-00190  * @param aprset The poll structure we will be using. 
-00191  * @param numsock The number of descriptors we are polling
-00192  * @param nsds The number of descriptors signalled (output parameter)
-00193  * @param timeout The amount of time in microseconds to wait.  This is 
-00194  *                a maximum, not a minimum.  If a descriptor is signalled, we 
-00195  *                will wake up before this time.  A negative number means 
-00196  *                wait until a descriptor is signalled.
-00197  * @remark The number of descriptors signalled is returned in the third argument. 
-00198  *         This is a blocking call, and it will not return until either a 
-00199  *         descriptor has been signalled, or the timeout has expired. 
-00200  * @remark The rtnevents field in the apr_pollfd_t array will only be filled-
-00201  *         in if the return value is APR_SUCCESS.
-00202  */
-00203 APR_DECLARE(apr_status_t) apr_poll(apr_pollfd_t *aprset, apr_int32_t numsock,
-00204                                    apr_int32_t *nsds, 
-00205                                    apr_interval_time_t timeout);
-00206 
-00207 /** Opaque structure used for pollset API */
-00208 typedef struct apr_pollcb_t apr_pollcb_t;
-00209 
-00210 /**
-00211  * Setup a pollcb object
-00212  * @param pollcb  The pointer in which to return the newly created object 
-00213  * @param size The maximum number of descriptors that a single _poll can return.
-00214  * @param p The pool from which to allocate the pollcb
-00215  * @param flags Optional flags to modify the operation of the pollcb.
-00216  *
-00217  * @remark Pollcb is only supported on some platforms; the apr_pollcb_create()
-00218  * call will fail with APR_ENOTIMPL on platforms where it is not supported.
-00219  */
-00220 APR_DECLARE(apr_status_t) apr_pollcb_create(apr_pollcb_t **pollcb,
-00221                                             apr_uint32_t size,
-00222                                             apr_pool_t *pool,
-00223                                             apr_uint32_t flags);
-00224 
-00225 /**
-00226  * Add a socket or file descriptor to a pollcb
-00227  * @param pollcb The pollcb to which to add the descriptor
-00228  * @param descriptor The descriptor to add
-00229  * @remark If you set client_data in the descriptor, that value
-00230  *         will be returned in the client_data field whenever this
-00231  *         descriptor is signalled in apr_pollcb_poll().
-00232  * @remark Unlike the apr_pollset API, the descriptor is not copied, and users 
-00233  *         must retain the memory used by descriptor, as the same pointer will be 
-00234  *         returned to them from apr_pollcb_poll.
-00235  */
-00236 APR_DECLARE(apr_status_t) apr_pollcb_add(apr_pollcb_t *pollcb,
-00237                                          apr_pollfd_t *descriptor);
-00238 /**
-00239  * Remove a descriptor from a pollcb
-00240  * @param pollcb The pollcb from which to remove the descriptor
-00241  * @param descriptor The descriptor to remove
-00242  */
-00243 APR_DECLARE(apr_status_t) apr_pollcb_remove(apr_pollcb_t *pollcb,
-00244                                             apr_pollfd_t *descriptor);
-00245 
-00246 /** Function prototype for pollcb handlers 
-00247  * @param baton Opaque baton passed into apr_pollcb_poll
-00248  * @param descriptor Contains the notification for an active descriptor, 
-00249  *                   the rtnevents member contains what events were triggered
-00250  *                   for this descriptor.
-00251  */
-00252 typedef apr_status_t (*apr_pollcb_cb_t)(void *baton, apr_pollfd_t *descriptor);
-00253 
-00254 /**
-00255  * Block for activity on the descriptor(s) in a pollcb
-00256  * @param pollcb The pollcb to use
-00257  * @param timeout Timeout in microseconds
-00258  * @param func Callback function to call for each active socket
-00259  * @param baton Opaque baton passed to the callback function.
-00260  */
-00261 APR_DECLARE(apr_status_t) apr_pollcb_poll(apr_pollcb_t *pollcb,
-00262                                           apr_interval_time_t timeout,
-00263                                           apr_pollcb_cb_t func,
-00264                                           void *baton); 
-00265 
-00266 /** @} */
-00267 
-00268 #ifdef __cplusplus
-00269 }
-00270 #endif
-00271 
-00272 #endif  /* ! APR_POLL_H */
-00273 
+00060 #define APR_POLLSET_NODEFAULT  0x010 /**< Do not try default method if non default fails */
+00061 
+00062 /**
+00063  * Pollset Methods
+00064  */
+00065 typedef enum {
+00066     APR_POLLSET_DEFAULT,        /**< Platform default poll method */
+00067     APR_POLLSET_SELECT,         /**< Poll uses select method */
+00068     APR_POLLSET_KQUEUE,
+00069     APR_POLLSET_PORT,
+00070     APR_POLLSET_EPOLL,
+00071     APR_POLLSET_POLL
+00072 } apr_pollset_method_e;
+00073 
+00074 /** Used in apr_pollfd_t to determine what the apr_descriptor is */
+00075 typedef enum { 
+00076     APR_NO_DESC,                /**< nothing here */
+00077     APR_POLL_SOCKET,            /**< descriptor refers to a socket */
+00078     APR_POLL_FILE,              /**< descriptor refers to a file */
+00079     APR_POLL_LASTDESC           /**< @deprecated descriptor is the last one in the list */
+00080 } apr_datatype_e ;
+00081 
+00082 /** Union of either an APR file or socket. */
+00083 typedef union {
+00084     apr_file_t *f;              /**< file */
+00085     apr_socket_t *s;            /**< socket */
+00086 } apr_descriptor;
+00087 
+00088 /** @see apr_pollfd_t */
+00089 typedef struct apr_pollfd_t apr_pollfd_t;
+00090 
+00091 /** Poll descriptor set. */
+00092 struct apr_pollfd_t {
+00093     apr_pool_t *p;              /**< associated pool */
+00094     apr_datatype_e desc_type;   /**< descriptor type */
+00095     apr_int16_t reqevents;      /**< requested events */
+00096     apr_int16_t rtnevents;      /**< returned events */
+00097     apr_descriptor desc;        /**< @see apr_descriptor */
+00098     void *client_data;          /**< allows app to associate context */
+00099 };
+00100 
+00101 
+00102 /* General-purpose poll API for arbitrarily large numbers of
+00103  * file descriptors
+00104  */
+00105 
+00106 /** Opaque structure used for pollset API */
+00107 typedef struct apr_pollset_t apr_pollset_t;
+00108 
+00109 /**
+00110  * Setup a pollset object
+00111  * @param pollset  The pointer in which to return the newly created object 
+00112  * @param size The maximum number of descriptors that this pollset can hold
+00113  * @param p The pool from which to allocate the pollset
+00114  * @param flags Optional flags to modify the operation of the pollset.
+00115  *
+00116  * @remark If flags equals APR_POLLSET_THREADSAFE, then a pollset is
+00117  *         created on which it is safe to make concurrent calls to
+00118  *         apr_pollset_add(), apr_pollset_remove() and apr_pollset_poll()
+00119  *         from separate threads.  This feature is only supported on some
+00120  *         platforms; the apr_pollset_create() call will fail with
+00121  *         APR_ENOTIMPL on platforms where it is not supported.
+00122  * @remark If flags contain APR_POLLSET_WAKEABLE, then a pollset is
+00123  *         created with additional internal pipe object used for
+00124  *         apr_pollset_wakeup() call. The actual size of pollset is
+00125  *         in that case size + 1. This feature is only supported on some
+00126  *         platforms; the apr_pollset_create() call will fail with
+00127  *         APR_ENOTIMPL on platforms where it is not supported.
+00128  */
+00129 APR_DECLARE(apr_status_t) apr_pollset_create(apr_pollset_t **pollset,
+00130                                              apr_uint32_t size,
+00131                                              apr_pool_t *p,
+00132                                              apr_uint32_t flags);
+00133 
+00134 /**
+00135  * Setup a pollset object
+00136  * @param pollset  The pointer in which to return the newly created object 
+00137  * @param size The maximum number of descriptors that this pollset can hold
+00138  * @param p The pool from which to allocate the pollset
+00139  * @param flags Optional flags to modify the operation of the pollset.
+00140  * @param method Poll method to use. See @apr_pollset_method_e.
+00141  *
+00142  * @remark If flags equals APR_POLLSET_THREADSAFE, then a pollset is
+00143  *         created on which it is safe to make concurrent calls to
+00144  *         apr_pollset_add(), apr_pollset_remove() and apr_pollset_poll()
+00145  *         from separate threads.  This feature is only supported on some
+00146  *         platforms; the apr_pollset_create() call will fail with
+00147  *         APR_ENOTIMPL on platforms where it is not supported.
+00148  * @remark If flags contain APR_POLLSET_WAKEABLE, then a pollset is
+00149  *         created with additional internal pipe object used for
+00150  *         apr_pollset_wakeup() call. The actual size of pollset is
+00151  *         in that case size + 1. This feature is only supported on some
+00152  *         platforms; the apr_pollset_create() call will fail with
+00153  *         APR_ENOTIMPL on platforms where it is not supported.
+00154  */
+00155 APR_DECLARE(apr_status_t) apr_pollset_create_ex(apr_pollset_t **pollset,
+00156                                                 apr_uint32_t size,
+00157                                                 apr_pool_t *p,
+00158                                                 apr_uint32_t flags,
+00159                                                 apr_pollset_method_e method);
+00160 
+00161 /**
+00162  * Destroy a pollset object
+00163  * @param pollset The pollset to destroy
+00164  */
+00165 APR_DECLARE(apr_status_t) apr_pollset_destroy(apr_pollset_t *pollset);
+00166 
+00167 /**
+00168  * Add a socket or file descriptor to a pollset
+00169  * @param pollset The pollset to which to add the descriptor
+00170  * @param descriptor The descriptor to add
+00171  * @remark If you set client_data in the descriptor, that value
+00172  *         will be returned in the client_data field whenever this
+00173  *         descriptor is signalled in apr_pollset_poll().
+00174  * @remark If the pollset has been created with APR_POLLSET_THREADSAFE
+00175  *         and thread T1 is blocked in a call to apr_pollset_poll() for
+00176  *         this same pollset that is being modified via apr_pollset_add()
+00177  *         in thread T2, the currently executing apr_pollset_poll() call in
+00178  *         T1 will either: (1) automatically include the newly added descriptor
+00179  *         in the set of descriptors it is watching or (2) return immediately
+00180  *         with APR_EINTR.  Option (1) is recommended, but option (2) is
+00181  *         allowed for implementations where option (1) is impossible
+00182  *         or impractical.
+00183  */
+00184 APR_DECLARE(apr_status_t) apr_pollset_add(apr_pollset_t *pollset,
+00185                                           const apr_pollfd_t *descriptor);
+00186 
+00187 /**
+00188  * Remove a descriptor from a pollset
+00189  * @param pollset The pollset from which to remove the descriptor
+00190  * @param descriptor The descriptor to remove
+00191  * @remark If the pollset has been created with APR_POLLSET_THREADSAFE
+00192  *         and thread T1 is blocked in a call to apr_pollset_poll() for
+00193  *         this same pollset that is being modified via apr_pollset_remove()
+00194  *         in thread T2, the currently executing apr_pollset_poll() call in
+00195  *         T1 will either: (1) automatically exclude the newly added descriptor
+00196  *         in the set of descriptors it is watching or (2) return immediately
+00197  *         with APR_EINTR.  Option (1) is recommended, but option (2) is
+00198  *         allowed for implementations where option (1) is impossible
+00199  *         or impractical.
+00200  */
+00201 APR_DECLARE(apr_status_t) apr_pollset_remove(apr_pollset_t *pollset,
+00202                                              const apr_pollfd_t *descriptor);
+00203 
+00204 /**
+00205  * Block for activity on the descriptor(s) in a pollset
+00206  * @param pollset The pollset to use
+00207  * @param timeout The amount of time in microseconds to wait.  This is 
+00208  *                a maximum, not a minimum.  If a descriptor is signalled, we 
+00209  *                will wake up before this time.  A negative number means 
+00210  *                wait until a descriptor is signalled.
+00211  * @param num Number of signalled descriptors (output parameter)
+00212  * @param descriptors Array of signalled descriptors (output parameter)
+00213  * @remark If the pollset has been created with APR_POLLSET_WAKEABLE
+00214  *         and the wakeup has been called while waiting for activity
+00215  *         return value is APR_EINTR in case there was no signaled
+00216  *         descriptors at the time of wakeup call.
+00217  */
+00218 APR_DECLARE(apr_status_t) apr_pollset_poll(apr_pollset_t *pollset,
+00219                                            apr_interval_time_t timeout,
+00220                                            apr_int32_t *num,
+00221                                            const apr_pollfd_t **descriptors);
+00222 
+00223 /**
+00224  * Interrupt the blocked apr_pollset_poll call.
+00225  * @param pollset The pollset to use
+00226  * @remark If the pollset was not created with APR_POLLSET_WAKEABLE the
+00227  *         return value is APR_EINIT.
+00228  */
+00229 APR_DECLARE(apr_status_t) apr_pollset_wakeup(apr_pollset_t *pollset);
+00230 
+00231 /**
+00232  * Poll the descriptors in the poll structure
+00233  * @param aprset The poll structure we will be using. 
+00234  * @param numsock The number of descriptors we are polling
+00235  * @param nsds The number of descriptors signalled (output parameter)
+00236  * @param timeout The amount of time in microseconds to wait.  This is 
+00237  *                a maximum, not a minimum.  If a descriptor is signalled, we 
+00238  *                will wake up before this time.  A negative number means 
+00239  *                wait until a descriptor is signalled.
+00240  * @remark The number of descriptors signalled is returned in the third argument. 
+00241  *         This is a blocking call, and it will not return until either a 
+00242  *         descriptor has been signalled, or the timeout has expired. 
+00243  * @remark The rtnevents field in the apr_pollfd_t array will only be filled-
+00244  *         in if the return value is APR_SUCCESS.
+00245  */
+00246 APR_DECLARE(apr_status_t) apr_poll(apr_pollfd_t *aprset, apr_int32_t numsock,
+00247                                    apr_int32_t *nsds, 
+00248                                    apr_interval_time_t timeout);
+00249 
+00250 /**
+00251  * Display the name of the pollset method, as it relates to the actual
+00252  * method used.
+00253  * @param pollset the name of the pollset.
+00254  */
+00255 APR_DECLARE(const char *) apr_pollset_method_name(apr_pollset_t *pollset);
+00256 
+00257 /**
+00258  * Display the name of the default poll method: APR_POLLSET_DEFAULT
+00259  */
+00260 APR_DECLARE(const char *) apr_poll_method_defname(void);
+00261 
+00262 /** Opaque structure used for pollset API */
+00263 typedef struct apr_pollcb_t apr_pollcb_t;
+00264 
+00265 /**
+00266  * Setup a pollcb object
+00267  * @param pollcb  The pointer in which to return the newly created object 
+00268  * @param size The maximum number of descriptors that a single _poll can return.
+00269  * @param p The pool from which to allocate the pollcb
+00270  * @param flags Optional flags to modify the operation of the pollcb.
+00271  *
+00272  * @remark Pollcb is only supported on some platforms; the apr_pollcb_create()
+00273  * call will fail with APR_ENOTIMPL on platforms where it is not supported.
+00274  */
+00275 APR_DECLARE(apr_status_t) apr_pollcb_create(apr_pollcb_t **pollcb,
+00276                                             apr_uint32_t size,
+00277                                             apr_pool_t *pool,
+00278                                             apr_uint32_t flags);
+00279 
+00280 /**
+00281  * Setup a pollcb object
+00282  * @param pollcb  The pointer in which to return the newly created object 
+00283  * @param size The maximum number of descriptors that a single _poll can return.
+00284  * @param p The pool from which to allocate the pollcb
+00285  * @param flags Optional flags to modify the operation of the pollcb.
+00286  * @param method Poll method to use. See @apr_pollset_method_e.
+00287  *
+00288  * @remark Pollcb is only supported on some platforms; the apr_pollcb_create()
+00289  * call will fail with APR_ENOTIMPL on platforms where it is not supported.
+00290  */
+00291 APR_DECLARE(apr_status_t) apr_pollcb_create_ex(apr_pollcb_t **pollcb,
+00292                                                apr_uint32_t size,
+00293                                                apr_pool_t *pool,
+00294                                                apr_uint32_t flags,
+00295                                                apr_pollset_method_e method);
+00296 
+00297 /**
+00298  * Add a socket or file descriptor to a pollcb
+00299  * @param pollcb The pollcb to which to add the descriptor
+00300  * @param descriptor The descriptor to add
+00301  * @remark If you set client_data in the descriptor, that value
+00302  *         will be returned in the client_data field whenever this
+00303  *         descriptor is signalled in apr_pollcb_poll().
+00304  * @remark Unlike the apr_pollset API, the descriptor is not copied, and users 
+00305  *         must retain the memory used by descriptor, as the same pointer will be 
+00306  *         returned to them from apr_pollcb_poll.
+00307  */
+00308 APR_DECLARE(apr_status_t) apr_pollcb_add(apr_pollcb_t *pollcb,
+00309                                          apr_pollfd_t *descriptor);
+00310 /**
+00311  * Remove a descriptor from a pollcb
+00312  * @param pollcb The pollcb from which to remove the descriptor
+00313  * @param descriptor The descriptor to remove
+00314  */
+00315 APR_DECLARE(apr_status_t) apr_pollcb_remove(apr_pollcb_t *pollcb,
+00316                                             apr_pollfd_t *descriptor);
+00317 
+00318 /** Function prototype for pollcb handlers 
+00319  * @param baton Opaque baton passed into apr_pollcb_poll
+00320  * @param descriptor Contains the notification for an active descriptor, 
+00321  *                   the rtnevents member contains what events were triggered
+00322  *                   for this descriptor.
+00323  */
+00324 typedef apr_status_t (*apr_pollcb_cb_t)(void *baton, apr_pollfd_t *descriptor);
+00325 
+00326 /**
+00327  * Block for activity on the descriptor(s) in a pollcb
+00328  * @param pollcb The pollcb to use
+00329  * @param timeout The amount of time in microseconds to wait.  This is 
+00330  *                a maximum, not a minimum.  If a descriptor is signalled, we 
+00331  *                will wake up before this time.  A negative number means 
+00332  *                wait until a descriptor is signalled.
+00333  * @param func Callback function to call for each active socket
+00334  * @param baton Opaque baton passed to the callback function.
+00335  */
+00336 APR_DECLARE(apr_status_t) apr_pollcb_poll(apr_pollcb_t *pollcb,
+00337                                           apr_interval_time_t timeout,
+00338                                           apr_pollcb_cb_t func,
+00339                                           void *baton); 
+00340 
+00341 /** @} */
+00342 
+00343 #ifdef __cplusplus
+00344 }
+00345 #endif
+00346 
+00347 #endif  /* ! APR_POLL_H */
+00348
apr_status_t	apr_socket_inherit_unset (apr_socket_t *thesocket)
	APR_PERMS_SET_IMPLEMENT (socket)
apr_status_t	apr_mcast_join (apr_socket_t sock, apr_sockaddr_t join, apr_sockaddr_t iface, apr_sockaddr_t source)
apr_status_t	apr_mcast_leave (apr_socket_t sock, apr_sockaddr_t addr, apr_sockaddr_t iface, apr_sockaddr_t source)

Defines
#define	APR_PERMS_SET_IMPLEMENT(type)
#define	APR_PERMS_SET_ENOTIMPL(type)
+#define	APR_PERMS_SET_FN(type) apr_##type##_perms_set
Typedefs
typedef apr_status_t(	apr_perms_setfn_t )(void *object, apr_fileperms_t perms, apr_uid_t uid, apr_gid_t gid)
apr_network_io.h File Reference

apr_network_io.h File Reference

apr_perms_set.h

apr_perms_set.h File Reference

Defines

Typedefs

Detailed Description

apr_poll.h
