mirror of
https://sourceware.org/git/binutils-gdb.git
synced 2024-12-03 04:12:10 +08:00
1d506c26d9
This commit is the result of the following actions:
- Running gdb/copyright.py to update all of the copyright headers to
include 2024,
- Manually updating a few files the copyright.py script told me to
update, these files had copyright headers embedded within the
file,
- Regenerating gdbsupport/Makefile.in to refresh it's copyright
date,
- Using grep to find other files that still mentioned 2023. If
these files were updated last year from 2022 to 2023 then I've
updated them this year to 2024.
I'm sure I've probably missed some dates. Feel free to fix them up as
you spot them.
91 lines
3.2 KiB
C
91 lines
3.2 KiB
C
/* Async events for the GDB event loop.
|
|
Copyright (C) 1999-2024 Free Software Foundation, Inc.
|
|
|
|
This file is part of GDB.
|
|
|
|
This program is free software; you can redistribute it and/or modify
|
|
it under the terms of the GNU General Public License as published by
|
|
the Free Software Foundation; either version 3 of the License, or
|
|
(at your option) any later version.
|
|
|
|
This program is distributed in the hope that it will be useful,
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
GNU General Public License for more details.
|
|
|
|
You should have received a copy of the GNU General Public License
|
|
along with this program. If not, see <http://www.gnu.org/licenses/>. */
|
|
|
|
#ifndef ASYNC_EVENT_H
|
|
#define ASYNC_EVENT_H
|
|
|
|
#include "gdbsupport/event-loop.h"
|
|
|
|
struct async_signal_handler;
|
|
struct async_event_handler;
|
|
typedef void (sig_handler_func) (gdb_client_data);
|
|
|
|
/* Type of async event handler callbacks.
|
|
|
|
DATA is the client data originally passed to create_async_event_handler.
|
|
|
|
The callback is called when the async event handler is marked. The callback
|
|
is responsible for clearing the async event handler if it no longer needs
|
|
to be called. */
|
|
|
|
typedef void (async_event_handler_func) (gdb_client_data);
|
|
|
|
extern struct async_signal_handler *
|
|
create_async_signal_handler (sig_handler_func *proc,
|
|
gdb_client_data client_data,
|
|
const char *name);
|
|
extern void delete_async_signal_handler (struct async_signal_handler **);
|
|
|
|
/* Call the handler from HANDLER the next time through the event
|
|
loop. */
|
|
extern void mark_async_signal_handler (struct async_signal_handler *handler);
|
|
|
|
/* Returns true if HANDLER is marked ready. */
|
|
|
|
extern int
|
|
async_signal_handler_is_marked (struct async_signal_handler *handler);
|
|
|
|
/* Mark HANDLER as NOT ready. */
|
|
|
|
extern void clear_async_signal_handler (struct async_signal_handler *handler);
|
|
|
|
/* Create and register an asynchronous event source in the event loop,
|
|
and set PROC as its callback. CLIENT_DATA is passed as argument to
|
|
PROC upon its invocation. Returns a pointer to an opaque structure
|
|
used to mark as ready and to later delete this event source from
|
|
the event loop.
|
|
|
|
NAME is a user-friendly name for the handler, used in debug statements. The
|
|
name is not copied: its lifetime should be at least as long as that of the
|
|
handler. */
|
|
|
|
extern struct async_event_handler *
|
|
create_async_event_handler (async_event_handler_func *proc,
|
|
gdb_client_data client_data,
|
|
const char *name);
|
|
|
|
/* Remove the event source pointed by HANDLER_PTR created by
|
|
CREATE_ASYNC_EVENT_HANDLER from the event loop, and release it. */
|
|
extern void
|
|
delete_async_event_handler (struct async_event_handler **handler_ptr);
|
|
|
|
/* Call the handler from HANDLER the next time through the event
|
|
loop. */
|
|
extern void mark_async_event_handler (struct async_event_handler *handler);
|
|
|
|
/* Return true if HANDLER is marked. */
|
|
extern bool async_event_handler_marked (async_event_handler *handler);
|
|
|
|
/* Mark the handler (ASYNC_HANDLER_PTR) as NOT ready. */
|
|
|
|
extern void clear_async_event_handler (struct async_event_handler *handler);
|
|
|
|
extern void initialize_async_signal_handlers (void);
|
|
|
|
#endif /* ASYNC_EVENT_H */
|