Currently, it's hard to get started with launching a debuggable instance of Nix. Building Nix with debug symbols requires knowledge of internal environment variables like mesonBuildType, which are not well-documented. For example, to build with debug symbols, you need to run:
nix develop .#native-clangStdenvPackages
# `make clean` did not work
trash build
export mesonBuildType=debug
mesonConfigurePhase
ninjaBuildPhase
Additionally, there is no documentation on how to attach a debugger to the nix-daemon.
Problem
Currently, it's hard to get started with launching a debuggable instance of Nix. Building Nix with debug symbols requires knowledge of internal environment variables like
mesonBuildType
, which are not well-documented. For example, to build with debug symbols, you need to run:Additionally, there is no documentation on how to attach a debugger to the
nix-daemon
.Proposal
Add a "Debugging" section to the Nix manual's development chapter. This section should include:
nix-daemon
.Checklist
Priorities
Add 👍 to issues you find important.