8de702cb67
Provides a blocking call to read a character from the console using semihosting.chardev, if specified. This takes some careful command line options to use stdio successfully as the serial ports, monitor and semihost all want to use stdio. Here's a sample set of command line options which share stdio between semihost, monitor and serial ports: qemu \ -chardev stdio,mux=on,id=stdio0 \ -serial chardev:stdio0 \ -semihosting-config enable=on,chardev=stdio0 \ -mon chardev=stdio0,mode=readline This creates a chardev hooked to stdio and then connects all of the subsystems to it. A shorter mechanism would be good to hear about. Signed-off-by: Keith Packard <keithp@keithp.com> Message-Id: <20191104204230.12249-1-keithp@keithp.com> [AJB: fixed up deadlock, minor commit title reword] Signed-off-by: Alex Bennée <alex.bennee@linaro.org> Cc: Paolo Bonzini <pbonzini@redhat.com> Reviewed-by: Keith Packard <keithp@keithp.com> Tested-by: Keith Packard <keithp@keithp.com> Reviewed-by: Richard Henderson <richard.henderson@linaro.org>
70 lines
1.9 KiB
C
70 lines
1.9 KiB
C
/*
|
|
* Semihosting Console
|
|
*
|
|
* Copyright (c) 2019 Linaro Ltd
|
|
*
|
|
* SPDX-License-Identifier: GPL-2.0-or-later
|
|
*/
|
|
|
|
#ifndef SEMIHOST_CONSOLE_H
|
|
#define SEMIHOST_CONSOLE_H
|
|
|
|
#include "cpu.h"
|
|
|
|
/**
|
|
* qemu_semihosting_console_outs:
|
|
* @env: CPUArchState
|
|
* @s: host address of null terminated guest string
|
|
*
|
|
* Send a null terminated guest string to the debug console. This may
|
|
* be the remote gdb session if a softmmu guest is currently being
|
|
* debugged.
|
|
*
|
|
* Returns: number of bytes written.
|
|
*/
|
|
int qemu_semihosting_console_outs(CPUArchState *env, target_ulong s);
|
|
|
|
/**
|
|
* qemu_semihosting_console_outc:
|
|
* @env: CPUArchState
|
|
* @s: host address of null terminated guest string
|
|
*
|
|
* Send single character from guest memory to the debug console. This
|
|
* may be the remote gdb session if a softmmu guest is currently being
|
|
* debugged.
|
|
*
|
|
* Returns: nothing
|
|
*/
|
|
void qemu_semihosting_console_outc(CPUArchState *env, target_ulong c);
|
|
|
|
/**
|
|
* qemu_semihosting_console_inc:
|
|
* @env: CPUArchState
|
|
*
|
|
* Receive single character from debug console. This may be the remote
|
|
* gdb session if a softmmu guest is currently being debugged. As this
|
|
* call may block if no data is available we suspend the CPU and will
|
|
* re-execute the instruction when data is there. Therefore two
|
|
* conditions must be met:
|
|
* - CPUState is synchronized before calling this function
|
|
* - pc is only updated once the character is successfully returned
|
|
*
|
|
* Returns: character read OR cpu_loop_exit!
|
|
*/
|
|
target_ulong qemu_semihosting_console_inc(CPUArchState *env);
|
|
|
|
/**
|
|
* qemu_semihosting_log_out:
|
|
* @s: pointer to string
|
|
* @len: length of string
|
|
*
|
|
* Send a string to the debug output. Unlike console_out these strings
|
|
* can't be sent to a remote gdb instance as they don't exist in guest
|
|
* memory.
|
|
*
|
|
* Returns: number of bytes written
|
|
*/
|
|
int qemu_semihosting_log_out(const char *s, int len);
|
|
|
|
#endif /* SEMIHOST_CONSOLE_H */
|