# netcoredbg

**Repository Path**: mirrors_lextm/netcoredbg

## Basic Information

- **Project Name**: netcoredbg
- **Description**: NetCoreDbg is a managed code debugger with MI interface for CoreCLR.
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-08-09
- **Last Updated**: 2026-02-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Debugger for .NET Core runtime

The debugger provides GDB/MI or VSCode Debug Adapter protocol and allows to debug .NET apps under .NET Core runtime.


## Build

Switch to `netcoredbg` directory, create `build` directory and switch into it:
```
mkdir build
cd build
```

Proceed to build with `cmake`.

> Necessary dependencies (CoreCLR sources and .NET SDK binaries) are going to be downloaded during CMake configure step. It is possible to override them with CMake options `-DCORECLR_DIR=<path-to-coreclr>` and `-DDOTNET_DIR=<path-to-dotnet-sdk>`.

### Ubuntu

```
CC=clang CXX=clang++ cmake .. -DCMAKE_INSTALL_PREFIX=$PWD/../bin
```

### macOS

```
cmake .. -DCMAKE_INSTALL_PREFIX=$PWD/../bin
```

### Windows

```
cmake .. -G "Visual Studio 15 2017 Win64" -DCMAKE_INSTALL_PREFIX="$pwd\..\bin"
```

Compile and install:
```
cmake --build . --target install
```


## Run

The above commands create `bin` directory with `netcoredbg` binary and additional libraries.

Now running the debugger with `--help` option should look like this:
```
$ ../bin/netcoredbg --help
.NET Core debugger

Options:
--attach <process-id>                 Attach the debugger to the specified process id.
--interpreter=mi                      Puts the debugger into MI mode.
--interpreter=vscode                  Puts the debugger into VS Code Debugger mode.
--engineLogging[=<path to log file>]  Enable logging to VsDbg-UI or file for the engine.
                                      Only supported by the VsCode interpreter.
--server[=port_num]                   Start the debugger listening for requests on the
                                      specified TCP/IP port instead of stdin/out. If port is not specified
                                      TCP 4711 will be used.
```