meson: remove dead dictionary access
[qemu/ar7.git] / include / gdbstub / user.h
blob3b8358e3dab3764a782d19332560bf1f01a45fde
1 /*
2 * gdbstub user-mode only APIs
4 * Copyright (c) 2022 Linaro Ltd
6 * SPDX-License-Identifier: LGPL-2.0+
7 */
9 #ifndef GDBSTUB_USER_H
10 #define GDBSTUB_USER_H
12 #define MAX_SIGINFO_LENGTH 128
14 /**
15 * gdb_handlesig() - yield control to gdb
16 * @cpu: CPU
17 * @sig: if non-zero, the signal number which caused us to stop
18 * @reason: stop reason for stop reply packet or NULL
19 * @siginfo: target-specific siginfo struct
20 * @siginfo_len: target-specific siginfo struct length
22 * This function yields control to gdb, when a user-mode-only target
23 * needs to stop execution. If @sig is non-zero, then we will send a
24 * stop packet to tell gdb that we have stopped because of this signal.
26 * This function will block (handling protocol requests from gdb)
27 * until gdb tells us to continue target execution. When it does
28 * return, the return value is a signal to deliver to the target,
29 * or 0 if no signal should be delivered, ie the signal that caused
30 * us to stop should be ignored.
32 int gdb_handlesig(CPUState *, int, const char *, void *, int);
34 /**
35 * gdb_signalled() - inform remote gdb of sig exit
36 * @as: current CPUArchState
37 * @sig: signal number
39 void gdb_signalled(CPUArchState *as, int sig);
41 /**
42 * gdbserver_fork_start() - inform gdb of the upcoming fork()
44 void gdbserver_fork_start(void);
46 /**
47 * gdbserver_fork_end() - inform gdb of the completed fork()
48 * @cs: CPU
49 * @pid: 0 if in child process, -1 if fork failed, child process pid otherwise
51 void gdbserver_fork_end(CPUState *cs, pid_t pid);
53 /**
54 * gdb_syscall_entry() - inform gdb of syscall entry and yield control to it
55 * @cs: CPU
56 * @num: syscall number
58 void gdb_syscall_entry(CPUState *cs, int num);
60 /**
61 * gdb_syscall_entry() - inform gdb of syscall return and yield control to it
62 * @cs: CPU
63 * @num: syscall number
65 void gdb_syscall_return(CPUState *cs, int num);
67 #endif /* GDBSTUB_USER_H */