source: projects/apt-rpm-manpages-ja/trunk/doc/ja/sources.list.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>sources.list</refentrytitle>
   <manvolnum>5</manvolnum>
 </refmeta>
 
 <!-- Man page title -->
 <refnamediv>
    <refname>sources.list</refname>
    <refpurpose>APT 用パッケージリソースリスト</refpurpose>
 </refnamediv>
 
 <RefSect1><Title>説明</Title>
   <Para>   
このパッケージリソースリストは、システムで使用するパッケージの保管場所を特定するのに使用されます。
   </Para>
   <Para>
     このマニュアルページには、Vine Linux で使用するパッケージシステムについてのみ記述します。より多くの情報を知りたい場合は、原文である英語版のマニュアルを読んでください。
   </Para>
   <Para>
この制御ファイルは、<filename>/etc/apt/sources.list</filename> にあります。
   </Para>
   <Para>   
.listという文字で終わるファイル(例 favorite-servers.list )を、ディレクトリ <filename>/etc/apt/sources.list.d</filename> に置くと、そのファイルも参照されます。ファイルの書式は <filename>/etc/apt/sources.list</filename> と同じです。
   </Para>

   <Para>
ソースリストは複数の有効な取得元と、様々な取得メディアをサポートしています。
ファイルには 1 行ごと取得元を列挙し、上の方にあるものから使用します。
行の書式は、<literal>タイプ uri 引数</literal> となります。
先頭の <literal>タイプ</literal> で <literal>引数</literal> の書式を決定します。
<literal>uri</literal> は Universal Resource Identifier(URI) で、よく知られた Universal Resource Locator(URL) を含むスーパーセット(上位集合)です。
# を付けると行の # 以降の部分をコメントにできます。
   </Para>

   <Para>
   一般的な書式の sources.list は次のようになります。
   <literallayout>type [[vendor]] baseuri distribution [component comp2 ...]</literallayout>
   </Para>

   <Para>
   type は、Vine Linux では rpm タイプと rpm-src タイプを利用します。
   </Para>
   <Para>
   baseuri は ディストリビューションによって与えられる URI の基底部分となります。
   Vine Linux では http://updates.vinelinux.org/apt が baseuri となります。
   </Para>
   <Para>
   distribution には ディストリビューション名 と バージョン と アーキテクチャー名 が入ります。
   baseuri の部分に Vine Linux を示す Vine が含まれているので
   distribution 部分はバージョンとアーキテクチャー名を指定します。
   </Para>
   <Para>
   URI を baseuri と distribution のパートに分けることで、baseuri をいじらずにディストリビューションのバージョンだけ変更するといったこともできるようになっています。
   マイナーバージョンの変化(X.1 から X.2 に変わるなど小数点以下だけ変わる場合)であれば、これだけで対応できる場合もあります。
   </Para>
   <Para>
   いくつかの type では component (コンポーネント) を指定することができます。
   Vine Linux では main plus updates nonfree extras といったコンポーネントがあります。
   Vine Linux では「コンポーネント」の代わりに「カテゴリ」と呼ぶことが多いようですが、どちらも同じものを指していて意味の違いはありません。
   </Para>

   <Para>
   [vendor] を指定することで、PGP キーを用いた署名の確認を行うことができます。&vendors.list; を参照してください。
   </Para>

   <Para>
   次にあげるものは置換されます。
   <literal>$(ARCH)</literal> は 設定項目 <literal>APT::Architecture</literal> で設定されたアーキテクチャー名(i386 , ppc など)に置き換えられます。
   </Para><Para>
   <literal>$(VERSION)</literal> は 設定項目 <literal>Apt::DistroVerPkg</literal> か <literal>APT::DistroVersion</literal> に設定された値で置き換えられます。
   </Para>
 </RefSect1>
 
 <RefSect1><Title>rpm タイプ と rpm-src タイプ</Title>
   <Para>
   rpm タイプと rpm-src タイプの sources.list の書式は次のようになり、最低でも一つ、component を指定する必要があります。
   <literallayout>rpm [[vendor]] baseuri distribution component [comp2 ...]</literallayout>
   <literallayout>rpm-src [[vendor]] baseuri distribution component [comp2 ...]</literallayout>
   </Para>
 </RefSect1>

 <RefSect1><title>URI の仕様</title>
   <Para>
現在認識される URI は、cdrom, http, ftp, file, copy です。
    
  <VariableList>
    <VarListEntry><term>cdrom</term>
    <ListItem><Para>
    cdrom スキームは、APT がローカル CD-ROM ドライブを、メディア交換しながら使えるようにします。
    取得元リストに cdrom エントリを追加するには、&apt-cdrom; コマンドを使用してください。
    </Para></ListItem>
    </VarListEntry>

    <VarListEntry><term>http</term>
    <ListItem><Para>
    http スキームはアーカイブとして、HTTP サーバを指定します。
    もし、環境変数 <EnVar>http_proxy</EnVar> が http://server:port/, といった形で指定されていれば、<EnVar>http_proxy</EnVar> で指定されたプロキシサーバを使用します。
ユーザ認証が必要な HTTP/1.1 プロキシの場合、http://user:pass@server:port/ という書式で指定してください。
なお、この認証方法は安全ではないことに注意してください。
    </Para></ListItem>
    </VarListEntry>

    <VarListEntry><term>ftp</term>
    <ListItem><Para>
        ftp スキームは、アーカイブに FTP サーバを指定します。
        APT の FTP の振る舞いは、高度に設定できます。
        詳細は &apt-conf; のマニュアルページを読んでください。
        ftp プロキシは、環境変数 <EnVar>ftp_proxy</EnVar> で指定するということにご注意ください。
        この方法用に、さらにこの方法でしか使用しないのに、http プロキシを使用することができます (http プロキシサーバは大抵 ftp urlも理解できます)。
        設定ファイルで http を使用する際に、ftp プロキシを使用するよう設定してあっても無視されます。
        </Para></ListItem>
    </VarListEntry>

    <VarListEntry><term>file</term>
    <ListItem><Para>
file スキームは、システム内の任意のディレクトリを、アーカイブとして扱えるようにします。
これは NFS マウントやローカルミラーで便利です。</Para>
<Para><command>apt-get</command> source とした場合には、カレントディレクトリにソースパッケージへのシンボリックリンクを作成することで、ディスクの使用を抑制します。
    </Para></ListItem>
    </VarListEntry>

    <VarListEntry><term>copy</term>
    <ListItem><Para>
copy スキームは、file スキームと同様ですが、パッケージをその場で使用せず、キャッシュディレクトリ(&cachedir;/archives/)にコピーするところが違います。 
zip ディスクを使用していて、APT でコピーを行う場合に便利です。
    </Para></ListItem>
    </VarListEntry>
    
  </VariableList>
 </Para>
 </RefSect1>
 
 <RefSect1><title>サンプル</title>
   <Para>
   rpm と rpm-src タイプのエントリです。main plus updates nonfree のコンポーネント(カテゴリ)を指定しています。
   <literallayout>rpm     [vine] http://updates.vinelinux.org/apt &Vine-linux-release-version;/$(ARCH) main plus updates nonfree</literallayout>
   <literallayout>rpm-src [vine] http://updates.vinelinux.org/apt &Vine-linux-release-version;/$(ARCH) main plus updates nonfree</literallayout>
   </Para>

   <Para>
   extras のコンポーネント(カテゴリ)も追加するには次のようにします。
   <literallayout>rpm     [vine] http://updates.vinelinux.org/apt &Vine-linux-release-version;/$(ARCH) main plus updates nonfree extras</literallayout>
   <literallayout>rpm-src [vine] http://updates.vinelinux.org/apt &Vine-linux-release-version;/$(ARCH) main plus updates nonfree extras</literallayout>
   </Para>

   <Para>
   apt-cdrom で追加した場合は次のように追記されます。
   <literallayout>rpm cdrom:[Vine Linux CR DVD]/ Vine main main2 nonfree plus</literallayout>
   </Para>
   <Para>[] の中はラベル名が入ります。
   登録時に認識されなかったカテゴリを「追加」することはできませんが、「削除」することはできます。
   </Para>


   <Para>
   http: ではなく ftp: を用いると次のようになります。
   <literallayout>rpm     [vine] ftp://updates.vinelinux.org/pub/Vine/apt &Vine-linux-release-version;/$(ARCH) main plus updates nonfree</literallayout>
   <literallayout>rpm-src [vine] ftp://updates.vinelinux.org/pub/Vine/apt &Vine-linux-release-version;/$(ARCH) main plus updates nonfree</literallayout>
   </Para>
 </RefSect1>


 <RefSect1><title>サンプル:ローカルのファイルを利用</title>
   <Para>
   file: では次のようになります。
   <literallayout>rpm     [myname] <literal>file://usr/local/unofficial-rpm local-build/$(ARCH)</literal> <literal>test</literal></literallayout>
   <literallayout>rpm-src [myname] <literal>file://usr/local/unofficial-rpm local-build/$(ARCH)</literal> <literal>test</literal></literallayout>
   </Para>
   <Para>
   copy: を用いるには file: の部分を copy: と書き換えるだけです。
   </Para>
   <Para>
   ローカルリポジトリの作成方法は &genbasedir; を参照してください。
   </Para>
 </RefSect1>
 
 <RefSect1><Title>関連項目</Title>
   <Para>
   &apt-cache; &apt-conf; &genbasedir;
   </Para>
 </RefSect1>

 &manbugs;
 &manauthor;
 
</refentry>

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