debugfs.h 6.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235
  1. /*
  2. * debugfs.h - a tiny little debug file system
  3. *
  4. * Copyright (C) 2004 Greg Kroah-Hartman <greg@kroah.com>
  5. * Copyright (C) 2004 IBM Inc.
  6. *
  7. * This program is free software; you can redistribute it and/or
  8. * modify it under the terms of the GNU General Public License version
  9. * 2 as published by the Free Software Foundation.
  10. *
  11. * debugfs is for people to use instead of /proc or /sys.
  12. * See Documentation/DocBook/filesystems for more details.
  13. */
  14. #ifndef _DEBUGFS_H_
  15. #define _DEBUGFS_H_
  16. #include <linux/fs.h>
  17. #include <linux/seq_file.h>
  18. #include <linux/types.h>
  19. struct file_operations;
  20. struct debugfs_blob_wrapper {
  21. void *data;
  22. unsigned long size;
  23. };
  24. struct debugfs_reg32 {
  25. char *name;
  26. unsigned long offset;
  27. };
  28. struct debugfs_regset32 {
  29. struct debugfs_reg32 *regs;
  30. int nregs;
  31. void __iomem *base;
  32. };
  33. extern struct dentry *arch_debugfs_dir;
  34. #if defined(CONFIG_DEBUG_FS)
  35. /* declared over in file.c */
  36. extern const struct file_operations debugfs_file_operations;
  37. extern const struct inode_operations debugfs_link_operations;
  38. struct dentry *debugfs_create_file(const char *name, umode_t mode,
  39. struct dentry *parent, void *data,
  40. const struct file_operations *fops);
  41. struct dentry *debugfs_create_dir(const char *name, struct dentry *parent);
  42. struct dentry *debugfs_create_symlink(const char *name, struct dentry *parent,
  43. const char *dest);
  44. void debugfs_remove(struct dentry *dentry);
  45. void debugfs_remove_recursive(struct dentry *dentry);
  46. struct dentry *debugfs_rename(struct dentry *old_dir, struct dentry *old_dentry,
  47. struct dentry *new_dir, const char *new_name);
  48. struct dentry *debugfs_create_u8(const char *name, umode_t mode,
  49. struct dentry *parent, u8 *value);
  50. struct dentry *debugfs_create_u16(const char *name, umode_t mode,
  51. struct dentry *parent, u16 *value);
  52. struct dentry *debugfs_create_u32(const char *name, umode_t mode,
  53. struct dentry *parent, u32 *value);
  54. struct dentry *debugfs_create_u64(const char *name, umode_t mode,
  55. struct dentry *parent, u64 *value);
  56. struct dentry *debugfs_create_x8(const char *name, umode_t mode,
  57. struct dentry *parent, u8 *value);
  58. struct dentry *debugfs_create_x16(const char *name, umode_t mode,
  59. struct dentry *parent, u16 *value);
  60. struct dentry *debugfs_create_x32(const char *name, umode_t mode,
  61. struct dentry *parent, u32 *value);
  62. struct dentry *debugfs_create_x64(const char *name, umode_t mode,
  63. struct dentry *parent, u64 *value);
  64. struct dentry *debugfs_create_size_t(const char *name, umode_t mode,
  65. struct dentry *parent, size_t *value);
  66. struct dentry *debugfs_create_bool(const char *name, umode_t mode,
  67. struct dentry *parent, u32 *value);
  68. struct dentry *debugfs_create_blob(const char *name, umode_t mode,
  69. struct dentry *parent,
  70. struct debugfs_blob_wrapper *blob);
  71. struct dentry *debugfs_create_regset32(const char *name, umode_t mode,
  72. struct dentry *parent,
  73. struct debugfs_regset32 *regset);
  74. int debugfs_print_regs32(struct seq_file *s, const struct debugfs_reg32 *regs,
  75. int nregs, void __iomem *base, char *prefix);
  76. struct dentry *debugfs_create_u32_array(const char *name, umode_t mode,
  77. struct dentry *parent,
  78. u32 *array, u32 elements);
  79. bool debugfs_initialized(void);
  80. #else
  81. #include <linux/err.h>
  82. /*
  83. * We do not return NULL from these functions if CONFIG_DEBUG_FS is not enabled
  84. * so users have a chance to detect if there was a real error or not. We don't
  85. * want to duplicate the design decision mistakes of procfs and devfs again.
  86. */
  87. static inline struct dentry *debugfs_create_file(const char *name, umode_t mode,
  88. struct dentry *parent, void *data,
  89. const struct file_operations *fops)
  90. {
  91. return ERR_PTR(-ENODEV);
  92. }
  93. static inline struct dentry *debugfs_create_dir(const char *name,
  94. struct dentry *parent)
  95. {
  96. return ERR_PTR(-ENODEV);
  97. }
  98. static inline struct dentry *debugfs_create_symlink(const char *name,
  99. struct dentry *parent,
  100. const char *dest)
  101. {
  102. return ERR_PTR(-ENODEV);
  103. }
  104. static inline void debugfs_remove(struct dentry *dentry)
  105. { }
  106. static inline void debugfs_remove_recursive(struct dentry *dentry)
  107. { }
  108. static inline struct dentry *debugfs_rename(struct dentry *old_dir, struct dentry *old_dentry,
  109. struct dentry *new_dir, char *new_name)
  110. {
  111. return ERR_PTR(-ENODEV);
  112. }
  113. static inline struct dentry *debugfs_create_u8(const char *name, umode_t mode,
  114. struct dentry *parent,
  115. u8 *value)
  116. {
  117. return ERR_PTR(-ENODEV);
  118. }
  119. static inline struct dentry *debugfs_create_u16(const char *name, umode_t mode,
  120. struct dentry *parent,
  121. u16 *value)
  122. {
  123. return ERR_PTR(-ENODEV);
  124. }
  125. static inline struct dentry *debugfs_create_u32(const char *name, umode_t mode,
  126. struct dentry *parent,
  127. u32 *value)
  128. {
  129. return ERR_PTR(-ENODEV);
  130. }
  131. static inline struct dentry *debugfs_create_u64(const char *name, umode_t mode,
  132. struct dentry *parent,
  133. u64 *value)
  134. {
  135. return ERR_PTR(-ENODEV);
  136. }
  137. static inline struct dentry *debugfs_create_x8(const char *name, umode_t mode,
  138. struct dentry *parent,
  139. u8 *value)
  140. {
  141. return ERR_PTR(-ENODEV);
  142. }
  143. static inline struct dentry *debugfs_create_x16(const char *name, umode_t mode,
  144. struct dentry *parent,
  145. u16 *value)
  146. {
  147. return ERR_PTR(-ENODEV);
  148. }
  149. static inline struct dentry *debugfs_create_x32(const char *name, umode_t mode,
  150. struct dentry *parent,
  151. u32 *value)
  152. {
  153. return ERR_PTR(-ENODEV);
  154. }
  155. static inline struct dentry *debugfs_create_size_t(const char *name, umode_t mode,
  156. struct dentry *parent,
  157. size_t *value)
  158. {
  159. return ERR_PTR(-ENODEV);
  160. }
  161. static inline struct dentry *debugfs_create_bool(const char *name, umode_t mode,
  162. struct dentry *parent,
  163. u32 *value)
  164. {
  165. return ERR_PTR(-ENODEV);
  166. }
  167. static inline struct dentry *debugfs_create_blob(const char *name, umode_t mode,
  168. struct dentry *parent,
  169. struct debugfs_blob_wrapper *blob)
  170. {
  171. return ERR_PTR(-ENODEV);
  172. }
  173. static inline struct dentry *debugfs_create_regset32(const char *name,
  174. umode_t mode, struct dentry *parent,
  175. struct debugfs_regset32 *regset)
  176. {
  177. return ERR_PTR(-ENODEV);
  178. }
  179. static inline bool debugfs_initialized(void)
  180. {
  181. return false;
  182. }
  183. static inline struct dentry *debugfs_create_u32_array(const char *name, umode_t mode,
  184. struct dentry *parent,
  185. u32 *array, u32 elements)
  186. {
  187. return ERR_PTR(-ENODEV);
  188. }
  189. #endif
  190. #endif