Skip to content

-Z split-dwarf-kind={single,split} is undocumented in the unstable book #135526

New issue

Have a question about this project? # for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “#”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? # to your account

Open
jieyouxu opened this issue Jan 15, 2025 · 2 comments
Open

-Z split-dwarf-kind={single,split} is undocumented in the unstable book #135526

jieyouxu opened this issue Jan 15, 2025 · 2 comments
Labels
A-CLI Area: Command-line interface (CLI) to the compiler A-debuginfo Area: Debugging information in compiled programs (DWARF, PDB, etc.) A-docs Area: Documentation for any part of the project, including the compiler, standard library, and tools T-compiler Relevant to the compiler team, which will review and decide on the PR/issue.

Comments

@jieyouxu
Copy link
Member

Implementation history:

This unstable compiler flag doesn't seem to have an entry in the unstable book, I only discovered them while looking at tests/run-make/split-debuginfo. It would be nice to document its behavior and also the meaning of its values.

@jieyouxu jieyouxu added A-CLI Area: Command-line interface (CLI) to the compiler A-debuginfo Area: Debugging information in compiled programs (DWARF, PDB, etc.) A-docs Area: Documentation for any part of the project, including the compiler, standard library, and tools T-compiler Relevant to the compiler team, which will review and decide on the PR/issue. labels Jan 15, 2025
@rustbot rustbot added the needs-triage This issue may need triage. Remove it if it has been sufficiently triaged. label Jan 15, 2025
@jieyouxu jieyouxu removed the needs-triage This issue may need triage. Remove it if it has been sufficiently triaged. label Jan 15, 2025
@davidtwco
Copy link
Member

Some extra details that might be useful to anyone interested in writing this up if I don't eventually do it:

  • -Zsplit-dwarf-kind=single puts the split debuginfo into the regular object files, but in a separate section so that the linker doesn't process them (just as it doesn't when the debug info in a different file and it doesn't see it at all)
  • -Zsplit-dwarf-kind=split is what we do by default today - the split debuginfo is in the separate DWARF object files.

@jieyouxu
Copy link
Member Author

jieyouxu commented Feb 18, 2025

Oh I think there's also a caveat where the target platform has to actually support the split-dwarf-kind, otherwise sometimes they become a no-op I think

# for free to join this conversation on GitHub. Already have an account? # to comment
Labels
A-CLI Area: Command-line interface (CLI) to the compiler A-debuginfo Area: Debugging information in compiled programs (DWARF, PDB, etc.) A-docs Area: Documentation for any part of the project, including the compiler, standard library, and tools T-compiler Relevant to the compiler team, which will review and decide on the PR/issue.
Projects
None yet
Development

No branches or pull requests

3 participants