put_user() 宏函数

beyes

功能：把内核变量值写入用户空间

原型： put_user (x, ptr)

说明：  put_user 宏函数在 ptr 指向的用户内存空间上写入 x 变量大小的数据

变量：

x      内核变量
ptr   用户内存块的起始地址

beyes

x86 体系下定义在 arch/x86/include/asm/uaccess.h (2.6.31.2)中：

[Plain Text] 纯文本查看 复制代码

/**
 * put_user: - Write a simple value into user space.
 * @x:   Value to copy to user space.
 * @ptr: Destination address, in user space.
 *
 * Context: User context only.  This function may sleep.
 *
 * This macro copies a single simple value from kernel space to user
 * space.  It supports simple types like char and int, but not larger
 * data types like structures or arrays.
 *
 * @ptr must have pointer-to-simple-variable type, and @x must be assignable
 * to the result of dereferencing @ptr.
 *
 * Returns zero on success, or -EFAULT on error.
 */
#define put_user(x, ptr)                                        \\
({                                                              \\
        int __ret_pu;                                           \\
        __typeof__(*(ptr)) __pu_val;                            \\
        __chk_user_ptr(ptr);                                    \\
        might_fault();                                          \\
        __pu_val = x;                                           \\
        switch (sizeof(*(ptr))) {                               \\
        case 1:                                                 \\
                __put_user_x(1, __pu_val, ptr, __ret_pu);       \\
                break;                                          \\
        case 2:                                                 \\
                __put_user_x(2, __pu_val, ptr, __ret_pu);       \\
                break;                                          \\
        case 4:                                                 \\
                __put_user_x(4, __pu_val, ptr, __ret_pu);       \\
                break;                                          \\
        case 8:                                                 \\
                __put_user_x8(__pu_val, ptr, __ret_pu);         \\
                break;                                          \\
        default:                                                \\
                __put_user_x(X, __pu_val, ptr, __ret_pu);       \\
                break;                                          \\
        }                                                       \\
        __ret_pu;                                               \\
})

put_user 从内核空间复制一个简单的单值到用户空间。它支持简单类型数据复制，如 char 与 int ；但不支持大的数据类型，如结构与数组。
第 2 个参数 ptr 也必须指向一个简单变量类型的指针，并且第 1 个参数 x 可以赋值到 ptr 地址上，也就是说，x 类型和 ptr 指针类型是要一致的。