| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 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/kernel-api for more details. | 
 | 13 |  */ | 
 | 14 |  | 
 | 15 | #ifndef _DEBUGFS_H_ | 
 | 16 | #define _DEBUGFS_H_ | 
 | 17 |  | 
 | 18 | #include <linux/fs.h> | 
 | 19 |  | 
| Roland Dreier | a7a76ce | 2005-04-18 21:57:33 -0700 | [diff] [blame] | 20 | #include <linux/types.h> | 
 | 21 |  | 
 | 22 | struct file_operations; | 
 | 23 |  | 
| Michael Ellerman | dd308bc | 2006-03-07 21:41:59 +1100 | [diff] [blame] | 24 | struct debugfs_blob_wrapper { | 
 | 25 | 	void *data; | 
 | 26 | 	unsigned long size; | 
 | 27 | }; | 
 | 28 |  | 
| venkatesh.pallipadi@intel.com | ae79cda | 2008-07-18 16:08:13 -0700 | [diff] [blame] | 29 | extern struct dentry *arch_debugfs_dir; | 
 | 30 |  | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 31 | #if defined(CONFIG_DEBUG_FS) | 
| Harvey Harrison | 3634634 | 2008-02-13 17:08:16 -0800 | [diff] [blame] | 32 |  | 
 | 33 | /* declared over in file.c */ | 
 | 34 | extern const struct file_operations debugfs_file_operations; | 
 | 35 | extern const struct inode_operations debugfs_link_operations; | 
 | 36 |  | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 37 | struct dentry *debugfs_create_file(const char *name, mode_t mode, | 
 | 38 | 				   struct dentry *parent, void *data, | 
| Arjan van de Ven | 99ac48f | 2006-03-28 01:56:41 -0800 | [diff] [blame] | 39 | 				   const struct file_operations *fops); | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 40 |  | 
 | 41 | struct dentry *debugfs_create_dir(const char *name, struct dentry *parent); | 
 | 42 |  | 
| Peter Oberparleiter | 66f5496 | 2007-02-13 12:13:54 +0100 | [diff] [blame] | 43 | struct dentry *debugfs_create_symlink(const char *name, struct dentry *parent, | 
 | 44 | 				      const char *dest); | 
 | 45 |  | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 46 | void debugfs_remove(struct dentry *dentry); | 
| Haavard Skinnemoen | 9505e63 | 2008-07-01 15:14:51 +0200 | [diff] [blame] | 47 | void debugfs_remove_recursive(struct dentry *dentry); | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 48 |  | 
| Jan Kara | cfc94cd | 2007-05-09 13:19:52 +0200 | [diff] [blame] | 49 | struct dentry *debugfs_rename(struct dentry *old_dir, struct dentry *old_dentry, | 
 | 50 |                 struct dentry *new_dir, const char *new_name); | 
 | 51 |  | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 52 | struct dentry *debugfs_create_u8(const char *name, mode_t mode, | 
 | 53 | 				 struct dentry *parent, u8 *value); | 
 | 54 | struct dentry *debugfs_create_u16(const char *name, mode_t mode, | 
 | 55 | 				  struct dentry *parent, u16 *value); | 
 | 56 | struct dentry *debugfs_create_u32(const char *name, mode_t mode, | 
 | 57 | 				  struct dentry *parent, u32 *value); | 
| Michael Ellerman | 8447891 | 2007-04-17 15:59:36 +1000 | [diff] [blame] | 58 | struct dentry *debugfs_create_u64(const char *name, mode_t mode, | 
 | 59 | 				  struct dentry *parent, u64 *value); | 
| Robin Getz | 2ebefc5 | 2007-08-02 18:23:50 -0400 | [diff] [blame] | 60 | struct dentry *debugfs_create_x8(const char *name, mode_t mode, | 
 | 61 | 				 struct dentry *parent, u8 *value); | 
 | 62 | struct dentry *debugfs_create_x16(const char *name, mode_t mode, | 
 | 63 | 				  struct dentry *parent, u16 *value); | 
 | 64 | struct dentry *debugfs_create_x32(const char *name, mode_t mode, | 
 | 65 | 				  struct dentry *parent, u32 *value); | 
| Inaky Perez-Gonzalez | 5e07878 | 2008-12-20 16:57:39 -0800 | [diff] [blame] | 66 | struct dentry *debugfs_create_size_t(const char *name, mode_t mode, | 
 | 67 | 				     struct dentry *parent, size_t *value); | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 68 | struct dentry *debugfs_create_bool(const char *name, mode_t mode, | 
 | 69 | 				  struct dentry *parent, u32 *value); | 
 | 70 |  | 
| Michael Ellerman | dd308bc | 2006-03-07 21:41:59 +1100 | [diff] [blame] | 71 | struct dentry *debugfs_create_blob(const char *name, mode_t mode, | 
 | 72 | 				  struct dentry *parent, | 
 | 73 | 				  struct debugfs_blob_wrapper *blob); | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 74 | #else | 
| Roland Dreier | a7a76ce | 2005-04-18 21:57:33 -0700 | [diff] [blame] | 75 |  | 
 | 76 | #include <linux/err.h> | 
 | 77 |  | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 78 | /*  | 
 | 79 |  * We do not return NULL from these functions if CONFIG_DEBUG_FS is not enabled | 
 | 80 |  * so users have a chance to detect if there was a real error or not.  We don't | 
 | 81 |  * want to duplicate the design decision mistakes of procfs and devfs again. | 
 | 82 |  */ | 
 | 83 |  | 
 | 84 | static inline struct dentry *debugfs_create_file(const char *name, mode_t mode, | 
| Jean Delvare | bde11d7 | 2006-04-18 21:30:22 -0700 | [diff] [blame] | 85 | 					struct dentry *parent, void *data, | 
 | 86 | 					const struct file_operations *fops) | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 87 | { | 
 | 88 | 	return ERR_PTR(-ENODEV); | 
 | 89 | } | 
 | 90 |  | 
 | 91 | static inline struct dentry *debugfs_create_dir(const char *name, | 
 | 92 | 						struct dentry *parent) | 
 | 93 | { | 
 | 94 | 	return ERR_PTR(-ENODEV); | 
 | 95 | } | 
 | 96 |  | 
| Peter Oberparleiter | 66f5496 | 2007-02-13 12:13:54 +0100 | [diff] [blame] | 97 | static inline struct dentry *debugfs_create_symlink(const char *name, | 
 | 98 | 						    struct dentry *parent, | 
 | 99 | 						    const char *dest) | 
 | 100 | { | 
 | 101 | 	return ERR_PTR(-ENODEV); | 
 | 102 | } | 
 | 103 |  | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 104 | static inline void debugfs_remove(struct dentry *dentry) | 
 | 105 | { } | 
 | 106 |  | 
| Haavard Skinnemoen | 9505e63 | 2008-07-01 15:14:51 +0200 | [diff] [blame] | 107 | static inline void debugfs_remove_recursive(struct dentry *dentry) | 
 | 108 | { } | 
 | 109 |  | 
| Jan Kara | cfc94cd | 2007-05-09 13:19:52 +0200 | [diff] [blame] | 110 | static inline struct dentry *debugfs_rename(struct dentry *old_dir, struct dentry *old_dentry, | 
 | 111 |                 struct dentry *new_dir, char *new_name) | 
 | 112 | { | 
 | 113 | 	return ERR_PTR(-ENODEV); | 
 | 114 | } | 
 | 115 |  | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 116 | static inline struct dentry *debugfs_create_u8(const char *name, mode_t mode, | 
 | 117 | 					       struct dentry *parent, | 
 | 118 | 					       u8 *value) | 
 | 119 | { | 
 | 120 | 	return ERR_PTR(-ENODEV); | 
 | 121 | } | 
 | 122 |  | 
 | 123 | static inline struct dentry *debugfs_create_u16(const char *name, mode_t mode, | 
 | 124 | 						struct dentry *parent, | 
| Michal Ostrowski | 7b55863 | 2005-04-18 21:57:34 -0700 | [diff] [blame] | 125 | 						u16 *value) | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 126 | { | 
 | 127 | 	return ERR_PTR(-ENODEV); | 
 | 128 | } | 
 | 129 |  | 
 | 130 | static inline struct dentry *debugfs_create_u32(const char *name, mode_t mode, | 
 | 131 | 						struct dentry *parent, | 
| Michal Ostrowski | 7b55863 | 2005-04-18 21:57:34 -0700 | [diff] [blame] | 132 | 						u32 *value) | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 133 | { | 
 | 134 | 	return ERR_PTR(-ENODEV); | 
 | 135 | } | 
 | 136 |  | 
| Michael Ellerman | 8447891 | 2007-04-17 15:59:36 +1000 | [diff] [blame] | 137 | static inline struct dentry *debugfs_create_u64(const char *name, mode_t mode, | 
 | 138 | 						struct dentry *parent, | 
 | 139 | 						u64 *value) | 
 | 140 | { | 
 | 141 | 	return ERR_PTR(-ENODEV); | 
 | 142 | } | 
 | 143 |  | 
| Robin Getz | 2ebefc5 | 2007-08-02 18:23:50 -0400 | [diff] [blame] | 144 | static inline struct dentry *debugfs_create_x8(const char *name, mode_t mode, | 
 | 145 | 					       struct dentry *parent, | 
 | 146 | 					       u8 *value) | 
 | 147 | { | 
 | 148 | 	return ERR_PTR(-ENODEV); | 
 | 149 | } | 
 | 150 |  | 
 | 151 | static inline struct dentry *debugfs_create_x16(const char *name, mode_t mode, | 
 | 152 | 						struct dentry *parent, | 
 | 153 | 						u16 *value) | 
 | 154 | { | 
 | 155 | 	return ERR_PTR(-ENODEV); | 
 | 156 | } | 
 | 157 |  | 
 | 158 | static inline struct dentry *debugfs_create_x32(const char *name, mode_t mode, | 
 | 159 | 						struct dentry *parent, | 
 | 160 | 						u32 *value) | 
 | 161 | { | 
 | 162 | 	return ERR_PTR(-ENODEV); | 
 | 163 | } | 
 | 164 |  | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 165 | static inline struct dentry *debugfs_create_bool(const char *name, mode_t mode, | 
 | 166 | 						 struct dentry *parent, | 
| Michal Ostrowski | 7b55863 | 2005-04-18 21:57:34 -0700 | [diff] [blame] | 167 | 						 u32 *value) | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 168 | { | 
 | 169 | 	return ERR_PTR(-ENODEV); | 
 | 170 | } | 
 | 171 |  | 
| Michael Ellerman | dd308bc | 2006-03-07 21:41:59 +1100 | [diff] [blame] | 172 | static inline struct dentry *debugfs_create_blob(const char *name, mode_t mode, | 
 | 173 | 				  struct dentry *parent, | 
 | 174 | 				  struct debugfs_blob_wrapper *blob) | 
 | 175 | { | 
 | 176 | 	return ERR_PTR(-ENODEV); | 
 | 177 | } | 
 | 178 |  | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 179 | #endif | 
 | 180 |  | 
 | 181 | #endif |