index.html 10 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241
  1. <!DOCTYPE html>
  2. <html>
  3. <head>
  4. <meta charset="utf-8">
  5. <meta name="viewport" content="width=device-width, initial-scale=1">
  6. <style type="text/css">
  7. @import url('css/main.css');
  8. </style>
  9. <title>GNU Libreboot documentation</title>
  10. </head>
  11. <body>
  12. <div class="section">
  13. <h1 id="pagetop">GNU Libreboot documentation</h1>
  14. <p>
  15. Information about this release can be found at <a href="release.html">release.html</a>.
  16. Always check <a href="http://libreboot.org">libreboot.org</a> for updates.
  17. </p>
  18. <p>
  19. <a href="#why">What is libreboot?</a>
  20. </p>
  21. <p>
  22. <a href="https://libreboot.org/faq/">Answers to frequently asked questions about GNU Libreboot</a>
  23. </p>
  24. </div>
  25. <div class="section">
  26. <h1>Installing libreboot</h1>
  27. <ul>
  28. <li><a href="hcl/index.html">What systems can I use libreboot on?</a> - NOTE: <a href="https://www.gnu.org/distros/">GNU/Linux</a> is expected to be running on your device.</li>
  29. <li><a href="install/index.html">How to install libreboot</a></li>
  30. <li><a href="gnulinux/index.html">How to install GNU/Linux on a libreboot system</a></li>
  31. </ul>
  32. <h1>Informaton for developers</h1>
  33. <ul>
  34. <li><a href="git/index.html">How to compile the libreboot source code</a></li>
  35. <li><a href="depthcharge/index.html">Depthcharge payload</a></li>
  36. <li><a href="grub/index.html">GRUB payload</a></li>
  37. </ul>
  38. <h1>Other information</h1>
  39. <ul>
  40. <li><a href="hardware/index.html">Hardware modifications</a></li>
  41. <li><a href="misc/index.html">Miscellaneous</a></li>
  42. </ul>
  43. </div>
  44. <div class="section" id="why">
  45. <h1>About the libreboot project</h1>
  46. <p>
  47. GNU Libreboot is a free BIOS or UEFI replacement (<a href="https://www.gnu.org/philosophy/free-sw.html">free as in freedom</a>);
  48. libre <em>boot firmware</em> that initializes the hardware and starts a bootloader for your operating
  49. system.
  50. It's also an open source BIOS, but open source <a href="https://www.gnu.org/philosophy/open-source-misses-the-point.html">fails</a> to
  51. promote freedom; <em>please call libreboot <strong><a href="https://www.gnu.org/philosophy/free-sw.html">free software</a></strong></em>.
  52. Since 14 May 2016, Libreboot is part of the <a href="https://www.gnu.org/">GNU project</a>.
  53. </p>
  54. <p>
  55. Libreboot originally began during December 2013, as a commercial effort
  56. by the <a href="https://minifree.org">Ministry of Freedom</a> to achieve
  57. <a href="https://www.fsf.org/resources/hw/endorsement/respects-your-freedom">RYF</a> endorsement for a modified ThinkPad X60
  58. (the first system to ever be added to libreboot).
  59. </p>
  60. <p>
  61. Back then, the name <i>libreboot</i> didn't exist; the project was nameless,
  62. referring to itself as a <i>deblobbed version of coreboot</i>. The project named
  63. itself libreboot at some point during early 2014, and has since rapidly expanded
  64. to support more hardware and become more user-friendly.
  65. </p>
  66. <p>
  67. Libreboot is a <a href="http://coreboot.org/">coreboot</a> distribution (distro) with proprietary software removed,
  68. intended to be a <a href="https://www.fsf.org/about/what-is-free-software">free</a>
  69. (libre) 'BIOS' replacement for your computer. The project is aimed at users, attempting to make
  70. coreboot as easy to use as possible.
  71. Read the full <a href="https://www.gnu.org/philosophy/free-sw.html">Free Software definition</a>.
  72. </p>
  73. <p>
  74. Libreboot has many practical advantages over <a href="https://gnu.org/philosophy/proprietary/">proprietary</a> boot firmware,
  75. such as faster boot speeds and better security. You can
  76. <a href="gnulinux/index.html">install GNU/Linux with encrypted /boot/</a>,
  77. <a href="http://www.coreboot.org/GRUB2#signed_kernels">verify GPG signatures on your kernel</a>,
  78. put a kernel in the flash chip and more.
  79. </p>
  80. <h2>
  81. The libreboot project has three main goals:
  82. </h2>
  83. <ul>
  84. <li>
  85. <i><u><b>Recommend and distribute only free software</b></u></i>.
  86. Coreboot distributes certain pieces of proprietary software which is needed on some systems.
  87. Examples can include things like CPU microcode updates, memory initialization blobs and so on.
  88. The coreboot project sometimes recommends adding more blobs which it does not distribute, such
  89. as the Video BIOS or Intel's <i>Management Engine</i>. However, a lot of dedicated and talented
  90. individuals in coreboot work hard to replace these blobs whenever possible.
  91. </li>
  92. <li>
  93. <i><u><b>Support as much hardware as possible!</b></u></i>
  94. Libreboot supports less hardware than coreboot, because most systems from coreboot still require
  95. certain proprietary software to work properly. Libreboot is an attempt to support as much
  96. hardware as possible, without any proprietary software.
  97. </li>
  98. <li>
  99. <i><u><b>Make coreboot easy to use</b></u></i>.
  100. Coreboot is notoriously difficult to install, due to an overall lack of user-focussed
  101. documentation and support. Most people will simply give up before attempting to install coreboot.<br/><br/>
  102. Libreboot attempts to bridge this divide, making sure that everything from building
  103. to installing coreboot is automated, as much as is feasibly possible. Secondly, the project
  104. produces documentation aimed at non-technical users. Thirdly, the project attempts
  105. to provide excellent user support via mailing lists and IRC.<br/><br/>
  106. Libreboot already comes with a payload (GRUB), flashrom and other needed parts. Everything
  107. is fully integrated, in a way where most of the complicated steps that are otherwise required,
  108. are instead done for the user in advance.<br/><br/>
  109. You can download ROM images for your libreboot system and install them, without having
  110. to build anything from source. The build system is also fully automated, so building
  111. from source is easy if you wanted to do that (for whatever reason).
  112. </li>
  113. </ul>
  114. <h2>
  115. Libreboot is a coreboot distribution, not a coreboot fork
  116. </h2>
  117. <p>
  118. Libreboot is not a fork of coreboot. Every so often, the project re-bases on the latest
  119. version of coreboot, with the number of custom patches in use minimized.
  120. </p>
  121. <p>
  122. All new coreboot development should be done in coreboot (upstream), not libreboot!
  123. Libreboot is about deblobbing and packaging coreboot in a user-friendly way, where most work
  124. is already done for the user.
  125. </p>
  126. <p>
  127. For example, if you wanted to add a new board to libreboot, you should add it to coreboot first.
  128. Libreboot will automatically receive your code at a later date, when it updates itself.
  129. </p>
  130. <p>
  131. The deblobbed coreboot tree used in libreboot is referred to as <i>coreboot-libre</i>,
  132. to distinguish it as a component of <i>libreboot</i>.
  133. </p>
  134. <h2>
  135. Libreboot is a 'stable' version of coreboot
  136. </h2>
  137. <ul>
  138. <li>
  139. Coreboot uses the <a href="https://en.wikipedia.org/wiki/Rolling_release">rolling release</a> model,
  140. which means that it is not guaranteed to be stable, or to even work at all on a given day.
  141. Coreboot does have a strict code review process, but being such a large project with so many contributors, regressions
  142. are always possible.
  143. </li>
  144. <li>
  145. Libreboot freezes on a particular revision of coreboot, making sure that everything works properly,
  146. making fixes on top of that and repeating this during each subsequent update to a later version
  147. of coreboot. By doing this, it provides a stronger guarantee to the user that the firmware
  148. will be reliable, and not break their system.
  149. </li>
  150. </ul>
  151. <p><a href="#pagetop">Back to top of page.</a></p>
  152. </div>
  153. <div class="section" id="version">
  154. <h1>How do I know what version I'm running?</h1>
  155. <p>
  156. See <a href="https://libreboot.org/faq/#version">https://libreboot.org/faq/#version</a>
  157. </p>
  158. </div>
  159. <div class="section">
  160. <p>
  161. Copyright &copy; 2014, 2015, 2016 Leah Rowe &lt;info@minifree.org&gt;<br/>
  162. Permission is granted to copy, distribute and/or modify this document
  163. under the terms of the GNU Free Documentation License, Version 1.3
  164. or any later version published by the Free Software Foundation;
  165. with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
  166. A copy of the license can be found at <a href="gfdl-1.3.txt">gfdl-1.3.txt</a>
  167. </p>
  168. <p>
  169. Updated versions of the license (when available) can be found at
  170. <a href="https://www.gnu.org/licenses/licenses.html">https://www.gnu.org/licenses/licenses.html</a>
  171. </p>
  172. <p>
  173. UNLESS OTHERWISE SEPARATELY UNDERTAKEN BY THE LICENSOR, TO THE
  174. EXTENT POSSIBLE, THE LICENSOR OFFERS THE LICENSED MATERIAL AS-IS
  175. AND AS-AVAILABLE, AND MAKES NO REPRESENTATIONS OR WARRANTIES OF
  176. ANY KIND CONCERNING THE LICENSED MATERIAL, WHETHER EXPRESS,
  177. IMPLIED, STATUTORY, OR OTHER. THIS INCLUDES, WITHOUT LIMITATION,
  178. WARRANTIES OF TITLE, MERCHANTABILITY, FITNESS FOR A PARTICULAR
  179. PURPOSE, NON-INFRINGEMENT, ABSENCE OF LATENT OR OTHER DEFECTS,
  180. ACCURACY, OR THE PRESENCE OR ABSENCE OF ERRORS, WHETHER OR NOT
  181. KNOWN OR DISCOVERABLE. WHERE DISCLAIMERS OF WARRANTIES ARE NOT
  182. ALLOWED IN FULL OR IN PART, THIS DISCLAIMER MAY NOT APPLY TO YOU.
  183. </p>
  184. <p>
  185. TO THE EXTENT POSSIBLE, IN NO EVENT WILL THE LICENSOR BE LIABLE
  186. TO YOU ON ANY LEGAL THEORY (INCLUDING, WITHOUT LIMITATION,
  187. NEGLIGENCE) OR OTHERWISE FOR ANY DIRECT, SPECIAL, INDIRECT,
  188. INCIDENTAL, CONSEQUENTIAL, PUNITIVE, EXEMPLARY, OR OTHER LOSSES,
  189. COSTS, EXPENSES, OR DAMAGES ARISING OUT OF THIS PUBLIC LICENSE OR
  190. USE OF THE LICENSED MATERIAL, EVEN IF THE LICENSOR HAS BEEN
  191. ADVISED OF THE POSSIBILITY OF SUCH LOSSES, COSTS, EXPENSES, OR
  192. DAMAGES. WHERE A LIMITATION OF LIABILITY IS NOT ALLOWED IN FULL OR
  193. IN PART, THIS LIMITATION MAY NOT APPLY TO YOU.
  194. </p>
  195. <p>
  196. The disclaimer of warranties and limitation of liability provided
  197. above shall be interpreted in a manner that, to the extent
  198. possible, most closely approximates an absolute disclaimer and
  199. waiver of all liability.
  200. </p>
  201. </div>
  202. </body>
  203. </html>