Linux总线驱动-02: struct bus_type 结构体

本文测试系统为：Ubuntu 10.10 x86_64 2.6.35-24-generic

 

上节中，除了简单的框架，我们还看到了一个和总线驱动相关的结构体bus_type。这个结构体的定义在include/linux/device.h中。本节先简单介绍结构体中的成员，再对每个成员作详细描述。

struct bus_type { const char *name; struct bus_attribute *bus_attrs; struct device_attribute *dev_attrs; struct driver_attribute *drv_attrs; int (*match)(struct device *dev, struct device_driver *drv); int (*uevent)(struct device *dev, struct kobj_uevent_env *env); int (*probe)(struct device *dev); int (*remove)(struct device *dev); void (*shutdown)(struct device *dev); int (*suspend)(struct device *dev, pm_message_t state); int (*resume)(struct device *dev); const struct dev_pm_ops *pm; struct bus_type_private *p; };

 

1. 成员简单介绍

const char *name; 总线名称。 struct bus_attribute *bus_attrs; 总线属性。 struct device_attribute *dev_attrs; 该总线上所有设备的默认属性。 struct driver_attribute *drv_attrs; 该总线上所有驱动的默认属性。 int (*match)(struct device *dev, struct device_driver *drv); 驱动匹配。 int (*uevent)(struct device *dev, struct kobj_uevent_env *env); 添加环境变量。 int (*probe)(struct device *dev); 驱动匹配。 int (*remove)(struct device *dev); 设备移除时调用。 void (*shutdown)(struct device *dev); 关机时调用。 int (*suspend)(struct device *dev, pm_message_t state); 挂起（投入休眠）时调用。 int (*resume)(struct device *dev); 恢复时调用。 const struct dev_pm_ops *pm; 设备电源管理。 struct bus_type_private *p; 私有数据。完全由驱动核心初始化并使用。

 

2. 成员详细描述

 

2.0 预备知识

在开始之前，我们先简单介绍一个结构体struct attribute。这个结构体作为属性的基本结构，嵌入在struct bus_attribute等结构体中。如下：

/* FIXME * The *owner field is no longer used. * x86 tree has been cleaned up. The owner * attribute is still left for other arches. */ struct attribute { const char *name; struct module *owner; mode_t mode; #ifdef CONFIG_DEBUG_LOCK_ALLOC struct lock_class_key *key; struct lock_class_key skey; #endif }; // 注：在2.6.37中，owner已经被移除了。

我们只关心name和mode成员。name作为属性文件名称，会出现在sysfs伪系统系统的特定目录下（具体目录和struct attribute所在的驱动相关），而mode是name文件的权限。
作为文件名称，name不能含有”/”，同时最好不含有空格，因为 shell分隔符IFS一般包含空格，空格对shell应用处理等会带来不便和错误。name值必须具有持久属性，例如静态字符数组或者字符串字面值（不能是栈内字符数组）。
mode和用户空间中文件的属性一致，可以针对所有者、同组、其他用户分别设置读、写、可执行权限等，需要注意的是，即使设置可执行权限，属性文件也是不允许执行的，最起码在当前的内核版本下是不允许执行的。

 

2.1 const char *name;
总线名称，体现在sysfs文件系统的/sys/bus下，不能和别的总线名称有冲突。作为文件名称，它不能含有”/”；同时最好不含有空格，值必须有持久性。例如：
struct bus_type ycbus_type = { .name = “ycbus” };

 

2.2 struct bus_attribute *bus_attrs;
总线属性。表现为/sys/bus/<name>/文件夹下的文件。这个结构体的具体定义如下：
struct bus_attribute { struct attribute attr; ssize_t (*show)(struct bus_type *bus, char *buf); ssize_t (*store)(struct bus_type *bus, const char *buf, size_t count); };

其中struct attribute attr的如2.0所述。show和store方法的第一个参数都是struct bus_ty