Changed wearable 3.0 API version
[platform/core/api/connection.git] / include / net_connection.h
1 /*
2  * Copyright (c) 2011-2013 Samsung Electronics Co., Ltd All Rights Reserved
3  *
4  * Licensed under the Apache License, Version 2.0 (the "License");
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at
7  *
8  * http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  */
16
17 #ifndef __NET_CONNECTION_INTF_H__
18 #define __NET_CONNECTION_INTF_H__
19
20 #include "connection_profile.h"
21
22 #ifdef __cplusplus
23 extern "C" {
24 #endif /* __cplusplus */
25
26 /**
27  * @file net_connection.h
28  */
29
30 /**
31  * @addtogroup CAPI_NETWORK_CONNECTION_MANAGER_MODULE
32  * @{
33  */
34
35 /**
36  * @brief The connection handle.
37  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
38 */
39 typedef void* connection_h;
40
41 /**
42  * @brief The profiles iterator handle.
43  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
44 */
45 typedef void* connection_profile_iterator_h;
46
47 /**
48  * @brief Enumeration for connection type.
49  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
50  */
51 typedef enum
52 {
53     CONNECTION_TYPE_DISCONNECTED = 0,  /**< Disconnected */
54     CONNECTION_TYPE_WIFI = 1,  /**< Wi-Fi type */
55     CONNECTION_TYPE_CELLULAR = 2,  /**< Cellular type */
56     CONNECTION_TYPE_ETHERNET = 3,  /**< Ethernet type */
57     CONNECTION_TYPE_BT = 4,  /**< Bluetooth type */
58     CONNECTION_TYPE_NET_PROXY, /**< Proxy type for internet connection (Since 3.0) */
59 } connection_type_e;
60
61 /**
62  * @brief Enumeration for cellular network state.
63  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
64  */
65 typedef enum
66 {
67     CONNECTION_CELLULAR_STATE_OUT_OF_SERVICE = 0,  /**< Out of service */
68     CONNECTION_CELLULAR_STATE_FLIGHT_MODE = 1,  /**< Flight mode */
69     CONNECTION_CELLULAR_STATE_ROAMING_OFF = 2,  /**< Roaming is turned off */
70     CONNECTION_CELLULAR_STATE_CALL_ONLY_AVAILABLE = 3,  /**< Call is only available */
71     CONNECTION_CELLULAR_STATE_AVAILABLE = 4,  /**< Available but not connected yet */
72     CONNECTION_CELLULAR_STATE_CONNECTED = 5,  /**< Connected */
73 } connection_cellular_state_e;
74
75 /**
76  * @brief Enumeration for Wi-Fi state.
77  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
78  */
79 typedef enum
80 {
81     CONNECTION_WIFI_STATE_DEACTIVATED = 0,  /**< Wi-Fi is deactivated */
82     CONNECTION_WIFI_STATE_DISCONNECTED = 1,  /**< Disconnected */
83     CONNECTION_WIFI_STATE_CONNECTED = 2,  /**< Connected */
84 } connection_wifi_state_e;
85
86 /**
87  * @brief Enumeration for ethernet state.
88  * @since_tizen 2.4
89  */
90 typedef enum
91 {
92     CONNECTION_ETHERNET_STATE_DEACTIVATED = 0,  /**< There is no Ethernet profile to open */
93     CONNECTION_ETHERNET_STATE_DISCONNECTED = 1,  /**< Disconnected */
94     CONNECTION_ETHERNET_STATE_CONNECTED = 2,  /**< Connected */
95 } connection_ethernet_state_e;
96
97 /**
98  * @brief Enumeration for Bluetooth state.
99  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
100  */
101 typedef enum
102 {
103     CONNECTION_BT_STATE_DEACTIVATED = 0,  /**< There is no Bluetooth profile to open */
104     CONNECTION_BT_STATE_DISCONNECTED = 1,  /**< Disconnected */
105     CONNECTION_BT_STATE_CONNECTED = 2,  /**< Connected */
106 } connection_bt_state_e;
107
108 /**
109  * @brief Enumeration for connection iterator type.
110  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
111  */
112 typedef enum
113 {
114     CONNECTION_ITERATOR_TYPE_REGISTERED = 0,  /**< The iterator of the registered profile  */
115     CONNECTION_ITERATOR_TYPE_CONNECTED = 1,  /**< The iterator of the connected profile  */
116         CONNECTION_ITERATOR_TYPE_DEFAULT = 2,   /**< The iterator of the default profile  */
117 } connection_iterator_type_e;
118
119 /**
120  * @brief Enumeration for reset profile type.
121  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
122 */
123 typedef enum
124 {
125     CONNECTION_RESET_DEFAULT_PROFILE = 0,  /**< Initialized with the default profile defined by csc */
126     CONNECTION_RESET_CLEAR_PROFILE = 1,  /**< Remove all profiles */
127 } connection_reset_option_e;
128
129 /**
130  * @brief This enumeration defines the attached or detached state of ethernet cable.
131  * @since_tizen 2.4
132  */
133 typedef enum
134 {
135     CONNECTION_ETHERNET_CABLE_DETACHED = 0,  /**< Ethernet cable is detached */
136     CONNECTION_ETHERNET_CABLE_ATTACHED = 1,  /**< Ethernet cable is attached */
137 } connection_ethernet_cable_state_e;
138
139 /**
140  * @brief Enumeration for connection errors.
141  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
142  */
143 typedef enum
144 {
145     CONNECTION_ERROR_NONE = TIZEN_ERROR_NONE, /**< Successful */
146     CONNECTION_ERROR_INVALID_PARAMETER = TIZEN_ERROR_INVALID_PARAMETER, /**< Invalid parameter */
147     CONNECTION_ERROR_OUT_OF_MEMORY = TIZEN_ERROR_OUT_OF_MEMORY, /**< Out of memory error */
148     CONNECTION_ERROR_INVALID_OPERATION = TIZEN_ERROR_INVALID_OPERATION, /**< Invalid Operation */
149     CONNECTION_ERROR_ADDRESS_FAMILY_NOT_SUPPORTED = TIZEN_ERROR_ADDRESS_FAMILY_NOT_SUPPORTED, /**< Address family not supported */
150     CONNECTION_ERROR_OPERATION_FAILED = TIZEN_ERROR_CONNECTION|0x0401, /**< Operation failed */
151     CONNECTION_ERROR_ITERATOR_END = TIZEN_ERROR_CONNECTION|0x0402, /**< End of iteration */
152     CONNECTION_ERROR_NO_CONNECTION = TIZEN_ERROR_CONNECTION|0x0403, /**< There is no connection */
153     CONNECTION_ERROR_NOW_IN_PROGRESS = TIZEN_ERROR_NOW_IN_PROGRESS, /** Now in progress */
154     CONNECTION_ERROR_ALREADY_EXISTS = TIZEN_ERROR_CONNECTION|0x0404, /**< Already exists */
155     CONNECTION_ERROR_OPERATION_ABORTED = TIZEN_ERROR_CONNECTION|0x0405, /**< Operation is aborted */
156     CONNECTION_ERROR_DHCP_FAILED = TIZEN_ERROR_CONNECTION|0x0406, /**< DHCP failed  */
157     CONNECTION_ERROR_INVALID_KEY = TIZEN_ERROR_CONNECTION|0x0407, /**< Invalid key  */
158     CONNECTION_ERROR_NO_REPLY = TIZEN_ERROR_CONNECTION|0x0408, /**< No reply */
159     CONNECTION_ERROR_PERMISSION_DENIED = TIZEN_ERROR_PERMISSION_DENIED, /**< Permission denied */
160     CONNECTION_ERROR_NOT_SUPPORTED = TIZEN_ERROR_NOT_SUPPORTED  /**< Not Supported */
161 } connection_error_e;
162
163 /**
164  * @}
165 */
166
167 /**
168  * @addtogroup CAPI_NETWORK_CONNECTION_STATISTICS_MODULE
169  * @{
170 */
171
172 /**
173  * @brief Enumeration for statistics type.
174  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
175  */
176 typedef enum
177 {
178     CONNECTION_STATISTICS_TYPE_LAST_RECEIVED_DATA = 0,  /**< Last received data */
179     CONNECTION_STATISTICS_TYPE_LAST_SENT_DATA = 1,  /**< Last sent data */
180     CONNECTION_STATISTICS_TYPE_TOTAL_RECEIVED_DATA = 2,  /**< Total received data */
181     CONNECTION_STATISTICS_TYPE_TOTAL_SENT_DATA = 3,  /**< Total sent data */
182 } connection_statistics_type_e;
183
184 /**
185  * @}
186 */
187
188 /**
189  * @addtogroup CAPI_NETWORK_CONNECTION_MANAGER_MODULE
190  * @{
191 */
192
193
194 /**
195  * @brief Creates a handle for managing data connections.
196  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
197  * @privlevel public
198  * @privilege %http://tizen.org/privilege/network.get
199  * @remarks You must release @a handle using connection_destroy().
200  * @param[out] connection  The connection handle
201  * @return @c 0 on success, otherwise a negative error value
202  * @retval #CONNECTION_ERROR_NONE  Successful
203  * @retval #CONNECTION_ERROR_INVALID_PARAMETER  Invalid parameter
204  * @retval #CONNECTION_ERROR_OUT_OF_MEMORY  Out of memory
205  * @see connection_destroy()
206  */
207 int connection_create(connection_h* connection);
208
209 /**
210  * @brief Destroys the connection handle.
211  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
212  * @param[in] connection  The connection handle
213  * @return @c 0 on success, otherwise negative error value
214  * @retval #CONNECTION_ERROR_NONE  Successful
215  * @retval #CONNECTION_ERROR_INVALID_PARAMETER  Invalid parameter
216  * @see connection_create()
217  */
218 int connection_destroy(connection_h connection);
219
220 /**
221  * @brief Called when the type of a connection is changed.
222  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
223  * @param[in] type  The type of the current network connection
224  * @param[in] user_data The user data passed from the callback registration function
225  * @see connection_set_type_changed_cb()
226  * @see connection_unset_type_changed_cb()
227  */
228 typedef void(*connection_type_changed_cb)(connection_type_e type, void* user_data);
229
230 /**
231  * @brief Called when the address is changed.
232  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
233  * @param[in] ipv4_address  The IP address for IPv4
234  * @param[in] ipv6_address  The IP address for IPv6
235  * @param[in] user_data The user data passed from the callback registration function
236  * @see connection_set_ip_address_changed_cb()
237  * @see connection_unset_ip_address_changed_cb()
238  * @see connection_set_proxy_address_changed_cb()
239  * @see connection_unset_proxy_address_changed_cb()
240  */
241 typedef void(*connection_address_changed_cb)(const char* ipv4_address, const char* ipv6_address, void* user_data);
242
243 /**
244  * @brief Called when connection_set_default_cellular_service_profile_async() finishes.
245  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
246  * @param[in] result  The result
247  * @param[in] user_data The user data passed from connection_open_profile()
248  * @pre connection_set_default_cellular_service_profile_async() will invoke this callback function.
249  * @see connection_set_default_cellular_service_profile_async()
250 */
251 typedef void(*connection_set_default_cb)(connection_error_e result, void* user_data);
252
253 /**
254  * @brief Gets the type of the current profile for data connection.
255  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
256  * @param[in] connection  The connection handle
257  * @param[out] type  The type of the network
258  * @return @c 0 on success, otherwise negative error value
259  * @retval #CONNECTION_ERROR_NONE  Successful
260  * @retval #CONNECTION_ERROR_INVALID_PARAMETER  Invalid parameter
261  * @retval #CONNECTION_ERROR_OPERATION_FAILED  Operation failed
262  */
263 int connection_get_type(connection_h connection, connection_type_e* type);
264
265 /**
266  * @brief Gets the IP address of the current connection.
267  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
268  * @remarks You must release @a ip_address using free().
269  * @param[in] connection  The connection handle
270  * @param[in] address_family  The address family
271  * @param[out] ip_address  The pointer to the IP address string
272  * @return @c 0 on success, otherwise a negative error value
273  * @retval #CONNECTION_ERROR_NONE  Successful
274  * @retval #CONNECTION_ERROR_INVALID_PARAMETER   Invalid parameter
275  * @retval #CONNECTION_ERROR_OPERATION_FAILED  Operation failed
276  * @retval #CONNECTION_ERROR_ADDRESS_FAMILY_NOT_SUPPORTED  Not supported address family
277  */
278 int connection_get_ip_address(connection_h connection, connection_address_family_e address_family, char** ip_address);
279
280 /**
281  * @brief Gets the proxy address of the current connection.
282  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
283  * @remarks You must release @a proxy using free().
284  * @param[in] connection  The connection handle
285  * @param[in] address_family  The address family
286  * @param[out] proxy  The proxy address
287  * @return @c 0 on success, otherwise a negative error value
288  * @retval #CONNECTION_ERROR_NONE  Successful
289  * @retval #CONNECTION_ERROR_INVALID_PARAMETER   Invalid parameter
290  * @retval #CONNECTION_ERROR_OPERATION_FAILED  Operation failed
291  * @retval #CONNECTION_ERROR_ADDRESS_FAMILY_NOT_SUPPORTED  Not supported address family
292  */
293 int connection_get_proxy(connection_h connection, connection_address_family_e address_family, char** proxy);
294
295 /**
296  * @brief Gets the MAC address of the Wi-Fi or ethernet.
297  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0
298  * @remarks @a mac_addr must be released with free() by you.
299  * @param[in] connection  The handle of the connection
300  * @param[in] type  The type of current network connection
301  * @param[out] mac_addr  The MAC address
302  * @return 0 on success, otherwise negative error value.
303  * @retval #CONNECTION_ERROR_NONE  Successful
304  * @retval #CONNECTION_ERROR_INVALID_PARAMETER   Invalid parameter
305  * @retval #CONNECTION_ERROR_INVALID_OPERATION   Invalid operation
306  * @retval #CONNECTION_ERROR_OPERATION_FAILED  Operation failed
307  * @retval #CONNECTION_ERROR_NOT_SUPPORTED  Not supported
308  * @retval #CONNECTION_ERROR_OUT_OF_MEMORY  Out of memory
309  */
310 int connection_get_mac_address(connection_h connection, connection_type_e type, char** mac_addr);
311
312 /**
313  * @brief Gets the state of cellular connection.
314  * @details The returned state is for the cellular connection state.
315  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
316  * @param[in] connection  The connection handle
317  * @param[out] state  The state of the cellular connection
318  * @return @c 0 on success, otherwise a negative error value
319  * @retval #CONNECTION_ERROR_NONE  Successful
320  * @retval #CONNECTION_ERROR_INVALID_PARAMETER   Invalid parameter
321  * @retval #CONNECTION_ERROR_OPERATION_FAILED  Operation failed
322  * @retval #CONNECTION_ERROR_NOT_SUPPORTED      Not supported
323  */
324 int connection_get_cellular_state(connection_h connection, connection_cellular_state_e* state);
325
326 /**
327  * @brief Gets the state of the Wi-Fi.
328  * @details The returned state is for the Wi-Fi connection state.
329  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
330  * @privlevel public
331  * @privilege %http://tizen.org/privilege/network.get
332  * @param[in] connection  The connection handle
333  * @param[out] state  The state of Wi-Fi connection
334  * @return @c 0 on success, otherwise a negative error value
335  * @retval #CONNECTION_ERROR_NONE  Successful
336  * @retval #CONNECTION_ERROR_INVALID_PARAMETER   Invalid parameter
337  * @retval #CONNECTION_ERROR_OPERATION_FAILED  Operation failed
338  * @retval #CONNECTION_ERROR_PERMISSION_DENIED Permission Denied
339  * @retval #CONNECTION_ERROR_NOT_SUPPORTED      Not supported
340  */
341 int connection_get_wifi_state(connection_h connection, connection_wifi_state_e* state);
342
343 /**
344  * @brief Gets the state of the Ethernet.
345  * @details The returned state is for the Ethernet connection state.
346  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0
347  * @privlevel public
348  * @privilege %http://tizen.org/privilege/network.get
349  * @param[in] connection  The connection handle
350  * @param[out] state  The state of Ethernet connection
351  * @return @c 0 on success, otherwise a negative error value
352  * @retval #CONNECTION_ERROR_NONE  Successful
353  * @retval #CONNECTION_ERROR_INVALID_PARAMETER   Invalid parameter
354  * @retval #CONNECTION_ERROR_OPERATION_FAILED  Operation failed
355  * @retval #CONNECTION_ERROR_PERMISSION_DENIED Permission Denied
356  * @retval #CONNECTION_ERROR_NOT_SUPPORTED      Not supported
357  */
358 int connection_get_ethernet_state(connection_h connection, connection_ethernet_state_e* state);
359
360 /**
361 * @brief Checks for ethernet cable is attached or not.
362 * @details The returned state is for the ethernet cable state.
363 * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0
364 * @privlevel public
365 * @privilege %http://tizen.org/privilege/network.get
366 * @param[in] connection  The handle of the connection
367 * @param[in] state - Enum connection_ethernet_cable_state_e
368 * @return 0 on success, otherwise negative error value
369 * @retval #CONNECTION_ERROR_NONE  Successful
370 * @retval #CONNECTION_ERROR_INVALID_PARAMETER  Invalid parameter
371 * @retval #CONNECTION_ERROR_OPERATION_FAILED Operation failed
372 * @retval #CONNECTION_ERROR_NOT_SUPPORTED  Not supported
373 * @retval #CONNECTION_ERROR_PERMISSION_DENIED Permission Denied
374 */
375 int connection_get_ethernet_cable_state(connection_h connection, connection_ethernet_cable_state_e *state);
376
377 /**
378  * @brief Called when ethernet cable is plugged [in/out].
379  * @since_tizen 2.4
380  * @param[in] state The ethernet cable state (connection_ethernet_cable_state_e)
381  * @param[in] user_data The user data passed to callback registration function
382  */
383 typedef void(*connection_ethernet_cable_state_chaged_cb)(
384                         connection_ethernet_cable_state_e state, void* user_data);
385
386 /**
387  * @brief Registers callback for ethernet cable is plugged [in/out] event.
388  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0
389  * @param[in] callback  The callback function to be called
390  * @param[in] user_data The user data passed to the callback function
391  * @return 0 on success, otherwise negative error value
392  * @retval #CONNECTION_ERROR_NONE   Successful
393  * @retval #CONNECTION_ERROR_INVALID_PARAMETER   Invalid parameter
394  * @retval #CONNECTION_ERROR_OPERATION_FAILED   Operation failed
395  * @retval #CONNECTION_ERROR_NOT_SUPPORTED  Not supported
396  */
397 int connection_set_ethernet_cable_state_chaged_cb( connection_h connection,
398                 connection_ethernet_cable_state_chaged_cb callback, void *user_data);
399
400 /**
401  * @brief Unregisters callback for ethernet cable is plugged [in/out] event.
402  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0
403  * @param[in] connection  The handle of connection
404  * @return 0 on success, otherwise negative error value
405  * @retval #CONNECTION_ERROR_NONE  Successful
406  * @retval #CONNECTION_ERROR_INVALID_PARAMETER   Invalid parameter
407  * @retval #CONNECTION_ERROR_OPERATION_FAILED  Operation failed
408  * @retval #CONNECTION_ERROR_NOT_SUPPORTED  Not supported
409  */
410 int connection_unset_ethernet_cable_state_chaged_cb(connection_h connection);
411
412 /**
413  * @brief Gets the state of the Bluetooth.
414  * @details The returned state is for the Bluetooth connection state.
415  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
416  * @privlevel public
417  * @privilege %http://tizen.org/privilege/network.get
418  * @param[in] connection  The connection handle
419  * @param[out] state  The state of the Bluetooth connection
420  * @return @c 0 on success, otherwise a negative error value
421  * @retval #CONNECTION_ERROR_NONE  Successful
422  * @retval #CONNECTION_ERROR_INVALID_PARAMETER   Invalid parameter
423  * @retval #CONNECTION_ERROR_OPERATION_FAILED  Operation failed
424  * @retval #CONNECTION_ERROR_PERMISSION_DENIED Permission Denied
425  * @retval #CONNECTION_ERROR_NOT_SUPPORTED      Not supported
426  */
427 int connection_get_bt_state(connection_h connection, connection_bt_state_e* state);
428
429 /**
430  * @brief Registers the callback that is called when the type of the current connection is changed.
431  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
432  * @param[in] connection  The connection handle
433  * @param[in] callback  The callback function to be called
434  * @param[in] user_data The user data passed to the callback function
435  * @return @c 0 on success, otherwise a negative error value
436  * @retval #CONNECTION_ERROR_NONE  Successful
437  * @retval #CONNECTION_ERROR_INVALID_PARAMETER   Invalid parameter
438  * @retval #CONNECTION_ERROR_OPERATION_FAILED  Operation failed
439  */
440 int connection_set_type_changed_cb(connection_h connection, connection_type_changed_cb callback, void* user_data);
441
442 /**
443  * @brief Unregisters the callback that is called when the type of current connection is changed.
444  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
445  * @param[in] connection  The connection handle
446  * @return @c 0 on success, otherwise a negative error value
447  * @retval #CONNECTION_ERROR_NONE  Successful
448  * @retval #CONNECTION_ERROR_INVALID_PARAMETER   Invalid parameter
449  * @retval #CONNECTION_ERROR_OPERATION_FAILED  Operation failed
450  */
451 int connection_unset_type_changed_cb(connection_h connection);
452
453 /**
454  * @brief Registers the callback that is called when the IP address is changed.
455  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
456  * @param[in] connection  The connection handle
457  * @param[in] callback  The callback function to be called
458  * @param[in] user_data The user data passed to the callback function
459  * @return @c 0 on success, otherwise a negative error value
460  * @retval #CONNECTION_ERROR_NONE  Successful
461  * @retval #CONNECTION_ERROR_INVALID_PARAMETER   Invalid parameter
462  * @retval #CONNECTION_ERROR_OPERATION_FAILED  Operation failed
463  */
464 int connection_set_ip_address_changed_cb(connection_h connection, connection_address_changed_cb callback, void* user_data);
465
466 /**
467  * @brief Unregisters the callback that is called when the IP address is changed.
468  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
469  * @param[in] connection  The connection handle
470  * @return @c 0 on success, otherwise a negative error value
471  * @retval #CONNECTION_ERROR_NONE  Successful
472  * @retval #CONNECTION_ERROR_INVALID_PARAMETER   Invalid parameter
473  * @retval #CONNECTION_ERROR_OPERATION_FAILED  Operation failed
474  */
475 int connection_unset_ip_address_changed_cb(connection_h connection);
476
477 /**
478  * @brief Registers the callback that is called when the proxy address is changed.
479  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
480  * @param[in] connection  The connection handle
481  * @param[in] callback  The callback function to be called
482  * @param[in] user_data The user data passed to the callback function
483  * @return @c 0 on success, otherwise a negative error value
484  * @retval #CONNECTION_ERROR_NONE  Successful
485  * @retval #CONNECTION_ERROR_INVALID_PARAMETER   Invalid parameter
486  * @retval #CONNECTION_ERROR_OPERATION_FAILED  Operation failed
487  */
488 int connection_set_proxy_address_changed_cb(connection_h connection, connection_address_changed_cb callback, void* user_data);
489
490 /**
491  * @brief Unregisters the callback that is called when the proxy address is changed.
492  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
493  * @param[in] connection  The connection handle
494  * @return @c 0 on success, otherwise a negative error value
495  * @retval #CONNECTION_ERROR_NONE  Successful
496  * @retval #CONNECTION_ERROR_INVALID_PARAMETER   Invalid parameter
497  * @retval #CONNECTION_ERROR_OPERATION_FAILED  Operation failed
498  */
499 int connection_unset_proxy_address_changed_cb(connection_h connection);
500
501 /**
502  * @brief Adds a new profile which is created by connection_profile_create().
503  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
504  * @privlevel public
505  * @privilege %http://tizen.org/privilege/network.profile
506  * @remarks You can only add a profile of the cellular type.
507  * @param[in] connection  The connection handle
508  * @param[in] profile  The profile handle
509  * @return @c 0 on success, otherwise a negative error value
510  * @retval #CONNECTION_ERROR_NONE  Successful
511  * @retval #CONNECTION_ERROR_INVALID_PARAMETER   Invalid parameter
512  * @retval #CONNECTION_ERROR_OPERATION_FAILED  Operation failed
513  * @retval #CONNECTION_ERROR_PERMISSION_DENIED Permission Denied
514  * @retval #CONNECTION_ERROR_NOT_SUPPORTED      Not Supported
515  */
516 int connection_add_profile(connection_h connection, connection_profile_h profile);
517
518 /**
519  * @brief Removes an existing profile.
520  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
521  * @privlevel public
522  * @privilege %http://tizen.org/privilege/network.profile \n
523  *            %http://tizen.org/privilege/network.get
524  * @remarks This API needs both privileges.
525  * @param[in] connection  The connection handle
526  * @param[in] profile  The profile handle
527  * @return @c 0 on success, otherwise a negative error value
528  * @retval #CONNECTION_ERROR_NONE  Successful
529  * @retval #CONNECTION_ERROR_INVALID_PARAMETER   Invalid parameter
530  * @retval #CONNECTION_ERROR_OPERATION_FAILED  Operation failed
531  * @retval #CONNECTION_ERROR_PERMISSION_DENIED Permission Denied
532  * @retval #CONNECTION_ERROR_NOT_SUPPORTED      Not Supported
533  */
534 int connection_remove_profile(connection_h connection, connection_profile_h profile);
535
536 /**
537  * @brief Updates an existing profile.
538  * @details When a profile is changed, these changes will be not applied to the Connection Manager immediately.
539  * When you call this function, your changes affect the Connection Manager and the existing profile is updated.
540  * In addition, the existing profile will be updated if you call connection_open_profile().
541  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
542  * @privlevel public
543  * @privilege %http://tizen.org/privilege/network.profile \n
544  *            %http://tizen.org/privilege/network.get
545  * @remarks This API needs both privileges.
546  * @param[in] connection  The connection handle
547  * @param[in] profile  The profile handle
548  * @return @c 0 on success, otherwise a negative error value
549  * @retval #CONNECTION_ERROR_NONE  Successful
550  * @retval #CONNECTION_ERROR_INVALID_PARAMETER   Invalid parameter
551  * @retval #CONNECTION_ERROR_OPERATION_FAILED  Operation failed
552  * @retval #CONNECTION_ERROR_PERMISSION_DENIED Permission Denied
553  * @retval #CONNECTION_ERROR_NOT_SUPPORTED      Not Supported
554  * @see connection_open_profile()
555  */
556 int connection_update_profile(connection_h connection, connection_profile_h profile);
557
558 /**
559  * @brief Gets a profiles iterator.
560  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
561  * @privlevel public
562  * @privilege %http://tizen.org/privilege/network.get
563  * @remarks You must release @a profile_iterator using connection_destroy().
564  * @param[in] connection  The connection handle
565  * @param[in] type  The type of the connetion iterator
566  * @param[out] profile_iterator  The iterator of profile
567  * @return @c 0 on success, otherwise a negative error value
568  * @retval #CONNECTION_ERROR_NONE  Successful
569  * @retval #CONNECTION_ERROR_INVALID_PARAMETER   Invalid parameter
570  * @retval #CONNECTION_ERROR_OUT_OF_MEMORY  Out of memory
571  * @retval #CONNECTION_ERROR_OPERATION_FAILED  Operation failed
572  * @retval #CONNECTION_ERROR_PERMISSION_DENIED Permission Denied
573  */
574 int connection_get_profile_iterator(connection_h connection, connection_iterator_type_e type, connection_profile_iterator_h* profile_iterator);
575
576 /**
577  * @brief Moves the profile iterator to the next position and gets a profile handle.
578  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
579  * @param[in] profile_iterator  The iterator of profile
580  * @param[out] profile  The profile handle
581  * @return @c 0 on success, otherwise a negative error value
582  * @retval #CONNECTION_ERROR_NONE  Successful
583  * @retval #CONNECTION_ERROR_INVALID_PARAMETER   Invalid parameter
584  * @retval #CONNECTION_ERROR_ITERATOR_END  End of iteration
585  */
586 int connection_profile_iterator_next(connection_profile_iterator_h profile_iterator, connection_profile_h* profile);
587
588 /**
589  * @brief Checks whether the next element of a profile iterator exists or not.
590  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
591  * @remarks The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
592  * @param[in] profile_iterator  The iterator of profile
593  * @return @c true if next element exists, otherwise @c false if next element doesn't exist
594  */
595 bool connection_profile_iterator_has_next(connection_profile_iterator_h profile_iterator);
596
597 /**
598  * @brief Destroys a profiles iterator.
599  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
600  * @param[in] profile_iterator  The iterator of the profile
601  * @return @c 0 on success, otherwise a negative error value
602  * @retval #CONNECTION_ERROR_NONE  Successful
603  * @retval #CONNECTION_ERROR_INVALID_PARAMETER   Invalid parameter
604  */
605 int connection_destroy_profile_iterator(connection_profile_iterator_h profile_iterator);
606
607 /**
608  * @brief Gets the name of the default profile.
609  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
610  * @privlevel public
611  * @privilege %http://tizen.org/privilege/network.get
612  * @remarks You must release @a profile using connection_profile_destroy().
613  * @param[in] connection  The connection handle
614  * @param[out] profile  The profile handle
615  * @return @c 0 on success, otherwise a negative error value
616  * @retval #CONNECTION_ERROR_NONE  Successful
617  * @retval #CONNECTION_ERROR_INVALID_PARAMETER   Invalid parameter
618  * @retval #CONNECTION_ERROR_OUT_OF_MEMORY  Out of memory
619  * @retval #CONNECTION_ERROR_OPERATION_FAILED  Operation failed
620  * @retval #CONNECTION_ERROR_NO_CONNECTION  There is no connection
621  * @retval #CONNECTION_ERROR_PERMISSION_DENIED Permission Denied
622  */
623 int connection_get_current_profile(connection_h connection, connection_profile_h* profile);
624
625 /**
626  * @brief Gets the default profile which provides the given cellular service.
627  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
628  * @privlevel public
629  * @privilege %http://tizen.org/privilege/network.get
630  * @remarks You must release @a profile using connection_profile_destroy().
631  * @param[in] connection  The connection handle
632  * @param[in] type  The type of cellular service \n
633  *                 #CONNECTION_CELLULAR_SERVICE_TYPE_APPLICATION is not permitted.
634  * @param[out] profile  The profile handle
635  * @return @c 0 on success, otherwise a negative error value
636  * @retval #CONNECTION_ERROR_NONE  Successful
637  * @retval #CONNECTION_ERROR_INVALID_PARAMETER   Invalid parameter
638  * @retval #CONNECTION_ERROR_OUT_OF_MEMORY  Out of memory
639  * @retval #CONNECTION_ERROR_OPERATION_FAILED  Operation failed
640  * @retval #CONNECTION_ERROR_PERMISSION_DENIED Permission Denieda
641  * @retval #CONNECTION_ERROR_NOT_SUPPORTED      Not Supported
642  */
643 int connection_get_default_cellular_service_profile(connection_h connection, connection_cellular_service_type_e type, connection_profile_h* profile);
644
645 /**
646  * @brief Sets the default profile which provides the given cellular service.
647  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
648  * @privlevel public
649  * @privilege %http://tizen.org/privilege/network.profile \n
650  *            %http://tizen.org/privilege/network.get
651  * @remarks This API needs both privileges.
652  * @param[in] connection  The connection handle
653  * @param[in] type  The type of cellular service \n
654  *                 only #CONNECTION_CELLULAR_SERVICE_TYPE_INTERNET and #CONNECTION_CELLULAR_SERVICE_TYPE_PREPAID_INTERNET are permitted.
655  * @param[in] profile  The profile handle
656  * @return @c 0 on success, otherwise a negative error value
657  * @retval #CONNECTION_ERROR_NONE  Successful
658  * @retval #CONNECTION_ERROR_INVALID_PARAMETER   Invalid parameter
659  * @retval #CONNECTION_ERROR_OPERATION_FAILED  Operation failed
660  * @retval #CONNECTION_ERROR_PERMISSION_DENIED Permission Denied
661  * @retval #CONNECTION_ERROR_NOT_SUPPORTED      Not Supported
662  */
663 int connection_set_default_cellular_service_profile(connection_h connection, connection_cellular_service_type_e type, connection_profile_h profile);
664
665 /**
666  * @brief Sets the default profile which provides the given cellular service, asynchronously.
667  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
668  * @privlevel public
669  * @privilege %http://tizen.org/privilege/network.profile \n
670  *            %http://tizen.org/privilege/network.get
671  * @remarks This API needs both privileges.
672  * @param[in] connection  The connection handle
673  * @param[in] type  The type of cellular service (only #CONNECTION_CELLULAR_SERVICE_TYPE_INTERNET and #CONNECTION_CELLULAR_SERVICE_TYPE_PREPAID_INTERNET are permitted)
674  * @param[in] profile  The profile handle
675  * @param[in] callback  The callback function to be called
676  * @param[in] user_data The user data passed to the callback function
677  * @return @c 0 on success, otherwise negative error value
678  * @retval #CONNECTION_ERROR_NONE  Successful
679  * @retval #CONNECTION_ERROR_INVALID_PARAMETER   Invalid parameter
680  * @retval #CONNECTION_ERROR_OPERATION_FAILED  Operation failed
681  * @retval #CONNECTION_ERROR_PERMISSION_DENIED Permission Denied
682  * @retval #CONNECTION_ERROR_NOT_SUPPORTED      Not Supported
683  */
684 int connection_set_default_cellular_service_profile_async(connection_h connection,
685                 connection_cellular_service_type_e type, connection_profile_h profile, connection_set_default_cb callback, void* user_data);
686
687 /**
688  * @brief Called after connection_open_profile() is finished.
689  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
690  * @param[in] result  The result
691  * @param[in] user_data The user data passed from connection_open_profile()
692  * @pre connection_open_profile() will invoke this callback function.
693  * @see connection_open_profile()
694 */
695 typedef void(*connection_opened_cb)(connection_error_e result, void* user_data);
696
697 /**
698  * @brief Called after connection_close_profile() is finished.
699  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
700  * @param[in] result  The result
701  * @param[in] user_data The user data passed from connection_close_profile()
702  * @pre connection_close_profile() will invoke this callback function.
703  * @see connection_close_profile()
704 */
705 typedef void(*connection_closed_cb)(connection_error_e result, void* user_data);
706
707 /**
708  * @brief Called after connection_reset_profile() is finished.
709  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
710  * @param[in] result  The result
711  * @param[in] user_data The user data passed from connection_reset_profile()
712  * @pre connection_reset_profile() will invoke this callback function.
713  * @see connection_reset_profile()
714 */
715 typedef void(*connection_reset_cb)(connection_error_e result, void* user_data);
716
717 /**
718  * @brief Opens a connection of profile, asynchronously.
719  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
720  * @privlevel public
721  * @privilege %http://tizen.org/privilege/network.set \n
722  *            %http://tizen.org/privilege/network.get
723  * @remarks This API needs both privileges.
724  * @param[in] connection  The connection handle
725  * @param[in] profile  The profile handle
726  * @param[in] callback  The callback function to be called
727  * @param[in] user_data The user data passed to the callback function
728  * @return @c 0 on success, otherwise negative error value
729  * @retval #CONNECTION_ERROR_NONE  Successful
730  * @retval #CONNECTION_ERROR_INVALID_PARAMETER   Invalid parameter
731  * @retval #CONNECTION_ERROR_OPERATION_FAILED  Operation failed
732  * @retval #CONNECTION_ERROR_PERMISSION_DENIED Permission Denied
733  * @post connection_opened_cb() will be invoked.
734  * @see connection_opened_cb()
735  * @see connection_close_profile()
736  * @see connection_profile_set_state_changed_cb()
737  * @see connection_profile_unset_state_changed_cb()
738  * @see connection_profile_state_changed_cb()
739  */
740 int connection_open_profile(connection_h connection, connection_profile_h profile, connection_opened_cb callback, void* user_data);
741
742 /**
743  * @brief Closes a connection of profile.
744  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
745  * @privlevel public
746  * @privilege %http://tizen.org/privilege/network.set
747  * @param[in] connection  The connection handle
748  * @param[in] profile  The profile handle
749  * @param[in] callback  The callback function to be called
750  * @param[in] user_data The user data passed to the callback function
751  * @return @c 0 on success, otherwise negative error value
752  * @retval #CONNECTION_ERROR_NONE  Successful
753  * @retval #CONNECTION_ERROR_INVALID_PARAMETER   Invalid parameter
754  * @retval #CONNECTION_ERROR_OPERATION_FAILED  Operation failed
755  * @retval #CONNECTION_ERROR_PERMISSION_DENIED Permission Denied
756  * @post connection_closed_cb() will be invoked.
757  * @see connection_closed_cb()
758  * @see connection_open_profile()
759  * @see connection_profile_set_state_changed_cb()
760  * @see connection_profile_unset_state_changed_cb()
761  * @see connection_profile_state_changed_cb()
762  */
763 int connection_close_profile(connection_h connection, connection_profile_h profile, connection_closed_cb callback, void* user_data);
764
765 /**
766  * @brief Resets the cellular profile.
767  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
768  * @privlevel public
769  * @privilege %http://tizen.org/privilege/network.profile \n
770  *            %http://tizen.org/privilege/network.get
771  * @remarks This API needs both privileges.
772  * @param[in] connection  The connection handle
773  * @param[in] type  The type of reset
774  * @param[in] id  The subscriber identity module id to reset (The sim index starts from 0.)
775  * @param[in] callback  The callback function to be called
776  * @param[in] user_data The user data passed to the callback function
777  * @return 0 on success, otherwise negative error value
778  * @retval #CONNECTION_ERROR_NONE Successful
779  * @retval #CONNECTION_ERROR_INVALID_PARAMETER   Invalid parameter
780  * @retval #CONNECTION_ERROR_OPERATION_FAILED  Operation failed
781  * @retval #CONNECTION_ERROR_PERMISSION_DENIED Permission Denied
782  * @retval #CONNECTION_ERROR_NOT_SUPPORTED      Not Supported
783  * @post connection_reset_cb() will be invoked.
784 */
785 int connection_reset_profile(connection_h connection, connection_reset_option_e type, int id, connection_reset_cb callback, void *user_data);
786
787 /**
788  * @brief Adds a IPv4 route to the routing table.
789  * @details You can get the @a interface_name from connection_profile_get_network_interface_name() of opened profile.
790  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
791  * @privlevel public
792  * @privilege %http://tizen.org/privilege/network.set
793  * @param[in] connection  The connection handle
794  * @param[in] interface_name  The name of network interface
795  * @param[in] host_address  The IP address of the host
796  * @return @c 0 on success, otherwise negative error value
797  * @retval #CONNECTION_ERROR_NONE  Successful
798  * @retval #CONNECTION_ERROR_INVALID_PARAMETER   Invalid parameter
799  * @retval #CONNECTION_ERROR_ALREADY_EXISTS  Already exists
800  * @retval #CONNECTION_ERROR_OPERATION_FAILED  Operation failed
801  * @retval #CONNECTION_ERROR_PERMISSION_DENIED Permission Denied
802  * @see connection_profile_get_network_interface_name()
803  */
804 int connection_add_route(connection_h connection, const char* interface_name, const char* host_address);
805
806 /**
807  * @brief Removes a IPv4 route from the routing table.
808  * @details You can get the @a interface_name from connection_profile_get_network_interface_name() of opened profile.
809  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
810  * @privlevel public
811  * @privilege %http://tizen.org/privilege/network.set
812  * @param[in] connection  The connection handle
813  * @param[in] interface_name  The name of network interface
814  * @param[in] host_address  The IP address of the host
815  * @return @c 0 on success, otherwise negative error value
816  * @retval #CONNECTION_ERROR_NONE  Successful
817  * @retval #CONNECTION_ERROR_INVALID_PARAMETER   Invalid parameter
818  * @retval #CONNECTION_ERROR_OPERATION_FAILED  Operation failed
819  * @retval #CONNECTION_ERROR_PERMISSION_DENIED Permission Denied
820  * @see connection_profile_get_network_interface_name()
821  */
822 int connection_remove_route(connection_h connection, const char* interface_name, const char* host_address);
823
824 /**
825  * @brief Adds a IPv6 route to the routing table.
826  * @details You can get the @a interface_name from connection_profile_get_network_interface_name() of opened profile.
827  * @since_tizen 2.3.1
828  * @privlevel public
829  * @privilege %http://tizen.org/privilege/network.set
830  * @param[in] connection  The connection handle
831  * @param[in] interface_name  The name of network interface
832  * @param[in] host_address  The IP address of the host
833  * @param[in] gateway  The gateway address
834  * @return @c 0 on success, otherwise negative error value
835  * @retval #CONNECTION_ERROR_NONE  Successful
836  * @retval #CONNECTION_ERROR_INVALID_PARAMETER   Invalid parameter
837  * @retval #CONNECTION_ERROR_ALREADY_EXISTS  Already exists
838  * @retval #CONNECTION_ERROR_OPERATION_FAILED  Operation failed
839  * @retval #CONNECTION_ERROR_PERMISSION_DENIED Permission Denied
840  * @see connection_profile_get_network_interface_name()
841  */
842 int connection_add_route_ipv6(connection_h connection, const char *interface_name, const char *host_address, const char * gateway);
843
844 /**
845  * @brief Removes a IPV6 route from the routing table.
846  * @details You can get the @a interface_name from connection_profile_get_network_interface_name() of opened profile.
847  * @since_tizen 2.3.1
848  * @privlevel public
849  * @privilege %http://tizen.org/privilege/network.set
850  * @param[in] connection  The connection handle
851  * @param[in] interface_name  The name of network interface
852  * @param[in] host_address  The IP address of the host
853  * @param[in] gateway  The gateway address
854  * @return @c 0 on success, otherwise negative error value
855  * @retval #CONNECTION_ERROR_NONE  Successful
856  * @retval #CONNECTION_ERROR_INVALID_PARAMETER   Invalid parameter
857  * @retval #CONNECTION_ERROR_OPERATION_FAILED  Operation failed
858  * @retval #CONNECTION_ERROR_PERMISSION_DENIED Permission Denied
859  * @see connection_profile_get_network_interface_name()
860  */
861 int connection_remove_route_ipv6(connection_h connection, const char *interface_name, const char *host_address, const char * gateway);
862
863 /**
864  * @}
865 */
866
867 /**
868  * @addtogroup CAPI_NETWORK_CONNECTION_STATISTICS_MODULE
869  * @{
870 */
871
872 /**
873  * @brief Gets the statistics information.
874  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
875  * @privlevel public
876  * @privilege %http://tizen.org/privilege/network.get
877  * @param[in] connection  The connection handle
878  * @param[in] connection_type  The type of connection (only CONNECTION_TYPE_WIFI and CONNECTION_TYPE_CELLULAR are supported)
879  * @param[in] statistics_type  The type of statistics
880  * @param[out] size  The received data size of the last cellular packet data connection (bytes)
881  * @return @c 0 on success, otherwise negative error value
882  * @retval #CONNECTION_ERROR_NONE  Successful
883  * @retval #CONNECTION_ERROR_INVALID_PARAMETER  Invalid parameter
884  * @retval #CONNECTION_ERROR_OPERATION_FAILED  Operation failed
885  * @retval #CONNECTION_ERROR_NOT_SUPPORTED      Not Supported
886  */
887 int connection_get_statistics(connection_h connection, connection_type_e connection_type, connection_statistics_type_e statistics_type, long long* size);
888
889 /**
890  * @brief Resets the statistics information.
891  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
892  * @privlevel public
893  * @privilege %http://tizen.org/privilege/network.set
894  * @remarks This API needs both privileges.
895  * @param[in] connection  The connection handle
896  * @param[in] connection_type  The type of connection (only CONNECTION_TYPE_WIFI and CONNECTION_TYPE_CELLULAR are supported)
897  * @param[in] statistics_type  The type of statistics
898  * @return @c 0 on success, otherwise negative error value
899  * @retval #CONNECTION_ERROR_NONE Successful
900  * @retval #CONNECTION_ERROR_INVALID_PARAMETER   Invalid parameter
901  * @retval #CONNECTION_ERROR_OPERATION_FAILED  Operation failed
902  * @retval #CONNECTION_ERROR_PERMISSION_DENIED Permission Denied
903  * @retval #CONNECTION_ERROR_NOT_SUPPORTED      Not Supported
904  */
905 int connection_reset_statistics(connection_h connection, connection_type_e connection_type, connection_statistics_type_e statistics_type);
906
907 /**
908  * @}
909 */
910
911 #ifdef __cplusplus
912 }
913 #endif /* __cplusplus */
914
915 #endif