]>
Commit | Line | Data |
---|---|---|
b8441ed2 TH |
1 | /* |
2 | * fs/kernfs/dir.c - kernfs directory implementation | |
3 | * | |
4 | * Copyright (c) 2001-3 Patrick Mochel | |
5 | * Copyright (c) 2007 SUSE Linux Products GmbH | |
6 | * Copyright (c) 2007, 2013 Tejun Heo <tj@kernel.org> | |
7 | * | |
8 | * This file is released under the GPLv2. | |
9 | */ | |
fd7b9f7b | 10 | |
abd54f02 | 11 | #include <linux/sched.h> |
fd7b9f7b TH |
12 | #include <linux/fs.h> |
13 | #include <linux/namei.h> | |
14 | #include <linux/idr.h> | |
15 | #include <linux/slab.h> | |
16 | #include <linux/security.h> | |
17 | #include <linux/hash.h> | |
18 | ||
19 | #include "kernfs-internal.h" | |
20 | ||
a797bfc3 | 21 | DEFINE_MUTEX(kernfs_mutex); |
3eef34ad TH |
22 | static DEFINE_SPINLOCK(kernfs_rename_lock); /* kn->parent and ->name */ |
23 | static char kernfs_pr_cont_buf[PATH_MAX]; /* protected by rename_lock */ | |
fd7b9f7b | 24 | |
adc5e8b5 | 25 | #define rb_to_kn(X) rb_entry((X), struct kernfs_node, rb) |
fd7b9f7b | 26 | |
81c173cb TH |
27 | static bool kernfs_active(struct kernfs_node *kn) |
28 | { | |
29 | lockdep_assert_held(&kernfs_mutex); | |
30 | return atomic_read(&kn->active) >= 0; | |
31 | } | |
32 | ||
182fd64b TH |
33 | static bool kernfs_lockdep(struct kernfs_node *kn) |
34 | { | |
35 | #ifdef CONFIG_DEBUG_LOCK_ALLOC | |
36 | return kn->flags & KERNFS_LOCKDEP; | |
37 | #else | |
38 | return false; | |
39 | #endif | |
40 | } | |
41 | ||
3eef34ad TH |
42 | static int kernfs_name_locked(struct kernfs_node *kn, char *buf, size_t buflen) |
43 | { | |
44 | return strlcpy(buf, kn->parent ? kn->name : "/", buflen); | |
45 | } | |
46 | ||
47 | static char * __must_check kernfs_path_locked(struct kernfs_node *kn, char *buf, | |
48 | size_t buflen) | |
49 | { | |
50 | char *p = buf + buflen; | |
51 | int len; | |
52 | ||
53 | *--p = '\0'; | |
54 | ||
55 | do { | |
56 | len = strlen(kn->name); | |
57 | if (p - buf < len + 1) { | |
58 | buf[0] = '\0'; | |
59 | p = NULL; | |
60 | break; | |
61 | } | |
62 | p -= len; | |
63 | memcpy(p, kn->name, len); | |
64 | *--p = '/'; | |
65 | kn = kn->parent; | |
66 | } while (kn && kn->parent); | |
67 | ||
68 | return p; | |
69 | } | |
70 | ||
71 | /** | |
72 | * kernfs_name - obtain the name of a given node | |
73 | * @kn: kernfs_node of interest | |
74 | * @buf: buffer to copy @kn's name into | |
75 | * @buflen: size of @buf | |
76 | * | |
77 | * Copies the name of @kn into @buf of @buflen bytes. The behavior is | |
78 | * similar to strlcpy(). It returns the length of @kn's name and if @buf | |
79 | * isn't long enough, it's filled upto @buflen-1 and nul terminated. | |
80 | * | |
81 | * This function can be called from any context. | |
82 | */ | |
83 | int kernfs_name(struct kernfs_node *kn, char *buf, size_t buflen) | |
84 | { | |
85 | unsigned long flags; | |
86 | int ret; | |
87 | ||
88 | spin_lock_irqsave(&kernfs_rename_lock, flags); | |
89 | ret = kernfs_name_locked(kn, buf, buflen); | |
90 | spin_unlock_irqrestore(&kernfs_rename_lock, flags); | |
91 | return ret; | |
92 | } | |
93 | ||
94 | /** | |
95 | * kernfs_path - build full path of a given node | |
96 | * @kn: kernfs_node of interest | |
97 | * @buf: buffer to copy @kn's name into | |
98 | * @buflen: size of @buf | |
99 | * | |
100 | * Builds and returns the full path of @kn in @buf of @buflen bytes. The | |
101 | * path is built from the end of @buf so the returned pointer usually | |
102 | * doesn't match @buf. If @buf isn't long enough, @buf is nul terminated | |
103 | * and %NULL is returned. | |
104 | */ | |
105 | char *kernfs_path(struct kernfs_node *kn, char *buf, size_t buflen) | |
106 | { | |
107 | unsigned long flags; | |
108 | char *p; | |
109 | ||
110 | spin_lock_irqsave(&kernfs_rename_lock, flags); | |
111 | p = kernfs_path_locked(kn, buf, buflen); | |
112 | spin_unlock_irqrestore(&kernfs_rename_lock, flags); | |
113 | return p; | |
114 | } | |
e61734c5 | 115 | EXPORT_SYMBOL_GPL(kernfs_path); |
3eef34ad TH |
116 | |
117 | /** | |
118 | * pr_cont_kernfs_name - pr_cont name of a kernfs_node | |
119 | * @kn: kernfs_node of interest | |
120 | * | |
121 | * This function can be called from any context. | |
122 | */ | |
123 | void pr_cont_kernfs_name(struct kernfs_node *kn) | |
124 | { | |
125 | unsigned long flags; | |
126 | ||
127 | spin_lock_irqsave(&kernfs_rename_lock, flags); | |
128 | ||
129 | kernfs_name_locked(kn, kernfs_pr_cont_buf, sizeof(kernfs_pr_cont_buf)); | |
130 | pr_cont("%s", kernfs_pr_cont_buf); | |
131 | ||
132 | spin_unlock_irqrestore(&kernfs_rename_lock, flags); | |
133 | } | |
134 | ||
135 | /** | |
136 | * pr_cont_kernfs_path - pr_cont path of a kernfs_node | |
137 | * @kn: kernfs_node of interest | |
138 | * | |
139 | * This function can be called from any context. | |
140 | */ | |
141 | void pr_cont_kernfs_path(struct kernfs_node *kn) | |
142 | { | |
143 | unsigned long flags; | |
144 | char *p; | |
145 | ||
146 | spin_lock_irqsave(&kernfs_rename_lock, flags); | |
147 | ||
148 | p = kernfs_path_locked(kn, kernfs_pr_cont_buf, | |
149 | sizeof(kernfs_pr_cont_buf)); | |
150 | if (p) | |
151 | pr_cont("%s", p); | |
152 | else | |
153 | pr_cont("<name too long>"); | |
154 | ||
155 | spin_unlock_irqrestore(&kernfs_rename_lock, flags); | |
156 | } | |
157 | ||
158 | /** | |
159 | * kernfs_get_parent - determine the parent node and pin it | |
160 | * @kn: kernfs_node of interest | |
161 | * | |
162 | * Determines @kn's parent, pins and returns it. This function can be | |
163 | * called from any context. | |
164 | */ | |
165 | struct kernfs_node *kernfs_get_parent(struct kernfs_node *kn) | |
166 | { | |
167 | struct kernfs_node *parent; | |
168 | unsigned long flags; | |
169 | ||
170 | spin_lock_irqsave(&kernfs_rename_lock, flags); | |
171 | parent = kn->parent; | |
172 | kernfs_get(parent); | |
173 | spin_unlock_irqrestore(&kernfs_rename_lock, flags); | |
174 | ||
175 | return parent; | |
176 | } | |
177 | ||
fd7b9f7b | 178 | /** |
c637b8ac | 179 | * kernfs_name_hash |
fd7b9f7b TH |
180 | * @name: Null terminated string to hash |
181 | * @ns: Namespace tag to hash | |
182 | * | |
183 | * Returns 31 bit hash of ns + name (so it fits in an off_t ) | |
184 | */ | |
c637b8ac | 185 | static unsigned int kernfs_name_hash(const char *name, const void *ns) |
fd7b9f7b TH |
186 | { |
187 | unsigned long hash = init_name_hash(); | |
188 | unsigned int len = strlen(name); | |
189 | while (len--) | |
190 | hash = partial_name_hash(*name++, hash); | |
191 | hash = (end_name_hash(hash) ^ hash_ptr((void *)ns, 31)); | |
192 | hash &= 0x7fffffffU; | |
193 | /* Reserve hash numbers 0, 1 and INT_MAX for magic directory entries */ | |
88391d49 | 194 | if (hash < 2) |
fd7b9f7b TH |
195 | hash += 2; |
196 | if (hash >= INT_MAX) | |
197 | hash = INT_MAX - 1; | |
198 | return hash; | |
199 | } | |
200 | ||
c637b8ac TH |
201 | static int kernfs_name_compare(unsigned int hash, const char *name, |
202 | const void *ns, const struct kernfs_node *kn) | |
fd7b9f7b | 203 | { |
72392ed0 RV |
204 | if (hash < kn->hash) |
205 | return -1; | |
206 | if (hash > kn->hash) | |
207 | return 1; | |
208 | if (ns < kn->ns) | |
209 | return -1; | |
210 | if (ns > kn->ns) | |
211 | return 1; | |
adc5e8b5 | 212 | return strcmp(name, kn->name); |
fd7b9f7b TH |
213 | } |
214 | ||
c637b8ac TH |
215 | static int kernfs_sd_compare(const struct kernfs_node *left, |
216 | const struct kernfs_node *right) | |
fd7b9f7b | 217 | { |
c637b8ac | 218 | return kernfs_name_compare(left->hash, left->name, left->ns, right); |
fd7b9f7b TH |
219 | } |
220 | ||
221 | /** | |
c637b8ac | 222 | * kernfs_link_sibling - link kernfs_node into sibling rbtree |
324a56e1 | 223 | * @kn: kernfs_node of interest |
fd7b9f7b | 224 | * |
324a56e1 | 225 | * Link @kn into its sibling rbtree which starts from |
adc5e8b5 | 226 | * @kn->parent->dir.children. |
fd7b9f7b TH |
227 | * |
228 | * Locking: | |
a797bfc3 | 229 | * mutex_lock(kernfs_mutex) |
fd7b9f7b TH |
230 | * |
231 | * RETURNS: | |
232 | * 0 on susccess -EEXIST on failure. | |
233 | */ | |
c637b8ac | 234 | static int kernfs_link_sibling(struct kernfs_node *kn) |
fd7b9f7b | 235 | { |
adc5e8b5 | 236 | struct rb_node **node = &kn->parent->dir.children.rb_node; |
fd7b9f7b TH |
237 | struct rb_node *parent = NULL; |
238 | ||
fd7b9f7b | 239 | while (*node) { |
324a56e1 | 240 | struct kernfs_node *pos; |
fd7b9f7b TH |
241 | int result; |
242 | ||
324a56e1 | 243 | pos = rb_to_kn(*node); |
fd7b9f7b | 244 | parent = *node; |
c637b8ac | 245 | result = kernfs_sd_compare(kn, pos); |
fd7b9f7b | 246 | if (result < 0) |
adc5e8b5 | 247 | node = &pos->rb.rb_left; |
fd7b9f7b | 248 | else if (result > 0) |
adc5e8b5 | 249 | node = &pos->rb.rb_right; |
fd7b9f7b TH |
250 | else |
251 | return -EEXIST; | |
252 | } | |
c1befb88 | 253 | |
fd7b9f7b | 254 | /* add new node and rebalance the tree */ |
adc5e8b5 TH |
255 | rb_link_node(&kn->rb, parent, node); |
256 | rb_insert_color(&kn->rb, &kn->parent->dir.children); | |
c1befb88 JZ |
257 | |
258 | /* successfully added, account subdir number */ | |
259 | if (kernfs_type(kn) == KERNFS_DIR) | |
260 | kn->parent->dir.subdirs++; | |
261 | ||
fd7b9f7b TH |
262 | return 0; |
263 | } | |
264 | ||
265 | /** | |
c637b8ac | 266 | * kernfs_unlink_sibling - unlink kernfs_node from sibling rbtree |
324a56e1 | 267 | * @kn: kernfs_node of interest |
fd7b9f7b | 268 | * |
35beab06 TH |
269 | * Try to unlink @kn from its sibling rbtree which starts from |
270 | * kn->parent->dir.children. Returns %true if @kn was actually | |
271 | * removed, %false if @kn wasn't on the rbtree. | |
fd7b9f7b TH |
272 | * |
273 | * Locking: | |
a797bfc3 | 274 | * mutex_lock(kernfs_mutex) |
fd7b9f7b | 275 | */ |
35beab06 | 276 | static bool kernfs_unlink_sibling(struct kernfs_node *kn) |
fd7b9f7b | 277 | { |
35beab06 TH |
278 | if (RB_EMPTY_NODE(&kn->rb)) |
279 | return false; | |
280 | ||
df23fc39 | 281 | if (kernfs_type(kn) == KERNFS_DIR) |
adc5e8b5 | 282 | kn->parent->dir.subdirs--; |
fd7b9f7b | 283 | |
adc5e8b5 | 284 | rb_erase(&kn->rb, &kn->parent->dir.children); |
35beab06 TH |
285 | RB_CLEAR_NODE(&kn->rb); |
286 | return true; | |
fd7b9f7b TH |
287 | } |
288 | ||
289 | /** | |
c637b8ac | 290 | * kernfs_get_active - get an active reference to kernfs_node |
324a56e1 | 291 | * @kn: kernfs_node to get an active reference to |
fd7b9f7b | 292 | * |
324a56e1 | 293 | * Get an active reference of @kn. This function is noop if @kn |
fd7b9f7b TH |
294 | * is NULL. |
295 | * | |
296 | * RETURNS: | |
324a56e1 | 297 | * Pointer to @kn on success, NULL on failure. |
fd7b9f7b | 298 | */ |
c637b8ac | 299 | struct kernfs_node *kernfs_get_active(struct kernfs_node *kn) |
fd7b9f7b | 300 | { |
324a56e1 | 301 | if (unlikely(!kn)) |
fd7b9f7b TH |
302 | return NULL; |
303 | ||
f4b3e631 GKH |
304 | if (!atomic_inc_unless_negative(&kn->active)) |
305 | return NULL; | |
895a068a | 306 | |
182fd64b | 307 | if (kernfs_lockdep(kn)) |
f4b3e631 GKH |
308 | rwsem_acquire_read(&kn->dep_map, 0, 1, _RET_IP_); |
309 | return kn; | |
fd7b9f7b TH |
310 | } |
311 | ||
312 | /** | |
c637b8ac | 313 | * kernfs_put_active - put an active reference to kernfs_node |
324a56e1 | 314 | * @kn: kernfs_node to put an active reference to |
fd7b9f7b | 315 | * |
324a56e1 | 316 | * Put an active reference to @kn. This function is noop if @kn |
fd7b9f7b TH |
317 | * is NULL. |
318 | */ | |
c637b8ac | 319 | void kernfs_put_active(struct kernfs_node *kn) |
fd7b9f7b | 320 | { |
abd54f02 | 321 | struct kernfs_root *root = kernfs_root(kn); |
fd7b9f7b TH |
322 | int v; |
323 | ||
324a56e1 | 324 | if (unlikely(!kn)) |
fd7b9f7b TH |
325 | return; |
326 | ||
182fd64b | 327 | if (kernfs_lockdep(kn)) |
324a56e1 | 328 | rwsem_release(&kn->dep_map, 1, _RET_IP_); |
adc5e8b5 | 329 | v = atomic_dec_return(&kn->active); |
df23fc39 | 330 | if (likely(v != KN_DEACTIVATED_BIAS)) |
fd7b9f7b TH |
331 | return; |
332 | ||
abd54f02 | 333 | wake_up_all(&root->deactivate_waitq); |
fd7b9f7b TH |
334 | } |
335 | ||
336 | /** | |
81c173cb TH |
337 | * kernfs_drain - drain kernfs_node |
338 | * @kn: kernfs_node to drain | |
fd7b9f7b | 339 | * |
81c173cb TH |
340 | * Drain existing usages and nuke all existing mmaps of @kn. Mutiple |
341 | * removers may invoke this function concurrently on @kn and all will | |
342 | * return after draining is complete. | |
fd7b9f7b | 343 | */ |
81c173cb | 344 | static void kernfs_drain(struct kernfs_node *kn) |
35beab06 | 345 | __releases(&kernfs_mutex) __acquires(&kernfs_mutex) |
fd7b9f7b | 346 | { |
abd54f02 | 347 | struct kernfs_root *root = kernfs_root(kn); |
fd7b9f7b | 348 | |
35beab06 | 349 | lockdep_assert_held(&kernfs_mutex); |
81c173cb | 350 | WARN_ON_ONCE(kernfs_active(kn)); |
ea1c472d | 351 | |
35beab06 | 352 | mutex_unlock(&kernfs_mutex); |
abd54f02 | 353 | |
182fd64b | 354 | if (kernfs_lockdep(kn)) { |
35beab06 TH |
355 | rwsem_acquire(&kn->dep_map, 0, 0, _RET_IP_); |
356 | if (atomic_read(&kn->active) != KN_DEACTIVATED_BIAS) | |
357 | lock_contended(&kn->dep_map, _RET_IP_); | |
358 | } | |
abd54f02 | 359 | |
35beab06 | 360 | /* but everyone should wait for draining */ |
abd54f02 TH |
361 | wait_event(root->deactivate_waitq, |
362 | atomic_read(&kn->active) == KN_DEACTIVATED_BIAS); | |
fd7b9f7b | 363 | |
182fd64b | 364 | if (kernfs_lockdep(kn)) { |
a6607930 TH |
365 | lock_acquired(&kn->dep_map, _RET_IP_); |
366 | rwsem_release(&kn->dep_map, 1, _RET_IP_); | |
367 | } | |
35beab06 | 368 | |
ccf02aaf TH |
369 | kernfs_unmap_bin_file(kn); |
370 | ||
35beab06 | 371 | mutex_lock(&kernfs_mutex); |
fd7b9f7b TH |
372 | } |
373 | ||
fd7b9f7b | 374 | /** |
324a56e1 TH |
375 | * kernfs_get - get a reference count on a kernfs_node |
376 | * @kn: the target kernfs_node | |
fd7b9f7b | 377 | */ |
324a56e1 | 378 | void kernfs_get(struct kernfs_node *kn) |
fd7b9f7b | 379 | { |
324a56e1 | 380 | if (kn) { |
adc5e8b5 TH |
381 | WARN_ON(!atomic_read(&kn->count)); |
382 | atomic_inc(&kn->count); | |
fd7b9f7b TH |
383 | } |
384 | } | |
385 | EXPORT_SYMBOL_GPL(kernfs_get); | |
386 | ||
387 | /** | |
324a56e1 TH |
388 | * kernfs_put - put a reference count on a kernfs_node |
389 | * @kn: the target kernfs_node | |
fd7b9f7b | 390 | * |
324a56e1 | 391 | * Put a reference count of @kn and destroy it if it reached zero. |
fd7b9f7b | 392 | */ |
324a56e1 | 393 | void kernfs_put(struct kernfs_node *kn) |
fd7b9f7b | 394 | { |
324a56e1 | 395 | struct kernfs_node *parent; |
ba7443bc | 396 | struct kernfs_root *root; |
fd7b9f7b | 397 | |
adc5e8b5 | 398 | if (!kn || !atomic_dec_and_test(&kn->count)) |
fd7b9f7b | 399 | return; |
324a56e1 | 400 | root = kernfs_root(kn); |
fd7b9f7b | 401 | repeat: |
81c173cb TH |
402 | /* |
403 | * Moving/renaming is always done while holding reference. | |
adc5e8b5 | 404 | * kn->parent won't change beneath us. |
fd7b9f7b | 405 | */ |
adc5e8b5 | 406 | parent = kn->parent; |
fd7b9f7b | 407 | |
81c173cb TH |
408 | WARN_ONCE(atomic_read(&kn->active) != KN_DEACTIVATED_BIAS, |
409 | "kernfs_put: %s/%s: released with incorrect active_ref %d\n", | |
410 | parent ? parent->name : "", kn->name, atomic_read(&kn->active)); | |
324a56e1 | 411 | |
df23fc39 | 412 | if (kernfs_type(kn) == KERNFS_LINK) |
adc5e8b5 | 413 | kernfs_put(kn->symlink.target_kn); |
2063d608 | 414 | if (!(kn->flags & KERNFS_STATIC_NAME)) |
adc5e8b5 TH |
415 | kfree(kn->name); |
416 | if (kn->iattr) { | |
417 | if (kn->iattr->ia_secdata) | |
418 | security_release_secctx(kn->iattr->ia_secdata, | |
419 | kn->iattr->ia_secdata_len); | |
420 | simple_xattrs_free(&kn->iattr->xattrs); | |
2322392b | 421 | } |
adc5e8b5 TH |
422 | kfree(kn->iattr); |
423 | ida_simple_remove(&root->ino_ida, kn->ino); | |
a797bfc3 | 424 | kmem_cache_free(kernfs_node_cache, kn); |
fd7b9f7b | 425 | |
324a56e1 TH |
426 | kn = parent; |
427 | if (kn) { | |
adc5e8b5 | 428 | if (atomic_dec_and_test(&kn->count)) |
ba7443bc TH |
429 | goto repeat; |
430 | } else { | |
324a56e1 | 431 | /* just released the root kn, free @root too */ |
bc755553 | 432 | ida_destroy(&root->ino_ida); |
ba7443bc TH |
433 | kfree(root); |
434 | } | |
fd7b9f7b TH |
435 | } |
436 | EXPORT_SYMBOL_GPL(kernfs_put); | |
437 | ||
c637b8ac | 438 | static int kernfs_dop_revalidate(struct dentry *dentry, unsigned int flags) |
fd7b9f7b | 439 | { |
324a56e1 | 440 | struct kernfs_node *kn; |
fd7b9f7b TH |
441 | |
442 | if (flags & LOOKUP_RCU) | |
443 | return -ECHILD; | |
444 | ||
19bbb926 TH |
445 | /* Always perform fresh lookup for negatives */ |
446 | if (!dentry->d_inode) | |
447 | goto out_bad_unlocked; | |
448 | ||
324a56e1 | 449 | kn = dentry->d_fsdata; |
a797bfc3 | 450 | mutex_lock(&kernfs_mutex); |
fd7b9f7b | 451 | |
81c173cb TH |
452 | /* The kernfs node has been deactivated */ |
453 | if (!kernfs_active(kn)) | |
fd7b9f7b TH |
454 | goto out_bad; |
455 | ||
c637b8ac | 456 | /* The kernfs node has been moved? */ |
adc5e8b5 | 457 | if (dentry->d_parent->d_fsdata != kn->parent) |
fd7b9f7b TH |
458 | goto out_bad; |
459 | ||
c637b8ac | 460 | /* The kernfs node has been renamed */ |
adc5e8b5 | 461 | if (strcmp(dentry->d_name.name, kn->name) != 0) |
fd7b9f7b TH |
462 | goto out_bad; |
463 | ||
c637b8ac | 464 | /* The kernfs node has been moved to a different namespace */ |
adc5e8b5 | 465 | if (kn->parent && kernfs_ns_enabled(kn->parent) && |
c525aadd | 466 | kernfs_info(dentry->d_sb)->ns != kn->ns) |
fd7b9f7b TH |
467 | goto out_bad; |
468 | ||
a797bfc3 | 469 | mutex_unlock(&kernfs_mutex); |
fd7b9f7b TH |
470 | return 1; |
471 | out_bad: | |
a797bfc3 | 472 | mutex_unlock(&kernfs_mutex); |
19bbb926 | 473 | out_bad_unlocked: |
fd7b9f7b TH |
474 | return 0; |
475 | } | |
476 | ||
c637b8ac | 477 | static void kernfs_dop_release(struct dentry *dentry) |
fd7b9f7b TH |
478 | { |
479 | kernfs_put(dentry->d_fsdata); | |
480 | } | |
481 | ||
a797bfc3 | 482 | const struct dentry_operations kernfs_dops = { |
c637b8ac | 483 | .d_revalidate = kernfs_dop_revalidate, |
c637b8ac | 484 | .d_release = kernfs_dop_release, |
fd7b9f7b TH |
485 | }; |
486 | ||
0c23b225 TH |
487 | /** |
488 | * kernfs_node_from_dentry - determine kernfs_node associated with a dentry | |
489 | * @dentry: the dentry in question | |
490 | * | |
491 | * Return the kernfs_node associated with @dentry. If @dentry is not a | |
492 | * kernfs one, %NULL is returned. | |
493 | * | |
494 | * While the returned kernfs_node will stay accessible as long as @dentry | |
495 | * is accessible, the returned node can be in any state and the caller is | |
496 | * fully responsible for determining what's accessible. | |
497 | */ | |
498 | struct kernfs_node *kernfs_node_from_dentry(struct dentry *dentry) | |
499 | { | |
f41c5934 | 500 | if (dentry->d_sb->s_op == &kernfs_sops) |
0c23b225 TH |
501 | return dentry->d_fsdata; |
502 | return NULL; | |
503 | } | |
504 | ||
db4aad20 TH |
505 | static struct kernfs_node *__kernfs_new_node(struct kernfs_root *root, |
506 | const char *name, umode_t mode, | |
507 | unsigned flags) | |
fd7b9f7b TH |
508 | { |
509 | char *dup_name = NULL; | |
324a56e1 | 510 | struct kernfs_node *kn; |
bc755553 | 511 | int ret; |
fd7b9f7b | 512 | |
2063d608 | 513 | if (!(flags & KERNFS_STATIC_NAME)) { |
fd7b9f7b TH |
514 | name = dup_name = kstrdup(name, GFP_KERNEL); |
515 | if (!name) | |
516 | return NULL; | |
517 | } | |
518 | ||
a797bfc3 | 519 | kn = kmem_cache_zalloc(kernfs_node_cache, GFP_KERNEL); |
324a56e1 | 520 | if (!kn) |
fd7b9f7b TH |
521 | goto err_out1; |
522 | ||
bc755553 TH |
523 | ret = ida_simple_get(&root->ino_ida, 1, 0, GFP_KERNEL); |
524 | if (ret < 0) | |
fd7b9f7b | 525 | goto err_out2; |
adc5e8b5 | 526 | kn->ino = ret; |
fd7b9f7b | 527 | |
adc5e8b5 | 528 | atomic_set(&kn->count, 1); |
81c173cb | 529 | atomic_set(&kn->active, KN_DEACTIVATED_BIAS); |
35beab06 | 530 | RB_CLEAR_NODE(&kn->rb); |
fd7b9f7b | 531 | |
adc5e8b5 TH |
532 | kn->name = name; |
533 | kn->mode = mode; | |
81c173cb | 534 | kn->flags = flags; |
fd7b9f7b | 535 | |
324a56e1 | 536 | return kn; |
fd7b9f7b TH |
537 | |
538 | err_out2: | |
a797bfc3 | 539 | kmem_cache_free(kernfs_node_cache, kn); |
fd7b9f7b TH |
540 | err_out1: |
541 | kfree(dup_name); | |
542 | return NULL; | |
543 | } | |
544 | ||
db4aad20 TH |
545 | struct kernfs_node *kernfs_new_node(struct kernfs_node *parent, |
546 | const char *name, umode_t mode, | |
547 | unsigned flags) | |
548 | { | |
549 | struct kernfs_node *kn; | |
550 | ||
551 | kn = __kernfs_new_node(kernfs_root(parent), name, mode, flags); | |
552 | if (kn) { | |
553 | kernfs_get(parent); | |
554 | kn->parent = parent; | |
555 | } | |
556 | return kn; | |
557 | } | |
558 | ||
fd7b9f7b | 559 | /** |
c637b8ac | 560 | * kernfs_add_one - add kernfs_node to parent without warning |
324a56e1 | 561 | * @kn: kernfs_node to be added |
fd7b9f7b | 562 | * |
db4aad20 TH |
563 | * The caller must already have initialized @kn->parent. This |
564 | * function increments nlink of the parent's inode if @kn is a | |
565 | * directory and link into the children list of the parent. | |
fd7b9f7b | 566 | * |
fd7b9f7b TH |
567 | * RETURNS: |
568 | * 0 on success, -EEXIST if entry with the given name already | |
569 | * exists. | |
570 | */ | |
988cd7af | 571 | int kernfs_add_one(struct kernfs_node *kn) |
fd7b9f7b | 572 | { |
db4aad20 | 573 | struct kernfs_node *parent = kn->parent; |
c525aadd | 574 | struct kernfs_iattrs *ps_iattr; |
988cd7af | 575 | bool has_ns; |
fd7b9f7b TH |
576 | int ret; |
577 | ||
988cd7af TH |
578 | mutex_lock(&kernfs_mutex); |
579 | ||
580 | ret = -EINVAL; | |
581 | has_ns = kernfs_ns_enabled(parent); | |
582 | if (WARN(has_ns != (bool)kn->ns, KERN_WARNING "kernfs: ns %s in '%s' for '%s'\n", | |
583 | has_ns ? "required" : "invalid", parent->name, kn->name)) | |
584 | goto out_unlock; | |
fd7b9f7b | 585 | |
df23fc39 | 586 | if (kernfs_type(parent) != KERNFS_DIR) |
988cd7af | 587 | goto out_unlock; |
fd7b9f7b | 588 | |
988cd7af | 589 | ret = -ENOENT; |
d35258ef | 590 | if ((parent->flags & KERNFS_ACTIVATED) && !kernfs_active(parent)) |
988cd7af | 591 | goto out_unlock; |
798c75a0 | 592 | |
c637b8ac | 593 | kn->hash = kernfs_name_hash(kn->name, kn->ns); |
fd7b9f7b | 594 | |
c637b8ac | 595 | ret = kernfs_link_sibling(kn); |
fd7b9f7b | 596 | if (ret) |
988cd7af | 597 | goto out_unlock; |
fd7b9f7b TH |
598 | |
599 | /* Update timestamps on the parent */ | |
adc5e8b5 | 600 | ps_iattr = parent->iattr; |
fd7b9f7b TH |
601 | if (ps_iattr) { |
602 | struct iattr *ps_iattrs = &ps_iattr->ia_iattr; | |
603 | ps_iattrs->ia_ctime = ps_iattrs->ia_mtime = CURRENT_TIME; | |
604 | } | |
605 | ||
d35258ef TH |
606 | mutex_unlock(&kernfs_mutex); |
607 | ||
608 | /* | |
609 | * Activate the new node unless CREATE_DEACTIVATED is requested. | |
610 | * If not activated here, the kernfs user is responsible for | |
611 | * activating the node with kernfs_activate(). A node which hasn't | |
612 | * been activated is not visible to userland and its removal won't | |
613 | * trigger deactivation. | |
614 | */ | |
615 | if (!(kernfs_root(kn)->flags & KERNFS_ROOT_CREATE_DEACTIVATED)) | |
616 | kernfs_activate(kn); | |
617 | return 0; | |
618 | ||
988cd7af | 619 | out_unlock: |
a797bfc3 | 620 | mutex_unlock(&kernfs_mutex); |
988cd7af | 621 | return ret; |
fd7b9f7b TH |
622 | } |
623 | ||
624 | /** | |
324a56e1 TH |
625 | * kernfs_find_ns - find kernfs_node with the given name |
626 | * @parent: kernfs_node to search under | |
fd7b9f7b TH |
627 | * @name: name to look for |
628 | * @ns: the namespace tag to use | |
629 | * | |
324a56e1 TH |
630 | * Look for kernfs_node with name @name under @parent. Returns pointer to |
631 | * the found kernfs_node on success, %NULL on failure. | |
fd7b9f7b | 632 | */ |
324a56e1 TH |
633 | static struct kernfs_node *kernfs_find_ns(struct kernfs_node *parent, |
634 | const unsigned char *name, | |
635 | const void *ns) | |
fd7b9f7b | 636 | { |
adc5e8b5 | 637 | struct rb_node *node = parent->dir.children.rb_node; |
ac9bba03 | 638 | bool has_ns = kernfs_ns_enabled(parent); |
fd7b9f7b TH |
639 | unsigned int hash; |
640 | ||
a797bfc3 | 641 | lockdep_assert_held(&kernfs_mutex); |
fd7b9f7b TH |
642 | |
643 | if (has_ns != (bool)ns) { | |
c637b8ac | 644 | WARN(1, KERN_WARNING "kernfs: ns %s in '%s' for '%s'\n", |
adc5e8b5 | 645 | has_ns ? "required" : "invalid", parent->name, name); |
fd7b9f7b TH |
646 | return NULL; |
647 | } | |
648 | ||
c637b8ac | 649 | hash = kernfs_name_hash(name, ns); |
fd7b9f7b | 650 | while (node) { |
324a56e1 | 651 | struct kernfs_node *kn; |
fd7b9f7b TH |
652 | int result; |
653 | ||
324a56e1 | 654 | kn = rb_to_kn(node); |
c637b8ac | 655 | result = kernfs_name_compare(hash, name, ns, kn); |
fd7b9f7b TH |
656 | if (result < 0) |
657 | node = node->rb_left; | |
658 | else if (result > 0) | |
659 | node = node->rb_right; | |
660 | else | |
324a56e1 | 661 | return kn; |
fd7b9f7b TH |
662 | } |
663 | return NULL; | |
664 | } | |
665 | ||
666 | /** | |
324a56e1 TH |
667 | * kernfs_find_and_get_ns - find and get kernfs_node with the given name |
668 | * @parent: kernfs_node to search under | |
fd7b9f7b TH |
669 | * @name: name to look for |
670 | * @ns: the namespace tag to use | |
671 | * | |
324a56e1 | 672 | * Look for kernfs_node with name @name under @parent and get a reference |
fd7b9f7b | 673 | * if found. This function may sleep and returns pointer to the found |
324a56e1 | 674 | * kernfs_node on success, %NULL on failure. |
fd7b9f7b | 675 | */ |
324a56e1 TH |
676 | struct kernfs_node *kernfs_find_and_get_ns(struct kernfs_node *parent, |
677 | const char *name, const void *ns) | |
fd7b9f7b | 678 | { |
324a56e1 | 679 | struct kernfs_node *kn; |
fd7b9f7b | 680 | |
a797bfc3 | 681 | mutex_lock(&kernfs_mutex); |
324a56e1 TH |
682 | kn = kernfs_find_ns(parent, name, ns); |
683 | kernfs_get(kn); | |
a797bfc3 | 684 | mutex_unlock(&kernfs_mutex); |
fd7b9f7b | 685 | |
324a56e1 | 686 | return kn; |
fd7b9f7b TH |
687 | } |
688 | EXPORT_SYMBOL_GPL(kernfs_find_and_get_ns); | |
689 | ||
ba7443bc TH |
690 | /** |
691 | * kernfs_create_root - create a new kernfs hierarchy | |
90c07c89 | 692 | * @scops: optional syscall operations for the hierarchy |
d35258ef | 693 | * @flags: KERNFS_ROOT_* flags |
ba7443bc TH |
694 | * @priv: opaque data associated with the new directory |
695 | * | |
696 | * Returns the root of the new hierarchy on success, ERR_PTR() value on | |
697 | * failure. | |
698 | */ | |
90c07c89 | 699 | struct kernfs_root *kernfs_create_root(struct kernfs_syscall_ops *scops, |
d35258ef | 700 | unsigned int flags, void *priv) |
ba7443bc TH |
701 | { |
702 | struct kernfs_root *root; | |
324a56e1 | 703 | struct kernfs_node *kn; |
ba7443bc TH |
704 | |
705 | root = kzalloc(sizeof(*root), GFP_KERNEL); | |
706 | if (!root) | |
707 | return ERR_PTR(-ENOMEM); | |
708 | ||
bc755553 | 709 | ida_init(&root->ino_ida); |
7d568a83 | 710 | INIT_LIST_HEAD(&root->supers); |
bc755553 | 711 | |
db4aad20 TH |
712 | kn = __kernfs_new_node(root, "", S_IFDIR | S_IRUGO | S_IXUGO, |
713 | KERNFS_DIR); | |
324a56e1 | 714 | if (!kn) { |
bc755553 | 715 | ida_destroy(&root->ino_ida); |
ba7443bc TH |
716 | kfree(root); |
717 | return ERR_PTR(-ENOMEM); | |
718 | } | |
719 | ||
324a56e1 | 720 | kn->priv = priv; |
adc5e8b5 | 721 | kn->dir.root = root; |
ba7443bc | 722 | |
90c07c89 | 723 | root->syscall_ops = scops; |
d35258ef | 724 | root->flags = flags; |
324a56e1 | 725 | root->kn = kn; |
abd54f02 | 726 | init_waitqueue_head(&root->deactivate_waitq); |
ba7443bc | 727 | |
d35258ef TH |
728 | if (!(root->flags & KERNFS_ROOT_CREATE_DEACTIVATED)) |
729 | kernfs_activate(kn); | |
730 | ||
ba7443bc TH |
731 | return root; |
732 | } | |
733 | ||
734 | /** | |
735 | * kernfs_destroy_root - destroy a kernfs hierarchy | |
736 | * @root: root of the hierarchy to destroy | |
737 | * | |
738 | * Destroy the hierarchy anchored at @root by removing all existing | |
739 | * directories and destroying @root. | |
740 | */ | |
741 | void kernfs_destroy_root(struct kernfs_root *root) | |
742 | { | |
324a56e1 | 743 | kernfs_remove(root->kn); /* will also free @root */ |
ba7443bc TH |
744 | } |
745 | ||
fd7b9f7b TH |
746 | /** |
747 | * kernfs_create_dir_ns - create a directory | |
748 | * @parent: parent in which to create a new directory | |
749 | * @name: name of the new directory | |
bb8b9d09 | 750 | * @mode: mode of the new directory |
fd7b9f7b TH |
751 | * @priv: opaque data associated with the new directory |
752 | * @ns: optional namespace tag of the directory | |
753 | * | |
754 | * Returns the created node on success, ERR_PTR() value on failure. | |
755 | */ | |
324a56e1 | 756 | struct kernfs_node *kernfs_create_dir_ns(struct kernfs_node *parent, |
bb8b9d09 TH |
757 | const char *name, umode_t mode, |
758 | void *priv, const void *ns) | |
fd7b9f7b | 759 | { |
324a56e1 | 760 | struct kernfs_node *kn; |
fd7b9f7b TH |
761 | int rc; |
762 | ||
763 | /* allocate */ | |
db4aad20 | 764 | kn = kernfs_new_node(parent, name, mode | S_IFDIR, KERNFS_DIR); |
324a56e1 | 765 | if (!kn) |
fd7b9f7b TH |
766 | return ERR_PTR(-ENOMEM); |
767 | ||
adc5e8b5 TH |
768 | kn->dir.root = parent->dir.root; |
769 | kn->ns = ns; | |
324a56e1 | 770 | kn->priv = priv; |
fd7b9f7b TH |
771 | |
772 | /* link in */ | |
988cd7af | 773 | rc = kernfs_add_one(kn); |
fd7b9f7b | 774 | if (!rc) |
324a56e1 | 775 | return kn; |
fd7b9f7b | 776 | |
324a56e1 | 777 | kernfs_put(kn); |
fd7b9f7b TH |
778 | return ERR_PTR(rc); |
779 | } | |
780 | ||
c637b8ac TH |
781 | static struct dentry *kernfs_iop_lookup(struct inode *dir, |
782 | struct dentry *dentry, | |
783 | unsigned int flags) | |
fd7b9f7b | 784 | { |
19bbb926 | 785 | struct dentry *ret; |
324a56e1 TH |
786 | struct kernfs_node *parent = dentry->d_parent->d_fsdata; |
787 | struct kernfs_node *kn; | |
fd7b9f7b TH |
788 | struct inode *inode; |
789 | const void *ns = NULL; | |
790 | ||
a797bfc3 | 791 | mutex_lock(&kernfs_mutex); |
fd7b9f7b | 792 | |
324a56e1 | 793 | if (kernfs_ns_enabled(parent)) |
c525aadd | 794 | ns = kernfs_info(dir->i_sb)->ns; |
fd7b9f7b | 795 | |
324a56e1 | 796 | kn = kernfs_find_ns(parent, dentry->d_name.name, ns); |
fd7b9f7b TH |
797 | |
798 | /* no such entry */ | |
b9c9dad0 | 799 | if (!kn || !kernfs_active(kn)) { |
19bbb926 | 800 | ret = NULL; |
fd7b9f7b TH |
801 | goto out_unlock; |
802 | } | |
324a56e1 TH |
803 | kernfs_get(kn); |
804 | dentry->d_fsdata = kn; | |
fd7b9f7b TH |
805 | |
806 | /* attach dentry and inode */ | |
c637b8ac | 807 | inode = kernfs_get_inode(dir->i_sb, kn); |
fd7b9f7b TH |
808 | if (!inode) { |
809 | ret = ERR_PTR(-ENOMEM); | |
810 | goto out_unlock; | |
811 | } | |
812 | ||
813 | /* instantiate and hash dentry */ | |
41d28bca | 814 | ret = d_splice_alias(inode, dentry); |
fd7b9f7b | 815 | out_unlock: |
a797bfc3 | 816 | mutex_unlock(&kernfs_mutex); |
fd7b9f7b TH |
817 | return ret; |
818 | } | |
819 | ||
80b9bbef TH |
820 | static int kernfs_iop_mkdir(struct inode *dir, struct dentry *dentry, |
821 | umode_t mode) | |
822 | { | |
823 | struct kernfs_node *parent = dir->i_private; | |
90c07c89 | 824 | struct kernfs_syscall_ops *scops = kernfs_root(parent)->syscall_ops; |
07c7530d | 825 | int ret; |
80b9bbef | 826 | |
90c07c89 | 827 | if (!scops || !scops->mkdir) |
80b9bbef TH |
828 | return -EPERM; |
829 | ||
07c7530d TH |
830 | if (!kernfs_get_active(parent)) |
831 | return -ENODEV; | |
832 | ||
90c07c89 | 833 | ret = scops->mkdir(parent, dentry->d_name.name, mode); |
07c7530d TH |
834 | |
835 | kernfs_put_active(parent); | |
836 | return ret; | |
80b9bbef TH |
837 | } |
838 | ||
839 | static int kernfs_iop_rmdir(struct inode *dir, struct dentry *dentry) | |
840 | { | |
841 | struct kernfs_node *kn = dentry->d_fsdata; | |
90c07c89 | 842 | struct kernfs_syscall_ops *scops = kernfs_root(kn)->syscall_ops; |
07c7530d | 843 | int ret; |
80b9bbef | 844 | |
90c07c89 | 845 | if (!scops || !scops->rmdir) |
80b9bbef TH |
846 | return -EPERM; |
847 | ||
07c7530d TH |
848 | if (!kernfs_get_active(kn)) |
849 | return -ENODEV; | |
850 | ||
90c07c89 | 851 | ret = scops->rmdir(kn); |
07c7530d TH |
852 | |
853 | kernfs_put_active(kn); | |
854 | return ret; | |
80b9bbef TH |
855 | } |
856 | ||
857 | static int kernfs_iop_rename(struct inode *old_dir, struct dentry *old_dentry, | |
858 | struct inode *new_dir, struct dentry *new_dentry) | |
859 | { | |
860 | struct kernfs_node *kn = old_dentry->d_fsdata; | |
861 | struct kernfs_node *new_parent = new_dir->i_private; | |
90c07c89 | 862 | struct kernfs_syscall_ops *scops = kernfs_root(kn)->syscall_ops; |
07c7530d | 863 | int ret; |
80b9bbef | 864 | |
90c07c89 | 865 | if (!scops || !scops->rename) |
80b9bbef TH |
866 | return -EPERM; |
867 | ||
07c7530d TH |
868 | if (!kernfs_get_active(kn)) |
869 | return -ENODEV; | |
870 | ||
871 | if (!kernfs_get_active(new_parent)) { | |
872 | kernfs_put_active(kn); | |
873 | return -ENODEV; | |
874 | } | |
875 | ||
90c07c89 | 876 | ret = scops->rename(kn, new_parent, new_dentry->d_name.name); |
07c7530d TH |
877 | |
878 | kernfs_put_active(new_parent); | |
879 | kernfs_put_active(kn); | |
880 | return ret; | |
80b9bbef TH |
881 | } |
882 | ||
a797bfc3 | 883 | const struct inode_operations kernfs_dir_iops = { |
c637b8ac TH |
884 | .lookup = kernfs_iop_lookup, |
885 | .permission = kernfs_iop_permission, | |
886 | .setattr = kernfs_iop_setattr, | |
887 | .getattr = kernfs_iop_getattr, | |
888 | .setxattr = kernfs_iop_setxattr, | |
889 | .removexattr = kernfs_iop_removexattr, | |
890 | .getxattr = kernfs_iop_getxattr, | |
891 | .listxattr = kernfs_iop_listxattr, | |
80b9bbef TH |
892 | |
893 | .mkdir = kernfs_iop_mkdir, | |
894 | .rmdir = kernfs_iop_rmdir, | |
895 | .rename = kernfs_iop_rename, | |
fd7b9f7b TH |
896 | }; |
897 | ||
c637b8ac | 898 | static struct kernfs_node *kernfs_leftmost_descendant(struct kernfs_node *pos) |
fd7b9f7b | 899 | { |
324a56e1 | 900 | struct kernfs_node *last; |
fd7b9f7b TH |
901 | |
902 | while (true) { | |
903 | struct rb_node *rbn; | |
904 | ||
905 | last = pos; | |
906 | ||
df23fc39 | 907 | if (kernfs_type(pos) != KERNFS_DIR) |
fd7b9f7b TH |
908 | break; |
909 | ||
adc5e8b5 | 910 | rbn = rb_first(&pos->dir.children); |
fd7b9f7b TH |
911 | if (!rbn) |
912 | break; | |
913 | ||
324a56e1 | 914 | pos = rb_to_kn(rbn); |
fd7b9f7b TH |
915 | } |
916 | ||
917 | return last; | |
918 | } | |
919 | ||
920 | /** | |
c637b8ac | 921 | * kernfs_next_descendant_post - find the next descendant for post-order walk |
fd7b9f7b | 922 | * @pos: the current position (%NULL to initiate traversal) |
324a56e1 | 923 | * @root: kernfs_node whose descendants to walk |
fd7b9f7b TH |
924 | * |
925 | * Find the next descendant to visit for post-order traversal of @root's | |
926 | * descendants. @root is included in the iteration and the last node to be | |
927 | * visited. | |
928 | */ | |
c637b8ac TH |
929 | static struct kernfs_node *kernfs_next_descendant_post(struct kernfs_node *pos, |
930 | struct kernfs_node *root) | |
fd7b9f7b TH |
931 | { |
932 | struct rb_node *rbn; | |
933 | ||
a797bfc3 | 934 | lockdep_assert_held(&kernfs_mutex); |
fd7b9f7b TH |
935 | |
936 | /* if first iteration, visit leftmost descendant which may be root */ | |
937 | if (!pos) | |
c637b8ac | 938 | return kernfs_leftmost_descendant(root); |
fd7b9f7b TH |
939 | |
940 | /* if we visited @root, we're done */ | |
941 | if (pos == root) | |
942 | return NULL; | |
943 | ||
944 | /* if there's an unvisited sibling, visit its leftmost descendant */ | |
adc5e8b5 | 945 | rbn = rb_next(&pos->rb); |
fd7b9f7b | 946 | if (rbn) |
c637b8ac | 947 | return kernfs_leftmost_descendant(rb_to_kn(rbn)); |
fd7b9f7b TH |
948 | |
949 | /* no sibling left, visit parent */ | |
adc5e8b5 | 950 | return pos->parent; |
fd7b9f7b TH |
951 | } |
952 | ||
d35258ef TH |
953 | /** |
954 | * kernfs_activate - activate a node which started deactivated | |
955 | * @kn: kernfs_node whose subtree is to be activated | |
956 | * | |
957 | * If the root has KERNFS_ROOT_CREATE_DEACTIVATED set, a newly created node | |
958 | * needs to be explicitly activated. A node which hasn't been activated | |
959 | * isn't visible to userland and deactivation is skipped during its | |
960 | * removal. This is useful to construct atomic init sequences where | |
961 | * creation of multiple nodes should either succeed or fail atomically. | |
962 | * | |
963 | * The caller is responsible for ensuring that this function is not called | |
964 | * after kernfs_remove*() is invoked on @kn. | |
965 | */ | |
966 | void kernfs_activate(struct kernfs_node *kn) | |
967 | { | |
968 | struct kernfs_node *pos; | |
969 | ||
970 | mutex_lock(&kernfs_mutex); | |
971 | ||
972 | pos = NULL; | |
973 | while ((pos = kernfs_next_descendant_post(pos, kn))) { | |
974 | if (!pos || (pos->flags & KERNFS_ACTIVATED)) | |
975 | continue; | |
976 | ||
977 | WARN_ON_ONCE(pos->parent && RB_EMPTY_NODE(&pos->rb)); | |
978 | WARN_ON_ONCE(atomic_read(&pos->active) != KN_DEACTIVATED_BIAS); | |
979 | ||
980 | atomic_sub(KN_DEACTIVATED_BIAS, &pos->active); | |
981 | pos->flags |= KERNFS_ACTIVATED; | |
982 | } | |
983 | ||
984 | mutex_unlock(&kernfs_mutex); | |
985 | } | |
986 | ||
988cd7af | 987 | static void __kernfs_remove(struct kernfs_node *kn) |
fd7b9f7b | 988 | { |
35beab06 TH |
989 | struct kernfs_node *pos; |
990 | ||
991 | lockdep_assert_held(&kernfs_mutex); | |
fd7b9f7b | 992 | |
6b0afc2a TH |
993 | /* |
994 | * Short-circuit if non-root @kn has already finished removal. | |
995 | * This is for kernfs_remove_self() which plays with active ref | |
996 | * after removal. | |
997 | */ | |
998 | if (!kn || (kn->parent && RB_EMPTY_NODE(&kn->rb))) | |
ce9b499c GKH |
999 | return; |
1000 | ||
c637b8ac | 1001 | pr_debug("kernfs %s: removing\n", kn->name); |
fd7b9f7b | 1002 | |
81c173cb | 1003 | /* prevent any new usage under @kn by deactivating all nodes */ |
35beab06 TH |
1004 | pos = NULL; |
1005 | while ((pos = kernfs_next_descendant_post(pos, kn))) | |
81c173cb TH |
1006 | if (kernfs_active(pos)) |
1007 | atomic_add(KN_DEACTIVATED_BIAS, &pos->active); | |
35beab06 TH |
1008 | |
1009 | /* deactivate and unlink the subtree node-by-node */ | |
fd7b9f7b | 1010 | do { |
35beab06 TH |
1011 | pos = kernfs_leftmost_descendant(kn); |
1012 | ||
1013 | /* | |
81c173cb TH |
1014 | * kernfs_drain() drops kernfs_mutex temporarily and @pos's |
1015 | * base ref could have been put by someone else by the time | |
1016 | * the function returns. Make sure it doesn't go away | |
1017 | * underneath us. | |
35beab06 TH |
1018 | */ |
1019 | kernfs_get(pos); | |
1020 | ||
d35258ef TH |
1021 | /* |
1022 | * Drain iff @kn was activated. This avoids draining and | |
1023 | * its lockdep annotations for nodes which have never been | |
1024 | * activated and allows embedding kernfs_remove() in create | |
1025 | * error paths without worrying about draining. | |
1026 | */ | |
1027 | if (kn->flags & KERNFS_ACTIVATED) | |
1028 | kernfs_drain(pos); | |
1029 | else | |
1030 | WARN_ON_ONCE(atomic_read(&kn->active) != KN_DEACTIVATED_BIAS); | |
35beab06 TH |
1031 | |
1032 | /* | |
1033 | * kernfs_unlink_sibling() succeeds once per node. Use it | |
1034 | * to decide who's responsible for cleanups. | |
1035 | */ | |
1036 | if (!pos->parent || kernfs_unlink_sibling(pos)) { | |
1037 | struct kernfs_iattrs *ps_iattr = | |
1038 | pos->parent ? pos->parent->iattr : NULL; | |
1039 | ||
1040 | /* update timestamps on the parent */ | |
1041 | if (ps_iattr) { | |
1042 | ps_iattr->ia_iattr.ia_ctime = CURRENT_TIME; | |
1043 | ps_iattr->ia_iattr.ia_mtime = CURRENT_TIME; | |
1044 | } | |
1045 | ||
988cd7af | 1046 | kernfs_put(pos); |
35beab06 TH |
1047 | } |
1048 | ||
1049 | kernfs_put(pos); | |
1050 | } while (pos != kn); | |
fd7b9f7b TH |
1051 | } |
1052 | ||
1053 | /** | |
324a56e1 TH |
1054 | * kernfs_remove - remove a kernfs_node recursively |
1055 | * @kn: the kernfs_node to remove | |
fd7b9f7b | 1056 | * |
324a56e1 | 1057 | * Remove @kn along with all its subdirectories and files. |
fd7b9f7b | 1058 | */ |
324a56e1 | 1059 | void kernfs_remove(struct kernfs_node *kn) |
fd7b9f7b | 1060 | { |
988cd7af TH |
1061 | mutex_lock(&kernfs_mutex); |
1062 | __kernfs_remove(kn); | |
1063 | mutex_unlock(&kernfs_mutex); | |
fd7b9f7b TH |
1064 | } |
1065 | ||
6b0afc2a TH |
1066 | /** |
1067 | * kernfs_break_active_protection - break out of active protection | |
1068 | * @kn: the self kernfs_node | |
1069 | * | |
1070 | * The caller must be running off of a kernfs operation which is invoked | |
1071 | * with an active reference - e.g. one of kernfs_ops. Each invocation of | |
1072 | * this function must also be matched with an invocation of | |
1073 | * kernfs_unbreak_active_protection(). | |
1074 | * | |
1075 | * This function releases the active reference of @kn the caller is | |
1076 | * holding. Once this function is called, @kn may be removed at any point | |
1077 | * and the caller is solely responsible for ensuring that the objects it | |
1078 | * dereferences are accessible. | |
1079 | */ | |
1080 | void kernfs_break_active_protection(struct kernfs_node *kn) | |
1081 | { | |
1082 | /* | |
1083 | * Take out ourself out of the active ref dependency chain. If | |
1084 | * we're called without an active ref, lockdep will complain. | |
1085 | */ | |
1086 | kernfs_put_active(kn); | |
1087 | } | |
1088 | ||
1089 | /** | |
1090 | * kernfs_unbreak_active_protection - undo kernfs_break_active_protection() | |
1091 | * @kn: the self kernfs_node | |
1092 | * | |
1093 | * If kernfs_break_active_protection() was called, this function must be | |
1094 | * invoked before finishing the kernfs operation. Note that while this | |
1095 | * function restores the active reference, it doesn't and can't actually | |
1096 | * restore the active protection - @kn may already or be in the process of | |
1097 | * being removed. Once kernfs_break_active_protection() is invoked, that | |
1098 | * protection is irreversibly gone for the kernfs operation instance. | |
1099 | * | |
1100 | * While this function may be called at any point after | |
1101 | * kernfs_break_active_protection() is invoked, its most useful location | |
1102 | * would be right before the enclosing kernfs operation returns. | |
1103 | */ | |
1104 | void kernfs_unbreak_active_protection(struct kernfs_node *kn) | |
1105 | { | |
1106 | /* | |
1107 | * @kn->active could be in any state; however, the increment we do | |
1108 | * here will be undone as soon as the enclosing kernfs operation | |
1109 | * finishes and this temporary bump can't break anything. If @kn | |
1110 | * is alive, nothing changes. If @kn is being deactivated, the | |
1111 | * soon-to-follow put will either finish deactivation or restore | |
1112 | * deactivated state. If @kn is already removed, the temporary | |
1113 | * bump is guaranteed to be gone before @kn is released. | |
1114 | */ | |
1115 | atomic_inc(&kn->active); | |
1116 | if (kernfs_lockdep(kn)) | |
1117 | rwsem_acquire(&kn->dep_map, 0, 1, _RET_IP_); | |
1118 | } | |
1119 | ||
1120 | /** | |
1121 | * kernfs_remove_self - remove a kernfs_node from its own method | |
1122 | * @kn: the self kernfs_node to remove | |
1123 | * | |
1124 | * The caller must be running off of a kernfs operation which is invoked | |
1125 | * with an active reference - e.g. one of kernfs_ops. This can be used to | |
1126 | * implement a file operation which deletes itself. | |
1127 | * | |
1128 | * For example, the "delete" file for a sysfs device directory can be | |
1129 | * implemented by invoking kernfs_remove_self() on the "delete" file | |
1130 | * itself. This function breaks the circular dependency of trying to | |
1131 | * deactivate self while holding an active ref itself. It isn't necessary | |
1132 | * to modify the usual removal path to use kernfs_remove_self(). The | |
1133 | * "delete" implementation can simply invoke kernfs_remove_self() on self | |
1134 | * before proceeding with the usual removal path. kernfs will ignore later | |
1135 | * kernfs_remove() on self. | |
1136 | * | |
1137 | * kernfs_remove_self() can be called multiple times concurrently on the | |
1138 | * same kernfs_node. Only the first one actually performs removal and | |
1139 | * returns %true. All others will wait until the kernfs operation which | |
1140 | * won self-removal finishes and return %false. Note that the losers wait | |
1141 | * for the completion of not only the winning kernfs_remove_self() but also | |
1142 | * the whole kernfs_ops which won the arbitration. This can be used to | |
1143 | * guarantee, for example, all concurrent writes to a "delete" file to | |
1144 | * finish only after the whole operation is complete. | |
1145 | */ | |
1146 | bool kernfs_remove_self(struct kernfs_node *kn) | |
1147 | { | |
1148 | bool ret; | |
1149 | ||
1150 | mutex_lock(&kernfs_mutex); | |
1151 | kernfs_break_active_protection(kn); | |
1152 | ||
1153 | /* | |
1154 | * SUICIDAL is used to arbitrate among competing invocations. Only | |
1155 | * the first one will actually perform removal. When the removal | |
1156 | * is complete, SUICIDED is set and the active ref is restored | |
1157 | * while holding kernfs_mutex. The ones which lost arbitration | |
1158 | * waits for SUICDED && drained which can happen only after the | |
1159 | * enclosing kernfs operation which executed the winning instance | |
1160 | * of kernfs_remove_self() finished. | |
1161 | */ | |
1162 | if (!(kn->flags & KERNFS_SUICIDAL)) { | |
1163 | kn->flags |= KERNFS_SUICIDAL; | |
1164 | __kernfs_remove(kn); | |
1165 | kn->flags |= KERNFS_SUICIDED; | |
1166 | ret = true; | |
1167 | } else { | |
1168 | wait_queue_head_t *waitq = &kernfs_root(kn)->deactivate_waitq; | |
1169 | DEFINE_WAIT(wait); | |
1170 | ||
1171 | while (true) { | |
1172 | prepare_to_wait(waitq, &wait, TASK_UNINTERRUPTIBLE); | |
1173 | ||
1174 | if ((kn->flags & KERNFS_SUICIDED) && | |
1175 | atomic_read(&kn->active) == KN_DEACTIVATED_BIAS) | |
1176 | break; | |
1177 | ||
1178 | mutex_unlock(&kernfs_mutex); | |
1179 | schedule(); | |
1180 | mutex_lock(&kernfs_mutex); | |
1181 | } | |
1182 | finish_wait(waitq, &wait); | |
1183 | WARN_ON_ONCE(!RB_EMPTY_NODE(&kn->rb)); | |
1184 | ret = false; | |
1185 | } | |
1186 | ||
1187 | /* | |
1188 | * This must be done while holding kernfs_mutex; otherwise, waiting | |
1189 | * for SUICIDED && deactivated could finish prematurely. | |
1190 | */ | |
1191 | kernfs_unbreak_active_protection(kn); | |
1192 | ||
1193 | mutex_unlock(&kernfs_mutex); | |
1194 | return ret; | |
1195 | } | |
1196 | ||
fd7b9f7b | 1197 | /** |
324a56e1 TH |
1198 | * kernfs_remove_by_name_ns - find a kernfs_node by name and remove it |
1199 | * @parent: parent of the target | |
1200 | * @name: name of the kernfs_node to remove | |
1201 | * @ns: namespace tag of the kernfs_node to remove | |
fd7b9f7b | 1202 | * |
324a56e1 TH |
1203 | * Look for the kernfs_node with @name and @ns under @parent and remove it. |
1204 | * Returns 0 on success, -ENOENT if such entry doesn't exist. | |
fd7b9f7b | 1205 | */ |
324a56e1 | 1206 | int kernfs_remove_by_name_ns(struct kernfs_node *parent, const char *name, |
fd7b9f7b TH |
1207 | const void *ns) |
1208 | { | |
324a56e1 | 1209 | struct kernfs_node *kn; |
fd7b9f7b | 1210 | |
324a56e1 | 1211 | if (!parent) { |
c637b8ac | 1212 | WARN(1, KERN_WARNING "kernfs: can not remove '%s', no directory\n", |
fd7b9f7b TH |
1213 | name); |
1214 | return -ENOENT; | |
1215 | } | |
1216 | ||
988cd7af | 1217 | mutex_lock(&kernfs_mutex); |
fd7b9f7b | 1218 | |
324a56e1 TH |
1219 | kn = kernfs_find_ns(parent, name, ns); |
1220 | if (kn) | |
988cd7af | 1221 | __kernfs_remove(kn); |
fd7b9f7b | 1222 | |
988cd7af | 1223 | mutex_unlock(&kernfs_mutex); |
fd7b9f7b | 1224 | |
324a56e1 | 1225 | if (kn) |
fd7b9f7b TH |
1226 | return 0; |
1227 | else | |
1228 | return -ENOENT; | |
1229 | } | |
1230 | ||
1231 | /** | |
1232 | * kernfs_rename_ns - move and rename a kernfs_node | |
324a56e1 | 1233 | * @kn: target node |
fd7b9f7b TH |
1234 | * @new_parent: new parent to put @sd under |
1235 | * @new_name: new name | |
1236 | * @new_ns: new namespace tag | |
1237 | */ | |
324a56e1 | 1238 | int kernfs_rename_ns(struct kernfs_node *kn, struct kernfs_node *new_parent, |
fd7b9f7b TH |
1239 | const char *new_name, const void *new_ns) |
1240 | { | |
3eef34ad TH |
1241 | struct kernfs_node *old_parent; |
1242 | const char *old_name = NULL; | |
fd7b9f7b TH |
1243 | int error; |
1244 | ||
3eef34ad TH |
1245 | /* can't move or rename root */ |
1246 | if (!kn->parent) | |
1247 | return -EINVAL; | |
1248 | ||
798c75a0 GKH |
1249 | mutex_lock(&kernfs_mutex); |
1250 | ||
d0ae3d43 | 1251 | error = -ENOENT; |
81c173cb | 1252 | if (!kernfs_active(kn) || !kernfs_active(new_parent)) |
d0ae3d43 TH |
1253 | goto out; |
1254 | ||
fd7b9f7b | 1255 | error = 0; |
adc5e8b5 TH |
1256 | if ((kn->parent == new_parent) && (kn->ns == new_ns) && |
1257 | (strcmp(kn->name, new_name) == 0)) | |
798c75a0 | 1258 | goto out; /* nothing to rename */ |
fd7b9f7b TH |
1259 | |
1260 | error = -EEXIST; | |
1261 | if (kernfs_find_ns(new_parent, new_name, new_ns)) | |
798c75a0 | 1262 | goto out; |
fd7b9f7b | 1263 | |
324a56e1 | 1264 | /* rename kernfs_node */ |
adc5e8b5 | 1265 | if (strcmp(kn->name, new_name) != 0) { |
fd7b9f7b TH |
1266 | error = -ENOMEM; |
1267 | new_name = kstrdup(new_name, GFP_KERNEL); | |
1268 | if (!new_name) | |
798c75a0 | 1269 | goto out; |
3eef34ad TH |
1270 | } else { |
1271 | new_name = NULL; | |
fd7b9f7b TH |
1272 | } |
1273 | ||
1274 | /* | |
1275 | * Move to the appropriate place in the appropriate directories rbtree. | |
1276 | */ | |
c637b8ac | 1277 | kernfs_unlink_sibling(kn); |
fd7b9f7b | 1278 | kernfs_get(new_parent); |
3eef34ad TH |
1279 | |
1280 | /* rename_lock protects ->parent and ->name accessors */ | |
1281 | spin_lock_irq(&kernfs_rename_lock); | |
1282 | ||
1283 | old_parent = kn->parent; | |
adc5e8b5 | 1284 | kn->parent = new_parent; |
3eef34ad TH |
1285 | |
1286 | kn->ns = new_ns; | |
1287 | if (new_name) { | |
1288 | if (!(kn->flags & KERNFS_STATIC_NAME)) | |
1289 | old_name = kn->name; | |
1290 | kn->flags &= ~KERNFS_STATIC_NAME; | |
1291 | kn->name = new_name; | |
1292 | } | |
1293 | ||
1294 | spin_unlock_irq(&kernfs_rename_lock); | |
1295 | ||
9561a896 | 1296 | kn->hash = kernfs_name_hash(kn->name, kn->ns); |
c637b8ac | 1297 | kernfs_link_sibling(kn); |
fd7b9f7b | 1298 | |
3eef34ad TH |
1299 | kernfs_put(old_parent); |
1300 | kfree(old_name); | |
1301 | ||
fd7b9f7b | 1302 | error = 0; |
798c75a0 | 1303 | out: |
a797bfc3 | 1304 | mutex_unlock(&kernfs_mutex); |
fd7b9f7b TH |
1305 | return error; |
1306 | } | |
1307 | ||
fd7b9f7b | 1308 | /* Relationship between s_mode and the DT_xxx types */ |
324a56e1 | 1309 | static inline unsigned char dt_type(struct kernfs_node *kn) |
fd7b9f7b | 1310 | { |
adc5e8b5 | 1311 | return (kn->mode >> 12) & 15; |
fd7b9f7b TH |
1312 | } |
1313 | ||
c637b8ac | 1314 | static int kernfs_dir_fop_release(struct inode *inode, struct file *filp) |
fd7b9f7b TH |
1315 | { |
1316 | kernfs_put(filp->private_data); | |
1317 | return 0; | |
1318 | } | |
1319 | ||
c637b8ac | 1320 | static struct kernfs_node *kernfs_dir_pos(const void *ns, |
324a56e1 | 1321 | struct kernfs_node *parent, loff_t hash, struct kernfs_node *pos) |
fd7b9f7b TH |
1322 | { |
1323 | if (pos) { | |
81c173cb | 1324 | int valid = kernfs_active(pos) && |
798c75a0 | 1325 | pos->parent == parent && hash == pos->hash; |
fd7b9f7b TH |
1326 | kernfs_put(pos); |
1327 | if (!valid) | |
1328 | pos = NULL; | |
1329 | } | |
1330 | if (!pos && (hash > 1) && (hash < INT_MAX)) { | |
adc5e8b5 | 1331 | struct rb_node *node = parent->dir.children.rb_node; |
fd7b9f7b | 1332 | while (node) { |
324a56e1 | 1333 | pos = rb_to_kn(node); |
fd7b9f7b | 1334 | |
adc5e8b5 | 1335 | if (hash < pos->hash) |
fd7b9f7b | 1336 | node = node->rb_left; |
adc5e8b5 | 1337 | else if (hash > pos->hash) |
fd7b9f7b TH |
1338 | node = node->rb_right; |
1339 | else | |
1340 | break; | |
1341 | } | |
1342 | } | |
b9c9dad0 TH |
1343 | /* Skip over entries which are dying/dead or in the wrong namespace */ |
1344 | while (pos && (!kernfs_active(pos) || pos->ns != ns)) { | |
adc5e8b5 | 1345 | struct rb_node *node = rb_next(&pos->rb); |
fd7b9f7b TH |
1346 | if (!node) |
1347 | pos = NULL; | |
1348 | else | |
324a56e1 | 1349 | pos = rb_to_kn(node); |
fd7b9f7b TH |
1350 | } |
1351 | return pos; | |
1352 | } | |
1353 | ||
c637b8ac | 1354 | static struct kernfs_node *kernfs_dir_next_pos(const void *ns, |
324a56e1 | 1355 | struct kernfs_node *parent, ino_t ino, struct kernfs_node *pos) |
fd7b9f7b | 1356 | { |
c637b8ac | 1357 | pos = kernfs_dir_pos(ns, parent, ino, pos); |
b9c9dad0 | 1358 | if (pos) { |
fd7b9f7b | 1359 | do { |
adc5e8b5 | 1360 | struct rb_node *node = rb_next(&pos->rb); |
fd7b9f7b TH |
1361 | if (!node) |
1362 | pos = NULL; | |
1363 | else | |
324a56e1 | 1364 | pos = rb_to_kn(node); |
b9c9dad0 TH |
1365 | } while (pos && (!kernfs_active(pos) || pos->ns != ns)); |
1366 | } | |
fd7b9f7b TH |
1367 | return pos; |
1368 | } | |
1369 | ||
c637b8ac | 1370 | static int kernfs_fop_readdir(struct file *file, struct dir_context *ctx) |
fd7b9f7b TH |
1371 | { |
1372 | struct dentry *dentry = file->f_path.dentry; | |
324a56e1 TH |
1373 | struct kernfs_node *parent = dentry->d_fsdata; |
1374 | struct kernfs_node *pos = file->private_data; | |
fd7b9f7b TH |
1375 | const void *ns = NULL; |
1376 | ||
1377 | if (!dir_emit_dots(file, ctx)) | |
1378 | return 0; | |
a797bfc3 | 1379 | mutex_lock(&kernfs_mutex); |
fd7b9f7b | 1380 | |
324a56e1 | 1381 | if (kernfs_ns_enabled(parent)) |
c525aadd | 1382 | ns = kernfs_info(dentry->d_sb)->ns; |
fd7b9f7b | 1383 | |
c637b8ac | 1384 | for (pos = kernfs_dir_pos(ns, parent, ctx->pos, pos); |
fd7b9f7b | 1385 | pos; |
c637b8ac | 1386 | pos = kernfs_dir_next_pos(ns, parent, ctx->pos, pos)) { |
adc5e8b5 | 1387 | const char *name = pos->name; |
fd7b9f7b TH |
1388 | unsigned int type = dt_type(pos); |
1389 | int len = strlen(name); | |
adc5e8b5 | 1390 | ino_t ino = pos->ino; |
fd7b9f7b | 1391 | |
adc5e8b5 | 1392 | ctx->pos = pos->hash; |
fd7b9f7b TH |
1393 | file->private_data = pos; |
1394 | kernfs_get(pos); | |
1395 | ||
a797bfc3 | 1396 | mutex_unlock(&kernfs_mutex); |
fd7b9f7b TH |
1397 | if (!dir_emit(ctx, name, len, ino, type)) |
1398 | return 0; | |
a797bfc3 | 1399 | mutex_lock(&kernfs_mutex); |
fd7b9f7b | 1400 | } |
a797bfc3 | 1401 | mutex_unlock(&kernfs_mutex); |
fd7b9f7b TH |
1402 | file->private_data = NULL; |
1403 | ctx->pos = INT_MAX; | |
1404 | return 0; | |
1405 | } | |
1406 | ||
c637b8ac TH |
1407 | static loff_t kernfs_dir_fop_llseek(struct file *file, loff_t offset, |
1408 | int whence) | |
fd7b9f7b TH |
1409 | { |
1410 | struct inode *inode = file_inode(file); | |
1411 | loff_t ret; | |
1412 | ||
1413 | mutex_lock(&inode->i_mutex); | |
1414 | ret = generic_file_llseek(file, offset, whence); | |
1415 | mutex_unlock(&inode->i_mutex); | |
1416 | ||
1417 | return ret; | |
1418 | } | |
1419 | ||
a797bfc3 | 1420 | const struct file_operations kernfs_dir_fops = { |
fd7b9f7b | 1421 | .read = generic_read_dir, |
c637b8ac TH |
1422 | .iterate = kernfs_fop_readdir, |
1423 | .release = kernfs_dir_fop_release, | |
1424 | .llseek = kernfs_dir_fop_llseek, | |
fd7b9f7b | 1425 | }; |