diff options
author | Daniel Xu <dxu@dxuuu.xyz> | 2023-10-01 12:38:26 -0600 |
---|---|---|
committer | Konstantin Kostiuk <kkostiuk@redhat.com> | 2023-10-11 14:30:54 +0300 |
commit | f897ef0d47d332d4c4498aed1140c6856fe56d79 (patch) | |
tree | b72823a005b322742df7228671a68d78db86324a /qga | |
parent | d6f67b83b81bf49b5c62e77143ed39c020e51830 (diff) | |
download | qemu-f897ef0d47d332d4c4498aed1140c6856fe56d79.zip qemu-f897ef0d47d332d4c4498aed1140c6856fe56d79.tar.gz qemu-f897ef0d47d332d4c4498aed1140c6856fe56d79.tar.bz2 |
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>
Diffstat (limited to 'qga')
-rw-r--r-- | qga/qapi-schema.json | 8 |
1 files changed, 5 insertions, 3 deletions
diff --git a/qga/qapi-schema.json b/qga/qapi-schema.json index b720dd4..876e2a8 100644 --- a/qga/qapi-schema.json +++ b/qga/qapi-schema.json @@ -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. |