device_schedule_callback_owner(9) [suse man page]

DEVICE_SCHEDULE_CALL(9) 				   Device drivers infrastructure				   DEVICE_SCHEDULE_CALL(9)

NAME

       device_schedule_callback_owner - helper to schedule a callback for a device

SYNOPSIS

       int device_schedule_callback_owner(struct device * dev, void (*func) (struct device *), struct module * owner);

ARGUMENTS

       dev
	   device.

       func
	   callback function to invoke later.

       owner
	   module owning the callback routine

DESCRIPTION

       Attribute methods must not unregister themselves or their parent device (which would amount to the same thing). Attempts to do so will
       deadlock, since unregistration is mutually exclusive with driver callbacks.

       Instead methods can call this routine, which will attempt to allocate and schedule a workqueue request to call back func with dev as its
       argument in the workqueue's process context.  dev will be pinned until func returns.

       This routine is usually called via the inline device_schedule_callback, which automatically sets owner to THIS_MODULE.

       Returns 0 if the request was submitted, -ENOMEM if storage could not be allocated, -ENODEV if a reference to owner isn't available.

NOTE

       This routine won't work if CONFIG_SYSFS isn't set! It uses an underlying sysfs routine (since it is intended for use by attribute methods),
       and if sysfs isn't available you'll get nothing but -ENOSYS.

COPYRIGHT

Kernel Hackers Manual 2.6.					     July 2010						   DEVICE_SCHEDULE_CALL(9)

DEVICE_CREATE(9)					   Device drivers infrastructure					  DEVICE_CREATE(9)

NAME

       device_create - creates a device and registers it with sysfs

SYNOPSIS

       struct device * device_create(struct class * class, struct device * parent, dev_t devt, void * drvdata, const char * fmt, ...);

ARGUMENTS

       class
	   pointer to the struct class that this device should be registered to

       parent
	   pointer to the parent struct device of this new device, if any

       devt
	   the dev_t for the char device to be added

       drvdata
	   the data to be added to the device for callbacks

       fmt
	   string for the device's name

       ...
	   variable arguments

DESCRIPTION

       This function can be used by char device classes. A struct device will be created in sysfs, registered to the specified class.

       A "dev" file will be created, showing the dev_t for the device, if the dev_t is not 0,0. If a pointer to a parent struct device is passed
       in, the newly created struct device will be a child of that device in sysfs. The pointer to the struct device will be returned from the
       call. Any further sysfs files that might be required can be created using this pointer.

       Returns struct device pointer on success, or ERR_PTR on error.

NOTE

       the struct class passed to this function must have previously been created with a call to class_create.

COPYRIGHT

Kernel Hackers Manual 3.10					     June 2014							  DEVICE_CREATE(9)