Mastering Go’s addr2line: Map Addresses to Source Lines for Debugging & Profiling

Introduction

In Go development, understanding each component of the toolchain is essential for effective bug fixing and performance optimization. One lesser‑known yet powerful utility is addr2line, which converts program addresses into file names and line numbers, helping developers pinpoint issues more accurately.

Core Functionality

addr2line

is part of Go's auxiliary toolset and maps memory addresses to their corresponding source code locations. This is especially useful when analyzing crash stack traces or profiling data that only provide raw addresses; the tool translates those addresses back to readable code lines.

Typical Use Cases

Error Debugging : When a program crashes and the stack trace contains only addresses, addr2line reveals the exact source lines responsible for the failure.

Performance Analysis : After running a profiler such as pprof, the report may list function calls by address; using addr2line converts them into human‑readable function names and locations.

Core Dump Analysis : While examining core dump files, addr2line helps map addresses back to source code, simplifying the debugging workflow.

Basic Usage

The general command format is: go tool addr2line [options] binary Here binary refers to the compiled Go executable. The tool reads addresses from standard input and outputs the matching file name and line number.

Example: echo 0x45cff0 | go tool addr2line /path/to/binary This command prints the source location for address 0x45cff0 in the specified binary.

Example Scenario

Assume a compiled binary named example located at /usr/local/bin. To find the source line for address 0x45cff0, run: echo 0x45cff0 | go tool addr2line -e /usr/local/bin/example The output might be: /path/to/source/file.go:23 This indicates that address 0x45cff0 corresponds to line 23 in file.go.

Conclusion

addr2line

is a vital component of the Go toolchain, translating memory addresses to source locations and greatly easing debugging and performance analysis. Mastering this utility enables developers to locate and resolve issues more quickly. Future articles will explore combining pprof and delve with addr2line for deeper insights.