suse man page for sysfs_schedule_callback

SYSFS_SCHEDULE_CALLB(9) 				  The Filesystem for Exporting K				   SYSFS_SCHEDULE_CALLB(9)

NAME
       sysfs_schedule_callback - helper to schedule a callback for a kobject

SYNOPSIS
       int sysfs_schedule_callback(struct kobject * kobj, void (*func) (void *), void * data, struct module * owner);

ARGUMENTS
       kobj
	   object we're acting for.

       func
	   callback function to invoke later.

       data
	   argument to pass to func.

       owner
	   module owning the callback code

DESCRIPTION
       sysfs attribute methods must not unregister themselves or their parent kobject (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 data as its
       argument in the workqueue's process context.  kobj will be pinned until func returns.

       Returns 0 if the request was submitted, -ENOMEM if storage could not be allocated, -ENODEV if a reference to owner isn't available, -EAGAIN
       if a callback has already been scheduled for kobj.

COPYRIGHT
Kernel Hackers Manual 2.6.					     July 2010						   SYSFS_SCHEDULE_CALLB(9)