put_user()和get_user()用户空间传递数据

一、往用户空间传递数据

1.传递单个数据

put_user()可以向用户空间传递单个数据。单个数据并不是指一个字节数据，对ARM而言, put_user一次性可传递一个char , short或者int型的数据,即1、2或者4字节。用put_user比用copy_to_user要快:

int put_user(x,p)

• x 为内核空间的数据，
• p 为用户空间的指针。
• 传递成功，返回 0，否则返回-EFAULT。

put_user 一般在 ioctl 方法中使用，假如要往用户空间传递一个 32 位的数据，可以这样实现：

static int char_cdev_ioctl (struct inode *inode, struct file *filp, unsigned int cmd, unsigned long arg)
{
　　int ret;
　　u32 dat,
　　switch(cmd)
　　{
　　　　case CHAR_CDEV_READ:
　　　　...其它操作
　　　　dat = 数据；
　　　　if (put_user(dat, (u32 *)arg) ) {
　　　　　　printk("put_user err\n");
　　　　　　return -EFAULT;
　　　　}
　　}
　　...其它操作
　　return ret;
}

__put_user 是没有进行地址验证的版本。

2．传递多个数据

copy_to_user()可以一次性向用户空间传递一个数据块，函数原型如下:

static inline unsigned long __must_check copy_from_user(void *to, const void __user *from, unsigned long n);

• to 是内核空间缓冲区地址，
• from 是用户空间地址，
• n 是数据字节数，
• 返回值是不能被复制的字节数，返回 0 表示全部复制成功。

copy_to_user()一般在 read 方法中使用。假如驱动要将从设备读到的 count 个数据送往用户空间，可以这样实现：

static ssize_t char_cdev_read(struct file *filp, char __user *buf, size_t count, loff_t *ppos)
{
    unsigned char data[256] = {0};
    ....从设备获取数据
    if (copy_to_user((void *)buf, data, count)) {
        printk("copy_to_user err\n");
    return -EFAULT;

    }
    return count;
}

__copy_to_user 是没有进行地址验证的版本。

 

二、从用户空间获取数据

1．获取单个数据

调用get_user()可以从用户空间获取单个数据，单个数据并不是指一个字节数据，对ARM而言，get_user一次性可获取一个char、short或者 int型的数据，即1、2或者4字节。用get_user比用get_from_user要快:

int get_user(x,p)

• x为内核空间的数据
• p为用户空间的指针。
• 获取成功，返回0，否则返回-EFAULT.

get_user()一般也用在ioctl方法中。假如驱动需要从用户空间获取一个32位数，然后写到某个寄存器中，可以这样实现:

static int char_cdev_ioctl (struct inode *inode, struct file *filp, unsigned int cmd, unsigned long arg)
{
　　int ret;
　　u32 dat,
switch(cmd)
{
　　case CHAR_CDEV_WRITE:
　　if (get_user(dat, (u32 *)arg) ) {
　　printk("get_user err\n");
　　return -EFAULT;
}
　　CHAR_CDEV_REG = dat;
　　...其它操作
}
　　...其它操作
　　return ret;
}

__get_user 是没有进行地址验证的版本。

 

2.获取多个数据

copy_from_user()可以一次性从用户空间获取一个数据块。
函数原型如下:

static inline unsigned long _must_ check copy_from_user(void *to, const void_user*from, unsigned long n);

• to是内核空间缓冲区地址，
• from是用户空间地址
• n是数据字节数
• 返回值是不能被复制的字节数，返回0表示全部复制成功。

copy_from_user()常用在 write方法中。如果驱动需要从用户空间获取count字节数据，用于操作设备，可以这样实现:

static ssize_t char_cdev_write(struct file *filp, const char __user *buf, size_t count, loff_t *ppos)
{
    unsigned char data[256];

    if (copy_from_user(&data, buf, 256) ) {
    printk("copy_from_user err\n");
    return -EFAULT;
    }
    ...
}

__copy_from_user 是没有进行地址验证的版本。