ACPI / PNP: Do not crash due to stale pointer use during system resume
[linux-block.git] / drivers / acpi / scan.c
CommitLineData
1da177e4
LT
1/*
2 * scan.c - support for transforming the ACPI namespace into individual objects
3 */
4
5#include <linux/module.h>
6#include <linux/init.h>
5a0e3ad6 7#include <linux/slab.h>
9b6d97b6 8#include <linux/kernel.h>
1da177e4 9#include <linux/acpi.h>
74523c90
AK
10#include <linux/signal.h>
11#include <linux/kthread.h>
222e82ac 12#include <linux/dmi.h>
d1efe3c3 13#include <linux/nls.h>
1da177e4
LT
14
15#include <acpi/acpi_drivers.h>
1da177e4 16
e60cc7a6
BH
17#include "internal.h"
18
1da177e4 19#define _COMPONENT ACPI_BUS_COMPONENT
f52fd66d 20ACPI_MODULE_NAME("scan");
1da177e4 21#define STRUCT_TO_INT(s) (*((int*)&s))
4be44fcd 22extern struct acpi_device *acpi_root;
1da177e4
LT
23
24#define ACPI_BUS_CLASS "system_bus"
29b71a1c 25#define ACPI_BUS_HID "LNXSYBUS"
1da177e4
LT
26#define ACPI_BUS_DEVICE_NAME "System Bus"
27
859ac9a4
BH
28#define ACPI_IS_ROOT_DEVICE(device) (!(device)->parent)
29
620e112c 30static const char *dummy_hid = "device";
2b2ae7c7 31
1da177e4 32static LIST_HEAD(acpi_device_list);
e49bd2dd 33static LIST_HEAD(acpi_bus_id_list);
9090589d 34DEFINE_MUTEX(acpi_device_lock);
1da177e4
LT
35LIST_HEAD(acpi_wakeup_device_list);
36
e49bd2dd 37struct acpi_device_bus_id{
bb095854 38 char bus_id[15];
e49bd2dd
ZR
39 unsigned int instance_no;
40 struct list_head node;
1da177e4 41};
29b71a1c
TR
42
43/*
44 * Creates hid/cid(s) string needed for modalias and uevent
45 * e.g. on a device with hid:IBM0001 and cid:ACPI0001 you get:
46 * char *modalias: "acpi:IBM0001:ACPI0001"
47*/
b3e572d2
AB
48static int create_modalias(struct acpi_device *acpi_dev, char *modalias,
49 int size)
50{
29b71a1c 51 int len;
5c9fcb5d 52 int count;
7f47fa6c 53 struct acpi_hardware_id *id;
29b71a1c 54
2b2ae7c7
TR
55 if (list_empty(&acpi_dev->pnp.ids))
56 return 0;
57
5c9fcb5d 58 len = snprintf(modalias, size, "acpi:");
29b71a1c
TR
59 size -= len;
60
7f47fa6c
BH
61 list_for_each_entry(id, &acpi_dev->pnp.ids, list) {
62 count = snprintf(&modalias[len], size, "%s:", id->id);
5c9fcb5d
ZR
63 if (count < 0 || count >= size)
64 return -EINVAL;
65 len += count;
66 size -= count;
67 }
68
29b71a1c
TR
69 modalias[len] = '\0';
70 return len;
71}
72
73static ssize_t
74acpi_device_modalias_show(struct device *dev, struct device_attribute *attr, char *buf) {
75 struct acpi_device *acpi_dev = to_acpi_device(dev);
76 int len;
77
78 /* Device has no HID and no CID or string is >1024 */
79 len = create_modalias(acpi_dev, buf, 1024);
80 if (len <= 0)
81 return 0;
82 buf[len++] = '\n';
83 return len;
84}
85static DEVICE_ATTR(modalias, 0444, acpi_device_modalias_show, NULL);
86
c4753e57
TK
87/**
88 * acpi_bus_hot_remove_device: hot-remove a device and its children
89 * @context: struct acpi_eject_event pointer (freed in this func)
90 *
91 * Hot-remove a device and its children. This function frees up the
92 * memory space passed by arg context, so that the caller may call
93 * this function asynchronously through acpi_os_hotplug_execute().
94 */
95void acpi_bus_hot_remove_device(void *context)
1da177e4 96{
c4753e57 97 struct acpi_eject_event *ej_event = (struct acpi_eject_event *) context;
26d46867 98 struct acpi_device *device;
c4753e57 99 acpi_handle handle = ej_event->handle;
b3c450c3 100 acpi_handle temp;
1da177e4
LT
101 struct acpi_object_list arg_list;
102 union acpi_object arg;
103 acpi_status status = AE_OK;
c4753e57 104 u32 ost_code = ACPI_OST_SC_NON_SPECIFIC_FAILURE; /* default */
1da177e4 105
26d46867 106 if (acpi_bus_get_device(handle, &device))
c4753e57 107 goto err_out;
26d46867
ZR
108
109 if (!device)
c4753e57 110 goto err_out;
26d46867
ZR
111
112 ACPI_DEBUG_PRINT((ACPI_DB_INFO,
0794469d 113 "Hot-removing device %s...\n", dev_name(&device->dev)));
26d46867
ZR
114
115 if (acpi_bus_trim(device, 1)) {
55ac9a01
LM
116 printk(KERN_ERR PREFIX
117 "Removing device failed\n");
c4753e57 118 goto err_out;
26d46867 119 }
1da177e4 120
b3c450c3
TK
121 /* device has been freed */
122 device = NULL;
123
26d46867
ZR
124 /* power off device */
125 status = acpi_evaluate_object(handle, "_PS3", NULL, NULL);
126 if (ACPI_FAILURE(status) && status != AE_NOT_FOUND)
55ac9a01
LM
127 printk(KERN_WARNING PREFIX
128 "Power-off device failed\n");
26d46867 129
b3c450c3 130 if (ACPI_SUCCESS(acpi_get_handle(handle, "_LCK", &temp))) {
1da177e4
LT
131 arg_list.count = 1;
132 arg_list.pointer = &arg;
133 arg.type = ACPI_TYPE_INTEGER;
134 arg.integer.value = 0;
135 acpi_evaluate_object(handle, "_LCK", &arg_list, NULL);
136 }
1da177e4 137
1da177e4
LT
138 arg_list.count = 1;
139 arg_list.pointer = &arg;
140 arg.type = ACPI_TYPE_INTEGER;
141 arg.integer.value = 1;
1da177e4 142
1da177e4
LT
143 /*
144 * TBD: _EJD support.
145 */
1da177e4 146 status = acpi_evaluate_object(handle, "_EJ0", &arg_list, NULL);
c4753e57
TK
147 if (ACPI_FAILURE(status)) {
148 if (status != AE_NOT_FOUND)
149 printk(KERN_WARNING PREFIX
150 "Eject device failed\n");
151 goto err_out;
152 }
1da177e4 153
c4753e57
TK
154 kfree(context);
155 return;
1da177e4 156
c4753e57
TK
157err_out:
158 /* Inform firmware the hot-remove operation has completed w/ error */
159 (void) acpi_evaluate_hotplug_ost(handle,
160 ej_event->event, ost_code, NULL);
161 kfree(context);
c8d72a5e 162 return;
1da177e4 163}
61622acc 164EXPORT_SYMBOL(acpi_bus_hot_remove_device);
1da177e4 165
1da177e4 166static ssize_t
f883d9db
PM
167acpi_eject_store(struct device *d, struct device_attribute *attr,
168 const char *buf, size_t count)
1da177e4 169{
4be44fcd 170 int ret = count;
4be44fcd 171 acpi_status status;
4be44fcd 172 acpi_object_type type = 0;
f883d9db 173 struct acpi_device *acpi_device = to_acpi_device(d);
c4753e57 174 struct acpi_eject_event *ej_event;
1da177e4 175
1da177e4
LT
176 if ((!count) || (buf[0] != '1')) {
177 return -EINVAL;
178 }
1da177e4 179#ifndef FORCE_EJECT
f883d9db 180 if (acpi_device->driver == NULL) {
1da177e4
LT
181 ret = -ENODEV;
182 goto err;
183 }
184#endif
f883d9db
PM
185 status = acpi_get_type(acpi_device->handle, &type);
186 if (ACPI_FAILURE(status) || (!acpi_device->flags.ejectable)) {
1da177e4
LT
187 ret = -ENODEV;
188 goto err;
189 }
1da177e4 190
c4753e57
TK
191 ej_event = kmalloc(sizeof(*ej_event), GFP_KERNEL);
192 if (!ej_event) {
193 ret = -ENOMEM;
194 goto err;
195 }
196
197 ej_event->handle = acpi_device->handle;
198 if (acpi_device->flags.eject_pending) {
199 /* event originated from ACPI eject notification */
200 ej_event->event = ACPI_NOTIFY_EJECT_REQUEST;
201 acpi_device->flags.eject_pending = 0;
202 } else {
203 /* event originated from user */
204 ej_event->event = ACPI_OST_EC_OSPM_EJECT;
205 (void) acpi_evaluate_hotplug_ost(ej_event->handle,
206 ej_event->event, ACPI_OST_SC_EJECT_IN_PROGRESS, NULL);
207 }
208
209 acpi_os_hotplug_execute(acpi_bus_hot_remove_device, (void *)ej_event);
74523c90 210err:
1da177e4 211 return ret;
1da177e4
LT
212}
213
f883d9db 214static DEVICE_ATTR(eject, 0200, NULL, acpi_eject_store);
1da177e4 215
e49bd2dd
ZR
216static ssize_t
217acpi_device_hid_show(struct device *dev, struct device_attribute *attr, char *buf) {
218 struct acpi_device *acpi_dev = to_acpi_device(dev);
1da177e4 219
ea8d82fd 220 return sprintf(buf, "%s\n", acpi_device_hid(acpi_dev));
1da177e4 221}
e49bd2dd 222static DEVICE_ATTR(hid, 0444, acpi_device_hid_show, NULL);
1da177e4 223
923d4a45
LZ
224static ssize_t acpi_device_uid_show(struct device *dev,
225 struct device_attribute *attr, char *buf)
226{
227 struct acpi_device *acpi_dev = to_acpi_device(dev);
228
229 return sprintf(buf, "%s\n", acpi_dev->pnp.unique_id);
230}
231static DEVICE_ATTR(uid, 0444, acpi_device_uid_show, NULL);
232
233static ssize_t acpi_device_adr_show(struct device *dev,
234 struct device_attribute *attr, char *buf)
235{
236 struct acpi_device *acpi_dev = to_acpi_device(dev);
237
238 return sprintf(buf, "0x%08x\n",
239 (unsigned int)(acpi_dev->pnp.bus_address));
240}
241static DEVICE_ATTR(adr, 0444, acpi_device_adr_show, NULL);
242
e49bd2dd
ZR
243static ssize_t
244acpi_device_path_show(struct device *dev, struct device_attribute *attr, char *buf) {
245 struct acpi_device *acpi_dev = to_acpi_device(dev);
246 struct acpi_buffer path = {ACPI_ALLOCATE_BUFFER, NULL};
247 int result;
1da177e4 248
e49bd2dd 249 result = acpi_get_name(acpi_dev->handle, ACPI_FULL_PATHNAME, &path);
0c526d96 250 if (result)
e49bd2dd 251 goto end;
1da177e4 252
e49bd2dd
ZR
253 result = sprintf(buf, "%s\n", (char*)path.pointer);
254 kfree(path.pointer);
0c526d96 255end:
e49bd2dd 256 return result;
1da177e4 257}
e49bd2dd 258static DEVICE_ATTR(path, 0444, acpi_device_path_show, NULL);
1da177e4 259
d1efe3c3
LO
260/* sysfs file that shows description text from the ACPI _STR method */
261static ssize_t description_show(struct device *dev,
262 struct device_attribute *attr,
263 char *buf) {
264 struct acpi_device *acpi_dev = to_acpi_device(dev);
265 int result;
266
267 if (acpi_dev->pnp.str_obj == NULL)
268 return 0;
269
270 /*
271 * The _STR object contains a Unicode identifier for a device.
272 * We need to convert to utf-8 so it can be displayed.
273 */
274 result = utf16s_to_utf8s(
275 (wchar_t *)acpi_dev->pnp.str_obj->buffer.pointer,
276 acpi_dev->pnp.str_obj->buffer.length,
277 UTF16_LITTLE_ENDIAN, buf,
278 PAGE_SIZE);
279
280 buf[result++] = '\n';
281
282 return result;
283}
284static DEVICE_ATTR(description, 0444, description_show, NULL);
285
bb74ac23
YI
286static ssize_t
287acpi_device_sun_show(struct device *dev, struct device_attribute *attr,
288 char *buf) {
289 struct acpi_device *acpi_dev = to_acpi_device(dev);
290
291 return sprintf(buf, "%lu\n", acpi_dev->pnp.sun);
292}
293static DEVICE_ATTR(sun, 0444, acpi_device_sun_show, NULL);
294
e49bd2dd 295static int acpi_device_setup_files(struct acpi_device *dev)
1da177e4 296{
d1efe3c3 297 struct acpi_buffer buffer = {ACPI_ALLOCATE_BUFFER, NULL};
f883d9db
PM
298 acpi_status status;
299 acpi_handle temp;
bb74ac23 300 unsigned long long sun;
e49bd2dd 301 int result = 0;
1da177e4
LT
302
303 /*
e49bd2dd 304 * Devices gotten from FADT don't have a "path" attribute
1da177e4 305 */
0c526d96 306 if (dev->handle) {
e49bd2dd 307 result = device_create_file(&dev->dev, &dev_attr_path);
0c526d96 308 if (result)
e49bd2dd 309 goto end;
1da177e4
LT
310 }
311
2b2ae7c7
TR
312 if (!list_empty(&dev->pnp.ids)) {
313 result = device_create_file(&dev->dev, &dev_attr_hid);
314 if (result)
315 goto end;
1da177e4 316
2b2ae7c7
TR
317 result = device_create_file(&dev->dev, &dev_attr_modalias);
318 if (result)
319 goto end;
320 }
29b71a1c 321
d1efe3c3
LO
322 /*
323 * If device has _STR, 'description' file is created
324 */
325 status = acpi_get_handle(dev->handle, "_STR", &temp);
326 if (ACPI_SUCCESS(status)) {
327 status = acpi_evaluate_object(dev->handle, "_STR",
328 NULL, &buffer);
329 if (ACPI_FAILURE(status))
330 buffer.pointer = NULL;
331 dev->pnp.str_obj = buffer.pointer;
332 result = device_create_file(&dev->dev, &dev_attr_description);
333 if (result)
334 goto end;
335 }
336
923d4a45
LZ
337 if (dev->flags.bus_address)
338 result = device_create_file(&dev->dev, &dev_attr_adr);
339 if (dev->pnp.unique_id)
340 result = device_create_file(&dev->dev, &dev_attr_uid);
341
bb74ac23
YI
342 status = acpi_evaluate_integer(dev->handle, "_SUN", NULL, &sun);
343 if (ACPI_SUCCESS(status)) {
344 dev->pnp.sun = (unsigned long)sun;
345 result = device_create_file(&dev->dev, &dev_attr_sun);
346 if (result)
347 goto end;
348 } else {
349 dev->pnp.sun = (unsigned long)-1;
350 }
351
e49bd2dd
ZR
352 /*
353 * If device has _EJ0, 'eject' file is created that is used to trigger
354 * hot-removal function from userland.
355 */
f883d9db
PM
356 status = acpi_get_handle(dev->handle, "_EJ0", &temp);
357 if (ACPI_SUCCESS(status))
e49bd2dd 358 result = device_create_file(&dev->dev, &dev_attr_eject);
0c526d96 359end:
e49bd2dd 360 return result;
1da177e4
LT
361}
362
f883d9db 363static void acpi_device_remove_files(struct acpi_device *dev)
1da177e4 364{
f883d9db
PM
365 acpi_status status;
366 acpi_handle temp;
1da177e4 367
f883d9db 368 /*
d1efe3c3
LO
369 * If device has _STR, remove 'description' file
370 */
371 status = acpi_get_handle(dev->handle, "_STR", &temp);
372 if (ACPI_SUCCESS(status)) {
373 kfree(dev->pnp.str_obj);
374 device_remove_file(&dev->dev, &dev_attr_description);
375 }
376 /*
377 * If device has _EJ0, remove 'eject' file.
f883d9db
PM
378 */
379 status = acpi_get_handle(dev->handle, "_EJ0", &temp);
380 if (ACPI_SUCCESS(status))
381 device_remove_file(&dev->dev, &dev_attr_eject);
1da177e4 382
bb74ac23
YI
383 status = acpi_get_handle(dev->handle, "_SUN", &temp);
384 if (ACPI_SUCCESS(status))
385 device_remove_file(&dev->dev, &dev_attr_sun);
386
923d4a45
LZ
387 if (dev->pnp.unique_id)
388 device_remove_file(&dev->dev, &dev_attr_uid);
389 if (dev->flags.bus_address)
390 device_remove_file(&dev->dev, &dev_attr_adr);
1131b938
BH
391 device_remove_file(&dev->dev, &dev_attr_modalias);
392 device_remove_file(&dev->dev, &dev_attr_hid);
0c526d96 393 if (dev->handle)
e49bd2dd 394 device_remove_file(&dev->dev, &dev_attr_path);
1da177e4 395}
1da177e4 396/* --------------------------------------------------------------------------
9e89dde2 397 ACPI Bus operations
1da177e4 398 -------------------------------------------------------------------------- */
29b71a1c
TR
399
400int acpi_match_device_ids(struct acpi_device *device,
401 const struct acpi_device_id *ids)
402{
403 const struct acpi_device_id *id;
7f47fa6c 404 struct acpi_hardware_id *hwid;
29b71a1c 405
39a0ad87
ZY
406 /*
407 * If the device is not present, it is unnecessary to load device
408 * driver for it.
409 */
410 if (!device->status.present)
411 return -ENODEV;
412
7f47fa6c
BH
413 for (id = ids; id->id[0]; id++)
414 list_for_each_entry(hwid, &device->pnp.ids, list)
415 if (!strcmp((char *) id->id, hwid->id))
29b71a1c 416 return 0;
29b71a1c
TR
417
418 return -ENOENT;
419}
420EXPORT_SYMBOL(acpi_match_device_ids);
421
7f47fa6c
BH
422static void acpi_free_ids(struct acpi_device *device)
423{
424 struct acpi_hardware_id *id, *tmp;
425
426 list_for_each_entry_safe(id, tmp, &device->pnp.ids, list) {
427 kfree(id->id);
428 kfree(id);
429 }
430}
431
1890a97a 432static void acpi_device_release(struct device *dev)
1da177e4 433{
1890a97a 434 struct acpi_device *acpi_dev = to_acpi_device(dev);
1da177e4 435
7f47fa6c 436 acpi_free_ids(acpi_dev);
ccf78040 437 kfree(acpi_dev->pnp.unique_id);
1890a97a 438 kfree(acpi_dev);
1da177e4
LT
439}
440
5d9464a4 441static int acpi_bus_match(struct device *dev, struct device_driver *drv)
9e89dde2 442{
5d9464a4
PM
443 struct acpi_device *acpi_dev = to_acpi_device(dev);
444 struct acpi_driver *acpi_drv = to_acpi_driver(drv);
1da177e4 445
29b71a1c 446 return !acpi_match_device_ids(acpi_dev, acpi_drv->ids);
5d9464a4 447}
1da177e4 448
7eff2e7a 449static int acpi_device_uevent(struct device *dev, struct kobj_uevent_env *env)
1da177e4 450{
5d9464a4 451 struct acpi_device *acpi_dev = to_acpi_device(dev);
7eff2e7a 452 int len;
5d9464a4 453
2b2ae7c7
TR
454 if (list_empty(&acpi_dev->pnp.ids))
455 return 0;
456
7eff2e7a
KS
457 if (add_uevent_var(env, "MODALIAS="))
458 return -ENOMEM;
459 len = create_modalias(acpi_dev, &env->buf[env->buflen - 1],
460 sizeof(env->buf) - env->buflen);
461 if (len >= (sizeof(env->buf) - env->buflen))
462 return -ENOMEM;
463 env->buflen += len;
9e89dde2 464 return 0;
1da177e4
LT
465}
466
46ec8598
BH
467static void acpi_device_notify(acpi_handle handle, u32 event, void *data)
468{
469 struct acpi_device *device = data;
470
471 device->driver->ops.notify(device, event);
472}
473
474static acpi_status acpi_device_notify_fixed(void *data)
475{
476 struct acpi_device *device = data;
477
53de5356
BH
478 /* Fixed hardware devices have no handles */
479 acpi_device_notify(NULL, ACPI_FIXED_HARDWARE_EVENT, device);
46ec8598
BH
480 return AE_OK;
481}
482
483static int acpi_device_install_notify_handler(struct acpi_device *device)
484{
485 acpi_status status;
46ec8598 486
ccba2a36 487 if (device->device_type == ACPI_BUS_TYPE_POWER_BUTTON)
46ec8598
BH
488 status =
489 acpi_install_fixed_event_handler(ACPI_EVENT_POWER_BUTTON,
490 acpi_device_notify_fixed,
491 device);
ccba2a36 492 else if (device->device_type == ACPI_BUS_TYPE_SLEEP_BUTTON)
46ec8598
BH
493 status =
494 acpi_install_fixed_event_handler(ACPI_EVENT_SLEEP_BUTTON,
495 acpi_device_notify_fixed,
496 device);
497 else
498 status = acpi_install_notify_handler(device->handle,
499 ACPI_DEVICE_NOTIFY,
500 acpi_device_notify,
501 device);
502
503 if (ACPI_FAILURE(status))
504 return -EINVAL;
505 return 0;
506}
507
508static void acpi_device_remove_notify_handler(struct acpi_device *device)
509{
ccba2a36 510 if (device->device_type == ACPI_BUS_TYPE_POWER_BUTTON)
46ec8598
BH
511 acpi_remove_fixed_event_handler(ACPI_EVENT_POWER_BUTTON,
512 acpi_device_notify_fixed);
ccba2a36 513 else if (device->device_type == ACPI_BUS_TYPE_SLEEP_BUTTON)
46ec8598
BH
514 acpi_remove_fixed_event_handler(ACPI_EVENT_SLEEP_BUTTON,
515 acpi_device_notify_fixed);
516 else
517 acpi_remove_notify_handler(device->handle, ACPI_DEVICE_NOTIFY,
518 acpi_device_notify);
519}
520
5d9464a4
PM
521static int acpi_bus_driver_init(struct acpi_device *, struct acpi_driver *);
522static int acpi_start_single_object(struct acpi_device *);
523static int acpi_device_probe(struct device * dev)
1da177e4 524{
5d9464a4
PM
525 struct acpi_device *acpi_dev = to_acpi_device(dev);
526 struct acpi_driver *acpi_drv = to_acpi_driver(dev->driver);
527 int ret;
528
529 ret = acpi_bus_driver_init(acpi_dev, acpi_drv);
530 if (!ret) {
c4168bff
LS
531 if (acpi_dev->bus_ops.acpi_op_start)
532 acpi_start_single_object(acpi_dev);
46ec8598
BH
533
534 if (acpi_drv->ops.notify) {
535 ret = acpi_device_install_notify_handler(acpi_dev);
536 if (ret) {
46ec8598
BH
537 if (acpi_drv->ops.remove)
538 acpi_drv->ops.remove(acpi_dev,
539 acpi_dev->removal_type);
540 return ret;
541 }
542 }
543
5d9464a4
PM
544 ACPI_DEBUG_PRINT((ACPI_DB_INFO,
545 "Found driver [%s] for device [%s]\n",
546 acpi_drv->name, acpi_dev->pnp.bus_id));
547 get_device(dev);
548 }
549 return ret;
550}
1da177e4 551
5d9464a4
PM
552static int acpi_device_remove(struct device * dev)
553{
554 struct acpi_device *acpi_dev = to_acpi_device(dev);
555 struct acpi_driver *acpi_drv = acpi_dev->driver;
556
557 if (acpi_drv) {
46ec8598
BH
558 if (acpi_drv->ops.notify)
559 acpi_device_remove_notify_handler(acpi_dev);
5d9464a4 560 if (acpi_drv->ops.remove)
96333578 561 acpi_drv->ops.remove(acpi_dev, acpi_dev->removal_type);
1da177e4 562 }
5d9464a4 563 acpi_dev->driver = NULL;
db89b4f0 564 acpi_dev->driver_data = NULL;
1da177e4 565
5d9464a4 566 put_device(dev);
9e89dde2
ZR
567 return 0;
568}
1da177e4 569
55955aad 570struct bus_type acpi_bus_type = {
9e89dde2 571 .name = "acpi",
5d9464a4
PM
572 .match = acpi_bus_match,
573 .probe = acpi_device_probe,
574 .remove = acpi_device_remove,
575 .uevent = acpi_device_uevent,
9e89dde2
ZR
576};
577
66b7ed40 578static int acpi_device_register(struct acpi_device *device)
1da177e4 579{
4be44fcd 580 int result;
e49bd2dd
ZR
581 struct acpi_device_bus_id *acpi_device_bus_id, *new_bus_id;
582 int found = 0;
66b7ed40 583
9e89dde2
ZR
584 /*
585 * Linkage
586 * -------
587 * Link this device to its parent and siblings.
588 */
589 INIT_LIST_HEAD(&device->children);
590 INIT_LIST_HEAD(&device->node);
9e89dde2 591 INIT_LIST_HEAD(&device->wakeup_list);
1033f904
LT
592 INIT_LIST_HEAD(&device->physical_node_list);
593 mutex_init(&device->physical_node_lock);
1da177e4 594
e49bd2dd
ZR
595 new_bus_id = kzalloc(sizeof(struct acpi_device_bus_id), GFP_KERNEL);
596 if (!new_bus_id) {
597 printk(KERN_ERR PREFIX "Memory allocation error\n");
598 return -ENOMEM;
1da177e4 599 }
e49bd2dd 600
9090589d 601 mutex_lock(&acpi_device_lock);
e49bd2dd
ZR
602 /*
603 * Find suitable bus_id and instance number in acpi_bus_id_list
604 * If failed, create one and link it into acpi_bus_id_list
605 */
606 list_for_each_entry(acpi_device_bus_id, &acpi_bus_id_list, node) {
1131b938
BH
607 if (!strcmp(acpi_device_bus_id->bus_id,
608 acpi_device_hid(device))) {
609 acpi_device_bus_id->instance_no++;
e49bd2dd
ZR
610 found = 1;
611 kfree(new_bus_id);
612 break;
613 }
1da177e4 614 }
0c526d96 615 if (!found) {
e49bd2dd 616 acpi_device_bus_id = new_bus_id;
1131b938 617 strcpy(acpi_device_bus_id->bus_id, acpi_device_hid(device));
e49bd2dd
ZR
618 acpi_device_bus_id->instance_no = 0;
619 list_add_tail(&acpi_device_bus_id->node, &acpi_bus_id_list);
1da177e4 620 }
0794469d 621 dev_set_name(&device->dev, "%s:%02x", acpi_device_bus_id->bus_id, acpi_device_bus_id->instance_no);
1da177e4 622
33b57150 623 if (device->parent)
9e89dde2 624 list_add_tail(&device->node, &device->parent->children);
33b57150 625
9e89dde2
ZR
626 if (device->wakeup.flags.valid)
627 list_add_tail(&device->wakeup_list, &acpi_wakeup_device_list);
9090589d 628 mutex_unlock(&acpi_device_lock);
1da177e4 629
1890a97a 630 if (device->parent)
66b7ed40 631 device->dev.parent = &device->parent->dev;
1890a97a 632 device->dev.bus = &acpi_bus_type;
1890a97a 633 device->dev.release = &acpi_device_release;
8b12b922 634 result = device_register(&device->dev);
0c526d96 635 if (result) {
8b12b922 636 dev_err(&device->dev, "Error registering device\n");
e49bd2dd 637 goto end;
1da177e4 638 }
1da177e4 639
e49bd2dd 640 result = acpi_device_setup_files(device);
0c526d96 641 if (result)
0794469d
KS
642 printk(KERN_ERR PREFIX "Error creating sysfs interface for device %s\n",
643 dev_name(&device->dev));
1da177e4 644
96333578 645 device->removal_type = ACPI_BUS_REMOVAL_NORMAL;
1da177e4 646 return 0;
0c526d96 647end:
9090589d 648 mutex_lock(&acpi_device_lock);
33b57150 649 if (device->parent)
e49bd2dd 650 list_del(&device->node);
e49bd2dd 651 list_del(&device->wakeup_list);
9090589d 652 mutex_unlock(&acpi_device_lock);
e49bd2dd 653 return result;
1da177e4
LT
654}
655
9e89dde2
ZR
656static void acpi_device_unregister(struct acpi_device *device, int type)
657{
9090589d 658 mutex_lock(&acpi_device_lock);
33b57150 659 if (device->parent)
9e89dde2 660 list_del(&device->node);
1da177e4 661
9e89dde2 662 list_del(&device->wakeup_list);
9090589d 663 mutex_unlock(&acpi_device_lock);
1da177e4 664
9e89dde2 665 acpi_detach_data(device->handle, acpi_bus_data_handler);
1890a97a 666
f883d9db 667 acpi_device_remove_files(device);
1890a97a 668 device_unregister(&device->dev);
1da177e4
LT
669}
670
9e89dde2
ZR
671/* --------------------------------------------------------------------------
672 Driver Management
673 -------------------------------------------------------------------------- */
1da177e4 674/**
d758a8fa
RD
675 * acpi_bus_driver_init - add a device to a driver
676 * @device: the device to add and initialize
677 * @driver: driver for the device
678 *
0c526d96 679 * Used to initialize a device via its device driver. Called whenever a
1890a97a 680 * driver is bound to a device. Invokes the driver's add() ops.
1da177e4
LT
681 */
682static int
4be44fcd 683acpi_bus_driver_init(struct acpi_device *device, struct acpi_driver *driver)
1da177e4 684{
4be44fcd 685 int result = 0;
1da177e4 686
1da177e4 687 if (!device || !driver)
d550d98d 688 return -EINVAL;
1da177e4
LT
689
690 if (!driver->ops.add)
d550d98d 691 return -ENOSYS;
1da177e4
LT
692
693 result = driver->ops.add(device);
694 if (result) {
695 device->driver = NULL;
db89b4f0 696 device->driver_data = NULL;
d550d98d 697 return result;
1da177e4
LT
698 }
699
700 device->driver = driver;
701
702 /*
703 * TBD - Configuration Management: Assign resources to device based
704 * upon possible configuration and currently allocated resources.
705 */
706
4be44fcd
LB
707 ACPI_DEBUG_PRINT((ACPI_DB_INFO,
708 "Driver successfully bound to device\n"));
d550d98d 709 return 0;
3fb02738
RS
710}
711
8713cbef 712static int acpi_start_single_object(struct acpi_device *device)
3fb02738
RS
713{
714 int result = 0;
715 struct acpi_driver *driver;
716
3fb02738
RS
717
718 if (!(driver = device->driver))
d550d98d 719 return 0;
3fb02738 720
1da177e4
LT
721 if (driver->ops.start) {
722 result = driver->ops.start(device);
723 if (result && driver->ops.remove)
724 driver->ops.remove(device, ACPI_BUS_REMOVAL_NORMAL);
1da177e4
LT
725 }
726
d550d98d 727 return result;
1da177e4
LT
728}
729
9e89dde2
ZR
730/**
731 * acpi_bus_register_driver - register a driver with the ACPI bus
732 * @driver: driver being registered
733 *
734 * Registers a driver with the ACPI bus. Searches the namespace for all
735 * devices that match the driver's criteria and binds. Returns zero for
736 * success or a negative error status for failure.
737 */
738int acpi_bus_register_driver(struct acpi_driver *driver)
1da177e4 739{
1890a97a 740 int ret;
1da177e4 741
9e89dde2
ZR
742 if (acpi_disabled)
743 return -ENODEV;
1890a97a
PM
744 driver->drv.name = driver->name;
745 driver->drv.bus = &acpi_bus_type;
746 driver->drv.owner = driver->owner;
1da177e4 747
1890a97a
PM
748 ret = driver_register(&driver->drv);
749 return ret;
9e89dde2 750}
1da177e4 751
9e89dde2
ZR
752EXPORT_SYMBOL(acpi_bus_register_driver);
753
754/**
755 * acpi_bus_unregister_driver - unregisters a driver with the APIC bus
756 * @driver: driver to unregister
757 *
758 * Unregisters a driver with the ACPI bus. Searches the namespace for all
759 * devices that match the driver's criteria and unbinds.
760 */
761void acpi_bus_unregister_driver(struct acpi_driver *driver)
762{
1890a97a 763 driver_unregister(&driver->drv);
9e89dde2
ZR
764}
765
766EXPORT_SYMBOL(acpi_bus_unregister_driver);
767
9e89dde2
ZR
768/* --------------------------------------------------------------------------
769 Device Enumeration
770 -------------------------------------------------------------------------- */
5c478f49
BH
771static struct acpi_device *acpi_bus_get_parent(acpi_handle handle)
772{
773 acpi_status status;
774 int ret;
775 struct acpi_device *device;
776
777 /*
778 * Fixed hardware devices do not appear in the namespace and do not
779 * have handles, but we fabricate acpi_devices for them, so we have
780 * to deal with them specially.
781 */
782 if (handle == NULL)
783 return acpi_root;
784
785 do {
786 status = acpi_get_parent(handle, &handle);
787 if (status == AE_NULL_ENTRY)
788 return NULL;
789 if (ACPI_FAILURE(status))
790 return acpi_root;
791
792 ret = acpi_bus_get_device(handle, &device);
793 if (ret == 0)
794 return device;
795 } while (1);
796}
797
9e89dde2
ZR
798acpi_status
799acpi_bus_get_ejd(acpi_handle handle, acpi_handle *ejd)
800{
801 acpi_status status;
802 acpi_handle tmp;
803 struct acpi_buffer buffer = {ACPI_ALLOCATE_BUFFER, NULL};
804 union acpi_object *obj;
805
806 status = acpi_get_handle(handle, "_EJD", &tmp);
807 if (ACPI_FAILURE(status))
808 return status;
809
810 status = acpi_evaluate_object(handle, "_EJD", NULL, &buffer);
811 if (ACPI_SUCCESS(status)) {
812 obj = buffer.pointer;
3b5fee59
HM
813 status = acpi_get_handle(ACPI_ROOT_OBJECT, obj->string.pointer,
814 ejd);
9e89dde2
ZR
815 kfree(buffer.pointer);
816 }
817 return status;
818}
819EXPORT_SYMBOL_GPL(acpi_bus_get_ejd);
820
8e4319c4 821void acpi_bus_data_handler(acpi_handle handle, void *context)
9e89dde2
ZR
822{
823
824 /* TBD */
825
826 return;
827}
828
9e89dde2
ZR
829static int acpi_bus_get_perf_flags(struct acpi_device *device)
830{
831 device->performance.state = ACPI_STATE_UNKNOWN;
832 return 0;
833}
834
835static acpi_status
b581a7f9
RW
836acpi_bus_extract_wakeup_device_power_package(acpi_handle handle,
837 struct acpi_device_wakeup *wakeup)
9e89dde2 838{
b581a7f9
RW
839 struct acpi_buffer buffer = { ACPI_ALLOCATE_BUFFER, NULL };
840 union acpi_object *package = NULL;
9e89dde2 841 union acpi_object *element = NULL;
b581a7f9
RW
842 acpi_status status;
843 int i = 0;
9e89dde2 844
b581a7f9 845 if (!wakeup)
9e89dde2
ZR
846 return AE_BAD_PARAMETER;
847
b581a7f9
RW
848 /* _PRW */
849 status = acpi_evaluate_object(handle, "_PRW", NULL, &buffer);
850 if (ACPI_FAILURE(status)) {
851 ACPI_EXCEPTION((AE_INFO, status, "Evaluating _PRW"));
852 return status;
853 }
854
855 package = (union acpi_object *)buffer.pointer;
856
857 if (!package || (package->package.count < 2)) {
858 status = AE_BAD_DATA;
859 goto out;
860 }
861
9e89dde2 862 element = &(package->package.elements[0]);
b581a7f9
RW
863 if (!element) {
864 status = AE_BAD_DATA;
865 goto out;
866 }
9e89dde2
ZR
867 if (element->type == ACPI_TYPE_PACKAGE) {
868 if ((element->package.count < 2) ||
869 (element->package.elements[0].type !=
870 ACPI_TYPE_LOCAL_REFERENCE)
b581a7f9
RW
871 || (element->package.elements[1].type != ACPI_TYPE_INTEGER)) {
872 status = AE_BAD_DATA;
873 goto out;
874 }
875 wakeup->gpe_device =
9e89dde2 876 element->package.elements[0].reference.handle;
b581a7f9 877 wakeup->gpe_number =
9e89dde2
ZR
878 (u32) element->package.elements[1].integer.value;
879 } else if (element->type == ACPI_TYPE_INTEGER) {
b581a7f9
RW
880 wakeup->gpe_device = NULL;
881 wakeup->gpe_number = element->integer.value;
882 } else {
883 status = AE_BAD_DATA;
884 goto out;
885 }
9e89dde2
ZR
886
887 element = &(package->package.elements[1]);
888 if (element->type != ACPI_TYPE_INTEGER) {
b581a7f9
RW
889 status = AE_BAD_DATA;
890 goto out;
9e89dde2 891 }
b581a7f9 892 wakeup->sleep_state = element->integer.value;
9e89dde2
ZR
893
894 if ((package->package.count - 2) > ACPI_MAX_HANDLES) {
b581a7f9
RW
895 status = AE_NO_MEMORY;
896 goto out;
9e89dde2 897 }
b581a7f9
RW
898 wakeup->resources.count = package->package.count - 2;
899 for (i = 0; i < wakeup->resources.count; i++) {
9e89dde2 900 element = &(package->package.elements[i + 2]);
b581a7f9
RW
901 if (element->type != ACPI_TYPE_LOCAL_REFERENCE) {
902 status = AE_BAD_DATA;
903 goto out;
904 }
9e89dde2 905
b581a7f9 906 wakeup->resources.handles[i] = element->reference.handle;
1da177e4 907 }
9e89dde2 908
bba63a29 909 acpi_setup_gpe_for_wake(handle, wakeup->gpe_device, wakeup->gpe_number);
9874647b 910
b581a7f9
RW
911 out:
912 kfree(buffer.pointer);
913
914 return status;
1da177e4
LT
915}
916
f517709d 917static void acpi_bus_set_run_wake_flags(struct acpi_device *device)
1da177e4 918{
29b71a1c
TR
919 struct acpi_device_id button_device_ids[] = {
920 {"PNP0C0D", 0},
921 {"PNP0C0C", 0},
922 {"PNP0C0E", 0},
923 {"", 0},
924 };
f517709d
RW
925 acpi_status status;
926 acpi_event_status event_status;
927
b67ea761 928 device->wakeup.flags.notifier_present = 0;
f517709d
RW
929
930 /* Power button, Lid switch always enable wakeup */
931 if (!acpi_match_device_ids(device, button_device_ids)) {
932 device->wakeup.flags.run_wake = 1;
f2b56bc8 933 device_set_wakeup_capable(&device->dev, true);
f517709d
RW
934 return;
935 }
936
e8e18c95
RW
937 status = acpi_get_gpe_status(device->wakeup.gpe_device,
938 device->wakeup.gpe_number,
939 &event_status);
f517709d
RW
940 if (status == AE_OK)
941 device->wakeup.flags.run_wake =
942 !!(event_status & ACPI_EVENT_FLAG_HANDLE);
943}
944
d57d09a4 945static void acpi_bus_get_wakeup_device_flags(struct acpi_device *device)
f517709d 946{
d57d09a4 947 acpi_handle temp;
f517709d 948 acpi_status status = 0;
f517709d 949 int psw_error;
29b71a1c 950
d57d09a4
RW
951 /* Presence of _PRW indicates wake capable */
952 status = acpi_get_handle(device->handle, "_PRW", &temp);
953 if (ACPI_FAILURE(status))
954 return;
955
b581a7f9
RW
956 status = acpi_bus_extract_wakeup_device_power_package(device->handle,
957 &device->wakeup);
9e89dde2
ZR
958 if (ACPI_FAILURE(status)) {
959 ACPI_EXCEPTION((AE_INFO, status, "Extracting _PRW package"));
d57d09a4 960 return;
9e89dde2 961 }
1da177e4 962
9e89dde2 963 device->wakeup.flags.valid = 1;
9b83ccd2 964 device->wakeup.prepare_count = 0;
f517709d 965 acpi_bus_set_run_wake_flags(device);
729b2bdb
ZY
966 /* Call _PSW/_DSW object to disable its ability to wake the sleeping
967 * system for the ACPI device with the _PRW object.
968 * The _PSW object is depreciated in ACPI 3.0 and is replaced by _DSW.
969 * So it is necessary to call _DSW object first. Only when it is not
970 * present will the _PSW object used.
971 */
77e76609
RW
972 psw_error = acpi_device_sleep_wake(device, 0, 0, 0);
973 if (psw_error)
974 ACPI_DEBUG_PRINT((ACPI_DB_INFO,
975 "error in _DSW or _PSW evaluation\n"));
1da177e4 976}
1da177e4 977
bf325f95
RW
978static void acpi_bus_add_power_resource(acpi_handle handle);
979
9e89dde2 980static int acpi_bus_get_power_flags(struct acpi_device *device)
1da177e4 981{
9e89dde2
ZR
982 acpi_status status = 0;
983 acpi_handle handle = NULL;
984 u32 i = 0;
1a365616 985
4be44fcd 986
9e89dde2
ZR
987 /*
988 * Power Management Flags
989 */
990 status = acpi_get_handle(device->handle, "_PSC", &handle);
991 if (ACPI_SUCCESS(status))
992 device->power.flags.explicit_get = 1;
993 status = acpi_get_handle(device->handle, "_IRC", &handle);
994 if (ACPI_SUCCESS(status))
995 device->power.flags.inrush_current = 1;
1da177e4 996
9e89dde2
ZR
997 /*
998 * Enumerate supported power management states
999 */
1cc0c998 1000 for (i = ACPI_STATE_D0; i <= ACPI_STATE_D3_HOT; i++) {
9e89dde2
ZR
1001 struct acpi_device_power_state *ps = &device->power.states[i];
1002 char object_name[5] = { '_', 'P', 'R', '0' + i, '\0' };
1da177e4 1003
9e89dde2
ZR
1004 /* Evaluate "_PRx" to se if power resources are referenced */
1005 acpi_evaluate_reference(device->handle, object_name, NULL,
1006 &ps->resources);
1007 if (ps->resources.count) {
bf325f95
RW
1008 int j;
1009
9e89dde2 1010 device->power.flags.power_resources = 1;
bf325f95
RW
1011 for (j = 0; j < ps->resources.count; j++)
1012 acpi_bus_add_power_resource(ps->resources.handles[j]);
1da177e4 1013 }
1da177e4 1014
9e89dde2
ZR
1015 /* Evaluate "_PSx" to see if we can do explicit sets */
1016 object_name[2] = 'S';
1017 status = acpi_get_handle(device->handle, object_name, &handle);
37239978 1018 if (ACPI_SUCCESS(status))
9e89dde2 1019 ps->flags.explicit_set = 1;
1da177e4 1020
1cc0c998
LM
1021 /*
1022 * State is valid if there are means to put the device into it.
1023 * D3hot is only valid if _PR3 present.
1024 */
1025 if (ps->resources.count ||
1026 (ps->flags.explicit_set && i < ACPI_STATE_D3_HOT))
9e89dde2 1027 ps->flags.valid = 1;
1da177e4 1028
9e89dde2
ZR
1029 ps->power = -1; /* Unknown - driver assigned */
1030 ps->latency = -1; /* Unknown - driver assigned */
1031 }
1da177e4 1032
9e89dde2
ZR
1033 /* Set defaults for D0 and D3 states (always valid) */
1034 device->power.states[ACPI_STATE_D0].flags.valid = 1;
1035 device->power.states[ACPI_STATE_D0].power = 100;
1036 device->power.states[ACPI_STATE_D3].flags.valid = 1;
1037 device->power.states[ACPI_STATE_D3].power = 0;
c8f7a62c 1038
5c7dd710
RW
1039 /* Set D3cold's explicit_set flag if _PS3 exists. */
1040 if (device->power.states[ACPI_STATE_D3_HOT].flags.explicit_set)
1041 device->power.states[ACPI_STATE_D3_COLD].flags.explicit_set = 1;
1042
ade3e7fe 1043 acpi_bus_init_power(device);
c8f7a62c 1044
9e89dde2
ZR
1045 return 0;
1046}
c8f7a62c 1047
4be44fcd 1048static int acpi_bus_get_flags(struct acpi_device *device)
1da177e4 1049{
4be44fcd
LB
1050 acpi_status status = AE_OK;
1051 acpi_handle temp = NULL;
1da177e4 1052
1da177e4
LT
1053
1054 /* Presence of _STA indicates 'dynamic_status' */
1055 status = acpi_get_handle(device->handle, "_STA", &temp);
1056 if (ACPI_SUCCESS(status))
1057 device->flags.dynamic_status = 1;
1058
1da177e4
LT
1059 /* Presence of _RMV indicates 'removable' */
1060 status = acpi_get_handle(device->handle, "_RMV", &temp);
1061 if (ACPI_SUCCESS(status))
1062 device->flags.removable = 1;
1063
1064 /* Presence of _EJD|_EJ0 indicates 'ejectable' */
1065 status = acpi_get_handle(device->handle, "_EJD", &temp);
1066 if (ACPI_SUCCESS(status))
1067 device->flags.ejectable = 1;
1068 else {
1069 status = acpi_get_handle(device->handle, "_EJ0", &temp);
1070 if (ACPI_SUCCESS(status))
1071 device->flags.ejectable = 1;
1072 }
1073
7bed50c5
RW
1074 /* Power resources cannot be power manageable. */
1075 if (device->device_type == ACPI_BUS_TYPE_POWER)
1076 return 0;
1077
1da177e4
LT
1078 /* Presence of _PS0|_PR0 indicates 'power manageable' */
1079 status = acpi_get_handle(device->handle, "_PS0", &temp);
1080 if (ACPI_FAILURE(status))
1081 status = acpi_get_handle(device->handle, "_PR0", &temp);
1082 if (ACPI_SUCCESS(status))
1083 device->flags.power_manageable = 1;
1084
3c5f9be4 1085 /* TBD: Performance management */
1da177e4 1086
d550d98d 1087 return 0;
1da177e4
LT
1088}
1089
c7bcb4e9 1090static void acpi_device_get_busid(struct acpi_device *device)
1da177e4 1091{
4be44fcd
LB
1092 char bus_id[5] = { '?', 0 };
1093 struct acpi_buffer buffer = { sizeof(bus_id), bus_id };
1094 int i = 0;
1da177e4
LT
1095
1096 /*
1097 * Bus ID
1098 * ------
1099 * The device's Bus ID is simply the object name.
1100 * TBD: Shouldn't this value be unique (within the ACPI namespace)?
1101 */
859ac9a4 1102 if (ACPI_IS_ROOT_DEVICE(device)) {
1da177e4 1103 strcpy(device->pnp.bus_id, "ACPI");
859ac9a4
BH
1104 return;
1105 }
1106
1107 switch (device->device_type) {
1da177e4
LT
1108 case ACPI_BUS_TYPE_POWER_BUTTON:
1109 strcpy(device->pnp.bus_id, "PWRF");
1110 break;
1111 case ACPI_BUS_TYPE_SLEEP_BUTTON:
1112 strcpy(device->pnp.bus_id, "SLPF");
1113 break;
1114 default:
66b7ed40 1115 acpi_get_name(device->handle, ACPI_SINGLE_NAME, &buffer);
1da177e4
LT
1116 /* Clean up trailing underscores (if any) */
1117 for (i = 3; i > 1; i--) {
1118 if (bus_id[i] == '_')
1119 bus_id[i] = '\0';
1120 else
1121 break;
1122 }
1123 strcpy(device->pnp.bus_id, bus_id);
1124 break;
1125 }
1126}
1127
54735266
ZR
1128/*
1129 * acpi_bay_match - see if a device is an ejectable driver bay
1130 *
1131 * If an acpi object is ejectable and has one of the ACPI ATA methods defined,
1132 * then we can safely call it an ejectable drive bay
1133 */
1134static int acpi_bay_match(struct acpi_device *device){
1135 acpi_status status;
1136 acpi_handle handle;
1137 acpi_handle tmp;
1138 acpi_handle phandle;
1139
1140 handle = device->handle;
1141
1142 status = acpi_get_handle(handle, "_EJ0", &tmp);
1143 if (ACPI_FAILURE(status))
1144 return -ENODEV;
1145
1146 if ((ACPI_SUCCESS(acpi_get_handle(handle, "_GTF", &tmp))) ||
1147 (ACPI_SUCCESS(acpi_get_handle(handle, "_GTM", &tmp))) ||
1148 (ACPI_SUCCESS(acpi_get_handle(handle, "_STM", &tmp))) ||
1149 (ACPI_SUCCESS(acpi_get_handle(handle, "_SDD", &tmp))))
1150 return 0;
1151
1152 if (acpi_get_parent(handle, &phandle))
1153 return -ENODEV;
1154
1155 if ((ACPI_SUCCESS(acpi_get_handle(phandle, "_GTF", &tmp))) ||
1156 (ACPI_SUCCESS(acpi_get_handle(phandle, "_GTM", &tmp))) ||
1157 (ACPI_SUCCESS(acpi_get_handle(phandle, "_STM", &tmp))) ||
1158 (ACPI_SUCCESS(acpi_get_handle(phandle, "_SDD", &tmp))))
1159 return 0;
1160
1161 return -ENODEV;
1162}
1163
3620f2f2
FS
1164/*
1165 * acpi_dock_match - see if a device has a _DCK method
1166 */
1167static int acpi_dock_match(struct acpi_device *device)
1168{
1169 acpi_handle tmp;
1170 return acpi_get_handle(device->handle, "_DCK", &tmp);
1171}
1172
620e112c 1173const char *acpi_device_hid(struct acpi_device *device)
15b8dd53 1174{
7f47fa6c 1175 struct acpi_hardware_id *hid;
15b8dd53 1176
2b2ae7c7
TR
1177 if (list_empty(&device->pnp.ids))
1178 return dummy_hid;
1179
7f47fa6c
BH
1180 hid = list_first_entry(&device->pnp.ids, struct acpi_hardware_id, list);
1181 return hid->id;
1182}
1183EXPORT_SYMBOL(acpi_device_hid);
15b8dd53 1184
7f47fa6c
BH
1185static void acpi_add_id(struct acpi_device *device, const char *dev_id)
1186{
1187 struct acpi_hardware_id *id;
15b8dd53 1188
7f47fa6c
BH
1189 id = kmalloc(sizeof(*id), GFP_KERNEL);
1190 if (!id)
1191 return;
15b8dd53 1192
581de59e 1193 id->id = kstrdup(dev_id, GFP_KERNEL);
7f47fa6c
BH
1194 if (!id->id) {
1195 kfree(id);
1196 return;
15b8dd53
BM
1197 }
1198
7f47fa6c 1199 list_add_tail(&id->list, &device->pnp.ids);
15b8dd53
BM
1200}
1201
222e82ac
DW
1202/*
1203 * Old IBM workstations have a DSDT bug wherein the SMBus object
1204 * lacks the SMBUS01 HID and the methods do not have the necessary "_"
1205 * prefix. Work around this.
1206 */
1207static int acpi_ibm_smbus_match(struct acpi_device *device)
1208{
1209 acpi_handle h_dummy;
1210 struct acpi_buffer path = {ACPI_ALLOCATE_BUFFER, NULL};
1211 int result;
1212
1213 if (!dmi_name_in_vendors("IBM"))
1214 return -ENODEV;
1215
1216 /* Look for SMBS object */
1217 result = acpi_get_name(device->handle, ACPI_SINGLE_NAME, &path);
1218 if (result)
1219 return result;
1220
1221 if (strcmp("SMBS", path.pointer)) {
1222 result = -ENODEV;
1223 goto out;
1224 }
1225
1226 /* Does it have the necessary (but misnamed) methods? */
1227 result = -ENODEV;
1228 if (ACPI_SUCCESS(acpi_get_handle(device->handle, "SBI", &h_dummy)) &&
1229 ACPI_SUCCESS(acpi_get_handle(device->handle, "SBR", &h_dummy)) &&
1230 ACPI_SUCCESS(acpi_get_handle(device->handle, "SBW", &h_dummy)))
1231 result = 0;
1232out:
1233 kfree(path.pointer);
1234 return result;
1235}
1236
c7bcb4e9 1237static void acpi_device_set_id(struct acpi_device *device)
1da177e4 1238{
4be44fcd 1239 acpi_status status;
57f3674f
BH
1240 struct acpi_device_info *info;
1241 struct acpica_device_id_list *cid_list;
7f47fa6c 1242 int i;
1da177e4 1243
c7bcb4e9 1244 switch (device->device_type) {
1da177e4 1245 case ACPI_BUS_TYPE_DEVICE:
859ac9a4 1246 if (ACPI_IS_ROOT_DEVICE(device)) {
57f3674f 1247 acpi_add_id(device, ACPI_SYSTEM_HID);
859ac9a4
BH
1248 break;
1249 }
1250
66b7ed40 1251 status = acpi_get_object_info(device->handle, &info);
1da177e4 1252 if (ACPI_FAILURE(status)) {
96b2dd1f 1253 printk(KERN_ERR PREFIX "%s: Error reading device info\n", __func__);
1da177e4
LT
1254 return;
1255 }
1256
1da177e4 1257 if (info->valid & ACPI_VALID_HID)
57f3674f
BH
1258 acpi_add_id(device, info->hardware_id.string);
1259 if (info->valid & ACPI_VALID_CID) {
15b8dd53 1260 cid_list = &info->compatible_id_list;
57f3674f
BH
1261 for (i = 0; i < cid_list->count; i++)
1262 acpi_add_id(device, cid_list->ids[i].string);
1263 }
1da177e4
LT
1264 if (info->valid & ACPI_VALID_ADR) {
1265 device->pnp.bus_address = info->address;
1266 device->flags.bus_address = 1;
1267 }
ccf78040
LZ
1268 if (info->valid & ACPI_VALID_UID)
1269 device->pnp.unique_id = kstrdup(info->unique_id.string,
1270 GFP_KERNEL);
ae843332 1271
a83893ae
BH
1272 kfree(info);
1273
57f3674f
BH
1274 /*
1275 * Some devices don't reliably have _HIDs & _CIDs, so add
1276 * synthetic HIDs to make sure drivers can find them.
1277 */
c3d6de69 1278 if (acpi_is_video_device(device))
57f3674f 1279 acpi_add_id(device, ACPI_VIDEO_HID);
3620f2f2 1280 else if (ACPI_SUCCESS(acpi_bay_match(device)))
57f3674f 1281 acpi_add_id(device, ACPI_BAY_HID);
3620f2f2 1282 else if (ACPI_SUCCESS(acpi_dock_match(device)))
57f3674f 1283 acpi_add_id(device, ACPI_DOCK_HID);
222e82ac
DW
1284 else if (!acpi_ibm_smbus_match(device))
1285 acpi_add_id(device, ACPI_SMBUS_IBM_HID);
b7b30de5
BH
1286 else if (!acpi_device_hid(device) &&
1287 ACPI_IS_ROOT_DEVICE(device->parent)) {
1288 acpi_add_id(device, ACPI_BUS_HID); /* \_SB, LNXSYBUS */
1289 strcpy(device->pnp.device_name, ACPI_BUS_DEVICE_NAME);
1290 strcpy(device->pnp.device_class, ACPI_BUS_CLASS);
1291 }
54735266 1292
1da177e4
LT
1293 break;
1294 case ACPI_BUS_TYPE_POWER:
57f3674f 1295 acpi_add_id(device, ACPI_POWER_HID);
1da177e4
LT
1296 break;
1297 case ACPI_BUS_TYPE_PROCESSOR:
57f3674f 1298 acpi_add_id(device, ACPI_PROCESSOR_OBJECT_HID);
1da177e4 1299 break;
1da177e4 1300 case ACPI_BUS_TYPE_THERMAL:
57f3674f 1301 acpi_add_id(device, ACPI_THERMAL_HID);
1da177e4
LT
1302 break;
1303 case ACPI_BUS_TYPE_POWER_BUTTON:
57f3674f 1304 acpi_add_id(device, ACPI_BUTTON_HID_POWERF);
1da177e4
LT
1305 break;
1306 case ACPI_BUS_TYPE_SLEEP_BUTTON:
57f3674f 1307 acpi_add_id(device, ACPI_BUTTON_HID_SLEEPF);
1da177e4
LT
1308 break;
1309 }
1da177e4
LT
1310}
1311
bc3b0772 1312static int acpi_device_set_context(struct acpi_device *device)
1da177e4 1313{
bc3b0772
BH
1314 acpi_status status;
1315
1da177e4
LT
1316 /*
1317 * Context
1318 * -------
1319 * Attach this 'struct acpi_device' to the ACPI object. This makes
bc3b0772
BH
1320 * resolutions from handle->device very efficient. Fixed hardware
1321 * devices have no handles, so we skip them.
1da177e4 1322 */
bc3b0772
BH
1323 if (!device->handle)
1324 return 0;
1da177e4 1325
bc3b0772
BH
1326 status = acpi_attach_data(device->handle,
1327 acpi_bus_data_handler, device);
1328 if (ACPI_SUCCESS(status))
1329 return 0;
1330
1331 printk(KERN_ERR PREFIX "Error attaching device data\n");
1332 return -ENODEV;
1da177e4
LT
1333}
1334
4be44fcd 1335static int acpi_bus_remove(struct acpi_device *dev, int rmdevice)
1da177e4 1336{
1da177e4 1337 if (!dev)
d550d98d 1338 return -EINVAL;
1da177e4 1339
96333578 1340 dev->removal_type = ACPI_BUS_REMOVAL_EJECT;
1890a97a 1341 device_release_driver(&dev->dev);
1da177e4
LT
1342
1343 if (!rmdevice)
d550d98d 1344 return 0;
1da177e4 1345
2786f6e3
RZ
1346 /*
1347 * unbind _ADR-Based Devices when hot removal
1348 */
1da177e4
LT
1349 if (dev->flags.bus_address) {
1350 if ((dev->parent) && (dev->parent->ops.unbind))
1351 dev->parent->ops.unbind(dev);
1352 }
1da177e4
LT
1353 acpi_device_unregister(dev, ACPI_BUS_REMOVAL_EJECT);
1354
d550d98d 1355 return 0;
1da177e4
LT
1356}
1357
5c478f49
BH
1358static int acpi_add_single_object(struct acpi_device **child,
1359 acpi_handle handle, int type,
778cbc1d 1360 unsigned long long sta,
5c478f49 1361 struct acpi_bus_ops *ops)
1da177e4 1362{
77c24888
BH
1363 int result;
1364 struct acpi_device *device;
29aaefa6 1365 struct acpi_buffer buffer = { ACPI_ALLOCATE_BUFFER, NULL };
1da177e4 1366
36bcbec7 1367 device = kzalloc(sizeof(struct acpi_device), GFP_KERNEL);
1da177e4 1368 if (!device) {
6468463a 1369 printk(KERN_ERR PREFIX "Memory allocation error\n");
d550d98d 1370 return -ENOMEM;
1da177e4 1371 }
1da177e4 1372
7f47fa6c 1373 INIT_LIST_HEAD(&device->pnp.ids);
caaa6efb 1374 device->device_type = type;
1da177e4 1375 device->handle = handle;
5c478f49 1376 device->parent = acpi_bus_get_parent(handle);
c4168bff 1377 device->bus_ops = *ops; /* workround for not call .start */
778cbc1d 1378 STRUCT_TO_INT(device->status) = sta;
c4168bff 1379
c7bcb4e9 1380 acpi_device_get_busid(device);
1da177e4
LT
1381
1382 /*
1383 * Flags
1384 * -----
778cbc1d
BH
1385 * Note that we only look for object handles -- cannot evaluate objects
1386 * until we know the device is present and properly initialized.
1da177e4
LT
1387 */
1388 result = acpi_bus_get_flags(device);
1389 if (result)
1390 goto end;
1391
1da177e4
LT
1392 /*
1393 * Initialize Device
1394 * -----------------
1395 * TBD: Synch with Core's enumeration/initialization process.
1396 */
c7bcb4e9 1397 acpi_device_set_id(device);
1da177e4
LT
1398
1399 /*
1400 * Power Management
1401 * ----------------
1402 */
1403 if (device->flags.power_manageable) {
1404 result = acpi_bus_get_power_flags(device);
1405 if (result)
1406 goto end;
1407 }
1408
4be44fcd 1409 /*
1da177e4
LT
1410 * Wakeup device management
1411 *-----------------------
1412 */
d57d09a4 1413 acpi_bus_get_wakeup_device_flags(device);
1da177e4
LT
1414
1415 /*
1416 * Performance Management
1417 * ----------------------
1418 */
1419 if (device->flags.performance_manageable) {
1420 result = acpi_bus_get_perf_flags(device);
1421 if (result)
1422 goto end;
1423 }
1424
bc3b0772 1425 if ((result = acpi_device_set_context(device)))
f61f9258 1426 goto end;
1da177e4 1427
66b7ed40 1428 result = acpi_device_register(device);
1da177e4
LT
1429
1430 /*
2786f6e3 1431 * Bind _ADR-Based Devices when hot add
1da177e4
LT
1432 */
1433 if (device->flags.bus_address) {
1434 if (device->parent && device->parent->ops.bind)
1435 device->parent->ops.bind(device);
1436 }
1437
0c526d96 1438end:
29aaefa6
BH
1439 if (!result) {
1440 acpi_get_name(handle, ACPI_FULL_PATHNAME, &buffer);
1441 ACPI_DEBUG_PRINT((ACPI_DB_INFO,
1442 "Adding %s [%s] parent %s\n", dev_name(&device->dev),
1443 (char *) buffer.pointer,
1444 device->parent ? dev_name(&device->parent->dev) :
1445 "(null)"));
1446 kfree(buffer.pointer);
1da177e4 1447 *child = device;
29aaefa6 1448 } else
718fb0de 1449 acpi_device_release(&device->dev);
1da177e4 1450
d550d98d 1451 return result;
1da177e4 1452}
1da177e4 1453
778cbc1d
BH
1454#define ACPI_STA_DEFAULT (ACPI_STA_DEVICE_PRESENT | ACPI_STA_DEVICE_ENABLED | \
1455 ACPI_STA_DEVICE_UI | ACPI_STA_DEVICE_FUNCTIONING)
1456
bf325f95
RW
1457static void acpi_bus_add_power_resource(acpi_handle handle)
1458{
1459 struct acpi_bus_ops ops = {
1460 .acpi_op_add = 1,
1461 .acpi_op_start = 1,
1462 };
1463 struct acpi_device *device = NULL;
1464
1465 acpi_bus_get_device(handle, &device);
1466 if (!device)
1467 acpi_add_single_object(&device, handle, ACPI_BUS_TYPE_POWER,
1468 ACPI_STA_DEFAULT, &ops);
1469}
1470
778cbc1d
BH
1471static int acpi_bus_type_and_status(acpi_handle handle, int *type,
1472 unsigned long long *sta)
1da177e4 1473{
778cbc1d
BH
1474 acpi_status status;
1475 acpi_object_type acpi_type;
1da177e4 1476
778cbc1d 1477 status = acpi_get_type(handle, &acpi_type);
51a85faf 1478 if (ACPI_FAILURE(status))
778cbc1d 1479 return -ENODEV;
4be44fcd 1480
778cbc1d 1481 switch (acpi_type) {
51a85faf
BH
1482 case ACPI_TYPE_ANY: /* for ACPI_ROOT_OBJECT */
1483 case ACPI_TYPE_DEVICE:
778cbc1d
BH
1484 *type = ACPI_BUS_TYPE_DEVICE;
1485 status = acpi_bus_get_status_handle(handle, sta);
1486 if (ACPI_FAILURE(status))
1487 return -ENODEV;
51a85faf
BH
1488 break;
1489 case ACPI_TYPE_PROCESSOR:
778cbc1d
BH
1490 *type = ACPI_BUS_TYPE_PROCESSOR;
1491 status = acpi_bus_get_status_handle(handle, sta);
1492 if (ACPI_FAILURE(status))
1493 return -ENODEV;
51a85faf
BH
1494 break;
1495 case ACPI_TYPE_THERMAL:
778cbc1d
BH
1496 *type = ACPI_BUS_TYPE_THERMAL;
1497 *sta = ACPI_STA_DEFAULT;
51a85faf
BH
1498 break;
1499 case ACPI_TYPE_POWER:
778cbc1d
BH
1500 *type = ACPI_BUS_TYPE_POWER;
1501 *sta = ACPI_STA_DEFAULT;
51a85faf
BH
1502 break;
1503 default:
778cbc1d 1504 return -ENODEV;
51a85faf 1505 }
1da177e4 1506
778cbc1d
BH
1507 return 0;
1508}
1509
1510static acpi_status acpi_bus_check_add(acpi_handle handle, u32 lvl,
1511 void *context, void **return_value)
1512{
1513 struct acpi_bus_ops *ops = context;
778cbc1d
BH
1514 int type;
1515 unsigned long long sta;
e3b87f8a
BH
1516 struct acpi_device *device;
1517 acpi_status status;
778cbc1d
BH
1518 int result;
1519
1520 result = acpi_bus_type_and_status(handle, &type, &sta);
1521 if (result)
1522 return AE_OK;
1523
1524 if (!(sta & ACPI_STA_DEVICE_PRESENT) &&
b581a7f9 1525 !(sta & ACPI_STA_DEVICE_FUNCTIONING)) {
86e4e20e
RW
1526 struct acpi_device_wakeup wakeup;
1527 acpi_handle temp;
1528
1529 status = acpi_get_handle(handle, "_PRW", &temp);
1530 if (ACPI_SUCCESS(status))
1531 acpi_bus_extract_wakeup_device_power_package(handle,
1532 &wakeup);
778cbc1d 1533 return AE_CTRL_DEPTH;
b581a7f9 1534 }
778cbc1d 1535
e3b87f8a
BH
1536 /*
1537 * We may already have an acpi_device from a previous enumeration. If
1538 * so, we needn't add it again, but we may still have to start it.
1539 */
1540 device = NULL;
1541 acpi_bus_get_device(handle, &device);
1542 if (ops->acpi_op_add && !device)
1543 acpi_add_single_object(&device, handle, type, sta, ops);
1da177e4 1544
e3b87f8a 1545 if (!device)
51a85faf 1546 return AE_CTRL_DEPTH;
1da177e4 1547
51a85faf
BH
1548 if (ops->acpi_op_start && !(ops->acpi_op_add)) {
1549 status = acpi_start_single_object(device);
1da177e4 1550 if (ACPI_FAILURE(status))
51a85faf
BH
1551 return AE_CTRL_DEPTH;
1552 }
1da177e4 1553
51a85faf
BH
1554 if (!*return_value)
1555 *return_value = device;
1556 return AE_OK;
1557}
3fb02738 1558
51a85faf
BH
1559static int acpi_bus_scan(acpi_handle handle, struct acpi_bus_ops *ops,
1560 struct acpi_device **child)
1561{
1562 acpi_status status;
51a85faf 1563 void *device = NULL;
3fb02738 1564
51a85faf
BH
1565 status = acpi_bus_check_add(handle, 0, ops, &device);
1566 if (ACPI_SUCCESS(status))
1567 acpi_walk_namespace(ACPI_TYPE_ANY, handle, ACPI_UINT32_MAX,
2263576c 1568 acpi_bus_check_add, NULL, ops, &device);
1da177e4 1569
51a85faf
BH
1570 if (child)
1571 *child = device;
7779688f
TR
1572
1573 if (device)
1574 return 0;
1575 else
1576 return -ENODEV;
1da177e4 1577}
1da177e4 1578
7779688f
TR
1579/*
1580 * acpi_bus_add and acpi_bus_start
1581 *
1582 * scan a given ACPI tree and (probably recently hot-plugged)
1583 * create and add or starts found devices.
1584 *
1585 * If no devices were found -ENODEV is returned which does not
1586 * mean that this is a real error, there just have been no suitable
1587 * ACPI objects in the table trunk from which the kernel could create
1588 * a device and add/start an appropriate driver.
1589 */
1590
3fb02738 1591int
4be44fcd
LB
1592acpi_bus_add(struct acpi_device **child,
1593 struct acpi_device *parent, acpi_handle handle, int type)
3fb02738 1594{
3fb02738
RS
1595 struct acpi_bus_ops ops;
1596
c4168bff
LS
1597 memset(&ops, 0, sizeof(ops));
1598 ops.acpi_op_add = 1;
3fb02738 1599
7779688f 1600 return acpi_bus_scan(handle, &ops, child);
3fb02738
RS
1601}
1602EXPORT_SYMBOL(acpi_bus_add);
1603
4be44fcd 1604int acpi_bus_start(struct acpi_device *device)
3fb02738 1605{
3fb02738 1606 struct acpi_bus_ops ops;
a2100801 1607 int result;
3fb02738 1608
d2f6650a
TR
1609 if (!device)
1610 return -EINVAL;
1611
8e029bf0
BH
1612 memset(&ops, 0, sizeof(ops));
1613 ops.acpi_op_start = 1;
3fb02738 1614
a2100801
RW
1615 result = acpi_bus_scan(device->handle, &ops, NULL);
1616
3a37898d 1617 acpi_update_all_gpes();
a2100801
RW
1618
1619 return result;
3fb02738
RS
1620}
1621EXPORT_SYMBOL(acpi_bus_start);
1da177e4 1622
ceaba663 1623int acpi_bus_trim(struct acpi_device *start, int rmdevice)
1da177e4 1624{
4be44fcd
LB
1625 acpi_status status;
1626 struct acpi_device *parent, *child;
1627 acpi_handle phandle, chandle;
1628 acpi_object_type type;
1629 u32 level = 1;
1630 int err = 0;
1631
1632 parent = start;
1da177e4
LT
1633 phandle = start->handle;
1634 child = chandle = NULL;
1635
1636 while ((level > 0) && parent && (!err)) {
1637 status = acpi_get_next_object(ACPI_TYPE_ANY, phandle,
4be44fcd 1638 chandle, &chandle);
1da177e4
LT
1639
1640 /*
1641 * If this scope is exhausted then move our way back up.
1642 */
1643 if (ACPI_FAILURE(status)) {
1644 level--;
1645 chandle = phandle;
1646 acpi_get_parent(phandle, &phandle);
1647 child = parent;
1648 parent = parent->parent;
1649
1650 if (level == 0)
1651 err = acpi_bus_remove(child, rmdevice);
1652 else
1653 err = acpi_bus_remove(child, 1);
1654
1655 continue;
1656 }
1657
1658 status = acpi_get_type(chandle, &type);
1659 if (ACPI_FAILURE(status)) {
1660 continue;
1661 }
1662 /*
1663 * If there is a device corresponding to chandle then
1664 * parse it (depth-first).
1665 */
1666 if (acpi_bus_get_device(chandle, &child) == 0) {
1667 level++;
1668 phandle = chandle;
1669 chandle = NULL;
1670 parent = child;
1671 }
1672 continue;
1673 }
1674 return err;
1675}
ceaba663
KA
1676EXPORT_SYMBOL_GPL(acpi_bus_trim);
1677
e8b945c9 1678static int acpi_bus_scan_fixed(void)
1da177e4 1679{
4be44fcd
LB
1680 int result = 0;
1681 struct acpi_device *device = NULL;
c4168bff 1682 struct acpi_bus_ops ops;
1da177e4 1683
c4168bff
LS
1684 memset(&ops, 0, sizeof(ops));
1685 ops.acpi_op_add = 1;
1686 ops.acpi_op_start = 1;
1687
1da177e4
LT
1688 /*
1689 * Enumerate all fixed-feature devices.
1690 */
cee324b1 1691 if ((acpi_gbl_FADT.flags & ACPI_FADT_POWER_BUTTON) == 0) {
5c478f49 1692 result = acpi_add_single_object(&device, NULL,
c4168bff 1693 ACPI_BUS_TYPE_POWER_BUTTON,
778cbc1d 1694 ACPI_STA_DEFAULT,
c4168bff 1695 &ops);
c10d7a13 1696 device_init_wakeup(&device->dev, true);
3fb02738 1697 }
1da177e4 1698
cee324b1 1699 if ((acpi_gbl_FADT.flags & ACPI_FADT_SLEEP_BUTTON) == 0) {
5c478f49 1700 result = acpi_add_single_object(&device, NULL,
c4168bff 1701 ACPI_BUS_TYPE_SLEEP_BUTTON,
778cbc1d 1702 ACPI_STA_DEFAULT,
c4168bff 1703 &ops);
3fb02738 1704 }
1da177e4 1705
d550d98d 1706 return result;
1da177e4
LT
1707}
1708
e747f274 1709int __init acpi_scan_init(void)
1da177e4
LT
1710{
1711 int result;
3fb02738 1712 struct acpi_bus_ops ops;
1da177e4 1713
c4168bff
LS
1714 memset(&ops, 0, sizeof(ops));
1715 ops.acpi_op_add = 1;
1716 ops.acpi_op_start = 1;
1da177e4 1717
5b327265
PM
1718 result = bus_register(&acpi_bus_type);
1719 if (result) {
1720 /* We don't want to quit even if we failed to add suspend/resume */
1721 printk(KERN_ERR PREFIX "Could not register bus type\n");
1722 }
1723
97d9a9e9
RW
1724 acpi_power_init();
1725
1da177e4
LT
1726 /*
1727 * Enumerate devices in the ACPI namespace.
1728 */
51a85faf 1729 result = acpi_bus_scan(ACPI_ROOT_OBJECT, &ops, &acpi_root);
c04209a7 1730
c4168bff 1731 if (!result)
adc08e20 1732 result = acpi_bus_scan_fixed();
1da177e4
LT
1733
1734 if (result)
1735 acpi_device_unregister(acpi_root, ACPI_BUS_REMOVAL_NORMAL);
a2100801 1736 else
3a37898d 1737 acpi_update_all_gpes();
1da177e4 1738
d550d98d 1739 return result;
1da177e4 1740}