{"id":18673865,"url":"https://github.com/nuta/microkernel-book","last_synced_at":"2025-04-04T10:06:22.208Z","repository":{"id":157904018,"uuid":"621708098","full_name":"nuta/microkernel-book","owner":"nuta","description":"『自作OSで学ぶマイクロカーネルの設計と実装』サポートサイト","archived":false,"fork":false,"pushed_at":"2025-01-23T13:13:36.000Z","size":1150,"stargazers_count":210,"open_issues_count":0,"forks_count":25,"subscribers_count":8,"default_branch":"main","last_synced_at":"2025-03-27T09:14:20.546Z","etag":null,"topics":["educational","microkernel","operating-system"],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nuta.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-03-31T08:08:43.000Z","updated_at":"2025-03-16T23:47:42.000Z","dependencies_parsed_at":"2024-03-09T10:21:49.367Z","dependency_job_id":"5c94c0e6-6cc3-481b-8320-df6aa00080a4","html_url":"https://github.com/nuta/microkernel-book","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nuta%2Fmicrokernel-book","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nuta%2Fmicrokernel-book/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nuta%2Fmicrokernel-book/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nuta%2Fmicrokernel-book/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nuta","download_url":"https://codeload.github.com/nuta/microkernel-book/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247157077,"owners_count":20893202,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["educational","microkernel","operating-system"],"created_at":"2024-11-07T09:16:49.298Z","updated_at":"2025-04-04T10:06:22.178Z","avatar_url":"https://github.com/nuta.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 『自作OSで学ぶマイクロカーネルの設計と実装』サポートサイト\n\nこのリポジトリは、[『自作OSで学ぶマイクロカーネルの設計と実装』(秀和システム、ISBN: 978-4-7980-6871-8)](https://www.hanmoto.com/bd/isbn/9784798068718) のサポートサイト兼、教育用マイクロカーネルOS「HinaOS」のソースコードの配布場所です。\n\n- [質問・バグ報告など (GitHub Discussions)](https://github.com/nuta/microkernel-book/discussions)\n- [HinaOS: ビルド・実行方法](#開発環境構築)\n- [HinaOS: 内部構造の概要](ARCHITECTURE.md)\n- [HinaOS: 実験テーマのアイデア集](IDEAS.md)\n- [HinaOS: デバッグガイド](DEBUG.md)\n\n\u003ca href=\"https://www.hanmoto.com/bd/isbn/9784798068718\"\u003e\n\u003cimg alt=\"本のカバー画像\" src=\"https://gist.githubusercontent.com/nuta/e45864405fbdc8618af4b08de534e42c/raw/bd3df82e7039902818c8fc0d394b69250cc78fc9/cover.jpg\" width=\"300\"\u003e\n\u003c/a\u003e\n\n## HinaOSをベースに自作OSをしたい方（おすすめ）\n\n`printf`関数で変数の中身を追ったり、デバッガを使って処理の流れを追ったりしながら、まずはHinaOSを改造して全体を理解していくアプローチです。\n\nHinaOSに手を加えながら本書を読み進めていくことで、OSの仕組みをより深く理解することができます。一通り読んだあとは、[こちらのドキュメント](IDEAS.md) にまとめてある実験テーマから興味のあるものを選んで実装してみるとより楽しめるでしょう。\n\n序盤に実装する必要があるくせにデバッグの難易度が非常に高く苦しいCPU初期化処理・割り込み周りの実装を、HinaOSをベースにすればスキップできるのでおすすめです。\n\n## ゼロから自作OSをしたい方\n\n本書はOSを体系的に学べるように各機能ごとにまとめて実装例を紹介しています。ただこのアプローチでは、ゼロから作って漸進的に学ぶことが難しく、一体どこから手をつければいいのか分かりにくいものです。\n\n「HinaOSベースではなく、ゼロからステップバイステップで自作OSを作りたい」という方のために [1,000行で小さなRISC-V用OSを作る資料](https://operating-system-in-1000-lines.vercel.app) を用意しました。最初の一歩さえ乗り越えられれば、あとは本書の興味のある部分をHinaOSを参考にしながら自作するための知識・自信がつくはずです。\n\n\u003e [!NOTE]\n\u003e 「ゼロからの実装の雰囲気を手っ取り早く動画で感じてみたい」という方は [筆者の45分OS自作ライブコーディング (オープンソースカンファレンス)](https://www.youtube.com/watch?v=dPEsTeL2F98) がおすすめです。\n\n----\n\n## HinaOSとは\n\nHinaOS (ひなおーえす) はマイクロカーネルベースの教育用オペレーティングシステムです。次の特徴・機能を持っています。\n\n- 32ビット RISC-V ([QEMU virtマシン](https://www.qemu.org/docs/master/system/riscv/virt.html)) に対応\n- マルチプロセッサ対応マイクロカーネル\n- 独自ファイルシステム (HinaFS)\n- TCP/IP プロトコルスタック\n- virtio-blk デバイスドライバ (仮想ストレージデバイス)\n- virtio-net デバイスドライバ (仮想ネットワークデバイス)\n- コマンドラインシェル\n\n## 開発環境構築\n\nHinaOSの開発には次のパッケージが必要です。筆者が利用しているバージョンも記載していますが、同じバージョンでなくとも新しめのものであれば問題ありません。もしビルド時にエラーが出る場合には、バージョンが古すぎないか確認してください。\n\n- Git バージョン 2.38.0\n- Python バージョン 3.11.2\n- GNU Make バージョン 3.81\n- QEMU バージョン 7.1.0\n- LLVMツールチェーン バージョン 15.0.2\n\nUbuntu 22.04 (Jammy) の場合は次のコマンドで必要なパッケージをインストールできます。\n\n```\n$ sudo apt update\n$ sudo apt install llvm clang lld python3-pip qemu-system gdb-multiarch git\n$ cd \u003cHinaOSのディレクトリ\u003e\n$ pip3 install --user -r tools/requirements.txt\n```\n\nmacOS 13 (Ventura) の場合は次のコマンドで必要なパッケージをインストールできます。\n\n```\n$ brew install llvm lld python3 qemu riscv-software-src/riscv/riscv-tools\n$ cd \u003cHinaOSのディレクトリ\u003e\n$ pip3 install --user -r tools/requirements.txt\n```\n\n\u003e [!NOTE]\n\u003e\n\u003e macOS上で `ld.lld` コマンドが見つからないというエラーが出る場合は、次の通りに `lld` パッケージをインストールしてください。\n\u003e\n\u003e ```\n\u003e brew install lld\n\u003e ```\n\n\u003e [!NOTE]\n\u003e\n\u003e Windowsでもwingetを利用して上記のパッケージをインストールすることでネイティブな開発環境を構築できます（詳細なステップは本書の付録で解説しています）。ただし環境構築がかえって面倒であるため、[WSL2](https://learn.microsoft.com/ja-jp/windows/wsl/install)上でUbuntuを利用するのがお勧めです。\n\n## ソースコードのダウンロード\n\n`git`コマンドでソースコードをダウンロードできます。\n\n```\n$ git clone https://github.com/nuta/microkernel-book\n```\n\n## ビルド・実行\n\n次のコマンドでビルドできます。`-j8` は8並列ビルドを意味します。CPUコア数程度を指定すると良いでしょう。`V=1`や`RELEASE=1`はビルドオプションで、組み合わせて使うことができます。\n\n```\n$ make -j8              # OSをビルドする\n$ make -j8 V=1          # OSをビルドする (詳細なビルドログを出力)\n$ make -j8 RELEASE=1    # OSをビルドする (コンパイラのより高度な最適化を有効化)\n$ make -j8 run          # OSをビルドしてQEMUで実行する (シングルコア)\n$ make -j8 run CPUS=4   # OSをビルドしてQEMUで実行する (4コア)\n```\n\n## デバッグ\n\n[HinaOSのデバッグ](./DEBUG.md) を参照してください。\n\n## ライセンス\n\nHinaOSは [MITライセンス](./LICENSE.md) で公開されています。\n\n## プルリクエスト受諾方針\n\nHinaOSはシンプルさと分かりやすさを保つため、新機能を追加するプルリクエストは受け付けていません。誤字の修正やバグフィックスのような変更のみ受け付けています。ただし、各ドキュメント (`ARCHITECTURE.md` など) の改善は大歓迎です :D\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnuta%2Fmicrokernel-book","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnuta%2Fmicrokernel-book","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnuta%2Fmicrokernel-book/lists"}