internal InterProcessMlosContext(
SharedMemoryRegionView <MlosProxyInternal.GlobalMemoryRegion> globalMemoryRegionView,
SharedMemoryMapView controlChannelMemoryMapView,
SharedMemoryMapView feedbackChannelMemoryMapView,
SharedMemoryRegionView <MlosProxyInternal.SharedConfigMemoryRegion> sharedConfigMemoryMapView,
NamedEvent controlChannelNamedEvent,
NamedEvent feedbackChannelNamedEvent)
{
this.globalMemoryRegionView = globalMemoryRegionView;
this.controlChannelMemoryMapView = controlChannelMemoryMapView;
this.feedbackChannelMemoryMapView = feedbackChannelMemoryMapView;
this.sharedConfigMemoryMapView = sharedConfigMemoryMapView;
this.controlChannelNamedEvent = controlChannelNamedEvent;
this.feedbackChannelNamedEvent = feedbackChannelNamedEvent;
MlosProxyInternal.GlobalMemoryRegion globalMemoryRegion = globalMemoryRegionView.MemoryRegion();
// Increase the usage counter. When closing global shared memory, we will decrease the counter.
// If there is no process using the shared memory, we will clean the OS resources. On Windows OS,
// this is no-op; on Linux, we unlink created files.
//
globalMemoryRegion.AttachedProcessesCount.FetchAdd(1);
// Create the control channel instance.
//
ControlChannel = new SharedChannel <InterProcessSharedChannelPolicy, SharedChannelSpinPolicy>(
buffer: controlChannelMemoryMapView.Buffer,
size: (uint)controlChannelMemoryMapView.MemSize,
sync: globalMemoryRegion.ControlChannelSynchronization)
{
ChannelPolicy = { NotificationEvent = controlChannelNamedEvent },
};
// Create the feedback channel instance.
//
FeedbackChannel = new SharedChannel <InterProcessSharedChannelPolicy, SharedChannelSpinPolicy>(
buffer: feedbackChannelMemoryMapView.Buffer,
size: (uint)feedbackChannelMemoryMapView.MemSize,
sync: globalMemoryRegion.FeedbackChannelSynchronization)
{
ChannelPolicy = { NotificationEvent = feedbackChannelNamedEvent },
};
}
/// <summary>
/// Initializes a new instance of the <see cref="InterProcessMlosContext"/> class.
/// </summary>
/// <returns>InterProcessMlosContext instance.</returns>
public static InterProcessMlosContext CreateOrOpen()
{
// Create or open the memory mapped files.
//
SharedMemoryRegionView <MlosProxyInternal.GlobalMemoryRegion> globalMemoryRegionView = SharedMemoryRegionView.CreateOrOpen <MlosProxyInternal.GlobalMemoryRegion>(GlobalMemoryMapName, SharedMemorySize);
SharedMemoryMapView controlChannelMemoryMapView = SharedMemoryMapView.CreateOrOpen(ControlChannelMemoryMapName, SharedMemorySize);
SharedMemoryMapView feedbackChannelMemoryMapView = SharedMemoryMapView.CreateOrOpen(FeedbackChannelMemoryMapName, SharedMemorySize);
// Create channel synchronization primitives.
//
NamedEvent controlChannelNamedEvent = NamedEvent.CreateOrOpen(ControlChannelSemaphoreName);
NamedEvent feedbackChannelNamedEvent = NamedEvent.CreateOrOpen(FeedbackChannelSemaphoreName);
return(new InterProcessMlosContext(
globalMemoryRegionView,
controlChannelMemoryMapView,
feedbackChannelMemoryMapView,
controlChannelNamedEvent,
feedbackChannelNamedEvent));
}
/// <summary>
/// Registers a shared config memory region created by the target process.
/// </summary>
/// <param name="sharedMemoryRegionIndex"></param>
/// <param name="sharedMemoryMapName"></param>
/// <param name="memoryRegionSize"></param>
public void RegisterSharedConfigMemoryRegion(uint sharedMemoryRegionIndex, string sharedMemoryMapName, ulong memoryRegionSize)
{
if (sharedConfigMemoryRegionView != null)
{
if (sharedConfigMemoryRegionView.MemoryRegion().MemoryHeader.MemoryRegionId.Index == sharedMemoryRegionIndex)
{
// Shared memory region has been already registered.
//
return;
}
else
{
throw new NotImplementedException("Only a single shared config memory region is currently supported.");
}
}
// Create a shared config memory region.
//
SharedMemoryMapView sharedConfigMemoryMapView = SharedMemoryMapView.OpenExisting(
sharedMemoryMapName,
memoryRegionSize);
sharedConfigMemoryRegionView = new SharedMemoryRegionView <MlosProxyInternal.SharedConfigMemoryRegion>(sharedConfigMemoryMapView);
}
/// <summary>
/// Initializes a new instance of the <see cref="InterProcessMlosContext"/> class.
/// </summary>
/// <returns>InterProcessMlosContext instance.</returns>
public static InterProcessMlosContext Create()
{
var targetProcessNamedEvent = NamedEvent.CreateOrOpen(TargetProcessEventName);
{
bool shouldWaitForTargetProcess = false;
try
{
// Try open a global shared memory and check if the target process is fully initialized.
//
using var targetProcessMemoryRegionView = SharedMemoryRegionView.OpenExisting <MlosProxyInternal.GlobalMemoryRegion>(GlobalMemoryMapName, MlosInternal.GlobalMemoryRegion.GlobalSharedMemorySize);
// If RegisteredSettingsAssemblyCount is 0, the context is not created.
//
if (targetProcessMemoryRegionView.MemoryRegion().RegisteredSettingsAssemblyCount.Load() == 0)
{
shouldWaitForTargetProcess = true;
}
}
catch (FileNotFoundException)
{
// If the target process is not running.
//
shouldWaitForTargetProcess = true;
}
if (shouldWaitForTargetProcess)
{
// If the target process is not fully initialized, wait for the signal.
//
targetProcessNamedEvent.Wait();
targetProcessNamedEvent.Signal();
}
}
// Open global memory region.
//
var globalMemoryRegionView = SharedMemoryRegionView.OpenExisting <MlosProxyInternal.GlobalMemoryRegion>(GlobalMemoryMapName, MlosInternal.GlobalMemoryRegion.GlobalSharedMemorySize);
GlobalMemoryRegion globalMemoryRegion = globalMemoryRegionView.MemoryRegion();
// Open existing shared channels memory maps.
//
globalMemoryRegion.TryOpenExisting(
new MlosInternal.MemoryRegionId {
Type = MlosInternal.MemoryRegionType.ControlChannel, Index = 0,
},
out SharedMemoryMapView controlChannelMemoryMapView);
globalMemoryRegion.TryOpenExisting(
new MlosInternal.MemoryRegionId {
Type = MlosInternal.MemoryRegionType.FeedbackChannel, Index = 0,
},
out SharedMemoryMapView feedbackChannelMemoryMapView);
// Open existing channel synchronization primitives.
//
globalMemoryRegion.TryOpenExisting(
new MlosInternal.MemoryRegionId {
Type = MlosInternal.MemoryRegionType.ControlChannel, Index = 0,
},
out NamedEvent controlChannelNamedEvent);
globalMemoryRegion.TryOpenExisting(
new MlosInternal.MemoryRegionId {
Type = MlosInternal.MemoryRegionType.FeedbackChannel, Index = 0,
},
out NamedEvent feedbackChannelNamedEvent);
return(new InterProcessMlosContext(
globalMemoryRegionView,
controlChannelMemoryMapView,
feedbackChannelMemoryMapView,
controlChannelNamedEvent,
feedbackChannelNamedEvent,
targetProcessNamedEvent));
}
/// <summary>
/// Initializes a new instance of the <see cref="InterProcessMlosContext"/> class.
/// </summary>
/// <param name="globalMemoryRegionView"></param>
/// <param name="controlChannelMemoryMapView"></param>
/// <param name="feedbackChannelMemoryMapView"></param>
/// <param name="controlChannelNamedEvent"></param>
/// <param name="feedbackChannelNamedEvent"></param>
/// <param name="targetProcessNamedEvent"></param>
private InterProcessMlosContext(
SharedMemoryRegionView <MlosProxyInternal.GlobalMemoryRegion> globalMemoryRegionView,
SharedMemoryMapView controlChannelMemoryMapView,
SharedMemoryMapView feedbackChannelMemoryMapView,
NamedEvent controlChannelNamedEvent,
NamedEvent feedbackChannelNamedEvent,
NamedEvent targetProcessNamedEvent)
{
this.globalMemoryRegionView = globalMemoryRegionView ?? throw new ArgumentNullException(nameof(globalMemoryRegionView));
this.controlChannelMemoryMapView = controlChannelMemoryMapView ?? throw new ArgumentNullException(nameof(controlChannelMemoryMapView));
this.feedbackChannelMemoryMapView = feedbackChannelMemoryMapView ?? throw new ArgumentNullException(nameof(feedbackChannelMemoryMapView));
this.controlChannelNamedEvent = controlChannelNamedEvent ?? throw new ArgumentNullException(nameof(controlChannelNamedEvent));
this.feedbackChannelNamedEvent = feedbackChannelNamedEvent ?? throw new ArgumentNullException(nameof(feedbackChannelNamedEvent));
this.targetProcessNamedEvent = targetProcessNamedEvent ?? throw new ArgumentNullException(nameof(targetProcessNamedEvent));
// Create the shared config manager.
//
SharedConfigManager = new SharedConfigManager();
MlosProxyInternal.GlobalMemoryRegion globalMemoryRegion = globalMemoryRegionView.MemoryRegion();
// Increase the usage counter. When closing global shared memory, we will decrease the counter.
// If there is no process using the shared memory, we will clean the OS resources. On Windows OS,
// this is no-op; on Linux, we unlink created files.
//
globalMemoryRegion.AttachedProcessesCount.FetchAdd(1);
// Create the control channel instance.
//
ControlChannel = new SharedChannel <InterProcessSharedChannelPolicy, SharedChannelSpinPolicy>(
buffer: controlChannelMemoryMapView.Buffer,
size: (uint)controlChannelMemoryMapView.MemSize,
sync: globalMemoryRegion.ControlChannelSynchronization)
{
ChannelPolicy = { NotificationEvent = controlChannelNamedEvent },
};
// Create the feedback channel instance.
//
FeedbackChannel = new SharedChannel <InterProcessSharedChannelPolicy, SharedChannelSpinPolicy>(
buffer: feedbackChannelMemoryMapView.Buffer,
size: (uint)feedbackChannelMemoryMapView.MemSize,
sync: globalMemoryRegion.FeedbackChannelSynchronization)
{
ChannelPolicy = { NotificationEvent = feedbackChannelNamedEvent },
};
// Register config region if available.
//
if (globalMemoryRegion.TryOpenExisting(
new MlosInternal.MemoryRegionId {
Type = MlosInternal.MemoryRegionType.SharedConfig, Index = 0,
},
out SharedMemoryMapView sharedConfigMemoryMap))
{
var sharedMemoryRegionView = new SharedMemoryRegionView <MlosProxyInternal.SharedConfigMemoryRegion>(sharedConfigMemoryMap);
SharedConfigManager.RegisterSharedConfigMemoryRegion(sharedMemoryRegionView);
}
else
{
sharedConfigMemoryMap?.Dispose();
}
}
/// <summary>
/// Registers a shared config memory region created by the target process.
/// </summary>
/// <param name="sharedConfigMemoryRegionView"></param>
public void RegisterSharedConfigMemoryRegion(SharedMemoryRegionView <MlosProxyInternal.SharedConfigMemoryRegion> sharedConfigMemoryRegionView)
{
this.sharedConfigMemoryRegionView = sharedConfigMemoryRegionView;
}
/// <summary>
/// Initializes a new instance of the <see cref="InterProcessMlosContext"/> class.
/// </summary>
/// <returns>InterProcessMlosContext instance.</returns>
public static InterProcessMlosContext CreateOrOpen()
{
NamedEvent targetProcessNamedEvent = NamedEvent.CreateOrOpen(TargetProcessEventName);
{
bool shouldWaitForTargetProcess = false;
try
{
// Try open a global shared memory and check if the tager process is fully initialized.
//
using SharedMemoryRegionView <MlosProxyInternal.GlobalMemoryRegion> targetProcessMemoryRegionView = SharedMemoryRegionView.OpenExisting <MlosProxyInternal.GlobalMemoryRegion>(GlobalMemoryMapName, SharedMemorySize);
if (targetProcessMemoryRegionView.MemoryRegion().GlobalMemoryRegionIndex == 1)
{
shouldWaitForTargetProcess = true;
}
}
catch (FileNotFoundException)
{
// If the target process is not running.
//
shouldWaitForTargetProcess = true;
}
if (shouldWaitForTargetProcess)
{
// If the target process is not fully initialized, wait for the signal.
//
targetProcessNamedEvent.Wait();
targetProcessNamedEvent.Signal();
}
}
SharedMemoryRegionView <MlosProxyInternal.GlobalMemoryRegion> globalMemoryRegionView = SharedMemoryRegionView.OpenExisting <MlosProxyInternal.GlobalMemoryRegion>(GlobalMemoryMapName, SharedMemorySize);
SharedMemoryMapView controlChannelMemoryMapView = SharedMemoryMapView.OpenExisting(ControlChannelMemoryMapName, SharedMemorySize);
SharedMemoryMapView feedbackChannelMemoryMapView = SharedMemoryMapView.OpenExisting(FeedbackChannelMemoryMapName, SharedMemorySize);
// Create channel synchronization primitives.
//
NamedEvent controlChannelNamedEvent = NamedEvent.CreateOrOpen(ControlChannelEventName);
NamedEvent feedbackChannelNamedEvent = NamedEvent.CreateOrOpen(FeedbackChannelEventName);
return(new InterProcessMlosContext(
globalMemoryRegionView,
controlChannelMemoryMapView,
feedbackChannelMemoryMapView,
controlChannelNamedEvent,
feedbackChannelNamedEvent,
targetProcessNamedEvent));
}