1*4882a593SmuzhiyunChinese translated version of Documentation/dev-tools/sparse.rst 2*4882a593Smuzhiyun 3*4882a593SmuzhiyunIf you have any comment or update to the content, please contact the 4*4882a593Smuzhiyunoriginal document maintainer directly. However, if you have a problem 5*4882a593Smuzhiyuncommunicating in English you can also ask the Chinese maintainer for 6*4882a593Smuzhiyunhelp. Contact the Chinese maintainer if this translation is outdated 7*4882a593Smuzhiyunor if there is a problem with the translation. 8*4882a593Smuzhiyun 9*4882a593SmuzhiyunChinese maintainer: Li Yang <leoyang.li@nxp.com> 10*4882a593Smuzhiyun--------------------------------------------------------------------- 11*4882a593SmuzhiyunDocumentation/dev-tools/sparse.rst 的中文翻译 12*4882a593Smuzhiyun 13*4882a593Smuzhiyun如果想评论或更新本文的内容，请直接联系原文档的维护者。如果你使用英文 14*4882a593Smuzhiyun交流有困难的话，也可以向中文版维护者求助。如果本翻译更新不及时或者翻 15*4882a593Smuzhiyun译存在问题，请联系中文版维护者。 16*4882a593Smuzhiyun 17*4882a593Smuzhiyun中文版维护者： 李阳 Li Yang <leoyang.li@nxp.com> 18*4882a593Smuzhiyun中文版翻译者： 李阳 Li Yang <leoyang.li@nxp.com> 19*4882a593Smuzhiyun 20*4882a593Smuzhiyun 21*4882a593Smuzhiyun以下为正文 22*4882a593Smuzhiyun--------------------------------------------------------------------- 23*4882a593Smuzhiyun 24*4882a593SmuzhiyunCopyright 2004 Linus Torvalds 25*4882a593SmuzhiyunCopyright 2004 Pavel Machek <pavel@ucw.cz> 26*4882a593SmuzhiyunCopyright 2006 Bob Copeland <me@bobcopeland.com> 27*4882a593Smuzhiyun 28*4882a593Smuzhiyun使用 sparse 工具做类型检查 29*4882a593Smuzhiyun~~~~~~~~~~~~~~~~~~~~~~~~~~ 30*4882a593Smuzhiyun 31*4882a593Smuzhiyun"__bitwise" 是一种类型属性，所以你应该这样使用它： 32*4882a593Smuzhiyun 33*4882a593Smuzhiyun typedef int __bitwise pm_request_t; 34*4882a593Smuzhiyun 35*4882a593Smuzhiyun enum pm_request { 36*4882a593Smuzhiyun PM_SUSPEND = (__force pm_request_t) 1, 37*4882a593Smuzhiyun PM_RESUME = (__force pm_request_t) 2 38*4882a593Smuzhiyun }; 39*4882a593Smuzhiyun 40*4882a593Smuzhiyun这样会使 PM_SUSPEND 和 PM_RESUME 成为位方式(bitwise)整数（使用"__force" 41*4882a593Smuzhiyun是因为 sparse 会抱怨改变位方式的类型转换，但是这里我们确实需要强制进行转 42*4882a593Smuzhiyun换）。而且因为所有枚举值都使用了相同的类型，这里的"enum pm_request"也将 43*4882a593Smuzhiyun会使用那个类型做为底层实现。 44*4882a593Smuzhiyun 45*4882a593Smuzhiyun而且使用 gcc 编译的时候，所有的 __bitwise/__force 都会消失，最后在 gcc 46*4882a593Smuzhiyun看来它们只不过是普通的整数。 47*4882a593Smuzhiyun 48*4882a593Smuzhiyun坦白来说，你并不需要使用枚举类型。上面那些实际都可以浓缩成一个特殊的"int 49*4882a593Smuzhiyun__bitwise"类型。 50*4882a593Smuzhiyun 51*4882a593Smuzhiyun所以更简单的办法只要这样做： 52*4882a593Smuzhiyun 53*4882a593Smuzhiyun typedef int __bitwise pm_request_t; 54*4882a593Smuzhiyun 55*4882a593Smuzhiyun #define PM_SUSPEND ((__force pm_request_t) 1) 56*4882a593Smuzhiyun #define PM_RESUME ((__force pm_request_t) 2) 57*4882a593Smuzhiyun 58*4882a593Smuzhiyun现在你就有了严格的类型检查所需要的所有基础架构。 59*4882a593Smuzhiyun 60*4882a593Smuzhiyun一个小提醒：常数整数"0"是特殊的。你可以直接把常数零当作位方式整数使用而 61*4882a593Smuzhiyun不用担心 sparse 会抱怨。这是因为"bitwise"（恰如其名）是用来确保不同位方 62*4882a593Smuzhiyun式类型不会被弄混（小尾模式，大尾模式，cpu尾模式，或者其他），对他们来说 63*4882a593Smuzhiyun常数"0"确实是特殊的。 64*4882a593Smuzhiyun 65*4882a593Smuzhiyun获取 sparse 工具 66*4882a593Smuzhiyun~~~~~~~~~~~~~~~~ 67*4882a593Smuzhiyun 68*4882a593Smuzhiyun你可以从 Sparse 的主页获取最新的发布版本： 69*4882a593Smuzhiyun 70*4882a593Smuzhiyun http://www.kernel.org/pub/linux/kernel/people/josh/sparse/ 71*4882a593Smuzhiyun 72*4882a593Smuzhiyun或者，你也可以使用 git 克隆最新的 sparse 开发版本： 73*4882a593Smuzhiyun 74*4882a593Smuzhiyun git://git.kernel.org/pub/scm/linux/kernel/git/josh/sparse.git 75*4882a593Smuzhiyun 76*4882a593Smuzhiyun一旦你下载了源码，只要以普通用户身份运行： 77*4882a593Smuzhiyun 78*4882a593Smuzhiyun make 79*4882a593Smuzhiyun make install 80*4882a593Smuzhiyun 81*4882a593Smuzhiyun它将会被自动安装到你的 ~/bin 目录下。 82*4882a593Smuzhiyun 83*4882a593Smuzhiyun使用 sparse 工具 84*4882a593Smuzhiyun~~~~~~~~~~~~~~~~ 85*4882a593Smuzhiyun 86*4882a593Smuzhiyun用"make C=1"命令来编译内核，会对所有重新编译的 C 文件使用 sparse 工具。 87*4882a593Smuzhiyun或者使用"make C=2"命令，无论文件是否被重新编译都会对其使用 sparse 工具。 88*4882a593Smuzhiyun如果你已经编译了内核，用后一种方式可以很快地检查整个源码树。 89*4882a593Smuzhiyun 90*4882a593Smuzhiyunmake 的可选变量 CHECKFLAGS 可以用来向 sparse 工具传递参数。编译系统会自 91*4882a593Smuzhiyun动向 sparse 工具传递 -Wbitwise 参数。 92