ioctl-number.rst

如果要向内核添加新的ioctl，则应该使用 <linux/ioctl.h> 中定义的 _IO 宏

上述的 read 和 write 应当像普通系统调用的命名规则一样，针对用户态视角来进行设计，而不是内核态视角。例如名为 SET_FOO 的cmd应当选用 _IOW ，因为其数据是从用户空间传向内核空间的(copy_from_user)、该指令以用户视角是写入，以内核视角是读取。而名为 GET_FOO 的cmd应当选用 _IOR ，因为其数据流向为内核空间到用户空间。

_IO 、 _IOW 、 _IOR 或 _IOWR 的第一个参数(即 type 字段，注1)是下方表格中的识别 letter 或 number 。由于驱动类型众多，许多驱动与其他驱动共用一个 letter 。

如果您正在为一个新设备编写驱动程序，并且需要一个 letter ，请选择一个有足够扩展空间的未使用块：32到256的ioctl命令。您可以通过修补这个文件并将修补程序提交给 Linus Torvalds 来注册这个块。或者你可以发电子邮件给我([email protected])，我会为你注册一个。

_IO 、 _IOW 、 _IOR 或 _IOWR 的第二个参数(即 nr 字段，注1)是用于区分ioctls的顺序数字。 _IOW 、 _IOR 或 _IOWR 的第三个参数(即 size 字段，注1)是进入内核或从内核出来的数据类型(例如， int 或 struct foo )。注意!不要使用 sizeof(arg) 作为第三个参数，因为这会导致ioctl认为它传递一个 size_t 类型的参数。

有些设备使用它们的主编号作为标识符; 只要它是唯一的就没问题。有些设备是不规则的，根本不遵循任何公约。

遵守这一共约是有益的，因为：

1. 保持ioctl的全局唯一性有助于错误检查：如果程序在错误的设备上调用ioctl，它将得到一个错误，而不是一些意外的行为。
2. strace 构建过程自动查找用 _IO 、 _IOW 、 _IOR 或 _IOWR 定义的ioctl数字。
3. 当数字是唯一的时候， strace 可以将数字解码回有用的名字。
4. 当使用这个约定来定义ioctl数字时，查找ioctl的人可以更容易地获取它们。
5. 在遵循约定时，驱动程序代码可以使用通用代码在用户和内核空间之间复制参数。

下表列出了从Linux/x86的用户界面可见的ioctls。它包含Linux2.6.31版本的大多数驱动程，但我知道我漏掉了一些。没有人试图从 drivers/staging/ 中列出非X86架构或ioctl。

1. 在 <asm-generic/ioctl.h> 中，这类宏的定义为：

/*
 * Used to create numbers.
 *
 * NOTE: _IOW means userland is writing and kernel is reading. _IOR
 * means userland is reading and kernel is writing.
 */
#define _IO(type,nr)		_IOC(_IOC_NONE,(type),(nr),0)
#define _IOR(type,nr,size)	_IOC(_IOC_READ,(type),(nr),(_IOC_TYPECHECK(size)))
#define _IOW(type,nr,size)	_IOC(_IOC_WRITE,(type),(nr),(_IOC_TYPECHECK(size)))
#define _IOWR(type,nr,size)	_IOC(_IOC_READ|_IOC_WRITE,(type),(nr),(_IOC_TYPECHECK(size)))
#define _IOR_BAD(type,nr,size)	_IOC(_IOC_READ,(type),(nr),sizeof(size))
#define _IOW_BAD(type,nr,size)	_IOC(_IOC_WRITE,(type),(nr),sizeof(size))
#define _IOWR_BAD(type,nr,size)	_IOC(_IOC_READ|_IOC_WRITE,(type),(nr),sizeof(size))
复制