copy_to_user必须在进程上下文（如read/write/ioctl）中调用，禁止在原子上下文使用；需先校验指针非空及access_ok合法性，再以“返回值≠0”判断失败，不可直接用布尔逻辑；单数据用put_user，批量用copy_to_user。
copy_to_user 在内核模块中怎么调用才不 panic
不能直接在任意上下文调用 copy_to_user，它要求当前进程上下文（即不能在中断、软中断、定时器回调或 workqueue 中无准备地调用），且目标用户地址必须属于当前进程的地址空间。最常见 panic 是传入了非法用户地址（如 NULL、内核地址、未映射页）或在原子上下文中调用。
实操建议：
- 确保调用点在进程上下文：比如字符设备的
read或write文件操作函数里，或 ioctl 的处理函数中 - 永远先检查用户指针是否非空：
if (!uaddr) return -EFAULT; - 不要对
copy_to_user返回值做“成功/失败”二元判断——它返回**未复制的字节数**，应显式比对：if (copy_to_user(uaddr, kbuf, len) != 0) return -EFAULT; - 避免在持有自旋锁（
spin_lock）时调用；它可能引发页错误，导致睡眠，而自旋锁禁止睡眠
为什么 copy_to_user 复制 0 字节也会返回 0 而不是成功标志
copy_to_user 的语义是“尽力复制”，返回值是剩余未复制的字节数。即使 len == 0，它也合法返回 0，不代表“操作成功”这个逻辑概念，只代表“没剩数据要复制”。这是 C 风格接口的惯用法（类似 memcpy 不返回状态），但容易误判。
典型错误现象：代码写成 if (copy_to_user(...)) return -EFAULT;，看似简洁，但当 len == 0 时，该条件不触发，逻辑上没问题；可一旦 len > 0 且部分失败（比如只复制了前 3 字节），返回非零值，你却只当“失败”处理，丢弃了已复制的有效数据——这在协议解析类驱动中很危险。
正确做法始终显式比对：
size_t ret = copy_to_user(uaddr, kbuf, len);
if (ret != 0) {
pr_err("copy_to_user failed: %zu bytes left\n", ret);
return -EFAULT;
}
copy_to_user 和 put_user 的性能与适用边界
put_user 是 copy_to_user 的轻量特化版，仅支持单个基本类型（char、int、long、指针等，具体取决于架构和 sizeof），底层用单条带地址检查的汇编指令（如 x86 的 mov + fault handler）。它比 copy_to_user 快一个数量级，且更安全（无长度计算溢出风险）。
使用场景选择：
- 传单个整数、状态码、标志位 → 用
put_user(val, uaddr)，别用copy_to_user - 传结构体（且大小 ≤ 缓存行，通常 ≤ 64 字节）→ 可考虑
__put_user（绕过地址验证，需确保uaddr确实有效），但慎用 - 传数组、字符串、动态 buffer → 必须用
copy_to_user，并确保kbuf已完成填充、无越界读 - 注意：ARM64 上
put_user对 16 字节（__int128）支持有限，实际应避免
用户地址合法性检查不能只靠 access_ok
access_ok(uaddr, len) 只检查地址范围是否落在用户空间（0x00000000 ~ TASK_SIZE），**不保证页已映射、可写（对 copy_from_user）或可读（对 copy_to_user）**。它只是快速预检，不是替代 copy_*_user 的安全机制。
常见误区：
- 写了
if (!access_ok(uaddr, len)) return -EFAULT;就以为万事大吉 —— 错。用户可能刚mmap(MAP_FIXED)覆盖了一段地址，或munmap了对应区域，access_ok仍返回 true，但copy_to_user会触发缺页异常并返回失败 - 在非当前进程上下文（如 kthread）中调用
access_ok检查另一个进程的地址 —— 无效，access_ok始终针对current->mm - 对用户态传递的指针不做
access_ok直接传给copy_to_user—— 内核可能 panic（尤其 CONFIG_DEBUG_VIRTUAL=y 时）
所以标准流程是：access_ok 做前置快筛 → 调用 copy_to_user → 检查其返回值。少一步都可能在线上环境静默失败或崩溃。
真正难处理的是跨进程共享内存场景（如 dma-buf、ion），这时用户地址有效性依赖于外部同步机制，copy_to_user 本身无法解决，得结合 get_user_pages_fast 或 pin pages 配合使用——那已经是另一层复杂度了。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
