2 * drivers/s390/cio/ccwgroup.c
3 * bus driver for ccwgroup
5 * Copyright (C) 2002 IBM Deutschland Entwicklung GmbH,
7 * Author(s): Arnd Bergmann (arndb@de.ibm.com)
8 * Cornelia Huck (cornelia.huck@de.ibm.com)
10 #include <linux/module.h>
11 #include <linux/errno.h>
12 #include <linux/slab.h>
13 #include <linux/list.h>
14 #include <linux/device.h>
15 #include <linux/init.h>
16 #include <linux/ctype.h>
17 #include <linux/dcache.h>
19 #include <asm/semaphore.h>
20 #include <asm/ccwdev.h>
21 #include <asm/ccwgroup.h>
23 /* In Linux 2.4, we had a channel device layer called "chandev"
24 * that did all sorts of obscure stuff for networking devices.
25 * This is another driver that serves as a replacement for just
26 * one of its functions, namely the translation of single subchannels
27 * to devices that use multiple subchannels.
30 /* a device matches a driver if all its slave devices match the same
31 * entry of the driver */
33 ccwgroup_bus_match (struct device * dev, struct device_driver * drv)
35 struct ccwgroup_device *gdev;
36 struct ccwgroup_driver *gdrv;
38 gdev = container_of(dev, struct ccwgroup_device, dev);
39 gdrv = container_of(drv, struct ccwgroup_driver, driver);
41 if (gdev->creator_id == gdrv->driver_id)
47 ccwgroup_uevent (struct device *dev, char **envp, int num_envp, char *buffer,
54 static struct bus_type ccwgroup_bus_type;
57 __ccwgroup_remove_symlinks(struct ccwgroup_device *gdev)
62 for (i = 0; i < gdev->count; i++) {
63 sprintf(str, "cdev%d", i);
64 sysfs_remove_link(&gdev->dev.kobj, str);
65 sysfs_remove_link(&gdev->cdev[i]->dev.kobj, "group_device");
71 * Provide an 'ungroup' attribute so the user can remove group devices no
72 * longer needed or accidentially created. Saves memory :)
74 static void ccwgroup_ungroup_callback(struct device *dev)
76 struct ccwgroup_device *gdev = to_ccwgroupdev(dev);
78 mutex_lock(&gdev->reg_mutex);
79 __ccwgroup_remove_symlinks(gdev);
80 device_unregister(dev);
81 mutex_unlock(&gdev->reg_mutex);
85 ccwgroup_ungroup_store(struct device *dev, struct device_attribute *attr, const char *buf, size_t count)
87 struct ccwgroup_device *gdev;
90 gdev = to_ccwgroupdev(dev);
92 if (gdev->state != CCWGROUP_OFFLINE)
95 /* Note that we cannot unregister the device from one of its
96 * attribute methods, so we have to use this roundabout approach.
98 rc = device_schedule_callback(dev, ccwgroup_ungroup_callback);
104 static DEVICE_ATTR(ungroup, 0200, NULL, ccwgroup_ungroup_store);
107 ccwgroup_release (struct device *dev)
109 struct ccwgroup_device *gdev;
112 gdev = to_ccwgroupdev(dev);
114 for (i = 0; i < gdev->count; i++) {
115 gdev->cdev[i]->dev.driver_data = NULL;
116 put_device(&gdev->cdev[i]->dev);
122 __ccwgroup_create_symlinks(struct ccwgroup_device *gdev)
127 for (i = 0; i < gdev->count; i++) {
128 rc = sysfs_create_link(&gdev->cdev[i]->dev.kobj, &gdev->dev.kobj,
131 for (--i; i >= 0; i--)
132 sysfs_remove_link(&gdev->cdev[i]->dev.kobj,
137 for (i = 0; i < gdev->count; i++) {
138 sprintf(str, "cdev%d", i);
139 rc = sysfs_create_link(&gdev->dev.kobj, &gdev->cdev[i]->dev.kobj,
142 for (--i; i >= 0; i--) {
143 sprintf(str, "cdev%d", i);
144 sysfs_remove_link(&gdev->dev.kobj, str);
146 for (i = 0; i < gdev->count; i++)
147 sysfs_remove_link(&gdev->cdev[i]->dev.kobj,
156 * try to add a new ccwgroup device for one driver
157 * argc and argv[] are a list of bus_id's of devices
158 * belonging to the driver.
161 ccwgroup_create(struct device *root,
162 unsigned int creator_id,
163 struct ccw_driver *cdrv,
164 int argc, char *argv[])
166 struct ccwgroup_device *gdev;
170 if (argc > 256) /* disallow dumb users */
173 gdev = kzalloc(sizeof(*gdev) + argc*sizeof(gdev->cdev[0]), GFP_KERNEL);
177 atomic_set(&gdev->onoff, 0);
178 mutex_init(&gdev->reg_mutex);
179 mutex_lock(&gdev->reg_mutex);
180 for (i = 0; i < argc; i++) {
181 gdev->cdev[i] = get_ccwdev_by_busid(cdrv, argv[i]);
183 /* all devices have to be of the same type in
184 * order to be grouped */
186 || gdev->cdev[i]->id.driver_info !=
187 gdev->cdev[0]->id.driver_info) {
191 /* Don't allow a device to belong to more than one group. */
192 if (gdev->cdev[i]->dev.driver_data) {
196 gdev->cdev[i]->dev.driver_data = gdev;
199 gdev->creator_id = creator_id;
201 gdev->dev.bus = &ccwgroup_bus_type;
202 gdev->dev.parent = root;
203 gdev->dev.release = ccwgroup_release;
205 snprintf (gdev->dev.bus_id, BUS_ID_SIZE, "%s",
206 gdev->cdev[0]->dev.bus_id);
208 rc = device_register(&gdev->dev);
211 get_device(&gdev->dev);
212 rc = device_create_file(&gdev->dev, &dev_attr_ungroup);
215 device_unregister(&gdev->dev);
219 rc = __ccwgroup_create_symlinks(gdev);
221 mutex_unlock(&gdev->reg_mutex);
222 put_device(&gdev->dev);
225 device_remove_file(&gdev->dev, &dev_attr_ungroup);
226 device_unregister(&gdev->dev);
228 for (i = 0; i < argc; i++)
230 if (gdev->cdev[i]->dev.driver_data == gdev)
231 gdev->cdev[i]->dev.driver_data = NULL;
232 put_device(&gdev->cdev[i]->dev);
234 mutex_unlock(&gdev->reg_mutex);
235 put_device(&gdev->dev);
242 return bus_register (&ccwgroup_bus_type);
246 cleanup_ccwgroup (void)
248 bus_unregister (&ccwgroup_bus_type);
251 module_init(init_ccwgroup);
252 module_exit(cleanup_ccwgroup);
254 /************************** driver stuff ******************************/
257 ccwgroup_set_online(struct ccwgroup_device *gdev)
259 struct ccwgroup_driver *gdrv;
262 if (atomic_cmpxchg(&gdev->onoff, 0, 1) != 0)
264 if (gdev->state == CCWGROUP_ONLINE) {
268 if (!gdev->dev.driver) {
272 gdrv = to_ccwgroupdrv (gdev->dev.driver);
273 if ((ret = gdrv->set_online ? gdrv->set_online(gdev) : 0))
276 gdev->state = CCWGROUP_ONLINE;
278 atomic_set(&gdev->onoff, 0);
283 ccwgroup_set_offline(struct ccwgroup_device *gdev)
285 struct ccwgroup_driver *gdrv;
288 if (atomic_cmpxchg(&gdev->onoff, 0, 1) != 0)
290 if (gdev->state == CCWGROUP_OFFLINE) {
294 if (!gdev->dev.driver) {
298 gdrv = to_ccwgroupdrv (gdev->dev.driver);
299 if ((ret = gdrv->set_offline ? gdrv->set_offline(gdev) : 0))
302 gdev->state = CCWGROUP_OFFLINE;
304 atomic_set(&gdev->onoff, 0);
309 ccwgroup_online_store (struct device *dev, struct device_attribute *attr, const char *buf, size_t count)
311 struct ccwgroup_device *gdev;
312 struct ccwgroup_driver *gdrv;
316 gdev = to_ccwgroupdev(dev);
320 gdrv = to_ccwgroupdrv (gdev->dev.driver);
321 if (!try_module_get(gdrv->owner))
324 value = simple_strtoul(buf, NULL, 0);
327 ccwgroup_set_online(gdev);
329 ccwgroup_set_offline(gdev);
332 module_put(gdrv->owner);
337 ccwgroup_online_show (struct device *dev, struct device_attribute *attr, char *buf)
341 online = (to_ccwgroupdev(dev)->state == CCWGROUP_ONLINE);
343 return sprintf(buf, online ? "1\n" : "0\n");
346 static DEVICE_ATTR(online, 0644, ccwgroup_online_show, ccwgroup_online_store);
349 ccwgroup_probe (struct device *dev)
351 struct ccwgroup_device *gdev;
352 struct ccwgroup_driver *gdrv;
356 gdev = to_ccwgroupdev(dev);
357 gdrv = to_ccwgroupdrv(dev->driver);
359 if ((ret = device_create_file(dev, &dev_attr_online)))
362 pr_debug("%s: device %s\n", __func__, gdev->dev.bus_id);
363 ret = gdrv->probe ? gdrv->probe(gdev) : -ENODEV;
365 device_remove_file(dev, &dev_attr_online);
371 ccwgroup_remove (struct device *dev)
373 struct ccwgroup_device *gdev;
374 struct ccwgroup_driver *gdrv;
376 gdev = to_ccwgroupdev(dev);
377 gdrv = to_ccwgroupdrv(dev->driver);
379 pr_debug("%s: device %s\n", __func__, gdev->dev.bus_id);
381 device_remove_file(dev, &dev_attr_online);
383 if (gdrv && gdrv->remove)
388 static struct bus_type ccwgroup_bus_type = {
390 .match = ccwgroup_bus_match,
391 .uevent = ccwgroup_uevent,
392 .probe = ccwgroup_probe,
393 .remove = ccwgroup_remove,
397 ccwgroup_driver_register (struct ccwgroup_driver *cdriver)
399 /* register our new driver with the core */
400 cdriver->driver.bus = &ccwgroup_bus_type;
401 cdriver->driver.name = cdriver->name;
403 return driver_register(&cdriver->driver);
407 __ccwgroup_match_all(struct device *dev, void *data)
413 ccwgroup_driver_unregister (struct ccwgroup_driver *cdriver)
417 /* We don't want ccwgroup devices to live longer than their driver. */
418 get_driver(&cdriver->driver);
419 while ((dev = driver_find_device(&cdriver->driver, NULL, NULL,
420 __ccwgroup_match_all))) {
421 struct ccwgroup_device *gdev = to_ccwgroupdev(dev);
423 mutex_lock(&gdev->reg_mutex);
424 __ccwgroup_remove_symlinks(gdev);
425 device_unregister(dev);
426 mutex_unlock(&gdev->reg_mutex);
429 put_driver(&cdriver->driver);
430 driver_unregister(&cdriver->driver);
434 ccwgroup_probe_ccwdev(struct ccw_device *cdev)
439 static struct ccwgroup_device *
440 __ccwgroup_get_gdev_by_cdev(struct ccw_device *cdev)
442 struct ccwgroup_device *gdev;
444 if (cdev->dev.driver_data) {
445 gdev = (struct ccwgroup_device *)cdev->dev.driver_data;
446 if (get_device(&gdev->dev)) {
447 mutex_lock(&gdev->reg_mutex);
448 if (device_is_registered(&gdev->dev))
450 mutex_unlock(&gdev->reg_mutex);
451 put_device(&gdev->dev);
459 ccwgroup_remove_ccwdev(struct ccw_device *cdev)
461 struct ccwgroup_device *gdev;
463 /* Ignore offlining errors, device is gone anyway. */
464 ccw_device_set_offline(cdev);
465 /* If one of its devices is gone, the whole group is done for. */
466 gdev = __ccwgroup_get_gdev_by_cdev(cdev);
468 __ccwgroup_remove_symlinks(gdev);
469 device_unregister(&gdev->dev);
470 mutex_unlock(&gdev->reg_mutex);
471 put_device(&gdev->dev);
475 MODULE_LICENSE("GPL");
476 EXPORT_SYMBOL(ccwgroup_driver_register);
477 EXPORT_SYMBOL(ccwgroup_driver_unregister);
478 EXPORT_SYMBOL(ccwgroup_create);
479 EXPORT_SYMBOL(ccwgroup_probe_ccwdev);
480 EXPORT_SYMBOL(ccwgroup_remove_ccwdev);