OpenTTD
udp.h
Go to the documentation of this file.
1 /* $Id$ */
2 
3 /*
4  * This file is part of OpenTTD.
5  * OpenTTD 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, version 2.
6  * OpenTTD 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.
7  * See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with OpenTTD. If not, see <http://www.gnu.org/licenses/>.
8  */
9 
14 #ifndef NETWORK_CORE_UDP_H
15 #define NETWORK_CORE_UDP_H
16 
17 #include "address.h"
18 #include "game.h"
19 #include "packet.h"
20 
36 };
37 
40  SLT_IPv4 = 0,
41  SLT_IPv6 = 1,
43 
45 };
46 
49 protected:
54 
55  NetworkRecvStatus CloseConnection(bool error = true) override;
56 
58 
64  virtual void Receive_CLIENT_FIND_SERVER(Packet *p, NetworkAddress *client_addr);
65 
105  virtual void Receive_SERVER_RESPONSE(Packet *p, NetworkAddress *client_addr);
106 
112  virtual void Receive_CLIENT_DETAIL_INFO(Packet *p, NetworkAddress *client_addr);
113 
141  virtual void Receive_SERVER_DETAIL_INFO(Packet *p, NetworkAddress *client_addr);
142 
152  virtual void Receive_SERVER_REGISTER(Packet *p, NetworkAddress *client_addr);
153 
159  virtual void Receive_MASTER_ACK_REGISTER(Packet *p, NetworkAddress *client_addr);
160 
168  virtual void Receive_CLIENT_GET_LIST(Packet *p, NetworkAddress *client_addr);
169 
179  virtual void Receive_MASTER_RESPONSE_LIST(Packet *p, NetworkAddress *client_addr);
180 
188  virtual void Receive_SERVER_UNREGISTER(Packet *p, NetworkAddress *client_addr);
189 
199  virtual void Receive_CLIENT_GET_NEWGRFS(Packet *p, NetworkAddress *client_addr);
200 
211  virtual void Receive_SERVER_NEWGRFS(Packet *p, NetworkAddress *client_addr);
212 
219  virtual void Receive_MASTER_SESSION_KEY(Packet *p, NetworkAddress *client_addr);
220 
221  void HandleUDPPacket(Packet *p, NetworkAddress *client_addr);
222 
230  virtual void HandleIncomingNetworkGameInfoGRFConfig(GRFConfig *config) { NOT_REACHED(); }
231 public:
233 
235  virtual ~NetworkUDPSocketHandler() { this->Close(); }
236 
237  bool Listen();
238  void Close() override;
239 
240  void SendPacket(Packet *p, NetworkAddress *recv, bool all = false, bool broadcast = false);
241  void ReceivePackets();
242 
243  void SendNetworkGameInfo(Packet *p, const NetworkGameInfo *info);
245 };
246 
247 #endif /* NETWORK_CORE_UDP_H */
Autodetect the type based on the connection.
Definition: udp.h:42
virtual void Receive_CLIENT_GET_NEWGRFS(Packet *p, NetworkAddress *client_addr)
The client requests information about some NewGRFs.
Definition: udp.cpp:345
Internal entity of a packet.
Definition: packet.h:42
Sends a fresh session key to the client.
Definition: udp.h:34
virtual void Receive_SERVER_REGISTER(Packet *p, NetworkAddress *client_addr)
Registers the server to the master server.
Definition: udp.cpp:340
Queries a game server for game information.
Definition: udp.h:23
virtual ~NetworkUDPSocketHandler()
On destructing of this class, the socket needs to be closed.
Definition: udp.h:235
Requests the name for a list of GRFs (GRF_ID and MD5)
Definition: udp.h:32
void ReceivePackets()
Receive a packet at UDP level.
Definition: udp.cpp:117
virtual void Receive_SERVER_RESPONSE(Packet *p, NetworkAddress *client_addr)
Return of server information to the client.
Definition: udp.cpp:337
Get the IPv4 addresses.
Definition: udp.h:40
Request for serverlist from master server.
Definition: udp.h:29
void SendNetworkGameInfo(Packet *p, const NetworkGameInfo *info)
Serializes the NetworkGameInfo struct to the packet.
Definition: udp.cpp:157
Get the IPv6 addresses.
Definition: udp.h:41
virtual void Receive_SERVER_UNREGISTER(Packet *p, NetworkAddress *client_addr)
A server unregisters itself at the master server.
Definition: udp.cpp:344
SocketList sockets
The opened sockets.
Definition: udp.h:53
virtual void Receive_MASTER_SESSION_KEY(Packet *p, NetworkAddress *client_addr)
The master server sends us a session key.
Definition: udp.cpp:347
Wrapper for (un)resolved network addresses; there&#39;s no reason to transform a numeric IP to a string a...
Definition: address.h:29
PacketUDPType
Enum with all types of UDP packets.
Definition: udp.h:22
Base socket handler for all UDP sockets.
Definition: udp.h:48
Request to be removed from the server-list.
Definition: udp.h:31
Information about a game that is sent between a game server, game client and masterserver.
void ReceiveInvalidPacket(PacketUDPType, NetworkAddress *client_addr)
Helper for logging receiving invalid packets.
Definition: udp.cpp:331
The game information that is sent from the server to the clients.
Definition: game.h:34
std::vector< NetworkAddress > NetworkAddressList
Type for a list of addresses.
Definition: address.h:20
virtual void Receive_CLIENT_FIND_SERVER(Packet *p, NetworkAddress *client_addr)
Queries to the server for information about the game.
Definition: udp.cpp:336
virtual void HandleIncomingNetworkGameInfoGRFConfig(GRFConfig *config)
Function that is called for every GRFConfig that is read when receiving a NetworkGameInfo.
Definition: udp.h:230
Must ALWAYS be on the end of this list!! (period)
Definition: udp.h:35
Information about GRF, used in the game and (part of it) in savegames.
virtual void Receive_CLIENT_GET_LIST(Packet *p, NetworkAddress *client_addr)
The client requests a list of servers.
Definition: udp.cpp:342
Packet to register itself to the master server.
Definition: udp.h:27
Packet indicating registration has succeeded.
Definition: udp.h:28
virtual void Receive_SERVER_NEWGRFS(Packet *p, NetworkAddress *client_addr)
The server returns information about some NewGRFs.
Definition: udp.cpp:346
void Close() override
Close the given UDP socket.
Definition: udp.cpp:60
Reply of the game server about details of the game, such as companies.
Definition: udp.h:26
NetworkRecvStatus
Status of a network client; reasons why a client has quit.
Definition: core.h:24
ServerListType
The types of server lists we can get.
Definition: udp.h:39
Wrapper for network addresses.
NetworkRecvStatus CloseConnection(bool error=true) override
Close the current connection; for TCP this will be mostly equivalent to Close(), but for UDP it just ...
Definition: udp.cpp:68
virtual void Receive_CLIENT_DETAIL_INFO(Packet *p, NetworkAddress *client_addr)
Query for detailed information about companies.
Definition: udp.cpp:338
virtual void Receive_MASTER_ACK_REGISTER(Packet *p, NetworkAddress *client_addr)
The master server acknowledges the registration.
Definition: udp.cpp:341
bool Listen()
Start listening on the given host and port.
Definition: udp.cpp:45
void SendPacket(Packet *p, NetworkAddress *recv, bool all=false, bool broadcast=false)
Send a packet over UDP.
Definition: udp.cpp:81
Sends the list of NewGRF&#39;s requested.
Definition: udp.h:33
void HandleUDPPacket(Packet *p, NetworkAddress *client_addr)
Handle an incoming packets by sending it to the correct function.
Definition: udp.cpp:293
virtual void Receive_SERVER_DETAIL_INFO(Packet *p, NetworkAddress *client_addr)
Reply with detailed company information.
Definition: udp.cpp:339
void CDECL error(const char *s,...)
Error handling for fatal non-user errors.
Definition: openttd.cpp:114
Basic functions to create, fill and read packets.
Response from master server with server ip&#39;s + port&#39;s.
Definition: udp.h:30
NetworkAddressList bind
The address to bind to.
Definition: udp.h:51
void ReceiveNetworkGameInfo(Packet *p, NetworkGameInfo *info)
Deserializes the NetworkGameInfo struct from the packet.
Definition: udp.cpp:219
Queries a game server about details of the game, such as companies.
Definition: udp.h:25
Reply of the game server with game information.
Definition: udp.h:24
virtual void Receive_MASTER_RESPONSE_LIST(Packet *p, NetworkAddress *client_addr)
The server sends a list of servers.
Definition: udp.cpp:343
End of &#39;arrays&#39; marker.
Definition: udp.h:44
SocketHandler for all network sockets in OpenTTD.
Definition: core.h:43
NetworkUDPSocketHandler(NetworkAddressList *bind=nullptr)
Create an UDP socket but don&#39;t listen yet.
Definition: udp.cpp:25