Use `URI` all caps in documentation
[iotivity.git] / resource / csdk / connectivity / inc / caraadapter.h
index 32656ba..139eaa6 100644 (file)
@@ -27,6 +27,7 @@
 
 #include "cacommon.h"
 #include "caadapterinterface.h"
+#include "cainterface.h"
 #include "cathreadpool.h"
 
 #ifdef __cplusplus
@@ -50,7 +51,7 @@ extern "C"
  */
 CAResult_t CAInitializeRA(CARegisterConnectivityCallback registerCallback,
                           CANetworkPacketReceivedCallback networkPacketCallback,
-                          CANetworkChangeCallback netCallback,
+                          CAAdapterChangeCallback netCallback,
                           ca_thread_pool_t handle);
 
 
@@ -63,15 +64,16 @@ CAResult_t CAStartRA();
 /**
  * Sends data to the endpoint using the adapter connectivity.
  * @param[in]   endpoint    Remote Endpoint information (like ipaddress, port,
- *                           reference uri and transport type) to which
+ *                           reference URI and transport type) to which
  *                           the unicast data has to be sent.
  * @param[in]   data        Data which is required to be sent.
  * @param[in]   dataLen     Size of data to be sent.
+ * @param[in]   dataType    Data type which is REQUEST or RESPONSE.
  * @note dataLen must be > 0.
  * @return The number of bytes sent on the network, or -1 upon error.
  */
 int32_t CASendRAUnicastData(const CAEndpoint_t *endpoint, const void *data,
-                            uint32_t dataLen);
+                            uint32_t dataLen, CADataType_t dataType);
 
 /**
  * Get RA Connectivity network information.
@@ -80,7 +82,7 @@ int32_t CASendRAUnicastData(const CAEndpoint_t *endpoint, const void *data,
  * @param[out]   size        Number of local connectivity structures.
  * @return  ::CA_STATUS_OK or Appropriate error code.
  */
-CAResult_t CAGetRAInterfaceInformation(CAEndpoint_t **info, uint32_t *size);
+CAResult_t CAGetRAInterfaceInformation(CAEndpoint_t **info, size_t *size);
 
 /**
  * Stops RA server and de-register XMPP callback listeners.
@@ -106,7 +108,7 @@ CAResult_t CASetRAInfo(const CARAInfo_t *caraInfo);
  * These functions are not applicable to Remote Access adapter.
  */
 int32_t CASendRAMulticastData(const CAEndpoint_t *endpoint,
-                 const void *data, uint32_t dataLen);
+                              const void *data, uint32_t dataLen, CADataType_t dataType);
 
 /**
  * Start listening server for receiving search requests.
@@ -114,6 +116,12 @@ int32_t CASendRAMulticastData(const CAEndpoint_t *endpoint,
  */
 CAResult_t CAStartRAListeningServer();
 
+/**
+ * Stops listening server from receiving search requests.
+ * @return  ::CA_NOT_SUPPORTED.
+ */
+CAResult_t CAStopRAListeningServer();
+
 /**
  * Start discovery servers for receiving advertisements.
  * @return  ::CA_NOT_SUPPORTED.