Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/MSDN-WhiteKnight/CilTools
A set of tools to work with CIL in .NET applications
https://github.com/MSDN-WhiteKnight/CilTools
analysis bytecode cil csharp csharp-library dotnet library msil parser
Last synced: 3 days ago
JSON representation
A set of tools to work with CIL in .NET applications
- Host: GitHub
- URL: https://github.com/MSDN-WhiteKnight/CilTools
- Owner: MSDN-WhiteKnight
- License: bsd-3-clause
- Created: 2019-03-19T18:34:37.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2024-09-24T16:03:32.000Z (5 months ago)
- Last Synced: 2025-02-02T14:17:58.752Z (8 days ago)
- Topics: analysis, bytecode, cil, csharp, csharp-library, dotnet, library, msil, parser
- Language: C#
- Homepage:
- Size: 7.36 MB
- Stars: 26
- Watchers: 4
- Forks: 3
- Open Issues: 20
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# CIL Tools
**License:** [BSD 2.0](https://gitflic.ru/project/smallsoft/ciltools/blob?file=LICENSE&branch=master)
[](https://gitflic.ru/project/smallsoft/gitflic-catalog) [](https://github.com/MSDN-WhiteKnight/CilTools/releases)
[Documentation](https://msdn-whiteknight.github.io/CilTools/) | [Examples](Examples/)
CIL tools is a set of software to work with Common Intermediate Language in .NET.
Libraries:
- [CilTools.BytecodeAnalysis](https://www.nuget.org/packages/CilTools.BytecodeAnalysis/) - inspect or disassemble bytecode of methods
- [CilTools.Runtime](https://www.nuget.org/packages/CilTools.Runtime/) - inspect assemblies from external .NET process
- [CilTools.Metadata](https://www.nuget.org/packages/CilTools.Metadata/) - inspect assembly via reflection without loading it into the current process
- [CilTools.SourceCode](https://www.nuget.org/packages/CilTools.SourceCode/) - provides APIs that assist in lexical analysis of source code
Applications:
- [CilTools.CommandLine](https://www.nuget.org/packages/CilTools.CommandLine/) - cross-platform command line disassembler tool
- [CIL View](https://gitflic.ru/project/smallsoft/ciltools/file?file=CilView&branch=master) - graphical CIL viewer application for Windows
## Using CilTools.BytecodeAnalysis
**Requirements:** .NET Framework 3.5+ or .NET Standard 2.0+
[](https://www.nuget.org/packages/CilTools.BytecodeAnalysis/)
CilTools.BytecodeAnalysis reads .NET methods' Common Intermediate Language (CIL) bytecode and converts it into high-level objects or textual CIL representation so they can be easily studied and programmatically processed.
*Usage*
Add reference to CilTools.BytecodeAnalysis.dll, import CilTools.BytecodeAnalysis namespace. Use CilReader.GetInstructions to get the collection of instructions from method, CilGraph.Create to get a graph that represents a flow of control between method's instructions, or CilAnalysis.MethodToText when you need to output method's CIL code as text. CilTools.BytecodeAnalysis.Extensions namespace provides an alternative syntax via extension methods.
*Example*
```
using System;
using System.Collections.Generic;
using CilTools.BytecodeAnalysis;
using CilTools.BytecodeAnalysis.Extensions;
namespace CilToolsExample
{
class Program
{
public static void Hello()
{
int a = 1;
int b = 2;
Console.WriteLine("Hello, World");
Console.WriteLine("{0} + {1} = {2}",a,b,a+b);
}
static void Main(string[] args)
{
IEnumerable instructions = typeof(Program).GetMethod("Hello").GetInstructions();
foreach (CilInstruction instr in instructions)
{
Console.WriteLine(instr.ToString());
}
Console.ReadKey();
}
}
}
/* Output:
nop
ldc.i4.1
stloc.0
ldc.i4.2
stloc.1
ldstr "Hello, World"
call void [mscorlib]System.Console::WriteLine(string)
nop
ldstr "{0} \053 {1} \075 {2}"
ldloc.0
box [mscorlib]System.Int32
ldloc.1
box [mscorlib]System.Int32
ldloc.0
ldloc.1
add
box [mscorlib]System.Int32
call void [mscorlib]System.Console::WriteLine(string, object, object, object)
nop
ret
*/
```
For more information, see [documentation](https://msdn-whiteknight.github.io/CilTools/articles/using-bytecode-analysis.html).
---
Copyright (c) 2023, SmallSoft