OpenWrt ビルドシステムに関するメモ

（👉 公式ドキュメント）

ビルドシステム
👉 基本
SSD/HDD の容量は 10~15GB 以上必要。
仕組みとして大きく分けると 3 段構成になっている：
  1. ホスト（実際に作業する PC）側用のツールチェイン
  2. ターゲット（OpenWrt をインストールするルーター）側用のツールチェイン
  3. パッケージ化したりファームウェアのイメージ化する
ツールチェインがホスト側・ターゲット側の 2 段構成になっている理由は、クロスコンパイルを可能にするため。まず、ホスト側ツールチェインを使って、ターゲット側 OpenWrt 用のツールチェインをビルドする。そうやって生み出されたターゲット側 OpenWrt 用のツールチェインを使って、実際に OpenWrt で使われるバイナリーイメージをビルドする（つまり、ホスト側のツールチェインは、単に、OpenWrt 用のツールチェインをビルドするためだけに使う。そして実際の OpenWrt の各パッケージは、ターゲット側 OpenWrt 用のツールチェインによってビルドしていく。このようにして一種の〝ビルド環境のエミュレーション〟のような仕組みとなっている）。
そうして、第 3 段階で、ビルド済みの各パッケージを .ipk の形にしたり、ファームウェアイメージにしたりして、ルーターにインストールするという流れ。
👉 セットアップ方法
GNU/Linux が標準の環境。基本は Git が使えるようにして、その他は、ツールチェインのビルドに必要な C コンパイラの環境を整えればよい。Debian / Ubuntu 系では apt を使って、build-essential clang flex bison g++ gawk gcc-multilib g++-multilib gettext git libncurses-dev libssl-dev python3-distutils rsync unzip zlib1g-dev file wget あたりを用意すればよい。
👉 セットアップ方法（macOS）
macOS は本来、非推奨。敢えて使いたいマニア向けの解説。
👉 セットアップ方法（WSL）
Windows は本来、非推奨。敢えて使いたいマニア向けの解説。
👉 使用法
基本で説明した流れを、実際に git と make コマンドによって行なう具体的な作業についての解説。
  1. git でレポジトリーをコピーし、ブランチまたはタグで特定のバージョンを選択
  2. フィードをアップデート（srcipts/feeds update -a）・インストール（srcipts/feeds install -a）して、パッケージリストの状態を最新の状態にする（必須ではないが、これをやらないと、パッケージリストの状態が最小限のものとなり、menuconfig 時に表示されるパッケージも限定される）
  3. make menuconfig でターゲット用のプロファイル（Target Profile、ビルドの対象とするルーター）を選択する
  4. make defconfig で、先に menuconfig で選んだターゲット用のデフォルトの設定状態（依存関係等）を反映する
  5. make (world)で、menuconfig で選んだターゲット用に、実際のビルドを行う（かなりの時間を要する処理）
  6. 作業ディレクトリの bin 以下に、ビルドされた結果のバイナリーが生成される
その他、make (world) する場合、マルチコア CPU を活用する場合は、-j オプションを使って
make -j $(($(nproc)+1)) download world
などとするとよい。nproc はコア数を返すコマンド、+1 のようにする理由は、コア数を上回るスレッド数とすることで、アイドル状態のコアが出現しないようにするため。シングルスレッドの場合はソースコードを都度ダウンロードするが、マルチスレッドだとスレッドごとに進行がまちまちになるためエラーの元となるので、download によってビルドに先立って全ての依存関係を先にダウンロードするために必須となる。download に続いて実際の make を行うため、world は省略できずに明示する。
また、ビルド途中でエラーが発生する場合には、V=s オプションで詳細なログを表示させると役に立つ。
👉 フィード
（割愛）
👉 技術リファレンス
（割愛）
👉 単体パッケージのビルド
ファームウェア全体を更新してルーターにファームウェアを丸ごと書き直すのではなく、単体のパッケージのみを更新したい場合のやり方。
  1. menuconfig 時に、ターゲットプロファイルを選んだ上で、目的とするパッケージと、それが依存するパッケージ群のみを選択する。依存関係がわからない場合は、ルーター上で opkg info <パッケージ名> をして情報表示させればよい。
  2. tool（make tools/install）と toolchain（make toolchain/install）のみを用意する。
  3. 依存するパッケージ群を先にコンパイルする：
    make package/<依存パッケージ名>/compile
    （ちなみにホスト用の被依存ツールをコンパイルする場合のパスは make package/<依存パッケージ名>/host/compile となる）
  4. 目的のパッケージをコンパイルする：
    make package/<パッケージ名>/compile
  5. パッケージ情報に反映させる（make package/index）
作業ディレクトリの bin 以下に、目的とするパッケージが生成される。
その他、カーネル・モジュールの単体ビルドのやり方についても説明されている（割愛）
👉 OpenWrt 上での OpenWrt のビルド
あくまで実験的なもので、技術的にはそれほど困難ではなく、ハードウェアの性能的に実用性が低い。デフォルト状態の OpenWrt OS に、何を足せばできるようになるのかが解説してある。敢えてやりたいマニア向け情報。
👉 クロスコンパイル
OpenWrt のパッケージに含まれていないプログラムをソースからクロスコンパイルする方法。基本は「使用法」の流れに沿う。
  1. OpenWrt 用のツールチェイン（staging_dir/toolchain-<アーキテクチャー名>_gcc-<gcc バージョン>_musl 以下）の bin ディレクトリーにある C コンパイラー（gcc）を見つけて、その bin ディレクトリーをホスト PC 側の PATH に追加してセット（export）する
  2. STAGING_DIR にはツールチェイン全体のディレクトリをセット（export）する
  3. コンパイルしたいプログラムのソースコードをダウンロード・解凍して、そのディレクトリーに移動する。
  4. PATH をセットした gcc を使ってそのプログラムをコンパイルするが、コンパイル（make）に先立って configure する際に --build=<アーキテクチャー名>-unknown-linux-gnu --host=<アーキテクチャー名>-openwrt-linux-musl をオプションとして使う。
    • --build= オプションを確認するためには config.guess コマンドを使う
    • クロスコンパイル設定が有効化どうかは configure のメッセージ中の 'checking whether we are cross compiling... yes' で確認できる
  5. 通常、GNU configure を使う場合には問題（必要）ないが、必要であれば、コンパイル（make）時に、CC と LD を環境変数として渡す：
    make CC=<アーキテクチャー名>-openwrt-linux-musl-gcc LD=<アーキテクチャー名>-openwrt-linux-musl-ld
  6. コンパイルされて出来あがったプログラムはソースを解凍した作業ディレクトリーのどこかにある。find -iname <プログラム名> を使うなどする。
  7. 実際のそのプログラムファイルを実行してみて、ちゃんとクロスコンパイルできているか確かめる。
  8. コンパイルがヘッダーまたは共有オブジェクトが見つからないためにエラーとなった場合には、CFLAGS や LDFLAGS 変数を上書きする必要があるかもしれない。staging_dir/target-<アーキテクチャー名>_musl 以下の usr/include と usr/lib を make 時に指定する。
  9. その他、デバッグする場合（割愛）
無事にコンパイルできたならば、実行バイナリーや関連するライブラリーを実際の OpenWrt ルーターにコピーしてテストする。この場合、ライブラリーの場所が通常と違う場合は、LD_LIBRARY_PATH 変数を指定してバイナリーを実行する必要があるかもしれない。
さらに .ipk 化したい場合には、ツールチェインの説明の範疇から外れるので、👉 独自のパッケージの作成、👉 依存関係の利用を参考のこと。
👉 イメージのビルドについての簡易ガイド
（割愛）
👉 ビルド環境の使い分け方
（割愛）
👉 SDK の使い方
SDK はクロスコンパイルする場合に、ツールチェインをゼロからコンパイルしなくて済むようにする目的で用意されたコンパイル済のツールチェインのことである。
  • 【可能】バイナリーと機能上の互換性を維持しながら独自のソフトウェアをコンパイルする
  • 【可能】特定のパッケージの新しいバージョンをコンパイルする
  • 【可能】既存のパッケージに独自のパッチを当てたり、異なる機能でコンパイルする
  • 【不可能】ファームウェア全体をクロスコンパイルするためのツールチェインとして使うことはできない
SDK の用意の仕方は、menuconfig で Build the OpenWrt SDK オプションを有効にしてコンパイルするか、OpenWrt のサイトのファームウェアイメージと同じディレクトリー（ex. WZR-HP-AG300H の場合 v23.05.2）の Supplementary Files の中からコンパイル済のものがダウンロードできる。
元々存在するパッケージに対して自分のカスタム版のパッケージに置き換えて使いたい場合は、feeds.conf.default の元のパッケージよりも前の行に追記する必要がある。
パッケージリストの反映方法：
  1. scripts/feeds update -a（通常通り）
  2. scripts/feeds install <パッケージ名>（カスタム版パッケージ用）
  3. scripts/feeds install -a（通常通り）
SDK の使い方：
  1. パッケージの選択は menuconfig して行う。
    余計な他のパッケージのビルドを避けるため、Global Build Settings で、
    • Select all target specific packages by default
    • Select all kernel module packages by default
    • Select all userspace packages by default
    を無効化する。その上で、目的とするパッケージを選択（M）する（依存パッケージも連動して選ばれる）。そうして .config を保存してメニューを終える。
  2. 目的とするパッケージをコンパイル（make）する（参考：単体パッケージのビルド）：
    • make package/<パッケージ名>/download パッケージのソースのダウンロード
    • make package/<パッケージ名>/prepare ソースを解凍したりパッチをインストールして当てたりする
    • make package/<パッケージ名>/compile コンパイルする
    • make package/<パッケージ名>/clean 作業に使ったソースを削除する
    • make package/index パッケージ情報に反映させる
    コンパイルによって作成された .ipk は SDK ディレクトリー以下の bin/packages と bin/targets に置かれる。
👉 パッチの扱い方
（割愛）

コメント

コメントを投稿

このブログの人気の投稿

清水俊史『上座部仏教における聖典論の研究』

清水俊史さんという仏教学者（佛教大学出身）が、東大教授（花園大学卒→東大編入 or 再入学？）の馬場紀寿氏と論争の末、アカハラ被害に遭い、さらには出版妨害に遭った（参考： 日本テーラワーダ仏教教会 事務局長 佐藤哲朗さんの YouTube 動画 ）という、問題作であるこの本を読んだ。 佐藤さんが紹介している Amazon の書評リンク にもある通り、この清水さんの本は、馬場氏の（今の東大教授としての地位へとつながる博士論文を母体とした）デビュー作『上座部仏教の思想形成――ブッダからブッダゴーサへ』の内容を完全否定するものである。 主に、清水さんの本の 3 部構成のうちの第 1 部がそれ（馬場説の完全否定劇）に該当する。 総括 第 1 部では、ブッダゴーサやダンマパーラに帰せられる著作群を主な材料として、小部の成立を軸とした三蔵の形成過程を考察した。以上をまとめれば、仏滅後からブッダゴーサを経てダンマパーラに至るまでに、三蔵は次のような段階を経て成立したと推定される。 仏滅後に残された様々な教えは、仏弟子たちによって、その内容に応じて律蔵と『長部』『中部』『相応部』『増支部』という経蔵四部とに収められ、僧団内にいる長部誦者や持律師と呼ばれる専門家たちがこれを伝承していった。この律蔵・四部から漏れた様々な種類の経典（主に偈頌経典）は、他の四部に比してより在家的・通俗的な蔵外文献として伝承され、『ジャータカ』と『ダンマパダ』の例外を除いて専門の誦者や伝持者は僧団内に存在しなかった。 これら四部の外側に累積していった蔵外文献（主に偈頌経典）は、 後に経蔵の第五部「小部」として三蔵内に組み込まれるが、経蔵が五部に再編成された後も小部の構成は固定的ではなく流動的であった。そのため、小部のうちには、成立が早いとされる『スッタニパータ』『ダンマパダ』といった韻文経典のみならず、成立が遅いと考えられ る『義釈』『無礙解道』といった教理書も収められている。このような編纂事情ゆえに、上座部における小部の伝持形態は、「小部」というーまとまりのセットで伝持するという意識が希薄であり、各々の文献単位で別個に伝持されていった。 また、小部の成立だけでなく、阿毘達磨蔵七書と律蔵附随の成立も遅いことが考えられるが、これら小部・阿毘達磨蔵・律蔵附随の成立の具体的な先後関係は不明であ
続きを読む

シークエンスパパともの先見の明

イメージ
先日、シンクロニシティ的に、故・シークエンスパパともが 2 年前に行った未解決事件に対する霊視が、ギャル霊媒師飯塚唯氏が最近行った霊視と、互いに補完し合うような内容であるということを ブログに 認 したた めた ばかりである。 ところで、さらにもう一つの、パパともの霊能力に関する（僕にとって）シンクロニシティ的なタイミングで到来した情報が発生した。 シークエンスはやとものチャンネルの動画などを観るようになったのがきっかけで、YouTube のお勧めに、オカルト系のチャンネルが多数表示されるようになってきたのだが、その一つに「都市ボーイズ」という都市伝説を中心としたオカルト系チャンネルがあった。こういうものを観だしたらキリがないので、基本はスルーしていたのだが、その都市ボーイズ（放送作家の岸本誠と早瀬康広のコンビ）がチャンネルにはやともがゲストで出演して生霊鑑定を行っていたのを観たので、そこから芋蔓式に都市ボーイズのチャンネルの動画も何本か観たりするようになった。 都市ボーイズはやせの黒魔術 当初は、はやせ（早瀬康広）に「黒い呪いのようなものがまとわりついている」という、はやともの生霊鑑定の結果を深掘りすべく、関連する動画を追った。はやせは、呪物コレクターであり、その上、最近（約 10 ヶ月前に公開された動画）、「呪いを飼い馴らして、黒魔術的な力を自分のものにする」という修行というか通過儀礼を行っていたというのである。 儀式を無事に終えて台湾系の呪術師に合格が認められたはやせは、「数年以内に自動的に能力が開花し、自分で自覚するだろう」と言われたという。 都市ボーイズはやせを怒らせた霊能者 そのようなはやせを擁する都市ボーイズだが、先日、「【テレビの闇】インチキ霊能力者にテレビ出演邪魔されました！【インチキ霊能者】」という刺激的なタイトルの動画が、たまたま僕が暇だった時、公開されたばかりのタイミングで見つけてしまったので、早速その動画を観た。 約 1 年前、とある霊能者の霊的な〝脅迫〟によって、はやせはテレビ出演を直前で降板させられてしまったそうである。 僕は、テレビは観なくなって久しい人間で、それこそ霊能者というとシークエンスはやともの言う「心霊第 3 世代」の宜保愛子で止まっていて、江原啓之ですら雑誌の見出しで名前を知っ
続きを読む

シークエンスパパとも 本物の霊能力

イメージ
シークエンスはやともを知ったきっかけ TV を見ない僕がシークエンスはやとも（YouTuber。吉本興業所属）の存在を知ったのは、今年の春（3 月か 4 月）の頃だったと思うが、YouTube でふと宜保愛子の動画を探していて、彼が宜保愛子を称賛するものを見つけて以来だったと思う。 それ以来いくつかの彼の動画をちょくちょく観るようになって、彼の霊能力が父親（シークエンスパパとも）譲りであり、パパともも息子のはやともに勧められて（癌闘病の傍ら）YouTuber として活躍していたのだが、残念ながら今年 1 月末に逝去していた、ということなどを知るようになった。 シークエンスパパともを知ったきっかけ はやとも流れでパパともの動画を観るきっかけになったのは、画面脇のお勧めに出ていた親子対談の動画を見たのが切っ掛けだった。 そこでのパパともの宮本武蔵に関するコメント（「晩年の宮本武蔵は一生懸命仏像を彫ったりしていたが、（若い頃）子供の道場主を殺したりしていたことによる怨霊は除霊できなかった」）に少しシビれた。息子のはやともが、まだ若いせいもあって、ちょっと話がマクロな（思想論や社会論的な）方向に行くと、厨二病的な傾向があるのには食傷気味な感じがあった。一方で、パパともの宗教・倫理観的な考えの方がその点、人間的な深さを感じるものがあったので、それがパパともに興味を引かれたきっかけだった。 パパともの霊能力に衝撃を受けた理由 そこで、初めて、パパとものチャンネルの動画もいくつか観たりしたのだが、「未解決事件を霊視する」という中々に攻めた企画を初期にやっていて興味深かったのだが、中に、上野の不忍池での事件（僕自身はこの 2006 年の事件については知らなかった）を扱ったものがあった： 「あっ！」と思ったのが、奇しくも前日（2023-06-28）、全く別のチャンネルの別の動画で、霊媒師が同じ事件を霊視するという企画のものを観ていたのだった： 千原せいじの YouTube チャンネルで、彼がコラボをしている飯島唯という通称・ギャル霊媒師の方が霊視をしている。 パパともの動画は 2021-05-12 と 2021-05-15 に公開されたものであるのに対し、ギャル霊媒師の動画は 2023-06-28 公開であり、僕はたまたま公開
続きを読む