fasmi 1.5.2

<br />

<p align="center"> <img src="https://raw.githubusercontent.com/d-edge/fasmi/main/img/fasmi.png" alt="fasmi logo" height="140"> </p>

<p align="center"> <img src="https://img.shields.io/nuget/v/fasmi" alt="version" /> <img src="https://img.shields.io/nuget/dt/fasmi" alt="download" /> <img src="https://img.shields.io/badge/license-MIT%20%2B%20BSD-green" alt="license" /> </p>

<br />

Fasmi is a F# to Jitted ASM / IL disassembler as a dotnet tool

Getting Started

Install fasmi as a global dotnet tool

dotnet tool install fasmi -g

or as a dotnet local tool

dotnet new tool-manifest
dotnet tool install fasmi

Quickstart

Create a demo.fsx F# interactive script:

let inc x = x+1

run fasmi:

dotnet fasmi ./demo.fsx

and open at the generated demo.asm file:

Demo.inc(Int32)
L0000: lea eax, [rcx+1]
L0003: ret

Watch mode

run fasmi in watch mode:

dotnet fasmi ./demo.fsx -w

Open the demo.fsx and demo.asm files side by side in your favorite editor, make changes to demo.fsx and save. The demo.asm file is updated on the fly.

Usage

USAGE: dotnet fasmi [--help] [--console] [--output <string>] [--watch] [--platform <x86|x64>] [--language <asm|il>] <string>

SOURCE:

    <string>              the source fsx or dotnet assembly file

OPTIONS:

    --console, -c         output to console
    --output, -o <string> specifiy the output file
    --watch, -w           run in watch mode
    --platform, -p <x86|x64>
                          specify the platform for disassembly
    --language, -l <asm|il>
                          specify the output language (asm/il)
    --help                display this list of options.

Input

The input can be a fsx F# script file or any dotnet .dll assemlby file. F# scripts are compiled for net 5.0.

Using a dotnet assembly as an input, you can use fasmi on any dotnet language.

Console

With the -c flag, the result is output to console rather than in a file.

Output

Use the -o flag to specifie the target file path and name.

Watch

The -w flag runs fasmi in watch mode. The file is recompiled and disassembled automatically when saved.

Platform

Use the -p flag to force x64 or x86 platform for disassembly.

Language

Specify the target language with the -l flag:

• asm : disassemble the jit output as a x86/x86 .asm file
• il : disassemble the output as a MSIL .il file

Acknowledgment

This tool is based on Andrey Shchekin code for https://sharplab.io/.

Contributing

Help and feedback is always welcome and pull requests get accepted.

• First open an issue to discuss your changes
• After your change has been formally approved please submit your PR against the develop branch
• Please follow the code convention by examining existing code
• Add/modify the README.md as required
• Add/modify unit tests as required
• Please document your changes in the upcoming release notes in RELEASE_NOTES.md
• PRs can only be approved and merged when all checks succeed (builds on Windows, MacOs and Linux)

License

MIT