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

最新推荐文章于 2025-10-16 08:22:59 发布
转载 最新推荐文章于 2025-10-16 08:22:59 发布 · 1k 阅读 · 3 ·
CC 4.0 BY-SA版权
原文链接：https://blog.youkuaiyun.com/weixin_35724881/article/details/116799934
文章标签：

#linux #运维 #服务器

Linux从3.7版本后引入uapi目录，将用户空间API的头文件独立，以解决头文件循环包含的问题。这减少了内核头文件的复杂性，简化了API之间的依赖，并方便用户追踪API的变化，通过git历史查看更新。

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 [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

【linux】Linux kernel uapi header file（用户态头文件）
郭老二
03-16 5060
uapi目录的创建原因 Linux在3.7以后把很多header file移到 include/uapi或是arch/xxxx/include/uapi下，为了解决include recursive（循环包含头文件）的问题。 英文参考文档：https://lwn.net/Articles/507794/ 解决include recursive问题的方法 例如：在A.h中inline f...
A share buffer infrastructure In Linux kernel through ION
tugouxp的专栏
12-13 574
ION是一种Linux内核中管理共享内存的机制，最初由Google开发，用于Android系统中的图形渲染和多媒体应用。the principle diagram,exporter process 输出FD，给另外两个进程作映射。
linux内核源码include目录下的uapi目录
brooknew的专栏
06-04 1124
linux内核源码include目录下的uapi目录 与交叉编译器sysroot/usr/include/linux相对应
uapi_include_linux_input,h
03-02
linux的输入设备的头文件，里面有各种输入宏定义，事件类型定义，键值等
关于新的 Linux 内核接口 gpio uapi 的说明
最新发布
2501_93209230的博客
10-16 693
对于少数人来说，这是一项严格的日常工作，而对于其他人来说，则是一项有趣的爱好。，就无法提前“猜测”联系人是否存在名称，并且如果事先不知道名称，则搜索导出的“命名”行会很困难（同样，如果知道名称，那么为了明确识别，我们需要已知。总的来说，我找不到一个明确的答案。我并不反对新界面，甚至支持它，但如此彻底地埋葬旧界面，我个人觉得难以理解，也不太愉快。有了新的接口，这种直接的连接就消失了，因为现在需要额外的实用程序来进行交互。中看到每个引脚的名称，不幸的是，很少有人给引脚命名，即使是常见的 SBC 也是如此。
linux的uapi文件夹,linux源码中的uapi的来源include recursion
weixin_35817545的博客
05-08 1014
转自http://tinylab.org/linux-kernel-uapi/问题描述从3.5开始，Linux Kernel 里多了一个 uapi 文件夹，里面放了很多 Linux Kernel 各个模块的头文件。如果是第一次碰到，可能会对这个不是很了解。问题分析Linux Kernel 中新增的这些 uapi 头文件，其实都是来自于各个模块原先的头文件，最先是由 David Howells 提出...
Linux Kernel UAPI
qwaszx523的博客
09-13 5194
 转自http://tinylab.org/linux-kernel-uapi/ 问题描述 从3.5开始，Linux Kernel 里多了一个 uapi 文件夹，里面放了很多 Linux Kernel 各个模块的头文件。如果是第一次碰到，可能会对这个不是很了解。 问题分析 Linux Kernel 中新增的这些 uapi 头文件，其实都是来自于各个
Linux tracing之内核vsyscall&vdso机制分析
tugouxp的专栏
06-27 1355
由于内核运行在受保护的地质空间上，Linux系统中的用户空间程序无法直接执行内核代码，不能直接调用内核空间中的函数，因此，应用程序以某种方式通知系统，告诉内核自己需要执行一function，希望系统系统切换到内核态，这样内核就可以代表应用程序在内核空间执行系统调用。这个道理就像机场的安检通道，旅客只能通过有限的几个通道进入，并且还要经过严格的安全检查。
桌面PC/服务器 ubuntu18.04 Linux内核编译升级与机制分析
tugouxp的专栏
06-06 7059
1.下载内核并且解压安装依赖2.执行make menuconfig，并不修改，使用默认然后退出,默认使用的配置是x86_64_defconfig还可以拷贝/boot/目录下的既有的config文件来作为编译内核的配置文件来编译。但是需要两个内核版本号差别不大，可以互通使用。将CONFIG_SYSTEM_TRUSTED_KEYS字符串置空。3.执行make -j4因为之前编译过，再次编译输出很少4.执行sudo make modules_install。
linux kernel 4.18.16 Makefile注释
qq_39389748的博客
11-02 1606
前言： 本人的操作系统作业，要求注释最新版本的GNU Linux kernel 的Makefile文件，我还没用过Linux，一打开这个Makefile真的是下了一跳……好多东西要注释啊，忙活了一个下午，成果就写个博客吧。 参考： GNU Linux kernel下载地址 Kernel顶层Makefile文件分析 跟我一起写Makefile Makefile： # SPDX-License-Ide...
JJJ：linux 源码 uapi 目录
engineer0的博客
01-03 835
一、问题描述 从3.5开始，Linux Kernel 里多了一个 uapi 文件夹，里面放了很多 Linux Kernel 各个模块的头文件。如果是第一次碰到，可能会对这个不是很了解。 二、问题分析 Linux Kernel 中新增的这些 uapi 头文件，其实都是来自于各个模块原先的头文件，最先是由 David Howells 提出来的。uapi 只是把内核用到的头文件和用户态用到的头文件分开。 三、解决方案 3.5 之前 在 3.5 之前，Linux Kernel 的头文件一般是这样的： /* Head
nuance uapi介绍及示例
08-12
nuance uapi介绍及示例，android系统自带的语音开发采用的便是nuance的语音库
linux的uapi文件夹,Linux文件与目录的权限操作
weixin_39728572的博客
05-08 515
在Linux 系统中，每一个文件和目录都有相应的访问许可权限 我们可以用它来确定谁可以通过何种方式对文件和目录进行访问和操作。文件或目录的访问权限分为可读、可写和可执行三种，分别以rwx表示，其含义为rw x文件 可读可写 可执行目录 可列出目录可在目录中做写操作 ...
linux源码中的uapi的来源include recursion
shenhuxi_yu的专栏
06-14 7473
问题重现 我把问题脱离于项目简单描述一下：我写了一个函数 bool func(ClassA* CA) 需要加到项目中，我就把这个函数的声明放到 head1.h 中，函数参数类型 ClassA 定义在另一个头文件 head2.h 中，因此我需要在 head1.h 中包含 head2.h；而 head2.h 中之前又包含了 head1.h，这样就构成了一种头文件相互包含的场景。再加上一些其它的声
Linux kernel uapi header file
闲云孤鹤
07-23 4636
From : http://vh21.github.io/linux/2014/11/21/linux-kernel-uapi-include-file.html Linux在3.7以後把很多header file移到 include/uapi或是arch/xxxx/include/uapi下，感覺起來要追define變得很麻煩，不太清楚為了什麼做這個修改，找了一下看到LWN有一篇文章介
Linux 目录操作API
qq_44881664的博客
09-09 514
使用案例见链接： 目录操作的相关API 1，创建或删除一个空目录 NAME mkdir, mkdirat - create a directory SYNOPSIS #include <sys/stat.h> #include <sys/types.h> mkdir用来用来创建一个空目录，该路径名为pathname，mode为该目录的权限， 目录的读的权限是指可以查看目录内容，执行的权限是指可以进...
LINUX系统API---操作目录
weixin_46120107的博客
03-28 1603
C++程序员必会的知识 目录操作函数 int mkdir(const char *pathname,mode_t mode); //创建一个目录 #include <stdio.h> #include <sys/stat.h> #include <sys/types.h> #include <fcntl.h> int main(){ int res = mkdir("mkdirDemo",0777); if(res ...
vscode linux驱动开发"intelliSenseMode"怎么配置
10-16
<think>根据用户的问题，我们需要讨论在VSCode中进行Linux驱动开发时，如何配置`intelliSenseMode`。这个问题涉及到C/C++扩展的配置，尤其是在驱动开发这种需要特定编译器和内核头文件的场景。 从引用[2]中可以看到一个配置示例，其中指定了`intelliSenseMode`为`linux-gcc-x64`。在Linux驱动开发中，我们通常需要交叉编译，所以可能需要调整这个模式。 在VSCode中，`intelliSenseMode`用于告诉C/C++扩展使用哪种IntelliSense引擎来提供代码补全、错误检查等功能。对于Linux驱动开发，我们通常使用gcc作为编译器，所以模式通常选择与gcc兼容的模式。 ### 配置方法 1. **打开C/C++配置**：在VSCode中，按下`Ctrl+Shift+P`，输入`C/C++: Edit Configurations (JSON)`，然后选择该命令打开`c_cpp_properties.json`文件。 2. **设置intelliSenseMode**：在`configurations`数组中，找到你的配置（例如"Linux"），然后设置`intelliSenseMode`属性。对于Linux驱动开发，通常使用： - 如果目标架构是x86_64：`linux-gcc-x64` - 如果目标架构是ARM：`linux-gcc-arm` 或 `linux-gcc-arm64`（根据具体架构） 例如，针对ARM64架构的驱动开发： ```json { "name": "Linux-ARM", "intelliSenseMode": "linux-gcc-arm64", // 其他配置... } ``` 3. **设置正确的编译器路径**：`compilerPath`需要指向你的交叉编译器（如果使用交叉编译）或者本机编译器（如果是本地编译）。例如： - 交叉编译ARM64：`/path/to/gcc-linaro-aarch64-linux-gnu/bin/aarch64-linux-gnu-gcc` - 本地x86_64编译：`/usr/bin/gcc` 4. **包含路径**：必须包含内核头文件路径。例如： ```json "includePath": [ "${workspaceFolder}/**", "/path/to/your/linux-kernel-headers/include", "/path/to/your/linux-kernel-headers/arch/arm64/include" ], ``` ### 示例配置 下面是一个针对ARM64架构的Linux驱动开发的配置示例（参考引用[2]的格式）： ```json { "configurations": [ { "name": "Linux-ARM64-Driver", "includePath": [ "${workspaceFolder}/**", "/home/user/linux-kernel/include", "/home/user/linux-kernel/arch/arm64/include", "/home/user/linux-kernel/arch/arm64/include/generated" ], "defines": [ "__KERNEL__", "MODULE" ], "compilerPath": "/opt/toolchains/gcc-linaro-aarch64-linux-gnu/bin/aarch64-linux-gnu-gcc", "cStandard": "c11", "cppStandard": "gnu++17", "intelliSenseMode": "linux-gcc-arm64", "browse": { "path": [ "/home/user/linux-kernel/include", "/home/user/linux-kernel/arch/arm64/include", "${workspaceRoot}" ], "limitSymbolsToIncludedHeaders": true, "databaseFilename": "" } } ], "version": 4 } ``` ### 注意事项 1. **内核头文件**：确保你配置的内核头文件路径与你要开发的内核版本一致。通常你需要先编译内核以生成一些头文件（如`include/generated/uapi/linux/version.h`）。 2. **宏定义**：驱动开发需要定义`__KERNEL__`和`MODULE`等宏，以便正确解析内核代码。 3. **更新配置**：当你切换内核版本或工作区时，记得更新配置。 4. **重新加载**：修改配置文件后，可能需要重新加载VSCode窗口（Ctrl+Shift+P，输入`Reload Window`）使配置生效。 ### 验证配置 编写一个简单的驱动代码，检查IntelliSense是否正常工作（没有红色波浪线）。例如： ```c #include <linux/module.h> #include <linux/kernel.h> static int __init my_module_init(void) { printk(KERN_INFO "Hello, world!\n"); return 0; } static void __exit my_module_exit(void) { printk(KERN_INFO "Goodbye, world!\n"); } module_init(my_module_init); module_exit(my_module_exit); MODULE_LICENSE("GPL"); ``` 如果头文件被正确找到，那么`printk`、`module_init`等函数和宏应该被正确识别。 ### 相关问题 §§ 相关问题 §§ 1. 如何在VSCode中为不同的内核版本切换头文件路径？ 2. 在Linux驱动开发中，如何配置VSCode的调试功能？ 3. 如何解决Linux内核头文件中的宏定义导致的IntelliSense错误？ 以上配置可以帮助你在VSCode中高效地进行Linux驱动开发[^2]。 </think>### VSCode中Linux驱动开发`intelliSenseMode`配置指南 在Linux驱动开发中，`intelliSenseMode`是`.vscode/c_cpp_properties.json`文件的关键配置项，它决定了C/C++扩展如何解析内核代码[^2]。以下是详细配置方法： #### 核心配置项 ```json { "configurations": [ { "name": "Linux Kernel", "intelliSenseMode": "linux-gcc-x64", // 架构选择见下表 "compilerPath": "/usr/bin/gcc", // 推荐使用目标平台交叉编译器 "includePath": [ "${workspaceFolder}/**", "/lib/modules/$(uname -r)/build/include", // 当前内核头文件 "/path/to/cross-kernel/include" // 交叉编译内核头文件 ], "defines": [ "__KERNEL__", // 必须定义 "MODULE", // 模块开发定义 "DEBUG" // 调试模式 ], "cStandard": "c11", // Linux内核使用C11标准 "cppStandard": "gnu++14" } ], "version": 4 } ``` #### `intelliSenseMode`选择矩阵 | 目标平台 | 推荐值 | 说明 | |---------------|-------------------------|------| | **x86_64** | `linux-gcc-x64` | 标准PC开发[^2] | | **ARM32** | `linux-gcc-arm` | 树莓派等32位ARM设备 | | **ARM64** | `linux-gcc-arm64` | 新款嵌入式设备 | | **PowerPC** | `linux-gcc-ppc64le` | 特定工控设备 | | **自定义** | `gcc-x64` (默认) | 当不确定时使用 | #### 关键注意事项 1. **内核头文件路径** 必须包含当前运行内核的构建头文件： ```json "/lib/modules/$(uname -r)/build/include" ``` 交叉编译时需替换为交叉编译内核的`include`路径 2. **必须定义的宏**[^4][^3] ```json "defines": [ "__KERNEL__", // 标识内核空间代码 "MODULE", // 模块开发标识 "__linux__" // Linux平台标识 ] ``` 3. **编译器路径** 推荐使用与目标平台匹配的交叉编译器： ```json "compilerPath": "/opt/gcc-arm-10.3-2021.07/bin/arm-none-linux-gnueabi-gcc" ``` #### 验证配置效果 1. **诊断驱动头文件** 创建测试文件`test_header.c`： ```c #include <linux/module.h> #include <linux/init.h> ``` 若无红色波浪线报错，则配置成功 2. **检查符号解析** 在驱动函数中输入： ```c struct file_operations fops; fops. ``` 应弹出`read`、`write`等成员提示 #### 常见问题解决 **问题：找不到`<linux/*>`头文件** ```json // 解决方案：添加内核架构头文件 "includePath": [ ..., "/lib/modules/$(uname -r)/build/arch/x86/include" // x86示例 ] ``` **问题：驱动API无智能提示** ```json // 解决方案：启用GNU扩展 "cStandard": "gnu11", "intelliSenseMode": "linux-gcc-x64" ``` **问题：PCI驱动符号未识别**[^3] ```json // 添加PCI相关定义 "defines": [ ..., "CONFIG_PCI", "CONFIG_PCI_MSI" ] ``` #### 推荐扩展 1. **C/C++** (ms-vscode.cpptools) - 基础智能感知 2. **C/C++ Advanced Lint** (joshpeng.lint) - 内核编码规范检查 3. **Makefile Tools** (ms-vscode.makefile-tools) - 驱动Makefile支持
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值