Filip Hejsek <[email protected]> writes:
> From: Szymon Lukasz <[email protected]>
>
> The managment software can use this command to notify QEMU about the
> size of the terminal connected to a chardev, QEMU can then forward this
> information to the guest if the chardev is connected to a virtio console
> device.
>
> Signed-off-by: Szymon Lukasz <[email protected]>
> Suggested-by: Daniel P. Berrangé <[email protected]>
> [Filip: rename command, change documentation]
> Reviewed-by: Daniel P. Berrangé <[email protected]>
> Acked-by: Markus Armbruster <[email protected]>
> Signed-off-by: Filip Hejsek <[email protected]>
[...]
> diff --git a/qapi/char.json b/qapi/char.json
> index 140614f82c..bc08f0161a 100644
> --- a/qapi/char.json
> +++ b/qapi/char.json
> @@ -861,6 +861,37 @@
> { 'command': 'chardev-send-break',
> 'data': { 'id': 'str' } }
>
> +##
> +# @chardev-window-size-changed:
> +#
> +# Notifies a chardev about the current size of the terminal connected
> +# to this chardev. The information will be forwarded to the guest if
> +# the chardev is connected to a virtio console device.
> +#
> +# The initial size is 0x0, which should be interpreted as an unknown
> +# size.
> +#
> +# Some backends detect the terminal size automatically, in which case
> +# the size may unpredictably revert to the detected one at any time.
> +#
> +# @id: the chardev's ID, must exist
Please drop ", must exist" for consistency with ID descriptions
elsewhere.
> +#
> +# @cols: the number of columns
> +#
> +# @rows: the number of rows
> +#
> +# Since: 11.0
> +#
> +# .. qmp-example::
> +#
> +# -> { "execute": "chardev-window-size-changed", "arguments": { "id":
> "foo", "cols": 80, "rows": 24 } }
> +# <- { "return": {} }
> +##
> +{ 'command': 'chardev-window-size-changed',
> + 'data': { 'id': 'str',
> + 'cols': 'uint16',
> + 'rows': 'uint16' } }
> +
> ##
> # @VSERPORT_CHANGE:
> #
