xref: /linux/fs/sysfs/dir.c (revision 2d03423b2319cc854adeb28a03f65de5b5e0ab63)
1 /*
2  * fs/sysfs/dir.c - sysfs core and dir operation implementation
3  *
4  * Copyright (c) 2001-3 Patrick Mochel
5  * Copyright (c) 2007 SUSE Linux Products GmbH
6  * Copyright (c) 2007 Tejun Heo <teheo@suse.de>
7  *
8  * This file is released under the GPLv2.
9  *
10  * Please see Documentation/filesystems/sysfs.txt for more information.
11  */
12 
13 #undef DEBUG
14 
15 #include <linux/fs.h>
16 #include <linux/mount.h>
17 #include <linux/module.h>
18 #include <linux/kobject.h>
19 #include <linux/namei.h>
20 #include <linux/idr.h>
21 #include <linux/completion.h>
22 #include <linux/mutex.h>
23 #include <linux/slab.h>
24 #include <linux/security.h>
25 #include "sysfs.h"
26 
27 DEFINE_MUTEX(sysfs_mutex);
28 DEFINE_SPINLOCK(sysfs_assoc_lock);
29 
30 static DEFINE_SPINLOCK(sysfs_ino_lock);
31 static DEFINE_IDA(sysfs_ino_ida);
32 
33 /**
34  *	sysfs_link_sibling - link sysfs_dirent into sibling list
35  *	@sd: sysfs_dirent of interest
36  *
37  *	Link @sd into its sibling list which starts from
38  *	sd->s_parent->s_dir.children.
39  *
40  *	Locking:
41  *	mutex_lock(sysfs_mutex)
42  */
43 static void sysfs_link_sibling(struct sysfs_dirent *sd)
44 {
45 	struct sysfs_dirent *parent_sd = sd->s_parent;
46 
47 	struct rb_node **p;
48 	struct rb_node *parent;
49 
50 	if (sysfs_type(sd) == SYSFS_DIR)
51 		parent_sd->s_dir.subdirs++;
52 
53 	p = &parent_sd->s_dir.inode_tree.rb_node;
54 	parent = NULL;
55 	while (*p) {
56 		parent = *p;
57 #define node	rb_entry(parent, struct sysfs_dirent, inode_node)
58 		if (sd->s_ino < node->s_ino) {
59 			p = &node->inode_node.rb_left;
60 		} else if (sd->s_ino > node->s_ino) {
61 			p = &node->inode_node.rb_right;
62 		} else {
63 			printk(KERN_CRIT "sysfs: inserting duplicate inode '%lx'\n",
64 			       (unsigned long) sd->s_ino);
65 			BUG();
66 		}
67 #undef node
68 	}
69 	rb_link_node(&sd->inode_node, parent, p);
70 	rb_insert_color(&sd->inode_node, &parent_sd->s_dir.inode_tree);
71 
72 	p = &parent_sd->s_dir.name_tree.rb_node;
73 	parent = NULL;
74 	while (*p) {
75 		int c;
76 		parent = *p;
77 #define node	rb_entry(parent, struct sysfs_dirent, name_node)
78 		c = strcmp(sd->s_name, node->s_name);
79 		if (c < 0) {
80 			p = &node->name_node.rb_left;
81 		} else {
82 			p = &node->name_node.rb_right;
83 		}
84 #undef node
85 	}
86 	rb_link_node(&sd->name_node, parent, p);
87 	rb_insert_color(&sd->name_node, &parent_sd->s_dir.name_tree);
88 }
89 
90 /**
91  *	sysfs_unlink_sibling - unlink sysfs_dirent from sibling list
92  *	@sd: sysfs_dirent of interest
93  *
94  *	Unlink @sd from its sibling list which starts from
95  *	sd->s_parent->s_dir.children.
96  *
97  *	Locking:
98  *	mutex_lock(sysfs_mutex)
99  */
100 static void sysfs_unlink_sibling(struct sysfs_dirent *sd)
101 {
102 	if (sysfs_type(sd) == SYSFS_DIR)
103 		sd->s_parent->s_dir.subdirs--;
104 
105 	rb_erase(&sd->inode_node, &sd->s_parent->s_dir.inode_tree);
106 	rb_erase(&sd->name_node, &sd->s_parent->s_dir.name_tree);
107 }
108 
109 /**
110  *	sysfs_get_active - get an active reference to sysfs_dirent
111  *	@sd: sysfs_dirent to get an active reference to
112  *
113  *	Get an active reference of @sd.  This function is noop if @sd
114  *	is NULL.
115  *
116  *	RETURNS:
117  *	Pointer to @sd on success, NULL on failure.
118  */
119 struct sysfs_dirent *sysfs_get_active(struct sysfs_dirent *sd)
120 {
121 	if (unlikely(!sd))
122 		return NULL;
123 
124 	while (1) {
125 		int v, t;
126 
127 		v = atomic_read(&sd->s_active);
128 		if (unlikely(v < 0))
129 			return NULL;
130 
131 		t = atomic_cmpxchg(&sd->s_active, v, v + 1);
132 		if (likely(t == v)) {
133 			rwsem_acquire_read(&sd->dep_map, 0, 1, _RET_IP_);
134 			return sd;
135 		}
136 		if (t < 0)
137 			return NULL;
138 
139 		cpu_relax();
140 	}
141 }
142 
143 /**
144  *	sysfs_put_active - put an active reference to sysfs_dirent
145  *	@sd: sysfs_dirent to put an active reference to
146  *
147  *	Put an active reference to @sd.  This function is noop if @sd
148  *	is NULL.
149  */
150 void sysfs_put_active(struct sysfs_dirent *sd)
151 {
152 	int v;
153 
154 	if (unlikely(!sd))
155 		return;
156 
157 	rwsem_release(&sd->dep_map, 1, _RET_IP_);
158 	v = atomic_dec_return(&sd->s_active);
159 	if (likely(v != SD_DEACTIVATED_BIAS))
160 		return;
161 
162 	/* atomic_dec_return() is a mb(), we'll always see the updated
163 	 * sd->u.completion.
164 	 */
165 	complete(sd->u.completion);
166 }
167 
168 /**
169  *	sysfs_deactivate - deactivate sysfs_dirent
170  *	@sd: sysfs_dirent to deactivate
171  *
172  *	Deny new active references and drain existing ones.
173  */
174 static void sysfs_deactivate(struct sysfs_dirent *sd)
175 {
176 	DECLARE_COMPLETION_ONSTACK(wait);
177 	int v;
178 
179 	BUG_ON(!(sd->s_flags & SYSFS_FLAG_REMOVED));
180 
181 	if (!(sysfs_type(sd) & SYSFS_ACTIVE_REF))
182 		return;
183 
184 	sd->u.completion = (void *)&wait;
185 
186 	rwsem_acquire(&sd->dep_map, 0, 0, _RET_IP_);
187 	/* atomic_add_return() is a mb(), put_active() will always see
188 	 * the updated sd->u.completion.
189 	 */
190 	v = atomic_add_return(SD_DEACTIVATED_BIAS, &sd->s_active);
191 
192 	if (v != SD_DEACTIVATED_BIAS) {
193 		lock_contended(&sd->dep_map, _RET_IP_);
194 		wait_for_completion(&wait);
195 	}
196 
197 	lock_acquired(&sd->dep_map, _RET_IP_);
198 	rwsem_release(&sd->dep_map, 1, _RET_IP_);
199 }
200 
201 static int sysfs_alloc_ino(ino_t *pino)
202 {
203 	int ino, rc;
204 
205  retry:
206 	spin_lock(&sysfs_ino_lock);
207 	rc = ida_get_new_above(&sysfs_ino_ida, 2, &ino);
208 	spin_unlock(&sysfs_ino_lock);
209 
210 	if (rc == -EAGAIN) {
211 		if (ida_pre_get(&sysfs_ino_ida, GFP_KERNEL))
212 			goto retry;
213 		rc = -ENOMEM;
214 	}
215 
216 	*pino = ino;
217 	return rc;
218 }
219 
220 static void sysfs_free_ino(ino_t ino)
221 {
222 	spin_lock(&sysfs_ino_lock);
223 	ida_remove(&sysfs_ino_ida, ino);
224 	spin_unlock(&sysfs_ino_lock);
225 }
226 
227 void release_sysfs_dirent(struct sysfs_dirent * sd)
228 {
229 	struct sysfs_dirent *parent_sd;
230 
231  repeat:
232 	/* Moving/renaming is always done while holding reference.
233 	 * sd->s_parent won't change beneath us.
234 	 */
235 	parent_sd = sd->s_parent;
236 
237 	if (sysfs_type(sd) == SYSFS_KOBJ_LINK)
238 		sysfs_put(sd->s_symlink.target_sd);
239 	if (sysfs_type(sd) & SYSFS_COPY_NAME)
240 		kfree(sd->s_name);
241 	if (sd->s_iattr && sd->s_iattr->ia_secdata)
242 		security_release_secctx(sd->s_iattr->ia_secdata,
243 					sd->s_iattr->ia_secdata_len);
244 	kfree(sd->s_iattr);
245 	sysfs_free_ino(sd->s_ino);
246 	kmem_cache_free(sysfs_dir_cachep, sd);
247 
248 	sd = parent_sd;
249 	if (sd && atomic_dec_and_test(&sd->s_count))
250 		goto repeat;
251 }
252 
253 static int sysfs_dentry_delete(const struct dentry *dentry)
254 {
255 	struct sysfs_dirent *sd = dentry->d_fsdata;
256 	return !!(sd->s_flags & SYSFS_FLAG_REMOVED);
257 }
258 
259 static int sysfs_dentry_revalidate(struct dentry *dentry, struct nameidata *nd)
260 {
261 	struct sysfs_dirent *sd;
262 	int is_dir;
263 
264 	if (nd->flags & LOOKUP_RCU)
265 		return -ECHILD;
266 
267 	sd = dentry->d_fsdata;
268 	mutex_lock(&sysfs_mutex);
269 
270 	/* The sysfs dirent has been deleted */
271 	if (sd->s_flags & SYSFS_FLAG_REMOVED)
272 		goto out_bad;
273 
274 	/* The sysfs dirent has been moved? */
275 	if (dentry->d_parent->d_fsdata != sd->s_parent)
276 		goto out_bad;
277 
278 	/* The sysfs dirent has been renamed */
279 	if (strcmp(dentry->d_name.name, sd->s_name) != 0)
280 		goto out_bad;
281 
282 	mutex_unlock(&sysfs_mutex);
283 out_valid:
284 	return 1;
285 out_bad:
286 	/* Remove the dentry from the dcache hashes.
287 	 * If this is a deleted dentry we use d_drop instead of d_delete
288 	 * so sysfs doesn't need to cope with negative dentries.
289 	 *
290 	 * If this is a dentry that has simply been renamed we
291 	 * use d_drop to remove it from the dcache lookup on its
292 	 * old parent.  If this dentry persists later when a lookup
293 	 * is performed at its new name the dentry will be readded
294 	 * to the dcache hashes.
295 	 */
296 	is_dir = (sysfs_type(sd) == SYSFS_DIR);
297 	mutex_unlock(&sysfs_mutex);
298 	if (is_dir) {
299 		/* If we have submounts we must allow the vfs caches
300 		 * to lie about the state of the filesystem to prevent
301 		 * leaks and other nasty things.
302 		 */
303 		if (have_submounts(dentry))
304 			goto out_valid;
305 		shrink_dcache_parent(dentry);
306 	}
307 	d_drop(dentry);
308 	return 0;
309 }
310 
311 static void sysfs_dentry_iput(struct dentry *dentry, struct inode *inode)
312 {
313 	struct sysfs_dirent * sd = dentry->d_fsdata;
314 
315 	sysfs_put(sd);
316 	iput(inode);
317 }
318 
319 static const struct dentry_operations sysfs_dentry_ops = {
320 	.d_revalidate	= sysfs_dentry_revalidate,
321 	.d_delete	= sysfs_dentry_delete,
322 	.d_iput		= sysfs_dentry_iput,
323 };
324 
325 struct sysfs_dirent *sysfs_new_dirent(const char *name, umode_t mode, int type)
326 {
327 	char *dup_name = NULL;
328 	struct sysfs_dirent *sd;
329 
330 	if (type & SYSFS_COPY_NAME) {
331 		name = dup_name = kstrdup(name, GFP_KERNEL);
332 		if (!name)
333 			return NULL;
334 	}
335 
336 	sd = kmem_cache_zalloc(sysfs_dir_cachep, GFP_KERNEL);
337 	if (!sd)
338 		goto err_out1;
339 
340 	if (sysfs_alloc_ino(&sd->s_ino))
341 		goto err_out2;
342 
343 	atomic_set(&sd->s_count, 1);
344 	atomic_set(&sd->s_active, 0);
345 
346 	sd->s_name = name;
347 	sd->s_mode = mode;
348 	sd->s_flags = type;
349 
350 	return sd;
351 
352  err_out2:
353 	kmem_cache_free(sysfs_dir_cachep, sd);
354  err_out1:
355 	kfree(dup_name);
356 	return NULL;
357 }
358 
359 /**
360  *	sysfs_addrm_start - prepare for sysfs_dirent add/remove
361  *	@acxt: pointer to sysfs_addrm_cxt to be used
362  *	@parent_sd: parent sysfs_dirent
363  *
364  *	This function is called when the caller is about to add or
365  *	remove sysfs_dirent under @parent_sd.  This function acquires
366  *	sysfs_mutex.  @acxt is used to keep and pass context to
367  *	other addrm functions.
368  *
369  *	LOCKING:
370  *	Kernel thread context (may sleep).  sysfs_mutex is locked on
371  *	return.
372  */
373 void sysfs_addrm_start(struct sysfs_addrm_cxt *acxt,
374 		       struct sysfs_dirent *parent_sd)
375 {
376 	memset(acxt, 0, sizeof(*acxt));
377 	acxt->parent_sd = parent_sd;
378 
379 	mutex_lock(&sysfs_mutex);
380 }
381 
382 /**
383  *	__sysfs_add_one - add sysfs_dirent to parent without warning
384  *	@acxt: addrm context to use
385  *	@sd: sysfs_dirent to be added
386  *
387  *	Get @acxt->parent_sd and set sd->s_parent to it and increment
388  *	nlink of parent inode if @sd is a directory and link into the
389  *	children list of the parent.
390  *
391  *	This function should be called between calls to
392  *	sysfs_addrm_start() and sysfs_addrm_finish() and should be
393  *	passed the same @acxt as passed to sysfs_addrm_start().
394  *
395  *	LOCKING:
396  *	Determined by sysfs_addrm_start().
397  *
398  *	RETURNS:
399  *	0 on success, -EEXIST if entry with the given name already
400  *	exists.
401  */
402 int __sysfs_add_one(struct sysfs_addrm_cxt *acxt, struct sysfs_dirent *sd)
403 {
404 	struct sysfs_inode_attrs *ps_iattr;
405 
406 	if (sysfs_find_dirent(acxt->parent_sd, sd->s_ns, sd->s_name))
407 		return -EEXIST;
408 
409 	sd->s_parent = sysfs_get(acxt->parent_sd);
410 
411 	sysfs_link_sibling(sd);
412 
413 	/* Update timestamps on the parent */
414 	ps_iattr = acxt->parent_sd->s_iattr;
415 	if (ps_iattr) {
416 		struct iattr *ps_iattrs = &ps_iattr->ia_iattr;
417 		ps_iattrs->ia_ctime = ps_iattrs->ia_mtime = CURRENT_TIME;
418 	}
419 
420 	return 0;
421 }
422 
423 /**
424  *	sysfs_pathname - return full path to sysfs dirent
425  *	@sd: sysfs_dirent whose path we want
426  *	@path: caller allocated buffer
427  *
428  *	Gives the name "/" to the sysfs_root entry; any path returned
429  *	is relative to wherever sysfs is mounted.
430  *
431  *	XXX: does no error checking on @path size
432  */
433 static char *sysfs_pathname(struct sysfs_dirent *sd, char *path)
434 {
435 	if (sd->s_parent) {
436 		sysfs_pathname(sd->s_parent, path);
437 		strcat(path, "/");
438 	}
439 	strcat(path, sd->s_name);
440 	return path;
441 }
442 
443 /**
444  *	sysfs_add_one - add sysfs_dirent to parent
445  *	@acxt: addrm context to use
446  *	@sd: sysfs_dirent to be added
447  *
448  *	Get @acxt->parent_sd and set sd->s_parent to it and increment
449  *	nlink of parent inode if @sd is a directory and link into the
450  *	children list of the parent.
451  *
452  *	This function should be called between calls to
453  *	sysfs_addrm_start() and sysfs_addrm_finish() and should be
454  *	passed the same @acxt as passed to sysfs_addrm_start().
455  *
456  *	LOCKING:
457  *	Determined by sysfs_addrm_start().
458  *
459  *	RETURNS:
460  *	0 on success, -EEXIST if entry with the given name already
461  *	exists.
462  */
463 int sysfs_add_one(struct sysfs_addrm_cxt *acxt, struct sysfs_dirent *sd)
464 {
465 	int ret;
466 
467 	ret = __sysfs_add_one(acxt, sd);
468 	if (ret == -EEXIST) {
469 		char *path = kzalloc(PATH_MAX, GFP_KERNEL);
470 		WARN(1, KERN_WARNING
471 		     "sysfs: cannot create duplicate filename '%s'\n",
472 		     (path == NULL) ? sd->s_name :
473 		     strcat(strcat(sysfs_pathname(acxt->parent_sd, path), "/"),
474 		            sd->s_name));
475 		kfree(path);
476 	}
477 
478 	return ret;
479 }
480 
481 /**
482  *	sysfs_remove_one - remove sysfs_dirent from parent
483  *	@acxt: addrm context to use
484  *	@sd: sysfs_dirent to be removed
485  *
486  *	Mark @sd removed and drop nlink of parent inode if @sd is a
487  *	directory.  @sd is unlinked from the children list.
488  *
489  *	This function should be called between calls to
490  *	sysfs_addrm_start() and sysfs_addrm_finish() and should be
491  *	passed the same @acxt as passed to sysfs_addrm_start().
492  *
493  *	LOCKING:
494  *	Determined by sysfs_addrm_start().
495  */
496 void sysfs_remove_one(struct sysfs_addrm_cxt *acxt, struct sysfs_dirent *sd)
497 {
498 	struct sysfs_inode_attrs *ps_iattr;
499 
500 	BUG_ON(sd->s_flags & SYSFS_FLAG_REMOVED);
501 
502 	sysfs_unlink_sibling(sd);
503 
504 	/* Update timestamps on the parent */
505 	ps_iattr = acxt->parent_sd->s_iattr;
506 	if (ps_iattr) {
507 		struct iattr *ps_iattrs = &ps_iattr->ia_iattr;
508 		ps_iattrs->ia_ctime = ps_iattrs->ia_mtime = CURRENT_TIME;
509 	}
510 
511 	sd->s_flags |= SYSFS_FLAG_REMOVED;
512 	sd->u.removed_list = acxt->removed;
513 	acxt->removed = sd;
514 }
515 
516 /**
517  *	sysfs_addrm_finish - finish up sysfs_dirent add/remove
518  *	@acxt: addrm context to finish up
519  *
520  *	Finish up sysfs_dirent add/remove.  Resources acquired by
521  *	sysfs_addrm_start() are released and removed sysfs_dirents are
522  *	cleaned up.
523  *
524  *	LOCKING:
525  *	sysfs_mutex is released.
526  */
527 void sysfs_addrm_finish(struct sysfs_addrm_cxt *acxt)
528 {
529 	/* release resources acquired by sysfs_addrm_start() */
530 	mutex_unlock(&sysfs_mutex);
531 
532 	/* kill removed sysfs_dirents */
533 	while (acxt->removed) {
534 		struct sysfs_dirent *sd = acxt->removed;
535 
536 		acxt->removed = sd->u.removed_list;
537 
538 		sysfs_deactivate(sd);
539 		unmap_bin_file(sd);
540 		sysfs_put(sd);
541 	}
542 }
543 
544 /**
545  *	sysfs_find_dirent - find sysfs_dirent with the given name
546  *	@parent_sd: sysfs_dirent to search under
547  *	@name: name to look for
548  *
549  *	Look for sysfs_dirent with name @name under @parent_sd.
550  *
551  *	LOCKING:
552  *	mutex_lock(sysfs_mutex)
553  *
554  *	RETURNS:
555  *	Pointer to sysfs_dirent if found, NULL if not.
556  */
557 struct sysfs_dirent *sysfs_find_dirent(struct sysfs_dirent *parent_sd,
558 				       const void *ns,
559 				       const unsigned char *name)
560 {
561 	struct rb_node *p = parent_sd->s_dir.name_tree.rb_node;
562 	struct sysfs_dirent *found = NULL;
563 
564 	while (p) {
565 		int c;
566 #define node	rb_entry(p, struct sysfs_dirent, name_node)
567 		c = strcmp(name, node->s_name);
568 		if (c < 0) {
569 			p = node->name_node.rb_left;
570 		} else if (c > 0) {
571 			p = node->name_node.rb_right;
572 		} else {
573 			found = node;
574 			p = node->name_node.rb_left;
575 		}
576 #undef node
577 	}
578 
579 	if (found && ns) {
580 		while (found->s_ns && found->s_ns != ns) {
581 			p = rb_next(&found->name_node);
582 			if (!p)
583 				return NULL;
584 			found = rb_entry(p, struct sysfs_dirent, name_node);
585 			if (strcmp(name, found->s_name))
586 				return NULL;
587 		}
588 	}
589 
590 	return found;
591 }
592 
593 /**
594  *	sysfs_get_dirent - find and get sysfs_dirent with the given name
595  *	@parent_sd: sysfs_dirent to search under
596  *	@name: name to look for
597  *
598  *	Look for sysfs_dirent with name @name under @parent_sd and get
599  *	it if found.
600  *
601  *	LOCKING:
602  *	Kernel thread context (may sleep).  Grabs sysfs_mutex.
603  *
604  *	RETURNS:
605  *	Pointer to sysfs_dirent if found, NULL if not.
606  */
607 struct sysfs_dirent *sysfs_get_dirent(struct sysfs_dirent *parent_sd,
608 				      const void *ns,
609 				      const unsigned char *name)
610 {
611 	struct sysfs_dirent *sd;
612 
613 	mutex_lock(&sysfs_mutex);
614 	sd = sysfs_find_dirent(parent_sd, ns, name);
615 	sysfs_get(sd);
616 	mutex_unlock(&sysfs_mutex);
617 
618 	return sd;
619 }
620 EXPORT_SYMBOL_GPL(sysfs_get_dirent);
621 
622 static int create_dir(struct kobject *kobj, struct sysfs_dirent *parent_sd,
623 	enum kobj_ns_type type, const void *ns, const char *name,
624 	struct sysfs_dirent **p_sd)
625 {
626 	umode_t mode = S_IFDIR| S_IRWXU | S_IRUGO | S_IXUGO;
627 	struct sysfs_addrm_cxt acxt;
628 	struct sysfs_dirent *sd;
629 	int rc;
630 
631 	/* allocate */
632 	sd = sysfs_new_dirent(name, mode, SYSFS_DIR);
633 	if (!sd)
634 		return -ENOMEM;
635 
636 	sd->s_flags |= (type << SYSFS_NS_TYPE_SHIFT);
637 	sd->s_ns = ns;
638 	sd->s_dir.kobj = kobj;
639 
640 	/* link in */
641 	sysfs_addrm_start(&acxt, parent_sd);
642 	rc = sysfs_add_one(&acxt, sd);
643 	sysfs_addrm_finish(&acxt);
644 
645 	if (rc == 0)
646 		*p_sd = sd;
647 	else
648 		sysfs_put(sd);
649 
650 	return rc;
651 }
652 
653 int sysfs_create_subdir(struct kobject *kobj, const char *name,
654 			struct sysfs_dirent **p_sd)
655 {
656 	return create_dir(kobj, kobj->sd,
657 			  KOBJ_NS_TYPE_NONE, NULL, name, p_sd);
658 }
659 
660 /**
661  *	sysfs_read_ns_type: return associated ns_type
662  *	@kobj: the kobject being queried
663  *
664  *	Each kobject can be tagged with exactly one namespace type
665  *	(i.e. network or user).  Return the ns_type associated with
666  *	this object if any
667  */
668 static enum kobj_ns_type sysfs_read_ns_type(struct kobject *kobj)
669 {
670 	const struct kobj_ns_type_operations *ops;
671 	enum kobj_ns_type type;
672 
673 	ops = kobj_child_ns_ops(kobj);
674 	if (!ops)
675 		return KOBJ_NS_TYPE_NONE;
676 
677 	type = ops->type;
678 	BUG_ON(type <= KOBJ_NS_TYPE_NONE);
679 	BUG_ON(type >= KOBJ_NS_TYPES);
680 	BUG_ON(!kobj_ns_type_registered(type));
681 
682 	return type;
683 }
684 
685 /**
686  *	sysfs_create_dir - create a directory for an object.
687  *	@kobj:		object we're creating directory for.
688  */
689 int sysfs_create_dir(struct kobject * kobj)
690 {
691 	enum kobj_ns_type type;
692 	struct sysfs_dirent *parent_sd, *sd;
693 	const void *ns = NULL;
694 	int error = 0;
695 
696 	BUG_ON(!kobj);
697 
698 	if (kobj->parent)
699 		parent_sd = kobj->parent->sd;
700 	else
701 		parent_sd = &sysfs_root;
702 
703 	if (sysfs_ns_type(parent_sd))
704 		ns = kobj->ktype->namespace(kobj);
705 	type = sysfs_read_ns_type(kobj);
706 
707 	error = create_dir(kobj, parent_sd, type, ns, kobject_name(kobj), &sd);
708 	if (!error)
709 		kobj->sd = sd;
710 	return error;
711 }
712 
713 static struct dentry * sysfs_lookup(struct inode *dir, struct dentry *dentry,
714 				struct nameidata *nd)
715 {
716 	struct dentry *ret = NULL;
717 	struct dentry *parent = dentry->d_parent;
718 	struct sysfs_dirent *parent_sd = parent->d_fsdata;
719 	struct sysfs_dirent *sd;
720 	struct inode *inode;
721 	enum kobj_ns_type type;
722 	const void *ns;
723 
724 	mutex_lock(&sysfs_mutex);
725 
726 	type = sysfs_ns_type(parent_sd);
727 	ns = sysfs_info(dir->i_sb)->ns[type];
728 
729 	sd = sysfs_find_dirent(parent_sd, ns, dentry->d_name.name);
730 
731 	/* no such entry */
732 	if (!sd) {
733 		ret = ERR_PTR(-ENOENT);
734 		goto out_unlock;
735 	}
736 
737 	/* attach dentry and inode */
738 	inode = sysfs_get_inode(dir->i_sb, sd);
739 	if (!inode) {
740 		ret = ERR_PTR(-ENOMEM);
741 		goto out_unlock;
742 	}
743 
744 	/* instantiate and hash dentry */
745 	ret = d_find_alias(inode);
746 	if (!ret) {
747 		d_set_d_op(dentry, &sysfs_dentry_ops);
748 		dentry->d_fsdata = sysfs_get(sd);
749 		d_add(dentry, inode);
750 	} else {
751 		d_move(ret, dentry);
752 		iput(inode);
753 	}
754 
755  out_unlock:
756 	mutex_unlock(&sysfs_mutex);
757 	return ret;
758 }
759 
760 const struct inode_operations sysfs_dir_inode_operations = {
761 	.lookup		= sysfs_lookup,
762 	.permission	= sysfs_permission,
763 	.setattr	= sysfs_setattr,
764 	.getattr	= sysfs_getattr,
765 	.setxattr	= sysfs_setxattr,
766 };
767 
768 static void remove_dir(struct sysfs_dirent *sd)
769 {
770 	struct sysfs_addrm_cxt acxt;
771 
772 	sysfs_addrm_start(&acxt, sd->s_parent);
773 	sysfs_remove_one(&acxt, sd);
774 	sysfs_addrm_finish(&acxt);
775 }
776 
777 void sysfs_remove_subdir(struct sysfs_dirent *sd)
778 {
779 	remove_dir(sd);
780 }
781 
782 
783 static void __sysfs_remove_dir(struct sysfs_dirent *dir_sd)
784 {
785 	struct sysfs_addrm_cxt acxt;
786 	struct rb_node *pos;
787 
788 	if (!dir_sd)
789 		return;
790 
791 	pr_debug("sysfs %s: removing dir\n", dir_sd->s_name);
792 	sysfs_addrm_start(&acxt, dir_sd);
793 	pos = rb_first(&dir_sd->s_dir.inode_tree);
794 	while (pos) {
795 		struct sysfs_dirent *sd = rb_entry(pos, struct sysfs_dirent, inode_node);
796 		pos = rb_next(pos);
797 		if (sysfs_type(sd) != SYSFS_DIR)
798 			sysfs_remove_one(&acxt, sd);
799 	}
800 	sysfs_addrm_finish(&acxt);
801 
802 	remove_dir(dir_sd);
803 }
804 
805 /**
806  *	sysfs_remove_dir - remove an object's directory.
807  *	@kobj:	object.
808  *
809  *	The only thing special about this is that we remove any files in
810  *	the directory before we remove the directory, and we've inlined
811  *	what used to be sysfs_rmdir() below, instead of calling separately.
812  */
813 
814 void sysfs_remove_dir(struct kobject * kobj)
815 {
816 	struct sysfs_dirent *sd = kobj->sd;
817 
818 	spin_lock(&sysfs_assoc_lock);
819 	kobj->sd = NULL;
820 	spin_unlock(&sysfs_assoc_lock);
821 
822 	__sysfs_remove_dir(sd);
823 }
824 
825 int sysfs_rename(struct sysfs_dirent *sd,
826 	struct sysfs_dirent *new_parent_sd, const void *new_ns,
827 	const char *new_name)
828 {
829 	const char *dup_name = NULL;
830 	int error;
831 
832 	mutex_lock(&sysfs_mutex);
833 
834 	error = 0;
835 	if ((sd->s_parent == new_parent_sd) && (sd->s_ns == new_ns) &&
836 	    (strcmp(sd->s_name, new_name) == 0))
837 		goto out;	/* nothing to rename */
838 
839 	error = -EEXIST;
840 	if (sysfs_find_dirent(new_parent_sd, new_ns, new_name))
841 		goto out;
842 
843 	/* rename sysfs_dirent */
844 	if (strcmp(sd->s_name, new_name) != 0) {
845 		error = -ENOMEM;
846 		new_name = dup_name = kstrdup(new_name, GFP_KERNEL);
847 		if (!new_name)
848 			goto out;
849 
850 		dup_name = sd->s_name;
851 		sd->s_name = new_name;
852 	}
853 
854 	/* Remove from old parent's list and insert into new parent's list. */
855 	if (sd->s_parent != new_parent_sd) {
856 		sysfs_unlink_sibling(sd);
857 		sysfs_get(new_parent_sd);
858 		sysfs_put(sd->s_parent);
859 		sd->s_parent = new_parent_sd;
860 		sysfs_link_sibling(sd);
861 	}
862 	sd->s_ns = new_ns;
863 
864 	error = 0;
865  out:
866 	mutex_unlock(&sysfs_mutex);
867 	kfree(dup_name);
868 	return error;
869 }
870 
871 int sysfs_rename_dir(struct kobject *kobj, const char *new_name)
872 {
873 	struct sysfs_dirent *parent_sd = kobj->sd->s_parent;
874 	const void *new_ns = NULL;
875 
876 	if (sysfs_ns_type(parent_sd))
877 		new_ns = kobj->ktype->namespace(kobj);
878 
879 	return sysfs_rename(kobj->sd, parent_sd, new_ns, new_name);
880 }
881 
882 int sysfs_move_dir(struct kobject *kobj, struct kobject *new_parent_kobj)
883 {
884 	struct sysfs_dirent *sd = kobj->sd;
885 	struct sysfs_dirent *new_parent_sd;
886 	const void *new_ns = NULL;
887 
888 	BUG_ON(!sd->s_parent);
889 	if (sysfs_ns_type(sd->s_parent))
890 		new_ns = kobj->ktype->namespace(kobj);
891 	new_parent_sd = new_parent_kobj && new_parent_kobj->sd ?
892 		new_parent_kobj->sd : &sysfs_root;
893 
894 	return sysfs_rename(sd, new_parent_sd, new_ns, sd->s_name);
895 }
896 
897 /* Relationship between s_mode and the DT_xxx types */
898 static inline unsigned char dt_type(struct sysfs_dirent *sd)
899 {
900 	return (sd->s_mode >> 12) & 15;
901 }
902 
903 static int sysfs_dir_release(struct inode *inode, struct file *filp)
904 {
905 	sysfs_put(filp->private_data);
906 	return 0;
907 }
908 
909 static struct sysfs_dirent *sysfs_dir_pos(const void *ns,
910 	struct sysfs_dirent *parent_sd,	ino_t ino, struct sysfs_dirent *pos)
911 {
912 	if (pos) {
913 		int valid = !(pos->s_flags & SYSFS_FLAG_REMOVED) &&
914 			pos->s_parent == parent_sd &&
915 			ino == pos->s_ino;
916 		sysfs_put(pos);
917 		if (!valid)
918 			pos = NULL;
919 	}
920 	if (!pos && (ino > 1) && (ino < INT_MAX)) {
921 		struct rb_node *p = parent_sd->s_dir.inode_tree.rb_node;
922 		while (p) {
923 #define node	rb_entry(p, struct sysfs_dirent, inode_node)
924 			if (ino < node->s_ino) {
925 				pos = node;
926 				p = node->inode_node.rb_left;
927 			} else if (ino > node->s_ino) {
928 				p = node->inode_node.rb_right;
929 			} else {
930 				pos = node;
931 				break;
932 			}
933 #undef node
934 		}
935 	}
936 	while (pos && pos->s_ns && pos->s_ns != ns) {
937 		struct rb_node *p = rb_next(&pos->inode_node);
938 		if (!p)
939 			pos = NULL;
940 		else
941 			pos = rb_entry(p, struct sysfs_dirent, inode_node);
942 	}
943 	return pos;
944 }
945 
946 static struct sysfs_dirent *sysfs_dir_next_pos(const void *ns,
947 	struct sysfs_dirent *parent_sd,	ino_t ino, struct sysfs_dirent *pos)
948 {
949 	pos = sysfs_dir_pos(ns, parent_sd, ino, pos);
950 	if (pos) do {
951 		struct rb_node *p = rb_next(&pos->inode_node);
952 		if (!p)
953 			pos = NULL;
954 		else
955 			pos = rb_entry(p, struct sysfs_dirent, inode_node);
956 	} while (pos && pos->s_ns && pos->s_ns != ns);
957 	return pos;
958 }
959 
960 static int sysfs_readdir(struct file * filp, void * dirent, filldir_t filldir)
961 {
962 	struct dentry *dentry = filp->f_path.dentry;
963 	struct sysfs_dirent * parent_sd = dentry->d_fsdata;
964 	struct sysfs_dirent *pos = filp->private_data;
965 	enum kobj_ns_type type;
966 	const void *ns;
967 	ino_t ino;
968 
969 	type = sysfs_ns_type(parent_sd);
970 	ns = sysfs_info(dentry->d_sb)->ns[type];
971 
972 	if (filp->f_pos == 0) {
973 		ino = parent_sd->s_ino;
974 		if (filldir(dirent, ".", 1, filp->f_pos, ino, DT_DIR) == 0)
975 			filp->f_pos++;
976 	}
977 	if (filp->f_pos == 1) {
978 		if (parent_sd->s_parent)
979 			ino = parent_sd->s_parent->s_ino;
980 		else
981 			ino = parent_sd->s_ino;
982 		if (filldir(dirent, "..", 2, filp->f_pos, ino, DT_DIR) == 0)
983 			filp->f_pos++;
984 	}
985 	mutex_lock(&sysfs_mutex);
986 	for (pos = sysfs_dir_pos(ns, parent_sd, filp->f_pos, pos);
987 	     pos;
988 	     pos = sysfs_dir_next_pos(ns, parent_sd, filp->f_pos, pos)) {
989 		const char * name;
990 		unsigned int type;
991 		int len, ret;
992 
993 		name = pos->s_name;
994 		len = strlen(name);
995 		ino = pos->s_ino;
996 		type = dt_type(pos);
997 		filp->f_pos = ino;
998 		filp->private_data = sysfs_get(pos);
999 
1000 		mutex_unlock(&sysfs_mutex);
1001 		ret = filldir(dirent, name, len, filp->f_pos, ino, type);
1002 		mutex_lock(&sysfs_mutex);
1003 		if (ret < 0)
1004 			break;
1005 	}
1006 	mutex_unlock(&sysfs_mutex);
1007 	if ((filp->f_pos > 1) && !pos) { /* EOF */
1008 		filp->f_pos = INT_MAX;
1009 		filp->private_data = NULL;
1010 	}
1011 	return 0;
1012 }
1013 
1014 
1015 const struct file_operations sysfs_dir_operations = {
1016 	.read		= generic_read_dir,
1017 	.readdir	= sysfs_readdir,
1018 	.release	= sysfs_dir_release,
1019 	.llseek		= generic_file_llseek,
1020 };
1021