Q applets/ja

q アプレットは Article description::C で書かれた小さくて素早い Portage クエリ (query) ユーティリティーのコレクションです. に比べてより素早く、しかし限定的な代替を提供します.

These are meant to offer a faster but more limited alternative to their gentoolkit counterparts.

q アプレットは gentoolkit を置き換えることを意図したものではないことに留意してください. このユーティリティーは gentoolkit の同等なものよりもかなり効率的であり、Portage を繰り返し呼ぶ必要があるスクリプト内での使用により適していますが、これらは同じ機能を提供するものではありません. q アプレットはeclass を考慮しませんし、 や のようなツールも提供しません.

Emerge
q アプレットをインストールします:

呼び出し
または と入力することによって、  が提供しているアプリケーションの完全なリストが表示されます. このガイドでは最も役立つ機能について短く言及するだけにとどめ、それぞれのアプリケーションに関する情報全てを含めることはしませんので、それぞれのユーティリティについての説明はmanページをご覧ください.

短い説明文付きで利用可能なアプレットを見るには、 を実行します:

currently defined applets: q : virtual applet qatom          : split atom strings qcheck      : verify integrity of installed packages qdepends      : show dependency info qfile     : list all pkgs owning files qgrep [pkg ...]: grep in ebuilds qkeyword : list packages based on keywords qlist      : list files owned by pkgname qlop      : emerge log analyzer qmanifest    : verify or generate thick Manifest files qmerge     : fetch and merge binary package qpkg    : create or manipulate Gentoo binpkgs qsearch        : search pkgname/desc qsize      : calculate size usage qtbz2    : manipulate tbz2 packages qtegrity    : verify files with IMA quse      : find pkgs using useflags qwhich       : find path to pkg qxpak    : manipulate xpak archives

options: -[ioemvqChV] -i, --install   * Install symlinks for applets -o, --overlays  * Print available overlays (read from repos.conf) -e, --envvar    * Print used variables and their found values -m, --masks     * Print (package.)masks for the current profile --root * Set the ROOT env var -v, --verbose   * Report full package versions, emit more elaborate output -q, --quiet     * Tighter output; suppress warnings -C, --nocolor   * Don't output color --color     * Force color in output -h, --help      * Print this help and exit -V, --version   * Print version and exit }}

あるファイルが含まれているパッケージを見つける方法 (qfile)
コマンドは、ファイルがどのパッケージに属しているか見つけます:

Example one:

Example two:

パッケージの整合性検証 (qcheck)
パッケージによってインストールされたファイルのMD5チェックサムや更新日時を確認するには、 アプリケーションを使います:

インストール後に変更された全てのファイルがここで報告されます. インストール後に手動で編集された設定ファイルも報告されます. 多くのパッケージは root パーミッションを要求しませんが、パッケージに root だけがアクセスできるファイルが含まれている場合は、 を root として実行する必要があります.

インストールされているすべてのパッケージの整合性を確認するには、次を実行してください:

パッケージ依存関係の一覧表示 (qdepends)
はあるパッケージの依存関係を両方向で一覧表示できます. インストールされている依存パッケージのうち DEPEND 、 RDEPEND 、 PDEPEND 、または BDEPEND を一覧表示するオプションを付けない場合、パッケージが要求するすべての依存パッケージが単一のリストにマージされて表示されます. ebuild 内で見られるような、シェル互換のフォーマットされた依存パッケージのリストを得るには、 を使用してください.

ebuild 内で見られるような、シェル互換のフォーマットされた依存パッケージのリストを得るには、 を使用してください.

あるパッケージに依存している、すべてのインストールされているパッケージを一覧表示するには、 オプションを使用してください.

パターンで ebuild または eclass を検索する (qgrep)
を使って、ある ebuild の名前 (以下の例では"libechonest"とします) に言及している ebuild を探すことができます. これはあるパッケージに依存するすべてのパッケージを (インストールされているかどうかに関係なく) 一覧表示します:

オプションは検索対象をインストール済みのパッケージに制限します. はファイル名の代わりにアトムを印字します.

あるebuildに属するファイルの一覧表示 (qlist)
は、指定した ebuild に属する全てのファイルの一覧を提供します.

あるUSEフラグを使っているパッケージの検索 (quse)
使用している USE フラグの一覧を表示するには、 を実行してください. もっとも単純な形式では、与えられた USE フラグを使用する ebuild を一覧表示します.

USE フラグの説明を表示するには、 オプションを使うことができます. これは、アトム名を引数として取り、与えられたアトムのすべての USE フラグを一覧表示する  オプションと組み合わせることができます.

パッケージサイズの検索 (qsize)
パッケージの大きさを表示させるには、 アプリケーションを使用します:

Portageツリーの検索 (qsearch)
の中で最も強力なツールの一つが です. このツールは を実行するよりもずっと速くPortageツリーを検索することができます.

いくつか使い方の例を挙げます:

オプションを使用すると、パッケージに関するホームページの情報が表示されます:

他の例として、Jabberクライアントについて見てみましょう:

emergeログからの情報抽出 (qlop)
は、 ファイルから役立つ情報を抽出します. このツールはパッケージがコンパイルされた回数を推測したり、ビルド時間を他のシステムと比較したりするのに役立ちます. ある瞬間に何をコンパイルしていてどれくらい時間がかかりそうなのか、コンソール上で作業していて他の手段をとりたくないときに手軽に確認することにも使えます.

のビルド作業がどのくらいかかるか見積もりたいときには:

いま何がemergeされていて、その作業に既にどのくらいの時間が経過したのか、見てみましょう:

Install binary package (qmerge)
qmerge can quickly install binary packages (binpkgs):

Defining atom fields for applet commands
Certain q applet commands / argument combinations (such as ) mention the use of atom formatting. The defintion of this formatting can be found on the qatom man page under the   argument: