From b86e8e7e9c4d4191d556a52fbd2c3e614ddb246e Mon Sep 17 00:00:00 2001
From: Peter Jones <pjones@redhat.com>
Date: Mon, 8 Oct 2018 13:31:30 -0400
Subject: Add CryptoPkg/Library/BaseCryptLib/ and CryptoPkg/Library/OpensslLib/

---
 CryptoPkg/Library/OpensslLib/Patch-HOWTO.txt | 61 ++++++++++++++++++++++++++++
 1 file changed, 61 insertions(+)
 create mode 100644 CryptoPkg/Library/OpensslLib/Patch-HOWTO.txt

(limited to 'CryptoPkg/Library/OpensslLib/Patch-HOWTO.txt')

diff --git a/CryptoPkg/Library/OpensslLib/Patch-HOWTO.txt b/CryptoPkg/Library/OpensslLib/Patch-HOWTO.txt
new file mode 100644
index 00000000..8418802a
--- /dev/null
+++ b/CryptoPkg/Library/OpensslLib/Patch-HOWTO.txt
@@ -0,0 +1,61 @@
+
+================================================================================
+                                 Introduction
+================================================================================
+  OpenSSL is a well-known open source implementation of SSL and TLS protocols.
+The core library implements the basic cryptographic functions and provides various
+utility functions. The OpenSSL library is widely used in variety of security
+products development as base crypto provider. (See http://www.openssl.org for more
+information for OpenSSL).
+  UEFI (Unified Extensible Firmware Interface) is a specification detailing the
+interfaces between OS and platform firmware. Several security features were
+introduced (e.g. Authenticated Variable Service, Driver Signing, etc) from UEFI
+2.2 (http://www.uefi.org). These security features highly depends on the
+cryptography. This patch will enable openssl building under UEFI environment.
+
+
+================================================================================
+                                OpenSSL-Version
+================================================================================
+  Current supported OpenSSL version for UEFI Crypto Library is 1.0.2k.
+    http://www.openssl.org/source/openssl-1.0.2k.tar.gz
+
+
+================================================================================
+                      HOW to Install Openssl for UEFI Building
+================================================================================
+1.  Download OpenSSL 1.0.2k from official website:
+    http://www.openssl.org/source/openssl-1.0.2k.tar.gz
+
+    NOTE: Some web browsers may rename the downloaded TAR file to openssl-1.0.2k.tar.tar.
+          When you do the download, rename the "openssl-1.0.2k.tar.tar" to
+          "openssl-1.0.2k.tar.gz" or rename the local downloaded file with ".tar.tar"
+          extension to ".tar.gz".
+
+2.  Extract TAR into CryptoPkg/Library/OpensslLib/openssl-1.0.2k
+
+    NOTE: If you use WinZip to unpack the openssl source in Windows, please
+          uncheck the WinZip smart CR/LF conversion option (WINZIP: Options -->
+          Configuration --> Miscellaneous --> "TAR file smart CR/LF conversion").
+
+3.  Apply this patch: EDKII_openssl-1.0.2k.patch, and make installation
+
+    For Windows Environment:
+    ------------------------
+    1) Make sure the patch utility has been installed in your machine.
+       Install Cygwin or get the patch utility binary from
+          http://gnuwin32.sourceforge.net/packages/patch.htm
+    2) cd $(WORKSPACE)\CryptoPkg\Library\OpensslLib\openssl-1.0.2k
+    3) patch -p1 -i ..\EDKII_openssl-1.0.2k.patch
+    4) cd ..
+    5) Install.cmd
+
+    For Linux* Environment:
+    -----------------------
+    1) Make sure the patch utility has been installed in your machine.
+       Patch utility is available from http://directory.fsf.org/project/patch/
+    2) cd $(WORKSPACE)/CryptoPkg/Library/OpensslLib/openssl-1.0.2k
+    3) patch -p1 -i ../EDKII_openssl-1.0.2k.patch
+    4) cd ..
+    5) ./Install.sh
+
-- 
cgit v1.2.3