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,
77 enum connman_service_state {
78 CONNMAN_SERVICE_STATE_UNKNOWN = 0,
79 CONNMAN_SERVICE_STATE_IDLE = 1,
80 CONNMAN_SERVICE_STATE_ASSOCIATION = 2,
81 CONNMAN_SERVICE_STATE_CONFIGURATION = 3,
82 CONNMAN_SERVICE_STATE_READY = 4,
83 CONNMAN_SERVICE_STATE_ONLINE = 5,
84 CONNMAN_SERVICE_STATE_DISCONNECT = 6,
85 CONNMAN_SERVICE_STATE_FAILURE = 7,
88 enum connman_service_error {
89 CONNMAN_SERVICE_ERROR_UNKNOWN = 0,
90 CONNMAN_SERVICE_ERROR_OUT_OF_RANGE = 1,
91 CONNMAN_SERVICE_ERROR_PIN_MISSING = 2,
92 CONNMAN_SERVICE_ERROR_DHCP_FAILED = 3,
93 CONNMAN_SERVICE_ERROR_CONNECT_FAILED = 4,
94 CONNMAN_SERVICE_ERROR_LOGIN_FAILED = 5,
95 CONNMAN_SERVICE_ERROR_AUTH_FAILED = 6,
96 CONNMAN_SERVICE_ERROR_INVALID_KEY = 7,
97 CONNMAN_SERVICE_ERROR_BLOCKED = 8,
100 enum connman_service_proxy_method {
101 CONNMAN_SERVICE_PROXY_METHOD_UNKNOWN = 0,
102 CONNMAN_SERVICE_PROXY_METHOD_DIRECT = 1,
103 CONNMAN_SERVICE_PROXY_METHOD_MANUAL = 2,
104 CONNMAN_SERVICE_PROXY_METHOD_AUTO = 3,
107 enum connman_service_connect_reason {
108 CONNMAN_SERVICE_CONNECT_REASON_NONE = 0,
109 CONNMAN_SERVICE_CONNECT_REASON_AUTO = 1,
110 CONNMAN_SERVICE_CONNECT_REASON_USER = 2,
111 CONNMAN_SERVICE_CONNECT_REASON_SESSION = 3,
114 struct connman_service;
115 struct connman_network;
117 struct connman_service *connman_service_create(void);
119 #define connman_service_ref(service) \
120 connman_service_ref_debug(service, __FILE__, __LINE__, __func__)
122 #define connman_service_unref(service) \
123 connman_service_unref_debug(service, __FILE__, __LINE__, __func__)
125 struct connman_service *
126 connman_service_ref_debug(struct connman_service *service,
127 const char *file, int line, const char *caller);
128 void connman_service_unref_debug(struct connman_service *service,
129 const char *file, int line, const char *caller);
131 enum connman_service_type connman_service_get_type(struct connman_service *service);
132 char *connman_service_get_interface(struct connman_service *service);
134 const char *connman_service_get_domainname(struct connman_service *service);
135 char **connman_service_get_nameservers(struct connman_service *service);
136 char **connman_service_get_timeservers_config(struct connman_service *service);
137 char **connman_service_get_timeservers(struct connman_service *service);
138 void connman_service_set_proxy_method(struct connman_service *service, enum connman_service_proxy_method method);
139 enum connman_service_proxy_method connman_service_get_proxy_method(struct connman_service *service);
140 char **connman_service_get_proxy_servers(struct connman_service *service);
141 char **connman_service_get_proxy_excludes(struct connman_service *service);
142 const char *connman_service_get_proxy_url(struct connman_service *service);
143 const char *connman_service_get_proxy_autoconfig(struct connman_service *service);
144 bool connman_service_get_favorite(struct connman_service *service);
145 bool connman_service_get_autoconnect(struct connman_service *service);
147 struct connman_service *connman_service_lookup_from_network(struct connman_network *network);
148 struct connman_service *connman_service_lookup_from_identifier(const char* identifier);
150 void connman_service_create_ip4config(struct connman_service *service,
152 void connman_service_create_ip6config(struct connman_service *service,
155 #if defined TIZEN_EXT
157 * Description: TIZEN implements system global connection management.
158 * It's only for PDP (cellular) bearer. Wi-Fi is managed by ConnMan automatically.
159 * Reference count can help to manage open/close connection requests by each application.
163 * Increase reference count of user-initiated packet data network connection
165 void connman_service_user_pdn_connection_ref(struct connman_service *service);
168 * Decrease reference count of user initiated packet data network connection
169 * and return TRUE if counter is zero.
171 gboolean connman_service_user_pdn_connection_unref_and_test(
172 struct connman_service *service);
175 * Test reference count of user initiated packet data network connection
176 * and return TRUE if counter is zero. No impact to reference count
178 gboolean connman_service_is_no_ref_user_pdn_connection(
179 struct connman_service *service);
182 #if defined TIZEN_EXT
183 struct connman_service *connman_service_get_default_connection(void);
186 * Description: telephony plug-in requires manual PROXY setting
188 int connman_service_set_proxy(struct connman_service *service,
189 const char *proxy, gboolean active);
191 void connman_service_set_disconnection_requested(struct connman_service *service,
192 bool disconnection_requested);
199 #endif /* __CONNMAN_SERVICE_H */