From 95259e28ef047923258434898113d70c8e544eab Mon Sep 17 00:00:00 2001 From: Francis Rowe Date: Fri, 06 Nov 2015 17:43:29 -0500 Subject: convert documentation to texinfo --- (limited to 'docs/index.html') diff --git a/docs/index.html b/docs/index.html deleted file mode 100644 index 62f482c..0000000 --- a/docs/index.html +++ /dev/null @@ -1,274 +0,0 @@ - - - - - - - - - Libreboot project documentation - - - - -
-

Libreboot project documentation

-

- Information about this release can be found at release.html. - Always check libreboot.org for updates. -

-

- What is libreboot? -

-

- How do I know what version I'm running? -

-
- -
- -

Table of contents

- - -
- -
- -

About the libreboot project

- -

- Libreboot originally began during December 2013, as a commercial effort - by Gluglug to achieve - RYF endorsement for a modified ThinkPad X60 - (the first system to ever be added to libreboot). -

- -

- Back then, the name libreboot didn't exist; the project was nameless, - referring to itself as a deblobbed version of coreboot. The project named - itself libreboot at some point during early 2014, and has since rapidly expanded - to support more hardware and become more user-friendly. -

- -

- Libreboot is a coreboot distribution (distro) with proprietary software removed, - intended to be a free - (libre) 'BIOS' replacement for your computer. The project is aimed at users, attempting to make - coreboot as easy to use as possible. - Read the full Free Software definition. -

- -

- Libreboot has many practical advantages over proprietary boot firmware, - such as faster boot speeds and better security. You can - install GNU/Linux with encrypted /boot/, - verify GPG signatures on your kernel, - put a kernel in the flash chip and more. -

- -

- The libreboot project has three main goals: -

- - -

- Libreboot is a coreboot distribution, not a coreboot fork -

- -

- Libreboot is not a fork of coreboot. Every so often, the project re-bases on the latest - version of coreboot, with the number of custom patches in use minimized. -

- -

- All new coreboot development should be done in coreboot (upstream), not libreboot! - Libreboot is about deblobbing and packaging coreboot in a user-friendly way, where most work - is already done for the user. -

- -

- For example, if you wanted to add a new board to libreboot, you should add it to coreboot first. - Libreboot will automatically receive your code at a later date, when it updates itself. -

- -

- The deblobbed coreboot tree used in libreboot is referred to as coreboot-libre, - to distinguish it as a component of libreboot. -

- -

- Libreboot is a 'stable' version of coreboot -

- - -

Back to top of page.

- -
- -
- -

How do I know what version I'm running?

- -

- If you are at least 127 commits after release 20150518 - (commit message build/roms/helper: add version information to CBFS) - (or you have any upstream stable release of libreboot after 20150518), then you can - press C at the GRUB console, and use this command to find out what version of libreboot you have:
- cat (cbfsdisk)/lbversion
- This will also work on non-release images (the version string is automatically generated, - using git describe --tags HEAD), built from the git repository. - A file named version will also be included in the archives that you downloaded (if you are - using release archives). -

- -

- If it exists, you can also extract this lbversion file by using the cbfstool utility - which libreboot includes, from a ROM image that you either dumped or haven't flashed yet. - In GNU/Linux, run cbfstool on your ROM image (libreboot.rom, in this example):
- $ ./cbfstool libreboot.rom extract -n lbversion -f lbversion
- You will now have a file, named lbversion, which you can read in whatever program - it is that you use for reading/writing text files. -

- -

- For git, it's easy. Just check the git log. -

- -

- For releases on or below 20150518, or snapshots generated from the git repository below 127 commits - after 20150518, you can find a file named commitid inside the archives. If you are using - pre-built ROM images from the libreboot project, you can press C in GRUB for access to the terminal, - and then run this command:
- lscoreboot
- You may find a date in here, detailing when that ROM image was built. For pre-built images distributed - by the libreboot project, this is a rough approximation of what version you have, because the version - numbers are dated, and the release archives are typically built on the same day as the release; you can - correlate that with the release information in release.html. -

- -

- You can also check the documentation that came with your archives, and in docs/release.html will be - the information about the version of libreboot that you are using. -

- -

- Generally speaking, it is advisable to use the latest version of libreboot. -

- -
- -
- -

- Copyright © 2014, 2015 Francis Rowe <info@gluglug.org.uk>
- Permission is granted to copy, distribute and/or modify this document - under the terms of the GNU Free Documentation License, Version 1.3 - or any later version published by the Free Software Foundation; - with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. - A copy of the license can be found at gfdl-1.3.txt -

- -

- Updated versions of the license (when available) can be found at - https://www.gnu.org/licenses/licenses.html -

- -

- UNLESS OTHERWISE SEPARATELY UNDERTAKEN BY THE LICENSOR, TO THE - EXTENT POSSIBLE, THE LICENSOR OFFERS THE LICENSED MATERIAL AS-IS - AND AS-AVAILABLE, AND MAKES NO REPRESENTATIONS OR WARRANTIES OF - ANY KIND CONCERNING THE LICENSED MATERIAL, WHETHER EXPRESS, - IMPLIED, STATUTORY, OR OTHER. THIS INCLUDES, WITHOUT LIMITATION, - WARRANTIES OF TITLE, MERCHANTABILITY, FITNESS FOR A PARTICULAR - PURPOSE, NON-INFRINGEMENT, ABSENCE OF LATENT OR OTHER DEFECTS, - ACCURACY, OR THE PRESENCE OR ABSENCE OF ERRORS, WHETHER OR NOT - KNOWN OR DISCOVERABLE. WHERE DISCLAIMERS OF WARRANTIES ARE NOT - ALLOWED IN FULL OR IN PART, THIS DISCLAIMER MAY NOT APPLY TO YOU. -

-

- TO THE EXTENT POSSIBLE, IN NO EVENT WILL THE LICENSOR BE LIABLE - TO YOU ON ANY LEGAL THEORY (INCLUDING, WITHOUT LIMITATION, - NEGLIGENCE) OR OTHERWISE FOR ANY DIRECT, SPECIAL, INDIRECT, - INCIDENTAL, CONSEQUENTIAL, PUNITIVE, EXEMPLARY, OR OTHER LOSSES, - COSTS, EXPENSES, OR DAMAGES ARISING OUT OF THIS PUBLIC LICENSE OR - USE OF THE LICENSED MATERIAL, EVEN IF THE LICENSOR HAS BEEN - ADVISED OF THE POSSIBILITY OF SUCH LOSSES, COSTS, EXPENSES, OR - DAMAGES. WHERE A LIMITATION OF LIABILITY IS NOT ALLOWED IN FULL OR - IN PART, THIS LIMITATION MAY NOT APPLY TO YOU. -

-

- The disclaimer of warranties and limitation of liability provided - above shall be interpreted in a manner that, to the extent - possible, most closely approximates an absolute disclaimer and - waiver of all liability. -

- -
- - - - - -- cgit v0.9.1