1

/* $Id$ */

     2

     3

#ifndef NETWORK_CORE_PACKET_H

     4

#define NETWORK_CORE_PACKET_H

     5

     6

#ifdef ENABLE_NETWORK

     7

    10

/**

    11

 * @file packet.h Basic functions to create, fill and read packets.

    12

 */

    13

    14

typedef struct NetworkClientState NetworkClientState;

    15

    16

/**

    17

 * Queries the network client state struct to determine whether

    18

 * the client has quit. It indirectly also queries whether the

    19

 * packet is corrupt as the connection will be closed if it is

    20

 * reading beyond the boundary of the received packet.

    21

 * @param cs the state to query

    22

 * @param true if the connection should be considered dropped

    23

 */

    24

bool HasClientQuit(NetworkClientState *cs);

    25

    26

typedef uint16 PacketSize; ///< Size of the whole packet.

    27

typedef uint8  PacketType; ///< Identifier for the packet

    28

    29

/**

    30

 * Internal entity of a packet. As everything is sent as a packet,

    31

 * all network communication will need to call the functions that

    32

 * populate the packet.

    33

 * Every packet can be at most SEND_MTU bytes. Overflowing this

    34

 * limit will give an assertion when sending (i.e. writing) the

    35

 * packet. Reading past the size of the packet when receiving

    36

 * will return all 0 values and "" in case of the string.

    37

 */

    38

typedef struct Packet {

    39

	/** The next packet. Used for queueing packets before sending. */

    40

	struct Packet *next;

    41

	/** The size of the whole packet for received packets. For packets

    42

	 * that will be sent, the value is filled in just before the

    43

	 * actual transmission. */

    44

	PacketSize size;

    45

	/** The current read/write position in the packet */

    46

	PacketSize pos;

    47

	/** The buffer of this packet */

    48

	byte buffer[SEND_MTU];

    49

} Packet;

    50

    51

    52

Packet *NetworkSend_Init(PacketType type);

    53

void NetworkSend_FillPacketSize(Packet *packet);

    54

void NetworkSend_uint8 (Packet *packet, uint8 data);

    55

void NetworkSend_uint16(Packet *packet, uint16 data);

    56

void NetworkSend_uint32(Packet *packet, uint32 data);

    57

void NetworkSend_uint64(Packet *packet, uint64 data);

    58

void NetworkSend_string(Packet *packet, const char* data);

    59

    60

void NetworkRecv_ReadPacketSize(Packet *packet);

    61

uint8  NetworkRecv_uint8 (NetworkClientState *cs, Packet *packet);

    62

uint16 NetworkRecv_uint16(NetworkClientState *cs, Packet *packet);

    63

uint32 NetworkRecv_uint32(NetworkClientState *cs, Packet *packet);

    64

uint64 NetworkRecv_uint64(NetworkClientState *cs, Packet *packet);

    65

void   NetworkRecv_string(NetworkClientState *cs, Packet *packet, char* buffer, size_t size);

    66

    67

#endif /* ENABLE_NETWORK */

    68

    69

#endif /* NETWORK_CORE_PACKET_H */