Buildroot — del 2. Skapa konfiguration för din bräda; användning av external tree, rootfs-overlay, post-build-skript

Selles jaotisest uurin mõningaid kohandamise võimalusi, mis mulle vajalikud olid. See ei ole täielik nimekiri sellest, mida buildroot pakub, kuid need on täiesti toimivad ja ei nõua sekkumist buildrooti failidesse.

Kohandamise EXTERNAL-mehhanismi kasutamine

Eelmisel artiklil uuriti lihtsat näidet oma konfiguratsiooni lisamisest, lisades plaadi defconfig'i ja vajalikud failid otse Buildrooti katalooge.

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 muud (näiteks kasutan katalooge patches pakettide patchide rakendamiseks, lähemalt eraldi jaotises) ning buildroot lisab need automaatselt oma kataloogile.

Märkus: saab rakendada mitu external tree'i korraga, näide on buildrooti juhendis

Loome katalooge my_tree, mis asub buildroot'i katalooge kõrval, ja viime sinna oma konfiguratsiooni. Väljundina peaksime saama järgmise failistruktuuri:

[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

Nagu näha, kordab struktuur üldiselt buildrooti struktuuri.

Kataloog board sisaldab meie vahetallistele spetsiifilisi faile:

• bef_cr_fs_img.sh — skript, mis käivitatakse pärast sihtfaili süsteemi kogumist, kuid enne selle pakkimist piltideks. Hiljem kasutame seda
• linux.config — tuumakonfiguratsioon
• rootfs_overlay — kataloog, et katta sihtfaili süsteemi
• users.txt — fail loodavate kasutajate kirjeldamiseks

Kataloog configs sisaldab meie vahetalliste defconfig'e. Meil on neid vaid üks.

Package — kataloog meie pakettide jaoks. Alguses sisaldab buildroot piiratud arvu pakettide kirjeldusi ja kogumise reegleid. Hiljem lisame siia aknahalduri icewm ja sisse logimise halduri Slim.
Patches — võimaldab mugavalt hoida oma patše erinevate pakettide jaoks. Lähemalt eraldi jaotises hiljem.
Nüüd tuleb lisada meie external-tree'i 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 väline puu artikli jaoks

Esimene rida on nimi. Edasi loob buildroot muutuja $(BR2_EXTERNAL_MY_TREE_PATH), mida tuleb kasutada ehituse konfigureerimisel. Näiteks on kasutaja failile tee määramiseks võimalik kasutada järgmist teed:

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

Teine rida on lühike, inimesele arusaadav kirjeldus.

Config.in, external.mk — failid, mis kirjeldavad lisatud pakette. Kui oma pakette ei lisata, saab need failid jätta tühjaks. Hetkel teeme just nii.
Nüüd on meie väline puu valmis, sisaldades meie plaadi defconfig'i ja vajalikke faile. Siirdugem buildroot katalooge ja määratlegem väline puu:

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

Esimeses käsus kasutame argumenti BR2_EXTERNAL=..\/my_tree\/, mis näitab välist puu kasutamist. Samal ajal saab määrata mitu välist puu kasutamiseks. Selleks piisab, kui teha seda üks kord, seejärel luuakse fail output\/.br-external.mk, mis salvestab teavet kasutatava välist puu kohta:

[alexey@alexey-pc buildroot]$ cat output\/.br-external.mk 
#
# Automaatne genereeritud fail; EI TOHI MUUTA.
#

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 väline puu artikli jaoks

Oluline! Sellel failil on teed absoluutsetena!

Menüüsse ilmus punkt External options:

Selles alammenüüs sisaldatakse meie pakette meie välist puust. Praegu on see osa tühi.

Praegu on olulisem kohandada vajalikke teid, et kasutada välist puud.

Pange tähele, et Build options → Location to save buildroot config nimetus näitab absoluutset teed salvestatud defconfig'ile. See luuakse, kui määratakse välist puu kasutamine.

Samuti muudame süsteemi konfiguratsiooni sektsioonis teed. Loendiga loodud kasutajate jaoks:

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

Kernel sektsioonis muudame kerneli konfigureerimise teed:

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

Nüüd kasutatakse ehitamisel meie faile meie välist puust. Teise katalooge viimise või buildroot'i uuendamise korral on meil minimaalne häda.

Root fs overlay'i lisamine:

See mehhanism võimaldab hõlpsalt lisada\/asendada faile sihtfailisüsteemis.
Kui fail on root fs overlay'is, kuid sihtkohas puudub, lisatakse see.
Kui fail on root fs overlay'is ja sihtkohas olemas, asendatakse see.
Esiteks määratleme tee root fs overlay kausta. Seda tehakse jaotises Süsteemi konfiguratsioon → Root filesystem overlay directories:

$(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 valmis 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 kogumise erinevatel etappidel

Sageli on vajalik teatud toimingute tegemine sihtfailide süsteemis enne selle pakkimist piltideks.

Seda saab teha jaotises Süsteemi konfiguratsioon:

Esimese kahe skripti täitmine toimub pärast sihtfailide süsteemi koostamist, kuid enne selle pakkimist piltideks. Erinevus on selles, et fakeroot-skript käib fakerooti kontekstis, simuleerides root-kasutaja tööd.

Viimane skript täidetakse pärast süsteemi piltide loomist. Sellega saab teha täiendavaid toiminguid, näiteks kopeerida vajalikud failid nfs-serverisse või luua oma seadme pildifail.

Näiteks loon skripti, mis kirjutab versiooni ja kogumise kuupäeva /etc/.
Esiteks määran selle faili tee oma external-tree'is:

Ja nüüd ise 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 kogumist saab selle faili süsteemist näha.

Praktikas võib skript muutuda mahukaks. Seetõttu läksin reaalses projektis edasi keerukamale lähenemisele:

1. Loomisin kausta (my_tree/board_my_x86_board/inside_fakeroot_scripts), kus on täitmiseks ettekirjutatud skriptid, järjestikuste 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 seda kausta ja täidab järjestikku seal olevaid skripte.
3. Märgin selle skripti plaadivaliku seadistustes jaotises Süsteemi konfiguratsioon → Kohandatud skriptid fakeroot keskkonnas täitmiseks ($(BR2_EXTERNAL_my_tree_PATH)/board/my_x86_board/run_inside_fakeroot.sh)

Allikas: habr.com