Buildroot — osa 2. Omakonfiguraatori loomine oma plaadi jaoks; external tree, rootfs-overlay, post-build skriptide rakendamine

Selles osas käsitlen mõningaid kohandamisvõimalusi, mida mul oli vaja. See ei ole täielik nimekiri sellest, mida buildroot pakub, kuid need on täiesti toimivad ja ei nõua sekkumist buildrooti failidesse.

EXTERNAL-mehhanismi kasutamine kohandamiseks

Eelnevas artiklis Käsitleti lihtsat näidet oma konfiguratsiooni lisamisest, lisades laua defconfig'i ja vajalikud failid otse Buildrooti kataloogi.

Kuid see meetod ei ole eriti mugav, eriti buildrooti värskendamisel. Selle probleemi lahendamiseks on mehhanism external tree. Selle olemus on see, et eraldi kataloogis saab hoida katalooge board, configs, packages ja muid (näiteks kasutan katalooge patches pakettide patch'ide rakendamiseks, rohkem teavet eraldi osas) ja buildroot lisab need automaatselt oma kataloogis olemasolevatele.

Märkuseks: saate rakendada mitu external tree korraga, sellest on näide buildrooti juhendis.

Loome katalooge my_tree, mis asub buildroot'i kõrval ja viime sinna meie konfiguratsiooni. Väljunds peaks olema järgmine failistruktuur:

[alexey@alexey-pc my_tree]$ tree
.
├── board
│   └── my_x86_board
│       ├── bef_cr_fs_img.sh
│       ├── linux.config
│       ├── rootfs_overlay
│       └── users.txt
├── Config.in
├── configs
│   └── my_x86_board_defconfig
├── external.desc
├── external.mk
├── package
└── patches

6 katalooge, 7 faili

Kuidas näha, peegeldab struktuur üldiselt buildroot'i struktuuri.

Kataloog board koosneb iga plaadi jaoks spetsiifilistest failidest, meie juhul:

• bef_cr_fs_img.sh — skript, mis käivitatakse pärast sihtfailisüsteemi kogumist, kuid enne selle pildiks pakkimist. Kasutame seda hiljem
• linux.config — tuuma konfiguratsioon
• rootfs_overlay — kataloog sihtfailisüsteemi pealelõikamiseks
• users.txt — fail loodud kasutajate kirjelduseks

Kataloog configs sisaldab meie plaatide defconfig'e. Meil on seda ainult üks.

Paketid — kataloog meie pakettide jaoks. Esialgu sisaldab buildroot piiratud arvu pakettide kirjeldusi ja kogumise reegleid. Hiljem lisame siia aknahalduri icewm ja süsteemi graafilise sisselogimise halduri Slim.
Patches — võimaldab mugavalt hoida oma patše erinevate pakettide jaoks. Lisainfot leiate eraldi jaotises.
Nüüd tuleb lisada meie external-tree kirjeldusfailid. Selle eest vastutavad 3 faili: external.desc, Config.in, external.mk.

external.desc sisaldab tegelikku kirjeldust:

[alexey@alexey-pc my_tree]$ cat external.desc 
name: my_tree
desc: Minu lihtne external-tree artikli jaoks

Esimene rida on nimi. Edasi koostab buildroot muutuja $(BR2_EXTERNAL_MY_TREE_PATH), mida tuleb kasutada ehituse konfigureerimisel. Näiteks kasutajate faili tee saab määrata järgmiselt:

$(BR2_EXTERNAL_my_tree_PATH)/board/my_x86_board/users.txt

Teine rida on lühike, inimesele arusaadav kirjeldus.

Config.in, external.mk — failid lisatavate pakettide kirjeldamiseks. Kui oma pakette ei lisata, võivad need failid jääda tühjaks. Praegu teeme just nii.
Nüüd on meie external-tree valmis, sisaldades defconfig meie plaadi jaoks ja vajalikke faile. Liigume buildroot katalooge, märkides, et kasutame external-tree:

[alexey@alexey-pc buildroot]$ make BR2_EXTERNAL=../my_tree/ my_x86_board_defconfig
#
# konfiguratsioon kirjutatud faili /home/alexey/dev/article/ramdisk/buildroot/.config
#
[alexey@alexey-pc buildroot]$ make menuconfig

Esimeses käskluses kasutame argumenti BR2_EXTERNAL=../my_tree/, mis näitab external tree. Samuti saab samal ajal määrata mitu external-tree, piisab, kui teha seda ühe korra, pärast mida luuakse fail output/.br-external.mk, mis salvestab teabe kasutatava external-tree kohta:

[alexey@alexey-pc buildroot]$ cat output/.br-external.mk 
#
# Automaatne genereeritud fail; ÄRGE MUUTKE.
#

BR2_EXTERNAL ?= /home/alexey/dev/article/ramdisk/my_small_linux/my_tree
BR2_EXTERNAL_NAMES = 
BR2_EXTERNAL_DIRS = 
BR2_EXTERNAL_MKS = 

BR2_EXTERNAL_NAMES += my_tree
BR2_EXTERNAL_DIRS += /home/alexey/dev/article/ramdisk/my_small_linux/my_tree
BR2_EXTERNAL_MKS += /home/alexey/dev/article/ramdisk/my_small_linux/my_tree/external.mk
export BR2_EXTERNAL_my_tree_PATH = /home/alexey/dev/article/ramdisk/my_small_linux/my_tree
export BR2_EXTERNAL_my_tree_DESC = Minu lihtne external-tree artikli jaoks

Oluline! Selles failis on teed absoluutsetes vormides!

Menüüsse on lisatud punkt External options:

Selles alammenüüs on meie paketid meie external-tree'ist. Praegu on see osa tühi.

Praegu on meil tähtis ümber kirjutada vajalikud teed, et kasutada external-tree.

Pange tähele, et jaotises Build options → Location to save buildroot config, on absoluutne tee salvestatava defconfig'i juurde. See formuleeritakse, kui määratakse external_tree'i kasutamine.

Samuti muudame jaotises System configuration teed. Loendiga, mille loovad kasutajad:

$(BR2_EXTERNAL_my_tree_PATH)/board/my_x86_board/users.txt

Jaotises Kernel muudame teed kernel'i konfiguratsioonile:

$(BR2_EXTERNAL_my_tree_PATH)/board/my_x86_board/linux.config

Nüüd kasutatakse koostamisel meie faile extern-tree'ist. Teise katalooge liigutamisel või buildroot'i uuendamisel on meil vähemalt vähe probleeme.

Root fs overlay'i lisamine:

See mehhanism võimaldab hõlpsasti lisada/väärata faile siht-süsteemis.
Kui fail on root fs overlay'is, kuid puudub sihtsüsteemis, siis lisatakse see.
Kui fail on nii root fs overlay'is kui ka sihtsüsteemis, siis vahetatakse see välja.
Esmalt määrame tee root fs overlay katalooge. Seda tehakse jaotises Süsteemi konfiguratsioon → Root failisüsteemi overlay kataloogid:

$(BR2_EXTERNAL_my_tree_PATH)/board/my_x86_board/rootfs_overlay/

Nüüd loome kaks faili.

[alexey@alexey-pc my_small_linux]$ cat my_tree/board/my_x86_board/rootfs_overlay/etc/hosts 
127.0.0.1   localhost
127.0.1.1   my_small_linux
8.8.8.8     google-public-dns-a.google.com.
[alexey@alexey-pc my_small_linux]$ cat my_tree/board/my_x86_board/rootfs_overlay/new_file.txt 
This is new file from overlay

Esimene fail (my_tree/board/my_x86_board/rootfs_overlay/etc/hosts) asendab faili /etc/hosts valmistanud süsteemis. Teine fail (cat my_tree/board/my_x86_board/rootfs_overlay/new_file.txt) lisatakse.

Kogume ja kontrollime:

Kohandamisskriptide täitmine süsteemi koostamise erinevates etappides

Sageli on vajalik teatud toimingute tegemine siht-süsteemis enne selle pakendamist piltideks.

Selle saab teha süsteemi konfiguratsiooni jaotises:

Esimesed kaks skripti käivitatakse pärast siht-failisüsteemi koostamist, kuid enne selle pildiks pakkimist. Erinevus seisneb selles, et fakeroot-skript käivitatakse fakeroot kontekstis, st simuleeritakse root-kasutaja töö.

Viimane skript käivitatakse juba pärast süsteemi piltide loomist. Selles saab teha täiendavaid toiminguid, näiteks kopeerida vajalikke faile nfs-serverisse või luua oma seadme sisufaili pilt.

Näiteks loon skripti, mis kirjutab versiooni ja koostamise kuupäeva /etc/.
Esmalt määran selle faili tee oma external-tree-s:

Ja nüüd põhi skript:

[alexey@alexey-pc buildroot]$ cat ../my_tree/board/my_x86_board/bef_cr_fs_img.sh 
#!/bin/sh
echo "my small linux 1.0 pre alpha" > output/target/etc/mysmalllinux-release
date >> output/target/etc/mysmalllinux-release

Pärast koostamist saab seda faili süsteemis näha.

Tegelikult võib skript suureks minna. Seetõttu läksin reaalses projektis rohkem arenenud teed:

1. Loomiseks kaust (my_tree/board_my_x86_board/inside_fakeroot_scripts), milles on täidetavad skriptid, numbritega. Näiteks, 0001-add-my_small_linux-version.sh, 0002-clear-apache-root-dir.sh
2. Kirjutasin skripti (my_tree/board_my_x86_board/run_inside_fakeroot.sh), mis läbib selle katalooge ja järjestikused skriptid, mis seal asuvad, täidab.
3. Määrasin selle skripti põhikuval seadetes jaotises Süsteemi konfiguratsioon -> Kohandatud skriptid, mis käivitatakse fakeroot keskkonnas ($(BR2_EXTERNAL_my_tree_PATH)/board/my_x86_board/run_inside_fakeroot.sh).

Allikas: habr.com