]>
Commit | Line | Data |
---|---|---|
d9d16e16 | 1 | // SPDX-License-Identifier: GPL-2.0 |
1da177e4 LT |
2 | /* |
3 | * kobject.c - library routines for handling generic kernel objects | |
4 | * | |
5 | * Copyright (c) 2002-2003 Patrick Mochel <mochel@osdl.org> | |
f0e7e1bd GKH |
6 | * Copyright (c) 2006-2007 Greg Kroah-Hartman <greg@kroah.com> |
7 | * Copyright (c) 2006-2007 Novell Inc. | |
1da177e4 | 8 | * |
1da177e4 LT |
9 | * Please see the file Documentation/kobject.txt for critical information |
10 | * about using the kobject interface. | |
11 | */ | |
12 | ||
13 | #include <linux/kobject.h> | |
14 | #include <linux/string.h> | |
8bc3bcc9 | 15 | #include <linux/export.h> |
1da177e4 | 16 | #include <linux/stat.h> |
4e57b681 | 17 | #include <linux/slab.h> |
89c86a64 | 18 | #include <linux/random.h> |
1da177e4 | 19 | |
e34ff490 | 20 | /** |
ed856349 | 21 | * kobject_namespace() - Return @kobj's namespace tag. |
e34ff490 TH |
22 | * @kobj: kobject in question |
23 | * | |
24 | * Returns namespace tag of @kobj if its parent has namespace ops enabled | |
25 | * and thus @kobj should have a namespace tag associated with it. Returns | |
26 | * %NULL otherwise. | |
27 | */ | |
28 | const void *kobject_namespace(struct kobject *kobj) | |
29 | { | |
30 | const struct kobj_ns_type_operations *ns_ops = kobj_ns_ops(kobj); | |
31 | ||
32 | if (!ns_ops || ns_ops->type == KOBJ_NS_TYPE_NONE) | |
33 | return NULL; | |
34 | ||
a1212d27 | 35 | return kobj->ktype->namespace(kobj); |
e34ff490 TH |
36 | } |
37 | ||
5f81880d | 38 | /** |
ed856349 | 39 | * kobject_get_ownership() - Get sysfs ownership data for @kobj. |
5f81880d DT |
40 | * @kobj: kobject in question |
41 | * @uid: kernel user ID for sysfs objects | |
42 | * @gid: kernel group ID for sysfs objects | |
43 | * | |
44 | * Returns initial uid/gid pair that should be used when creating sysfs | |
45 | * representation of given kobject. Normally used to adjust ownership of | |
46 | * objects in a container. | |
47 | */ | |
48 | void kobject_get_ownership(struct kobject *kobj, kuid_t *uid, kgid_t *gid) | |
49 | { | |
50 | *uid = GLOBAL_ROOT_UID; | |
51 | *gid = GLOBAL_ROOT_GID; | |
52 | ||
53 | if (kobj->ktype->get_ownership) | |
54 | kobj->ktype->get_ownership(kobj, uid, gid); | |
55 | } | |
56 | ||
e374a2bf GKH |
57 | /* |
58 | * populate_dir - populate directory with attributes. | |
59 | * @kobj: object we're working on. | |
1da177e4 | 60 | * |
e374a2bf GKH |
61 | * Most subsystems have a set of default attributes that are associated |
62 | * with an object that registers with them. This is a helper called during | |
63 | * object registration that loops through the default attributes of the | |
64 | * subsystem and creates attributes files for them in sysfs. | |
1da177e4 | 65 | */ |
e374a2bf | 66 | static int populate_dir(struct kobject *kobj) |
1da177e4 | 67 | { |
e374a2bf GKH |
68 | struct kobj_type *t = get_ktype(kobj); |
69 | struct attribute *attr; | |
1da177e4 LT |
70 | int error = 0; |
71 | int i; | |
e374a2bf | 72 | |
1da177e4 LT |
73 | if (t && t->default_attrs) { |
74 | for (i = 0; (attr = t->default_attrs[i]) != NULL; i++) { | |
e374a2bf GKH |
75 | error = sysfs_create_file(kobj, attr); |
76 | if (error) | |
1da177e4 LT |
77 | break; |
78 | } | |
79 | } | |
80 | return error; | |
81 | } | |
82 | ||
e374a2bf | 83 | static int create_dir(struct kobject *kobj) |
1da177e4 | 84 | { |
aa30f47c | 85 | const struct kobj_type *ktype = get_ktype(kobj); |
c84a3b27 | 86 | const struct kobj_ns_type_operations *ops; |
e34ff490 TH |
87 | int error; |
88 | ||
89 | error = sysfs_create_dir_ns(kobj, kobject_namespace(kobj)); | |
c84a3b27 TH |
90 | if (error) |
91 | return error; | |
92 | ||
93 | error = populate_dir(kobj); | |
94 | if (error) { | |
95 | sysfs_remove_dir(kobj); | |
96 | return error; | |
1da177e4 | 97 | } |
26ea12de | 98 | |
aa30f47c KB |
99 | if (ktype) { |
100 | error = sysfs_create_groups(kobj, ktype->default_groups); | |
101 | if (error) { | |
102 | sysfs_remove_dir(kobj); | |
103 | return error; | |
104 | } | |
105 | } | |
106 | ||
26ea12de TH |
107 | /* |
108 | * @kobj->sd may be deleted by an ancestor going away. Hold an | |
109 | * extra reference so that it stays until @kobj is gone. | |
110 | */ | |
111 | sysfs_get(kobj->sd); | |
112 | ||
c84a3b27 TH |
113 | /* |
114 | * If @kobj has ns_ops, its children need to be filtered based on | |
115 | * their namespace tags. Enable namespace support on @kobj->sd. | |
116 | */ | |
117 | ops = kobj_child_ns_ops(kobj); | |
118 | if (ops) { | |
119 | BUG_ON(ops->type <= KOBJ_NS_TYPE_NONE); | |
120 | BUG_ON(ops->type >= KOBJ_NS_TYPES); | |
121 | BUG_ON(!kobj_ns_type_registered(ops->type)); | |
122 | ||
fa4cd451 | 123 | sysfs_enable_ns(kobj->sd); |
c84a3b27 TH |
124 | } |
125 | ||
126 | return 0; | |
1da177e4 LT |
127 | } |
128 | ||
1da177e4 LT |
129 | static int get_kobj_path_length(struct kobject *kobj) |
130 | { | |
131 | int length = 1; | |
e374a2bf | 132 | struct kobject *parent = kobj; |
1da177e4 | 133 | |
e374a2bf | 134 | /* walk up the ancestors until we hit the one pointing to the |
1da177e4 LT |
135 | * root. |
136 | * Add 1 to strlen for leading '/' of each level. | |
137 | */ | |
138 | do { | |
b365b3da CE |
139 | if (kobject_name(parent) == NULL) |
140 | return 0; | |
1da177e4 LT |
141 | length += strlen(kobject_name(parent)) + 1; |
142 | parent = parent->parent; | |
143 | } while (parent); | |
144 | return length; | |
145 | } | |
146 | ||
147 | static void fill_kobj_path(struct kobject *kobj, char *path, int length) | |
148 | { | |
e374a2bf | 149 | struct kobject *parent; |
1da177e4 LT |
150 | |
151 | --length; | |
152 | for (parent = kobj; parent; parent = parent->parent) { | |
153 | int cur = strlen(kobject_name(parent)); | |
154 | /* back up enough to print this name with '/' */ | |
155 | length -= cur; | |
77d2a24b | 156 | memcpy(path + length, kobject_name(parent), cur); |
1da177e4 LT |
157 | *(path + --length) = '/'; |
158 | } | |
159 | ||
9f66fa2a | 160 | pr_debug("kobject: '%s' (%p): %s: path = '%s'\n", kobject_name(kobj), |
810304db | 161 | kobj, __func__, path); |
1da177e4 LT |
162 | } |
163 | ||
164 | /** | |
8fd7c302 | 165 | * kobject_get_path() - Allocate memory and fill in the path for @kobj. |
1da177e4 LT |
166 | * @kobj: kobject in question, with which to build the path |
167 | * @gfp_mask: the allocation type used to allocate the path | |
72fd4a35 | 168 | * |
8fd7c302 | 169 | * Return: The newly allocated memory, caller must free with kfree(). |
1da177e4 | 170 | */ |
fd4f2df2 | 171 | char *kobject_get_path(struct kobject *kobj, gfp_t gfp_mask) |
1da177e4 LT |
172 | { |
173 | char *path; | |
174 | int len; | |
175 | ||
176 | len = get_kobj_path_length(kobj); | |
b365b3da CE |
177 | if (len == 0) |
178 | return NULL; | |
4668edc3 | 179 | path = kzalloc(len, gfp_mask); |
1da177e4 LT |
180 | if (!path) |
181 | return NULL; | |
1da177e4 LT |
182 | fill_kobj_path(kobj, path, len); |
183 | ||
184 | return path; | |
185 | } | |
80fc9f53 | 186 | EXPORT_SYMBOL_GPL(kobject_get_path); |
1da177e4 | 187 | |
0f4dafc0 KS |
188 | /* add the kobject to its kset's list */ |
189 | static void kobj_kset_join(struct kobject *kobj) | |
1da177e4 | 190 | { |
0f4dafc0 | 191 | if (!kobj->kset) |
31b9025a | 192 | return; |
0f4dafc0 KS |
193 | |
194 | kset_get(kobj->kset); | |
195 | spin_lock(&kobj->kset->list_lock); | |
196 | list_add_tail(&kobj->entry, &kobj->kset->list); | |
197 | spin_unlock(&kobj->kset->list_lock); | |
1da177e4 LT |
198 | } |
199 | ||
0f4dafc0 KS |
200 | /* remove the kobject from its kset's list */ |
201 | static void kobj_kset_leave(struct kobject *kobj) | |
202 | { | |
203 | if (!kobj->kset) | |
204 | return; | |
1da177e4 | 205 | |
0f4dafc0 KS |
206 | spin_lock(&kobj->kset->list_lock); |
207 | list_del_init(&kobj->entry); | |
208 | spin_unlock(&kobj->kset->list_lock); | |
209 | kset_put(kobj->kset); | |
210 | } | |
1da177e4 | 211 | |
e374a2bf | 212 | static void kobject_init_internal(struct kobject *kobj) |
1da177e4 | 213 | { |
0f4dafc0 KS |
214 | if (!kobj) |
215 | return; | |
216 | kref_init(&kobj->kref); | |
217 | INIT_LIST_HEAD(&kobj->entry); | |
a4573c48 GKH |
218 | kobj->state_in_sysfs = 0; |
219 | kobj->state_add_uevent_sent = 0; | |
220 | kobj->state_remove_uevent_sent = 0; | |
221 | kobj->state_initialized = 1; | |
1da177e4 LT |
222 | } |
223 | ||
0f4dafc0 | 224 | |
9e7bbccd | 225 | static int kobject_add_internal(struct kobject *kobj) |
1da177e4 LT |
226 | { |
227 | int error = 0; | |
e374a2bf | 228 | struct kobject *parent; |
1da177e4 | 229 | |
0f4dafc0 | 230 | if (!kobj) |
1da177e4 | 231 | return -ENOENT; |
0f4dafc0 | 232 | |
af5ca3f4 | 233 | if (!kobj->name || !kobj->name[0]) { |
82d1f117 AS |
234 | WARN(1, |
235 | "kobject: (%p): attempted to be registered with empty name!\n", | |
236 | kobj); | |
c171fef5 GKH |
237 | return -EINVAL; |
238 | } | |
1da177e4 | 239 | |
0f4dafc0 | 240 | parent = kobject_get(kobj->parent); |
1da177e4 | 241 | |
0f4dafc0 | 242 | /* join kset if set, use it as parent if we do not already have one */ |
1da177e4 | 243 | if (kobj->kset) { |
0f4dafc0 | 244 | if (!parent) |
1da177e4 | 245 | parent = kobject_get(&kobj->kset->kobj); |
0f4dafc0 | 246 | kobj_kset_join(kobj); |
460f7e9a | 247 | kobj->parent = parent; |
1da177e4 | 248 | } |
1da177e4 | 249 | |
0f4dafc0 | 250 | pr_debug("kobject: '%s' (%p): %s: parent: '%s', set: '%s'\n", |
810304db | 251 | kobject_name(kobj), kobj, __func__, |
0f4dafc0 | 252 | parent ? kobject_name(parent) : "<NULL>", |
e374a2bf | 253 | kobj->kset ? kobject_name(&kobj->kset->kobj) : "<NULL>"); |
0f4dafc0 | 254 | |
90bc6135 | 255 | error = create_dir(kobj); |
1da177e4 | 256 | if (error) { |
0f4dafc0 KS |
257 | kobj_kset_leave(kobj); |
258 | kobject_put(parent); | |
259 | kobj->parent = NULL; | |
dcd0da00 GKH |
260 | |
261 | /* be noisy on error issues */ | |
262 | if (error == -EEXIST) | |
3e14c6ab DV |
263 | pr_err("%s failed for %s with -EEXIST, don't try to register things with the same name in the same directory.\n", |
264 | __func__, kobject_name(kobj)); | |
dcd0da00 | 265 | else |
3e14c6ab DV |
266 | pr_err("%s failed for %s (error: %d parent: %s)\n", |
267 | __func__, kobject_name(kobj), error, | |
268 | parent ? kobject_name(parent) : "'none'"); | |
0f4dafc0 KS |
269 | } else |
270 | kobj->state_in_sysfs = 1; | |
1da177e4 LT |
271 | |
272 | return error; | |
273 | } | |
274 | ||
663a4743 | 275 | /** |
ed856349 | 276 | * kobject_set_name_vargs() - Set the name of a kobject. |
663a4743 GKH |
277 | * @kobj: struct kobject to set the name of |
278 | * @fmt: format string used to build the name | |
279 | * @vargs: vargs to format the string. | |
280 | */ | |
1fa5ae85 | 281 | int kobject_set_name_vargs(struct kobject *kobj, const char *fmt, |
663a4743 GKH |
282 | va_list vargs) |
283 | { | |
f773f32d | 284 | const char *s; |
663a4743 | 285 | |
8a577ffc KS |
286 | if (kobj->name && !fmt) |
287 | return 0; | |
288 | ||
f773f32d | 289 | s = kvasprintf_const(GFP_KERNEL, fmt, vargs); |
2abf114f | 290 | if (!s) |
a4ca6617 | 291 | return -ENOMEM; |
663a4743 | 292 | |
f773f32d RV |
293 | /* |
294 | * ewww... some of these buggers have '/' in the name ... If | |
295 | * that's the case, we need to make sure we have an actual | |
296 | * allocated copy to modify, since kvasprintf_const may have | |
297 | * returned something from .rodata. | |
298 | */ | |
299 | if (strchr(s, '/')) { | |
300 | char *t; | |
301 | ||
302 | t = kstrdup(s, GFP_KERNEL); | |
303 | kfree_const(s); | |
304 | if (!t) | |
305 | return -ENOMEM; | |
306 | strreplace(t, '/', '!'); | |
307 | s = t; | |
308 | } | |
309 | kfree_const(kobj->name); | |
2abf114f | 310 | kobj->name = s; |
9f255651 | 311 | |
663a4743 GKH |
312 | return 0; |
313 | } | |
1da177e4 LT |
314 | |
315 | /** | |
ed856349 | 316 | * kobject_set_name() - Set the name of a kobject. |
663a4743 | 317 | * @kobj: struct kobject to set the name of |
8c4606b1 | 318 | * @fmt: format string used to build the name |
1da177e4 | 319 | * |
8c4606b1 GKH |
320 | * This sets the name of the kobject. If you have already added the |
321 | * kobject to the system, you must call kobject_rename() in order to | |
322 | * change the name of the kobject. | |
1da177e4 | 323 | */ |
663a4743 | 324 | int kobject_set_name(struct kobject *kobj, const char *fmt, ...) |
1da177e4 | 325 | { |
a4ca6617 | 326 | va_list vargs; |
663a4743 | 327 | int retval; |
1da177e4 | 328 | |
a4ca6617 KS |
329 | va_start(vargs, fmt); |
330 | retval = kobject_set_name_vargs(kobj, fmt, vargs); | |
331 | va_end(vargs); | |
1da177e4 | 332 | |
663a4743 | 333 | return retval; |
1da177e4 | 334 | } |
1da177e4 LT |
335 | EXPORT_SYMBOL(kobject_set_name); |
336 | ||
e86000d0 | 337 | /** |
ed856349 | 338 | * kobject_init() - Initialize a kobject structure. |
e86000d0 GKH |
339 | * @kobj: pointer to the kobject to initialize |
340 | * @ktype: pointer to the ktype for this kobject. | |
341 | * | |
342 | * This function will properly initialize a kobject such that it can then | |
343 | * be passed to the kobject_add() call. | |
344 | * | |
345 | * After this function is called, the kobject MUST be cleaned up by a call | |
346 | * to kobject_put(), not by a call to kfree directly to ensure that all of | |
347 | * the memory is cleaned up properly. | |
348 | */ | |
f9cb074b | 349 | void kobject_init(struct kobject *kobj, struct kobj_type *ktype) |
e86000d0 GKH |
350 | { |
351 | char *err_str; | |
352 | ||
353 | if (!kobj) { | |
354 | err_str = "invalid kobject pointer!"; | |
355 | goto error; | |
356 | } | |
357 | if (!ktype) { | |
358 | err_str = "must have a ktype to be initialized properly!\n"; | |
359 | goto error; | |
360 | } | |
0f4dafc0 | 361 | if (kobj->state_initialized) { |
e86000d0 | 362 | /* do not error out as sometimes we can recover */ |
82d1f117 AS |
363 | pr_err("kobject (%p): tried to init an initialized object, something is seriously wrong.\n", |
364 | kobj); | |
e86000d0 GKH |
365 | dump_stack(); |
366 | } | |
367 | ||
a4573c48 | 368 | kobject_init_internal(kobj); |
e86000d0 GKH |
369 | kobj->ktype = ktype; |
370 | return; | |
371 | ||
372 | error: | |
82d1f117 | 373 | pr_err("kobject (%p): %s\n", kobj, err_str); |
e86000d0 GKH |
374 | dump_stack(); |
375 | } | |
f9cb074b | 376 | EXPORT_SYMBOL(kobject_init); |
e86000d0 | 377 | |
8db14860 NI |
378 | static __printf(3, 0) int kobject_add_varg(struct kobject *kobj, |
379 | struct kobject *parent, | |
380 | const char *fmt, va_list vargs) | |
244f6cee | 381 | { |
244f6cee GKH |
382 | int retval; |
383 | ||
a4ca6617 | 384 | retval = kobject_set_name_vargs(kobj, fmt, vargs); |
244f6cee | 385 | if (retval) { |
82d1f117 | 386 | pr_err("kobject: can not set name properly!\n"); |
244f6cee GKH |
387 | return retval; |
388 | } | |
389 | kobj->parent = parent; | |
9e7bbccd | 390 | return kobject_add_internal(kobj); |
244f6cee GKH |
391 | } |
392 | ||
393 | /** | |
ed856349 | 394 | * kobject_add() - The main kobject add function. |
244f6cee GKH |
395 | * @kobj: the kobject to add |
396 | * @parent: pointer to the parent of the kobject. | |
397 | * @fmt: format to name the kobject with. | |
398 | * | |
399 | * The kobject name is set and added to the kobject hierarchy in this | |
400 | * function. | |
401 | * | |
402 | * If @parent is set, then the parent of the @kobj will be set to it. | |
403 | * If @parent is NULL, then the parent of the @kobj will be set to the | |
9705710e | 404 | * kobject associated with the kset assigned to this kobject. If no kset |
244f6cee GKH |
405 | * is assigned to the kobject, then the kobject will be located in the |
406 | * root of the sysfs tree. | |
407 | * | |
0f4dafc0 | 408 | * Note, no "add" uevent will be created with this call, the caller should set |
244f6cee GKH |
409 | * up all of the necessary sysfs files for the object and then call |
410 | * kobject_uevent() with the UEVENT_ADD parameter to ensure that | |
411 | * userspace is properly notified of this kobject's creation. | |
92067f84 TH |
412 | * |
413 | * Return: If this function returns an error, kobject_put() must be | |
414 | * called to properly clean up the memory associated with the | |
415 | * object. Under no instance should the kobject that is passed | |
416 | * to this function be directly freed with a call to kfree(), | |
417 | * that can leak memory. | |
418 | * | |
70e16a62 GKH |
419 | * If this function returns success, kobject_put() must also be called |
420 | * in order to properly clean up the memory associated with the object. | |
421 | * | |
422 | * In short, once this function is called, kobject_put() MUST be called | |
423 | * when the use of the object is finished in order to properly free | |
424 | * everything. | |
244f6cee | 425 | */ |
b2d6db58 GKH |
426 | int kobject_add(struct kobject *kobj, struct kobject *parent, |
427 | const char *fmt, ...) | |
244f6cee GKH |
428 | { |
429 | va_list args; | |
430 | int retval; | |
431 | ||
432 | if (!kobj) | |
433 | return -EINVAL; | |
434 | ||
0f4dafc0 | 435 | if (!kobj->state_initialized) { |
82d1f117 | 436 | pr_err("kobject '%s' (%p): tried to add an uninitialized object, something is seriously wrong.\n", |
0f4dafc0 KS |
437 | kobject_name(kobj), kobj); |
438 | dump_stack(); | |
439 | return -EINVAL; | |
440 | } | |
244f6cee GKH |
441 | va_start(args, fmt); |
442 | retval = kobject_add_varg(kobj, parent, fmt, args); | |
443 | va_end(args); | |
444 | ||
445 | return retval; | |
446 | } | |
b2d6db58 | 447 | EXPORT_SYMBOL(kobject_add); |
244f6cee | 448 | |
c11c4154 | 449 | /** |
ed856349 TH |
450 | * kobject_init_and_add() - Initialize a kobject structure and add it to |
451 | * the kobject hierarchy. | |
c11c4154 GKH |
452 | * @kobj: pointer to the kobject to initialize |
453 | * @ktype: pointer to the ktype for this kobject. | |
454 | * @parent: pointer to the parent of this kobject. | |
455 | * @fmt: the name of the kobject. | |
456 | * | |
1fd7c3b4 TH |
457 | * This function combines the call to kobject_init() and kobject_add(). |
458 | * | |
459 | * If this function returns an error, kobject_put() must be called to | |
460 | * properly clean up the memory associated with the object. This is the | |
461 | * same type of error handling after a call to kobject_add() and kobject | |
462 | * lifetime rules are the same here. | |
c11c4154 GKH |
463 | */ |
464 | int kobject_init_and_add(struct kobject *kobj, struct kobj_type *ktype, | |
465 | struct kobject *parent, const char *fmt, ...) | |
466 | { | |
467 | va_list args; | |
468 | int retval; | |
469 | ||
f9cb074b | 470 | kobject_init(kobj, ktype); |
c11c4154 GKH |
471 | |
472 | va_start(args, fmt); | |
473 | retval = kobject_add_varg(kobj, parent, fmt, args); | |
474 | va_end(args); | |
475 | ||
476 | return retval; | |
477 | } | |
478 | EXPORT_SYMBOL_GPL(kobject_init_and_add); | |
479 | ||
1da177e4 | 480 | /** |
ed856349 | 481 | * kobject_rename() - Change the name of an object. |
e374a2bf GKH |
482 | * @kobj: object in question. |
483 | * @new_name: object's new name | |
030c1d2b EB |
484 | * |
485 | * It is the responsibility of the caller to provide mutual | |
486 | * exclusion between two different calls of kobject_rename | |
487 | * on the same kobject and to ensure that new_name is valid and | |
488 | * won't conflict with other kobjects. | |
1da177e4 | 489 | */ |
e374a2bf | 490 | int kobject_rename(struct kobject *kobj, const char *new_name) |
1da177e4 LT |
491 | { |
492 | int error = 0; | |
ca2f37db | 493 | const char *devpath = NULL; |
0b4a4fea | 494 | const char *dup_name = NULL, *name; |
ca2f37db JT |
495 | char *devpath_string = NULL; |
496 | char *envp[2]; | |
1da177e4 LT |
497 | |
498 | kobj = kobject_get(kobj); | |
499 | if (!kobj) | |
500 | return -EINVAL; | |
122f8ec7 LY |
501 | if (!kobj->parent) { |
502 | kobject_put(kobj); | |
b592fcfe | 503 | return -EINVAL; |
122f8ec7 | 504 | } |
ca2f37db JT |
505 | |
506 | devpath = kobject_get_path(kobj, GFP_KERNEL); | |
507 | if (!devpath) { | |
508 | error = -ENOMEM; | |
509 | goto out; | |
510 | } | |
511 | devpath_string = kmalloc(strlen(devpath) + 15, GFP_KERNEL); | |
512 | if (!devpath_string) { | |
513 | error = -ENOMEM; | |
514 | goto out; | |
515 | } | |
516 | sprintf(devpath_string, "DEVPATH_OLD=%s", devpath); | |
517 | envp[0] = devpath_string; | |
518 | envp[1] = NULL; | |
ca2f37db | 519 | |
f773f32d | 520 | name = dup_name = kstrdup_const(new_name, GFP_KERNEL); |
0b4a4fea EB |
521 | if (!name) { |
522 | error = -ENOMEM; | |
523 | goto out; | |
524 | } | |
525 | ||
e34ff490 | 526 | error = sysfs_rename_dir_ns(kobj, new_name, kobject_namespace(kobj)); |
0b4a4fea EB |
527 | if (error) |
528 | goto out; | |
529 | ||
530 | /* Install the new kobject name */ | |
531 | dup_name = kobj->name; | |
532 | kobj->name = name; | |
ca2f37db JT |
533 | |
534 | /* This function is mostly/only used for network interface. | |
535 | * Some hotplug package track interfaces by their name and | |
536 | * therefore want to know when the name is changed by the user. */ | |
0b4a4fea | 537 | kobject_uevent_env(kobj, KOBJ_MOVE, envp); |
ca2f37db JT |
538 | |
539 | out: | |
f773f32d | 540 | kfree_const(dup_name); |
ca2f37db JT |
541 | kfree(devpath_string); |
542 | kfree(devpath); | |
b592fcfe EB |
543 | kobject_put(kobj); |
544 | ||
545 | return error; | |
546 | } | |
8344b568 | 547 | EXPORT_SYMBOL_GPL(kobject_rename); |
b592fcfe | 548 | |
8a82472f | 549 | /** |
ed856349 | 550 | * kobject_move() - Move object to another parent. |
e374a2bf GKH |
551 | * @kobj: object in question. |
552 | * @new_parent: object's new parent (can be NULL) | |
8a82472f | 553 | */ |
8a82472f CH |
554 | int kobject_move(struct kobject *kobj, struct kobject *new_parent) |
555 | { | |
556 | int error; | |
557 | struct kobject *old_parent; | |
558 | const char *devpath = NULL; | |
559 | char *devpath_string = NULL; | |
560 | char *envp[2]; | |
561 | ||
562 | kobj = kobject_get(kobj); | |
563 | if (!kobj) | |
564 | return -EINVAL; | |
565 | new_parent = kobject_get(new_parent); | |
566 | if (!new_parent) { | |
c744aeae CH |
567 | if (kobj->kset) |
568 | new_parent = kobject_get(&kobj->kset->kobj); | |
8a82472f | 569 | } |
e34ff490 | 570 | |
8a82472f CH |
571 | /* old object path */ |
572 | devpath = kobject_get_path(kobj, GFP_KERNEL); | |
573 | if (!devpath) { | |
574 | error = -ENOMEM; | |
575 | goto out; | |
576 | } | |
577 | devpath_string = kmalloc(strlen(devpath) + 15, GFP_KERNEL); | |
578 | if (!devpath_string) { | |
579 | error = -ENOMEM; | |
580 | goto out; | |
581 | } | |
582 | sprintf(devpath_string, "DEVPATH_OLD=%s", devpath); | |
583 | envp[0] = devpath_string; | |
584 | envp[1] = NULL; | |
e34ff490 | 585 | error = sysfs_move_dir_ns(kobj, new_parent, kobject_namespace(kobj)); |
8a82472f CH |
586 | if (error) |
587 | goto out; | |
588 | old_parent = kobj->parent; | |
589 | kobj->parent = new_parent; | |
9e993efb | 590 | new_parent = NULL; |
8a82472f CH |
591 | kobject_put(old_parent); |
592 | kobject_uevent_env(kobj, KOBJ_MOVE, envp); | |
593 | out: | |
9e993efb | 594 | kobject_put(new_parent); |
8a82472f CH |
595 | kobject_put(kobj); |
596 | kfree(devpath_string); | |
597 | kfree(devpath); | |
598 | return error; | |
599 | } | |
24199d20 | 600 | EXPORT_SYMBOL_GPL(kobject_move); |
8a82472f | 601 | |
e4deac1f | 602 | static void __kobject_del(struct kobject *kobj) |
1da177e4 | 603 | { |
324a56e1 | 604 | struct kernfs_node *sd; |
3d378dc7 | 605 | const struct kobj_type *ktype; |
26ea12de | 606 | |
31b9025a GKH |
607 | if (!kobj) |
608 | return; | |
0f4dafc0 | 609 | |
26ea12de | 610 | sd = kobj->sd; |
3d378dc7 | 611 | ktype = get_ktype(kobj); |
aa30f47c KB |
612 | |
613 | if (ktype) | |
614 | sysfs_remove_groups(kobj, ktype->default_groups); | |
615 | ||
1da177e4 | 616 | sysfs_remove_dir(kobj); |
26ea12de TH |
617 | sysfs_put(sd); |
618 | ||
0f4dafc0 KS |
619 | kobj->state_in_sysfs = 0; |
620 | kobj_kset_leave(kobj); | |
0f4dafc0 | 621 | kobj->parent = NULL; |
1da177e4 | 622 | } |
e4deac1f HK |
623 | |
624 | /** | |
625 | * kobject_del() - Unlink kobject from hierarchy. | |
626 | * @kobj: object. | |
627 | * | |
628 | * This is the function that should be called to delete an object | |
629 | * successfully added via kobject_add(). | |
630 | */ | |
631 | void kobject_del(struct kobject *kobj) | |
632 | { | |
e1ba3254 AS |
633 | struct kobject *parent; |
634 | ||
635 | if (!kobj) | |
636 | return; | |
e4deac1f | 637 | |
e1ba3254 | 638 | parent = kobj->parent; |
e4deac1f HK |
639 | __kobject_del(kobj); |
640 | kobject_put(parent); | |
641 | } | |
fa40ae34 | 642 | EXPORT_SYMBOL(kobject_del); |
1da177e4 | 643 | |
1da177e4 | 644 | /** |
ed856349 | 645 | * kobject_get() - Increment refcount for object. |
e374a2bf | 646 | * @kobj: object. |
1da177e4 | 647 | */ |
e374a2bf | 648 | struct kobject *kobject_get(struct kobject *kobj) |
1da177e4 | 649 | { |
d82d54af EZ |
650 | if (kobj) { |
651 | if (!kobj->state_initialized) | |
82d1f117 AS |
652 | WARN(1, KERN_WARNING |
653 | "kobject: '%s' (%p): is not initialized, yet kobject_get() is being called.\n", | |
654 | kobject_name(kobj), kobj); | |
1da177e4 | 655 | kref_get(&kobj->kref); |
d82d54af | 656 | } |
1da177e4 LT |
657 | return kobj; |
658 | } | |
fa40ae34 | 659 | EXPORT_SYMBOL(kobject_get); |
1da177e4 | 660 | |
c70c176f | 661 | struct kobject * __must_check kobject_get_unless_zero(struct kobject *kobj) |
a49b7e82 | 662 | { |
c70c176f JK |
663 | if (!kobj) |
664 | return NULL; | |
a49b7e82 LT |
665 | if (!kref_get_unless_zero(&kobj->kref)) |
666 | kobj = NULL; | |
667 | return kobj; | |
668 | } | |
c70c176f | 669 | EXPORT_SYMBOL(kobject_get_unless_zero); |
a49b7e82 | 670 | |
18041f47 GKH |
671 | /* |
672 | * kobject_cleanup - free kobject resources. | |
673 | * @kobj: object to cleanup | |
1da177e4 | 674 | */ |
18041f47 | 675 | static void kobject_cleanup(struct kobject *kobj) |
1da177e4 | 676 | { |
e4deac1f | 677 | struct kobject *parent = kobj->parent; |
0f4dafc0 | 678 | struct kobj_type *t = get_ktype(kobj); |
af5ca3f4 | 679 | const char *name = kobj->name; |
1da177e4 | 680 | |
c817a67e RK |
681 | pr_debug("kobject: '%s' (%p): %s, parent %p\n", |
682 | kobject_name(kobj), kobj, __func__, kobj->parent); | |
0f4dafc0 KS |
683 | |
684 | if (t && !t->release) | |
186bddb2 | 685 | pr_debug("kobject: '%s' (%p): does not have a release() function, it is broken and must be fixed. See Documentation/kobject.txt.\n", |
0f4dafc0 KS |
686 | kobject_name(kobj), kobj); |
687 | ||
688 | /* send "remove" if the caller did not do it but sent "add" */ | |
689 | if (kobj->state_add_uevent_sent && !kobj->state_remove_uevent_sent) { | |
690 | pr_debug("kobject: '%s' (%p): auto cleanup 'remove' event\n", | |
691 | kobject_name(kobj), kobj); | |
692 | kobject_uevent(kobj, KOBJ_REMOVE); | |
693 | } | |
694 | ||
695 | /* remove from sysfs if the caller did not do it */ | |
696 | if (kobj->state_in_sysfs) { | |
697 | pr_debug("kobject: '%s' (%p): auto cleanup kobject_del\n", | |
698 | kobject_name(kobj), kobj); | |
e4deac1f HK |
699 | __kobject_del(kobj); |
700 | } else { | |
701 | /* avoid dropping the parent reference unnecessarily */ | |
702 | parent = NULL; | |
0f4dafc0 KS |
703 | } |
704 | ||
ce2c9cb0 | 705 | if (t && t->release) { |
0f4dafc0 KS |
706 | pr_debug("kobject: '%s' (%p): calling ktype release\n", |
707 | kobject_name(kobj), kobj); | |
1da177e4 | 708 | t->release(kobj); |
0f4dafc0 KS |
709 | } |
710 | ||
711 | /* free name if we allocated it */ | |
af5ca3f4 | 712 | if (name) { |
0f4dafc0 | 713 | pr_debug("kobject: '%s': free name\n", name); |
f773f32d | 714 | kfree_const(name); |
ce2c9cb0 | 715 | } |
e4deac1f HK |
716 | |
717 | kobject_put(parent); | |
1da177e4 LT |
718 | } |
719 | ||
c817a67e RK |
720 | #ifdef CONFIG_DEBUG_KOBJECT_RELEASE |
721 | static void kobject_delayed_cleanup(struct work_struct *work) | |
722 | { | |
723 | kobject_cleanup(container_of(to_delayed_work(work), | |
724 | struct kobject, release)); | |
725 | } | |
726 | #endif | |
727 | ||
1da177e4 LT |
728 | static void kobject_release(struct kref *kref) |
729 | { | |
c817a67e RK |
730 | struct kobject *kobj = container_of(kref, struct kobject, kref); |
731 | #ifdef CONFIG_DEBUG_KOBJECT_RELEASE | |
89c86a64 BH |
732 | unsigned long delay = HZ + HZ * (get_random_int() & 0x3); |
733 | pr_info("kobject: '%s' (%p): %s, parent %p (delayed %ld)\n", | |
734 | kobject_name(kobj), kobj, __func__, kobj->parent, delay); | |
c817a67e | 735 | INIT_DELAYED_WORK(&kobj->release, kobject_delayed_cleanup); |
89c86a64 BH |
736 | |
737 | schedule_delayed_work(&kobj->release, delay); | |
c817a67e RK |
738 | #else |
739 | kobject_cleanup(kobj); | |
740 | #endif | |
1da177e4 LT |
741 | } |
742 | ||
743 | /** | |
ed856349 | 744 | * kobject_put() - Decrement refcount for object. |
e374a2bf | 745 | * @kobj: object. |
1da177e4 | 746 | * |
e374a2bf | 747 | * Decrement the refcount, and if 0, call kobject_cleanup(). |
1da177e4 | 748 | */ |
e374a2bf | 749 | void kobject_put(struct kobject *kobj) |
1da177e4 | 750 | { |
c1ebdae5 | 751 | if (kobj) { |
d955c78a | 752 | if (!kobj->state_initialized) |
82d1f117 AS |
753 | WARN(1, KERN_WARNING |
754 | "kobject: '%s' (%p): is not initialized, yet kobject_put() is being called.\n", | |
755 | kobject_name(kobj), kobj); | |
1da177e4 | 756 | kref_put(&kobj->kref, kobject_release); |
c1ebdae5 | 757 | } |
1da177e4 | 758 | } |
fa40ae34 | 759 | EXPORT_SYMBOL(kobject_put); |
1da177e4 | 760 | |
3f9e3ee9 | 761 | static void dynamic_kobj_release(struct kobject *kobj) |
7423172a | 762 | { |
810304db | 763 | pr_debug("kobject: (%p): %s\n", kobj, __func__); |
7423172a JN |
764 | kfree(kobj); |
765 | } | |
766 | ||
3f9e3ee9 | 767 | static struct kobj_type dynamic_kobj_ktype = { |
386f275f KS |
768 | .release = dynamic_kobj_release, |
769 | .sysfs_ops = &kobj_sysfs_ops, | |
7423172a JN |
770 | }; |
771 | ||
43968d2f | 772 | /** |
ed856349 | 773 | * kobject_create() - Create a struct kobject dynamically. |
3f9e3ee9 GKH |
774 | * |
775 | * This function creates a kobject structure dynamically and sets it up | |
776 | * to be a "dynamic" kobject with a default release function set up. | |
777 | * | |
778 | * If the kobject was not able to be created, NULL will be returned. | |
43968d2f | 779 | * The kobject structure returned from here must be cleaned up with a |
f9cb074b | 780 | * call to kobject_put() and not kfree(), as kobject_init() has |
43968d2f | 781 | * already been called on this structure. |
3f9e3ee9 | 782 | */ |
43968d2f | 783 | struct kobject *kobject_create(void) |
3f9e3ee9 GKH |
784 | { |
785 | struct kobject *kobj; | |
786 | ||
787 | kobj = kzalloc(sizeof(*kobj), GFP_KERNEL); | |
788 | if (!kobj) | |
789 | return NULL; | |
790 | ||
f9cb074b | 791 | kobject_init(kobj, &dynamic_kobj_ktype); |
3f9e3ee9 GKH |
792 | return kobj; |
793 | } | |
794 | ||
795 | /** | |
ed856349 TH |
796 | * kobject_create_and_add() - Create a struct kobject dynamically and |
797 | * register it with sysfs. | |
9ff1f838 | 798 | * @name: the name for the kobject |
3f9e3ee9 GKH |
799 | * @parent: the parent kobject of this kobject, if any. |
800 | * | |
f70701a3 | 801 | * This function creates a kobject structure dynamically and registers it |
3f9e3ee9 | 802 | * with sysfs. When you are finished with this structure, call |
78a2d906 | 803 | * kobject_put() and the structure will be dynamically freed when |
3f9e3ee9 GKH |
804 | * it is no longer being used. |
805 | * | |
806 | * If the kobject was not able to be created, NULL will be returned. | |
807 | */ | |
808 | struct kobject *kobject_create_and_add(const char *name, struct kobject *parent) | |
809 | { | |
810 | struct kobject *kobj; | |
811 | int retval; | |
812 | ||
813 | kobj = kobject_create(); | |
814 | if (!kobj) | |
815 | return NULL; | |
816 | ||
b2d6db58 | 817 | retval = kobject_add(kobj, parent, "%s", name); |
3f9e3ee9 | 818 | if (retval) { |
82d1f117 | 819 | pr_warn("%s: kobject_add error: %d\n", __func__, retval); |
3f9e3ee9 GKH |
820 | kobject_put(kobj); |
821 | kobj = NULL; | |
822 | } | |
823 | return kobj; | |
824 | } | |
825 | EXPORT_SYMBOL_GPL(kobject_create_and_add); | |
826 | ||
1da177e4 | 827 | /** |
ed856349 | 828 | * kset_init() - Initialize a kset for use. |
e374a2bf | 829 | * @k: kset |
1da177e4 | 830 | */ |
e374a2bf | 831 | void kset_init(struct kset *k) |
1da177e4 | 832 | { |
e1543ddf | 833 | kobject_init_internal(&k->kobj); |
1da177e4 LT |
834 | INIT_LIST_HEAD(&k->list); |
835 | spin_lock_init(&k->list_lock); | |
836 | } | |
837 | ||
23b5212c KS |
838 | /* default kobject attribute operations */ |
839 | static ssize_t kobj_attr_show(struct kobject *kobj, struct attribute *attr, | |
840 | char *buf) | |
841 | { | |
842 | struct kobj_attribute *kattr; | |
843 | ssize_t ret = -EIO; | |
844 | ||
845 | kattr = container_of(attr, struct kobj_attribute, attr); | |
846 | if (kattr->show) | |
847 | ret = kattr->show(kobj, kattr, buf); | |
848 | return ret; | |
849 | } | |
850 | ||
851 | static ssize_t kobj_attr_store(struct kobject *kobj, struct attribute *attr, | |
852 | const char *buf, size_t count) | |
853 | { | |
854 | struct kobj_attribute *kattr; | |
855 | ssize_t ret = -EIO; | |
856 | ||
857 | kattr = container_of(attr, struct kobj_attribute, attr); | |
858 | if (kattr->store) | |
859 | ret = kattr->store(kobj, kattr, buf, count); | |
860 | return ret; | |
861 | } | |
862 | ||
52cf25d0 | 863 | const struct sysfs_ops kobj_sysfs_ops = { |
23b5212c KS |
864 | .show = kobj_attr_show, |
865 | .store = kobj_attr_store, | |
866 | }; | |
29dfe2dc | 867 | EXPORT_SYMBOL_GPL(kobj_sysfs_ops); |
1da177e4 | 868 | |
1da177e4 | 869 | /** |
ed856349 | 870 | * kset_register() - Initialize and add a kset. |
e374a2bf | 871 | * @k: kset. |
1da177e4 | 872 | */ |
e374a2bf | 873 | int kset_register(struct kset *k) |
1da177e4 | 874 | { |
80f03e34 KS |
875 | int err; |
876 | ||
31b9025a GKH |
877 | if (!k) |
878 | return -EINVAL; | |
80f03e34 | 879 | |
1da177e4 | 880 | kset_init(k); |
12e339ac | 881 | err = kobject_add_internal(&k->kobj); |
80f03e34 KS |
882 | if (err) |
883 | return err; | |
884 | kobject_uevent(&k->kobj, KOBJ_ADD); | |
885 | return 0; | |
1da177e4 | 886 | } |
fa40ae34 | 887 | EXPORT_SYMBOL(kset_register); |
1da177e4 | 888 | |
1da177e4 | 889 | /** |
ed856349 | 890 | * kset_unregister() - Remove a kset. |
e374a2bf | 891 | * @k: kset. |
1da177e4 | 892 | */ |
e374a2bf | 893 | void kset_unregister(struct kset *k) |
1da177e4 | 894 | { |
31b9025a GKH |
895 | if (!k) |
896 | return; | |
35a5fe69 | 897 | kobject_del(&k->kobj); |
78a2d906 | 898 | kobject_put(&k->kobj); |
1da177e4 | 899 | } |
fa40ae34 | 900 | EXPORT_SYMBOL(kset_unregister); |
1da177e4 | 901 | |
1da177e4 | 902 | /** |
ed856349 | 903 | * kset_find_obj() - Search for object in kset. |
e374a2bf GKH |
904 | * @kset: kset we're looking in. |
905 | * @name: object's name. | |
1da177e4 | 906 | * |
e374a2bf GKH |
907 | * Lock kset via @kset->subsys, and iterate over @kset->list, |
908 | * looking for a matching kobject. If matching object is found | |
909 | * take a reference and return the object. | |
1da177e4 | 910 | */ |
e374a2bf | 911 | struct kobject *kset_find_obj(struct kset *kset, const char *name) |
1da177e4 | 912 | { |
c6a2a3dc | 913 | struct kobject *k; |
e374a2bf | 914 | struct kobject *ret = NULL; |
1da177e4 LT |
915 | |
916 | spin_lock(&kset->list_lock); | |
c25d1dfb | 917 | |
c6a2a3dc | 918 | list_for_each_entry(k, &kset->list, entry) { |
e374a2bf | 919 | if (kobject_name(k) && !strcmp(kobject_name(k), name)) { |
a49b7e82 | 920 | ret = kobject_get_unless_zero(k); |
1da177e4 LT |
921 | break; |
922 | } | |
923 | } | |
c25d1dfb | 924 | |
1da177e4 LT |
925 | spin_unlock(&kset->list_lock); |
926 | return ret; | |
927 | } | |
2fe829ac | 928 | EXPORT_SYMBOL_GPL(kset_find_obj); |
1da177e4 | 929 | |
b727c702 GKH |
930 | static void kset_release(struct kobject *kobj) |
931 | { | |
932 | struct kset *kset = container_of(kobj, struct kset, kobj); | |
9f66fa2a | 933 | pr_debug("kobject: '%s' (%p): %s\n", |
810304db | 934 | kobject_name(kobj), kobj, __func__); |
b727c702 GKH |
935 | kfree(kset); |
936 | } | |
937 | ||
7ab35a14 | 938 | static void kset_get_ownership(struct kobject *kobj, kuid_t *uid, kgid_t *gid) |
d028b6f7 DT |
939 | { |
940 | if (kobj->parent) | |
941 | kobject_get_ownership(kobj->parent, uid, gid); | |
942 | } | |
943 | ||
386f275f KS |
944 | static struct kobj_type kset_ktype = { |
945 | .sysfs_ops = &kobj_sysfs_ops, | |
d028b6f7 DT |
946 | .release = kset_release, |
947 | .get_ownership = kset_get_ownership, | |
b727c702 GKH |
948 | }; |
949 | ||
950 | /** | |
ed856349 | 951 | * kset_create() - Create a struct kset dynamically. |
b727c702 GKH |
952 | * |
953 | * @name: the name for the kset | |
954 | * @uevent_ops: a struct kset_uevent_ops for the kset | |
955 | * @parent_kobj: the parent kobject of this kset, if any. | |
956 | * | |
957 | * This function creates a kset structure dynamically. This structure can | |
958 | * then be registered with the system and show up in sysfs with a call to | |
959 | * kset_register(). When you are finished with this structure, if | |
960 | * kset_register() has been called, call kset_unregister() and the | |
961 | * structure will be dynamically freed when it is no longer being used. | |
962 | * | |
963 | * If the kset was not able to be created, NULL will be returned. | |
964 | */ | |
965 | static struct kset *kset_create(const char *name, | |
9cd43611 | 966 | const struct kset_uevent_ops *uevent_ops, |
b727c702 GKH |
967 | struct kobject *parent_kobj) |
968 | { | |
969 | struct kset *kset; | |
d9cd8f37 | 970 | int retval; |
b727c702 GKH |
971 | |
972 | kset = kzalloc(sizeof(*kset), GFP_KERNEL); | |
973 | if (!kset) | |
974 | return NULL; | |
b7165ebb | 975 | retval = kobject_set_name(&kset->kobj, "%s", name); |
d9cd8f37 DY |
976 | if (retval) { |
977 | kfree(kset); | |
978 | return NULL; | |
979 | } | |
b727c702 GKH |
980 | kset->uevent_ops = uevent_ops; |
981 | kset->kobj.parent = parent_kobj; | |
982 | ||
983 | /* | |
386f275f | 984 | * The kobject of this kset will have a type of kset_ktype and belong to |
b727c702 GKH |
985 | * no kset itself. That way we can properly free it when it is |
986 | * finished being used. | |
987 | */ | |
386f275f | 988 | kset->kobj.ktype = &kset_ktype; |
b727c702 GKH |
989 | kset->kobj.kset = NULL; |
990 | ||
991 | return kset; | |
992 | } | |
993 | ||
994 | /** | |
ed856349 | 995 | * kset_create_and_add() - Create a struct kset dynamically and add it to sysfs. |
b727c702 GKH |
996 | * |
997 | * @name: the name for the kset | |
998 | * @uevent_ops: a struct kset_uevent_ops for the kset | |
999 | * @parent_kobj: the parent kobject of this kset, if any. | |
1000 | * | |
1001 | * This function creates a kset structure dynamically and registers it | |
1002 | * with sysfs. When you are finished with this structure, call | |
1003 | * kset_unregister() and the structure will be dynamically freed when it | |
1004 | * is no longer being used. | |
1005 | * | |
1006 | * If the kset was not able to be created, NULL will be returned. | |
1007 | */ | |
1008 | struct kset *kset_create_and_add(const char *name, | |
9cd43611 | 1009 | const struct kset_uevent_ops *uevent_ops, |
b727c702 GKH |
1010 | struct kobject *parent_kobj) |
1011 | { | |
1012 | struct kset *kset; | |
1013 | int error; | |
1014 | ||
1015 | kset = kset_create(name, uevent_ops, parent_kobj); | |
1016 | if (!kset) | |
1017 | return NULL; | |
1018 | error = kset_register(kset); | |
1019 | if (error) { | |
1020 | kfree(kset); | |
1021 | return NULL; | |
1022 | } | |
1023 | return kset; | |
1024 | } | |
1025 | EXPORT_SYMBOL_GPL(kset_create_and_add); | |
1026 | ||
bc451f20 EB |
1027 | |
1028 | static DEFINE_SPINLOCK(kobj_ns_type_lock); | |
1029 | static const struct kobj_ns_type_operations *kobj_ns_ops_tbl[KOBJ_NS_TYPES]; | |
1030 | ||
1031 | int kobj_ns_type_register(const struct kobj_ns_type_operations *ops) | |
1032 | { | |
1033 | enum kobj_ns_type type = ops->type; | |
1034 | int error; | |
1035 | ||
1036 | spin_lock(&kobj_ns_type_lock); | |
1037 | ||
1038 | error = -EINVAL; | |
1039 | if (type >= KOBJ_NS_TYPES) | |
1040 | goto out; | |
1041 | ||
1042 | error = -EINVAL; | |
1043 | if (type <= KOBJ_NS_TYPE_NONE) | |
1044 | goto out; | |
1045 | ||
1046 | error = -EBUSY; | |
1047 | if (kobj_ns_ops_tbl[type]) | |
1048 | goto out; | |
1049 | ||
1050 | error = 0; | |
1051 | kobj_ns_ops_tbl[type] = ops; | |
1052 | ||
1053 | out: | |
1054 | spin_unlock(&kobj_ns_type_lock); | |
1055 | return error; | |
1056 | } | |
1057 | ||
1058 | int kobj_ns_type_registered(enum kobj_ns_type type) | |
1059 | { | |
1060 | int registered = 0; | |
1061 | ||
1062 | spin_lock(&kobj_ns_type_lock); | |
1063 | if ((type > KOBJ_NS_TYPE_NONE) && (type < KOBJ_NS_TYPES)) | |
1064 | registered = kobj_ns_ops_tbl[type] != NULL; | |
1065 | spin_unlock(&kobj_ns_type_lock); | |
1066 | ||
1067 | return registered; | |
1068 | } | |
1069 | ||
1070 | const struct kobj_ns_type_operations *kobj_child_ns_ops(struct kobject *parent) | |
1071 | { | |
1072 | const struct kobj_ns_type_operations *ops = NULL; | |
1073 | ||
41fb96a4 | 1074 | if (parent && parent->ktype && parent->ktype->child_ns_type) |
bc451f20 EB |
1075 | ops = parent->ktype->child_ns_type(parent); |
1076 | ||
1077 | return ops; | |
1078 | } | |
1079 | ||
1080 | const struct kobj_ns_type_operations *kobj_ns_ops(struct kobject *kobj) | |
1081 | { | |
1082 | return kobj_child_ns_ops(kobj->parent); | |
1083 | } | |
1084 | ||
7dc5dbc8 EB |
1085 | bool kobj_ns_current_may_mount(enum kobj_ns_type type) |
1086 | { | |
730d7d33 | 1087 | bool may_mount = true; |
7dc5dbc8 EB |
1088 | |
1089 | spin_lock(&kobj_ns_type_lock); | |
1090 | if ((type > KOBJ_NS_TYPE_NONE) && (type < KOBJ_NS_TYPES) && | |
1091 | kobj_ns_ops_tbl[type]) | |
1092 | may_mount = kobj_ns_ops_tbl[type]->current_may_mount(); | |
1093 | spin_unlock(&kobj_ns_type_lock); | |
1094 | ||
1095 | return may_mount; | |
1096 | } | |
bc451f20 | 1097 | |
a685e089 | 1098 | void *kobj_ns_grab_current(enum kobj_ns_type type) |
bc451f20 | 1099 | { |
a685e089 | 1100 | void *ns = NULL; |
bc451f20 EB |
1101 | |
1102 | spin_lock(&kobj_ns_type_lock); | |
1103 | if ((type > KOBJ_NS_TYPE_NONE) && (type < KOBJ_NS_TYPES) && | |
1104 | kobj_ns_ops_tbl[type]) | |
a685e089 | 1105 | ns = kobj_ns_ops_tbl[type]->grab_current_ns(); |
bc451f20 EB |
1106 | spin_unlock(&kobj_ns_type_lock); |
1107 | ||
1108 | return ns; | |
1109 | } | |
172856ea | 1110 | EXPORT_SYMBOL_GPL(kobj_ns_grab_current); |
bc451f20 EB |
1111 | |
1112 | const void *kobj_ns_netlink(enum kobj_ns_type type, struct sock *sk) | |
1113 | { | |
1114 | const void *ns = NULL; | |
1115 | ||
1116 | spin_lock(&kobj_ns_type_lock); | |
1117 | if ((type > KOBJ_NS_TYPE_NONE) && (type < KOBJ_NS_TYPES) && | |
1118 | kobj_ns_ops_tbl[type]) | |
1119 | ns = kobj_ns_ops_tbl[type]->netlink_ns(sk); | |
1120 | spin_unlock(&kobj_ns_type_lock); | |
1121 | ||
1122 | return ns; | |
1123 | } | |
1124 | ||
1125 | const void *kobj_ns_initial(enum kobj_ns_type type) | |
1126 | { | |
1127 | const void *ns = NULL; | |
1128 | ||
1129 | spin_lock(&kobj_ns_type_lock); | |
1130 | if ((type > KOBJ_NS_TYPE_NONE) && (type < KOBJ_NS_TYPES) && | |
1131 | kobj_ns_ops_tbl[type]) | |
1132 | ns = kobj_ns_ops_tbl[type]->initial_ns(); | |
1133 | spin_unlock(&kobj_ns_type_lock); | |
1134 | ||
1135 | return ns; | |
1136 | } | |
1137 | ||
a685e089 | 1138 | void kobj_ns_drop(enum kobj_ns_type type, void *ns) |
bc451f20 | 1139 | { |
a685e089 AV |
1140 | spin_lock(&kobj_ns_type_lock); |
1141 | if ((type > KOBJ_NS_TYPE_NONE) && (type < KOBJ_NS_TYPES) && | |
1142 | kobj_ns_ops_tbl[type] && kobj_ns_ops_tbl[type]->drop_ns) | |
1143 | kobj_ns_ops_tbl[type]->drop_ns(ns); | |
1144 | spin_unlock(&kobj_ns_type_lock); | |
bc451f20 | 1145 | } |
172856ea | 1146 | EXPORT_SYMBOL_GPL(kobj_ns_drop); |