1
0
mirror of https://gitlab.com/qemu-project/qemu synced 2024-07-08 20:17:27 +00:00

qapi: qga: Clarify when out-data and err-data are populated

If output is being captured for a guest-exec invocation, the out-data
and err-data fields of guest-exec-status are only populated after the
process is reaped. This is somewhat counter intuitive and too late to
change. Thus, it would be good to document the behavior.

Signed-off-by: Daniel Xu <dxu@dxuuu.xyz>
Reviewed-by: Konstantin Kostiuk <kkostiuk@redhat.com>
Signed-off-by: Konstantin Kostiuk <kkostiuk@redhat.com>
This commit is contained in:
Daniel Xu 2023-10-01 12:38:26 -06:00 committed by Konstantin Kostiuk
parent d6f67b83b8
commit f897ef0d47

View File

@ -1220,11 +1220,13 @@
# @signal: signal number (linux) or unhandled exception code (windows)
# if the process was abnormally terminated.
#
# @out-data: base64-encoded stdout of the process
# @out-data: base64-encoded stdout of the process. This field will only
# be populated after the process exits.
#
# @err-data: base64-encoded stderr of the process Note: @out-data and
# @err-data: base64-encoded stderr of the process. Note: @out-data and
# @err-data are present only if 'capture-output' was specified for
# 'guest-exec'
# 'guest-exec'. This field will only be populated after the process
# exits.
#
# @out-truncated: true if stdout was not fully captured due to size
# limitation.