SMBIOS(System Management BIOS , SMBIOS) 是主板或系统制造者以标准格式显示产品管理信息所需遵循的统一规范。 DMI(Desktop Management Interface, DMI) 就是帮助收集电脑系统信息的管理系统, DMI 信息的收集必须在严格遵照 SMBIOS 规范的前提下进行。 SMBIOS 和 DMI 是由行业指导机构 Desktop Management Task Force (DMTF) 起草的开放性的技术标准,其中, DMI 设计适用于任何的平台和操作系统。 DMI 充当了管理工具和系统层之间接口的角色。它建立了标准的可管理系统更加方便了电脑厂商和用户对系统的了解。
DMI 的主要组成部分是 Management Information Format (MIF) 数据库。这个数据库包括了所有有关电脑系统和配件的信息。通过 DMI ,用户可以获取序列号、电脑厂商、串口信息以及其它系统配件信息。
对于符合 SMBIOS 规范的计算机,可以通过访问 SMBIOS 的结构获得系统信息,共有两种办法可以访问:
1. 通过即插即用功能接口访问 SMBIOS 结构,这个在 SMBIOS2.0 标准里定义了,从 SMBIOS 2.1 开始这个访问方法不再被推荐使用。
2 .基于表结构的方法,表内容是 table entry point 的数据,这个访问方法从 SMBIOS 2.1 以后开始被使用,从 2.1 开始,以后的版本都推荐使用这种访问方式。在 2.1 版本中允许支持这两种方法中的任意一种和两种都支持,但在 2.2 以后的版本,必须支持方法 2 。在最新的 2.7.0 版中第一种方法已经废弃。
鉴于市场上计算机已经均支持 SMBIOS2.3 标准,所以只考虑方法 2 ,基于表结构的访问方式。基于表结构访问 SMBIOS 的过程是先找到 Entry Point Structure ( EPS )表,然后通过 Entry Point Structure ( EPS )表的数据找到 SMBIOS 结构表。
对于非 EFI 的系统,访问 SMBIOS EPS 表的操作过程如下:
1 .从物理内存 0x000F0000-0x000FFFFF 之间寻找关键字 “ _SM_” 。
2 .找到后再向后 16 个字节,看后面 5 个 BYTE 是否是关键字 “_DMI_” ,如果是, EPS 表即找到。
对于 UEFI (是 BIOS 的下一代版本)系统,可能通过搜索 EFI 配置表中的 SMBIOS GUID(SMBIOS_TABLE_GUID) ,然后使用指向 SMBIOS 的指针来定位 EPS 表。具体可参考 UEFI 规范。
SMBIOS EPS 表结构如下:
位置 | 名称 | 长度 | 描述 |
00H | 关键字 | 4BYTE | 固定是”_SM_” |
04H | 校验和 | 1BYTE | 用于校验数据 |
05H | 表结构长度 | 1BYTE | Entry Point Structure 表的长度 |
06H | Major 版本号 | 1BYTE | 用于判断SMBIOS 版本 |
07H | Minor 版本号 | 1BYTE | 用于判断SMBIOS 版本 |
08H | 表结构大小 | 2BYTE | 用于即插即用接口方法获得数据表结构长度 |
0AH | EPS 修正 | 1BYTE |
|
0B-0FH | 格式区域 | 5BYTE | 存放解释EPS 修正的信息 |
10H | 关键字 | 5BYTE | 固定为“_DMI_” |
15H | 校验和 | 1BYTE | Intermediate Entry Point Structure (IEPS) 的校验和 |
16H | 结构表长度 | 2BYTE | SMBIOS 结构表的长度 |
18H | 结构表地址 | 4BYTE | SMBIOS 结构表的真实内存位置 |
1CH | 结构表个数 | 2BYTE | SMBIOS 结构表数目 |
1EH | Smbios BCD 修正 | 1BYTE |
|
通过 EPS 表结构中 16H 以及 18H 处,得出数据表长度和数据表地址,即可通过地址访问 SMBIOS 数据结构表。从 EPS 表中的 1CH 处可得知数据表结构的总数,其中 TYPE 0 结构就是 BIOS information , TYPE 1 结构就是 SYSTEM Information 。
每个结构的头部是相同的,格式如下:
位置 | 名称 | 长度 | 描述 |
00H | TYPE 号 | 1BYTE | 结构的TYPE 号 |
01H | 长度 | 1BYTE | 本结构的长度,就此TYPE 号的结构而言 |
02H | 句柄 | 2BYTE | 用于获得本SMBIOS 结构,其值不定 |
每个结构都分为格式区域和字符串区域,格式区域就是一些本结构的信息,字符串区域是紧随在格式区域后的一个区域。结构 01H 处标识的结构长度仅是格式区域的长度,字符串区域的长度是不固定的。有的结构有字符串区域,有的则没有。
下面以 TYPE 0 ( BIOS information )为例说明格式区域和字符串区域的关系。 TYPE 0 ( BIOS information )格式区域如下:
位置 | 名称 | 长度 | 描述 |
00H | TYPE 号 | 1BYTE | 结构的TYPE 号,此处是0 |
01H | 长度 | 1BYTE | TYPE 0 格式区域的长度,一般为14H ,也有13H |
02H | 句柄 | 2BYTE | 本结构的句柄,一般为0000H |
04H | Bios 厂商信息 | 1BYTE | 此处是bios 卖方的信息,可能是OEM 厂商名,一般为01H ,代表紧随格式区域后的字符串区域的第一个字符串 |
05H | BIOS 版本 | 1BYTE | BIOS 版本号,一般为02H ,代表字符串区域的第二个字符串 |
06H | Bios 开始地址段 | 2BYTE | 用于计算常驻BIOS 镜像大小的计算,方法为 (10000H-BIOS 开始地址段)×16 |
08H | BIOS 发布日期 | 1BYTE | 一般为03H ,表示字符区第三个字符串 |
09H | BIOS rom size | 1BYTE | 计算方法为(n +1 )×64K ,n 为此处读出数值 |
0AH | BIOS 特征 | 8BYTE | Bios 的功能支持特征,如PCI,PCMCIA,FLASH 等 |
12H | Bios 特征扩展 | 不定 |
|
紧随 TYPE 0 ( BIOS information )结构区域之后,即在 Bios 特征扩展域后面的就是 TYPE 0 ( BIOS information )字符串区域,一个例子如下所示:
- db ‘System BIOS Vendor Name’,0 ; 字符串以零结尾,第一个字符串:BIOS厂商
- db ‘4.04’,0 ; 第二个:BIOS版本
- db ‘00/00/0000’,0 ; 第三个:BIOS发布日期
- db 0 ; 以0为整个字符中区域的结尾
每个字符串都以 00H 作为结束标志,上面的例子中有三个字符串。如果我们要找下一个 TYPE ,因为最后一个字符串以 00H 结尾,而整个字符区域又以 00H 结尾,故只要在字符串区域找到连续的 0000H 即可。例如,一个带字符串域的完整 BIOS Information 例子如下:
- BIOS_Info LABEL BYTE
- db 0 ; Indicates BIOS Structure Type
- db 13h ; Length of information in bytes
- dw ? ; Reserved for handle
- db 01h ; String 1 is the Vendor Name
- db 02h ; String 2 is the BIOS version
- dw 0E800h ; BIOS Starting Address
- db 03h ; String 3 is the BIOS Build Date
- db 1 ; Size of BIOS ROM is 128K (64K * (1 + 1))
- dq BIOS_Char ; BIOS Characteristics
- db 0 ; BIOS Characteristics Extension Byte 1
- db ‘System BIOS Vendor Name’,0 ;
- db ‘4.04’,0 ;
- db ‘00/00/0000’,0 ;
- db 0 ; End of strings
一个不带字符串域的完整 BIOS Information 例子:
- BIOS_Info LABEL BYTE
- db 0 ; Indicates BIOS Structure Type
- db 13h ; Length of information in bytes
- dw ? ; Reserved for handle
- db 00h ; No Vendor Name provided
- db 00h ; No BIOS version provided
- dw 0E800h ; BIOS Starting Address
- db 00h ; No BIOS Build Date provided
- db 1 ; Size of BIOS ROM is 128K (64K * (1 + 1))
- dq BIOS_Char ; BIOS Characteristics
- db 0 ; BIOS Characteristics Extension Byte 1
- dw 0000h ; Structure terminator
注意,当从 EPS 表中得到结构表的开始地址后,可以直接按结构来寻找相应的 TYPE 号,找到后直接读取就是该 TYPE 对应的结构的格式区域信息,然后向后移动结构区域长度(结构区域长度由该结构的 01H 处读出)个 BYTE ,即是该 TYPE 结构的字符串区域。
由上面介绍可知,获得 BIOS 信息的办法就是:
1 .通过 EPS 表的 12H 和 14H 数据找到 TYPE 结构表,然后找到 TYPE 0 的内存地址 ( 不一定是首个 ) 。
2 .由 TYPE 0 结构区域中得出相应 BIOS 信息是否存在(存在则是上面所述的 01H,02H,03H 依次排布,不存在则是相应的位置上为 00H )。
3 .如存在信息,则从字符串区域中读取对应 BIOS 信息。
获得其他类型的 SMBIOS 结构信息的方法类似,只是 TYPE 结构区域有所不同。
相信大家都用过一些系统检测软件 , 或者至少用过 Windows 优化大师里面的系统检测。实际上,应用程序程序就可以通过访问 SMBIOS 来获得这些信息。这里举一个例子,演示如何找到 BIOS 的版本号 (BIOS Version) 和电脑的厂商 (Manufacturer) 。不过我们不采用编程的方式,而是通过系统自带的 debug 命令来进行相关的操作。
内存的物理地址区间 0x000F0000-0x000FFFFF 使用了 32 位中的 20 位,先要在这个区间内寻找关键字 “ _SM_” ,以定位到 EPS 表。我们要采用 20 位地址模式,即高位字左移 12 位,因此值 0x000F0000 表示为 F000:0000 ,地址区间为 F000:0000 - F000:FFFF 。在 cmd 中输入 "debug", 回车 , 这样就进入了 debug 环境,它的命令提示符为 - , 以后出现在 - 后面的内容都为将要输入的命令。
在地址区间内搜索关键字 "_SM_" 的起始地址:
-s f000:0 ffff '_SM_'
以我的电脑为例 , 响应可能是下面这样的:
-s f000:0 ffff '_SM_'
F000:6C00
这个地址就是 EPS 表的起始地址。也有可能你的电脑会显示多个查找结果,不妨先随意选择一个进行下面的操作:
-d F000:6C00
会打印该地址后面 16*8 个字节的内容,可能的响应:
- -d F000:6C00
- F000:6C00 5F 53 4D 5F 16 1F 02 1F-4B 01 00 00 00 00 00 00 _SM_....K.......
- F000:6C10 5F 44 4D 49 5F 3D 98 09-10 30 0E 00 3C 00 00 00 _DMI_=...0..<...
- F000:6C20 52 53 44 20 50 54 52 20-DE 4E 45 43 20 20 20 00 RSD PTR .NEC .
- F000:6C30 34 95 F7 0D 00 00 00 00-00 00 00 00 00 00 00 00 4...............
- F000:6C40 00 00 00 00 00 00 00 00-00 00 00 00 00 00 00 00 ................
- F000:6C50 24 46 53 58 56 0C F8 00-B1 00 E0 00 00 00 00 00 $FSXV...........
- F000:6C60 5F 33 32 5F 20 D7 0F 00-00 01 D6 00 00 00 00 00 _32_ ...........
- F000:6C70 24 50 44 4D 01 0B 1A 5D-88 00 F0 00 00 00 00 00 $PDM...]........
如果嫌显示的行数太少 , 可以用 -d 继续打印后面的信息。注意到了吗, _SM_ (其 ASCII 编码为 5F 53 4D 5F ),还有 10H 偏移处(即偏移 16 个字节)的 _DMI_ 。如果你在上一步中有多个结果,那么只要某个结果通过 d 命令查看的结果符合这两个特征,我们就可以用它来继续下面的操作。至这一步, EPS 已经找到了。
EPS 的偏移 18H 处的 4 字节为 10 30 0E 00 ,是 SMBIOS 结构表的 32 位地址。这 4 个字节是从低字节到高字节,因为 x86 采用小端字节序,低字节存放的是高位的值,因此重新写成 " 高位 低位 " 的格式就是 000E 3010 ,转换成 20 位格式就把高位左移 12 位,变成 E000:3010 的形式。打印该地址处的内容:
-d e000:3010
可能的响应:
- -d e000:3010
- E000:3010 00 14 00 00 01 02 F5 E4-03 07 90 DF 99 7C 00 00 .............|..
- E000:3020 00 00 05 03 4E 45 43 20-20 20 20 20 00 4E 4F 54 ....NEC .NOT
- E000:3030 45 20 42 49 4F 53 20 56-65 72 73 69 6F 6E 20 2F E BIOS Version /
- E000:3040 33 36 39 41 30 36 30 30-20 00 30 39 2F 31 30 2F 369A0600 .09/10/
- E000:3050 32 30 30 33 00 00 01 19-01 00 01 02 03 04 8B B0 2003............
- E000:3060 DE 65 92 46 40 EB 86 FE-56 28 BD 80 79 13 06 4 E .e.F@...V(..y..N
- E000:3070 45 43 20 43 6F 6D 70 75-74 65 72 73 20 49 6E 74 EC Computers Int
- E000:3080 65 72 6E 61 74 69 6F 6E-61 6C 00 50 43 2D 43 56 ernational.PC-CV
首先,第一个字节 ( 零偏移处 ) 是 00 ,根据规范,这说明从这里开始的信息为 TYPE 0 结构,也即 BIOS 信息区。第二个字节 ( 偏移 01H 处 ) 是 14 ,说明 TYPE 0 区域的基本大小是 14H 。根据规范,偏移 02H 处的两个字节为 00 00 ,表示句柄。偏移 04H 处的字节为 01 ,表示 BIOS 厂商这个字符串在 Type 0 字符串区域中的编号,即字符串区域中的第 01 个字符串就 BIOS 厂商。偏移 05H 处的字节为 02 ,表示 BIOS 版本字符串在字符串区域中的编号。偏移 08H 处的字节为 03 ,表示 BIOS 发布日期字符串在字符串区域中的编号。
TYPE 0 区的基本大小为 14H ,则偏移 14H 处是 TYPE 0 字符串区域的开始。偏移 14H 处的值是 4E (右面对应的 ASCII 字符是 N ),这就是 TYPE 0 字符串区域的开始,它们是不包括在 TYPE 的大小计算中的。每个字符串不定长,由 00H 作为结束标志。熟悉 C/C++ 的人应该对这一标志符比较亲切吧。从第一个字符串依次编号为 01 , 02... 。第 01 个字符串为 ”NEC” (这里结束标志 00 前还插入了若干个控制字符 20 ),是 BIOS 厂商,第 02 个字符串为 "NOTE BIOS Version / 369A0600 " ,是 BIOS 版本,第 03 个字符串为 ”09/10/2003” ,是 BIOS 发布日期,这样我们的第一个目标 BIOS 版本就找到了。
整个字符串区的结束用 00 来标志,又根据字符串的结束符为 00 ,所以找到 00 00 ,从 00 00 的下一个地址开始就是下一个信息区了。这个例子中,就是 E000:3056 处,内容是 01 ,作为下一个区域的第一个字节,它标志着此 TYPE 的类型 , 这里就是 TYPE 1, 也即 System Information 。
根据与 TYPE 0 类似的方法 , 我们从 TYPE 1 的偏移 01H 处得到 TYPE 1 的大小为 19H , 而 SMBIOS 规范中说明, TYPE 1 的偏移 04H 处即为 Manufacturer 字符串的编号,这里即为 01 。转到 TYPE 1 的偏移 19H 处,即为 TYPE 1 的字符串区的开始,由于我们要找的信息编号为 01 ,所以从这里开始的信息 "NEC Computers International" 即为厂商的信息。
SMBIOS 支持在保护模式下工作,因此,在 Windows 中使用 16 位汇编进行程序编写将使得对物理内存进行访问变得非常容易。
(二)
从 SMBIOS 2.3 版本开始,兼容 SMBIOS 的实现必须包含以下 10 个数据表结构: BIOS 信息 (Type 0) 、系统信息 (Type 1) 、系统外围或底架 (Type 3) 、处理器信息 (Type 4) 、高速缓存信息 (Type 7) 、系统插槽 (Type 9) 、物理存储阵列 (Type 16) 、存储设备 (Type 17) 、存储阵列映射地址 (Type 19) 、系统引导信息 (Type 32) 。
其他的结构表则可根据实际来决定是否需要实现。最新的 SMBIOS 2.7.0 版中定义的所有结构表包括 Type 0-Type 42 ,其中 Type 5 、 Type 6 和 Type 10 已经废弃。另外还有 Type 126 和 Type 127 两个特殊结构表。如下:
BIOS 信息 (Type 0) 、系统信息 (Type 1) 、基板(或模块)信息 (Type 2) 、系统外围或底架 (Type 3) 、处理器信息 (Type 4) 、存储控制器信息 (Type 5, 已 废弃 ) 、存储模块信息 (Type 6, 已废弃 ) 、调整缓存信息 (Type 7) 、端口连接器信息 (Type 8) 、系统插槽 (Type 9) 。
板载设备信息 (Type 10) 、 OEM 字符串 (Type 11) 、系统配置选项 (Type 12) 、 BIOS 语言信息 (Type 13) 、组相联 (Type 14) 、系统事件日志 (Type 15) 、物理存储阵列 (Type 16) 、存储设备 (Type 17) 、 32-bit 内存错误信息 (Type 18) 、存储阵列映射地址 (Type 19) 。
存储设备映射地址 (Type 20) 、内建指针设备 (Type 21) 、便携式电池 (Type 22) 、系统重置 (Type 23) 、硬件安全 (Type 24) 、系统电源控制 (Type 25) 、电压探针 (Type 26) 、冷却设备 (Type 27) 、温度传感器 (Type 28) 、电流探头 (Type 29) 。
越界远程访问 (Type 30) 、引导完整性服务 (BIS) 入口点 (Type 31) 、系统引导信息 (Type 32) 、 64-bit 内存错误信息 (Type 33) 、管理设备 (Type 34) 、管理设备组件 (Type 35) 、管理设备门槛数据 (Type 36) 、存储信道 (Type 37) 、 IPMI 设备信息 (Type 38) 、系统供电电源 (Type 39) 。
附加信息 (Type 40) 、板载设备扩展信息 (Type 41) 、管理控制器主机接口 (Type 42) 。
不活动指示 (Type 126) 、表格结束指示 (Type 127) 。
SMBIOS 的大部分结构表数据在 CIM 模型中都有对应的实现,比如底架信息对应 CIM_Chassis ,处理器信息对应 CIM_Processor ,内存信息对应 CIM_Memory 等。
下面介绍主要的结构表。
1 、 BIOS 信息 (Type 0) :
位置 | 名称 | 长度 | 描述 |
00h | TYPE 号 | 1BYTE | 结构的TYPE 号,此处是0 |
01h | 长度 | 1BYTE | TYPE 0 格式区域的长度,一般为14h ,也有13h |
02h | 句柄 | 2BYTE | 指向本结构的句柄 |
04h | Bios 厂商信息 | 1BYTE | 此处是bios 卖方的信息,可能是OEM 厂商名,一般为01h ,代表紧随格式区域后的字符串区域的第一个字符串 |
05h | BIOS 版本 | 1BYTE | BIOS 版本号,一般为02h ,代表字符串区域的第二个字符串 |
06h | Bios 开始地址段 | 2BYTE | 用于计算常驻BIOS 镜像大小的计算,方法为 (10000h-BIOS 开始地址段)×16 |
08h | BIOS 发布日期 | 1BYTE | 一般为03h ,表示字符区第三个字符串 |
09h | BIOS ROM size | 1BYTE | 计算方法为(n +1 )×64K ,n 为此处读出数值 |
0Ah | BIOS 特征 | 8BYTE | Bios 的功能支持特征,如PCI,PCMCIA,FLASH 等 |
12h | BIOS 特征扩展 | 不定 | 从2.4 版开始包含两个扩展字节(12h-13h) ,以及字节14h-17h |
14h | BIOS 版本主号 | 1BYTE | 若系统不支持此域,则值设为ffh |
15h | BIOS 版本从号 | 1BYTE | 若系统不支持此域,则值设为ffh |
16h | 内置控制器固件的版主号 | 1BYTE | 若系统不支持此域,则值设为ffh |
17h | 内置控制器固件的版从号 | 1BYTE | 若系统不支持此域,则值设为ffh |
BIOS 特征域表示BIOS 对一些特性的支持情况,Bit 1 和Bit 1 保留,Bit 2 未知,Bit 3 表示本BIOS 特征域是否被支持。
Bit 4-Bit 19 分别表示是否支持ISA 、MCA 、EISA 、PCI 、PCMCIA 、PnP 、APM 、BIOS 刷新、BIOS 影像(把 BIOS 的只读内容拷贝到快一些的内存中)、VL-VESA 、ESCD 、从CD 引导、可选择的引导、BIOS ROM 是否被插装、从PCMCIA 引导、EDD 规范。
Bit 20-Bit 25 表示对各种型号的软盘支持情况(均为中断Int 13h ),包括NEC 9800 1.2MB 软盘、Toshiba 1.2MB 软盘、5.25”/360KB 软盘、5.25”/1.2MB 软盘、3.5”/720KB 软盘、3.5”/2.88MB 软盘。
Bit 26-Bit 29 表示是否支持中断Int 5h(PrintScreen 屏幕截取服务) 、Int 9h(8042 键盘服务) 、Int 14h( 串口服务) 、Int 17h( 打印机服务) 、Int 10h(CGA/Mono 视频服务) 、NEC PC-98 。
Bit 32:47 保留给BIOS 厂商使用。
Bit 48:63 保留给计算机系统厂商使用。
BIOS 特征扩展字节1( 偏移12h 处) 表示对另外一些设备的支持情况,Bit 0-Bit 1 分别表示是否支持ACPI 、USB 遗留、AGP 、I2O 引导、LS-120 SuperDisk 引导、ATAPI ZIP 驱动器引导、1394 引导、智能电池。
BIOS 特征扩展字节2( 偏移13h 处) 表示对一些高级特性的支持情况。Bit 1-Bit3 表示是否支持功能键初始化网络服务引导、激活目标内容分发、UEFI 规范。Bit 4 表示SMBIOS 表描述的是一台虚拟机,Bit 5:7 保留。
2 、系统信息 (Type 1) : SMBIOS 实现只关联一个单一的系统实例,并且包含且只包含一个系统信息结构。
位置 | 名称 | 长度 | 描述 |
00h | TYPE 号 | 1BYTE | 结构的TYPE 号,此处是1 |
01h | 长度 | 1BYTE | 格式区域总长度,2.0 版为08h ,2.1-2.3.4 版为19h ,从2.4 版开始为1Bh |
02h | 句柄 | 2BYTE | 指向本结构的句柄 |
04h | 电脑制造商 | 1BYTE | 一般为01h ,表示在字符串区域中的编号 |
05h | 产品名称 | 1BYTE | 在字符串区域中的编号 |
06h | 版本号 | 1BYTE | 在字符串区域中的编号 |
07h | 序列号 | 1BYTE | 在字符串区域中的编号 |
09h | UUID | 16BYTE | 通用唯一标识符 |
18h | 唤醒类型 | BYTE | 用来标识导致系统开电启动的事件 |
19h | SKU 号 | BYTE | 在字符串区域中的编号,SKU 号通常为产品ID 或采购订单号 |
1Ah | 产品家族 | 1BYTE | 在字符串区域中的编号 |
UUID 为 128 bit 长,是一个穿越时间和空间的唯一标识符,不需要集中的注册过程。它的格式在 RFC 4122 有详细的描述,内容比较繁锁,但 SMBIOS 并不关注这个,它只关注字节序。 UUID 的字节顺序以及在 RFC 4122 中对应域的名字如下:
time_low :偏移 00h 处, 4BYTEs ,为时间戳的低位域部分。
time_mid : 04h 处, 2BYTEs , 为时间戳的中间域部分。
time_hi_and_version : 06h 处, 2BYTEs ,为时间戳的高位域,同时还包含版本号。
clock_seq_hi_and_reserved : 08h 处, 1BYTE ,时钟序列的高位域部分,同时还包含保留部分。
clock_seq_low : 09h 处, 1BYTE ,时钟序列的低位域部分。
Node : 0Ah 处, 6BYTEs ,唯一结点标识符。
虽然 RFC 4122 建议对所有域都使用网络字节序(为大端字节序),但 PC 工业界(包括 ACPI , UEFI 和微软的规范)都对前面的三个域 time_low , time_mid , time_hi_and_version 使用小端字节序。同样地,电报格式的编码也被用来描述 SMBIOS 规范中的 UUID 。因此, UUID {00112233-4455-6677-8899-AABBCCDDEEFF} 被表示为 33 22 11 00 55 44 77 66 88 99 AA BB CC DD EE FF 。如果 ID 的所有字节都为 FFh ,表示当前 ID 在系统中不存在但可以被设置。如果所有字节都为 00h ,表示 ID 在系统中不存在。
对于唤醒类型域, 00h 保留, 01h 为其他, 02h 未知, 03h 为 APM 定时器, 04h 调制解调器拨响, 05h 为 LAN 远程, 06h 电源开关, 07h 为 PCI PME# , 08h 为 AC 电源恢复。
其他各个结构表的详细格式可参考 SMBIOS 规范,在 http://www.dmtf.org/standards/smbios 处。这里主要概述一下主要结构表所包含的对我们有用重要信息。
基板或模块单元信息 (Type 2) :制造商、产品名、版本、序列号、资产标签、特征标志、基板在底架上的位置、底架句柄、基板类型、包含的对象句柄个数、包含的个各对象句柄。
系统外围或底架 (Type 3) :制造商、类型、版本、序列号、资产标签号、启动状态、供电电源状态、热量状态、安全状态、 OEM 定义信息、高度、电源线个数、包含的单元个数、包含的单元记录长度、包含的各个单元、 SKU 号。
处理器信息 (Type 4) :插座指示、处理器类型、处理器家族、制造商、 ID 、版本、电压伏特数、外部时钟频率 (MHz) 、最大速率 (MHz) 、当前速率、状态、处理器升级、 L1 级缓存信息结构的句柄、 L2 级缓存信息结构的句柄、 L3 级缓存信息结构的句柄、序列号、资产标签、部件号码、内核个数、激活的内核个数、线程个数、处理器特征、处理器家族 2 。
高速缓存信息 (Type 7) :插座指示、缓存配置、最大缓存容量、已安装的容量、支持的 SRAM 类型、当前 SRAM 类型、缓存速率、纠错类型、系统缓存类型、关联性。
端口连接器信息 (Type 8) :例如并口、串口、键盘、鼠标器端口等都属于端口连接器。包含的信息有内部引用指示符、内部连接器类型、外部引用指示符、外部引用类型、端口类型。
系统插槽 (Type 9) :插槽指示符、插槽类型、插槽数据总线宽度、当前是否在使用、插槽长度、插槽 ID 、插槽特征 1 、插槽牲 2 、段组编号、总线编号、设备 / 函数编号。
OEM 字符串 (Type 11) :由 OEM 指定的描述字符串。
系统配置选项 (Type 12) :用来配置基板跳线和开关的信息字符串。
BIOS 语言信息 (Type 13) :可安装的语言、标志位字节、保留的 15 字节、当前语言。这里的语言是指英语、法语、汉语等国家语言,而不是计算机编程语言。
组相联 (Type 14) :组名、本项的类型、本结构的句柄。级相联用于指明某些部件的布局或层次,例如指明两个 CPU 共享一个外部缓存系统。
系统事件日志 (Type 15) :事件日志存放在非易失性的存储单元中,占据固定长度的区域, 以一个固定长度(和特定于厂商)的头部开始,后跟一个或多个可变长度的日志记录。应用程序可以通过周期性地读取系统事件日志结构(通过它的句柄)并在日志改变标记中搜索日志的更新,以实现事件日志改变通知。这里日志改变标记唯一地标识事件日志最后一次更新的时间。本结构包含的信息有日志区域长度、日志头部起始偏移、日志数据起始偏移、存取方法(如索引 I/O, 内存映射物理地址,通知目的非易失性数据函数等)、日志状态、日志改变标记、存取方法地址、日志头部格式、支持的日志类型描述符、每个日志类型描述符的长度、日志类型描述符列表。这里存取方法地址可用以下联合类型来表示:
- union {
- struct {
- short IndexAddr;
- short DataAddr;
- } IO;
- long PhysicalAddr32;
- short GPNVHandle;
- } AccessMethodAddress;
每个日志记录的格式都包含 8 字节的记录头部(事件类型、长度、日期时间域),后跟不定长的日志数据。
物理存储器阵列 (Type 16) :位置(系统板卡或附加板卡上)、存储功能、内存纠错、最大容量、存储错误信息句柄、存储设备数目、已扩展的最大容量。
存储设备 (Type 17) :用于描述物理存储器阵列中的单个存储设备。在物理存储器阵列中的句柄、存储错误信息句柄、存储总宽度、数据宽度、存储容量、形体尺寸、设备集、设备定位器、记忆槽定位器、存储器类型、类型额外细节、速率、制造商、序列号、资产标签、部件号码、属性标志、已扩展的容量、已配置的存储时钟速率。
32-bit 错误信息 (Type 18) :错误类型、错误粒度、错误操作、特定于制造商的错误表现、存储阵列错误地址、设备错误地址、错误解析。
存储阵列映射地址 (Type 19) :起始地址、结束地址、存储阵列句柄、分区宽度、已扩展的起始地址、已扩展的结束地址。
存储设备映射地址 (Type 20) :起始地址、结束地址、存储设备句柄、存储阵列映射地址句柄、分区行位置、交叉位置、交叉的数据深度、已扩展的起始地址、已扩展的结束地址。
内置指针设备 (Type 21) :指针设备类型、接口类型、按钮个数。
智能电池 (Type 22) :位置、制造商、制造日期、序列号、设备名、设备化学属性、设计容量、设计电压伏特数、 SBDS 版本号、电池数据的最大错误百分比、 SBDS 序列号、 SBDS 制造日期、 SBDS 设备化学属性、设计容量倍增因子、特定于 OEM 的信息。
系统引导信息 (Type 32) :保留域 (00h) 、引导状态描述 (10 字节 ) 。引导状态描述主要有“没有检测到错误”、“没有可引导的媒介”、“操作系统载入失败”、“ BIOS 硬件检测失败”、“操作系统硬件检测失败”、“用户请求引导(通过一个按键)”、“违反系统安全”、“预先请求映像(通过 PXE 引导)”、“系统监控记时器激活,导致系统重启”,特定于厂商引导状态描述等。
IPMI 设备信息 (Type 38) : BMC 接口类型、 IPMI 规范修改版本、 I2C 从地址、 NV 存储设备地址、基地址、基地址修饰符 / 中断信息、中断号。
不活动指示 (Type 126) :用来表明某个 SMBIOS 结构当前不活动,因此不应用被上层的软件使用。它没有字符串区域,只有结构头部(即三个头部域类型、长度、句柄)。
表格结束指示 (Type 127) :表示整个 SMBIOS 结构表的结束。它也只有结构头部,没有字符串区域。
可以看出,很多设备都包含一些类似的信息域,比如制造商、产品 ID(SKU 号 ) 、产品名称、版本、出厂日期、序列号、资产标签号、设备类型等。
应用软件可以使用下面的方法来解析基于表格的 SMBIOS 结构。 FindStructure 函数用于查找指定类型的第一个结构(注意同一个类型的结构可能会多个),返回这个结构的句柄,如果没找到,则返回 0xFFFF 。 TableAddress 和 StructureCount 的值可以通过在内存中定位 EPS 表来获得, EPS 中偏移 18h 处即为 TableAddress 的值,偏移 1Ch 处即为 StructureCount 的值。
- typedef unsigned short ushort;
- typedef unsigned char uchar;
- typedef struct {
- uchar Type;
- uchar Length;
- ushort Handle;
- } HEADER;
- ushort FindStructure(char* TableAddress, ushort StructureCount, uchar Type) {
- ushort i, handle;
- uchar lasttype;
- i=0;
- handle=0xFFFF;
- /* 从整个SMBIOS的首个结构开始搜索指定类型的第一个结构 */
- while(i<StructureCount && handle==0xFFFF) {
- i++;
- lasttype=((HEADER *)TableAddress)->Type; /* 获取当前结构的类型 */
- if(lasttype==Type) {
- handle=((HEADER *)TableAddress)->Handle;
- }else {
- /* 移动到当前结构的字符串区域处 */
- TableAddress+=((HEADER *)TableAddress)->Length;
- while(*((int *)TableAddress)!=0) /* 移动到字符串区域的结尾符0000h处 */
- TableAddress++;
- TableAddress+=2; /* 跳过0000h,移动到下一结构起始处 */
- }
- }
- return handle;
- }
(三)Linux中实现了SMBIO内核模块,它是通过/proc文件系统,以一种用户可理解的格式或纯粹的二进制格式来访问SMBIOS结构的信息。sourceforge上有这个内核模块的源代码,地址为http://sourceforge.net/projects/smbios/,是在Linux 2.4内核中的实现,它同时也实现了DMI。注意Linux 2.6中的内核驱动程序模块结构与2.4中的基本相同,只是有一些少许的变化,这里就不展开了。
1、bios.h文件:
(1)头文件中定义搜索起始地址0xF0000,固定字符串"_SM_"和"_DMI_"。
(2)定义SMBIOS EPS表smbios_entry_point_struct,SMBIOS结构头部smbios_struct、DMI的EPS表及结构头部。
(3)定义了模块在proc文件系统中的位置。有两种访问模式,即原始二进制格式(raw),用户可理解格式(cooked),因些访问位置有目录/proc/smbios,/proc/smbios/raw,/proc/smbios/cooked。
(4)定义搜索EPS表的函数smbios_find_entry_point(void*),以及获取结构长度、在proc中创建或删除节点、从proc文件系统中读取原始的或可理解格式的SMBIOS数据,等等。
这里的设计体现了初步的数据封装思想,即把数据结构和操作这些数据结构的函数封装在一个文件中。
- /** /文件 bios.h
- * DMI-BIOS和SM-BIOS的原型及声明
- */
- #ifndef __BIOS_H__
- #define __BIOS_H__
- /*
- * 用来帮助调试的宏
- */
- #undef PDEBUG /* 取消先前的定义(如果有的话),以防万一 */
- #ifdef _DEBUG_ /* 定义调试宏 */
- # define PDEBUG(fmt, args...) printk( KERN_DEBUG "smbios: " fmt, ## args)
- #else
- # define PDEBUG(fmt, args...) /* 不调试:不做任何事 */
- #endif
- #define BIOS_START_ADDRESS 0xF0000 /* 搜索SM-BIOS和DMI-BIOS的BISO段起始地址 */
- #define BIOS_MAP_LENGTH 0x10000 /* 搜索的BIOS区域长度 */
- #define SMBIOS_MAGIC_DWORD 0x5F4D535F /* 固定字符串 "_SM_" */
- #define DMIBIOS_MAGIC_DWORD 0x494d445f /* 固定字符串 "_DMI" */
- #define DMI_STRING "_DMI_"
- /** 有子类型的SMBIOS结构类型,可扩充! */
- #define TYPES_WITH_SUBTYPES 185, 187, 208, 209, 210, 211, 212, 254
- #define PROC_BLOCK_SIZE (3*1024) /* proc read函数最大的块大小 */
- /** 模式 原始二进制模式/烹调好的(即用户可理解模式) */
- #define FILE_MODE_RAW 0
- #define FILE_MODE_COOKED 1
- /* SMBIOS EPS表 */
- typedef struct smbios_entry_point_struct
- {
- __u32 anchor_string __attribute__ ((packed));
- __u8 entry_point_checksum __attribute__ ((packed));
- __u8 entry_point_length __attribute__ ((packed));
- __u8 major_version __attribute__ ((packed));
- __u8 minor_version __attribute__ ((packed));
- __u16 max_struct_size __attribute__ ((packed));
- __u8 revision __attribute__ ((packed));
- __u8 formated_area[5] __attribute__ ((packed));
- __u8 intermediate_string[5] __attribute__ ((packed));
- __u8 intermediate_checksum __attribute__ ((packed));
- __u16 struct_table_length __attribute__ ((packed));
- __u32 struct_table_address __attribute__ ((packed));
- __u16 no_of_structures __attribute__ ((packed));
- __u8 bcd_revision __attribute__ ((packed));
- } smbios_entry_point_struct;
- /** SM-BIOS和DMI-BIOS结构的头部 */
- typedef struct smbios_struct
- {
- __u8 type __attribute__ ((packed));
- __u8 length __attribute__ ((packed));
- __u16 handle __attribute__ ((packed));
- __u8 subtype __attribute__ ((packed));
- } smbios_struct;
- /** DMI-BIOS结构的头部 */
- typedef struct dmibios_table_entry_struct
- {
- __u16 size __attribute__ ((packed));
- __u16 handle __attribute__ ((packed));
- __u32 procedure __attribute__ ((packed));
- } dmibios_table_entry_struct;
- /** DMI-BIOS的EPS表 */
- typedef struct dmibios_entry_point_struct
- {
- __u8 signature[10] __attribute__ ((packed));
- __u8 revision __attribute__ ((packed));
- dmibios_table_entry_struct entry[1] __attribute__ ((packed));
- } dmibios_entry_point_struct;
- /*
- * 变量
- */
- extern struct proc_dir_entry * smbios_proc_dir; /* /proc/smbios */
- extern struct proc_dir_entry * smbios_raw_proc_dir; /* /proc/smbios/raw */
- extern struct proc_dir_entry * smbios_cooked_proc_dir; /* /proc/smbios/cooked */
- extern void * smbios_base; /* F-Segment */
- extern smbios_entry_point_struct * smbios_entry_point; /* SMBIOS在F-Segment中的起始地址 */
- extern dmibios_entry_point_struct * dmibios_entry_point; /* DMIBIOS在F-Segment中的起始地址 */
- extern void * smbios_structures_base; /* SMBIOS结构信息的基地址 */
- extern unsigned char smbios_types_with_subtypes[];
- extern char smbios_version_string[32]; /* 支持的SMBIOS版本,例如V2.31 */
- /* 搜索函数 */
- smbios_entry_point_struct * smbios_find_entry_point(void * base);
- dmibios_entry_point_struct * dmibios_find_entry_point(void * base);
- unsigned char smbios_check_entry_point(void * addr);
- int smbios_type_has_subtype(unsigned char type);
- int smbios_get_struct_length(smbios_struct * struct_ptr);
- int dmibios_get_struct_length(smbios_struct * struct_ptr);
- int smbios_version_proc (char *page, char **start, off_t off, int count, int *eof, void *data);
- int bios_read_raw_proc(char * page, char ** start, off_t off, int count, int * eof, void * data);
- int bios_read_cooked_proc(char *page, char **start, off_t off, int count, int *eof, void *data);
- int dmibios_read_raw_proc(char * page, char ** start, off_t off, int count, int * eof, void * data);
- int dmibios_read_cooked_proc(char *page, char **start, off_t off, int count, int *eof, void *data);
- int smbios_make_dir_entries(struct proc_dir_entry *smbiosdir, struct proc_dir_entry *rawdir, struct proc_dir_entry *cookeddir);
- int smbios_make_version_entry(struct proc_dir_entry *smbiosdir);
- int dmibios_make_dir_entries(struct proc_dir_entry * smbiosdir, struct proc_dir_entry * rawdir, struct proc_dir_entry * cookeddir);
- void smbios_destroy_dir_entries(struct proc_dir_entry * dir);
- unsigned int smbios_get_readable_name_ext(char *readable_name, smbios_struct *struct_ptr);
- unsigned int smbios_get_readable_name(char *readable_name, smbios_struct *struct_ptr);
- int make_file_entries (char *filename, struct proc_dir_entry *dir, smbios_struct *struct_ptr, int mode);
- #endif /* __BIOS_H__ */
这里__attribute__ ((packed))是GCC的扩展,其作用就是告诉编译器取消结构在编译过程中的优化对齐,按照实际占用字节数进行对齐。__attribute__关键字主要是用来在函数或数据声明中设置属性。给函数赋予属性的主要目的在于让编译器进行优化。例如函数声明中的__attribute__((noreturn)),就是告诉编译器这个函数不会返回给调用者,以便编译器在优化时去掉不必要的函数返回代码。__attribute__可以设置函数属性、变量属性和类型属性。书写时要放置在声明的尾部,在分号“;”之前。函数属性可以帮助开发者把一些特性添加到函数声明中,从而可以使编译器在错误检查方面的功能更强大。GCC需要使用–Wall编译器来击活该功能,这是控制警告信息的一个很好的方式。这里的packed属性可以使得变量或者结构体成员使用最小的对齐方式,即对变量是一字节对齐,对域(field)是位对齐。
2、cooking.h和strgdef.h文件: 由于要以用户可理解的方式显示SMBIOS信息,这需要把原始的SMBIOS结构数据映射到一些可理解的字符串上,以显示给用户看。在cooking.h中定义了各个SMBIOS结构以及解析这些结构的函数。有Type 0-Type 13、Type 16、Type 17、Type 19、Type 20、Type 32、Type 127共20个SMBIOS结构数据。这些结构在SMBIOS规范中都有清晰的描述,定义它们是比较直接的。例如Type 0和Type 1的定义如下:
- /* 解析成可理解的格式 */
- unsigned char * bios_cook_type_0 (smbios_struct * smbiostype, unsigned int *length);
- unsigned char * bios_cook_type_1 (smbios_struct * smbiostype, unsigned int *length);
- typedef struct smbios_type_0
- {
- smbios_header header;
- __u8 vendor __attribute__ ((packed));
- __u8 version __attribute__ ((packed));
- __u16 startaddr __attribute__ ((packed));
- __u8 reldate __attribute__ ((packed));
- __u8 romsize __attribute__ ((packed));
- __u64 characteristics __attribute__ ((packed));
- __u8 ext1 __attribute__ ((packed));
- __u8 ext2 __attribute__ ((packed));
- } smbios_type_0;
- typedef struct smbios_type_1
- {
- smbios_header header;
- __u8 manufacturer __attribute__ ((packed));
- __u8 productname __attribute__ ((packed));
- __u8 version __attribute__ ((packed));
- __u8 serialnumber __attribute__ ((packed));
- __u8 uuid[16] __attribute__ ((packed));
- __u8 wakeuptype __attribute__ ((packed));
- } smbios_type_1;
bios_cook_type_0()等函数就是把解析后的SMBIOS数据写入到/proc文件中。其他的结构就不列举了,在cooking.h中都有。strgdef.h中定义了各结构数据要解析成的友好信息,如结构中各个域的名称、字符串区域中各个字符串的值等,这在SMBIOS规范中也都有清晰的描述,定义时比较直接。例如对Type 0结构的信息,如下:
- /*
- * Type 0 - Bios
- */
- #define TYPE0_NAME "(BIOS Information)"
- #define TYPE0_VENDOR "Vendor"
- #define TYPE0_VERSION "Version"
- #define TYPE0_ADR_SEG "Starting Adr Seg"
- #define TYPE0_REL_DATE "Rel. Date"
- #define TYPE0_ROM_SIZE "ROM Size"
- #define TYPE0_CHAR "Characteristics"
- #define TYPE0_CHAR_RES "Reserved"
- #define TYPE0_CHAR_UNKNOWN "Unknown"
- #define TYPE0_CHAR_NOTSUP "Not Supported"
- #define TYPE0_CHAR_ISA "ISA"
- #define TYPE0_CHAR_MCA "MCA"
- #define TYPE0_CHAR_EISA "EISA"
- #define TYPE0_CHAR_PCI "PCI"
- #define TYPE0_CHAR_PCMCIA "PCMCIA"
- #define TYPE0_CHAR_PNP "Plug and Play"
- #define TYPE0_CHAR_APM "Advanced Power Management"
- #define TYPE0_CHAR_FLASH "Flash"
- #define TYPE0_CHAR_SHADOWING "Shadowing"
- #define TYPE0_CHAR_VL "VL-Vesa"
- #define TYPE0_CHAR_ESCD "ESCD"
- #define TYPE0_CHAR_BOOTCD "Boot from CD"
- #define TYPE0_CHAR_SELBOOT "Selectable Boot"
- #define TYPE0_CHAR_BIOS_IS_SOCKETED "Bios Rom is socketed"
- #define TYPE0_CHAR_PCMCIA_BOOT "Boot from PCMCIA"
- #define TYPE0_CHAR_ENH_DISK_DRIVE "Enhanced Disk Drive"
- #define TYPE0_CHAR_FD_NEC "Int13h - japanese Floppy NEC 1,2 MB"
- #define TYPE0_CHAR_FD_TOSHIBA "Int13h - japanese Floppy Toshiba 1,2 MB"
- #define TYPE0_CHAR_360 "Int13h - 360 kB Floppy"
- #define TYPE0_CHAR_1200 "Int13h - 1,2 MB Floppy"
- #define TYPE0_CHAR_720 "Int13h - 720 kB Floppy"
- #define TYPE0_CHAR_2880 "Int13h - 2,88 MB Floppy"
- #define TYPE0_CHAR_PRINT_SCREEN "Int5h - Print Screen"
- #define TYPE0_CHAR_KEYBOARD "Int9h - 8042 Keyboard"
- #define TYPE0_CHAR_SER_SERVICES "Int14h - Serial Services"
- #define TYPE0_CHAR_PRINT_SERVICES "Int17h - Printer Services"
- #define TYPE0_CHAR_VIDEO_SERVICES "Int10h - CGA,Mono Video Services"
- #define TYPE0_CHAR_PC98 "NEC PC-98"
- #define TYPE0_EXT1_ACPI "ACPI"
- #define TYPE0_EXT1_USB "USB Legacy"
- #define TYPE0_EXT1_AGP "AGP"
- #define TYPE0_EXT1_I2O_BOOT "I2O Boot"
- #define TYPE0_EXT1_LS120 "LS-120"
- #define TYPE0_EXT1_ATAPI_ZIP_BOOT "ATAPI ZIP Boot"
- #define TYPE0_EXT1_1394_BOOT "1394 Boot"
- #define TYPE0_EXT1_SMART_BATTERY "Smart Battery"
- #define TYPE0_EXT2_BBS "Bios Boot Spec."
- #define TYPE0_EXT2_NETWORK_BOOT "Function key initiated Network Service Boot"
3、实现文件cooking.c和bios.c: 文件cooking.c中的各个函数,如bios_cook_type_0(),bios_cook_type_1(),是对相应SMBIOS结构数据的解析。各个函数做的工作类似,基本流程如下:
(1)分配足够的空间(char[]型数组file)来存放整个结构的解析数据;
(2)解析结构头部信息,把strgdef.h中的相应信息用strcpy写入到file中;
(3)解析各个字符串信息,把strgdef.h中的相应字符串写入到file中;
(4)用kmalloc分配proc文件的内存,然后把用memcpy把file数组写入到proc文件中。
bios.c主要是实现对proc文件系统的操作,从内存的BIOS区域中(注意SMBIOS数据在BIOS启动时会被载入到内存的BIOS区域中),读取SMBIOS原始数据或解析成可理解的格式,然后写到proc文件系统中,由于proc文件系统在内存中,因此核心的实现就是把读取的数据用memcpy()直接拷贝到内存的proc区域中。实现的函数有:
(1)smbios_find_entry_point(void* base):从base开始搜索SMBIOS EPS表,只要搜索到固定字符串"_SM_"即可;
(2)dmibios_find_entry_point(void* base):从base开始搜索DMI EPS表,只要搜索到固定字符串"_DMI"即可;
(3)smbios_check_entry_point (void *addr):校验EPS表格;
(4)smbios_get_struct_length():返回指定类型的SMBIOS结构长度;
(5)bios_read_raw_proc():当应用程序需要打开本驱动程序创建的proc文件中,本函数就会被内核调用,以获取proc文件中的原始数据;
(6)dmibios_read_raw_proc():跟前一个类似。
(7)bios_read_cooked_proc():跟前面类似,只 不过读取的是友好格式的数据;
(8)smbios_make_version_entry():在proc文件系统中创建smbios_version文件;
(9)smbios_make_dir_entries():在proc文件系统中创建多个文件,每个类型的SMBIOS结构对应一个文件type[-subtype].instance;
(10)smbios_destroy_dir_entries():删除指定proc目录下的所有SMBIOS文件;
(11)smbios_get_readable_name():把SMBIOS类型转换成可理解的格式;
(12)make_file_entries():在指定的proc目录中创建一个文件。
4、main.c文件: 包含本驱动模块的框架性函数。
- /** /文件 main.c
- * smbios内核模块的内核接口函数
- */
- #ifndef __KERNEL__
- # define __KERNEL__
- #endif
- #ifndef MODULE
- # define MODULE
- #endif
- #define __NO_VERSION__ /* 在module.h中不要定义kernel_version */
- #include <linux/module.h>
- #include <linux/version.h>
- char kernel_version[] = UTS_RELEASE;
- #include <linux/kernel.h> /* printk() */
- #include <linux/errno.h> /* 错误码 */
- #include <linux/types.h> /* size_t */
- #include <linux/proc_fs.h>
- #include <asm/io.h> /* ioremap() */
- #include "strgdef.h" /* 所有解析成的字符串定义 */
- #include "bios.h" /* 本地定义 */
- EXPORT_NO_SYMBOLS;
- /** /fn 函数int init_module (void)
- * /brief 模块初始化,成功返回0,否则返回一个错误码
- */
- int
- init_module (void)
- {
- int err = 0;
- PDEBUG ("starting module initialization/n");
- /*
- * 映射SMBIOS存储段:ioremap把一个物理地址映射到虚拟地址,例如把BIOS起始地址映射成Bios F-段,
- * 即返回的起始虚拟地址smbios_base
- */
- if (!(smbios_base = ioremap (BIOS_START_ADDRESS, BIOS_MAP_LENGTH)))
- {
- PDEBUG ("ioremap() for entry point failed/n");
- err = -ENXIO;
- goto ioremap_for_entry_point_failed;
- }
- PDEBUG ("BIOS base set to 0x%p/n", smbios_base);
- /*
- * 搜索SMBIOS或DMIBIOS入口点(EPS表起始地址)
- */
- if (!(smbios_entry_point = smbios_find_entry_point (smbios_base)))
- {
- PDEBUG ("SM-BIOS entry point not found/n");
- if (!(dmibios_entry_point = dmibios_find_entry_point (smbios_base)))
- {
- PDEBUG ("DMI-BIOS entry point not found. Aborting.../n");
- err = -ENXIO;
- goto find_entry_point_failed;
- }
- }
- /*
- * 对SM-BIOS:检查指向DMI结构的指针是否存在。中间字符串_DMI_不是以'/0'结尾,因此strncmp()传入大小为sizeof(DMI_STRING)-1
- */
- if (smbios_entry_point)
- {
- if (strncmp((char *) &(smbios_entry_point->intermediate_string),
- DMI_STRING, sizeof (DMI_STRING) - 1))
- {
- PDEBUG ("Pointer to DMI structures not found!/n");
- err = -ENXIO;
- goto check_dmi_failed;
- }
- }
- /*
- * 映射SMBIOS结构的物理地址段,返回的smbios_structures_base包含了SMBIOS结构数据起始地址
- */
- if (smbios_entry_point)
- {
- if (!(smbios_structures_base =
- ioremap (smbios_entry_point->struct_table_address,
- (unsigned long) smbios_entry_point->struct_table_length)))
- {
- PDEBUG ("ioremap() for structures table failed/n");
- err = -ENXIO;
- goto ioremap_for_structures_table_failed;
- }
- }
- /*
- * 另一方面,如果我们有专有的DMI Bios,则smbios_structures_base会包含指向表格的指针,这个表格包含了到每个sm/dmi bios结构的偏移
- */
- if (dmibios_entry_point)
- {
- if (!(smbios_structures_base = dmibios_entry_point->entry))
- {
- PDEBUG ("invalid structure table entry%p,%p/n", smbios_structures_base,
- dmibios_entry_point->entry);
- err = -ENXIO;
- goto ioremap_for_structures_table_failed;
- }
- }
- PDEBUG ("DMI structures base set to 0x%p/n", smbios_structures_base);
- /*
- * 创建/proc节点
- */
- /* 创建/proc/smbios目录 */
- if (!(smbios_proc_dir =
- create_proc_entry (PROC_DIR_STRING, S_IFDIR, &proc_root)))
- {
- err = -ENOMEM;
- PDEBUG ("failed to create /proc/smbios directory entry/n");
- goto create_smbios_dir_failed;
- }
- PDEBUG ("/proc/smbios directory created./n");
- /* 创建/proc/smbios/raw目录 */
- if (!(smbios_raw_proc_dir =
- create_proc_entry (PROC_DIR_STRING_RAW, S_IFDIR, smbios_proc_dir)))
- {
- err = -ENOMEM;
- PDEBUG ("failed to create /proc/smbios/raw directory entry/n");
- goto create_smbios_raw_dir_failed;
- }
- PDEBUG ("/proc/smbios/raw directory created./n");
- /* 创建/proc/smbios/cooked目录 */
- if (!(smbios_cooked_proc_dir =
- create_proc_entry (PROC_DIR_STRING_COOKED, S_IFDIR, smbios_proc_dir)))
- {
- err = -ENOMEM;
- PDEBUG ("failed to create /proc/smbios/cooked directory entry/n");
- goto create_smbios_cooked_dir_failed;
- }
- PDEBUG ("/proc/smbios/cooked directory created./n");
- /* 创建版本文件 */
- if (smbios_entry_point)
- {
- if ((err = smbios_make_version_entry (smbios_proc_dir)))
- goto smbios_make_version_entry_failed;
- }
- /* 创建各个SMBIOS结构对应的文件 */
- if (smbios_entry_point)
- {
- if ((err = smbios_make_dir_entries (smbios_proc_dir, smbios_raw_proc_dir, smbios_cooked_proc_dir)))
- goto make_smbios_dir_entries_failed;
- }
- /* 创建各个DMI BIOS结构对应的文件 */
- if (dmibios_entry_point)
- {
- if ((err = dmibios_make_dir_entries (smbios_proc_dir, smbios_raw_proc_dir, smbios_cooked_proc_dir)))
- goto make_smbios_dir_entries_failed;
- }
- PDEBUG ("module loaded succesfully/n");
- return 0;
- /*
- * 发生错误时就会到达这里,需要对发生错误之前做的操作进行回滚处理(如申请了资源,则需要进行释放)
- */
- make_smbios_dir_entries_failed:
- /* remove /proc/smbios/cooked files */
- smbios_destroy_dir_entries (smbios_cooked_proc_dir);
- /* remove /proc/smbios/raw files */
- smbios_destroy_dir_entries (smbios_raw_proc_dir);
- /* remove /proc/smbios files */
- smbios_destroy_dir_entries (smbios_proc_dir);
- smbios_make_version_entry_failed:
- /* remove /proc/smbios/cooked directory */
- remove_proc_entry(PROC_DIR_STRING_COOKED, smbios_proc_dir);
- create_smbios_cooked_dir_failed :
- /* remove /proc/smbios/raw directory */
- remove_proc_entry(PROC_DIR_STRING_RAW, smbios_proc_dir);
- create_smbios_raw_dir_failed:
- /* remove /proc/smbios directory */
- remove_proc_entry(PROC_DIR_STRING, &proc_root);
- create_smbios_dir_failed:
- /* unmap the virtual to physical memory binding */
- if (smbios_entry_point)
- iounmap (smbios_structures_base);
- ioremap_for_structures_table_failed:
- check_dmi_failed:
- find_entry_point_failed:
- /* unmap the virtual to physical memory binding */
- iounmap (smbios_base);
- ioremap_for_entry_point_failed:
- return err;
- }
- /** /fn 函数int cleanup_module (void)
- * /brief 模块清理
- */
- void
- cleanup_module (void)
- {
- /* 删除/proc/smbios/cooked下的各个文件 */
- smbios_destroy_dir_entries (smbios_cooked_proc_dir);
- /* 删除/proc/smbios/raw下的各个文件 */
- smbios_destroy_dir_entries (smbios_raw_proc_dir);
- /* 删除/proc/smbios下的文件 */
- smbios_destroy_dir_entries (smbios_proc_dir);
- /* 删除/proc/smbios/cooked目录 */
- remove_proc_entry(PROC_DIR_STRING_COOKED, smbios_proc_dir);
- /* 删除/proc/smbios/raw目录 */
- remove_proc_entry(PROC_DIR_STRING_RAW, smbios_proc_dir);
- /* 删除/proc/smbios目录 */
- remove_proc_entry(PROC_DIR_STRING, &proc_root);
- /* 取消虚拟地址到物理地址的映射 */
- if (smbios_entry_point)
- iounmap (smbios_structures_base);
- iounmap (smbios_base);
- PDEBUG ("module unloaded/n");
- }
(1)init_module():映射SMBIOS存储段地址(映射到虚拟地址上)、搜索SMBIOS或DMI的EPS表、映射SMBIOS结构的物理地址、创建目录结点/proc/smbios/raw和/proc/smbios/cooked、在其中创建各个类型的SMBIOS文件。
(2)cleanup_module():删除proc中的各个SMBIOS文件、删除相应目录、解除地址映射。