[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [PATCH v2 2/3] qapi: Document some missing details of RTC_CHANGE eve
From: |
Markus Armbruster |
Subject: |
Re: [PATCH v2 2/3] qapi: Document some missing details of RTC_CHANGE event |
Date: |
Tue, 22 Feb 2022 12:22:02 +0100 |
User-agent: |
Gnus/5.13 (Gnus v5.13) Emacs/27.2 (gnu/linux) |
Peter Maydell <peter.maydell@linaro.org> writes:
> The RTC_CHANGE event's documentation is missing some details:
> * the offset argument is in units of seconds
> * it isn't guaranteed that the RTC will implement the event
>
> Signed-off-by: Peter Maydell <peter.maydell@linaro.org>
> ---
> v1->v2: add the "RTC might not implement this" note
> ---
> qapi/misc.json | 6 ++++--
> 1 file changed, 4 insertions(+), 2 deletions(-)
>
> diff --git a/qapi/misc.json b/qapi/misc.json
> index 7a70eaa3ffc..0ab235e41f7 100644
> --- a/qapi/misc.json
> +++ b/qapi/misc.json
> @@ -533,10 +533,12 @@
> #
> # Emitted when the guest changes the RTC time.
> #
> -# @offset: offset between base RTC clock (as specified by -rtc base), and
> -# new RTC clock value
> +# @offset: offset in seconds between base RTC clock (as specified
> +# by -rtc base), and new RTC clock value
> #
> # Note: This event is rate-limited.
> +# It is not guaranteed that the RTC in the system implements
> +# this event, or even that the system has an RTC at all.
> #
> # Since: 0.13
> #
Reviewed-by: Markus Armbruster <armbru@redhat.com>
- [PATCH v2 0/3] qapi: Move RTC_CHANGE back out of target schema, Peter Maydell, 2022/02/21
- [PATCH v2 1/3] qapi: Move RTC_CHANGE back out of target schema, Peter Maydell, 2022/02/21
- [PATCH v2 2/3] qapi: Document some missing details of RTC_CHANGE event, Peter Maydell, 2022/02/21
- [PATCH v2 3/3] hw/rtc: Compile pl031 once-only, Peter Maydell, 2022/02/21
- Re: [PATCH v2 0/3] qapi: Move RTC_CHANGE back out of target schema, Eric Auger, 2022/02/21
- [PATCH RFC 4/4] rtc: Have event RTC_CHANGE identify the RTC by QOM path, Markus Armbruster, 2022/02/22