class.c 9.6 KB
Newer Older
L
Linus Torvalds 已提交
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17
/*
 * class.c - basic device class management
 *
 * Copyright (c) 2002-3 Patrick Mochel
 * Copyright (c) 2002-3 Open Source Development Labs
 * Copyright (c) 2003-2004 Greg Kroah-Hartman
 * Copyright (c) 2003-2004 IBM Corp.
 *
 * This file is released under the GPLv2
 *
 */

#include <linux/device.h>
#include <linux/module.h>
#include <linux/init.h>
#include <linux/string.h>
#include <linux/kdev_t.h>
18
#include <linux/err.h>
T
Tim Schmielau 已提交
19
#include <linux/slab.h>
20
#include <linux/genhd.h>
L
Linus Torvalds 已提交
21 22 23 24
#include "base.h"

#define to_class_attr(_attr) container_of(_attr, struct class_attribute, attr)

25 26
static ssize_t class_attr_show(struct kobject *kobj, struct attribute *attr,
			       char *buf)
L
Linus Torvalds 已提交
27
{
28
	struct class_attribute *class_attr = to_class_attr(attr);
29
	struct class_private *cp = to_class(kobj);
30
	ssize_t ret = -EIO;
L
Linus Torvalds 已提交
31 32

	if (class_attr->show)
33
		ret = class_attr->show(cp->class, buf);
L
Linus Torvalds 已提交
34 35 36
	return ret;
}

37 38
static ssize_t class_attr_store(struct kobject *kobj, struct attribute *attr,
				const char *buf, size_t count)
L
Linus Torvalds 已提交
39
{
40
	struct class_attribute *class_attr = to_class_attr(attr);
41
	struct class_private *cp = to_class(kobj);
42
	ssize_t ret = -EIO;
L
Linus Torvalds 已提交
43 44

	if (class_attr->store)
45
		ret = class_attr->store(cp->class, buf, count);
L
Linus Torvalds 已提交
46 47 48
	return ret;
}

49
static void class_release(struct kobject *kobj)
L
Linus Torvalds 已提交
50
{
51 52
	struct class_private *cp = to_class(kobj);
	struct class *class = cp->class;
L
Linus Torvalds 已提交
53 54 55 56 57 58 59 60 61 62 63 64 65 66 67

	pr_debug("class '%s': release.\n", class->name);

	if (class->class_release)
		class->class_release(class);
	else
		pr_debug("class '%s' does not have a release() function, "
			 "be careful\n", class->name);
}

static struct sysfs_ops class_sysfs_ops = {
	.show	= class_attr_show,
	.store	= class_attr_store,
};

68
static struct kobj_type class_ktype = {
L
Linus Torvalds 已提交
69 70 71 72 73
	.sysfs_ops	= &class_sysfs_ops,
	.release	= class_release,
};

/* Hotplug events for classes go to the class_obj subsys */
74
static struct kset *class_kset;
L
Linus Torvalds 已提交
75 76


77
int class_create_file(struct class *cls, const struct class_attribute *attr)
L
Linus Torvalds 已提交
78 79
{
	int error;
80
	if (cls)
81
		error = sysfs_create_file(&cls->p->subsys.kobj, &attr->attr);
82
	else
L
Linus Torvalds 已提交
83 84 85 86
		error = -EINVAL;
	return error;
}

87
void class_remove_file(struct class *cls, const struct class_attribute *attr)
L
Linus Torvalds 已提交
88 89
{
	if (cls)
90
		sysfs_remove_file(&cls->p->subsys.kobj, &attr->attr);
L
Linus Torvalds 已提交
91 92
}

93
static struct class *class_get(struct class *cls)
L
Linus Torvalds 已提交
94 95
{
	if (cls)
96 97
		kset_get(&cls->p->subsys);
	return cls;
L
Linus Torvalds 已提交
98 99
}

100
static void class_put(struct class *cls)
L
Linus Torvalds 已提交
101
{
102
	if (cls)
103
		kset_put(&cls->p->subsys);
L
Linus Torvalds 已提交
104 105
}

106
static int add_class_attrs(struct class *cls)
L
Linus Torvalds 已提交
107 108 109 110 111 112
{
	int i;
	int error = 0;

	if (cls->class_attrs) {
		for (i = 0; attr_name(cls->class_attrs[i]); i++) {
113
			error = class_create_file(cls, &cls->class_attrs[i]);
L
Linus Torvalds 已提交
114
			if (error)
115
				goto error;
L
Linus Torvalds 已提交
116 117
		}
	}
118
done:
L
Linus Torvalds 已提交
119
	return error;
120
error:
L
Linus Torvalds 已提交
121
	while (--i >= 0)
122 123
		class_remove_file(cls, &cls->class_attrs[i]);
	goto done;
L
Linus Torvalds 已提交
124 125
}

126
static void remove_class_attrs(struct class *cls)
L
Linus Torvalds 已提交
127 128 129 130 131
{
	int i;

	if (cls->class_attrs) {
		for (i = 0; attr_name(cls->class_attrs[i]); i++)
132
			class_remove_file(cls, &cls->class_attrs[i]);
L
Linus Torvalds 已提交
133 134 135
	}
}

136
int class_register(struct class *cls)
L
Linus Torvalds 已提交
137
{
138
	struct class_private *cp;
L
Linus Torvalds 已提交
139 140 141 142
	int error;

	pr_debug("device class '%s': registering\n", cls->name);

143 144 145 146 147 148 149 150 151 152
	cp = kzalloc(sizeof(*cp), GFP_KERNEL);
	if (!cp)
		return -ENOMEM;
	INIT_LIST_HEAD(&cp->devices);
	INIT_LIST_HEAD(&cp->interfaces);
	kset_init(&cp->class_dirs);
	init_MUTEX(&cp->sem);
	error = kobject_set_name(&cp->subsys.kobj, "%s", cls->name);
	if (error) {
		kfree(cp);
L
Linus Torvalds 已提交
153
		return error;
154
	}
L
Linus Torvalds 已提交
155

156 157 158 159
	/* set the default /sys/dev directory for devices of this class */
	if (!cls->dev_kobj)
		cls->dev_kobj = sysfs_dev_char_kobj;

160
#if defined(CONFIG_SYSFS_DEPRECATED) && defined(CONFIG_BLOCK)
161 162
	/* let the block class directory show up in the root of sysfs */
	if (cls != &block_class)
163
		cp->subsys.kobj.kset = class_kset;
164
#else
165
	cp->subsys.kobj.kset = class_kset;
166
#endif
167 168 169
	cp->subsys.kobj.ktype = &class_ktype;
	cp->class = cls;
	cls->p = cp;
L
Linus Torvalds 已提交
170

171 172 173 174
	error = kset_register(&cp->subsys);
	if (error) {
		kfree(cp);
		return error;
L
Linus Torvalds 已提交
175
	}
176 177
	error = add_class_attrs(class_get(cls));
	class_put(cls);
L
Linus Torvalds 已提交
178 179 180
	return error;
}

181
void class_unregister(struct class *cls)
L
Linus Torvalds 已提交
182 183 184
{
	pr_debug("device class '%s': unregistering\n", cls->name);
	remove_class_attrs(cls);
185
	kset_unregister(&cls->p->subsys);
L
Linus Torvalds 已提交
186 187
}

188 189
static void class_create_release(struct class *cls)
{
190
	pr_debug("%s called for %s\n", __func__, cls->name);
191 192 193
	kfree(cls);
}

194 195 196 197 198 199
/**
 * class_create - create a struct class structure
 * @owner: pointer to the module that is to "own" this struct class
 * @name: pointer to a string for the name of this class.
 *
 * This is used to create a struct class pointer that can then be used
200
 * in calls to device_create().
201 202 203 204
 *
 * Note, the pointer created here is to be destroyed when finished by
 * making a call to class_destroy().
 */
205
struct class *class_create(struct module *owner, const char *name)
206 207 208 209
{
	struct class *cls;
	int retval;

210
	cls = kzalloc(sizeof(*cls), GFP_KERNEL);
211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230
	if (!cls) {
		retval = -ENOMEM;
		goto error;
	}

	cls->name = name;
	cls->owner = owner;
	cls->class_release = class_create_release;

	retval = class_register(cls);
	if (retval)
		goto error;

	return cls;

error:
	kfree(cls);
	return ERR_PTR(retval);
}

231 232
/**
 * class_destroy - destroys a struct class structure
233
 * @cls: pointer to the struct class that is to be destroyed
234 235 236 237
 *
 * Note, the pointer to be destroyed must have been created with a call
 * to class_create().
 */
238 239 240 241 242 243 244
void class_destroy(struct class *cls)
{
	if ((cls == NULL) || (IS_ERR(cls)))
		return;

	class_unregister(cls);
}
L
Linus Torvalds 已提交
245

246 247 248 249 250 251 252 253 254 255
#ifdef CONFIG_SYSFS_DEPRECATED
char *make_class_name(const char *name, struct kobject *kobj)
{
	char *class_name;
	int size;

	size = strlen(name) + strlen(kobject_name(kobj)) + 2;

	class_name = kmalloc(size, GFP_KERNEL);
	if (!class_name)
256
		return NULL;
257 258 259 260 261 262 263 264

	strcpy(class_name, name);
	strcat(class_name, ":");
	strcat(class_name, kobject_name(kobj));
	return class_name;
}
#endif

265 266 267
/**
 * class_for_each_device - device iterator
 * @class: the class we're iterating
268
 * @start: the device to start with in the list, if any.
269 270 271 272
 * @data: data for the callback
 * @fn: function to be called for each device
 *
 * Iterate over @class's list of devices, and call @fn for each,
273 274 275
 * passing it @data.  If @start is set, the list iteration will start
 * there, otherwise if it is NULL, the iteration starts at the
 * beginning of the list.
276 277 278 279 280 281 282 283
 *
 * We check the return of @fn each time. If it returns anything
 * other than 0, we break out and return that value.
 *
 * Note, we hold class->sem in this function, so it can not be
 * re-acquired in @fn, otherwise it will self-deadlocking. For
 * example, calls to add or remove class members would be verboten.
 */
284 285
int class_for_each_device(struct class *class, struct device *start,
			  void *data, int (*fn)(struct device *, void *))
286 287 288 289 290 291
{
	struct device *dev;
	int error = 0;

	if (!class)
		return -EINVAL;
292 293
	down(&class->p->sem);
	list_for_each_entry(dev, &class->p->devices, node) {
294 295 296 297 298
		if (start) {
			if (start == dev)
				start = NULL;
			continue;
		}
299
		dev = get_device(dev);
300 301
		error = fn(dev, data);
		put_device(dev);
302 303 304
		if (error)
			break;
	}
305
	up(&class->p->sem);
306 307 308 309 310 311 312 313

	return error;
}
EXPORT_SYMBOL_GPL(class_for_each_device);

/**
 * class_find_device - device iterator for locating a particular device
 * @class: the class we're iterating
314
 * @start: Device to begin with
315 316 317 318 319 320 321 322 323 324
 * @data: data for the match function
 * @match: function to check device
 *
 * This is similar to the class_for_each_dev() function above, but it
 * returns a reference to a device that is 'found' for later use, as
 * determined by the @match callback.
 *
 * The callback should return 0 if the device doesn't match and non-zero
 * if it does.  If the callback returns non-zero, this function will
 * return to the caller and not iterate over any more devices.
325
 *
326 327 328 329 330 331
 * Note, you will need to drop the reference with put_device() after use.
 *
 * We hold class->sem in this function, so it can not be
 * re-acquired in @match, otherwise it will self-deadlocking. For
 * example, calls to add or remove class members would be verboten.
 */
332 333 334
struct device *class_find_device(struct class *class, struct device *start,
				 void *data,
				 int (*match)(struct device *, void *))
335 336 337 338 339 340 341
{
	struct device *dev;
	int found = 0;

	if (!class)
		return NULL;

342 343
	down(&class->p->sem);
	list_for_each_entry(dev, &class->p->devices, node) {
344 345 346 347 348
		if (start) {
			if (start == dev)
				start = NULL;
			continue;
		}
349
		dev = get_device(dev);
350 351
		if (match(dev, data)) {
			found = 1;
352
			break;
353 354
		} else
			put_device(dev);
355
	}
356
	up(&class->p->sem);
357 358 359 360 361

	return found ? dev : NULL;
}
EXPORT_SYMBOL_GPL(class_find_device);

L
Linus Torvalds 已提交
362 363 364
int class_interface_register(struct class_interface *class_intf)
{
	struct class *parent;
365
	struct device *dev;
L
Linus Torvalds 已提交
366 367 368 369 370 371 372 373

	if (!class_intf || !class_intf->class)
		return -ENODEV;

	parent = class_get(class_intf->class);
	if (!parent)
		return -EINVAL;

374 375
	down(&parent->p->sem);
	list_add_tail(&class_intf->node, &parent->p->interfaces);
376
	if (class_intf->add_dev) {
377
		list_for_each_entry(dev, &parent->p->devices, node)
378 379
			class_intf->add_dev(dev, class_intf);
	}
380
	up(&parent->p->sem);
L
Linus Torvalds 已提交
381 382 383 384 385 386

	return 0;
}

void class_interface_unregister(struct class_interface *class_intf)
{
387
	struct class *parent = class_intf->class;
388
	struct device *dev;
L
Linus Torvalds 已提交
389 390 391 392

	if (!parent)
		return;

393
	down(&parent->p->sem);
L
Linus Torvalds 已提交
394
	list_del_init(&class_intf->node);
395
	if (class_intf->remove_dev) {
396
		list_for_each_entry(dev, &parent->p->devices, node)
397 398
			class_intf->remove_dev(dev, class_intf);
	}
399
	up(&parent->p->sem);
L
Linus Torvalds 已提交
400 401 402 403 404 405

	class_put(parent);
}

int __init classes_init(void)
{
406 407 408
	class_kset = kset_create_and_add("class", NULL, NULL);
	if (!class_kset)
		return -ENOMEM;
L
Linus Torvalds 已提交
409 410 411 412 413 414 415
	return 0;
}

EXPORT_SYMBOL_GPL(class_create_file);
EXPORT_SYMBOL_GPL(class_remove_file);
EXPORT_SYMBOL_GPL(class_register);
EXPORT_SYMBOL_GPL(class_unregister);
416 417
EXPORT_SYMBOL_GPL(class_create);
EXPORT_SYMBOL_GPL(class_destroy);
L
Linus Torvalds 已提交
418 419 420

EXPORT_SYMBOL_GPL(class_interface_register);
EXPORT_SYMBOL_GPL(class_interface_unregister);