ioctl.c

带中文注释的 linux 0.11 源代码0.11,很好的

/*
* linux/fs/ioctl.c
*
* (C) 1991 Linus Torvalds
*/

#include <string.h>		// 字符串头文件。主要定义了一些有关字符串操作的嵌入函数。
#include <errno.h>		// 错误号头文件。包含系统中各种出错号。(Linus 从minix 中引进的)。
#include <sys/stat.h>		// 文件状态头文件。含有文件或文件系统状态结构stat{}和常量。

#include <linux/sched.h>	// 调度程序头文件，定义了任务结构task_struct、初始任务0 的数据，
// 还有一些有关描述符参数设置和获取的嵌入式汇编函数宏语句。

extern int tty_ioctl (int dev, int cmd, int arg);	// 终端ioctl(chr_drv/tty_ioctl.c, 115)。

// 定义输入输出控制(ioctl)函数指针。
typedef int (*ioctl_ptr) (int dev, int cmd, int arg);

// 定义系统中设备种数。
#define NRDEVS ((sizeof (ioctl_table))/(sizeof (ioctl_ptr)))

// ioctl 操作函数指针表。
static ioctl_ptr ioctl_table[] = {
  NULL,				/* nodev */
  NULL,				/* /dev/mem */
  NULL,				/* /dev/fd */
  NULL,				/* /dev/hd */
  tty_ioctl,			/* /dev/ttyx */
  tty_ioctl,			/* /dev/tty */
  NULL,				/* /dev/lp */
  NULL
};				/* named pipes */


//// 系统调用函数 - 输入输出控制函数。
// 参数：fd - 文件描述符；cmd - 命令码；arg - 参数。
// 返回：成功则返回0，否则返回出错码。
int
sys_ioctl (unsigned int fd, unsigned int cmd, unsigned long arg)
{
  struct file *filp;
  int dev, mode;

// 如果文件描述符超出可打开的文件数，或者对应描述符的文件结构指针为空，则返回出错码，退出。
  if (fd >= NR_OPEN || !(filp = current->filp[fd]))
    return -EBADF;
// 取对应文件的属性。如果该文件不是字符文件，也不是块设备文件，则返回出错码，退出。
  mode = filp->f_inode->i_mode;
  if (!S_ISCHR (mode) && !S_ISBLK (mode))
    return -EINVAL;
// 从字符或块设备文件的i 节点中取设备号。如果设备号大于系统现有的设备数，则返回出错号。
  dev = filp->f_inode->i_zone[0];
  if (MAJOR (dev) >= NRDEVS)
    return -ENODEV;
// 如果该设备在ioctl 函数指针表中没有对应函数，则返回出错码。
  if (!ioctl_table[MAJOR (dev)])
    return -ENOTTY;
// 否则返回实际ioctl 函数返回码，成功则返回0，否则返回出错码。
  return ioctl_table[MAJOR (dev)] (dev, cmd, arg);
}