diff options
Diffstat (limited to 'docs/index.md')
| -rw-r--r-- | docs/index.md | 136 |
1 files changed, 38 insertions, 98 deletions
diff --git a/docs/index.md b/docs/index.md index 1796ae7c..455bb0e2 100644 --- a/docs/index.md +++ b/docs/index.md @@ -1,23 +1,16 @@ % Libreboot documentation -Information about this release can be found at -[release.html](release.html). Always check -[libreboot.org](http://libreboot.org) for updates. +Information about this release can be found at [release.html](release.html). +Always check [libreboot.org](/) for updates. -[What is libreboot?](#why) +Answers to [frequently asked questions about +Libreboot](https://libreboot.org/faq/). -[Answers to frequently asked questions about -Libreboot](https://libreboot.org/faq/) - -Libreboot is compatible with GNU+Linux and several BSD systems. - -For GNU+Linux, have a look at our [list of GNU+Linux distributions that -we recommend](distros/). - -For BSD, refer to [the libreboot FAQ](https://libreboot.org/faq/#bsd). -We wish to merge instructions into the official libreboot documentation, -if someone will provide it. We do have some instructions now for NetBSD, -FreeBSD and OpenBSD, but they are still incomplete. See [bsd/](bsd/). +Libreboot is compatible with GNU+Linux and several BSD systems. For BSD, refer +to [the libreboot FAQ](https://libreboot.org/faq/#bsd). We wish to merge +instructions into the official libreboot documentation, if someone will provide +it. We do have some instructions now for NetBSD, FreeBSD and OpenBSD, but they +are still incomplete. See [bsd/](bsd/). Installing libreboot ==================== @@ -28,9 +21,6 @@ Installing libreboot Installing operating systems ============================ -- [List of recommended GNU+Linux distributions for - libreboot](distros/) - - [How to install GNU+Linux on a libreboot system](gnulinux/) - [How to install BSD on a libreboot system](bsd/) @@ -44,28 +34,15 @@ Information for developers Other information ================= -- [Hardware modifications](hardware/) - [Miscellaneous](misc/) About the libreboot project =========================== -Libreboot is a free BIOS or UEFI replacement ([free as in -freedom](https://en.wikipedia.org/wiki/Free_software)); libre *boot -firmware* that initializes the hardware and starts a bootloader for your -operating system. It's also an open source BIOS, but open source fails -to promote freedom; *please call libreboot **[free -software](https://en.wikipedia.org/wiki/Free_software)***. - -Libreboot originally began during December 2013, as a commercial effort -by the [Ministry of Freedom](https://minifree.org) to achieve RYF -endorsement for a modified ThinkPad X60 (the first system to ever be -added to libreboot), which it did then achieve. - -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 [free](https://en.wikipedia.org/wiki/Free_software) and Open +Source BIOS or UEFI replacement, initialising the hardware and booting your +operating system. We are a member of the [Peers Community](https://peers.community/) +project, an organisation that supports Free Software. Libreboot is a [coreboot](http://coreboot.org/) distribution (distro) with proprietary software removed, intended to be a @@ -100,28 +77,21 @@ The libreboot project has three main goals: and support. Most people will simply give up before attempting to install coreboot. - +Libreboot attempts to bridge this divide, making sure that everything from +building to installing coreboot is automated, as much as is feasibly possible. +Secondly, the project produces documentation aimed at non-technical users. +Thirdly, the project attempts to provide excellent user support via mailing +lists and IRC. - Libreboot attempts to bridge this divide, making sure that - everything from building to installing coreboot is automated, as - much as is feasibly possible. Secondly, the project produces - documentation aimed at non-technical users. Thirdly, the project - attempts to provide excellent user support via mailing lists and - IRC. +Libreboot already comes with a payload (GRUB), flashrom and other +needed parts. Everything is fully integrated, in a way where most of +the complicated steps that are otherwise required, are instead done +for the user in advance. - - - Libreboot already comes with a payload (GRUB), flashrom and other - needed parts. Everything is fully integrated, in a way where most of - the complicated steps that are otherwise required, are instead done - for the user in advance. - - - - You can download ROM images for your libreboot system and install - them, without having to build anything from source. The build system - is also fully automated, so building from source is easy if you - wanted to do that (for whatever reason). +You can download ROM images for your libreboot system and install +them, without having to build anything from source. The build system +is also fully automated, so building from source is easy if you +wanted to do that (for whatever reason). Libreboot is a coreboot distribution, not a coreboot fork --------------------------------------------------------- @@ -145,16 +115,16 @@ Libreboot is a 'stable' version of coreboot --------------------------------------------- - Coreboot uses the [rolling - release](https://en.wikipedia.org/wiki/Rolling_release) model, which - means that it is not guaranteed to be stable, or to even work at all - on a given day. Coreboot does have a strict code review process, but - being such a large project with so many contributors, regressions - are always possible. +release](https://en.wikipedia.org/wiki/Rolling_release) model, which +means that it is not guaranteed to be stable, or to even work at all +on a given day. Coreboot does have a strict code review process, but +being such a large project with so many contributors, regressions +are always possible. - Libreboot freezes on a particular revision of coreboot, making sure - that everything works properly, making fixes on top of that and - repeating this during each subsequent update to a later version of - coreboot. By doing this, it provides a stronger guarantee to the - user that the firmware will be reliable, and not break their system. +that everything works properly, making fixes on top of that and +repeating this during each subsequent update to a later version of +coreboot. By doing this, it provides a stronger guarantee to the +user that the firmware will be reliable, and not break their system. How do I know what version I'm running? ======================================== @@ -174,7 +144,9 @@ 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 your distribution, 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. @@ -210,36 +182,4 @@ Generally speaking, it is advisable to use the latest version of libreboot. Copyright © 2014, 2015, 2016 Leah Rowe <info@minifree.org>\ -Permission is granted to copy, distribute and/or modify this document -under the terms of the Creative Commons Attribution-ShareAlike 4.0 -International license or any later version published by Creative -Commons; A copy of the license can be found at -[cc-by-sa-4.0.txt](cc-by-sa-4.0.txt) - -Updated versions of the license (when available) can be found at -<https://creativecommons.org/licenses/by-sa/4.0/legalcode> - -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. - +This page is available under the [CC BY SA 4.0](cc-by-sa-4.0.txt) |