doc/net_connection_doc.h

   1 /*
   2  * Copyright (c) 2011 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
  18 #ifndef __TIZEN_NETWORK_CONNECTION_DOC_H__
  19 #define __TIZEN_NETWORK_CONNECTION_DOC_H__
  20
  21 /**
  22  * @defgroup CAPI_NETWORK_CONNECTION_MODULE Connection
  23  * @brief The Connection API provides functions for managing modem data connections.
  24  * @ingroup CAPI_NETWORK_FRAMEWORK
  25  *
  26  * @section CAPI_NETWORK_CONNECTION_MODULE_HEADER Required Header
  27  *   \#include <net_connection.h>
  28  *
  29  * @section CAPI_NETWORK_CONNECTION_MODULE_OVERVIEW Overview
  30  * The Connection API provides functions used to create a network connection and to perform other operations on the
  31  * connection. With these functions, the application can get details such as the IP address, proxy information, gateway information, and connection
  32  * statistics.
  33  *
  34  */
  35
  36 /**
  37  * @defgroup CAPI_NETWORK_CONNECTION_MANAGER_MODULE Connection Manager
  38  * @brief The Connection Manager API provides functions for managing data connections.
  39  * @ingroup CAPI_NETWORK_CONNECTION_MODULE
  40  *
  41  * @section CAPI_NETWORK_CONNECTION_MANAGER_MODULE_HEADER Required Header
  42  *   \#include <net_connection.h>
  43  *
  44  * @section CAPI_NETWORK_CONNECTION_MANAGER_MODULE_OVERVIEW Overview
  45  * To use Connection Manager API, first create a connection handle using connection_create(). After that, you can obtain network information.
  46  * You should destroy the created connection handle if you do not need it anymore.
  47  * This API is related with libsoup and sockets. It allows you to create a socket on the kernel Linux stack, which can be used directly or by libsoup
  48  * or any other network library.
  49  * @section CAPI_NETWORK_CONNECTION_MANAGER_MODULE_FEATURE Related Features
  50  * This API is related with the following features:\n
  51  * - http://tizen.org/feature/network.wifi\n
  52  * - http://tizen.org/feature/network.telephony\n
  53  * - http://tizen.org/feature/network.tethering.bluetooth\n
  54  * - http://tizen.org/feature/network.net_proxy\n
  55  *
  56  * It is recommended to design feature related codes in your application for reliability.\n
  57  *
  58  * You can check if a device supports the related features for this API by using @ref CAPI_SYSTEM_SYSTEM_INFO_MODULE, thereby controlling the procedure of your application.\n
  59  *
  60  * To ensure your application is only running on the device with specific features, please define the features in your manifest file using the manifest editor in the SDK.\n
  61  *
  62  * More details on featuring your application can be found from <a href="https://developer.tizen.org/development/tools/native-tools/manifest-text-editor#feature"><b>Feature List</b>.</a>
  63  *
  64  */
  65
  66 /**
  67  * @defgroup CAPI_NETWORK_CONNECTION_PROFILE_MODULE Connection Profile
  68  * @brief The Connection Profile API provides functions for managing the connection profile.
  69  * @ingroup CAPI_NETWORK_CONNECTION_MANAGER_MODULE
  70  *
  71  * @section CAPI_NETWORK_CONNECTION_PROFILE_MODULE_HEADER Required Header
  72  *   \#include <net_connection.h>
  73  *
  74  * @section CAPI_NETWORK_CONNECTION_PROFILE_MODULE_OVERVIEW Overview
  75  * The Connection Profile provides functions for mapping connection profile.
  76  * It allows you to use a handle for dealing with a connection profile. You can get details about connection using ‘connection_profile_h’ handle.
  77  * @section CAPI_NETWORK_CONNECTION_PROFILE_MODULE_FEATURE Related Features
  78  * This API is related with the following features:\n
  79  * - http://tizen.org/feature/network.wifi\n
  80  * - http://tizen.org/feature/network.telephony\n
  81  * - http://tizen.org/feature/network.tethering.bluetooth\n
  82  *
  83  * It is recommended to design feature related codes in your application for reliability.\n
  84  *
  85  * You can check if a device supports the related features for this API by using @ref CAPI_SYSTEM_SYSTEM_INFO_MODULE, thereby controlling the procedure of your application.\n
  86  *
  87  * To ensure your application is only running on the device with specific features, please define the features in your manifest file using the manifest editor in the SDK.\n
  88  *
  89  * More details on featuring your application can be found from <a href="https://developer.tizen.org/development/tools/native-tools/manifest-text-editor#feature"><b>Feature List</b>.</a>
  90  *
  91  */
  92
  93 /**
  94  * @defgroup CAPI_NETWORK_CONNECTION_CELLULAR_PROFILE_MODULE Cellular Profile
  95  * @brief The Connection Cellular Profile API provides functions for managing the cellular profile.
  96  * @ingroup CAPI_NETWORK_CONNECTION_PROFILE_MODULE
  97  *
  98  * @section CAPI_NETWORK_CONNECTION_CELLULAR_PROFILE_MODULE_HEADER Required Header
  99  *   \#include <net_connection.h>
 100  * @section CAPI_NETWORK_CONNECTION_CELLULAR_PROFILE_MODULE_OVERVIEW Overview
 101  * The Connection Cellular Profile API provides functions for managing the cellular profile. You can manage the cellular profile using the functions.
 102  * @section CAPI_NETWORK_CONNECTION_CELLULAR_PROFILE_MODULE_FEATURE Related Features
 103  * This API is related with the following features:\n
 104  * - http://tizen.org/feature/network.telephony\n
 105  *
 106  * It is recommended to design feature related codes in your application for reliability.\n
 107  *
 108  * You can check if a device supports the related features for this API by using @ref CAPI_SYSTEM_SYSTEM_INFO_MODULE, thereby controlling the procedure of your application.\n
 109  *
 110  * To ensure your application is only running on the device with specific features, please define the features in your manifest file using the manifest editor in the SDK.\n
 111  *
 112  * More details on featuring your application can be found from <a href="https://developer.tizen.org/development/tools/native-tools/manifest-text-editor#feature"><b>Feature List</b>.</a>
 113  *
 114  */
 115
 116 /**
 117  * @defgroup CAPI_NETWORK_CONNECTION_WIFI_PROFILE_MODULE Wi-Fi Profile
 118  * @brief The Connection Wi-Fi Profile API provides functions for managing the WiFi profile.
 119  * @ingroup CAPI_NETWORK_CONNECTION_PROFILE_MODULE
 120  *
 121  * @section CAPI_NETWORK_CONNECTION_WIFI_PROFILE_MODULE_HEADER Required Header
 122  *   \#include <net_connection.h>
 123  * @section CAPI_NETWORK_CONNECTION_WIFI_PROFILE_MODULE_OVERVIEW Overview
 124  * The Connection Wi-Fi Profile API provides functions for managing the wi-fi profile. You can manage the wi-fi profile using the functions.
 125  * @section CAPI_NETWORK_CONNECTION_WIFI_PROFILE_MODULE_FEATURE Related Features
 126  * This API is related with the following features:\n
 127  * - http://tizen.org/feature/network.wifi\n
 128  *
 129  * It is recommended to design feature related codes in your application for reliability.\n
 130  *
 131  * You can check if a device supports the related features for this API by using @ref CAPI_SYSTEM_SYSTEM_INFO_MODULE, thereby controlling the procedure of your application.\n
 132  *
 133  * To ensure your application is only running on the device with specific features, please define the features in your manifest file using the manifest editor in the SDK.\n
 134  *
 135  * More details on featuring your application can be found from <a href="https://developer.tizen.org/development/tools/native-tools/manifest-text-editor#feature"><b>Feature List</b>.</a>
 136  *
 137  */
 138
 139 /**
 140  * @defgroup CAPI_NETWORK_CONNECTION_STATISTICS_MODULE Connection Statistics
 141  * @brief The Connection Statistics API provides functions for getting the statistical information.
 142  * @ingroup CAPI_NETWORK_CONNECTION_MODULE
 143  *
 144  * @section CAPI_NETWORK_CONNECTION_STATISTICS_MODULE_HEADER Required Header
 145  *   \#include <net_connection.h>
 146  *
 147  * @section CAPI_NETWORK_CONNECTION_STATISTICS_MODULE_HEADER_OVERVIEW Overview
 148  * The Connection allows you to track the data transfer information.
 149  * Use the Connection statistics to gather and reset statistics on network usage, such as the size of the sent or received data, in bytes.
 150  * It also provides methods for getting the cumulative size of packets sent or received.
 151  * @section CAPI_NETWORK_CONNECTION_STATISTICS_MODULE_FEATURE Related Features
 152  * This API is related with the following features:\n
 153  * - http://tizen.org/feature/network.wifi\n
 154  * - http://tizen.org/feature/network.telephony\n
 155  *
 156  * It is recommended to design feature related codes in your application for reliability.\n
 157  *
 158  * You can check if a device supports the related features for this API by using @ref CAPI_SYSTEM_SYSTEM_INFO_MODULE, thereby controlling the procedure of your application.\n
 159  *
 160  * To ensure your application is only running on the device with specific features, please define the features in your manifest file using the manifest editor in the SDK.\n
 161  *
 162  * More details on featuring your application can be found from <a href="https://developer.tizen.org/development/tools/native-tools/manifest-text-editor#feature"><b>Feature List</b>.</a>
 163  *
 164  */
 165
 166
 167
 168
 169 #endif /* __TIZEN_NETWORK_CONNECTION_DOC_H__ */