EmbeddedPkg/TimeBaseLib: Update comment blocks for API functions
This updates Doxygen comment blocks for API library functions. Cc: Leif Lindholm <leif@nuviainc.com> Cc: Ard Biesheuvel <ard.biesheuvel@arm.com> Signed-off-by: Nhi Pham <nhi@os.amperecomputing.com> Reviewed-by: Leif Lindholm <leif@nuviainc.com>
This commit is contained in:
@@ -2,6 +2,7 @@
|
||||
*
|
||||
* Copyright (c) 2016, Hisilicon Limited. All rights reserved.
|
||||
* Copyright (c) 2016-2019, Linaro Limited. All rights reserved.
|
||||
* Copyright (c) 2021, Ampere Computing LLC. All rights reserved.
|
||||
*
|
||||
* SPDX-License-Identifier: BSD-2-Clause-Patent
|
||||
*
|
||||
@@ -52,18 +53,45 @@
|
||||
#define SEC_PER_HOUR ((UINTN) 3600)
|
||||
#define SEC_PER_DAY ((UINTN) 86400)
|
||||
|
||||
/**
|
||||
Check if it is a leap year.
|
||||
|
||||
@param Time The UEFI time to be checked.
|
||||
|
||||
@retval TRUE It is a leap year.
|
||||
@retval FALSE It is NOT a leap year.
|
||||
|
||||
**/
|
||||
BOOLEAN
|
||||
EFIAPI
|
||||
IsLeapYear (
|
||||
IN EFI_TIME *Time
|
||||
);
|
||||
|
||||
/**
|
||||
Check if the day in the UEFI time is valid.
|
||||
|
||||
@param Time The UEFI time to be checked.
|
||||
|
||||
@retval TRUE Valid.
|
||||
@retval FALSE Invalid.
|
||||
|
||||
**/
|
||||
BOOLEAN
|
||||
EFIAPI
|
||||
IsDayValid (
|
||||
IN EFI_TIME *Time
|
||||
);
|
||||
|
||||
/**
|
||||
Check if the UEFI time is valid.
|
||||
|
||||
@param Time The UEFI time to be checked.
|
||||
|
||||
@retval TRUE Valid.
|
||||
@retval FALSE Invalid.
|
||||
|
||||
**/
|
||||
BOOLEAN
|
||||
EFIAPI
|
||||
IsTimeValid (
|
||||
@@ -71,8 +99,12 @@ IsTimeValid (
|
||||
);
|
||||
|
||||
/**
|
||||
Converts Epoch seconds (elapsed since 1970 JANUARY 01, 00:00:00 UTC) to EFI_TIME
|
||||
**/
|
||||
Converts Epoch seconds (elapsed since 1970 JANUARY 01, 00:00:00 UTC) to EFI_TIME.
|
||||
|
||||
@param EpochSeconds Epoch seconds.
|
||||
@param Time The time converted to UEFI format.
|
||||
|
||||
**/
|
||||
VOID
|
||||
EFIAPI
|
||||
EpochToEfiTime (
|
||||
@@ -81,8 +113,13 @@ EpochToEfiTime (
|
||||
);
|
||||
|
||||
/**
|
||||
Converts EFI_TIME to Epoch seconds (elapsed since 1970 JANUARY 01, 00:00:00 UTC)
|
||||
**/
|
||||
Converts EFI_TIME to Epoch seconds (elapsed since 1970 JANUARY 01, 00:00:00 UTC).
|
||||
|
||||
@param Time The UEFI time to be converted.
|
||||
|
||||
@return Number of seconds.
|
||||
|
||||
**/
|
||||
UINTN
|
||||
EFIAPI
|
||||
EfiTimeToEpoch (
|
||||
@@ -90,8 +127,13 @@ EfiTimeToEpoch (
|
||||
);
|
||||
|
||||
/**
|
||||
returns Day of the week [0-6] 0=Sunday
|
||||
**/
|
||||
Get the day of the week from the UEFI time.
|
||||
|
||||
@param Time The UEFI time to be calculated.
|
||||
|
||||
@return The day of the week: Sunday=0, Monday=1, ... Saturday=6
|
||||
|
||||
**/
|
||||
UINTN
|
||||
EfiTimeToWday (
|
||||
IN EFI_TIME *Time
|
||||
|
Reference in New Issue
Block a user