blob: 33f711f6b86ec4e174ce8f74b13eb1d2701d0095 [file] [log] [blame]
Tejun Heob8441ed2013-11-24 09:54:58 -05001/*
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 */
Tejun Heofd7b9f72013-11-28 14:54:33 -050010
Tejun Heoabd54f02014-02-03 14:02:55 -050011#include <linux/sched.h>
Tejun Heofd7b9f72013-11-28 14:54:33 -050012#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
Tejun Heoa797bfc2013-12-11 14:11:57 -050021DEFINE_MUTEX(kernfs_mutex);
Tejun Heo3eef34a2014-02-07 13:32:07 -050022static DEFINE_SPINLOCK(kernfs_rename_lock); /* kn->parent and ->name */
23static char kernfs_pr_cont_buf[PATH_MAX]; /* protected by rename_lock */
Shaohua Li7d350792017-07-12 11:49:46 -070024static DEFINE_SPINLOCK(kernfs_idr_lock); /* root->ino_idr */
Tejun Heofd7b9f72013-11-28 14:54:33 -050025
Tejun Heoadc5e8b2013-12-11 14:11:54 -050026#define rb_to_kn(X) rb_entry((X), struct kernfs_node, rb)
Tejun Heofd7b9f72013-11-28 14:54:33 -050027
Tejun Heo81c173c2014-02-03 14:03:00 -050028static bool kernfs_active(struct kernfs_node *kn)
29{
30 lockdep_assert_held(&kernfs_mutex);
31 return atomic_read(&kn->active) >= 0;
32}
33
Tejun Heo182fd642014-02-03 14:02:59 -050034static bool kernfs_lockdep(struct kernfs_node *kn)
35{
36#ifdef CONFIG_DEBUG_LOCK_ALLOC
37 return kn->flags & KERNFS_LOCKDEP;
38#else
39 return false;
40#endif
41}
42
Tejun Heo3eef34a2014-02-07 13:32:07 -050043static int kernfs_name_locked(struct kernfs_node *kn, char *buf, size_t buflen)
44{
Konstantin Khlebnikov17627152017-02-08 14:28:55 +030045 if (!kn)
46 return strlcpy(buf, "(null)", buflen);
47
Tejun Heo3eef34a2014-02-07 13:32:07 -050048 return strlcpy(buf, kn->parent ? kn->name : "/", buflen);
49}
50
Aditya Kali9f6df572016-01-29 02:54:04 -060051/* kernfs_node_depth - compute depth from @from to @to */
52static size_t kernfs_depth(struct kernfs_node *from, struct kernfs_node *to)
Tejun Heo3eef34a2014-02-07 13:32:07 -050053{
Aditya Kali9f6df572016-01-29 02:54:04 -060054 size_t depth = 0;
Tejun Heo3eef34a2014-02-07 13:32:07 -050055
Aditya Kali9f6df572016-01-29 02:54:04 -060056 while (to->parent && to != from) {
57 depth++;
58 to = to->parent;
59 }
60 return depth;
61}
Tejun Heo3eef34a2014-02-07 13:32:07 -050062
Aditya Kali9f6df572016-01-29 02:54:04 -060063static struct kernfs_node *kernfs_common_ancestor(struct kernfs_node *a,
64 struct kernfs_node *b)
65{
66 size_t da, db;
67 struct kernfs_root *ra = kernfs_root(a), *rb = kernfs_root(b);
Tejun Heo3eef34a2014-02-07 13:32:07 -050068
Aditya Kali9f6df572016-01-29 02:54:04 -060069 if (ra != rb)
70 return NULL;
71
72 da = kernfs_depth(ra->kn, a);
73 db = kernfs_depth(rb->kn, b);
74
75 while (da > db) {
76 a = a->parent;
77 da--;
78 }
79 while (db > da) {
80 b = b->parent;
81 db--;
82 }
83
84 /* worst case b and a will be the same at root */
85 while (b != a) {
86 b = b->parent;
87 a = a->parent;
88 }
89
90 return a;
91}
92
93/**
94 * kernfs_path_from_node_locked - find a pseudo-absolute path to @kn_to,
95 * where kn_from is treated as root of the path.
96 * @kn_from: kernfs node which should be treated as root for the path
97 * @kn_to: kernfs node to which path is needed
98 * @buf: buffer to copy the path into
99 * @buflen: size of @buf
100 *
101 * We need to handle couple of scenarios here:
102 * [1] when @kn_from is an ancestor of @kn_to at some level
103 * kn_from: /n1/n2/n3
104 * kn_to: /n1/n2/n3/n4/n5
105 * result: /n4/n5
106 *
107 * [2] when @kn_from is on a different hierarchy and we need to find common
108 * ancestor between @kn_from and @kn_to.
109 * kn_from: /n1/n2/n3/n4
110 * kn_to: /n1/n2/n5
111 * result: /../../n5
112 * OR
113 * kn_from: /n1/n2/n3/n4/n5 [depth=5]
114 * kn_to: /n1/n2/n3 [depth=3]
115 * result: /../..
116 *
Konstantin Khlebnikov17627152017-02-08 14:28:55 +0300117 * [3] when @kn_to is NULL result will be "(null)"
118 *
Tejun Heo3abb1d92016-08-10 11:23:44 -0400119 * Returns the length of the full path. If the full length is equal to or
120 * greater than @buflen, @buf contains the truncated path with the trailing
121 * '\0'. On error, -errno is returned.
Aditya Kali9f6df572016-01-29 02:54:04 -0600122 */
123static int kernfs_path_from_node_locked(struct kernfs_node *kn_to,
124 struct kernfs_node *kn_from,
125 char *buf, size_t buflen)
126{
127 struct kernfs_node *kn, *common;
128 const char parent_str[] = "/..";
Tejun Heo3abb1d92016-08-10 11:23:44 -0400129 size_t depth_from, depth_to, len = 0;
130 int i, j;
Aditya Kali9f6df572016-01-29 02:54:04 -0600131
Konstantin Khlebnikov17627152017-02-08 14:28:55 +0300132 if (!kn_to)
133 return strlcpy(buf, "(null)", buflen);
134
Aditya Kali9f6df572016-01-29 02:54:04 -0600135 if (!kn_from)
136 kn_from = kernfs_root(kn_to)->kn;
137
138 if (kn_from == kn_to)
139 return strlcpy(buf, "/", buflen);
140
141 common = kernfs_common_ancestor(kn_from, kn_to);
142 if (WARN_ON(!common))
Tejun Heo3abb1d92016-08-10 11:23:44 -0400143 return -EINVAL;
Aditya Kali9f6df572016-01-29 02:54:04 -0600144
145 depth_to = kernfs_depth(common, kn_to);
146 depth_from = kernfs_depth(common, kn_from);
147
148 if (buf)
149 buf[0] = '\0';
150
151 for (i = 0; i < depth_from; i++)
152 len += strlcpy(buf + len, parent_str,
153 len < buflen ? buflen - len : 0);
154
155 /* Calculate how many bytes we need for the rest */
Tejun Heo3abb1d92016-08-10 11:23:44 -0400156 for (i = depth_to - 1; i >= 0; i--) {
157 for (kn = kn_to, j = 0; j < i; j++)
158 kn = kn->parent;
159 len += strlcpy(buf + len, "/",
160 len < buflen ? buflen - len : 0);
161 len += strlcpy(buf + len, kn->name,
162 len < buflen ? buflen - len : 0);
Aditya Kali9f6df572016-01-29 02:54:04 -0600163 }
164
Tejun Heo3abb1d92016-08-10 11:23:44 -0400165 return len;
Tejun Heo3eef34a2014-02-07 13:32:07 -0500166}
167
168/**
169 * kernfs_name - obtain the name of a given node
170 * @kn: kernfs_node of interest
171 * @buf: buffer to copy @kn's name into
172 * @buflen: size of @buf
173 *
174 * Copies the name of @kn into @buf of @buflen bytes. The behavior is
175 * similar to strlcpy(). It returns the length of @kn's name and if @buf
176 * isn't long enough, it's filled upto @buflen-1 and nul terminated.
177 *
Konstantin Khlebnikov17627152017-02-08 14:28:55 +0300178 * Fills buffer with "(null)" if @kn is NULL.
179 *
Tejun Heo3eef34a2014-02-07 13:32:07 -0500180 * This function can be called from any context.
181 */
182int kernfs_name(struct kernfs_node *kn, char *buf, size_t buflen)
183{
184 unsigned long flags;
185 int ret;
186
187 spin_lock_irqsave(&kernfs_rename_lock, flags);
188 ret = kernfs_name_locked(kn, buf, buflen);
189 spin_unlock_irqrestore(&kernfs_rename_lock, flags);
190 return ret;
191}
192
193/**
Aditya Kali9f6df572016-01-29 02:54:04 -0600194 * kernfs_path_from_node - build path of node @to relative to @from.
195 * @from: parent kernfs_node relative to which we need to build the path
196 * @to: kernfs_node of interest
197 * @buf: buffer to copy @to's path into
198 * @buflen: size of @buf
199 *
200 * Builds @to's path relative to @from in @buf. @from and @to must
201 * be on the same kernfs-root. If @from is not parent of @to, then a relative
202 * path (which includes '..'s) as needed to reach from @from to @to is
203 * returned.
204 *
Tejun Heo3abb1d92016-08-10 11:23:44 -0400205 * Returns the length of the full path. If the full length is equal to or
206 * greater than @buflen, @buf contains the truncated path with the trailing
207 * '\0'. On error, -errno is returned.
Aditya Kali9f6df572016-01-29 02:54:04 -0600208 */
209int kernfs_path_from_node(struct kernfs_node *to, struct kernfs_node *from,
210 char *buf, size_t buflen)
211{
212 unsigned long flags;
213 int ret;
214
215 spin_lock_irqsave(&kernfs_rename_lock, flags);
216 ret = kernfs_path_from_node_locked(to, from, buf, buflen);
217 spin_unlock_irqrestore(&kernfs_rename_lock, flags);
218 return ret;
219}
220EXPORT_SYMBOL_GPL(kernfs_path_from_node);
221
222/**
Tejun Heo3eef34a2014-02-07 13:32:07 -0500223 * pr_cont_kernfs_name - pr_cont name of a kernfs_node
224 * @kn: kernfs_node of interest
225 *
226 * This function can be called from any context.
227 */
228void pr_cont_kernfs_name(struct kernfs_node *kn)
229{
230 unsigned long flags;
231
232 spin_lock_irqsave(&kernfs_rename_lock, flags);
233
234 kernfs_name_locked(kn, kernfs_pr_cont_buf, sizeof(kernfs_pr_cont_buf));
235 pr_cont("%s", kernfs_pr_cont_buf);
236
237 spin_unlock_irqrestore(&kernfs_rename_lock, flags);
238}
239
240/**
241 * pr_cont_kernfs_path - pr_cont path of a kernfs_node
242 * @kn: kernfs_node of interest
243 *
244 * This function can be called from any context.
245 */
246void pr_cont_kernfs_path(struct kernfs_node *kn)
247{
248 unsigned long flags;
Aditya Kali9f6df572016-01-29 02:54:04 -0600249 int sz;
Tejun Heo3eef34a2014-02-07 13:32:07 -0500250
251 spin_lock_irqsave(&kernfs_rename_lock, flags);
252
Aditya Kali9f6df572016-01-29 02:54:04 -0600253 sz = kernfs_path_from_node_locked(kn, NULL, kernfs_pr_cont_buf,
254 sizeof(kernfs_pr_cont_buf));
255 if (sz < 0) {
256 pr_cont("(error)");
257 goto out;
258 }
Tejun Heo3eef34a2014-02-07 13:32:07 -0500259
Aditya Kali9f6df572016-01-29 02:54:04 -0600260 if (sz >= sizeof(kernfs_pr_cont_buf)) {
261 pr_cont("(name too long)");
262 goto out;
263 }
264
265 pr_cont("%s", kernfs_pr_cont_buf);
266
267out:
Tejun Heo3eef34a2014-02-07 13:32:07 -0500268 spin_unlock_irqrestore(&kernfs_rename_lock, flags);
269}
270
271/**
272 * kernfs_get_parent - determine the parent node and pin it
273 * @kn: kernfs_node of interest
274 *
275 * Determines @kn's parent, pins and returns it. This function can be
276 * called from any context.
277 */
278struct kernfs_node *kernfs_get_parent(struct kernfs_node *kn)
279{
280 struct kernfs_node *parent;
281 unsigned long flags;
282
283 spin_lock_irqsave(&kernfs_rename_lock, flags);
284 parent = kn->parent;
285 kernfs_get(parent);
286 spin_unlock_irqrestore(&kernfs_rename_lock, flags);
287
288 return parent;
289}
290
Tejun Heofd7b9f72013-11-28 14:54:33 -0500291/**
Tejun Heoc637b8a2013-12-11 14:11:58 -0500292 * kernfs_name_hash
Tejun Heofd7b9f72013-11-28 14:54:33 -0500293 * @name: Null terminated string to hash
294 * @ns: Namespace tag to hash
295 *
296 * Returns 31 bit hash of ns + name (so it fits in an off_t )
297 */
Tejun Heoc637b8a2013-12-11 14:11:58 -0500298static unsigned int kernfs_name_hash(const char *name, const void *ns)
Tejun Heofd7b9f72013-11-28 14:54:33 -0500299{
Linus Torvalds8387ff22016-06-10 07:51:30 -0700300 unsigned long hash = init_name_hash(ns);
Tejun Heofd7b9f72013-11-28 14:54:33 -0500301 unsigned int len = strlen(name);
302 while (len--)
303 hash = partial_name_hash(*name++, hash);
Linus Torvalds8387ff22016-06-10 07:51:30 -0700304 hash = end_name_hash(hash);
Tejun Heofd7b9f72013-11-28 14:54:33 -0500305 hash &= 0x7fffffffU;
306 /* Reserve hash numbers 0, 1 and INT_MAX for magic directory entries */
Richard Cochran88391d42014-03-05 17:10:52 +0100307 if (hash < 2)
Tejun Heofd7b9f72013-11-28 14:54:33 -0500308 hash += 2;
309 if (hash >= INT_MAX)
310 hash = INT_MAX - 1;
311 return hash;
312}
313
Tejun Heoc637b8a2013-12-11 14:11:58 -0500314static int kernfs_name_compare(unsigned int hash, const char *name,
315 const void *ns, const struct kernfs_node *kn)
Tejun Heofd7b9f72013-11-28 14:54:33 -0500316{
Rasmus Villemoes72392ed2014-12-05 23:41:33 +0100317 if (hash < kn->hash)
318 return -1;
319 if (hash > kn->hash)
320 return 1;
321 if (ns < kn->ns)
322 return -1;
323 if (ns > kn->ns)
324 return 1;
Tejun Heoadc5e8b2013-12-11 14:11:54 -0500325 return strcmp(name, kn->name);
Tejun Heofd7b9f72013-11-28 14:54:33 -0500326}
327
Tejun Heoc637b8a2013-12-11 14:11:58 -0500328static int kernfs_sd_compare(const struct kernfs_node *left,
329 const struct kernfs_node *right)
Tejun Heofd7b9f72013-11-28 14:54:33 -0500330{
Tejun Heoc637b8a2013-12-11 14:11:58 -0500331 return kernfs_name_compare(left->hash, left->name, left->ns, right);
Tejun Heofd7b9f72013-11-28 14:54:33 -0500332}
333
334/**
Tejun Heoc637b8a2013-12-11 14:11:58 -0500335 * kernfs_link_sibling - link kernfs_node into sibling rbtree
Tejun Heo324a56e2013-12-11 14:11:53 -0500336 * @kn: kernfs_node of interest
Tejun Heofd7b9f72013-11-28 14:54:33 -0500337 *
Tejun Heo324a56e2013-12-11 14:11:53 -0500338 * Link @kn into its sibling rbtree which starts from
Tejun Heoadc5e8b2013-12-11 14:11:54 -0500339 * @kn->parent->dir.children.
Tejun Heofd7b9f72013-11-28 14:54:33 -0500340 *
341 * Locking:
Tejun Heoa797bfc2013-12-11 14:11:57 -0500342 * mutex_lock(kernfs_mutex)
Tejun Heofd7b9f72013-11-28 14:54:33 -0500343 *
344 * RETURNS:
345 * 0 on susccess -EEXIST on failure.
346 */
Tejun Heoc637b8a2013-12-11 14:11:58 -0500347static int kernfs_link_sibling(struct kernfs_node *kn)
Tejun Heofd7b9f72013-11-28 14:54:33 -0500348{
Tejun Heoadc5e8b2013-12-11 14:11:54 -0500349 struct rb_node **node = &kn->parent->dir.children.rb_node;
Tejun Heofd7b9f72013-11-28 14:54:33 -0500350 struct rb_node *parent = NULL;
351
Tejun Heofd7b9f72013-11-28 14:54:33 -0500352 while (*node) {
Tejun Heo324a56e2013-12-11 14:11:53 -0500353 struct kernfs_node *pos;
Tejun Heofd7b9f72013-11-28 14:54:33 -0500354 int result;
355
Tejun Heo324a56e2013-12-11 14:11:53 -0500356 pos = rb_to_kn(*node);
Tejun Heofd7b9f72013-11-28 14:54:33 -0500357 parent = *node;
Tejun Heoc637b8a2013-12-11 14:11:58 -0500358 result = kernfs_sd_compare(kn, pos);
Tejun Heofd7b9f72013-11-28 14:54:33 -0500359 if (result < 0)
Tejun Heoadc5e8b2013-12-11 14:11:54 -0500360 node = &pos->rb.rb_left;
Tejun Heofd7b9f72013-11-28 14:54:33 -0500361 else if (result > 0)
Tejun Heoadc5e8b2013-12-11 14:11:54 -0500362 node = &pos->rb.rb_right;
Tejun Heofd7b9f72013-11-28 14:54:33 -0500363 else
364 return -EEXIST;
365 }
Jianyu Zhanc1befb82014-04-17 17:52:10 +0800366
Tejun Heofd7b9f72013-11-28 14:54:33 -0500367 /* add new node and rebalance the tree */
Tejun Heoadc5e8b2013-12-11 14:11:54 -0500368 rb_link_node(&kn->rb, parent, node);
369 rb_insert_color(&kn->rb, &kn->parent->dir.children);
Jianyu Zhanc1befb82014-04-17 17:52:10 +0800370
371 /* successfully added, account subdir number */
372 if (kernfs_type(kn) == KERNFS_DIR)
373 kn->parent->dir.subdirs++;
374
Tejun Heofd7b9f72013-11-28 14:54:33 -0500375 return 0;
376}
377
378/**
Tejun Heoc637b8a2013-12-11 14:11:58 -0500379 * kernfs_unlink_sibling - unlink kernfs_node from sibling rbtree
Tejun Heo324a56e2013-12-11 14:11:53 -0500380 * @kn: kernfs_node of interest
Tejun Heofd7b9f72013-11-28 14:54:33 -0500381 *
Tejun Heo35beab02014-02-03 14:02:56 -0500382 * Try to unlink @kn from its sibling rbtree which starts from
383 * kn->parent->dir.children. Returns %true if @kn was actually
384 * removed, %false if @kn wasn't on the rbtree.
Tejun Heofd7b9f72013-11-28 14:54:33 -0500385 *
386 * Locking:
Tejun Heoa797bfc2013-12-11 14:11:57 -0500387 * mutex_lock(kernfs_mutex)
Tejun Heofd7b9f72013-11-28 14:54:33 -0500388 */
Tejun Heo35beab02014-02-03 14:02:56 -0500389static bool kernfs_unlink_sibling(struct kernfs_node *kn)
Tejun Heofd7b9f72013-11-28 14:54:33 -0500390{
Tejun Heo35beab02014-02-03 14:02:56 -0500391 if (RB_EMPTY_NODE(&kn->rb))
392 return false;
393
Tejun Heodf23fc32013-12-11 14:11:56 -0500394 if (kernfs_type(kn) == KERNFS_DIR)
Tejun Heoadc5e8b2013-12-11 14:11:54 -0500395 kn->parent->dir.subdirs--;
Tejun Heofd7b9f72013-11-28 14:54:33 -0500396
Tejun Heoadc5e8b2013-12-11 14:11:54 -0500397 rb_erase(&kn->rb, &kn->parent->dir.children);
Tejun Heo35beab02014-02-03 14:02:56 -0500398 RB_CLEAR_NODE(&kn->rb);
399 return true;
Tejun Heofd7b9f72013-11-28 14:54:33 -0500400}
401
402/**
Tejun Heoc637b8a2013-12-11 14:11:58 -0500403 * kernfs_get_active - get an active reference to kernfs_node
Tejun Heo324a56e2013-12-11 14:11:53 -0500404 * @kn: kernfs_node to get an active reference to
Tejun Heofd7b9f72013-11-28 14:54:33 -0500405 *
Tejun Heo324a56e2013-12-11 14:11:53 -0500406 * Get an active reference of @kn. This function is noop if @kn
Tejun Heofd7b9f72013-11-28 14:54:33 -0500407 * is NULL.
408 *
409 * RETURNS:
Tejun Heo324a56e2013-12-11 14:11:53 -0500410 * Pointer to @kn on success, NULL on failure.
Tejun Heofd7b9f72013-11-28 14:54:33 -0500411 */
Tejun Heoc637b8a2013-12-11 14:11:58 -0500412struct kernfs_node *kernfs_get_active(struct kernfs_node *kn)
Tejun Heofd7b9f72013-11-28 14:54:33 -0500413{
Tejun Heo324a56e2013-12-11 14:11:53 -0500414 if (unlikely(!kn))
Tejun Heofd7b9f72013-11-28 14:54:33 -0500415 return NULL;
416
Greg Kroah-Hartmanf4b3e632014-01-13 14:13:39 -0800417 if (!atomic_inc_unless_negative(&kn->active))
418 return NULL;
419
Tejun Heo182fd642014-02-03 14:02:59 -0500420 if (kernfs_lockdep(kn))
Tejun Heo324a56e2013-12-11 14:11:53 -0500421 rwsem_acquire_read(&kn->dep_map, 0, 1, _RET_IP_);
Greg Kroah-Hartmanf4b3e632014-01-13 14:13:39 -0800422 return kn;
Tejun Heofd7b9f72013-11-28 14:54:33 -0500423}
424
425/**
Tejun Heoc637b8a2013-12-11 14:11:58 -0500426 * kernfs_put_active - put an active reference to kernfs_node
Tejun Heo324a56e2013-12-11 14:11:53 -0500427 * @kn: kernfs_node to put an active reference to
Tejun Heofd7b9f72013-11-28 14:54:33 -0500428 *
Tejun Heo324a56e2013-12-11 14:11:53 -0500429 * Put an active reference to @kn. This function is noop if @kn
Tejun Heofd7b9f72013-11-28 14:54:33 -0500430 * is NULL.
431 */
Tejun Heoc637b8a2013-12-11 14:11:58 -0500432void kernfs_put_active(struct kernfs_node *kn)
Tejun Heofd7b9f72013-11-28 14:54:33 -0500433{
Tejun Heoabd54f02014-02-03 14:02:55 -0500434 struct kernfs_root *root = kernfs_root(kn);
Tejun Heofd7b9f72013-11-28 14:54:33 -0500435 int v;
436
Tejun Heo324a56e2013-12-11 14:11:53 -0500437 if (unlikely(!kn))
Tejun Heofd7b9f72013-11-28 14:54:33 -0500438 return;
439
Tejun Heo182fd642014-02-03 14:02:59 -0500440 if (kernfs_lockdep(kn))
Tejun Heo324a56e2013-12-11 14:11:53 -0500441 rwsem_release(&kn->dep_map, 1, _RET_IP_);
Tejun Heoadc5e8b2013-12-11 14:11:54 -0500442 v = atomic_dec_return(&kn->active);
Tejun Heodf23fc32013-12-11 14:11:56 -0500443 if (likely(v != KN_DEACTIVATED_BIAS))
Tejun Heofd7b9f72013-11-28 14:54:33 -0500444 return;
445
Tejun Heoabd54f02014-02-03 14:02:55 -0500446 wake_up_all(&root->deactivate_waitq);
Tejun Heofd7b9f72013-11-28 14:54:33 -0500447}
448
449/**
Tejun Heo81c173c2014-02-03 14:03:00 -0500450 * kernfs_drain - drain kernfs_node
451 * @kn: kernfs_node to drain
Tejun Heofd7b9f72013-11-28 14:54:33 -0500452 *
Tejun Heo81c173c2014-02-03 14:03:00 -0500453 * Drain existing usages and nuke all existing mmaps of @kn. Mutiple
454 * removers may invoke this function concurrently on @kn and all will
455 * return after draining is complete.
Tejun Heofd7b9f72013-11-28 14:54:33 -0500456 */
Tejun Heo81c173c2014-02-03 14:03:00 -0500457static void kernfs_drain(struct kernfs_node *kn)
Tejun Heo35beab02014-02-03 14:02:56 -0500458 __releases(&kernfs_mutex) __acquires(&kernfs_mutex)
Tejun Heofd7b9f72013-11-28 14:54:33 -0500459{
Tejun Heoabd54f02014-02-03 14:02:55 -0500460 struct kernfs_root *root = kernfs_root(kn);
Tejun Heofd7b9f72013-11-28 14:54:33 -0500461
Tejun Heo35beab02014-02-03 14:02:56 -0500462 lockdep_assert_held(&kernfs_mutex);
Tejun Heo81c173c2014-02-03 14:03:00 -0500463 WARN_ON_ONCE(kernfs_active(kn));
Tejun Heo35beab02014-02-03 14:02:56 -0500464
465 mutex_unlock(&kernfs_mutex);
466
Tejun Heo182fd642014-02-03 14:02:59 -0500467 if (kernfs_lockdep(kn)) {
Tejun Heoa6607932014-02-03 14:02:54 -0500468 rwsem_acquire(&kn->dep_map, 0, 0, _RET_IP_);
Tejun Heo35beab02014-02-03 14:02:56 -0500469 if (atomic_read(&kn->active) != KN_DEACTIVATED_BIAS)
470 lock_contended(&kn->dep_map, _RET_IP_);
471 }
Greg Kroah-Hartman08901472014-01-13 14:39:52 -0800472
Tejun Heo35beab02014-02-03 14:02:56 -0500473 /* but everyone should wait for draining */
Tejun Heoabd54f02014-02-03 14:02:55 -0500474 wait_event(root->deactivate_waitq,
475 atomic_read(&kn->active) == KN_DEACTIVATED_BIAS);
Tejun Heofd7b9f72013-11-28 14:54:33 -0500476
Tejun Heo182fd642014-02-03 14:02:59 -0500477 if (kernfs_lockdep(kn)) {
Tejun Heoa6607932014-02-03 14:02:54 -0500478 lock_acquired(&kn->dep_map, _RET_IP_);
479 rwsem_release(&kn->dep_map, 1, _RET_IP_);
480 }
Tejun Heo35beab02014-02-03 14:02:56 -0500481
Tejun Heo0e67db22016-12-27 14:49:03 -0500482 kernfs_drain_open_files(kn);
Tejun Heoccf02aa2014-02-03 14:02:57 -0500483
Tejun Heo35beab02014-02-03 14:02:56 -0500484 mutex_lock(&kernfs_mutex);
Tejun Heofd7b9f72013-11-28 14:54:33 -0500485}
486
Tejun Heofd7b9f72013-11-28 14:54:33 -0500487/**
Tejun Heo324a56e2013-12-11 14:11:53 -0500488 * kernfs_get - get a reference count on a kernfs_node
489 * @kn: the target kernfs_node
Tejun Heofd7b9f72013-11-28 14:54:33 -0500490 */
Tejun Heo324a56e2013-12-11 14:11:53 -0500491void kernfs_get(struct kernfs_node *kn)
Tejun Heofd7b9f72013-11-28 14:54:33 -0500492{
Tejun Heo324a56e2013-12-11 14:11:53 -0500493 if (kn) {
Tejun Heoadc5e8b2013-12-11 14:11:54 -0500494 WARN_ON(!atomic_read(&kn->count));
495 atomic_inc(&kn->count);
Tejun Heofd7b9f72013-11-28 14:54:33 -0500496 }
497}
498EXPORT_SYMBOL_GPL(kernfs_get);
499
500/**
Tejun Heo324a56e2013-12-11 14:11:53 -0500501 * kernfs_put - put a reference count on a kernfs_node
502 * @kn: the target kernfs_node
Tejun Heofd7b9f72013-11-28 14:54:33 -0500503 *
Tejun Heo324a56e2013-12-11 14:11:53 -0500504 * Put a reference count of @kn and destroy it if it reached zero.
Tejun Heofd7b9f72013-11-28 14:54:33 -0500505 */
Tejun Heo324a56e2013-12-11 14:11:53 -0500506void kernfs_put(struct kernfs_node *kn)
Tejun Heofd7b9f72013-11-28 14:54:33 -0500507{
Tejun Heo324a56e2013-12-11 14:11:53 -0500508 struct kernfs_node *parent;
Tejun Heoba7443b2013-11-28 14:54:40 -0500509 struct kernfs_root *root;
Tejun Heofd7b9f72013-11-28 14:54:33 -0500510
Tejun Heoadc5e8b2013-12-11 14:11:54 -0500511 if (!kn || !atomic_dec_and_test(&kn->count))
Tejun Heofd7b9f72013-11-28 14:54:33 -0500512 return;
Tejun Heo324a56e2013-12-11 14:11:53 -0500513 root = kernfs_root(kn);
Tejun Heofd7b9f72013-11-28 14:54:33 -0500514 repeat:
Tejun Heo81c173c2014-02-03 14:03:00 -0500515 /*
516 * Moving/renaming is always done while holding reference.
Tejun Heoadc5e8b2013-12-11 14:11:54 -0500517 * kn->parent won't change beneath us.
Tejun Heofd7b9f72013-11-28 14:54:33 -0500518 */
Tejun Heoadc5e8b2013-12-11 14:11:54 -0500519 parent = kn->parent;
Tejun Heofd7b9f72013-11-28 14:54:33 -0500520
Tejun Heo81c173c2014-02-03 14:03:00 -0500521 WARN_ONCE(atomic_read(&kn->active) != KN_DEACTIVATED_BIAS,
522 "kernfs_put: %s/%s: released with incorrect active_ref %d\n",
523 parent ? parent->name : "", kn->name, atomic_read(&kn->active));
Tejun Heofd7b9f72013-11-28 14:54:33 -0500524
Tejun Heodf23fc32013-12-11 14:11:56 -0500525 if (kernfs_type(kn) == KERNFS_LINK)
Tejun Heoadc5e8b2013-12-11 14:11:54 -0500526 kernfs_put(kn->symlink.target_kn);
Tejun Heodfeb07502015-02-13 14:36:31 -0800527
528 kfree_const(kn->name);
529
Tejun Heoadc5e8b2013-12-11 14:11:54 -0500530 if (kn->iattr) {
531 if (kn->iattr->ia_secdata)
532 security_release_secctx(kn->iattr->ia_secdata,
533 kn->iattr->ia_secdata_len);
534 simple_xattrs_free(&kn->iattr->xattrs);
Tejun Heo23223922013-11-23 17:40:02 -0500535 }
Tejun Heoadc5e8b2013-12-11 14:11:54 -0500536 kfree(kn->iattr);
Shaohua Li7d350792017-07-12 11:49:46 -0700537 spin_lock(&kernfs_idr_lock);
538 idr_remove(&root->ino_idr, kn->ino);
539 spin_unlock(&kernfs_idr_lock);
Tejun Heoa797bfc2013-12-11 14:11:57 -0500540 kmem_cache_free(kernfs_node_cache, kn);
Tejun Heofd7b9f72013-11-28 14:54:33 -0500541
Tejun Heo324a56e2013-12-11 14:11:53 -0500542 kn = parent;
543 if (kn) {
Tejun Heoadc5e8b2013-12-11 14:11:54 -0500544 if (atomic_dec_and_test(&kn->count))
Tejun Heoba7443b2013-11-28 14:54:40 -0500545 goto repeat;
546 } else {
Tejun Heo324a56e2013-12-11 14:11:53 -0500547 /* just released the root kn, free @root too */
Shaohua Li7d350792017-07-12 11:49:46 -0700548 idr_destroy(&root->ino_idr);
Tejun Heoba7443b2013-11-28 14:54:40 -0500549 kfree(root);
550 }
Tejun Heofd7b9f72013-11-28 14:54:33 -0500551}
552EXPORT_SYMBOL_GPL(kernfs_put);
553
Tejun Heoc637b8a2013-12-11 14:11:58 -0500554static int kernfs_dop_revalidate(struct dentry *dentry, unsigned int flags)
Tejun Heofd7b9f72013-11-28 14:54:33 -0500555{
Tejun Heo324a56e2013-12-11 14:11:53 -0500556 struct kernfs_node *kn;
Tejun Heofd7b9f72013-11-28 14:54:33 -0500557
558 if (flags & LOOKUP_RCU)
559 return -ECHILD;
560
Tejun Heo19bbb922013-12-11 16:02:59 -0500561 /* Always perform fresh lookup for negatives */
David Howells2b0143b2015-03-17 22:25:59 +0000562 if (d_really_is_negative(dentry))
Tejun Heo19bbb922013-12-11 16:02:59 -0500563 goto out_bad_unlocked;
564
Tejun Heo324a56e2013-12-11 14:11:53 -0500565 kn = dentry->d_fsdata;
Tejun Heoa797bfc2013-12-11 14:11:57 -0500566 mutex_lock(&kernfs_mutex);
Tejun Heofd7b9f72013-11-28 14:54:33 -0500567
Tejun Heo81c173c2014-02-03 14:03:00 -0500568 /* The kernfs node has been deactivated */
569 if (!kernfs_active(kn))
Tejun Heofd7b9f72013-11-28 14:54:33 -0500570 goto out_bad;
571
Tejun Heoc637b8a2013-12-11 14:11:58 -0500572 /* The kernfs node has been moved? */
Tejun Heoadc5e8b2013-12-11 14:11:54 -0500573 if (dentry->d_parent->d_fsdata != kn->parent)
Tejun Heofd7b9f72013-11-28 14:54:33 -0500574 goto out_bad;
575
Tejun Heoc637b8a2013-12-11 14:11:58 -0500576 /* The kernfs node has been renamed */
Tejun Heoadc5e8b2013-12-11 14:11:54 -0500577 if (strcmp(dentry->d_name.name, kn->name) != 0)
Tejun Heofd7b9f72013-11-28 14:54:33 -0500578 goto out_bad;
579
Tejun Heoc637b8a2013-12-11 14:11:58 -0500580 /* The kernfs node has been moved to a different namespace */
Tejun Heoadc5e8b2013-12-11 14:11:54 -0500581 if (kn->parent && kernfs_ns_enabled(kn->parent) &&
Tejun Heoc525aad2013-12-11 14:11:55 -0500582 kernfs_info(dentry->d_sb)->ns != kn->ns)
Tejun Heofd7b9f72013-11-28 14:54:33 -0500583 goto out_bad;
584
Tejun Heoa797bfc2013-12-11 14:11:57 -0500585 mutex_unlock(&kernfs_mutex);
Tejun Heofd7b9f72013-11-28 14:54:33 -0500586 return 1;
587out_bad:
Tejun Heoa797bfc2013-12-11 14:11:57 -0500588 mutex_unlock(&kernfs_mutex);
Tejun Heo19bbb922013-12-11 16:02:59 -0500589out_bad_unlocked:
Tejun Heofd7b9f72013-11-28 14:54:33 -0500590 return 0;
591}
592
Tejun Heoc637b8a2013-12-11 14:11:58 -0500593static void kernfs_dop_release(struct dentry *dentry)
Tejun Heofd7b9f72013-11-28 14:54:33 -0500594{
595 kernfs_put(dentry->d_fsdata);
596}
597
Tejun Heoa797bfc2013-12-11 14:11:57 -0500598const struct dentry_operations kernfs_dops = {
Tejun Heoc637b8a2013-12-11 14:11:58 -0500599 .d_revalidate = kernfs_dop_revalidate,
Tejun Heoc637b8a2013-12-11 14:11:58 -0500600 .d_release = kernfs_dop_release,
Tejun Heofd7b9f72013-11-28 14:54:33 -0500601};
602
Tejun Heo0c23b222014-02-03 14:09:15 -0500603/**
604 * kernfs_node_from_dentry - determine kernfs_node associated with a dentry
605 * @dentry: the dentry in question
606 *
607 * Return the kernfs_node associated with @dentry. If @dentry is not a
608 * kernfs one, %NULL is returned.
609 *
610 * While the returned kernfs_node will stay accessible as long as @dentry
611 * is accessible, the returned node can be in any state and the caller is
612 * fully responsible for determining what's accessible.
613 */
614struct kernfs_node *kernfs_node_from_dentry(struct dentry *dentry)
615{
Li Zefanf41c5932014-02-14 16:57:27 +0800616 if (dentry->d_sb->s_op == &kernfs_sops)
Tejun Heo0c23b222014-02-03 14:09:15 -0500617 return dentry->d_fsdata;
618 return NULL;
619}
620
Tejun Heodb4aad22014-01-17 09:58:25 -0500621static struct kernfs_node *__kernfs_new_node(struct kernfs_root *root,
622 const char *name, umode_t mode,
623 unsigned flags)
Tejun Heofd7b9f72013-11-28 14:54:33 -0500624{
Tejun Heo324a56e2013-12-11 14:11:53 -0500625 struct kernfs_node *kn;
Shaohua Li4a3ef682017-07-12 11:49:47 -0700626 u32 gen;
627 int cursor;
Tejun Heobc755552013-11-28 14:54:41 -0500628 int ret;
Tejun Heofd7b9f72013-11-28 14:54:33 -0500629
Tejun Heodfeb07502015-02-13 14:36:31 -0800630 name = kstrdup_const(name, GFP_KERNEL);
631 if (!name)
632 return NULL;
Tejun Heofd7b9f72013-11-28 14:54:33 -0500633
Tejun Heoa797bfc2013-12-11 14:11:57 -0500634 kn = kmem_cache_zalloc(kernfs_node_cache, GFP_KERNEL);
Tejun Heo324a56e2013-12-11 14:11:53 -0500635 if (!kn)
Tejun Heofd7b9f72013-11-28 14:54:33 -0500636 goto err_out1;
637
Shaohua Li7d350792017-07-12 11:49:46 -0700638 idr_preload(GFP_KERNEL);
639 spin_lock(&kernfs_idr_lock);
Shaohua Li4a3ef682017-07-12 11:49:47 -0700640 cursor = idr_get_cursor(&root->ino_idr);
641 ret = idr_alloc_cyclic(&root->ino_idr, kn, 1, 0, GFP_ATOMIC);
642 if (ret >= 0 && ret < cursor)
643 root->next_generation++;
644 gen = root->next_generation;
Shaohua Li7d350792017-07-12 11:49:46 -0700645 spin_unlock(&kernfs_idr_lock);
646 idr_preload_end();
Tejun Heobc755552013-11-28 14:54:41 -0500647 if (ret < 0)
Tejun Heofd7b9f72013-11-28 14:54:33 -0500648 goto err_out2;
Tejun Heoadc5e8b2013-12-11 14:11:54 -0500649 kn->ino = ret;
Shaohua Li4a3ef682017-07-12 11:49:47 -0700650 kn->generation = gen;
Tejun Heofd7b9f72013-11-28 14:54:33 -0500651
Tejun Heoadc5e8b2013-12-11 14:11:54 -0500652 atomic_set(&kn->count, 1);
Tejun Heo81c173c2014-02-03 14:03:00 -0500653 atomic_set(&kn->active, KN_DEACTIVATED_BIAS);
Tejun Heo35beab02014-02-03 14:02:56 -0500654 RB_CLEAR_NODE(&kn->rb);
Tejun Heofd7b9f72013-11-28 14:54:33 -0500655
Tejun Heoadc5e8b2013-12-11 14:11:54 -0500656 kn->name = name;
657 kn->mode = mode;
Tejun Heo81c173c2014-02-03 14:03:00 -0500658 kn->flags = flags;
Tejun Heofd7b9f72013-11-28 14:54:33 -0500659
Tejun Heo324a56e2013-12-11 14:11:53 -0500660 return kn;
Tejun Heofd7b9f72013-11-28 14:54:33 -0500661
662 err_out2:
Tejun Heoa797bfc2013-12-11 14:11:57 -0500663 kmem_cache_free(kernfs_node_cache, kn);
Tejun Heofd7b9f72013-11-28 14:54:33 -0500664 err_out1:
Tejun Heodfeb07502015-02-13 14:36:31 -0800665 kfree_const(name);
Tejun Heofd7b9f72013-11-28 14:54:33 -0500666 return NULL;
667}
668
Tejun Heodb4aad22014-01-17 09:58:25 -0500669struct kernfs_node *kernfs_new_node(struct kernfs_node *parent,
670 const char *name, umode_t mode,
671 unsigned flags)
672{
673 struct kernfs_node *kn;
674
675 kn = __kernfs_new_node(kernfs_root(parent), name, mode, flags);
676 if (kn) {
677 kernfs_get(parent);
678 kn->parent = parent;
679 }
680 return kn;
681}
682
Tejun Heofd7b9f72013-11-28 14:54:33 -0500683/**
Tejun Heoc637b8a2013-12-11 14:11:58 -0500684 * kernfs_add_one - add kernfs_node to parent without warning
Tejun Heo324a56e2013-12-11 14:11:53 -0500685 * @kn: kernfs_node to be added
Tejun Heofd7b9f72013-11-28 14:54:33 -0500686 *
Tejun Heodb4aad22014-01-17 09:58:25 -0500687 * The caller must already have initialized @kn->parent. This
688 * function increments nlink of the parent's inode if @kn is a
689 * directory and link into the children list of the parent.
Tejun Heofd7b9f72013-11-28 14:54:33 -0500690 *
Tejun Heofd7b9f72013-11-28 14:54:33 -0500691 * RETURNS:
692 * 0 on success, -EEXIST if entry with the given name already
693 * exists.
694 */
Tejun Heo988cd7a2014-02-03 14:02:58 -0500695int kernfs_add_one(struct kernfs_node *kn)
Tejun Heofd7b9f72013-11-28 14:54:33 -0500696{
Tejun Heodb4aad22014-01-17 09:58:25 -0500697 struct kernfs_node *parent = kn->parent;
Tejun Heoc525aad2013-12-11 14:11:55 -0500698 struct kernfs_iattrs *ps_iattr;
Tejun Heo988cd7a2014-02-03 14:02:58 -0500699 bool has_ns;
Tejun Heofd7b9f72013-11-28 14:54:33 -0500700 int ret;
701
Tejun Heo988cd7a2014-02-03 14:02:58 -0500702 mutex_lock(&kernfs_mutex);
703
704 ret = -EINVAL;
705 has_ns = kernfs_ns_enabled(parent);
706 if (WARN(has_ns != (bool)kn->ns, KERN_WARNING "kernfs: ns %s in '%s' for '%s'\n",
707 has_ns ? "required" : "invalid", parent->name, kn->name))
708 goto out_unlock;
Tejun Heofd7b9f72013-11-28 14:54:33 -0500709
Tejun Heodf23fc32013-12-11 14:11:56 -0500710 if (kernfs_type(parent) != KERNFS_DIR)
Tejun Heo988cd7a2014-02-03 14:02:58 -0500711 goto out_unlock;
Tejun Heofd7b9f72013-11-28 14:54:33 -0500712
Tejun Heo988cd7a2014-02-03 14:02:58 -0500713 ret = -ENOENT;
Eric W. Biedermanea015212015-05-13 16:09:29 -0500714 if (parent->flags & KERNFS_EMPTY_DIR)
715 goto out_unlock;
716
Tejun Heod35258e2014-02-03 14:09:12 -0500717 if ((parent->flags & KERNFS_ACTIVATED) && !kernfs_active(parent))
Tejun Heo988cd7a2014-02-03 14:02:58 -0500718 goto out_unlock;
Greg Kroah-Hartman798c75a2014-01-13 14:36:03 -0800719
Tejun Heoc637b8a2013-12-11 14:11:58 -0500720 kn->hash = kernfs_name_hash(kn->name, kn->ns);
Tejun Heofd7b9f72013-11-28 14:54:33 -0500721
Tejun Heoc637b8a2013-12-11 14:11:58 -0500722 ret = kernfs_link_sibling(kn);
Tejun Heofd7b9f72013-11-28 14:54:33 -0500723 if (ret)
Tejun Heo988cd7a2014-02-03 14:02:58 -0500724 goto out_unlock;
Tejun Heofd7b9f72013-11-28 14:54:33 -0500725
726 /* Update timestamps on the parent */
Tejun Heoadc5e8b2013-12-11 14:11:54 -0500727 ps_iattr = parent->iattr;
Tejun Heofd7b9f72013-11-28 14:54:33 -0500728 if (ps_iattr) {
729 struct iattr *ps_iattrs = &ps_iattr->ia_iattr;
Deepa Dinamani3a3a5fe2016-02-22 07:17:53 -0800730 ktime_get_real_ts(&ps_iattrs->ia_ctime);
731 ps_iattrs->ia_mtime = ps_iattrs->ia_ctime;
Tejun Heofd7b9f72013-11-28 14:54:33 -0500732 }
733
Tejun Heod35258e2014-02-03 14:09:12 -0500734 mutex_unlock(&kernfs_mutex);
735
736 /*
737 * Activate the new node unless CREATE_DEACTIVATED is requested.
738 * If not activated here, the kernfs user is responsible for
739 * activating the node with kernfs_activate(). A node which hasn't
740 * been activated is not visible to userland and its removal won't
741 * trigger deactivation.
742 */
743 if (!(kernfs_root(kn)->flags & KERNFS_ROOT_CREATE_DEACTIVATED))
744 kernfs_activate(kn);
745 return 0;
746
Tejun Heo988cd7a2014-02-03 14:02:58 -0500747out_unlock:
Tejun Heoa797bfc2013-12-11 14:11:57 -0500748 mutex_unlock(&kernfs_mutex);
Tejun Heo988cd7a2014-02-03 14:02:58 -0500749 return ret;
Tejun Heofd7b9f72013-11-28 14:54:33 -0500750}
751
752/**
Tejun Heo324a56e2013-12-11 14:11:53 -0500753 * kernfs_find_ns - find kernfs_node with the given name
754 * @parent: kernfs_node to search under
Tejun Heofd7b9f72013-11-28 14:54:33 -0500755 * @name: name to look for
756 * @ns: the namespace tag to use
757 *
Tejun Heo324a56e2013-12-11 14:11:53 -0500758 * Look for kernfs_node with name @name under @parent. Returns pointer to
759 * the found kernfs_node on success, %NULL on failure.
Tejun Heofd7b9f72013-11-28 14:54:33 -0500760 */
Tejun Heo324a56e2013-12-11 14:11:53 -0500761static struct kernfs_node *kernfs_find_ns(struct kernfs_node *parent,
762 const unsigned char *name,
763 const void *ns)
Tejun Heofd7b9f72013-11-28 14:54:33 -0500764{
Tejun Heoadc5e8b2013-12-11 14:11:54 -0500765 struct rb_node *node = parent->dir.children.rb_node;
Tejun Heoac9bba02013-11-29 17:19:09 -0500766 bool has_ns = kernfs_ns_enabled(parent);
Tejun Heofd7b9f72013-11-28 14:54:33 -0500767 unsigned int hash;
768
Tejun Heoa797bfc2013-12-11 14:11:57 -0500769 lockdep_assert_held(&kernfs_mutex);
Tejun Heofd7b9f72013-11-28 14:54:33 -0500770
771 if (has_ns != (bool)ns) {
Tejun Heoc637b8a2013-12-11 14:11:58 -0500772 WARN(1, KERN_WARNING "kernfs: ns %s in '%s' for '%s'\n",
Tejun Heoadc5e8b2013-12-11 14:11:54 -0500773 has_ns ? "required" : "invalid", parent->name, name);
Tejun Heofd7b9f72013-11-28 14:54:33 -0500774 return NULL;
775 }
776
Tejun Heoc637b8a2013-12-11 14:11:58 -0500777 hash = kernfs_name_hash(name, ns);
Tejun Heofd7b9f72013-11-28 14:54:33 -0500778 while (node) {
Tejun Heo324a56e2013-12-11 14:11:53 -0500779 struct kernfs_node *kn;
Tejun Heofd7b9f72013-11-28 14:54:33 -0500780 int result;
781
Tejun Heo324a56e2013-12-11 14:11:53 -0500782 kn = rb_to_kn(node);
Tejun Heoc637b8a2013-12-11 14:11:58 -0500783 result = kernfs_name_compare(hash, name, ns, kn);
Tejun Heofd7b9f72013-11-28 14:54:33 -0500784 if (result < 0)
785 node = node->rb_left;
786 else if (result > 0)
787 node = node->rb_right;
788 else
Tejun Heo324a56e2013-12-11 14:11:53 -0500789 return kn;
Tejun Heofd7b9f72013-11-28 14:54:33 -0500790 }
791 return NULL;
792}
793
Tejun Heobd96f762015-11-20 15:55:52 -0500794static struct kernfs_node *kernfs_walk_ns(struct kernfs_node *parent,
795 const unsigned char *path,
796 const void *ns)
797{
Tejun Heoe56ed3582016-01-15 12:30:14 -0500798 size_t len;
799 char *p, *name;
Tejun Heobd96f762015-11-20 15:55:52 -0500800
801 lockdep_assert_held(&kernfs_mutex);
802
Tejun Heoe56ed3582016-01-15 12:30:14 -0500803 /* grab kernfs_rename_lock to piggy back on kernfs_pr_cont_buf */
804 spin_lock_irq(&kernfs_rename_lock);
805
806 len = strlcpy(kernfs_pr_cont_buf, path, sizeof(kernfs_pr_cont_buf));
807
808 if (len >= sizeof(kernfs_pr_cont_buf)) {
809 spin_unlock_irq(&kernfs_rename_lock);
Tejun Heobd96f762015-11-20 15:55:52 -0500810 return NULL;
Tejun Heoe56ed3582016-01-15 12:30:14 -0500811 }
812
813 p = kernfs_pr_cont_buf;
Tejun Heobd96f762015-11-20 15:55:52 -0500814
815 while ((name = strsep(&p, "/")) && parent) {
816 if (*name == '\0')
817 continue;
818 parent = kernfs_find_ns(parent, name, ns);
819 }
820
Tejun Heoe56ed3582016-01-15 12:30:14 -0500821 spin_unlock_irq(&kernfs_rename_lock);
822
Tejun Heobd96f762015-11-20 15:55:52 -0500823 return parent;
824}
825
Tejun Heofd7b9f72013-11-28 14:54:33 -0500826/**
Tejun Heo324a56e2013-12-11 14:11:53 -0500827 * kernfs_find_and_get_ns - find and get kernfs_node with the given name
828 * @parent: kernfs_node to search under
Tejun Heofd7b9f72013-11-28 14:54:33 -0500829 * @name: name to look for
830 * @ns: the namespace tag to use
831 *
Tejun Heo324a56e2013-12-11 14:11:53 -0500832 * Look for kernfs_node with name @name under @parent and get a reference
Tejun Heofd7b9f72013-11-28 14:54:33 -0500833 * if found. This function may sleep and returns pointer to the found
Tejun Heo324a56e2013-12-11 14:11:53 -0500834 * kernfs_node on success, %NULL on failure.
Tejun Heofd7b9f72013-11-28 14:54:33 -0500835 */
Tejun Heo324a56e2013-12-11 14:11:53 -0500836struct kernfs_node *kernfs_find_and_get_ns(struct kernfs_node *parent,
837 const char *name, const void *ns)
Tejun Heofd7b9f72013-11-28 14:54:33 -0500838{
Tejun Heo324a56e2013-12-11 14:11:53 -0500839 struct kernfs_node *kn;
Tejun Heofd7b9f72013-11-28 14:54:33 -0500840
Tejun Heoa797bfc2013-12-11 14:11:57 -0500841 mutex_lock(&kernfs_mutex);
Tejun Heo324a56e2013-12-11 14:11:53 -0500842 kn = kernfs_find_ns(parent, name, ns);
843 kernfs_get(kn);
Tejun Heoa797bfc2013-12-11 14:11:57 -0500844 mutex_unlock(&kernfs_mutex);
Tejun Heofd7b9f72013-11-28 14:54:33 -0500845
Tejun Heo324a56e2013-12-11 14:11:53 -0500846 return kn;
Tejun Heofd7b9f72013-11-28 14:54:33 -0500847}
848EXPORT_SYMBOL_GPL(kernfs_find_and_get_ns);
849
850/**
Tejun Heobd96f762015-11-20 15:55:52 -0500851 * kernfs_walk_and_get_ns - find and get kernfs_node with the given path
852 * @parent: kernfs_node to search under
853 * @path: path to look for
854 * @ns: the namespace tag to use
855 *
856 * Look for kernfs_node with path @path under @parent and get a reference
857 * if found. This function may sleep and returns pointer to the found
858 * kernfs_node on success, %NULL on failure.
859 */
860struct kernfs_node *kernfs_walk_and_get_ns(struct kernfs_node *parent,
861 const char *path, const void *ns)
862{
863 struct kernfs_node *kn;
864
865 mutex_lock(&kernfs_mutex);
866 kn = kernfs_walk_ns(parent, path, ns);
867 kernfs_get(kn);
868 mutex_unlock(&kernfs_mutex);
869
870 return kn;
871}
872
873/**
Tejun Heoba7443b2013-11-28 14:54:40 -0500874 * kernfs_create_root - create a new kernfs hierarchy
Tejun Heo90c07c82014-02-03 14:09:09 -0500875 * @scops: optional syscall operations for the hierarchy
Tejun Heod35258e2014-02-03 14:09:12 -0500876 * @flags: KERNFS_ROOT_* flags
Tejun Heoba7443b2013-11-28 14:54:40 -0500877 * @priv: opaque data associated with the new directory
878 *
879 * Returns the root of the new hierarchy on success, ERR_PTR() value on
880 * failure.
881 */
Tejun Heo90c07c82014-02-03 14:09:09 -0500882struct kernfs_root *kernfs_create_root(struct kernfs_syscall_ops *scops,
Tejun Heod35258e2014-02-03 14:09:12 -0500883 unsigned int flags, void *priv)
Tejun Heoba7443b2013-11-28 14:54:40 -0500884{
885 struct kernfs_root *root;
Tejun Heo324a56e2013-12-11 14:11:53 -0500886 struct kernfs_node *kn;
Tejun Heoba7443b2013-11-28 14:54:40 -0500887
888 root = kzalloc(sizeof(*root), GFP_KERNEL);
889 if (!root)
890 return ERR_PTR(-ENOMEM);
891
Shaohua Li7d350792017-07-12 11:49:46 -0700892 idr_init(&root->ino_idr);
Tejun Heo7d568a82014-04-09 11:07:30 -0400893 INIT_LIST_HEAD(&root->supers);
Shaohua Li4a3ef682017-07-12 11:49:47 -0700894 root->next_generation = 1;
Tejun Heobc755552013-11-28 14:54:41 -0500895
Tejun Heodb4aad22014-01-17 09:58:25 -0500896 kn = __kernfs_new_node(root, "", S_IFDIR | S_IRUGO | S_IXUGO,
897 KERNFS_DIR);
Tejun Heo324a56e2013-12-11 14:11:53 -0500898 if (!kn) {
Shaohua Li7d350792017-07-12 11:49:46 -0700899 idr_destroy(&root->ino_idr);
Tejun Heoba7443b2013-11-28 14:54:40 -0500900 kfree(root);
901 return ERR_PTR(-ENOMEM);
902 }
903
Tejun Heo324a56e2013-12-11 14:11:53 -0500904 kn->priv = priv;
Tejun Heoadc5e8b2013-12-11 14:11:54 -0500905 kn->dir.root = root;
Tejun Heoba7443b2013-11-28 14:54:40 -0500906
Tejun Heo90c07c82014-02-03 14:09:09 -0500907 root->syscall_ops = scops;
Tejun Heod35258e2014-02-03 14:09:12 -0500908 root->flags = flags;
Tejun Heo324a56e2013-12-11 14:11:53 -0500909 root->kn = kn;
Tejun Heoabd54f02014-02-03 14:02:55 -0500910 init_waitqueue_head(&root->deactivate_waitq);
Tejun Heoba7443b2013-11-28 14:54:40 -0500911
Tejun Heod35258e2014-02-03 14:09:12 -0500912 if (!(root->flags & KERNFS_ROOT_CREATE_DEACTIVATED))
913 kernfs_activate(kn);
914
Tejun Heoba7443b2013-11-28 14:54:40 -0500915 return root;
916}
917
918/**
919 * kernfs_destroy_root - destroy a kernfs hierarchy
920 * @root: root of the hierarchy to destroy
921 *
922 * Destroy the hierarchy anchored at @root by removing all existing
923 * directories and destroying @root.
924 */
925void kernfs_destroy_root(struct kernfs_root *root)
926{
Tejun Heo324a56e2013-12-11 14:11:53 -0500927 kernfs_remove(root->kn); /* will also free @root */
Tejun Heoba7443b2013-11-28 14:54:40 -0500928}
929
930/**
Tejun Heofd7b9f72013-11-28 14:54:33 -0500931 * kernfs_create_dir_ns - create a directory
932 * @parent: parent in which to create a new directory
933 * @name: name of the new directory
Tejun Heobb8b9d02013-12-11 16:02:55 -0500934 * @mode: mode of the new directory
Tejun Heofd7b9f72013-11-28 14:54:33 -0500935 * @priv: opaque data associated with the new directory
936 * @ns: optional namespace tag of the directory
937 *
938 * Returns the created node on success, ERR_PTR() value on failure.
939 */
Tejun Heo324a56e2013-12-11 14:11:53 -0500940struct kernfs_node *kernfs_create_dir_ns(struct kernfs_node *parent,
Tejun Heobb8b9d02013-12-11 16:02:55 -0500941 const char *name, umode_t mode,
942 void *priv, const void *ns)
Tejun Heofd7b9f72013-11-28 14:54:33 -0500943{
Tejun Heo324a56e2013-12-11 14:11:53 -0500944 struct kernfs_node *kn;
Tejun Heofd7b9f72013-11-28 14:54:33 -0500945 int rc;
946
947 /* allocate */
Tejun Heodb4aad22014-01-17 09:58:25 -0500948 kn = kernfs_new_node(parent, name, mode | S_IFDIR, KERNFS_DIR);
Tejun Heo324a56e2013-12-11 14:11:53 -0500949 if (!kn)
Tejun Heofd7b9f72013-11-28 14:54:33 -0500950 return ERR_PTR(-ENOMEM);
951
Tejun Heoadc5e8b2013-12-11 14:11:54 -0500952 kn->dir.root = parent->dir.root;
953 kn->ns = ns;
Tejun Heo324a56e2013-12-11 14:11:53 -0500954 kn->priv = priv;
Tejun Heofd7b9f72013-11-28 14:54:33 -0500955
956 /* link in */
Tejun Heo988cd7a2014-02-03 14:02:58 -0500957 rc = kernfs_add_one(kn);
Tejun Heofd7b9f72013-11-28 14:54:33 -0500958 if (!rc)
Tejun Heo324a56e2013-12-11 14:11:53 -0500959 return kn;
Tejun Heofd7b9f72013-11-28 14:54:33 -0500960
Tejun Heo324a56e2013-12-11 14:11:53 -0500961 kernfs_put(kn);
Tejun Heofd7b9f72013-11-28 14:54:33 -0500962 return ERR_PTR(rc);
963}
964
Eric W. Biedermanea015212015-05-13 16:09:29 -0500965/**
966 * kernfs_create_empty_dir - create an always empty directory
967 * @parent: parent in which to create a new directory
968 * @name: name of the new directory
969 *
970 * Returns the created node on success, ERR_PTR() value on failure.
971 */
972struct kernfs_node *kernfs_create_empty_dir(struct kernfs_node *parent,
973 const char *name)
974{
975 struct kernfs_node *kn;
976 int rc;
977
978 /* allocate */
979 kn = kernfs_new_node(parent, name, S_IRUGO|S_IXUGO|S_IFDIR, KERNFS_DIR);
980 if (!kn)
981 return ERR_PTR(-ENOMEM);
982
983 kn->flags |= KERNFS_EMPTY_DIR;
984 kn->dir.root = parent->dir.root;
985 kn->ns = NULL;
986 kn->priv = NULL;
987
988 /* link in */
989 rc = kernfs_add_one(kn);
990 if (!rc)
991 return kn;
992
993 kernfs_put(kn);
994 return ERR_PTR(rc);
995}
996
Tejun Heoc637b8a2013-12-11 14:11:58 -0500997static struct dentry *kernfs_iop_lookup(struct inode *dir,
998 struct dentry *dentry,
999 unsigned int flags)
Tejun Heofd7b9f72013-11-28 14:54:33 -05001000{
Tejun Heo19bbb922013-12-11 16:02:59 -05001001 struct dentry *ret;
Tejun Heo324a56e2013-12-11 14:11:53 -05001002 struct kernfs_node *parent = dentry->d_parent->d_fsdata;
1003 struct kernfs_node *kn;
Tejun Heofd7b9f72013-11-28 14:54:33 -05001004 struct inode *inode;
1005 const void *ns = NULL;
1006
Tejun Heoa797bfc2013-12-11 14:11:57 -05001007 mutex_lock(&kernfs_mutex);
Tejun Heofd7b9f72013-11-28 14:54:33 -05001008
Tejun Heo324a56e2013-12-11 14:11:53 -05001009 if (kernfs_ns_enabled(parent))
Tejun Heoc525aad2013-12-11 14:11:55 -05001010 ns = kernfs_info(dir->i_sb)->ns;
Tejun Heofd7b9f72013-11-28 14:54:33 -05001011
Tejun Heo324a56e2013-12-11 14:11:53 -05001012 kn = kernfs_find_ns(parent, dentry->d_name.name, ns);
Tejun Heofd7b9f72013-11-28 14:54:33 -05001013
1014 /* no such entry */
Tejun Heob9c9dad2014-02-03 14:09:11 -05001015 if (!kn || !kernfs_active(kn)) {
Tejun Heo19bbb922013-12-11 16:02:59 -05001016 ret = NULL;
Tejun Heofd7b9f72013-11-28 14:54:33 -05001017 goto out_unlock;
1018 }
Tejun Heo324a56e2013-12-11 14:11:53 -05001019 kernfs_get(kn);
1020 dentry->d_fsdata = kn;
Tejun Heofd7b9f72013-11-28 14:54:33 -05001021
1022 /* attach dentry and inode */
Tejun Heoc637b8a2013-12-11 14:11:58 -05001023 inode = kernfs_get_inode(dir->i_sb, kn);
Tejun Heofd7b9f72013-11-28 14:54:33 -05001024 if (!inode) {
1025 ret = ERR_PTR(-ENOMEM);
1026 goto out_unlock;
1027 }
1028
1029 /* instantiate and hash dentry */
Al Viro41d28bc2014-10-12 22:24:21 -04001030 ret = d_splice_alias(inode, dentry);
Tejun Heofd7b9f72013-11-28 14:54:33 -05001031 out_unlock:
Tejun Heoa797bfc2013-12-11 14:11:57 -05001032 mutex_unlock(&kernfs_mutex);
Tejun Heofd7b9f72013-11-28 14:54:33 -05001033 return ret;
1034}
1035
Tejun Heo80b9bbe2013-12-11 16:03:00 -05001036static int kernfs_iop_mkdir(struct inode *dir, struct dentry *dentry,
1037 umode_t mode)
1038{
1039 struct kernfs_node *parent = dir->i_private;
Tejun Heo90c07c82014-02-03 14:09:09 -05001040 struct kernfs_syscall_ops *scops = kernfs_root(parent)->syscall_ops;
Tejun Heo07c75302014-02-03 14:09:08 -05001041 int ret;
Tejun Heo80b9bbe2013-12-11 16:03:00 -05001042
Tejun Heo90c07c82014-02-03 14:09:09 -05001043 if (!scops || !scops->mkdir)
Tejun Heo80b9bbe2013-12-11 16:03:00 -05001044 return -EPERM;
1045
Tejun Heo07c75302014-02-03 14:09:08 -05001046 if (!kernfs_get_active(parent))
1047 return -ENODEV;
1048
Tejun Heo90c07c82014-02-03 14:09:09 -05001049 ret = scops->mkdir(parent, dentry->d_name.name, mode);
Tejun Heo07c75302014-02-03 14:09:08 -05001050
1051 kernfs_put_active(parent);
1052 return ret;
Tejun Heo80b9bbe2013-12-11 16:03:00 -05001053}
1054
1055static int kernfs_iop_rmdir(struct inode *dir, struct dentry *dentry)
1056{
1057 struct kernfs_node *kn = dentry->d_fsdata;
Tejun Heo90c07c82014-02-03 14:09:09 -05001058 struct kernfs_syscall_ops *scops = kernfs_root(kn)->syscall_ops;
Tejun Heo07c75302014-02-03 14:09:08 -05001059 int ret;
Tejun Heo80b9bbe2013-12-11 16:03:00 -05001060
Tejun Heo90c07c82014-02-03 14:09:09 -05001061 if (!scops || !scops->rmdir)
Tejun Heo80b9bbe2013-12-11 16:03:00 -05001062 return -EPERM;
1063
Tejun Heo07c75302014-02-03 14:09:08 -05001064 if (!kernfs_get_active(kn))
1065 return -ENODEV;
1066
Tejun Heo90c07c82014-02-03 14:09:09 -05001067 ret = scops->rmdir(kn);
Tejun Heo07c75302014-02-03 14:09:08 -05001068
1069 kernfs_put_active(kn);
1070 return ret;
Tejun Heo80b9bbe2013-12-11 16:03:00 -05001071}
1072
1073static int kernfs_iop_rename(struct inode *old_dir, struct dentry *old_dentry,
Miklos Szeredi1cd66c92016-09-27 11:03:58 +02001074 struct inode *new_dir, struct dentry *new_dentry,
1075 unsigned int flags)
Tejun Heo80b9bbe2013-12-11 16:03:00 -05001076{
1077 struct kernfs_node *kn = old_dentry->d_fsdata;
1078 struct kernfs_node *new_parent = new_dir->i_private;
Tejun Heo90c07c82014-02-03 14:09:09 -05001079 struct kernfs_syscall_ops *scops = kernfs_root(kn)->syscall_ops;
Tejun Heo07c75302014-02-03 14:09:08 -05001080 int ret;
Tejun Heo80b9bbe2013-12-11 16:03:00 -05001081
Miklos Szeredi1cd66c92016-09-27 11:03:58 +02001082 if (flags)
1083 return -EINVAL;
1084
Tejun Heo90c07c82014-02-03 14:09:09 -05001085 if (!scops || !scops->rename)
Tejun Heo80b9bbe2013-12-11 16:03:00 -05001086 return -EPERM;
1087
Tejun Heo07c75302014-02-03 14:09:08 -05001088 if (!kernfs_get_active(kn))
1089 return -ENODEV;
1090
1091 if (!kernfs_get_active(new_parent)) {
1092 kernfs_put_active(kn);
1093 return -ENODEV;
1094 }
1095
Tejun Heo90c07c82014-02-03 14:09:09 -05001096 ret = scops->rename(kn, new_parent, new_dentry->d_name.name);
Tejun Heo07c75302014-02-03 14:09:08 -05001097
1098 kernfs_put_active(new_parent);
1099 kernfs_put_active(kn);
1100 return ret;
Tejun Heo80b9bbe2013-12-11 16:03:00 -05001101}
1102
Tejun Heoa797bfc2013-12-11 14:11:57 -05001103const struct inode_operations kernfs_dir_iops = {
Tejun Heoc637b8a2013-12-11 14:11:58 -05001104 .lookup = kernfs_iop_lookup,
1105 .permission = kernfs_iop_permission,
1106 .setattr = kernfs_iop_setattr,
1107 .getattr = kernfs_iop_getattr,
Tejun Heoc637b8a2013-12-11 14:11:58 -05001108 .listxattr = kernfs_iop_listxattr,
Tejun Heo80b9bbe2013-12-11 16:03:00 -05001109
1110 .mkdir = kernfs_iop_mkdir,
1111 .rmdir = kernfs_iop_rmdir,
1112 .rename = kernfs_iop_rename,
Tejun Heofd7b9f72013-11-28 14:54:33 -05001113};
1114
Tejun Heoc637b8a2013-12-11 14:11:58 -05001115static struct kernfs_node *kernfs_leftmost_descendant(struct kernfs_node *pos)
Tejun Heofd7b9f72013-11-28 14:54:33 -05001116{
Tejun Heo324a56e2013-12-11 14:11:53 -05001117 struct kernfs_node *last;
Tejun Heofd7b9f72013-11-28 14:54:33 -05001118
1119 while (true) {
1120 struct rb_node *rbn;
1121
1122 last = pos;
1123
Tejun Heodf23fc32013-12-11 14:11:56 -05001124 if (kernfs_type(pos) != KERNFS_DIR)
Tejun Heofd7b9f72013-11-28 14:54:33 -05001125 break;
1126
Tejun Heoadc5e8b2013-12-11 14:11:54 -05001127 rbn = rb_first(&pos->dir.children);
Tejun Heofd7b9f72013-11-28 14:54:33 -05001128 if (!rbn)
1129 break;
1130
Tejun Heo324a56e2013-12-11 14:11:53 -05001131 pos = rb_to_kn(rbn);
Tejun Heofd7b9f72013-11-28 14:54:33 -05001132 }
1133
1134 return last;
1135}
1136
1137/**
Tejun Heoc637b8a2013-12-11 14:11:58 -05001138 * kernfs_next_descendant_post - find the next descendant for post-order walk
Tejun Heofd7b9f72013-11-28 14:54:33 -05001139 * @pos: the current position (%NULL to initiate traversal)
Tejun Heo324a56e2013-12-11 14:11:53 -05001140 * @root: kernfs_node whose descendants to walk
Tejun Heofd7b9f72013-11-28 14:54:33 -05001141 *
1142 * Find the next descendant to visit for post-order traversal of @root's
1143 * descendants. @root is included in the iteration and the last node to be
1144 * visited.
1145 */
Tejun Heoc637b8a2013-12-11 14:11:58 -05001146static struct kernfs_node *kernfs_next_descendant_post(struct kernfs_node *pos,
1147 struct kernfs_node *root)
Tejun Heofd7b9f72013-11-28 14:54:33 -05001148{
1149 struct rb_node *rbn;
1150
Tejun Heoa797bfc2013-12-11 14:11:57 -05001151 lockdep_assert_held(&kernfs_mutex);
Tejun Heofd7b9f72013-11-28 14:54:33 -05001152
1153 /* if first iteration, visit leftmost descendant which may be root */
1154 if (!pos)
Tejun Heoc637b8a2013-12-11 14:11:58 -05001155 return kernfs_leftmost_descendant(root);
Tejun Heofd7b9f72013-11-28 14:54:33 -05001156
1157 /* if we visited @root, we're done */
1158 if (pos == root)
1159 return NULL;
1160
1161 /* if there's an unvisited sibling, visit its leftmost descendant */
Tejun Heoadc5e8b2013-12-11 14:11:54 -05001162 rbn = rb_next(&pos->rb);
Tejun Heofd7b9f72013-11-28 14:54:33 -05001163 if (rbn)
Tejun Heoc637b8a2013-12-11 14:11:58 -05001164 return kernfs_leftmost_descendant(rb_to_kn(rbn));
Tejun Heofd7b9f72013-11-28 14:54:33 -05001165
1166 /* no sibling left, visit parent */
Tejun Heoadc5e8b2013-12-11 14:11:54 -05001167 return pos->parent;
Tejun Heofd7b9f72013-11-28 14:54:33 -05001168}
1169
Tejun Heod35258e2014-02-03 14:09:12 -05001170/**
1171 * kernfs_activate - activate a node which started deactivated
1172 * @kn: kernfs_node whose subtree is to be activated
1173 *
1174 * If the root has KERNFS_ROOT_CREATE_DEACTIVATED set, a newly created node
1175 * needs to be explicitly activated. A node which hasn't been activated
1176 * isn't visible to userland and deactivation is skipped during its
1177 * removal. This is useful to construct atomic init sequences where
1178 * creation of multiple nodes should either succeed or fail atomically.
1179 *
1180 * The caller is responsible for ensuring that this function is not called
1181 * after kernfs_remove*() is invoked on @kn.
1182 */
1183void kernfs_activate(struct kernfs_node *kn)
1184{
1185 struct kernfs_node *pos;
1186
1187 mutex_lock(&kernfs_mutex);
1188
1189 pos = NULL;
1190 while ((pos = kernfs_next_descendant_post(pos, kn))) {
1191 if (!pos || (pos->flags & KERNFS_ACTIVATED))
1192 continue;
1193
1194 WARN_ON_ONCE(pos->parent && RB_EMPTY_NODE(&pos->rb));
1195 WARN_ON_ONCE(atomic_read(&pos->active) != KN_DEACTIVATED_BIAS);
1196
1197 atomic_sub(KN_DEACTIVATED_BIAS, &pos->active);
1198 pos->flags |= KERNFS_ACTIVATED;
1199 }
1200
1201 mutex_unlock(&kernfs_mutex);
1202}
1203
Tejun Heo988cd7a2014-02-03 14:02:58 -05001204static void __kernfs_remove(struct kernfs_node *kn)
Tejun Heofd7b9f72013-11-28 14:54:33 -05001205{
Tejun Heo35beab02014-02-03 14:02:56 -05001206 struct kernfs_node *pos;
1207
1208 lockdep_assert_held(&kernfs_mutex);
Tejun Heofd7b9f72013-11-28 14:54:33 -05001209
Tejun Heo6b0afc22014-02-03 14:03:01 -05001210 /*
1211 * Short-circuit if non-root @kn has already finished removal.
1212 * This is for kernfs_remove_self() which plays with active ref
1213 * after removal.
1214 */
1215 if (!kn || (kn->parent && RB_EMPTY_NODE(&kn->rb)))
Greg Kroah-Hartmance9b4992014-01-13 13:50:31 -08001216 return;
1217
Tejun Heoc637b8a2013-12-11 14:11:58 -05001218 pr_debug("kernfs %s: removing\n", kn->name);
Tejun Heofd7b9f72013-11-28 14:54:33 -05001219
Tejun Heo81c173c2014-02-03 14:03:00 -05001220 /* prevent any new usage under @kn by deactivating all nodes */
Tejun Heo35beab02014-02-03 14:02:56 -05001221 pos = NULL;
1222 while ((pos = kernfs_next_descendant_post(pos, kn)))
Tejun Heo81c173c2014-02-03 14:03:00 -05001223 if (kernfs_active(pos))
1224 atomic_add(KN_DEACTIVATED_BIAS, &pos->active);
Tejun Heo35beab02014-02-03 14:02:56 -05001225
1226 /* deactivate and unlink the subtree node-by-node */
Tejun Heofd7b9f72013-11-28 14:54:33 -05001227 do {
Tejun Heo35beab02014-02-03 14:02:56 -05001228 pos = kernfs_leftmost_descendant(kn);
1229
1230 /*
Tejun Heo81c173c2014-02-03 14:03:00 -05001231 * kernfs_drain() drops kernfs_mutex temporarily and @pos's
1232 * base ref could have been put by someone else by the time
1233 * the function returns. Make sure it doesn't go away
1234 * underneath us.
Tejun Heo35beab02014-02-03 14:02:56 -05001235 */
1236 kernfs_get(pos);
1237
Tejun Heod35258e2014-02-03 14:09:12 -05001238 /*
1239 * Drain iff @kn was activated. This avoids draining and
1240 * its lockdep annotations for nodes which have never been
1241 * activated and allows embedding kernfs_remove() in create
1242 * error paths without worrying about draining.
1243 */
1244 if (kn->flags & KERNFS_ACTIVATED)
1245 kernfs_drain(pos);
1246 else
1247 WARN_ON_ONCE(atomic_read(&kn->active) != KN_DEACTIVATED_BIAS);
Tejun Heo35beab02014-02-03 14:02:56 -05001248
1249 /*
1250 * kernfs_unlink_sibling() succeeds once per node. Use it
1251 * to decide who's responsible for cleanups.
1252 */
1253 if (!pos->parent || kernfs_unlink_sibling(pos)) {
1254 struct kernfs_iattrs *ps_iattr =
1255 pos->parent ? pos->parent->iattr : NULL;
1256
1257 /* update timestamps on the parent */
1258 if (ps_iattr) {
Deepa Dinamani3a3a5fe2016-02-22 07:17:53 -08001259 ktime_get_real_ts(&ps_iattr->ia_iattr.ia_ctime);
1260 ps_iattr->ia_iattr.ia_mtime =
1261 ps_iattr->ia_iattr.ia_ctime;
Tejun Heo35beab02014-02-03 14:02:56 -05001262 }
1263
Tejun Heo988cd7a2014-02-03 14:02:58 -05001264 kernfs_put(pos);
Tejun Heo35beab02014-02-03 14:02:56 -05001265 }
1266
1267 kernfs_put(pos);
1268 } while (pos != kn);
Tejun Heofd7b9f72013-11-28 14:54:33 -05001269}
1270
1271/**
Tejun Heo324a56e2013-12-11 14:11:53 -05001272 * kernfs_remove - remove a kernfs_node recursively
1273 * @kn: the kernfs_node to remove
Tejun Heofd7b9f72013-11-28 14:54:33 -05001274 *
Tejun Heo324a56e2013-12-11 14:11:53 -05001275 * Remove @kn along with all its subdirectories and files.
Tejun Heofd7b9f72013-11-28 14:54:33 -05001276 */
Tejun Heo324a56e2013-12-11 14:11:53 -05001277void kernfs_remove(struct kernfs_node *kn)
Tejun Heofd7b9f72013-11-28 14:54:33 -05001278{
Tejun Heo988cd7a2014-02-03 14:02:58 -05001279 mutex_lock(&kernfs_mutex);
1280 __kernfs_remove(kn);
1281 mutex_unlock(&kernfs_mutex);
Tejun Heofd7b9f72013-11-28 14:54:33 -05001282}
1283
1284/**
Tejun Heo6b0afc22014-02-03 14:03:01 -05001285 * kernfs_break_active_protection - break out of active protection
1286 * @kn: the self kernfs_node
1287 *
1288 * The caller must be running off of a kernfs operation which is invoked
1289 * with an active reference - e.g. one of kernfs_ops. Each invocation of
1290 * this function must also be matched with an invocation of
1291 * kernfs_unbreak_active_protection().
1292 *
1293 * This function releases the active reference of @kn the caller is
1294 * holding. Once this function is called, @kn may be removed at any point
1295 * and the caller is solely responsible for ensuring that the objects it
1296 * dereferences are accessible.
1297 */
1298void kernfs_break_active_protection(struct kernfs_node *kn)
1299{
1300 /*
1301 * Take out ourself out of the active ref dependency chain. If
1302 * we're called without an active ref, lockdep will complain.
1303 */
1304 kernfs_put_active(kn);
1305}
1306
1307/**
1308 * kernfs_unbreak_active_protection - undo kernfs_break_active_protection()
1309 * @kn: the self kernfs_node
1310 *
1311 * If kernfs_break_active_protection() was called, this function must be
1312 * invoked before finishing the kernfs operation. Note that while this
1313 * function restores the active reference, it doesn't and can't actually
1314 * restore the active protection - @kn may already or be in the process of
1315 * being removed. Once kernfs_break_active_protection() is invoked, that
1316 * protection is irreversibly gone for the kernfs operation instance.
1317 *
1318 * While this function may be called at any point after
1319 * kernfs_break_active_protection() is invoked, its most useful location
1320 * would be right before the enclosing kernfs operation returns.
1321 */
1322void kernfs_unbreak_active_protection(struct kernfs_node *kn)
1323{
1324 /*
1325 * @kn->active could be in any state; however, the increment we do
1326 * here will be undone as soon as the enclosing kernfs operation
1327 * finishes and this temporary bump can't break anything. If @kn
1328 * is alive, nothing changes. If @kn is being deactivated, the
1329 * soon-to-follow put will either finish deactivation or restore
1330 * deactivated state. If @kn is already removed, the temporary
1331 * bump is guaranteed to be gone before @kn is released.
1332 */
1333 atomic_inc(&kn->active);
1334 if (kernfs_lockdep(kn))
1335 rwsem_acquire(&kn->dep_map, 0, 1, _RET_IP_);
1336}
1337
1338/**
1339 * kernfs_remove_self - remove a kernfs_node from its own method
1340 * @kn: the self kernfs_node to remove
1341 *
1342 * The caller must be running off of a kernfs operation which is invoked
1343 * with an active reference - e.g. one of kernfs_ops. This can be used to
1344 * implement a file operation which deletes itself.
1345 *
1346 * For example, the "delete" file for a sysfs device directory can be
1347 * implemented by invoking kernfs_remove_self() on the "delete" file
1348 * itself. This function breaks the circular dependency of trying to
1349 * deactivate self while holding an active ref itself. It isn't necessary
1350 * to modify the usual removal path to use kernfs_remove_self(). The
1351 * "delete" implementation can simply invoke kernfs_remove_self() on self
1352 * before proceeding with the usual removal path. kernfs will ignore later
1353 * kernfs_remove() on self.
1354 *
1355 * kernfs_remove_self() can be called multiple times concurrently on the
1356 * same kernfs_node. Only the first one actually performs removal and
1357 * returns %true. All others will wait until the kernfs operation which
1358 * won self-removal finishes and return %false. Note that the losers wait
1359 * for the completion of not only the winning kernfs_remove_self() but also
1360 * the whole kernfs_ops which won the arbitration. This can be used to
1361 * guarantee, for example, all concurrent writes to a "delete" file to
1362 * finish only after the whole operation is complete.
1363 */
1364bool kernfs_remove_self(struct kernfs_node *kn)
1365{
1366 bool ret;
1367
1368 mutex_lock(&kernfs_mutex);
1369 kernfs_break_active_protection(kn);
1370
1371 /*
1372 * SUICIDAL is used to arbitrate among competing invocations. Only
1373 * the first one will actually perform removal. When the removal
1374 * is complete, SUICIDED is set and the active ref is restored
1375 * while holding kernfs_mutex. The ones which lost arbitration
1376 * waits for SUICDED && drained which can happen only after the
1377 * enclosing kernfs operation which executed the winning instance
1378 * of kernfs_remove_self() finished.
1379 */
1380 if (!(kn->flags & KERNFS_SUICIDAL)) {
1381 kn->flags |= KERNFS_SUICIDAL;
1382 __kernfs_remove(kn);
1383 kn->flags |= KERNFS_SUICIDED;
1384 ret = true;
1385 } else {
1386 wait_queue_head_t *waitq = &kernfs_root(kn)->deactivate_waitq;
1387 DEFINE_WAIT(wait);
1388
1389 while (true) {
1390 prepare_to_wait(waitq, &wait, TASK_UNINTERRUPTIBLE);
1391
1392 if ((kn->flags & KERNFS_SUICIDED) &&
1393 atomic_read(&kn->active) == KN_DEACTIVATED_BIAS)
1394 break;
1395
1396 mutex_unlock(&kernfs_mutex);
1397 schedule();
1398 mutex_lock(&kernfs_mutex);
1399 }
1400 finish_wait(waitq, &wait);
1401 WARN_ON_ONCE(!RB_EMPTY_NODE(&kn->rb));
1402 ret = false;
1403 }
1404
1405 /*
1406 * This must be done while holding kernfs_mutex; otherwise, waiting
1407 * for SUICIDED && deactivated could finish prematurely.
1408 */
1409 kernfs_unbreak_active_protection(kn);
1410
1411 mutex_unlock(&kernfs_mutex);
1412 return ret;
1413}
1414
1415/**
Tejun Heo324a56e2013-12-11 14:11:53 -05001416 * kernfs_remove_by_name_ns - find a kernfs_node by name and remove it
1417 * @parent: parent of the target
1418 * @name: name of the kernfs_node to remove
1419 * @ns: namespace tag of the kernfs_node to remove
Tejun Heofd7b9f72013-11-28 14:54:33 -05001420 *
Tejun Heo324a56e2013-12-11 14:11:53 -05001421 * Look for the kernfs_node with @name and @ns under @parent and remove it.
1422 * Returns 0 on success, -ENOENT if such entry doesn't exist.
Tejun Heofd7b9f72013-11-28 14:54:33 -05001423 */
Tejun Heo324a56e2013-12-11 14:11:53 -05001424int kernfs_remove_by_name_ns(struct kernfs_node *parent, const char *name,
Tejun Heofd7b9f72013-11-28 14:54:33 -05001425 const void *ns)
1426{
Tejun Heo324a56e2013-12-11 14:11:53 -05001427 struct kernfs_node *kn;
Tejun Heofd7b9f72013-11-28 14:54:33 -05001428
Tejun Heo324a56e2013-12-11 14:11:53 -05001429 if (!parent) {
Tejun Heoc637b8a2013-12-11 14:11:58 -05001430 WARN(1, KERN_WARNING "kernfs: can not remove '%s', no directory\n",
Tejun Heofd7b9f72013-11-28 14:54:33 -05001431 name);
1432 return -ENOENT;
1433 }
1434
Tejun Heo988cd7a2014-02-03 14:02:58 -05001435 mutex_lock(&kernfs_mutex);
Tejun Heofd7b9f72013-11-28 14:54:33 -05001436
Tejun Heo324a56e2013-12-11 14:11:53 -05001437 kn = kernfs_find_ns(parent, name, ns);
1438 if (kn)
Tejun Heo988cd7a2014-02-03 14:02:58 -05001439 __kernfs_remove(kn);
Tejun Heofd7b9f72013-11-28 14:54:33 -05001440
Tejun Heo988cd7a2014-02-03 14:02:58 -05001441 mutex_unlock(&kernfs_mutex);
Tejun Heofd7b9f72013-11-28 14:54:33 -05001442
Tejun Heo324a56e2013-12-11 14:11:53 -05001443 if (kn)
Tejun Heofd7b9f72013-11-28 14:54:33 -05001444 return 0;
1445 else
1446 return -ENOENT;
1447}
1448
1449/**
1450 * kernfs_rename_ns - move and rename a kernfs_node
Tejun Heo324a56e2013-12-11 14:11:53 -05001451 * @kn: target node
Tejun Heofd7b9f72013-11-28 14:54:33 -05001452 * @new_parent: new parent to put @sd under
1453 * @new_name: new name
1454 * @new_ns: new namespace tag
1455 */
Tejun Heo324a56e2013-12-11 14:11:53 -05001456int kernfs_rename_ns(struct kernfs_node *kn, struct kernfs_node *new_parent,
Tejun Heofd7b9f72013-11-28 14:54:33 -05001457 const char *new_name, const void *new_ns)
1458{
Tejun Heo3eef34a2014-02-07 13:32:07 -05001459 struct kernfs_node *old_parent;
1460 const char *old_name = NULL;
Tejun Heofd7b9f72013-11-28 14:54:33 -05001461 int error;
1462
Tejun Heo3eef34a2014-02-07 13:32:07 -05001463 /* can't move or rename root */
1464 if (!kn->parent)
1465 return -EINVAL;
1466
Tejun Heoae343722014-01-10 08:57:21 -05001467 mutex_lock(&kernfs_mutex);
Tejun Heod0ae3d42013-12-11 16:02:56 -05001468
Greg Kroah-Hartman798c75a2014-01-13 14:36:03 -08001469 error = -ENOENT;
Eric W. Biedermanea015212015-05-13 16:09:29 -05001470 if (!kernfs_active(kn) || !kernfs_active(new_parent) ||
1471 (new_parent->flags & KERNFS_EMPTY_DIR))
Greg Kroah-Hartman798c75a2014-01-13 14:36:03 -08001472 goto out;
1473
Tejun Heofd7b9f72013-11-28 14:54:33 -05001474 error = 0;
Tejun Heoadc5e8b2013-12-11 14:11:54 -05001475 if ((kn->parent == new_parent) && (kn->ns == new_ns) &&
1476 (strcmp(kn->name, new_name) == 0))
Greg Kroah-Hartman798c75a2014-01-13 14:36:03 -08001477 goto out; /* nothing to rename */
Tejun Heofd7b9f72013-11-28 14:54:33 -05001478
1479 error = -EEXIST;
1480 if (kernfs_find_ns(new_parent, new_name, new_ns))
Greg Kroah-Hartman798c75a2014-01-13 14:36:03 -08001481 goto out;
Tejun Heofd7b9f72013-11-28 14:54:33 -05001482
Tejun Heo324a56e2013-12-11 14:11:53 -05001483 /* rename kernfs_node */
Tejun Heoadc5e8b2013-12-11 14:11:54 -05001484 if (strcmp(kn->name, new_name) != 0) {
Tejun Heofd7b9f72013-11-28 14:54:33 -05001485 error = -ENOMEM;
Andrzej Hajda75287a62015-02-13 14:36:27 -08001486 new_name = kstrdup_const(new_name, GFP_KERNEL);
Tejun Heofd7b9f72013-11-28 14:54:33 -05001487 if (!new_name)
Greg Kroah-Hartman798c75a2014-01-13 14:36:03 -08001488 goto out;
Tejun Heo3eef34a2014-02-07 13:32:07 -05001489 } else {
1490 new_name = NULL;
Tejun Heofd7b9f72013-11-28 14:54:33 -05001491 }
1492
1493 /*
1494 * Move to the appropriate place in the appropriate directories rbtree.
1495 */
Tejun Heoc637b8a2013-12-11 14:11:58 -05001496 kernfs_unlink_sibling(kn);
Tejun Heofd7b9f72013-11-28 14:54:33 -05001497 kernfs_get(new_parent);
Tejun Heo3eef34a2014-02-07 13:32:07 -05001498
1499 /* rename_lock protects ->parent and ->name accessors */
1500 spin_lock_irq(&kernfs_rename_lock);
1501
1502 old_parent = kn->parent;
Tejun Heoadc5e8b2013-12-11 14:11:54 -05001503 kn->parent = new_parent;
Tejun Heo3eef34a2014-02-07 13:32:07 -05001504
1505 kn->ns = new_ns;
1506 if (new_name) {
Tejun Heodfeb07502015-02-13 14:36:31 -08001507 old_name = kn->name;
Tejun Heo3eef34a2014-02-07 13:32:07 -05001508 kn->name = new_name;
1509 }
1510
1511 spin_unlock_irq(&kernfs_rename_lock);
1512
Tejun Heo9561a892014-02-10 17:57:09 -05001513 kn->hash = kernfs_name_hash(kn->name, kn->ns);
Tejun Heoc637b8a2013-12-11 14:11:58 -05001514 kernfs_link_sibling(kn);
Tejun Heofd7b9f72013-11-28 14:54:33 -05001515
Tejun Heo3eef34a2014-02-07 13:32:07 -05001516 kernfs_put(old_parent);
Andrzej Hajda75287a62015-02-13 14:36:27 -08001517 kfree_const(old_name);
Tejun Heo3eef34a2014-02-07 13:32:07 -05001518
Tejun Heofd7b9f72013-11-28 14:54:33 -05001519 error = 0;
Greg Kroah-Hartman798c75a2014-01-13 14:36:03 -08001520 out:
Tejun Heoa797bfc2013-12-11 14:11:57 -05001521 mutex_unlock(&kernfs_mutex);
Tejun Heofd7b9f72013-11-28 14:54:33 -05001522 return error;
1523}
1524
Tejun Heofd7b9f72013-11-28 14:54:33 -05001525/* Relationship between s_mode and the DT_xxx types */
Tejun Heo324a56e2013-12-11 14:11:53 -05001526static inline unsigned char dt_type(struct kernfs_node *kn)
Tejun Heofd7b9f72013-11-28 14:54:33 -05001527{
Tejun Heoadc5e8b2013-12-11 14:11:54 -05001528 return (kn->mode >> 12) & 15;
Tejun Heofd7b9f72013-11-28 14:54:33 -05001529}
1530
Tejun Heoc637b8a2013-12-11 14:11:58 -05001531static int kernfs_dir_fop_release(struct inode *inode, struct file *filp)
Tejun Heofd7b9f72013-11-28 14:54:33 -05001532{
1533 kernfs_put(filp->private_data);
1534 return 0;
1535}
1536
Tejun Heoc637b8a2013-12-11 14:11:58 -05001537static struct kernfs_node *kernfs_dir_pos(const void *ns,
Tejun Heo324a56e2013-12-11 14:11:53 -05001538 struct kernfs_node *parent, loff_t hash, struct kernfs_node *pos)
Tejun Heofd7b9f72013-11-28 14:54:33 -05001539{
1540 if (pos) {
Tejun Heo81c173c2014-02-03 14:03:00 -05001541 int valid = kernfs_active(pos) &&
Greg Kroah-Hartman798c75a2014-01-13 14:36:03 -08001542 pos->parent == parent && hash == pos->hash;
Tejun Heofd7b9f72013-11-28 14:54:33 -05001543 kernfs_put(pos);
1544 if (!valid)
1545 pos = NULL;
1546 }
1547 if (!pos && (hash > 1) && (hash < INT_MAX)) {
Tejun Heoadc5e8b2013-12-11 14:11:54 -05001548 struct rb_node *node = parent->dir.children.rb_node;
Tejun Heofd7b9f72013-11-28 14:54:33 -05001549 while (node) {
Tejun Heo324a56e2013-12-11 14:11:53 -05001550 pos = rb_to_kn(node);
Tejun Heofd7b9f72013-11-28 14:54:33 -05001551
Tejun Heoadc5e8b2013-12-11 14:11:54 -05001552 if (hash < pos->hash)
Tejun Heofd7b9f72013-11-28 14:54:33 -05001553 node = node->rb_left;
Tejun Heoadc5e8b2013-12-11 14:11:54 -05001554 else if (hash > pos->hash)
Tejun Heofd7b9f72013-11-28 14:54:33 -05001555 node = node->rb_right;
1556 else
1557 break;
1558 }
1559 }
Tejun Heob9c9dad2014-02-03 14:09:11 -05001560 /* Skip over entries which are dying/dead or in the wrong namespace */
1561 while (pos && (!kernfs_active(pos) || pos->ns != ns)) {
Tejun Heoadc5e8b2013-12-11 14:11:54 -05001562 struct rb_node *node = rb_next(&pos->rb);
Tejun Heofd7b9f72013-11-28 14:54:33 -05001563 if (!node)
1564 pos = NULL;
1565 else
Tejun Heo324a56e2013-12-11 14:11:53 -05001566 pos = rb_to_kn(node);
Tejun Heofd7b9f72013-11-28 14:54:33 -05001567 }
1568 return pos;
1569}
1570
Tejun Heoc637b8a2013-12-11 14:11:58 -05001571static struct kernfs_node *kernfs_dir_next_pos(const void *ns,
Tejun Heo324a56e2013-12-11 14:11:53 -05001572 struct kernfs_node *parent, ino_t ino, struct kernfs_node *pos)
Tejun Heofd7b9f72013-11-28 14:54:33 -05001573{
Tejun Heoc637b8a2013-12-11 14:11:58 -05001574 pos = kernfs_dir_pos(ns, parent, ino, pos);
Tejun Heob9c9dad2014-02-03 14:09:11 -05001575 if (pos) {
Tejun Heofd7b9f72013-11-28 14:54:33 -05001576 do {
Tejun Heoadc5e8b2013-12-11 14:11:54 -05001577 struct rb_node *node = rb_next(&pos->rb);
Tejun Heofd7b9f72013-11-28 14:54:33 -05001578 if (!node)
1579 pos = NULL;
1580 else
Tejun Heo324a56e2013-12-11 14:11:53 -05001581 pos = rb_to_kn(node);
Tejun Heob9c9dad2014-02-03 14:09:11 -05001582 } while (pos && (!kernfs_active(pos) || pos->ns != ns));
1583 }
Tejun Heofd7b9f72013-11-28 14:54:33 -05001584 return pos;
1585}
1586
Tejun Heoc637b8a2013-12-11 14:11:58 -05001587static int kernfs_fop_readdir(struct file *file, struct dir_context *ctx)
Tejun Heofd7b9f72013-11-28 14:54:33 -05001588{
1589 struct dentry *dentry = file->f_path.dentry;
Tejun Heo324a56e2013-12-11 14:11:53 -05001590 struct kernfs_node *parent = dentry->d_fsdata;
1591 struct kernfs_node *pos = file->private_data;
Tejun Heofd7b9f72013-11-28 14:54:33 -05001592 const void *ns = NULL;
1593
1594 if (!dir_emit_dots(file, ctx))
1595 return 0;
Tejun Heoa797bfc2013-12-11 14:11:57 -05001596 mutex_lock(&kernfs_mutex);
Tejun Heofd7b9f72013-11-28 14:54:33 -05001597
Tejun Heo324a56e2013-12-11 14:11:53 -05001598 if (kernfs_ns_enabled(parent))
Tejun Heoc525aad2013-12-11 14:11:55 -05001599 ns = kernfs_info(dentry->d_sb)->ns;
Tejun Heofd7b9f72013-11-28 14:54:33 -05001600
Tejun Heoc637b8a2013-12-11 14:11:58 -05001601 for (pos = kernfs_dir_pos(ns, parent, ctx->pos, pos);
Tejun Heofd7b9f72013-11-28 14:54:33 -05001602 pos;
Tejun Heoc637b8a2013-12-11 14:11:58 -05001603 pos = kernfs_dir_next_pos(ns, parent, ctx->pos, pos)) {
Tejun Heoadc5e8b2013-12-11 14:11:54 -05001604 const char *name = pos->name;
Tejun Heofd7b9f72013-11-28 14:54:33 -05001605 unsigned int type = dt_type(pos);
1606 int len = strlen(name);
Tejun Heoadc5e8b2013-12-11 14:11:54 -05001607 ino_t ino = pos->ino;
Tejun Heofd7b9f72013-11-28 14:54:33 -05001608
Tejun Heoadc5e8b2013-12-11 14:11:54 -05001609 ctx->pos = pos->hash;
Tejun Heofd7b9f72013-11-28 14:54:33 -05001610 file->private_data = pos;
1611 kernfs_get(pos);
1612
Tejun Heoa797bfc2013-12-11 14:11:57 -05001613 mutex_unlock(&kernfs_mutex);
Tejun Heofd7b9f72013-11-28 14:54:33 -05001614 if (!dir_emit(ctx, name, len, ino, type))
1615 return 0;
Tejun Heoa797bfc2013-12-11 14:11:57 -05001616 mutex_lock(&kernfs_mutex);
Tejun Heofd7b9f72013-11-28 14:54:33 -05001617 }
Tejun Heoa797bfc2013-12-11 14:11:57 -05001618 mutex_unlock(&kernfs_mutex);
Tejun Heofd7b9f72013-11-28 14:54:33 -05001619 file->private_data = NULL;
1620 ctx->pos = INT_MAX;
1621 return 0;
1622}
1623
Tejun Heoa797bfc2013-12-11 14:11:57 -05001624const struct file_operations kernfs_dir_fops = {
Tejun Heofd7b9f72013-11-28 14:54:33 -05001625 .read = generic_read_dir,
Al Viro8cb0d2c2016-04-20 19:59:01 -04001626 .iterate_shared = kernfs_fop_readdir,
Tejun Heoc637b8a2013-12-11 14:11:58 -05001627 .release = kernfs_dir_fop_release,
Al Viro8cb0d2c2016-04-20 19:59:01 -04001628 .llseek = generic_file_llseek,
Tejun Heofd7b9f72013-11-28 14:54:33 -05001629};