OvmfPkg/Csm/LegacyBiosDxe: Update to make it build for OVMF
[mirror_edk2.git] / Readme.md
1 # EDK II Project\r
2 \r
3 A modern, feature-rich, cross-platform firmware development environment\r
4 for the UEFI and PI specifications from www.uefi.org.\r
5 \r
6 The majority of the content in the EDK II open source project uses a\r
7 [BSD-2-Clause Plus Patent License](License.txt).  The EDK II open source project\r
8 contains the following components that are covered by additional licenses:\r
9 * [BaseTools/Source/C/BrotliCompress](BaseTools/Source/C/BrotliCompress/LICENSE)\r
10 * [MdeModulePkg/Library/BrotliCustomDecompressLib](MdeModulePkg/Library/BrotliCustomDecompressLib/LICENSE)\r
11 * [BaseTools/Source/C/LzmaCompress](BaseTools/Source/C/LzmaCompress/LZMA-SDK-README.txt)\r
12 * [MdeModulePkg/Library/LzmaCustomDecompressLib](MdeModulePkg/Library/LzmaCustomDecompressLib/LZMA-SDK-README.txt)\r
13 * [IntelFrameworkModulePkg/Library/LzmaCustomDecompressLib/Sdk](IntelFrameworkModulePkg/Library/LzmaCustomDecompressLib/LZMA-SDK-README.txt)\r
14 * [BaseTools/Source/C/VfrCompile/Pccts](BaseTools/Source/C/VfrCompile/Pccts/RIGHTS)\r
15 * [MdeModulePkg/Universal/RegularExpressionDxe/Oniguruma](MdeModulePkg/Universal/RegularExpressionDxe/Oniguruma/README)\r
16 * [OvmfPkg](OvmfPkg/License.txt)\r
17 * [CryptoPkg/Library/OpensslLib/openssl](https://github.com/openssl/openssl/blob/50eaac9f3337667259de725451f201e784599687/LICENSE)\r
18 * [ArmPkg/Library/ArmSoftFloatLib/berkeley-softfloat-3](https://github.com/ucb-bar/berkeley-softfloat-3/blob/b64af41c3276f97f0e181920400ee056b9c88037/COPYING.txt)\r
19 \r
20 The EDK II Project is composed of packages.  The maintainers for each package\r
21 are listed in [Maintainers.txt](Maintainers.txt).\r
22 \r
23 # Resources\r
24 * [TianoCore](http://www.tianocore.org)\r
25 * [EDK II](https://github.com/tianocore/tianocore.github.io/wiki/EDK-II)\r
26 * [Getting Started with EDK II](https://github.com/tianocore/tianocore.github.io/wiki/Getting-Started-with-EDK-II)\r
27 * [Mailing Lists](https://github.com/tianocore/tianocore.github.io/wiki/Mailing-Lists)\r
28 * [TianoCore Bugzilla](https://bugzilla.tianocore.org)\r
29 * [How To Contribute](https://github.com/tianocore/tianocore.github.io/wiki/How-To-Contribute)\r
30 * [Release Planning](https://github.com/tianocore/tianocore.github.io/wiki/EDK-II-Release-Planning)\r
31 * [UDK2017](https://github.com/tianocore/edk2/releases/tag/vUDK2017)\r
32 * [UDK2018](https://github.com/tianocore/edk2/releases/tag/vUDK2018)\r
33 * [edk2-stable201811](https://github.com/tianocore/edk2/releases/tag/edk2-stable201811)\r
34 \r
35 # Code Contributions\r
36 To make a contribution to a TianoCore project, follow these steps.\r
37 1. Create a change description in the format specified below to\r
38    use in the source control commit log.\r
39 2. Your commit message must include your `Signed-off-by` signature\r
40 3. Submit your code to the TianoCore project using the process\r
41    that the project documents on its web page.  If the process is\r
42    not documented, then submit the code on development email list\r
43    for the project.\r
44 4. It is preferred that contributions are submitted using the same\r
45    copyright license as the base project. When that is not possible,\r
46    then contributions using the following licenses can be accepted:\r
47    * BSD (2-clause): http://opensource.org/licenses/BSD-2-Clause\r
48    * BSD (3-clause): http://opensource.org/licenses/BSD-3-Clause\r
49    * MIT: http://opensource.org/licenses/MIT\r
50    * Python-2.0: http://opensource.org/licenses/Python-2.0\r
51    * Zlib: http://opensource.org/licenses/Zlib\r
52 \r
53    For documentation:\r
54    * FreeBSD Documentation License\r
55      https://www.freebsd.org/copyright/freebsd-doc-license.html\r
56 \r
57    Contributions of code put into the public domain can also be\r
58    accepted.\r
59 \r
60    Contributions using other licenses might be accepted, but further\r
61    review will be required.\r
62 \r
63 # Developer Certificate of Origin\r
64 \r
65 Your change description should use the standard format for a\r
66 commit message, and must include your `Signed-off-by` signature.\r
67 \r
68 In order to keep track of who did what, all patches contributed must\r
69 include a statement that to the best of the contributor's knowledge\r
70 they have the right to contribute it under the specified license.\r
71 \r
72 The test for this is as specified in the [Developer's Certificate of\r
73 Origin (DCO) 1.1](https://developercertificate.org/). The contributor\r
74 certifies compliance by adding a line saying\r
75 \r
76   Signed-off-by: Developer Name <developer@example.org>\r
77 \r
78 where `Developer Name` is the contributor's real name, and the email\r
79 address is one the developer is reachable through at the time of\r
80 contributing.\r
81 \r
82 ```\r
83 Developer's Certificate of Origin 1.1\r
84 \r
85 By making a contribution to this project, I certify that:\r
86 \r
87 (a) The contribution was created in whole or in part by me and I\r
88     have the right to submit it under the open source license\r
89     indicated in the file; or\r
90 \r
91 (b) The contribution is based upon previous work that, to the best\r
92     of my knowledge, is covered under an appropriate open source\r
93     license and I have the right under that license to submit that\r
94     work with modifications, whether created in whole or in part\r
95     by me, under the same open source license (unless I am\r
96     permitted to submit under a different license), as indicated\r
97     in the file; or\r
98 \r
99 (c) The contribution was provided directly to me by some other\r
100     person who certified (a), (b) or (c) and I have not modified\r
101     it.\r
102 \r
103 (d) I understand and agree that this project and the contribution\r
104     are public and that a record of the contribution (including all\r
105     personal information I submit with it, including my sign-off) is\r
106     maintained indefinitely and may be redistributed consistent with\r
107     this project or the open source license(s) involved.\r
108 ```\r
109 \r
110 # Sample Change Description / Commit Message\r
111 \r
112 ```\r
113 From: Contributor Name <contributor@example.com>\r
114 Subject: [Repository/Branch PATCH] Pkg-Module: Brief-single-line-summary\r
115 \r
116 Full-commit-message\r
117 \r
118 Signed-off-by: Contributor Name <contributor@example.com>\r
119 ```\r
120 \r
121 ## Notes for sample patch email\r
122 \r
123 * The first line of commit message is taken from the email's subject\r
124   line following `[Repository/Branch PATCH]`. The remaining portion of the\r
125   commit message is the email's content.\r
126 * `git format-patch` is one way to create this format\r
127 \r
128 ## Definitions for sample patch email\r
129 \r
130 * `Repository` is the identifier of the repository the patch applies.\r
131   This identifier should only be provided for repositories other than\r
132   `edk2`. For example `edk2-BuildSpecification` or `staging`.\r
133 * `Branch` is the identifier of the branch the patch applies. This\r
134   identifier should only be provided for branches other than `edk2/master`.\r
135   For example `edk2/UDK2015`, `edk2-BuildSpecification/release/1.27`, or\r
136   `staging/edk2-test`.\r
137 * `Module` is a short identifier for the affected code or documentation. For\r
138   example `MdePkg`, `MdeModulePkg/UsbBusDxe`, `Introduction`, or\r
139   `EDK II INF File Format`.\r
140 * `Brief-single-line-summary` is a short summary of the change.\r
141 * The entire first line should be less than ~70 characters.\r
142 * `Full-commit-message` a verbose multiple line comment describing\r
143   the change.  Each line should be less than ~70 characters.\r
144 * `Signed-off-by` is the contributor's signature identifying them\r
145   by their real/legal name and their email address.\r