LXR qemu/include/hw/semihosting/console.h

   1/*
   2 * Semihosting Console
   3 *
   4 * Copyright (c) 2019 Linaro Ltd
   5 *
   6 * SPDX-License-Identifier: GPL-2.0-or-later
   7 */
   8
   9#ifndef SEMIHOST_CONSOLE_H
  10#define SEMIHOST_CONSOLE_H
  11
  12#include "cpu.h"
  13
  14/**
  15 * qemu_semihosting_console_outs:
  16 * @env: CPUArchState
  17 * @s: host address of null terminated guest string
  18 *
  19 * Send a null terminated guest string to the debug console. This may
  20 * be the remote gdb session if a softmmu guest is currently being
  21 * debugged.
  22 *
  23 * Returns: number of bytes written.
  24 */
  25int qemu_semihosting_console_outs(CPUArchState *env, target_ulong s);
  26
  27/**
  28 * qemu_semihosting_console_outc:
  29 * @env: CPUArchState
  30 * @s: host address of null terminated guest string
  31 *
  32 * Send single character from guest memory to the debug console. This
  33 * may be the remote gdb session if a softmmu guest is currently being
  34 * debugged.
  35 *
  36 * Returns: nothing
  37 */
  38void qemu_semihosting_console_outc(CPUArchState *env, target_ulong c);
  39
  40/**
  41 * qemu_semihosting_log_out:
  42 * @s: pointer to string
  43 * @len: length of string
  44 *
  45 * Send a string to the debug output. Unlike console_out these strings
  46 * can't be sent to a remote gdb instance as they don't exist in guest
  47 * memory.
  48 *
  49 * Returns: number of bytes written
  50 */
  51int qemu_semihosting_log_out(const char *s, int len);
  52
  53#endif /* SEMIHOST_CONSOLE_H */
  54