summaryrefslogtreecommitdiff
path: root/core/Lossless_UDP.h
blob: 53afe60609dac60f9c2f1906190a6d278f1bd345 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
/* Lossless_UDP.h
 *
 * An implementation of the Lossless_UDP protocol as seen in http://wiki.tox.im/index.php/Lossless_UDP
 *
 *  Copyright (C) 2013 Tox project All Rights Reserved.
 *
 *  This file is part of Tox.
 *
 *  Tox 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 3 of the License, or
 *  (at your option) any later version.
 *
 *  Tox 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 Tox.  If not, see <http://www.gnu.org/licenses/>.
 *
 */

#ifndef LOSSLESS_UDP_H
#define LOSSLESS_UDP_H

#include "network.h"

#ifdef __cplusplus
extern "C" {
#endif

/* maximum length of the data in the data packets */
#define MAX_DATA_SIZE 1024

/* 
 * Initialize a new connection to ip_port
 * Returns an integer corresponding to the connection id.
 * Return -1 if it could not initialize the connection.
 * Return number if there already was an existing connection to that ip_port.
 */
int new_connection(IP_Port ip_port);

/* 
 * Get connection id from IP_Port.
 * Return -1 if there are no connections like we are looking for.
 * Return id if it found it .
 */
int getconnection_id(IP_Port ip_port);

/* 
 * Returns an int corresponding to the next connection in our imcoming connection list
 * Return -1 if there are no new incoming connections in the list.
 */
int incoming_connection(void);

/* 
 * Return -1 if it could not kill the connection.
 * Return 0 if killed successfully
 */
int kill_connection(int connection_id);

/* 
 * Kill connection in seconds seconds.
 * Return -1 if it can not kill the connection.
 * Return 0 if it will kill it
 */
int kill_connection_in(int connection_id, uint32_t seconds);

/* 
 * Returns the ip_port of the corresponding connection.
 * Return 0 if there is no such connection.
 */
IP_Port connection_ip(int connection_id);

/* 
 * Returns the id of the next packet in the queue 
 * Return -1 if no packet in queue 
 */
char id_packet(int connection_id);

/* 
 * Return 0 if there is no received data in the buffer.
 * Return length of received packet if successful 
 */
int read_packet(int connection_id, uint8_t *data);

/* 
 * Return 0 if data could not be put in packet queue
 * Return 1 if data was put into the queue
 */
int write_packet(int connection_id, uint8_t *data, uint32_t length);

/* Returns the number of packets in the queue waiting to be successfully sent. */
uint32_t sendqueue(int connection_id);

/* 
 * returns the number of packets in the queue waiting to be successfully 
 * read with read_packet(...)
 */
uint32_t recvqueue(int connection_id);

/* Check if connection is connected:
 * Return 0 no.
 * Return 1 if attempting handshake.
 * Return 2 if handshake is done.
 * Return 3 if fully connected.
 * Return 4 if timed out and wating to be killed.
 */
int is_connected(int connection_id);

/* Call this function a couple times per second It's the main loop. */
void doLossless_UDP(void);

/* 
 * This function sets up LosslessUDP packet handling.
 */
void LosslessUDP_init(void);

#ifdef __cplusplus
}
#endif

#endif