Changes between Version 23 and Version 24 of DeviceDrivers

Timestamp:

2011-11-16T17:17:49Z (12 years ago)

Author:

Jiri Svoboda

Comment:

ddf_fun_online, ddf_fun_offline

DeviceDrivers

@@ -205 +205 @@
 }}}
 
-Unbind function ''fun'' from the system. Makes the function ''fun'' unavailable to the system. Calling ''ddf_fun_unbind'' on an online function is interpreted as surprise removal. Calling ''ddf_fun_unbind'' on an offline function is interpreted as anticipated removal. ''ddf_fun_unbind'' returns EOK on success, negative error code on failure. ''ddf_fun_unbind'' can fail if a child driver ''dev_remove'' or ''dev_gone'' entry point fails.
+Unbind function ''fun'' from the system. Makes the function ''fun'' unavailable to the system. Calling ''ddf_fun_unbind'' on an online inner function is interpreted as surprise removal (''dev_gone'' will be called for the device under ''fun''). Calling ''ddf_fun_unbind'' on an offline function is interpreted as anticipated removal. ''ddf_fun_unbind'' returns EOK on success, negative error code on failure. ''ddf_fun_unbind'' can fail if a child driver ''dev_remove'' or ''dev_gone'' entry point fails.
 
 ==== ddf_fun_online ====
@@ -213 +213 @@
 }}}
 
+Bring function ''fun'' on line. This function is used from the ''fun_online'' entry point to online one or more functions. The DDF will set the state of the function to ''on line''. If the function is an exposed function, corresponding Location service entry is created. If the function is an inner function, DDF will attach descendant devices to the function. ''ddf_fun_online'' returns EOK on success or negative error code.
+
 ==== ddf_fun_offline ====
 
@@ -218 +220 @@
 int ddf_fun_offline(ddf_fun_t *fun)
 }}}
+
+Bring function ''fun'' off line. This function is used from the ''fun_offline'' entry point to offline one or more functions. The DDF will set the state of the function to ''off line''. If the function is an exposed function, corresponding Location service entry is deleted. If the function is an inner function, DDF will recursively remove the device sub-tree under ''fun''. ''ddf_fun_offline'' returns EOK on success or negative error code.
 
 == Soft State Management ==