tcp.h File Reference
TCP (Transmission Control Protocol) More...
Go to the source code of this file.
Data Structures | |
| struct _TcpQueueItem | |
| Retransmission queue item. More... | |
| struct _TcpSynQueueItem | |
| SYN queue item. More... | |
| struct TcpSackBlock | |
| SACK block. More... | |
| struct TcpTxBuffer | |
| Transmit buffer. More... | |
| struct TcpRxBuffer | |
| Receive buffer. More... | |
Typedefs | |
| typedef struct _TcpQueueItem TcpQueueItem | |
| Retransmission queue item. More... | |
| typedef struct _TcpSynQueueItem TcpSynQueueItem | |
| SYN queue item. More... | |
Enumerations | |
| enum TcpState { TCP_STATE_CLOSED = 0, TCP_STATE_LISTEN = 1, TCP_STATE_SYN_SENT = 2, TCP_STATE_SYN_RECEIVED = 3, TCP_STATE_ESTABLISHED = 4, TCP_STATE_CLOSE_WAIT = 5, TCP_STATE_LAST_ACK = 6, TCP_STATE_FIN_WAIT_1 = 7, TCP_STATE_FIN_WAIT_2 = 8, TCP_STATE_CLOSING = 9, TCP_STATE_TIME_WAIT = 10 } | |
| TCP FSM states. More... | |
| enum TcpCongestState { TCP_CONGEST_STATE_IDLE = 0, TCP_CONGEST_STATE_RECOVERY = 1, TCP_CONGEST_STATE_LOSS_RECOVERY = 2 } | |
| TCP congestion states. More... | |
| enum TcpFlags { TCP_FLAG_FIN = 0x01, TCP_FLAG_SYN = 0x02, TCP_FLAG_RST = 0x04, TCP_FLAG_PSH = 0x08, TCP_FLAG_ACK = 0x10, TCP_FLAG_URG = 0x20 } | |
| TCP control flags. More... | |
| enum TcpOptionKind { TCP_OPTION_END = 0, TCP_OPTION_NOP = 1, TCP_OPTION_MAX_SEGMENT_SIZE = 2, TCP_OPTION_WINDOW_SCALE_FACTOR = 3, TCP_OPTION_SACK_PERMITTED = 4, TCP_OPTION_SACK = 5, TCP_OPTION_TIMESTAMP = 8 } | |
| TCP option types. More... | |
Functions | |
| error_t tcpInit (void) | |
| TCP related initialization. More... | |
| error_t tcpSetInitialRto (NetInterface *interface, systime_t initialRto) | |
| Set TCP initial retransmission timeout. More... | |
| uint16_t tcpGetDynamicPort (void) | |
| Get an ephemeral port number. More... | |
| error_t tcpConnect (Socket *socket, const IpAddr *remoteIpAddr, uint16_t remotePort) | |
| Establish a TCP connection. More... | |
| error_t tcpListen (Socket *socket, uint_t backlog) | |
| Place a socket in the listening state. More... | |
| Socket * tcpAccept (Socket *socket, IpAddr *clientIpAddr, uint16_t *clientPort) | |
| Permit an incoming connection attempt on a TCP socket. More... | |
| error_t tcpSend (Socket *socket, const uint8_t *data, size_t length, size_t *written, uint_t flags) | |
| Send data to a connected socket. More... | |
| error_t tcpReceive (Socket *socket, uint8_t *data, size_t size, size_t *received, uint_t flags) | |
| Receive data from a connected socket. More... | |
| error_t tcpShutdown (Socket *socket, uint_t how) | |
| Shutdown gracefully reception, transmission, or both. More... | |
| error_t tcpAbort (Socket *socket) | |
| Abort an existing TCP connection. More... | |
| TcpState tcpGetState (Socket *socket) | |
| Get the current state of the TCP FSM. More... | |
| Socket * tcpKillOldestConnection (void) | |
| Kill the oldest socket in the TIME-WAIT state. More... | |
Variables | |
| typedef __packed_struct | |
| TCP header. More... | |
| uint16_t destPort | |
| uint32_t seqNum | |
| uint32_t ackNum | |
| uint8_t reserved1 | |
| uint8_t dataOffset | |
| uint8_t flags | |
| uint8_t reserved2 | |
| uint16_t window | |
| uint16_t checksum | |
| uint16_t urgentPointer | |
| uint8_t options [] | |
| TcpHeader | |
| uint8_t length | |
| uint8_t value [] | |
| TcpOption | |
| systime_t tcpTickCounter | |
Detailed Description
TCP (Transmission Control Protocol)
License
SPDX-License-Identifier: GPL-2.0-or-later
Copyright (C) 2010-2025 Oryx Embedded SARL. All rights reserved.
This file is part of CycloneTCP Open.
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
- Version
- 2.5.0
Definition in file tcp.h.
Macro Definition Documentation
◆ TCP_2MSL_TIMER
◆ TCP_CMP_SEQ
◆ TCP_CONGEST_CONTROL_SUPPORT
◆ TCP_DEFAULT_KEEP_ALIVE_IDLE
◆ TCP_DEFAULT_KEEP_ALIVE_INTERVAL
◆ TCP_DEFAULT_KEEP_ALIVE_PROBES
◆ TCP_DEFAULT_MSS
◆ TCP_DEFAULT_PROBE_INTERVAL
◆ TCP_DEFAULT_RX_BUFFER_SIZE
◆ TCP_DEFAULT_SYN_QUEUE_SIZE
◆ TCP_DEFAULT_TX_BUFFER_SIZE
◆ TCP_FAST_RETRANSMIT_THRES
◆ TCP_FIN_WAIT_2_TIMER
◆ TCP_INITIAL_RTO
◆ TCP_INITIAL_WINDOW
◆ TCP_KEEP_ALIVE_SUPPORT
◆ TCP_LOSS_WINDOW
◆ TCP_MAX_HEADER_LENGTH
◆ TCP_MAX_MSS
◆ TCP_MAX_PROBE_INTERVAL
◆ TCP_MAX_RETRIES
◆ TCP_MAX_RTO
◆ TCP_MAX_RX_BUFFER_SIZE
◆ TCP_MAX_SACK_BLOCKS
◆ TCP_MAX_SYN_QUEUE_SIZE
◆ TCP_MAX_TX_BUFFER_SIZE
◆ TCP_MIN_MSS
◆ TCP_MIN_RTO
◆ TCP_OVERRIDE_TIMEOUT
◆ TCP_SACK_SUPPORT
◆ TCP_SECURE_ISN_SUPPORT
◆ TCP_SUPPORT
◆ TCP_TICK_INTERVAL
◆ TCP_WINDOW_SCALE_SUPPORT
Typedef Documentation
◆ TcpQueueItem
| typedef struct _TcpQueueItem TcpQueueItem |
Retransmission queue item.
◆ TcpSynQueueItem
| typedef struct _TcpSynQueueItem TcpSynQueueItem |
SYN queue item.
Enumeration Type Documentation
◆ TcpCongestState
| enum TcpCongestState |
◆ TcpFlags
| enum TcpFlags |
◆ TcpOptionKind
| enum TcpOptionKind |
◆ TcpState
| enum TcpState |
Function Documentation
◆ tcpAbort()
◆ tcpAccept()
Permit an incoming connection attempt on a TCP socket.
- Parameters
-
[in] socket Handle to a socket previously placed in a listening state [out] clientIpAddr IP address of the client [out] clientPort Port number used by the client
- Returns
- Handle to the socket in which the actual connection is made
◆ tcpConnect()
◆ tcpGetDynamicPort()
| uint16_t tcpGetDynamicPort | ( | void | ) |
◆ tcpGetState()
◆ tcpInit()
| error_t tcpInit | ( | void | ) |
◆ tcpKillOldestConnection()
| Socket* tcpKillOldestConnection | ( | void | ) |
◆ tcpListen()
Place a socket in the listening state.
Place a socket in a state in which it is listening for an incoming connection
- Parameters
-
[in] socket Socket to place in the listening state [in] backlog backlog The maximum length of the pending connection queue. If this parameter is zero, then the default backlog value is used instead
- Returns
- Error code
◆ tcpReceive()
| error_t tcpReceive | ( | Socket * | socket, |
| uint8_t * | data, | ||
| size_t | size, | ||
| size_t * | received, | ||
| uint_t | flags | ||
| ) |
Receive data from a connected socket.
- Parameters
-
[in] socket Handle that identifies a connected socket [out] data Buffer where to store the incoming data [in] size Maximum number of bytes that can be received [out] received Number of bytes that have been received [in] flags Set of flags that influences the behavior of this function
- Returns
- Error code
◆ tcpSend()
| error_t tcpSend | ( | Socket * | socket, |
| const uint8_t * | data, | ||
| size_t | length, | ||
| size_t * | written, | ||
| uint_t | flags | ||
| ) |
Send data to a connected socket.
- Parameters
-
[in] socket Handle that identifies a connected socket [in] data Pointer to a buffer containing the data to be transmitted [in] length Number of bytes to be transmitted [out] written Actual number of bytes written (optional parameter) [in] flags Set of flags that influences the behavior of this function
- Returns
- Error code
◆ tcpSetInitialRto()
| error_t tcpSetInitialRto | ( | NetInterface * | interface, |
| systime_t | initialRto | ||
| ) |
◆ tcpShutdown()
Shutdown gracefully reception, transmission, or both.
Note that socketShutdown() does not close the socket, and resources attached to the socket will not be freed until socketClose() is invoked
- Parameters
-
[in] socket Handle to a socket [in] how Flag that describes what types of operation will no longer be allowed
- Returns
- Error code
Variable Documentation
◆ __packed_struct
| typedef __packed_struct |