MemoryModule.NET

 

Package	Version
Cross platform
Windows
Linux	Coming soon (see the Abstractions branch)
MacOS	Coming soon (see the Abstractions branch)

Loads unmanaged libraries right from your embedded resources! Works on Windows and Linux only, both on .NET Framework and .NET Core (and of course .NET 5.0+)

Features:

• Load x86 and x64 assemblies, right from the memory. No P/Invoke, no temporary files.
• Correctly resolves loaded unmanaged libraries, and exposes a AssemblyResolve event for users to manually handle it.
• Linux x86 (32 and 64 bit) support, through interoperation with glibc.

Sample code:

using MemoryModule;

        [UnmanagedFunctionPointer(CallingConvention.Cdecl)]
        delegate int addNumberProc(int a, int b);

            var asmBytes = File.ReadAllBytes($"SampleDLL.dll");

            var asm = NativeAssembly.Load(asmBytes);

            Console.WriteLine("Successfully loaded library.");
            var addNumberFunc = asm.GetDelegate<addNumberProc>("addNumbers");
            var rand = new Random();
            int num1 = rand.Next(0, 20);
            int num2 = rand.Next(0, 20);
            Console.WriteLine($"{num1}+{num2}={addNumberFunc(num1, num2)}");

            var greetFunc = asm.GetDelegate<GreetProc>("Greet");
            greetFunc();

            asm.Dispose();

See the DemoApp for more details.

Packages

• MemoryModule: Cross platform package, with support for x86 and x86_64, Windows and Linux.
• MemoryModule.Compact.Windows: Compact module for small, standalone Windows applications.

Integration with OS internals

MemoryModule.NET, unlike other projects of the MemoryModule family, aims to have a simple design and a consistent interface across platforms. (see the Abstractions branch for an overview of the future of MemoryModule.NET).

Therefore, features requiring a high amount of integration, like TLS support (#34) or Interoperability with native APIs (#42) will not be included in MemoryModule.NET in the foreseeable future.

However, MemoryModule.NET should be able to bootstrap other native MemoryModules. For example, C# applications targeting only Windows can enjoy the above features by bootstrapping MemoryModulePP, as demonstrated in this repo.

Known issues

• Windows: Beware of 64-bit dll files compiled using g++: fancycode/MemoryModule#108. These files must be compiled using -static-libgcc and -static-libstdc++ to load properly, in both the original C version and this version.
• Windows: Resources are not supported.
• Linux: Support is limited. While basic C/C++ libraries, such as libcurl, can be properly loaded, MemoryModule.NET may not work with other advanced libraries that contain unknown ELF relocations. If that's the case, please open an issue.
• Linux: As MemoryModule.NET relies on certain glibc data structures, it may fail on systems that use beta/custom glibc version. Please open an issue for support.

Community

This repo is a part of Project Reality.

Need help using this project? Join me on Discord, and let's find a solution together.