有些操作可由任何类型的驱动程序执行,如装入模块所需的函数以及必需的自动配置入口点所需的函数。本节介绍通用于所有驱动程序的入口点类型。通用入口点汇总中列出了通用入口点,并包含指向手册页以及其他相关讨论的链接。
字符设备和块设备的驱动程序导出 cb_ops(9S) 结构,该结构定义用于块设备访问和字符设备访问的驱动程序入口点。这两种类型的驱动程序都需要支持 open(9E) 和 close(9E) 入口点。块驱动程序需要支持 strategy(9E),而字符驱动程序可选择实现适用于设备类型的 read(9E)、write(9E)、ioctl(9E)、mmap(9E) 或 devmap(9E) 入口点的任意组合。字符驱动程序还可通过 chpoll(9E) 支持轮询接口。块驱动程序以及那些可使用块文件系统和字符文件系统的驱动程序可通过 aread(9E) 和 awrite(9E) 支持异步 I/O。
所有驱动程序都需要实现可装入模块入口点 _init(9E)、_fini(9E) 和 _info(9E),以便装入、卸载和报告有关驱动程序模块的信息。
驱动程序应在 _init(9E) 中分配并初始化所有全局资源,并应在 _fini(9E) 中释放其资源。
在 Solaris OS 中,只有可装入模块例程必须在驱动程序对象模块的外部可见。其他例程可具有存储类 static。
对于设备自动配置,驱动程序需要实现 attach(9E)、detach(9E) 和 getinfo(9E) 入口点。设备(如 SCSI 目标设备)在引导过程中无法自标识时,驱动程序也可以实现可选入口点 probe(9E)。有关这些例程的更多信息,请参见第 6 章。
Solaris 平台提供了一组丰富的接口来维护和导出内核级统计信息(也称为 kstat)。驱动程序可以自由使用这些接口导出驱动程序和设备的统计信息,用户应用程序可使用这些统计信息来查看驱动程序的内部状态。提供了两个入口点来处理内核统计信息:
ks_snapshot(9E),可在特定时间捕获 kstat。
ks_update(9E),可用于根据需要更新 kstat 数据。在设置设备来跟踪内核数据但是提取该数据很耗时的情况下,ks_update() 非常有用。
有关详细信息,请参见 kstat_create(9F) 和 kstat(9S) 手册页。另请参见内核统计信息。
提供电源管理功能的硬件设备的驱动程序可支持可选的 power(9E) 入口点。有关此入口点的详细信息,请参见第 12 章。
下表列出了所有类型驱动程序都可使用的入口点。
表 1–1 用于所有驱动程序类型的入口点
类别/入口点 |
使用情况 |
说明 |
---|---|---|
cb_ops 入口点 | ||
必需 |
获取访问设备的权限。有关其他信息,请参见: |
|
必需 |
放弃访问设备的权限。STREAMS 驱动程序的 close() 版本具有不同于字符驱动程序和块驱动程序的签名。有关其他信息,请参见: |
|
可装入模块入口点 | ||
必需 |
初始化可装入模块。有关其他信息,请参见: 可装入驱动程序接口 |
|
必需 |
准备可装入模块以进行卸载。该入口点是所有驱动程序类型所必需的。有关其他信息,请参见: 可装入驱动程序接口 |
|
必需 |
返回有关可装入模块的信息。有关其他信息,请参见: 可装入驱动程序接口 |
|
自动配置入口点 | ||
必需 |
在初始化过程中向系统添加设备。此外,还用于恢复已暂停的系统。有关其他信息,请参见: attach() 入口点 |
|
必需 |
从系统中分离设备。此外,还用于临时暂停设备。有关其他信息,请参见: detach() 入口点 |
|
必需 |
获取特定于驱动程序的设备信息,如设备编号和相应实例之间的映射。有关其他信息,请参见: |
|
请参见说明 |
确定是否存在非自标识设备。该入口点是无法进行自标识的设备所必需的。有关其他信息,请参见: |
|
内核统计信息入口点 | ||
可选 | ||
可选 | ||
电源管理入口点 | ||
必需 |
设置设备的电源级别。如果不使用此入口点,则设置为 NULL。有关其他信息,请参见: power() 入口点 |
|
其他入口点 | ||
请参见说明 |
报告驱动程序属性信息。除非替换 ddi_prop_op(9F),否则此入口点是必需的。有关其他信息,请参见: |
|
请参见说明 |
系统出现故障时将内存转储到设备。对于出现紧急情况时要用作转储设备的任何设备,该入口点是必需的。有关其他信息,请参见: |
|
identify(9E) |
已过时 |
请勿使用此入口点。请在 dev_ops 结构中将 nulldev(9F) 指定给此入口点。 |