FreeBSD的null设备源代码注释

#include sys/cdefs.h>
__FBSDID("$FreeBSD: src/sys/dev/null/null.c,v 1.32 2006/11/06 13:41:54 rwatson Exp $");
#include sys/param.h>
#include sys/systm.h>
#include sys/conf.h>
#include sys/uio.h>
#include sys/kernel.h>
#include sys/malloc.h>
#include sys/module.h>
#include sys/priv.h>
#include sys/disk.h>
#include sys/bus.h>
#include machine/bus.h>
/*
* 该文件实现了2个设备: /dev/null和/dev/zero
* 设备指针在创建设备的时候得到,并被在模块UNLOAD时用于销毁设备.
*/
/* For use with destroy_dev(9). */
static struct cdev *null_dev;
static struct cdev *zero_dev;
/*
* 声明设备相关的操作
* /dev/null有write和ioctl,但是没有read操作
* 因此试图读取/dev/null就会马上得到一个EOF
* /dev/zero有read和write两个操作,只不过和null公用同一个write
*/
static d_write_t null_write;
static d_ioctl_t null_ioctl;
static d_read_t zero_read;
#define NULL_MINOR 2
#define ZERO_MINOR 12
/* null设备的设备结构 */
static struct cdevsw null_cdevsw = {
.d_version = D_VERSION,
.d_read = (d_read_t *)nullop,
.d_write = null_write,
.d_ioctl = null_ioctl,
.d_name = "null",
};
/* zero设备的设备结构 */
static struct cdevsw zero_cdevsw = {
.d_version = D_VERSION, /* 版本? 不知道具体什么含义 */
.d_read = zero_read,
.d_write = null_write,
.d_name = "zero",
.d_flags = D_MMAP_ANON, /* 表示对该设备调用mmap时需要特殊处理(什么特殊处理?) */
};
/*
* zero设备用来放置一个page的被0填充的页
* 在创建设备的时候分配空间并初始化
*/
static void *zbuf;
/* ARGSUSED */
static int
null_write(struct cdev *dev __unused, struct uio *uio, int flags __unused)
{
/* uio->uio_resid 是待处理的字节数,将其设为0,表示所有写入字节都已经处理完毕 */
uio->uio_resid = 0;
return (0); /* 成功返回 */
}
/* ARGSUSED */
static int
null_ioctl(struct cdev *dev __unused, u_long cmd, caddr_t data __unused,
    int flags __unused, struct thread *td)
{
int error;
/* DIOCSKERNELDUMP的定义如下:
  * #define DIOCSKERNELDUMP _IOW('d', 133, u_int) // Set/Clear kernel dumps
  * 该IOCTL选项用于修改该设备是否可用于内核core dump
  */
if (cmd != DIOCSKERNELDUMP)
  return (ENOIOCTL); /* null设备不支持除DIOCSKERNELDUMP外的其他选项 */
/* cmd == DIOCSKERNELDUMP */
error = priv_check(td, PRIV_SETDUMPER); /* 查看线程是否有权限 */
if (error)
  return (error);
/* 将null设备设置为dumper就等价于清除dumper */
return (set_dumper(NULL));
}
/* ARGSUSED */
static int
zero_read(struct cdev *dev __unused, struct uio *uio, int flags __unused)
{
int error = 0;
/* uio_resid表示未读取的字节数

标签：

版权申明：本站文章部分自网络，如有侵权，请联系：west999com@outlook.com
特别注意：本站所有转载文章言论不代表本站观点，本站所提供的摄影照片，插画，设计作品，如需使用，请与原作者联系，版权归原作者所有