On Thu, 10 Jan 2008 17:48:43 +0800, Dave Young <hidave.darkstar@xxxxxxxxx> wrote: Please add a kerneldoc comment for each of the new interfaces. > +int class_for_each_device(struct class *class, void *data, > + int (*fn)(struct device *, void *)) > +{ > + struct device *dev; > + int error = 0; > + > + if (!class) > + return -EINVAL; > + mutex_lock(&class->mutex); > + list_for_each_entry(dev, &class->devices, node) { > + error = fn(dev, data); Hm, the equivalent _for_each_device() functions all elevate the device's refcount while calling fn(). I wonder whether we want this here as well? > + if (error) > + break; > + } > + mutex_unlock(&class->mutex); > + > + return error; > +} > +EXPORT_SYMBOL_GPL(class_for_each_device); > + > +struct device *class_find_device(struct class *class, void *data, > + int (*match)(struct device *, void *)) > +{ > + struct device *dev; > + > + if (!class) > + return NULL; > + > + mutex_lock(&class->mutex); > + list_for_each_entry(dev, &class->devices, node) > + if (match(dev, data) && get_device(dev)) First get the reference and then drop it if the match function returns 0 to make this analogous to the other _find_device() functions? > + break; > + mutex_unlock(&class->mutex); > + > + return dev; > +} > +EXPORT_SYMBOL_GPL(class_find_device); > + > +int class_for_each_child(struct class *class, void *data, > + int (*fn)(struct class_device *, void *)) Haven't looked at the callers, but isn't it better to convert them to use struct device instead so we don't need to introduce new class_device api? > +{ > + struct class_device *dev; > + int error = 0; > + > + if (!class) > + return -EINVAL; > + mutex_lock(&class->mutex); > + list_for_each_entry(dev, &class->children, node) { > + error = fn(dev, data); Same comment as above concerning reference counts. > + if (error) > + break; > + } > + mutex_unlock(&class->mutex); > + > + return error; > +} > +EXPORT_SYMBOL_GPL(class_for_each_child); > + > +struct class_device *class_find_child(struct class *class, void *data, > + int (*match)(struct class_device *, void *)) > +{ > + struct class_device *dev; > + > + if (!class) > + return NULL; > + > + mutex_lock(&class->mutex); > + list_for_each_entry(dev, &class->children, node) > + if (match(dev, data) && class_device_get(dev)) And here. > + break; > + mutex_unlock(&class->mutex); > + > + return dev; > +} > +EXPORT_SYMBOL_GPL(class_find_child); > + - To unsubscribe from this list: send the line "unsubscribe linux-scsi" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html