2 * drivers/base/core.c - core driver model code (device registration, etc)
4 * Copyright (c) 2002-3 Patrick Mochel
5 * Copyright (c) 2002-3 Open Source Development Labs
6 * Copyright (c) 2006 Greg Kroah-Hartman <gregkh@suse.de>
7 * Copyright (c) 2006 Novell, Inc.
9 * This file is released under the GPLv2
13 #include <linux/device.h>
14 #include <linux/err.h>
15 #include <linux/init.h>
16 #include <linux/module.h>
17 #include <linux/slab.h>
18 #include <linux/string.h>
19 #include <linux/kdev_t.h>
20 #include <linux/notifier.h>
22 #include <asm/semaphore.h>
25 #include "power/power.h"
27 int (*platform_notify
)(struct device
* dev
) = NULL
;
28 int (*platform_notify_remove
)(struct device
* dev
) = NULL
;
31 * sysfs bindings for devices.
35 * dev_driver_string - Return a device's driver name, if at all possible
36 * @dev: struct device to get the name of
38 * Will return the device's driver's name if it is bound to a device. If
39 * the device is not bound to a device, it will return the name of the bus
40 * it is attached to. If it is not attached to a bus either, an empty
41 * string will be returned.
43 const char *dev_driver_string(struct device
*dev
)
45 return dev
->driver
? dev
->driver
->name
:
46 (dev
->bus
? dev
->bus
->name
: "");
48 EXPORT_SYMBOL(dev_driver_string
);
50 #define to_dev(obj) container_of(obj, struct device, kobj)
51 #define to_dev_attr(_attr) container_of(_attr, struct device_attribute, attr)
54 dev_attr_show(struct kobject
* kobj
, struct attribute
* attr
, char * buf
)
56 struct device_attribute
* dev_attr
= to_dev_attr(attr
);
57 struct device
* dev
= to_dev(kobj
);
61 ret
= dev_attr
->show(dev
, dev_attr
, buf
);
66 dev_attr_store(struct kobject
* kobj
, struct attribute
* attr
,
67 const char * buf
, size_t count
)
69 struct device_attribute
* dev_attr
= to_dev_attr(attr
);
70 struct device
* dev
= to_dev(kobj
);
74 ret
= dev_attr
->store(dev
, dev_attr
, buf
, count
);
78 static struct sysfs_ops dev_sysfs_ops
= {
79 .show
= dev_attr_show
,
80 .store
= dev_attr_store
,
85 * device_release - free device structure.
86 * @kobj: device's kobject.
88 * This is called once the reference count for the object
89 * reaches 0. We forward the call to the device's release
90 * method, which should handle actually freeing the structure.
92 static void device_release(struct kobject
* kobj
)
94 struct device
* dev
= to_dev(kobj
);
98 else if (dev
->type
&& dev
->type
->release
)
99 dev
->type
->release(dev
);
100 else if (dev
->class && dev
->class->dev_release
)
101 dev
->class->dev_release(dev
);
103 printk(KERN_ERR
"Device '%s' does not have a release() function, "
104 "it is broken and must be fixed.\n",
110 static struct kobj_type ktype_device
= {
111 .release
= device_release
,
112 .sysfs_ops
= &dev_sysfs_ops
,
116 static int dev_uevent_filter(struct kset
*kset
, struct kobject
*kobj
)
118 struct kobj_type
*ktype
= get_ktype(kobj
);
120 if (ktype
== &ktype_device
) {
121 struct device
*dev
= to_dev(kobj
);
130 static const char *dev_uevent_name(struct kset
*kset
, struct kobject
*kobj
)
132 struct device
*dev
= to_dev(kobj
);
135 return dev
->bus
->name
;
137 return dev
->class->name
;
141 static int dev_uevent(struct kset
*kset
, struct kobject
*kobj
, char **envp
,
142 int num_envp
, char *buffer
, int buffer_size
)
144 struct device
*dev
= to_dev(kobj
);
149 /* add the major/minor if present */
150 if (MAJOR(dev
->devt
)) {
151 add_uevent_var(envp
, num_envp
, &i
,
152 buffer
, buffer_size
, &length
,
153 "MAJOR=%u", MAJOR(dev
->devt
));
154 add_uevent_var(envp
, num_envp
, &i
,
155 buffer
, buffer_size
, &length
,
156 "MINOR=%u", MINOR(dev
->devt
));
160 add_uevent_var(envp
, num_envp
, &i
,
161 buffer
, buffer_size
, &length
,
162 "DRIVER=%s", dev
->driver
->name
);
164 #ifdef CONFIG_SYSFS_DEPRECATED
166 struct device
*parent
= dev
->parent
;
168 /* find first bus device in parent chain */
169 while (parent
&& !parent
->bus
)
170 parent
= parent
->parent
;
171 if (parent
&& parent
->bus
) {
174 path
= kobject_get_path(&parent
->kobj
, GFP_KERNEL
);
175 add_uevent_var(envp
, num_envp
, &i
,
176 buffer
, buffer_size
, &length
,
177 "PHYSDEVPATH=%s", path
);
180 add_uevent_var(envp
, num_envp
, &i
,
181 buffer
, buffer_size
, &length
,
182 "PHYSDEVBUS=%s", parent
->bus
->name
);
185 add_uevent_var(envp
, num_envp
, &i
,
186 buffer
, buffer_size
, &length
,
187 "PHYSDEVDRIVER=%s", parent
->driver
->name
);
189 } else if (dev
->bus
) {
190 add_uevent_var(envp
, num_envp
, &i
,
191 buffer
, buffer_size
, &length
,
192 "PHYSDEVBUS=%s", dev
->bus
->name
);
195 add_uevent_var(envp
, num_envp
, &i
,
196 buffer
, buffer_size
, &length
,
197 "PHYSDEVDRIVER=%s", dev
->driver
->name
);
201 /* terminate, set to next free slot, shrink available space */
205 buffer
= &buffer
[length
];
206 buffer_size
-= length
;
208 if (dev
->bus
&& dev
->bus
->uevent
) {
209 /* have the bus specific function add its stuff */
210 retval
= dev
->bus
->uevent(dev
, envp
, num_envp
, buffer
, buffer_size
);
212 pr_debug ("%s: bus uevent() returned %d\n",
213 __FUNCTION__
, retval
);
216 if (dev
->class && dev
->class->dev_uevent
) {
217 /* have the class specific function add its stuff */
218 retval
= dev
->class->dev_uevent(dev
, envp
, num_envp
, buffer
, buffer_size
);
220 pr_debug("%s: class uevent() returned %d\n",
221 __FUNCTION__
, retval
);
224 if (dev
->type
&& dev
->type
->uevent
) {
225 /* have the device type specific fuction add its stuff */
226 retval
= dev
->type
->uevent(dev
, envp
, num_envp
, buffer
, buffer_size
);
228 pr_debug("%s: dev_type uevent() returned %d\n",
229 __FUNCTION__
, retval
);
235 static struct kset_uevent_ops device_uevent_ops
= {
236 .filter
= dev_uevent_filter
,
237 .name
= dev_uevent_name
,
238 .uevent
= dev_uevent
,
241 static ssize_t
store_uevent(struct device
*dev
, struct device_attribute
*attr
,
242 const char *buf
, size_t count
)
244 kobject_uevent(&dev
->kobj
, KOBJ_ADD
);
248 static int device_add_groups(struct device
*dev
)
254 for (i
= 0; dev
->groups
[i
]; i
++) {
255 error
= sysfs_create_group(&dev
->kobj
, dev
->groups
[i
]);
258 sysfs_remove_group(&dev
->kobj
, dev
->groups
[i
]);
267 static void device_remove_groups(struct device
*dev
)
271 for (i
= 0; dev
->groups
[i
]; i
++) {
272 sysfs_remove_group(&dev
->kobj
, dev
->groups
[i
]);
277 static int device_add_attrs(struct device
*dev
)
279 struct class *class = dev
->class;
280 struct device_type
*type
= dev
->type
;
284 if (class && class->dev_attrs
) {
285 for (i
= 0; attr_name(class->dev_attrs
[i
]); i
++) {
286 error
= device_create_file(dev
, &class->dev_attrs
[i
]);
292 device_remove_file(dev
, &class->dev_attrs
[i
]);
295 if (type
&& type
->attrs
) {
296 for (i
= 0; attr_name(type
->attrs
[i
]); i
++) {
297 error
= device_create_file(dev
, &type
->attrs
[i
]);
303 device_remove_file(dev
, &type
->attrs
[i
]);
309 static void device_remove_attrs(struct device
*dev
)
311 struct class *class = dev
->class;
312 struct device_type
*type
= dev
->type
;
315 if (class && class->dev_attrs
) {
316 for (i
= 0; attr_name(class->dev_attrs
[i
]); i
++)
317 device_remove_file(dev
, &class->dev_attrs
[i
]);
320 if (type
&& type
->attrs
) {
321 for (i
= 0; attr_name(type
->attrs
[i
]); i
++)
322 device_remove_file(dev
, &type
->attrs
[i
]);
327 static ssize_t
show_dev(struct device
*dev
, struct device_attribute
*attr
,
330 return print_dev_t(buf
, dev
->devt
);
334 * devices_subsys - structure to be registered with kobject core.
337 decl_subsys(devices
, &ktype_device
, &device_uevent_ops
);
341 * device_create_file - create sysfs attribute file for device.
343 * @attr: device attribute descriptor.
346 int device_create_file(struct device
* dev
, struct device_attribute
* attr
)
349 if (get_device(dev
)) {
350 error
= sysfs_create_file(&dev
->kobj
, &attr
->attr
);
357 * device_remove_file - remove sysfs attribute file.
359 * @attr: device attribute descriptor.
362 void device_remove_file(struct device
* dev
, struct device_attribute
* attr
)
364 if (get_device(dev
)) {
365 sysfs_remove_file(&dev
->kobj
, &attr
->attr
);
371 * device_create_bin_file - create sysfs binary attribute file for device.
373 * @attr: device binary attribute descriptor.
375 int device_create_bin_file(struct device
*dev
, struct bin_attribute
*attr
)
379 error
= sysfs_create_bin_file(&dev
->kobj
, attr
);
382 EXPORT_SYMBOL_GPL(device_create_bin_file
);
385 * device_remove_bin_file - remove sysfs binary attribute file
387 * @attr: device binary attribute descriptor.
389 void device_remove_bin_file(struct device
*dev
, struct bin_attribute
*attr
)
392 sysfs_remove_bin_file(&dev
->kobj
, attr
);
394 EXPORT_SYMBOL_GPL(device_remove_bin_file
);
396 static void klist_children_get(struct klist_node
*n
)
398 struct device
*dev
= container_of(n
, struct device
, knode_parent
);
403 static void klist_children_put(struct klist_node
*n
)
405 struct device
*dev
= container_of(n
, struct device
, knode_parent
);
412 * device_initialize - init device structure.
415 * This prepares the device for use by other layers,
416 * including adding it to the device hierarchy.
417 * It is the first half of device_register(), if called by
418 * that, though it can also be called separately, so one
419 * may use @dev's fields (e.g. the refcount).
422 void device_initialize(struct device
*dev
)
424 kobj_set_kset_s(dev
, devices_subsys
);
425 kobject_init(&dev
->kobj
);
426 klist_init(&dev
->klist_children
, klist_children_get
,
428 INIT_LIST_HEAD(&dev
->dma_pools
);
429 INIT_LIST_HEAD(&dev
->node
);
430 init_MUTEX(&dev
->sem
);
431 device_init_wakeup(dev
, 0);
432 set_dev_node(dev
, -1);
435 #ifdef CONFIG_SYSFS_DEPRECATED
436 static struct kobject
* get_device_parent(struct device
*dev
,
437 struct device
*parent
)
439 /* Set the parent to the class, not the parent device */
440 /* this keeps sysfs from having a symlink to make old udevs happy */
442 return &dev
->class->subsys
.kset
.kobj
;
444 return &parent
->kobj
;
449 static struct kobject
* virtual_device_parent(struct device
*dev
)
452 return ERR_PTR(-ENODEV
);
454 if (!dev
->class->virtual_dir
) {
455 static struct kobject
*virtual_dir
= NULL
;
458 virtual_dir
= kobject_add_dir(&devices_subsys
.kset
.kobj
, "virtual");
459 dev
->class->virtual_dir
= kobject_add_dir(virtual_dir
, dev
->class->name
);
462 return dev
->class->virtual_dir
;
465 static struct kobject
* get_device_parent(struct device
*dev
,
466 struct device
*parent
)
468 /* if this is a class device, and has no parent, create one */
469 if ((dev
->class) && (parent
== NULL
)) {
470 return virtual_device_parent(dev
);
472 return &parent
->kobj
;
477 static int setup_parent(struct device
*dev
, struct device
*parent
)
479 struct kobject
*kobj
;
480 kobj
= get_device_parent(dev
, parent
);
482 return PTR_ERR(kobj
);
484 dev
->kobj
.parent
= kobj
;
489 * device_add - add device to device hierarchy.
492 * This is part 2 of device_register(), though may be called
493 * separately _iff_ device_initialize() has been called separately.
495 * This adds it to the kobject hierarchy via kobject_add(), adds it
496 * to the global and sibling lists for the device, then
497 * adds it to the other relevant subsystems of the driver model.
499 int device_add(struct device
*dev
)
501 struct device
*parent
= NULL
;
502 char *class_name
= NULL
;
503 struct class_interface
*class_intf
;
506 dev
= get_device(dev
);
507 if (!dev
|| !strlen(dev
->bus_id
))
510 pr_debug("DEV: registering device: ID = '%s'\n", dev
->bus_id
);
512 parent
= get_device(dev
->parent
);
514 error
= setup_parent(dev
, parent
);
518 /* first, register with generic layer. */
519 kobject_set_name(&dev
->kobj
, "%s", dev
->bus_id
);
520 error
= kobject_add(&dev
->kobj
);
524 /* notify platform of device entry */
526 platform_notify(dev
);
528 /* notify clients of device entry (new way) */
530 blocking_notifier_call_chain(&dev
->bus
->bus_notifier
,
531 BUS_NOTIFY_ADD_DEVICE
, dev
);
533 dev
->uevent_attr
.attr
.name
= "uevent";
534 dev
->uevent_attr
.attr
.mode
= S_IWUSR
;
536 dev
->uevent_attr
.attr
.owner
= dev
->driver
->owner
;
537 dev
->uevent_attr
.store
= store_uevent
;
538 error
= device_create_file(dev
, &dev
->uevent_attr
);
542 if (MAJOR(dev
->devt
)) {
543 struct device_attribute
*attr
;
544 attr
= kzalloc(sizeof(*attr
), GFP_KERNEL
);
547 goto ueventattrError
;
549 attr
->attr
.name
= "dev";
550 attr
->attr
.mode
= S_IRUGO
;
552 attr
->attr
.owner
= dev
->driver
->owner
;
553 attr
->show
= show_dev
;
554 error
= device_create_file(dev
, attr
);
557 goto ueventattrError
;
560 dev
->devt_attr
= attr
;
564 sysfs_create_link(&dev
->kobj
, &dev
->class->subsys
.kset
.kobj
,
566 /* If this is not a "fake" compatible device, then create the
567 * symlink from the class to the device. */
568 if (dev
->kobj
.parent
!= &dev
->class->subsys
.kset
.kobj
)
569 sysfs_create_link(&dev
->class->subsys
.kset
.kobj
,
570 &dev
->kobj
, dev
->bus_id
);
571 #ifdef CONFIG_SYSFS_DEPRECATED
573 sysfs_create_link(&dev
->kobj
, &dev
->parent
->kobj
,
575 class_name
= make_class_name(dev
->class->name
,
578 sysfs_create_link(&dev
->parent
->kobj
,
579 &dev
->kobj
, class_name
);
584 if ((error
= device_add_attrs(dev
)))
586 if ((error
= device_add_groups(dev
)))
588 if ((error
= device_pm_add(dev
)))
590 if ((error
= bus_add_device(dev
)))
592 kobject_uevent(&dev
->kobj
, KOBJ_ADD
);
593 if ((error
= bus_attach_device(dev
)))
596 klist_add_tail(&dev
->knode_parent
, &parent
->klist_children
);
599 down(&dev
->class->sem
);
600 /* tie the class to the device */
601 list_add_tail(&dev
->node
, &dev
->class->devices
);
603 /* notify any interfaces that the device is here */
604 list_for_each_entry(class_intf
, &dev
->class->interfaces
, node
)
605 if (class_intf
->add_dev
)
606 class_intf
->add_dev(dev
, class_intf
);
607 up(&dev
->class->sem
);
614 bus_remove_device(dev
);
616 device_pm_remove(dev
);
619 blocking_notifier_call_chain(&dev
->bus
->bus_notifier
,
620 BUS_NOTIFY_DEL_DEVICE
, dev
);
621 device_remove_groups(dev
);
623 device_remove_attrs(dev
);
625 if (dev
->devt_attr
) {
626 device_remove_file(dev
, dev
->devt_attr
);
627 kfree(dev
->devt_attr
);
630 device_remove_file(dev
, &dev
->uevent_attr
);
632 kobject_uevent(&dev
->kobj
, KOBJ_REMOVE
);
633 kobject_del(&dev
->kobj
);
642 * device_register - register a device with the system.
643 * @dev: pointer to the device structure
645 * This happens in two clean steps - initialize the device
646 * and add it to the system. The two steps can be called
647 * separately, but this is the easiest and most common.
648 * I.e. you should only call the two helpers separately if
649 * have a clearly defined need to use and refcount the device
650 * before it is added to the hierarchy.
653 int device_register(struct device
*dev
)
655 device_initialize(dev
);
656 return device_add(dev
);
661 * get_device - increment reference count for device.
664 * This simply forwards the call to kobject_get(), though
665 * we do take care to provide for the case that we get a NULL
669 struct device
* get_device(struct device
* dev
)
671 return dev
? to_dev(kobject_get(&dev
->kobj
)) : NULL
;
676 * put_device - decrement reference count.
677 * @dev: device in question.
679 void put_device(struct device
* dev
)
682 kobject_put(&dev
->kobj
);
687 * device_del - delete device from system.
690 * This is the first part of the device unregistration
691 * sequence. This removes the device from the lists we control
692 * from here, has it removed from the other driver model
693 * subsystems it was added to in device_add(), and removes it
694 * from the kobject hierarchy.
696 * NOTE: this should be called manually _iff_ device_add() was
697 * also called manually.
700 void device_del(struct device
* dev
)
702 struct device
* parent
= dev
->parent
;
703 struct class_interface
*class_intf
;
706 klist_del(&dev
->knode_parent
);
707 if (dev
->devt_attr
) {
708 device_remove_file(dev
, dev
->devt_attr
);
709 kfree(dev
->devt_attr
);
712 sysfs_remove_link(&dev
->kobj
, "subsystem");
713 /* If this is not a "fake" compatible device, remove the
714 * symlink from the class to the device. */
715 if (dev
->kobj
.parent
!= &dev
->class->subsys
.kset
.kobj
)
716 sysfs_remove_link(&dev
->class->subsys
.kset
.kobj
,
718 #ifdef CONFIG_SYSFS_DEPRECATED
720 char *class_name
= make_class_name(dev
->class->name
,
723 sysfs_remove_link(&dev
->parent
->kobj
,
726 sysfs_remove_link(&dev
->kobj
, "device");
730 down(&dev
->class->sem
);
731 /* notify any interfaces that the device is now gone */
732 list_for_each_entry(class_intf
, &dev
->class->interfaces
, node
)
733 if (class_intf
->remove_dev
)
734 class_intf
->remove_dev(dev
, class_intf
);
735 /* remove the device from the class list */
736 list_del_init(&dev
->node
);
737 up(&dev
->class->sem
);
739 device_remove_file(dev
, &dev
->uevent_attr
);
740 device_remove_groups(dev
);
741 device_remove_attrs(dev
);
742 bus_remove_device(dev
);
744 /* Notify the platform of the removal, in case they
745 * need to do anything...
747 if (platform_notify_remove
)
748 platform_notify_remove(dev
);
750 blocking_notifier_call_chain(&dev
->bus
->bus_notifier
,
751 BUS_NOTIFY_DEL_DEVICE
, dev
);
752 device_pm_remove(dev
);
753 kobject_uevent(&dev
->kobj
, KOBJ_REMOVE
);
754 kobject_del(&dev
->kobj
);
760 * device_unregister - unregister device from system.
761 * @dev: device going away.
763 * We do this in two parts, like we do device_register(). First,
764 * we remove it from all the subsystems with device_del(), then
765 * we decrement the reference count via put_device(). If that
766 * is the final reference count, the device will be cleaned up
767 * via device_release() above. Otherwise, the structure will
768 * stick around until the final reference to the device is dropped.
770 void device_unregister(struct device
* dev
)
772 pr_debug("DEV: Unregistering device. ID = '%s'\n", dev
->bus_id
);
778 static struct device
* next_device(struct klist_iter
* i
)
780 struct klist_node
* n
= klist_next(i
);
781 return n
? container_of(n
, struct device
, knode_parent
) : NULL
;
785 * device_for_each_child - device child iterator.
786 * @parent: parent struct device.
787 * @data: data for the callback.
788 * @fn: function to be called for each device.
790 * Iterate over @parent's child devices, and call @fn for each,
793 * We check the return of @fn each time. If it returns anything
794 * other than 0, we break out and return that value.
796 int device_for_each_child(struct device
* parent
, void * data
,
797 int (*fn
)(struct device
*, void *))
800 struct device
* child
;
803 klist_iter_init(&parent
->klist_children
, &i
);
804 while ((child
= next_device(&i
)) && !error
)
805 error
= fn(child
, data
);
811 * device_find_child - device iterator for locating a particular device.
812 * @parent: parent struct device
813 * @data: Data to pass to match function
814 * @match: Callback function to check device
816 * This is similar to the device_for_each_child() function above, but it
817 * returns a reference to a device that is 'found' for later use, as
818 * determined by the @match callback.
820 * The callback should return 0 if the device doesn't match and non-zero
821 * if it does. If the callback returns non-zero and a reference to the
822 * current device can be obtained, this function will return to the caller
823 * and not iterate over any more devices.
825 struct device
* device_find_child(struct device
*parent
, void *data
,
826 int (*match
)(struct device
*, void *))
829 struct device
*child
;
834 klist_iter_init(&parent
->klist_children
, &i
);
835 while ((child
= next_device(&i
)))
836 if (match(child
, data
) && get_device(child
))
842 int __init
devices_init(void)
844 return subsystem_register(&devices_subsys
);
847 EXPORT_SYMBOL_GPL(device_for_each_child
);
848 EXPORT_SYMBOL_GPL(device_find_child
);
850 EXPORT_SYMBOL_GPL(device_initialize
);
851 EXPORT_SYMBOL_GPL(device_add
);
852 EXPORT_SYMBOL_GPL(device_register
);
854 EXPORT_SYMBOL_GPL(device_del
);
855 EXPORT_SYMBOL_GPL(device_unregister
);
856 EXPORT_SYMBOL_GPL(get_device
);
857 EXPORT_SYMBOL_GPL(put_device
);
859 EXPORT_SYMBOL_GPL(device_create_file
);
860 EXPORT_SYMBOL_GPL(device_remove_file
);
863 static void device_create_release(struct device
*dev
)
865 pr_debug("%s called for %s\n", __FUNCTION__
, dev
->bus_id
);
870 * device_create - creates a device and registers it with sysfs
871 * @class: pointer to the struct class that this device should be registered to
872 * @parent: pointer to the parent struct device of this new device, if any
873 * @devt: the dev_t for the char device to be added
874 * @fmt: string for the device's name
876 * This function can be used by char device classes. A struct device
877 * will be created in sysfs, registered to the specified class.
879 * A "dev" file will be created, showing the dev_t for the device, if
880 * the dev_t is not 0,0.
881 * If a pointer to a parent struct device is passed in, the newly created
882 * struct device will be a child of that device in sysfs.
883 * The pointer to the struct device will be returned from the call.
884 * Any further sysfs files that might be required can be created using this
887 * Note: the struct class passed to this function must have previously
888 * been created with a call to class_create().
890 struct device
*device_create(struct class *class, struct device
*parent
,
891 dev_t devt
, const char *fmt
, ...)
894 struct device
*dev
= NULL
;
895 int retval
= -ENODEV
;
897 if (class == NULL
|| IS_ERR(class))
900 dev
= kzalloc(sizeof(*dev
), GFP_KERNEL
);
908 dev
->parent
= parent
;
909 dev
->release
= device_create_release
;
912 vsnprintf(dev
->bus_id
, BUS_ID_SIZE
, fmt
, args
);
914 retval
= device_register(dev
);
922 return ERR_PTR(retval
);
924 EXPORT_SYMBOL_GPL(device_create
);
927 * device_destroy - removes a device that was created with device_create()
928 * @class: pointer to the struct class that this device was registered with
929 * @devt: the dev_t of the device that was previously registered
931 * This call unregisters and cleans up a device that was created with a
932 * call to device_create().
934 void device_destroy(struct class *class, dev_t devt
)
936 struct device
*dev
= NULL
;
937 struct device
*dev_tmp
;
940 list_for_each_entry(dev_tmp
, &class->devices
, node
) {
941 if (dev_tmp
->devt
== devt
) {
949 device_unregister(dev
);
951 EXPORT_SYMBOL_GPL(device_destroy
);
954 * device_rename - renames a device
955 * @dev: the pointer to the struct device to be renamed
956 * @new_name: the new name of the device
958 int device_rename(struct device
*dev
, char *new_name
)
960 char *old_class_name
= NULL
;
961 char *new_class_name
= NULL
;
962 char *old_symlink_name
= NULL
;
965 dev
= get_device(dev
);
969 pr_debug("DEVICE: renaming '%s' to '%s'\n", dev
->bus_id
, new_name
);
971 #ifdef CONFIG_SYSFS_DEPRECATED
972 if ((dev
->class) && (dev
->parent
))
973 old_class_name
= make_class_name(dev
->class->name
, &dev
->kobj
);
977 old_symlink_name
= kmalloc(BUS_ID_SIZE
, GFP_KERNEL
);
978 if (!old_symlink_name
) {
980 goto out_free_old_class
;
982 strlcpy(old_symlink_name
, dev
->bus_id
, BUS_ID_SIZE
);
985 strlcpy(dev
->bus_id
, new_name
, BUS_ID_SIZE
);
987 error
= kobject_rename(&dev
->kobj
, new_name
);
989 #ifdef CONFIG_SYSFS_DEPRECATED
990 if (old_class_name
) {
991 new_class_name
= make_class_name(dev
->class->name
, &dev
->kobj
);
992 if (new_class_name
) {
993 sysfs_create_link(&dev
->parent
->kobj
, &dev
->kobj
,
995 sysfs_remove_link(&dev
->parent
->kobj
, old_class_name
);
1001 sysfs_remove_link(&dev
->class->subsys
.kset
.kobj
,
1003 sysfs_create_link(&dev
->class->subsys
.kset
.kobj
, &dev
->kobj
,
1008 kfree(new_class_name
);
1009 kfree(old_symlink_name
);
1011 kfree(old_class_name
);
1017 static int device_move_class_links(struct device
*dev
,
1018 struct device
*old_parent
,
1019 struct device
*new_parent
)
1021 #ifdef CONFIG_SYSFS_DEPRECATED
1025 class_name
= make_class_name(dev
->class->name
, &dev
->kobj
);
1031 sysfs_remove_link(&dev
->kobj
, "device");
1032 sysfs_remove_link(&old_parent
->kobj
, class_name
);
1035 error
= sysfs_create_link(&dev
->kobj
, &new_parent
->kobj
,
1039 error
= sysfs_create_link(&new_parent
->kobj
, &dev
->kobj
,
1042 sysfs_remove_link(&dev
->kobj
, "device");
1055 * device_move - moves a device to a new parent
1056 * @dev: the pointer to the struct device to be moved
1057 * @new_parent: the new parent of the device (can by NULL)
1059 int device_move(struct device
*dev
, struct device
*new_parent
)
1062 struct device
*old_parent
;
1063 struct kobject
*new_parent_kobj
;
1065 dev
= get_device(dev
);
1069 new_parent
= get_device(new_parent
);
1070 new_parent_kobj
= get_device_parent (dev
, new_parent
);
1071 if (IS_ERR(new_parent_kobj
)) {
1072 error
= PTR_ERR(new_parent_kobj
);
1073 put_device(new_parent
);
1076 pr_debug("DEVICE: moving '%s' to '%s'\n", dev
->bus_id
,
1077 new_parent
? new_parent
->bus_id
: "<NULL>");
1078 error
= kobject_move(&dev
->kobj
, new_parent_kobj
);
1080 put_device(new_parent
);
1083 old_parent
= dev
->parent
;
1084 dev
->parent
= new_parent
;
1086 klist_remove(&dev
->knode_parent
);
1088 klist_add_tail(&dev
->knode_parent
, &new_parent
->klist_children
);
1091 error
= device_move_class_links(dev
, old_parent
, new_parent
);
1093 /* We ignore errors on cleanup since we're hosed anyway... */
1094 device_move_class_links(dev
, new_parent
, old_parent
);
1095 if (!kobject_move(&dev
->kobj
, &old_parent
->kobj
)) {
1097 klist_remove(&dev
->knode_parent
);
1099 klist_add_tail(&dev
->knode_parent
,
1100 &old_parent
->klist_children
);
1102 put_device(new_parent
);
1106 put_device(old_parent
);
1112 EXPORT_SYMBOL_GPL(device_move
);