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