source: projects/apt-rpm-manpages-ja/trunk/doc/ja/apt-cache.ja.8.sgml @ 6625

<!-- -*- mode: sgml; mode: fold -*- -->
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [

<!ENTITY % aptent SYSTEM "apt.ent.ja">
%aptent;

]>

<refentry>
 &apt-docinfo;
 
 <refmeta>
   <refentrytitle>apt-cache</refentrytitle>
   <manvolnum>8</manvolnum>
 </refmeta>
 
 <!-- Man page title -->
 <refnamediv>
    <refname>apt-cache</refname>
    <refpurpose>APT パッケージ操作ユーティリティ -- キャッシュ操作</refpurpose>
 </refnamediv>

 <!-- Arguments -->
 <refsynopsisdiv>
   <cmdsynopsis>
      <command>apt-cache</command>
      <arg><option>-hvsn</option></arg>
      <arg><option>-o=<replaceable>config string</replaceable></option></arg>
      <arg><option>-c=<replaceable>file</replaceable></option></arg>
      <group choice="req">
         <arg>add <arg choice="plain" rep="repeat"><replaceable>file</replaceable></arg></arg>
         <arg>gencaches</arg>
         <arg>showpkg <arg choice="plain" rep="repeat"><replaceable>pkg</replaceable></arg></arg>
         <arg>showsrc <arg choice="plain" rep="repeat"><replaceable>pkg</replaceable></arg></arg>
         <arg>stats</arg>
         <arg>dump</arg>
         <arg>dumpavail</arg>
         <arg>unmet</arg>
         <arg>search <arg choice="plain"><replaceable>regex</replaceable></arg></arg>
         <arg>show <arg choice="plain" rep="repeat"><replaceable>pkg</replaceable></arg></arg>
         <arg>depends <arg choice="plain" rep="repeat"><replaceable>pkg</replaceable></arg></arg>
         <arg>whatdepends <arg choice="plain" rep="repeat"><replaceable>pkg</replaceable></arg></arg>
         <arg>whatprovides <arg choice="plain" rep="repeat"><replaceable>capability</replaceable></arg></arg>
         <arg>pkgnames <arg choice="plain"><replaceable>prefix</replaceable></arg></arg>
         <arg>dotty <arg choice="plain" rep="repeat"><replaceable>pkg</replaceable></arg></arg>
         <arg>policy <arg choice="plain" rep="repeat"><replaceable>pkgs</replaceable></arg></arg>
      </group>   
   </cmdsynopsis>
 </refsynopsisdiv>

 <RefSect1><Title>説明</Title>
   <para>
   <command>apt-cache</command> は APT のパッケージキャッシュに対して、さまざまな操作を行います。
   <command>apt-cache</command> は、システム状態の操作は行いませんが、パッケージのメタデータより検索したり、興味深い出力を生成するといった操作を提供します。
   </para>
 
   <para>
   <option>-h</option> オプションや <option>--help</option> オプションを除き、以下に挙げるコマンドが必要です。

   <VariableList>
     <VarListEntry><Term>add <replaceable>file(s)</replaceable></Term>
     <ListItem><Para>
     <literal>add</literal> は、パッケージキャッシュに指定したパッケージインデックスファイルを追加します。デバッグ専用です。</Para></ListItem>
     </VarListEntry>
     
     <VarListEntry><Term>gencaches</Term>
     <ListItem><Para>
     <literal>gencaches</literal> は、<command>apt-get check</command> と同じ動作を提供します。
                 これは &sources-list; 内の取得元と <filename>/var/lib/rpm</filename> から、ソースとパッケージのキャッシュを構築します。</Para>
        <Para>
          &apt-get; コマンドや &synaptic; などではなく、rpm コマンドで直接パッケージのインストール、アンインストールを行った時に生まれる、rpm のデータベースと apt のデータベースの差を解消します。
     </Para></ListItem>
     </VarListEntry>

     <VarListEntry><Term>showpkg <replaceable>pkg(s)</replaceable></Term>
     <ListItem><Para>
     <literal>showpkg</literal> は、コマンドライン上に列挙したパッケージの情報を表示します。
後に続く引数はパッケージ名となります。
各パッケージについて、有効なバージョンと被依存関係を列挙し、さらにその各バージョンについて依存関係を表示します。
(通常の) 依存関係とは、対象のパッケージが依存しているパッケージを指します。
また、被依存関係とは、対象のパッケージに依存しているパッケージを指します。
従って、パッケージの依存関係は満たさなければなりませんが、被依存関係は満たす必要はありません。
実例として、以下に <command>apt-cache showpkg readline</command> の出力を示します。
</Para>
     
<informalexample><programlisting>
Package: readline
Versions: 
5.1-0vl1.i386(/var/state/apt/lists/updates.vinelinux.org_apt_4.1_i386_base_pkglist.main)(/var/lib/rpm/Packages)

Reverse Depends: 
  apt,readline 4.3
  guile,readline
  readline-devel,readline 5.1
  sqlite3,readline
  apt,readline 4.3
Dependencies: 
5.1-0vl1 - install-info (0 (null)) ldconfig (0 (null)) /bin/sh (0 (null)) /sbin/ldconfig (0 (null)) /bin/sh (0 (null)) libc.so.6 (0 (null)) libc.so.6(GLIBC_2.0) (0 (null)) libc.so.6(GLIBC_2.1.3) (0 (null)) libc.so.6(GLIBC_2.3) (0 (null)) 
Provides: 
5.1-0vl1 - readline libreadline.so.5 libhistory.so.5 
Reverse Provides: 
readline 5.1-0vl1
</programlisting></informalexample>
                            
     <Para>上の例の Dependencies: のところで、readline の version 5.1-0vl1 は、install-info, (/sbin/)ldconfig, /bin/sh, libc.so.6 と ncurses3.0 に依存していて、readline が動作するには、これらをインストールする必要があるということが判ります。
     </Para>
     <Para>一方、Reverse Depends: のところで、apt, guile, readline-devel, sqlite3 が readline に依存していることがわかります。
readline をインストールするためには、install-info, (/sbin/)ldconfig, libc.so.6, ncurses3.0 をすべてインストールしなければなりませんが、apt, guile, readline-devel, sqlite3 はインストールする必要はありません。
     </Para>
     <Para>Dependencies: や Provides: のところに、パッケージ名だけでなく「ファイル名」も入るのは、APT-RPM の仕様です。
パッケージ間の依存の処理で、「パッケージ名」ではなく「ファイル名」を指定しても処理できるように、ファイルもバーチャルパッケージとして登録されます。
     </Para></ListItem>
     </VarListEntry>

     <VarListEntry><Term>stats</Term>
     <ListItem><Para>
     <literal>stats</literal> はキャッシュについての統計情報を表示します。
それ以上、引数は必要ありません。
以下の統計情報を表示します。
     <itemizedlist>
       <listitem><para>
       <literal>パッケージ名</literal> は、キャッシュに存在するパッケージ数を表します。
       </para></listitem>
       
       <listitem><para>
       <literal>通常パッケージ</literal> は、公式の普通のパッケージ数を表します。
これは、他のパッケージの依存関係で使用された名称で、それが一対一に対応するパッケージです。
大多数のパッケージはこのカテゴリに入ります。
       </para></listitem>

       <listitem><para>
       <literal>純粋バーチャルパッケージ</literal> は、バーチャル(仮想)パッケージ名としてのみ存在するパッケージ (バーチャルパッケージ名のみを「提供」し、実際にはいかなるパッケージもその名称を持たない) の数を表します。
例えば、Vine Linux では "emacsen" は純粋バーチャルパッケージです。 "emacsen" を提供するパッケージは "emacs", "emacs22", "xemacs" などがありますが、"emacsen" という名称のパッケージはありません。
       </para></listitem>
   
       <listitem><para>
       <literal>単一バーチャルパッケージ</literal> は、特定のバーチャルパッケージ名を提供するパッケージがただ一つの場合の数を表します。
       </para></listitem>

<!-- TODO : 例としてあげるパッケージ名を探す。 -->

       <listitem><para>
       <literal>複合バーチャルパッケージ</literal> は、その仮想パッケージ名を提供するパッケージが複数あるか、またパッケージ名と同じ仮想パッケージ名を持つパッケージ数を表します。
       </para></listitem>

<!-- TODO : 例としてあげるパッケージ名を探す。 -->
   
       <listitem><para>
       <literal>不明</literal> は、依存関係中には存在するのに、どのパッケージにも提供されていないパッケージ名の数を表します。
このパッケージがあるということは、全ディストリビューションにアクセスできていないか、(実ないし仮想) パッケージがディストリビューションからはずされてしまった可能性もあります。
通常では、構文が矛盾するとこのようになります。
       </para></listitem>

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

       <listitem><para>
       <literal>合計依存数</literal> は、キャッシュにあるすべてのパッケージで要求された依存関係の数です。
       </para></listitem>

       <listitem><para>
       出力の残りの部分の意味については、apt のソースコードを調べてください。
       </para></listitem>

     </itemizedlist>
     </Para></ListItem>
     </VarListEntry>

     <VarListEntry><Term>showsrc <replaceable>pkg(s)</replaceable></Term>
     <ListItem><Para>
     <literal>showsrc</literal> は、指定したパッケージ名に一致するソースパッケージを、すべて表示します。
すべてのバージョンについて、パッケージ名だけではなく、<command>apt-cache show</command> の結果を表示します。
     </Para></ListItem>
     </VarListEntry>
     
     <VarListEntry><Term>dump</Term>
     <ListItem><Para>
     <literal>dump</literal> は、キャッシュ内のパッケージそれぞれについて、短い一覧を表示します。主にデバッグ用です。
     </Para></ListItem>
     </VarListEntry>

     <VarListEntry><Term>dumpavail</Term>
     <ListItem><Para>
     <literal>dumpavail</literal> は、標準出力に、利用可能なパッケージの一覧を出力します。
パッケージ名だけではなく、<command>apt-cache show</command> の結果を表示します。
     </Para></ListItem>
     </VarListEntry>

     <VarListEntry><Term>unmet</Term>
     <ListItem><Para>
     <literal>unmet</literal> は、パッケージキャッシュ内にある、解決不可能な依存関係の概要を表示します。
     </Para></ListItem>
     </VarListEntry>

     <VarListEntry><Term>show <replaceable>pkg(s)</replaceable></Term>
     <ListItem><Para>
     <literal>show</literal> は、指定したパッケージの情報を表示します。
各パッケージについて、パッケージ名、グループ名(Sectionと表示されます)、インストール時のサイズ、パッケージャー名、バージョン、依存情報(Depends,Pre-Depends)、提供情報(Provides)、アーキテクチャー、パッケージファイルのサイズ、MD5値、ファイル名、短い説明文(Summary)、説明(Description) を表示します。     
     </Para></ListItem>
     </VarListEntry>

     <VarListEntry><Term>search <replaceable>regex [ regex ... ]</replaceable></Term>
     <ListItem><Para>
     <literal>search</literal> は、与えられた正規表現によって、すべての利用可能なパッケージに対して全文検索を行います。
パッケージ名と説明(Description)に対して検索を行い、 パッケージ名と短い説明文(Summary)を表示します。</Para>
        <Para><option>--full</option> オプションをつけた場合は、マッチしたパッケージに対し apt-cache show と同じ情報を出力します。</Para>
        <Para><option>--names-only</option> オプションをつけた場合は、説明文に対しては検索を行わず、パッケージ名のみ対象とします。</Para><Para>
スペースで区切って引数を複数与えることで、複数の検索パターンの and をとることができます。
     </Para></ListItem>
     </VarListEntry>

     <VarListEntry><Term>depends <replaceable>pkg(s)</replaceable></Term>
     <ListItem><Para>
     <literal>depends</literal> は、パッケージが持っている依存情報(Depends,Pre-Depends)と、その依存関係を満たす他のパッケージの一覧を表示します。
     </Para><Para>
        &rpm; -qR と似た動作です。
     </Para></ListItem>
     </VarListEntry>

     <VarListEntry><Term>whatdepends <replaceable>pkg(s)</replaceable></Term>
     <ListItem><Para>
     <literal>whatdepends</literal> は、パッケージに依存しているパッケージの一覧を表示します。
     </Para><Para>
        &rpm; -q --whatrequires と似た動作です。
     </Para></ListItem>
     </VarListEntry>

     <VarListEntry><Term>whatprovides <replaceable>capability</replaceable></Term>
     <ListItem><Para>
     <literal>whatprovides</literal> は、引数で与えられたものを提供(Provides)するパッケージの一覧を表示します。
     </Para><Para>
        &rpm; -q --whatprovides と似た動作です。
     </Para></ListItem>
     </VarListEntry>


     <VarListEntry><Term>pkgnames <replaceable>[ prefix ]</replaceable></Term>
     <ListItem><Para>
このコマンドは、システムでの各パッケージの名称を表示します。
オプションの引数により、取得する一覧より先頭一致で抽出することができます。
この出力はシェルのタブによる補完機能に使いやすく、また非常に速く生成されます。
このコマンドは <option>--generate</option> オプションと共に使用すると、非常に便利です。
     </Para></ListItem>
     </VarListEntry>
     
     <VarListEntry><Term>dotty <replaceable>pkg(s)</replaceable></Term>
     <ListItem><Para>
     <literal>dotty</literal> は、コマンドライン上のパッケージ名から、graphviz パッケージ( http://www.research.att.com/sw/tools/graphviz/ ) の dotty コマンドで利用するのに便利な出力を生成します。
結果はパッケージの関係を表わす、ノード・エッジのセットで表現されます。
デフォルトでは、すべての依存パッケージをトレースするので、非常に大きな図が得られます。
これは、<literal>APT::Cache::GivenOnly</literal> を設定して解除できます。
     </Para><Para>
結果のノードは数種の形状をとります。
通常パッケージは四角、純粋仮想パッケージは三角、複合仮想パッケージは菱形、六角形は欠落パッケージをそれぞれ表します。
オレンジの四角は再帰が終了した「リーフパッケージ」、青い線は先行依存、緑の線は競合を表します。
     </Para><Para>
注意) dotty は、 パッケージのより大きなセットのグラフは描けません。
     </Para></ListItem>
     </VarListEntry>
     
     <VarListEntry><Term>policy <replaceable>[ pkg(s) ]</replaceable></Term>
     <ListItem><Para>
     <literal>policy</literal> は、設定ファイル関係の問題について、デバッグを支援します。
引数を指定しなかった場合、取得元ごとの優先順位を表示します。
一方、パッケージ名を指定した場合、優先順の詳細情報を表示します。
     </Para></ListItem>
     </VarListEntry>
   </VariableList>
   </para>
 </RefSect1>
 
 <RefSect1><Title>オプション</Title>
   &apt-cmdblurb;
   
   <VariableList>
     <VarListEntry><term><option>-p</option></term><term><option>--pkg-cache</option></term>
     <ListItem><Para>パッケージキャッシュを格納するファイルを選択します。
         パッケージキャッシュは、すべての操作で使用される一次キャッシュです。
         設定項目 <literal>Dir::Cache::pkgcache</literal>
     </Para></ListItem>
     </VarListEntry>

     <VarListEntry><term><option>-s</option></term><term><option>--src-cache</option></term>
     <ListItem><Para>
         ソースキャッシュを格納するファイルを選択します。
このソースキャッシュは <literal>gencaches</literal> でのみ使用され、ここに解析された取得元のパッケージ情報が格納されています。
ソースキャッシュは、パッケージキャッシュを構築する際に、全パッケージファイルの再解析を避ける上で便利です。
設定項目 <literal>Dir::Cache::srcpkgcache</literal>
     </Para></ListItem>
     </VarListEntry>

     <VarListEntry><term><option>-q</option></term><term><option>--quiet</option></term>
     <ListItem><Para>
メッセージの出力を抑制する - 進捗表示を省略し、ログをとるのに便利な出力を行います。
最大 2 つまで q を重ねることでより少なくできます。
また、オプション <option>-q=#</option> のように抑制レベルを指定して、設定ファイルの値を上書きすることもできます。
設定項目 <literal>quiet</literal>
     </Para></ListItem>
     </VarListEntry>

     <VarListEntry><term><option>-i</option></term><term><option>--important</option></term>
     <ListItem><Para>
「重要」依存関係のみ表示 - unmet と共に使用します。
これは「依存」関係と「先行依存」関係のみを表示するためです。
設定項目 <literal>APT::Cache::Important</literal>
     </Para></ListItem>
     </VarListEntry>

     <VarListEntry><term><option>-f</option></term><term><option>--full</option></term>
     <ListItem><Para>
search 時にパッケージの情報を全て表示します。
設定項目 <literal>APT::Cache::ShowFull</literal>
     </Para></ListItem>
     </VarListEntry>

     <VarListEntry><term><option>-a</option></term><term><option>--all-versions</option></term>
     <ListItem><Para>
全利用可能バージョンのパッケージの情報を全て表示します。
これはデフォルトの動作で、無効にするには <option>--no-all-versions</option> オプションを使用してください。
<option>--no-all-versions</option> オプション指定すると、候補バージョン (インストールの際に選択されるもの) だけ表示します。
このオプションは、<literal>show</literal> コマンドでのみ適用できます。 
設定項目 <literal>APT::Cache::AllVersions</literal>
     </Para></ListItem>
     </VarListEntry>

     <VarListEntry><term><option>-g</option></term><term><option>--generate</option></term>
     <ListItem><Para>
そのままキャッシュを使用するのではなく、自動的にパッケージキャッシュを再生成します。
これはデフォルトの動作で、無効にするには <option>--no-generate</option> オプションを使用してください。
設定項目 <literal>APT::Cache::Generate</literal>
     </Para></ListItem>
     </VarListEntry>

     <VarListEntry><term><option>--names-only</option></term><term><option>-n</option></term>
     <ListItem><Para>
説明文ではなく、パッケージ名からのみ検索します。
ただし、APT-RPM では、ファイル名もバーチャルパッケージとして登録されるため検索対象となっています。
設定項目 <literal>APT::Cache::NamesOnly</literal>
     </Para></ListItem>
     </VarListEntry>

     <VarListEntry><term><option>--all-names</option></term>
     <ListItem><Para>
<literal>pkgnames</literal> で、仮想パッケージや欠落依存関係を含めた全名称を表示します。
     設定項目 <literal>APT::Cache::AllNames</literal>
     </Para></ListItem>
     </VarListEntry>

     <VarListEntry><term><option>--recurse</option></term>
     <ListItem><Para>
     <literal>depends</literal> や <literal>rdepends</literal> で指定した全パッケージを再帰的に一度に表示します。
     設定項目 <literal>APT::Cache::RecurseDepends</literal>
     </Para></ListItem>
     </VarListEntry>

     &apt-commonoptions;
     
   </VariableList>
 </RefSect1>

 <RefSect1><Title>ファイル</Title>
   <variablelist>
     <VarListEntry><term><filename>/etc/apt/sources.list</filename></term>
     <ListItem><Para>
パッケージの取得元。
設定項目 <literal>Dir::Etc::SourceList</literal>
     </Para></ListItem>
     </VarListEntry>
     
     <VarListEntry><term><filename>&statedir;/lists/</filename></term>
     <ListItem><Para>
&sources-list; のパッケージリソースごとの状態情報格納ディレクトリ。 設定項目 <literal>Dir::State::lists</literal>
     設定項目 <literal>Dir::State::Lists</literal>
     </Para></ListItem>
     </VarListEntry>
  
     <VarListEntry><term><filename>&statedir;/lists/partial/</filename></term>
     <ListItem><Para>
取得"中"の状態情報格納エリア。 設定項目 <literal>Dir::State::lists</literal> (取得"済み"の状態情報格納ディレクトリ に partial というサブディレクトリが作られます。)
     </Para></ListItem>
     </VarListEntry>     
   </variablelist>
 </RefSect1>

 <RefSect1><Title>関連項目</Title>
   <para>
   &apt-conf;, &sources-list;, &apt-get; &rpm;
   </para>
 </RefSect1>

 <RefSect1><Title>診断メッセージ</Title>
   <para>
   <command>apt-cache</command> は正常終了時に 0 を返します。エラー時には十進の 100 を返します。
   </para>
 </RefSect1>

 &manbugs;
 &manauthor;
</refentry>

<!--
                Local Variables:
                mode: nxml
                End:
-->