tcp.h
Go to the documentation of this file.
1 /*
2  * Copyright (C) 2015-2017 Simon Brummer
3  *
4  * This file is subject to the terms and conditions of the GNU Lesser
5  * General Public License v2.1. See the file LICENSE in the top level
6  * directory for more details.
7  */
8 
9 #pragma once
10 
24 #include <stdint.h>
25 #include "net/gnrc/pkt.h"
26 #include "net/gnrc/tcp/tcb.h"
27 
28 #ifdef SOCK_HAS_IPV6
29 #include "net/sock.h"
30 #else
31 #ifdef MODULE_GNRC_IPV6
32 #include "net/gnrc/ipv6.h"
33 #endif
34 #endif
35 
36 #ifdef __cplusplus
37 extern "C" {
38 #endif
39 
40 /* Note: This value if configurable for test purposes. Do not override it.
41  * Changing this value may lead to errors that are hard to track down.
42  */
43 #ifndef GNRC_TCP_NO_TIMEOUT
47 #define GNRC_TCP_NO_TIMEOUT (UINT32_MAX)
48 #endif
49 
50 #ifdef SOCK_HAS_IPV6
51 /* Reuse sock endpoint if sock is available and supporting IPv6. */
52 typedef struct _sock_tl_ep gnrc_tcp_ep_t;
53 
54 #else
59 typedef struct {
60  int family;
61  union {
62 #ifdef MODULE_GNRC_IPV6
63  uint8_t ipv6[sizeof(ipv6_addr_t)];
64 #endif
65  uint8_t dummy;
66  } addr;
67  uint16_t netif;
68  uint16_t port;
70 #endif
71 
86 int gnrc_tcp_ep_init(gnrc_tcp_ep_t *ep, int family, const uint8_t *addr, size_t addr_size,
87  uint16_t port, uint16_t netif);
88 
103 int gnrc_tcp_ep_from_str(gnrc_tcp_ep_t *ep, const char *str);
104 
113 int gnrc_tcp_init(void);
114 
122 
130 
157 int gnrc_tcp_open(gnrc_tcp_tcb_t *tcb, const gnrc_tcp_ep_t *remote, uint16_t local_port);
158 
181 int gnrc_tcp_listen(gnrc_tcp_tcb_queue_t *queue, gnrc_tcp_tcb_t *tcbs, size_t tcbs_len,
182  const gnrc_tcp_ep_t *local);
183 
206  const uint32_t user_timeout_duration_ms);
207 
233 ssize_t gnrc_tcp_send(gnrc_tcp_tcb_t *tcb, const void *data, const size_t len,
234  const uint32_t user_timeout_duration_ms);
235 
267 ssize_t gnrc_tcp_recv(gnrc_tcp_tcb_t *tcb, void *data, const size_t max_len,
268  const uint32_t user_timeout_duration_ms);
269 
279 
289 
301 
315 
329 
343 
355 int gnrc_tcp_calc_csum(const gnrc_pktsnip_t *hdr, const gnrc_pktsnip_t *pseudo_hdr);
356 
367 gnrc_pktsnip_t *gnrc_tcp_hdr_build(gnrc_pktsnip_t *payload, uint16_t src, uint16_t dst);
368 
369 #ifdef __cplusplus
370 }
371 #endif
372 
Definitions for GNRC's IPv6 implementation.
void gnrc_tcp_close(gnrc_tcp_tcb_t *tcb)
Close a TCP connection.
void gnrc_tcp_tcb_queue_init(gnrc_tcp_tcb_queue_t *queue)
Initialize Transmission Control Block (TCB) queue.
void gnrc_tcp_stop_listen(gnrc_tcp_tcb_queue_t *queue)
Close connections and stop listening on TCB queue.
gnrc_pktsnip_t * gnrc_tcp_hdr_build(gnrc_pktsnip_t *payload, uint16_t src, uint16_t dst)
Adds a TCP header to a given payload.
int gnrc_tcp_init(void)
Initialize TCP.
int gnrc_tcp_queue_get_local(gnrc_tcp_tcb_queue_t *queue, gnrc_tcp_ep_t *ep)
Gets the local end point of a TCB queue.
int gnrc_tcp_calc_csum(const gnrc_pktsnip_t *hdr, const gnrc_pktsnip_t *pseudo_hdr)
Calculate and set checksum in TCP header.
int gnrc_tcp_get_local(gnrc_tcp_tcb_t *tcb, gnrc_tcp_ep_t *ep)
Get the local end point of a connected TCB.
int gnrc_tcp_accept(gnrc_tcp_tcb_queue_t *queue, gnrc_tcp_tcb_t **tcb, const uint32_t user_timeout_duration_ms)
Accept TCP connection from listening queue.
int gnrc_tcp_ep_init(gnrc_tcp_ep_t *ep, int family, const uint8_t *addr, size_t addr_size, uint16_t port, uint16_t netif)
Initialize TCP connection endpoint.
int gnrc_tcp_ep_from_str(gnrc_tcp_ep_t *ep, const char *str)
Construct TCP connection endpoint from string.
int gnrc_tcp_get_remote(gnrc_tcp_tcb_t *tcb, gnrc_tcp_ep_t *ep)
Get the remote end point of a connected TCB.
ssize_t gnrc_tcp_recv(gnrc_tcp_tcb_t *tcb, void *data, const size_t max_len, const uint32_t user_timeout_duration_ms)
Receive Data from the peer.
int gnrc_tcp_listen(gnrc_tcp_tcb_queue_t *queue, gnrc_tcp_tcb_t *tcbs, size_t tcbs_len, const gnrc_tcp_ep_t *local)
Configures a sequence of TCBs to wait for incoming connections.
void gnrc_tcp_abort(gnrc_tcp_tcb_t *tcb)
Abort a TCP connection.
int gnrc_tcp_open(gnrc_tcp_tcb_t *tcb, const gnrc_tcp_ep_t *remote, uint16_t local_port)
Opens a connection.
void gnrc_tcp_tcb_init(gnrc_tcp_tcb_t *tcb)
Initialize Transmission Control Block (TCB)
ssize_t gnrc_tcp_send(gnrc_tcp_tcb_t *tcb, const void *data, const size_t len, const uint32_t user_timeout_duration_ms)
Transmit data to connected peer.
General definitions for network packets and their helper functions.
Common sock API definitions.
Common IP-based transport layer end point.
Definition: sock.h:214
uint8_t ipv6[16]
IPv6 address mode.
Definition: sock.h:229
union _sock_tl_ep::@389 addr
address
Type to represent parts (either headers or payload) of a packet, called snips.
Definition: pkt.h:108
Address information for a single TCP connection endpoint.
Definition: tcp.h:59
uint16_t netif
Network interface ID.
Definition: tcp.h:67
int family
IP address family.
Definition: tcp.h:60
uint16_t port
Port number (in host byte order)
Definition: tcp.h:68
uint8_t dummy
Enable build without network module.
Definition: tcp.h:65
TCP queue type.
Definition: sock_types.h:114
TCP sock type.
Definition: sock_types.h:101
GNRC TCP transmission control block (TCB)
Data type to represent an IPv6 address.
Definition: addr.h:67