toxcore/core/Lossless_UDP.h

97 lines
2.8 KiB
C
Raw Normal View History

/* Lossless_UDP.h
*
* An implementation of the Lossless_UDP protocol as seen in docs/Lossless_UDP.txt
*
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"
2013-07-03 21:45:01 +08:00
//maximum length of the data in the data packets
#define MAX_DATA_SIZE 1024
//Functions
//initialize a new connection to ip_port
//returns an integer corresponding to the connection id.
//return -1 if it could not initialize the connection.
2013-06-30 23:34:35 +08:00
//if there already was an existing connection to that ip_port return its number.
int new_connection(IP_Port ip_port);
2013-06-30 23:34:35 +08:00
//returns an integer 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();
2013-06-30 23:34:35 +08:00
//return -1 if it could not kill the connection.
//return 0 if killed successfully
int kill_connection(int connection_id);
2013-06-30 23:34:35 +08:00
//returns the ip_port of the corresponding connection.
//return 0 if there is no such connection.
IP_Port connection_ip(int connection_id);
//return 0 if there is no received data in the buffer.
//return length of recieved packet if successful
int read_packet(int connection_id, char * data);
2013-06-30 23:34:35 +08:00
//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, char * data, uint32_t length);
2013-06-30 23:34:35 +08:00
//returns the number of packets in the queue waiting to be successfully sent.
uint32_t sendqueue(int connection_id);
2013-06-30 23:34:35 +08:00
//returns the number of packets in the queue waiting to be successfully read with read_packet(...)
uint32_t recvqueue(int connection_id);
2013-06-30 23:34:35 +08:00
//check if connection is connected
//return 0 no.
2013-06-30 23:34:35 +08:00
//return 1 if attempting handshake
//return 2 if handshake is done
//return 3 if fully connected
int is_connected(int connection_id);
2013-06-30 23:34:35 +08:00
//Call this function a couple times per second
//It's the main loop.
void doLossless_UDP();
2013-06-30 23:34:35 +08:00
//if we receive a Lossless_UDP packet we call this function so it can be handled.
//Return 0 if packet is handled correctly.
//return 1 if it didn't handle the packet or if the packet was shit.
int LosslessUDP_handlepacket(char * packet, uint32_t length, IP_Port source);
2013-06-30 23:34:35 +08:00
#endif