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
38 * @title: Service premitives
39 * @short_description: Functions for handling services
42 enum connman_service_type {
43 CONNMAN_SERVICE_TYPE_UNKNOWN = 0,
44 CONNMAN_SERVICE_TYPE_SYSTEM = 1,
45 CONNMAN_SERVICE_TYPE_ETHERNET = 2,
46 CONNMAN_SERVICE_TYPE_WIFI = 3,
47 CONNMAN_SERVICE_TYPE_BLUETOOTH = 4,
48 CONNMAN_SERVICE_TYPE_CELLULAR = 5,
49 CONNMAN_SERVICE_TYPE_GPS = 6,
50 CONNMAN_SERVICE_TYPE_VPN = 7,
51 CONNMAN_SERVICE_TYPE_GADGET = 8,
52 CONNMAN_SERVICE_TYPE_P2P = 9,
53 #if defined TIZEN_EXT_WIFI_MESH
54 CONNMAN_SERVICE_TYPE_MESH = 10,
57 #if defined TIZEN_EXT_WIFI_MESH
58 #define MAX_CONNMAN_SERVICE_TYPES 11
60 #define MAX_CONNMAN_SERVICE_TYPES 10
64 enum connman_service_security {
65 CONNMAN_SERVICE_SECURITY_UNKNOWN = 0,
66 CONNMAN_SERVICE_SECURITY_NONE = 1,
67 CONNMAN_SERVICE_SECURITY_WEP = 2,
68 CONNMAN_SERVICE_SECURITY_PSK = 3,
69 CONNMAN_SERVICE_SECURITY_8021X = 4,
70 CONNMAN_SERVICE_SECURITY_WPA = 8,
71 CONNMAN_SERVICE_SECURITY_RSN = 9,
73 CONNMAN_SERVICE_SECURITY_SAE = 10,
74 CONNMAN_SERVICE_SECURITY_OWE = 11,
75 CONNMAN_SERVICE_SECURITY_DPP = 12,
78 CONNMAN_SERVICE_SECURITY_MAX
82 enum connman_service_state {
83 CONNMAN_SERVICE_STATE_UNKNOWN = 0,
84 CONNMAN_SERVICE_STATE_IDLE = 1,
85 CONNMAN_SERVICE_STATE_ASSOCIATION = 2,
86 CONNMAN_SERVICE_STATE_CONFIGURATION = 3,
87 CONNMAN_SERVICE_STATE_READY = 4,
88 CONNMAN_SERVICE_STATE_ONLINE = 5,
89 CONNMAN_SERVICE_STATE_DISCONNECT = 6,
90 CONNMAN_SERVICE_STATE_FAILURE = 7,
93 enum connman_service_error {
94 CONNMAN_SERVICE_ERROR_UNKNOWN = 0,
95 CONNMAN_SERVICE_ERROR_OUT_OF_RANGE = 1,
96 CONNMAN_SERVICE_ERROR_PIN_MISSING = 2,
97 CONNMAN_SERVICE_ERROR_DHCP_FAILED = 3,
98 CONNMAN_SERVICE_ERROR_CONNECT_FAILED = 4,
99 CONNMAN_SERVICE_ERROR_LOGIN_FAILED = 5,
100 CONNMAN_SERVICE_ERROR_AUTH_FAILED = 6,
101 CONNMAN_SERVICE_ERROR_INVALID_KEY = 7,
102 CONNMAN_SERVICE_ERROR_BLOCKED = 8,
105 enum connman_service_proxy_method {
106 CONNMAN_SERVICE_PROXY_METHOD_UNKNOWN = 0,
107 CONNMAN_SERVICE_PROXY_METHOD_DIRECT = 1,
108 CONNMAN_SERVICE_PROXY_METHOD_MANUAL = 2,
109 CONNMAN_SERVICE_PROXY_METHOD_AUTO = 3,
112 enum connman_service_connect_reason {
113 CONNMAN_SERVICE_CONNECT_REASON_NONE = 0,
114 CONNMAN_SERVICE_CONNECT_REASON_AUTO = 1,
115 CONNMAN_SERVICE_CONNECT_REASON_USER = 2,
116 CONNMAN_SERVICE_CONNECT_REASON_SESSION = 3,
119 struct connman_service;
120 struct connman_network;
122 struct connman_service *connman_service_create(void);
124 #define connman_service_ref(service) \
125 connman_service_ref_debug(service, __FILE__, __LINE__, __func__)
127 #define connman_service_unref(service) \
128 connman_service_unref_debug(service, __FILE__, __LINE__, __func__)
130 struct connman_service *
131 connman_service_ref_debug(struct connman_service *service,
132 const char *file, int line, const char *caller);
133 void connman_service_unref_debug(struct connman_service *service,
134 const char *file, int line, const char *caller);
136 enum connman_service_type connman_service_get_type(struct connman_service *service);
137 enum connman_service_state connman_service_get_state(struct connman_service *service);
138 char *connman_service_get_interface(struct connman_service *service);
140 const char *connman_service_get_identifier(struct connman_service *service);
141 const char *connman_service_get_domainname(struct connman_service *service);
142 const char *connman_service_get_dbuspath(struct connman_service *service);
143 char **connman_service_get_nameservers(struct connman_service *service);
144 char **connman_service_get_timeservers_config(struct connman_service *service);
145 char **connman_service_get_timeservers(struct connman_service *service);
146 void connman_service_set_proxy_method(struct connman_service *service, enum connman_service_proxy_method method);
147 enum connman_service_proxy_method connman_service_get_proxy_method(struct connman_service *service);
148 char **connman_service_get_proxy_servers(struct connman_service *service);
149 char **connman_service_get_proxy_excludes(struct connman_service *service);
150 const char *connman_service_get_proxy_url(struct connman_service *service);
151 const char *connman_service_get_proxy_autoconfig(struct connman_service *service);
152 bool connman_service_get_favorite(struct connman_service *service);
153 bool connman_service_get_autoconnect(struct connman_service *service);
154 bool connman_service_set_autoconnect(struct connman_service *service,
157 /* Return non-zero value to terminate the loop, zero to continue */
158 typedef int (* connman_service_iterate_cb) (struct connman_service *service,
160 int connman_service_iterate_services(connman_service_iterate_cb cb,
163 struct connman_service *connman_service_get_default(void);
164 struct connman_service *connman_service_lookup_from_network(struct connman_network *network);
165 struct connman_service *connman_service_lookup_from_identifier(const char* identifier);
167 void connman_service_create_ip4config(struct connman_service *service,
169 void connman_service_create_ip6config(struct connman_service *service,
172 #if defined TIZEN_EXT
174 * Description: TIZEN implements system global connection management.
175 * It's only for PDP (cellular) bearer. Wi-Fi is managed by ConnMan automatically.
176 * Reference count can help to manage open/close connection requests by each application.
180 * Increase reference count of user-initiated packet data network connection
182 void connman_service_user_pdn_connection_ref(struct connman_service *service);
185 * Decrease reference count of user initiated packet data network connection
186 * and return TRUE if counter is zero.
188 gboolean connman_service_user_pdn_connection_unref_and_test(
189 struct connman_service *service);
192 * Test reference count of user initiated packet data network connection
193 * and return TRUE if counter is zero. No impact to reference count
195 gboolean connman_service_is_no_ref_user_pdn_connection(
196 struct connman_service *service);
198 struct connman_service *connman_service_get_default_connection(void);
199 struct connman_service *connman_service_get_connected_service(const char *ifname);
202 * Description: telephony plug-in requires manual PROXY setting
204 int connman_service_set_proxy(struct connman_service *service,
205 const char *proxy, gboolean active);
207 void connman_service_set_disconnection_requested(struct connman_service *service,
208 bool disconnection_requested);
211 #if defined TIZEN_EXT
212 void connman_service_set_internet_connection(struct connman_service *service,
213 bool internet_connection);
214 bool connman_service_get_internet_connection(struct connman_service *service);
215 DBusMessage *connman_service_create_dbus_service_reply(DBusMessage *msg,
216 struct connman_service *service);
223 #endif /* __CONNMAN_SERVICE_H */