Merge git://git.kernel.org/pub/scm/linux/kernel/git/gregkh/driver-core-2.6 (61311e1b) · Commits · e / devices / android_kernel_xiaomi_markw

Documentation/ja_JP/HOWTO

+47 −20

Original line number	Diff line number	Diff line
		@@ -11,14 +11,14 @@ for non English (read: Japanese) speakers and is not intended as a
		fork. So if you have any comments or updates for this file, please try
		to update the original English file first.

		Last Updated: 2007/11/16
		Last Updated: 2008/08/21
		==================================
		これは、
		linux-2.6.24/Documentation/HOWTO
		linux-2.6.27/Documentation/HOWTO
		の和訳です。

		翻訳団体： JF プロジェクト < http://www.linux.or.jp/JF/ >
		翻訳日： 2007/11/10
		翻訳日： 2008/8/5
		翻訳者： Tsugikazu Shibata <tshibata at ab dot jp dot nec dot com>
		校正者：松倉さん <nbh--mats at nifty dot com>
		小林雅典さん (Masanori Kobayasi) <zap03216 at nifty dot ne dot jp>
		@@ -287,13 +287,15 @@ Linux カーネルの開発プロセスは現在幾つかの異なるメイン
		に安定した状態にあると判断したときにリリースされます。目標は毎週新
		しい -rc カーネルをリリースすることです。

		- 以下の URL で各 -rc リリースに存在する既知の後戻り問題のリスト
		が追跡されます-
		http://kernelnewbies.org/known_regressions

		- このプロセスはカーネルが「準備ができた」と考えられるまで継続しま
		す。このプロセスはだいたい 6週間継続します。

		- 各リリースでの既知の後戻り問題(regression: このリリースの中で新規
		に作り込まれた問題を指す) はその都度 Linux-kernel メーリングリスト
		に投稿されます。ゴールとしては、カーネルが「準備ができた」と宣言
		する前にこのリストの長さをゼロに減らすことですが、現実には、数個の
		後戻り問題がリリース時にたびたび残ってしまいます。

		Andrew Morton が Linux-kernel メーリングリストにカーネルリリースについ
		て書いたことをここで言っておくことは価値があります-
		「カーネルがいつリリースされるかは誰も知りません。なぜなら、これは現
		@@ -303,18 +305,20 @@ Andrew Morton が Linux-kernel メーリングリストにカーネルリリー
		2.6.x.y -stable カーネルツリー
		---------------------------

		バージョンに4つ目の数字がついたカーネルは -stable カーネルです。これに
		は、2.6.x カーネルで見つかったセキュリティ問題や重大な後戻りに対する比
		較的小さい重要な修正が含まれます。
		バージョン番号が4つの数字に分かれているカーネルは -stable カーネルです。
		これには、2.6.x カーネルで見つかったセキュリティ問題や重大な後戻りに対
		する比較的小さい重要な修正が含まれます。

		これは、開発/実験的バージョンのテストに協力することに興味が無く、
		最新の安定したカーネルを使いたいユーザに推奨するブランチです。

		もし、2.6.x.y カーネルが存在しない場合には、番号が一番大きい 2.6.x
		が最新の安定版カーネルです。
		もし、2.6.x.y カーネルが存在しない場合には、番号が一番大きい 2.6.x が
		最新の安定版カーネルです。

		2.6.x.y は "stable" チーム <stable@kernel.org> でメンテされており、だ
		いたい隔週でリリースされています。
		2.6.x.y は "stable" チーム <stable@kernel.org> でメンテされており、必
		要に応じてリリースされます。通常のリリース期間は 2週間毎ですが、差し迫っ
		た問題がなければもう少し長くなることもあります。セキュリティ関連の問題
		の場合はこれに対してだいたいの場合、すぐにリリースがされます。

		カーネルツリーに入っている、Documentation/stable_kernel_rules.txt ファ
		イルにはどのような種類の変更が -stable ツリーに受け入れ可能か、またリ
		@@ -341,7 +345,9 @@ linux-kernel メーリングリストで収集された多数のパッチと同
		メインラインへ入れるように Linus にプッシュします。

		メインカーネルツリーに含めるために Linus に送る前に、すべての新しいパッ
		チが -mm ツリーでテストされることが強く推奨されます。
		チが -mm ツリーでテストされることが強く推奨されています。マージウィン
		ドウが開く前に -mm ツリーに現れなかったパッチはメインラインにマージさ
		れることは困難になります。

		これらのカーネルは安定して動作すべきシステムとして使うのには適切ではあ
		りませんし、カーネルブランチの中でももっとも動作にリスクが高いものです。
		@@ -395,13 +401,15 @@ linux-kernel メーリングリストで収集された多数のパッチと同
		- pcmcia, Dominik Brodowski <linux@dominikbrodowski.net>
		git.kernel.org:/pub/scm/linux/kernel/git/brodo/pcmcia-2.6.git

		- SCSI, James Bottomley <James.Bottomley@SteelEye.com>
		- SCSI, James Bottomley <James.Bottomley@hansenpartnership.com>
		git.kernel.org:/pub/scm/linux/kernel/git/jejb/scsi-misc-2.6.git

		- x86, Ingo Molnar <mingo@elte.hu>
		git://git.kernel.org/pub/scm/linux/kernel/git/x86/linux-2.6-x86.git

		quilt ツリー-
		- USB, PCI ドライバコアと I2C, Greg Kroah-Hartman <gregkh@suse.de>
		- USB, ドライバコアと I2C, Greg Kroah-Hartman <gregkh@suse.de>
		kernel.org/pub/linux/kernel/people/gregkh/gregkh-2.6/
		- x86-64 と i386 の仲間 Andi Kleen <ak@suse.de>

		その他のカーネルツリーは http://git.kernel.org/ と MAINTAINERS ファ
		イルに一覧表があります。
		@@ -412,13 +420,32 @@ linux-kernel メーリングリストで収集された多数のパッチと同
		bugzilla.kernel.org は Linux カーネル開発者がカーネルのバグを追跡する
		場所です。ユーザは見つけたバグの全てをこのツールで報告すべきです。
		どう kernel bugzilla を使うかの詳細は、以下を参照してください-
		http://test.kernel.org/bugzilla/faq.html

		http://bugzilla.kernel.org/page.cgi?id=faq.html
		メインカーネルソースディレクトリにあるファイル REPORTING-BUGS はカーネ
		ルバグらしいものについてどうレポートするかの良いテンプレートであり、問
		題の追跡を助けるためにカーネル開発者にとってどんな情報が必要なのかの詳
		細が書かれています。

		バグレポートの管理
		-------------------

		あなたのハッキングのスキルを訓練する最高の方法のひとつに、他人がレポー
		トしたバグを修正することがあります。あなたがカーネルをより安定化させる
		こに寄与するということだけでなく、あなたは現実の問題を修正することを
		学び、自分のスキルも強化でき、また他の開発者があなたの存在に気がつき
		ます。バグを修正することは、多くの開発者の中から自分が功績をあげる最善
		の道です、なぜなら多くの人は他人のバグの修正に時間を浪費することを好ま
		ないからです。

		すでにレポートされたバグのために仕事をするためには、
		http://bugzilla.kernel.org に行ってください。もし今後のバグレポートに
		ついてアドバイスを受けたいのであれば、bugme-new メーリングリスト(新し
		いバグレポートだけがここにメールされる) または bugme-janitor メーリン
		グリスト(bugzilla の変更毎にここにメールされる)を購読できます。

		http://lists.linux-foundation.org/mailman/listinfo/bugme-new
		http://lists.linux-foundation.org/mailman/listinfo/bugme-janitors

		メーリングリスト
		-------------

Documentation/ja_JP/SubmitChecklist

0 → 100644

+111 −0

Original line number	Diff line number	Diff line
		NOTE:
		This is a version of Documentation/SubmitChecklist into Japanese.
		This document is maintained by Takenori Nagano <t-nagano@ah.jp.nec.com>
		and the JF Project team <http://www.linux.or.jp/JF/>.
		If you find any difference between this document and the original file
		or a problem with the translation,
		please contact the maintainer of this file or JF project.

		Please also note that the purpose of this file is to be easier to read
		for non English (read: Japanese) speakers and is not intended as a
		fork. So if you have any comments or updates of this file, please try
		to update the original English file first.

		Last Updated: 2008/07/14
		==================================
		これは、
		linux-2.6.26/Documentation/SubmitChecklist の和訳です。

		翻訳団体： JF プロジェクト < http://www.linux.or.jp/JF/ >
		翻訳日： 2008/07/14
		翻訳者： Takenori Nagano <t-nagano at ah dot jp dot nec dot com>
		校正者： Masanori Kobayashi さん <zap03216 at nifty dot ne dot jp>
		==================================


		Linux カーネルパッチ投稿者向けチェックリスト
		~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

		本書では、パッチをより素早く取り込んでもらいたい開発者が実践すべき基本的な事柄
		をいくつか紹介します。ここにある全ての事柄は、Documentation/SubmittingPatches
		などのLinuxカーネルパッチ投稿に際しての心得を補足するものです。

		1: 妥当なCONFIGオプションや変更されたCONFIGオプション、つまり =y, =m, =n
		全てで正しくビルドできることを確認してください。その際、gcc及びリンカが
		warningやerrorを出していないことも確認してください。

		2: allnoconfig, allmodconfig オプションを用いて正しくビルドできることを
		確認してください。

		3: 手許のクロスコンパイルツールやOSDLのPLMのようなものを用いて、複数の
		アーキテクチャにおいても正しくビルドできることを確認してください。

		4: 64bit長の'unsigned long'を使用しているppc64は、クロスコンパイルでの
		チェックに適当なアーキテクチャです。

		5: カーネルコーディングスタイルに準拠しているかどうか確認してください(!)

		6: CONFIGオプションの追加・変更をした場合には、CONFIGメニューが壊れていない
		ことを確認してください。

		7: 新しくKconfigのオプションを追加する際には、必ずそのhelpも記述してください。

		8: 適切なKconfigの依存関係を考えながら慎重にチェックしてください。
		ただし、この作業はマシンを使ったテストできちんと行うのがとても困難です。
		うまくやるには、自分の頭で考えることです。

		9: sparseを利用してちゃんとしたコードチェックをしてください。

		10: 'make checkstack' と 'make namespacecheck' を利用し、問題が発見されたら
		修正してください。'make checkstack' は明示的に問題を示しませんが、どれか
		１つの関数が512バイトより大きいスタックを使っていれば、修正すべき候補と
		なります。

		11: グローバルなkernel API を説明する kernel-doc をソースの中に含めてください。
		( staticな関数においては必須ではありませんが、含めてもらっても結構です )
		そして、'make htmldocs' もしくは 'make mandocs' を利用して追記した
		ドキュメントのチェックを行い、問題が見つかった場合には修正を行ってください。

		12: CONFIG_PREEMPT, CONFIG_DEBUG_PREEMPT, CONFIG_DEBUG_SLAB,
		CONFIG_DEBUG_PAGEALLOC, CONFIG_DEBUG_MUTEXES, CONFIG_DEBUG_SPINLOCK,
		CONFIG_DEBUG_SPINLOCK_SLEEP これら全てを同時に有効にして動作確認を
		行ってください。

		13: CONFIG_SMP, CONFIG_PREEMPT を有効にした場合と無効にした場合の両方で
		ビルドした上、動作確認を行ってください。

		14: もしパッチがディスクのI/O性能などに影響を与えるようであれば、
		'CONFIG_LBD'オプションを有効にした場合と無効にした場合の両方で
		テストを実施してみてください。

		15: lockdepの機能を全て有効にした上で、全てのコードパスを評価してください。

		16: /proc に新しいエントリを追加した場合には、Documentation/ 配下に
		必ずドキュメントを追加してください。

		17: 新しいブートパラメータを追加した場合には、
		必ずDocumentation/kernel-parameters.txt に説明を追加してください。

		18: 新しくmoduleにパラメータを追加した場合には、MODULE_PARM_DESC()を
		利用して必ずその説明を記述してください。

		19: 新しいuserspaceインタフェースを作成した場合には、Documentation/ABI/ に
		Documentation/ABI/README を参考にして必ずドキュメントを追加してください。

		20: 'make headers_check'を実行して全く問題がないことを確認してください。

		21: 少なくともslabアロケーションとpageアロケーションに失敗した場合の
		挙動について、fault-injectionを利用して確認してください。
		Documentation/fault-injection/ を参照してください。

		追加したコードがかなりの量であったならば、サブシステム特有の
		fault-injectionを追加したほうが良いかもしれません。

		22: 新たに追加したコードは、`gcc -W'でコンパイルしてください。
		このオプションは大量の不要なメッセージを出力しますが、
		"warning: comparison between signed and unsigned" のようなメッセージは、
		バグを見つけるのに役に立ちます。

		23: 投稿したパッチが -mm パッチセットにマージされた後、全ての既存のパッチや
		VM, VFS およびその他のサブシステムに関する様々な変更と、現時点でも共存
		できることを確認するテストを行ってください。

block/genhd.c

+24 −12

Original line number	Diff line number	Diff line
		@@ -293,27 +293,30 @@ void __init printk_all_partitions(void)
		/* iterator */
		static int find_start(struct device dev, void data)
		{
		loff_t k = (loff_t )data;
		loff_t *k = data;

		if (dev->type != &disk_type)
		return 0;
		if (!k--)
		if (!*k)
		return 1;
		(*k)--;
		return 0;
		}

		static void part_start(struct seq_file part, loff_t *pos)
		{
		struct device *dev;
		loff_t n = *pos;
		loff_t k = *pos;

		if (!n)
		if (!k)
		seq_puts(part, "major minor #blocks name\n\n");

		mutex_lock(&block_class_lock);
		dev = class_find_device(&block_class, NULL, (void *)pos, find_start);
		if (dev)
		dev = class_find_device(&block_class, NULL, &k, find_start);
		if (dev) {
		put_device(dev);
		return dev_to_disk(dev);
		}
		return NULL;
		}

		@@ -330,8 +333,10 @@ static void part_next(struct seq_file part, void v, loff_t pos)
		struct device *dev;
		++*pos;
		dev = class_find_device(&block_class, &gp->dev, NULL, find_next);
		if (dev)
		if (dev) {
		put_device(dev);
		return dev_to_disk(dev);
		}
		return NULL;
		}

		@@ -568,11 +573,14 @@ static struct device_type disk_type = {
		static void diskstats_start(struct seq_file part, loff_t *pos)
		{
		struct device *dev;
		loff_t k = *pos;

		mutex_lock(&block_class_lock);
		dev = class_find_device(&block_class, NULL, (void *)pos, find_start);
		if (dev)
		dev = class_find_device(&block_class, NULL, &k, find_start);
		if (dev) {
		put_device(dev);
		return dev_to_disk(dev);
		}
		return NULL;
		}

		@@ -583,8 +591,10 @@ static void diskstats_next(struct seq_file part, void v, loff_t pos)

		++*pos;
		dev = class_find_device(&block_class, &gp->dev, NULL, find_next);
		if (dev)
		if (dev) {
		put_device(dev);
		return dev_to_disk(dev);
		}
		return NULL;
		}

		@@ -712,10 +722,12 @@ dev_t blk_lookup_devt(const char *name, int part)
		mutex_lock(&block_class_lock);
		find.name = name;
		find.part = part;
		dev = class_find_device(&block_class, NULL, (void *)&find, match_id);
		if (dev)
		dev = class_find_device(&block_class, NULL, &find, match_id);
		if (dev) {
		put_device(dev);
		devt = MKDEV(MAJOR(dev->devt),
		MINOR(dev->devt) + part);
		}
		mutex_unlock(&block_class_lock);

		return devt;

drivers/base/class.c

+11 −0

Original line number	Diff line number	Diff line
		@@ -295,6 +295,12 @@ int class_for_each_device(struct class class, struct device start,

		if (!class)
		return -EINVAL;
		if (!class->p) {
		WARN(1, "%s called for class '%s' before it was initialized",
		__func__, class->name);
		return -EINVAL;
		}

		mutex_lock(&class->p->class_mutex);
		list_for_each_entry(dev, &class->p->class_devices, node) {
		if (start) {
		@@ -344,6 +350,11 @@ struct device class_find_device(struct class class, struct device *start,

		if (!class)
		return NULL;
		if (!class->p) {
		WARN(1, "%s called for class '%s' before it was initialized",
		__func__, class->name);
		return NULL;
		}

		mutex_lock(&class->p->class_mutex);
		list_for_each_entry(dev, &class->p->class_devices, node) {

drivers/base/core.c

+20 −11

Original line number	Diff line number	Diff line
		@@ -53,7 +53,7 @@ static inline int device_is_not_partition(struct device *dev)
		* it is attached to. If it is not attached to a bus either, an empty
		* string will be returned.
		*/
		const char dev_driver_string(struct device dev)
		const char dev_driver_string(const struct device dev)
		{
		return dev->driver ? dev->driver->name :
		(dev->bus ? dev->bus->name :
		@@ -541,6 +541,7 @@ void device_initialize(struct device *dev)
		spin_lock_init(&dev->devres_lock);
		INIT_LIST_HEAD(&dev->devres_head);
		device_init_wakeup(dev, 0);
		device_pm_init(dev);
		set_dev_node(dev, -1);
		}

		@@ -843,13 +844,19 @@ int device_add(struct device *dev)
		{
		struct device *parent = NULL;
		struct class_interface *class_intf;
		int error;
		int error = -EINVAL;

		dev = get_device(dev);
		if (!dev \|\| !strlen(dev->bus_id)) {
		error = -EINVAL;
		goto Done;
		}
		if (!dev)
		goto done;

		/* Temporarily support init_name if it is set.
		* It will override bus_id for now */
		if (dev->init_name)
		dev_set_name(dev, "%s", dev->init_name);

		if (!strlen(dev->bus_id))
		goto done;

		pr_debug("device: '%s': %s\n", dev->bus_id, __func__);

		@@ -897,9 +904,10 @@ int device_add(struct device *dev)
		error = bus_add_device(dev);
		if (error)
		goto BusError;
		error = device_pm_add(dev);
		error = dpm_sysfs_add(dev);
		if (error)
		goto PMError;
		goto DPMError;
		device_pm_add(dev);
		kobject_uevent(&dev->kobj, KOBJ_ADD);
		bus_attach_device(dev);
		if (parent)
		@@ -917,10 +925,10 @@ int device_add(struct device *dev)
		class_intf->add_dev(dev, class_intf);
		mutex_unlock(&dev->class->p->class_mutex);
		}
		Done:
		done:
		put_device(dev);
		return error;
		PMError:
		DPMError:
		bus_remove_device(dev);
		BusError:
		if (dev->bus)
		@@ -944,7 +952,7 @@ int device_add(struct device *dev)
		cleanup_device_parent(dev);
		if (parent)
		put_device(parent);
		goto Done;
		goto done;
		}

		/**
		@@ -1007,6 +1015,7 @@ void device_del(struct device *dev)
		struct class_interface *class_intf;

		device_pm_remove(dev);
		dpm_sysfs_remove(dev);
		if (parent)
		klist_del(&dev->knode_parent);
		if (MAJOR(dev->devt)) {