Blame view
lib/kobject_uevent.c
7.98 KB
1da177e4c
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 |
/* * kernel userspace event delivery * * Copyright (C) 2004 Red Hat, Inc. All rights reserved. * Copyright (C) 2004 Novell, Inc. All rights reserved. * Copyright (C) 2004 IBM, Inc. All rights reserved. * * Licensed under the GNU GPL v2. * * Authors: * Robert Love <rml@novell.com> * Kay Sievers <kay.sievers@vrfy.org> * Arjan van de Ven <arjanv@redhat.com> * Greg Kroah-Hartman <greg@kroah.com> */ #include <linux/spinlock.h> |
2d38f9a4f
|
18 19 20 |
#include <linux/string.h> #include <linux/kobject.h> #include <linux/module.h> |
1da177e4c
|
21 22 23 |
#include <linux/socket.h> #include <linux/skbuff.h> #include <linux/netlink.h> |
1da177e4c
|
24 |
#include <net/sock.h> |
1da177e4c
|
25 |
|
cd030c4cb
|
26 |
u64 uevent_seqnum; |
6a8d8abb6
|
27 |
char uevent_helper[UEVENT_HELPER_PATH_LEN] = CONFIG_UEVENT_HELPER_PATH; |
cd030c4cb
|
28 29 30 31 |
static DEFINE_SPINLOCK(sequence_lock); #if defined(CONFIG_NET) static struct sock *uevent_sock; #endif |
5c5daf657
|
32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 |
/* the strings here must match the enum in include/linux/kobject.h */ static const char *kobject_actions[] = { [KOBJ_ADD] = "add", [KOBJ_REMOVE] = "remove", [KOBJ_CHANGE] = "change", [KOBJ_MOVE] = "move", [KOBJ_ONLINE] = "online", [KOBJ_OFFLINE] = "offline", }; /** * kobject_action_type - translate action string to numeric type * * @buf: buffer containing the action string, newline is ignored * @len: length of buffer * @type: pointer to the location to store the action type * * Returns 0 if the action string was recognized. */ int kobject_action_type(const char *buf, size_t count, enum kobject_action *type) { enum kobject_action action; int ret = -EINVAL; |
a9edadbf7
|
56 57 |
if (count && (buf[count-1] == ' ' || buf[count-1] == '\0')) |
5c5daf657
|
58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 |
count--; if (!count) goto out; for (action = 0; action < ARRAY_SIZE(kobject_actions); action++) { if (strncmp(kobject_actions[action], buf, count) != 0) continue; if (kobject_actions[action][count] != '\0') continue; *type = action; ret = 0; break; } out: return ret; } |
1da177e4c
|
75 |
/** |
8a82472f8
|
76 |
* kobject_uevent_env - send an uevent with environmental data |
1da177e4c
|
77 |
* |
ccd490a3c
|
78 |
* @action: action that is happening |
1da177e4c
|
79 |
* @kobj: struct kobject that the action is happening to |
8a82472f8
|
80 |
* @envp_ext: pointer to environmental data |
542cfce6f
|
81 82 83 |
* * Returns 0 if kobject_uevent() is completed with success or the * corresponding error when it fails. |
1da177e4c
|
84 |
*/ |
542cfce6f
|
85 |
int kobject_uevent_env(struct kobject *kobj, enum kobject_action action, |
7eff2e7a8
|
86 |
char *envp_ext[]) |
1da177e4c
|
87 |
{ |
7eff2e7a8
|
88 89 |
struct kobj_uevent_env *env; const char *action_string = kobject_actions[action]; |
5f123fbd8
|
90 91 92 93 |
const char *devpath = NULL; const char *subsystem; struct kobject *top_kobj; struct kset *kset; |
312c004d3
|
94 |
struct kset_uevent_ops *uevent_ops; |
5f123fbd8
|
95 |
u64 seq; |
1da177e4c
|
96 |
int i = 0; |
542cfce6f
|
97 |
int retval = 0; |
1da177e4c
|
98 |
|
9f66fa2a4
|
99 100 |
pr_debug("kobject: '%s' (%p): %s ", |
810304db7
|
101 |
kobject_name(kobj), kobj, __func__); |
5f123fbd8
|
102 |
|
5f123fbd8
|
103 104 |
/* search the kset we belong to */ top_kobj = kobj; |
ccd490a3c
|
105 |
while (!top_kobj->kset && top_kobj->parent) |
14193fb91
|
106 |
top_kobj = top_kobj->parent; |
ccd490a3c
|
107 |
|
542cfce6f
|
108 |
if (!top_kobj->kset) { |
9f66fa2a4
|
109 110 111 |
pr_debug("kobject: '%s' (%p): %s: attempted to send uevent " "without kset! ", kobject_name(kobj), kobj, |
810304db7
|
112 |
__func__); |
542cfce6f
|
113 114 |
return -EINVAL; } |
1da177e4c
|
115 |
|
5f123fbd8
|
116 |
kset = top_kobj->kset; |
312c004d3
|
117 |
uevent_ops = kset->uevent_ops; |
1da177e4c
|
118 |
|
7eff2e7a8
|
119 |
/* skip the event, if the filter returns zero. */ |
312c004d3
|
120 |
if (uevent_ops && uevent_ops->filter) |
542cfce6f
|
121 |
if (!uevent_ops->filter(kset, kobj)) { |
9f66fa2a4
|
122 123 124 |
pr_debug("kobject: '%s' (%p): %s: filter function " "caused the event to drop! ", |
810304db7
|
125 |
kobject_name(kobj), kobj, __func__); |
542cfce6f
|
126 127 |
return 0; } |
1da177e4c
|
128 |
|
864062457
|
129 130 131 132 133 134 |
/* originating subsystem */ if (uevent_ops && uevent_ops->name) subsystem = uevent_ops->name(kset, kobj); else subsystem = kobject_name(&kset->kobj); if (!subsystem) { |
9f66fa2a4
|
135 136 137 |
pr_debug("kobject: '%s' (%p): %s: unset subsystem caused the " "event to drop! ", kobject_name(kobj), kobj, |
810304db7
|
138 |
__func__); |
864062457
|
139 140 |
return 0; } |
7eff2e7a8
|
141 142 143 |
/* environment buffer */ env = kzalloc(sizeof(struct kobj_uevent_env), GFP_KERNEL); if (!env) |
542cfce6f
|
144 |
return -ENOMEM; |
1da177e4c
|
145 |
|
5f123fbd8
|
146 147 |
/* complete object path */ devpath = kobject_get_path(kobj, GFP_KERNEL); |
542cfce6f
|
148 149 |
if (!devpath) { retval = -ENOENT; |
5f123fbd8
|
150 |
goto exit; |
542cfce6f
|
151 |
} |
1da177e4c
|
152 |
|
5f123fbd8
|
153 |
/* default keys */ |
7eff2e7a8
|
154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 |
retval = add_uevent_var(env, "ACTION=%s", action_string); if (retval) goto exit; retval = add_uevent_var(env, "DEVPATH=%s", devpath); if (retval) goto exit; retval = add_uevent_var(env, "SUBSYSTEM=%s", subsystem); if (retval) goto exit; /* keys passed in from the caller */ if (envp_ext) { for (i = 0; envp_ext[i]; i++) { retval = add_uevent_var(env, envp_ext[i]); if (retval) goto exit; } } |
1da177e4c
|
172 |
|
5f123fbd8
|
173 |
/* let the kset specific function add its stuff */ |
312c004d3
|
174 |
if (uevent_ops && uevent_ops->uevent) { |
7eff2e7a8
|
175 |
retval = uevent_ops->uevent(kset, kobj, env); |
1da177e4c
|
176 |
if (retval) { |
9f66fa2a4
|
177 178 179 |
pr_debug("kobject: '%s' (%p): %s: uevent() returned " "%d ", kobject_name(kobj), kobj, |
810304db7
|
180 |
__func__, retval); |
1da177e4c
|
181 182 183 |
goto exit; } } |
0f4dafc05
|
184 185 186 187 188 189 190 191 192 193 |
/* * Mark "add" and "remove" events in the object to ensure proper * events to userspace during automatic cleanup. If the object did * send an "add" event, "remove" will automatically generated by * the core, if not already done by the caller. */ if (action == KOBJ_ADD) kobj->state_add_uevent_sent = 1; else if (action == KOBJ_REMOVE) kobj->state_remove_uevent_sent = 1; |
7eff2e7a8
|
194 |
/* we will send an event, so request a new sequence number */ |
1da177e4c
|
195 |
spin_lock(&sequence_lock); |
312c004d3
|
196 |
seq = ++uevent_seqnum; |
1da177e4c
|
197 |
spin_unlock(&sequence_lock); |
7eff2e7a8
|
198 199 200 |
retval = add_uevent_var(env, "SEQNUM=%llu", (unsigned long long)seq); if (retval) goto exit; |
1da177e4c
|
201 |
|
4d17ffda3
|
202 |
#if defined(CONFIG_NET) |
5f123fbd8
|
203 204 205 206 207 208 209 |
/* send netlink message */ if (uevent_sock) { struct sk_buff *skb; size_t len; /* allocate message with the maximum possible size */ len = strlen(action_string) + strlen(devpath) + 2; |
7eff2e7a8
|
210 |
skb = alloc_skb(len + env->buflen, GFP_KERNEL); |
5f123fbd8
|
211 |
if (skb) { |
7eff2e7a8
|
212 |
char *scratch; |
5f123fbd8
|
213 214 215 216 217 |
/* add header */ scratch = skb_put(skb, len); sprintf(scratch, "%s@%s", action_string, devpath); /* copy keys to our continuous event payload buffer */ |
7eff2e7a8
|
218 219 |
for (i = 0; i < env->envp_idx; i++) { len = strlen(env->envp[i]) + 1; |
5f123fbd8
|
220 |
scratch = skb_put(skb, len); |
7eff2e7a8
|
221 |
strcpy(scratch, env->envp[i]); |
5f123fbd8
|
222 223 224 225 226 227 |
} NETLINK_CB(skb).dst_group = 1; netlink_broadcast(uevent_sock, skb, 0, 1, GFP_KERNEL); } } |
4d17ffda3
|
228 |
#endif |
1da177e4c
|
229 |
|
5f123fbd8
|
230 |
/* call uevent_helper, usually only enabled during early boot */ |
312c004d3
|
231 |
if (uevent_helper[0]) { |
5f123fbd8
|
232 |
char *argv [3]; |
1da177e4c
|
233 |
|
312c004d3
|
234 |
argv [0] = uevent_helper; |
5f123fbd8
|
235 236 |
argv [1] = (char *)subsystem; argv [2] = NULL; |
7eff2e7a8
|
237 238 239 |
retval = add_uevent_var(env, "HOME=/"); if (retval) goto exit; |
e374a2bfe
|
240 241 |
retval = add_uevent_var(env, "PATH=/sbin:/bin:/usr/sbin:/usr/bin"); |
7eff2e7a8
|
242 243 |
if (retval) goto exit; |
e374a2bfe
|
244 |
call_usermodehelper(argv[0], argv, env->envp, UMH_WAIT_EXEC); |
5f123fbd8
|
245 |
} |
1da177e4c
|
246 247 |
exit: |
5f123fbd8
|
248 |
kfree(devpath); |
7eff2e7a8
|
249 |
kfree(env); |
542cfce6f
|
250 |
return retval; |
1da177e4c
|
251 |
} |
8a82472f8
|
252 253 254 255 256 |
EXPORT_SYMBOL_GPL(kobject_uevent_env); /** * kobject_uevent - notify userspace by ending an uevent * |
ccd490a3c
|
257 |
* @action: action that is happening |
8a82472f8
|
258 |
* @kobj: struct kobject that the action is happening to |
542cfce6f
|
259 260 261 |
* * Returns 0 if kobject_uevent() is completed with success or the * corresponding error when it fails. |
8a82472f8
|
262 |
*/ |
542cfce6f
|
263 |
int kobject_uevent(struct kobject *kobj, enum kobject_action action) |
8a82472f8
|
264 |
{ |
542cfce6f
|
265 |
return kobject_uevent_env(kobj, action, NULL); |
8a82472f8
|
266 |
} |
312c004d3
|
267 |
EXPORT_SYMBOL_GPL(kobject_uevent); |
1da177e4c
|
268 269 |
/** |
7eff2e7a8
|
270 271 272 |
* add_uevent_var - add key value string to the environment buffer * @env: environment buffer structure * @format: printf format for the key=value pair |
1da177e4c
|
273 274 275 276 |
* * Returns 0 if environment variable was added successfully or -ENOMEM * if no space was available. */ |
7eff2e7a8
|
277 |
int add_uevent_var(struct kobj_uevent_env *env, const char *format, ...) |
1da177e4c
|
278 279 |
{ va_list args; |
7eff2e7a8
|
280 |
int len; |
1da177e4c
|
281 |
|
7eff2e7a8
|
282 283 284 285 |
if (env->envp_idx >= ARRAY_SIZE(env->envp)) { printk(KERN_ERR "add_uevent_var: too many keys "); WARN_ON(1); |
1da177e4c
|
286 |
return -ENOMEM; |
7eff2e7a8
|
287 |
} |
1da177e4c
|
288 289 |
va_start(args, format); |
7eff2e7a8
|
290 291 292 |
len = vsnprintf(&env->buf[env->buflen], sizeof(env->buf) - env->buflen, format, args); |
1da177e4c
|
293 |
va_end(args); |
7eff2e7a8
|
294 295 296 297 |
if (len >= (sizeof(env->buf) - env->buflen)) { printk(KERN_ERR "add_uevent_var: buffer size too small "); WARN_ON(1); |
1da177e4c
|
298 |
return -ENOMEM; |
7eff2e7a8
|
299 |
} |
1da177e4c
|
300 |
|
7eff2e7a8
|
301 302 |
env->envp[env->envp_idx++] = &env->buf[env->buflen]; env->buflen += len + 1; |
1da177e4c
|
303 304 |
return 0; } |
312c004d3
|
305 |
EXPORT_SYMBOL_GPL(add_uevent_var); |
1da177e4c
|
306 |
|
4d17ffda3
|
307 |
#if defined(CONFIG_NET) |
5f123fbd8
|
308 309 |
static int __init kobject_uevent_init(void) { |
b4b510290
|
310 311 |
uevent_sock = netlink_kernel_create(&init_net, NETLINK_KOBJECT_UEVENT, 1, NULL, NULL, THIS_MODULE); |
5f123fbd8
|
312 313 314 315 316 317 318 319 320 321 322 |
if (!uevent_sock) { printk(KERN_ERR "kobject_uevent: unable to create netlink socket! "); return -ENODEV; } return 0; } postcore_initcall(kobject_uevent_init); |
4d17ffda3
|
323 |
#endif |