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