Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/trungnt2910/memorymodule.net

Loads a native Windows assembly... right from your .NET embedded resources. Works on all modern .NET platforms.
https://github.com/trungnt2910/memorymodule.net

csharp dotnet elf-loader hacktoberfest linux pe-loader windows

Last synced: 2 days ago
JSON representation

Loads a native Windows assembly... right from your .NET embedded resources. Works on all modern .NET platforms.

Host: GitHub
URL: https://github.com/trungnt2910/memorymodule.net
Owner: trungnt2910
License: mit
Created: 2021-08-24T15:07:49.000Z (over 3 years ago)
Default Branch: master
Last Pushed: 2024-09-11T21:12:27.000Z (4 months ago)
Last Synced: 2025-01-06T20:16:00.556Z (9 days ago)
Topics: csharp, dotnet, elf-loader, hacktoberfest, linux, pe-loader, windows
Language: C#
Homepage:
Size: 2.53 MB
Stars: 41
Watchers: 5
Forks: 12
Open Issues: 6
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE.md

Awesome Lists containing this project

README

        # MemoryModule.NET

[![Discord Invite](https://dcbadge.vercel.app/api/server/3EB5sKD2Jd?style=flat)](https://discord.gg/3EB5sKD2Jd) 

![BuildStatus](https://github.com/trungnt2910/MemoryModule.NET/actions/workflows/ci.yml/badge.svg)

| Package | Version |

| ---- | ---- |

| Cross platform | [![CrossPlatformShield](https://shields.io/nuget/vpre/MemoryModule)](https://www.nuget.org/packages/MemoryModule) |

| Windows | [![WindowsShield](https://shields.io/nuget/vpre/MemoryModule.Compact.Windows)](https://www.nuget.org/packages/MemoryModule.Compact.Windows) |

| Linux | Coming soon (see the [`Abstractions`](https://github.com/trungnt2910/MemoryModule.NET/tree/dev/trungnt2910/Abstractions) branch) |

| MacOS | Coming soon (see the [`Abstractions`](https://github.com/trungnt2910/MemoryModule.NET/tree/dev/trungnt2910/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:

```C#

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("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("Greet");

            greetFunc();

            asm.Dispose();

```

See the DemoApp for more details.

## Packages

- [MemoryModule](https://www.nuget.org/packages/MemoryModule): Cross platform package, with support for x86 and x86_64, Windows and Linux.

- [MemoryModule.Compact.Windows](https://www.nuget.org/packages/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`](https://github.com/trungnt2910/MemoryModule.NET/tree/dev/trungnt2910/Abstractions)

branch for an overview of the future of `MemoryModule.NET`).

Therefore, features requiring a high amount of integration, like

[TLS support (#34)](https://github.com/trungnt2910/MemoryModule.NET/issues/34) or

[Interoperability with native APIs (#42)](https://github.com/trungnt2910/MemoryModule.NET/issues/34)

will **not** be included in `MemoryModule.NET` in the foreseeable future.

However, `MemoryModule.NET` **should** be able to bootstrap other native `MemoryModule`s. For

example, C# applications targeting only Windows **can** enjoy the above features by bootstrapping

[MemoryModulePP](https://github.com/bb107/MemoryModulePP), as demonstrated in

[this repo](https://github.com/trungnt2910/MemoryModulePP.NET).

## Known issues

- Windows: Beware of ~~64-bit~~ `dll` files compiled using g++: https://github.com/fancycode/MemoryModule/issues/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](https://github.com/trungnt2910/MemoryModule.NET/issues).

- 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](https://github.com/trungnt2910/MemoryModule.NET/issues) for support.

## Community

This repo is a part of [Project Reality](https://discord.gg/3EB5sKD2Jd).

Need help using this project? Join me on [Discord](https://discord.gg/3EB5sKD2Jd), and let's find a solution together.