5 * Copyright (C) 2007-2014 Intel Corporation. All rights reserved.
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.
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.
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
22 #ifndef __CONNMAN_SERVICE_H
23 #define __CONNMAN_SERVICE_H
37 * @title: Service premitives
38 * @short_description: Functions for handling services
41 enum connman_service_type {
42 CONNMAN_SERVICE_TYPE_UNKNOWN = 0,
43 CONNMAN_SERVICE_TYPE_SYSTEM = 1,
44 CONNMAN_SERVICE_TYPE_ETHERNET = 2,
45 CONNMAN_SERVICE_TYPE_WIFI = 3,
46 CONNMAN_SERVICE_TYPE_BLUETOOTH = 4,
47 CONNMAN_SERVICE_TYPE_CELLULAR = 5,
48 CONNMAN_SERVICE_TYPE_GPS = 6,
49 CONNMAN_SERVICE_TYPE_VPN = 7,
50 CONNMAN_SERVICE_TYPE_GADGET = 8,
51 CONNMAN_SERVICE_TYPE_P2P = 9,
52 #if defined TIZEN_EXT_WIFI_MESH
53 CONNMAN_SERVICE_TYPE_MESH = 10,
56 #if defined TIZEN_EXT_WIFI_MESH
57 #define MAX_CONNMAN_SERVICE_TYPES 11
59 #define MAX_CONNMAN_SERVICE_TYPES 10
63 enum connman_service_security {
64 CONNMAN_SERVICE_SECURITY_UNKNOWN = 0,
65 CONNMAN_SERVICE_SECURITY_NONE = 1,
66 CONNMAN_SERVICE_SECURITY_WEP = 2,
67 CONNMAN_SERVICE_SECURITY_PSK = 3,
68 CONNMAN_SERVICE_SECURITY_8021X = 4,
69 CONNMAN_SERVICE_SECURITY_WPA = 8,
70 CONNMAN_SERVICE_SECURITY_RSN = 9,
72 CONNMAN_SERVICE_SECURITY_SAE = 10,
73 CONNMAN_SERVICE_SECURITY_OWE = 11,
74 CONNMAN_SERVICE_SECURITY_DPP = 12,
77 CONNMAN_SERVICE_SECURITY_MAX
81 enum connman_service_state {
82 CONNMAN_SERVICE_STATE_UNKNOWN = 0,
83 CONNMAN_SERVICE_STATE_IDLE = 1,
84 CONNMAN_SERVICE_STATE_ASSOCIATION = 2,
85 CONNMAN_SERVICE_STATE_CONFIGURATION = 3,
86 CONNMAN_SERVICE_STATE_READY = 4,
87 CONNMAN_SERVICE_STATE_ONLINE = 5,
88 CONNMAN_SERVICE_STATE_DISCONNECT = 6,
89 CONNMAN_SERVICE_STATE_FAILURE = 7,
92 enum connman_service_error {
93 CONNMAN_SERVICE_ERROR_UNKNOWN = 0,
94 CONNMAN_SERVICE_ERROR_OUT_OF_RANGE = 1,
95 CONNMAN_SERVICE_ERROR_PIN_MISSING = 2,
96 CONNMAN_SERVICE_ERROR_DHCP_FAILED = 3,
97 CONNMAN_SERVICE_ERROR_CONNECT_FAILED = 4,
98 CONNMAN_SERVICE_ERROR_LOGIN_FAILED = 5,
99 CONNMAN_SERVICE_ERROR_AUTH_FAILED = 6,
100 CONNMAN_SERVICE_ERROR_INVALID_KEY = 7,
101 CONNMAN_SERVICE_ERROR_BLOCKED = 8,
104 enum connman_service_proxy_method {
105 CONNMAN_SERVICE_PROXY_METHOD_UNKNOWN = 0,
106 CONNMAN_SERVICE_PROXY_METHOD_DIRECT = 1,
107 CONNMAN_SERVICE_PROXY_METHOD_MANUAL = 2,
108 CONNMAN_SERVICE_PROXY_METHOD_AUTO = 3,
111 enum connman_service_connect_reason {
112 CONNMAN_SERVICE_CONNECT_REASON_NONE = 0,
113 CONNMAN_SERVICE_CONNECT_REASON_AUTO = 1,
114 CONNMAN_SERVICE_CONNECT_REASON_USER = 2,
115 CONNMAN_SERVICE_CONNECT_REASON_SESSION = 3,
118 struct connman_service;
119 struct connman_network;
121 struct connman_service *connman_service_create(void);
123 #define connman_service_ref(service) \
124 connman_service_ref_debug(service, __FILE__, __LINE__, __func__)
126 #define connman_service_unref(service) \
127 connman_service_unref_debug(service, __FILE__, __LINE__, __func__)
129 struct connman_service *
130 connman_service_ref_debug(struct connman_service *service,
131 const char *file, int line, const char *caller);
132 void connman_service_unref_debug(struct connman_service *service,
133 const char *file, int line, const char *caller);
135 enum connman_service_type connman_service_get_type(struct connman_service *service);
136 enum connman_service_state connman_service_get_state(struct connman_service *service);
137 char *connman_service_get_interface(struct connman_service *service);
139 const char *connman_service_get_identifier(struct connman_service *service);
140 const char *connman_service_get_domainname(struct connman_service *service);
141 const char *connman_service_get_dbuspath(struct connman_service *service);
142 char **connman_service_get_nameservers(struct connman_service *service);
143 char **connman_service_get_timeservers_config(struct connman_service *service);
144 char **connman_service_get_timeservers(struct connman_service *service);
145 void connman_service_set_proxy_method(struct connman_service *service, enum connman_service_proxy_method method);
146 enum connman_service_proxy_method connman_service_get_proxy_method(struct connman_service *service);
147 char **connman_service_get_proxy_servers(struct connman_service *service);
148 char **connman_service_get_proxy_excludes(struct connman_service *service);
149 const char *connman_service_get_proxy_url(struct connman_service *service);
150 const char *connman_service_get_proxy_autoconfig(struct connman_service *service);
151 bool connman_service_get_favorite(struct connman_service *service);
152 bool connman_service_get_autoconnect(struct connman_service *service);
154 /* Return non-zero value to terminate the loop, zero to continue */
155 typedef int (* connman_service_iterate_cb) (struct connman_service *service,
157 int connman_service_iterate_services(connman_service_iterate_cb cb,
160 struct connman_service *connman_service_get_default(void);
161 struct connman_service *connman_service_lookup_from_network(struct connman_network *network);
162 struct connman_service *connman_service_lookup_from_identifier(const char* identifier);
164 void connman_service_create_ip4config(struct connman_service *service,
166 void connman_service_create_ip6config(struct connman_service *service,
169 #if defined TIZEN_EXT
171 * Description: TIZEN implements system global connection management.
172 * It's only for PDP (cellular) bearer. Wi-Fi is managed by ConnMan automatically.
173 * Reference count can help to manage open/close connection requests by each application.
177 * Increase reference count of user-initiated packet data network connection
179 void connman_service_user_pdn_connection_ref(struct connman_service *service);
182 * Decrease reference count of user initiated packet data network connection
183 * and return TRUE if counter is zero.
185 gboolean connman_service_user_pdn_connection_unref_and_test(
186 struct connman_service *service);
189 * Test reference count of user initiated packet data network connection
190 * and return TRUE if counter is zero. No impact to reference count
192 gboolean connman_service_is_no_ref_user_pdn_connection(
193 struct connman_service *service);
195 struct connman_service *connman_service_get_default_connection(void);
198 * Description: telephony plug-in requires manual PROXY setting
200 int connman_service_set_proxy(struct connman_service *service,
201 const char *proxy, gboolean active);
203 void connman_service_set_disconnection_requested(struct connman_service *service,
204 bool disconnection_requested);
207 #if defined TIZEN_EXT
208 void connman_service_set_internet_connection(struct connman_service *service,
209 bool internet_connection);
210 bool connman_service_get_internet_connection(struct connman_service *service);
217 #endif /* __CONNMAN_SERVICE_H */