sysfs API总结

 原文链接:http://blog.csdn.net/qb_2008/article/details/6846412


sysfs是用于表现设备驱动模型的文件系统,它基于ramfs。要学习linux的设备驱动模型,就要先做好底层工作,总结sysfs提供给外界的API就是其中之一。sysfs文件系统中提供了四类文件的创建与管理,分别是目录、普通文件、软链接文件、二进制文件。目录层次往往代表着设备驱动模型的结构,软链接文件则代表着不同部分间的关系。比如某个设备的目录只出现在/sys/devices下,其它地方涉及到它时只好用软链接文件链接过去,保持了设备唯一的实例。而普通文件和二进制文件往往代表了设备的属性,读写这些文件需要调用相应的属性读写。

    sysfs是表现设备驱动模型的文件系统,它的目录层次实际反映的是对象的层次。为了配合这种目录,linux专门提供了两个结构作为sysfs的骨架,它们就是struct kobject和struct kset。我们知道,sysfs是完全虚拟的,它的每个目录其实都对应着一个kobject,要想知道这个目录下有哪些子目录,就要用到kset。从面向对象的角度来讲,kset继承了kobject的功能,既可以表示sysfs中的一个目录,还可以包含下层目录。对于kobject和kset,会在其它文章中专门分析到,这里简单描述只是为了更好地介绍sysfs提供的API。

    sysfs模块提供给外界的接口完全展现在include/linux/sysfs.h中。

  1. struct attribute {  
  2.     const char      *name;  
  3.     struct module       *owner;  
  4.     mode_t          mode;  
  5. };  
  6.   
  7. struct attribute_group {  
  8.     const char      *name;  
  9.     mode_t          (*is_visible)(struct kobject *,  
  10.                           struct attribute *, int);  
  11.     struct attribute    **attrs;  
  12. };  

之前说过普通文件是kobject目录的属性展现。struct attribute就是属性的通用结构,其它部分在使用时还可以把struct attribute内嵌到更大的属性结构中。struct attribute_group是提供一组属性的集合,这样集中的管理更为方便。

  1. #define __ATTR(_name,_mode,_show,_store) { \  
  2.     .attr = {.name = __stringify(_name), .mode = _mode },   \  
  3.     .show   = _show,                    \  
  4.     .store  = _store,                   \  
  5. }  
  6.   
  7. #define __ATTR_RO(_name) { \  
  8.     .attr   = { .name = __stringify(_name), .mode = 0444 }, \  
  9.     .show   = _name##_show,                 \  
  10. }  
  11.   
  12. #define __ATTR_NULL { .attr = { .name = NULL } }  
  13.   
  14. #define attr_name(_attr) (_attr).attr.name  

以上的宏是为了静态初始化属性时更为方便,我们简单将其忽略。

  1. struct bin_attribute {  
  2.     struct attribute    attr;  
  3.     size_t          size;  
  4.     void            *private;  
  5.     ssize_t (*read)(struct kobject *, struct bin_attribute *,  
  6.             char *, loff_t, size_t);  
  7.     ssize_t (*write)(struct kobject *, struct bin_attribute *,  
  8.              char *, loff_t, size_t);  
  9.     int (*mmap)(struct kobject *, struct bin_attribute *attr,  
  10.             struct vm_area_struct *vma);  
  11. };  

struct attribute是通用的属性结构,而struct bin_attribute就是为二进制属性专门设计的,它在sysfs中表现为二进制文件,大多数是设备配置参数的映射。struct bin_attribute恰恰就是把struct attribute内嵌到更大结构的样例。

  1. struct sysfs_ops {  
  2.     ssize_t (*show)(struct kobject *, struct attribute *,char *);  
  3.     ssize_t (*store)(struct kobject *,struct attribute *,const char *, size_t);  
  4. };  

struct sysfs_ops中包含show和store两个函数指针,它们分别在sysfs文件读和文件写时调用。

  1. int sysfs_schedule_callback(struct kobject *kobj, void (*func)(void *),  
  2.                 void *data, struct module *owner);  

sysfs_schedule_callback()会创建一个工作队列,稍后调用func(data)。本来sysfs中的属性读写函数是无法删除属性文件或者kobject目录的,因为调用函数时是加锁的,要删除也需要加锁。但这里可以通过工作队列回调的方式实现。

  1. int __must_check sysfs_create_dir(struct kobject *kobj);  
  2. void sysfs_remove_dir(struct kobject *kobj);  
  3. int __must_check sysfs_rename_dir(struct kobject *kobj, const char *new_name);  
  4. int __must_check sysfs_move_dir(struct kobject *kobj,  
  5.                 struct kobject *new_parent_kobj);  

sysfs_create_dir()创建一个kobject对应的目录,目录名就是kobj->name。

sysfs_remove_dir()删除kobj对应的目录。删除一个目录也会相应地删除目录下的文件及子目录。

sysfs_rename_dir()修改kobj对应目录的名称。

sysfs_move_dir()将kobj对应的目录移到new_parent_kobj对应的目录下。

 

  1. int __must_check sysfs_create_file(struct kobject *kobj,  
  2.                    const struct attribute *attr);  
  3. int __must_check sysfs_chmod_file(struct kobject *kobj, struct attribute *attr,  
  4.                   mode_t mode);  
  5. void sysfs_remove_file(struct kobject *kobj, const struct attribute *attr);  

sysfs_create_file()在kobj对应的目录下创建attr对应的属性文件。

sysfs_chmod_file()修改attr对应的属性文件的读写权限。

sysfs_remove_file()在kobj对应的目录下删除attr对应的属性文件。

 

  1. int __must_check sysfs_create_bin_file(struct kobject *kobj,  
  2.                        struct bin_attribute *attr);  
  3. void sysfs_remove_bin_file(struct kobject *kobj, struct bin_attribute *attr);  

sysfs_create_bin_file()在kobj目录下创建attr对应的二进制属性文件。

sysfs_remove_bin_file()在kobj目录下删除attr对应的二进制属性文件。

  1. int __must_check sysfs_create_link(struct kobject *kobj, struct kobject *target,  
  2.                    const char *name);  
  3. int __must_check sysfs_create_link_nowarn(struct kobject *kobj,  
  4.                       struct kobject *target,  
  5.                       const char *name);  
  6. void sysfs_remove_link(struct kobject *kobj, const char *name);  

sysfs_create_link()在kobj目录下创建指向target目录的软链接,name为软链接文件名称。

sysfs_create_link_nowarn()与sysfs_create_link()功能相同,只是在软链接文件已存在时不会出现警告。

sysfs_remove_link()删除kobj目录下名为name的软链接文件。

  1. int __must_check sysfs_create_group(struct kobject *kobj,  
  2.         const struct attribute_group *grp);  
  3. int sysfs_update_group(struct kobject *kobj,  
  4.          const struct attribute_group *grp);  
  5. void sysfs_remove_group(struct kobject *kobj,  
  6.    const struct attribute_group *grp);  
  7. int sysfs_add_file_to_group(struct kobject *kobj,  
  8.    const struct attribute *attr, const char *group);  
  9. void sysfs_remove_file_from_group(struct kobject *kobj,  
  10.    const struct attribute *attr, const char *group);  

sysfs_create_group()在kobj目录下创建一个属性集合,并显示集合中的属性文件。如果文件已存在,会报错。

sysfs_update_group()在kobj目录下创建一个属性集合,并显示集合中的属性文件。文件已存在也不会报错。sysfs_update_group()也用于group改动影响到文件显示时调用。

sysfs_remove_group()在kobj目录下删除一个属性集合,并删除集合中的属性文件。

sysfs_add_file_to_group()将一个属性attr加入kobj目录下已存在的的属性集合group。

sysfs_remove_file_from_group()将属性attr从kobj目录下的属性集合group中删除。

 

  1. void sysfs_notify(struct kobject *kobj, const char *dir, const char *attr);  
  2. void sysfs_notify_dirent(struct sysfs_dirent *sd);  

sysfs_notify()和sysfs_notify_dirent()都是用来唤醒在属性文件上调用select()或poll()而阻塞的用户进程。

  1. struct sysfs_dirent *sysfs_get_dirent(struct sysfs_dirent *parent_sd,  
  2.                       const unsigned char *name);  
  3. struct sysfs_dirent *sysfs_get(struct sysfs_dirent *sd);  
  4. void sysfs_put(struct sysfs_dirent *sd);  

sysfs_get()增加目录或文件的引用计数。

sysfs_put()减少目录或文件的引用计数,并在降为零时删除相应的文件或目录,这种删除又会减少上层目录的引用计数。

sysfs_get_dirent()是增加目录parent_sd中名为name的目录或文件的引用计数。

虽然同样是引用计数,同样在降为零时有删除动作,但却并非使用kref。这种操作更多地继承了文件系统管理时的传统。

  1. void sysfs_printk_last_file(void);  
  2. int __must_check sysfs_init(void);  

sysfs_printk_last_file()是在sysfs崩溃时打印最后一个访问到的文件路径。

sysfs_init()是在sysfs模块初始化时调用的。

这两个函数都与我们没有什么关系。
  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
### 回答1: Linux sysfs是Linux内核提供的一种虚拟文件系统,用于向用户空间提供内核信息和控制接口。它提供了一种统一的方式来访问内核数据结构,包括设备、驱动程序、文件系统和其他内核组件。通过sysfs,用户可以查看和修改内核状态,例如设备属性、驱动程序参数和系统配置。sysfs还提供了一些特殊的文件和目录,用于管理和监控系统资源,例如CPU、内存和网络接口。 ### 回答2: Linux sysfs 是一种用于管理 Linux 操作系统的虚拟文件系统。它为用户提供了一种简单、一致和易于理解的方式来管理系统设备、内核模块和进程的系统信息。 Linux sysfs 基于文件系统的概念,它不是用于存储文件的常规文件系统,而是用于存储和显示有关系统设备、内核模块和进程的信息。在 sysfs 中,几乎一切都被表示为文件或目录,并且可以通过文件系统的操作进行读写操作。 Linux sysfs 中的设备表示为一个目录结构,包括每个设备的名称和属性。这些属性包括该设备的状态、参数和配置。可以通过 sysfs 修改设备属性,从而在运行时对系统进行配置。 sysfs 还提供了一种管理内核模块的机制。内核模块将自己的信息写入 sysfs 中的相应目录,用户可以通过 sysfs 查看和修改内核模块的状态和参数,包括加载、移除、卸载和重载内核模块。 除了管理设备和内核模块之外,sysfs 还将进程信息以文件和目录的形式公开。每个进程都被表示为一个目录,包含进程的状态、配置和其他信息。sysfs 使用户可以查看和操作进程的信息,启用或禁用进程、发送信号和进程间通信等。 总之,Linux sysfs 是一个非常强大且重要的系统机制,它为用户提供了一种易于理解、一致、可靠且灵活的方式来管理系统设备、内核模块和进程的信息。无论您是管理 Linux 系统还是进行开发,了解 sysfs 都将是一个非常重要的领域。 ### 回答3: Linux sysfs是一个虚拟文件系统,用于向用户提供内核和设备驱动程序的信息。它提供了一个层次结构的文件系统,其中每个组件都被表示为文件夹和文件。这些文件夹和文件中包含有关系统状态和设备信息的数据。sysfs是Linux内核的一个重要组成部分,它提供了很多调试和诊断功能,同时也可以帮助开发者编写更好的设备驱动程序。 sysfs的主要作用是提供一种简单的方式来访问内核信息,通过读取或写入sysfs中的数据,用户可以获取有关设备、内核参数、驱动程序信息等很多数据。通过sysfs中的节点,用户可以查看内核的许多设置,例如IRQ映射、内存布局和中断控制器等。这些信息对于系统管理、硬件和软件故障排除以及性能调整至关重要。 sysfs还提供了另一个强大的功能,即让用户可以修改某些内核参数和配置。例如,通过sysfs,用户可以更改CPU调度策略、设置内核调试等级,或禁用某个硬件设备。这种灵活性使得开发者和系统管理员可以轻松地调整系统性能、解决问题并添加新的功能。 总之,Linux sysfs是一个非常有用的工具,提供了一种轻松访问内核和设备信息的方式。通过它,用户可以查看和修改内核参数和配置,有助于诊断和解决系统问题。在Linux的开发、管理和维护过程中扮演着非常重要的作用。

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值