From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mail02.groups.io (mail02.groups.io [66.175.222.108]) by spool.mail.gandi.net (Postfix) with ESMTPS id B42C374003D for ; Fri, 2 Feb 2024 12:59:29 +0000 (UTC) DKIM-Signature: a=rsa-sha256; bh=PasNj0doFf9BMbelHS8Jt3fovpzkw3br7YlMDAQhLY8=; c=relaxed/simple; d=groups.io; h=Message-ID:Date:MIME-Version:Subject:To:Cc:References:From:In-Reply-To:Precedence:List-Subscribe:List-Help:Sender:List-Id:Mailing-List:Delivered-To:Reply-To:List-Unsubscribe-Post:List-Unsubscribe:Content-Language:Content-Type:Content-Transfer-Encoding; s=20140610; t=1706878768; v=1; b=r4BrnQb/RyWqCyZ8oTZ4Fs/RLhdCmSPRQrsCHsgcqdOOlucE1PuOc5Klavl1GvUTfDMbfgNl a4xgGEnI3EtlSkcnn8vLfoj+SKkFcPMTxHHeoWKGFsNppLPtJNsk246I1OcvBWysilhPZYww7Pv Lv49a3UmYCS3KAOMv0SH8cqU= X-Received: by 127.0.0.2 with SMTP id JQhUYY7687511xPW32SGvuJz; Fri, 02 Feb 2024 04:59:28 -0800 X-Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.129.124]) by mx.groups.io with SMTP id smtpd.web11.22003.1706878767747609923 for ; Fri, 02 Feb 2024 04:59:27 -0800 X-Received: from mimecast-mx02.redhat.com (mimecast-mx02.redhat.com [66.187.233.88]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-281-00cKRVOzMo-FOvUOn3udbQ-1; Fri, 02 Feb 2024 07:59:21 -0500 X-MC-Unique: 00cKRVOzMo-FOvUOn3udbQ-1 X-Received: from smtp.corp.redhat.com (int-mx04.intmail.prod.int.rdu2.redhat.com [10.11.54.4]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id 44CD685A58C; Fri, 2 Feb 2024 12:59:21 +0000 (UTC) X-Received: from [10.39.192.34] (unknown [10.39.192.34]) by smtp.corp.redhat.com (Postfix) with ESMTPS id 468F32026D66; Fri, 2 Feb 2024 12:59:20 +0000 (UTC) Message-ID: <2ca13851-5bce-2c82-bd3e-36e3f786d435@redhat.com> Date: Fri, 2 Feb 2024 13:59:13 +0100 MIME-Version: 1.0 Subject: Re: [edk2-devel] [PATCH V3 5/5] OvmfPkg: Align XenRealTimeClockLib function headers with return values To: Suqiang Ren , devel@edk2.groups.io Cc: Ard Biesheuvel , Jiewen Yao , Anthony Perard References: From: "Laszlo Ersek" In-Reply-To: X-Scanned-By: MIMEDefang 3.4.1 on 10.11.54.4 X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Precedence: Bulk List-Subscribe: List-Help: Sender: devel@edk2.groups.io List-Id: Mailing-List: list devel@edk2.groups.io; contact devel+owner@edk2.groups.io Reply-To: devel@edk2.groups.io,lersek@redhat.com List-Unsubscribe-Post: List-Unsubscribe=One-Click List-Unsubscribe: X-Gm-Message-State: wzhaxKzJwyPcZK7xvAGg0Glzx7686176AA= Content-Language: en-US Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-GND-Status: LEGIT Authentication-Results: spool.mail.gandi.net; dkim=pass header.d=groups.io header.s=20140610 header.b="r4BrnQb/"; dmarc=fail reason="SPF not aligned (relaxed), DKIM not aligned (relaxed)" header.from=redhat.com (policy=none); spf=pass (spool.mail.gandi.net: domain of bounce@groups.io designates 66.175.222.108 as permitted sender) smtp.mailfrom=bounce@groups.io CC Anthony On 2/2/24 09:20, Suqiang Ren wrote: > XenRealTimeClockLib is used to back the runtime services time functions, > so align the description of the function return values with the > defined values for these services as described in UEFI Spec 2.10. > > REF: UEFI spec 2.10 section 8 Services — Runtime Services > > Signed-off-by: Suqiang Ren > Cc: Ard Biesheuvel > Cc: Jiewen Yao > Cc: Laszlo Ersek > --- > .../XenRealTimeClockLib/XenRealTimeClockLib.c | 22 +++++++++++++++---- > 1 file changed, 18 insertions(+), 4 deletions(-) > > diff --git a/OvmfPkg/Library/XenRealTimeClockLib/XenRealTimeClockLib.c b/OvmfPkg/Library/XenRealTimeClockLib/XenRealTimeClockLib.c > index 30c258313135..6d7f452a7550 100644 > --- a/OvmfPkg/Library/XenRealTimeClockLib/XenRealTimeClockLib.c > +++ b/OvmfPkg/Library/XenRealTimeClockLib/XenRealTimeClockLib.c > @@ -80,6 +80,9 @@ EpochToEfiTime ( > @retval EFI_SUCCESS The operation completed successfully. > @retval EFI_INVALID_PARAMETER Time is NULL. > @retval EFI_DEVICE_ERROR The time could not be retrieved due to hardware error. > + @retval EFI_UNSUPPORTED This call is not supported by this platform at the time the call is made. > + The platform should describe this runtime service as unsupported at runtime > + via an EFI_RT_PROPERTIES_TABLE configuration table. > > **/ > EFI_STATUS > @@ -109,6 +112,9 @@ LibGetTime ( > @retval EFI_SUCCESS The operation completed successfully. > @retval EFI_INVALID_PARAMETER A time field is out of range. > @retval EFI_DEVICE_ERROR The time could not be set due to hardware error. > + @retval EFI_UNSUPPORTED This call is not supported by this platform at the time the call is made. > + The platform should describe this runtime service as unsupported at runtime > + via an EFI_RT_PROPERTIES_TABLE configuration table. > > **/ > EFI_STATUS > @@ -128,9 +134,13 @@ LibSetTime ( > @param Time The current alarm setting. > > @retval EFI_SUCCESS The alarm settings were returned. > - @retval EFI_INVALID_PARAMETER Any parameter is NULL. > + @retval EFI_INVALID_PARAMETER Enabled is NULL. > + @retval EFI_INVALID_PARAMETER Pending is NULL. > + @retval EFI_INVALID_PARAMETER Time is NULL. > @retval EFI_DEVICE_ERROR The wakeup time could not be retrieved due to a hardware error. > - @retval EFI_UNSUPPORTED A wakeup timer is not supported on this platform. > + @retval EFI_UNSUPPORTED This call is not supported by this platform at the time the call is made. > + The platform should describe this runtime service as unsupported at runtime > + via an EFI_RT_PROPERTIES_TABLE configuration table. > > **/ > EFI_STATUS > @@ -152,9 +162,13 @@ LibGetWakeupTime ( > > @retval EFI_SUCCESS If Enable is TRUE, then the wakeup alarm was enabled. If > Enable is FALSE, then the wakeup alarm was disabled. > - @retval EFI_INVALID_PARAMETER A time field is out of range. > + @retval EFI_INVALID_PARAMETER Enabled is NULL. > + @retval EFI_INVALID_PARAMETER Pending is NULL. > + @retval EFI_INVALID_PARAMETER Time is NULL. > @retval EFI_DEVICE_ERROR The wakeup time could not be set due to a hardware error. > - @retval EFI_UNSUPPORTED A wakeup timer is not supported on this platform. > + @retval EFI_UNSUPPORTED This call is not supported by this platform at the time the call is made. > + The platform should describe this runtime service as unsupported at runtime > + via an EFI_RT_PROPERTIES_TABLE configuration table. > > **/ > EFI_STATUS -=-=-=-=-=-=-=-=-=-=-=- Groups.io Links: You receive all messages sent to this group. View/Reply Online (#115046): https://edk2.groups.io/g/devel/message/115046 Mute This Topic: https://groups.io/mt/104115882/7686176 Group Owner: devel+owner@edk2.groups.io Unsubscribe: https://edk2.groups.io/g/devel/unsub [rebecca@openfw.io] -=-=-=-=-=-=-=-=-=-=-=-