1 /* Async events for the GDB event loop. 2 Copyright (C) 1999-2020 Free Software Foundation, Inc. 3 4 This file is part of GDB. 5 6 This program is free software; you can redistribute it and/or modify 7 it under the terms of the GNU General Public License as published by 8 the Free Software Foundation; either version 3 of the License, or 9 (at your option) any later version. 10 11 This program is distributed in the hope that it will be useful, 12 but WITHOUT ANY WARRANTY; without even the implied warranty of 13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 14 GNU General Public License for more details. 15 16 You should have received a copy of the GNU General Public License 17 along with this program. If not, see <http://www.gnu.org/licenses/>. */ 18 19 #ifndef ASYNC_EVENT_H 20 #define ASYNC_EVENT_H 21 22 #include "gdbsupport/event-loop.h" 23 24 struct async_signal_handler; 25 struct async_event_handler; 26 typedef void (sig_handler_func) (gdb_client_data); 27 typedef void (async_event_handler_func) (gdb_client_data); 28 29 extern struct async_signal_handler * 30 create_async_signal_handler (sig_handler_func *proc, 31 gdb_client_data client_data); 32 extern void delete_async_signal_handler (struct async_signal_handler **); 33 34 /* Call the handler from HANDLER the next time through the event 35 loop. */ 36 extern void mark_async_signal_handler (struct async_signal_handler *handler); 37 38 /* Returns true if HANDLER is marked ready. */ 39 40 extern int 41 async_signal_handler_is_marked (struct async_signal_handler *handler); 42 43 /* Mark HANDLER as NOT ready. */ 44 45 extern void clear_async_signal_handler (struct async_signal_handler *handler); 46 47 /* Create and register an asynchronous event source in the event loop, 48 and set PROC as its callback. CLIENT_DATA is passed as argument to 49 PROC upon its invocation. Returns a pointer to an opaque structure 50 used to mark as ready and to later delete this event source from 51 the event loop. */ 52 extern struct async_event_handler * 53 create_async_event_handler (async_event_handler_func *proc, 54 gdb_client_data client_data); 55 56 /* Remove the event source pointed by HANDLER_PTR created by 57 CREATE_ASYNC_EVENT_HANDLER from the event loop, and release it. */ 58 extern void 59 delete_async_event_handler (struct async_event_handler **handler_ptr); 60 61 /* Call the handler from HANDLER the next time through the event 62 loop. */ 63 extern void mark_async_event_handler (struct async_event_handler *handler); 64 65 /* Mark the handler (ASYNC_HANDLER_PTR) as NOT ready. */ 66 67 extern void clear_async_event_handler (struct async_event_handler *handler); 68 69 extern void initialize_async_signal_handlers (void); 70 71 #endif /* ASYNC_EVENT_H */ 72