SOURCES.LIST(5)

NAME
sources.list - APT 用パッケージリソースリスト

説明

このパッケージリソースリストは、 システムで使用するパッケージの保管場所を特定するのに使用されます。 今回このマニュアルページには、 Debian GNU/Linux システムで使用するパッケージシステムについてのみ記述します。 この制御ファイルは、/etc/apt/sources.list にあります。

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

SOURCES.LIST.D

/etc/apt/sources.list.d ディレクトリに ファイル名が .list で終わる個別ファイルを置いておくと、 sources.list エントリに追加できます。フォーマットは、 通常の sources.list ファイルと同じです。

DEB タイプと DEB-SRC タイプ

deb タイプでは典型的な 2 段階の Debian アーカイブ (distribution/component) を記述します。 よくあるケースでは、distribution は通常 stable unstable testing のどれか、 component は、main contrib non-free non-us のどれかです。 deb-src タイプでは、 Debian ディストリビューションのソースコードを、 deb タイプと同じ形式で記述します。 deb-src 行は、 ソースインデックスを取得するのに必要です。

deb タイプと deb-src タイプで使用する sources.list エントリのフォーマットは、以下になります。

    deb uri distribution [component1] [component2] [...]

deb タイプの URI は、 APT が情報を見つけられるように、 Debian ディストリビューションの基底を指定しなければなりません。 distribution には正確なパスを指定できます。 その場合 component を省略し、distribution はスラッシュ (/) で終わらなくてはなりません。 これは URL で指定されたアーカイブの、 特定のサブセクションのみに関心があるときに役に立ちます。 distribution に正確なパスを指定しないのなら、 少なくともひとつは component を指定しなければなりません。

distribution は、 $(ARCH) 変数を含む場合があります。 $(ARCH) 変数は、システムで使用している Debian アーキテクチャ (i386, m68k, powerpc, ...) に展開されます。 これにより、アーキテクチャに依存しない sources.list ファイルを使用できます。 一般的に、これは正しいパスを指定するときに気にするだけです。 そうでない場合は、APT は現在のアーキテクチャで URI を自動的に生成します。

有効な全 distribution, component の場所から、 一部が必要な場合、1 行につき 1 distribution しか指定できないため、 同じ URI の行を複数記述することになるでしょう。 APT は内部で URI リストを生成してから、並べ替えます。 そして、同じインターネットホストに対しては複数の参照をまとめます。 例えば FTP 接続後、切断してからまた同じホストに再接続するといった、 効率の悪いことをせずに、1 接続にまとめます。 この機能は、同時接続匿名ユーザ数を制限している、 混んでいる FTP サイトにアクセスするのに便利です。 APT は、帯域の狭いサイトを効率よく扱うのに、 異なるホストへは、接続を並行して行うようにもしています。

最優先する取得元を最初に記述するというように、 優先順に取得元を記述するのは重要です。 一般的には、スピードの速い順に並べることになる (例えば、CD-ROM に続いてローカルネットワークのホスト、 さらに続いて彼方のインターネットホスト) でしょう。

例:

    deb http://http.us.debian.org/debian stable main contrib non-free
    deb http://http.us.debian.org/debian dists/stable-updates/

URI の仕様

現在認識する URI 対応は、cdrom, file, http, ftp です。

file
    file スキームは、システム内の任意のディレクトリを、 アーカイブとして扱えるようにします。 これは NFS マウントやローカルミラーで便利です。

cdrom
    cdrom スキームは、APT がローカル CD-ROM ドライブを、 メディア交換しながら使えるようにします。 取得元リストに cdrom エントリを追加するには、 apt-cdrom(8) プログラムを使用してください。

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

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

copy
    copy スキームは、file スキームと同様ですが、パッケージをその場で使用せず、 キャッシュディレクトリにコピーするところが違います。 zip ディスクを使用していて、APT でコピーを行う場合に便利です。

rsh, ssh
    rsh/ssh メソッドは、与えられたユーザでリモートホストに接続し、 ファイルにアクセスするのに rsh/ssh を使用します。 あらかじめ RSA キーや rhosts の配置が必要ですが、 パスワードなし認証が可能です。 リモートホストのファイルへのアクセスの際、 ファイル転送に標準の find コマンドや dd コマンドを使用します。

サンプル

/home/jason/debian に格納されている stable/main, stable/contrib, stable/non-free 用のローカル (または NFS) アーカイブを使用します。

    deb file:/home/jason/debian stable main contrib non-free

上記同様ですが、不安定版を使用します。

    deb file:/home/jason/debian unstable main contrib non-free

上記のソース行

    deb-src file:/home/jason/debian unstable main contrib non-free

archive.debian.org のアーカイブに HTTP アクセスし、 hamm/main のみを使用します。

    deb http://archive.debian.org/debian-archive hamm main

ftp.debian.org のアーカイブに FTP アクセスし、 debian ディレクトリ以下の stable/contrib のみを使用します。

    deb ftp://ftp.debian.org/debian stable contrib

ftp.debian.org のアーカイブに FTP アクセスし、 debian ディレクトリ以下の unstable/contrib を使用します。 sources.list に上記サンプルと一緒に指定された場合、 両方のリソース行に対応する FTP セッションはひとつだけになります。

    deb ftp://ftp.debian.org/debian unstable contrib

nonus.debian.org のアーカイブに HTTP アクセスし、 debian-non-US ディレクトリ以下を使用します。

    deb http://nonus.debian.org/debian-non-US stable/non-US main contrib non-free

nonus.debian.org のアーカイブに HTTP アクセスし、 debian-non-US ディレクトリ以下を使用します。 また、i386 マシンでは unstable/binary-i386 以下にあるファイル、 m68k マシンでは unstable/binary-m68k 以下にあるファイル、 その他サポートするアーキテクチャごとのファイルのみ使用します。 [このサンプルは変数展開の使用法の説明でしかないことに注意してください。 non-us はこのような構造になっていません]

    deb http://ftp.de.debian.org/debian-non-US unstable/binary-$(ARCH)/

関連項目

apt-cache(8) apt.conf(5)

バグ

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

訳者

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

AUTHORS

Jason Gunthorpe

    Author.

APT team

    Author.

NOTES

1.  APT バグページ
    http://bugs.debian.org/src:apt