https://github.com/kekyo/il2c
IL2C - A translator for ECMA-335 CIL/MSIL to C language.
https://github.com/kekyo/il2c
aot arduino c cil csharp dotnet ecma335 fsharp intermediate-language msil systems-programming translator transpiler uefi wdm
Last synced: 11 days ago
JSON representation
IL2C - A translator for ECMA-335 CIL/MSIL to C language.
- Host: GitHub
- URL: https://github.com/kekyo/il2c
- Owner: kekyo
- License: apache-2.0
- Created: 2017-09-15T01:42:59.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2022-06-19T14:05:38.000Z (almost 3 years ago)
- Last Synced: 2025-04-12T14:57:37.169Z (11 days ago)
- Topics: aot, arduino, c, cil, csharp, dotnet, ecma335, fsharp, intermediate-language, msil, systems-programming, translator, transpiler, uefi, wdm
- Language: C#
- Homepage:
- Size: 24.4 MB
- Stars: 417
- Watchers: 24
- Forks: 36
- Open Issues: 42
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# IL2C - A translator for ECMA-335 CIL/MSIL to C language.
## What's this?
* IL2C is a translator (transpiler) of ECMA-335 CIL/MSIL to C language.
* We're aiming for:
* **Better predictability of runtime costs**
Better human readability of C source code translated by IL2C.
* **Very tiny footprint requirements**
We're thinking about how to fit from large system with many resources to tiny embedded system. (KB order for the non-OSes system)
* **Better code/runtime portability**
Minimum requirement is only C99 compiler. The runtime minimum requires only the heap, CAS instructions, (POSIX) signal and setjmp/longjmp. Additional better feature is threading API (Win32, pthreads and FreeRTOS.)
* **Better interoperabilities for existed C libraries**
You can use the standard .NET interop technics (like P/Invoke.)
* **Containing seamless building systems for major C toolkits**
for example: CMake system, Arduino IDE, VC++ ...
## Simple hello-world like code
Original C# source code:
```csharp
public static class HelloWorld
{
public static void Main()
{
Console.WriteLine("Hello world with IL2C!");
}
}
```
Translated to C source code (all comments are stripped):
```c
IL2C_CONST_STRING(string0__, L"Hello world with IL2C!");
void HelloWorld_Main()
{
struct
{
const IL2C_EXECUTION_FRAME* pNext__;
const uint16_t objRefCount__;
const uint16_t valueCount__;
System_String* stack0_0__;
} frame__ = { NULL, 1, 0 };
il2c_link_execution_frame(&frame__);
frame__.stack0_0__ = string0__;
System_Console_WriteLine_10(frame__.stack0_0__);
il2c_unlink_execution_frame(&frame__);
return;
}
```
[View with comments / other sample translation results (contain complex results)](docs/sample-translation-results.md)
## Getting started
IL2C current status is **experimental**, read a simple ["Getting started"](docs/getting-started.md) for first step.
If you need understanding deep knowledge for IL2C, see ["Inside IL2C"](docs/inside-il2c.md) .
## Project status
Following lists are auto-generated by unit test.
* [Supported IL opcodes list](docs/supported-opcodes.md)
* [Supported basic types](docs/supported-basic-types.md)
* [Supported runtime system features](docs/supported-runtime-system-features.md)
[Supported features (old)](docs/supported-features.md)
## Packages
| Packages | master | devel |
|:---|:---|:---|
| IL2C.Build | [](https://www.nuget.org/packages/IL2C.Build) | [](https://www.myget.org/feed/il2c/package/nuget/IL2C.Build) |
| IL2C.Interop | [](https://www.nuget.org/packages/IL2C.Interop) | [](https://www.myget.org/feed/il2c/package/nuget/IL2C.Interop) |
| IL2C.Core | [](https://www.nuget.org/packages/IL2C.Core) | [](https://www.myget.org/feed/il2c/package/nuget/IL2C.Core) |
| IL2C.Runtime | [](https://www.nuget.org/packages/IL2C.Runtime) | [](https://www.myget.org/feed/il2c/package/nuget/IL2C.Runtime) |
| IL2C.Runtime.msvc | [](https://www.nuget.org/packages/IL2C.Runtime.msvc) | [](https://www.myget.org/feed/il2c/package/nuget/IL2C.Runtime.msvc) |
| IL2C.Runtime.Arduino | [(Constructing)](https://github.com/kekyo/IL2C.Runtime.Arduino) | [(Constructing)](https://github.com/kekyo/IL2C.Runtime.Arduino) |
## Build status
|Configuration|master|
|:--|:--|
|Publish|[](https://kekyo.visualstudio.com/IL2C/_build?definitionId=6)
|Debug|[ ](https://kekyo.visualstudio.com/IL2C/_build?definitionId=2)
|Release|[ ](https://kekyo.visualstudio.com/IL2C/_build?definitionId=3)
|Configuration|devel|
|:--|:--|
|Publish|[](https://kekyo.visualstudio.com/IL2C/_build?definitionId=6)
|Debug|[ ](https://kekyo.visualstudio.com/IL2C/_build?definitionId=4)
|
|Release|[ ](https://kekyo.visualstudio.com/IL2C/_build?definitionId=5)
|
## License
Under Apache v2.
## Related information
* Slide: [Making archive IL2C](https://www.slideshare.net/kekyo/making-archive-il2c-655-dotnet600-2018)
* **Covers overall information about internal IL2C.**
* #6-52 session in [dotNET 600 2018](https://centerclr.connpass.com/event/101479/) conference.
* Slide: [Write common, run anywhere](https://www.slideshare.net/kekyo/write-common-run-anywhere)
* #6-51 session in [dotNET 600 2017](https://centerclr.connpass.com/event/71414/)
conference
* [Session video (Japanese)](http://bit.ly/2DiaoKZ)
* Polish notation calculator: [Minimum, but useful impls for "Win32", "UEFI" and "M5Stack(ESP32)"](samples/Calculator)
* Slide: [How to make the calculator / Making archive IL2C](https://www.slideshare.net/kekyo/how-to-make-the-calculator)
* #6-52 session in [.NET Fringe Japan 2018](https://dotnetfringe-japan.connpass.com/event/74536/)
* Slide: [Making archive IL2C](https://www.slideshare.net/kekyo/mvp-summit-f-meetup-making-archive-il2c-653)
* #6-53 session in [MVP Summit F# Meetup / SEATTLE F# USERS GROUP](https://www.meetup.com/en-US/FSharpSeattle/events/247905452/)
* Slide: [Making archive IL2C](https://www.slideshare.net/kekyo/making-archive-il2c-654-at-mvp-summit-2018-vs-hackathon)
* #6-54 session in [Microsoft MVP Global Summit 2018](https://mvp.microsoft.com/en-us/Summit/Agenda)
– VS HACKATHON"
* Session video (Japanese): ["Making archive IL2C play list"](http://bit.ly/2xtu4MH)
* "How to create IL2C or a tool similar to IL2CPP? You see just the pure design process includes the concept."
* #1 session in [Center CLR #6](https://centerclr.connpass.com/)
* Video letter (Japanese): [Tested IL2C on micro:bit and arduino platform](http://bit.ly/2xGFo9J)
* Session video (Japanese): [Making archive IL2C](http://bit.ly/2hI1jTb)
* #6-28 session in [.NET Conf 2017 in Tokyo Room B](https://csugjp.connpass.com/event/66004/)
* Milestone 2+ informations (Japanese): [Extensive Xamarin - Xamaritans](http://bit.ly/2ycNVzW)
* included in the booklet "Extensive Xamarin - Techbook Fest part 3"
## Photos of design process
* #6-6: Near milestones
* #6-14: Data flow analysis
* Milestone 1: Test on VC++ and check how C compiler's optimizer works.
* #6-48: How mark-and-sweep garbage collection works on a translated code.
* How overload/override/virtual method symbol calculus work.
* How to translate exception handlers when combined the local unwind and global unwind.
* We are thinking about at [Center CLR Try! development meetup (11/10/2018, Japanese)](https://centerclr.connpass.com/event/107981/)
* This is the strcuture graph for the exection-frame and exception-frame.
