Changeset d347b53 in mainline for uspace/srv/devman/devman.h

Timestamp:

2010-03-21T19:33:58Z (14 years ago)

Author:

Lenka Trochtova <trochtova.lenka@…>

Branches:

lfn, master, serial, ticket/834-toolchain-update, topic/msim-upgrade, topic/simplify-dev-export

Children:

66babbd

Parents:

bda60d9

Message:

child device registration - parts of code

File:

• uspace/srv/devman/devman.h (modified) (6 diffs)

uspace/srv/devman/devman.h

@@ -141 +141 @@
 // Drivers
 
+/** 
+ * Initialize the list of device driver's.
+ * 
+ * @param drv_list the list of device driver's.
+ * 
+ */
 static inline void init_driver_list(driver_list_t *drv_list) 
 {
@@ -165 +171 @@
 void initialize_running_driver(driver_t *driver);
 
-
+/** 
+ * Initialize device driver structure.
+ * 
+ * @param drv the device driver structure.
+ * 
+ */
 static inline void init_driver(driver_t *drv)
 {
@@ -176 +187 @@
 }
 
+/**
+ * Device driver structure clean-up.
+ * 
+ * @param drv the device driver structure. 
+ */
 static inline void clean_driver(driver_t *drv)
 {
@@ -188 +204 @@
 }
 
+/**
+ * Delete device driver structure.
+ * 
+ *  @param drv the device driver structure.* 
+ */
 static inline void delete_driver(driver_t *drv)
 {
@@ -197 +218 @@
 
 // Device nodes
-
+/**
+ * Create a new device node.
+ * 
+ * @return a device node structure.
+ * 
+ */
 static inline node_t * create_dev_node()
 {
@@ -207 +233 @@
         list_initialize(&res->children);
         list_initialize(&res->match_ids.ids);
+        fibril_mutex_initialize(&res->children_mutex);
         
         return res;
 }
 
+static inline void delete_dev_node(node_t *node)
+{
+        assert(list_empty(&node->children) && NULL == node->parent && NULL == node->drv);
+        
+        clean_match_ids(&node->match_ids);
+        free_not_null(node->name);
+        free_not_null(node->pathname);
+        free(node);     
+}
+
+/**
+ * Find the device node structure of the device witch has the specified handle.
+ * 
+ * @param tree the device tree where we look for the device node.
+ * @param handle the handle of the device.
+ * @return the device node. 
+ */
 static inline node_t * find_dev_node(dev_tree_t *tree, long handle)
 {