site.cfg

@@ -1,3 +1,4 @@
 TITLE="-T Libreboot"
 DOMAIN="https://libreboot.org/"
 BLOGDIR="news/" # leave as empty string if you want the blog to be the homepage
+CSS="--css /global.css"

site/contact.md

@@ -22,13 +22,13 @@ Instructions are also on that page for sending patches (via pull requests).
 IRC chatroom
 ============
 
-IRC is the main way to contact the Libreboot project. `#libreboot` on Libera
+IRC is the main way to contact the libreboot project. `#libreboot` on Libera
 IRC.
 
 Webchat:
 <https://web.libera.chat/#libreboot>
 
-Libera is one of the largest IRC networks, used for Free Software projects.
+Libera is one of the largest IRC networks, used for Libre Software projects.
 Find more about them here: <https://libera.chat/>
 
 If you wish to connect using your preferred client (such as weechat or irssi),
@@ -53,19 +53,16 @@ In general, you should check the documentation provided by your IRC software.
 Social media
 ============
 
-Libreboot exists officially on many places.
+libreboot exists officially on many places.
 
-Twitter and Mastodon
---------------------
+Mastodon
+--------
 
-News announcements: <https://twitter.com/libreboot/>
+The founder and lead developer, Leah Rowe, is on Mastodon:
 
-The founder and lead developer, Leah Rowe, is also on Twitter and Mastodon:
-
-* <https://twitter.com/n4of7> (use nitter to avoid non-free JavaScript)
 * <https://mas.to/@libreleah>
 
-Leah can also be contacted by her email address:
+Leah can also be contacted by this email address:
 [leah@libreboot.org](mailto:leah@libreboot.org)
 
 Reddit

site/contact.uk.md

@@ -0,0 +1,72 @@
+---
+title: Зв'язок
+x-toc-enable: true
+...
+
+**TODO: списки розсилки, сервер mastodon та обліковий запис peertube.**
+
+Підтримка користувачів
+============
+
+IRC або Reddit рекомендовані, якщо ви бажаєте попросити про допомогу (найкраще IRC).
+Дивіться інформацію нижче щодо IRC та Reddit.
+
+Обговорення розробки
+======================
+
+Списки розсилки плануються на майбутнє. Зараз, подивіться нотатки
+на [сторінці Git](git.md) для інформації щодо допомоги з розробкою.
+
+На цій сторінці також знаходяться інструкції по відправці патчів (через pull request'и).
+
+Кімната IRC
+============
+
+IRC це головний спосіб зв'язку з проектом Libreboot. `#libreboot` на Libera
+IRC.
+
+Веб-версія:
+<https://web.libera.chat/#libreboot>
+
+Libera є однією з найбільших мереж IRC, використовуємих для проектів вільного програмного
+забезпечення. Знайти про них більше можна тут: <https://libera.chat/>
+
+Якщо ви бажаєте під'єднатися за допомогою вашого улюбленного клієнта (такого як weechat або irssi),
+інформація для під'єднання наступна:
+
+* Сервер: `irc.libera.chat`
+* Канал: `#libreboot`
+* Порт (TLS): `6697`
+* Порт (не TLS): `6667`
+
+Ми радимо вам використовувати порт `6697` з увімкненим TLS шифруванням.  
+
+Рекомендовано використовувати SASL для аутентифікації. Ці сторінки на веб-сайті Libera
+пояснять вам як:
+
+* Керівництво WeeChat SASL: <https://libera.chat/guides/weechat>
+* Керівництво Irssi SASL: <https://libera.chat/guides/irssi>
+* Керівництво HexChat SASL: <https://libera.chat/guides/hexchat>
+
+Взагалі, вам варто перевірити документацію, яка передбачена вашою програмою IRC.
+
+Соціальні мережі
+============
+
+Libreboot офіційно існує в багатьох місцях.
+
+Mastodon
+--------------------
+
+Засновник та головний розробник, Лія Роу, є в Mastodon:
+
+* <https://mas.to/@libreleah>
+
+Також можливо зв'язатися з Лією за ії електронною адресою:
+[leah@libreboot.org](mailto:leah@libreboot.org)
+
+Reddit
+------
+
+Найбільше використовується як канал підтримки, та також для оголошення новин:
+<https://www.reddit.com/r/libreboot/>

site/contrib.md

@@ -10,10 +10,10 @@ If we forgot to mention you here, let us know and we'll add you. (or if
 you don't want to be mentioned, let us know and we'll remove your
 entry)
 
-Information about who works on Libreboot, and how the project is run, can
+Information about who works on libreboot, and how the project is run, can
 be found on this page: [who.md](who.md)
 
-You can know the history of the Libreboot project, simply by reading this page.
+You can know the history of the libreboot project, simply by reading this page.
 It goes into detail about all of the major contributions to the project, and in
 general how the project was created (and who helped create it).
 
@@ -21,31 +21,87 @@ Leah Rowe
 ---------
 
 **Founder of the Libreboot project, and currently the lead developer.** Leah
-works on all aspects of Libreboot, such as:
+works on all aspects of libreboot, such as:
 
-* General management. Leah handles all outside contributions to Libreboot,
+* General management. Leah handles all outside contributions to libreboot,
   reviews pull requests, deals with bug reports, delegates tasks when necessary
   or desirable. Leah controls the libreboot.org server infrastructure, hosted
-  in her lab (of course it runs Libreboot!)
+  in her lab.
 * Leah has the final say on all decisions, taking input via discussion with
-  members of the public, mostly on IRC. Leah oversees releases of Libreboot,
+  members of the public, mostly on IRC. Leah oversees releases of libreboot,
   and generally keeps the project going. Without Leah, there would be no Libreboot!
-* The build system (lbmk, short for Libreboot Make). This is the automated build
-  system that sits at the heart of Libreboot; it downloads, patches, configures
+* The build system (lbmk, short for libreboot Make). This is the automated build
+  system that sits at the heart of libreboot; it downloads, patches, configures
   and compiles the relevant components like coreboot, GNU GRUB and generates
-  the Libreboot ROM images that you can find in release archives.
-* Upstream work on coreboot, when necessary (and other projects that Libreboot
-  uses). This means also working with people from outside of the Libreboot
+  the libreboot ROM images that you can find in release archives.
+* Upstream work on coreboot, when necessary (and other projects that libreboot
+  uses). This means also working with people from outside of the libreboot
   project, to get patches merged (among other things) on the upstream projects
-  that Libreboot uses
+  that libreboot uses
 * Providing user support on IRC
-* *Commercial* user support via her company listed
-  on [the suppliers page](/suppliers.md)
 
-Leah is also responsible for [osboot.org](https://osboot.org/) which is heavily
-based on Libreboot, but with different project goals.
+Caleb La Grange
+---------------
+
+**Secondary developer, number two to Leah.** Caleb is a full time libreboot developer
+with a narrower focus. Caleb focuses on several areas of development:
+
+* Build system. Caleb is responsible for improving and fixing the libreboot Make build
+system. Specifically: binary blob management, automation, and reproducibility. 
+* Hardware modification. Caleb has a passion for hardware alteration; soldering,
+desoldering, and testing libreboot software on the resulting hardware.
+* Board porting. Anything supported in Coreboot can be ported to libreboot, Caleb
+will test and port any board he can get his hands on. Additionally, anyone can
+contact Caleb to generate libreboot roms for testing on their board.
+* Documentation. Caleb actively maintains documentation on the above areas of
+interest. Additionally, Caleb is responsible for disassembly guides with his own
+pictures and diagrams for several boards.
+* User support. Caleb is active on irc and willing to help any user interested in
+using libreboot or in need of help.
+* Project goals. Caleb collaborates with Leah on determining project goals.
+Leah has the final say in every decision.
+
+External projects
+=================
+
+Coreboot project
+----------------
+
+Without coreboot, the libreboot project simply would not be possible.
+
+The people and companies that work on coreboot are numerous, and they make the
+libreboot project what it is. The libreboot project makes heavy use of coreboot, to
+provide hardware initialization.
+
+GNU GRUB
+--------
+
+GRUB is the bootloader used by libreboot. It goes without saying that the GRUB
+developers enable libreboot, through their work.
+
+SeaBIOS
+-------
+
+The libreboot firmware provides SeaBIOS as a payload option. SeaBIOS provides a
+legacy x86 BIOS implementation.
+
+U-Boot
+------
+
+Libreboot uses U-Boot as the coreboot payload on supported ARM Chromebooks.
 
-Other people are listed below, in alphabetical order:
+Contributors in alphabetical order
+==================================
+
+Alper Nebi Yasak
+----------------
+
+Contributed the build system integration and documentation for using
+U-Boot as payload, and initial Libreboot ports of some ARM Chromebooks
+based on that.
+
+Alper also does upstream development on U-Boot, e.g. continued an almost
+complete port of the `gru-kevin` board and got it merged upstream.
 
 Alyssa Rosenzweig
 -----------------
@@ -76,7 +132,7 @@ Arthur Heymans
 
 Merged a patch from coreboot into libreboot, enabling C3 and C4 power
 states to work correctly on GM45 laptops. This was a long-standing issue
-before Athur's contribution. Arthur also fixed VRAM size on i945 on
+before Arthur's contribution. Arthur also fixed VRAM size on i945 on
 GM45 systems, allowing maximum VRAM allocation for the onboard GPUs on
 these systems, another longstanding issue in libreboot.
 
@@ -99,13 +155,13 @@ Damien's upstream work on coreboot.
 Denis Carikli
 -------------
 
-Based on the work done by Peter Stuge, Vladimir Serbineko and others in
+Based on the work done by Peter Stuge, Vladimir Serbinenko and others in
 the coreboot project, got native graphics initialization to work on the
 ThinkPad X60, allowing it to be supported in libreboot. Denis gave
 a lot of advice and helped found the libreboot project.
 
 Denis was a mentor to Leah Rowe in the early days, when she founded the
-Libreboot project. A lot of the decision decisions taken, especially with the
+Libreboot project. A lot of the decisions taken, especially with the
 Libreboot build system (lbmk), were inspired from talks with Denis.
 
 Denis taught Leah about registers used by Intel GPUs for backlight control. In
@@ -145,7 +201,7 @@ that, the solution was clear:
 
 A project needed to exist, providing a fully free version of coreboot, without
 any binary blobs. At the time (and this is still true today), coreboot was not
-entirely free software and shipped with binary blobs by default. In particular,
+entirely libre software and shipped with binary blobs by default. In particular,
 CPU microcode updates were included by default, on all x86 machines. Working
 with Joshua who reviewed my work, I created a fully free version of coreboot.
 At first, it wasn't called Libreboot, and the work was purely intended for my
@@ -169,17 +225,6 @@ Klemens Nanni
 Made many fixes and improvements to the GRUB configuration used in
 libreboot, and several tweaks to the build system.
 
-Leah Rowe initially helped Klemens get his project, autoboot, off the ground.
-Autoboot (website autoboot.org) is no longer online, but was a fork of Libreboot
-with different project goals; in late 2020, Leah Rowe decided to create her
-own new fork of Libreboot called *osboot*, heavily inspired by Klemens's earlier
-work. See: <https://osboot.org/>
-
-The following is an archive of autoboot.org, from when it was online back in
-2016: <http://web.archive.org/web/20160414205513/http://autoboot.org/> (the
-autoboot website went offline a few months later, after Klemens abandoned the
-project)
-
 Lisa Marie Maginnis
 -------------------
 
@@ -227,10 +272,13 @@ and forth with Lisa around mid 2016, mostly raminit patches, to get the board
 running at the FSF offices. This work ultimately lead to a most wonderful
 achievement:
 
-The <https://www.gnu.org/> and <https://www.fsf.org/> websites now run on
+The FSF and GNU websites now run on
 Librebooted ASUS KGPE-D16 based servers, on a fully free GNU+Linux distro. This
 means that the FSF now has full software freedom for their hosting infrastructure.
 
+**NOTE: D16/D8 and KFSN4-DRE boards were removed from Libreboot on November
+19th, 2022.**
+
 The FSF also provides access to this infrastructure for many other projects
 (besides GNU projects); for example, Trisquel uses a D16 provided by the FSF
 for their development server used for building Trisquel releases and testing
@@ -379,8 +427,10 @@ Ported the ASUS KGPE-D16 board to coreboot for the company Raptor
 Engineering of which Timothy is the CEO.
 Timothy maintains this code in coreboot,
 helping the project with the libreboot integration for it. This person's
-contact details are on the raptor site, or you can ping **tpearson** on
-the Libera IRC network.
+contact details are on the raptor site.
+
+**D16 support was removed on 19 November 2022. You can still use older
+revisions of Libreboot, and older release versions.**
 
 vitali64
 --------

site/contrib.uk.md

@@ -0,0 +1,452 @@
+---
+title: Учасники проекту
+x-toc-enable: true
+...
+
+У цьому списку не обов'язково вказується, хто зараз працює над проектом,
+але в ньому вказано людей, які зробили значний внесок у проект.
+
+Якщо ми забули вас тут згадати, повідомте нам, і ми вас додамо. (або якщо
+ви не хочете, щоб вас згадували, повідомте нас, і ми видалимо ваш
+запис)
+
+Інформацію про те, хто працює над libreboot і як працює проект, можна
+знайти на цій сторінці: [who.md](who.md)
+
+Ви можете дізнатися історію проекту libreboot, просто прочитавши цю сторінку.
+Тут докладно розповідається про всі основні внески в проект і
+загалом про те, як створювався проект (і хто допоміг його створити).
+
+Лія Роу
+---------
+
+**Засновник проекту Libreboot, а зараз провідний розробник** Лія
+працює над усіма аспектами libreboot, такими як:
+
+* Загальне керівництво. Лія обробляє всі зовнішні внески до libreboot,
+  переглядає пул реквести, має справу із звітами про помилки, делегує завдання, коли це необхідно
+  або бажано. Лія контролює серверну інфраструктуру libreboot.org, розміщену
+  в її лабораторії.
+* Лія має останнє слово щодо всіх рішень, беручи внесок через обговорення з
+  представниками громадськості, переважно на IRC. Лія контролює випуски libreboot
+  і загалом підтримує проект. Без Лії не було би Libreboot!
+* Система збірки (lbmk, скорочення від libreboot Make). Це автоматизована
+  система збирання, яка лежить в серці libreboot; він завантажує, патчить, налаштовує
+  та компілює відповідні компоненти, такі як coreboot, GNU GRUB, і генерує образи ROM
+  libreboot, які ви можете знайти в архівах випусків.
+* Апстрім робота над coreboot, коли необхідно (та іншими проектами, які libreboot
+  використовує). Це також означає роботу з людьми поза межами проекту libreboot,
+  щоб об'єднати виправлення (між іншим) в апстрім проектах,
+  які libreboot використовує
+* Надання підтримки користувачів на IRC
+
+Калеб Ла Гранж
+---------------
+
+**Вторинний розробник, номер два для Лії.** Калеб - розробник libreboot на повний робочий день
+з вузьким фокусом. Калеб зосереджується на кількох напрямках розвитку:
+
+* Система побудови. Калеб відповідає за вдосконалення та виправлення системи побудови libreboot Make.
+Зокрема, управління бінарними блобами, автоматизація та відтворюваність. 
+* Апаратна модифікація. Калеб має пристрасть до переробки апаратного забезпечення; паяння,
+розпаювання, та тестування libreboot на отриманому обладнанні.
+* Перенесення плати. Все, що підтримується в Coreboot, можна перенести на libreboot, Калеб
+перевірить і перенесе будь-яку плату, до якої зможе потрапити. Крім того, будь-хто може
+зв'язатись з Калебом, щоб створити образи libreboot для тестування на своїй платі.
+* Документація. Калеб активно веде документацію щодо зазначених вище сфер
+інтересу. Додатково, Калеб відповідає за посібники з розбирання з власними
+малюнками та діаграмами для кількох плат.
+* Підтримка користувачів. Калеб активний в irc і готовий допомогти будь-якому користувачеві, який зацікавлений в
+використанні libreboot або потребує допомоги.
+* Цілі проекту. Калеб співпрацює з Лією над визначенням цілей проекту.
+Лія має останнє слово в кожному рішенні.
+
+Зовнішні проекти
+================
+
+Проект Coreboot
+----------------
+
+Без coreboot проект libreboot був би просто неможливий.
+
+Людей і компаній, які працюють над coreboot, багато, і вони роблять
+проект libreboot таким, яким він є. Проект libreboot активно використовує coreboot
+для ініціалізації обладнання.
+
+GNU GRUB
+--------
+
+GRUB - це завантажувач, який використовується libreboot. Само собою зрозуміло, що
+розробники GRUB стимулюють libreboot своєю роботою.
+
+SeaBIOS
+-------
+
+Прошивка libreboot надає SeaBIOS як опцію корисного навантаження. SeaBIOS забезпечує
+застарілу реалізацію BIOS x86.
+
+U-Boot
+------
+
+Libreboot використовує U-Boot як корисне навантаження coreboot на ноутбуках
+ARM Chromebook з підтримкою coreboot.
+
+Внески в алфавітному порядку
+============================
+
+Алісса Розенцвейг
+-----------------
+
+Переключила веб-сайт на використання розмітки замість рукописного HTML та користувацького
+PHP. **Колишній супроводжувач проекту libreboot (системний адміністратор libreboot.org).**
+
+Алісса написала оригінальний генератор статичних сайтів (скрипти bash, що перетворюють
+markdown в html, через pandoc) для libreboot.org. Цей генератор статичних сайтів
+був значно змінений і відгалужений Лією Роу у формальний проект:
+
+<https://untitled.vimuser.org/> (untitled - це робота Лії, а не Алісси, але вона базується на
+оригінальній роботі Аліси над генератором статичних сайтів, який раніше використовував Libreboot;
+веб-сайт Libreboot тепер створено за допомогою Untitled)
+
+Альпер Небі Ясак
+----------------
+
+Надав інтеграцію системи збірки та документацію для використання
+U-Boot в якості корисного навантаження, та початкові порти Libreboot деяких ARM Chromebook
+виходячи з того.
+
+Альпер також займається розробкою на U-Boot, напр. продовжив майже завершений
+порт плати `gru-kevin` і об'єднав його з апстрімом.
+
+Артур Хейманс
+--------------
+
+Об'єднав патч із coreboot у libreboot, дозволяючи режимам живлення C3 та C4
+правильно працювати на ноутбуках GM45. Це була давня проблема до внеску
+Артура. Артур також виправив розмір відеопам'яті на i945 на системах
+GM45, що дозволило максимально розподілити VRAM для вбудованих графічних процесорів
+у цих системах, ще одна давня проблема в libreboot.
+
+Артур також працював над системою збірки Libreboot, коли він був учасником
+проекту. Він досі працює над coreboot, і Libreboot отримує велику
+користь від його роботи. Його внесок у проект coreboot і Libreboot
+неоціненний.
+
+Володимир Сербіненко
+-------------------
+
+Перенес багато thinkpad, які підтримуються в libreboot, на coreboot, а
+також зробив багато виправлень у coreboot, які принесли користь проекту libreboot.
+
+Володимир написав багато вихідного коду ініціалізації відео, який використовується різними
+платформами Intel у Libreboot, під час прошивки (зараз переписаний
+іншими в Ada, для libgfxinit в coreboot, але спочатку він був написаний на
+C і включений безпосередньо в coreboot; libgfxinit є субмодуль третьої сторони).
+
+Демієн Замміт
+-------------
+
+Підтримує порт coreboot Gigabyte GA-G41M-ES2L, інтегрований у
+libreboot. Також працює над іншим апаратним забезпеченням на користь
+проекту libreboot.
+
+Демієн не працював безпосередньо над самим Libreboot, але він багато працював з
+Лією Роу, інтегруючи патчі та нові порти плати в Libreboot на основі
+попередньої роботи Демієна над coreboot.
+
+Денис Каріклі
+-------------
+
+На основі роботи, виконаної Пітером Стюджем, Володимиром Сербіненко та іншими
+в проекті coreboot, вдалось налагодити нативну ініціалізацію графіки для роботи
+на ThinkPad X60, що дозволяє підтримувати її в libreboot. Денис дав
+багато порад і допоміг створити проект libreboot.
+
+Денис був наставником Лії Роу в ранні дні, коли вона заснувала проект
+Libreboot. Багато прийнятих рішень, особливо щодо системи збірки
+Libreboot (lbmk), були натхненні розмовами з Денисом.
+
+Денис навчив Лію про регістри, які використовуються графічним процесором Intel для керування підсвічуванням.
+В ранні дні, ноутбуки ThinkPad X60 та T60 в Libreboot не мали працюючого
+контроля підсвічуванням, тому яскравість завжди була 100%. За допомогою Дениса,
+Лія змогла налаштувати керування підсвічуванням шляхом зворотньої розробки
+правильних значень для запису в ці регістри. На основі цього в coreboot
+було написано просте виправлення; однак виправлення перезаписувало безпосередньо регістр
+і не працювало з елементами керування яскравістю на основі ACPI. Інші в coreboot
+пізніше вдосконалили його, змусивши елементи керування підсвічуванням на основі ACPI працювати належним чином, на основі цієї
+попередньої роботи.
+
+Джерун Квінт
+------------
+
+Додав кілька виправлень до документації libreboot, пов'язаної зі
+встановленням Parabola з повним дисковим шифруванням у системах libreboot.
+
+Джошуа Гей
+----------
+
+Джошуа колишній співробітник FSF.
+
+Джошуа допоміг із раннім заснуванням проекту Libreboot, будучи
+(на той час) менеджером з ліцензування та відповідності FSF. Його роботою було
+переглядати продукти, надіслані до FSF для перевірки; FSF має програму
+сертифікації, під назвою *Поважає Вашу Свободу* (Respects Your Freedom), за якою FSF рекламуватиме
+продукти вашої компанії, якщо вони постачаються з усім вільним програмним
+забезпеченням.
+
+Я, Лія Роу, спочатку просто продавала ноутбуки ThinkPad X60 із звичайним
+coreboot, і це включало оновлення мікрокоду ЦП. У той час
+я не дуже про це думала. Джошуа зв'язався зі мною, в своїх повноваженнях FSF, і спитав,
+чи зацікавить мене програма RYF FSF; Я була дуже здивована, що FSF
+сприйме мене серйозно, і я сказала так. Саме з цього почалася рання робота
+над Libreboot. Джошуа показав мені всі проблеми з моїми продуктами, і з
+цього, рішення було очевидним:
+
+Необхідно, щоб існував проект із повністю вільною версією coreboot без будь-яких
+бінарних блобів. У той час (і це актуально й сьогодні) coreboot не був
+повністю вільним програмним забезпеченням і за замовчуванням постачався з двійковими блобами. Зокрема,
+оновлення мікрокоду ЦП включено за замовчуванням на всіх машинах x86. Працюючи
+з Джошуа, я створила повністю вільну версію coreboot.
+Спочатку він не називався Libreboot, і робота була призначена виключно для моєї
+компанії (на той час вона називалася Gluglug), яку просувала FSF.
+
+Джошуа використовував свої медійні зв'язки в FSF, щоб активно рекламувати мою роботу, і
+13 грудня 2013 року народився проект Libreboot (але не названий так).
+Джошуа переконався, щоб всі знали, що я роблю!
+
+Через кілька місяців було створено назву *Libreboot* і зареєстровано доменне ім'я
+*libreboot.org*. У цей момент офіційно народився проект Libreboot (на початку
+2014 року). Знову Джошуа надав всю можливу допомогу,
+активно просуваючи проект, і навіть написав цю статтю на веб-сайті FSF
+оголосивши про це:
+
+<https://www.fsf.org/blogs/licensing/replace-your-proprietary-bios-with-libreboot>
+
+
+Ендрю Роббінс
+--------------
+
+Працював над великими частинами старої системи збірки Libreboot і пов'язаною документацією.
+Ендрю приєднався до проекту Libreboot як штатний розробник у червні 2017,
+до моменту свого відходу в березні 2021 року.
+
+Я, Лія Роу, дуже вдячна Ендрю Роббінсу за його численні внески
+протягом багатьох років.
+
+Клеменс Нанні
+-------------
+
+Внесено багато виправлень і покращень у конфігурацію GRUB, яка використовується в
+libreboot, а також кілька змін у системі збірки.
+
+Ліза Марі Магінніс
+-------------------
+
+Ліза - колишній системний адміністратор Free Software Foundation. На перших днях
+проекту вона давала Лії багато технічних порад. Спочатку вона створила
+IRC-канал Libreboot, коли Лія не знала, як користуватися
+IRC, а також передала +F статус засновника для каналу. Як системний
+адміністратор FSF, роботою Лізи було підтримувати велику частину інфраструктури,
+яку використовує Libreboot; на той час списки розсилки на веб-сайті GNU Savannah
+використовувалися проектом Libreboot. Ліза також була тією, хто спочатку
+заохочував Лію приєднатися Libreboot до проекту GNU (рішення, яке пізніше,
+більше на жаль, було скасовано). Коли Пол Коціалковскі був учасником проекту в
+2016 році, вона допомогла йому отримати допомогу від FSF; на той час він був
+керівником проекту Replicant, який фінансував FSF, і FSF дозволив
+йому використати частину цього фінансування для його роботи над Libreboot, завдяки Лізи
+підтримці, коли вона працювала у FSF.
+
+Ліза також втрутилася, коли Лія Роу пропустила виступ на LibrePlanet 2016. Лія мала
+виступити з доповіддю про Libreboot, але не з'явилася вчасно. Ліза разом
+із Патріком Макдермоттом (колишнім розробником Libreboot, який був присутній
+на тій конференції) виступили замість Лії. Розмова ніколи не була записана, але
+Фонд вільного програмного забезпечення має ці фотографії цієї розмови на веб-сайті LibrePlanet
+(жінка з блакитним волоссям - Ліза, а довговолосий хлопець із вусами -
+Патрік):
+
+<https://media.libreplanet.org/u/libreplanet/m/session-02-c-mws-png-libreplanet-2016-sessions/>
+(посилання на архів: <http://web.archive.org/web/20170319043913/https://media.libreplanet.org/u/libreplanet/m/session-02-c-mws-png-libreplanet-2016-sessions/>)
+
+<https://media.libreplanet.org/u/libreplanet/m/session-02-c-wide-png-libreplanet-2016-sessions/>
+(посилання на архів: <http://web.archive.org/web/20170319043915/https://media.libreplanet.org/u/libreplanet/m/session-02-c-wide-png-libreplanet-2016-sessions/>)
+
+Цікавий факт: Патрік також є провідним розробником ProteanOS, проекту вбудованої
+ОС, схваленого FSF: <http://proteanos.com/> (використовує BusyBox і Linux-libre)
+
+Лія Роу провела *2* семінари LibrePlanet; один у 2015 році та інший у 2016 році,
+відвідуючи Бостон, Массачусетс, США в обох випадках для участі в цих конференціях. Ці
+семінари стосувалися встановлення Libreboot. Люди приходили на обидва семінари, щоб
+встановити Libreboot на свої комп'ютери. Як системний адміністратор FSF, на той час,
+Ліза забезпечила всю інфраструктуру та обладнання, яке використовувалося на цих семінарах.
+Без її допомоги ці майстер-класи були б неможливими.
+
+Коли материнська плата ASUS KGPE-D16 (серверна плата високого класу) була перенесена на Libreboot,
+Лія, працюючи з Тімоті Пірсоном (той, хто її переніс),
+приблизно в середині 2016 року поділилася з Лізою виправленнями, в основному виправленнями raminit, щоб отримати плату, яка працює в офісах FSF. Ця робота
+зрештою призвела до чудового досягнення:
+
+Веб-сайти FSF і GNU тепер працюють на, з встановленим Libreboot,
+заснованих на ASUS KGPE-D16 серверах, на повністю вільному GNU+Linux дистрибутиві. Це
+означає, що FSF тепер має повну свободу програмного забезпечення для своєї
+інфраструктури хостингу.
+
+**ПРИМІТКА: Плати D16/D8 та KFSN4-DRE було видалено з Libreboot 19 листопада
+2022 року**
+
+FSF також надає доступ до цієї інфраструктури для багатьох інших проектів
+(крім проектів GNU); наприклад, Trisquel використовує D16, наданий FSF
+для свого сервера розробки, який використовується для створення випусків Trisquel і тестування
+змін у дистрибутиві Trisquel GNU+Linux. Trisquel - це повністю вільний
+GNU+Linux дистрибутив, активно просуваний FSF.
+
+Ліза була сильною прихильницею Libreboot на перших днях проекту,
+і її внесок був неоціненним. Я, Лія Роу, у боргу перед нею.
+
+Маркус Мьоллер
+--------------
+
+Зробив логотип libreboot.
+
+Патрік "П. Дж." Макдермотт
+---------------------------
+
+Патрік також провів багато досліджень і написав розділ поширених запитань libreboot,
+пов'язаний із [Intel Management Engine](../faq.md#intelme), а також зробив кілька покращень у
+системі збірки libreboot. **Колишній супроводжувач проекту
+libreboot.**
+
+У 2016 році Лія Роу провела семінар зі встановлення Libreboot на конференції FSF
+LibrePlanet. Працюючи разом з Лією, Патрік допомагав вести семінар
+та допомагав установлювати Libreboot на комп'ютери людей.
+
+Пітер Стюдж
+-----------
+
+Допоміг написати [розділ поширених запитань про DMA](../faq.md#hddssd-firmware), та надав
+загальні поради на перших днях проекту. У той час Пітер був розробником coreboot
+і головним розробником проекту *libusb* (який flashrom
+активно використовує).
+
+Пітер також написав утиліту *bucts*, яка використовується для встановлення біта Top Swap
+(TS) для керування резервним копіюванням (BUC) на ноутбуках i945, таких як ThinkPad X60/T60, яка є корисною для
+обхідного шляху для прошивки Libreboot без використання зовнішнього обладнання; на цій машині,
+з Lenovo BIOS, можна перепрошити все, крім головного завантажувального
+блоку, але платформи Intel мають 2 завантажувальні блоки, і ви вказуєте, який із них
+використовувати, встановленням біта TS. Потім ви завантажуєтеся лише з одним прошитим завантажувальним блоком
+(завантажувальним блоком проекту coreboot на цій машині), а потім скидаєте
+bucts перед повторною прошивкою ROM, щоб прошити основний завантажувальний блок. Libreboot
+розміщує копію його роботи, оскільки його веб-сайт, на якому розміщено bucts,
+більше не відповідає.
+
+Пол Коціалковський
+-----------------
+
+Переніс ноутбуки Chromebook на основі ARM (Rockchip RK3288 SoC) до
+libreboot. Також один із головних розробників [Replicant](http://www.replicant.us/).
+
+Пол Менцель
+-----------
+
+Дослідив та виправив помилку в coreboot на ThinkPad X60/T60, яку виявляло
+ядро Linux 3.12 і новіших версій, через яку прискорення 3D не
+працювало, а відео загалом ставало нестабільним. Проблема полягала в тому, що
+coreboot під час ініціалізації відеочіпсета Intel, відображав *GTT Stolen Memory* в
+не тому місці, оскільки код базувався на коді ядра, а в ядрі Linux
+була така сама помилка. Коли Linux це виправив, він виявив ту саму помилку в coreboot.
+
+Пол працював над цим із Libreboot,
+періодично надсилаючи патчі для тестування, доки помилку не було виправлено
+в coreboot, а потім допоміг ій інтегрувати виправлення в libreboot.
+
+Стів Шентон
+-------------
+
+Стів виконав першу роботу зі зворотньої розробки Intel Flash Descriptor, який використовується
+на машинах ICH9M, таких як ThinkPad X200. Він створив структуру C, що визначає (використовуючи
+бітові поля в C) цю область дескриптора. За допомогою деяких хитрих трюків він зміг
+виявити існування біта в дескрипторі для *вимкнення* Intel ME
+(management engine) на цих платформах.
+
+Його початкове підтвердження концепції визначило лише дескриптор, і зробило би це:
+
+* Читання дескриптора за замовчуванням і регіонів GbE з ROM Lenovo X200 (прошивка
+  за замовчуванням, не coreboot)
+* Вимкнення ME, встановивши 2 біти в дескрипторі
+* Вимкнення регіона ME
+* Переміщення дескриптора+GbE (загалом 12КБ) поруч
+* Виділення решти флеш-пам'яті для регіону BIOS
+* На основі цього створено 12КБ регіон дескриптор+область GBE для вставки
+  в образ ROM coreboot.
+
+У перші дні, до того, як Libreboot підтримував платформи GM45+ICH9M, такі як
+ThinkPad X200/T400, ви могли використовувати ці машини, але щоб уникнути
+Intel ME, вам доводилося виконувати прошивку без області дескриптора. У ті часи це працювало нормально,
+тому що ME обробляв лише TPM та AMT на цих машинах, і система
+працювала нормально, але Intel Flash Descriptor також обробляє область Intel GbE NVM
+у флеш-пам'яті, яка використовується для інтерфейсу Intel Gigabit Ethernet.
+
+Отже, ви або мали Intel ME, або не підтримували ethernet. Стів зрозумів, як
+вимкнути Intel ME за допомогою 2 бітів перемикання в дескрипторі, а також як видалити область
+Intel ME з флеш-пам'яті.
+
+Ґрунтуючись на його дослідженні, я, Лія Роу, працюючи разом зі Стівом, також виконала зворотню розробку
+області Intel GbE NVM (енергонезалежна пам'ять) у
+завантажувальній флеш-пам'яті. Цей регіон визначає параметри конфігурації для вбудованої мережевої карти Intel
+GbE, якщо присутня.
+
+На основі цього я змогла взяти початкове підтвердження концепції та написати
+утиліту `ich9gen`, яка генерує Intel Flash Descriptor та регіон GbE NVM,
+з нуля, без визначення регіону Intel ME. Саме цей інструмент,
+інструмент `ich9gen`, використовує Libreboot для надання образів ROM для GM45+ICH9M
+платформ (таких як ThinkPad X200/T400/T500/W500), із повнофункціональним
+дескриптором та функціональним Gigabit Ethernet, але *без* необхідності мікропрограми Intel
+Management Engine (ME), що робить ці машини *вільними* (ME
+повністю вимкнено, коли ви використовуєте образ дескриптора+gbe, створене `ich9gen`).
+
+З *моїм* інструментом `ich9gen` (інструмент Стіва називався `ich9deblob`), вам більше
+не потрібен був дамп оригінальної мікропрограми Lenovo BIOS! Я не могла би написати цей інструмент
+без первинного підтвердження концепції Стіва. Я працювала з ним
+протягом багатьох місяців. Вся GM45+ICH9M підтримка (X200, T400 і так далі) в
+Libreboot стала можливою завдяки його роботі у 2014 році.
+
+Тімоті Пірсон
+---------------
+
+Перенес плату ASUS KGPE-D16 до coreboot для компанії Raptor
+Engineering, генеральним директором якої є Тімоті.
+Тімоті підтримує цей код у coreboot, допомогаючи проекту,
+з його інтеграцією з libreboot. Контактні
+дані цієї людини є на сайті raptor.
+
+**Підтримку D16 було припинено 19 листопада 2022 року. Ви все ще можете використовувати
+старіші версії Libreboot, і старіші випуски.**
+
+Swift Geek
+----------
+
+Додав патч для ich9gen для створення дескрипторів розміром 16MiB.
+
+Після цього Swift Geek повільно почав долучатися, поки не став розробником на повний
+робочий день. Внески Swift Geek насправді ніколи не були у формі *коду*,
+але те, що йому не вистачало в коді, він компенсував чудовою підтримкою як для користувачів,
+так і для інших розробників, допомагаючи іншим дізнатися більше про технології на
+низькому рівні.
+
+Коли Swift Geek був учасником проекту, його роль здебільшого полягала в
+наданні підтримки користувачам (на каналі IRC) і проведенні досліджень. Swift Geek знає
+багато про апаратне забезпечення. Swift Geek також зробив деяку апстрім розробку GNU GRUB.
+
+Swift Geek неодноразово надавав технічні поради Лії Роу
+та допоміг їй покращити її навички паяння, а також навчив її
+деяким навичкам ремонту, до того моменту, коли вона тепер може виправляти більшість несправностей
+на материнських платах ThinkPad (під час перегляду схем та бордв'ю).
+
+Swiftgeek залишив проект у березні 2021 року. Я, Лія Роу, бажаю його всього найкращого в його
+починаннях і дуже вдячна за його численні внески протягом багатьох
+років.
+
+vitali64
+--------
+
+Додав підтримку cstate 3 на macbook21, що забезпечує тривалий термін служби батареї
+та нижчу температуру процесора під час простою. vitali64 на irc

site/docs/bsd/freebsd.md

@@ -1,130 +0,0 @@
----
-title: How to install FreeBSD on x86 GNU GRUB payload
-x-toc-enable: true
-...
-
-FreeBSD might show graphical corruption during bootup. You can fix this by
-altering the order in which kernel modules/drivers are loaded. First, try moving
-video to an earlier stage on the boot process, or try moving it to a later stage
-instead. With this, you should be able to get a working display.
-
-freebsd.img is the installation image for FreeBSD. Adapt the filename
-accordingly, for whatever FreeBSD version you use.
-
-Prepare the USB drive (in FreeBSD)
-----------------------------------
-
-[This page](https://www.freebsd.org/doc/handbook/bsdinstall-pre.html) on
-the FreeBSD website shows how to create a bootable USB drive for
-installing FreeBSD. Use the *dd* on that page.
-
-Prepare the USB drive (in NetBSD)
----------------------------------
-
-[This
-page](https://wiki.netbsd.org/tutorials/how_to_install_netbsd_from_an_usb_memory_stick/)
-on the NetBSD website shows how to create a NetBSD bootable USB drive
-from within NetBSD itself. You should use the *dd* method documented
-there; you can use this with any ISO, including FreeBSD.
-
-Prepare the USB drive (in LibertyBSD or OpenBSD)
-------------------------------------------------
-
-If you downloaded your ISO on a LibertyBSD or OpenBSD system, here is
-how to create the bootable FreeBSD USB drive:
-
-Connect the USB drive. Check dmesg:
-
-    dmesg | tail
-
-Check to confirm which drive it is, for example, if you think its sd3:
-
-    disklabel sd3
-
-Check that it wasn't automatically mounted. If it was, unmount it. For
-example:
-
-    doas umount /dev/sd3i
-
-dmesg told you what device it is. Overwrite the drive, writing the
-FreeBSD installer to it with dd. For example:
-
-    doas dd if=freebsd.img of=/dev/rsdXc bs=1M; sync
-
-You should now be able to boot the installer from your USB drive.
-Continue reading, for information about how to do that.
-
-Prepare the USB drive (in GNU+Linux)
-------------------------------------
-
-If you downloaded your ISO on a GNU+Linux system, here is how to create
-the bootable FreeBSD USB drive:
-
-Connect the USB drive. Check dmesg:
-
-    dmesg
-
-Check lsblk to confirm which drive it is:
-
-    lsblk
-
-Check that it wasn't automatically mounted. If it was, unmount it. For
-example:
-
-    sudo umount /dev/sdX\*
-    umount /dev/sdX\*
-
-dmesg told you what device it is. Overwrite the drive, writing your
-distro ISO to it with dd. For example:
-
-    sudo dd if=freebsd.img of=/dev/sdX bs=8M; sync
-    dd if=freebsd.img of=/dev/sdX bs=8M; sync
-
-You should now be able to boot the installer from your USB drive.
-Continue reading, for information about how to do that.
-
-Installing FreeBSD without full disk encryption
------------------------------------------------
-
-Press C in GRUB to access the command line:
-
-    grub> kfreebsd (usb0,gpt3)/boot/kernel/kernel
-    grub> set FreeBSD.vfs.mountfrom=ufs:/dev/da1p3\
-    grub> boot
-
-It will start booting into the FreeBSD installer. Follow the normal
-process for installing FreeBSD.
-
-Installing FreeBSD with full disk encryption
---------------------------------------------
-
-TODO
-
-Booting
--------
-
-TODO
-
-Configuring Grub
-----------------
-
-TODO
-
-Troubleshooting
-===============
-
-Most of these issues occur when using libreboot with coreboot's 'text
-mode' instead of the coreboot framebuffer. This mode is useful for
-booting payloads like memtest86+ which expect text-mode, but for FreeBSD
-it can be problematic when they are trying to switch to a framebuffer
-because it doesn't exist.
-
-In most cases, you should use the corebootfb ROM images. There ROM images
-have `corebootfb` in the file name, and they start in a high resolution frame
-buffer, provided by coreboot's `libgfxinit` library.
-
-won't boot...something about file not found
----------------------------------------------
-
-Your device names (i.e. usb0, usb1, sd0, sd1, wd0, ahci0, hd0, etc) and
-numbers may differ. Use TAB completion.

site/docs/bsd/index.md

@@ -3,78 +3,169 @@ title: BSD operating systems
 x-toc-enable: true
 ...
 
-This section is largely x86-centric, pertaining to use of BSD operating systems.
-Although not as popular, BSD systems are also (in most cases) *Free Software*,
-but they are non-copyleft.
+Guide last updated on 16 November 2022.
 
-Libreboot is capable of booting many BSD systems. This section mostly documents
-the peculiarities of Libreboot as it pertains to BSD; you can otherwise refer to
+NOTE: This guide pertains to x86 hosts, and does not cover supported CrOS/ARM
+chromebooks. For ARM targets, you should refer to u-boot documentation.
+
+libreboot is capable of booting many BSD systems. This section mostly documents
+the peculiarities of libreboot as it pertains to BSD; you can otherwise refer to
 the official documentation for whatever BSD system you would like to use.
 
-Video modes
-===========
+Kernel Mode Setting
+===================
+
+Your BSD system *must* support Kernel Mode Setting for your graphics
+device (most of them do nowadays). The reasons will become apparent, as
+you read this article.
+
+Boot BSD, using SeaBIOS
+=======================
+
+On x86 platforms, libreboot/libreboot both provide the choice of GNU GRUB and/or
+SeaBIOS payload. GRUB can technically boot BSD kernels, but the code is
+poorly maintained and unreliable for this use-case scenario; on BIOS systems,
+GRUB can chainload BSD bootloaders, but on bare metal (as coreboot payload),
+GRUB can only chainload other coreboot payloads or boot Linux/BSD kernels
+directly (but direct booting is only really reliable for Linux, in GRUB).
+
+It is recommended that you boot in text mode, with SeaBIOS. You can literally
+just follow the official installation guides for your BSD system, whether it
+be FreeBSD, OpenBSD or others.
+
+If you don't plan to set up Xorg/Wayland, then that's all you really need to
+do. For example, you might want to run a headless server, in which case you
+probably don't mind running in text mode all the time.
+
+OpenBSD and corebootfb
+----------------------
+
+It's still recommended to use SeaBIOS in text mode, but OpenBSD specifically
+can work with SeaBIOS booting in a coreboot framebuffer, with SeaVGABIOS. In
+Libreboot ROM images, this would be SeaBIOS images with `corebootfb` in the
+file name.
+
+Make sure to select MBR-style partitioning on the installer, and it will
+Just Work.
+
+If you're using the GRUB payload but SeaBIOS is available in the boot menu,
+you can just select SeaBIOS at said menu, and OpenBSD will work fine.
+
+FreeBSD and corebootfb
+----------------------
+
+Assumed broken, so please ensure that you boot with SeaBIOS payload in text
+mode (lbmk ROM images with `txtmode` in the file name, not `corebootfb`).
+
+Warnings for X11 users
+----------------------
+
+One important peculiarity of most libreboot and libreboot systems is: VGA mode
+support exists, if booting with corebootfb (coreboot's own framebuffer) and
+the SeaVGABIOS option ROM used in the SeaBIOS payload; however, the ability
+to switch modes is not present, which means you can't switch to text mode
+either.
+
+Coreboot can start in framebuffer (corebootfb) or INT10H text mode, and it
+stays in whatever mode was set, unless KMS is used to change the mode. It
+should be noted that the coreboot framebuffer is not a VGA mode, but instead
+coreboot implements minimal drivers for hardware that it supports, providing
+a framebuffer directly in memory, which software (such as GRUB) can simply
+use.
+
+The BSD bootloaders on x86, in BIOS systems, typically expect text mode
+startup. It is usually possible to set the console to higher VGA modes,
+on most systems, but not on most coreboot systems with native video
+initialisation used, due to the quirks already described. If you see any
+documentation (in BSD land) pertaining to VESA modes, ignore it entirely;
+unless you're using the proprietary VGA ROM for your device, it won't work,
+and libreboot/libreboot don't distribute these (instead, coreboot's own video
+initialisation is used where possible, or a headless SeaBIOS payload setup
+is provided, where you would either run it headless or install a graphics
+card).
 
-For BSD systems, it is desirable that you boot in *text mode*. ROM images
-with `txtmode` in the file name, on x86 systems, boot up with int10h text mode
-in use. This is the most "compatible" option, and BSD operating systems have
-excellent support for text-mode startup. Many of them also support *kernel mode
-setting* (KMS) nowadays, which you *need* if you want a graphical desktop on
-the X window system. The reason is that Libreboot does not currently implement
-int10h VGA modes on x86 systems. However, basic video initialization is
-provided on all platforms (int10h text mode, or coreboot framebuffer).
+Now, this would otherwise mean: no X11/Wayland. If you start in corebootfb
+mode with SeaVGABIOS, you won't get a display in BSD bootloaders, and if you
+boot in text mode, you can't set VESA modes from BSD. However, you're in luck:
 
-Combined with the use of SeaBIOS payload, BSD systems (and any other OS that
-can boot in text mode) will *just work*. If your BSD system supports kernel
-mode setting, it can set up a framebuffer without making use of int10h VGA
-modes. In this case, the driver (e.g. Intel video driver) will set modes
-directly, and implement its own framebuffer.
+At least OpenBSD and FreeBSD (possibly others) all have excellent KMS
+support nowadays; short for `Kernel Mode Setting`. This avoids the inefficiency
+of BIOS/UEFI methods, by having the kernel set modes directly. It is based on
+KMS drivers that the BSD projects ported over from the Linux kernel. With this,
+you can use X11/Wayland in FreeBSD (and just X11 in OpenBSD, for now).
 
-Booting with a coreboot framebuffer will also work well on most BSD systems.
-These ROM images have `corebootfb` in the filename, on recent Libreboot releases.
-In this setup, you should make sure that your BSD system has a `corebootfb`
-driver (to make use of the coreboot framebuffer), but when switching to X, your
-video driver (e.g. Intel video driver) may already support kernel mode setting
-which means that the coreboot framebuffer will no longer be used at that point.
+For example: on FreeBSD, you can install `graphics/drm-kmod` as a package
+or from ports, and (for Intel GPUs) do this:
 
-Booting BSD
-===========
+	sysrc kld_list+="i915kms"
 
-On x86 platforms, Libreboot currently provides the choice of GNU GRUB and/or
-SeaBIOS payload. You can use *either* payload, to boot BSD operating systems.
+This creates the following entry in `/etc/rc.conf`:
 
-SeaBIOS payload
----------------
+	kld_list="i915kms"
 
-It is highly recommended that you use the SeaBIOS payload. ROM images are
-available in the latest Libreboot release, which start with the SeaBIOS payload.
+On FreeBSD it is also recommended that you switch to KMS on the console/TTY;
+add this to `/boot/loader.conf` so that you can still use the console after
+terminating Xorg:
 
-The ROM images with GNU GRUB *also* have SeaBIOS available in the boot menu.
-GNU GRUB, when compiled as a coreboot payload, runs on *bare metal* and it can
-boot any other coreboot payload if you use the `chainloader` command.
+	kern.vty=vt
 
-The way to use SeaBIOS is fairly self-explanatory. SeaBIOS functions the way
-you would expect on a typical computer. Libreboot currently lacks any sort of
-documentation for SeaBIOS, but you can refer to their
-website: <https://seabios.org/SeaBIOS>
+You should not rely on the above instruction (for FreeBSD), because the exact
+step might change, and it does not go into full detail either. Refer to the
+documentation provided by your system, to know how KMS is configured.
+
+ALWAYS READ THE MANUAL
+----------------------
+
+All of the BSDs have *excellent* documentation; it's one of the defining
+characteristics, versus typical Linux distros.
 
-SeaBIOS is *especially* recommended if you're doing an encrypted installation.
+Aside from this quirk in coreboot, regarding *BIOS* video modes, the BSDs
+otherwise work in exactly the same way as you would expect, and you can
+follow along to their official documentation without much fuss.
+
+No specific or detailed guides will be provided here, because SeaBIOS is
+fairly self-explanatory; you can otherwise refer to the SeaBIOS
+documentation.
 
-The benefit to using SeaBIOS is that it's basically more reliable. For example,
-ZFS support is less reliable in GRUB, but a FreeBSD system booted in SeaBIOS
-would work just fine because you'd be using FreeBSD's own bootloader in that
-instance.
+If you're flashing a ROM for a machine where `seabios_withgrub`
+and `seabios_grubfirst` ROMs are available, choose `seabios_withgrub`.
+
+DO NOT USE ROM IMAGES WITH `seabios_grubfirst` IN THE FILE NAME! These were
+present in older Libreboot releases, and supported in previous revisions
+of the build system, but they did not work for the intended purpose. More
+info is written on the [Libreboot installation guide](../install/). ROM
+images with `seabios_grubfirst` in the filename will NOT be included in
+future Libreboot releases.
 
-GNU GRUB payload
-----------------
+Dubious mention: Tianocore
+--------------------------
 
-GRUB can directly boot many BSD kernels, but support for this is quite unreliable
-compared to its support for booting Linux kernels. However, you *can* use GRUB.
+Tianocore is extremely bloated, and unauditable, so it is not included
+in libreboot or libreboot, but it is the reference UEFI implementation by
+Intel and contributors. It can boot most BSD systems very well.
 
-When you use GNU GRUB directly, in this way, the various BSD bootloaders are
-bypassed entirely.
+More robust ways to provide UEFI services in Libreboot are to be investigated.
+Tianocore integration will not be provided officially, in any current or future
+releases of Libreboot.
 
-We have separate pages for each BSD system:
+Desktop users
+-------------
 
-* [How to install NetBSD on x86 GNU GRUB payload](netbsd.md)
-* [How to install OpenBSD on x86 GNU GRUB payload](openbsd.md)
-* [How to install FreeBSD on a x86 GNU GRUB payload](freebsd.md)
+Desktop users on libreboot/libreboot should just install a graphics card,
+and again boot with SeaBIOS in text mode; however, when you do this,
+SeaBIOS will execute the VGA option ROM on the card which will provide
+early video initialisation instead of coreboot's initialisation, and that
+VGA ROM will usually implement full INT10H modes, including the ability
+to set modes in the BIOS (using interrupts), in which case you don't
+need to worry about Kernel Mode Setting, but you should still use KMS
+anyway.
+
+The reason to use KMS is because it's more efficient. The INT10H service can
+only be called in Real Mode or Virtual 8086 mode; v8086 is unavailable in
+long mode (x86\_64) and switching into Real Mode just to set VGA modes is
+extremely expensive computationally speaking. This is why modern kernels
+(Linux and BSD one) do mode setting themselves.
+
+You can learn more about INT10H text/VGA modes here:
+
+<https://en.wikipedia.org/wiki/INT_10H>

site/docs/bsd/netbsd.md

@@ -1,148 +0,0 @@
----
-title: How to install NetBSD on x86 GNU GRUB payload
-x-toc-enable: true
-...
-
-GRUB supports booting NetBSD kernels directly. However, you're better off
-simply using the SeaBIOS payload; BSD works well with BIOS or UEFI setups.
-
-GRUB is acceptable for booting unencrypted BSD installations. However,
-encrypted BSD installations will probably require the use of SeaBIOS/Tianocore.
-
-Prepare the USB drive (in NetBSD)
----------------------------------
-
-[This
-page](https://wiki.netbsd.org/tutorials/how_to_install_netbsd_from_an_usb_memory_stick/)
-on the NetBSD website shows how to create a NetBSD bootable USB drive
-from within NetBSD itself. You should use the *dd* method documented
-there.
-
-Prepare the USB drive (in FreeBSD)
-----------------------------------
-
-[This page](https://www.freebsd.org/doc/handbook/bsdinstall-pre.html) on
-the FreeBSD website shows how to create a bootable USB drive for
-installing FreeBSD. Use the *dd* on that page. You can also use the same
-instructions with a NetBSD ISO image.
-
-Prepare the USB drive (in OpenBSD or NetBSD)
------------------------------------------------
-
-If you downloaded your ISO on a OpenBSD or NetBSD system, here is how
-to create the bootable NetBSD USB drive:
-
-Connect the USB drive. Check dmesg:
-
-    dmesg | tail
-
-Check to confirm which drive it is, for example, if you think its sd3:
-
-    disklabel sd3
-
-Check that it wasn't automatically mounted. If it was, unmount it. For
-example:
-
-    doas umount /dev/sd3i
-
-dmesg told you what device it is. Overwrite the drive, writing the
-NetBSD installer to it with dd. For example:
-
-    doas netbsd.iso of=/dev/rsdXc bs=1M; sync
-
-You should now be able to boot the installer from your USB drive.
-Continue reading, for information about how to do that.
-
-Prepare the USB drive (in GNU+Linux)
-------------------------------------
-
-If you downloaded your ISO on a GNU+Linux system, here is how to create
-the bootable NetBSD USB drive:
-
-Connect the USB drive. Check dmesg:
-
-    dmesg
-
-Check lsblk to confirm which drive it is:
-
-    lsblk
-
-Check that it wasn't automatically mounted. If it was, unmount it. For
-example:
-
-    sudo umount /dev/sdX\*
-    umount /dev/sdX\*
-
-dmesg told you what device it is. Overwrite the drive, writing your
-distro ISO to it with dd. For example:
-
-    sudo dd if=install60.fs of=/dev/sdX bs=8M; sync
-    dd if=netbsd.iso of=/dev/sdX bs=8M; sync
-
-You should now be able to boot the installer from your USB drive.
-Continue reading, for information about how to do that.
-
-Installing NetBSD without full disk encryption
-----------------------------------------------
-
-You might have to use an external USB keyboard during the installation.
-Press C to access the GRUB terminal.
-
-    grub> knetbsd -r sd0a (usb0,netbsd1)/netbsd
-    grub> boot
-
-It will start booting into the NetBSD installer. Follow the normal
-process for installing NetBSD.
-
-Installing NetBSD with full disk encryption
--------------------------------------------
-
-TODO
-
-Booting
--------
-
-Press C in GRUB to access the command line:
-
-    grub> knetbsd -r wd0a (ahci0,netbsd1)/netbsd
-    grub> boot
-
-NetBSD will start booting. Yay!
-
-Configuring Grub
-----------------
-
-If you don't want to drop to the GRUB command line and type in a
-command to boot NetBSD every time, you can create a GRUB configuration
-that's aware of your NetBSD installation and that will automatically be
-used by libreboot.
-
-On your NetBSD root partition, create the `/grub` directory and add
-the file `libreboot_grub.cfg` to it. Inside the
-`libreboot_grub.cfg` add these lines:
-
-    default=0
-    timeout=3
-
-    menuentry "NetBSD" {
-        knetbsd -r wd0a (ahci0,netbsd1)/netbsd
-    }
-
-The next time you boot, you'll see the old Grub menu for a few seconds,
-then you'll see the a new menu with only NetBSD on the list. After 3
-seconds NetBSD will boot, or you can hit enter to boot.
-
-Troubleshooting
-===============
-
-Most of these issues occur when using Libreboot with coreboot's 'text
-mode' instead of the coreboot framebuffer. This mode is useful for
-booting payloads like memtest86+ which expect text-mode, but for NetBSD
-it can be problematic when they are trying to switch to a framebuffer
-because it doesn't exist.
-
-won't boot...something about file not found
----------------------------------------------
-
-Your device names (i.e. usb0, usb1, sd0, sd1, wd0, ahci0, hd0, etc) and
-numbers may differ. Use TAB completion.

site/docs/bsd/openbsd.md

@@ -1,163 +0,0 @@
----
-title: How to install OpenBSD on x86 GNU GRUB payload
-x-toc-enable: true
-...
-
-This guide is written for OpenBSD 6.1, but it can be adapted easily for other
-versions (of OpenBSD).
-
-If you want an encrypted install, use SeaBIOS instead of GRUB and go here:
-<https://www.openbsd.org/faq/faq4.html> (official installation guide, which
-says how to use encryption)
-
-GRUB supports booting OpenBSD kernels directly. However, you're better off
-simply using the SeaBIOS payload; BSD works well with BIOS or UEFI setups.
-
-GRUB is acceptable for booting unencrypted BSD installations. However,
-encrypted BSD installations will probably require the use of SeaBIOS/Tianocore.
-
-install61.fs is the installation image for OpenBSD 6.1. Adapt the
-filename accordingly, for a different OpenBSD version or LibertyBSD.
-
-Prepare the USB drive (in LibertyBSD or OpenBSD)
-------------------------------------------------
-
-If you downloaded your ISO on a LibertyBSD or OpenBSD system, here is
-how to create the bootable LibertyBSD/OpenBSD USB drive:
-
-Connect the USB drive and check the system message buffer:
-
-    dmesg | tail
-
-Check to confirm which drive it is, for example, if you think it's `sd3`:
-
-    disklabel sd3
-
-Check that it wasn't automatically mounted. If it was, unmount it:
-
-    doas umount /dev/sd3i
-
-Now write the OpenBSD installer to the drive with `dd`:
-
-    doas dd if=install60.fs of=/dev/rsdXc bs=1M; sync
-
-You should now be able to boot the installer from your USB drive.
-Continue reading, for information about how to do that.
-
-Prepare the USB drive (in NetBSD)
----------------------------------
-
-[This
-page](https://wiki.netbsd.org/tutorials/how_to_install_netbsd_from_an_usb_memory_stick/)
-on the NetBSD website shows how to create a NetBSD bootable USB drive
-from within NetBSD itself. You should use the `dd` method documented
-there. This will also work with the OpenBSD image.
-
-Prepare the USB drive (in FreeBSD)
-----------------------------------
-
-[This page](https://www.freebsd.org/doc/handbook/bsdinstall-pre.md) on
-the FreeBSD website shows how to create a bootable USB drive for
-installing FreeBSD. Use the `dd` on that page. You can also use the same
-instructions with a OpenBSD ISO image.
-
-Prepare the USB drive (in GNU+Linux)
-------------------------------------
-
-If you downloaded your ISO on a GNU+Linux system, here is how to create
-the bootable OpenBSD USB drive:
-
-Connect the USB drive. Check dmesg:
-
-    dmesg
-
-Check lsblk to confirm which drive it is:
-
-    lsblk
-
-Check that it wasn't automatically mounted. If it was, unmount it. For
-example:
-
-    sudo umount /dev/sdX\*
-    umount /dev/sdX\*
-
-dmesg told you what device it is. Overwrite the drive, writing your
-distro ISO to it with dd. For example:
-
-    sudo dd if=install61.fs of=/dev/sdX bs=8M; sync
-    dd if=install61.fs of=/dev/sdX bs=8M; sync
-
-You should now be able to boot the installer from your USB drive.
-Continue reading, for information about how to do that.
-
-Installing OpenBSD without full disk encryption
------------------------------------------------
-
-Press C in GRUB to access the command line:
-
-    grub> kopenbsd (usb0,openbsd1)/6.1/amd64/bsd.rd
-    grub> boot
-
-It will start booting into the OpenBSD installer. Follow the normal
-process for installing OpenBSD.
-
-Installing OpenBSD with full disk encryption
---------------------------------------------
-
-If you are using SeaBIOS, OpenBSD's bootloader will be
-chainloaded automatically and everything will just work.
-
-Alternatively, it would be good to port OpenBSD either natively as a
-coreboot payload, or port it to libpayload (payload library in coreboot;
-it has a basic C library and a few functions for certain operations e.g.
-text/bitmap).
-
-Booting
--------
-
-Press C in GRUB to access the command line:
-
-    grub> kopenbsd -r sd0a (ahci0,openbsd1)/bsd
-    grub> boot
-
-OpenBSD will start booting. Yay!
-
-Configuring Grub
-----------------
-
-If you don't want to drop to the GRUB command line and type in a
-command to boot OpenBSD every time, you can create a GRUB configuration
-that's aware of your OpenBSD installation and that will automatically
-be used by Libreboot.
-
-On your OpenBSD root partition, create the `/grub` directory and add the file
-`libreboot_grub.cfg` to it. Inside the `libreboot_grub.cfg` add these lines:
-
-    default=0
-    timeout=3
-
-    menuentry "OpenBSD" {
-        kopenbsd -r sd0a (ahci0,openbsd1)/bsd
-    }
-
-If your OpenBSD installation uses a GPT scheme, use the `gpt4` partition
-instead of `openbsd1`.
-
-The next time you boot, you'll see the old Grub menu for a few seconds,
-then you'll see the a new menu with only OpenBSD on the list. After 3
-seconds OpenBSD will boot, or you can hit enter to boot.
-
-Troubleshooting
-===============
-
-Most of these issues occur when using Libreboot with coreboot's 'text
-mode' instead of the coreboot framebuffer. This mode is useful for
-booting payloads like memtest86+ which expect text-mode, but for OpenBSD
-it can be problematic when they are trying to switch to a framebuffer
-because it doesn't exist.
-
-Won't boot...something about file not found
----------------------------------------------
-
-Your device names (i.e. usb0, usb1, sd0, sd1, wd0, ahci0, hd0, etc) and
-numbers may differ. Use TAB completion.