Modified: apr/site/trunk/docs/docs/apr/trunk/group__apr__poll.html URL: http://svn.apache.org/viewvc/apr/site/trunk/docs/docs/apr/trunk/group__apr__poll.html?rev=784636&r1=784635&r2=784636&view=diff ============================================================================== --- apr/site/trunk/docs/docs/apr/trunk/group__apr__poll.html (original) +++ apr/site/trunk/docs/docs/apr/trunk/group__apr__poll.html Mon Jun 15 00:01:38 2009 @@ -1,16 +1,17 @@
-Do not try default method if non default fails +Do not try to use the default method if the specified non-default method cannot be used
-Pollset Flags Adding or Removing a Descriptor is thread safe +Pollset Flags Adding or removing a descriptor is thread-safe
-Pollset poll operation is interruptable +Poll operations are interruptable by apr_pollset_wakeup()
+
The rtnevents field in the apr_pollfd_t array will only be filled- in if the return value is APR_SUCCESS.
-Display the name of the default poll method: APR_POLLSET_DEFAULT +Return a printable representation of the default pollset method (APR_POLLSET_DEFAULT).
-Unlike the apr_pollset API, the descriptor is not copied, and users must retain the memory used by descriptor, as the same pointer will be returned to them from apr_pollcb_poll.
+Do not add the same socket or file descriptor to the same pollcb multiple times, even if the requested events differ for the different calls to apr_pollcb_add(). If the events of interest for a descriptor change, you must first remove the descriptor from the pollcb with apr_pollcb_remove(), then add it again specifying all requested events.
@@ -526,7 +528,7 @@
-Setup a pollcb object
| pollcb | The pointer in which to return the newly created object | |
| size | The maximum number of descriptors that a single _poll can return. |
| pollcb | The pointer in which to return the newly created object | |
| size | The maximum number of descriptors that a single _poll can return. | |
| p | The pool from which to allocate the pollcb | |
| flags | Optional flags to modify the operation of the pollcb. | |
| method | Poll method to use. See . | |
| method | Poll method to use. See . If this method cannot be used, the default method will be used unless the APR_POLLSET_NODEFAULT flag has been specified. |
@@ -636,11 +638,12 @@ Block for activity on the descriptor(s) in a pollcb
| pollcb | The pollcb to use | |
| timeout | The amount of time in microseconds to wait. This is a maximum, not a minimum. If a descriptor is signalled, we will wake up before this time. A negative number means wait until a descriptor is signalled. | |
| func | Callback function to call for each active socket | |
| timeout | The amount of time in microseconds to wait. This is a maximum, not a minimum. If a descriptor is signalled, the function will return before this time. If timeout is negative, the function will block until a descriptor is signalled. | |
| func | Callback function to call for each active descriptor. | |
| baton | Opaque baton passed to the callback function. |
@@ -676,6 +679,7 @@
@@ -712,7 +716,9 @@
-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.
+If the pollset has been created with APR_POLLSET_NOCOPY, the apr_pollfd_t structure referenced by descriptor will not be copied and must have a lifetime at least as long as the pollset.
+Do not add the same socket or file descriptor to the same pollset multiple times, even if the requested events differ for the different calls to apr_pollset_add(). If the events of interest for a descriptor change, you must first remove the descriptor from the pollset with apr_pollset_remove(), then add it again specifying all requested events.
@@ -754,7 +760,7 @@
-Setup a pollset object
| pollset | The pointer in which to return the newly created object | |
| size | The maximum number of descriptors that this pollset can hold | |
| flags | Optional flags to modify the operation of the pollset. |
-If flags contain APR_POLLSET_WAKEABLE, then a pollset is created with additional internal pipe object used for apr_pollset_wakeup() call. The actual size of pollset is in that case size + 1. This feature is only supported on some platforms; the apr_pollset_create() call will fail with APR_ENOTIMPL on platforms where it is not supported.
+If flags contains APR_POLLSET_WAKEABLE, then a pollset is created with an additional internal pipe object used for the apr_pollset_wakeup() call. The actual size of pollset is in that case size + 1. This feature is only supported on some platforms; the apr_pollset_create() call will fail with APR_ENOTIMPL on platforms where it is not supported.
+If flags contains APR_POLLSET_NOCOPY, then the apr_pollfd_t structures passed to apr_pollset_add() are not copied and must have a lifetime at least as long as the pollset.
@@ -811,17 +818,18 @@
-Setup a pollset object
| pollset | The pointer in which to return the newly created object | |
| size | The maximum number of descriptors that this pollset can hold | |
| p | The pool from which to allocate the pollset | |
| flags | Optional flags to modify the operation of the pollset. | |
| method | Poll method to use. See . | |
| method | Poll method to use. See . If this method cannot be used, the default method will be used unless the APR_POLLSET_NODEFAULT flag has been specified. |
-If flags contain APR_POLLSET_WAKEABLE, then a pollset is created with additional internal pipe object used for apr_pollset_wakeup() call. The actual size of pollset is in that case size + 1. This feature is only supported on some platforms; the apr_pollset_create() call will fail with APR_ENOTIMPL on platforms where it is not supported.
+If flags contains APR_POLLSET_WAKEABLE, then a pollset is created with additional internal pipe object used for the apr_pollset_wakeup() call. The actual size of pollset is in that case size + 1. This feature is only supported on some platforms; the apr_pollset_create_ex() call will fail with APR_ENOTIMPL on platforms where it is not supported.
+If flags contains APR_POLLSET_NOCOPY, then the apr_pollfd_t structures passed to apr_pollset_add() are not copied and must have a lifetime at least as long as the pollset.
@@ -867,9 +875,9 @@
-Display the name of the pollset method, as it relates to the actual method used.
| pollset | the name of the pollset. | |
| pollset | The pollset to use |
| pollset | The pollset to use | |
| timeout | The amount of time in microseconds to wait. This is a maximum, not a minimum. If a descriptor is signalled, we will wake up before this time. A negative number means wait until a descriptor is signalled. | |
| timeout | The amount of time in microseconds to wait. This is a maximum, not a minimum. If a descriptor is signalled, the function will return before this time. If timeout is negative, the function will block until a descriptor is signalled or until apr_pollset_wakeup() has been called. | |
| num | Number of signalled descriptors (output parameter) | |
| descriptors | Array of signalled descriptors (output parameter) |
+Multiple signalled conditions for the same descriptor may be reported in one or more returned apr_pollfd_t structures, depending on the implementation.
@@ -957,7 +966,8 @@
+apr_pollset_remove() cannot be used to remove a subset of requested events for a descriptor. The reqevents field in the apr_pollfd_t parameter must contain the same value when removing as when adding.
@@ -978,7 +988,7 @@
-Interrupt the blocked apr_pollset_poll call.
| pollset | The pollset to use |
-
1.5.7.1
+
1.5.8
Modified: apr/site/trunk/docs/docs/apr/trunk/group__apr__pools.html
URL: http://svn.apache.org/viewvc/apr/site/trunk/docs/docs/apr/trunk/group__apr__pools.html?rev=784636&r1=784635&r2=784636&view=diff
==============================================================================
--- apr/site/trunk/docs/docs/apr/trunk/group__apr__pools.html (original)
+++ apr/site/trunk/docs/docs/apr/trunk/group__apr__pools.html Mon Jun 15 00:01:38 2009
@@ -1,16 +1,17 @@
| apr_allocator_t* apr_pool_allocator_get | -( | -apr_pool_t * | -pool | -) | -- |
-Find the pools allocator
| pool | The pool to get the allocator from. |
| apr_status_t apr_pool_create_core | -( | -apr_pool_t ** | -newpool | -) | -- |
-Create a new pool.
| newpool | The pool we have just created. |
| apr_status_t apr_pool_create_core_ex | -( | -apr_pool_t ** | -newpool, | -|
| - | - | apr_abortfunc_t | -abort_fn, | -|
| - | - | apr_allocator_t * | -allocator | - |
| - | ) | -- |
| apr_status_t apr_pool_create_core_ex_debug | -( | -apr_pool_t ** | -newpool, | -|
| - | - | apr_abortfunc_t | -abort_fn, | -|
| - | - | apr_allocator_t * | -allocator, | -|
| - | - | const char * | -file_line | - |
| - | ) | -- |
-Debug version of apr_pool_create_core_ex.
-| apr_status_t apr_pool_create_unmanaged_ex | -( | -apr_pool_t ** | -newpool, | -|
| - | - | apr_abortfunc_t | -abort_fn, | -|
| - | - | apr_allocator_t * | -allocator | - |
| - | ) | -- |
-Create a new unmanaged pool.
| newpool | The pool we have just created. | |
| abort_fn | A function to use if the pool cannot allocate more memory. | |
| allocator | The allocator to use with the new pool. If NULL a new allocator will be crated with newpool as owner. |
| apr_status_t apr_pool_create_unmanaged_ex_debug | -( | -apr_pool_t ** | -newpool, | -|
| - | - | apr_abortfunc_t | -abort_fn, | -|
| - | - | apr_allocator_t * | -allocator, | -|
| - | - | const char * | -file_line | - |
| - | ) | -- |
-Debug version of apr_pool_create_unmanaged_ex.
| newpool |
| abort_fn |
| allocator |
| file_line | Where the function is called from. This is usually APR_POOL__FILE_LINE__. |
-
1.5.7.1
+
1.5.8
Modified: apr/site/trunk/docs/docs/apr/trunk/group__apr__portabile.html
URL: http://svn.apache.org/viewvc/apr/site/trunk/docs/docs/apr/trunk/group__apr__portabile.html?rev=784636&r1=784635&r2=784636&view=diff
==============================================================================
--- apr/site/trunk/docs/docs/apr/trunk/group__apr__portabile.html (original)
+++ apr/site/trunk/docs/docs/apr/trunk/group__apr__portabile.html Mon Jun 15 00:01:38 2009
@@ -1,16 +1,17 @@
-
1.5.7.1
+
1.5.8
Modified: apr/site/trunk/docs/docs/apr/trunk/group__apr__proc__mutex.html
URL: http://svn.apache.org/viewvc/apr/site/trunk/docs/docs/apr/trunk/group__apr__proc__mutex.html?rev=784636&r1=784635&r2=784636&view=diff
==============================================================================
--- apr/site/trunk/docs/docs/apr/trunk/group__apr__proc__mutex.html (original)
+++ apr/site/trunk/docs/docs/apr/trunk/group__apr__proc__mutex.html Mon Jun 15 00:01:38 2009
@@ -1,16 +1,17 @@
-
1.5.7.1
+
1.5.8
Modified: apr/site/trunk/docs/docs/apr/trunk/group__apr__random.html
URL: http://svn.apache.org/viewvc/apr/site/trunk/docs/docs/apr/trunk/group__apr__random.html?rev=784636&r1=784635&r2=784636&view=diff
==============================================================================
--- apr/site/trunk/docs/docs/apr/trunk/group__apr__random.html (original)
+++ apr/site/trunk/docs/docs/apr/trunk/group__apr__random.html Mon Jun 15 00:01:38 2009
@@ -1,16 +1,17 @@
-
1.5.7.1
+
1.5.8
Modified: apr/site/trunk/docs/docs/apr/trunk/group__apr__ring.html
URL: http://svn.apache.org/viewvc/apr/site/trunk/docs/docs/apr/trunk/group__apr__ring.html?rev=784636&r1=784635&r2=784636&view=diff
==============================================================================
--- apr/site/trunk/docs/docs/apr/trunk/group__apr__ring.html (original)
+++ apr/site/trunk/docs/docs/apr/trunk/group__apr__ring.html Mon Jun 15 00:01:38 2009
@@ -1,16 +1,17 @@
-
1.5.7.1
+
1.5.8
Modified: apr/site/trunk/docs/docs/apr/trunk/group__apr__shm.html
URL: http://svn.apache.org/viewvc/apr/site/trunk/docs/docs/apr/trunk/group__apr__shm.html?rev=784636&r1=784635&r2=784636&view=diff
==============================================================================
--- apr/site/trunk/docs/docs/apr/trunk/group__apr__shm.html (original)
+++ apr/site/trunk/docs/docs/apr/trunk/group__apr__shm.html Mon Jun 15 00:01:38 2009
@@ -1,16 +1,17 @@
-
1.5.7.1
+
1.5.8
Modified: apr/site/trunk/docs/docs/apr/trunk/group__apr__signal.html
URL: http://svn.apache.org/viewvc/apr/site/trunk/docs/docs/apr/trunk/group__apr__signal.html?rev=784636&r1=784635&r2=784636&view=diff
==============================================================================
--- apr/site/trunk/docs/docs/apr/trunk/group__apr__signal.html (original)
+++ apr/site/trunk/docs/docs/apr/trunk/group__apr__signal.html Mon Jun 15 00:01:38 2009
@@ -1,16 +1,17 @@
-
1.5.7.1
+
1.5.8
Modified: apr/site/trunk/docs/docs/apr/trunk/group__apr__sockopt.html
URL: http://svn.apache.org/viewvc/apr/site/trunk/docs/docs/apr/trunk/group__apr__sockopt.html?rev=784636&r1=784635&r2=784636&view=diff
==============================================================================
--- apr/site/trunk/docs/docs/apr/trunk/group__apr__sockopt.html (original)
+++ apr/site/trunk/docs/docs/apr/trunk/group__apr__sockopt.html Mon Jun 15 00:01:38 2009
@@ -1,16 +1,17 @@
-
1.5.7.1
+
1.5.8
Modified: apr/site/trunk/docs/docs/apr/trunk/group__apr__strings.html
URL: http://svn.apache.org/viewvc/apr/site/trunk/docs/docs/apr/trunk/group__apr__strings.html?rev=784636&r1=784635&r2=784636&view=diff
==============================================================================
--- apr/site/trunk/docs/docs/apr/trunk/group__apr__strings.html (original)
+++ apr/site/trunk/docs/docs/apr/trunk/group__apr__strings.html Mon Jun 15 00:01:38 2009
@@ -1,16 +1,17 @@
@@ -921,8 +922,8 @@
-
1.5.7.1
+
1.5.8
Modified: apr/site/trunk/docs/docs/apr/trunk/group__apr__support.html
URL: http://svn.apache.org/viewvc/apr/site/trunk/docs/docs/apr/trunk/group__apr__support.html?rev=784636&r1=784635&r2=784636&view=diff
==============================================================================
--- apr/site/trunk/docs/docs/apr/trunk/group__apr__support.html (original)
+++ apr/site/trunk/docs/docs/apr/trunk/group__apr__support.html Mon Jun 15 00:01:38 2009
@@ -1,16 +1,17 @@
-
1.5.7.1
+
1.5.8
Modified: apr/site/trunk/docs/docs/apr/trunk/group__apr__tables.html
URL: http://svn.apache.org/viewvc/apr/site/trunk/docs/docs/apr/trunk/group__apr__tables.html?rev=784636&r1=784635&r2=784636&view=diff
==============================================================================
--- apr/site/trunk/docs/docs/apr/trunk/group__apr__tables.html (original)
+++ apr/site/trunk/docs/docs/apr/trunk/group__apr__tables.html Mon Jun 15 00:01:38 2009
@@ -1,16 +1,17 @@
-
1.5.7.1
+
1.5.8
Modified: apr/site/trunk/docs/docs/apr/trunk/group__apr__thread__cond.html
URL: http://svn.apache.org/viewvc/apr/site/trunk/docs/docs/apr/trunk/group__apr__thread__cond.html?rev=784636&r1=784635&r2=784636&view=diff
==============================================================================
--- apr/site/trunk/docs/docs/apr/trunk/group__apr__thread__cond.html (original)
+++ apr/site/trunk/docs/docs/apr/trunk/group__apr__thread__cond.html Mon Jun 15 00:01:38 2009
@@ -1,16 +1,17 @@
-
1.5.7.1
+
1.5.8
Modified: apr/site/trunk/docs/docs/apr/trunk/group__apr__thread__mutex.html
URL: http://svn.apache.org/viewvc/apr/site/trunk/docs/docs/apr/trunk/group__apr__thread__mutex.html?rev=784636&r1=784635&r2=784636&view=diff
==============================================================================
--- apr/site/trunk/docs/docs/apr/trunk/group__apr__thread__mutex.html (original)
+++ apr/site/trunk/docs/docs/apr/trunk/group__apr__thread__mutex.html Mon Jun 15 00:01:38 2009
@@ -1,16 +1,17 @@
-
1.5.7.1
+
1.5.8
Modified: apr/site/trunk/docs/docs/apr/trunk/group__apr__thread__proc.html
URL: http://svn.apache.org/viewvc/apr/site/trunk/docs/docs/apr/trunk/group__apr__thread__proc.html?rev=784636&r1=784635&r2=784636&view=diff
==============================================================================
--- apr/site/trunk/docs/docs/apr/trunk/group__apr__thread__proc.html (original)
+++ apr/site/trunk/docs/docs/apr/trunk/group__apr__thread__proc.html Mon Jun 15 00:01:38 2009
@@ -1,16 +1,17 @@
@@ -1362,7 +1363,7 @@
-
1.5.7.1
+
1.5.8
Modified: apr/site/trunk/docs/docs/apr/trunk/group__apr__thread__rwlock.html
URL: http://svn.apache.org/viewvc/apr/site/trunk/docs/docs/apr/trunk/group__apr__thread__rwlock.html?rev=784636&r1=784635&r2=784636&view=diff
==============================================================================
--- apr/site/trunk/docs/docs/apr/trunk/group__apr__thread__rwlock.html (original)
+++ apr/site/trunk/docs/docs/apr/trunk/group__apr__thread__rwlock.html Mon Jun 15 00:01:38 2009
@@ -1,16 +1,17 @@
-
1.5.7.1
+
1.5.8
Modified: apr/site/trunk/docs/docs/apr/trunk/group__apr__time.html
URL: http://svn.apache.org/viewvc/apr/site/trunk/docs/docs/apr/trunk/group__apr__time.html?rev=784636&r1=784635&r2=784636&view=diff
==============================================================================
--- apr/site/trunk/docs/docs/apr/trunk/group__apr__time.html (original)
+++ apr/site/trunk/docs/docs/apr/trunk/group__apr__time.html Mon Jun 15 00:01:38 2009
@@ -1,16 +1,17 @@
-
1.5.7.1
+
1.5.8
Modified: apr/site/trunk/docs/docs/apr/trunk/group__apr__user.html
URL: http://svn.apache.org/viewvc/apr/site/trunk/docs/docs/apr/trunk/group__apr__user.html?rev=784636&r1=784635&r2=784636&view=diff
==============================================================================
--- apr/site/trunk/docs/docs/apr/trunk/group__apr__user.html (original)
+++ apr/site/trunk/docs/docs/apr/trunk/group__apr__user.html Mon Jun 15 00:01:38 2009
@@ -1,16 +1,17 @@
-
1.5.7.1
+
1.5.8