APT−CACHE

名前

apt-cache − APT キャッシュへの問い合わせ

概要

apt−cache [−agipns] [−o=config_string] [−c=config_file] {gencaches | showpkg pkg... | showsrc pkg... | stats | dump | dumpavail | unmet | search regex... | show pkg [{=pkg_version_number | /target_release}]... | depends pkg [{=pkg_version_number | /target_release}]... | rdepends pkg [{=pkg_version_number | /target_release}]... | pkgnames [prefix] | dotty pkg [{=pkg_version_number | /target_release}]... | xvcg pkg [{=pkg_version_number | /target_release}]... | policy [pkg...] | madison pkg... | {−v | −−version} | {−h | −−help}}

説明

apt−cache は APT のパッケージキャッシュに対して、さまざまな操作を行います。apt−cache は、システム状態の操作は行いませんが、パッケージのメタデータを検索したり、興味深い出力を生成するといった操作を提供します。メタデータは、例えば apt−get の 'update' コマンドで取得して更新します。そのため、最後の更新が古すぎる場合は、時代遅れです。ただし、引き換えに apt−cache は、設定された取得元の可用性とは独立して動作します (例えばオフライン)。

−h オプションや −−help オプションを除き、以下に挙げるコマンドが必要です。

gencaches

gencaches は APT のパッケージキャッシュを作成します。このキャッシュが見つからない、または古くなっている場合、キャッシュを必要とするすべてのコマンドによって、暗黙で実行されます。

showpkg pkg...

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 はキャッシュについての統計情報を表示します。それ以上、引数は必要ありません。以下の統計情報を表示します。

• パッケージ名総数は、キャッシュに存在するパッケージ数を表します。

• 通常パッケージは、公式の普通のパッケージ数を表します。これは、他のパッケージの依存関係で使用された名称で、それが一対一に対応するパッケージです。大多数のパッケージはこのカテゴリに入ります。

• 純粋仮想パッケージは、仮想パッケージ名としてのみ存在するパッケージ (仮想パッケージ名のみを「提供」し、実際にはいかなるパッケージもその名称を持たない) の数を表します。例えば、Debian システムでは "mail−transport−agent" は純粋仮想パッケージです。"mail−transport−agent" を提供するパッケージはいくつもありますが、"mail−transport−agent" という名前のパッケージはありません。

• 単一仮想パッケージは、特定の仮想パッケージ名を提供するパッケージが、ただ一つの場合の数を表します。例えば、Debian システムでは、"X11−text−viewer" は仮想パッケージですが、"X11−text−viewer" を提供するパッケージは、xless パッケージのみということです。

• 複合仮想パッケージは、その仮想パッケージ名を提供するパッケージが複数あるか、またパッケージ名と同じ仮想パッケージ名を持つパッケージの数を表します。例えば、Debian システムでは、"debconf" は実際のパッケージ名でもありますが、debconf−tiny によって提供もされています。

• 欠落は、依存関係中には存在するのに、どのパッケージにも提供されていないパッケージ名の数を表します。欠落パッケージは、全ディストリビューションにアクセスできていないか、(実ないし仮想) パッケージがディストリビューションからはずされたという兆候かもしれません。通常、構文が競合や破損するとこのようになります。

• 個別バージョン総数は、キャッシュに存在するパッケージのバージョンの数を表します。もし複数のディストリビューション (例えば "stable" と "unstable") にアクセスする場合、この値はパッケージ名総数よりもかなり大きい数になります。

• 依存関係総数は、キャッシュにあるすべてのパッケージで要求された依存関係の数です。

showsrc pkg...

showsrc は、指定したパッケージ名に一致するソースパッケージを、すべて表示します。バイナリパッケージになるときの名称を宣言したレコードとともに、すべてのバージョンについて表示します。ソースパッケージ名だけを表示するには、−−only−source を使用してください。

dump

dump は、キャッシュ内のパッケージそれぞれについて、短い一覧を表示します。主にデバッグ用です。

dumpavail

dumpavail は、標準出力に利用可能なものの一覧を出力します。 dpkg(1) と共に使用すると便利ですし、dselect(1) でも使用されます。

unmet

unmet は、パッケージキャッシュ内にある、不適当な依存関係の概要を表示します。

show pkg...

show は、dpkg −−print−avail と同様の機能を実行します。これは、指定したパッケージのパッケージレコードの表示です。

search regex...

search は、与えられた POSIX の正規表現 (regex(7) を参照) により、すべての利用可能なパッケージに対して全文検索を行います。パッケージ名と説明に対して正規表現で検索を行い、パッケージ名 (仮想パッケージ名を含む) と短い説明文を表示します。−−full が与えられた場合、マッチしたパッケージに対し show と同じ情報を出力します。−−names−only が与えられた場合は、長い説明文に対して検索を行わず、パッケージ名と提供されたパッケージのみ対象とします。

空白で区切った引数で、複数の検索パターンの and をとることができます。

depends pkg...

depends は、パッケージが持っている依存関係と、その依存関係を満たす他のパッケージの一覧を表示します。

rdepends pkg...

rdepends は、パッケージが持つ被依存関係を一覧表示します。

pkgnames [prefix]

このコマンドは、APT が知っている各パッケージの名前を表示します。オプション引数は、名前一覧から先頭一致で抽出します。この出力はシェルのタブによる補完機能で使いやすく、また非常に高速に生成されます。このコマンドは −−generate オプションと共に使用すると非常に便利です。

APT が知っているパッケージは、ダウンロード可能、インストール可能、インストール済みである必要がないことに注意してください。つまり、仮想パッケージも生成した一覧にあります。

dotty pkg...

dotty は、コマンドライン上のパッケージ名から、GraphViz [1] パッケージの dotty コマンドで利用するのに便利な出力を生成します。結果はパッケージの関係を表わす、ノード・エッジのセットで表現されます。デフォルトでは、すべての依存パッケージをトレースするので、非常に大きい図が得られます。コマンドラインに列挙したパッケージだけを出力するように制限するには、APT::Cache::GivenOnly をセットしてください。

結果のノードは数種の形状をとります。通常パッケージは四角、純粋仮想パッケージは三角、複合仮想パッケージは菱形、欠落パッケージは六角形で表します。オレンジの四角は再帰が終了した「リーフパッケージ」、青い線は先行依存、緑の線は競合を表します。

注意) dotty は、パッケージのより大きなセットのグラフは描けません。

xvcg pkg...

dotty と同様ですが、VCG tool [2] の xvcg 専用です。

policy [pkg...]

policy は、プリファレンスファイル関係の問題について、デバッグを支援します。引数を指定しなかった場合、取得元ごとの優先順位を表示します。一方、パッケージ名を指定した場合、優先順の詳細情報を表示します。

madison pkg...

apt−cache の madison コマンドは、Debian アーカイブ管理ツール madison の機能のサブセットで、出力フォーマットを真似ようとします。パッケージの利用可能バージョンを表形式で表示します。オリジナルの madison と違い、APT がパッケージ一覧を検索したアーキテクチャ (APT::Architecture) の情報を表示するだけです。

オプション

All command line options may be set using the configuration file, the descriptions indicate the configuration option to set. For boolean options you can override the config file by using something like −f−,−−no−f, −f=no or several other variations.

−p, −−pkg−cache

パッケージキャッシュを格納するファイルを選択します。パッケージキャッシュは、すべての操作で使用される一次キャッシュです。設定項目: Dir::Cache::pkgcache

−s, −−src−cache

ソースキャッシュを格納するファイルを選択します。このソースキャッシュは gencaches でのみ使用され、ここに解析された取得元のパッケージ情報が格納されています。パッケージキャッシュを構築する際に、全パッケージファイルの再解析を避けるために、ソースキャッシュが使われます。設定項目: Dir::Cache::srcpkgcache

−q, −−quiet

静粛 − 進捗表示を省略し、ログをとるのに便利な出力を行います。最大 2 つまで q を重ねることでさらに静粛にできます。また、−q=# のように静粛レベルを指定して、設定ファイルを上書きすることもできます。設定項目: quiet

−i, −−important

「重要」依存関係のみ表示 − unmet や depends と共に使用し、「依存」関係と「先行依存」関係のみを表示します。設定項目: APT::Cache::Important

−−no−pre−depends, −−no−depends, −−no−recommends, −−no−suggests, −−no−conflicts, −−no−breaks, −−no−replaces, −−no−enhances

デフォルトでは depends や rdepends は全依存関係を出力します。この挙動を、ここに挙げたフラグで指定した依存関係を省略できます。設定項目: APT::Cache::Show依存関係タイプ 例: APT::Cache::ShowRecommends

−−implicit

デフォルトでは depends や rdepends はメタデータ中に明示的に表現された依存関係のみを出力します。このフラグを指定すると、遭遇したデータにもとづいて追加の依存関係を表示します。Conflicts: foo は、例えば、このパッケージがほかのアーキテクチャからのパッケージ foo と競合していることを暗黙的に表現しています。設定項目: APT::Cache::ShowImplicit

−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

−−with−source filename

メタ情報のソースとして指定したファイルを追加します。指定を繰り返すと複数のファイルを追加できます。現在サポートしているのは *.deb、*.dsc、*.changes、Sources、Packages ファイル並びにソースパッケージのディレクトリです。ファイルとの照合はファイル名だけを基にして行い、ファイルの内容との照合は行いません!

Sources 及び Packages は正しい拡張子を付けていれば APT がサポートする任意の形式で圧縮できます。このファイルを同じディレクトリに複数置く必要がある場合は、自分が付ける名前の部分の最後尾にアンダースコア (「_」) を付加したものを先頭に付けます。例: my.example_Packages.xz

これによって指定したソースは信頼できるものとして扱われる (apt-secure(8) 参照) ことに注意してください。設定項目: APT::Sources::With

−h, −−help

Show a short usage summary.

−v, −−version

Show the program version.

−c, −−config−file

Configuration File; Specify a configuration file to use. The program will read the default configuration file and then this configuration file. If configuration settings need to be set before the default configuration files are parsed specify a file with the APT_CONFIG environment variable. See apt.conf(5) for syntax information.

−o, −−option

Set a Configuration Option; This will set an arbitrary configuration option. The syntax is −o Foo::Bar=bar. −o and −−option can be used multiple times to set different options.

ファイル

/etc/apt/sources.list

Locations to fetch packages from. Configuration Item: Dir::Etc::SourceList.

/etc/apt/sources.list.d/

File fragments for locations to fetch packages from. Configuration Item: Dir::Etc::SourceParts.

/var/lib/apt/lists/

Storage area for state information for each package resource specified in sources.list(5) Configuration Item: Dir::State::Lists.

/var/lib/apt/lists/partial/

Storage area for state information in transit. Configuration Item: Dir::State::Lists (partial will be implicitly appended)

関連項目

apt.conf(5), sources.list(5), apt-get(8)

診断メッセージ

apt−cache は正常終了時に 0 を返します。エラー時には十進の 100 を返します。

BUGS

APT bug page [3] . If you wish to report a bug in APT, please see /usr/share/doc/debian/bug−reporting.txt or the reportbug(1) command.

TRANSLATION

The english translation was done by John Doe <john@doe.org> in 2009, 2010 and Daniela Acme <daniela@acme.us> in 2010 together with the Debian Dummy l10n Team <debian−l10n−dummy@lists.debian.org>.

Note that this translated document may contain untranslated parts. This is done on purpose, to avoid losing content when the translation is lagging behind the original content.

著者

Gunthorpe Jason[FAMILY Given]

[FAMILY Given]

注記

1.

GraphViz

http://www.research.att.com/sw/tools/graphviz/

2.

VCG tool

http://rw4.cs.uni-sb.de/users/sander/html/gsvcg1.html

3.

APT bug page

http://bugs.debian.org/src:apt