Add info on fast start and debugging of Release dlls
authorGleb Balykov/Platform Lab /SRR/Staff Engineer/Samsung Electronics <g.balykov@samsung.com>
Wed, 2 Feb 2022 12:43:24 +0000 (15:43 +0300)
committerAlexander Soldatov/Platform Lab /SRR/Staff Engineer/Samsung Electronics <soldatov.a@samsung.com>
Thu, 17 Feb 2022 13:54:39 +0000 (16:54 +0300)
doc/cli.md

index dd590b0c1545dd9482e48a4ff8624a2378291e11..59145be2bc276fb1aa1744525197e66aaadb63ee 100644 (file)
@@ -1,4 +1,14 @@
 # Using NetCoreDbg with CLI (Command Line Interface)
+
+## Fast start
+
+To start debugger and run program with one command just type
+```
+$ netcoredbg --interpreter=cli -- dotnet hello.dll param1 param2
+```
+
+Note: to debug Release build of dlls with pdbs Just-My-Code should be disabled, see below.
+
 ## Command reference
 ```
 command    alias  args   
@@ -58,6 +68,13 @@ The name of the assembly for debugging and all the required parameters could be
 ncdb> set args hello.dll param1 param2
 ```
 
+### Debugging Release build of dlls
+
+To debug Release build of dlls with pdbs Just-My-Code should be disabled:
+```
+ncdb> set just-my-code 0
+```
+
 ### Running debugging program
 Now the debugger is ready to run your assembly. The debugging information is not loaded at this moment and will be available after debuggee program starts. But breakpoints could be set here using `break` command (see below). Keep in mind that all breakpoints set here will have "pending" status until "hit entry point" event will occur. Debugging information is provided by *.pdb file. If the debugger can't find the correspoinding *.pdb the debugging will not be possible, even hitting the entry point will not pause the debuggee process. Example:
 ```