Orange Pi5 kernel

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