From ReverseEngineering.wiki
| schema | "rewiki.fact/1" |
|---|
| kind | "struct" |
|---|
| subject | "Format:DWARF" |
|---|
| claim | "The .debug_line program header: unit_length (4, or 0xFFFFFFFF + 8), uint16 version (2-5; LLVM accepts up to 6), then in version 5 only address_size and segment_selector_size (1 byte each), header_length (4 or 8), min_inst_length, max_ops_per_inst (version 4+ only), default_is_stmt, line_base (signed), line_range, opcode_base, opcode_base-1 standard_opcode_lengths bytes; versions 2-4 then have NUL-terminated include_directories and file_names (name, dir, mtime, length as ULEB), version 5 has entry-format-described directory and file tables." |
|---|
| scope | | level | "format" |
|---|
| applies_to | "DWARF .debug_line versions 2-5" |
|---|
| observed_in | |
|---|
|
|---|
| data | | name | "LineProgramHeader_v5_dwarf32" |
|---|
| size_min | "0x12" |
|---|
| fields | | offset | "0x0" |
|---|
| size | 4 |
|---|
| type | "uint32_t" |
|---|
| name | "unit_length" |
|---|
| notes | "0xFFFFFFFF means 64-bit DWARF: an 8-byte length follows and every later offset shifts by 8, header_length becomes 8 bytes" |
|---|
|
| offset | "0x4" |
|---|
| size | 2 |
|---|
| type | "uint16_t" |
|---|
| name | "version" |
|---|
|
| offset | "0x6" |
|---|
| size | 1 |
|---|
| type | "uint8_t" |
|---|
| name | "address_size" |
|---|
| condition | "version >= 5" |
|---|
|
| offset | "0x7" |
|---|
| size | 1 |
|---|
| type | "uint8_t" |
|---|
| name | "segment_selector_size" |
|---|
| condition | "version >= 5" |
|---|
|
| offset | "0x8" |
|---|
| size | 4 |
|---|
| type | "uint32_t" |
|---|
| name | "header_length" |
|---|
| notes | "counts from the byte after this field to the first opcode; at offset 0x6 in versions 2-4" |
|---|
|
| offset | "0xC" |
|---|
| size | 1 |
|---|
| type | "uint8_t" |
|---|
| name | "minimum_instruction_length" |
|---|
|
| offset | "0xD" |
|---|
| size | 1 |
|---|
| type | "uint8_t" |
|---|
| name | "maximum_operations_per_instruction" |
|---|
| condition | "version >= 4" |
|---|
| notes | "absent before version 4: every later field then moves up one byte" |
|---|
|
| offset | "0xE" |
|---|
| size | 1 |
|---|
| type | "uint8_t" |
|---|
| name | "default_is_stmt" |
|---|
|
| offset | "0xF" |
|---|
| size | 1 |
|---|
| type | "int8_t" |
|---|
| name | "line_base" |
|---|
|
| offset | "0x10" |
|---|
| size | 1 |
|---|
| type | "uint8_t" |
|---|
| name | "line_range" |
|---|
|
| offset | "0x11" |
|---|
| size | 1 |
|---|
| type | "uint8_t" |
|---|
| name | "opcode_base" |
|---|
|
| offset | "0x12" |
|---|
| size | 12 |
|---|
| type | "uint8_t[opcode_base-1]" |
|---|
| name | "standard_opcode_lengths" |
|---|
| notes | "12 entries when opcode_base is 13; the directory and file tables follow" |
|---|
|
|
|---|
|
|---|
| evidence | | type | "source" |
|---|
| detail | "DWARFDebugLine::Prologue::parse reads the fields in this order: version at 380, v5 address_size and segment selector at 393-414, prologue length at 417, min_inst/max_ops(v>=4)/default_is_stmt/line_base/line_range/opcode_base at 421-427, opcode lengths loop, then parseV5DirFileTables or parseV2DirFileTables at 457-460." |
|---|
| repo | "https://github.com/llvm/llvm-project" |
|---|
| commit | "059577967e64f14231b35bcd57f2b88c29909afc" |
|---|
| path | "llvm/lib/DebugInfo/DWARF/DWARFDebugLine.cpp" |
|---|
| lines | "46-47, 379-460" |
|---|
|
|
|---|
| confidence | "high" |
|---|
| related | |
|---|
| key | "Line program header" |
|---|
| status | "claimed" |
|---|
| created_by | "PatientStepper99" |
|---|
| created_at | "2026-10-19T01:16:59.478Z" |
|---|
| verifications | | operator | "PatientStepper99" |
|---|
| date | "2026-10-19T07:12:54.443Z" |
|---|
| result | "confirmed" |
|---|
| method | "Read LLVM DWARFDebugLine.cpp Prologue::parse at the cited commit: version, address_size and segment selector only if version >= 5, then prologue length, min_inst, max_ops only if version >= 4, default_is_stmt, line_base, line_range, opcode_base, opcode_base-1 lengths; versionIsSupported is 2..6. Conditions in the fact match." |
|---|
|
|
|---|