Add fully dynamic property storage capabilities
[connman] / include / element.h
1 /*
2  *
3  *  Connection Manager
4  *
5  *  Copyright (C) 2007-2009  Intel Corporation. All rights reserved.
6  *
7  *  This program is free software; you can redistribute it and/or modify
8  *  it under the terms of the GNU General Public License version 2 as
9  *  published by the Free Software Foundation.
10  *
11  *  This program is distributed in the hope that it will be useful,
12  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
13  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14  *  GNU General Public License for more details.
15  *
16  *  You should have received a copy of the GNU General Public License
17  *  along with this program; if not, write to the Free Software
18  *  Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
19  *
20  */
21
22 #ifndef __CONNMAN_ELEMENT_H
23 #define __CONNMAN_ELEMENT_H
24
25 #ifdef __cplusplus
26 extern "C" {
27 #endif
28
29 #include <errno.h>
30 #include <glib.h>
31
32 #include <connman/property.h>
33 #include <connman/types.h>
34 #include <connman/ipv4.h>
35
36 /**
37  * SECTION:element
38  * @title: Element premitives
39  * @short_description: Functions for handling elements
40  */
41
42 enum connman_element_type {
43         CONNMAN_ELEMENT_TYPE_UNKNOWN    = 0,
44         CONNMAN_ELEMENT_TYPE_ROOT       = 1,
45         CONNMAN_ELEMENT_TYPE_PROFILE    = 2,
46         CONNMAN_ELEMENT_TYPE_DEVICE     = 3,
47         CONNMAN_ELEMENT_TYPE_NETWORK    = 4,
48         CONNMAN_ELEMENT_TYPE_SERVICE    = 5,
49         CONNMAN_ELEMENT_TYPE_PPP        = 6,
50         CONNMAN_ELEMENT_TYPE_IPV4       = 7,
51         CONNMAN_ELEMENT_TYPE_IPV6       = 8,
52         CONNMAN_ELEMENT_TYPE_DHCP       = 9,
53         CONNMAN_ELEMENT_TYPE_BOOTP      = 10,
54         CONNMAN_ELEMENT_TYPE_ZEROCONF   = 11,
55         CONNMAN_ELEMENT_TYPE_CONNECTION = 42,
56         CONNMAN_ELEMENT_TYPE_VENDOR     = 10000,
57 };
58
59 struct connman_driver;
60
61 struct connman_element {
62         gint refcount;
63         gint index;
64         gchar *name;
65         gchar *path;
66         enum connman_element_type type;
67         gboolean enabled;
68         gboolean configuring;
69         gchar *devname;
70
71         struct connman_element *parent;
72
73         struct connman_driver *driver;
74         void *driver_data;
75
76         void (*destruct) (struct connman_element *element);
77
78         union {
79                 void *private;
80                 struct connman_device *device;
81                 struct connman_network *network;
82         };
83
84         GHashTable *properties;
85
86         struct {
87                 enum connman_ipv4_method method;
88                 gchar *address;
89                 gchar *netmask;
90                 gchar *gateway;
91                 gchar *network;
92                 gchar *broadcast;
93                 gchar *nameserver;
94         } ipv4;
95 };
96
97 extern struct connman_element *connman_element_create(const char *name);
98 extern struct connman_element *connman_element_ref(struct connman_element *element);
99 extern void connman_element_unref(struct connman_element *element);
100
101 extern int connman_element_get_value(struct connman_element *element,
102                                 enum connman_property_id id, void *value);
103
104 extern int connman_element_set_string(struct connman_element *element,
105                                         const char *key, const char *value);
106 extern const char *connman_element_get_string(struct connman_element *element,
107                                                         const char *key);
108 extern int connman_element_set_uint8(struct connman_element *element,
109                                 const char *key, connman_uint8_t value);
110 extern connman_uint8_t connman_element_get_uint8(struct connman_element *element,
111                                                         const char *key);
112 extern int connman_element_set_blob(struct connman_element *element,
113                         const char *key, const void *data, unsigned int size);
114 extern const void *connman_element_get_blob(struct connman_element *element,
115                                         const char *key, unsigned int *size);
116
117 extern int connman_element_register(struct connman_element *element,
118                                         struct connman_element *parent);
119 extern void connman_element_unregister(struct connman_element *element);
120 extern void connman_element_unregister_children(struct connman_element *element);
121 extern void connman_element_update(struct connman_element *element);
122
123 extern int connman_element_set_enabled(struct connman_element *element,
124                                                         gboolean enabled);
125
126 static inline void *connman_element_get_data(struct connman_element *element)
127 {
128         return element->driver_data;
129 }
130
131 static inline void connman_element_set_data(struct connman_element *element,
132                                                                 void *data)
133 {
134         element->driver_data = data;
135 }
136
137 #ifdef __cplusplus
138 }
139 #endif
140
141 #endif /* __CONNMAN_ELEMENT_H */