Provided by:
apt_0.7.14ubuntu6_i386 
NAME
apt-cache - APT パッケージ操作ユーティリティ -- ゥ礇奪轡總犧
SYNOPSIS
apt-cache [-hvsn] [-o=config string] [-c=file] {[add file...] |
[gencaches] | [showpkg pkg...] | [showsrc pkg...] | [stats] |
[dump] | [dumpavail] | [unmet] | [search regex] |
[show pkg...] | [depends pkg...] | [rdepends pkg...] |
[pkgnames prefix] | [dotty pkg...] | [policy pkgs...] |
[madison pkgs...]}
明
apt-cache は APT のパッケージゥ礇奪轡紊紡个靴董
さまざまな操作を行います。 apt-cache
は、システム状態の操作は行いませんが、
パッケージのメタデータより検索したり、
興味深い出力を生成するといった操作を提供します。
-h オプションや --help オプションを除ぁ
以下に挙げるコマンドが必要です。
add file(s)
add は、 パッケージ-
ャッシュに指定したパッケージインデックスファイルを追加します。
デバッグ専用です。
gencaches
gencaches は、 apt-get check と同じ動作を提供します。 これは
sources.list(5) 内の取得元と /var/lib/dpkg/statusから、
ソースとパッケージのゥ礇奪轡紊鮃獣曚靴泙后
showpkg pkg(s)
showpkg は、
コマンドライン上に列挙したパッケージの情報を表示します。
後に続く引数はパッケージ名となります。 各パッケージについて、-
効なバージョンと被依存関係を列挙し、
さらにその各バージョンについて依存関係を表示します。 (通常の)
依存関係とは、対象のパッケージが依存しているパッケージを指します。
また、被依存関係とは、対象のパッケージに依存しているパッケージを指します。
従って、パッケージの依存関係は満たさなければなりませんが、
被依存関係は満たす必要はありません。 実例として、以下に apt-cache
showpkg libreadline2 の 出力を掲げます。
Package: libreadline2
Versions: 2.1-12(/var/state/apt/lists/foo_Packages),
Reverse Depends:
libreadlineg2,libreadline2
libreadline2-altdev,libreadline2
Dependencies:
2.1-12 - libc5 (2 5.4.0-0) ncurses3.0 (0 (null))
Provides:
2.1-12 -
Reverse Provides:
つまり、libreadline2 の version 2.1-12 は、 libc5 と ncurses3.0
に依存していて、libreadline2 が動作するには、
これらをインストールする必要があるということが判ります。
一方、libreadlineg2 と libreadline2-altdev は libreadline2
に依存しています。 libreadline2 をインストールするためには、libc5,
ncurses3.0, ldso を
すべてインストールしなければなりませんが、libreadlineg2 と
libreadline2-altdev はインストールする必要はありません。
出力の残りの部分の意味については、 apt
のソースコードを調べるのが最良でしょう。
stats
stats はゥ礇奪轡紊砲弔い討療計情報を表示します。
それ以上、引数は必要ありません。以下の統計情報を表示します。
o パッケージ名総数は、 -
ャッシュに存在するパッケージ数を表します。
o 通常パッケージは、 公式の普通のパッケージ数を表します。
これは、他のパッケージの依存関係で使用された名称で、それが一対一に対応
するパッケージです。
大多数のパッケージはこのカテゴリに入ります。
o 純粋仮想パッケージは、
仮想パッケージ名としてのみ存在するパッケージ
(仮想パッケージ名のみを「提供」し、
実際にはいかなるパッケージもその名称を持たない)
の数を表します。 例えば、Debian GNU/Linux システムでは
"mail-transport-agent" は純粋仮想パッケージです。
"mail-transport-agent"
を提供するパッケージはいくつもありますが、
"mail-transport-agent" という名称のパッケージはありません。
o 単一仮想パッケージは、
特定の仮想パッケージ名を提供するパッケージが、
ただ一つの場合の数を表します。 例えば、Debian GNU/Linux
システムでは、"X11-text-viewer"
は仮想パッケージですが、"X11-text-viewer"
を提供するパッケージは、 xless パッケージのみということです。
o 複合仮想パッケージは、
その仮想パッケージ名を提供するパッケージが複数あるか、
またパッケージ名と同じ仮想パッケージ名を持つパッケージ数を表します。
例えば、Debian GNU/Linux システムでは、 debconf
は実際のパッケージ名でもありますが、 debconf-tiny
によって提供もされています。
o 欠落は、依存関係中には存在するのに、
どのパッケージにも提供されていないパッケージ名の数を表します。
このパッケージがあるということは、
全ディストリビューションにアクセスでい討い覆い、
(実ないし仮想)
パッケージがディストリビューションからはずされてしまった可能-
もあります。 通常では、構文が矛盾するとこのようになります。
o 個別バージョン総数は、 -
ャッシュに存在するパッケージのバージョンの数を表します。
そのため、この値は最小でもパッケージ名総数と一致します。
もし複数のディストリビューション (例 "stable" と "unstable"
の両方) を利用した場合、
この値はパッケージ名総数よりもかなり大いた瑤砲覆蠅泙后
o 依存関係総数は、 -
ャッシュにあるすべてのパッケージで要求された依存関係の数です。
showsrc pkg(s)
showsrc は、
指定したパッケージ名に一致するソースパッケージを、すべて表示します。
バイナリになるとい量松里鮴觚世靴織譽魁璽匹汎瑛佑法
すべてのバージョンについて表示します。
dump
dump は、 -
ャッシュ内のパッケージそれぞれについて、短い一覧を表示します。
主にデバッグ用です。
dumpavail
dumpavail は、 標準出力に利用可能なものの一覧を出力します。 dpkg(8)
と共に使用すると便利ですし、 dselect(8) でも使用されます。
unmet
unmet は、 パッケージゥ礇奪轡綟發砲△襦
不適当な依存関係の概要を表示します。
show pkg(s)
show は、 dpkg --print-avail と同様の機能を実行します。
これは、指定したパッケージのパッケージレコードの表示です。
search regex [ regex ... ]
search は、与えられた正規表現によって、
すべての利用可能なパッケージに対して全文検索を行います。
パッケージ名と説明に対して検索を行い、
パッケージ名と短い説明文を表示します。 --full
が与えられた場合、マッチしたパッケージに対し show
と同じ情報を出力します。 --names-only が与えられた場合は、
説明文に対して検索を行わず、パッケージ名に対してのみ対象とします。
空白で区切った引数で、 複数の検索パターンの and をとることがで-
ます。
depends pkg(s)
depends は、 パッケージが持っている依存関係と、
その依存関係を満たす他のパッケージの一覧を表示します。
rdepends pkg(s)
rdepends は、 パッケージが持つ被依存関係を一覧表示します。
pkgnames [ prefix ]
このコマンドは、 システムでの各パッケージの名称を表示します。
オプションの引数により、取得する一覧より先頭一致で抽出することがで-
ます。 この出力はシェルのタブによる補完機能に使いやすく、
また非常に速く生成されます。 このコマンドは --generate
オプションと共に使用すると、 非常に便利です。
dotty pkg(s)
dotty は、 コマンドライン上のパッケージ名から、 GraphViz[1]
パッケージの dotty コマンドで利用するのに便利な出力を生成します。
結果はパッケージの関係を表わす、ノード・エッジのセットで表現されます。
デフォルトでは、すべての依存パッケージをトレースするので、
非常に大いた泙得られます。 これは、APT::Cache::GivenOnly
オプションを設定して解除でい泙后
結果のノードは数種の形状をとります。
通常パッケージは四角、純粋仮想パッケージは三角、複合仮想パッケージは菱形、
六角形は欠落パッケージをそれぞれ表します。
オレンジの四角は再帰が終了した「リーフパッケージ」、青い線は先行依存、
緑の線は競合を表します。
注意) dotty は、 パッケージのより大い淵札奪箸離哀薀佞鷲舛韻泙擦鵝
policy [ pkg(s) ]
policy は、 設定ファイル関係の問題について、デバッグを支援します。
引数を指定しなかった場合、取得元ごとの優先順位を表示します。
一方、パッケージ名を指定した場合、 優先順の詳細情報を表示します。
madison /[ pkg(s) ]
apt-cache の madison コマンドは、Debian アーカイブ管理ツール
madison の機能のサブセットで、出力フォーマットを真似ようとします。
パッケージの利用可能バージョンを表形式で表示します。 オリジナルの
madison と違い、 APT がパッケージ一覧を検索したアーゥ謄チャ
(APT::Architecture) の情報を表示するだけです。
ン
この説明で示したオプションは、 すべて設定ファイルを使用して設定で-
ます。 設定ファイルに書いた真偽値をとるオプションは -f-,--no-f, -f=no
などのようにして上書い任ます。
-p, --pkg-cache
パッケージゥ礇奪轡紊魍頁爾垢襯侫．ぅ襪鯀択します。 パッケージ-
ャッシュは、すべての操作で使用される一次ゥ礇奪轡紊任后 設定項目 -
Dir::Cache::pkgcache
-s, --src-cache
ソースゥ礇奪轡紊魍頁爾垢襯侫．ぅ襪鯀択します。 このソース-
ャッシュは gencaches でのみ使用され、
ここに解析された取得元のパッケージ情報が格納されています。
パッケージゥ礇奪轡紊鮃獣曚垢觝櫃法▲宗璽好ャッシュは、
全パッケージファイルを再解析を避ける上で便利です。 設定項目 -
Dir::Cache::srcpkgcache
-q, --quiet
静粛 - 進捗表示を省略し、 ログをとるのに便利な出力を行います。 最大
2 つまで q を重ねることでさらに静粛にでい泙后 また、-q=#
のように静粛レベルを指定して、 設定ファイルを上書い垢襪海箸發任-
ます。 設定項目 - quiet
-i, --important
「重要」依存関係のみ表示 - unmet と共に使用します。
これは「依存」関係と「先行依存」関係のみを表示するためです。
設定項目 - APT::Cache::Important
-f, --full
search 時に全パッケージレコードを表示します。 設定項目 -
APT::Cache::ShowFull
-a, --all-versions
全利用可能バージョンのレコード全体を表示します。
これはデフォルトの動作で、 無効にするには --no-all-versions
を使用してください。 --no-all-versions を指定すると、
候補バージョン (インストールの際に選択されるもの) だけ表示します。
このオプションは、show コマンドでのみ適用でい泙后 設定項目 -
APT::Cache::AllVersions
-g, --generate
そのままゥ礇奪轡紊鮖藩僂垢襪里任呂覆、 自動的にパッケージ-
ャッシュを再生成します。これはデフォルトの動作で、 無効にするには
--no-generate を使用してください。 設定項目 - APT::Cache::Generate
--names-only, -n
説明文ではなく、パッケージ名からのみ検索します。 設定項目 -
APT::Cache::NamesOnly
--all-names
pkgnames で、
仮想パッケージや欠落依存関係を含めた全名称を表示します。 設定項目 -
APT::Cache::AllNames
--recurse
depends や rdepends
で、指定した全パッケージを再帰的に一度に表示します。 設定項目 -
APT::Cache::RecurseDepends
--installed
depends や rdepends の出力を、
現在インストールされているパッケージに限定します。 設定項目 -
APT::Cache::Installed
-h, --help
使い方の短い要約を表示します。
-v, --version
プログラムのバージョンを表示します。
-c, --config-file
設定ファイル。 使用する設定ファイルを指定します。
この設定ファイルが読めない場合はデフォルトの設定ファイルを読み込みます。
文法については apt.conf(5) を参照してください。
-o, --option
設定オプションのセット。任意の設定オプションをセットします。 文法は
-o Foo::Bar=bar となります。
ル
/etc/apt/sources.list
パッケージの取得元。 設定項目 - Dir::Etc::SourceList
/var/lib/apt/lists/
sources.list(5) に指定した、
パッケージリソースごとの状態情報格納エリア。 設定項目 -
Dir::State::Lists
/var/lib/apt/lists/partial/
取得中状態情報格納エリア。 設定項目 - Dir::State::Lists
(必然的に不完全)
目
apt.conf(5), sources.list(5), apt-get(8)
ジ
apt-cache は正常終了時に 0 を返します。 エラー時には十進の 100
を返します。
グ
APT _/usr/share/doc/debian/bug-reporting.txt や reportbug(1)
コマンドをご覧ください。
者
倉澤 望 <nabetaro@debian.or.jp> (2003-2006), Debian JP Documentation ML
<debian-doc@debian.or.jp>
AUTHORS
Jason Gunthorpe
Author.
APT team
Author.
NOTES
1. GraphViz
http://www.research.att.com/sw/tools/graphviz/
2. APT バグページ
http://bugs.debian.org/src:apt