where backup links are available, use those as main instead. this is because of the new XBMK_CACHE_MIRROR variable, which makes --mirror be used when performed on review.coreboot.org, this also pulls down all changes from gerrit code review; the github backups for example only contain the official branches, but gerrit creates a new ref per merge request. a user can still run ./mk -F to force pulling all repos, including the coreboot.org ones, but use of -f will skip the coreboot.org ones if the backup links worked and contain the local commit needed, by a given project used in xbmk. this patch won't change any real-world behaviour for xbmk users, but it is done as a courtesy to the coreboot project, in that it largely avoids a sudden surge in coreboot.org's traffic if lots of users start doing XBMK_CACHE_MIRROR=y if XBMK_CACHE_MIRROR is not set, or set to anything other than y, a regular clone is performed, saving cached sources to cache/clone/ - otherwise, cache/mirror/ is used. Signed-off-by: Leah Rowe <leah@libreboot.org>
Libreboot
Documentation: libreboot.org
Support: #libreboot on
Libera IRC
Libreboot provides libre boot firmware on supported motherboards. It replaces proprietary vendor BIOS/UEFI implementations, by
- Using coreboot to initialize the hardware (e.g. memory controller, CPU, etc.) while minimizing unwanted functionality (e.g. backdoors such as the Intel Management Engine)
- ... which runs a payload such as SeaBIOS, GRUB, or U-Boot
- ... which loads your operating system's boot loader (BSD and Linux-based systems are supported).
Why use Libreboot, and what is coreboot?
A lot of users who use libre operating systems still use proprietary boot firmware, which often contain backdoors and bugs, hampering user freedom and right to repair.
coreboot provides libre boot firmware by initializing the hardware then running a payload. However, coreboot is notoriously difficult to configure and install for most non-technical users, requiring detailed technical knowledge of hardware.
Libreboot solves this by being a coreboot distribution (in the same way that Alpine Linux is a Linux distribution). It provides a fully automated build system that downloads and compiles pre-configured ROM images for supported motherboards, so end-users could easily fetch images to flash onto their devices.
Libreboot also produces documentation aimed at non-technical users and excellent user support via IRC.
Contribute
You can check bugs listed on the bug tracker.
You may use Codeberg pull requests to send patches with bug fixes or other improvements. This repository hosts the code for the main build system. The website lives in a separate repository.
Development is also done on the IRC channel.
License for this README
It's just a README file. It is released under Creative Commons Zero, version 1.0.