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]
This commit is contained in:
Markus Armbruster
2026-01-14 13:47:13 +01:00
parent 0da15e16c3
commit c6ea6ce1e6

View File

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