[llvm-dev] RFC: Debug info for Cuda (original) (raw)

Hal Finkel via llvm-dev llvm-dev at lists.llvm.org
Tue Nov 7 08:04:35 PST 2017

Hi, Alexey,

Thanks a bunch for working on this. A couple quick questions below...

On 11/06/2017 12:37 PM, Alexey Bataev wrote:

Hi everybody, As you know, Cuda/NVPTX target has very limited support of the debug info in Clang/LLVM. Currently, LLVM supports only emission of the line numbers debug info. This is caused by limitations of the Cuda/NVPTX codegen. Clang/LLVM translates the source code to LLVM IR, which is then lowered to PTX (parallel thread execution) intermediate file. This PTX file represents special kind of the assembler code in text format, which contains the code itself + (possibly) debug info. Then this PTX file is compiled by ptxas tool into the CUDA binary representation.

Debug info representation in PTX file. ======================== According to PTX Writer's Guide to Interoperability, Debug information (http://docs.nvidia.com/cuda/ptx-writers-guide-to-interoperability/index.html#debug-information) , debug information must be encoded in DWARF (Debug With Arbitrary Record Format). The responsibility for generating debug information is split between the PTX producer and the PTX-to-SASS backend. The PTX producer is responsible for emitting binary DWARF into the PTX file, using the .section and .b8-.b16-.b32-and-.b64 directives in PTX. This should contain the .debuginfo and .debugabbrev sections, and possibly optional sections .debugpubnames and .debugaranges. These sections are standard DWARF2 sections that refer to labels and registers in the PTX. The PTX-to-SASS backend is responsible for generating the .debugline section from the .file and .loc directives in the PTX file. This section maps source lines to SASS addresses. The PTX-to-SASS backend also generates the .debugframe section. LLVM is able to emit debug info in DWARF. But ptxas compiler has some limitations, that make it hard to adapt LLVM for correct emission of the debug info in PTX files. Limitations/features of the PTX format/ptxas compiler. ================================== a) Supports DWARF-2 only. b) Labels are allowed only in code section (only in functions). c) Does not support label arithmetic in DWARF sections. “.b32 L1 – L2” as the size of the section is not allowed, so the sections sizes should be calculated explicitly. d) Debug info must point to the sections, not to labels inside these sections. “.b32 .debugabbrevs” e) Sections itself must be enclosed into braces “.section .debuginfo {…}” f) Frame info is non-register based Based on function local “_localdepot” array, that represents the stack frame. g) All variables must have non-standard DWATaddressclass attribute so the debuger had the info about address class of the variable - global or local. DWARF standard does support this attribute, but it can be appiled to pointer/reference types only, not variables. h) The first label in the function must follow the debug location macro. In LLVM, it is followed by the debug location macro. i) .debugframe section is emitted by txas compiler. DWATframebase must be set to dwarf::DWFORMdata1 dwarf::DWOPcallframecfa value. j) Strings cannot be referenced by the labels, instead they must be inlined in the sections in form of array of chars. Some changes in LLVM are required to support all these limitation/features in the output PTX files. Required changes in LLVM. ================== •include/llvm/CodeGen/AsmPrinter.h. •Add “virtual MCSymbol *getFunctionFrameSymbol(const MachineFunction *MF) const” for non-register-based frame info. •Override “NVPTXMCAsmPrinter.cpp” to return the name of the “_localdepot” frame storage. •Add ”cuda-gdb” specific tuning. •Inlined strings must be used in sections, not string references. •Label arithmetic is replaced by the absolute section size evaluation. •Use “AsmPrinter::doInitialization()” instead of NVPTX-custom manual initialization. •Local variables address emitted as “_localdepot” + . •Add NVPTX specific “NVPTXMCAsmStreamer” class. •Requires moving to includes of “MCAsmStreamer” class declaration. •Overrides emission of the labels (names of the section are emitted instead). •Overrides emission of the sections (emit braces) •Overrides string emission (as sequence of bytes, not as strings) •Overrides emission of files/locations debug info Required changes in Clang. ================= •Add option “-gcuda-gdb” to driver. •Emit cuda-gdb compatible debug info (DWARF-2 by default + CudaGDB tuning). •Add options “-g --dont-merge-basicblocks --return-at-end” to “ptxas” call.

Is this a change? It looks like this is already the behavior of the driver's CUDA target code:

if (Args.hasFlag(options::OPT_cuda_noopt_device_debug, options::OPT_no_cuda_noopt_device_debug, false)) { // ptxas does not accept -g option if optimization is enabled, so // we ignore the compiler's -O* options if we want debug info. CmdArgs.push_back("-g"); CmdArgs.push_back("--dont-merge-basicblocks"); CmdArgs.push_back("--return-at-end"); } else if (Arg *A = Args.getLastArg(options::OPT_O_Group)) { // Map the -O we received to -O{0,1,2,3}.

•ptxas is able to translate debug information only if -O0 optimization level is used. It means, that we can use optimization level in LLVM > O0, but still have to use O0 when calling ptxas compiler.

Can you clarify what "unable to translate" mean? Does it refuse to compile the code, drop all debug info, drop all debug info except for line-table information, something else?

Thanks again, Hal

This approach was implemented in https://github.com/clang-ykt to support debug info emission for NVPTX target when generating code for OpenMP offloading constructs. You can try to use it.

-- Hal Finkel Lead, Compiler Technology and Programming Languages Leadership Computing Facility Argonne National Laboratory

-------------- next part -------------- An HTML attachment was scrubbed... URL: <http://lists.llvm.org/pipermail/llvm-dev/attachments/20171107/20bc37b2/attachment-0001.html>

More information about the llvm-dev mailing list