Commit c6ea6ce1e6 for qemu.org

commit c6ea6ce1e6fa0b0b1b8d11ca56c3b669c639c90c
Author: Markus Armbruster <armbru@redhat.com>
Date:   Wed Jan 14 13:47:13 2026 +0100

    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 <armbru@redhat.com>
    Message-ID: <20260114124713.3308719-4-armbru@redhat.com>
    [Comments rewritten in review]

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, ...)
 {