Documentation / zh_CN / sparse.txt

Custom Search

Based on kernel version 3.9. Page generated on 2013-05-02 23:17 EST.

	Chinese translated version of Documentation/sparse.txt
	
	If you have any comment or update to the content, please contact the
	original document maintainer directly.  However, if you have a problem
	communicating in English you can also ask the Chinese maintainer for
	help.  Contact the Chinese maintainer if this translation is outdated
	or if there is a problem with the translation.
	
	Chinese maintainer: Li Yang <leo@zh-kernel.org>
	---------------------------------------------------------------------
	Documentation/sparse.txt 的中文翻译
	
	如果想评论或更新本文的内容，请直接�系原文档的维护者。如果你使用英文
	交�有困难的�，也�以�中文版维护者求助。如果本翻译更新��时或者翻
	译存在问题，请�系中文版维护者。
	
	中文版维护者： �阳  Li Yang <leo@zh-kernel.org>
	中文版翻译者： �阳  Li Yang <leo@zh-kernel.org>
	
	
	以下为正文
	---------------------------------------------------------------------
	
	Copyright 2004 Linus Torvalds
	Copyright 2004 Pavel Machek <pavel@ucw.cz>
	Copyright 2006 Bob Copeland <me@bobcopeland.com>
	
	使用 sparse 工具�类型检查
	~~~~~~~~~~~~~~~~~~~~~~~~~~
	
	"__bitwise" 是一�类型属性，所以你应该这样使用它：
	
	        typedef int __bitwise pm_request_t;
	
	        enum pm_request {
	                PM_SUSPEND = (__force pm_request_t) 1,
	                PM_RESUME = (__force pm_request_t) 2
	        };
	
	这样会使 PM_SUSPEND 和 PM_RESUME �为�方�(bitwise)整数（使用"__force"
	是因为 sparse 会抱怨改��方�的类型转�，但是这里我们确实需�强制进行转
	�）。而且因为所有枚举值都使用了相�的类型，这里的"enum pm_request"也将
	会使用那个类型�为底层实现。
	
	而且使用 gcc 编译的时候，所有的 __bitwise/__force 都会消失，最�在 gcc
	看�它们��过是普通的整数。
	
	�白�说，你并�需�使用枚举类型。上�那些实际都�以浓缩�一个特殊的"int
	__bitwise"类型。
	
	所以更简�的办法��这样�：
	
		typedef int __bitwise pm_request_t;
	
		#define PM_SUSPEND ((__force pm_request_t) 1)
		#define PM_RESUME ((__force pm_request_t) 2)
	
	现在你就有了严格的类型检查所需�的所有基础架构。
	
	一个��醒：常数整数"0"是特殊的。你�以直接把常数零当作�方�整数使用而
	�用担心 sparse 会抱怨。这是因为"bitwise"（�如其�）是用�确����方
	�类型�会被弄混（�尾模�，大尾模�，cpu尾模�，或者其他），对他们�说
	常数"0"确实是特殊的。
	
	获� sparse 工具
	~~~~~~~~~~~~~~~~
	
	你�以从 Sparse 的主页获�最新的�布版本：
	
		http://www.kernel.org/pub/linux/kernel/people/josh/sparse/
	
	或者，你也�以使用 git 克隆最新的 sparse 开�版本：
	
		git://git.kernel.org/pub/scm/linux/kernel/git/josh/sparse.git
	
	DaveJ 把��时自动生�的 git ��树 tar 包放在以下地�：
	
		http://www.codemonkey.org.uk/projects/git-snapshots/sparse/
	
	一旦你下载了��，��以普通用户身份�行：
	
		make
		make install
	
	它将会被自动安装到你的 ~/bin 目录下。
	
	使用 sparse 工具
	~~~~~~~~~~~~~~~~
	
	用"make C=1"命令�编译内核，会对所有�新编译的 C 文件使用 sparse 工具。
	或者使用"make C=2"命令，无论文件是�被�新编译都会对其使用 sparse 工具。
	如果你已�编译了内核，用�一�方��以很快地检查整个��树。
	
	make 的�选�� CHECKFLAGS �以用�� sparse 工具传递�数。编译系统会自
	动� sparse 工具传递 -Wbitwise �数。你�以定义 __CHECK_ENDIAN__ �进行
	大�尾检查。
	
		make C=2 CHECKFLAGS="-D__CHECK_ENDIAN__"
	
	这些检查默认都是被关闭的，因为他们通常会产生大�的警告。

• [ zh_CN ]
• [ arm ]
• [ arm64 ]
• basic_profiling.txt
• CodingStyle
• email-clients.txt
• [ filesystems ]
• gpio.txt
• HOWTO
• IRQ.txt
• magic-number.txt
• oops-tracing.txt
• SecurityBugs
• sparse.txt
• stable_api_nonsense.txt
• stable_kernel_rules.txt
• SubmittingDrivers
• SubmittingPatches
• [ video4linux ]
• volatile-considered-harmful.txt
•