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
;
49 struct dentry
*debugfs_create_file(const char *name
, umode_t mode
,
50 struct dentry
*parent
, void *data
,
51 const struct file_operations
*fops
);
53 struct dentry
*debugfs_create_file_size(const char *name
, umode_t mode
,
54 struct dentry
*parent
, void *data
,
55 const struct file_operations
*fops
,
58 struct dentry
*debugfs_create_dir(const char *name
, struct dentry
*parent
);
60 struct dentry
*debugfs_create_symlink(const char *name
, struct dentry
*parent
,
63 struct dentry
*debugfs_create_automount(const char *name
,
64 struct dentry
*parent
,
65 struct vfsmount
*(*f
)(void *),
68 void debugfs_remove(struct dentry
*dentry
);
69 void debugfs_remove_recursive(struct dentry
*dentry
);
71 struct dentry
*debugfs_rename(struct dentry
*old_dir
, struct dentry
*old_dentry
,
72 struct dentry
*new_dir
, const char *new_name
);
74 struct dentry
*debugfs_create_u8(const char *name
, umode_t mode
,
75 struct dentry
*parent
, u8
*value
);
76 struct dentry
*debugfs_create_u16(const char *name
, umode_t mode
,
77 struct dentry
*parent
, u16
*value
);
78 struct dentry
*debugfs_create_u32(const char *name
, umode_t mode
,
79 struct dentry
*parent
, u32
*value
);
80 struct dentry
*debugfs_create_u64(const char *name
, umode_t mode
,
81 struct dentry
*parent
, u64
*value
);
82 struct dentry
*debugfs_create_x8(const char *name
, umode_t mode
,
83 struct dentry
*parent
, u8
*value
);
84 struct dentry
*debugfs_create_x16(const char *name
, umode_t mode
,
85 struct dentry
*parent
, u16
*value
);
86 struct dentry
*debugfs_create_x32(const char *name
, umode_t mode
,
87 struct dentry
*parent
, u32
*value
);
88 struct dentry
*debugfs_create_x64(const char *name
, umode_t mode
,
89 struct dentry
*parent
, u64
*value
);
90 struct dentry
*debugfs_create_size_t(const char *name
, umode_t mode
,
91 struct dentry
*parent
, size_t *value
);
92 struct dentry
*debugfs_create_atomic_t(const char *name
, umode_t mode
,
93 struct dentry
*parent
, atomic_t
*value
);
94 struct dentry
*debugfs_create_bool(const char *name
, umode_t mode
,
95 struct dentry
*parent
, u32
*value
);
97 struct dentry
*debugfs_create_blob(const char *name
, umode_t mode
,
98 struct dentry
*parent
,
99 struct debugfs_blob_wrapper
*blob
);
101 struct dentry
*debugfs_create_regset32(const char *name
, umode_t mode
,
102 struct dentry
*parent
,
103 struct debugfs_regset32
*regset
);
105 void debugfs_print_regs32(struct seq_file
*s
, const struct debugfs_reg32
*regs
,
106 int nregs
, void __iomem
*base
, char *prefix
);
108 struct dentry
*debugfs_create_u32_array(const char *name
, umode_t mode
,
109 struct dentry
*parent
,
110 u32
*array
, u32 elements
);
112 struct dentry
*debugfs_create_devm_seqfile(struct device
*dev
, const char *name
,
113 struct dentry
*parent
,
114 int (*read_fn
)(struct seq_file
*s
,
117 bool debugfs_initialized(void);
121 #include <linux/err.h>
124 * We do not return NULL from these functions if CONFIG_DEBUG_FS is not enabled
125 * so users have a chance to detect if there was a real error or not. We don't
126 * want to duplicate the design decision mistakes of procfs and devfs again.
129 static inline struct dentry
*debugfs_create_file(const char *name
, umode_t mode
,
130 struct dentry
*parent
, void *data
,
131 const struct file_operations
*fops
)
133 return ERR_PTR(-ENODEV
);
136 static inline struct dentry
*debugfs_create_file_size(const char *name
, umode_t mode
,
137 struct dentry
*parent
, void *data
,
138 const struct file_operations
*fops
,
141 return ERR_PTR(-ENODEV
);
144 static inline struct dentry
*debugfs_create_dir(const char *name
,
145 struct dentry
*parent
)
147 return ERR_PTR(-ENODEV
);
150 static inline struct dentry
*debugfs_create_symlink(const char *name
,
151 struct dentry
*parent
,
154 return ERR_PTR(-ENODEV
);
157 static inline void debugfs_remove(struct dentry
*dentry
)
160 static inline void debugfs_remove_recursive(struct dentry
*dentry
)
163 static inline struct dentry
*debugfs_rename(struct dentry
*old_dir
, struct dentry
*old_dentry
,
164 struct dentry
*new_dir
, char *new_name
)
166 return ERR_PTR(-ENODEV
);
169 static inline struct dentry
*debugfs_create_u8(const char *name
, umode_t mode
,
170 struct dentry
*parent
,
173 return ERR_PTR(-ENODEV
);
176 static inline struct dentry
*debugfs_create_u16(const char *name
, umode_t mode
,
177 struct dentry
*parent
,
180 return ERR_PTR(-ENODEV
);
183 static inline struct dentry
*debugfs_create_u32(const char *name
, umode_t mode
,
184 struct dentry
*parent
,
187 return ERR_PTR(-ENODEV
);
190 static inline struct dentry
*debugfs_create_u64(const char *name
, umode_t mode
,
191 struct dentry
*parent
,
194 return ERR_PTR(-ENODEV
);
197 static inline struct dentry
*debugfs_create_x8(const char *name
, umode_t mode
,
198 struct dentry
*parent
,
201 return ERR_PTR(-ENODEV
);
204 static inline struct dentry
*debugfs_create_x16(const char *name
, umode_t mode
,
205 struct dentry
*parent
,
208 return ERR_PTR(-ENODEV
);
211 static inline struct dentry
*debugfs_create_x32(const char *name
, umode_t mode
,
212 struct dentry
*parent
,
215 return ERR_PTR(-ENODEV
);
218 static inline struct dentry
*debugfs_create_x64(const char *name
, umode_t mode
,
219 struct dentry
*parent
,
222 return ERR_PTR(-ENODEV
);
225 static inline struct dentry
*debugfs_create_size_t(const char *name
, umode_t mode
,
226 struct dentry
*parent
,
229 return ERR_PTR(-ENODEV
);
232 static inline struct dentry
*debugfs_create_atomic_t(const char *name
, umode_t mode
,
233 struct dentry
*parent
, atomic_t
*value
)
235 return ERR_PTR(-ENODEV
);
238 static inline struct dentry
*debugfs_create_bool(const char *name
, umode_t mode
,
239 struct dentry
*parent
,
242 return ERR_PTR(-ENODEV
);
245 static inline struct dentry
*debugfs_create_blob(const char *name
, umode_t mode
,
246 struct dentry
*parent
,
247 struct debugfs_blob_wrapper
*blob
)
249 return ERR_PTR(-ENODEV
);
252 static inline struct dentry
*debugfs_create_regset32(const char *name
,
253 umode_t mode
, struct dentry
*parent
,
254 struct debugfs_regset32
*regset
)
256 return ERR_PTR(-ENODEV
);
259 static inline void debugfs_print_regs32(struct seq_file
*s
, const struct debugfs_reg32
*regs
,
260 int nregs
, void __iomem
*base
, char *prefix
)
264 static inline bool debugfs_initialized(void)
269 static inline struct dentry
*debugfs_create_u32_array(const char *name
, umode_t mode
,
270 struct dentry
*parent
,
271 u32
*array
, u32 elements
)
273 return ERR_PTR(-ENODEV
);
276 static inline struct dentry
*debugfs_create_devm_seqfile(struct device
*dev
,
278 struct dentry
*parent
,
279 int (*read_fn
)(struct seq_file
*s
,
282 return ERR_PTR(-ENODEV
);