LXR qemu/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 */
  27int gdb_handlesig(CPUState *, int);
  28
  29/**
  30 * gdb_signalled() - inform remote gdb of sig exit
  31 * @as: current CPUArchState
  32 * @sig: signal number
  33 */
  34void gdb_signalled(CPUArchState *as, int sig);
  35
  36/**
  37 * gdbserver_fork() - disable gdb stub for child processes.
  38 * @cs: CPU
  39 */
  40void gdbserver_fork(CPUState *cs);
  41
  42
  43#endif /* GDBSTUB_USER_H */
  44