Corrected formatting issues and missing references in Header file. 73/137073/1
authorNishant Chaprana <n.chaprana@samsung.com>
Tue, 4 Jul 2017 05:11:22 +0000 (10:41 +0530)
committerNishant Chaprana <n.chaprana@samsung.com>
Tue, 4 Jul 2017 09:07:12 +0000 (14:37 +0530)
Change-Id: Iacbf37d0bf56a492285955eb64b4dda7eb5de072
Signed-off-by: Nishant Chaprana <n.chaprana@samsung.com>
include/wifi-direct.h
packaging/capi-network-wifi-direct.spec

index e9375a9..d6c1804 100755 (executable)
@@ -17,7 +17,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  *
-*/
+ */
 #ifndef __TIZEN_NET_WIFI_DIRECT_H__
 #define __TIZEN_NET_WIFI_DIRECT_H__
 
@@ -62,6 +62,8 @@ typedef enum {
 /**
  * @brief Enumeration for Wi-Fi Direct link status.
  * @since_tizen 2.3
+ * @see wifi_direct_state_changed_cb()
+ * @see wifi_direct_get_state()
  */
 typedef enum {
        WIFI_DIRECT_STATE_DEACTIVATED,    /**< Deactivated */
@@ -79,6 +81,7 @@ typedef enum {
 /**
  * @brief Enumeration for Wi-Fi Direct device state.
  * @since_tizen 2.3
+ * @see wifi_direct_device_state_changed_cb()
  */
 typedef enum {
        WIFI_DIRECT_DEVICE_STATE_ACTIVATED,    /**< Activated */
@@ -89,6 +92,8 @@ typedef enum {
 /**
  * @brief Enumeration for Wi-Fi Direct discovery state.
  * @since_tizen 2.3
+ * @see wifi_direct_discovery_state_chagned_cb()
+ * @see wifi_direct_peer_found_cb()
  */
 typedef enum {
        WIFI_DIRECT_ONLY_LISTEN_STARTED,  /**< Only listen started */
@@ -102,12 +107,13 @@ typedef enum {
 /**
  * @brief Enumeration for Wi-Fi Direct connection state.
  * @since_tizen 2.3
+ * @see wifi_direct_connection_state_changed_cb()
  */
 typedef enum {
        WIFI_DIRECT_CONNECTION_REQ,          /**< Connection is requested */
        WIFI_DIRECT_CONNECTION_WPS_REQ,      /**< WPS is requested */
        WIFI_DIRECT_CONNECTION_IN_PROGRESS,  /**< Connection in progress */
-       WIFI_DIRECT_CONNECTION_RSP,          /**< Connected */
+       WIFI_DIRECT_CONNECTION_RSP,          /**< Connection response */
        WIFI_DIRECT_DISASSOCIATION_IND,      /**< Disconnected by remote Group Client */
        WIFI_DIRECT_DISCONNECTION_RSP,       /**< Disconnected by local device */
        WIFI_DIRECT_DISCONNECTION_IND,       /**< Disconnected by remote Group Owner */
@@ -119,6 +125,7 @@ typedef enum {
 /**
  * @brief Enumeration for Wi-Fi Direct secondary device type.
  * @since_tizen 2.3
+ * @see wifi_direct_get_secondary_device_type()
  */
 typedef enum {
        WIFI_DIRECT_SECONDARY_DEVICE_TYPE_COMPUTER_PC = 1,                  /**< PC */
@@ -184,6 +191,7 @@ typedef enum {
 /**
  * @brief Enumeration for Wi-Fi Direct primary device type.
  * @since_tizen 2.3
+ * @see wifi_direct_get_primary_device_type()
  */
 typedef enum {
        WIFI_DIRECT_PRIMARY_DEVICE_TYPE_COMPUTER = 1,           /**< Computer */
@@ -200,9 +208,14 @@ typedef enum {
        WIFI_DIRECT_PRIMARY_DEVICE_TYPE_OTHER =  255            /**< Others */
 } wifi_direct_primary_device_type_e;
 
+
 /**
  * @brief Enumeration for Wi-Fi WPS type.
  * @since_tizen 2.3
+ * @see wifi_direct_supported_wps_type_cb()
+ * @see wifi_direct_get_local_wps_type()
+ * @see wifi_direct_set_req_wps_type()
+ * @see wifi_direct_get_req_wps_type()
  */
 typedef enum {
        WIFI_DIRECT_WPS_TYPE_NONE = 0x00,         /**< No WPS type */
@@ -213,9 +226,9 @@ typedef enum {
 
 
 /**
-* @brief Enumeration for Wi-Fi Display device type.
-* @since_tizen 2.3
-*/
+ * @brief Enumeration for Wi-Fi Display device type.
+ * @since_tizen 2.3
+ */
 typedef enum {
        WIFI_DISPLAY_TYPE_NONE,  /**< Configure as WFD Source*/
        WIFI_DISPLAY_TYPE_SINK,  /**< Configure as WFD Primary Sink */
@@ -228,36 +241,43 @@ typedef enum {
 /**
  * @brief Enumeration for Service Discovery type.
  * @since_tizen 2.3
-*/
+ * @see wifi_direct_service_state_changed_cb()
+ * @see wifi_direct_start_service_discovery()
+ * @see wifi_direct_cancel_service_discovery()
+ * @see wifi_direct_register_service()
+ */
 typedef enum {
-       WIFI_DIRECT_SERVICE_TYPE_ALL,            /**< Service discovery Type all */
-       WIFI_DIRECT_SERVICE_TYPE_BONJOUR,        /**< Service discovery Type bonjour */
-       WIFI_DIRECT_SERVICE_TYPE_UPNP,           /**< Service discovery Type UPNP */
-       WIFI_DIRECT_SERVICE_TYPE_WS_DISCOVERY,   /**< Service discovery Type ws discovery */
-       WIFI_DIRECT_SERVICE_TYPE_WIFI_DISPLAY,   /**< Service discovery Type wifi-display */
-       WIFI_DIRECT_SERVICE_TYPE_BT_ADDR,        /**< Service discovery Type bt address */
-       WIFI_DIRECT_SERVICE_TYPE_CONTACT_INFO,   /**< Service discovery Type contact info */
-       WIFI_DIRECT_SERVICE_TYPE_VENDOR = 0xff,  /**< Service discovery Type vendor-specific */
+       WIFI_DIRECT_SERVICE_TYPE_ALL,            /**< Service discovery type all */
+       WIFI_DIRECT_SERVICE_TYPE_BONJOUR,        /**< Service discovery type bonjour */
+       WIFI_DIRECT_SERVICE_TYPE_UPNP,           /**< Service discovery type UPNP */
+       WIFI_DIRECT_SERVICE_TYPE_WS_DISCOVERY,   /**< Service discovery type ws discovery */
+       WIFI_DIRECT_SERVICE_TYPE_WIFI_DISPLAY,   /**< Service discovery type wifi-display */
+       WIFI_DIRECT_SERVICE_TYPE_BT_ADDR,        /**< Service discovery type bt address */
+       WIFI_DIRECT_SERVICE_TYPE_CONTACT_INFO,   /**< Service discovery type contact info */
+       WIFI_DIRECT_SERVICE_TYPE_VENDOR = 0xff,  /**< Service discovery type vendor-specific */
 } wifi_direct_service_type_e;
 
 
 /**
-* @brief Enumeration for Wi-Fi Display device type.
-* @since_tizen 2.4
-*/
+ * @brief Enumeration for Wi-Fi Display device type.
+ * @since_tizen 2.4
+ * @see wifi_direct_set_display()
+ * @see wifi_direct_get_peer_display_type()
+ */
 typedef enum {
        WIFI_DIRECT_DISPLAY_TYPE_SOURCE,   /**< Configure as WFD Source*/
        WIFI_DIRECT_DISPLAY_TYPE_PRISINK,  /**< Configure as WFD Primary Sink */
        WIFI_DIRECT_DISPLAY_TYPE_SECSINK,  /**< Configure as WFD Secondary Sink */
        WIFI_DIRECT_DISPLAY_TYPE_DUAL,     /**< Configure as WFD Dual Role */
-       WIFI_DIRECT_DISPLAY_TYPE_MAX,
+       WIFI_DIRECT_DISPLAY_TYPE_MAX,      /**< Not configured */
 } wifi_direct_display_type_e;
 
 
 /**
  * @brief Enumeration for Wi-Fi Direct service Discovery state.
  * @since_tizen 2.3
-*/
+ * @see wifi_direct_service_state_changed_cb()
+ */
 typedef enum {
        WIFI_DIRECT_SERVICE_DISCOVERY_STARTED,   /**< Service discovery started */
        WIFI_DIRECT_SERVICE_DISCOVERY_FOUND,     /**< Service discovery found */
@@ -268,7 +288,8 @@ typedef enum {
 /**
  * @brief Enumeration for Wi-Fi Direct Discovery Channel.
  * @since_tizen 2.3
-*/
+ * @see wifi_direct_start_discovery_specific_channel()
+ */
 typedef enum {
        WIFI_DIRECT_DISCOVERY_FULL_SCAN = 0,          /**< Scan full channel */
        WIFI_DIRECT_DISCOVERY_SOCIAL_CHANNEL = 1611,  /**< Scan social channel */
@@ -362,82 +383,88 @@ typedef enum {
  * @since_tizen 2.3
  * @remarks You can use APIs for Wi-Fi Direct display function instead of is_miracast_device value
  *          which is deprecated since 2.4.
+ * @see wifi_direct_discovered_peer_cb()
+ * @see wifi_direct_get_peer_info()
+ * @see wifi_direct_get_connecting_peer_info()
  */
 typedef struct {
-        /**<
-         * Device's friendly name
-         */
+       /**
+        * Device's friendly name
+        */
        char *device_name;
 
-        /**<
-         * Device's P2P Device Address
-         */
+       /**
+        * Device's P2P Device Address
+        */
        char *mac_address;
 
-       /**<
+       /**
         * Device's P2P Interface Address, Valid only if device is a P2P GO
         */
        char *interface_address;
 
-       /**<
+       /**
         * Channel the device is listening on
         */
        int channel;
 
-        /**<
-         * Is peer connected*/
+       /**
+        * Is peer connected
+        */
        bool is_connected;
 
-        /**<
-         * Is an active P2P Group Owner
-         */
+       /**
+        * Is an active P2P Group Owner
+        */
        bool is_group_owner;
 
-        /**<
-         * Is a stored Persistent GO
-         */
+       /**
+        * Is a stored Persistent GO
+        */
        bool is_persistent_group_owner;
 
-        /**<
-         * Primary category of device
-         */
+       /**
+        * Primary category of device
+        */
        wifi_direct_primary_device_type_e primary_device_type;
 
-        /**<
-         * Sub category of device
-         */
+       /**
+        * Sub category of device
+        */
        wifi_direct_secondary_device_type_e secondary_device_type;
 
-        /**<
-         * The list of supported WPS type. The OR operation on
-         * #wifi_direct_wps_type_e can be used like
-         * #WIFI_DIRECT_WPS_TYPE_PBC | #WIFI_DIRECT_WPS_TYPE_PIN_DISPLAY
-         */
+       /**
+        * The list of supported WPS type. The OR operation on
+        * #wifi_direct_wps_type_e can be used like
+        * #WIFI_DIRECT_WPS_TYPE_PBC | #WIFI_DIRECT_WPS_TYPE_PIN_DISPLAY
+        */
        int supported_wps_types;
 
-        /**<
-         * Is capable of processing P2P Invitation Procedure signaling
-         */
+       /**
+        * Is capable of processing P2P Invitation Procedure signaling
+        */
        bool is_p2p_invitation_procedure_supported;
 
-        /**<
-         * The number of Registered services
-         */
+       /**
+        * The number of Registered services
+        */
        unsigned int service_count;
 
-        /**<
-         * The list of registered services
-         */
+       /**
+        * The list of registered services
+        */
        char **service_list;
 
-        /**<
-         * Is a wifi display device
-         */
+       /**
+        * Is a wifi display device
+        * @deprecated since tizen 2.4, use wifi direct display APIs instead of
+        * is_miracast_device value.
+        */
        bool is_miracast_device;
 
-        /**<
-         * The information for vendor specific information element
-         */
+       /**
+        * The information for vendor specific information element
+        */
        void *vsie_info;
 } wifi_direct_discovered_peer_info_s;
 
@@ -447,60 +474,64 @@ typedef struct {
  * @since_tizen 2.3
  * @remarks You can use APIs for wifi-direct display function instead of is_miracast_device value
  *          which is deprecated since 2.4.
+ * @see wifi_direct_connected_peer_cb()
  */
 typedef struct {
-        /**<
-         * Device's friendly name
-         */
+       /**
+        * Device's friendly name
+        */
        char *device_name;
 
-        /**<
-         * The IP address
-         */
+       /**
+        * The IP address
+        */
        char *ip_address;
 
-        /**<
-         * Device's P2P Device Address
-         */
+       /**
+        * Device's P2P Device Address
+        */
        char *mac_address;
 
-        /**<
-         * Device's P2P Interface Address
-         */
+       /**
+        * Device's P2P Interface Address
+        */
        char *interface_address;
 
-       /**<
+       /**
         * Operating channel
         */
        int channel;
 
-        /**<
-         * Whether peer is a P2P device*/
+       /**
+        * Whether peer is a P2P device
+        */
        bool p2p_supported;
 
-        /**<
-         * Primary category of device
-         */
+       /**
+        * Primary category of device
+        */
        wifi_direct_primary_device_type_e primary_device_type;
 
-        /**<
-         * Sub category of device
-         */
+       /**
+        * Sub category of device
+        */
        wifi_direct_secondary_device_type_e secondary_device_type;
 
-        /**<
-         * The number of Registered services
-         */
+       /**
+        * The number of Registered services
+        */
        unsigned int service_count;
 
-        /**<
-         * The list of registered services
-         */
+       /**
+        * The list of registered services
+        */
        char **service_list;
 
-        /**<
-         * Is a wifi display device
-         */
+       /**
+        * Is a wifi display device
+        * @deprecated since tizen 2.4, use wifi direct display APIs instead of
+        * is_miracast_device value.
+        */
        bool is_miracast_device;
 } wifi_direct_connected_peer_info_s;
 
@@ -524,8 +555,8 @@ typedef struct {
  * @see wifi_direct_unset_discovery_state_changed_cb()
  */
 typedef void (*wifi_direct_discovery_state_chagned_cb) (int error_code,
-                                                        wifi_direct_discovery_state_e discovery_state,
-                                                        void *user_data);
+                                                       wifi_direct_discovery_state_e discovery_state,
+                                                       void *user_data);
 
 
 /**
@@ -548,9 +579,9 @@ typedef void (*wifi_direct_discovery_state_chagned_cb) (int error_code,
  * @see wifi_direct_unset_peer_found_cb()
  */
 typedef void (*wifi_direct_peer_found_cb) (int error_code,
-                                           wifi_direct_discovery_state_e discovery_state,
-                                           const char *mac_address,
-                                           void *user_data);
+                                          wifi_direct_discovery_state_e discovery_state,
+                                          const char *mac_address,
+                                          void *user_data);
 
 
 /**
@@ -572,8 +603,8 @@ typedef void (*wifi_direct_peer_found_cb) (int error_code,
  * @see wifi_direct_unset_device_state_changed_cb()
  */
 typedef void (*wifi_direct_device_state_changed_cb) (int error_code,
-                                                     wifi_direct_device_state_e device_state,
-                                                     void *user_data);
+                                                    wifi_direct_device_state_e device_state,
+                                                    void *user_data);
 
 
 /**
@@ -600,9 +631,9 @@ typedef void (*wifi_direct_device_state_changed_cb) (int error_code,
  * @see wifi_direct_unset_connection_state_changed_cb()
  */
 typedef void (*wifi_direct_connection_state_changed_cb) (int error_code,
-                                                         wifi_direct_connection_state_e connection_state,
-                                                         const char *mac_address,
-                                                         void *user_data);
+                                                        wifi_direct_connection_state_e connection_state,
+                                                        const char *mac_address,
+                                                        void *user_data);
 
 
 /**
@@ -622,12 +653,12 @@ typedef void (*wifi_direct_connection_state_changed_cb) (int error_code,
  * @see wifi_direct_unset_client_ip_address_assigned_cb()
  */
 typedef void (*wifi_direct_client_ip_address_assigned_cb) (const char *mac_address,
-                                                           const char *ip_address,
-                                                           const char *interface_address,
-                                                           void *user_data);
+                                                          const char *ip_address,
+                                                          const char *interface_address,
+                                                          void *user_data);
 
 
- /**
+/**
  * @brief Called when the state of Service discovery is changed.
  * @details The following error codes can be delivered
  *          #WIFI_DIRECT_ERROR_NONE
@@ -649,11 +680,11 @@ typedef void (*wifi_direct_client_ip_address_assigned_cb) (const char *mac_addre
  * @see wifi_direct_unset_discovery_state_changed_cb()
  */
 typedef void (*wifi_direct_service_state_changed_cb) (int error_code,
-                                                      wifi_direct_service_discovery_state_e service_state,
-                                                      wifi_direct_service_type_e service_type,
-                                                      void *response_data,
-                                                      const char *mac_address,
-                                                      void *user_data);
+                                                     wifi_direct_service_discovery_state_e service_state,
+                                                     wifi_direct_service_type_e service_type,
+                                                     void *response_data,
+                                                     const char *mac_address,
+                                                     void *user_data);
 
 
 /**
@@ -666,8 +697,8 @@ typedef void (*wifi_direct_service_state_changed_cb) (int error_code,
  * @see wifi_direct_set_state_changed_cb()
  * @see wifi_direct_unset_state_changed_cb()
  */
-typedef void (*wifi_direct_state_changed_cb)  (wifi_direct_state_e state,
-                                               void *user_data);
+typedef void (*wifi_direct_state_changed_cb) (wifi_direct_state_e state,
+                                             void *user_data);
 
 
 /**
@@ -1064,6 +1095,7 @@ int wifi_direct_start_discovery(bool listen_only, int timeout);
  */
 int wifi_direct_start_discovery_specific_channel(bool listen_only, int timeout, wifi_direct_discovery_channel_e channel);
 
+
 /**
  * @brief Starts discovery to find all P2P capable devices with specified frequency, asynchronously.
  * @since_tizen 4.0
@@ -1105,6 +1137,7 @@ int wifi_direct_start_discovery_specific_channel(bool listen_only, int timeout,
  */
 int wifi_direct_start_discovery_specific_freq(bool listen_only, int timeout, int frequency);
 
+
 /**
  * @brief Cancels discovery process, asynchronously.
  * @details This function stops all discovery processes started with
@@ -1132,7 +1165,7 @@ int wifi_direct_start_discovery_specific_freq(bool listen_only, int timeout, int
 int wifi_direct_cancel_discovery(void);
 
 
- /**
+/**
  * @brief Called repeatedly when you get the information of discovered peers.
  * @since_tizen 2.3
  * @privlevel public
@@ -1142,8 +1175,8 @@ int wifi_direct_cancel_discovery(void);
  * @return @c true to continue with the next iteration of the loop,
  *         @c false to break out of the loop
  * @see wifi_direct_foreach_discovered_peers()
 */
-typedef bool(*wifi_direct_discovered_peer_cb)  (wifi_direct_discovered_peer_info_s *peer, void *user_data);
+ */
+typedef bool (*wifi_direct_discovered_peer_cb) (wifi_direct_discovered_peer_info_s *peer, void *user_data);
 
 
 /**
@@ -1283,7 +1316,7 @@ int wifi_direct_disconnect(char *mac_address);
  *         @c false to break out of the loop
  * @see wifi_direct_foreach_connected_peers()
  */
-typedef bool(*wifi_direct_connected_peer_cb) (wifi_direct_connected_peer_info_s *peer, void *user_data);
+typedef bool (*wifi_direct_connected_peer_cb) (wifi_direct_connected_peer_info_s *peer, void *user_data);
 
 
 /**
@@ -1337,6 +1370,7 @@ int wifi_direct_foreach_connected_peers(wifi_direct_connected_peer_cb callback,
  */
 int wifi_direct_create_group(void);
 
+
 /**
  * @brief Destorys the Wi-Fi Direct Group, asynchronously.
  * @details This API destroys the Wi-Fi Direct Group owned by a local device.
@@ -1778,11 +1812,13 @@ int wifi_direct_activate_pushbutton(void);
  */
 int wifi_direct_set_wps_pin(char *pin);
 
+
 /**
  * @brief Gets the WPS PIN number.
  * @since_tizen 2.3
  * @privlevel public
  * @privilege http://tizen.org/privilege/wifidirect
+ * @remarks @a device_name must be released with free().
  * @param[out] pin  Pointer to store pin number. Application must free this memory
  * @return @c 0 on success,
  *         otherwise a negative error value
@@ -2062,6 +2098,7 @@ int wifi_direct_set_passphrase(const char *passphrase);
  * @since_tizen 2.4
  * @privlevel public
  * @privilege http://tizen.org/privilege/wifidirect
+ * @remarks @a device_name must be released with free().
  * @param[out] passphrase  Pointer to store wpa password. Application must free this memory
  * @return @c 0 on success,
  *         otherwise a negative error value
@@ -2224,7 +2261,7 @@ int wifi_direct_is_persistent_group_enabled(bool *enabled);
  *         @c false to break out of the loop
  * @pre wifi_direct_foreach_persistent_groups() will invoke this callback.
  * @see wifi_direct_foreach_persistent_groups()
-*/
+ */
 typedef bool(*wifi_direct_persistent_group_cb)(const char *mac_address, const char *ssid, void *user_data);
 
 
@@ -2250,7 +2287,7 @@ typedef bool(*wifi_direct_persistent_group_cb)(const char *mac_address, const ch
  * @post wifi_direct_persistent_group_cb() will be called.
  * @see wifi_direct_initialize()
  * @see wifi_direct_persistent_group_cb()
-*/
+ */
 int wifi_direct_foreach_persistent_groups(wifi_direct_persistent_group_cb callback, void *user_data);
 
 
@@ -2275,7 +2312,7 @@ int wifi_direct_foreach_persistent_groups(wifi_direct_persistent_group_cb callba
  * @pre Wi-Fi Direct service must be initialized by wifi_direct_initialize().
  * @see wifi_direct_initialize()
  * @see wifi_direct_foreach_persistent_groups()
-*/
+ */
 int wifi_direct_remove_persistent_group(char *mac_address, const char *ssid);
 
 
@@ -2302,7 +2339,7 @@ int wifi_direct_remove_persistent_group(char *mac_address, const char *ssid);
  * @post wifi_direct_set_service_state_changed_cb() will be invoked.
  * @see wifi_direct_activate()
  * @see wifi_direct_set_service_state_changed_cb()
-*/
+ */
 int wifi_direct_start_service_discovery(char *mac_address, wifi_direct_service_type_e service_type);
 
 
@@ -2325,7 +2362,7 @@ int wifi_direct_start_service_discovery(char *mac_address, wifi_direct_service_t
  * @retval #WIFI_DIRECT_ERROR_RESOURCE_BUSY         Device or resource busy
  * @pre Wi-Fi Direct service must be activated by wifi_direct_activate().
  * @see wifi_direct_activate()
-*/
+ */
 int wifi_direct_cancel_service_discovery(char *mac_address, wifi_direct_service_type_e service_type);
 
 
@@ -2351,7 +2388,7 @@ int wifi_direct_cancel_service_discovery(char *mac_address, wifi_direct_service_
  * @retval #WIFI_DIRECT_ERROR_RESOURCE_BUSY         Device or resource busy
  * @pre Wi-Fi Direct service must be activated by wifi_direct_activate().
  * @see wifi_direct_activate()
-*/
+ */
 int wifi_direct_register_service(wifi_direct_service_type_e service_type, char *info1, char *info2, unsigned int *service_id);
 
 
@@ -2374,7 +2411,7 @@ int wifi_direct_register_service(wifi_direct_service_type_e service_type, char *
  * @retval #WIFI_DIRECT_ERROR_RESOURCE_BUSY         Device or resource busy
  * @pre Wi-Fi Direct service must be activated by wifi_direct_activate().
  * @see wifi_direct_activate()
-*/
+ */
 int wifi_direct_deregister_service(unsigned int service_id);
 
 
@@ -2397,7 +2434,7 @@ int wifi_direct_deregister_service(unsigned int service_id);
  * @retval #WIFI_DIRECT_ERROR_RESOURCE_BUSY         Device or resource busy
  * @pre Wi-Fi Direct service must be activated by wifi_direct_activate().
  * @see wifi_direct_activate()
-*/
+ */
 int wifi_direct_init_miracast(bool enable);
 
 
@@ -2681,57 +2718,58 @@ int wifi_direct_set_auto_group_removal(bool enable);
 
 
 /**
-* @brief Sets the timer which is used to expire the connection session.
-* @since_tizen 3.0
-* @privlevel public
-* @privilege http://tizen.org/privilege/wifidirect
-* @param[in] seconds  Set the connection session timer value in seconds
-* @return @c 0 on success,
-*         otherwise a negative error value
-* @retval #WIFI_DIRECT_ERROR_NONE                  Successful
-* @retval #WIFI_DIRECT_ERROR_INVALID_PARAMETER     Invalid parameter
-* @retval #WIFI_DIRECT_ERROR_OPERATION_FAILED      Operation failed
-* @retval #WIFI_DIRECT_ERROR_COMMUNICATION_FAILED  Communication failed
-* @retval #WIFI_DIRECT_ERROR_PERMISSION_DENIED     Permission denied
-* @retval #WIFI_DIRECT_ERROR_NOT_PERMITTED         Operation not permitted
-* @retval #WIFI_DIRECT_ERROR_NOT_INITIALIZED       Not initialized
-* @retval #WIFI_DIRECT_ERROR_RESOURCE_BUSY         Device or resource busy
-* @pre Wi-Fi Direct service must be activated by wifi_direct_activate().
-* @see wifi_direct_activate()
-*/
+ * @brief Sets the timer which is used to expire the connection session.
+ * @since_tizen 3.0
+ * @privlevel public
+ * @privilege http://tizen.org/privilege/wifidirect
+ * @param[in] seconds  Set the connection session timer value in seconds
+ * @return @c 0 on success,
+ *         otherwise a negative error value
+ * @retval #WIFI_DIRECT_ERROR_NONE                  Successful
+ * @retval #WIFI_DIRECT_ERROR_INVALID_PARAMETER     Invalid parameter
+ * @retval #WIFI_DIRECT_ERROR_OPERATION_FAILED      Operation failed
+ * @retval #WIFI_DIRECT_ERROR_COMMUNICATION_FAILED  Communication failed
+ * @retval #WIFI_DIRECT_ERROR_PERMISSION_DENIED     Permission denied
+ * @retval #WIFI_DIRECT_ERROR_NOT_PERMITTED         Operation not permitted
+ * @retval #WIFI_DIRECT_ERROR_NOT_INITIALIZED       Not initialized
+ * @retval #WIFI_DIRECT_ERROR_RESOURCE_BUSY         Device or resource busy
+ * @pre Wi-Fi Direct service must be activated by wifi_direct_activate().
+ * @see wifi_direct_activate()
+ */
 int wifi_direct_set_session_timer(int seconds);
 
 
 /**
-* @brief Gets the timer which is used to expire the connection session.
-* @since_tizen 3.0
-* @privlevel public
-* @privilege http://tizen.org/privilege/wifidirect
-* @param[out] seconds  Connection session timer value
-* @return @c 0 on success,
- *         otherwise a negative error value
-* @retval #WIFI_DIRECT_ERROR_NONE                  Successful
-* @retval #WIFI_DIRECT_ERROR_INVALID_PARAMETER     Invalid parameter
-* @retval #WIFI_DIRECT_ERROR_OPERATION_FAILED      Operation failed
-* @retval #WIFI_DIRECT_ERROR_COMMUNICATION_FAILED  Communication failed
-* @retval #WIFI_DIRECT_ERROR_PERMISSION_DENIED     Permission denied
-* @retval #WIFI_DIRECT_ERROR_NOT_PERMITTED         Operation not permitted
-* @retval #WIFI_DIRECT_ERROR_NOT_INITIALIZED       Not initialized
-* @retval #WIFI_DIRECT_ERROR_RESOURCE_BUSY         Device or resource busy
-* @pre Wi-Fi Direct service must be activated by wifi_direct_activate().
-* @see wifi_direct_activate()
-*/
+ * @brief Gets the timer which is used to expire the connection session.
+ * @since_tizen 3.0
+ * @privlevel public
+ * @privilege http://tizen.org/privilege/wifidirect
+ * @param[out] seconds  Connection session timer value
+ * @return @c 0 on success,
+ *         otherwise a negative error value
+ * @retval #WIFI_DIRECT_ERROR_NONE                  Successful
+ * @retval #WIFI_DIRECT_ERROR_INVALID_PARAMETER     Invalid parameter
+ * @retval #WIFI_DIRECT_ERROR_OPERATION_FAILED      Operation failed
+ * @retval #WIFI_DIRECT_ERROR_COMMUNICATION_FAILED  Communication failed
+ * @retval #WIFI_DIRECT_ERROR_PERMISSION_DENIED     Permission denied
+ * @retval #WIFI_DIRECT_ERROR_NOT_PERMITTED         Operation not permitted
+ * @retval #WIFI_DIRECT_ERROR_NOT_INITIALIZED       Not initialized
+ * @retval #WIFI_DIRECT_ERROR_RESOURCE_BUSY         Device or resource busy
+ * @pre Wi-Fi Direct service must be activated by wifi_direct_activate().
+ * @see wifi_direct_activate()
+ */
 int wifi_direct_get_session_timer(int *seconds);
 
+
 /**
-* @brief Gets the timer which is used to expire the connection session.
-* @since_tizen 3.0
-* @privlevel public
-* @privilege http://tizen.org/privilege/wifidirect
-* @param[in] mac_address  MAC Address of the peer device
-* @param[out] rssi        RSSI value of the peer device
-* @return @c 0 on success,
-*         otherwise a negative error value
+ * @brief Gets the timer which is used to expire the connection session.
+ * @since_tizen 3.0
+ * @privlevel public
+ * @privilege http://tizen.org/privilege/wifidirect
+ * @param[in] mac_address  MAC Address of the peer device
+ * @param[out] rssi        RSSI value of the peer device
+ * @return @c 0 on success,
+ *         otherwise a negative error value
  * @retval #WIFI_DIRECT_ERROR_NONE                  Successful
  * @retval #WIFI_DIRECT_ERROR_INVALID_PARAMETER     Invalid parameter
  * @retval #WIFI_DIRECT_ERROR_OPERATION_FAILED      Operation failed
@@ -2741,11 +2779,12 @@ int wifi_direct_get_session_timer(int *seconds);
  * @retval #WIFI_DIRECT_ERROR_NOT_SUPPORTED         Not supported
  * @retval #WIFI_DIRECT_ERROR_NOT_INITIALIZED       Not initialized
  * @retval #WIFI_DIRECT_ERROR_RESOURCE_BUSY         Device or resource busy
-* @pre Wi-Fi Direct service must be initialized by wifi_direct_initialize().
-* @see wifi_direct_activate()
-*/
+ * @pre Wi-Fi Direct service must be initialized by wifi_direct_initialize().
+ * @see wifi_direct_activate()
+ */
 int wifi_direct_get_peer_rssi(char *mac_address, int *rssi);
 
+
 /**
  * @brief Adds the Wi-Fi Vendor Specific Information Element (VSIE) to specific frame type.
  * @since_tizen 4.0
@@ -2828,6 +2867,7 @@ int wifi_direct_get_vsie(wifi_direct_vsie_frames_e frame_id, char **vsie_str);
  */
 int wifi_direct_remove_vsie(wifi_direct_vsie_frames_e frame_id, const char *vsie_str);
 
+
 /**
  * @brief Gets the information of peer devices which is in the connecting state.
  * @since_tizen 4.0
@@ -2860,4 +2900,4 @@ int wifi_direct_get_connecting_peer_info(wifi_direct_discovered_peer_info_s **pe
 #ifdef __cplusplus
 }
 #endif
-#endif                                                 /* __TIZEN_NET_WIFI_DIRECT_H__ */
+#endif /* __TIZEN_NET_WIFI_DIRECT_H__ */
index 1c2149c..3629c5a 100644 (file)
@@ -3,7 +3,7 @@
 
 Name:       capi-network-wifi-direct
 Summary:    Network WiFi-Direct Library
-Version:    1.2.82
+Version:    1.2.83
 Release:    1
 Group:      Network & Connectivity/API
 License:    Apache-2.0