Provided by: dpkg-dev_1.17.5ubuntu5.8_all 
名前
deb-src-control - Debian ソースパッケージのマスタ制御ファイルのフォーマット
書式
control
説明
Debian の各ソースパッケージには、マスタとなる "control" ファイルがある。ファイルには、空白
行で区切られた最低 2 つの段落が含まれる。最初の段落には、通常ソースパッケージに関するすべ
ての情報が列挙されている。以降の段落は、各々が 1 つのバイナリパッケージに関する設定とな
る。各段落は、最低 1 つのフィールドからなる。フィールドは Package やSection (大文字小文字
の区別なし) といったフィールド名から始まり、コロンの後にフィールドの本体 (値) が続き、改行
で終わる。フィールドは複数行にまたがっても構わないが、フィールド名を含まない追加の行は、最
低 1 つのスペースから始まる必要がある。通常、複数行にまたがるフィールドの本体は、ツールに
よって 1行にまとめられる (ただし、以下で説明する Description フィールドは例外である)。空行
を追加したい場合は、スペースに続けてドットを 1 つだけ記述する。'#' で始まる行はコメントと
して扱われる。
SOURCE フィールド
Source: ソースパッケージ名 (必須)
このフィールドの値がソースパッケージ名となる。これは debian/changelog ファイル内の
ソースパッケージ名と合致させるべきである。パッケージ名には、小文字(a-z)、数字
(0-9)、プラス (+)、マイナス (-) 記号とピリオド (.) のみを含めることができる。パッ
ケージ名は最低 2 文字以上の長さとし、英数字で始めなければならない。
Maintainer: fullname-email (必須)
`Joe Bloggs <jbloggs@foo.com>' 形式で設定すること。パッケージ化されたソフトウェアの
開発者や元々のパッケージ作成者ではなく、*このパッケージ* の現在のメンテナの情報を記
載する。
Uploaders: fullname-email
パッケージの共同メンテナの名前と電子メールアドレスを Maintainer フィールドと同じ形
式で列挙する。共同メンテナが複数人いる場合はコンマで区切ること。
Standards-Version: バージョン文字列
このパッケージが準拠した標準 (debian-policy パッケージに含まれる Debian Policy
Manual と関連ドキュメントから構成される) の最新バージョンを示す。
Homepage: url
アップストリームのプロジェクトのホームページ URL。
Bugs: url
パッケージのバグトラッキングシステムの url。現在使われている形式
は、debbugs://bugs.debian.org のような bts-type://bts_address 形式である。この
フィールドは一般的に必要とされない。
Vcs-*: url
このパッケージの管理に用いられているバージョン管理システムのリポジトリ url。現在サ
ポートされているのは、Arch, Bzr (Bazaar), Cvs, Darcs, Git, Hg(Mercurial), Mtn
(Monotone), Svn (Subversion) である。通常、このフィールドは、main ブランチや trunk
といった最新版のパッケージを示している。
Vcs-Browser: url
バージョン管理システムのリポジトリを閲覧するための Web インタフェースの url。
Origin: ディストリビューション名
パッケージの起源となったディストリビューション名。このフィールドは、通常不要であ
る。
Section: セクション
パッケージによりインストールされるソフトウェアがどのセクションの分類に属するかを示
すフィールドである。一般的なセクションには "utils" や "net"、"mail"、"text"、"x11"
などがある。
Priority: priority
システム全体からみたこのパッケージの重要度を示す。一般的に使われる priority には
"required"、"standard"、"optional"、"extra" などがある。
Debian では、Section と Priority フィールドで使える値がポリシーマニュアルで定められ
ている。最新の debian-policy パッケージから一覧を取得できる。
Build-Depends: パッケージのリスト
ソースパッケージをビルドするためにインストールと設定が必要なパッケージのリスト。こ
のリストで定義した依存関係は、Build-Depends-Arch と Build-Depends-Indep の両方で
行った定義と同じ効力を持つだけでなく、ソースのみのビルドにおいても効力を持つ。
Build-Depends-Arch: パッケージのリスト
Same as Build-Depends, but they are only needed when building the architecture
dependent packages. The Build-Depends are also installed in this case. This field
is supported since dpkg 1.16.4; in order to build with older dpkg versions,
Build-Depends should be used instead.
Build-Depends-Indep: パッケージのリスト
Build-Depends と同様だが、アーキテクチャ非依存なパッケージをビルドする場合にのみ必
要とされるもの。Build-Depends もインストールされる。
Build-Conflicts: パッケージのリスト
ビルドシステムの動作に影響するなど、パッケージがビルドされる時にインストールされて
いることが好ましくないパッケージのリスト。このリストで定義した依存関係
は、Build-Conflicts-Arch と Build-Conflicts-Indep の両方で行った定義と同じ効力を持
つだけでなく、ソースのみのビルドにおいても効力を持つ。
Build-Conflicts-Arch: パッケージのリスト
Same as Build-Conflicts, but only when building the architecture dependent
packages. This field is supported since dpkg 1.16.4; in order to build with older
dpkg versions, Build-Conflicts should be used instead.
Build-Conflicts-Indep: パッケージのリスト
Build-Conflicts と同様だが、アーキテクチャ非依存なパッケージをビルドする場合にのみ
影響するもの。
The syntax of the Build-Depends, Build-Depends-Arch and Build-Depends-Indep fields is a
list of groups of alternative packages. Each group is a list of packages separated by
vertical bar (or "pipe") symbols, "|". The groups are separated by commas. Commas are to
be read as "AND", and pipes as "OR", with pipes binding more tightly. Each package name is
optionally followed by a version number specification in parentheses, an architecture
specification in square brackets, and a profile specification in angle brackets.
The syntax of the Build-Conflicts, Build-Conflicts-Arch and Build-Conflicts-Indep fields
is a list of comma-separated package names, where the comma is read as an "AND".
Specifying alternative packages using a "pipe" is not supported. Each package name is
optionally followed by a version number specification in parentheses, an architecture
specification in square brackets, and a profile specification in angle brackets.
バージョン番号が ">>" で始まる場合は、それより新しいバージョンすべてにマッチする。バージョ
ン番号には、(ハイフンに続けて) Debian パッケージリビジョンを指定することもできるが、省略し
ても構わない。「より新しい」を意味する ">>"、「より古い」を意味する "<<"、「同じか新し
い」を意味する ">="、「同じか古い」を意味する "<="、「同じ」を意味する "=" を使用できる。
An architecture specification consists of one or more architecture names, separated by
whitespace. Exclamation marks may be prepended to each of the names, meaning "NOT".
A profile specification consists of one or more profile names, prefixed with the
"profile." namespace, separated by whitespace. Exclamation marks may be prepended to each
of the names, meaning "NOT".
build-essential に含まれるパッケージとの依存関係は省略できること、これらのパッケージと競合
するようなビルド設定は禁止されている点に留意すること。該当するパッケージの一覧
は、build-essential パッケージに含まれている。
BINARY フィールド
Priority, Section, Homepage フィールドは、BINARY 段落に設定することで、ソースパッケージで
定義されたグローバルな値を上書きすることも可能である点に留意すること。
Package: バイナリパッケージ名 (必須)
このフィールドはバイナリパッケージ名の指定に用いられる。ソースパッケージ名と同様の
制約が適用される。
Architecture: arch|all|any (必須)
アーキテクチャ (Architecture) は、このパッケージが動作するハードウェア種別を指定す
る。すべてのアーキテクチャで動作するパッケージは、値 any を使用する。シェルスクリプ
トや Perl スクリプト、ドキュメントといったアーキテクチャ非依存のパッケージは、値
all を使用する。パッケージのアーキテクチャを制約したい場合は、アーキテクチャ名をス
ペースで区切って指定する。アーキテクチャのワイルドカードを使用することも可能である
(詳細は dpkg-architecture(1) を参照のこと)。
Package-Type: deb|udeb
このフィールドは、パッケージのタイプを指定する。"udeb" は debian installer が使用す
るサイズの制約があるパッケージである。"deb" はデフォルトの値であり、フィールドが存
在しなかった場合に仮定される値である。将来的にはこれ以外のタイプが追加されるかもし
れない。
Subarchitecture: value
Kernel-Version: value
Installer-Menu-Item: value
これらのフィールドは、debian-installer によって用いられるもので、通常は不要であ
る。詳細については、debian-installer パッケージに含まれてい
る/usr/share/doc/debian-installer/devel/modules.txt を参照のこと
Essential: yes|no
Multi-Arch: same|foreign|allowed
Tag: タグのリスト
Description: 短い説明 (必須)
これらのフィールドは、バイナリパッケージの control ファイルにそのままコピーされるた
め、deb-control(5) のマニュアルページで解説されている。
Depends: パッケージのリスト
Pre-Depends: パッケージのリスト
Recommends: パッケージのリスト
Suggests: パッケージのリスト
Breaks: パッケージのリスト
Enhances: パッケージのリスト
Replaces: パッケージのリスト
Conflicts: パッケージのリスト
Provides: パッケージのリスト
Built-Using: パッケージのリスト
これらのフィールドは、パッケージ間の関連性を指定するものであり、deb-control(5) マ
ニュアルページと debian-policy パッケージで説明されている。
ユーザ定義フィールド
control ファイルに、ユーザが定義する追加のフィールドを含めることもできる。ツール類は、これ
らのフィールドを無視する。フィールドをバイナリパッケージなどの出力ファイルにもコピーしたい
場合は、X に続き、文字 BCS から 1 文字以上とハイフンとをつなげた custom naming scheme を使
用する必要がある。文字 B を使用する場合、フィールドはバイナリパッケージの control ファイル
に複製される。deb-control(5) も参照のこと。文字 S の場合は dpkg-source(1) によって作成され
るソースパッケージ内の control ファイルに、文字 C の場合はアップロードの制御ファイル
(.changes ファイル) に、各々複製される。フィールドが出力ファイルにコピーされる時
に、X[BCS]- というプレフィックスは削除されることに注意。例えば XC-Approved-By というフィー
ルドは changes ファイルでは Approved-Byとなり、バイナリやソースパッケージ内 の control
ファイルには複製されない点に留意すること。
こうしたユーザ定義のフィールドはグローバルな名前空間を使用するため、将来的に公式に定義され
たフィールドと衝突する可能性がある点に注意。このような潜在的な可能性を避けるために、これら
のフィールドを XB-Private-New-Field のように Private- から開始するとよい。これに
は、dpkg-deb がこれらを不明なフィールドとして警告しなくなるという副次的効果もある。
例
# Comment
Source: dpkg
Section: admin
Priority: required
Maintainer: Dpkg Developers <debian-dpkg@lists.debian.org>
# this field is copied to the binary and source packages
XBS-Upstream-Release-Status: stable
Homepage: https://wiki.debian.org/Teams/Dpkg
Vcs-Browser: http://git.debian.org/?p=dpkg/dpkg.git
Vcs-Git: git://git.debian.org/git/dpkg/dpkg.git
Standards-Version: 3.7.3
Build-Depends: pkg-config, debhelper (>= 4.1.81),
libselinux1-dev (>= 1.28-4) [!linux-any]
Package: dpkg-dev
Section: utils
Priority: optional
Architecture: all
# this is a custom field in the binary package
XB-Mentoring-Contact: Raphael Hertzog <hertzog@debian.org>
Depends: dpkg (>= 1.14.6), perl5, perl-modules, cpio (>= 2.4.2-2),
bzip2, lzma, patch (>= 2.2-1), make, binutils, libtimedate-perl
Recommends: gcc | c-compiler, build-essential
Suggests: gnupg, debian-keyring
Conflicts: dpkg-cross (<< 2.0.0), devscripts (<< 2.10.26)
Replaces: manpages-pl (<= 20051117-1)
Description: Debian package development tools
This package provides the development tools (including dpkg-source)
required to unpack, build and upload Debian source packages.
.
Most Debian source packages will require additional tools to build;
for example, most packages need make and the C compiler gcc.
関連項目
deb-control(5), deb-version(5), dpkg-source(1)
翻訳者
高橋 基信 <monyo@monyo.com>. 喜瀬 浩 <kise@fuyuneko.jp>. 関戸 幸一 <sekido@mbox.kyoto-
inet.or.jp>. 鍋谷 栄展 <nabe@debian.or.jp>. 倉澤 望 <nabetaro@debian.or.jp>. 石川 睦
<ishikawa@linux.or.jp>. 鵜飼 文敏 <ukai@debian.or.jp>. 中野 武雄
<nakano@apm.seikei.ac.jp>.
翻訳校正
Debian JP Documentation ML <debian-doc@debian.or.jp>.