| /* Copyright 2000-2004 The Apache Software Foundation |
| * |
| * Licensed under the Apache License, Version 2.0 (the "License"); |
| * you may not use this file except in compliance with the License. |
| * You may obtain a copy of the License at |
| * |
| * http://www.apache.org/licenses/LICENSE-2.0 |
| * |
| * Unless required by applicable law or agreed to in writing, software |
| * distributed under the License is distributed on an "AS IS" BASIS, |
| * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| * See the License for the specific language governing permissions and |
| * limitations under the License. |
| */ |
| |
| #ifndef APR_POLL_H |
| #define APR_POLL_H |
| /** |
| * @file apr_poll.h |
| * @brief APR Poll interface |
| */ |
| #include "apr.h" |
| #include "apr_pools.h" |
| #include "apr_errno.h" |
| #include "apr_inherit.h" |
| #include "apr_file_io.h" |
| #include "apr_network_io.h" |
| |
| #if APR_HAVE_NETINET_IN_H |
| #include <netinet/in.h> |
| #endif |
| |
| #ifdef __cplusplus |
| extern "C" { |
| #endif /* __cplusplus */ |
| |
| /** |
| * @defgroup apr_poll Poll Routines |
| * @ingroup APR |
| * @{ |
| */ |
| |
| /** |
| * Poll options |
| */ |
| #define APR_POLLIN 0x001 /**< Can read without blocking */ |
| #define APR_POLLPRI 0x002 /**< Priority data available */ |
| #define APR_POLLOUT 0x004 /**< Can write without blocking */ |
| #define APR_POLLERR 0x010 /**< Pending error */ |
| #define APR_POLLHUP 0x020 /**< Hangup occurred */ |
| #define APR_POLLNVAL 0x040 /**< Descriptior invalid */ |
| |
| /** Used in apr_pollfd_t to determine what the apr_descriptor is */ |
| typedef enum { |
| APR_NO_DESC, /**< nothing here */ |
| APR_POLL_SOCKET, /**< descriptor refers to a socket */ |
| APR_POLL_FILE, /**< descriptor refers to a file */ |
| APR_POLL_LASTDESC /**< descriptor is the last one in the list */ |
| } apr_datatype_e ; |
| |
| /** Union of either an APR file or socket. */ |
| typedef union { |
| apr_file_t *f; /**< file */ |
| apr_socket_t *s; /**< socket */ |
| } apr_descriptor; |
| |
| /** @see apr_pollfd_t */ |
| typedef struct apr_pollfd_t apr_pollfd_t; |
| |
| /** Poll descriptor set. */ |
| struct apr_pollfd_t { |
| apr_pool_t *p; /**< associated pool */ |
| apr_datatype_e desc_type; /**< descriptor type */ |
| apr_int16_t reqevents; /**< requested events */ |
| apr_int16_t rtnevents; /**< returned events */ |
| apr_descriptor desc; /**< @see apr_descriptor */ |
| void *client_data; /**< allows app to associate context */ |
| }; |
| |
| |
| /* General-purpose poll API for arbitrarily large numbers of |
| * file descriptors |
| */ |
| |
| /** Opaque structure used for pollset API */ |
| typedef struct apr_pollset_t apr_pollset_t; |
| |
| /** |
| * Setup a pollset object |
| * @param pollset The pointer in which to return the newly created object |
| * @param size The maximum number of descriptors that this pollset can hold |
| * @param p The pool from which to allocate the pollset |
| * @param flags Optional flags to modify the operation of the pollset |
| * (reserved for future expansion) |
| */ |
| APR_DECLARE(apr_status_t) apr_pollset_create(apr_pollset_t **pollset, |
| apr_uint32_t size, |
| apr_pool_t *p, |
| apr_uint32_t flags); |
| |
| /** |
| * Destroy a pollset object |
| * @param pollset The pollset to destroy |
| */ |
| 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 |
| * @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); |
| |
| /** |
| * Remove a descriptor from a pollset |
| * @param pollset The pollset from which to remove the descriptor |
| * @param descriptor The descriptor to remove |
| */ |
| APR_DECLARE(apr_status_t) apr_pollset_remove(apr_pollset_t *pollset, |
| const apr_pollfd_t *descriptor); |
| |
| /** |
| * Block for activity on the descriptor(s) in a pollset |
| * @param pollset The pollset to use |
| * @param timeout Timeout in microseconds |
| * @param num Number of signalled descriptors (output parameter) |
| * @param descriptors Array of signalled descriptors (output parameter) |
| */ |
| APR_DECLARE(apr_status_t) apr_pollset_poll(apr_pollset_t *pollset, |
| apr_interval_time_t timeout, |
| apr_int32_t *num, |
| const apr_pollfd_t **descriptors); |
| |
| |
| /** |
| * Poll the sockets in the poll structure |
| * @param aprset The poll structure we will be using. |
| * @param numsock The number of sockets we are polling |
| * @param nsds The number of sockets signalled. |
| * @param timeout The amount of time in microseconds to wait. This is |
| * a maximum, not a minimum. If a socket is signalled, we |
| * will wake up before this time. A negative number means |
| * wait until a socket is signalled. |
| * @remark The number of sockets signalled is returned in the third argument. |
| * This is a blocking call, and it will not return until either a |
| * socket has been signalled, or the timeout has expired. |
| */ |
| APR_DECLARE(apr_status_t) apr_poll(apr_pollfd_t *aprset, apr_int32_t numsock, |
| apr_int32_t *nsds, |
| apr_interval_time_t timeout); |
| |
| /** @} */ |
| |
| |
| #ifdef __cplusplus |
| } |
| #endif |
| |
| #endif /* ! APR_POLL_H */ |
| |