Lines Matching full:an
35 Libevent is an event notification library for developing scalable network
42 servers. An application just needs to call event_dispatch() and then add or
51 the most scalable event notification mechanism available on an operating
75 @section base Creating an event base
77 Next, you need to create an event_base structure, using event_base_new()
85 For each file descriptor that you wish to monitor, you must create an
86 event structure with event_new(). (You may also declare an event
128 an event struct to use as a timer. To activate the timer, call
133 Libevent provides an asynchronous DNS resolver that should be used instead
171 An embedded libevent-based HTTP server
207 * This is an opaque structure; you can allocate one using
224 * An event can have some underlying condition it represents: a socket
226 * (An event that represents no underlying condition is still useful: you
231 * callbacks of an events whose conditions are triggered. When you
236 * An event may be "pending" (one whose condition we are watching),
241 * To make an event pending, pass it to event_add(). When doing so, you
244 * Events become active during an event_base_loop() call when either their
246 * also activate an event manually using event_active(). The even_base
250 * You can make an event non-pending by passing it to event_del(). This
261 * This should be treated as an opaque structure; you should never read or
279 * Configuration for an event_base.
282 * implementation of an event_base. To avoid having to pass them all in a
283 * complex many-argument constructor, we provide an abstract data type
300 * would otherwise crash mysteriously to fail earlier with an assertion
305 * An event is re-assigned while it is added
320 * When debugging mode is enabled, informs Libevent that an event should no
360 @return 0 if successful, -1 if an error occurred, or 1 if we exited because
382 @return an array with pointers to the names of support methods.
383 The end of the array is indicated by a NULL pointer. If an
392 an event base.
394 @return an event_config object that can be used to store configuration, or
395 NULL if an error is encountered.
401 Deallocates all memory associated with an event configuration object
408 Enters an event method that should be avoided into the configuration.
412 mechanisms. An application can make use of multiple event bases to
422 A flag used to describe which features an event_base (must) provide.
431 /** Require an event method that allows edge-triggered events with EV_ET. */
433 /** Require an event method where having one event triggered among
434 * many is [approximately] an O(1) operation. This excludes (for
438 /** Require an event method that allows file descriptors as well as
446 These flags change the behavior of an allocated event_base.
456 an event_base */
488 Return a bitmask of the features implemented by an event base. This
547 @return an initialized event_base that can be used to registering events,
554 Deallocate all memory associated with an event_base, and free the base.
559 @param eb an event_base to be freed
588 @param cb a function taking two arguments: an integer severity between
613 Libevent will (almost) always log an _EVENT_LOG_ERR message before calling
619 Associate a different event base with an event.
634 /** Block until we have an active event, then exit once all active events
655 @return 0 if successful, -1 if an error occurred, or 1 if we exited because
674 @return 0 if successful, or -1 if an error occurred
689 @return 0 if successful, or -1 if an error occurred
697 This function will return true for an event_base at every point after
711 This function will return true for an event_base at every point after
726 * anything else with an argument of the form "short events"
780 A callback function for an event.
784 @param fd An fd or signal
825 that a timeout occurred, and EV_ET indicates that an edge-triggered
834 @param callback_arg an argument to be passed to the callback function
857 event_get_struct_event_size() to determine the required size of an event
860 Note that it is NOT safe to call this function on an event that is
863 event_assign to change an existing event, but only if it is not active
869 @param ev an event struct to be modified
874 @param callback_arg an argument to be passed to the callback function
896 caller to prepare an event structure.
902 @param base an event_base
907 @param arg an argument to be passed to the callback function
909 makes an EV_READ/EV_WRITE event make forever; NULL makes an
911 @return 0 if successful, or -1 if an error occurred
916 Add an event to the set of pending events.
931 @param ev an event struct initialized via event_set()
934 @return 0 if successful, or -1 if an error occurred
940 Remove an event from the set of monitored events.
946 @param ev an event struct to be removed from the working set
947 @return 0 if successful, or -1 if an error occurred
954 Make an event active.
963 @param ev an event to make active.
965 @param ncalls an obsolete argument: this is ignored.
972 @param ev an event struct previously passed to event_add()
986 Test if an event structure might be initialized.
988 The event_initialized() function can be used to check if an event has been
992 piece of memory from an initialized event, it can easily be confused by
993 uninitialized memory. Thus, it should ONLY be used to distinguish an
996 @param ev an event structure to be tested
1008 Get the socket or signal assigned to an event, or -1 if the event has
1014 Get the event_base associated with an event.
1019 Return the events (EV_READ, EV_WRITE, etc) assigned to an event.
1024 Return the callback assigned to an event.
1029 Return the callback argument assigned to an event.
1103 event_priority_set() function can be used to assign a priority to an
1115 @return 0 if successful, or -1 if an error occurred
1121 Assign a priority to an event.
1123 @param ev an event struct
1125 @return 0 if successful, or -1 if an error occurred
1131 Prepare an event_base to use a large number of timeouts with the same