TOMOYO Linux Cross Reference
Linux/Documentation/translations/zh_TW/filesystems/sysfs.txt

Diff markup

Differences between /Documentation/translations/zh_TW/filesystems/sysfs.txt (Version linux-6.12-rc7) and /Documentation/translations/zh_TW/filesystems/sysfs.txt (Version linux-6.11.7)

   SPDX-License-Identifier: GPL-2.0                     SPDX-License-Identifier: GPL-2.0
                                                        
   Chinese translated version of Documentation/fi       Chinese translated version of Documentation/filesystems/sysfs.rst
                                                        
   If you have any comment or update to the conte       If you have any comment or update to the content, please contact the
   original document maintainer directly.  Howeve       original document maintainer directly.  However, if you have a problem
   communicating in English you can also ask the        communicating in English you can also ask the Chinese maintainer for
   help.  Contact the Chinese maintainer if this        help.  Contact the Chinese maintainer if this translation is outdated
   or if there is a problem with the translation.       or if there is a problem with the translation.
                                                      
  Maintainer: Patrick Mochel      <mochel@osdl.or      Maintainer: Patrick Mochel      <mochel@osdl.org>
                  Mike Murphy <mamurph@cs.clemson                      Mike Murphy <mamurph@cs.clemson.edu>
  Chinese maintainer: Fu Wei <tekkamanninja@gmail      Chinese maintainer: Fu Wei <tekkamanninja@gmail.com>
  ----------------------------------------------      ---------------------------------------------------------------------
  Documentation/filesystems/sysfs.rst çš„ä¸­æ–‡ç      Documentation/filesystems/sysfs.rst 的中文翻譯
                                                      
  å¦‚æžœæƒ³è©•è«–æˆ–æ›´æ–°æœ¬æ–‡çš„å…§å®¹ï¼Œè«‹ç      如果想評論或更新本文的內容，請直接è�¯ç¹«åŽŸæ–‡æª”的維護者。如果你使用英文
  交æµ�有困難的話，也å�¯ä»¥å�‘ä¸­æ–‡ç‰ˆç      交æµ�有困難的話，也å�¯ä»¥å�‘中文版維護者求助。如果本翻譯更新ä¸�å�Šæ™‚或者翻
  譯存在å•�題，請è�¯ç¹«ä¸­æ–‡ç‰ˆç¶­è­·è€…ã      譯存在å•�題，請è�¯ç¹«ä¸­æ–‡ç‰ˆç¶­è­·è€…。
  英文版維護者： Patrick Mochel    <mochel      英文版維護者： Patrick Mochel    <mochel@osdl.org>
                  Mike Murphy <mamurph@cs.clemson                      Mike Murphy <mamurph@cs.clemson.edu>
  中文版維護者： 傅煒 Fu Wei <tekkamanni      中文版維護者： 傅煒 Fu Wei <tekkamanninja@gmail.com>
  中文版翻譯者： 傅煒 Fu Wei <tekkamanni      中文版翻譯者： 傅煒 Fu Wei <tekkamanninja@gmail.com>
  中文版校譯者： 傅煒 Fu Wei <tekkamanni      中文版校譯者： 傅煒 Fu Wei <tekkamanninja@gmail.com>
  �體中文版校譯者：胡皓文 Hu Haowen<      �體中文版校譯者：胡皓文 Hu Haowen <2023002089@link.tyut.edu.cn>
                                                      
                                                      
  以下爲正文                                     以下爲正文
  ----------------------------------------------      ---------------------------------------------------------------------
  sysfs - 用於導出內核å°�象(kobject)çš„æ–      sysfs - 用於導出內核å°�象(kobject)的文件系統
                                                      
  Patrick Mochel  <mochel@osdl.org>                    Patrick Mochel  <mochel@osdl.org>
  Mike Murphy <mamurph@cs.clemson.edu>                 Mike Murphy <mamurph@cs.clemson.edu>
                                                      
  修訂:    16 August 2011                           修訂:    16 August 2011
  原始版本:   10 January 2003                     原始版本:   10 January 2003
                                                      
                                                      
  sysfs 簡介:                                       sysfs 簡介:
  ~~~~~~~~~~                                          ~~~~~~~~~~
                                                      
  sysfs 是一個最�基於 ramfs 且�於內      sysfs 是一個最�基於 ramfs 且�於內存的文件系統。它�供導出內核
  數據çµ�構å�Šå…¶å±¬æ€§ï¼Œä»¥å�Šå®ƒå€‘ä¹‹é–“ç      數據çµ�構å�Šå…¶å±¬æ€§ï¼Œä»¥å�Šå®ƒå€‘之間的關è�¯åˆ°ç”¨æˆ¶ç©ºé–“的方法。
                                                      
  sysfs 始終與 kobject 的底層çµ�æ§‹ç·Šå¯†ç      sysfs 始終與 kobject 的底層çµ�構緊密相關。請閱讀
  Documentation/core-api/kobject.rst 文檔以ç�      Documentation/core-api/kobject.rst 文檔以ç�²å¾—更多關於 kobject 接å�£çš„
  信�。                                           信�。
                                                      
                                                      
  使用 sysfs                                        使用 sysfs
  ~~~~~~~~~~~                                         ~~~~~~~~~~~
                                                      
  å�ªè¦�內核é…�置中定義了 CONFIG_SYSFS ï¼      å�ªè¦�內核é…�置中定義了 CONFIG_SYSFS ，sysfs 總是被編譯進內核。你å�¯
  通�以下命令掛載它:                        通�以下命令掛載它:
                                                      
      mount -t sysfs sysfs /sys                           mount -t sysfs sysfs /sys
                                                      
                                                      
  創建目錄                                        創建目錄
  ~~~~~~~~                                            ~~~~~~~~
                                                      
  任何 kobject åœ¨ç³»çµ±ä¸­è¨»å†Šï¼Œå°±æœƒæœ‰ä      任何 kobject 在系統中註冊，就會有一個目錄在 sysfs 中被創建。這個
  目錄是作爲該 kobject 的父å°�è±¡æ‰€åœ¨ç      目錄是作爲該 kobject 的父å°�象所在目錄的å­�目錄創建的，以準確地傳é�ž
  內核的å°�象層次到用戶空間。sysfs ä      內核的å°�象層次到用戶空間。sysfs 中的頂層目錄代表ç�€å…§æ ¸å°�象層次的
  å…±å�Œç¥–先；例如：æŸ�些å°�象屬於æŸ�å      å…±å�Œç¥–先；例如：æŸ�些å°�象屬於æŸ�個å­�系統。
                                                      
  Sysfs 在與其目錄關�的 kernfs_node �      Sysfs 在與其目錄關�的 kernfs_node �象中內部�存一個指�實�
  目錄的 kobject 的指�。以�，這個       目錄的 kobject 的指�。以�，這個 kobject 指�被 sysfs 直接用於
  kobject 文件打開和關閉的引用計數〠     kobject 文件打開和關閉的引用計數。而�在的 sysfs 實�中，kobject
  引用計數�能通� sysfs_schedule_callba      引用計數�能通� sysfs_schedule_callback() 函數直接修改。
                                                      
                                                      
  屬性                                              屬性
  ~~~~                                                ~~~~
                                                      
  kobject 的屬性å�¯åœ¨æ–‡ä»¶ç³»çµ±ä¸­ä»¥æ™®é€      kobject 的屬性å�¯åœ¨æ–‡ä»¶ç³»çµ±ä¸­ä»¥æ™®é€šæ–‡ä»¶çš„å½¢å¼�導出。Sysfs 爲屬性定義
  了é�¢å�‘文件 I/O æ“�作的方法，以æ��ä¾      了é�¢å�‘文件 I/O æ“�作的方法，以æ��ä¾›å°�內核屬性的讀寫。
                                                      
                                                      
  屬性應爲 ASCII 碼文本文件。以一個      屬性應爲 ASCII 碼文本文件。以一個文件�存儲一個屬性值爲宜。但一個
  文件å�ªåŒ…å�«ä¸€å€‹å±¬æ€§å€¼å�¯èƒ½å½±éŸ¿æ•ˆç      文件å�ªåŒ…å�«ä¸€å€‹å±¬æ€§å€¼å�¯èƒ½å½±éŸ¿æ•ˆçŽ‡ï¼Œæ‰€ä»¥ä¸€å€‹åŒ…å�«ç›¸å�Œæ•¸æ“šé¡žåž‹çš„屬性值
  數組也被廣泛地接�。                      數組也被廣泛地接�。
                                                      
  æ··å�ˆé¡žåž‹ã€�表é�”多行數據以å�Šä¸€äº›æ      æ··å�ˆé¡žåž‹ã€�表é�”多行數據以å�Šä¸€äº›æ€ªç•°çš„數據格å¼�會é�­åˆ°å¼·çƒˆå��å°�。這樣å�šæ˜¯
  很丟臉的,而且其代碼會在未通知作      很丟臉的,而且其代碼會在未通知作者的情�下被�寫。
                                                      
                                                      
  一個簡單的屬性�構定義如下:            一個簡單的屬性�構定義如下:
                                                      
  struct attribute {                                  struct attribute {
          char                    * name;                     char                    * name;
          struct module           *owner;                     struct module           *owner;
          umode_t                 mode;                       umode_t                 mode;
  };                                                  };
                                                      
                                                      
  int sysfs_create_file(struct kobject * kobj, c      int sysfs_create_file(struct kobject * kobj, const struct attribute * attr);
  void sysfs_remove_file(struct kobject * kobj,       void sysfs_remove_file(struct kobject * kobj, const struct attribute * attr);
                                                      
                                                    
 一個單ç�¨çš„屬性çµ�構並ä¸�包å�«è®€å¯«å     一個單ç�¨çš„屬性çµ�構並ä¸�包å�«è®€å¯«å…¶å±¬æ€§å€¼çš„方法。å­�系統最好爲增刪特定
 å°�象類型的屬性定義自己的屬性çµ�æ     å°�象類型的屬性定義自己的屬性çµ�構體和å°�è£�函數。
                                                    
 例如:驅動程�模型定義的 device_attr     例如:驅動程�模型定義的 device_attribute �構體如下:
                                                    
 struct device_attribute {                          struct device_attribute {
         struct attribute        attr;                      struct attribute        attr;
         ssize_t (*show)(struct device *dev, st             ssize_t (*show)(struct device *dev, struct device_attribute *attr,
                         char *buf);                                        char *buf);
         ssize_t (*store)(struct device *dev, s             ssize_t (*store)(struct device *dev, struct device_attribute *attr,
                          const char *buf, size                              const char *buf, size_t count);
 };                                                 };
                                                    
 int device_create_file(struct device *, const      int device_create_file(struct device *, const struct device_attribute *);
 void device_remove_file(struct device *, const     void device_remove_file(struct device *, const struct device_attribute *);
                                                    
 爲了定義設備屬性，å�Œæ™‚å®šç¾©äº†ä¸€ä     爲了定義設備屬性，å�Œæ™‚定義了一下輔助å®�:
                                                    
 #define DEVICE_ATTR(_name, _mode, _show, _stor     #define DEVICE_ATTR(_name, _mode, _show, _store) \
 struct device_attribute dev_attr_##_name = __A     struct device_attribute dev_attr_##_name = __ATTR(_name, _mode, _show, _store)
                                                    
 例如:�明                                      例如:�明
                                                    
 static DEVICE_ATTR(foo, S_IWUSR | S_IRUGO, sho     static DEVICE_ATTR(foo, S_IWUSR | S_IRUGO, show_foo, store_foo);
                                                    
 等�於如下代碼：                           等�於如下代碼：
                                                    
 static struct device_attribute dev_attr_foo =      static struct device_attribute dev_attr_foo = {
        .attr    = {                                       .attr    = {
                 .name = "foo",                                     .name = "foo",
                 .mode = S_IWUSR | S_IRUGO,                         .mode = S_IWUSR | S_IRUGO,
                 .show = show_foo,                                  .show = show_foo,
                 .store = store_foo,                                .store = store_foo,
         },                                                 },
 };                                                 };
                                                    
                                                    
 �系統特有的回調函數                     �系統特有的回調函數
 ~~~~~~~~~~~~~~~~~~~                                ~~~~~~~~~~~~~~~~~~~
                                                    
 當一個å­�ç³»çµ±å®šç¾©ä¸€å€‹æ–°çš„å±¬æ€§é¡žå     當一個å­�系統定義一個新的屬性類型時，必須實ç�¾ä¸€ç³»åˆ—çš„ sysfs æ“�作，
 以幫助讀寫調用實ç�¾å±¬æ€§æ‰€æœ‰è€…çš„é     以幫助讀寫調用實ç�¾å±¬æ€§æ‰€æœ‰è€…的顯示和儲存方法。
                                                    
 struct sysfs_ops {                                 struct sysfs_ops {
         ssize_t (*show)(struct kobject *, stru             ssize_t (*show)(struct kobject *, struct attribute *, char *);
         ssize_t (*store)(struct kobject *, str             ssize_t (*store)(struct kobject *, struct attribute *, const char *, size_t);
 };                                                 };
                                                    
 [�系統應已經定義了一個 struct kobj     [�系統應已經定義了一個 struct kobj_type �構體作爲這個類型的
 æ��述符，並在此ä¿�å­˜ sysfs_ops çš„æŒ‡é‡     æ��述符，並在此ä¿�å­˜ sysfs_ops 的指é‡�。更多的信æ�¯å�ƒè¦‹ kobject çš„
 文檔]                                            文檔]
                                                    
 sysfs 會爲這個類型調用é�©ç•¶çš„æ–¹æ³•ã     sysfs 會爲這個類型調用é�©ç•¶çš„方法。當一個文件被讀寫時，這個方法會
 將一般的kobject 和 attribute �構體指     將一般的kobject 和 attribute �構體指�轉�爲�當的指�類型後
 調用相關�的函數。                        調用相關�的函數。
                                                    
                                                    
 示例:                                            示例:
                                                    
 #define to_dev_attr(_attr) container_of(_attr,     #define to_dev_attr(_attr) container_of(_attr, struct device_attribute, attr)
                                                    
 static ssize_t dev_attr_show(struct kobject *k     static ssize_t dev_attr_show(struct kobject *kobj, struct attribute *attr,
                              char *buf)                                         char *buf)
 {                                                  {
         struct device_attribute *dev_attr = to             struct device_attribute *dev_attr = to_dev_attr(attr);
         struct device *dev = kobj_to_dev(kobj)             struct device *dev = kobj_to_dev(kobj);
         ssize_t ret = -EIO;                                ssize_t ret = -EIO;
                                                    
         if (dev_attr->show)                                if (dev_attr->show)
                 ret = dev_attr->show(dev, dev_                     ret = dev_attr->show(dev, dev_attr, buf);
         if (ret >= (ssize_t)PAGE_SIZE) {                   if (ret >= (ssize_t)PAGE_SIZE) {
                 printk("dev_attr_show: %pS ret                     printk("dev_attr_show: %pS returned bad count\n",
                                 dev_attr->show                                     dev_attr->show);
         }                                                  }
         return ret;                                        return ret;
 }                                                  }
                                                    
                                                    
                                                    
 讀寫屬性數據                                 讀寫屬性數據
 ~~~~~~~~~~~~                                       ~~~~~~~~~~~~
                                                    
 在�明屬性時，必須指定 show() 或 s     在�明屬性時，必須指定 show() 或 store() 方法，以實�屬性的
 è®€æˆ–å¯«ã€‚é€™äº›æ–¹æ³•çš„é¡žåž‹æ‡‰è©²å’Œä»¥ä     讀或寫。這些方法的類型應該和以下的設備屬性定義一樣簡單。
                                                    
 ssize_t (*show)(struct device *dev, struct dev     ssize_t (*show)(struct device *dev, struct device_attribute *attr, char *buf);
 ssize_t (*store)(struct device *dev, struct de     ssize_t (*store)(struct device *dev, struct device_attribute *attr,
                  const char *buf, size_t count                      const char *buf, size_t count);
                                                    
 也就是說,他們應�以一個處��象     也就是說,他們應�以一個處��象�一個屬性和一個緩�指�作爲�數。
                                                    
 sysfs 會分�一個大�爲 (PAGE_SIZE) 的     sysfs 會分�一個大�爲 (PAGE_SIZE) 的緩��並傳�給這個方法。
 Sysfs 將會爲æ¯�次讀寫æ“�ä½œèª¿ç”¨ä¸€æ¬¡é     Sysfs 將會爲æ¯�次讀寫æ“�作調用一次這個方法。這使得這些方法在執行時
 會出�以下的行爲:                          會出�以下的行爲:
                                                    
 - 在讀方�（read(2)），show() 方法應     - 在讀方�（read(2)），show() 方法應該填充整個緩��。回想屬性
   應å�ªå°Žå‡ºäº†ä¸€å€‹å±¬æ€§å€¼æˆ–是一個å�       應å�ªå°Žå‡ºäº†ä¸€å€‹å±¬æ€§å€¼æˆ–是一個å�Œé¡žåž‹å±¬æ€§å€¼çš„數組，所以這個代價將
   �會�太高。                                 �會�太高。
                                                    
   這使得用戶空間å�¯ä»¥å±€éƒ¨åœ°è®€å’Œä»       這使得用戶空間å�¯ä»¥å±€éƒ¨åœ°è®€å’Œä»»æ„�çš„å�‘å‰�æ�œç´¢æ•´å€‹æ–‡ä»¶ã€‚如果用戶空間
   å�‘後æ�œç´¢åˆ°é›¶æˆ–使用‘0’å��ç§»åŸ·è       å�‘後æ�œç´¢åˆ°é›¶æˆ–使用‘0’å��移執行一個pread(2)æ“�作，show()方法將
   �次被調用，以�新填充緩存。         �次被調用，以�新填充緩存。
                                                    
 - 在寫方�（write(2)），sysfs 希望在     - 在寫方�（write(2)），sysfs 希望在第一次寫�作時得到整個緩��。
   之後 Sysfs 傳�整個緩��給 store(       之後 Sysfs 傳�整個緩��給 store() 方法。
                                                    
   當è¦�寫 sysfs æ–‡ä»¶æ™‚ï¼Œç”¨æˆ¶ç©ºé–“é€²ç       當è¦�寫 sysfs 文件時，用戶空間進程應首先讀å�–整個文件，修該想è¦�
   改變的值，然後回寫整個緩��〠      改變的值，然後回寫整個緩��。
                                                    
   åœ¨è®€å¯«å±¬æ€§å€¼æ™‚ï¼Œå±¬æ€§æ–¹æ³•çš„åŸ·è¡       在讀寫屬性值時，屬性方法的執行應æ“�作相å�Œçš„ç·©è¡�å�€ã€‚
                                                    
 註記:                                            註記:
                                                    
 - 寫�作導致的 show() 方法�載，會     - 寫�作導致的 show() 方法�載，會忽略當�文件�置。
                                                    
 - 緩��應總是 PAGE_SIZE 大�。�於     - 緩��應總是 PAGE_SIZE 大�。�於i386，這個值爲4096。
                                                    
 - show() 方法應該返回寫入緩è¡�å�€çš„å     - show() 方法應該返回寫入緩è¡�å�€çš„字節數，也就是 scnprintf()çš„
   返回值。                                       返回值。
                                                    
 - show() 方法在將格å¼�åŒ–è¿”å›žå€¼è¿”å›žç     - show() 方法在將格å¼�化返回值返回用戶空間的時候，ç¦�止使用snprintf()。
   如果å�¯ä»¥ä¿�è­‰ä¸�會發生緩è¡�å�€æº¢å‡       如果å�¯ä»¥ä¿�è­‰ä¸�會發生緩è¡�å�€æº¢å‡ºï¼Œå�¯ä»¥ä½¿ç”¨sprintf()，å�¦å‰‡å¿…須使用
   scnprintf()。                                     scnprintf()。
                                                    
 - store() 應返回緩��的已用字節數     - store() 應返回緩��的已用字節數。如果整個緩存都已填滿，�需返回
   count �數。                                    count �數。
                                                    
 - show() 或 store() å�¯ä»¥è¿”å›žéŒ¯èª¤å€¼ã€‚ç     - show() 或 store() å�¯ä»¥è¿”回錯誤值。當得到一個é�žæ³•å€¼ï¼Œå¿…須返回一個
   錯誤值。                                       錯誤值。
                                                    
 - 一個傳�給方法的�象將會通� s     - 一個傳�給方法的�象將會通� sysfs 調用�象內嵌的引用計數固定在
   內存中。儘管如此，å°�è±¡ä»£è¡¨çš„ç‰       內存中。儘管如此，å°�象代表的物ç�†å¯¦é«”(如設備)å�¯èƒ½å·²ä¸�存在。如有必è¦�，
   應該實�一個檢測機制。                  應該實�一個檢測機制。
                                                    
 一個簡單的(未經實驗證實的)è¨­å‚™å±     一個簡單的(未經實驗證實的)設備屬性實ç�¾å¦‚下：
                                                    
 static ssize_t show_name(struct device *dev, s     static ssize_t show_name(struct device *dev, struct device_attribute *attr,
                          char *buf)                                         char *buf)
 {                                                  {
         return scnprintf(buf, PAGE_SIZE, "%s\n             return scnprintf(buf, PAGE_SIZE, "%s\n", dev->name);
 }                                                  }
                                                    
 static ssize_t store_name(struct device *dev,      static ssize_t store_name(struct device *dev, struct device_attribute *attr,
                           const char *buf, siz                               const char *buf, size_t count)
 {                                                  {
         snprintf(dev->name, sizeof(dev->name),             snprintf(dev->name, sizeof(dev->name), "%.*s",
                  (int)min(count, sizeof(dev->n                      (int)min(count, sizeof(dev->name) - 1), buf);
         return count;                                      return count;
 }                                                  }
                                                    
 static DEVICE_ATTR(name, S_IRUGO, show_name, s     static DEVICE_ATTR(name, S_IRUGO, show_name, store_name);
                                                    
                                                    
 （注æ„�：真正的實ç�¾ä¸�å…�è¨±ç”¨æˆ¶ç©ºé     （注æ„�：真正的實ç�¾ä¸�å…�許用戶空間設置設備å��。）
                                                    
 頂層目錄佈局                                 頂層目錄佈局
 ~~~~~~~~~~~~                                       ~~~~~~~~~~~~
                                                    
 sysfs 目錄的安排顯示了內核數據çµ�æ     sysfs 目錄的安排顯示了內核數據çµ�構之間的關係。
                                                    
 頂層 sysfs 目錄如下:                         頂層 sysfs 目錄如下:
                                                    
 block/                                             block/
 bus/                                               bus/
 class/                                             class/
 dev/                                               dev/
 devices/                                           devices/
 firmware/                                          firmware/
 net/                                               net/
 fs/                                                fs/
                                                    
 devices/ 包å�«äº†ä¸€å€‹è¨­å‚™æ¨¹çš„æ–‡ä»¶ç³»ç     devices/ 包å�«äº†ä¸€å€‹è¨­å‚™æ¨¹çš„文件系統表示。他直接映射了內部的內核
 設備樹，�映了設備的層次�構。      設備樹，�映了設備的層次�構。
                                                    
 bus/ 包å�«äº†å…§æ ¸ä¸­å�„ç¨®ç¸½ç·šé¡žåž‹çš„å¹     bus/ 包å�«äº†å…§æ ¸ä¸­å�„種總線類型的平é�¢ç›®éŒ„佈局。æ¯�個總線目錄包å�«å…©å€‹
 �目錄:                                         �目錄:
                                                    
         devices/                                           devices/
         drivers/                                           drivers/
                                                    
 devices/ 包å�«äº†ç³»çµ±ä¸­å‡ºç�¾çš„æ¯�å€‹è¨­å     devices/ 包å�«äº†ç³»çµ±ä¸­å‡ºç�¾çš„æ¯�個設備的符號é�ˆæŽ¥ï¼Œä»–們指å�‘ root/ 下的
 設備目錄。                                    設備目錄。
                                                    
 drivers/ 包å�«äº†æ¯�å€‹å·²çˆ²ç‰¹å®šç¸½ç·šä¸Šç     drivers/ 包å�«äº†æ¯�個已爲特定總線上的設備而掛載的驅動程åº�的目錄(這è£�
 �定驅動沒有跨越多個總線類型)。     �定驅動沒有跨越多個總線類型)。
                                                    
 fs/ 包�了一個爲文件系統設立的目     fs/ 包�了一個爲文件系統設立的目錄。�在�個想�導出屬性的文件系統必須
 在 fs/ 下創建自己的層次�構(�見D     在 fs/ 下創建自己的層次�構(�見Documentation/filesystems/fuse.rst)。
                                                    
 dev/ 包�兩個�目錄： char/ 和 block/     dev/ 包�兩個�目錄： char/ 和 block/。在這兩個�目錄中，有以
 <major>:<minor> 格�命�的符號�接。     <major>:<minor> 格�命�的符號�接。這些符號�接指� sysfs 目錄
 中相應的設備。/sys/dev æ��ä¾›ä¸€å€‹é€šé     中相應的設備。/sys/dev æ��供一個通é�Žä¸€å€‹ stat(2) æ“�作çµ�果，查找
 設備 sysfs 接�快�的方法。              設備 sysfs 接�快�的方法。
                                                    
 更多有關 driver-model 的特性信æ�¯å�¯ä»     更多有關 driver-model 的特性信æ�¯å�¯ä»¥åœ¨ Documentation/driver-api/driver-model/
 中找到。                                       中找到。
                                                    
                                                    
 TODO: 完�這一節。                           TODO: 完�這一節。
                                                    
                                                    
 當�接�                                       當�接�
 ~~~~~~~~                                           ~~~~~~~~
                                                    
 以下的接�層普�存在於當�的sysf     以下的接�層普�存在於當�的sysfs中:
                                                    
 - 設備 (include/linux/device.h)                  - 設備 (include/linux/device.h)
 ----------------------------------                 ----------------------------------
 �構體:                                         �構體:
                                                    
 struct device_attribute {                          struct device_attribute {
         struct attribute        attr;                      struct attribute        attr;
         ssize_t (*show)(struct device *dev, st             ssize_t (*show)(struct device *dev, struct device_attribute *attr,
                         char *buf);                                        char *buf);
         ssize_t (*store)(struct device *dev, s             ssize_t (*store)(struct device *dev, struct device_attribute *attr,
                          const char *buf, size                              const char *buf, size_t count);
 };                                                 };
                                                    
 �明:                                            �明:
                                                    
 DEVICE_ATTR(_name, _mode, _show, _store);          DEVICE_ATTR(_name, _mode, _show, _store);
                                                    
 增/刪屬性:                                     增/刪屬性:
                                                    
 int device_create_file(struct device *dev, con     int device_create_file(struct device *dev, const struct device_attribute * attr);
 void device_remove_file(struct device *dev, co     void device_remove_file(struct device *dev, const struct device_attribute * attr);
                                                    
                                                    
 - 總線驅動程� (include/linux/device.h)      - 總線驅動程� (include/linux/device.h)
 --------------------------------------             --------------------------------------
 �構體:                                         �構體:
                                                    
 struct bus_attribute {                             struct bus_attribute {
         struct attribute        attr;                      struct attribute        attr;
         ssize_t (*show)(const struct bus_type              ssize_t (*show)(const struct bus_type *, char * buf);
         ssize_t (*store)(const struct bus_type             ssize_t (*store)(const struct bus_type *, const char * buf, size_t count);
 };                                                 };
                                                    
 �明:                                            �明:
                                                    
 BUS_ATTR(_name, _mode, _show, _store)              BUS_ATTR(_name, _mode, _show, _store)
                                                    
 增/刪屬性:                                     增/刪屬性:
                                                    
 int bus_create_file(struct bus_type *, struct      int bus_create_file(struct bus_type *, struct bus_attribute *);
 void bus_remove_file(struct bus_type *, struct     void bus_remove_file(struct bus_type *, struct bus_attribute *);
                                                    
                                                    
 - 設備驅動程� (include/linux/device.h)      - 設備驅動程� (include/linux/device.h)
 -----------------------------------------          -----------------------------------------
                                                    
 �構體:                                         �構體:
                                                    
 struct driver_attribute {                          struct driver_attribute {
         struct attribute        attr;                      struct attribute        attr;
         ssize_t (*show)(struct device_driver *             ssize_t (*show)(struct device_driver *, char * buf);
         ssize_t (*store)(struct device_driver              ssize_t (*store)(struct device_driver *, const char * buf,
                          size_t count);                                     size_t count);
 };                                                 };
                                                    
 �明:                                            �明:
                                                    
 DRIVER_ATTR(_name, _mode, _show, _store)           DRIVER_ATTR(_name, _mode, _show, _store)
                                                    
 增/刪屬性：                                   增/刪屬性：
                                                    
 int driver_create_file(struct device_driver *,     int driver_create_file(struct device_driver *, const struct driver_attribute *);
 void driver_remove_file(struct device_driver *     void driver_remove_file(struct device_driver *, const struct driver_attribute *);
                                                    
                                                    
 文檔                                             文檔
 ~~~~                                               ~~~~
                                                    
 sysfs 目錄çµ�構以å�Šå…¶ä¸­åŒ…å�«çš„å±¬æ€§å     sysfs 目錄çµ�構以å�Šå…¶ä¸­åŒ…å�«çš„屬性定義了一個內核與用戶空間之間的 ABI。
 �於任何 ABI，其自身的穩定和�當     �於任何 ABI，其自身的穩定和�當的文檔是�常��的。所有新的 sysfs
 屬性必須在 Documentation/ABI 中有文檔     屬性必須在 Documentation/ABI 中有文檔。詳見 Documentation/ABI/README。
                                                    
                                                      

Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.