Comet Debugging Guide

This HOWTO describes how to debug JVM code and Native code concurrently. The guide assumes you have:

Intellij as the Java IDE
CLion as the Native IDE. For Rust code, the CLion Rust language plugin is required. Note that the Intellij Rust plugin is not sufficient.
CLion/LLDB as the native debugger. CLion ships with a bundled LLDB and the Rust community has its own packaging of LLDB (lldb-rust). Both provide a better display of Rust symbols than plain LLDB or the LLDB that is bundled with XCode. We will use the LLDB packaged with CLion for this guide.
We will use a Comet unit test as the canonical use case.

Caveat: The steps here have only been tested with JDK 11 on Mac (M1)

Debugging for Advanced Developers

Add a .lldbinit to comet/core. This is not strictly necessary but will be useful if you want to use advanced lldb debugging.

Set a breakpoint in NativeBase.load(), at a point after the Comet library has been loaded.
Add a Debug Configuration for the unit test
In the Debug Configuration for that unit test add -Xint as a JVM parameter. This option is undocumented magic. Without this, the LLDB debugger hits a EXC_BAD_ACCESS (or EXC_BAD_INSTRUCTION) from which one cannot recover.
Add a println to the unit test to print the PID of the JVM process. (jps can also be used but this is less error prone if you have multiple jvm processes running)
```
     println("Waiting for Debugger: PID - ", ManagementFactory.getRuntimeMXBean().getName())
```
This will print something like : PID@your_machine_name.

For JDK9 and newer
```
     println("Waiting for Debugger: PID - ", ProcessHandle.current.pid)
```
==> Note the PID
Debug-run the test in Intellij and wait for the breakpoint to be hit

After the breakpoint is hit in Intellij, in Clion (or LLDB from terminal or editor) -
1. Attach to the jvm process (make sure the PID matches). In CLion, this is Run -> Atttach to process
2. Put your breakpoint in the native code
Go back to intellij and resume the process.
Most debugging in CLion is similar to Intellij. For advanced LLDB based debugging the LLDB command line can be accessed from the LLDB tab in the Debugger view. Refer to the LLDB manual for LLDB commands.

In CLion, detach from the process if not already detached
In Intellij, the debugger might have lost track of the process. If so, the debugger tab will show the process as running (even if the test/job is shown as completed).
Close the debugger tab, and if the IDS asks whether it should terminate the process, click Yes.
In terminal, use jps to identify the process with the process id you were debugging. If it shows up as running, kill -9 [pid]. If that doesn't remove the process, don't bother, the process will be left behind as a zombie and will consume no (significant) resources. Eventually it will be cleaned up when you reboot possibly after a software update.