cregit-Linux how code gets into the kernel

Release 4.10 fs/proc/inode.c

Directory: fs/proc
/*
 *  linux/fs/proc/inode.c
 *
 *  Copyright (C) 1991, 1992  Linus Torvalds
 */

#include <linux/time.h>
#include <linux/proc_fs.h>
#include <linux/kernel.h>
#include <linux/pid_namespace.h>
#include <linux/mm.h>
#include <linux/string.h>
#include <linux/stat.h>
#include <linux/completion.h>
#include <linux/poll.h>
#include <linux/printk.h>
#include <linux/file.h>
#include <linux/limits.h>
#include <linux/init.h>
#include <linux/module.h>
#include <linux/sysctl.h>
#include <linux/seq_file.h>
#include <linux/slab.h>
#include <linux/mount.h>
#include <linux/magic.h>

#include <linux/uaccess.h>

#include "internal.h"


static void proc_evict_inode(struct inode *inode) { struct proc_dir_entry *de; struct ctl_table_header *head; truncate_inode_pages_final(&inode->i_data); clear_inode(inode); /* Stop tracking associated processes */ put_pid(PROC_I(inode)->pid); /* Let go of any associated proc directory entry */ de = PDE(inode); if (de) pde_put(de); head = PROC_I(inode)->sysctl; if (head) { RCU_INIT_POINTER(PROC_I(inode)->sysctl, NULL); sysctl_head_put(head); } }

Contributors

PersonTokensPropCommitsCommitProp
al viroal viro4143.62%316.67%
pre-gitpre-git2930.85%633.33%
linus torvaldslinus torvalds88.51%15.56%
mark fashehmark fasheh77.45%15.56%
eric w. biedermaneric w. biederman44.26%211.11%
jan karajan kara11.06%15.56%
alexey dobriyanalexey dobriyan11.06%15.56%
monam agarwalmonam agarwal11.06%15.56%
alexander kuleshovalexander kuleshov11.06%15.56%
johannes weinerjohannes weiner11.06%15.56%
Total94100.00%18100.00%

static struct kmem_cache * proc_inode_cachep;
static struct inode *proc_alloc_inode(struct super_block *sb) { struct proc_inode *ei; struct inode *inode; ei = (struct proc_inode *)kmem_cache_alloc(proc_inode_cachep, GFP_KERNEL); if (!ei) return NULL; ei->pid = NULL; ei->fd = 0; ei->op.proc_get_link = NULL; ei->pde = NULL; ei->sysctl = NULL; ei->sysctl_entry = NULL; ei->ns_ops = NULL; inode = &ei->vfs_inode; return inode; }

Contributors

PersonTokensPropCommitsCommitProp
al viroal viro5656.57%228.57%
linus torvaldslinus torvalds3434.34%114.29%
eric w. biedermaneric w. biederman88.08%342.86%
christoph lameterchristoph lameter11.01%114.29%
Total99100.00%7100.00%


static void proc_i_callback(struct rcu_head *head) { struct inode *inode = container_of(head, struct inode, i_rcu); kmem_cache_free(proc_inode_cachep, PROC_I(inode)); }

Contributors

PersonTokensPropCommitsCommitProp
al viroal viro1850.00%150.00%
nick pigginnick piggin1850.00%150.00%
Total36100.00%2100.00%


static void proc_destroy_inode(struct inode *inode) { call_rcu(&inode->i_rcu, proc_i_callback); }

Contributors

PersonTokensPropCommitsCommitProp
nick pigginnick piggin21100.00%1100.00%
Total21100.00%1100.00%


static void init_once(void *foo) { struct proc_inode *ei = (struct proc_inode *) foo; inode_init_once(&ei->vfs_inode); }

Contributors

PersonTokensPropCommitsCommitProp
al viroal viro2790.00%150.00%
christoph lameterchristoph lameter310.00%150.00%
Total30100.00%2100.00%


void __init proc_init_inodecache(void) { proc_inode_cachep = kmem_cache_create("proc_inode_cache", sizeof(struct proc_inode), 0, (SLAB_RECLAIM_ACCOUNT| SLAB_MEM_SPREAD|SLAB_ACCOUNT| SLAB_PANIC), init_once); }

Contributors

PersonTokensPropCommitsCommitProp
al viroal viro2571.43%114.29%
paul jacksonpaul jackson411.43%228.57%
alexey dobriyanalexey dobriyan38.57%228.57%
vladimir davydovvladimir davydov25.71%114.29%
andrew mortonandrew morton12.86%114.29%
Total35100.00%7100.00%


static int proc_show_options(struct seq_file *seq, struct dentry *root) { struct super_block *sb = root->d_sb; struct pid_namespace *pid = sb->s_fs_info; if (!gid_eq(pid->pid_gid, GLOBAL_ROOT_GID)) seq_printf(seq, ",gid=%u", from_kgid_munged(&init_user_ns, pid->pid_gid)); if (pid->hide_pid != 0) seq_printf(seq, ",hidepid=%u", pid->hide_pid); return 0; }

Contributors

PersonTokensPropCommitsCommitProp
vasiliy kulikovvasiliy kulikov7284.71%266.67%
eric w. biedermaneric w. biederman1315.29%133.33%
Total85100.00%3100.00%

static const struct super_operations proc_sops = { .alloc_inode = proc_alloc_inode, .destroy_inode = proc_destroy_inode, .drop_inode = generic_delete_inode, .evict_inode = proc_evict_inode, .statfs = simple_statfs, .remount_fs = proc_remount, .show_options = proc_show_options, }; enum {BIAS = -1U<<31};
static inline int use_pde(struct proc_dir_entry *pde) { return atomic_inc_unless_negative(&pde->in_use); }

Contributors

PersonTokensPropCommitsCommitProp
al viroal viro1361.90%250.00%
alexey dobriyanalexey dobriyan628.57%125.00%
pre-gitpre-git29.52%125.00%
Total21100.00%4100.00%


static void unuse_pde(struct proc_dir_entry *pde) { if (atomic_dec_return(&pde->in_use) == BIAS) complete(pde->pde_unload_completion); }

Contributors

PersonTokensPropCommitsCommitProp
al viroal viro1860.00%250.00%
alexey dobriyanalexey dobriyan1240.00%250.00%
Total30100.00%4100.00%

/* pde is locked */
static void close_pdeo(struct proc_dir_entry *pde, struct pde_opener *pdeo) { /* * close() (proc_reg_release()) can't delete an entry and proceed: * ->release hook needs to be available at the right moment. * * rmmod (remove_proc_entry() et al) can't delete an entry and proceed: * "struct file" needs to be available at the right moment. * * Therefore, first process to enter this function does ->release() and * signals its completion to the other process which does nothing. */ if (pdeo->closing) { /* somebody else is doing that, just wait */ DECLARE_COMPLETION_ONSTACK(c); pdeo->c = &c; spin_unlock(&pde->pde_unload_lock); wait_for_completion(&c); spin_lock(&pde->pde_unload_lock); } else { struct file *file; pdeo->closing = true; spin_unlock(&pde->pde_unload_lock); file = pdeo->file; pde->proc_fops->release(file_inode(file), file); spin_lock(&pde->pde_unload_lock); /* After ->release. */ list_del(&pdeo->lh); if (pdeo->c) complete(pdeo->c); kfree(pdeo); } }

Contributors

PersonTokensPropCommitsCommitProp
al viroal viro13397.08%240.00%
alexey dobriyanalexey dobriyan42.92%360.00%
Total137100.00%5100.00%


void proc_entry_rundown(struct proc_dir_entry *de) { DECLARE_COMPLETION_ONSTACK(c); /* Wait until all existing callers into module are done. */ de->pde_unload_completion = &c; if (atomic_add_return(BIAS, &de->in_use) != BIAS) wait_for_completion(&c); /* ->pde_openers list can't grow from now on. */ spin_lock(&de->pde_unload_lock); while (!list_empty(&de->pde_openers)) { struct pde_opener *pdeo; pdeo = list_first_entry(&de->pde_openers, struct pde_opener, lh); close_pdeo(de, pdeo); } spin_unlock(&de->pde_unload_lock); }

Contributors

PersonTokensPropCommitsCommitProp
al viroal viro9999.00%375.00%
alexey dobriyanalexey dobriyan11.00%125.00%
Total100100.00%4100.00%


static loff_t proc_reg_llseek(struct file *file, loff_t offset, int whence) { struct proc_dir_entry *pde = PDE(file_inode(file)); loff_t rv = -EINVAL; if (use_pde(pde)) { loff_t (*llseek)(struct file *, loff_t, int); llseek = pde->proc_fops->llseek; if (!llseek) llseek = default_llseek; rv = llseek(file, offset, whence); unuse_pde(pde); } return rv; }

Contributors

PersonTokensPropCommitsCommitProp
alexey dobriyanalexey dobriyan6163.54%116.67%
pre-gitpre-git1818.75%116.67%
al viroal viro1313.54%233.33%
eric w. biedermaneric w. biederman22.08%116.67%
kirill korotaevkirill korotaev22.08%116.67%
Total96100.00%6100.00%


static ssize_t proc_reg_read(struct file *file, char __user *buf, size_t count, loff_t *ppos) { ssize_t (*read)(struct file *, char __user *, size_t, loff_t *); struct proc_dir_entry *pde = PDE(file_inode(file)); ssize_t rv = -EIO; if (use_pde(pde)) { read = pde->proc_fops->read; if (read) rv = read(file, buf, count, ppos); unuse_pde(pde); } return rv; }

Contributors

PersonTokensPropCommitsCommitProp
alexey dobriyanalexey dobriyan7673.08%133.33%
al viroal viro2221.15%133.33%
pre-gitpre-git65.77%133.33%
Total104100.00%3100.00%


static ssize_t proc_reg_write(struct file *file, const char __user *buf, size_t count, loff_t *ppos) { ssize_t (*write)(struct file *, const char __user *, size_t, loff_t *); struct proc_dir_entry *pde = PDE(file_inode(file)); ssize_t rv = -EIO; if (use_pde(pde)) { write = pde->proc_fops->write; if (write) rv = write(file, buf, count, ppos); unuse_pde(pde); } return rv; }

Contributors

PersonTokensPropCommitsCommitProp
alexey dobriyanalexey dobriyan8479.25%150.00%
al viroal viro2220.75%150.00%
Total106100.00%2100.00%


static unsigned int proc_reg_poll(struct file *file, struct poll_table_struct *pts) { struct proc_dir_entry *pde = PDE(file_inode(file)); unsigned int rv = DEFAULT_POLLMASK; unsigned int (*poll)(struct file *, struct poll_table_struct *); if (use_pde(pde)) { poll = pde->proc_fops->poll; if (poll) rv = poll(file, pts); unuse_pde(pde); } return rv; }

Contributors

PersonTokensPropCommitsCommitProp
alexey dobriyanalexey dobriyan8291.11%250.00%
al viroal viro88.89%250.00%
Total90100.00%4100.00%


static long proc_reg_unlocked_ioctl(struct file *file, unsigned int cmd, unsigned long arg) { struct proc_dir_entry *pde = PDE(file_inode(file)); long rv = -ENOTTY; long (*ioctl)(struct file *, unsigned int, unsigned long); if (use_pde(pde)) { ioctl = pde->proc_fops->unlocked_ioctl; if (ioctl) rv = ioctl(file, cmd, arg); unuse_pde(pde); } return rv; }

Contributors

PersonTokensPropCommitsCommitProp
alexey dobriyanalexey dobriyan8690.53%125.00%
al viroal viro88.42%250.00%
arnd bergmannarnd bergmann11.05%125.00%
Total95100.00%4100.00%

#ifdef CONFIG_COMPAT
static long proc_reg_compat_ioctl(struct file *file, unsigned int cmd, unsigned long arg) { struct proc_dir_entry *pde = PDE(file_inode(file)); long rv = -ENOTTY; long (*compat_ioctl)(struct file *, unsigned int, unsigned long); if (use_pde(pde)) { compat_ioctl = pde->proc_fops->compat_ioctl; if (compat_ioctl) rv = compat_ioctl(file, cmd, arg); unuse_pde(pde); } return rv; }

Contributors

PersonTokensPropCommitsCommitProp
alexey dobriyanalexey dobriyan8791.58%133.33%
al viroal viro88.42%266.67%
Total95100.00%3100.00%

#endif
static int proc_reg_mmap(struct file *file, struct vm_area_struct *vma) { struct proc_dir_entry *pde = PDE(file_inode(file)); int rv = -EIO; int (*mmap)(struct file *, struct vm_area_struct *); if (use_pde(pde)) { mmap = pde->proc_fops->mmap; if (mmap) rv = mmap(file, vma); unuse_pde(pde); } return rv; }

Contributors

PersonTokensPropCommitsCommitProp
alexey dobriyanalexey dobriyan8090.91%133.33%
al viroal viro89.09%266.67%
Total88100.00%3100.00%


static unsigned long proc_reg_get_unmapped_area(struct file *file, unsigned long orig_addr, unsigned long len, unsigned long pgoff, unsigned long flags) { struct proc_dir_entry *pde = PDE(file_inode(file)); unsigned long rv = -EIO; if (use_pde(pde)) { typeof(proc_reg_get_unmapped_area) *get_area; get_area = pde->proc_fops->get_unmapped_area; #ifdef CONFIG_MMU if (!get_area) get_area = current->mm->get_unmapped_area; #endif if (get_area) rv = get_area(file, orig_addr, len, pgoff, flags); else rv = orig_addr; unuse_pde(pde); } return rv; }

Contributors

PersonTokensPropCommitsCommitProp
alexey dobriyanalexey dobriyan8569.67%120.00%
jan beulichjan beulich2318.85%120.00%
daisuke hatayamadaisuke hatayama1411.48%360.00%
Total122100.00%5100.00%


static int proc_reg_open(struct inode *inode, struct file *file) { struct proc_dir_entry *pde = PDE(inode); int rv = 0; int (*open)(struct inode *, struct file *); int (*release)(struct inode *, struct file *); struct pde_opener *pdeo; /* * Ensure that * 1) PDE's ->release hook will be called no matter what * either normally by close()/->release, or forcefully by * rmmod/remove_proc_entry. * * 2) rmmod isn't blocked by opening file in /proc and sitting on * the descriptor (including "rmmod foo </proc/foo" scenario). * * Save every "struct file" with custom ->release hook. */ pdeo = kmalloc(sizeof(struct pde_opener), GFP_KERNEL); if (!pdeo) return -ENOMEM; if (!use_pde(pde)) { kfree(pdeo); return -ENOENT; } open = pde->proc_fops->open; release = pde->proc_fops->release; if (open) rv = open(inode, file); if (rv == 0 && release) { /* To know what to release. */ pdeo->file = file; pdeo->closing = false; pdeo->c = NULL; spin_lock(&pde->pde_unload_lock); list_add(&pdeo->lh, &pde->pde_openers); spin_unlock(&pde->pde_unload_lock); } else kfree(pdeo); unuse_pde(pde); return rv; }

Contributors

PersonTokensPropCommitsCommitProp
alexey dobriyanalexey dobriyan18889.95%562.50%
al viroal viro209.57%225.00%
daisuke oginodaisuke ogino10.48%112.50%
Total209100.00%8100.00%


static int proc_reg_release(struct inode *inode, struct file *file) { struct proc_dir_entry *pde = PDE(inode); struct pde_opener *pdeo; spin_lock(&pde->pde_unload_lock); list_for_each_entry(pdeo, &pde->pde_openers, lh) { if (pdeo->file == file) { close_pdeo(pde, pdeo); break; } } spin_unlock(&pde->pde_unload_lock); return 0; }

Contributors

PersonTokensPropCommitsCommitProp
alexey dobriyanalexey dobriyan6684.62%266.67%
al viroal viro1215.38%133.33%
Total78100.00%3100.00%

static const struct file_operations proc_reg_file_ops = { .llseek = proc_reg_llseek, .read = proc_reg_read, .write = proc_reg_write, .poll = proc_reg_poll, .unlocked_ioctl = proc_reg_unlocked_ioctl, #ifdef CONFIG_COMPAT .compat_ioctl = proc_reg_compat_ioctl, #endif .mmap = proc_reg_mmap, .get_unmapped_area = proc_reg_get_unmapped_area, .open = proc_reg_open, .release = proc_reg_release, }; #ifdef CONFIG_COMPAT static const struct file_operations proc_reg_file_ops_no_compat = { .llseek = proc_reg_llseek, .read = proc_reg_read, .write = proc_reg_write, .poll = proc_reg_poll, .unlocked_ioctl = proc_reg_unlocked_ioctl, .mmap = proc_reg_mmap, .get_unmapped_area = proc_reg_get_unmapped_area, .open = proc_reg_open, .release = proc_reg_release, }; #endif
static void proc_put_link(void *p) { unuse_pde(p); }

Contributors

PersonTokensPropCommitsCommitProp
al viroal viro15100.00%1100.00%
Total15100.00%1100.00%


static const char *proc_get_link(struct dentry *dentry, struct inode *inode, struct delayed_call *done) { struct proc_dir_entry *pde = PDE(inode); if (unlikely(!use_pde(pde))) return ERR_PTR(-EINVAL); set_delayed_call(done, proc_put_link, pde); return pde->data; }

Contributors

PersonTokensPropCommitsCommitProp
al viroal viro65100.00%4100.00%
Total65100.00%4100.00%

const struct inode_operations proc_link_inode_operations = { .get_link = proc_get_link, };
struct inode *proc_get_inode(struct super_block *sb, struct proc_dir_entry *de) { struct inode *inode = new_inode_pseudo(sb); if (inode) { inode->i_ino = de->low_ino; inode->i_mtime = inode->i_atime = inode->i_ctime = current_time(inode); PROC_I(inode)->pde = de; if (is_empty_pde(de)) { make_empty_dir_inode(inode); return inode; } if (de->mode) { inode->i_mode = de->mode; inode->i_uid = de->uid; inode->i_gid = de->gid; } if (de->size) inode->i_size = de->size; if (de->nlink) set_nlink(inode, de->nlink); WARN_ON(!de->proc_iops); inode->i_op = de->proc_iops; if (de->proc_fops) { if (S_ISREG(inode->i_mode)) { #ifdef CONFIG_COMPAT if (!de->proc_fops->compat_ioctl) inode->i_fop = &proc_reg_file_ops_no_compat; else #endif inode->i_fop = &proc_reg_file_ops; } else { inode->i_fop = de->proc_fops; } } } else pde_put(de); return inode; }

Contributors

PersonTokensPropCommitsCommitProp
alexey dobriyanalexey dobriyan11349.34%213.33%
linus torvaldslinus torvalds3314.41%213.33%
david s. millerdavid s. miller2410.48%16.67%
eric w. biedermaneric w. biederman177.42%16.67%
david howellsdavid howells177.42%16.67%
al viroal viro73.06%213.33%
pre-gitpre-git52.18%213.33%
krzysztof sachanowiczkrzysztof sachanowicz41.75%16.67%
deepa dinamanideepa dinamani41.75%16.67%
miklos szeredimiklos szeredi41.75%16.67%
denis v. lunevdenis v. lunev10.44%16.67%
Total229100.00%15100.00%


int proc_fill_super(struct super_block *s, void *data, int silent) { struct pid_namespace *ns = get_pid_ns(s->s_fs_info); struct inode *root_inode; int ret; if (!proc_parse_options(data, ns)) return -EINVAL; /* User space would break if executables or devices appear on proc */ s->s_iflags |= SB_I_USERNS_VISIBLE | SB_I_NOEXEC | SB_I_NODEV; s->s_flags |= MS_NODIRATIME | MS_NOSUID | MS_NOEXEC; s->s_blocksize = 1024; s->s_blocksize_bits = 10; s->s_magic = PROC_SUPER_MAGIC; s->s_op = &proc_sops; s->s_time_gran = 1; /* * procfs isn't actually a stacking filesystem; however, there is * too much magic going on inside it to permit stacking things on * top of it */ s->s_stack_depth = FILESYSTEM_MAX_STACK_DEPTH; pde_get(&proc_root); root_inode = proc_get_inode(s, &proc_root); if (!root_inode) { pr_err("proc_fill_super: get root inode failed\n"); return -ENOMEM; } s->s_root = d_make_root(root_inode); if (!s->s_root) { pr_err("proc_fill_super: allocate dentry failed\n"); return -ENOMEM; } ret = proc_setup_self(s); if (ret) { return ret; } return proc_setup_thread_self(s); }

Contributors

PersonTokensPropCommitsCommitProp
eric w. biedermaneric w. biederman6232.46%421.05%
pre-gitpre-git5227.23%526.32%
maxim patlasovmaxim patlasov3819.90%15.26%
linus torvaldslinus torvalds115.76%210.53%
andrew mortonandrew morton84.19%210.53%
al viroal viro84.19%210.53%
alexey dobriyanalexey dobriyan63.14%210.53%
andi kleenandi kleen63.14%15.26%
Total191100.00%19100.00%


Overall Contributors

PersonTokensPropCommitsCommitProp
alexey dobriyanalexey dobriyan112044.22%1312.87%
al viroal viro68527.04%1716.83%
pre-gitpre-git1526.00%1413.86%
eric w. biedermaneric w. biederman1064.18%1110.89%
vasiliy kulikovvasiliy kulikov913.59%21.98%
linus torvaldslinus torvalds893.51%76.93%
david s. millerdavid s. miller773.04%10.99%
nick pigginnick piggin391.54%10.99%
maxim patlasovmaxim patlasov381.50%10.99%
jan beulichjan beulich230.91%10.99%
david howellsdavid howells200.79%21.98%
daisuke hatayamadaisuke hatayama140.55%32.97%
andrew mortonandrew morton120.47%32.97%
art haasart haas100.39%10.99%
andi kleenandi kleen90.36%21.98%
mark fashehmark fasheh70.28%10.99%
christoph lameterchristoph lameter60.24%32.97%
miklos szeredimiklos szeredi40.16%10.99%
krzysztof sachanowiczkrzysztof sachanowicz40.16%10.99%
deepa dinamanideepa dinamani40.16%10.99%
paul jacksonpaul jackson40.16%21.98%
tejun heotejun heo30.12%10.99%
adrian bunkadrian bunk30.12%10.99%
kirill korotaevkirill korotaev20.08%10.99%
vladimir davydovvladimir davydov20.08%10.99%
jan karajan kara10.04%10.99%
josef 'jeff' sipekjosef 'jeff' sipek10.04%10.99%
johannes weinerjohannes weiner10.04%10.99%
daisuke oginodaisuke ogino10.04%10.99%
arnd bergmannarnd bergmann10.04%10.99%
monam agarwalmonam agarwal10.04%10.99%
dave jonesdave jones10.04%10.99%
denis v. lunevdenis v. lunev10.04%10.99%
alexander kuleshovalexander kuleshov10.04%10.99%
Total2533100.00%101100.00%
Directory: fs/proc
Information contained on this website is for historical information purposes only and does not indicate or represent copyright ownership.