CryptoPkg: Apply uncrustify changes

[mirror_edk2.git] / CryptoPkg / Library / BaseCryptLib / Pk / CryptPkcs7VerifyEkuRuntime.c

/** @file\r
  This module verifies that Enhanced Key Usages (EKU's) are present within\r
  a PKCS7 signature blob using OpenSSL.\r
\r
  Copyright (C) Microsoft Corporation. All Rights Reserved.\r
  Copyright (c) 2019, Intel Corporation. All rights reserved.<BR>\r
\r
  SPDX-License-Identifier: BSD-2-Clause-Patent\r
\r
**/\r
\r
#include "InternalCryptLib.h"\r
\r
/**\r
  This function receives a PKCS#7 formatted signature blob,\r
  looks for the EKU SEQUENCE blob, and if found then looks\r
  for all the required EKUs.  This function was created so that\r
  the Surface team can cut down on the number of Certificate\r
  Authorities (CA's) by checking EKU's on leaf signers for\r
  a specific product.  This prevents one product's certificate\r
  from signing another product's firmware or unlock blobs.\r
\r
  Return RETURN_UNSUPPORTED to indicate this interface is not supported.\r
\r
  @param[in]  Pkcs7Signature        The PKCS#7 signed information content block. An array\r
                                    containing the content block with both the signature,\r
                                    the signer's certificate, and any necessary intermediate\r
                                    certificates.\r
  @param[in]  Pkcs7SignatureSize    Number of bytes in pPkcs7Signature.\r
  @param[in]  RequiredEKUs          Array of null-terminated strings listing OIDs of\r
                                    required EKUs that must be present in the signature.\r
                                    All specified EKU's must be present in order to\r
                                    succeed.\r
  @param[in]  RequiredEKUsSize      Number of elements in the rgRequiredEKUs string.\r
                                    This parameter has a maximum of MAX_EKU_SEARCH.\r
  @param[in]  RequireAllPresent     If this is TRUE, then all of the specified EKU's\r
                                    must be present in the leaf signer.  If it is\r
                                    FALSE, then we will succeed if we find any\r
                                    of the specified EKU's.\r
\r
  @retval RETURN_UNSUPPORTED        The operation is not supported.\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
VerifyEKUsInPkcs7Signature (\r
  IN CONST UINT8   *Pkcs7Signature,\r
  IN CONST UINT32  SignatureSize,\r
  IN CONST CHAR8   *RequiredEKUs[],\r
  IN CONST UINT32  RequiredEKUsSize,\r
  IN BOOLEAN       RequireAllPresent\r
  )\r
{\r
  ASSERT (FALSE);\r
  return RETURN_UNSUPPORTED;\r
}\r