blob: 488c77fa3aae138c41168408d983791819f5a7fb [file] [log] [blame]
Tsugikazu Shibata3b6662f2007-09-25 01:54:26 +09001NOTE:
Tsugikazu Shibata8b436262007-07-19 11:24:54 +09002This is a version of Documentation/HOWTO translated into Japanese.
3This document is maintained by Tsugikazu Shibata <tshibata@ab.jp.nec.com>
4and the JF Project team <www.linux.or.jp/JF>.
5If you find any difference between this document and the original file
6or a problem with the translation,
7please contact the maintainer of this file or JF project.
Tsugikazu Shibata73fd6252007-06-12 17:16:12 +09008
Tsugikazu Shibata8b436262007-07-19 11:24:54 +09009Please also note that the purpose of this file is to be easier to read
10for non English (read: Japanese) speakers and is not intended as a
11fork. So if you have any comments or updates for this file, please try
12to update the original English file first.
Tsugikazu Shibata73fd6252007-06-12 17:16:12 +090013
Tsugikazu Shibatae11d0442007-11-30 18:59:18 +090014Last Updated: 2007/11/16
Tsugikazu Shibata73fd6252007-06-12 17:16:12 +090015==================================
16これは、
Tsugikazu Shibatae11d0442007-11-30 18:59:18 +090017linux-2.6.24/Documentation/HOWTO
Tsugikazu Shibata73fd6252007-06-12 17:16:12 +090018の和訳です。
19
20翻訳団体: JF プロジェクト < http://www.linux.or.jp/JF/ >
Tsugikazu Shibatae11d0442007-11-30 18:59:18 +090021翻訳日: 2007/11/10
Tsugikazu Shibata73fd6252007-06-12 17:16:12 +090022翻訳者: Tsugikazu Shibata <tshibata at ab dot jp dot nec dot com>
23校正者: 松倉さん <nbh--mats at nifty dot com>
24 小林 雅典さん (Masanori Kobayasi) <zap03216 at nifty dot ne dot jp>
25 武井伸光さん、<takei at webmasters dot gr dot jp>
26 かねこさん (Seiji Kaneko) <skaneko at a2 dot mbn dot or dot jp>
27 野口さん (Kenji Noguchi) <tokyo246 at gmail dot com>
28 河内さん (Takayoshi Kochi) <t-kochi at bq dot jp dot nec dot com>
29 岩本さん (iwamoto) <iwamoto.kn at ncos dot nec dot co dot jp>
Tsugikazu Shibata3b6662f2007-09-25 01:54:26 +090030 内田さん (Satoshi Uchida) <s-uchida at ap dot jp dot nec dot com>
Tsugikazu Shibata73fd6252007-06-12 17:16:12 +090031==================================
32
33Linux カーネル開発のやり方
34-------------------------------
35
36これは上のトピック( Linux カーネル開発のやり方)の重要な事柄を網羅した
37ドキュメントです。ここには Linux カーネル開発者になるための方法と
38Linux カーネル開発コミュニティと共に活動するやり方を学ぶ方法が含まれて
39います。カーネルプログラミングに関する技術的な項目に関することは何も含
40めないようにしていますが、カーネル開発者となるための正しい方向に向かう
41手助けになります。
42
43もし、このドキュメントのどこかが古くなっていた場合には、このドキュメン
Tsugikazu Shibata3b6662f2007-09-25 01:54:26 +090044トの最後にリストしたメンテナにパッチを送ってください。
Tsugikazu Shibata73fd6252007-06-12 17:16:12 +090045
46はじめに
47---------
48
49あなたは Linux カーネルの開発者になる方法を学びたいのでしょうか? そ
50れともあなたは上司から「このデバイスの Linux ドライバを書くように」と
51言われているのでしょうか? 
52この文書の目的は、あなたが踏むべき手順と、コミュニティと一緒にうまく働
53くヒントを書き下すことで、あなたが知るべき全てのことを教えることです。
54また、このコミュニティがなぜ今うまくまわっているのかという理由の一部も
55説明しようと試みています。
56
Tsugikazu Shibata8b436262007-07-19 11:24:54 +090057
Tsugikazu Shibata73fd6252007-06-12 17:16:12 +090058カーネルは 少量のアーキテクチャ依存部分がアセンブリ言語で書かれている
59以外は大部分は C 言語で書かれています。C言語をよく理解していることはカー
60ネル開発者には必要です。アーキテクチャ向けの低レベル部分の開発をするの
61でなければ、(どんなアーキテクチャでも)アセンブリ(訳注: 言語)は必要あり
62ません。以下の本は、C 言語の十分な知識や何年もの経験に取って代わるもの
Tsugikazu Shibata3b6662f2007-09-25 01:54:26 +090063ではありませんが、少なくともリファレンスとしては良い本です。
Tsugikazu Shibata73fd6252007-06-12 17:16:12 +090064 - "The C Programming Language" by Kernighan and Ritchie [Prentice Hall]
65 -『プログラミング言語C第2版』(B.W. カーニハン/D.M. リッチー著 石田晴久訳) [共立出版]
66 - "Practical C Programming" by Steve Oualline [O'Reilly]
67 - 『C実践プログラミング第3版』(Steve Oualline著 望月康司監訳 谷口功訳) [オライリージャパン]
68 - "C: A Reference Manual" by Harbison and Steele [Prentice Hall]
69 - 『新・詳説 C 言語 H&S リファレンス』
70 (サミュエル P ハービソン/ガイ L スティール共著 斉藤 信男監訳)[ソフトバンク]
71
72カーネルは GNU C と GNU ツールチェインを使って書かれています。カーネル
73は ISO C89 仕様に準拠して書く一方で、標準には無い言語拡張を多く使って
74います。カーネルは標準 C ライブラリとは関係がないといった、C 言語フリー
75スタンディング環境です。そのため、C の標準で使えないものもあります。任
76意の long long の除算や浮動小数点は使えません。
77ときどき、カーネルがツールチェインや C 言語拡張に置いている前提がどう
78なっているのかわかりにくいことがあり、また、残念なことに決定的なリファ
79レンスは存在しません。情報を得るには、gcc の info ページ( info gcc )を
Tsugikazu Shibata3b6662f2007-09-25 01:54:26 +090080見てください。
Tsugikazu Shibata73fd6252007-06-12 17:16:12 +090081
82あなたは既存の開発コミュニティと一緒に作業する方法を学ぼうとしているこ
83とに留意してください。そのコミュニティは、コーディング、スタイル、
84開発手順について高度な標準を持つ、多様な人の集まりです。
85地理的に分散した大規模なチームに対してもっともうまくいくとわかったこと
86をベースにしながら、これらの標準は長い時間をかけて築かれてきました。
87これらはきちんと文書化されていますから、事前にこれらの標準についてでき
88るだけたくさん学んでください。また皆があなたやあなたの会社のやり方に合わ
89せてくれると思わないでください。
90
91法的問題
92------------
93
94Linux カーネルのソースコードは GPL ライセンスの下でリリースされていま
95す。ライセンスの詳細については、ソースツリーのメインディレクトリに存在
Tsugikazu Shibata3b6662f2007-09-25 01:54:26 +090096する、COPYING のファイルを見てください。もしライセンスについてさらに質
Tsugikazu Shibata73fd6252007-06-12 17:16:12 +090097問があれば、Linux Kernel メーリングリストに質問するのではなく、どうぞ
98法律家に相談してください。メーリングリストの人達は法律家ではなく、法的
99問題については彼らの声明はあてにするべきではありません。
100
101GPL に関する共通の質問や回答については、以下を参照してください。
102 http://www.gnu.org/licenses/gpl-faq.html
103
104ドキュメント
105------------
106
107Linux カーネルソースツリーは幅広い範囲のドキュメントを含んでおり、それ
108らはカーネルコミュニティと会話する方法を学ぶのに非常に貴重なものです。
109新しい機能がカーネルに追加される場合、その機能の使い方について説明した
110新しいドキュメントファイルも追加することを勧めます。
111カーネルの変更が、カーネルがユーザ空間に公開しているインターフェイスの
112変更を引き起こす場合、その変更を説明するマニュアルページのパッチや情報
Tsugikazu Shibatae11d0442007-11-30 18:59:18 +0900113をマニュアルページのメンテナ mtk.manpages@gmail.com に送ることを勧めま
Tsugikazu Shibata3b6662f2007-09-25 01:54:26 +0900114す。
Tsugikazu Shibata73fd6252007-06-12 17:16:12 +0900115
116以下はカーネルソースツリーに含まれている読んでおくべきファイルの一覧で
117す-
118
119 README
120 このファイルは Linuxカーネルの簡単な背景とカーネルを設定(訳注
121 configure )し、生成(訳注 build )するために必要なことは何かが書かれ
Tsugikazu Shibata3b6662f2007-09-25 01:54:26 +0900122 ています。カーネルに関して初めての人はここからスタートすると良いで
Tsugikazu Shibata73fd6252007-06-12 17:16:12 +0900123 しょう。
124
125 Documentation/Changes
126 このファイルはカーネルをうまく生成(訳注 build )し、走らせるのに最
127 小限のレベルで必要な数々のソフトウェアパッケージの一覧を示してい
128 ます。
129
130 Documentation/CodingStyle
131 これは Linux カーネルのコーディングスタイルと背景にある理由を記述
132 しています。全ての新しいコードはこのドキュメントにあるガイドライン
Tsugikazu Shibata3b6662f2007-09-25 01:54:26 +0900133 に従っていることを期待されています。大部分のメンテナはこれらのルー
Tsugikazu Shibata73fd6252007-06-12 17:16:12 +0900134 ルに従っているものだけを受け付け、多くの人は正しいスタイルのコード
135 だけをレビューします。
136
137 Documentation/SubmittingPatches
138 Documentation/SubmittingDrivers
139 これらのファイルには、どうやってうまくパッチを作って投稿するかに
140 ついて非常に詳しく書かれており、以下を含みます(これだけに限らない
141 けれども)
142 - Email に含むこと
143 - Email の形式
144 - だれに送るか
145 これらのルールに従えばうまくいくことを保証することではありません
146 が (すべてのパッチは内容とスタイルについて精査を受けるので)、
147 ルールに従わなければ間違いなくうまくいかないでしょう。
Tsugikazu Shibata8b436262007-07-19 11:24:54 +0900148
Tsugikazu Shibata73fd6252007-06-12 17:16:12 +0900149 この他にパッチを作る方法についてのよくできた記述は-
150
151 "The Perfect Patch"
152 http://www.zip.com.au/~akpm/linux/patches/stuff/tpp.txt
153 "Linux kernel patch submission format"
154 http://linux.yyz.us/patch-format.html
155
156 Documentation/stable_api_nonsense.txt
157 このファイルはカーネルの中に不変のAPIを持たないことにした意識的な
158 決断の背景にある理由について書かれています。以下のようなことを含
159 んでいます-
160 - サブシステムとの間に層を作ること(コンパチビリティのため?)
161 - オペレーティングシステム間のドライバの移植性
162 - カーネルソースツリーの素早い変更を遅らせる(もしくは素早い変更
163 を妨げる)
164 このドキュメントは Linux 開発の思想を理解するのに非常に重要です。
165 そして、他のOSでの開発者が Linux に移る時にとても重要です。
166
167 Documentation/SecurityBugs
168 もし Linux カーネルでセキュリティ問題を発見したように思ったら、こ
169 のドキュメントのステップに従ってカーネル開発者に連絡し、問題解決を
170 支援してください。
171
172 Documentation/ManagementStyle
Tsugikazu Shibata3b6662f2007-09-25 01:54:26 +0900173 このドキュメントは Linux カーネルのメンテナ達がどう行動するか、
Tsugikazu Shibata73fd6252007-06-12 17:16:12 +0900174 彼らの手法の背景にある共有されている精神について記述しています。こ
175 れはカーネル開発の初心者なら(もしくは、単に興味があるだけの人でも)
Tsugikazu Shibata3b6662f2007-09-25 01:54:26 +0900176 重要です。なぜならこのドキュメントは、カーネルメンテナ達の独特な
Tsugikazu Shibata73fd6252007-06-12 17:16:12 +0900177 行動についての多くの誤解や混乱を解消するからです。
178
179 Documentation/stable_kernel_rules.txt
180 このファイルはどのように stable カーネルのリリースが行われるかのルー
181 ルが記述されています。そしてこれらのリリースの中のどこかで変更を取
Tsugikazu Shibata3b6662f2007-09-25 01:54:26 +0900182 り入れてもらいたい場合に何をすれば良いかが示されています。
Tsugikazu Shibata73fd6252007-06-12 17:16:12 +0900183
184 Documentation/kernel-docs.txt
185  カーネル開発に付随する外部ドキュメントのリストです。もしあなたが
186 探しているものがカーネル内のドキュメントでみつからなかった場合、
187 このリストをあたってみてください。
188
189 Documentation/applying-patches.txt
190 パッチとはなにか、パッチをどうやって様々なカーネルの開発ブランチに
191 適用するのかについて正確に記述した良い入門書です。
192
193カーネルはソースコードから自動的に生成可能な多数のドキュメントを自分自
194身でもっています。これにはカーネル内 API のすべての記述や、どう正しく
195ロックをかけるかの規則が含まれます。このドキュメントは
196Documentation/DocBook/ ディレクトリに作られ、以下のように
197 make pdfdocs
198 make psdocs
199 make htmldocs
200 make mandocs
201コマンドを実行するとメインカーネルのソースディレクトリから
202それぞれ、PDF, Postscript, HTML, man page の形式で生成されます。
203
204カーネル開発者になるには
205---------------------------
206
207もしあなたが、Linux カーネル開発について何も知らないならば、
208KernelNewbies プロジェクトを見るべきです
209 http://kernelnewbies.org
210
211このサイトには役に立つメーリングリストがあり、基本的なカーネル開発に関
212するほとんどどんな種類の質問もできます (既に回答されているようなことを
213聞く前にまずはアーカイブを調べてください)。
214またここには、リアルタイムで質問を聞くことができる IRC チャネルや、Linux
215カーネルの開発に関して学ぶのに便利なたくさんの役に立つドキュメントがあ
216ります。
217
218web サイトには、コードの構成、サブシステム、現在存在するプロジェクト(ツ
219リーにあるもの無いものの両方)の基本的な管理情報があります。
220ここには、また、カーネルのコンパイルのやり方やパッチの当て方などの間接
221的な基本情報も記述されています。
222
Tsugikazu Shibata3b6662f2007-09-25 01:54:26 +0900223あなたがどこからスタートして良いかわからないが、Linux カーネル開発コミュ
Tsugikazu Shibata73fd6252007-06-12 17:16:12 +0900224ニティに参加して何かすることをさがしている場合には、Linux kernel
Tsugikazu Shibata3b6662f2007-09-25 01:54:26 +0900225Janitor's プロジェクトにいけば良いでしょう -
Tsugikazu Shibata73fd6252007-06-12 17:16:12 +0900226 http://janitor.kernelnewbies.org/
227ここはそのようなスタートをするのにうってつけの場所です。ここには、
228Linux カーネルソースツリーの中に含まれる、きれいにし、修正しなければな
229らない、単純な問題のリストが記述されています。このプロジェクトに関わる
230開発者と一緒に作業することで、あなたのパッチを Linuxカーネルツリーに入
231れるための基礎を学ぶことができ、そしてもしあなたがまだアイディアを持っ
232ていない場合には、次にやる仕事の方向性が見えてくるかもしれません。
233
234もしあなたが、すでにひとまとまりコードを書いていて、カーネルツリーに入
235れたいと思っていたり、それに関する適切な支援を求めたい場合、カーネル
236メンターズプロジェクトはそのような皆さんを助けるためにできました。
237ここにはメーリングリストがあり、以下から参照できます
238 http://selenic.com/mailman/listinfo/kernel-mentors
239
240実際に Linux カーネルのコードについて修正を加える前に、どうやってその
241コードが動作するのかを理解することが必要です。そのためには、特別なツー
242ルの助けを借りてでも、それを直接よく読むことが最良の方法です(ほとんど
243のトリッキーな部分は十分にコメントしてありますから)。そういうツールで
244特におすすめなのは、Linux クロスリファレンスプロジェクトです。これは、
245自己参照方式で、索引がついた web 形式で、ソースコードを参照することが
246できます。この最新の素晴しいカーネルコードのリポジトリは以下で見つかり
247ます-
Tsugikazu Shibata3b6662f2007-09-25 01:54:26 +0900248 http://sosdg.org/~qiyong/lxr/
Tsugikazu Shibata73fd6252007-06-12 17:16:12 +0900249
250開発プロセス
251-----------------------
252
253Linux カーネルの開発プロセスは現在幾つかの異なるメインカーネル「ブラン
254チ」と多数のサブシステム毎のカーネルブランチから構成されます。
255これらのブランチとは-
256 - メインの 2.6.x カーネルツリー
257 - 2.6.x.y -stable カーネルツリー
258 - 2.6.x -git カーネルパッチ
259 - 2.6.x -mm カーネルパッチ
260 - サブシステム毎のカーネルツリーとパッチ
261
2622.6.x カーネルツリー
263-----------------
264
2652.6.x カーネルは Linus Torvalds によってメンテナンスされ、kernel.org
266の pub/linux/kernel/v2.6/ ディレクトリに存在します。この開発プロセスは
267以下のとおり-
268
269 - 新しいカーネルがリリースされた直後に、2週間の特別期間が設けられ、
Tsugikazu Shibata3b6662f2007-09-25 01:54:26 +0900270 この期間中に、メンテナ達は Linus に大きな差分を送ることができます。
271 このような差分は通常 -mm カーネルに数週間含まれてきたパッチです。
272 大きな変更は git(カーネルのソース管理ツール、詳細は
Tsugikazu Shibata73fd6252007-06-12 17:16:12 +0900273 http://git.or.cz/ 参照) を使って送るのが好ましいやり方ですが、パッ
274 チファイルの形式のまま送るのでも十分です。
275
276 - 2週間後、-rc1 カーネルがリリースされ、この後にはカーネル全体の安定
277 性に影響をあたえるような新機能は含まない類のパッチしか取り込むこと
278 はできません。新しいドライバ(もしくはファイルシステム)のパッチは
279 -rc1 の後で受け付けられることもあることを覚えておいてください。な
280 ぜなら、変更が独立していて、追加されたコードの外の領域に影響を与え
281 ない限り、退行のリスクは無いからです。-rc1 がリリースされた後、
282 Linus へパッチを送付するのに git を使うこともできますが、パッチは
283 レビューのために、パブリックなメーリングリストへも同時に送る必要が
284 あります。
285
286 - 新しい -rc は Linus が、最新の git ツリーがテスト目的であれば十分
287 に安定した状態にあると判断したときにリリースされます。目標は毎週新
288 しい -rc カーネルをリリースすることです。
289
Tsugikazu Shibata3b6662f2007-09-25 01:54:26 +0900290 - 以下の URL で各 -rc リリースに存在する既知の後戻り問題のリスト
291 が追跡されます-
292 http://kernelnewbies.org/known_regressions
293
Tsugikazu Shibata73fd6252007-06-12 17:16:12 +0900294 - このプロセスはカーネルが 「準備ができた」と考えられるまで継続しま
295 す。このプロセスはだいたい 6週間継続します。
296
297Andrew Morton が Linux-kernel メーリングリストにカーネルリリースについ
298て書いたことをここで言っておくことは価値があります-
299 「カーネルがいつリリースされるかは誰も知りません。なぜなら、これは現
300 実に認識されたバグの状況によりリリースされるのであり、前もって決めら
301 れた計画によってリリースされるものではないからです。」
302
3032.6.x.y -stable カーネルツリー
304---------------------------
305
306バージョンに4つ目の数字がついたカーネルは -stable カーネルです。これに
307は、2.6.x カーネルで見つかったセキュリティ問題や重大な後戻りに対する比
308較的小さい重要な修正が含まれます。
309
310これは、開発/実験的バージョンのテストに協力することに興味が無く、
311最新の安定したカーネルを使いたいユーザに推奨するブランチです。
312
313もし、2.6.x.y カーネルが存在しない場合には、番号が一番大きい 2.6.x
314が最新の安定版カーネルです。
315
3162.6.x.y は "stable" チーム <stable@kernel.org> でメンテされており、だ
317いたい隔週でリリースされています。
318
319カーネルツリーに入っている、Documentation/stable_kernel_rules.txt ファ
320イルにはどのような種類の変更が -stable ツリーに受け入れ可能か、またリ
321リースプロセスがどう動くかが記述されています。
322
3232.6.x -git パッチ
324------------------
325
326git リポジトリで管理されているLinus のカーネルツリーの毎日のスナップ
327ショットがあります。(だから -git という名前がついています)。これらのパッ
328チはおおむね毎日リリースされており、Linus のツリーの現状を表します。こ
329れは -rc カーネルと比べて、パッチが大丈夫かどうかも確認しないで自動的
330に生成されるので、より実験的です。
331
3322.6.x -mm カーネルパッチ
333------------------------
334
335Andrew Morton によってリリースされる実験的なカーネルパッチ群です。
336Andrew は個別のサブシステムカーネルツリーとパッチを全て集めてきて
337linux-kernel メーリングリストで収集された多数のパッチと同時に一つにま
338とめます。
339このツリーは新機能とパッチが検証される場となります。ある期間の間パッチ
Tsugikazu Shibata3b6662f2007-09-25 01:54:26 +0900340が -mm に入って価値を証明されたら、Andrew やサブシステムメンテナが、
341メインラインへ入れるように Linus にプッシュします。
Tsugikazu Shibata73fd6252007-06-12 17:16:12 +0900342
343メインカーネルツリーに含めるために Linus に送る前に、すべての新しいパッ
344チが -mm ツリーでテストされることが強く推奨されます。
345
346これらのカーネルは安定して動作すべきシステムとして使うのには適切ではあ
347りませんし、カーネルブランチの中でももっとも動作にリスクが高いものです。
348
349もしあなたが、カーネル開発プロセスの支援をしたいと思っているのであれば、
350どうぞこれらのカーネルリリースをテストに使ってみて、そしてもし問題があ
351れば、またもし全てが正しく動作したとしても、linux-kernel メーリングリ
352ストにフィードバックを提供してください。
353
354すべての他の実験的パッチに加えて、これらのカーネルは通常リリース時点で
355メインラインの -git カーネルに含まれる全ての変更も含んでいます。
356
357-mm カーネルは決まったスケジュールではリリースされません、しかし通常幾
358つかの -mm カーネル (1 から 3 が普通)が各-rc カーネルの間にリリースさ
359れます。
360
361サブシステム毎のカーネルツリーとパッチ
362-------------------------------------------
363
364カーネルの様々な領域で何が起きているかを見られるようにするため、多くの
365カーネルサブシステム開発者は彼らの開発ツリーを公開しています。これらの
366ツリーは説明したように -mm カーネルリリースに入れ込まれます。
367
368以下はさまざまなカーネルツリーの中のいくつかのリスト-
369
370 git ツリー-
371 - Kbuild の開発ツリー、Sam Ravnborg <sam@ravnborg.org>
Tsugikazu Shibata8b436262007-07-19 11:24:54 +0900372 git.kernel.org:/pub/scm/linux/kernel/git/sam/kbuild.git
Tsugikazu Shibata73fd6252007-06-12 17:16:12 +0900373
374 - ACPI の開発ツリー、 Len Brown <len.brown@intel.com>
Tsugikazu Shibata8b436262007-07-19 11:24:54 +0900375 git.kernel.org:/pub/scm/linux/kernel/git/lenb/linux-acpi-2.6.git
Tsugikazu Shibata73fd6252007-06-12 17:16:12 +0900376
377 - Block の開発ツリー、Jens Axboe <axboe@suse.de>
Tsugikazu Shibata8b436262007-07-19 11:24:54 +0900378 git.kernel.org:/pub/scm/linux/kernel/git/axboe/linux-2.6-block.git
Tsugikazu Shibata73fd6252007-06-12 17:16:12 +0900379
380 - DRM の開発ツリー、Dave Airlie <airlied@linux.ie>
Tsugikazu Shibata8b436262007-07-19 11:24:54 +0900381 git.kernel.org:/pub/scm/linux/kernel/git/airlied/drm-2.6.git
Tsugikazu Shibata73fd6252007-06-12 17:16:12 +0900382
383 - ia64 の開発ツリー、Tony Luck <tony.luck@intel.com>
Tsugikazu Shibata8b436262007-07-19 11:24:54 +0900384 git.kernel.org:/pub/scm/linux/kernel/git/aegl/linux-2.6.git
Tsugikazu Shibata73fd6252007-06-12 17:16:12 +0900385
386 - infiniband, Roland Dreier <rolandd@cisco.com>
Tsugikazu Shibata8b436262007-07-19 11:24:54 +0900387 git.kernel.org:/pub/scm/linux/kernel/git/roland/infiniband.git
Tsugikazu Shibata73fd6252007-06-12 17:16:12 +0900388
389 - libata, Jeff Garzik <jgarzik@pobox.com>
Tsugikazu Shibata8b436262007-07-19 11:24:54 +0900390 git.kernel.org:/pub/scm/linux/kernel/git/jgarzik/libata-dev.git
Tsugikazu Shibata73fd6252007-06-12 17:16:12 +0900391
392 - ネットワークドライバ, Jeff Garzik <jgarzik@pobox.com>
Tsugikazu Shibata8b436262007-07-19 11:24:54 +0900393 git.kernel.org:/pub/scm/linux/kernel/git/jgarzik/netdev-2.6.git
Tsugikazu Shibata73fd6252007-06-12 17:16:12 +0900394
395 - pcmcia, Dominik Brodowski <linux@dominikbrodowski.net>
Tsugikazu Shibata8b436262007-07-19 11:24:54 +0900396 git.kernel.org:/pub/scm/linux/kernel/git/brodo/pcmcia-2.6.git
Tsugikazu Shibata73fd6252007-06-12 17:16:12 +0900397
398 - SCSI, James Bottomley <James.Bottomley@SteelEye.com>
Tsugikazu Shibata8b436262007-07-19 11:24:54 +0900399 git.kernel.org:/pub/scm/linux/kernel/git/jejb/scsi-misc-2.6.git
Tsugikazu Shibata73fd6252007-06-12 17:16:12 +0900400
401 quilt ツリー-
402 - USB, PCI ドライバコアと I2C, Greg Kroah-Hartman <gregkh@suse.de>
403 kernel.org/pub/linux/kernel/people/gregkh/gregkh-2.6/
Tsugikazu Shibata8b436262007-07-19 11:24:54 +0900404 - x86-64 と i386 の仲間 Andi Kleen <ak@suse.de>
405
406 その他のカーネルツリーは http://git.kernel.org/ と MAINTAINERS ファ
407 イルに一覧表があります。
Tsugikazu Shibata73fd6252007-06-12 17:16:12 +0900408
409バグレポート
410-------------
411
412bugzilla.kernel.org は Linux カーネル開発者がカーネルのバグを追跡する
413場所です。ユーザは見つけたバグの全てをこのツールで報告すべきです。
414どう kernel bugzilla を使うかの詳細は、以下を参照してください-
415 http://test.kernel.org/bugzilla/faq.html
416
417メインカーネルソースディレクトリにあるファイル REPORTING-BUGS はカーネ
418ルバグらしいものについてどうレポートするかの良いテンプレートであり、問
419題の追跡を助けるためにカーネル開発者にとってどんな情報が必要なのかの詳
420細が書かれています。
421
422メーリングリスト
423-------------
424
425上のいくつかのドキュメントで述べていますが、コアカーネル開発者の大部分
426は Linux kernel メーリングリストに参加しています。このリストの登録/脱
427退の方法については以下を参照してください-
428 http://vger.kernel.org/vger-lists.html#linux-kernel
429
430このメーリングリストのアーカイブは web 上の多数の場所に存在します。こ
431れらのアーカイブを探すにはサーチエンジンを使いましょう。例えば-
432 http://dir.gmane.org/gmane.linux.kernel
433
434リストに投稿する前にすでにその話題がアーカイブに存在するかどうかを検索
435することを是非やってください。多数の事がすでに詳細に渡って議論されて
436おり、アーカイブにのみ記録されています。
437
438大部分のカーネルサブシステムも自分の個別の開発を実施するメーリングリス
439トを持っています。個々のグループがどんなリストを持っているかは、
440MAINTAINERS ファイルにリストがありますので参照してください。
441
442多くのリストは kernel.org でホストされています。これらの情報は以下にあ
443ります-
444 http://vger.kernel.org/vger-lists.html
445
446メーリングリストを使う場合、良い行動習慣に従うようにしましょう。
447少し安っぽいが、以下の URL は上のリスト(や他のリスト)で会話する場合の
448シンプルなガイドラインを示しています-
449 http://www.albion.com/netiquette/
450
451もし複数の人があなたのメールに返事をした場合、CC: で受ける人のリストは
452だいぶ多くなるでしょう。良い理由がない場合、CC: リストから誰かを削除を
453しないように、また、メーリングリストのアドレスだけにリプライすることの
454ないようにしましょう。1つは送信者から、もう1つはリストからのように、メー
455ルを2回受けることになってもそれに慣れ、しゃれたメールヘッダーを追加し
456てこの状態を変えようとしないように。人々はそのようなことは好みません。
457
458今までのメールでのやりとりとその間のあなたの発言はそのまま残し、
459"John Kernlehacker wrote ...:" の行をあなたのリプライの先頭行にして、
460メールの先頭でなく、各引用行の間にあなたの言いたいことを追加するべきで
461す。
462
463もしパッチをメールに付ける場合は、Documentaion/SubmittingPatches に提
464示されているように、それは プレーンな可読テキストにすることを忘れない
465ようにしましょう。カーネル開発者は 添付や圧縮したパッチを扱いたがりま
466せん-
467彼らはあなたのパッチの行毎にコメントを入れたいので、そのためにはそうす
468るしかありません。あなたのメールプログラムが空白やタブを圧縮しないよう
Tsugikazu Shibata3b6662f2007-09-25 01:54:26 +0900469に確認した方が良いです。最初の良いテストとしては、自分にメールを送って
Tsugikazu Shibata73fd6252007-06-12 17:16:12 +0900470みて、そのパッチを自分で当ててみることです。もしそれがうまく行かないな
471ら、あなたのメールプログラムを直してもらうか、正しく動くように変えるべ
472きです。
473
474とりわけ、他の登録者に対する尊敬を表すようにすることを覚えておいてくだ
475さい。
476
477コミュニティと共に働くこと
478--------------------------
479
480カーネルコミュニティのゴールは可能なかぎり最高のカーネルを提供すること
481です。あなたがパッチを受け入れてもらうために投稿した場合、それは、技術
482的メリットだけがレビューされます。その際、あなたは何を予想すべきでしょ
483うか?
484 - 批判
485 - コメント
486 - 変更の要求
487 - パッチの正当性の証明要求
488 - 沈黙
489
490思い出してください、ここはあなたのパッチをカーネルに入れる話です。あ
491なたは、あなたのパッチに対する批判とコメントを受け入れるべきで、それら
492を技術的レベルで評価して、パッチを再作成するか、なぜそれらの変更をすべ
493きでないかを明確で簡潔な理由の説明を提供してください。
494もし、あなたのパッチに何も反応がない場合、たまにはメールの山に埋もれて
495見逃され、あなたの投稿が忘れられてしまうこともあるので、数日待って再度
496投稿してください。
497
498あなたがやるべきでないものは?
499 - 質問なしにあなたのパッチが受け入れられると想像すること
500 - 守りに入ること
501 - コメントを無視すること
502 - 要求された変更を何もしないでパッチを出し直すこと
503
504可能な限り最高の技術的解決を求めているコミュニティでは、パッチがどのく
505らい有益なのかについては常に異なる意見があります。あなたは協調的である
506べきですし、また、あなたのアイディアをカーネルに対してうまく合わせるよ
507うにすることが望まれています。もしくは、最低限あなたのアイディアがそれ
508だけの価値があるとすすんで証明するようにしなければなりません。
509正しい解決に向かって進もうという意志がある限り、間違うことがあっても許
510容されることを忘れないでください。
511
512あなたの最初のパッチに単に 1ダースもの修正を求めるリストの返答になるこ
513とも普通のことです。これはあなたのパッチが受け入れられないということで
514は *ありません*、そしてあなた自身に反対することを意味するのでも *ありま
515せん*。単に自分のパッチに対して指摘された問題を全て修正して再送すれば
Tsugikazu Shibata3b6662f2007-09-25 01:54:26 +0900516良いのです。
Tsugikazu Shibata73fd6252007-06-12 17:16:12 +0900517
Tsugikazu Shibata8b436262007-07-19 11:24:54 +0900518
Tsugikazu Shibata73fd6252007-06-12 17:16:12 +0900519カーネルコミュニティと企業組織のちがい
520-----------------------------------------------------------------
521
522カーネルコミュニティは大部分の伝統的な会社の開発環境とは異ったやり方で
Tsugikazu Shibata3b6662f2007-09-25 01:54:26 +0900523動いています。以下は問題を避けるためにできると良いことのリストです-
Tsugikazu Shibata73fd6252007-06-12 17:16:12 +0900524
525 あなたの提案する変更について言うときのうまい言い方:
526
527 - "これは複数の問題を解決します"
528 - "これは2000行のコードを削除します"
529 - "以下のパッチは、私が言おうとしていることを説明するものです"
530 - "私はこれを5つの異なるアーキテクチャでテストしたのですが..."
531 - "以下は一連の小さなパッチ群ですが..."
532 - "これは典型的なマシンでの性能を向上させます.."
533
Tsugikazu Shibata3b6662f2007-09-25 01:54:26 +0900534 やめた方が良い悪い言い方:
Tsugikazu Shibata73fd6252007-06-12 17:16:12 +0900535
536 - このやり方で AIX/ptx/Solaris ではできたので、できるはずだ
537 - 私はこれを20年もの間やってきた、だから
538 - これは、私の会社が金儲けをするために必要だ
539 - これは我々のエンタープライズ向け商品ラインのためである
540 - これは 私が自分のアイディアを記述した、1000ページの設計資料である
541 - 私はこれについて、6ケ月作業している。
542 - 以下は ... に関する5000行のパッチです
543 - 私は現在のぐちゃぐちゃを全部書き直した、それが以下です...
544 - 私は〆切がある、そのためこのパッチは今すぐ適用される必要がある
545
546カーネルコミュニティが大部分の伝統的なソフトウェアエンジニアリングの労
547働環境と異なるもう一つの点は、やりとりに顔を合わせないということです。
548email と irc を第一のコミュニケーションの形とする一つの利点は、性別や
549民族の差別がないことです。Linux カーネルの職場環境は女性や少数民族を受
550容します。なぜなら、email アドレスによってのみあなたが認識されるからで
551す。
552国際的な側面からも活動領域を均等にするようにします。なぜならば、あなた
553は人の名前で性別を想像できないからです。ある男性が アンドレアという名
554前で、女性の名前は パット かもしれません (訳注 Andrea は米国では女性、
555それ以外(欧州など)では男性名として使われることが多い。同様に、Pat は
556Patricia (主に女性名)や Patrick (主に男性名)の略称)。
557Linux カーネルの活動をして、意見を表明したことがある大部分の女性は、前
558向きな経験をもっています。
559
560言葉の壁は英語が得意でない一部の人には問題になります。
561メーリングリストの中できちんとアイディアを交換するには、相当うまく英語
562を操れる必要があることもあります。そのため、あなたは自分のメール
563を送る前に英語で意味が通じているかをチェックすることをお薦めします。
564
565変更を分割する
566---------------------
567
568Linux カーネルコミュニティは、一度に大量のコードの塊を喜んで受容するこ
569とはありません。変更は正確に説明される必要があり、議論され、小さい、個
570別の部分に分割する必要があります。これはこれまで多くの会社がやり慣れて
571きたことと全く正反対のことです。あなたのプロポーザルは、開発プロセスのと
572ても早い段階から紹介されるべきです。そうすれば あなたは自分のやってい
573ることにフィードバックを得られます。これは、コミュニティからみれば、あ
574なたが彼らと一緒にやっているように感じられ、単にあなたの提案する機能の
575ゴミ捨て場として使っているのではない、と感じられるでしょう。
576しかし、一度に 50 もの email をメーリングリストに送りつけるようなことは
577やってはいけません、あなたのパッチ群はいつもどんな時でもそれよりは小さ
578くなければなりません。
579
580パッチを分割する理由は以下です-
581
5821) 小さいパッチはあなたのパッチが適用される見込みを大きくします、カー
583 ネルの人達はパッチが正しいかどうかを確認する時間や労力をかけないか
Tsugikazu Shibata3b6662f2007-09-25 01:54:26 +0900584 らです。5行のパッチはメンテナがたった1秒見るだけで適用できます。
585 しかし、500行のパッチは、正しいことをレビューするのに数時間かかるか
586 もしれません(時間はパッチのサイズなどにより指数関数に比例してかかり
587 ます)
Tsugikazu Shibata8b436262007-07-19 11:24:54 +0900588
Tsugikazu Shibata73fd6252007-06-12 17:16:12 +0900589 小さいパッチは何かあったときにデバッグもとても簡単になります。パッ
590 チを1個1個取り除くのは、とても大きなパッチを当てた後に(かつ、何かお
591 かしくなった後で)解剖するのに比べればとても簡単です。
592
5932) 小さいパッチを送るだけでなく、送るまえに、書き直して、シンプルにす
594 る(もしくは、単に順番を変えるだけでも)ことも、とても重要です。
595
Tsugikazu Shibata3b6662f2007-09-25 01:54:26 +0900596以下はカーネル開発者の Al Viro のたとえ話です:
Tsugikazu Shibata73fd6252007-06-12 17:16:12 +0900597
598 "生徒の数学の宿題を採点する先生のことを考えてみてください、先
Tsugikazu Shibata3b6662f2007-09-25 01:54:26 +0900599 生は生徒が解に到達するまでの試行錯誤を見たいとは思わないでしょ
600 う。先生は簡潔な最高の解を見たいのです。良い生徒はこれを知って
Tsugikazu Shibata73fd6252007-06-12 17:16:12 +0900601 おり、そして最終解の前の中間作業を提出することは決してないので
602 す"
Tsugikazu Shibata8b436262007-07-19 11:24:54 +0900603
Tsugikazu Shibata3b6662f2007-09-25 01:54:26 +0900604 カーネル開発でもこれは同じです。メンテナ達とレビューア達は、
605 問題を解決する解の背後になる思考プロセスを見たいとは思いません。
606 彼らは単純であざやかな解決方法を見たいのです。
Tsugikazu Shibata73fd6252007-06-12 17:16:12 +0900607
608あざやかな解を説明するのと、コミュニティと共に仕事をし、未解決の仕事を
609議論することのバランスをキープするのは難しいかもしれません。
610ですから、開発プロセスの早期段階で改善のためのフィードバックをもらうよ
Tsugikazu Shibata3b6662f2007-09-25 01:54:26 +0900611うにするのも良いですが、変更点を小さい部分に分割して全体ではまだ完成し
612ていない仕事を(部分的に)取り込んでもらえるようにすることも良いことです。
Tsugikazu Shibata73fd6252007-06-12 17:16:12 +0900613
614また、でき上がっていないものや、"将来直す" ようなパッチを、本流に含め
615てもらうように送っても、それは受け付けられないことを理解してください。
616
617あなたの変更を正当化する
618-------------------
619
620あなたのパッチを分割するのと同時に、なぜその変更を追加しなければならな
621いかを Linux コミュニティに知らせることはとても重要です。新機能は必要
622性と有用性で正当化されなければなりません。
623
624あなたの変更の説明
625--------------------
626
627あなたのパッチを送付する場合には、メールの中のテキストで何を言うかにつ
628いて、特別に注意を払ってください。この情報はパッチの ChangeLog に使わ
629れ、いつも皆がみられるように保管されます。これは次のような項目を含め、
630パッチを完全に記述するべきです-
631
632 - なぜ変更が必要か
633 - パッチ全体の設計アプローチ
634 - 実装の詳細
635 - テスト結果
636
637これについて全てがどのようにあるべきかについての詳細は、以下のドキュメ
Tsugikazu Shibata3b6662f2007-09-25 01:54:26 +0900638ントの ChangeLog セクションを見てください-
Tsugikazu Shibata73fd6252007-06-12 17:16:12 +0900639 "The Perfect Patch"
640 http://www.zip.com.au/~akpm/linux/patches/stuff/tpp.txt
641
642これらのどれもが、時にはとても困難です。これらの慣例を完璧に実施するに
643は数年かかるかもしれません。これは継続的な改善のプロセスであり、そのた
644めには多数の忍耐と決意を必要とするものです。でも、諦めないで、これは可
645能なことです。多数の人がすでにできていますし、彼らも皆最初はあなたと同
646じところからスタートしたのですから。
647
648Paolo Ciarrocchi に感謝、彼は彼の書いた "Development Process"
649(http://linux.tar.bz/articles/2.6-development_process)セクショ
650ンをこのテキストの原型にすることを許可してくれました。
651Rundy Dunlap と Gerrit Huizenga はメーリングリストでやるべきこととやっ
652てはいけないことのリストを提供してくれました。
653以下の人々のレビュー、コメント、貢献に感謝。
654Pat Mochel, Hanna Linder, Randy Dunlap, Kay Sievers,
655Vojtech Pavlik, Jan Kara, Josh Boyer, Kees Cook, Andrew Morton, Andi
656Kleen, Vadim Lobanov, Jesper Juhl, Adrian Bunk, Keri Harris, Frans Pop,
657David A. Wheeler, Junio Hamano, Michael Kerrisk, と Alex Shepard
658彼らの支援なしでは、このドキュメントはできなかったでしょう。
659
660Maintainer: Greg Kroah-Hartman <greg@kroah.com>