Commit 61311e1b authored by Linus Torvalds's avatar Linus Torvalds
Browse files

Merge git://git.kernel.org/pub/scm/linux/kernel/git/gregkh/driver-core-2.6 

* git://git.kernel.org/pub/scm/linux/kernel/git/gregkh/driver-core-2.6:
  pnp: fix "add acpi:* modalias entries"
  UIO: generic irq handling for some uio platform devices
  UIO: uio_pdrv: fix license specification
  UIO: uio_pdrv: fix memory leak
  block: drop references taken by class_find_device()
  block: fix partial read() of /proc/{partitions,diskstats}
  PM: Remove WARN_ON from device_pm_add
  driver core: add init_name to struct device
  PM: don't skip device PM init when CONFIG_PM_SLEEP isn't set and CONFIG_PM is set
  driver model: anti-oopsing medicine
  dev_printk(): constify the `dev' argument
  drivers/base/driver.c: remove unused to_dev() macro
  Documentation: HOWTO-ja_JP-sync patch
  Japanese translation of Documentation/SubmitChecklist
  kobject: Replace ALL occurrences of '/' with '!' instead of only the first one.
parents 691a5599 5e4c6564

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)) {

CRA Git | Maintained and supported by SUSTech CRA and CCSE