Changes in uspace/srv/devman/devman.h [83a2f43:ffa2c8ef] in mainline

File:

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

uspace/srv/devman/devman.h

@@ -56 +56 @@
 #define DEVMAP_SEPARATOR '\\'
 
-struct dev_node;
-typedef struct dev_node dev_node_t;
-
-struct fun_node;
-typedef struct fun_node fun_node_t;
+struct node;
+typedef struct node node_t;
 
 typedef enum {
@@ -120 +117 @@
 } device_state_t;
 
-/** Device node in the device tree. */
-struct dev_node {
+/** Representation of a node in the device tree. */
+struct node {
         /** The global unique identifier of the device. */
         devman_handle_t handle;
-        
-        /** (Parent) function the device is attached to. */
-        fun_node_t *pfun;
-        
-        /** List of device functions. */
-        link_t functions;
+        /** The name of the device specified by its parent. */
+        char *name;
+        
+        /**
+         * Full path and name of the device in device hierarchi (i. e. in full
+         * path in device tree).
+         */
+        char *pathname;
+        
+        /** The node of the parent device. */
+        node_t *parent;
+        
+        /**
+         * Pointers to previous and next child devices in the linked list of
+         * parent device's node.
+         */
+        link_t sibling;
+        
+        /** List of child device nodes. */
+        link_t children;
+        /** List of device ids for device-to-driver matching. */
+        match_id_list_t match_ids;
         /** Driver of this device. */
         driver_t *drv;
         /** The state of the device. */
         device_state_t state;
-        /** Link to list of devices owned by driver (driver_t.devices) */
+        /**
+         * Pointer to the previous and next device in the list of devices
+         * owned by one driver.
+         */
         link_t driver_devices;
         
+        /** The list of device classes to which this device belongs. */
+        link_t classes;
+        /** Devmap handle if the device is registered by devmapper. */
+        devmap_handle_t devmap_handle;
+        
         /**
          * Used by the hash table of devices indexed by devman device handles.
          */
-        link_t devman_dev;
-        
+        link_t devman_link;
+        
+        /**
+         * Used by the hash table of devices indexed by devmap device handles.
+         */
+        link_t devmap_link;
+
         /**
          * Whether this device was already passed to the driver.
@@ -147 +173 @@
         bool passed_to_driver;
 };
-
-/** Function node in the device tree. */
-struct fun_node {
-        /** The global unique identifier of the function */
-        devman_handle_t handle;
-        /** Name of the function, assigned by the device driver */
-        char *name;
-        
-        /** Full path and name of the device in device hierarchy */
-        char *pathname;
-        
-        /** Device which this function belongs to */
-        dev_node_t *dev;
-        
-        /** Link to list of functions in the device (ddf_dev_t.functions) */
-        link_t dev_functions;
-        
-        /** Child device node (if any attached). */
-        dev_node_t *child;
-        /** List of device ids for device-to-driver matching. */
-        match_id_list_t match_ids;
-        
-        /** The list of device classes to which this device function belongs. */
-        link_t classes;
-        /** Devmap handle if the device function is registered by devmap. */
-        devmap_handle_t devmap_handle;
-        
-        /**
-         * Used by the hash table of functions indexed by devman device handles.
-         */
-        link_t devman_fun;
-        
-        /**
-         * Used by the hash table of functions indexed by devmap device handles.
-         */
-        link_t devmap_fun;
-};
-
 
 /** Represents device tree. */
 typedef struct dev_tree {
         /** Root device node. */
-        fun_node_t *root_node;
+        node_t *root_node;
         
         /**
@@ -203 +191 @@
         hash_table_t devman_devices;
         
-        /** Hash table of all devices indexed by devman handles. */
-        hash_table_t devman_functions;
-        
         /**
          * Hash table of devices registered by devmapper, indexed by devmap
          * handles.
          */
-        hash_table_t devmap_functions;
+        hash_table_t devmap_devices;
 } dev_tree_t;
 
@@ -242 +227 @@
 
 /**
- * Provides n-to-m mapping between function nodes and classes - each function
- * can register in an arbitrary number of classes and each class can contain
- * an arbitrary number of device functions.
+ * Provides n-to-m mapping between device nodes and classes - each device may
+ * be register to the arbitrary number of classes and each class may contain
+ * the arbitrary number of devices.
  */
 typedef struct dev_class_info {
@@ -250 +235 @@
         dev_class_t *dev_class;
         /** The device. */
-        fun_node_t *fun;
+        node_t *dev;
         
         /**
@@ -264 +249 @@
         link_t dev_classes;
         
-        /** The name of the device function within the class. */
+        /** The name of the device within the class. */
         char *dev_name;
         /** The handle of the device by device mapper in the class namespace. */
@@ -285 +270 @@
          * indexed by devmap handles.
          */
-        hash_table_t devmap_functions;
+        hash_table_t devmap_devices;
         
         /** Fibril mutex for list of classes. */
@@ -293 +278 @@
 /* Match ids and scores */
 
-extern int get_match_score(driver_t *, dev_node_t *);
+extern int get_match_score(driver_t *, node_t *);
 
 extern bool parse_match_ids(char *, match_id_list_t *);
@@ -307 +292 @@
 extern int lookup_available_drivers(driver_list_t *, const char *);
 
-extern driver_t *find_best_match_driver(driver_list_t *, dev_node_t *);
-extern bool assign_driver(dev_node_t *, driver_list_t *, dev_tree_t *);
+extern driver_t *find_best_match_driver(driver_list_t *, node_t *);
+extern bool assign_driver(node_t *, driver_list_t *, dev_tree_t *);
 
 extern void add_driver(driver_list_t *, driver_t *);
-extern void attach_driver(dev_node_t *, driver_t *);
-extern void add_device(int, driver_t *, dev_node_t *, dev_tree_t *);
+extern void attach_driver(node_t *, driver_t *);
+extern void add_device(int, driver_t *, node_t *, dev_tree_t *);
 extern bool start_driver(driver_t *);
 
@@ -325 +310 @@
 /* Device nodes */
 
-extern dev_node_t *create_dev_node(void);
-extern void delete_dev_node(dev_node_t *node);
-extern dev_node_t *find_dev_node_no_lock(dev_tree_t *tree,
+extern node_t *create_dev_node(void);
+extern void delete_dev_node(node_t *node);
+extern node_t *find_dev_node_no_lock(dev_tree_t *tree,
     devman_handle_t handle);
-extern dev_node_t *find_dev_node(dev_tree_t *tree, devman_handle_t handle);
-extern dev_node_t *find_dev_function(dev_node_t *, const char *);
-
-extern fun_node_t *create_fun_node(void);
-extern void delete_fun_node(fun_node_t *);
-extern fun_node_t *find_fun_node_no_lock(dev_tree_t *tree,
-    devman_handle_t handle);
-extern fun_node_t *find_fun_node(dev_tree_t *tree, devman_handle_t handle);
-extern fun_node_t *find_fun_node_by_path(dev_tree_t *, char *);
+extern node_t *find_dev_node(dev_tree_t *tree, devman_handle_t handle);
+extern node_t *find_dev_node_by_path(dev_tree_t *, char *);
+extern node_t *find_node_child(node_t *, const char *);
 
 /* Device tree */
 
 extern bool init_device_tree(dev_tree_t *, driver_list_t *);
-extern bool create_root_nodes(dev_tree_t *);
-extern bool insert_dev_node(dev_tree_t *, dev_node_t *, fun_node_t *);
-extern bool insert_fun_node(dev_tree_t *, fun_node_t *, char *, dev_node_t *);
+extern bool create_root_node(dev_tree_t *);
+extern bool insert_dev_node(dev_tree_t *, node_t *, char *, node_t *);
 
 /* Device classes */
@@ -352 +330 @@
 extern size_t get_new_class_dev_idx(dev_class_t *);
 extern char *create_dev_name_for_class(dev_class_t *, const char *);
-extern dev_class_info_t *add_function_to_class(fun_node_t *, dev_class_t *,
+extern dev_class_info_t *add_device_to_class(node_t *, dev_class_t *,
     const char *);
 
@@ -363 +341 @@
 /* Devmap devices */
 
-extern void devmap_register_tree_function(fun_node_t *, dev_tree_t *);
-
-extern fun_node_t *find_devmap_tree_function(dev_tree_t *, devmap_handle_t);
-extern fun_node_t *find_devmap_class_function(class_list_t *, devmap_handle_t);
-
-extern void class_add_devmap_function(class_list_t *, dev_class_info_t *);
-extern void tree_add_devmap_function(dev_tree_t *, fun_node_t *);
+extern node_t *find_devmap_tree_device(dev_tree_t *, devmap_handle_t);
+extern node_t *find_devmap_class_device(class_list_t *, devmap_handle_t);
+
+extern void class_add_devmap_device(class_list_t *, dev_class_info_t *);
+extern void tree_add_devmap_device(dev_tree_t *, node_t *);
 
 #endif