TODO: translate this section into ukrainian language
WARNING: When you build a ROM image from the Canoeboot build system, please ensure that you flash the appropriate ROM image from bin/
, NOT elf/
. The elf/
coreboot ROMs do not contain payloads. Canoeboot’s build system builds no-payload ROMs under elf/
, and payloads separately under elf/
. Then it copies from elf/
and inserts payloads from elf/
, and puts the final ROM images (containing payloads) in bin/
. This design is more efficient, and permits many configurations without needless duplication of work. More info is available in the cbmk maintenance manual
Canoeboot’s build system defaults to a single build thread, but you can change it by doing e.g.
export XBMK_THREADS=4
This would make cbmk run on 4 threads.
More specifically: when compiling source trees via script/trees
, -jTHREADS
is passed, where THREADS is the number of threads. This is also set when running xz commands for compression, using the -t
option.
Please read about environmental variables in the build instructions, before running cbmk. You should set your variables accordingly, though you do not technically need to; some of them may be useful, e.g. XBMK_THREADS
(sets the number of build threads).
Система побудови canoeboot, називається cbmk
, скорочення від CanoeBoot MaKe
, і цей документ описує те, як використовувати її. З цим керівництвом ви можете узнати те, як побудувати canoeboot з доступного джерельного коду. Ця версія, якщо розміщена наживо на canoeboot.org, передбачає, що ви використовуєте сховище git cbmk
, яке ви можете завантажити, використовуючи інструкції на сторінці огляду коду.
Якщо ви використовуєте архів випуску canoeboot, будь ласка, зверніться до документації, включеної до того випуску. Випуски canoeboot розраховані тільки, як знімки, не для розробки. Для належної розробки ви маєте завжди працювати безпосередньо в сховищі git canoeboot.
Наступний документ описує те, як працює cbmk
, і як ви можете робити зміни до нього: керівництво обслуговування canoeboot
Система побудови Canoeboot використовує Git, обширно. Ви маєте виконати кроки знизу, навіть, якщо ви використовуєте архів випуску.
Перед тим, як вам використовувати систему побудови, будь ласка, знайте: система побудови, сама по собі, використовує Git обширно, коли завантажує програмне забезпечення, таке як coreboot, та проводить застосування виправлень.
Ви маєте переконатись в тому, щоб ініціалізувати ваш Git належним чином, перед тим, як почати, або інакше система побудови не буде працювати належно. Зробіть це:
git config --global user.name "John Doe"
git config --global user.email johndoe@example.com
Змініть ім’я та адресу електронної пошти на будь-яку, що забажаєте, коли робите це.
Ви також можете захотіти прослідувати більшій кількості етапів тут: https://git-scm.com/book/en/v2/Getting-Started-First-Time-Git-Setup
Python2 не використовується cbmk або будь-чим, що завантажується в якості модулів. Ви маєте переконатись, що команда python
виконує python 3 на вашій системі.
Make sure date/hwclock report the correct time and date on your system, because parts of the build process download from HTTPS servers and wrong time or date can cause connections to be dropped during negotiation.
Фактична розробка/тестування завжди виконується безпосередньо за допомогою cbmk
, і це також стосується збирання з джерельного коду. Ось кілька інструкцій, щоб почати:
canoeboot включає сценарій, який автоматично встановлює apt-get залежності в Ubuntu 20.04:
sudo ./build dependencies ubuntu2004
Окремі сценарії також існують:
sudo ./build dependencies debian
sudo ./build dependencies arch
sudo ./build dependencies void
Check: config/dependencies/
for list of supported distros.
Технічно, будь-який дистрибутив Linux може бути використано для побудови canoeboot. Однак, вам потрібно буде написано свій власний сценарій для встановлення залежностей побудови.
Canoeboot Make (cbmk) автоматично виконує всі необхідні команди; наприклад, ./build roms
автоматично виконає ./build grub
, якщо затребувані утиліти для GRUB не збудовано, для виготовлення корисних навантажень.
В якості результату, ви тепер можете (після встановлення правильних залежностей побудови) виконати лише одну команду, з свіжого Git clone, для побудови образів ROM:
./build roms all
або навіть побудувати конкретні образи ROM, такі як:
./build roms x60
or get a list of supported build targets:
./build roms list
Якщо ви бажаєте побудувати корисні навантаження, можете зробити це. Наприклад:
./build grub
./update trees -b seabios
./update trees -b u-boot
Попередні кроки буде виконано автоматично. Однак, ви можете досі виконати окремі частини системи побудови власноруч, якщо виберете. Це може бути вигідно, коли ви робите зміни, та бажаєте протестувати конкретну частину cbmk.
Markdown: https://canoeboot.org/docs/build/index.uk.md
Ця сторінка була створена з Untitled Static Site Generator.