ReadMe.rst

   1 ==============
   2 EDK II Project
   3 ==============
   4
   5 A modern, feature-rich, cross-platform firmware development
   6 environment for the UEFI and PI specifications from www.uefi.org.
   7
   8 Core CI Build Status
   9 --------------------
  10
  11 ============================= ================= =============== ===================
  12  Host Type & Toolchain        Build Status      Test Status     Code Coverage
  13 ============================= ================= =============== ===================
  14 Windows_VS2019_               |WindowsCiBuild|  |WindowsCiTest| |WindowsCiCoverage|
  15 Ubuntu_GCC5_                  |UbuntuCiBuild|   |UbuntuCiTest|  |UbuntuCiCoverage|
  16 ============================= ================= =============== ===================
  17
  18 `More CI Build information <.pytool/Readme.md>`__
  19
  20 Platform CI Build Status
  21 ------------------------
  22
  23 Microsoft Windows VS2019
  24 ````````````````````````
  25
  26 ============================= ================= ============= ============= ==============
  27  Toolchain                    CONFIG            DEBUG         RELEASE       NOOPT
  28 ============================= ================= ============= ============= ==============
  29 EmulatorPkg_Win_VS2019_       | IA32            |em32d|       |em32r|       |em32n|
  30 |                             | X64             |em64d|       |em64r|       |em64n|
  31 |                             | IA32 FULL       |em32fd|      |em32fr|      |em32fn|
  32 |                             | X64 FULL        |em64fd|      |em64fr|      |em64fn|
  33 OvmfPkg_Win_VS2019_           | IA32            |op32d|       |op32r|       |op32n|
  34 |                             | X64             |op64d|       |op64r|       |op64n|
  35 |                             | IA32 X64        |op3264d|     |op3264r|     |op3264n|
  36 |                             | IA32 X64 FULL   |op3264fd|    |op3264fr|    |op3264fn|
  37 ============================= ================= ============= ============= ==============
  38
  39 Ubuntu 18.04 GCC5
  40 `````````````````
  41
  42 ============================= ================= ============= ============= ==============
  43  Toolchain                    CONFIG            DEBUG         RELEASE       NOOPT
  44 ============================= ================= ============= ============= ==============
  45 ArmVirtPkg_Ubuntu_GCC5_       | AARCH64         |avAArch64du| |avAArch64ru| |avAArch64nu|
  46 |                             | ARM             |avArmdu|     |avArmru|     |avArmnu|
  47 EmulatorPkg_Ubuntu_GCC5_      | IA32            |em32du|      |em32ru|      |em32nu|
  48 |                             | X64             |em64du|      |em64ru|      |em64nu|
  49 |                             | IA32 FULL       |em32fdu|     |em32fru|     |em32fnu|
  50 |                             | X64 FULL        |em64fdu|     |em64fru|     |em64fnu|
  51 OvmfPkg_Ubuntu_GCC5_          | IA32            |op32du|      |op32ru|      |op32nu|
  52 |                             | X64             |op64du|      |op64ru|      |op64nu|
  53 |                             | IA32 X64        |op3264du|    |op3264ru|    |op3264nu|
  54 |                             | IA32 X64 FULL   |op3264fdu|   |op3264fru|   |op3264fru|
  55 ============================= ================= ============= ============= ==============
  56
  57 |TCBZ_2668|_ - EmulatorPkg Ubuntu GCC5 Segfaults during execution.
  58
  59 |TCBZ_2639|_ - EmulatorPkg Ubuntu GCC5 Segfaults during execution.
  60
  61 `More ArmVirtPkg CI Build Information <ArmVirtPkg/PlatformCI/ReadMe.md>`__
  62
  63 `More EmulatorPkg CI Build Information <EmulatorPkg/PlatformCI/ReadMe.md>`__
  64
  65 `More OvmfPkg CI Build Information <OvmfPkg/PlatformCI/ReadMe.md>`__
  66
  67
  68 License Details
  69 ---------------
  70
  71 The majority of the content in the EDK II open source project uses a
  72 `BSD-2-Clause Plus Patent License <License.txt>`__. The EDK II open
  73 source project contains the following components that are covered by additional
  74 licenses:
  75
  76 -  `BaseTools/Source/C/LzmaCompress <BaseTools/Source/C/LzmaCompress/LZMA-SDK-README.txt>`__
  77 -  `BaseTools/Source/C/VfrCompile/Pccts <BaseTools/Source/C/VfrCompile/Pccts/RIGHTS>`__
  78 -  `CryptoPkg\Library\BaseCryptLib\SysCall\inet_pton.c <CryptoPkg\Library\BaseCryptLib\SysCall\inet_pton.c>`__
  79 -  `CryptoPkg\Library\Include\crypto\dso_conf.h <https://github.com/openssl/openssl/blob/e2e09d9fba1187f8d6aafaa34d4172f56f1ffb72/LICENSE>`__
  80 -  `CryptoPkg\Library\Include\openssl\opensslconf.h <https://github.com/openssl/openssl/blob/e2e09d9fba1187f8d6aafaa34d4172f56f1ffb72/LICENSE>`__
  81 -  `EmbeddedPkg/Library/FdtLib <EmbeddedPkg/Library/FdtLib/fdt.c>`__.  (EDK II uses BSD License)
  82 -  `EmbeddedPkg/Include/fdt.h <EmbeddedPkg/Include/fdt.h>`__.  (EDK II uses BSD Licence)
  83 -  `EmbeddedPkg/Include/libfdt.h <EmbeddedPkg/Include/libfdt.h>`__.  (EDK II uses BSD License)
  84 -  `MdeModulePkg/Library/LzmaCustomDecompressLib <MdeModulePkg/Library/LzmaCustomDecompressLib/LZMA-SDK-README.txt>`__
  85 -  `OvmfPkg <OvmfPkg/License.txt>`__
  86
  87 The EDK II open source project uses content from upstream projects as git submodules
  88 that are covered by additional licenses.
  89
  90 -  `ArmPkg/Library/ArmSoftFloatLib/berkeley-softfloat-3 <https://github.com/ucb-bar/berkeley-softfloat-3/blob/b64af41c3276f97f0e181920400ee056b9c88037/COPYING.txt>`__
  91 -  `BaseTools/Source/C/BrotliCompress/brotli <https://github.com/google/brotli/blob/666c3280cc11dc433c303d79a83d4ffbdd12cc8d/LICENSE>`__
  92 -  `CryptoPkg/Library/OpensslLib/openssl <https://github.com/openssl/openssl/blob/e2e09d9fba1187f8d6aafaa34d4172f56f1ffb72/LICENSE>`__
  93 -  `MdeModulePkg/Library/BrotliCustomDecompressLib/brotli <https://github.com/google/brotli/blob/666c3280cc11dc433c303d79a83d4ffbdd12cc8d/LICENSE>`__
  94 -  `MdeModulePkg/Universal/RegularExpressionDxe/oniguruma <https://github.com/kkos/oniguruma/blob/abfc8ff81df4067f309032467785e06975678f0d/COPYING>`__
  95 -  `UnitTestFrameworkPkg/Library/CmockaLib/cmocka <https://github.com/tianocore/edk2-cmocka/blob/f5e2cd77c88d9f792562888d2b70c5a396bfbf7a/COPYING>`__
  96 -  `RedfishPkg/Library/JsonLib/jansson <https://github.com/akheron/jansson/blob/2882ead5bb90cf12a01b07b2c2361e24960fae02/LICENSE>`__
  97
  98 The EDK II Project is composed of packages. The maintainers for each package
  99 are listed in `Maintainers.txt <Maintainers.txt>`__.
 100
 101 Resources
 102 ---------
 103
 104 -  `TianoCore <http://www.tianocore.org>`__
 105 -  `EDK
 106    II <https://github.com/tianocore/tianocore.github.io/wiki/EDK-II>`__
 107 -  `Getting Started with EDK
 108    II <https://github.com/tianocore/tianocore.github.io/wiki/Getting-Started-with-EDK-II>`__
 109 -  `Mailing
 110    Lists <https://github.com/tianocore/tianocore.github.io/wiki/Mailing-Lists>`__
 111 -  `TianoCore Bugzilla <https://bugzilla.tianocore.org>`__
 112 -  `How To
 113    Contribute <https://github.com/tianocore/tianocore.github.io/wiki/How-To-Contribute>`__
 114 -  `Release
 115    Planning <https://github.com/tianocore/tianocore.github.io/wiki/EDK-II-Release-Planning>`__
 116
 117 Code Contributions
 118 ------------------
 119
 120 To make a contribution to a TianoCore project, follow these steps.
 121
 122 #. Create a change description in the format specified below to
 123     use in the source control commit log.
 124 #. Your commit message must include your ``Signed-off-by`` signature
 125 #. Submit your code to the TianoCore project using the process
 126     that the project documents on its web page. If the process is
 127     not documented, then submit the code on development email list
 128     for the project.
 129 #. It is preferred that contributions are submitted using the same
 130     copyright license as the base project. When that is not possible,
 131     then contributions using the following licenses can be accepted:
 132
 133 -  BSD (2-clause): http://opensource.org/licenses/BSD-2-Clause
 134 -  BSD (3-clause): http://opensource.org/licenses/BSD-3-Clause
 135 -  MIT: http://opensource.org/licenses/MIT
 136 -  Python-2.0: http://opensource.org/licenses/Python-2.0
 137 -  Zlib: http://opensource.org/licenses/Zlib
 138
 139 For documentation:
 140
 141 -  FreeBSD Documentation License
 142     https://www.freebsd.org/copyright/freebsd-doc-license.html
 143
 144 Contributions of code put into the public domain can also be accepted.
 145
 146 Contributions using other licenses might be accepted, but further
 147 review will be required.
 148
 149 Developer Certificate of Origin
 150 -------------------------------
 151
 152 Your change description should use the standard format for a
 153 commit message, and must include your ``Signed-off-by`` signature.
 154
 155 In order to keep track of who did what, all patches contributed must
 156 include a statement that to the best of the contributor's knowledge
 157 they have the right to contribute it under the specified license.
 158
 159 The test for this is as specified in the `Developer's Certificate of
 160 Origin (DCO) 1.1 <https://developercertificate.org/>`__. The contributor
 161 certifies compliance by adding a line saying
 162
 163 Signed-off-by: Developer Name developer@example.org
 164
 165 where ``Developer Name`` is the contributor's real name, and the email
 166 address is one the developer is reachable through at the time of
 167 contributing.
 168
 169 ::
 170
 171     Developer's Certificate of Origin 1.1
 172
 173     By making a contribution to this project, I certify that:
 174
 175     (a) The contribution was created in whole or in part by me and I
 176         have the right to submit it under the open source license
 177         indicated in the file; or
 178
 179     (b) The contribution is based upon previous work that, to the best
 180         of my knowledge, is covered under an appropriate open source
 181         license and I have the right under that license to submit that
 182         work with modifications, whether created in whole or in part
 183         by me, under the same open source license (unless I am
 184         permitted to submit under a different license), as indicated
 185         in the file; or
 186
 187     (c) The contribution was provided directly to me by some other
 188         person who certified (a), (b) or (c) and I have not modified
 189         it.
 190
 191     (d) I understand and agree that this project and the contribution
 192         are public and that a record of the contribution (including all
 193         personal information I submit with it, including my sign-off) is
 194         maintained indefinitely and may be redistributed consistent with
 195         this project or the open source license(s) involved.
 196
 197 Sample Change Description / Commit Message
 198 ------------------------------------------
 199
 200 ::
 201
 202     From: Contributor Name <contributor@example.com>
 203     Subject: [Repository/Branch PATCH] Pkg-Module: Brief-single-line-summary
 204
 205     Full-commit-message
 206
 207     Signed-off-by: Contributor Name <contributor@example.com>
 208
 209 Notes for sample patch email
 210 ````````````````````````````
 211
 212 -  The first line of commit message is taken from the email's subject
 213    line following ``[Repository/Branch PATCH]``. The remaining portion
 214    of the commit message is the email's content.
 215 -  ``git format-patch`` is one way to create this format
 216
 217 Definitions for sample patch email
 218 ``````````````````````````````````
 219
 220 -  ``Repository`` is the identifier of the repository the patch applies.
 221     This identifier should only be provided for repositories other than
 222     ``edk2``. For example ``edk2-BuildSpecification`` or ``staging``.
 223 -  ``Branch`` is the identifier of the branch the patch applies. This
 224     identifier should only be provided for branches other than
 225    ``edk2/master``.
 226     For example ``edk2/UDK2015``,
 227    ``edk2-BuildSpecification/release/1.27``, or
 228     ``staging/edk2-test``.
 229 -  ``Module`` is a short identifier for the affected code or
 230    documentation. For example ``MdePkg``, ``MdeModulePkg/UsbBusDxe``, ``Introduction``, or
 231     ``EDK II INF File Format``.
 232 -  ``Brief-single-line-summary`` is a short summary of the change.
 233 -  The entire first line should be less than ~70 characters.
 234 -  ``Full-commit-message`` a verbose multiple line comment describing
 235     the change. Each line should be less than ~70 characters.
 236 -  ``Signed-off-by`` is the contributor's signature identifying them
 237     by their real/legal name and their email address.
 238
 239 Submodules
 240 ----------
 241
 242 Submodule in EDK II is allowed but submodule chain should be avoided
 243 as possible as we can. Currently EDK II contains the following submodules
 244
 245 -  CryptoPkg/Library/OpensslLib/openssl
 246 -  ArmPkg/Library/ArmSoftFloatLib/berkeley-softfloat-3
 247 -  MdeModulePkg/Universal/RegularExpressionDxe/oniguruma
 248 -  MdeModulePkg/Library/BrotliCustomDecompressLib/brotli
 249 -  BaseTools/Source/C/BrotliCompress/brotli
 250
 251 ArmSoftFloatLib is actually required by OpensslLib. It's inevitable
 252 in openssl-1.1.1 (since stable201905) for floating point parameter
 253 conversion, but should be dropped once there's no such need in future
 254 release of openssl.
 255
 256 To get a full, buildable EDK II repository, use following steps of git
 257 command
 258
 259 .. code-block:: bash
 260
 261   git clone https://github.com/tianocore/edk2.git
 262   cd edk2
 263   git submodule update --init
 264   cd ..
 265
 266 If there's update for submodules, use following git commands to get
 267 the latest submodules code.
 268
 269 .. code-block:: bash
 270
 271   cd edk2
 272   git pull
 273   git submodule update
 274
 275 Note: When cloning submodule repos, '--recursive' option is not
 276 recommended. EDK II itself will not use any code/feature from
 277 submodules in above submodules. So using '--recursive' adds a
 278 dependency on being able to reach servers we do not actually want
 279 any code from, as well as needlessly downloading code we will not
 280 use.
 281
 282 .. ===================================================================
 283 .. This is a bunch of directives to make the README file more readable
 284 .. ===================================================================
 285
 286 .. CoreCI
 287
 288 .. _Windows_VS2019: https://dev.azure.com/tianocore/edk2-ci/_build/latest?definitionId=32&branchName=master
 289 .. |WindowsCiBuild| image:: https://dev.azure.com/tianocore/edk2-ci/_apis/build/status/Windows%20VS2019%20CI?branchName=master
 290 .. |WindowsCiTest| image:: https://img.shields.io/azure-devops/tests/tianocore/edk2-ci/32.svg
 291 .. |WindowsCiCoverage| image:: https://img.shields.io/badge/coverage-coming_soon-blue
 292
 293 .. _Ubuntu_GCC5: https://dev.azure.com/tianocore/edk2-ci/_build/latest?definitionId=31&branchName=master
 294 .. |UbuntuCiBuild| image:: https://dev.azure.com/tianocore/edk2-ci/_apis/build/status/Ubuntu%20GCC5%20CI?branchName=master
 295 .. |UbuntuCiTest| image:: https://img.shields.io/azure-devops/tests/tianocore/edk2-ci/31.svg
 296 .. |UbuntuCiCoverage| image:: https://img.shields.io/badge/coverage-coming_soon-blue
 297
 298 .. ArmVirtPkg
 299
 300 .. _ArmVirtPkg_Ubuntu_GCC5: https://dev.azure.com/tianocore/edk2-ci/_build/latest?definitionId=46&branchName=master
 301 .. |avAArch64du| image:: https://dev.azure.com/tianocore/edk2-ci/_apis/build/status/PlatformCI_ArmVirtPkg_Ubuntu_GCC5_CI?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20QEMU_AARCH64_DEBUG
 302 .. |avAArch64ru| image:: https://dev.azure.com/tianocore/edk2-ci/_apis/build/status/PlatformCI_ArmVirtPkg_Ubuntu_GCC5_CI?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20QEMU_AARCH64_RELEASE
 303 .. |avAArch64nu| image:: https://dev.azure.com/tianocore/edk2-ci/_apis/build/status/PlatformCI_ArmVirtPkg_Ubuntu_GCC5_CI?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20QEMU_AARCH64_NOOPT
 304
 305 .. |avArmdu| image:: https://dev.azure.com/tianocore/edk2-ci/_apis/build/status/PlatformCI_ArmVirtPkg_Ubuntu_GCC5_CI?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20QEMU_ARM_DEBUG
 306 .. |avArmru| image:: https://dev.azure.com/tianocore/edk2-ci/_apis/build/status/PlatformCI_ArmVirtPkg_Ubuntu_GCC5_CI?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20QEMU_ARM_RELEASE
 307 .. |avArmnu| image:: https://dev.azure.com/tianocore/edk2-ci/_apis/build/status/PlatformCI_ArmVirtPkg_Ubuntu_GCC5_CI?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20QEMU_ARM_NOOPT
 308
 309 .. EmulatorPkg
 310
 311 .. |TCBZ_2668| image:: https://img.shields.io/bugzilla/2668?baseUrl=https%3A%2F%2Fbugzilla.tianocore.org
 312 .. _TCBZ_2668: https://bugzilla.tianocore.org/show_bug.cgi?id=2668
 313
 314 .. |TCBZ_2639| image:: https://img.shields.io/bugzilla/2639?baseUrl=https%3A%2F%2Fbugzilla.tianocore.org
 315 .. _TCBZ_2639: https://bugzilla.tianocore.org/show_bug.cgi?id=2639
 316
 317 .. _EmulatorPkg_Win_VS2019:  https://dev.azure.com/tianocore/edk2-ci/_build/latest?definitionId=44&branchName=master
 318 .. _EmulatorPkg_Ubuntu_GCC5: https://dev.azure.com/tianocore/edk2-ci/_build/latest?definitionId=43&branchName=master
 319
 320 .. |em32d| image:: https://dev.azure.com/tianocore/edk2-ci/_apis/build/status/PlatformCI_EmulatorPkg_Windows_VS2019_CI?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20EmulatorPkg_IA32_DEBUG
 321 .. |em32du| image:: https://dev.azure.com/tianocore/edk2-ci/_apis/build/status/PlatformCI_EmulatorPkg_Ubuntu_GCC5_CI?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20EmulatorPkg_IA32_DEBUG
 322 .. |em32r| image:: https://dev.azure.com/tianocore/edk2-ci/_apis/build/status/PlatformCI_EmulatorPkg_Windows_VS2019_CI?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20EmulatorPkg_IA32_RELEASE
 323 .. |em32ru| image:: https://dev.azure.com/tianocore/edk2-ci/_apis/build/status/PlatformCI_EmulatorPkg_Ubuntu_GCC5_CI?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20EmulatorPkg_IA32_RELEASE
 324 .. |em32n| image:: https://dev.azure.com/tianocore/edk2-ci/_apis/build/status/PlatformCI_EmulatorPkg_Windows_VS2019_CI?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20EmulatorPkg_IA32_NOOPT
 325 .. |em32nu| image:: https://dev.azure.com/tianocore/edk2-ci/_apis/build/status/PlatformCI_EmulatorPkg_Ubuntu_GCC5_CI?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20EmulatorPkg_IA32_NOOPT
 326
 327 .. |em32fd| image:: https://dev.azure.com/tianocore/edk2-ci/_apis/build/status/PlatformCI_EmulatorPkg_Windows_VS2019_CI?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20EmulatorPkg_IA32_FULL_DEBUG
 328 .. |em32fdu| image:: https://dev.azure.com/tianocore/edk2-ci/_apis/build/status/PlatformCI_EmulatorPkg_Ubuntu_GCC5_CI?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20EmulatorPkg_IA32_FULL_DEBUG
 329 .. |em32fr| image:: https://dev.azure.com/tianocore/edk2-ci/_apis/build/status/PlatformCI_EmulatorPkg_Windows_VS2019_CI?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20EmulatorPkg_IA32_FULL_RELEASE
 330 .. |em32fru| image:: https://dev.azure.com/tianocore/edk2-ci/_apis/build/status/PlatformCI_EmulatorPkg_Ubuntu_GCC5_CI?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20EmulatorPkg_IA32_FULL_RELEASE
 331 .. |em32fn| image:: https://dev.azure.com/tianocore/edk2-ci/_apis/build/status/PlatformCI_EmulatorPkg_Windows_VS2019_CI?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20EmulatorPkg_IA32_FULL_NOOPT
 332 .. |em32fnu| image:: https://dev.azure.com/tianocore/edk2-ci/_apis/build/status/PlatformCI_EmulatorPkg_Ubuntu_GCC5_CI?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20EmulatorPkg_IA32_FULL_NOOPT
 333
 334 .. |em64d| image:: https://dev.azure.com/tianocore/edk2-ci/_apis/build/status/PlatformCI_EmulatorPkg_Windows_VS2019_CI?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20EmulatorPkg_X64_DEBUG
 335 .. |em64du| image:: https://dev.azure.com/tianocore/edk2-ci/_apis/build/status/PlatformCI_EmulatorPkg_Ubuntu_GCC5_CI?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20EmulatorPkg_X64_DEBUG
 336 .. |em64r| image:: https://dev.azure.com/tianocore/edk2-ci/_apis/build/status/PlatformCI_EmulatorPkg_Windows_VS2019_CI?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20EmulatorPkg_X64_RELEASE
 337 .. |em64ru| image:: https://dev.azure.com/tianocore/edk2-ci/_apis/build/status/PlatformCI_EmulatorPkg_Ubuntu_GCC5_CI?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20EmulatorPkg_X64_RELEASE
 338 .. |em64n| image:: https://dev.azure.com/tianocore/edk2-ci/_apis/build/status/PlatformCI_EmulatorPkg_Windows_VS2019_CI?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20EmulatorPkg_X64_NOOPT
 339 .. |em64nu| image:: https://dev.azure.com/tianocore/edk2-ci/_apis/build/status/PlatformCI_EmulatorPkg_Ubuntu_GCC5_CI?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20EmulatorPkg_X64_NOOPT
 340
 341 .. |em64fd| image:: https://dev.azure.com/tianocore/edk2-ci/_apis/build/status/PlatformCI_EmulatorPkg_Windows_VS2019_CI?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20EmulatorPkg_X64_FULL_DEBUG
 342 .. |em64fdu| image:: https://dev.azure.com/tianocore/edk2-ci/_apis/build/status/PlatformCI_EmulatorPkg_Ubuntu_GCC5_CI?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20EmulatorPkg_X64_FULL_DEBUG
 343 .. |em64fr| image:: https://dev.azure.com/tianocore/edk2-ci/_apis/build/status/PlatformCI_EmulatorPkg_Windows_VS2019_CI?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20EmulatorPkg_X64_FULL_RELEASE
 344 .. |em64fru| image:: https://dev.azure.com/tianocore/edk2-ci/_apis/build/status/PlatformCI_EmulatorPkg_Ubuntu_GCC5_CI?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20EmulatorPkg_X64_FULL_RELEASE
 345 .. |em64fn| image:: https://dev.azure.com/tianocore/edk2-ci/_apis/build/status/PlatformCI_EmulatorPkg_Windows_VS2019_CI?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20EmulatorPkg_X64_FULL_NOOPT
 346 .. |em64fnu| image:: https://dev.azure.com/tianocore/edk2-ci/_apis/build/status/PlatformCI_EmulatorPkg_Ubuntu_GCC5_CI?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20EmulatorPkg_X64_FULL_NOOPT
 347
 348 .. OvmfPkg
 349
 350 .. |TCBZ_2661| image:: https://img.shields.io/bugzilla/2661?baseUrl=https%3A%2F%2Fbugzilla.tianocore.org
 351 .. _TCBZ_2661: https://bugzilla.tianocore.org/show_bug.cgi?id=2661
 352
 353 .. _OvmfPkg_Win_VS2019:  https://dev.azure.com/tianocore/edk2-ci/_build/latest?definitionId=50&branchName=master
 354 .. _OvmfPkg_Ubuntu_GCC5: https://dev.azure.com/tianocore/edk2-ci/_build/latest?definitionId=48&branchName=master
 355
 356 .. |op32d| image:: https://dev.azure.com/tianocore/edk2-ci/_apis/build/status/PlatformCI_OvmfPkg_Windows_VS2019_CI?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20OVMF_IA32_DEBUG
 357 .. |op32du| image:: https://dev.azure.com/tianocore/edk2-ci/_apis/build/status/PlatformCI_OvmfPkg_Ubuntu_GCC5_CI?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20OVMF_IA32_DEBUG
 358 .. |op32r| image:: https://dev.azure.com/tianocore/edk2-ci/_apis/build/status/PlatformCI_OvmfPkg_Windows_VS2019_CI?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20OVMF_IA32_RELEASE
 359 .. |op32ru| image:: https://dev.azure.com/tianocore/edk2-ci/_apis/build/status/PlatformCI_OvmfPkg_Ubuntu_GCC5_CI?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20OVMF_IA32_RELEASE
 360 .. |op32n| image:: https://dev.azure.com/tianocore/edk2-ci/_apis/build/status/PlatformCI_OvmfPkg_Windows_VS2019_CI?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20OVMF_IA32_NOOPT
 361 .. |op32nu| image:: https://dev.azure.com/tianocore/edk2-ci/_apis/build/status/PlatformCI_OvmfPkg_Ubuntu_GCC5_CI?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20OVMF_IA32_NOOPT
 362
 363 .. |op64d| image:: https://dev.azure.com/tianocore/edk2-ci/_apis/build/status/PlatformCI_OvmfPkg_Windows_VS2019_CI?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20OVMF_X64_DEBUG
 364 .. |op64du| image:: https://dev.azure.com/tianocore/edk2-ci/_apis/build/status/PlatformCI_OvmfPkg_Ubuntu_GCC5_CI?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20OVMF_X64_DEBUG
 365 .. |op64r| image:: https://dev.azure.com/tianocore/edk2-ci/_apis/build/status/PlatformCI_OvmfPkg_Windows_VS2019_CI?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20OVMF_X64_RELEASE
 366 .. |op64ru| image:: https://dev.azure.com/tianocore/edk2-ci/_apis/build/status/PlatformCI_OvmfPkg_Ubuntu_GCC5_CI?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20OVMF_X64_RELEASE
 367 .. |op64n| image:: https://dev.azure.com/tianocore/edk2-ci/_apis/build/status/PlatformCI_OvmfPkg_Windows_VS2019_CI?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20OVMF_X64_NOOPT
 368 .. |op64nu| image:: https://dev.azure.com/tianocore/edk2-ci/_apis/build/status/PlatformCI_OvmfPkg_Ubuntu_GCC5_CI?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20OVMF_X64_NOOPT
 369
 370
 371 .. |op3264d| image:: https://dev.azure.com/tianocore/edk2-ci/_apis/build/status/PlatformCI_OvmfPkg_Windows_VS2019_CI?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20OVMF_IA32X64_DEBUG
 372 .. |op3264du| image:: https://dev.azure.com/tianocore/edk2-ci/_apis/build/status/PlatformCI_OvmfPkg_Ubuntu_GCC5_CI?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20OVMF_IA32X64_DEBUG
 373 .. |op3264r| image:: https://dev.azure.com/tianocore/edk2-ci/_apis/build/status/PlatformCI_OvmfPkg_Windows_VS2019_CI?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20OVMF_IA32X64_RELEASE
 374 .. |op3264ru| image:: https://dev.azure.com/tianocore/edk2-ci/_apis/build/status/PlatformCI_OvmfPkg_Ubuntu_GCC5_CI?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20OVMF_IA32X64_RELEASE
 375 .. |op3264n| image:: https://dev.azure.com/tianocore/edk2-ci/_apis/build/status/PlatformCI_OvmfPkg_Windows_VS2019_CI?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20OVMF_IA32X64_NOOPT
 376 .. |op3264nu| image:: https://dev.azure.com/tianocore/edk2-ci/_apis/build/status/PlatformCI_OvmfPkg_Ubuntu_GCC5_CI?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20OVMF_IA32X64_NOOPT
 377
 378 .. |op3264fd| image:: https://dev.azure.com/tianocore/edk2-ci/_apis/build/status/PlatformCI_OvmfPkg_Windows_VS2019_CI?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20OVMF_IA32X64_FULL_DEBUG
 379 .. |op3264fdu| image:: https://dev.azure.com/tianocore/edk2-ci/_apis/build/status/PlatformCI_OvmfPkg_Ubuntu_GCC5_CI?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20OVMF_IA32X64_FULL_DEBUG
 380 .. |op3264fr| image:: https://dev.azure.com/tianocore/edk2-ci/_apis/build/status/PlatformCI_OvmfPkg_Windows_VS2019_CI?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20OVMF_IA32X64_FULL_RELEASE
 381 .. |op3264fru| image:: https://dev.azure.com/tianocore/edk2-ci/_apis/build/status/PlatformCI_OvmfPkg_Ubuntu_GCC5_CI?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20OVMF_IA32X64_FULL_RELEASE
 382 .. |op3264fn| replace:: |TCBZ_2661|_
 383 .. |op3264fnu| image:: https://dev.azure.com/tianocore/edk2-ci/_apis/build/status/PlatformCI_OvmfPkg_Ubuntu_GCC5_CI?branchName=master&jobName=Platform_CI&configuration=Platform_CI%20OVMF_IA32X64_FULL_NOOPT