netcoredbg icon indicating copy to clipboard operation
netcoredbg copied to clipboard

Published 20 hours ago • verified publisher icon Samsung

Documentation

Open sebasmonia opened this issue 5 years ago • 9 comments

It would be great to have some documentation on each command. I managed to run a few things using the unit tests as an example, but that's less than ideal.

Doesn't need to be a full fledged manual, just a Wiki page can work.

sebasmonia avatar May 13 '19 14:05 sebasmonia

Hi! Thank you for expressing your interest in netcoredbg. Could you please specify a little bit more details about documentation than you need? The debugger supports 2 protocols, which are intended for interoperability with IDE (although not all commands are supported by netcoredbg):

  • GDB/MI https://sourceware.org/gdb/onlinedocs/gdb/GDB_002fMI.html
  • Debug Adapter Protocol https://microsoft.github.io/debug-adapter-protocol/overview

ayuckhulk avatar May 13 '19 20:05 ayuckhulk

I am interested in the GDB/MI interface, will check out the link supplied.

A list of the commands supported and the link to the docs could be a good start for the README page.

sebasmonia avatar May 15 '19 14:05 sebasmonia

For DAP the one thing that has to be documented is the launch request, as it is completely server-defined and users have to configure it.

puremourning avatar Jun 19 '19 07:06 puremourning

Hi,

Is there some getting started guide? I'm trying to get it working for a while without much progress.

Thanks

serezlan avatar Dec 02 '21 09:12 serezlan

@serezlan what kind of starting guide you are looking? For developing NCDB or for using it?

alpencolt avatar Dec 02 '21 10:12 alpencolt

@alpencolt I am thinking about guide on how to use the debugger. Also it would be great if you can throw some guide on debugging unit test. It would mean a lot.

serezlan avatar Dec 03 '21 16:12 serezlan

Next week we're going to synchronize source code with our main repo, manual will be added. Now you can run debugger following way:

$ netcoredbg 
ncdb> file dotnet
ncdb> set-args your_app.dll app_param1 app_param2
ncdb> run

CLI commands for debugging are similar to GDB ones. To not enter file ... set-args... (and other command, e.g. setting breakpoints) you may save them to file and run NCDB as:

$netcoredbg --command=command_file

Also it's possible to run NCDB from VS Code.

alpencolt avatar Dec 03 '21 17:12 alpencolt

Check this for VSCode https://github.com/OmniSharp/omnisharp-vscode/issues/3943#issuecomment-668142734

alpencolt avatar Dec 03 '21 17:12 alpencolt

@serezlan check this manual https://github.com/Samsung/netcoredbg/blob/master/doc/cli.md

alpencolt avatar Dec 10 '21 14:12 alpencolt