2 * debugfs.h - a tiny little debug file system
4 * Copyright (C) 2004 Greg Kroah-Hartman <greg@kroah.com>
5 * Copyright (C) 2004 IBM Inc.
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.
11 * debugfs is for people to use instead of /proc or /sys.
12 * See Documentation/DocBook/filesystems for more details.
19 #include <linux/seq_file.h>
21 #include <linux/types.h>
24 struct file_operations
;
26 struct debugfs_blob_wrapper
{
31 struct debugfs_reg32
{
36 struct debugfs_regset32
{
37 const struct debugfs_reg32
*regs
;
42 extern struct dentry
*arch_debugfs_dir
;
44 #if defined(CONFIG_DEBUG_FS)
46 /* declared over in file.c */
47 extern const struct file_operations debugfs_file_operations
;
48 extern const struct inode_operations debugfs_link_operations
;
50 struct dentry
*debugfs_create_file(const char *name
, umode_t mode
,
51 struct dentry
*parent
, void *data
,
52 const struct file_operations
*fops
);
54 struct dentry
*debugfs_create_file_size(const char *name
, umode_t mode
,
55 struct dentry
*parent
, void *data
,
56 const struct file_operations
*fops
,
59 struct dentry
*debugfs_create_dir(const char *name
, struct dentry
*parent
);
61 struct dentry
*debugfs_create_symlink(const char *name
, struct dentry
*parent
,
64 struct dentry
*debugfs_create_automount(const char *name
,
65 struct dentry
*parent
,
66 struct vfsmount
*(*f
)(void *),
69 void debugfs_remove(struct dentry
*dentry
);
70 void debugfs_remove_recursive(struct dentry
*dentry
);
72 struct dentry
*debugfs_rename(struct dentry
*old_dir
, struct dentry
*old_dentry
,
73 struct dentry
*new_dir
, const char *new_name
);
75 struct dentry
*debugfs_create_u8(const char *name
, umode_t mode
,
76 struct dentry
*parent
, u8
*value
);
77 struct dentry
*debugfs_create_u16(const char *name
, umode_t mode
,
78 struct dentry
*parent
, u16
*value
);
79 struct dentry
*debugfs_create_u32(const char *name
, umode_t mode
,
80 struct dentry
*parent
, u32
*value
);
81 struct dentry
*debugfs_create_u64(const char *name
, umode_t mode
,
82 struct dentry
*parent
, u64
*value
);
83 struct dentry
*debugfs_create_x8(const char *name
, umode_t mode
,
84 struct dentry
*parent
, u8
*value
);
85 struct dentry
*debugfs_create_x16(const char *name
, umode_t mode
,
86 struct dentry
*parent
, u16
*value
);
87 struct dentry
*debugfs_create_x32(const char *name
, umode_t mode
,
88 struct dentry
*parent
, u32
*value
);
89 struct dentry
*debugfs_create_x64(const char *name
, umode_t mode
,
90 struct dentry
*parent
, u64
*value
);
91 struct dentry
*debugfs_create_size_t(const char *name
, umode_t mode
,
92 struct dentry
*parent
, size_t *value
);
93 struct dentry
*debugfs_create_atomic_t(const char *name
, umode_t mode
,
94 struct dentry
*parent
, atomic_t
*value
);
95 struct dentry
*debugfs_create_bool(const char *name
, umode_t mode
,
96 struct dentry
*parent
, u32
*value
);
98 struct dentry
*debugfs_create_blob(const char *name
, umode_t mode
,
99 struct dentry
*parent
,
100 struct debugfs_blob_wrapper
*blob
);
102 struct dentry
*debugfs_create_regset32(const char *name
, umode_t mode
,
103 struct dentry
*parent
,
104 struct debugfs_regset32
*regset
);
106 void debugfs_print_regs32(struct seq_file
*s
, const struct debugfs_reg32
*regs
,
107 int nregs
, void __iomem
*base
, char *prefix
);
109 struct dentry
*debugfs_create_u32_array(const char *name
, umode_t mode
,
110 struct dentry
*parent
,
111 u32
*array
, u32 elements
);
113 struct dentry
*debugfs_create_devm_seqfile(struct device
*dev
, const char *name
,
114 struct dentry
*parent
,
115 int (*read_fn
)(struct seq_file
*s
,
118 bool debugfs_initialized(void);
122 #include <linux/err.h>
125 * We do not return NULL from these functions if CONFIG_DEBUG_FS is not enabled
126 * so users have a chance to detect if there was a real error or not. We don't
127 * want to duplicate the design decision mistakes of procfs and devfs again.
130 static inline struct dentry
*debugfs_create_file(const char *name
, umode_t mode
,
131 struct dentry
*parent
, void *data
,
132 const struct file_operations
*fops
)
134 return ERR_PTR(-ENODEV
);
137 static inline struct dentry
*debugfs_create_file_size(const char *name
, umode_t mode
,
138 struct dentry
*parent
, void *data
,
139 const struct file_operations
*fops
,
142 return ERR_PTR(-ENODEV
);
145 static inline struct dentry
*debugfs_create_dir(const char *name
,
146 struct dentry
*parent
)
148 return ERR_PTR(-ENODEV
);
151 static inline struct dentry
*debugfs_create_symlink(const char *name
,
152 struct dentry
*parent
,
155 return ERR_PTR(-ENODEV
);
158 static inline void debugfs_remove(struct dentry
*dentry
)
161 static inline void debugfs_remove_recursive(struct dentry
*dentry
)
164 static inline struct dentry
*debugfs_rename(struct dentry
*old_dir
, struct dentry
*old_dentry
,
165 struct dentry
*new_dir
, char *new_name
)
167 return ERR_PTR(-ENODEV
);
170 static inline struct dentry
*debugfs_create_u8(const char *name
, umode_t mode
,
171 struct dentry
*parent
,
174 return ERR_PTR(-ENODEV
);
177 static inline struct dentry
*debugfs_create_u16(const char *name
, umode_t mode
,
178 struct dentry
*parent
,
181 return ERR_PTR(-ENODEV
);
184 static inline struct dentry
*debugfs_create_u32(const char *name
, umode_t mode
,
185 struct dentry
*parent
,
188 return ERR_PTR(-ENODEV
);
191 static inline struct dentry
*debugfs_create_u64(const char *name
, umode_t mode
,
192 struct dentry
*parent
,
195 return ERR_PTR(-ENODEV
);
198 static inline struct dentry
*debugfs_create_x8(const char *name
, umode_t mode
,
199 struct dentry
*parent
,
202 return ERR_PTR(-ENODEV
);
205 static inline struct dentry
*debugfs_create_x16(const char *name
, umode_t mode
,
206 struct dentry
*parent
,
209 return ERR_PTR(-ENODEV
);
212 static inline struct dentry
*debugfs_create_x32(const char *name
, umode_t mode
,
213 struct dentry
*parent
,
216 return ERR_PTR(-ENODEV
);
219 static inline struct dentry
*debugfs_create_x64(const char *name
, umode_t mode
,
220 struct dentry
*parent
,
223 return ERR_PTR(-ENODEV
);
226 static inline struct dentry
*debugfs_create_size_t(const char *name
, umode_t mode
,
227 struct dentry
*parent
,
230 return ERR_PTR(-ENODEV
);
233 static inline struct dentry
*debugfs_create_atomic_t(const char *name
, umode_t mode
,
234 struct dentry
*parent
, atomic_t
*value
)
236 return ERR_PTR(-ENODEV
);
239 static inline struct dentry
*debugfs_create_bool(const char *name
, umode_t mode
,
240 struct dentry
*parent
,
243 return ERR_PTR(-ENODEV
);
246 static inline struct dentry
*debugfs_create_blob(const char *name
, umode_t mode
,
247 struct dentry
*parent
,
248 struct debugfs_blob_wrapper
*blob
)
250 return ERR_PTR(-ENODEV
);
253 static inline struct dentry
*debugfs_create_regset32(const char *name
,
254 umode_t mode
, struct dentry
*parent
,
255 struct debugfs_regset32
*regset
)
257 return ERR_PTR(-ENODEV
);
260 static inline void debugfs_print_regs32(struct seq_file
*s
, const struct debugfs_reg32
*regs
,
261 int nregs
, void __iomem
*base
, char *prefix
)
265 static inline bool debugfs_initialized(void)
270 static inline struct dentry
*debugfs_create_u32_array(const char *name
, umode_t mode
,
271 struct dentry
*parent
,
272 u32
*array
, u32 elements
)
274 return ERR_PTR(-ENODEV
);
277 static inline struct dentry
*debugfs_create_devm_seqfile(struct device
*dev
,
279 struct dentry
*parent
,
280 int (*read_fn
)(struct seq_file
*s
,
283 return ERR_PTR(-ENODEV
);