[connection] Added Tizen Wi-Fi Mesh

[platform/core/api/connection.git] / include / connection_profile.h

diff --git a/include/connection_profile.h b/include/connection_profile.h
index af1dd4f..5bee76d 100755 (executable)
--- a/include/connection_profile.h
+++ b/include/connection_profile.h
@@ -93,15 +93,15 @@ typedef enum {
 /**
  * @brief Enumeration for cellular pdn type.
  * @since_tizen 3.0
- * @remarks Use CONNECTION_CELLULAR_PDN_TYPE_IPV4_IPV6 instead of
+ * @remarks Use #CONNECTION_CELLULAR_PDN_TYPE_IPV4_IPV6 instead of
  *          CONNECTION_CELLULAR_PDN_TYPE_IPV4_IPv6.
  */
 typedef enum {
-       CONNECTION_CELLULAR_PDN_TYPE_UNKNOWN = 0,    /**> Unknown */
-       CONNECTION_CELLULAR_PDN_TYPE_IPV4 = 1,       /**> IPv4 */
-       CONNECTION_CELLULAR_PDN_TYPE_IPV6 = 2,       /**> IPv6 */
-       CONNECTION_CELLULAR_PDN_TYPE_IPV4_IPv6 = 3,  /**> IPv4 and IPv6 (Deprecated since 4.0)*/
-       CONNECTION_CELLULAR_PDN_TYPE_IPV4_IPV6 = 4,  /**> IPv4 and IPv6 (Since 4.0)*/
+       CONNECTION_CELLULAR_PDN_TYPE_UNKNOWN = 0,    /**< Unknown */
+       CONNECTION_CELLULAR_PDN_TYPE_IPV4 = 1,       /**< IPv4 */
+       CONNECTION_CELLULAR_PDN_TYPE_IPV6 = 2,       /**< IPv6 */
+       CONNECTION_CELLULAR_PDN_TYPE_IPV4_IPv6 = 3,  /**< IPv4 and IPv6 (Deprecated since 4.0) */
+       CONNECTION_CELLULAR_PDN_TYPE_IPV4_IPV6 = 4,  /**< IPv4 and IPv6 (Since 4.0) */
 } connection_cellular_pdn_type_e;
 
 
@@ -172,7 +172,7 @@ typedef enum {
        CONNECTION_IP_CONFIG_TYPE_STATIC  = 1,
 
        /**
-        * Config IP using DHCP client
+        * Config IP using DHCP client (IPv4 Only)
         */
        CONNECTION_IP_CONFIG_TYPE_DYNAMIC = 2,
 
@@ -182,7 +182,7 @@ typedef enum {
        CONNECTION_IP_CONFIG_TYPE_AUTO = 3,
 
        /**
-        * Indicates an IP address that can not be modified
+        * Indicates an IP address that can not be modified (IPv4 Only)
         */
        CONNECTION_IP_CONFIG_TYPE_FIXED = 4,
 
@@ -249,6 +249,7 @@ typedef enum {
  * @return @c 0 on success,
  *         otherwise negative error value
  * @retval #CONNECTION_ERROR_NONE                  Successful
+ * @retval #CONNECTION_ERROR_NOT_INITIALIZED       Not initialized
  * @retval #CONNECTION_ERROR_INVALID_PARAMETER     Invalid parameter
  * @retval #CONNECTION_ERROR_OUT_OF_MEMORY         Out of memory
  * @retval #CONNECTION_ERROR_PERMISSION_DENIED     Permission denied
@@ -267,6 +268,7 @@ int connection_profile_create(connection_profile_type_e type,
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #CONNECTION_ERROR_NONE                  Successful
+ * @retval #CONNECTION_ERROR_NOT_INITIALIZED       Not initialized
  * @retval #CONNECTION_ERROR_INVALID_PARAMETER     Invalid parameter
  * @see connection_profile_create()
 */
@@ -282,6 +284,7 @@ int connection_profile_destroy(connection_profile_h profile);
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #CONNECTION_ERROR_NONE                  Successful
+ * @retval #CONNECTION_ERROR_NOT_INITIALIZED       Not initialized
  * @retval #CONNECTION_ERROR_INVALID_PARAMETER     Invalid parameter
  * @retval #CONNECTION_ERROR_OUT_OF_MEMORY         Out of memory
  * @see connection_profile_destroy()
@@ -293,7 +296,7 @@ int connection_profile_clone(connection_profile_h *cloned_profile,
 /**
  * @brief Gets the profile ID.
  * @details The separate profiles can have the same name.
- *          So, you must use this API instead of connection_profile_get_name()
+ *          So, you must use this function instead of connection_profile_get_name()
  *          if you want to get the unique identification.
  *          In case you create a profile, this value will be determined when you add the profile.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
@@ -303,6 +306,7 @@ int connection_profile_clone(connection_profile_h *cloned_profile,
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #CONNECTION_ERROR_NONE                  Successful
+ * @retval #CONNECTION_ERROR_NOT_INITIALIZED       Not initialized
  * @retval #CONNECTION_ERROR_INVALID_PARAMETER     Invalid parameter
  * @retval #CONNECTION_ERROR_OUT_OF_MEMORY         Out of memory
  * @see connection_profile_get_name()
@@ -320,6 +324,7 @@ int connection_profile_get_id(connection_profile_h profile, char **profile_id);
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #CONNECTION_ERROR_NONE                  Successful
+ * @retval #CONNECTION_ERROR_NOT_INITIALIZED       Not initialized
  * @retval #CONNECTION_ERROR_INVALID_PARAMETER     Invalid parameter
  * @retval #CONNECTION_ERROR_OUT_OF_MEMORY         Out of memory
  * @see connection_profile_get_id()
@@ -335,6 +340,7 @@ int connection_profile_get_name(connection_profile_h profile, char **profile_nam
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #CONNECTION_ERROR_NONE                  Successful
+ * @retval #CONNECTION_ERROR_NOT_INITIALIZED       Not initialized
  * @retval #CONNECTION_ERROR_INVALID_PARAMETER     Invalid parameter
  * @retval #CONNECTION_ERROR_OPERATION_FAILED      Operation failed
 */
@@ -350,6 +356,7 @@ int connection_profile_get_type(connection_profile_h profile, connection_profile
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #CONNECTION_ERROR_NONE                  Successful
+ * @retval #CONNECTION_ERROR_NOT_INITIALIZED       Not initialized
  * @retval #CONNECTION_ERROR_INVALID_PARAMETER     Invalid parameter
  * @retval #CONNECTION_ERROR_OUT_OF_MEMORY         Out of memory
 */
@@ -368,6 +375,7 @@ int connection_profile_get_network_interface_name(connection_profile_h profile,
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #CONNECTION_ERROR_NONE                  Successful
+ * @retval #CONNECTION_ERROR_NOT_INITIALIZED       Not initialized
  * @retval #CONNECTION_ERROR_INVALID_PARAMETER     Invalid parameter
  * @retval #CONNECTION_ERROR_OPERATION_FAILED      Operation failed
  * @retval #CONNECTION_ERROR_OUT_OF_MEMORY         Out of memory
@@ -377,13 +385,14 @@ int connection_profile_refresh(connection_profile_h profile);
 
 
 /**
- * @brief Gets the network type.
+ * @brief Gets the network state.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @param[in] profile           The profile handle
  * @param[out] state            The state of the profile
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #CONNECTION_ERROR_NONE                  Successful
+ * @retval #CONNECTION_ERROR_NOT_INITIALIZED       Not initialized
  * @retval #CONNECTION_ERROR_INVALID_PARAMETER     Invalid parameter
  * @retval #CONNECTION_ERROR_OPERATION_FAILED      Operation failed
 */
@@ -400,6 +409,7 @@ int connection_profile_get_state(connection_profile_h profile,
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #CONNECTION_ERROR_NONE                  Successful
+ * @retval #CONNECTION_ERROR_NOT_INITIALIZED       Not initialized
  * @retval #CONNECTION_ERROR_INVALID_PARAMETER     Invalid parameter
  * @retval #CONNECTION_ERROR_OPERATION_FAILED      Operation failed
 */
@@ -417,6 +427,7 @@ int connection_profile_get_ip_config_type(connection_profile_h profile,
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #CONNECTION_ERROR_NONE                           Successful
+ * @retval #CONNECTION_ERROR_NOT_INITIALIZED                Not initialized
  * @retval #CONNECTION_ERROR_INVALID_PARAMETER              Invalid parameter
  * @retval #CONNECTION_ERROR_OUT_OF_MEMORY                  Out of memory
  * @retval #CONNECTION_ERROR_ADDRESS_FAMILY_NOT_SUPPORTED   Not supported address family
@@ -437,6 +448,7 @@ int connection_profile_get_ip_address(connection_profile_h profile,
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #CONNECTION_ERROR_NONE                           Successful
+ * @retval #CONNECTION_ERROR_NOT_INITIALIZED                Not initialized
  * @retval #CONNECTION_ERROR_INVALID_PARAMETER              Invalid parameter
  * @retval #CONNECTION_ERROR_OUT_OF_MEMORY                  Out of memory
  * @retval #CONNECTION_ERROR_ADDRESS_FAMILY_NOT_SUPPORTED   Not supported address family
@@ -456,6 +468,7 @@ int connection_profile_get_subnet_mask(connection_profile_h profile,
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #CONNECTION_ERROR_NONE                           Successful
+ * @retval #CONNECTION_ERROR_NOT_INITIALIZED                Not initialized
  * @retval #CONNECTION_ERROR_INVALID_PARAMETER              Invalid parameter
  * @retval #CONNECTION_ERROR_OUT_OF_MEMORY                  Out of memory
  * @retval #CONNECTION_ERROR_ADDRESS_FAMILY_NOT_SUPPORTED   Not supported address family
@@ -474,6 +487,7 @@ int connection_profile_get_gateway_address(connection_profile_h profile,
  * @param[out] dhcp_server      The DHCP Server address
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CONNECTION_ERROR_NONE                           Successful
+ * @retval #CONNECTION_ERROR_NOT_INITIALIZED                Not initialized
  * @retval #CONNECTION_ERROR_INVALID_PARAMETER              Invalid parameter
  * @retval #CONNECTION_ERROR_OUT_OF_MEMORY                  Out of memory
  * @retval #CONNECTION_ERROR_ADDRESS_FAMILY_NOT_SUPPORTED   Not supported address family
@@ -490,6 +504,7 @@ int connection_profile_get_dhcp_server_address(connection_profile_h profile,
  * @param[out] dhcp_lease_duration      The DHCP lease duration in seconds
  * @return @c 0 on success, otherwise a negative error value
  * @retval #CONNECTION_ERROR_NONE                           Successful
+ * @retval #CONNECTION_ERROR_NOT_INITIALIZED                Not initialized
  * @retval #CONNECTION_ERROR_INVALID_PARAMETER              Invalid parameter
  * @retval #CONNECTION_ERROR_ADDRESS_FAMILY_NOT_SUPPORTED   Not supported address family
  * @retval #CONNECTION_ERROR_OPERATION_FAILED               Operation failed
@@ -510,6 +525,7 @@ int connection_profile_get_dhcp_lease_duration(connection_profile_h profile,
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #CONNECTION_ERROR_NONE                           Successful
+ * @retval #CONNECTION_ERROR_NOT_INITIALIZED                Not initialized
  * @retval #CONNECTION_ERROR_INVALID_PARAMETER              Invalid parameter
  * @retval #CONNECTION_ERROR_OUT_OF_MEMORY                  Out of memory
  * @retval #CONNECTION_ERROR_ADDRESS_FAMILY_NOT_SUPPORTED   Not supported address family
@@ -527,6 +543,7 @@ int connection_profile_get_dns_address(connection_profile_h profile,
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #CONNECTION_ERROR_NONE                  Successful
+ * @retval #CONNECTION_ERROR_NOT_INITIALIZED       Not initialized
  * @retval #CONNECTION_ERROR_INVALID_PARAMETER     Invalid parameter
  * @retval #CONNECTION_ERROR_OPERATION_FAILED      Operation failed
 */
@@ -544,6 +561,7 @@ int connection_profile_get_proxy_type(connection_profile_h profile,
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #CONNECTION_ERROR_NONE                           Successful
+ * @retval #CONNECTION_ERROR_NOT_INITIALIZED                Not initialized
  * @retval #CONNECTION_ERROR_INVALID_PARAMETER              Invalid parameter
  * @retval #CONNECTION_ERROR_OUT_OF_MEMORY                  Out of memory
  * @retval #CONNECTION_ERROR_ADDRESS_FAMILY_NOT_SUPPORTED   Not supported address family
@@ -564,6 +582,7 @@ int connection_profile_get_proxy_address(connection_profile_h profile,
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #CONNECTION_ERROR_NONE                  Successful
+ * @retval #CONNECTION_ERROR_NOT_INITIALIZED       Not initialized
  * @retval #CONNECTION_ERROR_INVALID_PARAMETER     Invalid parameter
  * @retval #CONNECTION_ERROR_OPERATION_FAILED      Operation failed
 */
@@ -582,6 +601,7 @@ int connection_profile_set_ip_config_type(connection_profile_h profile,
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #CONNECTION_ERROR_NONE                           Successful
+ * @retval #CONNECTION_ERROR_NOT_INITIALIZED                Not initialized
  * @retval #CONNECTION_ERROR_INVALID_PARAMETER              Invalid parameter
  * @retval #CONNECTION_ERROR_ADDRESS_FAMILY_NOT_SUPPORTED   Not supported address family
  * @retval #CONNECTION_ERROR_OPERATION_FAILED               Operation failed
@@ -603,6 +623,7 @@ int connection_profile_set_ip_address(connection_profile_h profile,
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #CONNECTION_ERROR_NONE                           Successful
+ * @retval #CONNECTION_ERROR_NOT_INITIALIZED                Not initialized
  * @retval #CONNECTION_ERROR_INVALID_PARAMETER              Invalid parameter
  * @retval #CONNECTION_ERROR_ADDRESS_FAMILY_NOT_SUPPORTED   Not supported address family
  * @retval #CONNECTION_ERROR_OPERATION_FAILED               Operation failed
@@ -623,6 +644,7 @@ int connection_profile_set_subnet_mask(connection_profile_h profile,
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #CONNECTION_ERROR_NONE                           Successful
+ * @retval #CONNECTION_ERROR_NOT_INITIALIZED                Not initialized
  * @retval #CONNECTION_ERROR_INVALID_PARAMETER              Invalid parameter
  * @retval #CONNECTION_ERROR_ADDRESS_FAMILY_NOT_SUPPORTED   Not supported address family
  * @retval #CONNECTION_ERROR_OPERATION_FAILED               Operation failed
@@ -646,6 +668,7 @@ int connection_profile_set_gateway_address(connection_profile_h profile,
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #CONNECTION_ERROR_NONE                           Successful
+ * @retval #CONNECTION_ERROR_NOT_INITIALIZED                Not initialized
  * @retval #CONNECTION_ERROR_INVALID_PARAMETER              Invalid parameter
  * @retval #CONNECTION_ERROR_ADDRESS_FAMILY_NOT_SUPPORTED   Not supported address family
  * @retval #CONNECTION_ERROR_OPERATION_FAILED               Operation failed
@@ -665,6 +688,7 @@ int connection_profile_set_dns_address(connection_profile_h profile,
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #CONNECTION_ERROR_NONE                  Successful
+ * @retval #CONNECTION_ERROR_NOT_INITIALIZED       Not initialized
  * @retval #CONNECTION_ERROR_INVALID_PARAMETER     Invalid parameter
  * @retval #CONNECTION_ERROR_OPERATION_FAILED      Operation failed
  * @see connection_update_profile()
@@ -684,6 +708,7 @@ int connection_profile_set_proxy_type(connection_profile_h profile,
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #CONNECTION_ERROR_NONE                           Successful
+ * @retval #CONNECTION_ERROR_NOT_INITIALIZED                Not initialized
  * @retval #CONNECTION_ERROR_INVALID_PARAMETER              Invalid parameter
  * @retval #CONNECTION_ERROR_ADDRESS_FAMILY_NOT_SUPPORTED   Not supported address family
  * @retval #CONNECTION_ERROR_OPERATION_FAILED               Operation failed
@@ -706,7 +731,7 @@ typedef void(*connection_profile_state_changed_cb)(connection_profile_state_e st
 
 
 /**
- * @brief Registers the callback that is called when the state of profile is changed.
+ * @brief Sets the callback that is called when the state of profile is changed.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @param[in] profile           The profile handle
  * @param[in] callback          The callback function to be called
@@ -714,6 +739,7 @@ typedef void(*connection_profile_state_changed_cb)(connection_profile_state_e st
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #CONNECTION_ERROR_NONE                  Successful
+ * @retval #CONNECTION_ERROR_NOT_INITIALIZED       Not initialized
  * @retval #CONNECTION_ERROR_INVALID_PARAMETER     Invalid parameter
  * @retval #CONNECTION_ERROR_OPERATION_FAILED      Operation failed
  * @post connection_opened_cb() is invoked when the state of profile is changed.
@@ -725,12 +751,13 @@ int connection_profile_set_state_changed_cb(connection_profile_h profile,
 
 
 /**
- * @brief Unregisters the callback that is called when the state of profile is changed.
+ * @brief Unsets the callback that is called when the state of profile is changed.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @param[in] profile           The profile handle
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #CONNECTION_ERROR_NONE                  Successful
+ * @retval #CONNECTION_ERROR_NOT_INITIALIZED       Not initialized
  * @retval #CONNECTION_ERROR_INVALID_PARAMETER     Invalid parameter
  * @see connection_profile_state_changed_cb()
  * @see connection_profile_set_state_changed_cb()
@@ -744,6 +771,7 @@ int connection_profile_unset_state_changed_cb(connection_profile_h profile);
  * @param[out] state            The profile state
  * @return 0 on success, otherwise negative error value
  * @retval #CONNECTION_ERROR_NONE                  Successful
+ * @retval #CONNECTION_ERROR_NOT_INITIALIZED       Not initialized
  * @retval #CONNECTION_ERROR_INVALID_PARAMETER     Invalid parameter
  * @retval #CONNECTION_ERROR_OPERATION_FAILED      Operation failed
  * @retval #CONNECTION_ERROR_NOT_SUPPORTED         Not supported
@@ -759,6 +787,7 @@ int connection_profile_get_ipv6_state(connection_profile_h profile,
  * @param[in] type            The DNS config type
  * @return 0 on success, otherwise negative error value
  * @retval #CONNECTION_ERROR_NONE               Successful
+ * @retval #CONNECTION_ERROR_NOT_INITIALIZED    Not initialized
  * @retval #CONNECTION_ERROR_INVALID_PARAMETER  Invalid parameter
  * @retval #CONNECTION_ERROR_OPERATION_FAILED   Operation failed
  * @retval #CONNECTION_ERROR_NOT_SUPPORTED      Not supported
@@ -774,6 +803,7 @@ int connection_profile_set_dns_config_type(connection_profile_h profile,
  * @param[out] type           The DNS config type
  * @return 0 on success, otherwise negative error value
  * @retval #CONNECTION_ERROR_NONE               Successful
+ * @retval #CONNECTION_ERROR_NOT_INITIALIZED    Not initialized
  * @retval #CONNECTION_ERROR_INVALID_PARAMETER  Invalid parameter
  * @retval #CONNECTION_ERROR_OPERATION_FAILED   Operation failed
  * @retval #CONNECTION_ERROR_NOT_SUPPORTED      Not supported
@@ -791,6 +821,7 @@ int connection_profile_get_dns_config_type(connection_profile_h profile,
  *                            (also called a prefix, e.g. 8, 16, 24, 32)
  * @return 0 on success, otherwise negative error value.
  * @retval #CONNECTION_ERROR_NONE               Successful
+ * @retval #CONNECTION_ERROR_NOT_INITIALIZED    Not initialized
  * @retval #CONNECTION_ERROR_INVALID_PARAMETER  Invalid parameter
  * @retval #CONNECTION_ERROR_OPERATION_FAILED   Operation failed
  * @retval #CONNECTION_ERROR_NOT_SUPPORTED      Not supported
@@ -808,6 +839,7 @@ int connection_profile_get_prefix_length(connection_profile_h profile,
  *                            (also called a prefix, e.g. 8, 16, 24, 32)
  * @return 0 on success, otherwise negative error value
  * @retval #CONNECTION_ERROR_NONE               Successful
+ * @retval #CONNECTION_ERROR_NOT_INITIALIZED    Not initialized
  * @retval #CONNECTION_ERROR_INVALID_PARAMETER  Invalid parameter
  * @retval #CONNECTION_ERROR_OPERATION_FAILED   Operation failed
  * @retval #CONNECTION_ERROR_NOT_SUPPORTED      Not supported
@@ -836,6 +868,7 @@ int connection_profile_set_prefix_length(connection_profile_h profile,
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #CONNECTION_ERROR_NONE               Successful
+ * @retval #CONNECTION_ERROR_NOT_INITIALIZED    Not initialized
  * @retval #CONNECTION_ERROR_INVALID_PARAMETER  Invalid parameter
  * @retval #CONNECTION_ERROR_OUT_OF_MEMORY      Out of memory
  * @retval #CONNECTION_ERROR_NOT_SUPPORTED      Not supported
@@ -852,6 +885,7 @@ int connection_profile_get_wifi_essid(connection_profile_h profile, char **essid
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #CONNECTION_ERROR_NONE               Successful
+ * @retval #CONNECTION_ERROR_NOT_INITIALIZED    Not initialized
  * @retval #CONNECTION_ERROR_INVALID_PARAMETER  Invalid parameter
  * @retval #CONNECTION_ERROR_OUT_OF_MEMORY      Out of memory
  * @retval #CONNECTION_ERROR_NOT_SUPPORTED      Not supported
@@ -867,6 +901,7 @@ int connection_profile_get_wifi_bssid(connection_profile_h profile, char **bssid
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #CONNECTION_ERROR_NONE               Successful
+ * @retval #CONNECTION_ERROR_NOT_INITIALIZED    Not initialized
  * @retval #CONNECTION_ERROR_INVALID_PARAMETER  Invalid parameter
  * @retval #CONNECTION_ERROR_NOT_SUPPORTED      Not supported
 */
@@ -881,6 +916,7 @@ int connection_profile_get_wifi_rssi(connection_profile_h profile, int *rssi);
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #CONNECTION_ERROR_NONE               Successful
+ * @retval #CONNECTION_ERROR_NOT_INITIALIZED    Not initialized
  * @retval #CONNECTION_ERROR_INVALID_PARAMETER  Invalid parameter
  * @retval #CONNECTION_ERROR_NOT_SUPPORTED      Not supported
 */
@@ -895,6 +931,7 @@ int connection_profile_get_wifi_frequency(connection_profile_h profile, int *fre
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #CONNECTION_ERROR_NONE               Successful
+ * @retval #CONNECTION_ERROR_NOT_INITIALIZED    Not initialized
  * @retval #CONNECTION_ERROR_INVALID_PARAMETER  Invalid parameter
  * @retval #CONNECTION_ERROR_NOT_SUPPORTED      Not supported
 */
@@ -902,13 +939,14 @@ int connection_profile_get_wifi_max_speed(connection_profile_h profile, int *max
 
 
 /**
- * @brief Gets the security mode of Wi-Fi.
+ * @brief Gets the security type of Wi-Fi.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @param[in] profile         The profile handle
  * @param[out] type           The type of Wi-Fi security
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #CONNECTION_ERROR_NONE               Successful
+ * @retval #CONNECTION_ERROR_NOT_INITIALIZED    Not initialized
  * @retval #CONNECTION_ERROR_INVALID_PARAMETER  Invalid parameter
  * @retval #CONNECTION_ERROR_OPERATION_FAILED   Operation failed
  * @retval #CONNECTION_ERROR_NOT_SUPPORTED      Not supported
@@ -918,13 +956,14 @@ int connection_profile_get_wifi_security_type(connection_profile_h profile,
 
 
 /**
- * @brief Gets the security mode of Wi-Fi.
+ * @brief Gets the encryption type of Wi-Fi.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @param[in] profile         The profile handle
  * @param[out] type           The type of Wi-Fi security
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #CONNECTION_ERROR_NONE               Successful
+ * @retval #CONNECTION_ERROR_NOT_INITIALIZED    Not initialized
  * @retval #CONNECTION_ERROR_INVALID_PARAMETER  Invalid parameter
  * @retval #CONNECTION_ERROR_OPERATION_FAILED   Operation failed
  * @retval #CONNECTION_ERROR_NOT_SUPPORTED      Not supported
@@ -942,9 +981,10 @@ int connection_profile_get_wifi_encryption_type(connection_profile_h profile,
  *                            otherwise @c false if a passphrase is not required
  * @return @c 0 on success,
  *         otherwise a negative error value
- * @retval #CONNECTION_ERROR_NONE Successful
- * @retval #CONNECTION_ERROR_INVALID_PARAMETER Invalid parameter
- * @retval #CONNECTION_ERROR_NOT_SUPPORTED Not supported
+ * @retval #CONNECTION_ERROR_NONE               Successful
+ * @retval #CONNECTION_ERROR_NOT_INITIALIZED    Not initialized
+ * @retval #CONNECTION_ERROR_INVALID_PARAMETER  Invalid parameter
+ * @retval #CONNECTION_ERROR_NOT_SUPPORTED      Not supported
 */
 int connection_profile_is_wifi_passphrase_required(connection_profile_h profile,
                bool *required);
@@ -959,6 +999,7 @@ int connection_profile_is_wifi_passphrase_required(connection_profile_h profile,
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #CONNECTION_ERROR_NONE               Successful
+ * @retval #CONNECTION_ERROR_NOT_INITIALIZED    Not initialized
  * @retval #CONNECTION_ERROR_INVALID_PARAMETER  Invalid parameter
  * @retval #CONNECTION_ERROR_NOT_SUPPORTED      Not supported
  * @see connection_update_profile()
@@ -977,6 +1018,7 @@ int connection_profile_set_wifi_passphrase(connection_profile_h profile,
  * @return @c 0 on success,
  *         otherwise negative error value
  * @retval #CONNECTION_ERROR_NONE               Successful
+ * @retval #CONNECTION_ERROR_NOT_INITIALIZED    Not initialized
  * @retval #CONNECTION_ERROR_INVALID_PARAMETER  Invalid parameter
  * @retval #CONNECTION_ERROR_NOT_SUPPORTED      Not supported
 */
@@ -1003,6 +1045,7 @@ int connection_profile_is_wifi_wps_supported(connection_profile_h profile,
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #CONNECTION_ERROR_NONE               Successful
+ * @retval #CONNECTION_ERROR_NOT_INITIALIZED    Not initialized
  * @retval #CONNECTION_ERROR_INVALID_PARAMETER  Invalid parameter
  * @retval #CONNECTION_ERROR_OPERATION_FAILED   Operation failed
  * @retval #CONNECTION_ERROR_NOT_SUPPORTED      Not supported
@@ -1020,6 +1063,7 @@ int connection_profile_get_cellular_service_type(connection_profile_h profile,
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #CONNECTION_ERROR_NONE               Successful
+ * @retval #CONNECTION_ERROR_NOT_INITIALIZED    Not initialized
  * @retval #CONNECTION_ERROR_INVALID_PARAMETER  Invalid parameter
  * @retval #CONNECTION_ERROR_OUT_OF_MEMORY      Out of memory
  * @retval #CONNECTION_ERROR_NOT_SUPPORTED      Not supported
@@ -1038,6 +1082,7 @@ int connection_profile_get_cellular_apn(connection_profile_h profile, char **apn
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #CONNECTION_ERROR_NONE               Successful
+ * @retval #CONNECTION_ERROR_NOT_INITIALIZED    Not initialized
  * @retval #CONNECTION_ERROR_INVALID_PARAMETER  Invalid parameter
  * @retval #CONNECTION_ERROR_OUT_OF_MEMORY      Out of memory
  * @retval #CONNECTION_ERROR_OPERATION_FAILED   Operation failed
@@ -1056,6 +1101,7 @@ int connection_profile_get_cellular_auth_info(connection_profile_h profile,
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #CONNECTION_ERROR_NONE               Successful
+ * @retval #CONNECTION_ERROR_NOT_INITIALIZED    Not initialized
  * @retval #CONNECTION_ERROR_INVALID_PARAMETER  Invalid parameter
  * @retval #CONNECTION_ERROR_OUT_OF_MEMORY      Out of memory
  * @retval #CONNECTION_ERROR_NOT_SUPPORTED      Not supported
@@ -1072,9 +1118,10 @@ int connection_profile_get_cellular_home_url(connection_profile_h profile,
  * @return @c 0 on success,
  *         otherwise negative error value
  * @retval #CONNECTION_ERROR_NONE               Successful
+ * @retval #CONNECTION_ERROR_NOT_INITIALIZED    Not initialized
  * @retval #CONNECTION_ERROR_INVALID_PARAMETER  Invalid parameter
  * @retval #CONNECTION_ERROR_OPERATION_FAILED   Operation failed
- * @retval #CONNECTION_ERROR_NOT_SUPPORTED      Not suppported
+ * @retval #CONNECTION_ERROR_NOT_SUPPORTED      Not supported
 */
 int connection_profile_get_cellular_pdn_type(connection_profile_h profile,
                connection_cellular_pdn_type_e *type);
@@ -1088,6 +1135,7 @@ int connection_profile_get_cellular_pdn_type(connection_profile_h profile,
  * @return @c 0 on success,
  *         otherwise negative error value
  * @retval #CONNECTION_ERROR_NONE               Successful
+ * @retval #CONNECTION_ERROR_NOT_INITIALIZED    Not initialized
  * @retval #CONNECTION_ERROR_INVALID_PARAMETER  Invalid parameter
  * @retval #CONNECTION_ERROR_OPERATION_FAILED   Operation failed
  * @retval #CONNECTION_ERROR_NOT_SUPPORTED      Not supported
@@ -1105,6 +1153,7 @@ int connection_profile_get_cellular_roam_pdn_type(connection_profile_h profile,
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #CONNECTION_ERROR_NONE               Successful
+ * @retval #CONNECTION_ERROR_NOT_INITIALIZED    Not initialized
  * @retval #CONNECTION_ERROR_INVALID_PARAMETER  Invalid parameter
  * @retval #CONNECTION_ERROR_NOT_SUPPORTED      Not supported
 */
@@ -1121,6 +1170,7 @@ int connection_profile_is_cellular_roaming(connection_profile_h profile,
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #CONNECTION_ERROR_NONE               Successful
+ * @retval #CONNECTION_ERROR_NOT_INITIALIZED    Not initialized
  * @retval #CONNECTION_ERROR_INVALID_PARAMETER  Invalid parameter
  * @retval #CONNECTION_ERROR_NOT_SUPPORTED      Not supported
 */
@@ -1137,6 +1187,7 @@ int connection_profile_is_cellular_hidden(connection_profile_h profile,
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #CONNECTION_ERROR_NONE               Successful
+ * @retval #CONNECTION_ERROR_NOT_INITIALIZED    Not initialized
  * @retval #CONNECTION_ERROR_INVALID_PARAMETER  Invalid parameter
  * @retval #CONNECTION_ERROR_NOT_SUPPORTED      Not supported
 */
@@ -1153,6 +1204,7 @@ int connection_profile_is_cellular_editable(connection_profile_h profile,
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #CONNECTION_ERROR_NONE               Successful
+ * @retval #CONNECTION_ERROR_NOT_INITIALIZED    Not initialized
  * @retval #CONNECTION_ERROR_INVALID_PARAMETER  Invalid parameter
  * @retval #CONNECTION_ERROR_NOT_SUPPORTED      Not supported
 */
@@ -1168,6 +1220,7 @@ int connection_profile_is_cellular_default(connection_profile_h profile,
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #CONNECTION_ERROR_NONE               Successful
+ * @retval #CONNECTION_ERROR_NOT_INITIALIZED    Not initialized
  * @retval #CONNECTION_ERROR_INVALID_PARAMETER  Invalid parameter
  * @retval #CONNECTION_ERROR_NOT_SUPPORTED      Not supported
  * @see connection_update_profile()
@@ -1179,12 +1232,13 @@ int connection_profile_set_cellular_service_type(connection_profile_h profile,
 /**
  * @brief Sets the APN (Access Point Name).
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
- * @remarks You must release @a spn using free().
+ * @remarks You must release @a apn using free().
  * @param[in] profile         The profile handle
  * @param[in] apn             The name of APN
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #CONNECTION_ERROR_NONE               Successful
+ * @retval #CONNECTION_ERROR_NOT_INITIALIZED    Not initialized
  * @retval #CONNECTION_ERROR_INVALID_PARAMETER  Invalid parameter
  * @retval #CONNECTION_ERROR_NOT_SUPPORTED      Not supported
  * @see connection_update_profile()
@@ -1203,6 +1257,7 @@ int connection_profile_set_cellular_apn(connection_profile_h profile, const char
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #CONNECTION_ERROR_NONE               Successful
+ * @retval #CONNECTION_ERROR_NOT_INITIALIZED    Not initialized
  * @retval #CONNECTION_ERROR_INVALID_PARAMETER  Invalid parameter
  * @retval #CONNECTION_ERROR_NOT_SUPPORTED      Not supported
  * @see connection_update_profile()
@@ -1220,6 +1275,7 @@ int connection_profile_set_cellular_auth_info(connection_profile_h profile,
  * @return @c 0 on success,
  *         otherwise a negative error value
  * @retval #CONNECTION_ERROR_NONE               Successful
+ * @retval #CONNECTION_ERROR_NOT_INITIALIZED    Not initialized
  * @retval #CONNECTION_ERROR_INVALID_PARAMETER  Invalid parameter
  * @retval #CONNECTION_ERROR_NOT_SUPPORTED      Not supported
  * @see connection_update_profile()
@@ -1236,6 +1292,7 @@ int connection_profile_set_cellular_home_url(connection_profile_h profile,
  * @return @c 0 on success,
  *         otherwise negative error value
  * @retval #CONNECTION_ERROR_NONE               Successful
+ * @retval #CONNECTION_ERROR_NOT_INITIALIZED    Not initialized
  * @retval #CONNECTION_ERROR_INVALID_PARAMETER  Invalid parameter
  * @retval #CONNECTION_ERROR_OPERATION_FAILED   Operation failed
  * @retval #CONNECTION_ERROR_NOT_SUPPORTED      Not supported
@@ -1252,6 +1309,7 @@ int connection_profile_set_cellular_pdn_type(connection_profile_h profile,
  * @return @c 0 on success,
  *         otherwise negative error value
  * @retval #CONNECTION_ERROR_NONE               Successful
+ * @retval #CONNECTION_ERROR_NOT_INITIALIZED    Not initialized
  * @retval #CONNECTION_ERROR_INVALID_PARAMETER  Invalid parameter
  * @retval #CONNECTION_ERROR_OPERATION_FAILED   Operation failed
  * @retval #CONNECTION_ERROR_NOT_SUPPORTED      Not supported