source: projects/apt-rpm-manpages-ja/trunk/doc/ja/apt_preferences.ja.5.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_preferences</refentrytitle>
                <manvolnum>5</manvolnum>
        </refmeta>
        
        <!-- Man page title -->
        <refnamediv>
                <refname>apt_preferences</refname>
                <refpurpose>APT 設定制御ファイル</refpurpose>
        </refnamediv>
        
        <RefSect1>
                <Title>説明</Title>
                <para>
                        APT 設定ファイル <filename>/etc/apt/preferences</filename> は、インストールするパッケージのバージョン選択を制御するのに使用します。
                </para>
                
                <para>
                        &sources-list; ファイルに複数のディストリビューション (例 <literal>stable</literal> と <literal>testing</literal>) が指定されていて、パッケージに対し複数のバージョンがインストールできることがあります。
                        このとき APT は、利用できるバージョンごとに優先度を割り当てます。
                        依存関係規則を条件として、<command>apt-get</command> は、最も高い優先度を持つバージョンをインストールするよう選択します。
                        APT 設定ファイルは、APT がデフォルトで割り当てた、パッケージのバージョンの優先度を上書きします。
                        その結果、インストールするものの選択を、ユーザが選択できるようになります。
                </para>
                <para>
                        &sources-list; ファイルに複数のダウンロードサイトが書かれている場合、パッケージの同じバージョンのファイルが複数利用できる可能性があります。
                        この場合、<command>apt-get</command> は &sources-list; ファイルの初めの方に指定されているところからダウンロードします。
                        APT 設定ファイルは、バージョンの選択にのみ影響し、ダウンロードサイトの選択には影響しません。
                </para>
                

                <RefSect2><Title>APT のデフォルト優先度の割り当て</Title>
                
                <para>
                        設定ファイルがなかったり、設定ファイルに、特定のパッケージを割り当てるエントリがない場合、そのバージョンの優先度は、そのバージョンが属しているディストリビューションの優先度となります。
                        デフォルトで他のディストリビューションより高い優先度を持つ、特定のディストリビューションを「ターゲットリリース」としておくのは可能です。
                        ターゲットリリースは、<command>apt-get</command> のコマンドラインで設定したり、APT 設定ファイル <filename>/etc/apt/apt.conf</filename> で設定したりできます。
                        例えば以下のようになります。
                        <programlisting>
                                <command>apt-get install -t testing <replaceable>some-package</replaceable></command>
                        </programlisting>
                        <programlisting>
                                APT::Default-Release "stable";
                        </programlisting>
                </para>
                
                <para>
                        ターゲットリリースが指定されると、APT は以下のアルゴリズムで、パッケージのバージョンの優先度を設定します。
                        このように割り当てます。
                        <variablelist>
                                <varlistentry>
                                        <term>優先度(priority) 100</term>
                                        <listitem><simpara>(あるならば) 既にインストールされているバージョン。(RPM Database)</simpara></listitem>
                                </varlistentry>
                                <varlistentry>
                                        <term>優先度 500</term>
                                        <listitem><simpara>インストールされておらず、ターゲットリリースに含まれないバージョン。</simpara></listitem>
                                </varlistentry>
                                <varlistentry>
                                        <term>優先度 990</term>
                                        <listitem><simpara>インストールされておらず、ターゲットリリースに含まれるバージョン。</simpara></listitem>
                                </varlistentry>
                        </variablelist>
                </para>
                
                <para>
                ターゲットリリースが指定されていなければ、APT は単純にインストールしているパッケージのバージョンには 100 を、インストールしていないパッケージのバージョンには 500 を割り当てます。</para>
                
                <para>
                        APT は、インストールするパッケージのバージョンを決定するために、 以下のルールを上から順番に適用します。
                        <itemizedlist>
                                <listitem><simpara>有効なバージョンの優先度が 1000 を越えない場合、決してダウングレードしません。
                                (「ダウングレード」は、現在のパッケージのバージョンよりも、小さいバージョンのものをインストールします。APT のデフォルト優先度が 1000 を越えないことに注意してください。そのような優先度は設定ファイルでのみ設定できます。また、パッケージのダウングレードは危険であることにも注意してください)</simpara></listitem>
                                <listitem><simpara>最も高い優先度のバージョンをインストールします。</simpara></listitem>
                                <listitem><simpara>同じ優先度のバージョンが複数存在する場合、最も新しいもの (最もバージョン番号が高いもの) をインストールします。</simpara></listitem>
                                <listitem><simpara>優先度・バージョン番号が同じものが複数存在し、そのパッケージのメタデータが異なるか <literal>--reinstall</literal> オプションが与えられている場合、インストールされていないものをインストールします。</simpara></listitem>
                        </itemizedlist>
                </para>
                
                <para>
                        よくある状況として、あるインストールされているパッケージのバージョン (優先度 100) が、&sources-list; ファイルのリストから得られるバージョン (優先度 500 か 990) よりも新しくないということがあります。
                        この場合、<command>apt-get install <replaceable>some-package</replaceable></command> や <command>apt-get upgrade</command> を実行するとパッケージが更新されます。
                </para>

                <para>
                        まれに、インストールされているパッケージのバージョンが、<emphasis>他の有効なバージョンよりも新しい</emphasis>場合があります。
                        この時 <command>apt-get install <replaceable>some-package</replaceable></command> や <command>apt-get upgrade</command> を実行しても、ダウングレードしません。
                </para>

                <para>
                        時々、インストールしているパッケージのバージョンが、ターゲットリリースに属するバージョンよりも新しく、他のディストリビューションよりも古い場合があります。
                        そのようなパッケージに対して <command>apt-get install <replaceable>some-package</replaceable></command> や <command>apt-get upgrade</command> を実行すると、パッケージは更新されます。

                        この場合、インストールされているバージョンよりも、少なくとも<emphasis>ひとつ</emphasis>は、高い優先度を持つ有効なパッケージがあるからです。
                </para>

                </RefSect2>

                <RefSect2>
                        <Title>パッケージのバージョンとディストリビューションプロパティの決定</Title>
                        <para>
                        &sources-list; ファイルに列挙した場所では、その場所で利用できるパッケージを記述した、<filename>release</filename> ファイル、<filename>release.<replaceable>component</replaceable></filename> ファイル、<filename>pkglist.<replaceable>component</replaceable>.bz2</filename> ファイルなどを提供します。</para>
                        <para>
                                これらのファイルについては、&genbasedir; コマンドのマニュアルでも説明していますので参照してください。
                        </para>
                        
                        <para>
                                これらのファイルは通常 <filename><replaceable>baseuri</replaceable>/<replaceable>distribution</replaceable>/&lt;architecture&gt;/base</filename> ディレクトリにあります。
                        </para>
                        <para>
                                また、パッケージは、通常 <filename><replaceable>baseuri</replaceable>/<replaceable>distribution</replaceable>/&lt;architecture&gt;/RPMS.<replaceable>component</replaceable></filename> ディレクトリにあります。
                                複数のコンポーネントがある場合、<filename><replaceable>baseuri</replaceable>/<replaceable>distribution</replaceable>/&lt;architecture&gt;/RPMS.<replaceable>component2</replaceable></filename> のようなディレクトリもあります。
                        </para>
                        <para>
                                それぞれ、具体的な例を挙げれば
                                <filename>release</filename>ファイルなどは、<literal>http://updates.vinelinux.org/apt/&Vine-linux-release-version;/i386/base/</literal>に、パッケージは、<literal>http://updates.vinelinux.org/apt/&Vine-linux-release-version;/i386/RPMS.main/</literal>
                                 にあります。
                        </para>

                        <para>
                                <filename>release</filename> ファイルは、どのようなコンポーネントがあるか、また、<filename>release.<replaceable>component</replaceable></filename> ファイルや <filename>pkglist.<replaceable>component</replaceable>.bz2</filename> ファイルの具体的なファイル名の情報などを含んでいます。
                        </para>
                        <para>
                                この情報をもとに、<filename>release.<replaceable>component</replaceable></filename> や、<filename>pkglist.<replaceable>component</replaceable>.bz2</filename> といったファイルを取得します。
                        </para>

                        <para>
                                <filename>pkglist.<replaceable>component</replaceable>.bz2</filename> ファイルは、<filename><replaceable>baseuri</replaceable>/<replaceable>distribution</replaceable>/&lt;architecture&gt;/RPMS.<replaceable>component</replaceable></filename> ディレクトリにある利用可能パッケージごとに、パッケージ名、パッケージのバージョン番号、依存情報など様々な情報を含んでいます。(このファイルは純粋なテキストファイルではありません。)
                        </para>
                        <para>
                                <filename>pkglist.<replaceable>component</replaceable>.bz2</filename> ファイルからは、<literal>パッケージ名</literal> と <literal>パッケージのバージョン番号</literal> といった情報が利用されます。
                        </para>

                        <para>
                                <filename>release.<replaceable>component</replaceable></filename> ファイルは、ディレクトリ <filename><replaceable>baseuri</replaceable>/<replaceable>distribution</replaceable>/&lt;architecture&gt;/RPMS.<replaceable>component</replaceable></filename> 以下にある<emphasis>全パッケージ</emphasis>(コンポーネントの全パッケージ)に適用する、複数行のレコードから成っています。
                        </para>
                        
                        <para>
                                <filename>release.<replaceable>component</replaceable></filename> ファイルは、ほとんどの行が APT 優先度の設定に関連します。
                        </para>

                        <para>
                                <filename>release.<replaceable>component</replaceable></filename> ファイルの内容は、<command>apt-cache policy</command> コマンドでは、次のように出力されます。
                                <informalexample><programlisting>  500 http://updates.vinelinux.org &Vine-linux-release-version;/i386/main pkglist
     <emphasis>release v=&Vine-linux-release-version;,o=Project Vine,a=stable,l=Vine Linux,c=main</emphasis>
     origin updates.vinelinux.org</programlisting></informalexample>
                        </para>
                        
                        <para>release と書かれた行の、<literal>v=</literal>, <literal>o=</literal>, <literal>a=</literal>, <literal>l=</literal>, <literal>c=</literal> の部分が <filename>release.<replaceable>component</replaceable></filename> ファイルのそれぞれ次の部分と対応しています。</para>
                        
                        <variablelist>
                                <varlistentry>
                                        <term><literal>Version:</literal> 行</term>
                                        <listitem><simpara>リリースバージョン名。
                                        <command>apt-cache policy</command> コマンドの出力の <literal>v=</literal> の部分に対応します。
                                        例えば、このツリーのパッケージが、Vine Linux リリースバージョン &Vine-linux-release-version; に属するとします。
                                        通常 <literal>testing</literal> ディストリビューションや <literal>unstable</literal> ディストリビューションには、まだリリースされていないので、バージョン番号が付きません。
                                        APT 設定ファイルでこれを指定するには、以下の行のいずれかが必要になります。</simpara>
                                        
                                        <programlisting>
                                                Pin: release v=&Vine-linux-release-version;
                                                Pin: release a=stable, v=&Vine-linux-release-version;
                                                Pin: release &Vine-linux-release-version;
                                        </programlisting>

                                        <simpara>二つ目では、a=stable, v=&Vine-linux-release-version; のように、Version だけではなく Archive も指定しています。複数指定する場合には、このように "<literal>,</literal>" を利用して記述します。</simpara>
                                        </listitem>
                                </varlistentry>
                                
                                <varlistentry>
                                        <term><literal>Origin:</literal> 行</term>
                                        <listitem><simpara><filename>release.<replaceable>component</replaceable></filename> ファイルのディレクトリツリーにあるパッケージの提供者名。
                                        <command>apt-cache policy</command> コマンドの出力の <literal>o=</literal> の部分に対応します。
                                        ほとんど共通で、<literal>Project Vine</literal> です。
                                        APT 設定ファイルでこの提供者を指定するには、以下の行が必要になります。
                                </simpara>
                                <programlisting>
                                        Pin: release o=Project Vine
                                </programlisting>
                                <simpara>なお、<literal>Project Vine</literal> という文字列は t と V の間にスペース(空白)を一つ含んでいますが、<emphasis>" " は不要</emphasis>です。
                                <literal>Pin: release o="Project Vine"</literal> のように、<literal>"</literal> をつけると <literal>"</literal> も文字として認識されてしまい、正しく処理されません。
                                </simpara>
                                        </listitem>
                                </varlistentry>
                                
                                <varlistentry>
                                        <term><literal>Archive:</literal> 行</term>
                                        <listitem><simpara>このディレクトリツリーに属する全パッケージのアーカイブ名。
                                        <command>apt-cache policy</command> コマンドの出力の <literal>a=</literal> の部分に対応します。
                                        例えば、"Archive: stable" という行は、<filename>release.<replaceable>component</replaceable></filename> ファイルの親ディレクトリツリー以下にある全パッケージが、<literal>stable</literal> アーカイブだと指定します。
                                        APT 設定ファイルでこの値を指定するには、以下の行が必要になります。</simpara>
                                        <programlisting>
                                                Pin: release a=stable
                                        </programlisting>
                                        </listitem>
                                </varlistentry>
                                
                                <varlistentry>
                                        <term><literal>Label:</literal> 行</term>
                                        <listitem><simpara>
                                                <filename>release.<replaceable>component</replaceable></filename> ファイルのディレクトリツリーにあるパッケージのラベル名。
                                                <command>apt-cache policy</command> コマンドの出力の <literal>l=</literal> の部分に対応します。
                                                <literal>Vine Linux</literal> や <literal>Vine Linux - コンポーネント名</literal> が用いられます。
                                                APT 設定ファイルでこのラベルを指定するには、以下の行が必要になります。</simpara>
                                                <programlisting>
                                                        Pin: release l=Vine Linux
                                                </programlisting>
                                        </listitem>
                                </varlistentry>
                                
                                <varlistentry>
                                        <term><literal>Component:</literal> 行</term>
                                        <listitem><simpara><filename>release.<replaceable>component</replaceable></filename> ファイルの、ディレクトリツリーにあるパッケージのライセンスコンポーネント名。
                                        <command>apt-cache policy</command> コマンドの出力の <literal>c=</literal> の部分に対応します。
                                        例えば、"Component: main" という行は、このディレクトリ以下の全ファイルが、<literal>main</literal> コンポーネント(Eratta発行の対象となるパッケージ)であることを表します。
                                        APT 設定ファイルでこのコンポーネントを指定するには、以下の行が必要になります。</simpara>
                                        <programlisting>
                                                Pin: release c=main
                                        </programlisting>
                                        </listitem>
                                </varlistentry>

                        </variablelist>
                        
                        <para>
                                &sources-list; ファイルに列挙された場所から取得した <filename>release.<replaceable>component</replaceable></filename> ファイルや <filename>release</filename> ファイルはすべて、<filename>/var/state/apt/lists</filename> ディレクトリや、<filename>apt.conf</filename> ファイルの設定項目 <literal>Dir::State::lists</literal> で指定した場所に取得されます。
                                例えば、<filename><literal>updates.vinelinux.org</literal>_apt_<literal>&Vine-linux-release-version;</literal>_<literal>i386</literal>_base_<literal>release</literal>.<literal>main</literal></filename>
                        ファイルは、<literal>updates.vinelinux.org</literal> から取得した、<literal>&Vine-linux-release-version;</literal> ディストリビューションで、<literal>main</literal> コンポーネントな、<literal>i386</literal> アーキテクチャ用の <filename>release</filename> ファイルを含んでいます。</para>
                        
                </RefSect2>
                
                
                <RefSect2><Title>APT 設定の効果</Title>

                <para>
                        APT 設定ファイルを使うと、システム管理者が優先度を割り当てられるようになります。
                        ファイルは、空白行で区切られた、複数行からなるレコードで構成されています。
                        レコードは特定形式か、汎用形式のどちらかの形式をとります。
                        <itemizedlist>
                                <listitem>
                                        <simpara>
                                                特定形式は、優先度 ("Pin-Priority") を、指定したパッケージの指定したバージョン (範囲) について割り当てます。
                                                例えば以下のレコードは、"<literal>5.8</literal>" で始まる <filename>perl</filename> パッケージを、高い優先度に設定します。
                                        </simpara>

                                        <programlisting>Package: perl
Pin: version 5.8*
Pin-Priority: 1001
                                        </programlisting>
                                </listitem>

                                <listitem><simpara>
                                        汎用形式は、与えられたディストリビューションにある、すべてのパッケージ (<filename>release</filename> ファイルに列挙したパッケージ) の優先度や、FQDN(Fully Qualified Domain Name)で指定した、特定のインターネットサイトから取得するパッケージの優先度を割り当てます。
                                </simpara>

                                <simpara>
                                        APT 設定ファイルに書かれている汎用形式のエントリは、パッケージのグループについてのみ適用されます。
                                        例えば以下のレコードは、ローカルサイトにある全パッケージについて、高い優先度を割り当てます。
                                </simpara>

                                <programlisting>Package: *
Pin: origin ""
Pin-Priority: 999
                                </programlisting>

                                <simpara>
                                        注: ここで使用しているキーワードは "<literal>origin</literal>" です。
                                        origin には updates.vinelinux.org のような URL を書きます。"" のようにすると、ローカルサイトを示すことになります。
                                        <filename>release</filename> ファイルに指定されたような、ディストリビューションの Origin と混同しないようにしてください。
                                        <filename>release</filename> ファイルにある "Origin:" タグは、インターネットアドレスではなく、"Project Vine" や "Debian" といった作者やベンダ名です。
                                </simpara>

                                <simpara>
                                        以下のレコードは、アーカイブ名が "<literal>unstable</literal>" となっているディストリビューションに属するパッケージを、すべて低い優先度に割り当てます。
                                </simpara>

                                <programlisting>Package: *
Pin: release a=unstable
Pin-Priority: 50
                                </programlisting>
                                
                                <simpara>
                                        以下のレコードは、アーカイブ名が "<literal>stable</literal>" で、リリースバージョン番号が "<literal>3.0</literal>" となっているリリースに属するパッケージを、すべて高い優先度に割り当てます。
                                </simpara>
                                
                                <programlisting>Package: *
Pin: release a=unstable, v=3.0
Pin-Priority: 50
                                </programlisting>
                                </listitem>
                        </itemizedlist>
                </para>
                
                </RefSect2>

                <RefSect2>
                        <Title>APT が優先度に割り込む方法</Title>

                        <para>
                                APT 設定ファイルで割り当てた優先度 (P) は、正負の整数でなくてはなりません。
                                これは (おおざっぱにいうと) 以下のように解釈されます。

                                <variablelist>
                                        <varlistentry>
                                                <term>P &gt; 1000</term>
                                                <listitem><simpara>パッケージがダウングレードしても、このバージョンのパッケージをインストールします。</simpara></listitem>
                                        </varlistentry>
                                        <varlistentry>
                                                <term>990 &lt; P &lt;=1000</term>
                                                <listitem><simpara>インストールされているバージョンの方が新しいことを除き、ターゲットリリースに含まれなくても、このバージョンのパッケージをインストールします。</simpara></listitem>
                                        </varlistentry>
                                        <varlistentry>
                                                <term>500 &lt; P &lt;=990</term>
                                                <listitem><simpara>ターゲットリリースに属するバージョンがあったり、インストールされているバージョンの方が新しいのでなければ、このバージョンのパッケージをインストールします。</simpara></listitem>
                                        </varlistentry>
                                        <varlistentry>
                                                <term>100 &lt; P &lt;=500</term>
                                                <listitem><simpara>他のディストリビューションに属するバージョンがあったり、インストールされているバージョンの方が新しいのでなければ、このバージョンのパッケージをインストールします。</simpara></listitem>
                                        </varlistentry>
                                        <varlistentry>
                                                <term>0 &lt; P &lt;=100</term>
                                                <listitem><simpara>このパッケージがインストールされていない場合、このバージョンのパッケージをインストールします。</simpara></listitem>
                                        </varlistentry>
                                        <varlistentry>
                                                <term>P &lt; 0</term>
                                                <listitem><simpara>このバージョンがインストールされないようにします。</simpara></listitem>
                                        </varlistentry>
                                </variablelist>
                        </para>

                        <para>
                                特定形式のレコードが利用可能パッケージバージョンに一致した場合、最初のレコードが、パッケージバージョンの優先度を決定します。
                                失敗して、汎用形式のレコードが利用可能パッケージバージョンに一致した場合、最初のレコードが、パッケージバージョンの優先度を決定します。
                        </para>
                        
                        <para>
                                例えば、APT 設定ファイルの上の方に、以下の 3つのレコードが書かれていると仮定してください。
                                <programlisting>
Package: perl
Pin: version 5.8*
Pin-Priority: 1001

Package: *
Pin: origin ""
Pin-Priority: 999

Package: *
Pin: release unstable
Pin-Priority: 50
                                </programlisting>

                                すると

                                <itemizedlist>
                                        <listitem><simpara>1番目のレコードで、<literal>perl</literal> のパッケージについて記述されています。
                                        バージョン番号が "<literal>5.8</literal>" で始まっていれば、<literal>perl</literal> の最新の利用可能パッケージがインストールされます。
                                        <literal>perl</literal> の <emphasis>バージョン 5.8* が利用可能</emphasis>で、バージョン 5.9* がインストールされている場合、<literal>perl</literal> はダウングレードされます。</simpara></listitem>
                                        
                                        <listitem><simpara>2番目のレコードで、 <literal>origin ""</literal> とあり、ローカルシステムの優先度が指定されています。
                                        ローカルシステムで入手可能な、<literal>perl</literal> 以外のどんなパッケージでも、他のバージョンより (たとえターゲットリリースに属していても) 優先度が高くなります。</simpara></listitem>
                                        
                                        <listitem><simpara>3番目のレコードで、ローカルシステムにはなくても &sources-list; に列挙されたサイトにあるバージョンで、<literal>unstable</literal> ディストリビューションに属しているパッケージは、インストールするよう選択され、既にインストールされているバージョンがない場合にのみインストールされます。</simpara></listitem>
                                </itemizedlist>
                        </para>
                </RefSect2>


                <RefSect2>
                        <Title>APT 設定レコードのオプション行</Title>
                        
                        <para>
                                APT 設定ファイルのレコードごとに、任意で <literal>Explanation:</literal> で始まる行を持てます。
                                これは、コメント用の場所を確保します。
                        </para>
                        
                        <para>
                                APT 設定レコードの <literal>Pin-Priority:</literal> 行は任意です。
                                省略すると、<literal>Pin-Priority: release ...</literal> で始まる行で指示した最後の値 (少なくとも1つ) を優先度に割り当てます。
                        </para>
                </RefSect2>
        </RefSect1>
        
        <RefSect1>
                <Title>サンプル</Title>
                <RefSect2>
                        <Title>安定版(Stable)を追跡</Title>
                        
                        <para>
                                以下の APT 設定ファイルは、<literal>stable</literal> ディストリビューションに属する全てのパッケージのバージョンに、 デフォルト (500) より高い優先度を割り当て、 他の <literal>Project Vine</literal> ディストリビューションのパッケージのバージョンには、低くてインストールできないような優先度を割り当てます。
                                
                                <programlisting>
Explanation: Uninstall or do not install any Project Vine-originated
Explanation: package versions other than those in the stable distro
Package: *
Pin: release a=stable
Pin-Priority: 900

Package: *
Pin: release o=Project Vine
Pin-Priority: -10
                                </programlisting>
                        </para>

                        <para>
                                適切な &sources-list; ファイルと上記の設定ファイルにより、
                                以下のコマンドで最新の <literal>stable</literal> バージョンにアップグレードできます。

                                <programlisting>
apt-get install <replaceable>package-name</replaceable>
apt-get upgrade
apt-get dist-upgrade
                                </programlisting>
                        </para>

                        <para>
                                以下のコマンドで、指定したパッケージを <literal>testing</literal> ディストリビューションの最新バージョンにアップグレードします。
                                このパッケージは、再度このコマンドを発行しないとアップグレードされません。
                                
                                <programlisting>
apt-get install <replaceable>package</replaceable>/testing
                                </programlisting>
                        </para>
                </RefSect2>
                
                <RefSect2>
                        <Title>テスト版(Testing)や不安定版(Unstable)を追跡</Title>
                        
                        <para>
                                以下の APT 設定ファイルは、<literal>testing</literal> ディストリビューションのパッケージのバージョンに高い優先度を割り当て、<literal>unstable</literal> ディストリビューションのパッケージのバージョンには低い優先度を割り当てます。
                                また他の <literal>Project Vine</literal> ディストリビューションのパッケージのバージョンには、低くてインストールできないような優先度を割り当てます。
                                
                                <programlisting>
Package: *
Pin: release a=testing
Pin-Priority: 900

Package: *
Pin: release a=unstable
Pin-Priority: 800

Package: *
Pin: release o=Project Vine
Pin-Priority: -10
                                </programlisting>
                        </para>

                        <para>
                                適切な &sources-list; ファイルと上記の設定ファイルにより、以下のコマンドで最新の <literal>testing</literal> バージョンにアップグレードできます。
                                
                                <programlisting>
apt-get install <replaceable>package-name</replaceable>
apt-get upgrade
apt-get dist-upgrade
                                </programlisting>
                        </para>
                        
                        <para>以下のコマンドで、指定したパッケージを <literal>unstable</literal> ディストリビューションの最新バージョンにアップグレードします。
                        それ以降、<command>apt-get upgrade</command> は <literal>testing</literal> バージョンのパッケージが更新されていれば <literal>testing</literal> の最新版に、<literal>unstable</literal> バージョンのパッケージが更新されていれば <literal>unstable</literal> の最新版にアップグレードします。
                        
                        <programlisting>
apt-get install <replaceable>package</replaceable>/unstable
                        </programlisting>
                        </para>
                        
                </RefSect2>

                <RefSect2>
                        <Title>Project Vine のパッケージにもどす</Title>
                        
                        <para>
                                以下の APT 設定ファイルは、<literal>Project Vine</literal> ディストリビューションに属する全てのパッケージのバージョンに、ダウングレードも認める 1000 より大きな優先度を割り当てます。
                                ローカルで Patch を当てるなどしてテストパッケージを作りインストールしていた場合などに、公式に配布されているパッケージのバージョンに戻すことができます。
                                
                                <programlisting>
Package: *
Pin: release o=Project Vine
Pin-Priority: 1001
                                </programlisting>
                        </para>

                        <para>
                                適切な &sources-list; ファイルと上記の設定ファイルにより、
                                以下のコマンドで最新の <literal>stable</literal> バージョンにアップグレードできます。

                                <programlisting>
apt-get install <replaceable>package-name</replaceable>
apt-get upgrade
apt-get dist-upgrade
                                </programlisting>
                        </para>

                        <para>
                                以下のコマンドで、指定したパッケージを <literal>testing</literal> ディストリビューションの最新バージョンにアップグレードします。
                                このパッケージは、再度このコマンドを発行しないとアップグレードされません。
                                
                                <programlisting>
apt-get install <replaceable>package</replaceable>/testing
                                </programlisting>
                        </para>
                </RefSect2>

        </RefSect1>
        
        <RefSect1>
                <Title>関連項目</Title>
                <para>
                        &apt-get; &apt-cache; &apt-conf; &sources-list;
                </para>
        </RefSect1>
        
        &manbugs;
        <RefSect1><Title>著者</Title>
        <para>
                APT は Debian APT team によって作成され、その後 Conectiva(現 Mandriva) により rpm へ移植され apt-rpm となり、現在は Panu Matilainen さん(http://laiskiainen.org/) たちによって、http://apt-rpm.org/ でメンテナンスされています。
                APT に対して貢献された方々については、&docdir;AUTHORS* 等も参照してください。
        </para>
        <para>
                注) この日本語マニュアルは 倉澤 望さん、喜瀬 浩さん、岡 充さんなど、Debian JP Documentation ML の人たちによって日本語訳された Debian GNU/Linux のオンラインマニュアル、および、APT HOWTO (http://www.debian.org/doc/manuals/apt-howto/ch-apt-get.ja.html) の内容をもとに、2007年 7月に Vine Linux の環境にあわせて Vine Linux ドキュメントチーム 小林が修正しています。
                オリジナルの英語のマニュアルとは異なる部分が多数あります。この日本語マニュアルの間違いを発見した場合は Vine Linux バグトラッキングセンター http://bts.vinelinux.org/ 等を通じて報告してください。
        </para>
        </RefSect1>
        
</refentry>

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