DebuggingStarbreachLinux.md

Debugging Starbreach on Linux

First I had to install dotnet SDK (https://docs.microsoft.com/en-us/dotnet/core/install/linux-scripted-manual#scripted-install)

curl https://dot.net/v1/dotnet-install.sh -O -L
chmod +x dotnet-install.sh
./dotnet-install.sh -c Current
sudo ln -sv /home/manio/.dotnet/dotnet /usr/local/bin/dotnet

You need to compile the Stride game (here Starbreach) with that SDK in Debug config to have access to symbols. Not sure if it works on a version built with another SDK.

For me running Starbreach on ubuntu looks like this:

cd Bin/Linux/Debug/linux-64
LD_LIBRARY_PATH=linux-x64 ./Starbreach.Linux

Then I installed lldb and SOS plugin (https://github.com/dotnet/diagnostics/blob/main/documentation/installing-sos-instructions.md)

sudo apt install lldb
dotnet tool install -g dotnet-sos
DOTNET_ROOT=/home/manio/.dotnet /home/manio/.dotnet/dotnet/tools/dotnet-sos install

Run sudo lldb from ~ and load plugin

(lldb) plugin load .dotnet/sos/libsosplugin.so
(lldb) process attach -p <PID>
(lldb) continue
# when stuck
(lldb) process interrupt
(lldb) clrstack