1 // SPDX-License-Identifier: GPL-2.0
3 * fs/sysfs/dir.c - sysfs core and dir operation implementation
5 * Copyright (c) 2001-3 Patrick Mochel
6 * Copyright (c) 2007 SUSE Linux Products GmbH
7 * Copyright (c) 2007 Tejun Heo <teheo@suse.de>
9 * Please see Documentation/filesystems/sysfs.rst for more information.
12 #define pr_fmt(fmt) "sysfs: " fmt
15 #include <linux/kobject.h>
16 #include <linux/slab.h>
19 DEFINE_SPINLOCK(sysfs_symlink_target_lock
);
21 void sysfs_warn_dup(struct kernfs_node
*parent
, const char *name
)
25 buf
= kzalloc(PATH_MAX
, GFP_KERNEL
);
27 kernfs_path(parent
, buf
, PATH_MAX
);
29 pr_warn("cannot create duplicate filename '%s/%s'\n", buf
, name
);
36 * sysfs_create_dir_ns - create a directory for an object with a namespace tag
37 * @kobj: object we're creating directory for
38 * @ns: the namespace tag to use
40 int sysfs_create_dir_ns(struct kobject
*kobj
, const void *ns
)
42 struct kernfs_node
*parent
, *kn
;
50 parent
= kobj
->parent
->sd
;
52 parent
= sysfs_root_kn
;
57 kobject_get_ownership(kobj
, &uid
, &gid
);
59 kn
= kernfs_create_dir_ns(parent
, kobject_name(kobj
),
60 S_IRWXU
| S_IRUGO
| S_IXUGO
, uid
, gid
,
63 if (PTR_ERR(kn
) == -EEXIST
)
64 sysfs_warn_dup(parent
, kobject_name(kobj
));
73 * sysfs_remove_dir - remove an object's directory.
76 * The only thing special about this is that we remove any files in
77 * the directory before we remove the directory, and we've inlined
78 * what used to be sysfs_rmdir() below, instead of calling separately.
80 void sysfs_remove_dir(struct kobject
*kobj
)
82 struct kernfs_node
*kn
= kobj
->sd
;
85 * In general, kboject owner is responsible for ensuring removal
86 * doesn't race with other operations and sysfs doesn't provide any
87 * protection; however, when @kobj is used as a symlink target, the
88 * symlinking entity usually doesn't own @kobj and thus has no
89 * control over removal. @kobj->sd may be removed anytime
90 * and symlink code may end up dereferencing an already freed node.
92 * sysfs_symlink_target_lock synchronizes @kobj->sd
93 * disassociation against symlink operations so that symlink code
94 * can safely dereference @kobj->sd.
96 spin_lock(&sysfs_symlink_target_lock
);
98 spin_unlock(&sysfs_symlink_target_lock
);
101 WARN_ON_ONCE(kernfs_type(kn
) != KERNFS_DIR
);
106 int sysfs_rename_dir_ns(struct kobject
*kobj
, const char *new_name
,
109 struct kernfs_node
*parent
;
112 parent
= kernfs_get_parent(kobj
->sd
);
113 ret
= kernfs_rename_ns(kobj
->sd
, parent
, new_name
, new_ns
);
118 int sysfs_move_dir_ns(struct kobject
*kobj
, struct kobject
*new_parent_kobj
,
121 struct kernfs_node
*kn
= kobj
->sd
;
122 struct kernfs_node
*new_parent
;
124 new_parent
= new_parent_kobj
&& new_parent_kobj
->sd
?
125 new_parent_kobj
->sd
: sysfs_root_kn
;
127 return kernfs_rename_ns(kn
, new_parent
, kn
->name
, new_ns
);
131 * sysfs_create_mount_point - create an always empty directory
132 * @parent_kobj: kobject that will contain this always empty directory
133 * @name: The name of the always empty directory to add
135 int sysfs_create_mount_point(struct kobject
*parent_kobj
, const char *name
)
137 struct kernfs_node
*kn
, *parent
= parent_kobj
->sd
;
139 kn
= kernfs_create_empty_dir(parent
, name
);
141 if (PTR_ERR(kn
) == -EEXIST
)
142 sysfs_warn_dup(parent
, name
);
148 EXPORT_SYMBOL_GPL(sysfs_create_mount_point
);
151 * sysfs_remove_mount_point - remove an always empty directory.
152 * @parent_kobj: kobject that will contain this always empty directory
153 * @name: The name of the always empty directory to remove
156 void sysfs_remove_mount_point(struct kobject
*parent_kobj
, const char *name
)
158 struct kernfs_node
*parent
= parent_kobj
->sd
;
160 kernfs_remove_by_name_ns(parent
, name
, NULL
);
162 EXPORT_SYMBOL_GPL(sysfs_remove_mount_point
);