Gentoo チートシート

これはGentoo システムを管理するための便利なコマンドとヒントからなるリファレンスカードです。初心者も熟練者も、便利なヒントがあればぜひ下に追加してください。

パッケージ管理

同期の手段

Portage

Gentoo ebuild リポジトリも含めて、auto-sync に設定されているすべてのリポジトリを同期する:

または、短い形式では:

ミラーから (長くとも) 一日以内のスナップショットを取得して Gentoo ebuild リポジトリを同期する:

emerge --sync は現在 emaint sync モジュールを --auto オプション付きで実行します。 Portage の同期操作 を参照してください。

eix

eix を使用して 設定済みのパッケージリポジトリ と Gentoo ebuild リポジトリ を同期する:

これはリポジトリを同期するだけでなく、eix がクエリを行うために使用するキャッシュも更新します。自動的に キャッシュを更新するように portage を設定する ほうがより好ましいかもしれません。

パッケージの一覧表示

qlist

インストールされているパッケージを、バージョン、使用されているオーバーレイの名前付きで一覧表示する:

qlist は app-portage/portage-utils によって提供されます。

eix

world 集合のパッケージの一覧を、利用可能なバージョンの一覧とともに確認するために、 eix を使うことができます:

出力の色を保持するには、 --color スイッチを使用してください:

Portage

以下を実行することで、 パッケージ集合 を使って、selected 集合のパッケージを一覧表示します:

すべての (*)、または指定された名前を持つ、複数のスロットを使用するパッケージを一覧表示する:

パッケージの、同期された利用可能なバージョンとキーワードを一覧表示する:

パッケージのインストール

以下の例では www-client/firefox パッケージを使用していますが、この部分はインストールしたいパッケージで置き換えてください。

どのパッケージがインストールされることになるか、実際にインストールせずに一覧表示する:

または、短い形式では:

どのパッケージがインストールされることになるか一覧表示し、インストールする前に確認を求める:

または、短い形式では:

特定のバージョンをインストールする

パッケージの特定のバージョンをインストールする ("=" 文字に特別な意味を付加するシェルでは "\=" ( バックスラッシュ と イコール ) を使用してください)。例えば:

Portage が自動的にパッケージを更新しないようにするには、 /etc/portage/package.mask/package.mask ファイルに次の行を追加してください (ファイルが存在しない場合は作成してください)。最新の安定版より古いパッケージをマスクする場合は先頭に大なり演算子 ( > ) を接頭辞として使用して、より新しいバージョンをマスクする場合は小なり演算子 ( < ) を接頭辞として使用して、バージョンを指定します:

<www-client/firefox-96.0.1

パッケージのマスキングに関するさらなる情報については /etc/portage/package.mask を参照してください。

グループ内の一部のパッケージのみをインストールする

インストール時に特定のパッケージとその依存を除外するには:

既にインストール済みのパッケージを world に追加する

パッケージの再マージをせずに world ファイルを更新します:

world ファイルに追加せずにインストールする

world ファイルに追加せずにパッケージを emerge します:

または、短い形式では:

パッケージの削除

--deselect

指定されたパッケージを @world 集合 から削除する (そのパッケージはもういらないことを示す) には emerge --deselect (または短縮形の -W オプション) を使用してください:

次に emerge --depclean (または短縮形の -c オプション) を実行してください。 --pretend ( -p ) オプションはどのようなアクションが取られるかを emerge に表示させます。必要なパッケージが削除されないことを確かめるには、この出力を確認する必要があります:

emerge --depclean をしばらく実行しなかった場合、多数のパッケージを削除しようとするかもしれません - 注意してください。 emerge --depclean が不要なパッケージだけを削除することを確認したら、次を実行してください:

--ask オプションは、 --pretend による確認後であれば実際には必要ありませんが、上の例を「コピペ」したときの事故を軽減するために追加しています。

--depclean

他のパッケージに依存されていないパッケージを直接削除するには:

Calculating dependencies... done!
>>> Calculating removal order...
 
>>> These are the packages that would be unmerged:
 
 www-client/firefox
    selected: 68.5.0 
   protected: none 
     omitted: none 
 
All selected packages: =www-client/firefox-68.5.0
 
>>> 'Selected' packages are slated for removal.
>>> 'Protected' and 'omitted' packages will not be removed.
 
Would you like to unmerge these packages? [Yes/No]

安全策として、depclean は すべての 必要な依存が解決されていない限り、どのパッケージも削除しません。その結果として、まず以下を実行する必要があることがあります:

変更がリポジトリへの USE フラグの追加・削除のみである場合に再ビルドを避けるために、 --newuse ( -N ) の代わりに --changed-use ( -U ) を使用します。より簡潔な実行のために --quiet ( -q ) フラグを使用します:

パッケージの更新

world 集合 のすべてのパッケージ、それらの依存 ( --deep )、および USE フラグの変更があるパッケージを (USE 変更が何の影響も及ぼさない場合は不必要な再ビルドを避けつつ) アップグレードする:

すべてのパッケージの USE フラグが Gentoo リポジトリの現在の状態を反映していることを確実にするために、 --changed-use の代わりに --newuse を使用することができますが、これはより多くのパッケージの再ビルドを発生させるでしょう。ビルド時依存も更新するためには、 --with-bdeps=y を使用することができます。

パッケージのトラブルシューティング

欠けているライブラリが無いか確認し、再ビルドする (通常は必要ありません):

equery は app-portage/gentoolkit に含まれます。このコマンドを実行してインストールしてください:

equery を使って、インストールされたどのパッケージがコマンドを提供しているか確認する:

e-file を使って、(インストールされていなくてもよい) どのパッケージがコマンドを提供しているか確認する:

次で e-file をインストールする:

equery を使用して、特定のパッケージ (例では cat/pkg です) にどのパッケージが依存しているか確認する:

eix を使ってパッケージについての情報を得る:

再ビルド

パッケージを正しく機能させるために、再ビルドが必要になることがあります。以下は再ビルドコマンドの例です。

新しいカーネルをインストールした後は:

新しいライブラリを使用する には:

Portage の改良

emerge 完了後に、設定ファイルへの変更を管理する:

インストールまたは更新後

perl -core パッケージを更新した後は:

または、上の効果が無い場合は:

haskell パッケージに関しては:

USE フラグ

euse を使用して、USE フラグ X の説明と使用状況を取得する:

マニュアルページを読むことで euse についてさらなる情報を収集する:

どのパッケージが mysql USE フラグを持っているか表示する:

どのパッケージが現在 mysql USE フラグとともにビルドされているか表示する:

特定のパッケージに対してどの USE フラグが利用できるか表示する:

パッケージインストールのために必要な USE フラグを手っ取り早く追加する:

重要な Portage 関連ファイル

• /etc/portage - Portage の主要設定のディレクトリ。
• /etc/portage/make.conf - グローバル設定 (USE フラグ、コンパイラオプション)。
• /etc/portage/package.use - 個々のパッケージの USE フラグ。複数のファイルを含むフォルダにすることもできます。
• /etc/portage/package.accept_keywords - 個々のパッケージのキーワード; 例えば ~amd64 、 ~x86 、または ∼arm 。
• /etc/portage/package.license - 受諾したライセンス
• /etc/portage/profile/use.mask - ロックされた USE フラグをマスク/マスク解除するために。
• /var/lib/portage/world - 明示的にインストールされたパッケージアトムのリスト。
• /var/db/pkg - インストールされたすべてのパッケージに対する、インストールについての情報ファイルの集合を含んでいます。

ログ管理

genlop

genlop は Portage ログ処理プログラムで、パッケージを emerge したときのビルド時間を推測することもできます。

次を実行して app-portage/genlop をインストールしてください:

マニュアルページを読むことで genlop についてさらなる情報を収集する:

最後に emerge (インストール) された 10 パッケージを表示する:

LibreOffice の emerge にどれだけの時間がかかったかを表示する:

emerge -uND --with-bdeps=y @world にどれだけの時間がかかりそうか推測する:

システムアップグレード中に、最新の ebuild マージ状況を監視する:

オーバーレイ

eselect repository

以下を実行することで app-eselect/eselect-repository をインストールできます:

存在するすべてのオーバーレイを一覧表示する:

インストールされているすべてのオーバーレイを一覧表示する:

サービス

root シェルを取得する (現在のユーザが sudoers リストに含まれていない場合):

OpenRC

ブート時に default ランレベルで ssh デーモンを開始する:

今すぐ sshd サービスを開始する:

sshd サービスが実行中か確認する

sshd サービスを再起動する:

sshd サービスを停止する:

サービス、それらのステータス、それらが属しているランレベルを一覧表示する:

有効化されているサービス、それらが属しているランレベルを表示する (実行中かどうかではなく、有効化されているもののみ):

systemd

ssh デーモンをブート時に開始する:

sshd サービスを今すぐ開始する:

sshd サービスが実行中か確認する:

ヒント

メタデータキャッシュを生成する

ebuild リポジトリは小さなものから大きなものまでさまざまです。その結果として Portage の操作の大部分の処理速度を低下させます。これが起こるのは、オーバーレイがメタデータキャッシュを持っていないからです。キャッシュは検索と依存ツリーの構築を高速化するために使用されます。オーバーレイを同期した後はローカルメタデータキャッシュを生成するのが良い戦略です。

この技は eix と組み合わせて使うこともできます。 eix-update は処理を高速化するために、 emerge --regen によって生成されたメタデータキャッシュを使用することができます。これを有効化するには、次の変数を /etc/eixrc/00-eixrc に追加してください:

OVERLAY_CACHE_METHOD="assign"

Portage 内のパッケージを正規表現で検索する

Portage 内のパッケージを正規表現で検索し、インストールされているバージョン付きで表示するには:

または

qcheck

qcheck を使用してインストール済みのパッケージを検証する:

qcheck は app-portage/portage-utils に含まれており、このコマンドを実行することでインストールできます:l

qcheck について、マニュアルページを読んで詳しく知る:

関連項目

• Package_sets

外部資料

• オリジナルの gentoo-cheat リポジトリ
• gentoo-cheat についてのフォーラム投稿
• 別の Gentoo チートシート
• Gentoo ヒント集
• 新入り向けチートシート