OpenTTD Source  20240919-master-gdf0233f4c2
PacketWriter Struct Reference

Writing a savegame directly to a number of packets. More...

Inheritance diagram for PacketWriter:
SaveFilter

Public Member Functions

 PacketWriter (ServerNetworkGameSocketHandler *cs)
 Create the packet writer. More...
 
 ~PacketWriter ()
 Make sure everything is cleaned up.
 
void Destroy ()
 Begin the destruction of this packet writer. More...
 
bool TransferToNetworkQueue ()
 Transfer all packets from here to the network's queue while holding the lock on our mutex. More...
 
void Write (uint8_t *buf, size_t size) override
 Write a given number of bytes into the savegame. More...
 
void Finish () override
 Prepare everything to finish writing the savegame.
 
- Public Member Functions inherited from SaveFilter
 SaveFilter (std::shared_ptr< SaveFilter > chain)
 Initialise this filter. More...
 
virtual ~SaveFilter ()
 Make sure the writers are properly closed.
 

Data Fields

ServerNetworkGameSocketHandlercs
 Socket we are associated with.
 
std::unique_ptr< Packetcurrent
 The packet we're currently writing to.
 
size_t total_size
 Total size of the compressed savegame.
 
std::deque< std::unique_ptr< Packet > > packets
 Packet queue of the savegame; send these "slowly" to the client. Cannot be a std::queue as we want to push the map size packet in front of the data packets.
 
std::mutex mutex
 Mutex for making threaded saving safe.
 
std::condition_variable exit_sig
 Signal for threaded destruction of this packet writer.
 
- Data Fields inherited from SaveFilter
std::shared_ptr< SaveFilterchain
 Chained to the (savegame) filters.
 

Detailed Description

Writing a savegame directly to a number of packets.

Definition at line 67 of file network_server.cpp.

Constructor & Destructor Documentation

◆ PacketWriter()

PacketWriter::PacketWriter ( ServerNetworkGameSocketHandler cs)
inline

Create the packet writer.

Parameters
csThe socket handler we're making the packets for.

Definition at line 79 of file network_server.cpp.

Member Function Documentation

◆ Destroy()

void PacketWriter::Destroy ( )
inline

Begin the destruction of this packet writer.

It can happen in two ways: in the first case the client disconnected while saving the map. In this case the saving has not finished and killed this PacketWriter. In that case we simply set cs to nullptr, triggering the appending to fail due to the connection problem and eventually triggering the destructor. In the second case the destructor is already called, and it is waiting for our signal which we will send. Only then the packets will be removed by the destructor.

Definition at line 106 of file network_server.cpp.

References lock.

◆ TransferToNetworkQueue()

bool PacketWriter::TransferToNetworkQueue ( )
inline

Transfer all packets from here to the network's queue while holding the lock on our mutex.

Returns
True iff the last packet of the map has been sent.

Definition at line 126 of file network_server.cpp.

References lock, PACKET_SERVER_MAP_DONE, and NetworkTCPSocketHandler::SendPacket().

◆ Write()

void PacketWriter::Write ( uint8_t *  buf,
size_t  len 
)
inlineoverridevirtual

Write a given number of bytes into the savegame.

Parameters
bufThe bytes to write.
lenThe number of bytes to write.

Implements SaveFilter.

Definition at line 144 of file network_server.cpp.

References lock, PACKET_SERVER_MAP_DATA, SlError(), and TCP_MTU.


The documentation for this struct was generated from the following file: