APT-CACHE(8) APT APT-CACHE(8) 名前 apt-cache - APT キャッシュへの問い合わせ 概要 apt-cache [-agipns] [-o=設定文字列] [-c=設定ファイル] {gencaches | showpkg パッケー ジ... | showsrc パッケージ... | stats | dump | dumpavail | unmet | search 正規表現... | show パッケージ [{=パッケージバージョン番号 | /対象リリース}]... | depends パッケージ [{=パッケージバージョン番号 | /対象リリース}]... | rdepends パッ ケージ [{=パッケージバージョン番号 | /対象リリース}]... | pkgnames [prefix] | dotty パッケージ [{=パッケージバージョン番号 | /対象リリース}]... | xvcg パッケー ジ [{=パッケージバージョン番号 | /対象リリース}]... | policy [パッケージ...] | madison パッケージ... | {-v | --version} | {-h | --help}} 説明 apt-cache は APT のパッケージキャッシュに対して、さまざまな操作を行います。apt-cache は、システム状態の操作は行いませ んが、パッケージのメタデータを検索したり、興味深い出力を生成するといった操作を提供します。メタデータは、例えば apt-get の 'update' コマンドで取得して更新します。そのため、最後の更新が古すぎる場合は、時代遅れです。ただし、引き換えに apt-cache は、設定された取得元の可用性とは独立して動作します (例えばオフライン)。 -h オプションや --help オプションを除き、以下に挙げるコマンドが必要です。 gencaches gencaches は APT のパッケージキャッシュを作成します。このキャッシュが見つからない、または古くなっている場合、キャッシュ を必要とするすべてのコマンドによって、暗黙で実行されます。 showpkg パッケージ... 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 パッケージ... showsrc は、指定したパッケージ名に一致するソースパッケージを、すべて表示します。バイナリパッケージになるときの名称を宣言したレ コードとともに、すべてのバージョンについて表示します。ソースパッケージ名だけを表示するには、--only-source を使用してくだ さい。 dump dump は、キャッシュ内のパッケージそれぞれについて、短い一覧を表示します。主にデバッグ用です。 dumpavail dumpavail は、標準出力に利用可能なものの一覧を出力します。 dpkg(1) と共に使用すると便利ですし、dselect(1) でも使用されます。 unmet unmet は、パッケージキャッシュ内にある、不適当な依存関係の概要を表示します。 show パッケージ... show は、dpkg --print-avail と同様の機能を実行します。これは、指定したパッケージのパッケージレコードの表示で す。 search 正規表現... search は、与えられた POSIX の正規表現 (regex(7) を参照) により、すべての利用可能なパッケージに対して全文検 索を行います。パッケージ名と説明に対して正規表現で検索を行い、パッケージ名 (仮想パッケージ名を含む) と短い説明文を表示しま す。--full が与えられた場合、マッチしたパッケージに対し show と同じ情報を出力します。--names-only が与えられ た場合は、長い説明文に対して検索を行わず、パッケージ名と提供されたパッケージのみ対象とします。 空白で区切った引数で、複数の検索パターンの and をとることができます。 depends パッケージ... depends は、パッケージが持っている依存関係と、その依存関係を満たす他のパッケージの一覧を表示します。 rdepends パッケージ... rdepends は、パッケージが持つ被依存関係を一覧表示します。 pkgnames [prefix] このコマンドは、APT が知っている各パッケージの名前を表示します。オプション引数は、名前一覧から先頭一致で抽出します。この出力はシェ ルのタブによる補完機能で使いやすく、また非常に高速に生成されます。このコマンドは --generate オプションと共に使用すると非常 に便利です。 APT が知っているパッケージは、ダウンロード可能、インストール可能、インストール済みである必要がないことに注意してください。つま り、仮想パッケージも生成した一覧にあります。 dotty パッケージ... dotty は、コマンドライン上のパッケージ名から、GraphViz[1] パッケージの dotty コマンドで利用するのに便利な出力 を生成します。結果はパッケージの関係を表わす、ノード・エッジのセットで表現されます。デフォルトでは、すべての依存パッケージをトレースす るので、非常に大きい図が得られます。コマンドラインに列挙したパッケージだけを出力するように制限するに は、APT::Cache::GivenOnly をセットしてください。 結果のノードは数種の形状をとります。通常パッケージは四角、純粋仮想パッケージは三角、複合仮想パッケージは菱形、欠落パッケージは六角形で 表します。オレンジの四角は再帰が終了した「リーフパッケージ」、青い線は先行依存、緑の線は競合を表します。 注意) dotty は、パッケージのより大きなセットのグラフは描けません。 xvcg パッケージ... dotty と同様ですが、VCG tool[2] の xvcg 専用です。 policy [パッケージ...] policy は、プリファレンスファイル関係の問題について、デバッグを支援します。引数を指定しなかった場合、取得元ごとの優先順位を表示 します。一方、パッケージ名を指定した場合、優先順の詳細情報を表示します。 madison パッケージ... 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 --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 ファイル名 メタ情報のソースとして指定したファイルを追加します。指定を繰り返すと複数のファイルを追加できます。現在サポートしているのは *.deb、*.dsc、*.changes、Sources、Packages ファイル並びにソースパッケージのディレクトリです。ファイ ルとの照合はファイル名だけを基にして行い、ファイルの内容との照合は行いません! Sources 及び Packages は正しい拡張子を付けていれば APT がサポートする任意の形式で圧縮できます。このファイルを同 じディレクトリに複数置く必要がある場合は、自分が付ける名前の部分の最後尾にアンダースコア (「_」) を付加したものを先頭に付けま す。例: my.example_Packages.xz これによって指定したソースは信頼できるものとして扱われる (apt-secure(8) 参照) ことに注意してください。設定項目: APT::Sources::With -h, --help 使い方の短い要約を表示します。 -v, --version プログラムのバージョンを表示します。 -c, --config-file 設定ファイル。 使用する設定ファイルを指定します。 このプログラムは、デフォルト設定ファイルを読んでから、この設定ファイルを読みます。 この設定をデフォルト設定ファイルよりも前に読む必要がある場合、 APT_CONFIG 環境変数に指定してください。構文については apt.conf(5) をご覧ください。 -o, --option 設定オプションのセット。任意の設定オプションをセットします。 構文 -o Foo::Bar=bar となります。 異なるオプションを設 定するため、-o と --option は、 複数回使用できます。 ファイル /etc/apt/sources.list パッケージ取得元の場所。 設定項目: Dir::Etc::SourceList /etc/apt/sources.list.d/ パッケージ取得元の場所のファイル断片 設定項目: Dir::Etc::SourceParts /var/lib/apt/lists/ sources.list(5) に指定した、パッケージリソースごとの状態情報格納エリア。 設定項目: Dir::State::Lists /var/lib/apt/lists/partial/ 取得中状態情報格納エリア。 設定項目: Dir::State::Lists (暗黙で 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-2012), Takuma Yamada <tyamada@takumayamada.com> (2016), Debian JP Documentation ML <debian-doc@debian.or.jp> この翻訳文書には未訳部分が含まれている可能性があることに 注意してください。 翻訳がオリジナルに追従できていない場合、 内容を失わないようにこ のようにしています。 著者 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 バグページ http://bugs.debian.org/src:apt APT 2.6.1 04 4 月 2019 APT-CACHE(8)
Generated by dwww version 1.15 on Mon Jul 1 05:51:16 CEST 2024.