sources.list

Autres langues

Langue: ja

Version: 29 February 2004 (ubuntu - 25/10/10)

Section: 5 (Format de fichier)

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

/etc/apt/sources.list.d ディレクトリは、個別ファイルで追加 source.list エントリを提供します。フォーマットは、通常の sources.list ファイルと同じです。ファイル名は、.list で終わる必要があり、文字 (a-z と A-Z)、数字 (0-9)、アンダースコア (_)、ハイフン (-)、ピリオド (.) のみを含んでいなければなりません。そうでなければ、黙って無視します。

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://ftp.debian.org/debian lenny main contrib non-free
 deb http://security.debian.org/ lenny/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
 

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

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

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

 deb ftp://ftp.debian.org/debian lenny 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)

バグ

m[blue]APT バグページm[][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