Commit | Line | Data |
---|---|---|
b2441318 | 1 | /* SPDX-License-Identifier: GPL-2.0 */ |
1da177e4 LT |
2 | /* |
3 | * sysctl.h: General linux system control interface | |
4 | * | |
5 | * Begun 24 March 1995, Stephen Tweedie | |
6 | * | |
7 | **************************************************************** | |
8 | **************************************************************** | |
9 | ** | |
7cc13edc | 10 | ** WARNING: |
1da177e4 | 11 | ** The values in this file are exported to user space via |
7cc13edc EB |
12 | ** the sysctl() binary interface. Do *NOT* change the |
13 | ** numbering of any existing values here, and do not change | |
14 | ** any numbers within any one set of values. If you have to | |
93aec204 | 15 | ** redefine an existing interface, use a new number for it. |
7cc13edc EB |
16 | ** The kernel will then return -ENOTDIR to any application using |
17 | ** the old binary interface. | |
18 | ** | |
1da177e4 LT |
19 | **************************************************************** |
20 | **************************************************************** | |
21 | */ | |
1da177e4 LT |
22 | #ifndef _LINUX_SYSCTL_H |
23 | #define _LINUX_SYSCTL_H | |
24 | ||
d4ed803c | 25 | #include <linux/list.h> |
684adca4 | 26 | #include <linux/rcupdate.h> |
f1ecf068 | 27 | #include <linux/wait.h> |
ac13ac6f | 28 | #include <linux/rbtree.h> |
e79c6a4f | 29 | #include <linux/uidgid.h> |
607ca46e | 30 | #include <uapi/linux/sysctl.h> |
1da177e4 | 31 | |
805b5d5e | 32 | /* For the /proc/sys support */ |
db3f6001 | 33 | struct completion; |
1ff007eb | 34 | struct ctl_table; |
e51b6ba0 | 35 | struct nsproxy; |
d7321cd6 | 36 | struct ctl_table_root; |
f7e6ced4 | 37 | struct ctl_table_header; |
7ec66d06 | 38 | struct ctl_dir; |
f7e6ced4 | 39 | |
eec4844f | 40 | /* Keep the same order as in fs/proc/proc_sysctl.c */ |
4c7f24f8 TZ |
41 | #define SYSCTL_ZERO ((void *)&sysctl_vals[0]) |
42 | #define SYSCTL_ONE ((void *)&sysctl_vals[1]) | |
43 | #define SYSCTL_TWO ((void *)&sysctl_vals[2]) | |
44 | #define SYSCTL_THREE ((void *)&sysctl_vals[3]) | |
78e36f3b XN |
45 | #define SYSCTL_FOUR ((void *)&sysctl_vals[4]) |
46 | #define SYSCTL_ONE_HUNDRED ((void *)&sysctl_vals[5]) | |
47 | #define SYSCTL_TWO_HUNDRED ((void *)&sysctl_vals[6]) | |
48 | #define SYSCTL_ONE_THOUSAND ((void *)&sysctl_vals[7]) | |
49 | #define SYSCTL_THREE_THOUSAND ((void *)&sysctl_vals[8]) | |
50 | #define SYSCTL_INT_MAX ((void *)&sysctl_vals[9]) | |
eec4844f | 51 | |
54771613 LC |
52 | /* this is needed for the proc_dointvec_minmax for [fs_]overflow UID and GID */ |
53 | #define SYSCTL_MAXOLDUID ((void *)&sysctl_vals[10]) | |
4c7f24f8 | 54 | #define SYSCTL_NEG_ONE ((void *)&sysctl_vals[11]) |
54771613 | 55 | |
eec4844f MC |
56 | extern const int sysctl_vals[]; |
57 | ||
b1f2aff8 LC |
58 | #define SYSCTL_LONG_ZERO ((void *)&sysctl_long_vals[0]) |
59 | #define SYSCTL_LONG_ONE ((void *)&sysctl_long_vals[1]) | |
60 | #define SYSCTL_LONG_MAX ((void *)&sysctl_long_vals[2]) | |
61 | ||
62 | extern const unsigned long sysctl_long_vals[]; | |
63 | ||
32927393 CH |
64 | typedef int proc_handler(struct ctl_table *ctl, int write, void *buffer, |
65 | size_t *lenp, loff_t *ppos); | |
66 | ||
67 | int proc_dostring(struct ctl_table *, int, void *, size_t *, loff_t *); | |
a2071573 JH |
68 | int proc_dobool(struct ctl_table *table, int write, void *buffer, |
69 | size_t *lenp, loff_t *ppos); | |
32927393 CH |
70 | int proc_dointvec(struct ctl_table *, int, void *, size_t *, loff_t *); |
71 | int proc_douintvec(struct ctl_table *, int, void *, size_t *, loff_t *); | |
72 | int proc_dointvec_minmax(struct ctl_table *, int, void *, size_t *, loff_t *); | |
73 | int proc_douintvec_minmax(struct ctl_table *table, int write, void *buffer, | |
74 | size_t *lenp, loff_t *ppos); | |
cb944413 ED |
75 | int proc_dou8vec_minmax(struct ctl_table *table, int write, void *buffer, |
76 | size_t *lenp, loff_t *ppos); | |
32927393 | 77 | int proc_dointvec_jiffies(struct ctl_table *, int, void *, size_t *, loff_t *); |
c381d02b YW |
78 | int proc_dointvec_ms_jiffies_minmax(struct ctl_table *table, int write, |
79 | void *buffer, size_t *lenp, loff_t *ppos); | |
32927393 CH |
80 | int proc_dointvec_userhz_jiffies(struct ctl_table *, int, void *, size_t *, |
81 | loff_t *); | |
82 | int proc_dointvec_ms_jiffies(struct ctl_table *, int, void *, size_t *, | |
83 | loff_t *); | |
84 | int proc_doulongvec_minmax(struct ctl_table *, int, void *, size_t *, loff_t *); | |
85 | int proc_doulongvec_ms_jiffies_minmax(struct ctl_table *table, int, void *, | |
86 | size_t *, loff_t *); | |
87 | int proc_do_large_bitmap(struct ctl_table *, int, void *, size_t *, loff_t *); | |
88 | int proc_do_static_key(struct ctl_table *table, int write, void *buffer, | |
89 | size_t *lenp, loff_t *ppos); | |
1da177e4 | 90 | |
1da177e4 LT |
91 | /* |
92 | * Register a set of sysctl names by calling register_sysctl_table | |
2315ffa0 EB |
93 | * with an initialised array of struct ctl_table's. An entry with |
94 | * NULL procname terminates the table. table->de will be | |
d99f160a | 95 | * set up by the registration and need not be initialised in advance. |
1da177e4 LT |
96 | * |
97 | * sysctl names can be mirrored automatically under /proc/sys. The | |
98 | * procname supplied controls /proc naming. | |
99 | * | |
88db0aa2 | 100 | * The table's mode will be honoured for proc-fs access. |
1da177e4 LT |
101 | * |
102 | * Leaf nodes in the sysctl tree will be represented by a single file | |
103 | * under /proc; non-leaf nodes will be represented by directories. A | |
104 | * null procname disables /proc mirroring at this node. | |
d99f160a | 105 | * |
88db0aa2 | 106 | * The data and maxlen fields of the ctl_table |
1da177e4 LT |
107 | * struct enable minimal validation of the values being written to be |
108 | * performed, and the mode field allows minimal authentication. | |
109 | * | |
1da177e4 LT |
110 | * There must be a proc_handler routine for any terminal nodes |
111 | * mirrored under /proc/sys (non-terminals are handled by a built-in | |
112 | * directory handler). Several default handlers are available to | |
113 | * cover common cases. | |
114 | */ | |
115 | ||
f1ecf068 LDM |
116 | /* Support for userspace poll() to watch for changes */ |
117 | struct ctl_table_poll { | |
118 | atomic_t event; | |
119 | wait_queue_head_t wait; | |
120 | }; | |
121 | ||
122 | static inline void *proc_sys_poll_event(struct ctl_table_poll *poll) | |
123 | { | |
124 | return (void *)(unsigned long)atomic_read(&poll->event); | |
125 | } | |
126 | ||
f1ecf068 LDM |
127 | #define __CTL_TABLE_POLL_INITIALIZER(name) { \ |
128 | .event = ATOMIC_INIT(0), \ | |
129 | .wait = __WAIT_QUEUE_HEAD_INITIALIZER(name.wait) } | |
130 | ||
131 | #define DEFINE_CTL_TABLE_POLL(name) \ | |
132 | struct ctl_table_poll name = __CTL_TABLE_POLL_INITIALIZER(name) | |
133 | ||
1da177e4 | 134 | /* A sysctl table is an array of struct ctl_table: */ |
d5ffb71b | 135 | struct ctl_table { |
1da177e4 LT |
136 | const char *procname; /* Text ID for /proc/sys, or zero */ |
137 | void *data; | |
138 | int maxlen; | |
36fcb589 | 139 | umode_t mode; |
f728019b | 140 | struct ctl_table *child; /* Deprecated */ |
1da177e4 | 141 | proc_handler *proc_handler; /* Callback for text formatting */ |
f1ecf068 | 142 | struct ctl_table_poll *poll; |
1da177e4 LT |
143 | void *extra1; |
144 | void *extra2; | |
3859a271 | 145 | } __randomize_layout; |
1da177e4 | 146 | |
ac13ac6f EB |
147 | struct ctl_node { |
148 | struct rb_node node; | |
149 | struct ctl_table_header *header; | |
150 | }; | |
151 | ||
1da177e4 | 152 | /* struct ctl_table_header is used to maintain dynamic lists of |
d8217f07 | 153 | struct ctl_table trees. */ |
d5ffb71b | 154 | struct ctl_table_header { |
dfef6dcd AV |
155 | union { |
156 | struct { | |
157 | struct ctl_table *ctl_table; | |
dfef6dcd AV |
158 | int used; |
159 | int count; | |
938aaa4f | 160 | int nreg; |
dfef6dcd AV |
161 | }; |
162 | struct rcu_head rcu; | |
163 | }; | |
330d57fb | 164 | struct completion *unregistering; |
23eb06de | 165 | struct ctl_table *ctl_table_arg; |
e51b6ba0 | 166 | struct ctl_table_root *root; |
73455092 | 167 | struct ctl_table_set *set; |
7ec66d06 | 168 | struct ctl_dir *parent; |
ac13ac6f | 169 | struct ctl_node *node; |
2fd1d2c4 | 170 | struct hlist_head inodes; /* head for proc_inode->sysctl_inodes */ |
7ec66d06 EB |
171 | }; |
172 | ||
173 | struct ctl_dir { | |
174 | /* Header must be at the start of ctl_dir */ | |
175 | struct ctl_table_header header; | |
ac13ac6f | 176 | struct rb_root root; |
1da177e4 LT |
177 | }; |
178 | ||
0ce8974d | 179 | struct ctl_table_set { |
0ce8974d | 180 | int (*is_seen)(struct ctl_table_set *); |
0e47c99d | 181 | struct ctl_dir dir; |
0ce8974d EB |
182 | }; |
183 | ||
184 | struct ctl_table_root { | |
0ce8974d | 185 | struct ctl_table_set default_set; |
13bcc6a2 | 186 | struct ctl_table_set *(*lookup)(struct ctl_table_root *root); |
e79c6a4f DT |
187 | void (*set_ownership)(struct ctl_table_header *head, |
188 | struct ctl_table *table, | |
189 | kuid_t *uid, kgid_t *gid); | |
73f7ef43 | 190 | int (*permissions)(struct ctl_table_header *head, struct ctl_table *table); |
0ce8974d EB |
191 | }; |
192 | ||
29e796fd EB |
193 | /* struct ctl_path describes where in the hierarchy a table is added */ |
194 | struct ctl_path { | |
195 | const char *procname; | |
29e796fd EB |
196 | }; |
197 | ||
0ce8974d EB |
198 | #ifdef CONFIG_SYSCTL |
199 | ||
51cb8dfc LC |
200 | #define DECLARE_SYSCTL_BASE(_name, _table) \ |
201 | static struct ctl_table _name##_base_table[] = { \ | |
202 | { \ | |
203 | .procname = #_name, \ | |
204 | .mode = 0555, \ | |
205 | .child = _table, \ | |
206 | }, \ | |
207 | { }, \ | |
208 | } | |
209 | ||
210 | extern int __register_sysctl_base(struct ctl_table *base_table); | |
211 | ||
212 | #define register_sysctl_base(_name) __register_sysctl_base(_name##_base_table) | |
213 | ||
0ce8974d EB |
214 | void proc_sys_poll_notify(struct ctl_table_poll *poll); |
215 | ||
216 | extern void setup_sysctl_set(struct ctl_table_set *p, | |
9eb47c26 | 217 | struct ctl_table_root *root, |
0ce8974d | 218 | int (*is_seen)(struct ctl_table_set *)); |
97324cd8 | 219 | extern void retire_sysctl_set(struct ctl_table_set *set); |
0ce8974d | 220 | |
6e9d5164 | 221 | struct ctl_table_header *__register_sysctl_table( |
60a47a2e | 222 | struct ctl_table_set *set, |
6e9d5164 | 223 | const char *path, struct ctl_table *table); |
fea478d4 | 224 | struct ctl_table_header *register_sysctl(const char *path, struct ctl_table *table); |
d8217f07 | 225 | struct ctl_table_header *register_sysctl_table(struct ctl_table * table); |
1da177e4 LT |
226 | void unregister_sysctl_table(struct ctl_table_header * table); |
227 | ||
d8c0418a | 228 | extern int sysctl_init_bases(void); |
3ddd9a80 XN |
229 | extern void __register_sysctl_init(const char *path, struct ctl_table *table, |
230 | const char *table_name); | |
231 | #define register_sysctl_init(path, table) __register_sysctl_init(path, table, #table) | |
ee9efac4 LC |
232 | extern struct ctl_table_header *register_sysctl_mount_point(const char *path); |
233 | ||
3db978d4 | 234 | void do_sysctl_args(void); |
1998f193 LC |
235 | int do_proc_douintvec(struct ctl_table *table, int write, |
236 | void *buffer, size_t *lenp, loff_t *ppos, | |
237 | int (*conv)(unsigned long *lvalp, | |
238 | unsigned int *valp, | |
239 | int write, void *data), | |
240 | void *data); | |
f9bd6733 | 241 | |
2374c09b CH |
242 | extern int pwrsw_enabled; |
243 | extern int unaligned_enabled; | |
244 | extern int unaligned_dump_stack; | |
245 | extern int no_unaligned_warning; | |
246 | ||
f9bd6733 EB |
247 | extern struct ctl_table sysctl_mount_point[]; |
248 | ||
0ce8974d | 249 | #else /* CONFIG_SYSCTL */ |
51cb8dfc LC |
250 | |
251 | #define DECLARE_SYSCTL_BASE(_name, _table) | |
252 | ||
253 | static inline int __register_sysctl_base(struct ctl_table *base_table) | |
254 | { | |
255 | return 0; | |
256 | } | |
257 | ||
258 | #define register_sysctl_base(table) __register_sysctl_base(table) | |
259 | ||
0ce8974d EB |
260 | static inline struct ctl_table_header *register_sysctl_table(struct ctl_table * table) |
261 | { | |
262 | return NULL; | |
263 | } | |
264 | ||
6213834c MS |
265 | static inline void register_sysctl_init(const char *path, struct ctl_table *table) |
266 | { | |
267 | } | |
268 | ||
6cb91741 | 269 | static inline struct ctl_table_header *register_sysctl_mount_point(const char *path) |
ee9efac4 LC |
270 | { |
271 | return NULL; | |
272 | } | |
273 | ||
e609a6b8 AB |
274 | static inline struct ctl_table_header *register_sysctl(const char *path, struct ctl_table *table) |
275 | { | |
276 | return NULL; | |
277 | } | |
278 | ||
0ce8974d EB |
279 | static inline void unregister_sysctl_table(struct ctl_table_header * table) |
280 | { | |
281 | } | |
282 | ||
283 | static inline void setup_sysctl_set(struct ctl_table_set *p, | |
9eb47c26 | 284 | struct ctl_table_root *root, |
0ce8974d EB |
285 | int (*is_seen)(struct ctl_table_set *)) |
286 | { | |
287 | } | |
288 | ||
3db978d4 VB |
289 | static inline void do_sysctl_args(void) |
290 | { | |
291 | } | |
0ce8974d EB |
292 | #endif /* CONFIG_SYSCTL */ |
293 | ||
32927393 CH |
294 | int sysctl_max_threads(struct ctl_table *table, int write, void *buffer, |
295 | size_t *lenp, loff_t *ppos); | |
16db3d3f | 296 | |
1da177e4 | 297 | #endif /* _LINUX_SYSCTL_H */ |