2 * \file udi_meta_mgmt.h
4 #ifndef _UDI_META_MGMT_H_
5 #define _UDI_META_MGMT_H_
7 typedef struct udi_mgmt_ops_s udi_mgmt_ops_t;
8 typedef struct udi_mgmt_cb_s udi_mgmt_cb_t;
9 typedef struct udi_usage_cb_s udi_usage_cb_t;
10 typedef struct udi_filter_element_s udi_filter_element_t;
11 typedef struct udi_enumerate_cb_s udi_enumerate_cb_t;
17 typedef void udi_usage_ind_op_t(udi_usage_cb_t *cb, udi_ubit8_t resource_level);
18 /* Values for resource_level */
19 #define UDI_RESOURCES_CRITICAL 1
20 #define UDI_RESOURCES_LOW 2
21 #define UDI_RESOURCES_NORMAL 3
22 #define UDI_RESOURCES_PLENTIFUL 4
24 extern udi_usage_ind_op_t udi_static_usage;
29 typedef void udi_usage_res_op_t(udi_usage_cb_t *cb);
32 * \name Enumerate this driver
35 typedef void udi_enumerate_req_op_t(udi_enumerate_cb_t *cb, udi_ubit8_t enumeration_level);
36 /* Values for enumeration_level */
37 #define UDI_ENUMERATE_START 1
38 #define UDI_ENUMERATE_START_RESCAN 2
39 #define UDI_ENUMERATE_NEXT 3
40 #define UDI_ENUMERATE_NEW 4
41 #define UDI_ENUMERATE_DIRECTED 5
42 #define UDI_ENUMERATE_RELEASE 6
44 extern udi_enumerate_req_op_t udi_enumerate_no_children;
50 * \name Enumeration Acknowlagement
53 typedef void udi_enumerate_ack_op_t(udi_enumerate_cb_t *cb, udi_ubit8_t enumeration_result, udi_index_t ops_idx);
54 /* Values for enumeration_result */
55 #define UDI_ENUMERATE_OK 0
56 #define UDI_ENUMERATE_LEAF 1
57 #define UDI_ENUMERATE_DONE 2
58 #define UDI_ENUMERATE_RESCAN 3
59 #define UDI_ENUMERATE_REMOVED 4
60 #define UDI_ENUMERATE_REMOVED_SELF 5
61 #define UDI_ENUMERATE_RELEASED 6
62 #define UDI_ENUMERATE_FAILED 255
71 typedef void udi_devmgmt_req_op_t(udi_mgmt_cb_t *cb, udi_ubit8_t mgmt_op, udi_ubit8_t parent_ID);
72 /* Values for mgmt_op */
73 #define UDI_DMGMT_PREPARE_TO_SUSPEND 1
74 #define UDI_DMGMT_SUSPEND 2
75 #define UDI_DMGMT_SHUTDOWN 3
76 #define UDI_DMGMT_PARENT_SUSPENDED 4
77 #define UDI_DMGMT_RESUME 5
78 #define UDI_DMGMT_UNBIND 6
80 typedef void udi_devmgmt_ack_op_t(udi_mgmt_cb_t *cb, udi_ubit8_t flags, udi_status_t status);
81 /* Values for flags */
82 #define UDI_DMGMT_NONTRANSPARENT (1U<<0)
83 /* Meta-Specific Status Codes */
84 #define UDI_DMGMT_STAT_ROUTING_CHANGE (UDI_STAT_META_SPECIFIC|1)
88 typedef void udi_final_cleanup_req_op_t(udi_mgmt_cb_t *cb);
89 typedef void udi_final_cleanup_ack_op_t(udi_mgmt_cb_t *cb);
97 udi_usage_ind_op_t *usage_ind_op;
98 udi_enumerate_req_op_t *enumerate_req_op;
99 udi_devmgmt_req_op_t *devmgmt_req_op;
100 udi_final_cleanup_req_op_t *final_cleanup_req_op;
108 struct udi_usage_cb_s
111 udi_trevent_t trace_mask;
112 udi_index_t meta_idx;
116 struct udi_filter_element_s
118 char attr_name[UDI_MAX_ATTR_NAMELEN];
119 udi_ubit8_t attr_min[UDI_MAX_ATTR_SIZE];
120 udi_ubit8_t attr_min_len;
121 udi_ubit8_t attr_max[UDI_MAX_ATTR_SIZE];
122 udi_ubit8_t attr_max_len;
123 udi_instance_attr_type_t attr_type;
124 udi_ubit32_t attr_stride;
126 struct udi_enumerate_cb_s
129 udi_ubit32_t child_ID;
131 udi_instance_attr_list_t *attr_list;
132 udi_ubit8_t attr_valid_length;
133 const udi_filter_element_t *filter_list;
134 udi_ubit8_t filter_list_length;
135 udi_ubit8_t parent_ID;
137 /* Special parent_ID filter values */
138 #define UDI_ANY_PARENT_ID 0