include/gdbstub/user.h

   1 /*
   2  * gdbstub user-mode only APIs
   3  *
   4  * Copyright (c) 2022 Linaro Ltd
   5  *
   6  * SPDX-License-Identifier: LGPL-2.0+
   7  */
   8
   9 #ifndef GDBSTUB_USER_H
  10 #define GDBSTUB_USER_H
  11
  12 /**
  13  * gdb_handlesig() - yield control to gdb
  14  * @cpu: CPU
  15  * @sig: if non-zero, the signal number which caused us to stop
  16  *
  17  * This function yields control to gdb, when a user-mode-only target
  18  * needs to stop execution. If @sig is non-zero, then we will send a
  19  * stop packet to tell gdb that we have stopped because of this signal.
  20  *
  21  * This function will block (handling protocol requests from gdb)
  22  * until gdb tells us to continue target execution. When it does
  23  * return, the return value is a signal to deliver to the target,
  24  * or 0 if no signal should be delivered, ie the signal that caused
  25  * us to stop should be ignored.
  26  */
  27 int gdb_handlesig(CPUState *, int);
  28
  29 /**
  30  * gdb_signalled() - inform remote gdb of sig exit
  31  * @as: current CPUArchState
  32  * @sig: signal number
  33  */
  34 void gdb_signalled(CPUArchState *as, int sig);
  35
  36 /**
  37  * gdbserver_fork() - disable gdb stub for child processes.
  38  * @cs: CPU
  39  */
  40 void gdbserver_fork(CPUState *cs);
  41
  42
  43 #endif /* GDBSTUB_USER_H */