【linux】Linux kernel uapi header file（用户态头文件）

最新推荐文章于 2024-08-18 18:07:37 发布

maze.ma

最新推荐文章于 2024-08-18 18:07:37 发布

阅读量2.6k

点赞数 4

分类专栏： kernel

原文链接：http://vh21.github.io/linux/2014/11/21/linux-kernel-uapi-include-file.html

版权

kernel 专栏收录该内容

60 篇文章 13 订阅

订阅专栏

uapi目录的创建原因

Linux在3.7以后把很多header file移到 include/uapi或是arch/xxxx/include/uapi下，为了解决include recursive（循环包含头文件）的问题。
英文参考文档：https://lwn.net/Articles/507794/

解决include recursive问题的方法

例如：在A.h中inline function时发现里面用到的某些struct定义在B.h中，而B.h中又有inline function需要用到A.h中的struct，就会造成循环包含recursive include

uapi的创建

把userspace API的文件独立到 include/uapi跟arch/xxxx/include/uapi下，
举例来说本来header中

 /* Header comments (copyright, etc.) */
 #ifndef _XXXXXX_H     /* Guard macro preventing double inclusion */
 #define _XXXXXX_H

 [User-space definitions]
 #ifdef __KERNEL__
 [Kernel-space definitions]
 #endif /* __KERNEL__ */

 [User-space definitions]
 #endif /* End prevent double inclusion */

换成如下两个文件

a. kernel space的东西放在原本路径下

 /* Header comments (copyright, etc.) */

 #ifndef _XXXXXX_H     /* Guard macro preventing double inclusion */
 #define _XXXXXX_H

 #include <include/uapi/path/to/header.h>

 [Kernel-space definitions]

 #endif /* End prevent double inclusion */

 /* Header comments (copyright, etc.) */

b. uapi目录下创建同名文件
#ifndef _UAPI__XXXXXX_H /* Guard macro preventing double inclusion */
#define _UAPI__XXXXXX_H

 [User-space definitions]

 #endif /* End prevent double inclusion */

好处

减少与简化kernel-only header的size；
现在kernel header有的是文件中一部分export给userspace用。这样做简化了头文件间的交互相依性。
处理用户态的人更容易追踪API的变更，透过git来追踪uapi下的log更容易在每个kernel的释放版本中知道做了那些修改
转发自：http://vh21.github.io/linux/2014/11/21/linux-kernel-uapi-include-file.html

所以kernel/include/linux/xx.h是用于kernel空间，kernel/include/uapi/linux/xx.h用于用户空间