バグシステムリクエストサーバ入門

バグ追跡システムでは、要求に応じて平文でバグ報告や索引を送付するメールサーバを運用しています。

メールサーバは、 request@bugs.debian.org 宛に電子メールを送ることで利用できます。Subject は返信メールの Subject に利用されますが、その以外では無視されます。

本文には一行に一つのコマンドを書いて送らなければいけません。メール発信者が受けとる返信には、解釈された自分のメッセージとそれぞれのコマンドに対する応答が書かれています。ここに挙げられたコマンドでは、誰かに通知が送られることはありません。またメールは、公開されている場所には記録されません。

ハッシュ記号 # で始まる行は無視されます。サーバは、制御終端 (quit、thank you、あるいはハイフン2つ、などが一般的な例です) のある行で処理を中止します。また、認識不能なコマンドや不正な形式を持つコマンドが多くある場合も、処理を中止します。正常な処理を行ったコマンドがひとつもない場合、サーバは help 文書を送ります。

利用可能なコマンド

send bugnumber

send-detail bugnumber

引き数で指定したバグ報告の写しを要求します。send-detail では、自動通知など全ての退屈なメッセージが送られます。

index [full]

index-summary by-package

index-summary by-number

それぞれ、 (full をつけると解決済、転送済バグ報告も含む)完全なインデックス、パッケージ名順の要約、バグ番号順の要約を要求します。

index-maint

バグ追跡システムで(未解決または最近クローズされた)バグを持つメンテナーリストのインデックスページを要求します。

index maint maintainer

メンテナ maintainer のバグのインデックスページを要求します。検索語は、完全一致です。バグのインデックスは個別のメールで送られます。

index-packages

バグ追跡システムで(未解決または最近クローズされた)バグを持つパッケージリストのインデックスページを要求します。

index packages package

パッケージ package のバグ一覧を要求します。検索語は、完全一致です。バグのインデックスは個別のメールで送られます。

send-unmatched [this|0]

send-unmatched last|-1

send-unmatched old|-2

それぞれ今週、先週、先々週の間に送られた特定のバグ報告に該当しないメッセージのログを要求します(水曜日を週末として扱います)

getinfo filename

パッケージやメンテナの情報を含むファイルを要求します。利用可能なファイルを以下に示します。

maintainers: バグ追跡システムで利用されるパッケージメンテナー一覧。これは Packages ファイル、override ファイルおよび擬似パッケージファイル中の情報から作られます。
override.distribution
override.distribution.non-free
override.distribution.contrib
override.experimental: パッケージの重要度(priority)とセクション(section)の情報やメンテナの修正情報。この情報は FTP アーカイブ上の Packages ファイルを生成する際に利用されます。ディストリビューションツリーそれぞれについてこの情報が利用可能です。ディストリビューション名はコード名です。
pseudo-packages.description
pseudo-packages.maintainers: それぞれ、擬似パッケージに対する説明とメンテナーの一覧。

refcard

メールサーバリファレンスカードを平文で送るよう要求します。

help

このヘルプ文書(原文)を平文で送るよう要求します。

quit

stop

thank

thanks

thankyou

thank you

--

この行でメッセージの処理を中止します。この行の後に任意の文書を含めることができますが、メールサーバはそれを処理しません。たとえば、あなたのメッセージを(バグ追跡システムのログや CC または BCC で)読む人のために、長いコメントを含める時には # よりもこれを使用する方が適切です。

#...

コメント行。# は行頭になければいけません。

debug level

デバッグレベルをlevelに設定します。levelには負でない整数が使用できます。0 の場合はデバッグ出力をしません。通常のデバッグには 1 で十分です。デバッグ出力は写しに書き出されますが、こればバグシステムの一般ユーザに役立つ情報ではありません。

この他、メールサーバのリファレンスカードが用意されています。利用には WWW 上や bug-mailserver-refcard.txt、電子メールで refcard コマンドを使います。 (上記を参照のこと)。

バグ報告を操作したい場合は、control@bugs.debian.or.org アドレスを使用しなければいけません。このアドレスは上記のコマンド群のスーパーセットを解釈します。詳細は別の文書で記述されており、 WWW 上や bug-maint-mailcontrol.txt 、または control@bugs に help コマンドを送ることで参照できます。

この文書を平文ファイル、もしくは電子メールで読んでいる場合は、バグ追跡システムトップページ http://www.debian.org/Bugs/ から HTML 版が利用できます。

その他の BTS ページ:

Debian BTS administrators <owner@bugs.debian.org>