| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 1 | /* | 
|  | 2 | * kobject.c - library routines for handling generic kernel objects | 
|  | 3 | * | 
|  | 4 | * Copyright (c) 2002-2003 Patrick Mochel <mochel@osdl.org> | 
| Greg Kroah-Hartman | f0e7e1b | 2007-09-27 14:48:53 -0700 | [diff] [blame] | 5 | * Copyright (c) 2006-2007 Greg Kroah-Hartman <greg@kroah.com> | 
|  | 6 | * Copyright (c) 2006-2007 Novell Inc. | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 7 | * | 
|  | 8 | * This file is released under the GPLv2. | 
|  | 9 | * | 
|  | 10 | * | 
|  | 11 | * Please see the file Documentation/kobject.txt for critical information | 
|  | 12 | * about using the kobject interface. | 
|  | 13 | */ | 
|  | 14 |  | 
|  | 15 | #include <linux/kobject.h> | 
|  | 16 | #include <linux/string.h> | 
| Paul Gortmaker | 8bc3bcc | 2011-11-16 21:29:17 -0500 | [diff] [blame] | 17 | #include <linux/export.h> | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 18 | #include <linux/stat.h> | 
| Tim Schmielau | 4e57b68 | 2005-10-30 15:03:48 -0800 | [diff] [blame] | 19 | #include <linux/slab.h> | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 20 |  | 
| Greg Kroah-Hartman | e374a2b | 2008-01-24 21:59:04 -0800 | [diff] [blame] | 21 | /* | 
|  | 22 | * populate_dir - populate directory with attributes. | 
|  | 23 | * @kobj: object we're working on. | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 24 | * | 
| Greg Kroah-Hartman | e374a2b | 2008-01-24 21:59:04 -0800 | [diff] [blame] | 25 | * Most subsystems have a set of default attributes that are associated | 
|  | 26 | * with an object that registers with them.  This is a helper called during | 
|  | 27 | * object registration that loops through the default attributes of the | 
|  | 28 | * subsystem and creates attributes files for them in sysfs. | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 29 | */ | 
| Greg Kroah-Hartman | e374a2b | 2008-01-24 21:59:04 -0800 | [diff] [blame] | 30 | static int populate_dir(struct kobject *kobj) | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 31 | { | 
| Greg Kroah-Hartman | e374a2b | 2008-01-24 21:59:04 -0800 | [diff] [blame] | 32 | struct kobj_type *t = get_ktype(kobj); | 
|  | 33 | struct attribute *attr; | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 34 | int error = 0; | 
|  | 35 | int i; | 
| Greg Kroah-Hartman | e374a2b | 2008-01-24 21:59:04 -0800 | [diff] [blame] | 36 |  | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 37 | if (t && t->default_attrs) { | 
|  | 38 | for (i = 0; (attr = t->default_attrs[i]) != NULL; i++) { | 
| Greg Kroah-Hartman | e374a2b | 2008-01-24 21:59:04 -0800 | [diff] [blame] | 39 | error = sysfs_create_file(kobj, attr); | 
|  | 40 | if (error) | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 41 | break; | 
|  | 42 | } | 
|  | 43 | } | 
|  | 44 | return error; | 
|  | 45 | } | 
|  | 46 |  | 
| Greg Kroah-Hartman | e374a2b | 2008-01-24 21:59:04 -0800 | [diff] [blame] | 47 | static int create_dir(struct kobject *kobj) | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 48 | { | 
|  | 49 | int error = 0; | 
| yan | 6b96061 | 2012-04-20 21:25:53 +0800 | [diff] [blame^] | 50 | error = sysfs_create_dir(kobj); | 
|  | 51 | if (!error) { | 
|  | 52 | error = populate_dir(kobj); | 
|  | 53 | if (error) | 
|  | 54 | sysfs_remove_dir(kobj); | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 55 | } | 
|  | 56 | return error; | 
|  | 57 | } | 
|  | 58 |  | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 59 | static int get_kobj_path_length(struct kobject *kobj) | 
|  | 60 | { | 
|  | 61 | int length = 1; | 
| Greg Kroah-Hartman | e374a2b | 2008-01-24 21:59:04 -0800 | [diff] [blame] | 62 | struct kobject *parent = kobj; | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 63 |  | 
| Greg Kroah-Hartman | e374a2b | 2008-01-24 21:59:04 -0800 | [diff] [blame] | 64 | /* walk up the ancestors until we hit the one pointing to the | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 65 | * root. | 
|  | 66 | * Add 1 to strlen for leading '/' of each level. | 
|  | 67 | */ | 
|  | 68 | do { | 
| Chuck Ebbert | b365b3d | 2006-01-12 20:02:00 -0500 | [diff] [blame] | 69 | if (kobject_name(parent) == NULL) | 
|  | 70 | return 0; | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 71 | length += strlen(kobject_name(parent)) + 1; | 
|  | 72 | parent = parent->parent; | 
|  | 73 | } while (parent); | 
|  | 74 | return length; | 
|  | 75 | } | 
|  | 76 |  | 
|  | 77 | static void fill_kobj_path(struct kobject *kobj, char *path, int length) | 
|  | 78 | { | 
| Greg Kroah-Hartman | e374a2b | 2008-01-24 21:59:04 -0800 | [diff] [blame] | 79 | struct kobject *parent; | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 80 |  | 
|  | 81 | --length; | 
|  | 82 | for (parent = kobj; parent; parent = parent->parent) { | 
|  | 83 | int cur = strlen(kobject_name(parent)); | 
|  | 84 | /* back up enough to print this name with '/' */ | 
|  | 85 | length -= cur; | 
| Greg Kroah-Hartman | e374a2b | 2008-01-24 21:59:04 -0800 | [diff] [blame] | 86 | strncpy(path + length, kobject_name(parent), cur); | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 87 | *(path + --length) = '/'; | 
|  | 88 | } | 
|  | 89 |  | 
| Greg Kroah-Hartman | 9f66fa2 | 2007-11-28 23:49:41 -0800 | [diff] [blame] | 90 | pr_debug("kobject: '%s' (%p): %s: path = '%s'\n", kobject_name(kobj), | 
| Harvey Harrison | 810304d | 2008-04-30 00:55:08 -0700 | [diff] [blame] | 91 | kobj, __func__, path); | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 92 | } | 
|  | 93 |  | 
|  | 94 | /** | 
| Robert P. J. Day | 72fd4a3 | 2007-02-10 01:45:59 -0800 | [diff] [blame] | 95 | * kobject_get_path - generate and return the path associated with a given kobj and kset pair. | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 96 | * | 
|  | 97 | * @kobj:	kobject in question, with which to build the path | 
|  | 98 | * @gfp_mask:	the allocation type used to allocate the path | 
| Robert P. J. Day | 72fd4a3 | 2007-02-10 01:45:59 -0800 | [diff] [blame] | 99 | * | 
|  | 100 | * The result must be freed by the caller with kfree(). | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 101 | */ | 
| Al Viro | fd4f2df | 2005-10-21 03:18:50 -0400 | [diff] [blame] | 102 | char *kobject_get_path(struct kobject *kobj, gfp_t gfp_mask) | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 103 | { | 
|  | 104 | char *path; | 
|  | 105 | int len; | 
|  | 106 |  | 
|  | 107 | len = get_kobj_path_length(kobj); | 
| Chuck Ebbert | b365b3d | 2006-01-12 20:02:00 -0500 | [diff] [blame] | 108 | if (len == 0) | 
|  | 109 | return NULL; | 
| Burman Yan | 4668edc | 2006-12-06 20:38:51 -0800 | [diff] [blame] | 110 | path = kzalloc(len, gfp_mask); | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 111 | if (!path) | 
|  | 112 | return NULL; | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 113 | fill_kobj_path(kobj, path, len); | 
|  | 114 |  | 
|  | 115 | return path; | 
|  | 116 | } | 
| Dmitry Torokhov | 80fc9f5 | 2006-10-11 01:43:58 -0400 | [diff] [blame] | 117 | EXPORT_SYMBOL_GPL(kobject_get_path); | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 118 |  | 
| Kay Sievers | 0f4dafc | 2007-12-19 01:40:42 +0100 | [diff] [blame] | 119 | /* add the kobject to its kset's list */ | 
|  | 120 | static void kobj_kset_join(struct kobject *kobj) | 
|  | 121 | { | 
|  | 122 | if (!kobj->kset) | 
|  | 123 | return; | 
|  | 124 |  | 
|  | 125 | kset_get(kobj->kset); | 
|  | 126 | spin_lock(&kobj->kset->list_lock); | 
|  | 127 | list_add_tail(&kobj->entry, &kobj->kset->list); | 
|  | 128 | spin_unlock(&kobj->kset->list_lock); | 
|  | 129 | } | 
|  | 130 |  | 
|  | 131 | /* remove the kobject from its kset's list */ | 
|  | 132 | static void kobj_kset_leave(struct kobject *kobj) | 
|  | 133 | { | 
|  | 134 | if (!kobj->kset) | 
|  | 135 | return; | 
|  | 136 |  | 
|  | 137 | spin_lock(&kobj->kset->list_lock); | 
|  | 138 | list_del_init(&kobj->entry); | 
|  | 139 | spin_unlock(&kobj->kset->list_lock); | 
|  | 140 | kset_put(kobj->kset); | 
|  | 141 | } | 
|  | 142 |  | 
| Greg Kroah-Hartman | e374a2b | 2008-01-24 21:59:04 -0800 | [diff] [blame] | 143 | static void kobject_init_internal(struct kobject *kobj) | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 144 | { | 
| Greg Kroah-Hartman | 31b9025a | 2007-01-18 12:23:51 -0800 | [diff] [blame] | 145 | if (!kobj) | 
|  | 146 | return; | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 147 | kref_init(&kobj->kref); | 
|  | 148 | INIT_LIST_HEAD(&kobj->entry); | 
| Greg Kroah-Hartman | a4573c4 | 2008-02-26 09:36:38 -0800 | [diff] [blame] | 149 | kobj->state_in_sysfs = 0; | 
|  | 150 | kobj->state_add_uevent_sent = 0; | 
|  | 151 | kobj->state_remove_uevent_sent = 0; | 
|  | 152 | kobj->state_initialized = 1; | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 153 | } | 
|  | 154 |  | 
|  | 155 |  | 
| Greg Kroah-Hartman | 9e7bbcc | 2007-12-17 23:05:35 -0700 | [diff] [blame] | 156 | static int kobject_add_internal(struct kobject *kobj) | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 157 | { | 
|  | 158 | int error = 0; | 
| Greg Kroah-Hartman | e374a2b | 2008-01-24 21:59:04 -0800 | [diff] [blame] | 159 | struct kobject *parent; | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 160 |  | 
| Kay Sievers | 0f4dafc | 2007-12-19 01:40:42 +0100 | [diff] [blame] | 161 | if (!kobj) | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 162 | return -ENOENT; | 
| Kay Sievers | 0f4dafc | 2007-12-19 01:40:42 +0100 | [diff] [blame] | 163 |  | 
| Kay Sievers | af5ca3f | 2007-12-20 02:09:39 +0100 | [diff] [blame] | 164 | if (!kobj->name || !kobj->name[0]) { | 
| Arjan van de Ven | d955c78 | 2008-07-25 01:45:55 -0700 | [diff] [blame] | 165 | WARN(1, "kobject: (%p): attempted to be registered with empty " | 
| Greg Kroah-Hartman | 9f66fa2 | 2007-11-28 23:49:41 -0800 | [diff] [blame] | 166 | "name!\n", kobj); | 
| Greg Kroah-Hartman | c171fef | 2006-01-20 14:08:59 -0800 | [diff] [blame] | 167 | return -EINVAL; | 
|  | 168 | } | 
| Kay Sievers | 0f4dafc | 2007-12-19 01:40:42 +0100 | [diff] [blame] | 169 |  | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 170 | parent = kobject_get(kobj->parent); | 
|  | 171 |  | 
| Kay Sievers | 0f4dafc | 2007-12-19 01:40:42 +0100 | [diff] [blame] | 172 | /* join kset if set, use it as parent if we do not already have one */ | 
|  | 173 | if (kobj->kset) { | 
|  | 174 | if (!parent) | 
|  | 175 | parent = kobject_get(&kobj->kset->kobj); | 
|  | 176 | kobj_kset_join(kobj); | 
|  | 177 | kobj->parent = parent; | 
|  | 178 | } | 
|  | 179 |  | 
| Greg Kroah-Hartman | 9f66fa2 | 2007-11-28 23:49:41 -0800 | [diff] [blame] | 180 | pr_debug("kobject: '%s' (%p): %s: parent: '%s', set: '%s'\n", | 
| Harvey Harrison | 810304d | 2008-04-30 00:55:08 -0700 | [diff] [blame] | 181 | kobject_name(kobj), kobj, __func__, | 
| Greg Kroah-Hartman | 9f66fa2 | 2007-11-28 23:49:41 -0800 | [diff] [blame] | 182 | parent ? kobject_name(parent) : "<NULL>", | 
| Greg Kroah-Hartman | e374a2b | 2008-01-24 21:59:04 -0800 | [diff] [blame] | 183 | kobj->kset ? kobject_name(&kobj->kset->kobj) : "<NULL>"); | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 184 |  | 
| Eric W. Biederman | 90bc613 | 2007-07-31 19:15:08 +0900 | [diff] [blame] | 185 | error = create_dir(kobj); | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 186 | if (error) { | 
| Kay Sievers | 0f4dafc | 2007-12-19 01:40:42 +0100 | [diff] [blame] | 187 | kobj_kset_leave(kobj); | 
|  | 188 | kobject_put(parent); | 
|  | 189 | kobj->parent = NULL; | 
| Greg Kroah-Hartman | dcd0da0 | 2006-03-20 13:17:13 -0800 | [diff] [blame] | 190 |  | 
|  | 191 | /* be noisy on error issues */ | 
|  | 192 | if (error == -EEXIST) | 
| Greg Kroah-Hartman | 9e7bbcc | 2007-12-17 23:05:35 -0700 | [diff] [blame] | 193 | printk(KERN_ERR "%s failed for %s with " | 
| Greg Kroah-Hartman | 5c73a3f | 2007-06-07 15:05:15 -0700 | [diff] [blame] | 194 | "-EEXIST, don't try to register things with " | 
|  | 195 | "the same name in the same directory.\n", | 
| Harvey Harrison | 810304d | 2008-04-30 00:55:08 -0700 | [diff] [blame] | 196 | __func__, kobject_name(kobj)); | 
| Greg Kroah-Hartman | dcd0da0 | 2006-03-20 13:17:13 -0800 | [diff] [blame] | 197 | else | 
| Greg Kroah-Hartman | 9e7bbcc | 2007-12-17 23:05:35 -0700 | [diff] [blame] | 198 | printk(KERN_ERR "%s failed for %s (%d)\n", | 
| Harvey Harrison | 810304d | 2008-04-30 00:55:08 -0700 | [diff] [blame] | 199 | __func__, kobject_name(kobj), error); | 
| Greg Kroah-Hartman | 5c73a3f | 2007-06-07 15:05:15 -0700 | [diff] [blame] | 200 | dump_stack(); | 
| Kay Sievers | 0f4dafc | 2007-12-19 01:40:42 +0100 | [diff] [blame] | 201 | } else | 
|  | 202 | kobj->state_in_sysfs = 1; | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 203 |  | 
|  | 204 | return error; | 
|  | 205 | } | 
|  | 206 |  | 
| Eric W. Biederman | b592fcf | 2007-01-24 12:35:52 -0700 | [diff] [blame] | 207 | /** | 
| Greg Kroah-Hartman | 663a474 | 2007-11-29 18:32:47 -0500 | [diff] [blame] | 208 | * kobject_set_name_vargs - Set the name of an kobject | 
|  | 209 | * @kobj: struct kobject to set the name of | 
| Greg Kroah-Hartman | 8c4606b | 2007-12-04 14:45:47 +0800 | [diff] [blame] | 210 | * @fmt: format string used to build the name | 
| Greg Kroah-Hartman | 663a474 | 2007-11-29 18:32:47 -0500 | [diff] [blame] | 211 | * @vargs: vargs to format the string. | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 212 | */ | 
| Kay Sievers | 1fa5ae8 | 2009-01-25 15:17:37 +0100 | [diff] [blame] | 213 | int kobject_set_name_vargs(struct kobject *kobj, const char *fmt, | 
| Greg Kroah-Hartman | 663a474 | 2007-11-29 18:32:47 -0500 | [diff] [blame] | 214 | va_list vargs) | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 215 | { | 
| Kay Sievers | 9f25565 | 2008-05-06 22:24:04 +0200 | [diff] [blame] | 216 | const char *old_name = kobj->name; | 
|  | 217 | char *s; | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 218 |  | 
| Kay Sievers | 8a577ff | 2009-04-18 15:05:45 -0700 | [diff] [blame] | 219 | if (kobj->name && !fmt) | 
|  | 220 | return 0; | 
|  | 221 |  | 
| Kay Sievers | a4ca661 | 2008-04-30 02:06:29 +0200 | [diff] [blame] | 222 | kobj->name = kvasprintf(GFP_KERNEL, fmt, vargs); | 
|  | 223 | if (!kobj->name) | 
|  | 224 | return -ENOMEM; | 
| Greg Kroah-Hartman | 663a474 | 2007-11-29 18:32:47 -0500 | [diff] [blame] | 225 |  | 
| Kay Sievers | 9f25565 | 2008-05-06 22:24:04 +0200 | [diff] [blame] | 226 | /* ewww... some of these buggers have '/' in the name ... */ | 
| Ingo Oeser | 25fdeb3 | 2008-07-23 01:25:01 +0200 | [diff] [blame] | 227 | while ((s = strchr(kobj->name, '/'))) | 
| Kay Sievers | 9f25565 | 2008-05-06 22:24:04 +0200 | [diff] [blame] | 228 | s[0] = '!'; | 
|  | 229 |  | 
|  | 230 | kfree(old_name); | 
| Greg Kroah-Hartman | 663a474 | 2007-11-29 18:32:47 -0500 | [diff] [blame] | 231 | return 0; | 
|  | 232 | } | 
|  | 233 |  | 
|  | 234 | /** | 
|  | 235 | * kobject_set_name - Set the name of a kobject | 
|  | 236 | * @kobj: struct kobject to set the name of | 
|  | 237 | * @fmt: format string used to build the name | 
|  | 238 | * | 
|  | 239 | * This sets the name of the kobject.  If you have already added the | 
|  | 240 | * kobject to the system, you must call kobject_rename() in order to | 
|  | 241 | * change the name of the kobject. | 
|  | 242 | */ | 
|  | 243 | int kobject_set_name(struct kobject *kobj, const char *fmt, ...) | 
|  | 244 | { | 
| Kay Sievers | a4ca661 | 2008-04-30 02:06:29 +0200 | [diff] [blame] | 245 | va_list vargs; | 
| Greg Kroah-Hartman | 663a474 | 2007-11-29 18:32:47 -0500 | [diff] [blame] | 246 | int retval; | 
|  | 247 |  | 
| Kay Sievers | a4ca661 | 2008-04-30 02:06:29 +0200 | [diff] [blame] | 248 | va_start(vargs, fmt); | 
|  | 249 | retval = kobject_set_name_vargs(kobj, fmt, vargs); | 
|  | 250 | va_end(vargs); | 
| Greg Kroah-Hartman | 663a474 | 2007-11-29 18:32:47 -0500 | [diff] [blame] | 251 |  | 
|  | 252 | return retval; | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 253 | } | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 254 | EXPORT_SYMBOL(kobject_set_name); | 
|  | 255 |  | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 256 | /** | 
| Greg Kroah-Hartman | f9cb074 | 2007-12-17 23:05:35 -0700 | [diff] [blame] | 257 | * kobject_init - initialize a kobject structure | 
| Greg Kroah-Hartman | e86000d | 2007-12-03 21:31:08 -0800 | [diff] [blame] | 258 | * @kobj: pointer to the kobject to initialize | 
|  | 259 | * @ktype: pointer to the ktype for this kobject. | 
|  | 260 | * | 
|  | 261 | * This function will properly initialize a kobject such that it can then | 
|  | 262 | * be passed to the kobject_add() call. | 
|  | 263 | * | 
|  | 264 | * After this function is called, the kobject MUST be cleaned up by a call | 
|  | 265 | * to kobject_put(), not by a call to kfree directly to ensure that all of | 
|  | 266 | * the memory is cleaned up properly. | 
|  | 267 | */ | 
| Greg Kroah-Hartman | f9cb074 | 2007-12-17 23:05:35 -0700 | [diff] [blame] | 268 | void kobject_init(struct kobject *kobj, struct kobj_type *ktype) | 
| Greg Kroah-Hartman | e86000d | 2007-12-03 21:31:08 -0800 | [diff] [blame] | 269 | { | 
|  | 270 | char *err_str; | 
|  | 271 |  | 
|  | 272 | if (!kobj) { | 
|  | 273 | err_str = "invalid kobject pointer!"; | 
|  | 274 | goto error; | 
|  | 275 | } | 
|  | 276 | if (!ktype) { | 
|  | 277 | err_str = "must have a ktype to be initialized properly!\n"; | 
|  | 278 | goto error; | 
|  | 279 | } | 
| Kay Sievers | 0f4dafc | 2007-12-19 01:40:42 +0100 | [diff] [blame] | 280 | if (kobj->state_initialized) { | 
| Greg Kroah-Hartman | e86000d | 2007-12-03 21:31:08 -0800 | [diff] [blame] | 281 | /* do not error out as sometimes we can recover */ | 
| Kay Sievers | 0f4dafc | 2007-12-19 01:40:42 +0100 | [diff] [blame] | 282 | printk(KERN_ERR "kobject (%p): tried to init an initialized " | 
|  | 283 | "object, something is seriously wrong.\n", kobj); | 
| Greg Kroah-Hartman | e86000d | 2007-12-03 21:31:08 -0800 | [diff] [blame] | 284 | dump_stack(); | 
|  | 285 | } | 
|  | 286 |  | 
| Greg Kroah-Hartman | a4573c4 | 2008-02-26 09:36:38 -0800 | [diff] [blame] | 287 | kobject_init_internal(kobj); | 
| Greg Kroah-Hartman | e86000d | 2007-12-03 21:31:08 -0800 | [diff] [blame] | 288 | kobj->ktype = ktype; | 
|  | 289 | return; | 
|  | 290 |  | 
|  | 291 | error: | 
| Kay Sievers | 0f4dafc | 2007-12-19 01:40:42 +0100 | [diff] [blame] | 292 | printk(KERN_ERR "kobject (%p): %s\n", kobj, err_str); | 
| Greg Kroah-Hartman | e86000d | 2007-12-03 21:31:08 -0800 | [diff] [blame] | 293 | dump_stack(); | 
|  | 294 | } | 
| Greg Kroah-Hartman | f9cb074 | 2007-12-17 23:05:35 -0700 | [diff] [blame] | 295 | EXPORT_SYMBOL(kobject_init); | 
| Greg Kroah-Hartman | e86000d | 2007-12-03 21:31:08 -0800 | [diff] [blame] | 296 |  | 
| Greg Kroah-Hartman | 244f6ce | 2007-12-03 21:31:08 -0800 | [diff] [blame] | 297 | static int kobject_add_varg(struct kobject *kobj, struct kobject *parent, | 
|  | 298 | const char *fmt, va_list vargs) | 
|  | 299 | { | 
| Greg Kroah-Hartman | 244f6ce | 2007-12-03 21:31:08 -0800 | [diff] [blame] | 300 | int retval; | 
|  | 301 |  | 
| Kay Sievers | a4ca661 | 2008-04-30 02:06:29 +0200 | [diff] [blame] | 302 | retval = kobject_set_name_vargs(kobj, fmt, vargs); | 
| Greg Kroah-Hartman | 244f6ce | 2007-12-03 21:31:08 -0800 | [diff] [blame] | 303 | if (retval) { | 
|  | 304 | printk(KERN_ERR "kobject: can not set name properly!\n"); | 
|  | 305 | return retval; | 
|  | 306 | } | 
|  | 307 | kobj->parent = parent; | 
| Greg Kroah-Hartman | 9e7bbcc | 2007-12-17 23:05:35 -0700 | [diff] [blame] | 308 | return kobject_add_internal(kobj); | 
| Greg Kroah-Hartman | 244f6ce | 2007-12-03 21:31:08 -0800 | [diff] [blame] | 309 | } | 
|  | 310 |  | 
|  | 311 | /** | 
| Greg Kroah-Hartman | b2d6db5 | 2007-12-17 23:05:35 -0700 | [diff] [blame] | 312 | * kobject_add - the main kobject add function | 
| Greg Kroah-Hartman | 244f6ce | 2007-12-03 21:31:08 -0800 | [diff] [blame] | 313 | * @kobj: the kobject to add | 
|  | 314 | * @parent: pointer to the parent of the kobject. | 
|  | 315 | * @fmt: format to name the kobject with. | 
|  | 316 | * | 
|  | 317 | * The kobject name is set and added to the kobject hierarchy in this | 
|  | 318 | * function. | 
|  | 319 | * | 
|  | 320 | * If @parent is set, then the parent of the @kobj will be set to it. | 
|  | 321 | * If @parent is NULL, then the parent of the @kobj will be set to the | 
|  | 322 | * kobject associted with the kset assigned to this kobject.  If no kset | 
|  | 323 | * is assigned to the kobject, then the kobject will be located in the | 
|  | 324 | * root of the sysfs tree. | 
|  | 325 | * | 
|  | 326 | * If this function returns an error, kobject_put() must be called to | 
|  | 327 | * properly clean up the memory associated with the object. | 
| Greg Kroah-Hartman | 244f6ce | 2007-12-03 21:31:08 -0800 | [diff] [blame] | 328 | * Under no instance should the kobject that is passed to this function | 
|  | 329 | * be directly freed with a call to kfree(), that can leak memory. | 
|  | 330 | * | 
| Kay Sievers | 0f4dafc | 2007-12-19 01:40:42 +0100 | [diff] [blame] | 331 | * Note, no "add" uevent will be created with this call, the caller should set | 
| Greg Kroah-Hartman | 244f6ce | 2007-12-03 21:31:08 -0800 | [diff] [blame] | 332 | * up all of the necessary sysfs files for the object and then call | 
|  | 333 | * kobject_uevent() with the UEVENT_ADD parameter to ensure that | 
|  | 334 | * userspace is properly notified of this kobject's creation. | 
|  | 335 | */ | 
| Greg Kroah-Hartman | b2d6db5 | 2007-12-17 23:05:35 -0700 | [diff] [blame] | 336 | int kobject_add(struct kobject *kobj, struct kobject *parent, | 
|  | 337 | const char *fmt, ...) | 
| Greg Kroah-Hartman | 244f6ce | 2007-12-03 21:31:08 -0800 | [diff] [blame] | 338 | { | 
|  | 339 | va_list args; | 
|  | 340 | int retval; | 
|  | 341 |  | 
|  | 342 | if (!kobj) | 
|  | 343 | return -EINVAL; | 
|  | 344 |  | 
| Kay Sievers | 0f4dafc | 2007-12-19 01:40:42 +0100 | [diff] [blame] | 345 | if (!kobj->state_initialized) { | 
|  | 346 | printk(KERN_ERR "kobject '%s' (%p): tried to add an " | 
|  | 347 | "uninitialized object, something is seriously wrong.\n", | 
|  | 348 | kobject_name(kobj), kobj); | 
|  | 349 | dump_stack(); | 
|  | 350 | return -EINVAL; | 
|  | 351 | } | 
| Greg Kroah-Hartman | 244f6ce | 2007-12-03 21:31:08 -0800 | [diff] [blame] | 352 | va_start(args, fmt); | 
|  | 353 | retval = kobject_add_varg(kobj, parent, fmt, args); | 
|  | 354 | va_end(args); | 
|  | 355 |  | 
|  | 356 | return retval; | 
|  | 357 | } | 
| Greg Kroah-Hartman | b2d6db5 | 2007-12-17 23:05:35 -0700 | [diff] [blame] | 358 | EXPORT_SYMBOL(kobject_add); | 
| Greg Kroah-Hartman | 244f6ce | 2007-12-03 21:31:08 -0800 | [diff] [blame] | 359 |  | 
| Greg Kroah-Hartman | e86000d | 2007-12-03 21:31:08 -0800 | [diff] [blame] | 360 | /** | 
| Greg Kroah-Hartman | c11c4154 | 2007-12-03 21:31:08 -0800 | [diff] [blame] | 361 | * kobject_init_and_add - initialize a kobject structure and add it to the kobject hierarchy | 
|  | 362 | * @kobj: pointer to the kobject to initialize | 
|  | 363 | * @ktype: pointer to the ktype for this kobject. | 
|  | 364 | * @parent: pointer to the parent of this kobject. | 
|  | 365 | * @fmt: the name of the kobject. | 
|  | 366 | * | 
| Greg Kroah-Hartman | f9cb074 | 2007-12-17 23:05:35 -0700 | [diff] [blame] | 367 | * This function combines the call to kobject_init() and | 
| Greg Kroah-Hartman | b2d6db5 | 2007-12-17 23:05:35 -0700 | [diff] [blame] | 368 | * kobject_add().  The same type of error handling after a call to | 
|  | 369 | * kobject_add() and kobject lifetime rules are the same here. | 
| Greg Kroah-Hartman | c11c4154 | 2007-12-03 21:31:08 -0800 | [diff] [blame] | 370 | */ | 
|  | 371 | int kobject_init_and_add(struct kobject *kobj, struct kobj_type *ktype, | 
|  | 372 | struct kobject *parent, const char *fmt, ...) | 
|  | 373 | { | 
|  | 374 | va_list args; | 
|  | 375 | int retval; | 
|  | 376 |  | 
| Greg Kroah-Hartman | f9cb074 | 2007-12-17 23:05:35 -0700 | [diff] [blame] | 377 | kobject_init(kobj, ktype); | 
| Greg Kroah-Hartman | c11c4154 | 2007-12-03 21:31:08 -0800 | [diff] [blame] | 378 |  | 
|  | 379 | va_start(args, fmt); | 
|  | 380 | retval = kobject_add_varg(kobj, parent, fmt, args); | 
|  | 381 | va_end(args); | 
|  | 382 |  | 
|  | 383 | return retval; | 
|  | 384 | } | 
|  | 385 | EXPORT_SYMBOL_GPL(kobject_init_and_add); | 
|  | 386 |  | 
|  | 387 | /** | 
| Greg Kroah-Hartman | e374a2b | 2008-01-24 21:59:04 -0800 | [diff] [blame] | 388 | * kobject_rename - change the name of an object | 
|  | 389 | * @kobj: object in question. | 
|  | 390 | * @new_name: object's new name | 
| Eric W. Biederman | 030c1d2 | 2008-05-08 14:41:00 -0700 | [diff] [blame] | 391 | * | 
|  | 392 | * It is the responsibility of the caller to provide mutual | 
|  | 393 | * exclusion between two different calls of kobject_rename | 
|  | 394 | * on the same kobject and to ensure that new_name is valid and | 
|  | 395 | * won't conflict with other kobjects. | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 396 | */ | 
| Greg Kroah-Hartman | e374a2b | 2008-01-24 21:59:04 -0800 | [diff] [blame] | 397 | int kobject_rename(struct kobject *kobj, const char *new_name) | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 398 | { | 
|  | 399 | int error = 0; | 
| Jean Tourrilhes | ca2f37d | 2007-03-07 10:49:30 -0800 | [diff] [blame] | 400 | const char *devpath = NULL; | 
| Eric W. Biederman | 0b4a4fe | 2008-07-03 18:05:28 -0700 | [diff] [blame] | 401 | const char *dup_name = NULL, *name; | 
| Jean Tourrilhes | ca2f37d | 2007-03-07 10:49:30 -0800 | [diff] [blame] | 402 | char *devpath_string = NULL; | 
|  | 403 | char *envp[2]; | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 404 |  | 
|  | 405 | kobj = kobject_get(kobj); | 
|  | 406 | if (!kobj) | 
|  | 407 | return -EINVAL; | 
| Eric W. Biederman | b592fcf | 2007-01-24 12:35:52 -0700 | [diff] [blame] | 408 | if (!kobj->parent) | 
|  | 409 | return -EINVAL; | 
| Jean Tourrilhes | ca2f37d | 2007-03-07 10:49:30 -0800 | [diff] [blame] | 410 |  | 
|  | 411 | devpath = kobject_get_path(kobj, GFP_KERNEL); | 
|  | 412 | if (!devpath) { | 
|  | 413 | error = -ENOMEM; | 
|  | 414 | goto out; | 
|  | 415 | } | 
|  | 416 | devpath_string = kmalloc(strlen(devpath) + 15, GFP_KERNEL); | 
|  | 417 | if (!devpath_string) { | 
|  | 418 | error = -ENOMEM; | 
|  | 419 | goto out; | 
|  | 420 | } | 
|  | 421 | sprintf(devpath_string, "DEVPATH_OLD=%s", devpath); | 
|  | 422 | envp[0] = devpath_string; | 
|  | 423 | envp[1] = NULL; | 
| Jean Tourrilhes | ca2f37d | 2007-03-07 10:49:30 -0800 | [diff] [blame] | 424 |  | 
| Eric W. Biederman | 0b4a4fe | 2008-07-03 18:05:28 -0700 | [diff] [blame] | 425 | name = dup_name = kstrdup(new_name, GFP_KERNEL); | 
|  | 426 | if (!name) { | 
|  | 427 | error = -ENOMEM; | 
|  | 428 | goto out; | 
|  | 429 | } | 
|  | 430 |  | 
| Eric W. Biederman | 90bc613 | 2007-07-31 19:15:08 +0900 | [diff] [blame] | 431 | error = sysfs_rename_dir(kobj, new_name); | 
| Eric W. Biederman | 0b4a4fe | 2008-07-03 18:05:28 -0700 | [diff] [blame] | 432 | if (error) | 
|  | 433 | goto out; | 
|  | 434 |  | 
|  | 435 | /* Install the new kobject name */ | 
|  | 436 | dup_name = kobj->name; | 
|  | 437 | kobj->name = name; | 
| Jean Tourrilhes | ca2f37d | 2007-03-07 10:49:30 -0800 | [diff] [blame] | 438 |  | 
|  | 439 | /* This function is mostly/only used for network interface. | 
|  | 440 | * Some hotplug package track interfaces by their name and | 
|  | 441 | * therefore want to know when the name is changed by the user. */ | 
| Eric W. Biederman | 0b4a4fe | 2008-07-03 18:05:28 -0700 | [diff] [blame] | 442 | kobject_uevent_env(kobj, KOBJ_MOVE, envp); | 
| Jean Tourrilhes | ca2f37d | 2007-03-07 10:49:30 -0800 | [diff] [blame] | 443 |  | 
|  | 444 | out: | 
| Eric W. Biederman | 0b4a4fe | 2008-07-03 18:05:28 -0700 | [diff] [blame] | 445 | kfree(dup_name); | 
| Jean Tourrilhes | ca2f37d | 2007-03-07 10:49:30 -0800 | [diff] [blame] | 446 | kfree(devpath_string); | 
|  | 447 | kfree(devpath); | 
| Eric W. Biederman | b592fcf | 2007-01-24 12:35:52 -0700 | [diff] [blame] | 448 | kobject_put(kobj); | 
|  | 449 |  | 
|  | 450 | return error; | 
|  | 451 | } | 
| Alex Chiang | 8344b56 | 2008-06-10 15:30:42 -0600 | [diff] [blame] | 452 | EXPORT_SYMBOL_GPL(kobject_rename); | 
| Eric W. Biederman | b592fcf | 2007-01-24 12:35:52 -0700 | [diff] [blame] | 453 |  | 
|  | 454 | /** | 
| Greg Kroah-Hartman | e374a2b | 2008-01-24 21:59:04 -0800 | [diff] [blame] | 455 | * kobject_move - move object to another parent | 
|  | 456 | * @kobj: object in question. | 
|  | 457 | * @new_parent: object's new parent (can be NULL) | 
| Cornelia Huck | 8a82472 | 2006-11-20 17:07:51 +0100 | [diff] [blame] | 458 | */ | 
| Cornelia Huck | 8a82472 | 2006-11-20 17:07:51 +0100 | [diff] [blame] | 459 | int kobject_move(struct kobject *kobj, struct kobject *new_parent) | 
|  | 460 | { | 
|  | 461 | int error; | 
|  | 462 | struct kobject *old_parent; | 
|  | 463 | const char *devpath = NULL; | 
|  | 464 | char *devpath_string = NULL; | 
|  | 465 | char *envp[2]; | 
|  | 466 |  | 
|  | 467 | kobj = kobject_get(kobj); | 
|  | 468 | if (!kobj) | 
|  | 469 | return -EINVAL; | 
|  | 470 | new_parent = kobject_get(new_parent); | 
|  | 471 | if (!new_parent) { | 
| Cornelia Huck | c744aeae | 2007-01-08 20:16:44 +0100 | [diff] [blame] | 472 | if (kobj->kset) | 
|  | 473 | new_parent = kobject_get(&kobj->kset->kobj); | 
| Cornelia Huck | 8a82472 | 2006-11-20 17:07:51 +0100 | [diff] [blame] | 474 | } | 
|  | 475 | /* old object path */ | 
|  | 476 | devpath = kobject_get_path(kobj, GFP_KERNEL); | 
|  | 477 | if (!devpath) { | 
|  | 478 | error = -ENOMEM; | 
|  | 479 | goto out; | 
|  | 480 | } | 
|  | 481 | devpath_string = kmalloc(strlen(devpath) + 15, GFP_KERNEL); | 
|  | 482 | if (!devpath_string) { | 
|  | 483 | error = -ENOMEM; | 
|  | 484 | goto out; | 
|  | 485 | } | 
|  | 486 | sprintf(devpath_string, "DEVPATH_OLD=%s", devpath); | 
|  | 487 | envp[0] = devpath_string; | 
|  | 488 | envp[1] = NULL; | 
|  | 489 | error = sysfs_move_dir(kobj, new_parent); | 
|  | 490 | if (error) | 
|  | 491 | goto out; | 
|  | 492 | old_parent = kobj->parent; | 
|  | 493 | kobj->parent = new_parent; | 
| Dmitriy Monakhov | 9e993ef | 2007-03-03 16:11:21 +0300 | [diff] [blame] | 494 | new_parent = NULL; | 
| Cornelia Huck | 8a82472 | 2006-11-20 17:07:51 +0100 | [diff] [blame] | 495 | kobject_put(old_parent); | 
|  | 496 | kobject_uevent_env(kobj, KOBJ_MOVE, envp); | 
|  | 497 | out: | 
| Dmitriy Monakhov | 9e993ef | 2007-03-03 16:11:21 +0300 | [diff] [blame] | 498 | kobject_put(new_parent); | 
| Cornelia Huck | 8a82472 | 2006-11-20 17:07:51 +0100 | [diff] [blame] | 499 | kobject_put(kobj); | 
|  | 500 | kfree(devpath_string); | 
|  | 501 | kfree(devpath); | 
|  | 502 | return error; | 
|  | 503 | } | 
|  | 504 |  | 
|  | 505 | /** | 
| Greg Kroah-Hartman | e374a2b | 2008-01-24 21:59:04 -0800 | [diff] [blame] | 506 | * kobject_del - unlink kobject from hierarchy. | 
|  | 507 | * @kobj: object. | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 508 | */ | 
| Greg Kroah-Hartman | e374a2b | 2008-01-24 21:59:04 -0800 | [diff] [blame] | 509 | void kobject_del(struct kobject *kobj) | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 510 | { | 
| Greg Kroah-Hartman | 31b9025a | 2007-01-18 12:23:51 -0800 | [diff] [blame] | 511 | if (!kobj) | 
|  | 512 | return; | 
| Kay Sievers | 0f4dafc | 2007-12-19 01:40:42 +0100 | [diff] [blame] | 513 |  | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 514 | sysfs_remove_dir(kobj); | 
| Kay Sievers | 0f4dafc | 2007-12-19 01:40:42 +0100 | [diff] [blame] | 515 | kobj->state_in_sysfs = 0; | 
|  | 516 | kobj_kset_leave(kobj); | 
|  | 517 | kobject_put(kobj->parent); | 
|  | 518 | kobj->parent = NULL; | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 519 | } | 
|  | 520 |  | 
|  | 521 | /** | 
| Greg Kroah-Hartman | e374a2b | 2008-01-24 21:59:04 -0800 | [diff] [blame] | 522 | * kobject_get - increment refcount for object. | 
|  | 523 | * @kobj: object. | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 524 | */ | 
| Greg Kroah-Hartman | e374a2b | 2008-01-24 21:59:04 -0800 | [diff] [blame] | 525 | struct kobject *kobject_get(struct kobject *kobj) | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 526 | { | 
|  | 527 | if (kobj) | 
|  | 528 | kref_get(&kobj->kref); | 
|  | 529 | return kobj; | 
|  | 530 | } | 
|  | 531 |  | 
| Greg Kroah-Hartman | 18041f47 | 2007-12-03 21:31:08 -0800 | [diff] [blame] | 532 | /* | 
|  | 533 | * kobject_cleanup - free kobject resources. | 
|  | 534 | * @kobj: object to cleanup | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 535 | */ | 
| Greg Kroah-Hartman | 18041f47 | 2007-12-03 21:31:08 -0800 | [diff] [blame] | 536 | static void kobject_cleanup(struct kobject *kobj) | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 537 | { | 
| Kay Sievers | 0f4dafc | 2007-12-19 01:40:42 +0100 | [diff] [blame] | 538 | struct kobj_type *t = get_ktype(kobj); | 
| Kay Sievers | af5ca3f | 2007-12-20 02:09:39 +0100 | [diff] [blame] | 539 | const char *name = kobj->name; | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 540 |  | 
| Greg Kroah-Hartman | 9f66fa2 | 2007-11-28 23:49:41 -0800 | [diff] [blame] | 541 | pr_debug("kobject: '%s' (%p): %s\n", | 
| Harvey Harrison | 810304d | 2008-04-30 00:55:08 -0700 | [diff] [blame] | 542 | kobject_name(kobj), kobj, __func__); | 
| Kay Sievers | 0f4dafc | 2007-12-19 01:40:42 +0100 | [diff] [blame] | 543 |  | 
|  | 544 | if (t && !t->release) | 
|  | 545 | pr_debug("kobject: '%s' (%p): does not have a release() " | 
|  | 546 | "function, it is broken and must be fixed.\n", | 
|  | 547 | kobject_name(kobj), kobj); | 
|  | 548 |  | 
|  | 549 | /* send "remove" if the caller did not do it but sent "add" */ | 
|  | 550 | if (kobj->state_add_uevent_sent && !kobj->state_remove_uevent_sent) { | 
|  | 551 | pr_debug("kobject: '%s' (%p): auto cleanup 'remove' event\n", | 
|  | 552 | kobject_name(kobj), kobj); | 
|  | 553 | kobject_uevent(kobj, KOBJ_REMOVE); | 
|  | 554 | } | 
|  | 555 |  | 
|  | 556 | /* remove from sysfs if the caller did not do it */ | 
|  | 557 | if (kobj->state_in_sysfs) { | 
|  | 558 | pr_debug("kobject: '%s' (%p): auto cleanup kobject_del\n", | 
|  | 559 | kobject_name(kobj), kobj); | 
|  | 560 | kobject_del(kobj); | 
|  | 561 | } | 
|  | 562 |  | 
| Greg Kroah-Hartman | ce2c9cb | 2007-09-12 15:06:57 -0700 | [diff] [blame] | 563 | if (t && t->release) { | 
| Kay Sievers | 0f4dafc | 2007-12-19 01:40:42 +0100 | [diff] [blame] | 564 | pr_debug("kobject: '%s' (%p): calling ktype release\n", | 
|  | 565 | kobject_name(kobj), kobj); | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 566 | t->release(kobj); | 
| Kay Sievers | 0f4dafc | 2007-12-19 01:40:42 +0100 | [diff] [blame] | 567 | } | 
|  | 568 |  | 
|  | 569 | /* free name if we allocated it */ | 
| Kay Sievers | af5ca3f | 2007-12-20 02:09:39 +0100 | [diff] [blame] | 570 | if (name) { | 
| Kay Sievers | 0f4dafc | 2007-12-19 01:40:42 +0100 | [diff] [blame] | 571 | pr_debug("kobject: '%s': free name\n", name); | 
| Greg Kroah-Hartman | ce2c9cb | 2007-09-12 15:06:57 -0700 | [diff] [blame] | 572 | kfree(name); | 
|  | 573 | } | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 574 | } | 
|  | 575 |  | 
|  | 576 | static void kobject_release(struct kref *kref) | 
|  | 577 | { | 
|  | 578 | kobject_cleanup(container_of(kref, struct kobject, kref)); | 
|  | 579 | } | 
|  | 580 |  | 
|  | 581 | /** | 
| Greg Kroah-Hartman | e374a2b | 2008-01-24 21:59:04 -0800 | [diff] [blame] | 582 | * kobject_put - decrement refcount for object. | 
|  | 583 | * @kobj: object. | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 584 | * | 
| Greg Kroah-Hartman | e374a2b | 2008-01-24 21:59:04 -0800 | [diff] [blame] | 585 | * Decrement the refcount, and if 0, call kobject_cleanup(). | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 586 | */ | 
| Greg Kroah-Hartman | e374a2b | 2008-01-24 21:59:04 -0800 | [diff] [blame] | 587 | void kobject_put(struct kobject *kobj) | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 588 | { | 
| Greg Kroah-Hartman | c1ebdae | 2008-02-26 09:36:38 -0800 | [diff] [blame] | 589 | if (kobj) { | 
| Arjan van de Ven | d955c78 | 2008-07-25 01:45:55 -0700 | [diff] [blame] | 590 | if (!kobj->state_initialized) | 
|  | 591 | WARN(1, KERN_WARNING "kobject: '%s' (%p): is not " | 
| Greg Kroah-Hartman | c1ebdae | 2008-02-26 09:36:38 -0800 | [diff] [blame] | 592 | "initialized, yet kobject_put() is being " | 
|  | 593 | "called.\n", kobject_name(kobj), kobj); | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 594 | kref_put(&kobj->kref, kobject_release); | 
| Greg Kroah-Hartman | c1ebdae | 2008-02-26 09:36:38 -0800 | [diff] [blame] | 595 | } | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 596 | } | 
|  | 597 |  | 
| Greg Kroah-Hartman | 3f9e3ee | 2007-11-05 13:16:15 -0800 | [diff] [blame] | 598 | static void dynamic_kobj_release(struct kobject *kobj) | 
| Jun'ichi Nomura | 7423172 | 2006-03-13 17:14:25 -0500 | [diff] [blame] | 599 | { | 
| Harvey Harrison | 810304d | 2008-04-30 00:55:08 -0700 | [diff] [blame] | 600 | pr_debug("kobject: (%p): %s\n", kobj, __func__); | 
| Jun'ichi Nomura | 7423172 | 2006-03-13 17:14:25 -0500 | [diff] [blame] | 601 | kfree(kobj); | 
|  | 602 | } | 
|  | 603 |  | 
| Greg Kroah-Hartman | 3f9e3ee | 2007-11-05 13:16:15 -0800 | [diff] [blame] | 604 | static struct kobj_type dynamic_kobj_ktype = { | 
| Kay Sievers | 386f275 | 2007-11-02 13:47:53 +0100 | [diff] [blame] | 605 | .release	= dynamic_kobj_release, | 
|  | 606 | .sysfs_ops	= &kobj_sysfs_ops, | 
| Jun'ichi Nomura | 7423172 | 2006-03-13 17:14:25 -0500 | [diff] [blame] | 607 | }; | 
|  | 608 |  | 
| Greg Kroah-Hartman | 43968d2 | 2007-11-05 22:24:43 -0800 | [diff] [blame] | 609 | /** | 
| Greg Kroah-Hartman | 3f9e3ee | 2007-11-05 13:16:15 -0800 | [diff] [blame] | 610 | * kobject_create - create a struct kobject dynamically | 
|  | 611 | * | 
|  | 612 | * This function creates a kobject structure dynamically and sets it up | 
|  | 613 | * to be a "dynamic" kobject with a default release function set up. | 
|  | 614 | * | 
|  | 615 | * If the kobject was not able to be created, NULL will be returned. | 
| Greg Kroah-Hartman | 43968d2 | 2007-11-05 22:24:43 -0800 | [diff] [blame] | 616 | * The kobject structure returned from here must be cleaned up with a | 
| Greg Kroah-Hartman | f9cb074 | 2007-12-17 23:05:35 -0700 | [diff] [blame] | 617 | * call to kobject_put() and not kfree(), as kobject_init() has | 
| Greg Kroah-Hartman | 43968d2 | 2007-11-05 22:24:43 -0800 | [diff] [blame] | 618 | * already been called on this structure. | 
| Greg Kroah-Hartman | 3f9e3ee | 2007-11-05 13:16:15 -0800 | [diff] [blame] | 619 | */ | 
| Greg Kroah-Hartman | 43968d2 | 2007-11-05 22:24:43 -0800 | [diff] [blame] | 620 | struct kobject *kobject_create(void) | 
| Greg Kroah-Hartman | 3f9e3ee | 2007-11-05 13:16:15 -0800 | [diff] [blame] | 621 | { | 
|  | 622 | struct kobject *kobj; | 
|  | 623 |  | 
|  | 624 | kobj = kzalloc(sizeof(*kobj), GFP_KERNEL); | 
|  | 625 | if (!kobj) | 
|  | 626 | return NULL; | 
|  | 627 |  | 
| Greg Kroah-Hartman | f9cb074 | 2007-12-17 23:05:35 -0700 | [diff] [blame] | 628 | kobject_init(kobj, &dynamic_kobj_ktype); | 
| Greg Kroah-Hartman | 3f9e3ee | 2007-11-05 13:16:15 -0800 | [diff] [blame] | 629 | return kobj; | 
|  | 630 | } | 
|  | 631 |  | 
|  | 632 | /** | 
|  | 633 | * kobject_create_and_add - create a struct kobject dynamically and register it with sysfs | 
|  | 634 | * | 
|  | 635 | * @name: the name for the kset | 
|  | 636 | * @parent: the parent kobject of this kobject, if any. | 
|  | 637 | * | 
| Dave Young | f70701a | 2008-01-28 16:58:00 +0800 | [diff] [blame] | 638 | * This function creates a kobject structure dynamically and registers it | 
| Greg Kroah-Hartman | 3f9e3ee | 2007-11-05 13:16:15 -0800 | [diff] [blame] | 639 | * with sysfs.  When you are finished with this structure, call | 
| Greg Kroah-Hartman | 78a2d90 | 2007-12-20 08:13:05 -0800 | [diff] [blame] | 640 | * kobject_put() and the structure will be dynamically freed when | 
| Greg Kroah-Hartman | 3f9e3ee | 2007-11-05 13:16:15 -0800 | [diff] [blame] | 641 | * it is no longer being used. | 
|  | 642 | * | 
|  | 643 | * If the kobject was not able to be created, NULL will be returned. | 
|  | 644 | */ | 
|  | 645 | struct kobject *kobject_create_and_add(const char *name, struct kobject *parent) | 
|  | 646 | { | 
|  | 647 | struct kobject *kobj; | 
|  | 648 | int retval; | 
|  | 649 |  | 
|  | 650 | kobj = kobject_create(); | 
|  | 651 | if (!kobj) | 
|  | 652 | return NULL; | 
|  | 653 |  | 
| Greg Kroah-Hartman | b2d6db5 | 2007-12-17 23:05:35 -0700 | [diff] [blame] | 654 | retval = kobject_add(kobj, parent, "%s", name); | 
| Greg Kroah-Hartman | 3f9e3ee | 2007-11-05 13:16:15 -0800 | [diff] [blame] | 655 | if (retval) { | 
|  | 656 | printk(KERN_WARNING "%s: kobject_add error: %d\n", | 
| Harvey Harrison | 810304d | 2008-04-30 00:55:08 -0700 | [diff] [blame] | 657 | __func__, retval); | 
| Greg Kroah-Hartman | 3f9e3ee | 2007-11-05 13:16:15 -0800 | [diff] [blame] | 658 | kobject_put(kobj); | 
|  | 659 | kobj = NULL; | 
|  | 660 | } | 
|  | 661 | return kobj; | 
|  | 662 | } | 
|  | 663 | EXPORT_SYMBOL_GPL(kobject_create_and_add); | 
|  | 664 |  | 
| Jun'ichi Nomura | 7423172 | 2006-03-13 17:14:25 -0500 | [diff] [blame] | 665 | /** | 
| Greg Kroah-Hartman | e374a2b | 2008-01-24 21:59:04 -0800 | [diff] [blame] | 666 | * kset_init - initialize a kset for use | 
|  | 667 | * @k: kset | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 668 | */ | 
| Greg Kroah-Hartman | e374a2b | 2008-01-24 21:59:04 -0800 | [diff] [blame] | 669 | void kset_init(struct kset *k) | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 670 | { | 
| Greg Kroah-Hartman | e1543dd | 2007-12-17 23:05:35 -0700 | [diff] [blame] | 671 | kobject_init_internal(&k->kobj); | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 672 | INIT_LIST_HEAD(&k->list); | 
|  | 673 | spin_lock_init(&k->list_lock); | 
|  | 674 | } | 
|  | 675 |  | 
| Kay Sievers | 23b5212 | 2007-11-02 13:47:53 +0100 | [diff] [blame] | 676 | /* default kobject attribute operations */ | 
|  | 677 | static ssize_t kobj_attr_show(struct kobject *kobj, struct attribute *attr, | 
|  | 678 | char *buf) | 
|  | 679 | { | 
|  | 680 | struct kobj_attribute *kattr; | 
|  | 681 | ssize_t ret = -EIO; | 
|  | 682 |  | 
|  | 683 | kattr = container_of(attr, struct kobj_attribute, attr); | 
|  | 684 | if (kattr->show) | 
|  | 685 | ret = kattr->show(kobj, kattr, buf); | 
|  | 686 | return ret; | 
|  | 687 | } | 
|  | 688 |  | 
|  | 689 | static ssize_t kobj_attr_store(struct kobject *kobj, struct attribute *attr, | 
|  | 690 | const char *buf, size_t count) | 
|  | 691 | { | 
|  | 692 | struct kobj_attribute *kattr; | 
|  | 693 | ssize_t ret = -EIO; | 
|  | 694 |  | 
|  | 695 | kattr = container_of(attr, struct kobj_attribute, attr); | 
|  | 696 | if (kattr->store) | 
|  | 697 | ret = kattr->store(kobj, kattr, buf, count); | 
|  | 698 | return ret; | 
|  | 699 | } | 
|  | 700 |  | 
| Emese Revfy | 52cf25d | 2010-01-19 02:58:23 +0100 | [diff] [blame] | 701 | const struct sysfs_ops kobj_sysfs_ops = { | 
| Kay Sievers | 23b5212 | 2007-11-02 13:47:53 +0100 | [diff] [blame] | 702 | .show	= kobj_attr_show, | 
|  | 703 | .store	= kobj_attr_store, | 
|  | 704 | }; | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 705 |  | 
|  | 706 | /** | 
| Greg Kroah-Hartman | e374a2b | 2008-01-24 21:59:04 -0800 | [diff] [blame] | 707 | * kset_register - initialize and add a kset. | 
|  | 708 | * @k: kset. | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 709 | */ | 
| Greg Kroah-Hartman | e374a2b | 2008-01-24 21:59:04 -0800 | [diff] [blame] | 710 | int kset_register(struct kset *k) | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 711 | { | 
| Kay Sievers | 80f03e3 | 2007-05-26 11:21:36 +0200 | [diff] [blame] | 712 | int err; | 
|  | 713 |  | 
| Greg Kroah-Hartman | 31b9025a | 2007-01-18 12:23:51 -0800 | [diff] [blame] | 714 | if (!k) | 
|  | 715 | return -EINVAL; | 
| Kay Sievers | 80f03e3 | 2007-05-26 11:21:36 +0200 | [diff] [blame] | 716 |  | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 717 | kset_init(k); | 
| Greg Kroah-Hartman | 12e339a | 2002-04-09 12:14:34 -0700 | [diff] [blame] | 718 | err = kobject_add_internal(&k->kobj); | 
| Kay Sievers | 80f03e3 | 2007-05-26 11:21:36 +0200 | [diff] [blame] | 719 | if (err) | 
|  | 720 | return err; | 
|  | 721 | kobject_uevent(&k->kobj, KOBJ_ADD); | 
|  | 722 | return 0; | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 723 | } | 
|  | 724 |  | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 725 | /** | 
| Greg Kroah-Hartman | e374a2b | 2008-01-24 21:59:04 -0800 | [diff] [blame] | 726 | * kset_unregister - remove a kset. | 
|  | 727 | * @k: kset. | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 728 | */ | 
| Greg Kroah-Hartman | e374a2b | 2008-01-24 21:59:04 -0800 | [diff] [blame] | 729 | void kset_unregister(struct kset *k) | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 730 | { | 
| Greg Kroah-Hartman | 31b9025a | 2007-01-18 12:23:51 -0800 | [diff] [blame] | 731 | if (!k) | 
|  | 732 | return; | 
| Greg Kroah-Hartman | 78a2d90 | 2007-12-20 08:13:05 -0800 | [diff] [blame] | 733 | kobject_put(&k->kobj); | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 734 | } | 
|  | 735 |  | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 736 | /** | 
| Greg Kroah-Hartman | e374a2b | 2008-01-24 21:59:04 -0800 | [diff] [blame] | 737 | * kset_find_obj - search for object in kset. | 
|  | 738 | * @kset: kset we're looking in. | 
|  | 739 | * @name: object's name. | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 740 | * | 
| Greg Kroah-Hartman | e374a2b | 2008-01-24 21:59:04 -0800 | [diff] [blame] | 741 | * Lock kset via @kset->subsys, and iterate over @kset->list, | 
|  | 742 | * looking for a matching kobject. If matching object is found | 
|  | 743 | * take a reference and return the object. | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 744 | */ | 
| Greg Kroah-Hartman | e374a2b | 2008-01-24 21:59:04 -0800 | [diff] [blame] | 745 | struct kobject *kset_find_obj(struct kset *kset, const char *name) | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 746 | { | 
| Robert P. J. Day | c6a2a3d | 2008-03-27 01:13:34 -0400 | [diff] [blame] | 747 | struct kobject *k; | 
| Greg Kroah-Hartman | e374a2b | 2008-01-24 21:59:04 -0800 | [diff] [blame] | 748 | struct kobject *ret = NULL; | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 749 |  | 
|  | 750 | spin_lock(&kset->list_lock); | 
| Robin Holt | c25d1df | 2010-09-29 14:00:54 -0500 | [diff] [blame] | 751 |  | 
| Robert P. J. Day | c6a2a3d | 2008-03-27 01:13:34 -0400 | [diff] [blame] | 752 | list_for_each_entry(k, &kset->list, entry) { | 
| Greg Kroah-Hartman | e374a2b | 2008-01-24 21:59:04 -0800 | [diff] [blame] | 753 | if (kobject_name(k) && !strcmp(kobject_name(k), name)) { | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 754 | ret = kobject_get(k); | 
|  | 755 | break; | 
|  | 756 | } | 
|  | 757 | } | 
| Robin Holt | c25d1df | 2010-09-29 14:00:54 -0500 | [diff] [blame] | 758 |  | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 759 | spin_unlock(&kset->list_lock); | 
|  | 760 | return ret; | 
|  | 761 | } | 
|  | 762 |  | 
| Greg Kroah-Hartman | b727c70 | 2007-09-27 14:48:53 -0700 | [diff] [blame] | 763 | static void kset_release(struct kobject *kobj) | 
|  | 764 | { | 
|  | 765 | struct kset *kset = container_of(kobj, struct kset, kobj); | 
| Greg Kroah-Hartman | 9f66fa2 | 2007-11-28 23:49:41 -0800 | [diff] [blame] | 766 | pr_debug("kobject: '%s' (%p): %s\n", | 
| Harvey Harrison | 810304d | 2008-04-30 00:55:08 -0700 | [diff] [blame] | 767 | kobject_name(kobj), kobj, __func__); | 
| Greg Kroah-Hartman | b727c70 | 2007-09-27 14:48:53 -0700 | [diff] [blame] | 768 | kfree(kset); | 
|  | 769 | } | 
|  | 770 |  | 
| Kay Sievers | 386f275 | 2007-11-02 13:47:53 +0100 | [diff] [blame] | 771 | static struct kobj_type kset_ktype = { | 
|  | 772 | .sysfs_ops	= &kobj_sysfs_ops, | 
| Greg Kroah-Hartman | b727c70 | 2007-09-27 14:48:53 -0700 | [diff] [blame] | 773 | .release = kset_release, | 
|  | 774 | }; | 
|  | 775 |  | 
|  | 776 | /** | 
|  | 777 | * kset_create - create a struct kset dynamically | 
|  | 778 | * | 
|  | 779 | * @name: the name for the kset | 
|  | 780 | * @uevent_ops: a struct kset_uevent_ops for the kset | 
|  | 781 | * @parent_kobj: the parent kobject of this kset, if any. | 
|  | 782 | * | 
|  | 783 | * This function creates a kset structure dynamically.  This structure can | 
|  | 784 | * then be registered with the system and show up in sysfs with a call to | 
|  | 785 | * kset_register().  When you are finished with this structure, if | 
|  | 786 | * kset_register() has been called, call kset_unregister() and the | 
|  | 787 | * structure will be dynamically freed when it is no longer being used. | 
|  | 788 | * | 
|  | 789 | * If the kset was not able to be created, NULL will be returned. | 
|  | 790 | */ | 
|  | 791 | static struct kset *kset_create(const char *name, | 
| Emese Revfy | 9cd4361 | 2009-12-31 14:52:51 +0100 | [diff] [blame] | 792 | const struct kset_uevent_ops *uevent_ops, | 
| Greg Kroah-Hartman | b727c70 | 2007-09-27 14:48:53 -0700 | [diff] [blame] | 793 | struct kobject *parent_kobj) | 
|  | 794 | { | 
|  | 795 | struct kset *kset; | 
| Dave Young | d9cd8f3 | 2009-05-11 14:17:45 +0800 | [diff] [blame] | 796 | int retval; | 
| Greg Kroah-Hartman | b727c70 | 2007-09-27 14:48:53 -0700 | [diff] [blame] | 797 |  | 
|  | 798 | kset = kzalloc(sizeof(*kset), GFP_KERNEL); | 
|  | 799 | if (!kset) | 
|  | 800 | return NULL; | 
| Dave Young | d9cd8f3 | 2009-05-11 14:17:45 +0800 | [diff] [blame] | 801 | retval = kobject_set_name(&kset->kobj, name); | 
|  | 802 | if (retval) { | 
|  | 803 | kfree(kset); | 
|  | 804 | return NULL; | 
|  | 805 | } | 
| Greg Kroah-Hartman | b727c70 | 2007-09-27 14:48:53 -0700 | [diff] [blame] | 806 | kset->uevent_ops = uevent_ops; | 
|  | 807 | kset->kobj.parent = parent_kobj; | 
|  | 808 |  | 
|  | 809 | /* | 
| Kay Sievers | 386f275 | 2007-11-02 13:47:53 +0100 | [diff] [blame] | 810 | * The kobject of this kset will have a type of kset_ktype and belong to | 
| Greg Kroah-Hartman | b727c70 | 2007-09-27 14:48:53 -0700 | [diff] [blame] | 811 | * no kset itself.  That way we can properly free it when it is | 
|  | 812 | * finished being used. | 
|  | 813 | */ | 
| Kay Sievers | 386f275 | 2007-11-02 13:47:53 +0100 | [diff] [blame] | 814 | kset->kobj.ktype = &kset_ktype; | 
| Greg Kroah-Hartman | b727c70 | 2007-09-27 14:48:53 -0700 | [diff] [blame] | 815 | kset->kobj.kset = NULL; | 
|  | 816 |  | 
|  | 817 | return kset; | 
|  | 818 | } | 
|  | 819 |  | 
|  | 820 | /** | 
|  | 821 | * kset_create_and_add - create a struct kset dynamically and add it to sysfs | 
|  | 822 | * | 
|  | 823 | * @name: the name for the kset | 
|  | 824 | * @uevent_ops: a struct kset_uevent_ops for the kset | 
|  | 825 | * @parent_kobj: the parent kobject of this kset, if any. | 
|  | 826 | * | 
|  | 827 | * This function creates a kset structure dynamically and registers it | 
|  | 828 | * with sysfs.  When you are finished with this structure, call | 
|  | 829 | * kset_unregister() and the structure will be dynamically freed when it | 
|  | 830 | * is no longer being used. | 
|  | 831 | * | 
|  | 832 | * If the kset was not able to be created, NULL will be returned. | 
|  | 833 | */ | 
|  | 834 | struct kset *kset_create_and_add(const char *name, | 
| Emese Revfy | 9cd4361 | 2009-12-31 14:52:51 +0100 | [diff] [blame] | 835 | const struct kset_uevent_ops *uevent_ops, | 
| Greg Kroah-Hartman | b727c70 | 2007-09-27 14:48:53 -0700 | [diff] [blame] | 836 | struct kobject *parent_kobj) | 
|  | 837 | { | 
|  | 838 | struct kset *kset; | 
|  | 839 | int error; | 
|  | 840 |  | 
|  | 841 | kset = kset_create(name, uevent_ops, parent_kobj); | 
|  | 842 | if (!kset) | 
|  | 843 | return NULL; | 
|  | 844 | error = kset_register(kset); | 
|  | 845 | if (error) { | 
|  | 846 | kfree(kset); | 
|  | 847 | return NULL; | 
|  | 848 | } | 
|  | 849 | return kset; | 
|  | 850 | } | 
|  | 851 | EXPORT_SYMBOL_GPL(kset_create_and_add); | 
|  | 852 |  | 
| Eric W. Biederman | bc451f2 | 2010-03-30 11:31:25 -0700 | [diff] [blame] | 853 |  | 
|  | 854 | static DEFINE_SPINLOCK(kobj_ns_type_lock); | 
|  | 855 | static const struct kobj_ns_type_operations *kobj_ns_ops_tbl[KOBJ_NS_TYPES]; | 
|  | 856 |  | 
|  | 857 | int kobj_ns_type_register(const struct kobj_ns_type_operations *ops) | 
|  | 858 | { | 
|  | 859 | enum kobj_ns_type type = ops->type; | 
|  | 860 | int error; | 
|  | 861 |  | 
|  | 862 | spin_lock(&kobj_ns_type_lock); | 
|  | 863 |  | 
|  | 864 | error = -EINVAL; | 
|  | 865 | if (type >= KOBJ_NS_TYPES) | 
|  | 866 | goto out; | 
|  | 867 |  | 
|  | 868 | error = -EINVAL; | 
|  | 869 | if (type <= KOBJ_NS_TYPE_NONE) | 
|  | 870 | goto out; | 
|  | 871 |  | 
|  | 872 | error = -EBUSY; | 
|  | 873 | if (kobj_ns_ops_tbl[type]) | 
|  | 874 | goto out; | 
|  | 875 |  | 
|  | 876 | error = 0; | 
|  | 877 | kobj_ns_ops_tbl[type] = ops; | 
|  | 878 |  | 
|  | 879 | out: | 
|  | 880 | spin_unlock(&kobj_ns_type_lock); | 
|  | 881 | return error; | 
|  | 882 | } | 
|  | 883 |  | 
|  | 884 | int kobj_ns_type_registered(enum kobj_ns_type type) | 
|  | 885 | { | 
|  | 886 | int registered = 0; | 
|  | 887 |  | 
|  | 888 | spin_lock(&kobj_ns_type_lock); | 
|  | 889 | if ((type > KOBJ_NS_TYPE_NONE) && (type < KOBJ_NS_TYPES)) | 
|  | 890 | registered = kobj_ns_ops_tbl[type] != NULL; | 
|  | 891 | spin_unlock(&kobj_ns_type_lock); | 
|  | 892 |  | 
|  | 893 | return registered; | 
|  | 894 | } | 
|  | 895 |  | 
|  | 896 | const struct kobj_ns_type_operations *kobj_child_ns_ops(struct kobject *parent) | 
|  | 897 | { | 
|  | 898 | const struct kobj_ns_type_operations *ops = NULL; | 
|  | 899 |  | 
|  | 900 | if (parent && parent->ktype->child_ns_type) | 
|  | 901 | ops = parent->ktype->child_ns_type(parent); | 
|  | 902 |  | 
|  | 903 | return ops; | 
|  | 904 | } | 
|  | 905 |  | 
|  | 906 | const struct kobj_ns_type_operations *kobj_ns_ops(struct kobject *kobj) | 
|  | 907 | { | 
|  | 908 | return kobj_child_ns_ops(kobj->parent); | 
|  | 909 | } | 
|  | 910 |  | 
|  | 911 |  | 
| Al Viro | a685e08 | 2011-06-08 21:13:01 -0400 | [diff] [blame] | 912 | void *kobj_ns_grab_current(enum kobj_ns_type type) | 
| Eric W. Biederman | bc451f2 | 2010-03-30 11:31:25 -0700 | [diff] [blame] | 913 | { | 
| Al Viro | a685e08 | 2011-06-08 21:13:01 -0400 | [diff] [blame] | 914 | void *ns = NULL; | 
| Eric W. Biederman | bc451f2 | 2010-03-30 11:31:25 -0700 | [diff] [blame] | 915 |  | 
|  | 916 | spin_lock(&kobj_ns_type_lock); | 
|  | 917 | if ((type > KOBJ_NS_TYPE_NONE) && (type < KOBJ_NS_TYPES) && | 
|  | 918 | kobj_ns_ops_tbl[type]) | 
| Al Viro | a685e08 | 2011-06-08 21:13:01 -0400 | [diff] [blame] | 919 | ns = kobj_ns_ops_tbl[type]->grab_current_ns(); | 
| Eric W. Biederman | bc451f2 | 2010-03-30 11:31:25 -0700 | [diff] [blame] | 920 | spin_unlock(&kobj_ns_type_lock); | 
|  | 921 |  | 
|  | 922 | return ns; | 
|  | 923 | } | 
|  | 924 |  | 
|  | 925 | const void *kobj_ns_netlink(enum kobj_ns_type type, struct sock *sk) | 
|  | 926 | { | 
|  | 927 | const void *ns = NULL; | 
|  | 928 |  | 
|  | 929 | spin_lock(&kobj_ns_type_lock); | 
|  | 930 | if ((type > KOBJ_NS_TYPE_NONE) && (type < KOBJ_NS_TYPES) && | 
|  | 931 | kobj_ns_ops_tbl[type]) | 
|  | 932 | ns = kobj_ns_ops_tbl[type]->netlink_ns(sk); | 
|  | 933 | spin_unlock(&kobj_ns_type_lock); | 
|  | 934 |  | 
|  | 935 | return ns; | 
|  | 936 | } | 
|  | 937 |  | 
|  | 938 | const void *kobj_ns_initial(enum kobj_ns_type type) | 
|  | 939 | { | 
|  | 940 | const void *ns = NULL; | 
|  | 941 |  | 
|  | 942 | spin_lock(&kobj_ns_type_lock); | 
|  | 943 | if ((type > KOBJ_NS_TYPE_NONE) && (type < KOBJ_NS_TYPES) && | 
|  | 944 | kobj_ns_ops_tbl[type]) | 
|  | 945 | ns = kobj_ns_ops_tbl[type]->initial_ns(); | 
|  | 946 | spin_unlock(&kobj_ns_type_lock); | 
|  | 947 |  | 
|  | 948 | return ns; | 
|  | 949 | } | 
|  | 950 |  | 
| Al Viro | a685e08 | 2011-06-08 21:13:01 -0400 | [diff] [blame] | 951 | void kobj_ns_drop(enum kobj_ns_type type, void *ns) | 
| Eric W. Biederman | bc451f2 | 2010-03-30 11:31:25 -0700 | [diff] [blame] | 952 | { | 
| Al Viro | a685e08 | 2011-06-08 21:13:01 -0400 | [diff] [blame] | 953 | spin_lock(&kobj_ns_type_lock); | 
|  | 954 | if ((type > KOBJ_NS_TYPE_NONE) && (type < KOBJ_NS_TYPES) && | 
|  | 955 | kobj_ns_ops_tbl[type] && kobj_ns_ops_tbl[type]->drop_ns) | 
|  | 956 | kobj_ns_ops_tbl[type]->drop_ns(ns); | 
|  | 957 | spin_unlock(&kobj_ns_type_lock); | 
| Eric W. Biederman | bc451f2 | 2010-03-30 11:31:25 -0700 | [diff] [blame] | 958 | } | 
|  | 959 |  | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 960 | EXPORT_SYMBOL(kobject_get); | 
|  | 961 | EXPORT_SYMBOL(kobject_put); | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 962 | EXPORT_SYMBOL(kobject_del); | 
|  | 963 |  | 
|  | 964 | EXPORT_SYMBOL(kset_register); | 
|  | 965 | EXPORT_SYMBOL(kset_unregister); |