mirror of
https://github.com/espressif/openthread.git
synced 2026-08-12 21:57:47 +00:00
[tcp] update otTcpConnect() doc to indicate currently supported behavior (#8835)
This commit updates the documentation for `otTcpConnect()` indicating that caller need to wait for `otTcpEstablished` callback indicating that TCP connection was established before it can start sending data (e.g., calling `otTcpSendByReference()`). It also removes the mention of "TCP Fast Open" which is not yet supported.
This commit is contained in:
@@ -53,7 +53,7 @@ extern "C" {
|
||||
* @note This number versions both OpenThread platform and user APIs.
|
||||
*
|
||||
*/
|
||||
#define OPENTHREAD_API_VERSION (298)
|
||||
#define OPENTHREAD_API_VERSION (299)
|
||||
|
||||
/**
|
||||
* @addtogroup api-instance
|
||||
|
||||
@@ -401,11 +401,11 @@ enum
|
||||
/**
|
||||
* Records the remote host and port for this connection.
|
||||
*
|
||||
* By default TCP Fast Open is used. This means that this function merely
|
||||
* records the remote host and port, and that the TCP connection establishment
|
||||
* handshake only happens on the first call to otTcpSendByReference(). TCP Fast
|
||||
* Open can be explicitly disabled using @p aFlags, in which case the TCP
|
||||
* connection establishment handshake is initiated immediately.
|
||||
* Caller must wait for `otTcpEstablished` callback indicating that TCP
|
||||
* connection establishment handshake is done before it can start sending data
|
||||
* e.g., calling `otTcpSendByReference()`.
|
||||
*
|
||||
* The TCP Fast Open is not yet supported and @p aFlags is ignored.
|
||||
*
|
||||
* @param[in] aEndpoint A pointer to the TCP endpoint structure to connect.
|
||||
* @param[in] aSockName The IP address and port of the host to which to connect.
|
||||
|
||||
Reference in New Issue
Block a user