APT-CACHE(8)

February 2004

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

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

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

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

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

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

        • Missing is the number of package names that were referenced in a dependency but were not provided by any package. Missing packages may be an evidence if a full distribution is not accessed, or if a package (real or virtual) has been dropped from the distribution. Usually they are referenced from Conflicts or Breaks statements.

        • 個別バージョン総数は、キャッシュに存在するパッケージのバージョンの数を表します。そのため、この値は最小でもパッケージ名総数と一致します。もし複数のディストリビューション (例 "stable" と "unstable" の両方) を利用した場合、この値はパッケージ名総数よりもかなり大きい数になります。

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

showsrc pkg(s)
    showsrc は、指定したパッケージ名に一致するソースパッケージを、すべて表示します。バイナリになるときの名称を宣言したレコードと同様に、すべてのバージョンについて表示します。

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

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

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

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

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

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

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

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

pkgnames [ prefix ]
    This command prints the name of each package APT knows. The optional argument is a prefix match to filter the name list. The output is suitable for use in a shell tab complete function and the output is generated extremely quickly. This command is best used with the --generate option.

    Note that a package which APT knows of is not necessarily available to download, installable or installed, e.g. virtual packages are also listed in the generated list.

dotty pkg(s)
    dotty は、コマンドライン上のパッケージ名から、GraphViz[1] パッケージの dotty コマンドで利用するのに便利な出力を生成します。結果はパッケージの関係を表わす、ノード・エッジのセットで表現されます。デフォルトでは、すべての依存パッケージをトレースするので、非常に大きい図が得られます。これは、APT::Cache::GivenOnly オプションを設定して解除できます。

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

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

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

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 や depends と共に使用します。これは「依存」関係と「先行依存」関係のみを表示するためです。設定項目 - 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 となります。 異なるオプションを設定するため、-o と --option は、 複数回使用できます。

ファイル

/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 (implicit partial).

関連項目

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

診断メッセージ

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

バグ

APT バグページ[3] をご覧ください。 APT のバグを報告する場合は、 /usr/share/doc/debian/bug-reporting.txt や reportbug(1) コマンドをご覧ください。

訳者

倉澤 望 nabetaro@debian.or.jp (2003-2006,2009), Debian JP Documentation ML debian-doc@debian.or.jp

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.

AUTHORS

Jason Gunthorpe

APT team

NOTES

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 バグページ
    http://bugs.debian.org/src:apt