OpenTTD Source  20241121-master-g67a0fccfad
tcp_game.cpp
Go to the documentation of this file.
1 /*
2  * This file is part of OpenTTD.
3  * 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.
4  * 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.
5  * 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/>.
6  */
7 
12 #include "../../stdafx.h"
13 
14 #include "../network.h"
15 #include "../network_internal.h"
16 #include "../../debug.h"
17 #include "../../error.h"
18 
19 #include "table/strings.h"
20 
21 #include "../../safeguards.h"
22 
23 static std::vector<std::unique_ptr<NetworkGameSocketHandler>> _deferred_deletions;
24 
30  last_frame(_frame_counter), last_frame_server(_frame_counter)
31 {
32  this->sock = s;
33  this->last_packet = std::chrono::steady_clock::now();
34 }
35 
44 {
45  /* Clients drop back to the main menu */
46  if (!_network_server && _networking) {
49  _networking = false;
50  ShowErrorMessage(STR_NETWORK_ERROR_LOSTCONNECTION, INVALID_STRING_ID, WL_CRITICAL);
51 
53  }
54 
56 }
57 
58 
65 {
67 
68  if (this->HasClientQuit()) {
69  Debug(net, 0, "[tcp/game] Received invalid packet from client {}", this->client_id);
70  this->CloseConnection();
72  }
73 
74  this->last_packet = std::chrono::steady_clock::now();
75 
76  switch (type) {
77  case PACKET_SERVER_FULL: return this->Receive_SERVER_FULL(p);
78  case PACKET_SERVER_BANNED: return this->Receive_SERVER_BANNED(p);
79  case PACKET_CLIENT_JOIN: return this->Receive_CLIENT_JOIN(p);
80  case PACKET_SERVER_ERROR: return this->Receive_SERVER_ERROR(p);
84  case PACKET_CLIENT_IDENTIFY: return this->Receive_CLIENT_IDENTIFY(p);
88  case PACKET_SERVER_WELCOME: return this->Receive_SERVER_WELCOME(p);
89  case PACKET_CLIENT_GETMAP: return this->Receive_CLIENT_GETMAP(p);
90  case PACKET_SERVER_WAIT: return this->Receive_SERVER_WAIT(p);
92  case PACKET_SERVER_MAP_SIZE: return this->Receive_SERVER_MAP_SIZE(p);
93  case PACKET_SERVER_MAP_DATA: return this->Receive_SERVER_MAP_DATA(p);
94  case PACKET_SERVER_MAP_DONE: return this->Receive_SERVER_MAP_DONE(p);
95  case PACKET_CLIENT_MAP_OK: return this->Receive_CLIENT_MAP_OK(p);
96  case PACKET_SERVER_JOIN: return this->Receive_SERVER_JOIN(p);
97  case PACKET_SERVER_FRAME: return this->Receive_SERVER_FRAME(p);
98  case PACKET_SERVER_SYNC: return this->Receive_SERVER_SYNC(p);
99  case PACKET_CLIENT_ACK: return this->Receive_CLIENT_ACK(p);
100  case PACKET_CLIENT_COMMAND: return this->Receive_CLIENT_COMMAND(p);
101  case PACKET_SERVER_COMMAND: return this->Receive_SERVER_COMMAND(p);
102  case PACKET_CLIENT_CHAT: return this->Receive_CLIENT_CHAT(p);
103  case PACKET_SERVER_CHAT: return this->Receive_SERVER_CHAT(p);
105  case PACKET_CLIENT_SET_NAME: return this->Receive_CLIENT_SET_NAME(p);
106  case PACKET_CLIENT_QUIT: return this->Receive_CLIENT_QUIT(p);
107  case PACKET_CLIENT_ERROR: return this->Receive_CLIENT_ERROR(p);
108  case PACKET_SERVER_QUIT: return this->Receive_SERVER_QUIT(p);
110  case PACKET_SERVER_SHUTDOWN: return this->Receive_SERVER_SHUTDOWN(p);
111  case PACKET_SERVER_NEWGAME: return this->Receive_SERVER_NEWGAME(p);
112  case PACKET_SERVER_RCON: return this->Receive_SERVER_RCON(p);
113  case PACKET_CLIENT_RCON: return this->Receive_CLIENT_RCON(p);
116  case PACKET_SERVER_MOVE: return this->Receive_SERVER_MOVE(p);
117  case PACKET_CLIENT_MOVE: return this->Receive_CLIENT_MOVE(p);
119 
120  default:
121  Debug(net, 0, "[tcp/game] Received invalid packet type {} from client {}", type, this->client_id);
122  this->CloseConnection();
124  }
125 }
126 
135 {
136  std::unique_ptr<Packet> p;
137  while ((p = this->ReceivePacket()) != nullptr) {
139  if (res != NETWORK_RECV_STATUS_OKAY) return res;
140  }
141 
143 }
144 
151 {
152  Debug(net, 0, "[tcp/game] Received illegal packet type {} from client {}", type, this->client_id);
154 }
155 
198 
199 void NetworkGameSocketHandler::DeferDeletion()
200 {
201  _deferred_deletions.emplace_back(this);
202  this->is_pending_deletion = true;
203 }
204 
205 /* static */ void NetworkGameSocketHandler::ProcessDeferredDeletions()
206 {
207  /* Calls deleter on all items */
208  _deferred_deletions.clear();
209 }
virtual NetworkRecvStatus Receive_CLIENT_MOVE(Packet &p)
Request the server to move this client into another company: uint8_t ID of the company the client wan...
Definition: tcp_game.cpp:196
virtual NetworkRecvStatus Receive_SERVER_MAP_BEGIN(Packet &p)
Sends that the server will begin with sending the map to the client: uint32_t Current frame.
Definition: tcp_game.cpp:170
virtual NetworkRecvStatus Receive_SERVER_MAP_SIZE(Packet &p)
Sends the size of the map to the client.
Definition: tcp_game.cpp:171
NetworkRecvStatus ReceivePackets()
Do the actual receiving of packets.
Definition: tcp_game.cpp:134
bool is_pending_deletion
Whether this socket is pending deletion.
Definition: tcp_game.h:145
virtual NetworkRecvStatus Receive_SERVER_CONFIG_UPDATE(Packet &p)
Update the clients knowledge of the max settings: uint8_t Maximum number of companies allowed.
Definition: tcp_game.cpp:197
virtual NetworkRecvStatus Receive_SERVER_BANNED(Packet &p)
Notification that the client trying to join is banned.
Definition: tcp_game.cpp:157
virtual NetworkRecvStatus Receive_SERVER_SYNC(Packet &p)
Sends a sync-check to the client: uint32_t Frame counter.
Definition: tcp_game.cpp:177
virtual NetworkRecvStatus Receive_SERVER_COMMAND(Packet &p)
Sends a DoCommand to the client: uint8_t ID of the company (0..MAX_COMPANIES-1).
Definition: tcp_game.cpp:180
virtual NetworkRecvStatus Receive_SERVER_MAP_DONE(Packet &p)
Sends that all data of the map are sent to the client:
Definition: tcp_game.cpp:173
NetworkGameSocketHandler(SOCKET s)
Create a new socket for the game connection.
Definition: tcp_game.cpp:29
virtual NetworkRecvStatus Receive_CLIENT_ACK(Packet &p)
Tell the server we are done with this frame: uint32_t Current frame counter of the client.
Definition: tcp_game.cpp:178
virtual NetworkRecvStatus Receive_SERVER_ENABLE_ENCRYPTION(Packet &p)
Indication to the client that authentication is complete and encryption has to be used from here on f...
Definition: tcp_game.cpp:166
virtual NetworkRecvStatus Receive_SERVER_GAME_INFO(Packet &p)
Sends information about the game.
Definition: tcp_game.cpp:161
virtual NetworkRecvStatus Receive_SERVER_WELCOME(Packet &p)
The client is joined and ready to receive their map: uint32_t Own client ID.
Definition: tcp_game.cpp:167
virtual NetworkRecvStatus Receive_CLIENT_QUIT(Packet &p)
The client is quitting the game.
Definition: tcp_game.cpp:185
virtual NetworkRecvStatus Receive_CLIENT_NEWGRFS_CHECKED(Packet &p)
Tell the server that we have the required GRFs.
Definition: tcp_game.cpp:194
virtual NetworkRecvStatus Receive_SERVER_SHUTDOWN(Packet &p)
Let the clients know that the server is closing.
Definition: tcp_game.cpp:189
virtual NetworkRecvStatus Receive_SERVER_FRAME(Packet &p)
Sends the current frame counter to the client: uint32_t Frame counter uint32_t Frame counter max (how...
Definition: tcp_game.cpp:176
virtual NetworkRecvStatus Receive_CLIENT_AUTH_RESPONSE(Packet &p)
Send the response to the authentication request: 32 * uint8_t Public key of the client.
Definition: tcp_game.cpp:165
virtual NetworkRecvStatus Receive_SERVER_MOVE(Packet &p)
Move a client from one company into another: uint32_t ID of the client.
Definition: tcp_game.cpp:195
virtual NetworkRecvStatus Receive_SERVER_AUTH_REQUEST(Packet &p)
Indication to the client that it needs to authenticate: uint8_t The NetworkAuthenticationMethod to us...
Definition: tcp_game.cpp:164
virtual NetworkRecvStatus Receive_SERVER_QUIT(Packet &p)
Notification that a client left the game: uint32_t ID of the client.
Definition: tcp_game.cpp:187
NetworkRecvStatus ReceiveInvalidPacket(PacketGameType type)
Helper for logging receiving invalid packets.
Definition: tcp_game.cpp:150
virtual NetworkRecvStatus Receive_CLIENT_GETMAP(Packet &p)
Request the map from the server.
Definition: tcp_game.cpp:168
ClientID client_id
Client identifier.
Definition: tcp_game.h:486
std::chrono::steady_clock::time_point last_packet
Time we received the last frame.
Definition: tcp_game.h:490
virtual NetworkRecvStatus Receive_SERVER_CHECK_NEWGRFS(Packet &p)
Sends information about all used GRFs to the client: uint8_t Amount of GRFs (the following data is re...
Definition: tcp_game.cpp:193
virtual NetworkRecvStatus Receive_CLIENT_JOIN(Packet &p)
Try to join the server: string OpenTTD revision (norev0000 if no revision).
Definition: tcp_game.cpp:158
virtual NetworkRecvStatus Receive_SERVER_ERROR_QUIT(Packet &p)
Inform all clients that one client made an error and thus has quit/been disconnected: uint32_t ID of ...
Definition: tcp_game.cpp:188
virtual NetworkRecvStatus Receive_CLIENT_RCON(Packet &p)
Send an RCon command to the server: string RCon password.
Definition: tcp_game.cpp:192
virtual NetworkRecvStatus Receive_SERVER_ERROR(Packet &p)
The client made an error: uint8_t Error code caused (see NetworkErrorCode).
Definition: tcp_game.cpp:159
virtual NetworkRecvStatus Receive_CLIENT_CHAT(Packet &p)
Sends a chat-packet to the server: uint8_t ID of the action (see NetworkAction).
Definition: tcp_game.cpp:181
NetworkRecvStatus HandlePacket(Packet &p)
Handle the given packet, i.e.
Definition: tcp_game.cpp:64
virtual NetworkRecvStatus Receive_CLIENT_GAME_INFO(Packet &p)
Request game information.
Definition: tcp_game.cpp:160
virtual NetworkRecvStatus Receive_CLIENT_MAP_OK(Packet &p)
Tell the server that we are done receiving/loading the map.
Definition: tcp_game.cpp:174
virtual NetworkRecvStatus Receive_SERVER_CHAT(Packet &p)
Sends a chat-packet to the client: uint8_t ID of the action (see NetworkAction).
Definition: tcp_game.cpp:182
virtual NetworkRecvStatus Receive_SERVER_RCON(Packet &p)
Send the result of an issues RCon command back to the client: uint16_t Colour code.
Definition: tcp_game.cpp:191
virtual NetworkRecvStatus Receive_CLIENT_COMMAND(Packet &p)
Send a DoCommand to the Server: uint8_t ID of the company (0..MAX_COMPANIES-1).
Definition: tcp_game.cpp:179
virtual NetworkRecvStatus Receive_SERVER_JOIN(Packet &p)
A client joined (PACKET_CLIENT_MAP_OK), what usually directly follows is a PACKET_SERVER_CLIENT_INFO:...
Definition: tcp_game.cpp:175
virtual NetworkRecvStatus Receive_SERVER_CLIENT_INFO(Packet &p)
Send information about a client: uint32_t ID of the client (always unique on a server.
Definition: tcp_game.cpp:162
virtual NetworkRecvStatus Receive_SERVER_WAIT(Packet &p)
Notification that another client is currently receiving the map: uint8_t Number of clients waiting in...
Definition: tcp_game.cpp:169
virtual NetworkRecvStatus Receive_CLIENT_IDENTIFY(Packet &p)
The client tells the server about the identity of the client: string Name of the client (max NETWORK_...
Definition: tcp_game.cpp:163
virtual NetworkRecvStatus Receive_SERVER_FULL(Packet &p)
Notification that the server is full.
Definition: tcp_game.cpp:156
NetworkRecvStatus CloseConnection(bool error=true) override
Functions to help ReceivePacket/SendPacket a bit A socket can make errors.
Definition: tcp_game.cpp:43
virtual NetworkRecvStatus Receive_SERVER_MAP_DATA(Packet &p)
Sends the data of the map to the client: Contains a part of the map (until max size of packet).
Definition: tcp_game.cpp:172
virtual NetworkRecvStatus Receive_CLIENT_ERROR(Packet &p)
The client made an error and is quitting the game.
Definition: tcp_game.cpp:186
virtual NetworkRecvStatus Receive_SERVER_EXTERNAL_CHAT(Packet &p)
Sends a chat-packet for external source to the client: string Name of the source this message came fr...
Definition: tcp_game.cpp:183
virtual NetworkRecvStatus Receive_SERVER_NEWGAME(Packet &p)
Let the clients know that the server is loading a new map.
Definition: tcp_game.cpp:190
virtual NetworkRecvStatus Receive_CLIENT_SET_NAME(Packet &p)
Gives the client a new name: string New name of the client.
Definition: tcp_game.cpp:184
bool HasClientQuit() const
Whether the current client connected to the socket has quit.
Definition: core.h:74
virtual std::unique_ptr< Packet > ReceivePacket()
Receives a packet for the given client.
Definition: tcp.cpp:129
SOCKET sock
The socket currently connected to.
Definition: tcp.h:38
NetworkRecvStatus
Status of a network client; reasons why a client has quit.
Definition: core.h:23
@ NETWORK_RECV_STATUS_CLIENT_QUIT
The connection is lost gracefully. Other clients are already informed of this leaving client.
Definition: core.h:28
@ NETWORK_RECV_STATUS_OKAY
Everything is okay.
Definition: core.h:24
@ NETWORK_RECV_STATUS_CONNECTION_LOST
The connection is lost unexpectedly.
Definition: core.h:34
@ NETWORK_RECV_STATUS_MALFORMED_PACKET
We apparently send a malformed packet.
Definition: core.h:29
#define Debug(category, level, format_string,...)
Ouptut a line of debugging information.
Definition: debug.h:37
void ShowErrorMessage(StringID summary_msg, int x, int y, CommandCost cc)
Display an error message in a window.
Definition: error_gui.cpp:367
@ WL_CRITICAL
Critical errors, the MessageBox is shown in all cases.
Definition: error.h:27
SwitchMode _switch_mode
The next mainloop command.
Definition: gfx.cpp:49
uint32_t _frame_counter
The current frame.
Definition: network.cpp:78
bool _networking
are we in networking mode?
Definition: network.cpp:65
bool _network_server
network-server is active
Definition: network.cpp:66
void ClientNetworkEmergencySave()
Create an emergency savegame when the network connection is lost.
@ INVALID_CLIENT_ID
Client is not part of anything.
Definition: network_type.h:50
@ SM_MENU
Switch to game intro menu.
Definition: openttd.h:33
static const StringID INVALID_STRING_ID
Constant representing an invalid string (16bit in case it is used in savegames)
Definition: strings_type.h:17
Internal entity of a packet.
Definition: packet.h:42
uint8_t Recv_uint8()
Read a 8 bits integer from the packet.
Definition: packet.cpp:318
PacketGameType
Enum with all types of TCP packets.
Definition: tcp_game.h:25
@ PACKET_CLIENT_IDENTIFY
Client telling the server the client's name and requested company.
Definition: tcp_game.h:68
@ PACKET_SERVER_JOIN
Tells clients that a new client has joined.
Definition: tcp_game.h:87
@ PACKET_SERVER_MAP_SIZE
Server tells the client what the (compressed) size of the map is.
Definition: tcp_game.h:82
@ PACKET_SERVER_RCON
Response of the executed command on the server.
Definition: tcp_game.h:111
@ PACKET_SERVER_MAP_BEGIN
Server tells the client that it is beginning to send the map.
Definition: tcp_game.h:81
@ PACKET_SERVER_SYNC
Server tells the client what the random state should be.
Definition: tcp_game.h:98
@ PACKET_CLIENT_GETMAP
Client requests the actual map.
Definition: tcp_game.h:79
@ PACKET_CLIENT_ERROR
A client reports an error to the server.
Definition: tcp_game.h:124
@ PACKET_SERVER_WAIT
Server tells the client there are some people waiting for the map as well.
Definition: tcp_game.h:80
@ PACKET_SERVER_CONFIG_UPDATE
Some network configuration important to the client changed.
Definition: tcp_game.h:119
@ PACKET_CLIENT_JOIN
The client telling the server it wants to join.
Definition: tcp_game.h:37
@ PACKET_CLIENT_AUTH_RESPONSE
The client responds to the authentication request.
Definition: tcp_game.h:64
@ PACKET_CLIENT_NEWGRFS_CHECKED
Client acknowledges that it has all required NewGRFs.
Definition: tcp_game.h:72
@ PACKET_SERVER_ENABLE_ENCRYPTION
The server tells that authentication has completed and requests to enable encryption with the keys of...
Definition: tcp_game.h:65
@ PACKET_SERVER_GAME_INFO
Information about the server.
Definition: tcp_game.h:45
@ PACKET_CLIENT_COMMAND
Client executed a command and sends it to the server.
Definition: tcp_game.h:101
@ PACKET_SERVER_ERROR_QUIT
A server tells that a client has hit an error and did quit.
Definition: tcp_game.h:125
@ PACKET_SERVER_CLIENT_INFO
Server sends you information about a client.
Definition: tcp_game.h:76
@ PACKET_CLIENT_SET_NAME
A client changes its name.
Definition: tcp_game.h:118
@ PACKET_SERVER_WELCOME
Server welcomes you and gives you your ClientID.
Definition: tcp_game.h:75
@ PACKET_CLIENT_ACK
The client tells the server which frame it has executed.
Definition: tcp_game.h:97
@ PACKET_SERVER_BANNED
The server has banned you.
Definition: tcp_game.h:34
@ PACKET_SERVER_FRAME
Server tells the client what frame it is in, and thus to where the client may progress.
Definition: tcp_game.h:96
@ PACKET_SERVER_EXTERNAL_CHAT
Server distributing the message from external source.
Definition: tcp_game.h:107
@ PACKET_SERVER_CHAT
Server distributing the message of a client (or itself).
Definition: tcp_game.h:106
@ PACKET_SERVER_COMMAND
Server distributes a command to (all) the clients.
Definition: tcp_game.h:102
@ PACKET_SERVER_SHUTDOWN
The server is shutting down.
Definition: tcp_game.h:50
@ PACKET_SERVER_AUTH_REQUEST
The server requests the client to authenticate using a number of methods.
Definition: tcp_game.h:63
@ PACKET_CLIENT_RCON
Client asks the server to execute some command.
Definition: tcp_game.h:110
@ PACKET_SERVER_NEWGAME
The server is preparing to start a new game.
Definition: tcp_game.h:49
@ PACKET_SERVER_MOVE
Server tells everyone that someone is moved to another company.
Definition: tcp_game.h:115
@ PACKET_SERVER_MAP_DATA
Server sends bits of the map to the client.
Definition: tcp_game.h:83
@ PACKET_CLIENT_MAP_OK
Client tells the server that it received the whole map.
Definition: tcp_game.h:85
@ PACKET_CLIENT_QUIT
A client tells the server it is going to quit.
Definition: tcp_game.h:122
@ PACKET_CLIENT_MOVE
A client would like to be moved to another company.
Definition: tcp_game.h:114
@ PACKET_SERVER_FULL
The server is full and has no place for you.
Definition: tcp_game.h:33
@ PACKET_SERVER_QUIT
A server tells that a client has quit.
Definition: tcp_game.h:123
@ PACKET_SERVER_ERROR
Server sending an error message to the client.
Definition: tcp_game.h:38
@ PACKET_SERVER_CHECK_NEWGRFS
Server sends NewGRF IDs and MD5 checksums for the client to check.
Definition: tcp_game.h:71
@ PACKET_SERVER_MAP_DONE
Server tells it has just sent the last bits of the map to the client.
Definition: tcp_game.h:84
@ PACKET_CLIENT_CHAT
Client said something that should be distributed.
Definition: tcp_game.h:105
@ PACKET_CLIENT_GAME_INFO
Request information about the server.
Definition: tcp_game.h:46