1*bf608ebcSHu HaowenSPDX-License-Identifier: GPL-2.0 2*bf608ebcSHu Haowen 3*bf608ebcSHu HaowenChinese translated version of Documentation/filesystems/sysfs.rst 4*bf608ebcSHu Haowen 5*bf608ebcSHu HaowenIf you have any comment or update to the content, please contact the 6*bf608ebcSHu Haowenoriginal document maintainer directly. However, if you have a problem 7*bf608ebcSHu Haowencommunicating in English you can also ask the Chinese maintainer for 8*bf608ebcSHu Haowenhelp. Contact the Chinese maintainer if this translation is outdated 9*bf608ebcSHu Haowenor if there is a problem with the translation. 10*bf608ebcSHu Haowen 11*bf608ebcSHu HaowenMaintainer: Patrick Mochel <mochel@osdl.org> 12*bf608ebcSHu Haowen Mike Murphy <mamurph@cs.clemson.edu> 13*bf608ebcSHu HaowenChinese maintainer: Fu Wei <tekkamanninja@gmail.com> 14*bf608ebcSHu Haowen--------------------------------------------------------------------- 15*bf608ebcSHu HaowenDocumentation/filesystems/sysfs.rst 的中文翻譯 16*bf608ebcSHu Haowen 17*bf608ebcSHu Haowen如果想評論或更新本文的內容,請直接聯繫原文檔的維護者。如果你使用英文 18*bf608ebcSHu Haowen交流有困難的話,也可以向中文版維護者求助。如果本翻譯更新不及時或者翻 19*bf608ebcSHu Haowen譯存在問題,請聯繫中文版維護者。 20*bf608ebcSHu Haowen英文版維護者: Patrick Mochel <mochel@osdl.org> 21*bf608ebcSHu Haowen Mike Murphy <mamurph@cs.clemson.edu> 22*bf608ebcSHu Haowen中文版維護者: 傅煒 Fu Wei <tekkamanninja@gmail.com> 23*bf608ebcSHu Haowen中文版翻譯者: 傅煒 Fu Wei <tekkamanninja@gmail.com> 24*bf608ebcSHu Haowen中文版校譯者: 傅煒 Fu Wei <tekkamanninja@gmail.com> 25*bf608ebcSHu Haowen繁體中文版校譯者:胡皓文 Hu Haowen <src.res@email.cn> 26*bf608ebcSHu Haowen 27*bf608ebcSHu Haowen 28*bf608ebcSHu Haowen以下爲正文 29*bf608ebcSHu Haowen--------------------------------------------------------------------- 30*bf608ebcSHu Haowensysfs - 用於導出內核對象(kobject)的文件系統 31*bf608ebcSHu Haowen 32*bf608ebcSHu HaowenPatrick Mochel <mochel@osdl.org> 33*bf608ebcSHu HaowenMike Murphy <mamurph@cs.clemson.edu> 34*bf608ebcSHu Haowen 35*bf608ebcSHu Haowen修訂: 16 August 2011 36*bf608ebcSHu Haowen原始版本: 10 January 2003 37*bf608ebcSHu Haowen 38*bf608ebcSHu Haowen 39*bf608ebcSHu Haowensysfs 簡介: 40*bf608ebcSHu Haowen~~~~~~~~~~ 41*bf608ebcSHu Haowen 42*bf608ebcSHu Haowensysfs 是一個最初基於 ramfs 且位於內存的文件系統。它提供導出內核 43*bf608ebcSHu Haowen數據結構及其屬性,以及它們之間的關聯到用戶空間的方法。 44*bf608ebcSHu Haowen 45*bf608ebcSHu Haowensysfs 始終與 kobject 的底層結構緊密相關。請閱讀 46*bf608ebcSHu HaowenDocumentation/core-api/kobject.rst 文檔以獲得更多關於 kobject 接口的 47*bf608ebcSHu Haowen信息。 48*bf608ebcSHu Haowen 49*bf608ebcSHu Haowen 50*bf608ebcSHu Haowen使用 sysfs 51*bf608ebcSHu Haowen~~~~~~~~~~~ 52*bf608ebcSHu Haowen 53*bf608ebcSHu Haowen只要內核配置中定義了 CONFIG_SYSFS ,sysfs 總是被編譯進內核。你可 54*bf608ebcSHu Haowen通過以下命令掛載它: 55*bf608ebcSHu Haowen 56*bf608ebcSHu Haowen mount -t sysfs sysfs /sys 57*bf608ebcSHu Haowen 58*bf608ebcSHu Haowen 59*bf608ebcSHu Haowen創建目錄 60*bf608ebcSHu Haowen~~~~~~~~ 61*bf608ebcSHu Haowen 62*bf608ebcSHu Haowen任何 kobject 在系統中註冊,就會有一個目錄在 sysfs 中被創建。這個 63*bf608ebcSHu Haowen目錄是作爲該 kobject 的父對象所在目錄的子目錄創建的,以準確地傳遞 64*bf608ebcSHu Haowen內核的對象層次到用戶空間。sysfs 中的頂層目錄代表著內核對象層次的 65*bf608ebcSHu Haowen共同祖先;例如:某些對象屬於某個子系統。 66*bf608ebcSHu Haowen 67*bf608ebcSHu HaowenSysfs 在與其目錄關聯的 kernfs_node 對象中內部保存一個指向實現 68*bf608ebcSHu Haowen目錄的 kobject 的指針。以前,這個 kobject 指針被 sysfs 直接用於 69*bf608ebcSHu Haowenkobject 文件打開和關閉的引用計數。而現在的 sysfs 實現中,kobject 70*bf608ebcSHu Haowen引用計數只能通過 sysfs_schedule_callback() 函數直接修改。 71*bf608ebcSHu Haowen 72*bf608ebcSHu Haowen 73*bf608ebcSHu Haowen屬性 74*bf608ebcSHu Haowen~~~~ 75*bf608ebcSHu Haowen 76*bf608ebcSHu Haowenkobject 的屬性可在文件系統中以普通文件的形式導出。Sysfs 爲屬性定義 77*bf608ebcSHu Haowen了面向文件 I/O 操作的方法,以提供對內核屬性的讀寫。 78*bf608ebcSHu Haowen 79*bf608ebcSHu Haowen 80*bf608ebcSHu Haowen屬性應爲 ASCII 碼文本文件。以一個文件只存儲一個屬性值爲宜。但一個 81*bf608ebcSHu Haowen文件只包含一個屬性值可能影響效率,所以一個包含相同數據類型的屬性值 82*bf608ebcSHu Haowen數組也被廣泛地接受。 83*bf608ebcSHu Haowen 84*bf608ebcSHu Haowen混合類型、表達多行數據以及一些怪異的數據格式會遭到強烈反對。這樣做是 85*bf608ebcSHu Haowen很丟臉的,而且其代碼會在未通知作者的情況下被重寫。 86*bf608ebcSHu Haowen 87*bf608ebcSHu Haowen 88*bf608ebcSHu Haowen一個簡單的屬性結構定義如下: 89*bf608ebcSHu Haowen 90*bf608ebcSHu Haowenstruct attribute { 91*bf608ebcSHu Haowen char * name; 92*bf608ebcSHu Haowen struct module *owner; 93*bf608ebcSHu Haowen umode_t mode; 94*bf608ebcSHu Haowen}; 95*bf608ebcSHu Haowen 96*bf608ebcSHu Haowen 97*bf608ebcSHu Haowenint sysfs_create_file(struct kobject * kobj, const struct attribute * attr); 98*bf608ebcSHu Haowenvoid sysfs_remove_file(struct kobject * kobj, const struct attribute * attr); 99*bf608ebcSHu Haowen 100*bf608ebcSHu Haowen 101*bf608ebcSHu Haowen一個單獨的屬性結構並不包含讀寫其屬性值的方法。子系統最好爲增刪特定 102*bf608ebcSHu Haowen對象類型的屬性定義自己的屬性結構體和封裝函數。 103*bf608ebcSHu Haowen 104*bf608ebcSHu Haowen例如:驅動程序模型定義的 device_attribute 結構體如下: 105*bf608ebcSHu Haowen 106*bf608ebcSHu Haowenstruct device_attribute { 107*bf608ebcSHu Haowen struct attribute attr; 108*bf608ebcSHu Haowen ssize_t (*show)(struct device *dev, struct device_attribute *attr, 109*bf608ebcSHu Haowen char *buf); 110*bf608ebcSHu Haowen ssize_t (*store)(struct device *dev, struct device_attribute *attr, 111*bf608ebcSHu Haowen const char *buf, size_t count); 112*bf608ebcSHu Haowen}; 113*bf608ebcSHu Haowen 114*bf608ebcSHu Haowenint device_create_file(struct device *, const struct device_attribute *); 115*bf608ebcSHu Haowenvoid device_remove_file(struct device *, const struct device_attribute *); 116*bf608ebcSHu Haowen 117*bf608ebcSHu Haowen爲了定義設備屬性,同時定義了一下輔助宏: 118*bf608ebcSHu Haowen 119*bf608ebcSHu Haowen#define DEVICE_ATTR(_name, _mode, _show, _store) \ 120*bf608ebcSHu Haowenstruct device_attribute dev_attr_##_name = __ATTR(_name, _mode, _show, _store) 121*bf608ebcSHu Haowen 122*bf608ebcSHu Haowen例如:聲明 123*bf608ebcSHu Haowen 124*bf608ebcSHu Haowenstatic DEVICE_ATTR(foo, S_IWUSR | S_IRUGO, show_foo, store_foo); 125*bf608ebcSHu Haowen 126*bf608ebcSHu Haowen等同於如下代碼: 127*bf608ebcSHu Haowen 128*bf608ebcSHu Haowenstatic struct device_attribute dev_attr_foo = { 129*bf608ebcSHu Haowen .attr = { 130*bf608ebcSHu Haowen .name = "foo", 131*bf608ebcSHu Haowen .mode = S_IWUSR | S_IRUGO, 132*bf608ebcSHu Haowen .show = show_foo, 133*bf608ebcSHu Haowen .store = store_foo, 134*bf608ebcSHu Haowen }, 135*bf608ebcSHu Haowen}; 136*bf608ebcSHu Haowen 137*bf608ebcSHu Haowen 138*bf608ebcSHu Haowen子系統特有的回調函數 139*bf608ebcSHu Haowen~~~~~~~~~~~~~~~~~~~ 140*bf608ebcSHu Haowen 141*bf608ebcSHu Haowen當一個子系統定義一個新的屬性類型時,必須實現一系列的 sysfs 操作, 142*bf608ebcSHu Haowen以幫助讀寫調用實現屬性所有者的顯示和儲存方法。 143*bf608ebcSHu Haowen 144*bf608ebcSHu Haowenstruct sysfs_ops { 145*bf608ebcSHu Haowen ssize_t (*show)(struct kobject *, struct attribute *, char *); 146*bf608ebcSHu Haowen ssize_t (*store)(struct kobject *, struct attribute *, const char *, size_t); 147*bf608ebcSHu Haowen}; 148*bf608ebcSHu Haowen 149*bf608ebcSHu Haowen[子系統應已經定義了一個 struct kobj_type 結構體作爲這個類型的 150*bf608ebcSHu Haowen描述符,並在此保存 sysfs_ops 的指針。更多的信息參見 kobject 的 151*bf608ebcSHu Haowen文檔] 152*bf608ebcSHu Haowen 153*bf608ebcSHu Haowensysfs 會爲這個類型調用適當的方法。當一個文件被讀寫時,這個方法會 154*bf608ebcSHu Haowen將一般的kobject 和 attribute 結構體指針轉換爲適當的指針類型後 155*bf608ebcSHu Haowen調用相關聯的函數。 156*bf608ebcSHu Haowen 157*bf608ebcSHu Haowen 158*bf608ebcSHu Haowen示例: 159*bf608ebcSHu Haowen 160*bf608ebcSHu Haowen#define to_dev_attr(_attr) container_of(_attr, struct device_attribute, attr) 161*bf608ebcSHu Haowen 162*bf608ebcSHu Haowenstatic ssize_t dev_attr_show(struct kobject *kobj, struct attribute *attr, 163*bf608ebcSHu Haowen char *buf) 164*bf608ebcSHu Haowen{ 165*bf608ebcSHu Haowen struct device_attribute *dev_attr = to_dev_attr(attr); 166*bf608ebcSHu Haowen struct device *dev = kobj_to_dev(kobj); 167*bf608ebcSHu Haowen ssize_t ret = -EIO; 168*bf608ebcSHu Haowen 169*bf608ebcSHu Haowen if (dev_attr->show) 170*bf608ebcSHu Haowen ret = dev_attr->show(dev, dev_attr, buf); 171*bf608ebcSHu Haowen if (ret >= (ssize_t)PAGE_SIZE) { 172*bf608ebcSHu Haowen printk("dev_attr_show: %pS returned bad count\n", 173*bf608ebcSHu Haowen dev_attr->show); 174*bf608ebcSHu Haowen } 175*bf608ebcSHu Haowen return ret; 176*bf608ebcSHu Haowen} 177*bf608ebcSHu Haowen 178*bf608ebcSHu Haowen 179*bf608ebcSHu Haowen 180*bf608ebcSHu Haowen讀寫屬性數據 181*bf608ebcSHu Haowen~~~~~~~~~~~~ 182*bf608ebcSHu Haowen 183*bf608ebcSHu Haowen在聲明屬性時,必須指定 show() 或 store() 方法,以實現屬性的 184*bf608ebcSHu Haowen讀或寫。這些方法的類型應該和以下的設備屬性定義一樣簡單。 185*bf608ebcSHu Haowen 186*bf608ebcSHu Haowenssize_t (*show)(struct device *dev, struct device_attribute *attr, char *buf); 187*bf608ebcSHu Haowenssize_t (*store)(struct device *dev, struct device_attribute *attr, 188*bf608ebcSHu Haowen const char *buf, size_t count); 189*bf608ebcSHu Haowen 190*bf608ebcSHu Haowen也就是說,他們應只以一個處理對象、一個屬性和一個緩衝指針作爲參數。 191*bf608ebcSHu Haowen 192*bf608ebcSHu Haowensysfs 會分配一個大小爲 (PAGE_SIZE) 的緩衝區並傳遞給這個方法。 193*bf608ebcSHu HaowenSysfs 將會爲每次讀寫操作調用一次這個方法。這使得這些方法在執行時 194*bf608ebcSHu Haowen會出現以下的行爲: 195*bf608ebcSHu Haowen 196*bf608ebcSHu Haowen- 在讀方面(read(2)),show() 方法應該填充整個緩衝區。回想屬性 197*bf608ebcSHu Haowen 應只導出了一個屬性值或是一個同類型屬性值的數組,所以這個代價將 198*bf608ebcSHu Haowen 不會不太高。 199*bf608ebcSHu Haowen 200*bf608ebcSHu Haowen 這使得用戶空間可以局部地讀和任意的向前搜索整個文件。如果用戶空間 201*bf608ebcSHu Haowen 向後搜索到零或使用『0』偏移執行一個pread(2)操作,show()方法將 202*bf608ebcSHu Haowen 再次被調用,以重新填充緩存。 203*bf608ebcSHu Haowen 204*bf608ebcSHu Haowen- 在寫方面(write(2)),sysfs 希望在第一次寫操作時得到整個緩衝區。 205*bf608ebcSHu Haowen 之後 Sysfs 傳遞整個緩衝區給 store() 方法。 206*bf608ebcSHu Haowen 207*bf608ebcSHu Haowen 當要寫 sysfs 文件時,用戶空間進程應首先讀取整個文件,修該想要 208*bf608ebcSHu Haowen 改變的值,然後回寫整個緩衝區。 209*bf608ebcSHu Haowen 210*bf608ebcSHu Haowen 在讀寫屬性值時,屬性方法的執行應操作相同的緩衝區。 211*bf608ebcSHu Haowen 212*bf608ebcSHu Haowen註記: 213*bf608ebcSHu Haowen 214*bf608ebcSHu Haowen- 寫操作導致的 show() 方法重載,會忽略當前文件位置。 215*bf608ebcSHu Haowen 216*bf608ebcSHu Haowen- 緩衝區應總是 PAGE_SIZE 大小。對於i386,這個值爲4096。 217*bf608ebcSHu Haowen 218*bf608ebcSHu Haowen- show() 方法應該返回寫入緩衝區的字節數,也就是 scnprintf()的 219*bf608ebcSHu Haowen 返回值。 220*bf608ebcSHu Haowen 221*bf608ebcSHu Haowen- show() 方法在將格式化返回值返回用戶空間的時候,禁止使用snprintf()。 222*bf608ebcSHu Haowen 如果可以保證不會發生緩衝區溢出,可以使用sprintf(),否則必須使用 223*bf608ebcSHu Haowen scnprintf()。 224*bf608ebcSHu Haowen 225*bf608ebcSHu Haowen- store() 應返回緩衝區的已用字節數。如果整個緩存都已填滿,只需返回 226*bf608ebcSHu Haowen count 參數。 227*bf608ebcSHu Haowen 228*bf608ebcSHu Haowen- show() 或 store() 可以返回錯誤值。當得到一個非法值,必須返回一個 229*bf608ebcSHu Haowen 錯誤值。 230*bf608ebcSHu Haowen 231*bf608ebcSHu Haowen- 一個傳遞給方法的對象將會通過 sysfs 調用對象內嵌的引用計數固定在 232*bf608ebcSHu Haowen 內存中。儘管如此,對象代表的物理實體(如設備)可能已不存在。如有必要, 233*bf608ebcSHu Haowen 應該實現一個檢測機制。 234*bf608ebcSHu Haowen 235*bf608ebcSHu Haowen一個簡單的(未經實驗證實的)設備屬性實現如下: 236*bf608ebcSHu Haowen 237*bf608ebcSHu Haowenstatic ssize_t show_name(struct device *dev, struct device_attribute *attr, 238*bf608ebcSHu Haowen char *buf) 239*bf608ebcSHu Haowen{ 240*bf608ebcSHu Haowen return scnprintf(buf, PAGE_SIZE, "%s\n", dev->name); 241*bf608ebcSHu Haowen} 242*bf608ebcSHu Haowen 243*bf608ebcSHu Haowenstatic ssize_t store_name(struct device *dev, struct device_attribute *attr, 244*bf608ebcSHu Haowen const char *buf, size_t count) 245*bf608ebcSHu Haowen{ 246*bf608ebcSHu Haowen snprintf(dev->name, sizeof(dev->name), "%.*s", 247*bf608ebcSHu Haowen (int)min(count, sizeof(dev->name) - 1), buf); 248*bf608ebcSHu Haowen return count; 249*bf608ebcSHu Haowen} 250*bf608ebcSHu Haowen 251*bf608ebcSHu Haowenstatic DEVICE_ATTR(name, S_IRUGO, show_name, store_name); 252*bf608ebcSHu Haowen 253*bf608ebcSHu Haowen 254*bf608ebcSHu Haowen(注意:真正的實現不允許用戶空間設置設備名。) 255*bf608ebcSHu Haowen 256*bf608ebcSHu Haowen頂層目錄布局 257*bf608ebcSHu Haowen~~~~~~~~~~~~ 258*bf608ebcSHu Haowen 259*bf608ebcSHu Haowensysfs 目錄的安排顯示了內核數據結構之間的關係。 260*bf608ebcSHu Haowen 261*bf608ebcSHu Haowen頂層 sysfs 目錄如下: 262*bf608ebcSHu Haowen 263*bf608ebcSHu Haowenblock/ 264*bf608ebcSHu Haowenbus/ 265*bf608ebcSHu Haowenclass/ 266*bf608ebcSHu Haowendev/ 267*bf608ebcSHu Haowendevices/ 268*bf608ebcSHu Haowenfirmware/ 269*bf608ebcSHu Haowennet/ 270*bf608ebcSHu Haowenfs/ 271*bf608ebcSHu Haowen 272*bf608ebcSHu Haowendevices/ 包含了一個設備樹的文件系統表示。他直接映射了內部的內核 273*bf608ebcSHu Haowen設備樹,反映了設備的層次結構。 274*bf608ebcSHu Haowen 275*bf608ebcSHu Haowenbus/ 包含了內核中各種總線類型的平面目錄布局。每個總線目錄包含兩個 276*bf608ebcSHu Haowen子目錄: 277*bf608ebcSHu Haowen 278*bf608ebcSHu Haowen devices/ 279*bf608ebcSHu Haowen drivers/ 280*bf608ebcSHu Haowen 281*bf608ebcSHu Haowendevices/ 包含了系統中出現的每個設備的符號連結,他們指向 root/ 下的 282*bf608ebcSHu Haowen設備目錄。 283*bf608ebcSHu Haowen 284*bf608ebcSHu Haowendrivers/ 包含了每個已爲特定總線上的設備而掛載的驅動程序的目錄(這裡 285*bf608ebcSHu Haowen假定驅動沒有跨越多個總線類型)。 286*bf608ebcSHu Haowen 287*bf608ebcSHu Haowenfs/ 包含了一個爲文件系統設立的目錄。現在每個想要導出屬性的文件系統必須 288*bf608ebcSHu Haowen在 fs/ 下創建自己的層次結構(參見Documentation/filesystems/fuse.rst)。 289*bf608ebcSHu Haowen 290*bf608ebcSHu Haowendev/ 包含兩個子目錄: char/ 和 block/。在這兩個子目錄中,有以 291*bf608ebcSHu Haowen<major>:<minor> 格式命名的符號連結。這些符號連結指向 sysfs 目錄 292*bf608ebcSHu Haowen中相應的設備。/sys/dev 提供一個通過一個 stat(2) 操作結果,查找 293*bf608ebcSHu Haowen設備 sysfs 接口快捷的方法。 294*bf608ebcSHu Haowen 295*bf608ebcSHu Haowen更多有關 driver-model 的特性信息可以在 Documentation/driver-api/driver-model/ 296*bf608ebcSHu Haowen中找到。 297*bf608ebcSHu Haowen 298*bf608ebcSHu Haowen 299*bf608ebcSHu HaowenTODO: 完成這一節。 300*bf608ebcSHu Haowen 301*bf608ebcSHu Haowen 302*bf608ebcSHu Haowen當前接口 303*bf608ebcSHu Haowen~~~~~~~~ 304*bf608ebcSHu Haowen 305*bf608ebcSHu Haowen以下的接口層普遍存在於當前的sysfs中: 306*bf608ebcSHu Haowen 307*bf608ebcSHu Haowen- 設備 (include/linux/device.h) 308*bf608ebcSHu Haowen---------------------------------- 309*bf608ebcSHu Haowen結構體: 310*bf608ebcSHu Haowen 311*bf608ebcSHu Haowenstruct device_attribute { 312*bf608ebcSHu Haowen struct attribute attr; 313*bf608ebcSHu Haowen ssize_t (*show)(struct device *dev, struct device_attribute *attr, 314*bf608ebcSHu Haowen char *buf); 315*bf608ebcSHu Haowen ssize_t (*store)(struct device *dev, struct device_attribute *attr, 316*bf608ebcSHu Haowen const char *buf, size_t count); 317*bf608ebcSHu Haowen}; 318*bf608ebcSHu Haowen 319*bf608ebcSHu Haowen聲明: 320*bf608ebcSHu Haowen 321*bf608ebcSHu HaowenDEVICE_ATTR(_name, _mode, _show, _store); 322*bf608ebcSHu Haowen 323*bf608ebcSHu Haowen增/刪屬性: 324*bf608ebcSHu Haowen 325*bf608ebcSHu Haowenint device_create_file(struct device *dev, const struct device_attribute * attr); 326*bf608ebcSHu Haowenvoid device_remove_file(struct device *dev, const struct device_attribute * attr); 327*bf608ebcSHu Haowen 328*bf608ebcSHu Haowen 329*bf608ebcSHu Haowen- 總線驅動程序 (include/linux/device.h) 330*bf608ebcSHu Haowen-------------------------------------- 331*bf608ebcSHu Haowen結構體: 332*bf608ebcSHu Haowen 333*bf608ebcSHu Haowenstruct bus_attribute { 334*bf608ebcSHu Haowen struct attribute attr; 335*bf608ebcSHu Haowen ssize_t (*show)(struct bus_type *, char * buf); 336*bf608ebcSHu Haowen ssize_t (*store)(struct bus_type *, const char * buf, size_t count); 337*bf608ebcSHu Haowen}; 338*bf608ebcSHu Haowen 339*bf608ebcSHu Haowen聲明: 340*bf608ebcSHu Haowen 341*bf608ebcSHu HaowenBUS_ATTR(_name, _mode, _show, _store) 342*bf608ebcSHu Haowen 343*bf608ebcSHu Haowen增/刪屬性: 344*bf608ebcSHu Haowen 345*bf608ebcSHu Haowenint bus_create_file(struct bus_type *, struct bus_attribute *); 346*bf608ebcSHu Haowenvoid bus_remove_file(struct bus_type *, struct bus_attribute *); 347*bf608ebcSHu Haowen 348*bf608ebcSHu Haowen 349*bf608ebcSHu Haowen- 設備驅動程序 (include/linux/device.h) 350*bf608ebcSHu Haowen----------------------------------------- 351*bf608ebcSHu Haowen 352*bf608ebcSHu Haowen結構體: 353*bf608ebcSHu Haowen 354*bf608ebcSHu Haowenstruct driver_attribute { 355*bf608ebcSHu Haowen struct attribute attr; 356*bf608ebcSHu Haowen ssize_t (*show)(struct device_driver *, char * buf); 357*bf608ebcSHu Haowen ssize_t (*store)(struct device_driver *, const char * buf, 358*bf608ebcSHu Haowen size_t count); 359*bf608ebcSHu Haowen}; 360*bf608ebcSHu Haowen 361*bf608ebcSHu Haowen聲明: 362*bf608ebcSHu Haowen 363*bf608ebcSHu HaowenDRIVER_ATTR(_name, _mode, _show, _store) 364*bf608ebcSHu Haowen 365*bf608ebcSHu Haowen增/刪屬性: 366*bf608ebcSHu Haowen 367*bf608ebcSHu Haowenint driver_create_file(struct device_driver *, const struct driver_attribute *); 368*bf608ebcSHu Haowenvoid driver_remove_file(struct device_driver *, const struct driver_attribute *); 369*bf608ebcSHu Haowen 370*bf608ebcSHu Haowen 371*bf608ebcSHu Haowen文檔 372*bf608ebcSHu Haowen~~~~ 373*bf608ebcSHu Haowen 374*bf608ebcSHu Haowensysfs 目錄結構以及其中包含的屬性定義了一個內核與用戶空間之間的 ABI。 375*bf608ebcSHu Haowen對於任何 ABI,其自身的穩定和適當的文檔是非常重要的。所有新的 sysfs 376*bf608ebcSHu Haowen屬性必須在 Documentation/ABI 中有文檔。詳見 Documentation/ABI/README。 377*bf608ebcSHu Haowen 378