rbb 99/04/14 12:18:16
Modified: docs networkio.txt Log: Update docs for select instead of poll. Revision Changes Path 1.6 +35 -11 apache-apr/docs/networkio.txt Index: networkio.txt =================================================================== RCS file: /home/cvs/apache-apr/docs/networkio.txt,v retrieving revision 1.5 retrieving revision 1.6 diff -u -r1.5 -r1.6 --- networkio.txt 1999/04/14 16:30:44 1.5 +++ networkio.txt 1999/04/14 19:18:15 1.6 @@ -62,17 +62,43 @@ return) APR_SUCCESS or APR_FAILURE. Note: To unset an option, call apr_setsocketoption with the same argument. - APRStatus apr_poll(APRPollDesc, APRInt32, APRInt32, APRInt32) - Check an array of File Descriptors for specified events + void apr_sd_set(apr_socket_t *, sd_set *) + set the bit in the sd_set that corresponds to the socket Arguments: - arg 1) The file descriptors to look at. - arg 2) The number of file descriptors. - arg 3) amount of time in seconds to wait if no event has occured on - any of the file descriptors. 0 return immediately. -1 block - until an event occurs. For list of events and meanings, see - below under Events - arg 4) Number of file desriptors selected. 0 means call timed out. + arg 1) The socket we care about. + arg 2) The sd_set we are adding to. + + void apr_sd_rapr_socket_t *, sd_set *) + clear the bit in the sd_set that corresponds to the socket + Arguments: + arg 1) The socket we care about. + arg 2) The sd_set we are removing from. + + int apr_sd_isset(apr_socket_t *, sd_set *) + check the bit in the sd_set that corresponds to the socket + Arguments: + arg 1) The socket we care about. + arg 2) The sd_set we are checking. + return) APR_SUCCESS if there, APR_FAILURE otherwise + + void apr_sd_zero(sd_set *) + clear all bits in the sd_set + Arguments: + arg 1) The sd_set we are clearing. + + apr_int32_t apr_select(apr_int32 nsd, apr_sd_set_t *readset, apr_sd_set_t *writeset, apr_sd_set_t *exceptset, struct timeval timeout) + Monitor sockets for one of three possible conditions. + Arguments: + arg 1) The number of sockets to check. Must be at least one greater + than the size of the biggest set. + arg 2) The set of sockets to check for data to read + arg 3) The set of sockets to check if they are ready for writing. + arg 4) The set of sockets to check for exceptional conditions. + arg 5) The length of time to wait until a socket is triggered + in one of the sets. + return) Number of file desriptors triggered. 0 means call timed out. -1 returned on failure. + APRStatus apr_bind(APRSocket, APRNetAddr *) Assign an address to an unnamed port Arguments: @@ -175,5 +201,3 @@ int socketdes char *hostname } - -