No Description

Michael D Kinney 0f7fb5c5e5 UnitTestFrameworkPkg: Add public and private interfaces 4 years ago
.azurepipelines 106c7a991c .azurepipelines: Add Azure Pipelines YML configuration files 4 years ago
.mergify 4baa783d5e .mergify: Add Mergify YML pull request rules configuration file 4 years ago
.pytool 61364ab927 .pytool: Add CI support for host based unit tests with results 4 years ago
ArmPkg e3756ba90a ArmPkg/ArmSmcPsciResetSystemLib: remove EnterS3WithImmediateWake () 4 years ago
ArmPlatformPkg a6a835bdb1 ArmPlatformPkg/PrePeiCore: enable VFP at startup 4 years ago
ArmVirtPkg 9d1c9d0379 ArmVirtPkg: remove EnterS3WithImmediateWake () from ResetSystemLib 4 years ago
BaseTools 0a5d2b505c BaseTools/Plugin: Add HostBasedUnitTestRunner plugin 4 years ago
Conf 7d83e9e847 BaseTools:Delete FrameworkDatabase from BaseTools/Conf 5 years ago
CryptoPkg bd33a385ee CryptoPkg/CryptoPkg.dsc: Add build of Crypto libraries/modules 4 years ago
DynamicTablesPkg f413d9bee3 DynamicTablesPkg: Arm SRAT Table Generator 4 years ago
EmbeddedPkg 49054b6bb6 EmbeddedPkg: implement EDK2 IoMmu protocol wrapping DmaLib 4 years ago
EmulatorPkg 0b9ad0bc03 EmulatorPkg DSC and WinHost.inf: Update tool chain name to CLANGPDB 4 years ago
FatPkg 6d807aef57 FatPkg: Add YAML file for CI builds 4 years ago
FmpDevicePkg 2ed845b3c3 FmdDevicePkg/FmpDxe: Support Fmp Capsule Dependency. 4 years ago
IntelFsp2Pkg 9e639c1cb6 IntelFsp2Pkg/SplitFspBin.py: Command crashed when FV almost full. 4 years ago
IntelFsp2WrapperPkg 97eedf5dfb IntelFsp2WrapperPkg: Fix various typos 4 years ago
MdeModulePkg 322ac05f8b MdeModulePkg/PiDxeS3BootScriptLib: Fix potential numeric truncation (CVE-2019-14563) 4 years ago
MdePkg b238ce28f8 MdePkg/Include/Library: Add UnitTestLib class 4 years ago
NetworkPkg 4cca792399 NetworkPkg/HttpDxe: fix 32-bit truncation in HTTPS download 4 years ago
OvmfPkg 75839f977d OvmfPkg/PlatformPei: detect SMRAM at default SMBASE (for real) 4 years ago
PcAtChipsetPkg 6eacb857c1 PcAtChipsetPkg: remove EnterS3WithImmediateWake () from ResetSystemLib 4 years ago
SecurityPkg 01712e6508 SecurityPkg/TcgPhysicalPresenceLib: Replace the ASSERT with error code 4 years ago
ShellPkg 710ff7490a ShellPkg: acpiview: Update SRAT parser to ACPI 6.3 4 years ago
SignedCapsulePkg 3137900fc9 SignedCapsulePkg: Use BaseCryptLibNull to reduce package CI time 4 years ago
SourceLevelDebugPkg 4053587347 SourceLevelDebugPkg DebugCommLibUsb3: Address NULL ptr dereference case 4 years ago
StandaloneMmPkg 290a485d60 StandaloneMmPkg: Fix build failure - Bug 2253 4 years ago
UefiCpuPkg a9e3458ba7 UefiCpuPkg/MpInitLib: Always get CPUID & PlatformID in MicrocodeDetect() 4 years ago
UefiPayloadPkg eaea26b781 UefiPayloadPkg: remove EnterS3WithImmediateWake () from ResetSystemLib 4 years ago
UnitTestFrameworkPkg 0f7fb5c5e5 UnitTestFrameworkPkg: Add public and private interfaces 4 years ago
.gitignore 48760409cc .gitignore: Ignore python compiled files, extdeps, and vscode 4 years ago
.gitmodules 85af0b8116 ArmPkg: import Berkeley Softfloat library as git submodule 5 years ago
.mailmap 0ef6fbbd11 .mailmap: Add an entry for Yu-Chen Lin 4 years ago
License-History.txt f53de8aecb edk2: Add License-History.txt 5 years ago
License.txt 304bff7223 edk2: Change License.txt from 2-Clause BSD to BSD+Patent 5 years ago
Maintainers.txt c40c6351fa Maintainers.txt: update email address for Leif Lindholm 4 years ago
Readme.md e92b155740 Readme.md: Update EDK II CI build branch name 4 years ago
edksetup.bat cc617b6e14 edksetup.bat: Simplify the step to use CLANGPDB 4 years ago
edksetup.sh cf2d8d4978 edksetup.sh: remove redundant -?, -h and --help in options parsing 4 years ago
pip-requirements.txt ab5892f260 pip-requirements.txt: Add python pip requirements file 4 years ago

Readme.md

EDK II Project

A modern, feature-rich, cross-platform firmware development environment for the UEFI and PI specifications from www.uefi.org.

Build Status

Host Type Toolchain Branch Build Status Test Status Code Coverage
Windows VS2019 master
Ubuntu GCC master

More CI Build information

License Details

The majority of the content in the EDK II open source project uses a BSD-2-Clause Plus Patent License. The EDK II open source project contains the following components that are covered by additional licenses:

The EDK II Project is composed of packages. The maintainers for each package are listed in Maintainers.txt.

Resources

Code Contributions

To make a contribution to a TianoCore project, follow these steps.

  1. Create a change description in the format specified below to use in the source control commit log.
  2. Your commit message must include your Signed-off-by signature
  3. Submit your code to the TianoCore project using the process that the project documents on its web page. If the process is not documented, then submit the code on development email list for the project.
  4. It is preferred that contributions are submitted using the same copyright license as the base project. When that is not possible, then contributions using the following licenses can be accepted:

For documentation:

Contributions of code put into the public domain can also be accepted.

Contributions using other licenses might be accepted, but further review will be required.

Developer Certificate of Origin

Your change description should use the standard format for a commit message, and must include your Signed-off-by signature.

In order to keep track of who did what, all patches contributed must include a statement that to the best of the contributor’s knowledge they have the right to contribute it under the specified license.

The test for this is as specified in the Developer’s Certificate of Origin (DCO) 1.1. The contributor certifies compliance by adding a line saying

Signed-off-by: Developer Name developer@example.org

where Developer Name is the contributor’s real name, and the email address is one the developer is reachable through at the time of contributing.

Developer's Certificate of Origin 1.1

By making a contribution to this project, I certify that:

(a) The contribution was created in whole or in part by me and I
    have the right to submit it under the open source license
    indicated in the file; or

(b) The contribution is based upon previous work that, to the best
    of my knowledge, is covered under an appropriate open source
    license and I have the right under that license to submit that
    work with modifications, whether created in whole or in part
    by me, under the same open source license (unless I am
    permitted to submit under a different license), as indicated
    in the file; or

(c) The contribution was provided directly to me by some other
    person who certified (a), (b) or (c) and I have not modified
    it.

(d) I understand and agree that this project and the contribution
    are public and that a record of the contribution (including all
    personal information I submit with it, including my sign-off) is
    maintained indefinitely and may be redistributed consistent with
    this project or the open source license(s) involved.

Sample Change Description / Commit Message

From: Contributor Name <contributor@example.com>
Subject: [Repository/Branch PATCH] Pkg-Module: Brief-single-line-summary

Full-commit-message

Signed-off-by: Contributor Name <contributor@example.com>

Notes for sample patch email

  • The first line of commit message is taken from the email’s subject line following [Repository/Branch PATCH]. The remaining portion of the commit message is the email’s content.
  • git format-patch is one way to create this format

Definitions for sample patch email

  • Repository is the identifier of the repository the patch applies. This identifier should only be provided for repositories other than edk2. For example edk2-BuildSpecification or staging.
  • Branch is the identifier of the branch the patch applies. This identifier should only be provided for branches other than edk2/master. For example edk2/UDK2015, edk2-BuildSpecification/release/1.27, or staging/edk2-test.
  • Module is a short identifier for the affected code or documentation. For example MdePkg, MdeModulePkg/UsbBusDxe, Introduction, or EDK II INF File Format.
  • Brief-single-line-summary is a short summary of the change.
  • The entire first line should be less than ~70 characters.
  • Full-commit-message a verbose multiple line comment describing the change. Each line should be less than ~70 characters.
  • Signed-off-by is the contributor’s signature identifying them by their real/legal name and their email address.

Submodules

Submodule in EDK II is allowed but submodule chain should be avoided as possible as we can. Currently EDK II contains the following submodules

  • CryptoPkg/Library/OpensslLib/openssl
  • ArmPkg/Library/ArmSoftFloatLib/berkeley-softfloat-3

ArmSoftFloatLib is actually required by OpensslLib. It’s inevitable in openssl-1.1.1 (since stable201905) for floating point parameter conversion, but should be dropped once there’s no such need in future release of openssl.

To get a full, buildable EDK II repository, use following steps of git command

$ git clone https://github.com/tianocore/edk2.git
$ cd edk2
$ git submodule update --init
$ cd ..

If there’s update for submodules, use following git commands to get the latest submodules code.

$ cd edk2
$ git pull
$ git submodule update

Note: When cloning submodule repos, ‘–recursive’ option is not recommended. EDK II itself will not use any code/feature from submodules in above submodules. So using ‘–recursive’ adds a dependency on being able to reach servers we do not actually want any code from, as well as needlessly downloading code we will not use.