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

最新推荐文章于 2024-10-07 19:47:52 发布

郭老二

最新推荐文章于 2024-10-07 19:47:52 发布

阅读量4.8k

点赞数 3

分类专栏： linux

linux 专栏收录该内容

147 篇文章 25 订阅 ¥69.90 ¥99.00

订阅专栏

本文探讨了Linux内核从3.7版本开始将头文件移至include/uapi目录的原因，旨在解决循环包含（recursive include）问题。通过创建uapi，将用户态API独立出来，减少了内核头文件的大小并简化了API间的依赖。这样改进后，对于处理用户态代码的开发者，跟踪API变化和理解内核更新变得更加容易。

摘要由CSDN通过智能技术生成

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