OpenTTD
network_func.h
Go to the documentation of this file.
1 /* $Id: network_func.h 27400 2015-09-19 16:49:46Z rubidium $ */
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 
12 #ifndef NETWORK_FUNC_H
13 #define NETWORK_FUNC_H
14 
19 // #define DEBUG_DUMP_COMMANDS
20 // #define DEBUG_FAILED_DUMP_COMMANDS
21 
22 #include "core/address.h"
23 #include "network_type.h"
24 #include "../console_type.h"
25 #include "../gfx_type.h"
26 #include "../openttd.h"
27 #include "../company_type.h"
28 
29 #ifdef ENABLE_NETWORK
30 
33 
36 extern bool _network_need_advertise;
37 extern uint8 _network_reconnect;
41 
42 byte NetworkSpectatorCount();
45 const char *NetworkChangeCompanyPassword(CompanyID company_id, const char *password);
46 void NetworkReboot();
47 void NetworkDisconnect(bool blocking = false, bool close_admins = true);
48 void NetworkGameLoop();
50 void ParseConnectionString(const char **company, const char **port, char *connection_string);
51 void NetworkStartDebugLog(NetworkAddress address);
53 
54 void NetworkUpdateClientInfo(ClientID client_id);
56 void NetworkClientConnectGame(NetworkAddress address, CompanyID join_as, const char *join_server_password = NULL, const char *join_company_password = NULL);
57 void NetworkClientRequestMove(CompanyID company, const char *pass = "");
58 void NetworkClientSendRcon(const char *password, const char *command);
59 void NetworkClientSendChat(NetworkAction action, DestType type, int dest, const char *msg, int64 data = 0);
61 bool NetworkCompanyIsPassworded(CompanyID company_id);
64 void NetworkPrintClients();
65 void NetworkHandlePauseChange(PauseMode prev_mode, PauseMode changed_mode);
66 
67 /*** Commands ran by the server ***/
73 bool NetworkServerStart();
74 void NetworkServerNewCompany(const Company *company, NetworkClientInfo *ci);
75 bool NetworkServerChangeClientName(ClientID client_id, const char *new_name);
76 
77 
78 void NetworkServerDoMove(ClientID client_id, CompanyID company_id);
79 void NetworkServerSendRcon(ClientID client_id, TextColour colour_code, const char *string);
80 void NetworkServerSendChat(NetworkAction action, DestType type, int dest, const char *msg, ClientID from_id, int64 data = 0, bool from_admin = false);
81 
82 void NetworkServerKickClient(ClientID client_id);
83 uint NetworkServerKickOrBanIP(ClientID client_id, bool ban);
84 uint NetworkServerKickOrBanIP(const char *ip, bool ban);
85 
87 void CDECL NetworkAddChatMessage(TextColour colour, uint duration, const char *message, ...) WARN_FORMAT(3, 4);
90 
92 
93 #endif /* ENABLE_NETWORK */
94 #endif /* NETWORK_FUNC_H */
uint NetworkServerKickOrBanIP(ClientID client_id, bool ban)
Ban, or kick, everyone joined from the given client&#39;s IP.
uint8 _network_reconnect
Reconnect timeout.
Definition: network.cpp:66
void NetworkInitChatMessage()
Initialize all buffers of the chat visualisation.
bool NetworkCompanyIsPassworded(CompanyID company_id)
Check if the company we want to join requires a password.
Definition: network.cpp:225
Container for all information known about a client.
Definition: network_base.h:27
void NetworkServerShowStatusToConsole()
Show the status message of all clients on the console.
void ParseConnectionString(const char **company, const char **port, char *connection_string)
Converts a string to ip/port/company Format: IP:port::company.
Definition: network.cpp:474
The game information that is not generated on-the-fly and has to be sent to the clients.
Definition: game.h:28
bool NetworkCompanyHasClients(CompanyID company)
Check whether a particular company has clients.
void NetworkPopulateCompanyStats(NetworkCompanyStats *stats)
Populate the company stats.
void NetworkDisconnect(bool blocking=false, bool close_admins=true)
We want to disconnect from the host/clients.
Definition: network.cpp:798
void NetworkUpdateClientInfo(ClientID client_id)
Send updated client info of a particular client.
Wrapper for (un)resolved network addresses; there&#39;s no reason to transform a numeric IP to a string a...
Definition: address.h:31
void NetworkServerDoMove(ClientID client_id, CompanyID company_id)
Handle the tid-bits of moving a client from one company to another.
void NetworkClientRequestMove(CompanyID company, const char *pass="")
Notify the server of this client wanting to be moved to another company.
StringList _network_bind_list
The addresses to bind on.
Definition: network.cpp:67
void NetworkHandlePauseChange(PauseMode prev_mode, PauseMode changed_mode)
Handle the pause mode change so we send the right messages to the chat.
Definition: network.cpp:348
void NetworkServerDailyLoop()
Daily "callback".
const char * NetworkChangeCompanyPassword(CompanyID company_id, const char *password)
Change the company password of a given company.
Definition: network.cpp:174
bool NetworkMaxSpectatorsReached()
Check if max_spectatos has been reached on the server (local check only).
void NetworkServerKickClient(ClientID client_id)
Kick a single client.
void NetworkServerYearlyLoop()
Yearly "callback".
TextColour
Colour of the strings, see _string_colourmap in table/string_colours.h or docs/ottd-colourtext-palett...
Definition: gfx_type.h:247
bool NetworkClientPreferTeamChat(const NetworkClientInfo *cio)
Tell whether the client has team members where he/she can chat to.
void NetworkPrintClients()
Print all the clients to the console.
Wrapper for network addresses.
bool NetworkMaxCompaniesReached()
Check if max_companies has been reached on the server (local check only).
void NetworkServerSendRcon(ClientID client_id, TextColour colour_code, const char *string)
Send an rcon reply to the client.
void NetworkClientSendRcon(const char *password, const char *command)
Send a remote console command.
void NetworkBackgroundLoop()
We have to do some (simple) background stuff that runs normally, even when we are not in multiplayer...
Definition: network.cpp:856
StringList _network_host_list
The servers we know.
Definition: network.cpp:68
bool NetworkServerChangeClientName(ClientID client_id, const char *new_name)
Change the client name of the given client.
void NetworkUpdateClientName()
Send the server our name.
void NetworkServerSendChat(NetworkAction action, DestType type, int dest, const char *msg, ClientID from_id, int64 data=0, bool from_admin=false)
Send an actual chat message.
void NetworkServerSendConfigUpdate()
Send Config Update.
void NetworkClientSendChat(NetworkAction action, DestType type, int dest, const char *msg, int64 data=0)
Send a chat message.
ClientID _network_own_client_id
Our client identifier.
Definition: network.cpp:63
Types used for networking.
bool _network_need_advertise
Whether we need to advertise.
Definition: network.cpp:65
void NetworkServerNewCompany(const Company *company, NetworkClientInfo *ci)
Perform all the server specific administration of a new company.
ClientID
&#39;Unique&#39; identifier to be given to clients
Definition: network_type.h:43
NetworkServerGameInfo _network_game_info
Uncomment the following define to enable command replaying.
Definition: network.cpp:61
PauseMode
Modes of pausing we&#39;ve got.
Definition: openttd.h:57
void NetworkClientsToSpectators(CompanyID cid)
Move the clients of a company to the spectators.
void CDECL NetworkAddChatMessage(TextColour colour, uint duration, const char *message,...)
Add a text message to the &#39;chat window&#39; to be shown.
void NetworkChatMessageLoop()
Check if a message is expired.
StringList _network_ban_list
The banned clients.
Definition: network.cpp:69
Simple calculated statistics of a company.
Definition: network_type.h:61
void NetworkAfterNewGRFScan()
Rebuild the GRFConfig&#39;s of the servers in the game list as we did a rescan and might have found new N...
void CDECL void NetworkUndrawChatMessage()
Hide the chatbox.
void NetworkServerMonthlyLoop()
Monthly "callback".
Some state information of a company, especially for servers.
Definition: network_type.h:68
Owner
Enum for all companies/owners.
Definition: company_type.h:20
ClientID _redirect_console_to_client
If not invalid, redirect the console output to a client.
Definition: network.cpp:64
DestType
Destination of our chat messages.
Definition: network_type.h:82
NetworkCompanyState * _network_company_states
Statistics about some companies.
Definition: network.cpp:62
NetworkAction
Actions that can be used for NetworkTextMessage.
Definition: network_type.h:89