From c6ea6ce1e6fa0b0b1b8d11ca56c3b669c639c90c Mon Sep 17 00:00:00 2001 From: Markus Armbruster Date: Wed, 14 Jan 2026 13:47:13 +0100 Subject: [PATCH] qemu-print: Document qemu_fprintf(), qemu_vfprintf() failure These functions fail when @stream is null and the current monitor isn't HMP. Signed-off-by: Markus Armbruster Message-ID: <20260114124713.3308719-4-armbru@redhat.com> [Comments rewritten in review] --- util/qemu-print.c | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/util/qemu-print.c b/util/qemu-print.c index 4a30cd1a8e..7b9591035e 100644 --- a/util/qemu-print.c +++ b/util/qemu-print.c @@ -44,7 +44,10 @@ int qemu_printf(const char *fmt, ...) /* * Print like vfprintf() - * Print to @stream if non-null, else to current monitor. + * Print to @stream if non-null, else to current HMP monitor if we + * have one, else fail without printing anything. + * Return number of characters printed on success, negative value on + * error. */ int qemu_vfprintf(FILE *stream, const char *fmt, va_list ap) { @@ -56,7 +59,10 @@ int qemu_vfprintf(FILE *stream, const char *fmt, va_list ap) /* * Print like fprintf(). - * Print to @stream if non-null, else to current monitor. + * Print to @stream if non-null, else to current HMP monitor if we + * have one, else fail without printing anything. + * Return number of characters printed on success, negative value on + * error. */ int qemu_fprintf(FILE *stream, const char *fmt, ...) {