/** @file | |
Redfish HTTP cache library helps Redfish application to get Redfish resource | |
from BMC with cache mechanism enabled. | |
Copyright (c) 2023-2024, NVIDIA CORPORATION & AFFILIATES. All rights reserved. | |
SPDX-License-Identifier: BSD-2-Clause-Patent | |
**/ | |
#include <Library/BaseLib.h> | |
#include <Library/DebugLib.h> | |
#include <Library/RedfishHttpLib.h> | |
#include <Library/UefiBootServicesTableLib.h> | |
#include <Library/UefiLib.h> | |
EDKII_REDFISH_HTTP_PROTOCOL *mRedfishHttpProtocol = NULL; | |
/** | |
This function create Redfish service. It's caller's responsibility to free returned | |
Redfish service by calling FreeService (). | |
@param[in] RedfishConfigServiceInfo Redfish config service information. | |
@retval REDFISH_SERVICE Redfish service is created. | |
@retval NULL Errors occur. | |
**/ | |
REDFISH_SERVICE | |
RedfishCreateService ( | |
IN REDFISH_CONFIG_SERVICE_INFORMATION *RedfishConfigServiceInfo | |
) | |
{ | |
if (mRedfishHttpProtocol == NULL) { | |
return NULL; | |
} | |
return mRedfishHttpProtocol->CreateService ( | |
mRedfishHttpProtocol, | |
RedfishConfigServiceInfo | |
); | |
} | |
/** | |
This function free resources in Redfish service. RedfishService is no longer available | |
after this function returns successfully. | |
@param[in] RedfishService Pointer to Redfish service to be released. | |
@retval EFI_SUCCESS Resource is released successfully. | |
@retval Others Errors occur. | |
**/ | |
EFI_STATUS | |
RedfishCleanupService ( | |
IN REDFISH_SERVICE RedfishService | |
) | |
{ | |
if (mRedfishHttpProtocol == NULL) { | |
return EFI_NOT_READY; | |
} | |
return mRedfishHttpProtocol->FreeService ( | |
mRedfishHttpProtocol, | |
RedfishService | |
); | |
} | |
/** | |
This function returns JSON value in given RedfishPayload. Returned JSON value | |
is a reference to the JSON value in RedfishPayload. Any modification to returned | |
JSON value will change JSON value in RedfishPayload. | |
@param[in] RedfishPayload Pointer to Redfish payload. | |
@retval EDKII_JSON_VALUE JSON value is returned. | |
@retval NULL Errors occur. | |
**/ | |
EDKII_JSON_VALUE | |
RedfishJsonInPayload ( | |
IN REDFISH_PAYLOAD RedfishPayload | |
) | |
{ | |
if (mRedfishHttpProtocol == NULL) { | |
return NULL; | |
} | |
return mRedfishHttpProtocol->JsonInPayload ( | |
mRedfishHttpProtocol, | |
RedfishPayload | |
); | |
} | |
/** | |
This function free resources in Request. Request is no longer available | |
after this function returns successfully. | |
@param[in] Request HTTP request to be released. | |
@retval EFI_SUCCESS Resource is released successfully. | |
@retval Others Errors occur. | |
**/ | |
EFI_STATUS | |
RedfishHttpFreeRequest ( | |
IN REDFISH_REQUEST *Request | |
) | |
{ | |
if (mRedfishHttpProtocol == NULL) { | |
return EFI_NOT_READY; | |
} | |
return mRedfishHttpProtocol->FreeRequest ( | |
mRedfishHttpProtocol, | |
Request | |
); | |
} | |
/** | |
This function free resources in Response. Response is no longer available | |
after this function returns successfully. | |
@param[in] Response HTTP response to be released. | |
@retval EFI_SUCCESS Resource is released successfully. | |
@retval Others Errors occur. | |
**/ | |
EFI_STATUS | |
RedfishHttpFreeResponse ( | |
IN REDFISH_RESPONSE *Response | |
) | |
{ | |
if (mRedfishHttpProtocol == NULL) { | |
return EFI_NOT_READY; | |
} | |
return mRedfishHttpProtocol->FreeResponse ( | |
mRedfishHttpProtocol, | |
Response | |
); | |
} | |
/** | |
This function expire the cached response of given URI. | |
@param[in] Uri Target response of URI. | |
@retval EFI_SUCCESS Target response is expired successfully. | |
@retval Others Errors occur. | |
**/ | |
EFI_STATUS | |
RedfishHttpExpireResponse ( | |
IN EFI_STRING Uri | |
) | |
{ | |
if (mRedfishHttpProtocol == NULL) { | |
return EFI_NOT_READY; | |
} | |
return mRedfishHttpProtocol->ExpireResponse ( | |
mRedfishHttpProtocol, | |
Uri | |
); | |
} | |
/** | |
Get redfish resource from given resource URI with cache mechanism | |
supported. It's caller's responsibility to Response by calling | |
RedfishHttpFreeResponse (). | |
@param[in] Service Redfish service instance to perform HTTP GET. | |
@param[in] Uri Target resource URI. | |
@param[in] Request Additional request context. This is optional. | |
@param[out] Response HTTP response from redfish service. | |
@param[in] UseCache If it is TRUE, this function will search for | |
cache first. If it is FALSE, this function | |
will query Redfish URI directly. | |
@retval EFI_SUCCESS Resource is returned successfully. | |
@retval Others Errors occur. | |
**/ | |
EFI_STATUS | |
RedfishHttpGetResource ( | |
IN REDFISH_SERVICE Service, | |
IN EFI_STRING Uri, | |
IN REDFISH_REQUEST *Request OPTIONAL, | |
OUT REDFISH_RESPONSE *Response, | |
IN BOOLEAN UseCache | |
) | |
{ | |
if (mRedfishHttpProtocol == NULL) { | |
return EFI_NOT_READY; | |
} | |
return mRedfishHttpProtocol->GetResource ( | |
mRedfishHttpProtocol, | |
Service, | |
Uri, | |
Request, | |
Response, | |
UseCache | |
); | |
} | |
/** | |
Perform HTTP PATCH to send redfish resource to given resource URI. | |
It's caller's responsibility to free Response by calling RedfishHttpFreeResponse (). | |
@param[in] Service Redfish service instance to perform HTTP PATCH. | |
@param[in] Uri Target resource URI. | |
@param[in] Content Data to patch. | |
@param[out] Response HTTP response from redfish service. | |
@retval EFI_SUCCESS Resource is returned successfully. | |
@retval Others Errors occur. | |
**/ | |
EFI_STATUS | |
RedfishHttpPatchResource ( | |
IN REDFISH_SERVICE Service, | |
IN EFI_STRING Uri, | |
IN CHAR8 *Content, | |
OUT REDFISH_RESPONSE *Response | |
) | |
{ | |
if (mRedfishHttpProtocol == NULL) { | |
return EFI_NOT_READY; | |
} | |
return mRedfishHttpProtocol->PatchResource ( | |
mRedfishHttpProtocol, | |
Service, | |
Uri, | |
Content, | |
0, | |
NULL, | |
Response | |
); | |
} | |
/** | |
Perform HTTP PATCH to send redfish resource to given resource URI. | |
It's caller's responsibility to free Response by calling RedfishHttpFreeResponse (). | |
@param[in] Service Redfish service instance to perform HTTP PATCH. | |
@param[in] Uri Target resource URI. | |
@param[in] Content Data to patch. | |
@param[in] ContentSize Size of the Content to be send to Redfish service. | |
This is optional. When ContentSize is 0, ContentSize | |
is the size of Content. | |
@param[in] ContentType Type of the Content to be send to Redfish service. | |
This is optional. | |
@param[out] Response HTTP response from redfish service. | |
@retval EFI_SUCCESS Resource is returned successfully. | |
@retval Others Errors occur. | |
**/ | |
EFI_STATUS | |
RedfishHttpPatchResourceEx ( | |
IN REDFISH_SERVICE Service, | |
IN EFI_STRING Uri, | |
IN CHAR8 *Content, | |
IN UINTN ContentSize OPTIONAL, | |
IN CHAR8 *ContentType OPTIONAL, | |
OUT REDFISH_RESPONSE *Response | |
) | |
{ | |
if (mRedfishHttpProtocol == NULL) { | |
return EFI_NOT_READY; | |
} | |
return mRedfishHttpProtocol->PatchResource ( | |
mRedfishHttpProtocol, | |
Service, | |
Uri, | |
Content, | |
ContentSize, | |
ContentType, | |
Response | |
); | |
} | |
/** | |
Perform HTTP PUT to send redfish resource to given resource URI. | |
It's caller's responsibility to free Response by calling RedfishHttpFreeResponse (). | |
@param[in] Service Redfish service instance to perform HTTP PUT. | |
@param[in] Uri Target resource URI. | |
@param[in] Content Data to put. | |
@param[out] Response HTTP response from redfish service. | |
@retval EFI_SUCCESS Resource is returned successfully. | |
@retval Others Errors occur. | |
**/ | |
EFI_STATUS | |
RedfishHttpPutResource ( | |
IN REDFISH_SERVICE Service, | |
IN EFI_STRING Uri, | |
IN CHAR8 *Content, | |
OUT REDFISH_RESPONSE *Response | |
) | |
{ | |
if (mRedfishHttpProtocol == NULL) { | |
return EFI_NOT_READY; | |
} | |
return mRedfishHttpProtocol->PutResource ( | |
mRedfishHttpProtocol, | |
Service, | |
Uri, | |
Content, | |
0, | |
NULL, | |
Response | |
); | |
} | |
/** | |
Perform HTTP PUT to send redfish resource to given resource URI. | |
It's caller's responsibility to free Response by calling RedfishHttpFreeResponse (). | |
@param[in] Service Redfish service instance to perform HTTP PUT. | |
@param[in] Uri Target resource URI. | |
@param[in] Content Data to put. | |
@param[in] ContentSize Size of the Content to be send to Redfish service. | |
This is optional. When ContentSize is 0, ContentSize | |
is the size of Content. | |
@param[in] ContentType Type of the Content to be send to Redfish service. | |
This is optional. | |
@param[out] Response HTTP response from redfish service. | |
@retval EFI_SUCCESS Resource is returned successfully. | |
@retval Others Errors occur. | |
**/ | |
EFI_STATUS | |
RedfishHttpPutResourceEx ( | |
IN REDFISH_SERVICE Service, | |
IN EFI_STRING Uri, | |
IN CHAR8 *Content, | |
IN UINTN ContentSize OPTIONAL, | |
IN CHAR8 *ContentType OPTIONAL, | |
OUT REDFISH_RESPONSE *Response | |
) | |
{ | |
if (mRedfishHttpProtocol == NULL) { | |
return EFI_NOT_READY; | |
} | |
return mRedfishHttpProtocol->PutResource ( | |
mRedfishHttpProtocol, | |
Service, | |
Uri, | |
Content, | |
ContentSize, | |
ContentType, | |
Response | |
); | |
} | |
/** | |
Perform HTTP POST to send redfish resource to given resource URI. | |
It's caller's responsibility to free Response by calling RedfishHttpFreeResponse (). | |
@param[in] Service Redfish service instance to perform HTTP POST. | |
@param[in] Uri Target resource URI. | |
@param[in] Content Data to post. | |
@param[out] Response HTTP response from redfish service. | |
@retval EFI_SUCCESS Resource is returned successfully. | |
@retval Others Errors occur. | |
**/ | |
EFI_STATUS | |
RedfishHttpPostResource ( | |
IN REDFISH_SERVICE Service, | |
IN EFI_STRING Uri, | |
IN CHAR8 *Content, | |
OUT REDFISH_RESPONSE *Response | |
) | |
{ | |
if (mRedfishHttpProtocol == NULL) { | |
return EFI_NOT_READY; | |
} | |
return mRedfishHttpProtocol->PostResource ( | |
mRedfishHttpProtocol, | |
Service, | |
Uri, | |
Content, | |
0, | |
NULL, | |
Response | |
); | |
} | |
/** | |
Perform HTTP POST to send redfish resource to given resource URI. | |
It's caller's responsibility to free Response by calling RedfishHttpFreeResponse (). | |
@param[in] Service Redfish service instance to perform HTTP POST. | |
@param[in] Uri Target resource URI. | |
@param[in] Content Data to post. | |
@param[in] ContentSize Size of the Content to be send to Redfish service. | |
This is optional. When ContentSize is 0, ContentSize | |
is the size of Content. | |
@param[in] ContentType Type of the Content to be send to Redfish service. | |
This is optional. | |
@param[out] Response HTTP response from redfish service. | |
@retval EFI_SUCCESS Resource is returned successfully. | |
@retval Others Errors occur. | |
**/ | |
EFI_STATUS | |
RedfishHttpPostResourceEx ( | |
IN REDFISH_SERVICE Service, | |
IN EFI_STRING Uri, | |
IN CHAR8 *Content, | |
IN UINTN ContentSize OPTIONAL, | |
IN CHAR8 *ContentType OPTIONAL, | |
OUT REDFISH_RESPONSE *Response | |
) | |
{ | |
if (mRedfishHttpProtocol == NULL) { | |
return EFI_NOT_READY; | |
} | |
return mRedfishHttpProtocol->PostResource ( | |
mRedfishHttpProtocol, | |
Service, | |
Uri, | |
Content, | |
ContentSize, | |
ContentType, | |
Response | |
); | |
} | |
/** | |
Perform HTTP DELETE to delete redfish resource on given resource URI. | |
It's caller's responsibility to free Response by calling RedfishHttpFreeResponse (). | |
@param[in] Service Redfish service instance to perform HTTP DELETE. | |
@param[in] Uri Target resource URI. | |
@param[out] Response HTTP response from redfish service. | |
@retval EFI_SUCCESS Resource is returned successfully. | |
@retval Others Errors occur. | |
**/ | |
EFI_STATUS | |
RedfishHttpDeleteResource ( | |
IN REDFISH_SERVICE Service, | |
IN EFI_STRING Uri, | |
OUT REDFISH_RESPONSE *Response | |
) | |
{ | |
if (mRedfishHttpProtocol == NULL) { | |
return EFI_NOT_READY; | |
} | |
return mRedfishHttpProtocol->DeleteResource ( | |
mRedfishHttpProtocol, | |
Service, | |
Uri, | |
NULL, | |
0, | |
NULL, | |
Response | |
); | |
} | |
/** | |
Perform HTTP DELETE to delete redfish resource on given resource URI. | |
It's caller's responsibility to free Response by calling RedfishHttpFreeResponse (). | |
@param[in] Service Redfish service instance to perform HTTP DELETE. | |
@param[in] Uri Target resource URI. | |
@param[in] Content JSON represented properties to be deleted. This is | |
optional. | |
@param[in] ContentSize Size of the Content to be send to Redfish service. | |
This is optional. When ContentSize is 0, ContentSize | |
is the size of Content if Content is not NULL. | |
@param[in] ContentType Type of the Content to be send to Redfish service. | |
This is optional. | |
@param[out] Response HTTP response from redfish service. | |
@retval EFI_SUCCESS Resource is returned successfully. | |
@retval Others Errors occur. | |
**/ | |
EFI_STATUS | |
RedfishHttpDeleteResourceEx ( | |
IN REDFISH_SERVICE Service, | |
IN EFI_STRING Uri, | |
IN CHAR8 *Content OPTIONAL, | |
IN UINTN ContentSize OPTIONAL, | |
IN CHAR8 *ContentType OPTIONAL, | |
OUT REDFISH_RESPONSE *Response | |
) | |
{ | |
if (mRedfishHttpProtocol == NULL) { | |
return EFI_NOT_READY; | |
} | |
return mRedfishHttpProtocol->DeleteResource ( | |
mRedfishHttpProtocol, | |
Service, | |
Uri, | |
Content, | |
ContentSize, | |
ContentType, | |
Response | |
); | |
} | |
/** | |
Callback function when gEdkIIRedfishHttpProtocolGuid is installed. | |
@param[in] Event Event whose notification function is being invoked. | |
@param[in] Context Pointer to the notification function's context. | |
**/ | |
VOID | |
EFIAPI | |
RedfishHttpProtocolIsReady ( | |
IN EFI_EVENT Event, | |
IN VOID *Context | |
) | |
{ | |
EFI_STATUS Status; | |
if (mRedfishHttpProtocol != NULL) { | |
gBS->CloseEvent (Event); | |
return; | |
} | |
Status = gBS->LocateProtocol ( | |
&gEdkIIRedfishHttpProtocolGuid, | |
NULL, | |
(VOID **)&mRedfishHttpProtocol | |
); | |
if (EFI_ERROR (Status)) { | |
return; | |
} | |
gBS->CloseEvent (Event); | |
} | |
/** | |
Initial HTTP library instance. | |
@param[in] ImageHandle The image handle. | |
@param[in] SystemTable The system table. | |
@retval EFI_SUCCESS Initial library successfully. | |
@retval Other Return error status. | |
**/ | |
EFI_STATUS | |
EFIAPI | |
RedfishHttpConstructor ( | |
IN EFI_HANDLE ImageHandle, | |
IN EFI_SYSTEM_TABLE *SystemTable | |
) | |
{ | |
VOID *Registration; | |
EfiCreateProtocolNotifyEvent ( | |
&gEdkIIRedfishHttpProtocolGuid, | |
TPL_CALLBACK, | |
RedfishHttpProtocolIsReady, | |
NULL, | |
&Registration | |
); | |
return EFI_SUCCESS; | |
} |