Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 1 | #ifndef _LINUX_PROC_FS_H |
| 2 | #define _LINUX_PROC_FS_H |
| 3 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 4 | #include <linux/slab.h> |
| 5 | #include <linux/fs.h> |
Steven Rostedt | 64a07bd | 2006-03-26 01:36:55 -0800 | [diff] [blame] | 6 | #include <linux/spinlock.h> |
Jeff Garzik | e18fa70 | 2006-09-24 11:13:19 -0400 | [diff] [blame] | 7 | #include <linux/magic.h> |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 8 | #include <asm/atomic.h> |
| 9 | |
Eric W. Biederman | 457c4cb | 2007-09-12 12:01:34 +0200 | [diff] [blame] | 10 | struct net; |
Alexey Dobriyan | 786d7e1 | 2007-07-15 23:39:00 -0700 | [diff] [blame] | 11 | struct completion; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 12 | /* |
| 13 | * The proc filesystem constants/structures |
| 14 | */ |
| 15 | |
| 16 | /* |
| 17 | * Offset of the first process in the /proc root directory.. |
| 18 | */ |
| 19 | #define FIRST_PROCESS_ENTRY 256 |
| 20 | |
Matt Mackall | f248dcb | 2008-02-04 22:29:03 -0800 | [diff] [blame] | 21 | /* Worst case buffer size needed for holding an integer. */ |
| 22 | #define PROC_NUMBUF 13 |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 23 | |
| 24 | /* |
| 25 | * We always define these enumerators |
| 26 | */ |
| 27 | |
| 28 | enum { |
| 29 | PROC_ROOT_INO = 1, |
| 30 | }; |
| 31 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 32 | /* |
| 33 | * This is not completely implemented yet. The idea is to |
| 34 | * create an in-memory tree (like the actual /proc filesystem |
| 35 | * tree) of these proc_dir_entries, so that we can dynamically |
| 36 | * add new files to /proc. |
| 37 | * |
| 38 | * The "next" pointer creates a linked list of one /proc directory, |
| 39 | * while parent/subdir create the directory structure (every |
| 40 | * /proc file has a parent, but "subdir" is NULL for all |
| 41 | * non-directory entries). |
| 42 | * |
| 43 | * "get_info" is called at "read", while "owner" is used to protect module |
| 44 | * from unloading while proc_dir_entry is in use |
| 45 | */ |
| 46 | |
| 47 | typedef int (read_proc_t)(char *page, char **start, off_t off, |
| 48 | int count, int *eof, void *data); |
| 49 | typedef int (write_proc_t)(struct file *file, const char __user *buffer, |
| 50 | unsigned long count, void *data); |
| 51 | typedef int (get_info_t)(char *, char **, off_t, int); |
| 52 | |
| 53 | struct proc_dir_entry { |
| 54 | unsigned int low_ino; |
| 55 | unsigned short namelen; |
| 56 | const char *name; |
| 57 | mode_t mode; |
| 58 | nlink_t nlink; |
| 59 | uid_t uid; |
| 60 | gid_t gid; |
Maneesh Soni | 22e6c1b | 2006-03-26 01:37:29 -0800 | [diff] [blame] | 61 | loff_t size; |
Arjan van de Ven | c5ef1c4 | 2007-02-12 00:55:40 -0800 | [diff] [blame] | 62 | const struct inode_operations *proc_iops; |
Alexey Dobriyan | 786d7e1 | 2007-07-15 23:39:00 -0700 | [diff] [blame] | 63 | /* |
| 64 | * NULL ->proc_fops means "PDE is going away RSN" or |
| 65 | * "PDE is just created". In either case, e.g. ->read_proc won't be |
| 66 | * called because it's too late or too early, respectively. |
| 67 | * |
| 68 | * If you're allocating ->proc_fops dynamically, save a pointer |
| 69 | * somewhere. |
| 70 | */ |
Arjan van de Ven | c5ef1c4 | 2007-02-12 00:55:40 -0800 | [diff] [blame] | 71 | const struct file_operations *proc_fops; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 72 | get_info_t *get_info; |
| 73 | struct module *owner; |
| 74 | struct proc_dir_entry *next, *parent, *subdir; |
| 75 | void *data; |
| 76 | read_proc_t *read_proc; |
| 77 | write_proc_t *write_proc; |
| 78 | atomic_t count; /* use count */ |
Alexey Dobriyan | 786d7e1 | 2007-07-15 23:39:00 -0700 | [diff] [blame] | 79 | int pde_users; /* number of callers into module in progress */ |
| 80 | spinlock_t pde_unload_lock; /* proc_fops checks and pde_users bumps */ |
| 81 | struct completion *pde_unload_completion; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 82 | }; |
| 83 | |
| 84 | struct kcore_list { |
| 85 | struct kcore_list *next; |
| 86 | unsigned long addr; |
| 87 | size_t size; |
| 88 | }; |
| 89 | |
Vivek Goyal | 666bfdd | 2005-06-25 14:58:21 -0700 | [diff] [blame] | 90 | struct vmcore { |
| 91 | struct list_head list; |
| 92 | unsigned long long paddr; |
Vivek Goyal | 80e8ff6 | 2006-04-10 22:54:10 -0700 | [diff] [blame] | 93 | unsigned long long size; |
Vivek Goyal | 666bfdd | 2005-06-25 14:58:21 -0700 | [diff] [blame] | 94 | loff_t offset; |
| 95 | }; |
| 96 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 97 | #ifdef CONFIG_PROC_FS |
| 98 | |
| 99 | extern struct proc_dir_entry proc_root; |
| 100 | extern struct proc_dir_entry *proc_root_fs; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 101 | extern struct proc_dir_entry *proc_bus; |
| 102 | extern struct proc_dir_entry *proc_root_driver; |
| 103 | extern struct proc_dir_entry *proc_root_kcore; |
| 104 | |
Steven Rostedt | 64a07bd | 2006-03-26 01:36:55 -0800 | [diff] [blame] | 105 | extern spinlock_t proc_subdir_lock; |
| 106 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 107 | extern void proc_root_init(void); |
| 108 | extern void proc_misc_init(void); |
| 109 | |
| 110 | struct mm_struct; |
| 111 | |
Eric W. Biederman | 48e6484 | 2006-06-26 00:25:48 -0700 | [diff] [blame] | 112 | void proc_flush_task(struct task_struct *task); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 113 | struct dentry *proc_pid_lookup(struct inode *dir, struct dentry * dentry, struct nameidata *); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 114 | int proc_pid_readdir(struct file * filp, void * dirent, filldir_t filldir); |
| 115 | unsigned long task_vsize(struct mm_struct *); |
| 116 | int task_statm(struct mm_struct *, int *, int *, int *, int *); |
Eric W. Biederman | df5f831 | 2008-02-08 04:18:33 -0800 | [diff] [blame] | 117 | void task_mem(struct seq_file *, struct mm_struct *); |
| 118 | void clear_refs_smap(struct mm_struct *mm); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 119 | |
Alexey Dobriyan | 7695650 | 2007-05-08 00:25:45 -0700 | [diff] [blame] | 120 | struct proc_dir_entry *de_get(struct proc_dir_entry *de); |
| 121 | void de_put(struct proc_dir_entry *de); |
| 122 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 123 | extern struct proc_dir_entry *create_proc_entry(const char *name, mode_t mode, |
| 124 | struct proc_dir_entry *parent); |
Alexey Dobriyan | 2d3a4e3 | 2008-02-08 04:18:37 -0800 | [diff] [blame] | 125 | struct proc_dir_entry *proc_create(const char *name, mode_t mode, |
| 126 | struct proc_dir_entry *parent, |
| 127 | const struct file_operations *proc_fops); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 128 | extern void remove_proc_entry(const char *name, struct proc_dir_entry *parent); |
| 129 | |
| 130 | extern struct vfsmount *proc_mnt; |
Pavel Emelyanov | 07543f5 | 2007-10-18 23:40:08 -0700 | [diff] [blame] | 131 | struct pid_namespace; |
| 132 | extern int proc_fill_super(struct super_block *); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 133 | extern struct inode *proc_get_inode(struct super_block *, unsigned int, struct proc_dir_entry *); |
| 134 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 135 | /* |
| 136 | * These are generic /proc routines that use the internal |
| 137 | * "struct proc_dir_entry" tree to traverse the filesystem. |
| 138 | * |
| 139 | * The /proc root directory has extended versions to take care |
| 140 | * of the /proc/<pid> subdirectories. |
| 141 | */ |
| 142 | extern int proc_readdir(struct file *, void *, filldir_t); |
| 143 | extern struct dentry *proc_lookup(struct inode *, struct dentry *, struct nameidata *); |
| 144 | |
Arjan van de Ven | 4b6f5d2 | 2006-03-28 01:56:42 -0800 | [diff] [blame] | 145 | extern const struct file_operations proc_kcore_operations; |
| 146 | extern const struct file_operations proc_kmsg_operations; |
| 147 | extern const struct file_operations ppc_htab_operations; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 148 | |
Pavel Emelyanov | 6f4e643 | 2007-10-18 23:40:11 -0700 | [diff] [blame] | 149 | extern int pid_ns_prepare_proc(struct pid_namespace *ns); |
| 150 | extern void pid_ns_release_proc(struct pid_namespace *ns); |
| 151 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 152 | /* |
| 153 | * proc_tty.c |
| 154 | */ |
| 155 | struct tty_driver; |
| 156 | extern void proc_tty_init(void); |
| 157 | extern void proc_tty_register_driver(struct tty_driver *driver); |
| 158 | extern void proc_tty_unregister_driver(struct tty_driver *driver); |
| 159 | |
| 160 | /* |
| 161 | * proc_devtree.c |
| 162 | */ |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 163 | #ifdef CONFIG_PROC_DEVICETREE |
Benjamin Herrenschmidt | 183d020 | 2005-11-07 14:29:02 +1100 | [diff] [blame] | 164 | struct device_node; |
| 165 | struct property; |
| 166 | extern void proc_device_tree_init(void); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 167 | extern void proc_device_tree_add_node(struct device_node *, struct proc_dir_entry *); |
Benjamin Herrenschmidt | 183d020 | 2005-11-07 14:29:02 +1100 | [diff] [blame] | 168 | extern void proc_device_tree_add_prop(struct proc_dir_entry *pde, struct property *prop); |
Dave C Boutcher | 898b539 | 2006-01-12 16:07:17 -0600 | [diff] [blame] | 169 | extern void proc_device_tree_remove_prop(struct proc_dir_entry *pde, |
| 170 | struct property *prop); |
| 171 | extern void proc_device_tree_update_prop(struct proc_dir_entry *pde, |
| 172 | struct property *newprop, |
| 173 | struct property *oldprop); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 174 | #endif /* CONFIG_PROC_DEVICETREE */ |
| 175 | |
| 176 | extern struct proc_dir_entry *proc_symlink(const char *, |
| 177 | struct proc_dir_entry *, const char *); |
| 178 | extern struct proc_dir_entry *proc_mkdir(const char *,struct proc_dir_entry *); |
| 179 | extern struct proc_dir_entry *proc_mkdir_mode(const char *name, mode_t mode, |
| 180 | struct proc_dir_entry *parent); |
| 181 | |
| 182 | static inline struct proc_dir_entry *create_proc_read_entry(const char *name, |
| 183 | mode_t mode, struct proc_dir_entry *base, |
| 184 | read_proc_t *read_proc, void * data) |
| 185 | { |
| 186 | struct proc_dir_entry *res=create_proc_entry(name,mode,base); |
| 187 | if (res) { |
| 188 | res->read_proc=read_proc; |
| 189 | res->data=data; |
| 190 | } |
| 191 | return res; |
| 192 | } |
| 193 | |
| 194 | static inline struct proc_dir_entry *create_proc_info_entry(const char *name, |
| 195 | mode_t mode, struct proc_dir_entry *base, get_info_t *get_info) |
| 196 | { |
| 197 | struct proc_dir_entry *res=create_proc_entry(name,mode,base); |
| 198 | if (res) res->get_info=get_info; |
| 199 | return res; |
| 200 | } |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 201 | |
Eric W. Biederman | 457c4cb | 2007-09-12 12:01:34 +0200 | [diff] [blame] | 202 | extern struct proc_dir_entry *proc_net_fops_create(struct net *net, |
| 203 | const char *name, mode_t mode, const struct file_operations *fops); |
| 204 | extern void proc_net_remove(struct net *net, const char *name); |
Denis V. Lunev | e5d69b9 | 2008-01-10 03:51:41 -0800 | [diff] [blame] | 205 | extern struct proc_dir_entry *proc_net_mkdir(struct net *net, const char *name, |
| 206 | struct proc_dir_entry *parent); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 207 | |
Matt Helsley | 925d1c4 | 2008-04-29 01:01:36 -0700 | [diff] [blame^] | 208 | /* While the {get|set|dup}_mm_exe_file functions are for mm_structs, they are |
| 209 | * only needed to implement /proc/<pid>|self/exe so we define them here. */ |
| 210 | extern void set_mm_exe_file(struct mm_struct *mm, struct file *new_exe_file); |
| 211 | extern struct file *get_mm_exe_file(struct mm_struct *mm); |
| 212 | extern void dup_mm_exe_file(struct mm_struct *oldmm, struct mm_struct *newmm); |
| 213 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 214 | #else |
| 215 | |
| 216 | #define proc_root_driver NULL |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 217 | #define proc_bus NULL |
| 218 | |
Eric W. Biederman | 457c4cb | 2007-09-12 12:01:34 +0200 | [diff] [blame] | 219 | #define proc_net_fops_create(net, name, mode, fops) ({ (void)(mode), NULL; }) |
Eric W. Biederman | 457c4cb | 2007-09-12 12:01:34 +0200 | [diff] [blame] | 220 | static inline void proc_net_remove(struct net *net, const char *name) {} |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 221 | |
Pavel Emelyanov | 60347f6 | 2007-10-18 23:40:03 -0700 | [diff] [blame] | 222 | static inline void proc_flush_task(struct task_struct *task) |
| 223 | { |
| 224 | } |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 225 | |
| 226 | static inline struct proc_dir_entry *create_proc_entry(const char *name, |
| 227 | mode_t mode, struct proc_dir_entry *parent) { return NULL; } |
Alexey Dobriyan | 2d3a4e3 | 2008-02-08 04:18:37 -0800 | [diff] [blame] | 228 | static inline struct proc_dir_entry *proc_create(const char *name, |
| 229 | mode_t mode, struct proc_dir_entry *parent, |
| 230 | const struct file_operations *proc_fops) |
| 231 | { |
| 232 | return NULL; |
| 233 | } |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 234 | #define remove_proc_entry(name, parent) do {} while (0) |
| 235 | |
| 236 | static inline struct proc_dir_entry *proc_symlink(const char *name, |
| 237 | struct proc_dir_entry *parent,const char *dest) {return NULL;} |
| 238 | static inline struct proc_dir_entry *proc_mkdir(const char *name, |
| 239 | struct proc_dir_entry *parent) {return NULL;} |
| 240 | |
| 241 | static inline struct proc_dir_entry *create_proc_read_entry(const char *name, |
| 242 | mode_t mode, struct proc_dir_entry *base, |
| 243 | read_proc_t *read_proc, void * data) { return NULL; } |
| 244 | static inline struct proc_dir_entry *create_proc_info_entry(const char *name, |
| 245 | mode_t mode, struct proc_dir_entry *base, get_info_t *get_info) |
| 246 | { return NULL; } |
| 247 | |
| 248 | struct tty_driver; |
| 249 | static inline void proc_tty_register_driver(struct tty_driver *driver) {}; |
| 250 | static inline void proc_tty_unregister_driver(struct tty_driver *driver) {}; |
| 251 | |
| 252 | extern struct proc_dir_entry proc_root; |
| 253 | |
Pavel Emelyanov | 6f4e643 | 2007-10-18 23:40:11 -0700 | [diff] [blame] | 254 | static inline int pid_ns_prepare_proc(struct pid_namespace *ns) |
| 255 | { |
| 256 | return 0; |
| 257 | } |
| 258 | |
| 259 | static inline void pid_ns_release_proc(struct pid_namespace *ns) |
| 260 | { |
| 261 | } |
| 262 | |
Matt Helsley | 925d1c4 | 2008-04-29 01:01:36 -0700 | [diff] [blame^] | 263 | static inline void set_mm_exe_file(struct mm_struct *mm, |
| 264 | struct file *new_exe_file) |
| 265 | {} |
| 266 | |
| 267 | static inline struct file *get_mm_exe_file(struct mm_struct *mm) |
| 268 | { |
| 269 | return NULL; |
| 270 | } |
| 271 | |
| 272 | static inline void dup_mm_exe_file(struct mm_struct *oldmm, |
| 273 | struct mm_struct *newmm) |
| 274 | {} |
| 275 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 276 | #endif /* CONFIG_PROC_FS */ |
| 277 | |
| 278 | #if !defined(CONFIG_PROC_KCORE) |
| 279 | static inline void kclist_add(struct kcore_list *new, void *addr, size_t size) |
| 280 | { |
| 281 | } |
| 282 | #else |
| 283 | extern void kclist_add(struct kcore_list *, void *, size_t); |
| 284 | #endif |
| 285 | |
Eric W. Biederman | 20cdc89 | 2006-10-02 02:17:07 -0700 | [diff] [blame] | 286 | union proc_op { |
Jan Blunck | 3dcd25f | 2008-02-14 19:38:35 -0800 | [diff] [blame] | 287 | int (*proc_get_link)(struct inode *, struct path *); |
Eric W. Biederman | 20cdc89 | 2006-10-02 02:17:07 -0700 | [diff] [blame] | 288 | int (*proc_read)(struct task_struct *task, char *page); |
Eric W. Biederman | be61408 | 2008-02-08 04:18:30 -0800 | [diff] [blame] | 289 | int (*proc_show)(struct seq_file *m, |
| 290 | struct pid_namespace *ns, struct pid *pid, |
| 291 | struct task_struct *task); |
Eric W. Biederman | 20cdc89 | 2006-10-02 02:17:07 -0700 | [diff] [blame] | 292 | }; |
| 293 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 294 | struct proc_inode { |
Eric W. Biederman | 13b41b0 | 2006-06-26 00:25:56 -0700 | [diff] [blame] | 295 | struct pid *pid; |
Eric W. Biederman | aed7a6c | 2006-06-26 00:25:44 -0700 | [diff] [blame] | 296 | int fd; |
Eric W. Biederman | 20cdc89 | 2006-10-02 02:17:07 -0700 | [diff] [blame] | 297 | union proc_op op; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 298 | struct proc_dir_entry *pde; |
| 299 | struct inode vfs_inode; |
| 300 | }; |
| 301 | |
| 302 | static inline struct proc_inode *PROC_I(const struct inode *inode) |
| 303 | { |
| 304 | return container_of(inode, struct proc_inode, vfs_inode); |
| 305 | } |
| 306 | |
| 307 | static inline struct proc_dir_entry *PDE(const struct inode *inode) |
| 308 | { |
| 309 | return PROC_I(inode)->pde; |
| 310 | } |
| 311 | |
Eric W. Biederman | 457c4cb | 2007-09-12 12:01:34 +0200 | [diff] [blame] | 312 | static inline struct net *PDE_NET(struct proc_dir_entry *pde) |
| 313 | { |
| 314 | return pde->parent->data; |
| 315 | } |
| 316 | |
Eric W. Biederman | 077130c | 2007-09-13 09:18:57 +0200 | [diff] [blame] | 317 | struct net *get_proc_net(const struct inode *inode); |
Eric W. Biederman | 457c4cb | 2007-09-12 12:01:34 +0200 | [diff] [blame] | 318 | |
Eric W. Biederman | 99f8955 | 2006-06-26 00:25:55 -0700 | [diff] [blame] | 319 | struct proc_maps_private { |
Eric W. Biederman | 13b41b0 | 2006-06-26 00:25:56 -0700 | [diff] [blame] | 320 | struct pid *pid; |
Eric W. Biederman | 99f8955 | 2006-06-26 00:25:55 -0700 | [diff] [blame] | 321 | struct task_struct *task; |
David Howells | dbf8685 | 2006-09-27 01:50:19 -0700 | [diff] [blame] | 322 | #ifdef CONFIG_MMU |
Eric W. Biederman | 99f8955 | 2006-06-26 00:25:55 -0700 | [diff] [blame] | 323 | struct vm_area_struct *tail_vma; |
David Howells | dbf8685 | 2006-09-27 01:50:19 -0700 | [diff] [blame] | 324 | #endif |
Eric W. Biederman | 99f8955 | 2006-06-26 00:25:55 -0700 | [diff] [blame] | 325 | }; |
| 326 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 327 | #endif /* _LINUX_PROC_FS_H */ |