]>
Commit | Line | Data |
---|---|---|
b8441ed2 TH |
1 | /* |
2 | * kernfs.h - pseudo filesystem decoupled from vfs locking | |
3 | * | |
4 | * This file is released under the GPLv2. | |
5 | */ | |
6 | ||
7 | #ifndef __LINUX_KERNFS_H | |
8 | #define __LINUX_KERNFS_H | |
9 | ||
879f40d1 | 10 | #include <linux/kernel.h> |
5d0e26bb | 11 | #include <linux/err.h> |
dd8a5b03 TH |
12 | #include <linux/list.h> |
13 | #include <linux/mutex.h> | |
bc755553 | 14 | #include <linux/idr.h> |
517e64f5 | 15 | #include <linux/lockdep.h> |
cf9e5a73 TH |
16 | #include <linux/rbtree.h> |
17 | #include <linux/atomic.h> | |
630d0eb6 | 18 | #include <linux/uidgid.h> |
abd54f02 | 19 | #include <linux/wait.h> |
879f40d1 | 20 | |
5d60418e | 21 | struct file; |
917f56ca | 22 | struct dentry; |
5d60418e | 23 | struct iattr; |
dd8a5b03 TH |
24 | struct seq_file; |
25 | struct vm_area_struct; | |
4b93dc9b TH |
26 | struct super_block; |
27 | struct file_system_type; | |
5d60418e | 28 | |
c525aadd TH |
29 | struct kernfs_open_node; |
30 | struct kernfs_iattrs; | |
cf9e5a73 TH |
31 | |
32 | enum kernfs_node_type { | |
df23fc39 TH |
33 | KERNFS_DIR = 0x0001, |
34 | KERNFS_FILE = 0x0002, | |
35 | KERNFS_LINK = 0x0004, | |
cf9e5a73 TH |
36 | }; |
37 | ||
df23fc39 | 38 | #define KERNFS_TYPE_MASK 0x000f |
df23fc39 | 39 | #define KERNFS_FLAG_MASK ~KERNFS_TYPE_MASK |
cf9e5a73 TH |
40 | |
41 | enum kernfs_node_flag { | |
d35258ef | 42 | KERNFS_ACTIVATED = 0x0010, |
df23fc39 TH |
43 | KERNFS_NS = 0x0020, |
44 | KERNFS_HAS_SEQ_SHOW = 0x0040, | |
45 | KERNFS_HAS_MMAP = 0x0080, | |
46 | KERNFS_LOCKDEP = 0x0100, | |
6b0afc2a TH |
47 | KERNFS_SUICIDAL = 0x0400, |
48 | KERNFS_SUICIDED = 0x0800, | |
ea015218 | 49 | KERNFS_EMPTY_DIR = 0x1000, |
0e67db2f | 50 | KERNFS_HAS_RELEASE = 0x2000, |
cf9e5a73 TH |
51 | }; |
52 | ||
d35258ef TH |
53 | /* @flags for kernfs_create_root() */ |
54 | enum kernfs_root_flag { | |
555724a8 TH |
55 | /* |
56 | * kernfs_nodes are created in the deactivated state and invisible. | |
57 | * They require explicit kernfs_activate() to become visible. This | |
58 | * can be used to make related nodes become visible atomically | |
59 | * after all nodes are created successfully. | |
60 | */ | |
61 | KERNFS_ROOT_CREATE_DEACTIVATED = 0x0001, | |
62 | ||
63 | /* | |
64 | * For regular flies, if the opener has CAP_DAC_OVERRIDE, open(2) | |
65 | * succeeds regardless of the RW permissions. sysfs had an extra | |
66 | * layer of enforcement where open(2) fails with -EACCES regardless | |
67 | * of CAP_DAC_OVERRIDE if the permission doesn't have the | |
68 | * respective read or write access at all (none of S_IRUGO or | |
69 | * S_IWUGO) or the respective operation isn't implemented. The | |
70 | * following flag enables that behavior. | |
71 | */ | |
72 | KERNFS_ROOT_EXTRA_OPEN_PERM_CHECK = 0x0002, | |
aa818825 SL |
73 | |
74 | /* | |
75 | * The filesystem supports exportfs operation, so userspace can use | |
76 | * fhandle to access nodes of the fs. | |
77 | */ | |
78 | KERNFS_ROOT_SUPPORT_EXPORTOP = 0x0004, | |
d35258ef TH |
79 | }; |
80 | ||
324a56e1 TH |
81 | /* type-specific structures for kernfs_node union members */ |
82 | struct kernfs_elem_dir { | |
cf9e5a73 | 83 | unsigned long subdirs; |
adc5e8b5 | 84 | /* children rbtree starts here and goes through kn->rb */ |
cf9e5a73 TH |
85 | struct rb_root children; |
86 | ||
87 | /* | |
88 | * The kernfs hierarchy this directory belongs to. This fits | |
324a56e1 | 89 | * better directly in kernfs_node but is here to save space. |
cf9e5a73 TH |
90 | */ |
91 | struct kernfs_root *root; | |
92 | }; | |
93 | ||
324a56e1 TH |
94 | struct kernfs_elem_symlink { |
95 | struct kernfs_node *target_kn; | |
cf9e5a73 TH |
96 | }; |
97 | ||
324a56e1 | 98 | struct kernfs_elem_attr { |
cf9e5a73 | 99 | const struct kernfs_ops *ops; |
c525aadd | 100 | struct kernfs_open_node *open; |
cf9e5a73 | 101 | loff_t size; |
ecca47ce | 102 | struct kernfs_node *notify_next; /* for kernfs_notify() */ |
cf9e5a73 TH |
103 | }; |
104 | ||
c53cd490 SL |
105 | /* represent a kernfs node */ |
106 | union kernfs_node_id { | |
107 | struct { | |
aa818825 SL |
108 | /* |
109 | * blktrace will export this struct as a simplified 'struct | |
110 | * fid' (which is a big data struction), so userspace can use | |
111 | * it to find kernfs node. The layout must match the first two | |
112 | * fields of 'struct fid' exactly. | |
113 | */ | |
c53cd490 SL |
114 | u32 ino; |
115 | u32 generation; | |
116 | }; | |
117 | u64 id; | |
118 | }; | |
119 | ||
cf9e5a73 | 120 | /* |
324a56e1 TH |
121 | * kernfs_node - the building block of kernfs hierarchy. Each and every |
122 | * kernfs node is represented by single kernfs_node. Most fields are | |
cf9e5a73 TH |
123 | * private to kernfs and shouldn't be accessed directly by kernfs users. |
124 | * | |
324a56e1 TH |
125 | * As long as s_count reference is held, the kernfs_node itself is |
126 | * accessible. Dereferencing elem or any other outer entity requires | |
127 | * active reference. | |
cf9e5a73 | 128 | */ |
324a56e1 | 129 | struct kernfs_node { |
adc5e8b5 TH |
130 | atomic_t count; |
131 | atomic_t active; | |
cf9e5a73 TH |
132 | #ifdef CONFIG_DEBUG_LOCK_ALLOC |
133 | struct lockdep_map dep_map; | |
134 | #endif | |
3eef34ad TH |
135 | /* |
136 | * Use kernfs_get_parent() and kernfs_name/path() instead of | |
137 | * accessing the following two fields directly. If the node is | |
138 | * never moved to a different parent, it is safe to access the | |
139 | * parent directly. | |
140 | */ | |
adc5e8b5 TH |
141 | struct kernfs_node *parent; |
142 | const char *name; | |
cf9e5a73 | 143 | |
adc5e8b5 | 144 | struct rb_node rb; |
cf9e5a73 | 145 | |
adc5e8b5 | 146 | const void *ns; /* namespace tag */ |
9b0925a6 | 147 | unsigned int hash; /* ns + name hash */ |
cf9e5a73 | 148 | union { |
adc5e8b5 TH |
149 | struct kernfs_elem_dir dir; |
150 | struct kernfs_elem_symlink symlink; | |
151 | struct kernfs_elem_attr attr; | |
cf9e5a73 TH |
152 | }; |
153 | ||
154 | void *priv; | |
155 | ||
c53cd490 | 156 | union kernfs_node_id id; |
adc5e8b5 TH |
157 | unsigned short flags; |
158 | umode_t mode; | |
c525aadd | 159 | struct kernfs_iattrs *iattr; |
cf9e5a73 | 160 | }; |
b8441ed2 | 161 | |
80b9bbef | 162 | /* |
90c07c89 TH |
163 | * kernfs_syscall_ops may be specified on kernfs_create_root() to support |
164 | * syscalls. These optional callbacks are invoked on the matching syscalls | |
165 | * and can perform any kernfs operations which don't necessarily have to be | |
166 | * the exact operation requested. An active reference is held for each | |
167 | * kernfs_node parameter. | |
80b9bbef | 168 | */ |
90c07c89 | 169 | struct kernfs_syscall_ops { |
6a7fed4e TH |
170 | int (*remount_fs)(struct kernfs_root *root, int *flags, char *data); |
171 | int (*show_options)(struct seq_file *sf, struct kernfs_root *root); | |
172 | ||
80b9bbef TH |
173 | int (*mkdir)(struct kernfs_node *parent, const char *name, |
174 | umode_t mode); | |
175 | int (*rmdir)(struct kernfs_node *kn); | |
176 | int (*rename)(struct kernfs_node *kn, struct kernfs_node *new_parent, | |
177 | const char *new_name); | |
4f41fc59 SH |
178 | int (*show_path)(struct seq_file *sf, struct kernfs_node *kn, |
179 | struct kernfs_root *root); | |
80b9bbef TH |
180 | }; |
181 | ||
ba7443bc TH |
182 | struct kernfs_root { |
183 | /* published fields */ | |
324a56e1 | 184 | struct kernfs_node *kn; |
d35258ef | 185 | unsigned int flags; /* KERNFS_ROOT_* flags */ |
bc755553 TH |
186 | |
187 | /* private fields, do not use outside kernfs proper */ | |
7d35079f | 188 | struct idr ino_idr; |
4a3ef68a | 189 | u32 next_generation; |
90c07c89 | 190 | struct kernfs_syscall_ops *syscall_ops; |
7d568a83 TH |
191 | |
192 | /* list of kernfs_super_info of this root, protected by kernfs_mutex */ | |
193 | struct list_head supers; | |
194 | ||
abd54f02 | 195 | wait_queue_head_t deactivate_waitq; |
ba7443bc TH |
196 | }; |
197 | ||
c525aadd | 198 | struct kernfs_open_file { |
dd8a5b03 | 199 | /* published fields */ |
324a56e1 | 200 | struct kernfs_node *kn; |
dd8a5b03 | 201 | struct file *file; |
0e67db2f | 202 | struct seq_file *seq_file; |
2536390d | 203 | void *priv; |
dd8a5b03 TH |
204 | |
205 | /* private fields, do not use outside kernfs proper */ | |
206 | struct mutex mutex; | |
e4234a1f | 207 | struct mutex prealloc_mutex; |
dd8a5b03 TH |
208 | int event; |
209 | struct list_head list; | |
2b75869b | 210 | char *prealloc_buf; |
dd8a5b03 | 211 | |
b7ce40cf | 212 | size_t atomic_write_len; |
a1d82aff | 213 | bool mmapped:1; |
0e67db2f | 214 | bool released:1; |
dd8a5b03 TH |
215 | const struct vm_operations_struct *vm_ops; |
216 | }; | |
217 | ||
f6acf8bb | 218 | struct kernfs_ops { |
0e67db2f TH |
219 | /* |
220 | * Optional open/release methods. Both are called with | |
221 | * @of->seq_file populated. | |
222 | */ | |
223 | int (*open)(struct kernfs_open_file *of); | |
224 | void (*release)(struct kernfs_open_file *of); | |
225 | ||
f6acf8bb TH |
226 | /* |
227 | * Read is handled by either seq_file or raw_read(). | |
228 | * | |
d19b9846 TH |
229 | * If seq_show() is present, seq_file path is active. Other seq |
230 | * operations are optional and if not implemented, the behavior is | |
231 | * equivalent to single_open(). @sf->private points to the | |
c525aadd | 232 | * associated kernfs_open_file. |
f6acf8bb TH |
233 | * |
234 | * read() is bounced through kernel buffer and a read larger than | |
235 | * PAGE_SIZE results in partial operation of PAGE_SIZE. | |
236 | */ | |
237 | int (*seq_show)(struct seq_file *sf, void *v); | |
d19b9846 TH |
238 | |
239 | void *(*seq_start)(struct seq_file *sf, loff_t *ppos); | |
240 | void *(*seq_next)(struct seq_file *sf, void *v, loff_t *ppos); | |
241 | void (*seq_stop)(struct seq_file *sf, void *v); | |
f6acf8bb | 242 | |
c525aadd | 243 | ssize_t (*read)(struct kernfs_open_file *of, char *buf, size_t bytes, |
f6acf8bb TH |
244 | loff_t off); |
245 | ||
246 | /* | |
4d3773c4 TH |
247 | * write() is bounced through kernel buffer. If atomic_write_len |
248 | * is not set, a write larger than PAGE_SIZE results in partial | |
249 | * operations of PAGE_SIZE chunks. If atomic_write_len is set, | |
250 | * writes upto the specified size are executed atomically but | |
251 | * larger ones are rejected with -E2BIG. | |
f6acf8bb | 252 | */ |
4d3773c4 | 253 | size_t atomic_write_len; |
2b75869b N |
254 | /* |
255 | * "prealloc" causes a buffer to be allocated at open for | |
256 | * all read/write requests. As ->seq_show uses seq_read() | |
257 | * which does its own allocation, it is incompatible with | |
258 | * ->prealloc. Provide ->read and ->write with ->prealloc. | |
259 | */ | |
260 | bool prealloc; | |
c525aadd | 261 | ssize_t (*write)(struct kernfs_open_file *of, char *buf, size_t bytes, |
f6acf8bb TH |
262 | loff_t off); |
263 | ||
c525aadd | 264 | int (*mmap)(struct kernfs_open_file *of, struct vm_area_struct *vma); |
517e64f5 TH |
265 | |
266 | #ifdef CONFIG_DEBUG_LOCK_ALLOC | |
267 | struct lock_class_key lockdep_key; | |
268 | #endif | |
f6acf8bb TH |
269 | }; |
270 | ||
ba341d55 | 271 | #ifdef CONFIG_KERNFS |
879f40d1 | 272 | |
df23fc39 | 273 | static inline enum kernfs_node_type kernfs_type(struct kernfs_node *kn) |
cf9e5a73 | 274 | { |
df23fc39 | 275 | return kn->flags & KERNFS_TYPE_MASK; |
cf9e5a73 TH |
276 | } |
277 | ||
278 | /** | |
279 | * kernfs_enable_ns - enable namespace under a directory | |
324a56e1 | 280 | * @kn: directory of interest, should be empty |
cf9e5a73 | 281 | * |
324a56e1 TH |
282 | * This is to be called right after @kn is created to enable namespace |
283 | * under it. All children of @kn must have non-NULL namespace tags and | |
cf9e5a73 TH |
284 | * only the ones which match the super_block's tag will be visible. |
285 | */ | |
324a56e1 | 286 | static inline void kernfs_enable_ns(struct kernfs_node *kn) |
cf9e5a73 | 287 | { |
df23fc39 | 288 | WARN_ON_ONCE(kernfs_type(kn) != KERNFS_DIR); |
adc5e8b5 | 289 | WARN_ON_ONCE(!RB_EMPTY_ROOT(&kn->dir.children)); |
df23fc39 | 290 | kn->flags |= KERNFS_NS; |
cf9e5a73 TH |
291 | } |
292 | ||
ac9bba03 TH |
293 | /** |
294 | * kernfs_ns_enabled - test whether namespace is enabled | |
324a56e1 | 295 | * @kn: the node to test |
ac9bba03 TH |
296 | * |
297 | * Test whether namespace filtering is enabled for the children of @ns. | |
298 | */ | |
324a56e1 | 299 | static inline bool kernfs_ns_enabled(struct kernfs_node *kn) |
ac9bba03 | 300 | { |
df23fc39 | 301 | return kn->flags & KERNFS_NS; |
ac9bba03 TH |
302 | } |
303 | ||
3eef34ad | 304 | int kernfs_name(struct kernfs_node *kn, char *buf, size_t buflen); |
9f6df573 AK |
305 | int kernfs_path_from_node(struct kernfs_node *root_kn, struct kernfs_node *kn, |
306 | char *buf, size_t buflen); | |
3eef34ad TH |
307 | void pr_cont_kernfs_name(struct kernfs_node *kn); |
308 | void pr_cont_kernfs_path(struct kernfs_node *kn); | |
309 | struct kernfs_node *kernfs_get_parent(struct kernfs_node *kn); | |
324a56e1 TH |
310 | struct kernfs_node *kernfs_find_and_get_ns(struct kernfs_node *parent, |
311 | const char *name, const void *ns); | |
bd96f76a TH |
312 | struct kernfs_node *kernfs_walk_and_get_ns(struct kernfs_node *parent, |
313 | const char *path, const void *ns); | |
324a56e1 TH |
314 | void kernfs_get(struct kernfs_node *kn); |
315 | void kernfs_put(struct kernfs_node *kn); | |
ccf73cf3 | 316 | |
0c23b225 TH |
317 | struct kernfs_node *kernfs_node_from_dentry(struct dentry *dentry); |
318 | struct kernfs_root *kernfs_root_from_sb(struct super_block *sb); | |
fb02915f | 319 | struct inode *kernfs_get_inode(struct super_block *sb, struct kernfs_node *kn); |
0c23b225 | 320 | |
fb3c8315 AK |
321 | struct dentry *kernfs_node_dentry(struct kernfs_node *kn, |
322 | struct super_block *sb); | |
90c07c89 | 323 | struct kernfs_root *kernfs_create_root(struct kernfs_syscall_ops *scops, |
d35258ef | 324 | unsigned int flags, void *priv); |
ba7443bc TH |
325 | void kernfs_destroy_root(struct kernfs_root *root); |
326 | ||
324a56e1 | 327 | struct kernfs_node *kernfs_create_dir_ns(struct kernfs_node *parent, |
bb8b9d09 | 328 | const char *name, umode_t mode, |
630d0eb6 | 329 | kuid_t uid, kgid_t gid, |
bb8b9d09 | 330 | void *priv, const void *ns); |
ea015218 EB |
331 | struct kernfs_node *kernfs_create_empty_dir(struct kernfs_node *parent, |
332 | const char *name); | |
2063d608 | 333 | struct kernfs_node *__kernfs_create_file(struct kernfs_node *parent, |
630d0eb6 DT |
334 | const char *name, umode_t mode, |
335 | kuid_t uid, kgid_t gid, | |
336 | loff_t size, | |
2063d608 TH |
337 | const struct kernfs_ops *ops, |
338 | void *priv, const void *ns, | |
2063d608 | 339 | struct lock_class_key *key); |
324a56e1 TH |
340 | struct kernfs_node *kernfs_create_link(struct kernfs_node *parent, |
341 | const char *name, | |
342 | struct kernfs_node *target); | |
d35258ef | 343 | void kernfs_activate(struct kernfs_node *kn); |
324a56e1 | 344 | void kernfs_remove(struct kernfs_node *kn); |
6b0afc2a TH |
345 | void kernfs_break_active_protection(struct kernfs_node *kn); |
346 | void kernfs_unbreak_active_protection(struct kernfs_node *kn); | |
347 | bool kernfs_remove_self(struct kernfs_node *kn); | |
324a56e1 | 348 | int kernfs_remove_by_name_ns(struct kernfs_node *parent, const char *name, |
879f40d1 | 349 | const void *ns); |
324a56e1 | 350 | int kernfs_rename_ns(struct kernfs_node *kn, struct kernfs_node *new_parent, |
890ece16 | 351 | const char *new_name, const void *new_ns); |
324a56e1 TH |
352 | int kernfs_setattr(struct kernfs_node *kn, const struct iattr *iattr); |
353 | void kernfs_notify(struct kernfs_node *kn); | |
879f40d1 | 354 | |
4b93dc9b TH |
355 | const void *kernfs_super_ns(struct super_block *sb); |
356 | struct dentry *kernfs_mount_ns(struct file_system_type *fs_type, int flags, | |
26fc9cd2 JZ |
357 | struct kernfs_root *root, unsigned long magic, |
358 | bool *new_sb_created, const void *ns); | |
4b93dc9b | 359 | void kernfs_kill_sb(struct super_block *sb); |
4e26445f | 360 | struct super_block *kernfs_pin_sb(struct kernfs_root *root, const void *ns); |
4b93dc9b TH |
361 | |
362 | void kernfs_init(void); | |
363 | ||
69fd5c39 SL |
364 | struct kernfs_node *kernfs_get_node_by_id(struct kernfs_root *root, |
365 | const union kernfs_node_id *id); | |
ba341d55 | 366 | #else /* CONFIG_KERNFS */ |
879f40d1 | 367 | |
df23fc39 | 368 | static inline enum kernfs_node_type kernfs_type(struct kernfs_node *kn) |
cf9e5a73 TH |
369 | { return 0; } /* whatever */ |
370 | ||
324a56e1 | 371 | static inline void kernfs_enable_ns(struct kernfs_node *kn) { } |
cf9e5a73 | 372 | |
324a56e1 | 373 | static inline bool kernfs_ns_enabled(struct kernfs_node *kn) |
ac9bba03 TH |
374 | { return false; } |
375 | ||
3eef34ad TH |
376 | static inline int kernfs_name(struct kernfs_node *kn, char *buf, size_t buflen) |
377 | { return -ENOSYS; } | |
378 | ||
0e0b2afd TH |
379 | static inline int kernfs_path_from_node(struct kernfs_node *root_kn, |
380 | struct kernfs_node *kn, | |
381 | char *buf, size_t buflen) | |
382 | { return -ENOSYS; } | |
383 | ||
3eef34ad TH |
384 | static inline void pr_cont_kernfs_name(struct kernfs_node *kn) { } |
385 | static inline void pr_cont_kernfs_path(struct kernfs_node *kn) { } | |
386 | ||
387 | static inline struct kernfs_node *kernfs_get_parent(struct kernfs_node *kn) | |
388 | { return NULL; } | |
389 | ||
324a56e1 TH |
390 | static inline struct kernfs_node * |
391 | kernfs_find_and_get_ns(struct kernfs_node *parent, const char *name, | |
ccf73cf3 TH |
392 | const void *ns) |
393 | { return NULL; } | |
bd96f76a TH |
394 | static inline struct kernfs_node * |
395 | kernfs_walk_and_get_ns(struct kernfs_node *parent, const char *path, | |
396 | const void *ns) | |
397 | { return NULL; } | |
ccf73cf3 | 398 | |
324a56e1 TH |
399 | static inline void kernfs_get(struct kernfs_node *kn) { } |
400 | static inline void kernfs_put(struct kernfs_node *kn) { } | |
ccf73cf3 | 401 | |
0c23b225 TH |
402 | static inline struct kernfs_node *kernfs_node_from_dentry(struct dentry *dentry) |
403 | { return NULL; } | |
404 | ||
405 | static inline struct kernfs_root *kernfs_root_from_sb(struct super_block *sb) | |
406 | { return NULL; } | |
407 | ||
fb02915f TH |
408 | static inline struct inode * |
409 | kernfs_get_inode(struct super_block *sb, struct kernfs_node *kn) | |
410 | { return NULL; } | |
411 | ||
80b9bbef | 412 | static inline struct kernfs_root * |
d35258ef TH |
413 | kernfs_create_root(struct kernfs_syscall_ops *scops, unsigned int flags, |
414 | void *priv) | |
ba7443bc TH |
415 | { return ERR_PTR(-ENOSYS); } |
416 | ||
417 | static inline void kernfs_destroy_root(struct kernfs_root *root) { } | |
418 | ||
324a56e1 | 419 | static inline struct kernfs_node * |
bb8b9d09 | 420 | kernfs_create_dir_ns(struct kernfs_node *parent, const char *name, |
630d0eb6 DT |
421 | umode_t mode, kuid_t uid, kgid_t gid, |
422 | void *priv, const void *ns) | |
93b2b8e4 TH |
423 | { return ERR_PTR(-ENOSYS); } |
424 | ||
324a56e1 | 425 | static inline struct kernfs_node * |
2063d608 | 426 | __kernfs_create_file(struct kernfs_node *parent, const char *name, |
630d0eb6 DT |
427 | umode_t mode, kuid_t uid, kgid_t gid, |
428 | loff_t size, const struct kernfs_ops *ops, | |
dfeb0750 | 429 | void *priv, const void *ns, struct lock_class_key *key) |
496f7394 TH |
430 | { return ERR_PTR(-ENOSYS); } |
431 | ||
324a56e1 TH |
432 | static inline struct kernfs_node * |
433 | kernfs_create_link(struct kernfs_node *parent, const char *name, | |
434 | struct kernfs_node *target) | |
5d0e26bb TH |
435 | { return ERR_PTR(-ENOSYS); } |
436 | ||
d35258ef TH |
437 | static inline void kernfs_activate(struct kernfs_node *kn) { } |
438 | ||
324a56e1 | 439 | static inline void kernfs_remove(struct kernfs_node *kn) { } |
879f40d1 | 440 | |
6b0afc2a TH |
441 | static inline bool kernfs_remove_self(struct kernfs_node *kn) |
442 | { return false; } | |
443 | ||
324a56e1 | 444 | static inline int kernfs_remove_by_name_ns(struct kernfs_node *kn, |
879f40d1 TH |
445 | const char *name, const void *ns) |
446 | { return -ENOSYS; } | |
447 | ||
324a56e1 TH |
448 | static inline int kernfs_rename_ns(struct kernfs_node *kn, |
449 | struct kernfs_node *new_parent, | |
890ece16 TH |
450 | const char *new_name, const void *new_ns) |
451 | { return -ENOSYS; } | |
452 | ||
324a56e1 | 453 | static inline int kernfs_setattr(struct kernfs_node *kn, |
5d60418e TH |
454 | const struct iattr *iattr) |
455 | { return -ENOSYS; } | |
456 | ||
324a56e1 | 457 | static inline void kernfs_notify(struct kernfs_node *kn) { } |
024f6471 | 458 | |
4b93dc9b TH |
459 | static inline const void *kernfs_super_ns(struct super_block *sb) |
460 | { return NULL; } | |
461 | ||
462 | static inline struct dentry * | |
463 | kernfs_mount_ns(struct file_system_type *fs_type, int flags, | |
26fc9cd2 JZ |
464 | struct kernfs_root *root, unsigned long magic, |
465 | bool *new_sb_created, const void *ns) | |
4b93dc9b TH |
466 | { return ERR_PTR(-ENOSYS); } |
467 | ||
468 | static inline void kernfs_kill_sb(struct super_block *sb) { } | |
469 | ||
470 | static inline void kernfs_init(void) { } | |
471 | ||
ba341d55 | 472 | #endif /* CONFIG_KERNFS */ |
879f40d1 | 473 | |
3abb1d90 TH |
474 | /** |
475 | * kernfs_path - build full path of a given node | |
476 | * @kn: kernfs_node of interest | |
477 | * @buf: buffer to copy @kn's name into | |
478 | * @buflen: size of @buf | |
479 | * | |
480 | * Builds and returns the full path of @kn in @buf of @buflen bytes. The | |
481 | * path is built from the end of @buf so the returned pointer usually | |
482 | * doesn't match @buf. If @buf isn't long enough, @buf is nul terminated | |
483 | * and %NULL is returned. | |
484 | */ | |
485 | static inline int kernfs_path(struct kernfs_node *kn, char *buf, size_t buflen) | |
486 | { | |
487 | return kernfs_path_from_node(kn, NULL, buf, buflen); | |
488 | } | |
489 | ||
324a56e1 TH |
490 | static inline struct kernfs_node * |
491 | kernfs_find_and_get(struct kernfs_node *kn, const char *name) | |
ccf73cf3 | 492 | { |
324a56e1 | 493 | return kernfs_find_and_get_ns(kn, name, NULL); |
ccf73cf3 TH |
494 | } |
495 | ||
bd96f76a TH |
496 | static inline struct kernfs_node * |
497 | kernfs_walk_and_get(struct kernfs_node *kn, const char *path) | |
498 | { | |
499 | return kernfs_walk_and_get_ns(kn, path, NULL); | |
500 | } | |
501 | ||
324a56e1 | 502 | static inline struct kernfs_node * |
bb8b9d09 TH |
503 | kernfs_create_dir(struct kernfs_node *parent, const char *name, umode_t mode, |
504 | void *priv) | |
93b2b8e4 | 505 | { |
630d0eb6 DT |
506 | return kernfs_create_dir_ns(parent, name, mode, |
507 | GLOBAL_ROOT_UID, GLOBAL_ROOT_GID, | |
508 | priv, NULL); | |
93b2b8e4 TH |
509 | } |
510 | ||
324a56e1 TH |
511 | static inline struct kernfs_node * |
512 | kernfs_create_file_ns(struct kernfs_node *parent, const char *name, | |
630d0eb6 DT |
513 | umode_t mode, kuid_t uid, kgid_t gid, |
514 | loff_t size, const struct kernfs_ops *ops, | |
517e64f5 TH |
515 | void *priv, const void *ns) |
516 | { | |
517 | struct lock_class_key *key = NULL; | |
518 | ||
519 | #ifdef CONFIG_DEBUG_LOCK_ALLOC | |
520 | key = (struct lock_class_key *)&ops->lockdep_key; | |
521 | #endif | |
630d0eb6 DT |
522 | return __kernfs_create_file(parent, name, mode, uid, gid, |
523 | size, ops, priv, ns, key); | |
517e64f5 TH |
524 | } |
525 | ||
324a56e1 TH |
526 | static inline struct kernfs_node * |
527 | kernfs_create_file(struct kernfs_node *parent, const char *name, umode_t mode, | |
496f7394 TH |
528 | loff_t size, const struct kernfs_ops *ops, void *priv) |
529 | { | |
630d0eb6 DT |
530 | return kernfs_create_file_ns(parent, name, mode, |
531 | GLOBAL_ROOT_UID, GLOBAL_ROOT_GID, | |
532 | size, ops, priv, NULL); | |
496f7394 TH |
533 | } |
534 | ||
324a56e1 | 535 | static inline int kernfs_remove_by_name(struct kernfs_node *parent, |
879f40d1 TH |
536 | const char *name) |
537 | { | |
538 | return kernfs_remove_by_name_ns(parent, name, NULL); | |
539 | } | |
540 | ||
0c23b225 TH |
541 | static inline int kernfs_rename(struct kernfs_node *kn, |
542 | struct kernfs_node *new_parent, | |
543 | const char *new_name) | |
544 | { | |
545 | return kernfs_rename_ns(kn, new_parent, new_name, NULL); | |
546 | } | |
547 | ||
4b93dc9b TH |
548 | static inline struct dentry * |
549 | kernfs_mount(struct file_system_type *fs_type, int flags, | |
26fc9cd2 JZ |
550 | struct kernfs_root *root, unsigned long magic, |
551 | bool *new_sb_created) | |
4b93dc9b | 552 | { |
26fc9cd2 JZ |
553 | return kernfs_mount_ns(fs_type, flags, root, |
554 | magic, new_sb_created, NULL); | |
4b93dc9b TH |
555 | } |
556 | ||
b8441ed2 | 557 | #endif /* __LINUX_KERNFS_H */ |