English version

最終更新: 2026-02-23

genpack-overlay プロファイルリファレンス

概要

genpack-overlay のプロファイルは、genpack イメージのベース環境を定義します。genpack.json5 で profile: "paravirt" のように指定すると、そのプロファイルが持つパッケージ群、USE フラグ、キーワード設定などが自動的に適用されます。

プロファイルは Gentoo の Portage プロファイル機構を使って構成されており、階層的な継承関係を持ちます。

プロファイル階層

全てのプロファイルは genpack ルートプロファイルを継承し、さらにアーキテクチャ固有の層を経由します。

実際のプロファイル選択時には、アーキテクチャ層が自動的に挿入されます:

genpack.json5: profile: "paravirt"
  → genpack/amd64/paravirt  (x86_64 の場合)
  → genpack/arm64/paravirt  (aarch64 の場合)

利用可能なプロファイル

paravirt

用途: QEMU/KVM 仮想マシン向け

systemimg と排他的です。仮想化環境に特化したパッケージ(ゲストエージェント、virtio 対応)を含み、物理ハードウェア向けのドライバ類を含みません。

追加されるパッケージ (genpack/paravirt メタパッケージ):

USE フラグ設定:

media-libs/mesa video_cards_zink video_cards_lavapipe

仮想マシンではソフトウェアレンダリング (lavapipe) と Zink (OpenGL on Vulkan) が使用されます。

systemimg

用途: ディスクイメージベースのインストール向け(genpack-install で書き込む形式)

paravirt と排他的です。genpack-install によるディスク書き込みとブートローダー設置に必要なパッケージを含みます。

追加されるパッケージ (genpack/systemimg メタパッケージ):

USE フラグ設定:

sys-libs/zlib minizip

baremetal (systemimg/baremetal)

用途: 物理マシン向け(systemimg を継承)

profile: "baremetal" で指定します。物理ハードウェアの検出・管理に必要なツール群を追加します。

追加されるパッケージ (genpack/systemimg の baremetal USE フラグで有効化):

x86_64 固有:

gnome/baremetal

用途: 物理マシン + GNOME デスクトップ

profile: "gnome/baremetal" で指定します。baremetal の全パッケージに加えて GNOME デスクトップ環境を含みます。

追加されるパッケージ (genpack/gnome メタパッケージ):

継承元: gentoo:targets/desktop/gnome プロファイルを含むため、GNOME に必要な広範な USE フラグが自動設定されます。

weston/paravirt

用途: 仮想マシン + Wayland (Weston) デスクトップ

profile: "weston/paravirt" で指定します。Weston コンポジタをベースとした軽量なデスクトップ環境を提供します。

追加されるパッケージ (genpack/weston メタパッケージ):

グローバル USE フラグ:

USE="wayland -X"

X11 を無効化し、Wayland を優先する設定です。

パッケージ別 USE フラグ (74 項目、主要なもの):

sys-apps/systemd policykit
media-libs/mesa X vulkan vaapi
app-i18n/mozc fcitx5
dev-qt/qtbase opengl vulkan

Chrome、VS Code、Ghostty、GIMP、Evolution、LibreOffice、VLC など多数のアプリケーション向けの USE フラグが設定されています。

仮想マシン向けビデオドライバ:

VIDEO_CARDS="-intel -nouveau -radeon -radeonsi virgl"

raspberrypi

用途: Raspberry Pi 向け(arm64 のみ)

profile: "raspberrypi" で指定します(arm64 アーキテクチャ専用)。baremetal を継承し、Raspberry Pi 固有のカーネルとファームウェアを追加します。

追加されるパッケージ:

ルートプロファイル (genpack)

全プロファイルが継承する共通設定です。

パッケージ:

グローバル USE フラグ:

sys-libs/glibc audit
sys-kernel/installkernel dracut
sys-fs/squashfs-tools lz4 lzma lzo xattr zstd
app-crypt/libb2 -openmp
dev-lang/perl minimal
app-editors/vim minimal

パッケージマスク:

>=dev-lang/python-3.14

ベースシステム (genpack/base)

全プロファイルを通じて含まれるベースパッケージです。

常に含まれるパッケージ:

USE フラグで制御可能なパッケージ (全てデフォルト有効):

その他のメタパッケージ

プロファイルとは独立して genpack.json5 の packages に追加できるメタパッケージです。

genpack/wireless

無線ネットワークサポート:

genpack/devel

開発ツール:

genpack/devlauncher

AI エージェント向け開発環境 (genpack/devel を含む):

プロファイルの選択ガイド

アーキテクチャ固有の差異