ioctl

函数名: ioctl
功 能: 控制I/O设备
用 法: int ioctl(int handle, int cmd,[int *argdx, int argcx]);

include/asm/ioctl.h中定义的宏的注释：

#define   _IOC_NRBITS        8                               //序数（number）字段的字位宽度，8bits
#define   _IOC_TYPEBITS      8                               //幻数（type）字段的字位宽度，8bits
#define   _IOC_SIZEBITS      14                              //大小（size）字段的字位宽度，14bits
#define   _IOC_DIRBITS       2                               //方向（direction）字段的字位宽度，2bits

#define   _IOC_NRMASK       ((1 << _IOC_NRBITS)-1)    //序数字段的掩码，0x000000FF
#define   _IOC_TYPEMASK     ((1 << _IOC_TYPEBITS)-1)  //幻数字段的掩码，0x000000FF
#define   _IOC_SIZEMASK     ((1 << _IOC_SIZEBITS)-1)   //大小字段的掩码，0x00003FFF
#define   _IOC_DIRMASK      ((1 << _IOC_DIRBITS)-1)    //方向字段的掩码，0x00000003

#define   _IOC_NRSHIFT     0                                //序数字段在整个字段中的位移，0
#define   _IOC_TYPESHIFT   (_IOC_NRSHIFT+_IOC_NRBITS)       //幻数字段的位移，8
#define   _IOC_SIZESHIFT   (_IOC_TYPESHIFT+_IOC_TYPEBITS)   //大小字段的位移，16
#define   _IOC_DIRSHIFT    (_IOC_SIZESHIFT+_IOC_SIZEBITS)   //方向字段的位移，30

/*
* Direction bits.
*/

#define _IOC_NONE    0U     //没有数据传输
#define _IOC_WRITE   1U     //向设备写入数据，驱动程序必须从用户空间读入数据
#define _IOC_READ    2U     //从设备中读取数据，驱动程序必须向用户空间写入数据

#define _IOC(dir,type,nr,size) \
       (((dir)  << _IOC_DIRSHIFT) | \
        ((type) << _IOC_TYPESHIFT) | \
        ((nr)   << _IOC_NRSHIFT) | \
        ((size) << _IOC_SIZESHIFT))



/*
* used to create numbers
*/

//构造无参数的命令编号
#define _IO(type,nr)             _IOC(_IOC_NONE,(type),(nr),0)

//构造从驱动程序中读取数据的命令编号
#define _IOR(type,nr,size)     _IOC(_IOC_READ,(type),(nr),sizeof(size))

//用于向驱动程序写入数据命令
#define _IOW(type,nr,size)    _IOC(_IOC_WRITE,(type),(nr),sizeof(size))

//用于双向传输
#define _IOWR(type,nr,size) _IOC(_IOC_READ|_IOC_WRITE,(type),(nr),sizeof(size))



/*
*used to decode ioctl numbers..
*/

//从命令参数中解析出数据方向，即写进还是读出
#define _IOC_DIR(nr)          (((nr) >> _IOC_DIRSHIFT) & _IOC_DIRMASK)

//从命令参数中解析出幻数type
#define _IOC_TYPE(nr)              (((nr) >> _IOC_TYPESHIFT) & _IOC_TYPEMASK)

//从命令参数中解析出序数number
#define _IOC_NR(nr)           (((nr) >> _IOC_NRSHIFT) & _IOC_NRMASK)

//从命令参数中解析出用户数据大小
#define _IOC_SIZE(nr)         (((nr) >> _IOC_SIZESHIFT) & _IOC_SIZEMASK)


/* ...and for the drivers/sound files... */
#define IOC_IN            (_IOC_WRITE << _IOC_DIRSHIFT)
#define IOC_OUT           (_IOC_READ << _IOC_DIRSHIFT)
#define IOC_INOUT         ((_IOC_WRITE|_IOC_READ) << _IOC_DIRSHIFT)
#define IOCSIZE_MASK      (_IOC_SIZEMASK << _IOC_SIZESHIFT)
#define IOCSIZE_SHIFT     (_IOC_SIZESHIFT)

程序例:

#include <stdlib.h>
#include <stdio.h>
#include <sys/ioctl.h>

int main(void) {
..int stat;

/* use func 8 to determine if the default drive is removable */
..stat = ioctl(0, 8, 0, 0);
..if (!stat)
....printf("Drive %c is removable.\n", getdisk() + 'A');
..else
....printf("Drive %c is not removable.\n", getdisk() + 'A');
..return 0;
}

一、 什么是ioctl。
ioctl是设备驱动程序中对设备的I/O通道进行管理的函数。所谓对I/O通道进行管理，就是对设

备的一些特性进行控制，例如串口的传输波特率、马达的转速等等。它的调用个数如下：
int ioctl(int fd, ind cmd, …)；       其中fd就是用户程序打开设备时使用open函数返回

的文件标示符，cmd就是用户程序对设备的控制命令，至于后面的省略号，那是一些补充参数，

一般最多一个，有或没有是和cmd的意义相关的。       ioctl函数是文件结构中的一个属性分

量，就是说如果你的驱动程序提供了对ioctl的支持，用户就可以在用户程序中使用ioctl函数

控制设备的I/O通道。
二、 ioctl的必要性
如果不用ioctl的话，也可以实现对设备I/O通道的控制，但那就是蛮拧了。例如，我们可以在

驱动程序中实现write的时候检查一下是否有特殊约定的数据流通过，如果有的话，那么后面就

跟着控制命令（一般在socket编程中常常这样做）。但是如果这样做的话，会      导致代码

分工不明，程序结构混乱，程序员自己也会头昏眼花的。       所以，我们就使用ioctl来实

现控制的功能。要记住，用户程序所作的只是通过命令码告诉驱动程序它想做什么，至于怎么

解释这些命令和怎么实现这些命令，这都是驱动程序要做的事情。 三、 ioctl如何实现
这是一个很麻烦的问题，我是能省则省。要说清楚它，没有四五千字是不行的，所以我这里是

不可能把它说得非常清楚了，不过如果有读者对用户程序怎么和驱动程序联系起来感兴趣的话

，可以看我前一阵子写的《write的奥秘》。读者只要把write换成ioctl，就知道用户程序的io

ctl是怎么和驱动程序中的ioctl实现联系在一起的了。
我这里说一个大概思路，因为我觉得《Linux设备驱动程序》这本书已经说 的非常清楚了，但

是得化一些时间来看。在驱动程序中实现的ioctl函数体内，实际上是有一个switch{case}结构

，每一个case对应一个命令码，做出一些相应的操作。怎么实现这些操作，这是每一个程序员

自己的事情，因为设备都是特定的，这里也没法说。关键在于怎么样组织命令码，因为在ioctl

中命令码是唯一联系用户程序命令和驱动程序支持的途径。命令码的组织是有一些讲究的，因

为我们一定要做到命令和设备是一一对应的，这样才不会将正确的命令发给错误的设备，或者

是把错误的命令发给正确的设备，或者是把错误的命令发给错误的设备。这些错误都会导致不

可预料的事情发生，而当程序员发现了这些奇怪的事情的时候，再来调试程序查找错误，那将

是非常困难的事情。所以在Linux核心中是这样定义一个命令码的：
| 设备类型 | 序列号 |方向  |数据尺寸|     
|----------|--------|------|--------|     
| 8 bit    |  8 bit |2 bit |8~14 bit|
|----------|--------|------|--------|
这样一来，一个命令就变成了一个整数形式的命令码。但是命令码非常的不直观，所以Linux

Kernel中提供了一些宏，这些宏可根据便于理解的字符串生成命令码，或者是从命令码得到一

些用户可以理解的字符串以标明这个命令对应的设备类型、设备序列号、数据传送方向和数据

传输尺寸。这些宏我就不在这里解释了，具体的形式请读者察看Linux核心源代码中的和，文件

里给除了这些宏完整的定义。这里我只多说一个地方，那就是"幻数"。幻数是一个字母，数据

长度也是8，所以就用一个特定的字母来标明设备类型，这和用一 个数字是一样的，只是更加

利于记忆和理解。就是这样，再没有更复杂的了。更多的说了也没有，读者还是看一看源代码

吧，推荐各位阅读《Linux 设备驱动程序》所带源代码中的short一例，因为它比较短小，功能

比较简单，可以看明白ioctl的功能和细节。
四、 cmd参数如何得出
这里确实要说一说，cmd参数在用户程序端由一些宏根据设备类型、序列号、传送方向、数据尺

寸等生成，这个整数通过系统调用传递到内核中的驱动程序，再由驱动程序使用解码宏从这个

整数中得到设备的类型、序列号、传送方向、数据尺寸等信息，然后通过switch{case}结构进

行相应的操作。要透彻理解，只能是通过阅读源代码，我这篇文章实际上只是一个引子。Cmd参

数的组织还是比较复杂的，我认为要搞熟它还是得花不少时间的，但是这是值得的，驱动程序

中最难的是对中断的理解。
五、 小结
ioctl其实没有什么很难的东西需要理解，关键是理解cmd命令码是怎么在用户程序里生成并在

驱动程序里解析的，程序员最主要的工作量在switch{case}结构中，因为对设备的I/O控制都是

通过这一部分的代码实现的。
参考资料：      
1．《Linux设备驱动程序》，鲁宾尼著，中国电力出版社。

2．《write的奥秘》