> [!IMPORTANT] > **Breaking Changes** > - DecodePacket and EncodePacket delegates replaced with IClientEncryption interface > - NetState.Connection (Socket) replaced with internal RingSocket management > - NetState.RecvPipe and NetState.SendPipe removed (buffers managed internally) ## Summary Upgrades the networking stack from PollGroup-based I/O to io_uring, significantly improving I/O performance on Linux. This also adds native client encryption support for encrypted UO clients. ## Major Changes io_uring Networking Architecture - Replaced PollGroup with IORingGroup for async socket I/O operations - Removed Pipe.cs (mirrored ring buffer) and TcpServer.cs in favor of RingSocketManager - Added NetState.Network.cs - centralized network infrastructure handling accept, recv, send, and disconnect completions - Added SocketHelper.cs - platform-specific socket utilities for raw socket handle operations (getpeername, getsockname) - Buffer management now handled by RingSocketManager with configurable slab allocation ### Client Encryption Support - Added full encryption stack in Network/Encryption/: - EncryptionConfig.cs - configurable encryption modes (None, Unencrypted, Encrypted, Both) - EncryptionManager.cs - encryption detection and initialization for login/game packets - LoginEncryption.cs - handles login packet encryption with version-derived keys - GameEncryption.cs - handles game server encryption using Twofish - TwofishEngine.cs - optimized Twofish block cipher implementation - LoginKeys.cs - encryption key table for client versions - IClientEncryption.cs - interface for client encryption implementations ### NetState Improvements - Replaced Socket Connection with RingSocket _socket for managed socket lifecycle - Changed from GCHandle polling to event-based completion processing - Disconnect handling now properly waits for pending sends to flush - Simplified connecting socket management using lazy queue removal ### Configuration - New settings: network.encryptionMode and network.encryptionDebug - Encryption mode flags: Unencrypted, Encrypted, or Both ### Dependencies - Replaced PollGroup NuGet package with IORingGroup - Linux requires liburing-dev / liburing-devel package ### Test plan - Verify server starts and accepts connections on Linux with io_uring - Verify server starts and accepts connections on Windows (fallback to IOCP) - Test unencrypted client connections (ClassicUO with encryption disabled) - Test encrypted client connections if available - Verify graceful disconnect flushes pending data - Confirm CI builds pass on all target platforms
222 lines
5.1 KiB
C#
222 lines
5.1 KiB
C#
using Server.Network;
|
|
using Server.Prompts;
|
|
using Xunit;
|
|
|
|
namespace Server.Tests.Network;
|
|
|
|
[Collection("Sequential Server Tests")]
|
|
public class MessageTests
|
|
{
|
|
[Fact]
|
|
public void TestMessageLocalized()
|
|
{
|
|
var serial = (Serial)0x1024;
|
|
var graphic = 0x100;
|
|
var messageType = MessageType.Label;
|
|
var hue = 1024;
|
|
var font = 3;
|
|
var number = 150000;
|
|
var name = "Stuff";
|
|
var args = "Arguments";
|
|
|
|
var expected = new MessageLocalized(
|
|
serial,
|
|
graphic,
|
|
messageType,
|
|
hue,
|
|
font,
|
|
number,
|
|
name,
|
|
args
|
|
).Compile();
|
|
|
|
using var ns = PacketTestUtilities.CreateTestNetState();
|
|
ns.SendMessageLocalized(
|
|
serial,
|
|
graphic,
|
|
messageType,
|
|
hue,
|
|
font,
|
|
number,
|
|
name,
|
|
args
|
|
);
|
|
|
|
var result = ns.SendBuffer.GetReadSpan();
|
|
AssertThat.Equal(result, expected);
|
|
}
|
|
|
|
[Fact]
|
|
public void TestMessageLocalizedAffix()
|
|
{
|
|
var serial = (Serial)0x1024;
|
|
var graphic = 0x100;
|
|
var messageType = MessageType.Label;
|
|
var hue = 1024;
|
|
var font = 3;
|
|
var number = 150000;
|
|
var name = "Stuff";
|
|
var args = "Arguments";
|
|
var affixType = AffixType.System;
|
|
var affix = "Affix";
|
|
|
|
var expected = new MessageLocalizedAffix(
|
|
serial,
|
|
graphic,
|
|
messageType,
|
|
hue,
|
|
font,
|
|
number,
|
|
name,
|
|
affixType,
|
|
affix,
|
|
args
|
|
).Compile();
|
|
|
|
using var ns = PacketTestUtilities.CreateTestNetState();
|
|
ns.SendMessageLocalizedAffix(
|
|
serial,
|
|
graphic,
|
|
messageType,
|
|
hue,
|
|
font,
|
|
number,
|
|
name,
|
|
affixType,
|
|
affix,
|
|
args
|
|
);
|
|
|
|
var result = ns.SendBuffer.GetReadSpan();
|
|
AssertThat.Equal(result, expected);
|
|
}
|
|
|
|
[Fact]
|
|
public void TestAsciiMessage()
|
|
{
|
|
var serial = (Serial)0x1024;
|
|
var graphic = 0x100;
|
|
var messageType = MessageType.Label;
|
|
var hue = 1024;
|
|
var font = 3;
|
|
var name = "Stuff";
|
|
var text = "Some Text";
|
|
|
|
var expected = new AsciiMessage(
|
|
serial,
|
|
graphic,
|
|
messageType,
|
|
hue,
|
|
font,
|
|
name,
|
|
text
|
|
).Compile();
|
|
|
|
using var ns = PacketTestUtilities.CreateTestNetState();
|
|
ns.SendMessage(
|
|
serial,
|
|
graphic,
|
|
messageType,
|
|
hue,
|
|
font,
|
|
true,
|
|
null,
|
|
name,
|
|
text
|
|
);
|
|
|
|
var result = ns.SendBuffer.GetReadSpan();
|
|
AssertThat.Equal(result, expected);
|
|
}
|
|
|
|
[Fact]
|
|
public void TestUnicodeMessage()
|
|
{
|
|
var serial = (Serial)0x1024;
|
|
var graphic = 0x100;
|
|
var messageType = MessageType.Label;
|
|
var hue = 1024;
|
|
var font = 3;
|
|
var lang = "ENU";
|
|
var name = "Stuff";
|
|
var text = "Some Text";
|
|
|
|
var expected = new UnicodeMessage(
|
|
serial,
|
|
graphic,
|
|
messageType,
|
|
hue,
|
|
font,
|
|
lang,
|
|
name,
|
|
text
|
|
).Compile();
|
|
|
|
using var ns = PacketTestUtilities.CreateTestNetState();
|
|
ns.SendMessage(
|
|
serial,
|
|
graphic,
|
|
messageType,
|
|
hue,
|
|
font,
|
|
false,
|
|
lang,
|
|
name,
|
|
text
|
|
);
|
|
|
|
var result = ns.SendBuffer.GetReadSpan();
|
|
AssertThat.Equal(result, expected);
|
|
}
|
|
|
|
[Fact]
|
|
public void TestFollowMessage()
|
|
{
|
|
var serial = (Serial)0x1024;
|
|
var serial2 = (Serial)0x2;
|
|
|
|
var expected = new FollowMessage(serial, serial2).Compile();
|
|
|
|
using var ns = PacketTestUtilities.CreateTestNetState();
|
|
ns.SendFollowMessage(serial, serial2);
|
|
|
|
var result = ns.SendBuffer.GetReadSpan();
|
|
AssertThat.Equal(result, expected);
|
|
}
|
|
|
|
[Fact]
|
|
public void TestObjectHelpResponse()
|
|
{
|
|
var s = (Serial)0x100;
|
|
var text = "This is some testing text";
|
|
|
|
var expected = new ObjectHelpResponse(s, text).Compile();
|
|
|
|
using var ns = PacketTestUtilities.CreateTestNetState();
|
|
ns.SendHelpResponse(s, text);
|
|
|
|
var result = ns.SendBuffer.GetReadSpan();
|
|
AssertThat.Equal(result, expected);
|
|
}
|
|
|
|
internal class TestPrompt : Prompt
|
|
{
|
|
}
|
|
|
|
[Collection("Sequential Server Tests")]
|
|
public class UnicodePromptTests
|
|
{
|
|
[Fact]
|
|
public void TestUnicodePrompt()
|
|
{
|
|
var prompt = new TestPrompt();
|
|
var expected = new UnicodePrompt(prompt).Compile();
|
|
|
|
using var ns = PacketTestUtilities.CreateTestNetState();
|
|
ns.SendPrompt(prompt);
|
|
|
|
var result = ns.SendBuffer.GetReadSpan();
|
|
AssertThat.Equal(result, expected);
|
|
}
|
|
}
|
|
}
|