2 * linux/fs/proc/inode.c
4 * Copyright (C) 1991, 1992 Linus Torvalds
7 #include <linux/time.h>
8 #include <linux/proc_fs.h>
9 #include <linux/kernel.h>
10 #include <linux/pid_namespace.h>
12 #include <linux/string.h>
13 #include <linux/stat.h>
14 #include <linux/completion.h>
15 #include <linux/poll.h>
16 #include <linux/printk.h>
17 #include <linux/file.h>
18 #include <linux/limits.h>
19 #include <linux/init.h>
20 #include <linux/module.h>
21 #include <linux/sysctl.h>
22 #include <linux/seq_file.h>
23 #include <linux/slab.h>
24 #include <linux/mount.h>
26 #include <asm/uaccess.h>
30 static void proc_evict_inode(struct inode
*inode
)
32 struct proc_dir_entry
*de
;
33 struct ctl_table_header
*head
;
34 const struct proc_ns_operations
*ns_ops
;
37 truncate_inode_pages(&inode
->i_data
, 0);
40 /* Stop tracking associated processes */
41 put_pid(PROC_I(inode
)->pid
);
43 /* Let go of any associated proc directory entry */
44 de
= PROC_I(inode
)->pde
;
47 head
= PROC_I(inode
)->sysctl
;
49 rcu_assign_pointer(PROC_I(inode
)->sysctl
, NULL
);
50 sysctl_head_put(head
);
52 /* Release any associated namespace */
53 ns_ops
= PROC_I(inode
)->ns_ops
;
54 ns
= PROC_I(inode
)->ns
;
59 static struct kmem_cache
* proc_inode_cachep
;
61 static struct inode
*proc_alloc_inode(struct super_block
*sb
)
63 struct proc_inode
*ei
;
66 ei
= (struct proc_inode
*)kmem_cache_alloc(proc_inode_cachep
, GFP_KERNEL
);
71 ei
->op
.proc_get_link
= NULL
;
74 ei
->sysctl_entry
= NULL
;
77 inode
= &ei
->vfs_inode
;
78 inode
->i_mtime
= inode
->i_atime
= inode
->i_ctime
= CURRENT_TIME
;
82 static void proc_i_callback(struct rcu_head
*head
)
84 struct inode
*inode
= container_of(head
, struct inode
, i_rcu
);
85 kmem_cache_free(proc_inode_cachep
, PROC_I(inode
));
88 static void proc_destroy_inode(struct inode
*inode
)
90 call_rcu(&inode
->i_rcu
, proc_i_callback
);
93 static void init_once(void *foo
)
95 struct proc_inode
*ei
= (struct proc_inode
*) foo
;
97 inode_init_once(&ei
->vfs_inode
);
100 void __init
proc_init_inodecache(void)
102 proc_inode_cachep
= kmem_cache_create("proc_inode_cache",
103 sizeof(struct proc_inode
),
104 0, (SLAB_RECLAIM_ACCOUNT
|
105 SLAB_MEM_SPREAD
|SLAB_PANIC
),
109 static int proc_show_options(struct seq_file
*seq
, struct dentry
*root
)
111 struct super_block
*sb
= root
->d_sb
;
112 struct pid_namespace
*pid
= sb
->s_fs_info
;
114 if (!gid_eq(pid
->pid_gid
, GLOBAL_ROOT_GID
))
115 seq_printf(seq
, ",gid=%u", from_kgid_munged(&init_user_ns
, pid
->pid_gid
));
116 if (pid
->hide_pid
!= 0)
117 seq_printf(seq
, ",hidepid=%u", pid
->hide_pid
);
122 static const struct super_operations proc_sops
= {
123 .alloc_inode
= proc_alloc_inode
,
124 .destroy_inode
= proc_destroy_inode
,
125 .drop_inode
= generic_delete_inode
,
126 .evict_inode
= proc_evict_inode
,
127 .statfs
= simple_statfs
,
128 .remount_fs
= proc_remount
,
129 .show_options
= proc_show_options
,
132 enum {BIAS
= -1U<<31};
134 static inline int use_pde(struct proc_dir_entry
*pde
)
137 spin_lock(&pde
->pde_unload_lock
);
138 if (unlikely(pde
->pde_users
< 0))
142 spin_unlock(&pde
->pde_unload_lock
);
146 static void __pde_users_dec(struct proc_dir_entry
*pde
)
148 if (--pde
->pde_users
== BIAS
)
149 complete(pde
->pde_unload_completion
);
152 static void unuse_pde(struct proc_dir_entry
*pde
)
154 spin_lock(&pde
->pde_unload_lock
);
155 __pde_users_dec(pde
);
156 spin_unlock(&pde
->pde_unload_lock
);
159 void proc_entry_rundown(struct proc_dir_entry
*de
)
161 spin_lock(&de
->pde_unload_lock
);
162 de
->pde_users
+= BIAS
;
163 /* Wait until all existing callers into module are done. */
164 if (de
->pde_users
!= BIAS
) {
165 DECLARE_COMPLETION_ONSTACK(c
);
166 de
->pde_unload_completion
= &c
;
167 spin_unlock(&de
->pde_unload_lock
);
169 wait_for_completion(de
->pde_unload_completion
);
171 spin_lock(&de
->pde_unload_lock
);
174 while (!list_empty(&de
->pde_openers
)) {
175 struct pde_opener
*pdeo
;
178 pdeo
= list_first_entry(&de
->pde_openers
, struct pde_opener
, lh
);
180 spin_unlock(&de
->pde_unload_lock
);
182 de
->proc_fops
->release(file_inode(file
), file
);
184 spin_lock(&de
->pde_unload_lock
);
186 spin_unlock(&de
->pde_unload_lock
);
189 /* ->read_proc() users - legacy crap */
191 proc_file_read(struct file
*file
, char __user
*buf
, size_t nbytes
,
194 struct proc_dir_entry
*pde
= PDE(file_inode(file
));
197 rv
= __proc_file_read(file
, buf
, nbytes
, ppos
);
204 proc_file_lseek(struct file
*file
, loff_t offset
, int orig
)
206 loff_t retval
= -EINVAL
;
209 offset
+= file
->f_pos
;
212 if (offset
< 0 || offset
> MAX_NON_LFS
)
214 file
->f_pos
= retval
= offset
;
219 const struct file_operations proc_file_operations
= {
220 .llseek
= proc_file_lseek
,
221 .read
= proc_file_read
,
224 static loff_t
proc_reg_llseek(struct file
*file
, loff_t offset
, int whence
)
226 struct proc_dir_entry
*pde
= PDE(file_inode(file
));
229 loff_t (*llseek
)(struct file
*, loff_t
, int);
230 llseek
= pde
->proc_fops
->llseek
;
232 llseek
= default_llseek
;
233 rv
= llseek(file
, offset
, whence
);
239 static ssize_t
proc_reg_read(struct file
*file
, char __user
*buf
, size_t count
, loff_t
*ppos
)
241 ssize_t (*read
)(struct file
*, char __user
*, size_t, loff_t
*);
242 struct proc_dir_entry
*pde
= PDE(file_inode(file
));
245 read
= pde
->proc_fops
->read
;
247 rv
= read(file
, buf
, count
, ppos
);
253 static ssize_t
proc_reg_write(struct file
*file
, const char __user
*buf
, size_t count
, loff_t
*ppos
)
255 ssize_t (*write
)(struct file
*, const char __user
*, size_t, loff_t
*);
256 struct proc_dir_entry
*pde
= PDE(file_inode(file
));
259 write
= pde
->proc_fops
->write
;
261 rv
= write(file
, buf
, count
, ppos
);
267 static unsigned int proc_reg_poll(struct file
*file
, struct poll_table_struct
*pts
)
269 struct proc_dir_entry
*pde
= PDE(file_inode(file
));
270 unsigned int rv
= DEFAULT_POLLMASK
;
271 unsigned int (*poll
)(struct file
*, struct poll_table_struct
*);
273 poll
= pde
->proc_fops
->poll
;
275 rv
= poll(file
, pts
);
281 static long proc_reg_unlocked_ioctl(struct file
*file
, unsigned int cmd
, unsigned long arg
)
283 struct proc_dir_entry
*pde
= PDE(file_inode(file
));
285 long (*ioctl
)(struct file
*, unsigned int, unsigned long);
287 ioctl
= pde
->proc_fops
->unlocked_ioctl
;
289 rv
= ioctl(file
, cmd
, arg
);
296 static long proc_reg_compat_ioctl(struct file
*file
, unsigned int cmd
, unsigned long arg
)
298 struct proc_dir_entry
*pde
= PDE(file_inode(file
));
300 long (*compat_ioctl
)(struct file
*, unsigned int, unsigned long);
302 compat_ioctl
= pde
->proc_fops
->compat_ioctl
;
304 rv
= compat_ioctl(file
, cmd
, arg
);
311 static int proc_reg_mmap(struct file
*file
, struct vm_area_struct
*vma
)
313 struct proc_dir_entry
*pde
= PDE(file_inode(file
));
315 int (*mmap
)(struct file
*, struct vm_area_struct
*);
317 mmap
= pde
->proc_fops
->mmap
;
319 rv
= mmap(file
, vma
);
325 static int proc_reg_open(struct inode
*inode
, struct file
*file
)
327 struct proc_dir_entry
*pde
= PDE(inode
);
329 int (*open
)(struct inode
*, struct file
*);
330 int (*release
)(struct inode
*, struct file
*);
331 struct pde_opener
*pdeo
;
334 * What for, you ask? Well, we can have open, rmmod, remove_proc_entry
335 * sequence. ->release won't be called because ->proc_fops will be
336 * cleared. Depending on complexity of ->release, consequences vary.
338 * We can't wait for mercy when close will be done for real, it's
339 * deadlockable: rmmod foo </proc/foo . So, we're going to do ->release
340 * by hand in remove_proc_entry(). For this, save opener's credentials
343 pdeo
= kmalloc(sizeof(struct pde_opener
), GFP_KERNEL
);
351 open
= pde
->proc_fops
->open
;
352 release
= pde
->proc_fops
->release
;
355 rv
= open(inode
, file
);
357 spin_lock(&pde
->pde_unload_lock
);
358 if (rv
== 0 && release
) {
359 /* To know what to release. */
361 /* Strictly for "too late" ->release in proc_reg_release(). */
362 list_add(&pdeo
->lh
, &pde
->pde_openers
);
365 __pde_users_dec(pde
);
366 spin_unlock(&pde
->pde_unload_lock
);
370 static struct pde_opener
*find_pde_opener(struct proc_dir_entry
*pde
,
373 struct pde_opener
*pdeo
;
375 list_for_each_entry(pdeo
, &pde
->pde_openers
, lh
) {
376 if (pdeo
->file
== file
)
382 static int proc_reg_release(struct inode
*inode
, struct file
*file
)
384 struct proc_dir_entry
*pde
= PDE(inode
);
386 int (*release
)(struct inode
*, struct file
*);
387 struct pde_opener
*pdeo
;
389 spin_lock(&pde
->pde_unload_lock
);
390 pdeo
= find_pde_opener(pde
, file
);
391 if (pde
->pde_users
< 0) {
393 * Can't simply exit, __fput() will think that everything is OK,
394 * and move on to freeing struct file. remove_proc_entry() will
395 * find slacker in opener's list and will try to do non-trivial
396 * things with struct file. Therefore, remove opener from list.
398 * But if opener is removed from list, who will ->release it?
402 spin_unlock(&pde
->pde_unload_lock
);
403 rv
= pde
->proc_fops
->release(inode
, file
);
406 spin_unlock(&pde
->pde_unload_lock
);
410 release
= pde
->proc_fops
->release
;
415 spin_unlock(&pde
->pde_unload_lock
);
418 rv
= release(inode
, file
);
424 static const struct file_operations proc_reg_file_ops
= {
425 .llseek
= proc_reg_llseek
,
426 .read
= proc_reg_read
,
427 .write
= proc_reg_write
,
428 .poll
= proc_reg_poll
,
429 .unlocked_ioctl
= proc_reg_unlocked_ioctl
,
431 .compat_ioctl
= proc_reg_compat_ioctl
,
433 .mmap
= proc_reg_mmap
,
434 .open
= proc_reg_open
,
435 .release
= proc_reg_release
,
439 static const struct file_operations proc_reg_file_ops_no_compat
= {
440 .llseek
= proc_reg_llseek
,
441 .read
= proc_reg_read
,
442 .write
= proc_reg_write
,
443 .poll
= proc_reg_poll
,
444 .unlocked_ioctl
= proc_reg_unlocked_ioctl
,
445 .mmap
= proc_reg_mmap
,
446 .open
= proc_reg_open
,
447 .release
= proc_reg_release
,
451 struct inode
*proc_get_inode(struct super_block
*sb
, struct proc_dir_entry
*de
)
453 struct inode
*inode
= new_inode_pseudo(sb
);
456 inode
->i_ino
= de
->low_ino
;
457 inode
->i_mtime
= inode
->i_atime
= inode
->i_ctime
= CURRENT_TIME
;
458 PROC_I(inode
)->pde
= de
;
461 inode
->i_mode
= de
->mode
;
462 inode
->i_uid
= de
->uid
;
463 inode
->i_gid
= de
->gid
;
466 inode
->i_size
= de
->size
;
468 set_nlink(inode
, de
->nlink
);
469 WARN_ON(!de
->proc_iops
);
470 inode
->i_op
= de
->proc_iops
;
472 if (S_ISREG(inode
->i_mode
)) {
474 if (!de
->proc_fops
->compat_ioctl
)
476 &proc_reg_file_ops_no_compat
;
479 inode
->i_fop
= &proc_reg_file_ops
;
481 inode
->i_fop
= de
->proc_fops
;
489 int proc_fill_super(struct super_block
*s
)
491 struct inode
*root_inode
;
493 s
->s_flags
|= MS_NODIRATIME
| MS_NOSUID
| MS_NOEXEC
;
494 s
->s_blocksize
= 1024;
495 s
->s_blocksize_bits
= 10;
496 s
->s_magic
= PROC_SUPER_MAGIC
;
497 s
->s_op
= &proc_sops
;
501 root_inode
= proc_get_inode(s
, &proc_root
);
503 pr_err("proc_fill_super: get root inode failed\n");
507 s
->s_root
= d_make_root(root_inode
);
509 pr_err("proc_fill_super: allocate dentry failed\n");
513 return proc_setup_self(s
);