SOURCES.LIST(5)

February 2004

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

説明

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

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

SOURCES.LIST.D

The /etc/apt/sources.list.d directory provides a way to add sources.list entries in separate files. The format is the same as for the regular sources.list file. File names need to end with .list and may only contain letters (a-z and A-Z), digits (0-9), underscore (_), hyphen (-) and period (.) characters. Otherwise APT will print a notice that it has ignored a file if the file doesn't match a pattern in the Dir::Ignore-Files-Silently configuration list - in this case it will be silently ignored.

DEB タイプと DEB-SRC タイプ

The deb type describes a typical two-level Debian archive, distribution/component. Typically, distribution is generally an archivename like stable or testing or a codename like squeeze or wheezy while component is one of main contrib or non-free. The deb-src type describes a debian distribution's source code in the same form as the deb type. A deb-src line is required to fetch source indexes.

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

    deb [ options ] 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 は、帯域の狭いサイトを効率よく扱うのに、異なるホストへは、接続を並行して行うようにもしています。

options is always optional and needs to be surounded by square brackets. It can consist of multiple settings in the form setting=value. Multiple settings are separated by spaces. The following settings are supported by APT, note though that unsupported settings will be ignored silently:

    • arch=arch1,arch2,... can be used to specify for which architectures packages information should be downloaded. If this option is not set all architectures defined by the APT::Architectures option will be downloaded.

    • trusted=yes can be set to indicate that packages from this source are always authenificated even if the Release file is not signed or the signature can't be checked. This disables parts of apt-secure(8) and should therefore only be used in a local and trusted context. trusted=no is the opposite which handles even correctly authenificated sources as not authenificated.

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

例:

    deb http://ftp.debian.org/debian squeeze main contrib non-free
    deb http://security.debian.org/ squeeze/updates main contrib non-free

URI の仕様

現在認識する URI タイプは、cdrom, file, http, ftp, copy, ssh, rsh です。.PP ファイル
    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 コマンドを使用します。

さらに認識できる URI タイプ
    APT can be extended with more methods shipped in other optional packages which should follow the nameing scheme apt-transport-method. The APT team e.g. maintains also the apt-transport-https package which provides access methods for https-URIs with features similar to the http method, but other methods for using e.g. debtorrent are also available, see apt-transport-debtorrent(1).

サンプル

/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

The first line gets package information for the architectures in APT::Architectures while the second always retrieves amd64 and armel.

    deb http://ftp.debian.org/debian squeeze main
    deb [ arch=amd64,armel ] http://ftp.debian.org/debian squeeze main

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

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

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

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

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

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

Uses HTTP to access the archive at ftp.tlh.debian.org, under the universe directory, and uses only files found under unstable/binary-i386 on i386 machines, unstable/binary-amd64 on amd64, and so forth for other supported architectures. [Note this example only illustrates how to use the substitution variable; official debian archives are not structured like this]

    deb http://ftp.tlh.debian.org/universe 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,2009-2010), Debian JP Documentation ML <debian-doc@debian.or.jp>

この翻訳文書には未訳部分が含まれていることに注意してください。 翻訳がオリジナルに追従できていない場合、 内容を失わないようにこのようにしています。

AUTHORS

Jason Gunthorpe

APT チーム

NOTES

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