2 * kobject.c - library routines for handling generic kernel objects
4 * Copyright (c) 2002-2003 Patrick Mochel <mochel@osdl.org>
5 * Copyright (c) 2006-2007 Greg Kroah-Hartman <greg@kroah.com>
6 * Copyright (c) 2006-2007 Novell Inc.
8 * This file is released under the GPLv2.
11 * Please see the file Documentation/kobject.txt for critical information
12 * about using the kobject interface.
15 #include <linux/kobject.h>
16 #include <linux/kobj_completion.h>
17 #include <linux/string.h>
18 #include <linux/export.h>
19 #include <linux/stat.h>
20 #include <linux/slab.h>
21 #include <linux/random.h>
24 * kobject_namespace - return @kobj's namespace tag
25 * @kobj: kobject in question
27 * Returns namespace tag of @kobj if its parent has namespace ops enabled
28 * and thus @kobj should have a namespace tag associated with it. Returns
31 const void *kobject_namespace(struct kobject
*kobj
)
33 const struct kobj_ns_type_operations
*ns_ops
= kobj_ns_ops(kobj
);
35 if (!ns_ops
|| ns_ops
->type
== KOBJ_NS_TYPE_NONE
)
38 return kobj
->ktype
->namespace(kobj
);
42 * populate_dir - populate directory with attributes.
43 * @kobj: object we're working on.
45 * Most subsystems have a set of default attributes that are associated
46 * with an object that registers with them. This is a helper called during
47 * object registration that loops through the default attributes of the
48 * subsystem and creates attributes files for them in sysfs.
50 static int populate_dir(struct kobject
*kobj
)
52 struct kobj_type
*t
= get_ktype(kobj
);
53 struct attribute
*attr
;
57 if (t
&& t
->default_attrs
) {
58 for (i
= 0; (attr
= t
->default_attrs
[i
]) != NULL
; i
++) {
59 error
= sysfs_create_file(kobj
, attr
);
67 static int create_dir(struct kobject
*kobj
)
69 const struct kobj_ns_type_operations
*ops
;
72 error
= sysfs_create_dir_ns(kobj
, kobject_namespace(kobj
));
76 error
= populate_dir(kobj
);
78 sysfs_remove_dir(kobj
);
83 * @kobj->sd may be deleted by an ancestor going away. Hold an
84 * extra reference so that it stays until @kobj is gone.
89 * If @kobj has ns_ops, its children need to be filtered based on
90 * their namespace tags. Enable namespace support on @kobj->sd.
92 ops
= kobj_child_ns_ops(kobj
);
94 BUG_ON(ops
->type
<= KOBJ_NS_TYPE_NONE
);
95 BUG_ON(ops
->type
>= KOBJ_NS_TYPES
);
96 BUG_ON(!kobj_ns_type_registered(ops
->type
));
98 kernfs_enable_ns(kobj
->sd
);
104 static int get_kobj_path_length(struct kobject
*kobj
)
107 struct kobject
*parent
= kobj
;
109 /* walk up the ancestors until we hit the one pointing to the
111 * Add 1 to strlen for leading '/' of each level.
114 if (kobject_name(parent
) == NULL
)
116 length
+= strlen(kobject_name(parent
)) + 1;
117 parent
= parent
->parent
;
122 static void fill_kobj_path(struct kobject
*kobj
, char *path
, int length
)
124 struct kobject
*parent
;
127 for (parent
= kobj
; parent
; parent
= parent
->parent
) {
128 int cur
= strlen(kobject_name(parent
));
129 /* back up enough to print this name with '/' */
131 strncpy(path
+ length
, kobject_name(parent
), cur
);
132 *(path
+ --length
) = '/';
135 pr_debug("kobject: '%s' (%p): %s: path = '%s'\n", kobject_name(kobj
),
136 kobj
, __func__
, path
);
140 * kobject_get_path - generate and return the path associated with a given kobj and kset pair.
142 * @kobj: kobject in question, with which to build the path
143 * @gfp_mask: the allocation type used to allocate the path
145 * The result must be freed by the caller with kfree().
147 char *kobject_get_path(struct kobject
*kobj
, gfp_t gfp_mask
)
152 len
= get_kobj_path_length(kobj
);
155 path
= kzalloc(len
, gfp_mask
);
158 fill_kobj_path(kobj
, path
, len
);
162 EXPORT_SYMBOL_GPL(kobject_get_path
);
164 /* add the kobject to its kset's list */
165 static void kobj_kset_join(struct kobject
*kobj
)
170 kset_get(kobj
->kset
);
171 spin_lock(&kobj
->kset
->list_lock
);
172 list_add_tail(&kobj
->entry
, &kobj
->kset
->list
);
173 spin_unlock(&kobj
->kset
->list_lock
);
176 /* remove the kobject from its kset's list */
177 static void kobj_kset_leave(struct kobject
*kobj
)
182 spin_lock(&kobj
->kset
->list_lock
);
183 list_del_init(&kobj
->entry
);
184 spin_unlock(&kobj
->kset
->list_lock
);
185 kset_put(kobj
->kset
);
188 static void kobject_init_internal(struct kobject
*kobj
)
192 kref_init(&kobj
->kref
);
193 INIT_LIST_HEAD(&kobj
->entry
);
194 kobj
->state_in_sysfs
= 0;
195 kobj
->state_add_uevent_sent
= 0;
196 kobj
->state_remove_uevent_sent
= 0;
197 kobj
->state_initialized
= 1;
201 static int kobject_add_internal(struct kobject
*kobj
)
204 struct kobject
*parent
;
209 if (!kobj
->name
|| !kobj
->name
[0]) {
210 WARN(1, "kobject: (%p): attempted to be registered with empty "
215 parent
= kobject_get(kobj
->parent
);
217 /* join kset if set, use it as parent if we do not already have one */
220 parent
= kobject_get(&kobj
->kset
->kobj
);
221 kobj_kset_join(kobj
);
222 kobj
->parent
= parent
;
225 pr_debug("kobject: '%s' (%p): %s: parent: '%s', set: '%s'\n",
226 kobject_name(kobj
), kobj
, __func__
,
227 parent
? kobject_name(parent
) : "<NULL>",
228 kobj
->kset
? kobject_name(&kobj
->kset
->kobj
) : "<NULL>");
230 error
= create_dir(kobj
);
232 kobj_kset_leave(kobj
);
236 /* be noisy on error issues */
237 if (error
== -EEXIST
)
238 WARN(1, "%s failed for %s with "
239 "-EEXIST, don't try to register things with "
240 "the same name in the same directory.\n",
241 __func__
, kobject_name(kobj
));
243 WARN(1, "%s failed for %s (error: %d parent: %s)\n",
244 __func__
, kobject_name(kobj
), error
,
245 parent
? kobject_name(parent
) : "'none'");
247 kobj
->state_in_sysfs
= 1;
253 * kobject_set_name_vargs - Set the name of an kobject
254 * @kobj: struct kobject to set the name of
255 * @fmt: format string used to build the name
256 * @vargs: vargs to format the string.
258 int kobject_set_name_vargs(struct kobject
*kobj
, const char *fmt
,
261 const char *old_name
= kobj
->name
;
264 if (kobj
->name
&& !fmt
)
267 kobj
->name
= kvasprintf(GFP_KERNEL
, fmt
, vargs
);
271 /* ewww... some of these buggers have '/' in the name ... */
272 while ((s
= strchr(kobj
->name
, '/')))
280 * kobject_set_name - Set the name of a kobject
281 * @kobj: struct kobject to set the name of
282 * @fmt: format string used to build the name
284 * This sets the name of the kobject. If you have already added the
285 * kobject to the system, you must call kobject_rename() in order to
286 * change the name of the kobject.
288 int kobject_set_name(struct kobject
*kobj
, const char *fmt
, ...)
293 va_start(vargs
, fmt
);
294 retval
= kobject_set_name_vargs(kobj
, fmt
, vargs
);
299 EXPORT_SYMBOL(kobject_set_name
);
302 * kobject_init - initialize a kobject structure
303 * @kobj: pointer to the kobject to initialize
304 * @ktype: pointer to the ktype for this kobject.
306 * This function will properly initialize a kobject such that it can then
307 * be passed to the kobject_add() call.
309 * After this function is called, the kobject MUST be cleaned up by a call
310 * to kobject_put(), not by a call to kfree directly to ensure that all of
311 * the memory is cleaned up properly.
313 void kobject_init(struct kobject
*kobj
, struct kobj_type
*ktype
)
318 err_str
= "invalid kobject pointer!";
322 err_str
= "must have a ktype to be initialized properly!\n";
325 if (kobj
->state_initialized
) {
326 /* do not error out as sometimes we can recover */
327 printk(KERN_ERR
"kobject (%p): tried to init an initialized "
328 "object, something is seriously wrong.\n", kobj
);
332 kobject_init_internal(kobj
);
337 printk(KERN_ERR
"kobject (%p): %s\n", kobj
, err_str
);
340 EXPORT_SYMBOL(kobject_init
);
342 static int kobject_add_varg(struct kobject
*kobj
, struct kobject
*parent
,
343 const char *fmt
, va_list vargs
)
347 retval
= kobject_set_name_vargs(kobj
, fmt
, vargs
);
349 printk(KERN_ERR
"kobject: can not set name properly!\n");
352 kobj
->parent
= parent
;
353 return kobject_add_internal(kobj
);
357 * kobject_add - the main kobject add function
358 * @kobj: the kobject to add
359 * @parent: pointer to the parent of the kobject.
360 * @fmt: format to name the kobject with.
362 * The kobject name is set and added to the kobject hierarchy in this
365 * If @parent is set, then the parent of the @kobj will be set to it.
366 * If @parent is NULL, then the parent of the @kobj will be set to the
367 * kobject associted with the kset assigned to this kobject. If no kset
368 * is assigned to the kobject, then the kobject will be located in the
369 * root of the sysfs tree.
371 * If this function returns an error, kobject_put() must be called to
372 * properly clean up the memory associated with the object.
373 * Under no instance should the kobject that is passed to this function
374 * be directly freed with a call to kfree(), that can leak memory.
376 * Note, no "add" uevent will be created with this call, the caller should set
377 * up all of the necessary sysfs files for the object and then call
378 * kobject_uevent() with the UEVENT_ADD parameter to ensure that
379 * userspace is properly notified of this kobject's creation.
381 int kobject_add(struct kobject
*kobj
, struct kobject
*parent
,
382 const char *fmt
, ...)
390 if (!kobj
->state_initialized
) {
391 printk(KERN_ERR
"kobject '%s' (%p): tried to add an "
392 "uninitialized object, something is seriously wrong.\n",
393 kobject_name(kobj
), kobj
);
398 retval
= kobject_add_varg(kobj
, parent
, fmt
, args
);
403 EXPORT_SYMBOL(kobject_add
);
406 * kobject_init_and_add - initialize a kobject structure and add it to the kobject hierarchy
407 * @kobj: pointer to the kobject to initialize
408 * @ktype: pointer to the ktype for this kobject.
409 * @parent: pointer to the parent of this kobject.
410 * @fmt: the name of the kobject.
412 * This function combines the call to kobject_init() and
413 * kobject_add(). The same type of error handling after a call to
414 * kobject_add() and kobject lifetime rules are the same here.
416 int kobject_init_and_add(struct kobject
*kobj
, struct kobj_type
*ktype
,
417 struct kobject
*parent
, const char *fmt
, ...)
422 kobject_init(kobj
, ktype
);
425 retval
= kobject_add_varg(kobj
, parent
, fmt
, args
);
430 EXPORT_SYMBOL_GPL(kobject_init_and_add
);
433 * kobject_rename - change the name of an object
434 * @kobj: object in question.
435 * @new_name: object's new name
437 * It is the responsibility of the caller to provide mutual
438 * exclusion between two different calls of kobject_rename
439 * on the same kobject and to ensure that new_name is valid and
440 * won't conflict with other kobjects.
442 int kobject_rename(struct kobject
*kobj
, const char *new_name
)
445 const char *devpath
= NULL
;
446 const char *dup_name
= NULL
, *name
;
447 char *devpath_string
= NULL
;
450 kobj
= kobject_get(kobj
);
456 devpath
= kobject_get_path(kobj
, GFP_KERNEL
);
461 devpath_string
= kmalloc(strlen(devpath
) + 15, GFP_KERNEL
);
462 if (!devpath_string
) {
466 sprintf(devpath_string
, "DEVPATH_OLD=%s", devpath
);
467 envp
[0] = devpath_string
;
470 name
= dup_name
= kstrdup(new_name
, GFP_KERNEL
);
476 error
= sysfs_rename_dir_ns(kobj
, new_name
, kobject_namespace(kobj
));
480 /* Install the new kobject name */
481 dup_name
= kobj
->name
;
484 /* This function is mostly/only used for network interface.
485 * Some hotplug package track interfaces by their name and
486 * therefore want to know when the name is changed by the user. */
487 kobject_uevent_env(kobj
, KOBJ_MOVE
, envp
);
491 kfree(devpath_string
);
497 EXPORT_SYMBOL_GPL(kobject_rename
);
500 * kobject_move - move object to another parent
501 * @kobj: object in question.
502 * @new_parent: object's new parent (can be NULL)
504 int kobject_move(struct kobject
*kobj
, struct kobject
*new_parent
)
507 struct kobject
*old_parent
;
508 const char *devpath
= NULL
;
509 char *devpath_string
= NULL
;
512 kobj
= kobject_get(kobj
);
515 new_parent
= kobject_get(new_parent
);
518 new_parent
= kobject_get(&kobj
->kset
->kobj
);
521 /* old object path */
522 devpath
= kobject_get_path(kobj
, GFP_KERNEL
);
527 devpath_string
= kmalloc(strlen(devpath
) + 15, GFP_KERNEL
);
528 if (!devpath_string
) {
532 sprintf(devpath_string
, "DEVPATH_OLD=%s", devpath
);
533 envp
[0] = devpath_string
;
535 error
= sysfs_move_dir_ns(kobj
, new_parent
, kobject_namespace(kobj
));
538 old_parent
= kobj
->parent
;
539 kobj
->parent
= new_parent
;
541 kobject_put(old_parent
);
542 kobject_uevent_env(kobj
, KOBJ_MOVE
, envp
);
544 kobject_put(new_parent
);
546 kfree(devpath_string
);
552 * kobject_del - unlink kobject from hierarchy.
555 void kobject_del(struct kobject
*kobj
)
557 struct sysfs_dirent
*sd
;
563 sysfs_remove_dir(kobj
);
566 kobj
->state_in_sysfs
= 0;
567 kobj_kset_leave(kobj
);
568 kobject_put(kobj
->parent
);
573 * kobject_get - increment refcount for object.
576 struct kobject
*kobject_get(struct kobject
*kobj
)
579 kref_get(&kobj
->kref
);
583 static struct kobject
* __must_check
kobject_get_unless_zero(struct kobject
*kobj
)
585 if (!kref_get_unless_zero(&kobj
->kref
))
591 * kobject_cleanup - free kobject resources.
592 * @kobj: object to cleanup
594 static void kobject_cleanup(struct kobject
*kobj
)
596 struct kobj_type
*t
= get_ktype(kobj
);
597 const char *name
= kobj
->name
;
599 pr_debug("kobject: '%s' (%p): %s, parent %p\n",
600 kobject_name(kobj
), kobj
, __func__
, kobj
->parent
);
602 if (t
&& !t
->release
)
603 pr_debug("kobject: '%s' (%p): does not have a release() "
604 "function, it is broken and must be fixed.\n",
605 kobject_name(kobj
), kobj
);
607 /* send "remove" if the caller did not do it but sent "add" */
608 if (kobj
->state_add_uevent_sent
&& !kobj
->state_remove_uevent_sent
) {
609 pr_debug("kobject: '%s' (%p): auto cleanup 'remove' event\n",
610 kobject_name(kobj
), kobj
);
611 kobject_uevent(kobj
, KOBJ_REMOVE
);
614 /* remove from sysfs if the caller did not do it */
615 if (kobj
->state_in_sysfs
) {
616 pr_debug("kobject: '%s' (%p): auto cleanup kobject_del\n",
617 kobject_name(kobj
), kobj
);
621 if (t
&& t
->release
) {
622 pr_debug("kobject: '%s' (%p): calling ktype release\n",
623 kobject_name(kobj
), kobj
);
627 /* free name if we allocated it */
629 pr_debug("kobject: '%s': free name\n", name
);
634 #ifdef CONFIG_DEBUG_KOBJECT_RELEASE
635 static void kobject_delayed_cleanup(struct work_struct
*work
)
637 kobject_cleanup(container_of(to_delayed_work(work
),
638 struct kobject
, release
));
642 static void kobject_release(struct kref
*kref
)
644 struct kobject
*kobj
= container_of(kref
, struct kobject
, kref
);
645 #ifdef CONFIG_DEBUG_KOBJECT_RELEASE
646 unsigned long delay
= HZ
+ HZ
* (get_random_int() & 0x3);
647 pr_info("kobject: '%s' (%p): %s, parent %p (delayed %ld)\n",
648 kobject_name(kobj
), kobj
, __func__
, kobj
->parent
, delay
);
649 INIT_DELAYED_WORK(&kobj
->release
, kobject_delayed_cleanup
);
651 schedule_delayed_work(&kobj
->release
, delay
);
653 kobject_cleanup(kobj
);
658 * kobject_put - decrement refcount for object.
661 * Decrement the refcount, and if 0, call kobject_cleanup().
663 void kobject_put(struct kobject
*kobj
)
666 if (!kobj
->state_initialized
)
667 WARN(1, KERN_WARNING
"kobject: '%s' (%p): is not "
668 "initialized, yet kobject_put() is being "
669 "called.\n", kobject_name(kobj
), kobj
);
670 kref_put(&kobj
->kref
, kobject_release
);
674 static void dynamic_kobj_release(struct kobject
*kobj
)
676 pr_debug("kobject: (%p): %s\n", kobj
, __func__
);
680 static struct kobj_type dynamic_kobj_ktype
= {
681 .release
= dynamic_kobj_release
,
682 .sysfs_ops
= &kobj_sysfs_ops
,
686 * kobject_create - create a struct kobject dynamically
688 * This function creates a kobject structure dynamically and sets it up
689 * to be a "dynamic" kobject with a default release function set up.
691 * If the kobject was not able to be created, NULL will be returned.
692 * The kobject structure returned from here must be cleaned up with a
693 * call to kobject_put() and not kfree(), as kobject_init() has
694 * already been called on this structure.
696 struct kobject
*kobject_create(void)
698 struct kobject
*kobj
;
700 kobj
= kzalloc(sizeof(*kobj
), GFP_KERNEL
);
704 kobject_init(kobj
, &dynamic_kobj_ktype
);
709 * kobject_create_and_add - create a struct kobject dynamically and register it with sysfs
711 * @name: the name for the kobject
712 * @parent: the parent kobject of this kobject, if any.
714 * This function creates a kobject structure dynamically and registers it
715 * with sysfs. When you are finished with this structure, call
716 * kobject_put() and the structure will be dynamically freed when
717 * it is no longer being used.
719 * If the kobject was not able to be created, NULL will be returned.
721 struct kobject
*kobject_create_and_add(const char *name
, struct kobject
*parent
)
723 struct kobject
*kobj
;
726 kobj
= kobject_create();
730 retval
= kobject_add(kobj
, parent
, "%s", name
);
732 printk(KERN_WARNING
"%s: kobject_add error: %d\n",
739 EXPORT_SYMBOL_GPL(kobject_create_and_add
);
742 * kset_init - initialize a kset for use
745 void kset_init(struct kset
*k
)
747 kobject_init_internal(&k
->kobj
);
748 INIT_LIST_HEAD(&k
->list
);
749 spin_lock_init(&k
->list_lock
);
752 /* default kobject attribute operations */
753 static ssize_t
kobj_attr_show(struct kobject
*kobj
, struct attribute
*attr
,
756 struct kobj_attribute
*kattr
;
759 kattr
= container_of(attr
, struct kobj_attribute
, attr
);
761 ret
= kattr
->show(kobj
, kattr
, buf
);
765 static ssize_t
kobj_attr_store(struct kobject
*kobj
, struct attribute
*attr
,
766 const char *buf
, size_t count
)
768 struct kobj_attribute
*kattr
;
771 kattr
= container_of(attr
, struct kobj_attribute
, attr
);
773 ret
= kattr
->store(kobj
, kattr
, buf
, count
);
777 const struct sysfs_ops kobj_sysfs_ops
= {
778 .show
= kobj_attr_show
,
779 .store
= kobj_attr_store
,
783 * kobj_completion_init - initialize a kobj_completion object.
784 * @kc: kobj_completion
785 * @ktype: type of kobject to initialize
787 * kobj_completion structures can be embedded within structures with different
788 * lifetime rules. During the release of the enclosing object, we can
789 * wait on the release of the kobject so that we don't free it while it's
792 void kobj_completion_init(struct kobj_completion
*kc
, struct kobj_type
*ktype
)
794 init_completion(&kc
->kc_unregister
);
795 kobject_init(&kc
->kc_kobj
, ktype
);
797 EXPORT_SYMBOL_GPL(kobj_completion_init
);
800 * kobj_completion_release - release a kobj_completion object
801 * @kobj: kobject embedded in kobj_completion
803 * Used with kobject_release to notify waiters that the kobject has been
806 void kobj_completion_release(struct kobject
*kobj
)
808 struct kobj_completion
*kc
= kobj_to_kobj_completion(kobj
);
809 complete(&kc
->kc_unregister
);
811 EXPORT_SYMBOL_GPL(kobj_completion_release
);
814 * kobj_completion_del_and_wait - release the kobject and wait for it
815 * @kc: kobj_completion object to release
817 * Delete the kobject from sysfs and drop the reference count. Then wait
818 * until any other outstanding references are also dropped. This routine
819 * is only necessary once other references may have been taken on the
820 * kobject. Typically this happens when the kobject has been published
821 * to sysfs via kobject_add.
823 void kobj_completion_del_and_wait(struct kobj_completion
*kc
)
825 kobject_del(&kc
->kc_kobj
);
826 kobject_put(&kc
->kc_kobj
);
827 wait_for_completion(&kc
->kc_unregister
);
829 EXPORT_SYMBOL_GPL(kobj_completion_del_and_wait
);
832 * kset_register - initialize and add a kset.
835 int kset_register(struct kset
*k
)
843 err
= kobject_add_internal(&k
->kobj
);
846 kobject_uevent(&k
->kobj
, KOBJ_ADD
);
851 * kset_unregister - remove a kset.
854 void kset_unregister(struct kset
*k
)
858 kobject_put(&k
->kobj
);
862 * kset_find_obj - search for object in kset.
863 * @kset: kset we're looking in.
864 * @name: object's name.
866 * Lock kset via @kset->subsys, and iterate over @kset->list,
867 * looking for a matching kobject. If matching object is found
868 * take a reference and return the object.
870 struct kobject
*kset_find_obj(struct kset
*kset
, const char *name
)
873 struct kobject
*ret
= NULL
;
875 spin_lock(&kset
->list_lock
);
877 list_for_each_entry(k
, &kset
->list
, entry
) {
878 if (kobject_name(k
) && !strcmp(kobject_name(k
), name
)) {
879 ret
= kobject_get_unless_zero(k
);
884 spin_unlock(&kset
->list_lock
);
888 static void kset_release(struct kobject
*kobj
)
890 struct kset
*kset
= container_of(kobj
, struct kset
, kobj
);
891 pr_debug("kobject: '%s' (%p): %s\n",
892 kobject_name(kobj
), kobj
, __func__
);
896 static struct kobj_type kset_ktype
= {
897 .sysfs_ops
= &kobj_sysfs_ops
,
898 .release
= kset_release
,
902 * kset_create - create a struct kset dynamically
904 * @name: the name for the kset
905 * @uevent_ops: a struct kset_uevent_ops for the kset
906 * @parent_kobj: the parent kobject of this kset, if any.
908 * This function creates a kset structure dynamically. This structure can
909 * then be registered with the system and show up in sysfs with a call to
910 * kset_register(). When you are finished with this structure, if
911 * kset_register() has been called, call kset_unregister() and the
912 * structure will be dynamically freed when it is no longer being used.
914 * If the kset was not able to be created, NULL will be returned.
916 static struct kset
*kset_create(const char *name
,
917 const struct kset_uevent_ops
*uevent_ops
,
918 struct kobject
*parent_kobj
)
923 kset
= kzalloc(sizeof(*kset
), GFP_KERNEL
);
926 retval
= kobject_set_name(&kset
->kobj
, "%s", name
);
931 kset
->uevent_ops
= uevent_ops
;
932 kset
->kobj
.parent
= parent_kobj
;
935 * The kobject of this kset will have a type of kset_ktype and belong to
936 * no kset itself. That way we can properly free it when it is
937 * finished being used.
939 kset
->kobj
.ktype
= &kset_ktype
;
940 kset
->kobj
.kset
= NULL
;
946 * kset_create_and_add - create a struct kset dynamically and add it to sysfs
948 * @name: the name for the kset
949 * @uevent_ops: a struct kset_uevent_ops for the kset
950 * @parent_kobj: the parent kobject of this kset, if any.
952 * This function creates a kset structure dynamically and registers it
953 * with sysfs. When you are finished with this structure, call
954 * kset_unregister() and the structure will be dynamically freed when it
955 * is no longer being used.
957 * If the kset was not able to be created, NULL will be returned.
959 struct kset
*kset_create_and_add(const char *name
,
960 const struct kset_uevent_ops
*uevent_ops
,
961 struct kobject
*parent_kobj
)
966 kset
= kset_create(name
, uevent_ops
, parent_kobj
);
969 error
= kset_register(kset
);
976 EXPORT_SYMBOL_GPL(kset_create_and_add
);
979 static DEFINE_SPINLOCK(kobj_ns_type_lock
);
980 static const struct kobj_ns_type_operations
*kobj_ns_ops_tbl
[KOBJ_NS_TYPES
];
982 int kobj_ns_type_register(const struct kobj_ns_type_operations
*ops
)
984 enum kobj_ns_type type
= ops
->type
;
987 spin_lock(&kobj_ns_type_lock
);
990 if (type
>= KOBJ_NS_TYPES
)
994 if (type
<= KOBJ_NS_TYPE_NONE
)
998 if (kobj_ns_ops_tbl
[type
])
1002 kobj_ns_ops_tbl
[type
] = ops
;
1005 spin_unlock(&kobj_ns_type_lock
);
1009 int kobj_ns_type_registered(enum kobj_ns_type type
)
1013 spin_lock(&kobj_ns_type_lock
);
1014 if ((type
> KOBJ_NS_TYPE_NONE
) && (type
< KOBJ_NS_TYPES
))
1015 registered
= kobj_ns_ops_tbl
[type
] != NULL
;
1016 spin_unlock(&kobj_ns_type_lock
);
1021 const struct kobj_ns_type_operations
*kobj_child_ns_ops(struct kobject
*parent
)
1023 const struct kobj_ns_type_operations
*ops
= NULL
;
1025 if (parent
&& parent
->ktype
->child_ns_type
)
1026 ops
= parent
->ktype
->child_ns_type(parent
);
1031 const struct kobj_ns_type_operations
*kobj_ns_ops(struct kobject
*kobj
)
1033 return kobj_child_ns_ops(kobj
->parent
);
1036 bool kobj_ns_current_may_mount(enum kobj_ns_type type
)
1038 bool may_mount
= true;
1040 spin_lock(&kobj_ns_type_lock
);
1041 if ((type
> KOBJ_NS_TYPE_NONE
) && (type
< KOBJ_NS_TYPES
) &&
1042 kobj_ns_ops_tbl
[type
])
1043 may_mount
= kobj_ns_ops_tbl
[type
]->current_may_mount();
1044 spin_unlock(&kobj_ns_type_lock
);
1049 void *kobj_ns_grab_current(enum kobj_ns_type type
)
1053 spin_lock(&kobj_ns_type_lock
);
1054 if ((type
> KOBJ_NS_TYPE_NONE
) && (type
< KOBJ_NS_TYPES
) &&
1055 kobj_ns_ops_tbl
[type
])
1056 ns
= kobj_ns_ops_tbl
[type
]->grab_current_ns();
1057 spin_unlock(&kobj_ns_type_lock
);
1062 const void *kobj_ns_netlink(enum kobj_ns_type type
, struct sock
*sk
)
1064 const void *ns
= NULL
;
1066 spin_lock(&kobj_ns_type_lock
);
1067 if ((type
> KOBJ_NS_TYPE_NONE
) && (type
< KOBJ_NS_TYPES
) &&
1068 kobj_ns_ops_tbl
[type
])
1069 ns
= kobj_ns_ops_tbl
[type
]->netlink_ns(sk
);
1070 spin_unlock(&kobj_ns_type_lock
);
1075 const void *kobj_ns_initial(enum kobj_ns_type type
)
1077 const void *ns
= NULL
;
1079 spin_lock(&kobj_ns_type_lock
);
1080 if ((type
> KOBJ_NS_TYPE_NONE
) && (type
< KOBJ_NS_TYPES
) &&
1081 kobj_ns_ops_tbl
[type
])
1082 ns
= kobj_ns_ops_tbl
[type
]->initial_ns();
1083 spin_unlock(&kobj_ns_type_lock
);
1088 void kobj_ns_drop(enum kobj_ns_type type
, void *ns
)
1090 spin_lock(&kobj_ns_type_lock
);
1091 if ((type
> KOBJ_NS_TYPE_NONE
) && (type
< KOBJ_NS_TYPES
) &&
1092 kobj_ns_ops_tbl
[type
] && kobj_ns_ops_tbl
[type
]->drop_ns
)
1093 kobj_ns_ops_tbl
[type
]->drop_ns(ns
);
1094 spin_unlock(&kobj_ns_type_lock
);
1097 EXPORT_SYMBOL(kobject_get
);
1098 EXPORT_SYMBOL(kobject_put
);
1099 EXPORT_SYMBOL(kobject_del
);
1101 EXPORT_SYMBOL(kset_register
);
1102 EXPORT_SYMBOL(kset_unregister
);