转自:http://blog.csdn.net/zhoudaxia/article/details/5919967
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文件、删除相应目录、解除地址映射。