83c146be5c8a6089d3a870c06de7141f748c8e71
[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
34 /**
35  * SECTION:element
36  * @title: Element premitives
37  * @short_description: Functions for handling elements
38  */
39
40 enum connman_element_state {
41         CONNMAN_ELEMENT_STATE_UNKNOWN   = 0,
42         CONNMAN_ELEMENT_STATE_CONNECT   = 1,
43         CONNMAN_ELEMENT_STATE_CONNECTED = 2,
44         CONNMAN_ELEMENT_STATE_CLOSED    = 3,
45 };
46
47 enum connman_element_policy {
48         CONNMAN_ELEMENT_POLICY_UNKNOWN = 0,
49         CONNMAN_ELEMENT_POLICY_IGNORE  = 1,
50         CONNMAN_ELEMENT_POLICY_AUTO    = 2,
51         CONNMAN_ELEMENT_POLICY_ASK     = 3,
52 };
53
54 enum connman_element_type {
55         CONNMAN_ELEMENT_TYPE_UNKNOWN    = 0,
56         CONNMAN_ELEMENT_TYPE_ROOT       = 1,
57         CONNMAN_ELEMENT_TYPE_PROFILE    = 2,
58         CONNMAN_ELEMENT_TYPE_DEVICE     = 3,
59         CONNMAN_ELEMENT_TYPE_NETWORK    = 4,
60         CONNMAN_ELEMENT_TYPE_SERVICE    = 5,
61         CONNMAN_ELEMENT_TYPE_PPP        = 6,
62         CONNMAN_ELEMENT_TYPE_IPV4       = 7,
63         CONNMAN_ELEMENT_TYPE_IPV6       = 8,
64         CONNMAN_ELEMENT_TYPE_DHCP       = 9,
65         CONNMAN_ELEMENT_TYPE_BOOTP      = 10,
66         CONNMAN_ELEMENT_TYPE_ZEROCONF   = 11,
67         CONNMAN_ELEMENT_TYPE_CONNECTION = 42,
68         CONNMAN_ELEMENT_TYPE_VENDOR     = 10000,
69 };
70
71 enum connman_element_subtype {
72         CONNMAN_ELEMENT_SUBTYPE_UNKNOWN   = 0,
73         CONNMAN_ELEMENT_SUBTYPE_FAKE      = 1,
74         CONNMAN_ELEMENT_SUBTYPE_ETHERNET  = 3,
75         CONNMAN_ELEMENT_SUBTYPE_WIFI      = 4,
76         CONNMAN_ELEMENT_SUBTYPE_WIMAX     = 5,
77         CONNMAN_ELEMENT_SUBTYPE_CELLULAR  = 6,
78         CONNMAN_ELEMENT_SUBTYPE_BLUETOOTH = 7,
79 };
80
81 struct connman_driver;
82
83 struct connman_element {
84         gint refcount;
85         gint index;
86         gchar *name;
87         gchar *path;
88         enum connman_element_type type;
89         enum connman_element_subtype subtype;
90         enum connman_element_state state;
91         enum connman_element_policy policy;
92         gboolean enabled;
93         gboolean scanning;
94         gboolean available;
95         gboolean remember;
96         guint16 priority;
97         guint8 strength;
98         gchar *devpath;
99         gchar *devname;
100
101         struct connman_element *parent;
102
103         struct connman_driver *driver;
104         void *driver_data;
105
106         void (*destruct) (struct connman_element *element);
107
108         union {
109                 void *private;
110                 struct connman_device *device;
111                 struct connman_network *network;
112         };
113
114         GSList *properties;
115
116         struct {
117                 gchar *address;
118                 gchar *netmask;
119                 gchar *gateway;
120                 gchar *network;
121                 gchar *broadcast;
122                 gchar *nameserver;
123         } ipv4;
124
125         struct {
126                 gchar *security;
127                 gchar *passphrase;
128         } wifi;
129 };
130
131 extern struct connman_element *connman_element_create(const char *name);
132 extern struct connman_element *connman_element_ref(struct connman_element *element);
133 extern void connman_element_unref(struct connman_element *element);
134
135 extern int connman_element_add_static_property(struct connman_element *element,
136                                 const char *name, int type, const void *value);
137 extern int connman_element_set_static_property(struct connman_element *element,
138                                 const char *name, int type, const void *value);
139 extern int connman_element_add_static_array_property(struct connman_element *element,
140                         const char *name, int type, const void *value, int len);
141 extern int connman_element_define_properties(struct connman_element *element, ...);
142 extern int connman_element_create_property(struct connman_element *element,
143                                                 const char *name, int type);
144 extern int connman_element_set_property(struct connman_element *element,
145                                 enum connman_property_id id, const void *value);
146 extern int connman_element_get_value(struct connman_element *element,
147                                 enum connman_property_id id, void *value);
148 extern gboolean connman_element_get_static_property(struct connman_element *element,
149                                                 const char *name, void *value);
150 extern gboolean connman_element_get_static_array_property(struct connman_element *element,
151                                         const char *name, void *value, int *len);
152 extern gboolean connman_element_match_static_property(struct connman_element *element,
153                                         const char *name, const void *value);
154
155 extern int connman_element_register(struct connman_element *element,
156                                         struct connman_element *parent);
157 extern void connman_element_unregister(struct connman_element *element);
158 extern void connman_element_unregister_children(struct connman_element *element);
159 extern void connman_element_update(struct connman_element *element);
160
161 extern int connman_element_set_enabled(struct connman_element *element,
162                                                         gboolean enabled);
163 extern int connman_element_set_scanning(struct connman_element *element,
164                                                         gboolean scanning);
165
166 static inline void *connman_element_get_data(struct connman_element *element)
167 {
168         return element->driver_data;
169 }
170
171 static inline void connman_element_set_data(struct connman_element *element,
172                                                                 void *data)
173 {
174         element->driver_data = data;
175 }
176
177 #ifdef __cplusplus
178 }
179 #endif
180
181 #endif /* __CONNMAN_ELEMENT_H */