]>
Commit | Line | Data |
---|---|---|
1da177e4 LT |
1 | /* |
2 | * kernel userspace event delivery | |
3 | * | |
4 | * Copyright (C) 2004 Red Hat, Inc. All rights reserved. | |
5 | * Copyright (C) 2004 Novell, Inc. All rights reserved. | |
6 | * Copyright (C) 2004 IBM, Inc. All rights reserved. | |
7 | * | |
8 | * Licensed under the GNU GPL v2. | |
9 | * | |
10 | * Authors: | |
11 | * Robert Love <[email protected]> | |
12 | * Kay Sievers <[email protected]> | |
13 | * Arjan van de Ven <[email protected]> | |
14 | * Greg Kroah-Hartman <[email protected]> | |
15 | */ | |
16 | ||
17 | #include <linux/spinlock.h> | |
18 | #include <linux/socket.h> | |
19 | #include <linux/skbuff.h> | |
20 | #include <linux/netlink.h> | |
21 | #include <linux/string.h> | |
1da177e4 LT |
22 | #include <linux/kobject.h> |
23 | #include <net/sock.h> | |
24 | ||
d87499ed | 25 | #define BUFFER_SIZE 2048 /* buffer for the variables */ |
1da177e4 LT |
26 | #define NUM_ENVP 32 /* number of env pointers */ |
27 | ||
4d17ffda | 28 | #if defined(CONFIG_HOTPLUG) |
51107301 JN |
29 | u64 uevent_seqnum; |
30 | char uevent_helper[UEVENT_HELPER_PATH_LEN] = "/sbin/hotplug"; | |
0296b228 | 31 | static DEFINE_SPINLOCK(sequence_lock); |
4d17ffda | 32 | #if defined(CONFIG_NET) |
5f123fbd | 33 | static struct sock *uevent_sock; |
4d17ffda | 34 | #endif |
0296b228 | 35 | |
1da177e4 LT |
36 | static char *action_to_string(enum kobject_action action) |
37 | { | |
38 | switch (action) { | |
39 | case KOBJ_ADD: | |
40 | return "add"; | |
41 | case KOBJ_REMOVE: | |
42 | return "remove"; | |
43 | case KOBJ_CHANGE: | |
44 | return "change"; | |
fa675765 GKH |
45 | case KOBJ_MOUNT: |
46 | return "mount"; | |
47 | case KOBJ_UMOUNT: | |
48 | return "umount"; | |
1da177e4 LT |
49 | case KOBJ_OFFLINE: |
50 | return "offline"; | |
51 | case KOBJ_ONLINE: | |
52 | return "online"; | |
8a82472f CH |
53 | case KOBJ_MOVE: |
54 | return "move"; | |
1da177e4 LT |
55 | default: |
56 | return NULL; | |
57 | } | |
58 | } | |
1da177e4 | 59 | |
1da177e4 | 60 | /** |
8a82472f | 61 | * kobject_uevent_env - send an uevent with environmental data |
1da177e4 | 62 | * |
8a82472f | 63 | * @action: action that is happening (usually KOBJ_MOVE) |
1da177e4 | 64 | * @kobj: struct kobject that the action is happening to |
8a82472f | 65 | * @envp_ext: pointer to environmental data |
542cfce6 AK |
66 | * |
67 | * Returns 0 if kobject_uevent() is completed with success or the | |
68 | * corresponding error when it fails. | |
1da177e4 | 69 | */ |
542cfce6 | 70 | int kobject_uevent_env(struct kobject *kobj, enum kobject_action action, |
8a82472f | 71 | char *envp_ext[]) |
1da177e4 | 72 | { |
5f123fbd KS |
73 | char **envp; |
74 | char *buffer; | |
1da177e4 | 75 | char *scratch; |
5f123fbd KS |
76 | const char *action_string; |
77 | const char *devpath = NULL; | |
78 | const char *subsystem; | |
79 | struct kobject *top_kobj; | |
80 | struct kset *kset; | |
312c004d | 81 | struct kset_uevent_ops *uevent_ops; |
5f123fbd KS |
82 | u64 seq; |
83 | char *seq_buff; | |
1da177e4 | 84 | int i = 0; |
542cfce6 | 85 | int retval = 0; |
8a82472f | 86 | int j; |
1da177e4 | 87 | |
5f123fbd KS |
88 | pr_debug("%s\n", __FUNCTION__); |
89 | ||
90 | action_string = action_to_string(action); | |
542cfce6 AK |
91 | if (!action_string) { |
92 | pr_debug("kobject attempted to send uevent without action_string!\n"); | |
93 | return -EINVAL; | |
94 | } | |
5f123fbd KS |
95 | |
96 | /* search the kset we belong to */ | |
97 | top_kobj = kobj; | |
1da177e4 LT |
98 | if (!top_kobj->kset && top_kobj->parent) { |
99 | do { | |
100 | top_kobj = top_kobj->parent; | |
101 | } while (!top_kobj->kset && top_kobj->parent); | |
102 | } | |
542cfce6 AK |
103 | if (!top_kobj->kset) { |
104 | pr_debug("kobject attempted to send uevent without kset!\n"); | |
105 | return -EINVAL; | |
106 | } | |
1da177e4 | 107 | |
5f123fbd | 108 | kset = top_kobj->kset; |
312c004d | 109 | uevent_ops = kset->uevent_ops; |
1da177e4 | 110 | |
5f123fbd | 111 | /* skip the event, if the filter returns zero. */ |
312c004d | 112 | if (uevent_ops && uevent_ops->filter) |
542cfce6 AK |
113 | if (!uevent_ops->filter(kset, kobj)) { |
114 | pr_debug("kobject filter function caused the event to drop!\n"); | |
115 | return 0; | |
116 | } | |
1da177e4 | 117 | |
5f123fbd KS |
118 | /* environment index */ |
119 | envp = kzalloc(NUM_ENVP * sizeof (char *), GFP_KERNEL); | |
1da177e4 | 120 | if (!envp) |
542cfce6 | 121 | return -ENOMEM; |
1da177e4 | 122 | |
5f123fbd | 123 | /* environment values */ |
1da177e4 | 124 | buffer = kmalloc(BUFFER_SIZE, GFP_KERNEL); |
542cfce6 AK |
125 | if (!buffer) { |
126 | retval = -ENOMEM; | |
1da177e4 | 127 | goto exit; |
542cfce6 | 128 | } |
1da177e4 | 129 | |
5f123fbd KS |
130 | /* complete object path */ |
131 | devpath = kobject_get_path(kobj, GFP_KERNEL); | |
542cfce6 AK |
132 | if (!devpath) { |
133 | retval = -ENOENT; | |
5f123fbd | 134 | goto exit; |
542cfce6 | 135 | } |
1da177e4 | 136 | |
5f123fbd | 137 | /* originating subsystem */ |
312c004d KS |
138 | if (uevent_ops && uevent_ops->name) |
139 | subsystem = uevent_ops->name(kset, kobj); | |
5f123fbd KS |
140 | else |
141 | subsystem = kobject_name(&kset->kobj); | |
1da177e4 | 142 | |
5f123fbd KS |
143 | /* event environemnt for helper process only */ |
144 | envp[i++] = "HOME=/"; | |
145 | envp[i++] = "PATH=/sbin:/bin:/usr/sbin:/usr/bin"; | |
1da177e4 | 146 | |
5f123fbd | 147 | /* default keys */ |
1da177e4 | 148 | scratch = buffer; |
1da177e4 LT |
149 | envp [i++] = scratch; |
150 | scratch += sprintf(scratch, "ACTION=%s", action_string) + 1; | |
1da177e4 | 151 | envp [i++] = scratch; |
5f123fbd | 152 | scratch += sprintf (scratch, "DEVPATH=%s", devpath) + 1; |
1da177e4 | 153 | envp [i++] = scratch; |
5f123fbd | 154 | scratch += sprintf(scratch, "SUBSYSTEM=%s", subsystem) + 1; |
8a82472f CH |
155 | for (j = 0; envp_ext && envp_ext[j]; j++) |
156 | envp[i++] = envp_ext[j]; | |
5f123fbd | 157 | /* just reserve the space, overwrite it after kset call has returned */ |
1da177e4 LT |
158 | envp[i++] = seq_buff = scratch; |
159 | scratch += strlen("SEQNUM=18446744073709551616") + 1; | |
160 | ||
5f123fbd | 161 | /* let the kset specific function add its stuff */ |
312c004d KS |
162 | if (uevent_ops && uevent_ops->uevent) { |
163 | retval = uevent_ops->uevent(kset, kobj, | |
1da177e4 LT |
164 | &envp[i], NUM_ENVP - i, scratch, |
165 | BUFFER_SIZE - (scratch - buffer)); | |
166 | if (retval) { | |
312c004d | 167 | pr_debug ("%s - uevent() returned %d\n", |
1da177e4 LT |
168 | __FUNCTION__, retval); |
169 | goto exit; | |
170 | } | |
171 | } | |
172 | ||
5f123fbd | 173 | /* we will send an event, request a new sequence number */ |
1da177e4 | 174 | spin_lock(&sequence_lock); |
312c004d | 175 | seq = ++uevent_seqnum; |
1da177e4 LT |
176 | spin_unlock(&sequence_lock); |
177 | sprintf(seq_buff, "SEQNUM=%llu", (unsigned long long)seq); | |
178 | ||
4d17ffda | 179 | #if defined(CONFIG_NET) |
5f123fbd KS |
180 | /* send netlink message */ |
181 | if (uevent_sock) { | |
182 | struct sk_buff *skb; | |
183 | size_t len; | |
184 | ||
185 | /* allocate message with the maximum possible size */ | |
186 | len = strlen(action_string) + strlen(devpath) + 2; | |
187 | skb = alloc_skb(len + BUFFER_SIZE, GFP_KERNEL); | |
188 | if (skb) { | |
189 | /* add header */ | |
190 | scratch = skb_put(skb, len); | |
191 | sprintf(scratch, "%s@%s", action_string, devpath); | |
192 | ||
193 | /* copy keys to our continuous event payload buffer */ | |
194 | for (i = 2; envp[i]; i++) { | |
195 | len = strlen(envp[i]) + 1; | |
196 | scratch = skb_put(skb, len); | |
197 | strcpy(scratch, envp[i]); | |
198 | } | |
199 | ||
200 | NETLINK_CB(skb).dst_group = 1; | |
201 | netlink_broadcast(uevent_sock, skb, 0, 1, GFP_KERNEL); | |
202 | } | |
203 | } | |
4d17ffda | 204 | #endif |
1da177e4 | 205 | |
5f123fbd | 206 | /* call uevent_helper, usually only enabled during early boot */ |
312c004d | 207 | if (uevent_helper[0]) { |
5f123fbd | 208 | char *argv [3]; |
1da177e4 | 209 | |
312c004d | 210 | argv [0] = uevent_helper; |
5f123fbd KS |
211 | argv [1] = (char *)subsystem; |
212 | argv [2] = NULL; | |
213 | call_usermodehelper (argv[0], argv, envp, 0); | |
214 | } | |
1da177e4 LT |
215 | |
216 | exit: | |
5f123fbd | 217 | kfree(devpath); |
1da177e4 LT |
218 | kfree(buffer); |
219 | kfree(envp); | |
542cfce6 | 220 | return retval; |
1da177e4 | 221 | } |
8a82472f CH |
222 | |
223 | EXPORT_SYMBOL_GPL(kobject_uevent_env); | |
224 | ||
225 | /** | |
226 | * kobject_uevent - notify userspace by ending an uevent | |
227 | * | |
228 | * @action: action that is happening (usually KOBJ_ADD and KOBJ_REMOVE) | |
229 | * @kobj: struct kobject that the action is happening to | |
542cfce6 AK |
230 | * |
231 | * Returns 0 if kobject_uevent() is completed with success or the | |
232 | * corresponding error when it fails. | |
8a82472f | 233 | */ |
542cfce6 | 234 | int kobject_uevent(struct kobject *kobj, enum kobject_action action) |
8a82472f | 235 | { |
542cfce6 | 236 | return kobject_uevent_env(kobj, action, NULL); |
8a82472f CH |
237 | } |
238 | ||
312c004d | 239 | EXPORT_SYMBOL_GPL(kobject_uevent); |
1da177e4 LT |
240 | |
241 | /** | |
312c004d | 242 | * add_uevent_var - helper for creating event variables |
1da177e4 | 243 | * @envp: Pointer to table of environment variables, as passed into |
312c004d | 244 | * uevent() method. |
1da177e4 | 245 | * @num_envp: Number of environment variable slots available, as |
312c004d | 246 | * passed into uevent() method. |
1da177e4 | 247 | * @cur_index: Pointer to current index into @envp. It should be |
312c004d | 248 | * initialized to 0 before the first call to add_uevent_var(), |
1da177e4 LT |
249 | * and will be incremented on success. |
250 | * @buffer: Pointer to buffer for environment variables, as passed | |
312c004d KS |
251 | * into uevent() method. |
252 | * @buffer_size: Length of @buffer, as passed into uevent() method. | |
1da177e4 LT |
253 | * @cur_len: Pointer to current length of space used in @buffer. |
254 | * Should be initialized to 0 before the first call to | |
312c004d | 255 | * add_uevent_var(), and will be incremented on success. |
1da177e4 LT |
256 | * @format: Format for creating environment variable (of the form |
257 | * "XXX=%x") for snprintf(). | |
258 | * | |
259 | * Returns 0 if environment variable was added successfully or -ENOMEM | |
260 | * if no space was available. | |
261 | */ | |
312c004d KS |
262 | int add_uevent_var(char **envp, int num_envp, int *cur_index, |
263 | char *buffer, int buffer_size, int *cur_len, | |
264 | const char *format, ...) | |
1da177e4 LT |
265 | { |
266 | va_list args; | |
267 | ||
268 | /* | |
269 | * We check against num_envp - 1 to make sure there is at | |
312c004d KS |
270 | * least one slot left after we return, since kobject_uevent() |
271 | * needs to set the last slot to NULL. | |
1da177e4 LT |
272 | */ |
273 | if (*cur_index >= num_envp - 1) | |
274 | return -ENOMEM; | |
275 | ||
276 | envp[*cur_index] = buffer + *cur_len; | |
277 | ||
278 | va_start(args, format); | |
279 | *cur_len += vsnprintf(envp[*cur_index], | |
280 | max(buffer_size - *cur_len, 0), | |
281 | format, args) + 1; | |
282 | va_end(args); | |
283 | ||
284 | if (*cur_len > buffer_size) | |
285 | return -ENOMEM; | |
286 | ||
287 | (*cur_index)++; | |
288 | return 0; | |
289 | } | |
312c004d | 290 | EXPORT_SYMBOL_GPL(add_uevent_var); |
1da177e4 | 291 | |
4d17ffda | 292 | #if defined(CONFIG_NET) |
5f123fbd KS |
293 | static int __init kobject_uevent_init(void) |
294 | { | |
295 | uevent_sock = netlink_kernel_create(NETLINK_KOBJECT_UEVENT, 1, NULL, | |
af65bdfc | 296 | NULL, THIS_MODULE); |
5f123fbd KS |
297 | |
298 | if (!uevent_sock) { | |
299 | printk(KERN_ERR | |
300 | "kobject_uevent: unable to create netlink socket!\n"); | |
301 | return -ENODEV; | |
302 | } | |
303 | ||
304 | return 0; | |
305 | } | |
306 | ||
307 | postcore_initcall(kobject_uevent_init); | |
4d17ffda | 308 | #endif |
5f123fbd | 309 | |
1da177e4 | 310 | #endif /* CONFIG_HOTPLUG */ |