首页 > 其他分享 >sysfs - 用于导出内核对象的_文件系统 【ChatGPT】

sysfs - 用于导出内核对象的_文件系统 【ChatGPT】

时间:2023-12-10 20:44:41浏览次数:37  
标签:struct attribute sysfs dev 内核 device ChatGPT attr

sysfs - _用于导出内核对象的_文件系统

Patrick Mochel [email protected]
Mike Murphy [email protected]

修订日期 2011年8月16日
原始日期 2003年1月10日

它是什么

sysfs是一个基于ramfs的基于RAM的文件系统。它提供了一种将内核数据结构、它们的属性以及它们之间的链接导出到用户空间的方法。

sysfs与kobject基础结构密切相关。有关kobject接口的更多信息,请阅读《关于kobjects、ksets和ktypes的一切你从未想过的》。

使用sysfs

如果定义了CONFIG_SYSFS,sysfs将始终被编译进内核。您可以通过以下方式访问它:

mount -t sysfs sysfs /sys

目录创建

对于系统注册的每个kobject,都会在sysfs中为其创建一个目录。该目录被创建为kobject的父目录的子目录,向用户空间表达内部对象层次结构。sysfs中的顶级目录表示对象层次结构的共同祖先;即对象所属的子系统。

sysfs在内部存储指向实现目录的kobject的指针,该指针与与目录关联的kernfs_node对象相关联。在过去,sysfs使用此kobject指针直接对kobject进行引用计数,每当打开或关闭文件时。使用当前的sysfs实现,kobject引用计数仅通过函数sysfs_schedule_callback()直接修改。

属性

属性可以以文件的形式导出为kobjects。sysfs将文件I/O操作转发到为属性定义的方法,提供了一种读取和写入内核属性的方法。

属性应该是ASCII文本文件,最好每个文件只包含一个值。需要注意的是,每个文件只包含一个值可能不够高效,因此可以接受以社会接受的方式表达相同类型的值数组。

混合类型、表达多行数据和对数据进行花式格式化都是不被赞同的。这样做可能会导致您被公开羞辱,并且您的代码可能会在不经通知的情况下被重写。

属性定义很简单:

struct attribute {
        char                    *name;
        struct module           *owner;
        umode_t                 mode;
};


int sysfs_create_file(struct kobject * kobj, const struct attribute * attr);
void sysfs_remove_file(struct kobject * kobj, const struct attribute * attr);

一个简单的属性不包含读取或写入属性值的方法。鼓励子系统为特定对象类型定义自己的属性结构和包装函数来添加和移除属性。

例如,驱动程序模型定义了struct device_attribute,如下所示:

struct device_attribute {
        struct attribute    attr;
        ssize_t (*show)(struct device *dev, struct device_attribute *attr,
                        char *buf);
        ssize_t (*store)(struct device *dev, struct device_attribute *attr,
                        const char *buf, size_t count);
};

int device_create_file(struct device *, const struct device_attribute *);
void device_remove_file(struct device *, const struct device_attribute *);

它还定义了用于定义设备属性的辅助程序:

#define DEVICE_ATTR(_name, _mode, _show, _store) \
struct device_attribute dev_attr_##_name = __ATTR(_name, _mode, _show, _store)

例如,声明:

static DEVICE_ATTR(foo, S_IWUSR | S_IRUGO, show_foo, store_foo);

等同于:

static struct device_attribute dev_attr_foo = {
        .attr = {
                .name = "foo",
                .mode = S_IWUSR | S_IRUGO,
        },
        .show = show_foo,
        .store = store_foo,
};

请注意,如include/linux/kernel.h中所述,“OTHER_WRITABLE? 通常被认为是一个坏主意。”因此,尝试将sysfs文件设置为对所有人可写将失败,并恢复为“其他”模式。

对于常见情况,sysfs.h提供了方便的宏,以使定义属性更容易,并使代码更简洁和可读。上述情况可以缩短为:

static struct device_attribute dev_attr_foo = __ATTR_RW(foo);

可用于定义包装函数的辅助程序列表包括:

  • __ATTR_RO(name):
    假定默认的name_show和mode为0444

  • __ATTR_WO(name):
    假定只有name_store,并且被限制为0200模式,即仅根用户具有写访问权限。

  • __ATTR_RO_MODE(name, mode):
    用于更严格的只读访问;目前仅用例是EFI系统资源表(参见drivers/firmware/efi/esrt.c)

  • __ATTR_RW(name):
    假定默认的name_show、name_store,并将模式设置为0644。

  • __ATTR_NULL:
    将名称设置为NULL,并用作列表结束指示器(参见:kernel/workqueue.c)

特定于子系统的回调

当子系统定义新的属性类型时,它必须实现一组sysfs操作,以将读取和写入调用转发到属性所有者的show和store方法:

struct sysfs_ops {
        ssize_t (*show)(struct kobject *, struct attribute *, char *);
        ssize_t (*store)(struct kobject *, struct attribute *, const char *, size_t);
};

[子系统应该已经定义了一个struct kobj_type作为此类型的描述符,其中存储了sysfs_ops指针。有关更多信息,请参阅kobject文档。]

当读取或写入文件时,sysfs调用类型的适当方法。然后,方法将通用的struct kobject和struct attribute指针转换为适当的指针类型,并调用相关的方法。

举例说明:

#define to_dev_attr(_attr) container_of(_attr, struct device_attribute, attr)

static ssize_t dev_attr_show(struct kobject *kobj, struct attribute *attr,
                            char *buf)
{
        struct device_attribute *dev_attr = to_dev_attr(attr);
        struct device *dev = kobj_to_dev(kobj);
        ssize_t ret = -EIO;

        if (dev_attr->show)
                ret = dev_attr->show(dev, dev_attr, buf);
        if (ret >= (ssize_t)PAGE_SIZE) {
                printk("dev_attr_show: %pS returned bad count\n",
                                dev_attr->show);
        }
        return ret;
}

读取/写入属性数据

要读取或写入属性,必须在声明属性时指定show()或store()方法。方法类型应该与为设备属性定义的方法一样简单:

ssize_t (*show)(struct device *dev, struct device_attribute *attr, char *buf);
ssize_t (*store)(struct device *dev, struct device_attribute *attr,
                const char *buf, size_t count);

即,它们应该只接受一个对象、一个属性和一个缓冲区作为参数。

sysfs分配了一个大小为(PAGE_SIZE)的缓冲区,并将其传递给方法。sysfs将为每次读取或写入调用方法一次。这迫使方法实现以下行为:

  • 在read(2)上,show()方法应填充整个缓冲区。请记住,一个属性应该只导出一个值,或者类似值的数组,因此这不应该太昂贵。

    这允许用户空间对整个文件进行部分读取,并随意进行前向寻址。如果用户空间将寻址回零或执行带有偏移量“0”的pread(2),则show()方法将被重新激活,以填充缓冲区。

  • 在write(2)上,sysfs期望在第一次写入时传递整个缓冲区。然后,sysfs将整个缓冲区传递给store()方法。在存储时,在数据后添加了一个终止空字符。这使得诸如sysfs_streq()之类的函数可以安全使用。

    在写入sysfs文件时,用户空间进程应首先读取整个文件,修改其希望更改的值,然后将整个缓冲区写回。

    属性方法实现在读取和写入值时应使用相同的缓冲区。

其他注意事项:

  • 写入会导致show()方法被重新激活,而不管当前文件位置如何。

  • 缓冲区的长度始终为PAGE_SIZE字节。在x86上,这是4096。

  • show()方法应返回打印到缓冲区中的字节数。

  • show()应仅在将要返回给用户空间的值进行格式化时使用sysfs_emit()或sysfs_emit_at()。

  • store()应返回从缓冲区使用的字节数。如果已使用整个缓冲区,只需返回计数参数。

  • show()或store()始终可以返回错误。如果出现错误值,请务必返回错误。

  • 通过sysfs引用计数其嵌入对象的对象将被固定在内存中。但是,对象表示的物理实体(例如设备)可能不存在。如有必要,请确保有一种方法来检查这一点。

设备属性的一个非常简单(并且天真)的实现是:

static ssize_t show_name(struct device *dev, struct device_attribute *attr,
                        char *buf)
{
        return sysfs_emit(buf, "%s\n", dev->name);
}

static ssize_t store_name(struct device *dev, struct device_attribute *attr,
                        const char *buf, size_t count)
{
        snprintf(dev->name, sizeof(dev->name), "%.*s",
                (int)min(count, sizeof(dev->name) - 1), buf);
        return count;
}

static DEVICE_ATTR(name, S_IRUGO, show_name, store_name);

(请注意,真实的实现不允许用户空间为设备设置名称。)

顶级目录布局

sysfs目录布局公开了内核数据结构的关系。

顶级sysfs目录如下所示:

block/
bus/
class/
dev/
devices/
firmware/
fs/
hypervisor/
kernel/
module/
net/
power/

devices/包含设备树的文件系统表示。它直接映射到内核设备树,这是一个struct device的层次结构。

bus/包含内核中各种总线类型的扁平目录布局。每个总线的目录包含两个子目录:

devices/
drivers/

devices/包含系统中发现的每个设备的符号链接,指向根目录下设备的目录。

drivers/包含为该特定总线类型上的设备加载的每个设备驱动程序的目录(这假设驱动程序不跨多个总线类型)。

fs/包含一些文件系统的目录。当前,每个想要导出属性的文件系统必须在fs/下创建自己的层次结构(请参见./fuse.rst作为示例)。

module/包含所有加载的系统模块的参数值和状态信息,对于内置模块和可加载模块都是如此。

dev/包含两个目录:char/和block/。在这两个目录中,有名为<major>:<minor>的符号链接。这些符号链接指向给定设备的sysfs目录。/sys/dev提供了一种从stat(2)操作的结果快速查找设备的sysfs接口的方法。

有关驱动程序模型特定功能的更多信息,请参阅Documentation/driver-api/driver-model/。

待办事项:完成本节。

当前接口

sysfs当前存在以下接口层。

devices(include/linux/device.h)

结构:

struct device_attribute {
        struct attribute    attr;
        ssize_t (*show)(struct device *dev, struct device_attribute *attr,
                        char *buf);
        ssize_t (*store)(struct device *dev, struct device_attribute *attr,
                        const char *buf, size_t count);
};

声明:

DEVICE_ATTR(_name, _mode, _show, _store);

创建/移除:

int device_create_file(struct device *dev, const struct device_attribute * attr);
void device_remove_file(struct device *dev, const struct device_attribute * attr);

总线驱动程序(include/linux/device.h)

结构:

struct bus_attribute {
        struct attribute        attr;
        ssize_t (*show)(const struct bus_type *, char * buf);
        ssize_t (*store)(const struct bus_type *, const char * buf, size_t count);
};

声明:

static BUS_ATTR_RW(name);
static BUS_ATTR_RO(name);
static BUS_ATTR_WO(name);

创建/移除:

int bus_create_file(struct bus_type *, struct bus_attribute *);
void bus_remove_file(struct bus_type *, struct bus_attribute *);

设备驱动程序(include/linux/device.h)

结构:

struct driver_attribute {
        struct attribute        attr;
        ssize_t (*show)(struct device_driver *, char * buf);
        ssize_t (*store)(struct device_driver *, const char * buf,
                        size_t count);
};

声明:

DRIVER_ATTR_RO(_name)
DRIVER_ATTR_RW(_name)

创建/移除:

int driver_create_file(struct device_driver *, const struct driver_attribute *);
void driver_remove_file(struct device_driver *, const struct driver_attribute *);

文档

sysfs目录结构和每个目录中的属性定义了内核与用户空间之间的ABI。与任何ABI一样,重要的是这个ABI是稳定的并且有适当的文档记录。所有新的sysfs属性必须在Documentation/ABI中进行记录。有关更多信息,请参阅Documentation/ABI/README。

标签:struct,attribute,sysfs,dev,内核,device,ChatGPT,attr
From: https://www.cnblogs.com/pengdonglin137/p/17893197.html

相关文章

  • 访问与总线无关的设备 【ChatGPT】
    https://www.kernel.org/doc/html/v6.6/driver-api/device-io.htmlBus-IndependentDeviceAccesses作者MatthewWilcox作者AlanCox介绍Linux提供了一个API,它抽象了在所有总线和设备上执行IO的过程,允许独立于总线类型编写设备驱动程序。内存映射IO获取设备访问......
  • 文心一言 VS 讯飞星火 VS chatgpt (153)-- 算法导论12.2 9题
    九、用go语言,设T是一棵二叉搜索树,其关键字互不相同;设x是一个叶结点,y为其父结点。证明:y.key或者是T树中大于x.key的最小关键字,或者是T树中小于x.key的最大关键字。文心一言:要证明这个性质,我们可以采用二叉搜索树的性质:对于任何节点N,其左子树中的所有节点的值都小于N......
  • PINCTRL(PIN CONTROL)子系统 【ChatGPT】
    https://www.kernel.org/doc/html/v6.6/driver-api/pin-control.htmlPINCTRL(PINCONTROL)子系统本文概述了Linux中的pincontrol子系统。该子系统涉及以下内容:枚举和命名可控制的引脚引脚、Pads、Fingers(等)的复用,请参见下文了解详情配置引脚、Pads、Fingers(等),例如软件控制......
  • PHY 子系统 【ChatGPT】
    https://www.kernel.org/doc/html/v6.6/driver-api/phy/phy.htmlPHY子系统作者[email protected]本文档解释了通用PHY框架以及提供的API,以及如何使用。简介PHY是物理层的缩写。它用于将设备连接到物理介质,例如,USB控制器具有PHY来提供序列化、反序列......
  • Linux PWM接口概述 【ChatGPT】
    https://www.kernel.org/doc/html/v6.6/driver-api/pwm.htmlLinuxPWM接口概述PWM(脉冲宽度调制)接口用于控制LED、风扇或手机中的振动器。具有固定目的的PWM无需实现LinuxPWMAPI(尽管它们可以)。然而,在SoC上通常会发现作为离散设备的PWM,它们没有固定的用途。将它们连接到LED或......
  • Sync File API 指南【ChatGPT】
    https://www.kernel.org/doc/html/v6.6/driver-api/sync_file.htmlSyncFileAPIGuide本文档旨在为设备驱动程序编写者提供有关sync_fileAPI的指南,以及驱动程序如何支持它。Syncfile是需要在驱动程序之间或跨进程边界同步的fences(structdma_fence)的载体。sync_fileAPI旨......
  • 文心一言 VS 讯飞星火 VS chatgpt (153)-- 算法导论12.2 9题
    九、用go语言,设T是一棵二叉搜索树,其关键字互不相同;设x是一个叶结点,y为其父结点。证明:y.key或者是T树中大于x.key的最小关键字,或者是T树中小于x.key的最大关键字。文心一言:要证明这个性质,我们可以采用二叉搜索树的性质:对于任何节点N,其左子树中的所有节点的值都小......
  • Ramfs、rootfs和initramfs【ChatGPT】
    https://www.kernel.org/doc/html/v6.6/filesystems/ramfs-rootfs-initramfs.htmlRamfs、rootfs和initramfs作者[email protected]什么是ramfs?Ramfs是一个非常简单的文件系统,它将Linux的磁盘缓存机制(页面缓存和目录项缓存)作为一个动态可调整大小的基于RAM的文件......
  • 51单片机的内核架构组成 & 介绍
    对于51单片机相信很多电子信息或者相关专业的朋友应该都不会感觉陌生,很多专业在大学课程中开设的单片机课程就是使用的51单片机进行授课和学习的。51单片机的内容相较于其他高性能复杂的单片机来说,架构相对简单一些,寄存器也少很多,作为新手入门学习是很有好处的,不用一上来就啃很复......
  • 设备链接 【ChatGPT】
    https://www.kernel.org/doc/html/v6.6/driver-api/device_link.html默认情况下,驱动核心仅强制执行设备之间的依赖关系,这些依赖关系源自设备层次结构中的父/子关系:在挂起、恢复或关闭系统时,设备的顺序是基于这种关系的,即子设备总是在其父设备之前挂起,父设备总是在其子设备之前......