Repository files navigation

A simple VS Code debugger extension for the Mono VM. Its implementation was inspired by theSDB command line debugger.

You can either download the latest Mono version for Linux, macOS, or Windows at theMono project website or you can use your package manager.

• On OS X:brew install mono
• On Ubuntu, Debian, Raspbian:sudo apt-get install mono-complete
• On CentOS:yum install mono-complete
• On Fedora:dnf install mono-complete

To enable debugging of Mono based C# (and F#) programs, you have to pass the-debug option to the compiler:

csc -debug Program.cs

If you want to attach the VS Code debugger to a Mono program, pass these additional arguments to the Mono runtime:

mono --debug --debugger-agent=transport=dt_socket,server=y,address=127.0.0.1:55555 Program.exe

The corresponding attachlaunch.json configuration looks like this:

{"version":"0.2.0","configurations": [        {"name":"Attach to Mono","request":"attach","type":"mono","address":"localhost","port":55555        }    ]}

Building and using VS Code mono-debug requires a basic POSIX-like environment, a Bash-likeshell, and an installed Mono framework.

First, clone the mono-debug project:

$ git clone --recursive https://github.com/microsoft/vscode-mono-debug

To build the extension vsix, run:

$cd vscode-mono-debug$ npm install$ make