summaryrefslogtreecommitdiff
path: root/gdb/event-loop.h
diff options
context:
space:
mode:
authorMichael Snyder <msnyder@specifix.com>2010-12-29 00:58:11 +0000
committerMichael Snyder <msnyder@specifix.com>2010-12-29 00:58:11 +0000
commit142b87ff1070383a6b305aacfb45f5fe5f6a856f (patch)
tree1819c2be5bb45d499247f312358c2202b4a48230 /gdb/event-loop.h
parent249d172966a109f18942d85b3d3bf38852863406 (diff)
downloadgdb-142b87ff1070383a6b305aacfb45f5fe5f6a856f.tar.gz
2010-12-28 Michael Snyder <msnyder@vmware.com>
* event-loop.c: Comment clean-up. * event-loop.h: Ditto. * event-top.c: Ditto. * gdb.c: Ditto. * gdb.h: Ditto. * main.c: Ditto. * top.c: Ditto. * top.h: Ditto.
Diffstat (limited to 'gdb/event-loop.h')
-rw-r--r--gdb/event-loop.h34
1 files changed, 19 insertions, 15 deletions
diff --git a/gdb/event-loop.h b/gdb/event-loop.h
index 9a61d91cdcf..501a56e2559 100644
--- a/gdb/event-loop.h
+++ b/gdb/event-loop.h
@@ -18,18 +18,18 @@
You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>. */
-/* An event loop listens for events from multiple event sources. When
+/* An event loop listens for events from multiple event sources. When
an event arrives, it is queued and processed by calling the
- appropriate event handler. The event loop then continues to listen
- for more events. An event loop completes when there are no event
+ appropriate event handler. The event loop then continues to listen
+ for more events. An event loop completes when there are no event
sources to listen on. External event sources can be plugged into
the loop.
There are 4 main components:
- - a list of file descriptors to be monitored, GDB_NOTIFIER.
+ - a list of file descriptors to be monitored, GDB_NOTIFIER.
- a list of asynchronous event sources to be monitored,
ASYNC_EVENT_HANDLER_LIST.
- - a list of events that have occurred, EVENT_QUEUE.
+ - a list of events that have occurred, EVENT_QUEUE.
- a list of signal handling functions, SIGHANDLER_LIST.
GDB_NOTIFIER keeps track of the file descriptor based event
@@ -64,9 +64,9 @@
functions that are invoked through traditional signal handlers.
The actions to be taken is response to such events will be executed
when the SIGHANDLER_LIST is scanned, the next time through the
- infinite loop.
+ infinite loop.
- Corollary tasks are the creation and deletion of event sources. */
+ Corollary tasks are the creation and deletion of event sources. */
typedef void *gdb_client_data;
struct async_signal_handler;
@@ -76,14 +76,14 @@ typedef void (sig_handler_func) (gdb_client_data);
typedef void (async_event_handler_func) (gdb_client_data);
typedef void (timer_handler_func) (gdb_client_data);
-/* Where to add an event onto the event queue, by queue_event. */
+/* Where to add an event onto the event queue, by queue_event. */
typedef enum
{
- /* Add at tail of queue. It will be processed in first in first
- out order. */
+ /* Add at tail of queue. It will be processed in first in first
+ out order. */
TAIL,
- /* Add at head of queue. It will be processed in last in first out
- order. */
+ /* Add at head of queue. It will be processed in last in first
+ out order. */
HEAD
}
queue_position;
@@ -93,11 +93,15 @@ queue_position;
extern void start_event_loop (void);
extern int gdb_do_one_event (void *data);
extern void delete_file_handler (int fd);
-extern void add_file_handler (int fd, handler_func * proc, gdb_client_data client_data);
+extern void add_file_handler (int fd, handler_func *proc,
+ gdb_client_data client_data);
extern struct async_signal_handler *
- create_async_signal_handler (sig_handler_func * proc, gdb_client_data client_data);
+ create_async_signal_handler (sig_handler_func *proc,
+ gdb_client_data client_data);
extern void delete_async_signal_handler (struct async_signal_handler **async_handler_ptr);
-extern int create_timer (int milliseconds, timer_handler_func * proc, gdb_client_data client_data);
+extern int create_timer (int milliseconds,
+ timer_handler_func *proc,
+ gdb_client_data client_data);
extern void delete_timer (int id);
/* Call the handler from HANDLER immediately. This function