Merge "Remove DEPRECATED connection_set_ethernet_cable_state_chaged_cb() call" into...

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

diff --git a/include/connection_profile.h b/include/connection_profile.h
index d1df149..34c216d 100755 (executable)
--- a/include/connection_profile.h
+++ b/include/connection_profile.h
@@ -48,6 +48,7 @@ typedef enum {
        CONNECTION_WIFI_SECURITY_TYPE_WPA_PSK = 2,      /**< WPA-PSK */
        CONNECTION_WIFI_SECURITY_TYPE_WPA2_PSK = 3,     /**< WPA2-PSK */
        CONNECTION_WIFI_SECURITY_TYPE_EAP = 4,          /**< EAP */
+       CONNECTION_WIFI_SECURITY_TYPE_SAE = 5,          /**< WPA3 */
 } connection_wifi_security_type_e;
 
 
@@ -83,7 +84,7 @@ typedef enum {
        CONNECTION_CELLULAR_SERVICE_TYPE_UNKNOWN = 0,          /**< Unknown */
        CONNECTION_CELLULAR_SERVICE_TYPE_INTERNET = 1,         /**< Internet */
        CONNECTION_CELLULAR_SERVICE_TYPE_MMS = 2,              /**< MMS */
-       CONNECTION_CELLULAR_SERVICE_TYPE_PREPAID_INTERNET = 3, /**< Prepaid internet */
+       CONNECTION_CELLULAR_SERVICE_TYPE_PREPAID_INTERNET = 3, /**< Prepaid Internet */
        CONNECTION_CELLULAR_SERVICE_TYPE_PREPAID_MMS = 4,      /**< Prepaid MMS */
        CONNECTION_CELLULAR_SERVICE_TYPE_TETHERING = 5,        /**< Tethering */
        CONNECTION_CELLULAR_SERVICE_TYPE_APPLICATION = 6,      /**< Specific application */
@@ -93,15 +94,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 +173,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 +183,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,
 
@@ -233,6 +234,15 @@ typedef enum {
        CONNECTION_PROFILE_TYPE_BT = 3,          /**< Bluetooth type */
 } connection_profile_type_e;
 
+/**
+ * @brief Enumeration for Internet connection state.
+ * @since_tizen 5.5
+ */
+typedef enum {
+       CONNECTION_INTERNET_STATE_OFFLINE = 0,   /**< Internet connection is unavailable */
+       CONNECTION_INTERNET_STATE_ONLINE = 1,   /**< Internet connection is available */
+} connection_internet_state_e;
+
 
 /**
  * @brief Creates a profile handle.
@@ -249,6 +259,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 +278,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 +294,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 +306,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 +316,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 +334,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 +350,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 +366,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 +385,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,19 +395,34 @@ 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
 */
 int connection_profile_get_state(connection_profile_h profile,
                connection_profile_state_e *state);
 
+/**
+ * @brief Gets the Internet connection state.
+ * @since_tizen 5.5
+ * @param[in] profile           The profile handle
+ * @param[out] state            The Internet connection 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
+*/
+int connection_profile_get_internet_state(connection_profile_h profile,
+               connection_internet_state_e *state);
 
 /**
  * @brief Gets the IP config type.
@@ -400,6 +433,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 +451,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 +472,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 +492,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 +511,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
@@ -483,6 +521,23 @@ int connection_profile_get_dhcp_server_address(connection_profile_h profile,
                connection_address_family_e address_family, char **dhcp_server);
 
 /**
+ * @brief Gets the DHCP lease duration.
+ * @since_tizen 4.0
+ * @param[in] profile                   The profile handle
+ * @param[in] address_family            The address family
+ * @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
+ * @retval #CONNECTION_ERROR_NOT_SUPPORTED                  Not supported
+*/
+int connection_profile_get_dhcp_lease_duration(connection_profile_h profile,
+               connection_address_family_e address_family, int *dhcp_lease_duration);
+
+/**
  * @brief Gets the DNS address.
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @remarks The allowance of the DNS address is @c 2. You must release @a dns_address using free().
@@ -494,6 +549,7 @@ int connection_profile_get_dhcp_server_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
@@ -511,6 +567,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
 */
@@ -528,6 +585,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
@@ -548,6 +606,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
 */
@@ -566,6 +625,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
@@ -587,6 +647,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
@@ -607,6 +668,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
@@ -630,6 +692,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
@@ -649,6 +712,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()
@@ -668,6 +732,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
@@ -690,7 +755,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
@@ -698,6 +763,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.
@@ -709,12 +775,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()
@@ -728,6 +795,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
@@ -743,6 +811,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
@@ -758,6 +827,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
@@ -775,6 +845,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
@@ -792,6 +863,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
@@ -820,6 +892,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
@@ -836,6 +909,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
@@ -851,6 +925,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
 */
@@ -865,6 +940,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
 */
@@ -879,6 +955,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
 */
@@ -886,13 +963,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
@@ -902,13 +980,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
@@ -926,9 +1005,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);
@@ -943,6 +1023,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()
@@ -961,6 +1042,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
 */
@@ -987,6 +1069,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
@@ -1004,6 +1087,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
@@ -1022,6 +1106,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
@@ -1040,6 +1125,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
@@ -1056,9 +1142,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);
@@ -1072,6 +1159,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
@@ -1089,6 +1177,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
 */
@@ -1105,6 +1194,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
 */
@@ -1121,6 +1211,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
 */
@@ -1137,6 +1228,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
 */
@@ -1152,6 +1244,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()
@@ -1163,12 +1256,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()
@@ -1187,6 +1281,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()
@@ -1204,6 +1299,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()
@@ -1220,6 +1316,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
@@ -1236,6 +1333,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