From 66632fec0001a4fbc14b8ef554c67c22c8826f1d Mon Sep 17 00:00:00 2001 From: Meta Vens Date: Mon, 13 Jul 2026 02:00:41 +0100 Subject: [PATCH] Support shared-memory body capabilities --- src/GameCult.Mesh/CultMeshBodies.cs | 41 ++++++++++++++++++- .../CultMeshBodyTransportTests.cs | 24 +++++++++++ 2 files changed, 63 insertions(+), 2 deletions(-) diff --git a/src/GameCult.Mesh/CultMeshBodies.cs b/src/GameCult.Mesh/CultMeshBodies.cs index 2fabe687..8b06cd64 100644 --- a/src/GameCult.Mesh/CultMeshBodies.cs +++ b/src/GameCult.Mesh/CultMeshBodies.cs @@ -276,6 +276,38 @@ namespace GameCult.Mesh } } + public sealed class CultMeshSharedMemoryBodyAdapter : ICultMeshBodyTransportAdapter + { + public CultMeshBodyTransportKind TransportKind => CultMeshBodyTransportKind.SharedMemory; + public bool CanOpen(CultMeshBodyDescriptor descriptor) => + descriptor != null && descriptor.TransportKind == TransportKind; + + public ICultMeshBodyReadLease OpenReadOnly( + CultMeshBodyDescriptor descriptor, + CultMeshBodyValidationRequest request) + { + CultMeshBodyDescriptorValidator.Validate(descriptor, request); + MemoryMappedFile mapping; + try + { + mapping = MemoryMappedFile.OpenExisting(descriptor.CapabilityToken, MemoryMappedFileRights.Read); + } + catch (FileNotFoundException error) + { + throw new InvalidDataException("CultMesh shared-memory capability is unavailable or revoked.", error); + } + try + { + return new CultMeshMappedBodyLease(descriptor, mapping); + } + catch + { + mapping.Dispose(); + throw; + } + } + } + public sealed class CultMeshMappedBodyLease : ICultMeshBodyReadLease { private readonly MemoryMappedFile _mapping; @@ -283,14 +315,19 @@ namespace GameCult.Mesh private bool _disposed; internal CultMeshMappedBodyLease(CultMeshBodyDescriptor descriptor, string path) + : this(descriptor, MemoryMappedFile.CreateFromFile(path, FileMode.Open, null, 0, MemoryMappedFileAccess.Read)) + { + } + + internal CultMeshMappedBodyLease(CultMeshBodyDescriptor descriptor, MemoryMappedFile mapping) { Descriptor = descriptor; - _mapping = MemoryMappedFile.CreateFromFile(path, FileMode.Open, null, 0, MemoryMappedFileAccess.Read); + _mapping = mapping; _view = _mapping.CreateViewAccessor(0, descriptor.ByteSize, MemoryMappedFileAccess.Read); } public CultMeshBodyDescriptor Descriptor { get; } - public CultMeshBodyTransportKind TransportKind => CultMeshBodyTransportKind.SharedFileMapping; + public CultMeshBodyTransportKind TransportKind => Descriptor.TransportKind; public byte ReadByte(long offset) { ValidateRange(offset, 1); return _view.ReadByte(offset); } public int ReadInt32(long offset) { ValidateRange(offset, sizeof(int)); return _view.ReadInt32(offset); } public long ReadInt64(long offset) { ValidateRange(offset, sizeof(long)); return _view.ReadInt64(offset); } diff --git a/tests/GameCult.Mesh.Tests/CultMeshBodyTransportTests.cs b/tests/GameCult.Mesh.Tests/CultMeshBodyTransportTests.cs index d0e604f6..ac411a3a 100644 --- a/tests/GameCult.Mesh.Tests/CultMeshBodyTransportTests.cs +++ b/tests/GameCult.Mesh.Tests/CultMeshBodyTransportTests.cs @@ -2,6 +2,7 @@ using System; using System.IO; using FluentAssertions; using NUnit.Framework; +using System.IO.MemoryMappedFiles; namespace GameCult.Mesh.Tests; @@ -147,6 +148,29 @@ public sealed class CultMeshBodyTransportTests open.Should().Throw(); } + [Test] + [Platform("Win")] + public void SharedMemoryAdapter_OpensOpaqueCapabilityReadOnly() + { + var token = "CultMesh.Body.Test." + Guid.NewGuid().ToString("N"); + using var mapping = MemoryMappedFile.CreateNew(token, 8, MemoryMappedFileAccess.ReadWrite); + using (var writer = mapping.CreateViewAccessor(0, 8, MemoryMappedFileAccess.Write)) writer.Write(0, 99L); + var now = DateTimeOffset.UtcNow; + var descriptor = new CultMeshBodyDescriptor + { + BodyId = "body", SchemaId = "schema", LayoutVersion = 1, + ByteSize = 8, Capacity = 8, ProducerEpoch = 4, Sequence = 2, + LeaseExpiresAtUnixMs = now.AddMinutes(1).ToUnixTimeMilliseconds(), + TransportKind = CultMeshBodyTransportKind.SharedMemory, + CapabilityToken = token + }; + + using var lease = new CultMeshSharedMemoryBodyAdapter().OpenReadOnly(descriptor, Request(descriptor, now)); + + lease.ReadInt64(0).Should().Be(99); + lease.TransportKind.Should().Be(CultMeshBodyTransportKind.SharedMemory); + } + private static CultMeshBodyValidationRequest Request(CultMeshBodyDescriptor descriptor, DateTimeOffset now) => new() { BodyId = descriptor.BodyId,