目录
1. 函数原型
register_chrdev_region()原型如下:
原 型: int register_chrdev_region(dev_t from, unsigned count, const char *name)
功 能: 注册字符设备
@param1: 起始设备号
@param2: 设备数量
@param3: 设备名字
@return: 成功返回0,失败返回负数
2. 调用过程
2.1 register_chrdev_region
int register_chrdev_region(dev_t from, unsigned count, const char *name)
{
struct char_device_struct *cd;
dev_t to = from + count; // 计算分配设备号的最大值
dev_t n, next;
for (n = from; n < to; n = next) {
next = MKDEV(MAJOR(n)+1, 0); // 计算下一个设备号的值,其中次设备号为0
if (next > to) // 如果下一个设备号的值大于分配设备号的最大值,将to赋值给next,for循环只会执行一次
next = to;
cd = __register_chrdev_region(MAJOR(n), MINOR(n), next - n, name);
if (IS_ERR(cd))
goto fail;
}
return 0;
fail:
to = n;
for (n = from; n < to; n = next) {
next = MKDEV(MAJOR(n)+1, 0);
kfree(__unregister_chrdev_region(MAJOR(n), MINOR(n), next - n));
}
return PTR_ERR(cd);
}
在内核4.4版本中,MKDEV(ma,mi) ((ma)<<8 | (mi)),与之前的主设备号占高12位,次设备号占低20位不同,所以次设备号只能从0~255,一共有256个值。定义如下(linux-4.9.28\include\uapi\linux\kdev_t.h):
#define MAJOR(dev) ((dev)>>8)
#define MINOR(dev) ((dev) & 0xff)
#define MKDEV(ma,mi) ((ma)<<8 | (mi))
简单绘制一个图表示两个相邻的设备号之间的关系。其中表格上面的红色字表示主设备号,表格中间的黑色数字表示每个主设备号下的次设备号。
假设注册字符设备时,主设备定义的是5,起始次设备号为0,也就是 from = MKDEV(5, 0),数量是4,也就是 to = from + count = MKDEV(5, 4-1),在上图中用 to_1 表示,此时在图中可以看出 next > to,这是for循环只会执行一次,也就是 __register_chrdev_region 只会执行一次,而当一次注册的设备号 >256 的时候,例如注册260个时,此时to在图中的位置用 to_2 表示,这种情况下for循环会执行多次,相应的__register_chrdev_region 也会执行多次,本次只分析for循环执行一次的过程。
判断完注册的设备数量是否会溢出之后,接着会调用 __register_chrdev_region,传入的参数依次是主设备号、次设备号、设备数量、设备名字。
下面内容选自博客 http://blog.chinaunix.net/uid-29379418-id-4992151.html
2.2 __register_chrdev_region
static struct char_device_struct * __register_chrdev_region(unsigned int major, unsigned int baseminor, int minorct, const char *name)
{
struct char_device_struct *cd, **cp;
int i;
int ret = 0;
cd = kmalloc(sizeof(struct char_device_struct), GFP_KERNEL);/*slab分配一个char_device_struct变量*/
if (cd == NULL)
return ERR_PTR(-ENOMEM);
memset(cd, 0, sizeof(struct char_device_struct));/*将刚刚分配的变量的内存区清零*/
write_lock_irq(&chrdevs_lock);/*关中断,禁止内核抢占+读写锁*/
/* temporary */
if (major == 0) {/*分配一个主设备号!*/
for (i = ARRAY_SIZE(chrdevs)-1; i > 0; i--) {
if (chrdevs[i] == NULL)
break;
}
if (i == 0) {
ret = -EBUSY;
goto out;
}
major = i;
ret = major;
}
cd->major = major;
cd->baseminor = baseminor;
cd->minorct = minorct;/*申请设备号的个数*/
cd->name = name;
/****************以上为第一部分,处理char_device_struct变量的分配和初始化************/
/****************以下为第二部分,将char_device_struct变量注册到内核*****************/
i = major_to_index(major);/*将major对256取余数,得到可以存放char_device_struct在chrdevs中的索引*/
/*
*退出循环:
(1)chrdevs[i]为空
(2)chrdevs[i]的主设备号大于major
(3)chrdevs[i]的主设备号等于major,但是次设备号大于等于baseminor
*/
for (cp = &chrdevs[i]; *cp; cp = &(*cp)->next)
if ((*cp)->major > major ||
((*cp)->major == major &&
(((*cp)->baseminor >= baseminor) ||
((*cp)->baseminor + (*cp)->minorct > baseminor))))
break;
/*
*如果*cp不空,并且*cp的major与要申请的major相同,
*此时,如果(*cp)->baseminor < baseminor + minorct,就会发生冲突
*因为和已经分配了的设备号冲突了。
*出错!
*/
/* Check for overlapping minor ranges. */
if (*cp && (*cp)->major == major) {
int old_min = (*cp)->baseminor;
int old_max = (*cp)->baseminor + (*cp)->minorct - 1;
int new_min = baseminor;
int new_max = baseminor + minorct - 1;
/* New driver overlaps from the left. */
if (new_max >= old_min && new_max <= old_max) {
ret = -EBUSY;
goto out;
}
/* New driver overlaps from the right. */
if (new_min <= old_max && new_min >= old_min) {
ret = -EBUSY;
goto out;
}
}
/*
*所要申请的设备号可以满足
*/
cd->next = *cp;/*按照主设备号从小到达的顺序排列*/
*cp = cd;
write_unlock_irq(&chrdevs_lock);
return cd;
out:
write_unlock_irq(&chrdevs_lock);
kfree(cd);
return ERR_PTR(ret);
}
2.3 char_device_struct 结构体
static struct char_device_struct {
struct char_device_struct *next;
unsigned int major;
unsigned int baseminor;
int minorct;
char name[64];
struct cdev *cdev; /* will die */
} *chrdevs[CHRDEV_MAJOR_HASH_SIZE]; // 255
总结:体上分为两个步骤:
1. char_device_struct类型变量的分配以及初始化
2. 将char_device_struct变量注册到内核
1.char_device_struct类型变量的分配以及初始化
(1) 首先,调用 kmalloc 分配一个 char_device_struct 变量cd。检查返回值,进行错误处理。
(2) 将分配的char_device_struct变量的内存区清零memset。
(3) 获取chrdevs_lock读写锁,并且关闭中断,禁止内核抢占,write_lock_irq。
(4) 如果传入的主设备号major不为0,跳转到第(7)步。
(5) 这时,major为0,首先需要分配一个合适的主设备号。将 i 赋值成 ARRAY_SIZE(chrdevs)-1,其中的 chrdevs 是包含有256个char_device_struct *类型的数组,然后递减 i 的值,直到在chrdevs数组中出现 NULL。当chrdevs数组中不存在空值的时候,ret = -EBUSY; goto out;
(6) 到达这里,就表明主设备号major已经有合法的值了,接着进行char_device_struct变量的初始化。设置major, baseminor, minorct以及name。
2. 将char_device_struct变量注册到内核
(7) 将 i 赋值成 major_to_index(major) 将major对256取余数,得到可以存放char_device_struct在chrdevs中的索引
(8) 进入循环,在chrdevs[i]的链表中找到一个合适位置。
退出循环的条件:
(1)chrdevs[i]为空。
(2)chrdevs[i]的主设备号大于major。
(3)chrdevs[i]的主设备号等于major,但是次设备号大于等于baseminor。
注意:cp = &(*cp)->next,cp是char_device_struct **类型,(*cp)->next是一个char_device_struct 类型,所以&(cp)->next,就得到一个char_device_struct **,并且这时候由于是指针,所以对cp赋值,就相当于对链表中的元素的next字段进行操作。
(9) 进行冲突检查,因为退出循环的情况可能造成设备号冲突(产生交集)。如果cp不空,并且cp的major与要申请的major相同,此时,如果(*cp)->baseminor < baseminor + minorct,就会发生冲突,因为和已经分配了的设备号冲突了。出错就跳转到ret = -EBUSY; goto out;
(10) 到这里,内核可以满足设备号的申请,将cd链接到链表中。
(11) 释放chrdevs_lock读写锁,开中断,开内核抢占。
(12) 返回加入链表的char_device_struct变量cd。
(13) out出错退出
a. 释放chrdevs_lock读写锁,开中断,开内核抢占。
b. 释放char_device_struct变量cd,kfree。
c. 返回错误信息