Equery/ja

は、Portage における一般的な操作をより簡単にするためのツールです. パッケージの依存関係、メタデータ、インストールされたファイルなどを表示可能です.

emerge
Equery is part of a toolset installed with the package:

For information on installing or other tools visit the Gentoolkit article.

はじめに
is a tool that displays useful information about the installed packages on the system. is based on a system of modules. Every module has a shorthand name. For example, running is the same as running. Invoking the  option  will output global options and list all available modules and their shorthand names. Adding a module name to the end will display the help screen for that specific module. Lastly, executing will also provide a detailed explanation of all available modules and options along with some useful examples.

下に示す方法は、大部分のモジュールで使うことができます.

Like, does not understand partial package names:

Unlike, can accept shell-like globbing in the category and/or package name:

ほとんどのequeryモジュールは複数の入力を受け付けます.

いくつかのモジュールは完全な正規表現も扱うことができます.

The next few sections in this document give a quick introduction to the different modules.

機能
equeryのすべての機能を見たい場合、単純に引数無しでequeryを実行します.

エイリアス
A common approach to working with is to create aliases. When using bash these can usually be placed in the file:

belongs (b): ファイルを提供したパッケージを検索
は、 オプションで指定される正規表現にマッチしたファイルを検索できます. オプションを付けると、マッチするファイルを見つけた時点で検索を停止します. ２つ以上のパッケージに所属するファイルは存在しないため、このオプションは安全です.

A short version of   can also be used. For example, to list what package belongs to:

changes (c): パッケージの ChangeLog を表示
lets the user view ChangeLog entries for a package version or range of versions. Imagine after running an Portage prints out a message saying it is going to be upgraded. To see what has changed this command can be used:

check (k): パッケージの状態が完全か検査
Sometimes it is useful to check a package's integrity. can verify MD5 sums as well as timestamps to indicate when a package might have been corrupted, replaced, or removed.

depends (d): パッケージに依存するすべてのパッケージをリスト表示
Ever wonder why a certain package has been installed on the system? can tell which packages list it as a dependency with. Include indirect dependencies with the  option.

次の例では、udevに直接依存するすべてのパッケージをリストアップします.

depgraph (g): パッケージが必要とするすべてのパッケージを表示
は、 の逆です. 指定したパッケージが必要とする全てのパッケージを表示します（「指定したパッケージを必要とするパッケージ」ではありません）. 間接的に必要なパッケージも表示します. 何階層にわたり再帰検索を行うかについては、  オプションで指定します.

上記例では、 USEフラグが有効なときには  が直接的に必要で、   が間接的に必要になることがわかります.

files (f): パッケージが含むファイルのリストを表示
can list all the files installed by an ebuild with the  module. Try  to get an easy to read directory layout. Use  to only find a certain type of file. For example, to find where executables were installed use, or to quickly find the configuration file location try.

Another example, to list all files installed by :

Descriptions of other modules and additional command line flags can be found in the equery man page.

hasuse (h): 特定のUSEフラグをもつパッケージを検索
can be used to find packages with a given USE flag. will not indicate if the flag has been enabled or not; it simply outputs a list of ebuilds that have the queried flag as an option. See the EXAMPLES section of  in the  man page for more tip on getting this kind of information.

list (l): パッケージをリスト表示
は単純ですが協力なモジュールで、Portageツリーもしくはオーバーレイでインストールされたパッケージをリスト表示することができます.

通常のequeryは、与えられたパッケージ名に対してインストールされているパッケージを探します. を指定することでインストールされているすべてのパッケージを表示できます. このとき、もっとも左のフィールドで、個々のパッケージが実際に nstallされているのか、それとも ortageツリーに存在するだけなのかがわかります. これらは（2番目のフィールドが空白なので）マスクされておらず、かつデフォルトスロット（0）にインストールされていることがわかります.

ローカルオプションを使えば、Portageとオーバーレイにあるパッケージを検索できます.

この例では、バージョン7.2.182がインストールされ、オーバーレイには使用可能なバージョンがないことがわかります. 2番目のフィールドの によってマスクされているバージョンがわかります.

meta (m): パッケージのメタデータを表示
Each package in the Portage tree provides at least some metadata about its maintainer, etc. The amount of useful information depends on how much package maintainers decide to provide. With no options,  returns some basic useful information.

一部のメンテナーは、そのパッケージについてとても有益な情報を提供しています.

size (s): パッケージのサイズを表示
Ever been curious to find out how much space a specific package is occupying? Since a package could have its files over a number of directories, the usual command might not give the correct figure. Not to worry, to the rescue!

は、人が読みやすい単位でディスク使用量を表示し、そのパッケージが持つファイルの数をリスト表示します. 例えば、バイト単位でトータルサイズを得るためには を使用してください.

uses (u): パッケージ毎にUSEフラグを表示する
's  module can provide information about what USE flags are available for a specific package and which of those flags is currently enabled.

この例では、いくつかのUSEフラグがgstreamerプラグインのメタパッケージで有効にされていることがわかります. しかし他に使用可能なUSEがあることもわかります. USEフラグの詳細については、Gentoo HandbookのUSE Flagsの章を参照してください.

which (w): ebuildのパスを検索する
is a simple script to help users quickly find the file path to an ebuild. If an unversioned package name is passed using  it will return the path to the newest installable ebuild version. In other words, it would return the ebuild Portage would use if was typed. also accepts a versioned package to get the path to that ebuild.

Lastly, if none of the above features of have provided an answer, try using   to manually search an ebuild with programs like,  or :

参考

 * Q applets - A collection of small and fast Portage helper tools written in C.
 * eix - A set of utilities for searching and diffing the local Portage tree and overlays using a binary cache.
 * Gentoolkit - A suite of tools to ease the administration of a Gentoo system.