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,
73 enum connman_service_state {
74 CONNMAN_SERVICE_STATE_UNKNOWN = 0,
75 CONNMAN_SERVICE_STATE_IDLE = 1,
76 CONNMAN_SERVICE_STATE_ASSOCIATION = 2,
77 CONNMAN_SERVICE_STATE_CONFIGURATION = 3,
78 CONNMAN_SERVICE_STATE_READY = 4,
79 CONNMAN_SERVICE_STATE_ONLINE = 5,
80 CONNMAN_SERVICE_STATE_DISCONNECT = 6,
81 CONNMAN_SERVICE_STATE_FAILURE = 7,
84 enum connman_service_error {
85 CONNMAN_SERVICE_ERROR_UNKNOWN = 0,
86 CONNMAN_SERVICE_ERROR_OUT_OF_RANGE = 1,
87 CONNMAN_SERVICE_ERROR_PIN_MISSING = 2,
88 CONNMAN_SERVICE_ERROR_DHCP_FAILED = 3,
89 CONNMAN_SERVICE_ERROR_CONNECT_FAILED = 4,
90 CONNMAN_SERVICE_ERROR_LOGIN_FAILED = 5,
91 CONNMAN_SERVICE_ERROR_AUTH_FAILED = 6,
92 CONNMAN_SERVICE_ERROR_INVALID_KEY = 7,
93 CONNMAN_SERVICE_ERROR_BLOCKED = 8,
96 enum connman_service_proxy_method {
97 CONNMAN_SERVICE_PROXY_METHOD_UNKNOWN = 0,
98 CONNMAN_SERVICE_PROXY_METHOD_DIRECT = 1,
99 CONNMAN_SERVICE_PROXY_METHOD_MANUAL = 2,
100 CONNMAN_SERVICE_PROXY_METHOD_AUTO = 3,
103 enum connman_service_connect_reason {
104 CONNMAN_SERVICE_CONNECT_REASON_NONE = 0,
105 CONNMAN_SERVICE_CONNECT_REASON_AUTO = 1,
106 CONNMAN_SERVICE_CONNECT_REASON_USER = 2,
107 CONNMAN_SERVICE_CONNECT_REASON_SESSION = 3,
110 struct connman_service;
111 struct connman_network;
113 struct connman_service *connman_service_create(void);
115 #define connman_service_ref(service) \
116 connman_service_ref_debug(service, __FILE__, __LINE__, __func__)
118 #define connman_service_unref(service) \
119 connman_service_unref_debug(service, __FILE__, __LINE__, __func__)
121 struct connman_service *
122 connman_service_ref_debug(struct connman_service *service,
123 const char *file, int line, const char *caller);
124 void connman_service_unref_debug(struct connman_service *service,
125 const char *file, int line, const char *caller);
127 enum connman_service_type connman_service_get_type(struct connman_service *service);
128 char *connman_service_get_interface(struct connman_service *service);
130 const char *connman_service_get_domainname(struct connman_service *service);
131 char **connman_service_get_nameservers(struct connman_service *service);
132 char **connman_service_get_timeservers_config(struct connman_service *service);
133 char **connman_service_get_timeservers(struct connman_service *service);
134 void connman_service_set_proxy_method(struct connman_service *service, enum connman_service_proxy_method method);
135 enum connman_service_proxy_method connman_service_get_proxy_method(struct connman_service *service);
136 char **connman_service_get_proxy_servers(struct connman_service *service);
137 char **connman_service_get_proxy_excludes(struct connman_service *service);
138 const char *connman_service_get_proxy_url(struct connman_service *service);
139 const char *connman_service_get_proxy_autoconfig(struct connman_service *service);
140 bool connman_service_get_favorite(struct connman_service *service);
141 bool connman_service_get_autoconnect(struct connman_service *service);
143 struct connman_service *connman_service_lookup_from_network(struct connman_network *network);
144 struct connman_service *connman_service_lookup_from_identifier(const char* identifier);
146 void connman_service_create_ip4config(struct connman_service *service,
148 void connman_service_create_ip6config(struct connman_service *service,
151 #if defined TIZEN_EXT
153 * Description: TIZEN implements system global connection management.
154 * It's only for PDP (cellular) bearer. Wi-Fi is managed by ConnMan automatically.
155 * Reference count can help to manage open/close connection requests by each application.
159 * Increase reference count of user-initiated packet data network connection
161 void connman_service_user_pdn_connection_ref(struct connman_service *service);
164 * Decrease reference count of user initiated packet data network connection
165 * and return TRUE if counter is zero.
167 gboolean connman_service_user_pdn_connection_unref_and_test(
168 struct connman_service *service);
171 * Test reference count of user initiated packet data network connection
172 * and return TRUE if counter is zero. No impact to reference count
174 gboolean connman_service_is_no_ref_user_pdn_connection(
175 struct connman_service *service);
178 #if defined TIZEN_EXT
179 struct connman_service *connman_service_get_default_connection(void);
182 * Description: telephony plug-in requires manual PROXY setting
184 int connman_service_set_proxy(struct connman_service *service,
185 const char *proxy, gboolean active);
192 #endif /* __CONNMAN_SERVICE_H */