include/linux/proc_ns.h

   1 /* SPDX-License-Identifier: GPL-2.0 */
   2 /*
   3  * procfs namespace bits
   4  */
   5 #ifndef _LINUX_PROC_NS_H
   6 #define _LINUX_PROC_NS_H
   7
   8 #include <linux/ns_common.h>
   9
  10 struct pid_namespace;
  11 struct nsproxy;
  12 struct path;
  13 struct task_struct;
  14 struct inode;
  15
  16 struct proc_ns_operations {
  17         const char *name;
  18         const char *real_ns_name;
  19         int type;
  20         struct ns_common *(*get)(struct task_struct *task);
  21         void (*put)(struct ns_common *ns);
  22         int (*install)(struct nsproxy *nsproxy, struct ns_common *ns);
  23         struct user_namespace *(*owner)(struct ns_common *ns);
  24         struct ns_common *(*get_parent)(struct ns_common *ns);
  25 } __randomize_layout;
  26
  27 extern const struct proc_ns_operations netns_operations;
  28 extern const struct proc_ns_operations utsns_operations;
  29 extern const struct proc_ns_operations ipcns_operations;
  30 extern const struct proc_ns_operations pidns_operations;
  31 extern const struct proc_ns_operations pidns_for_children_operations;
  32 extern const struct proc_ns_operations userns_operations;
  33 extern const struct proc_ns_operations mntns_operations;
  34 extern const struct proc_ns_operations cgroupns_operations;
  35 extern const struct proc_ns_operations timens_operations;
  36 extern const struct proc_ns_operations timens_for_children_operations;
  37
  38 /*
  39  * We always define these enumerators
  40  */
  41 enum {
  42         PROC_ROOT_INO           = 1,
  43         PROC_IPC_INIT_INO       = 0xEFFFFFFFU,
  44         PROC_UTS_INIT_INO       = 0xEFFFFFFEU,
  45         PROC_USER_INIT_INO      = 0xEFFFFFFDU,
  46         PROC_PID_INIT_INO       = 0xEFFFFFFCU,
  47         PROC_CGROUP_INIT_INO    = 0xEFFFFFFBU,
  48         PROC_TIME_INIT_INO      = 0xEFFFFFFAU,
  49 };
  50
  51 #ifdef CONFIG_PROC_FS
  52
  53 extern int pid_ns_prepare_proc(struct pid_namespace *ns);
  54 extern void pid_ns_release_proc(struct pid_namespace *ns);
  55 extern int proc_alloc_inum(unsigned int *pino);
  56 extern void proc_free_inum(unsigned int inum);
  57
  58 #else /* CONFIG_PROC_FS */
  59
  60 static inline int pid_ns_prepare_proc(struct pid_namespace *ns) { return 0; }
  61 static inline void pid_ns_release_proc(struct pid_namespace *ns) {}
  62
  63 static inline int proc_alloc_inum(unsigned int *inum)
  64 {
  65         *inum = 1;
  66         return 0;
  67 }
  68 static inline void proc_free_inum(unsigned int inum) {}
  69
  70 #endif /* CONFIG_PROC_FS */
  71
  72 static inline int ns_alloc_inum(struct ns_common *ns)
  73 {
  74         atomic_long_set(&ns->stashed, 0);
  75         return proc_alloc_inum(&ns->inum);
  76 }
  77
  78 #define ns_free_inum(ns) proc_free_inum((ns)->inum)
  79
  80 extern struct file *proc_ns_fget(int fd);
  81 #define get_proc_ns(inode) ((struct ns_common *)(inode)->i_private)
  82 extern int ns_get_path(struct path *path, struct task_struct *task,
  83                         const struct proc_ns_operations *ns_ops);
  84 typedef struct ns_common *ns_get_path_helper_t(void *);
  85 extern int ns_get_path_cb(struct path *path, ns_get_path_helper_t ns_get_cb,
  86                             void *private_data);
  87
  88 extern int ns_get_name(char *buf, size_t size, struct task_struct *task,
  89                         const struct proc_ns_operations *ns_ops);
  90 extern void nsfs_init(void);
  91
  92 #endif /* _LINUX_PROC_NS_H */