// test.h
extern "C" inline int foz() {
  return 1234;
}

// test.cpp
#include "test.h"
int bar=42;
int foo() {
  return bar;
}
int baz() {
  volatile int k = 42;
  return foz() + k;
}
int main() {
  return foo() + baz();
}

$ clang -g test.cpp -o test.elf
$ clang -g -O2 test.cpp -o inlined.elf

$ llvm-symbolizer --obj=test.elf 0x4004d0 0x400490
foz
/tmp/test.h:1:0
baz()
/tmp/test.cpp:11:0

$ cat addr.txt
0x4004a0
0x400490
0x4004d0
$ llvm-symbolizer --obj=test.elf < addr.txt
main
/tmp/test.cpp:15:0
baz()
/tmp/test.cpp:11:0
foz
/tmp/./test.h:1:0

$ llvm-symbolizer "test.elf 0x400490" "FILE:inlined.elf 0x400480"
baz()
/tmp/test.cpp:11:0
foo()
/tmp/test.cpp:8:10
$ cat addr2.txt
FILE:test.elf 0x4004a0
inlined.elf 0x400480
$ llvm-symbolizer < addr2.txt
main
/tmp/test.cpp:15:0
foo()
/tmp/test.cpp:8:10

$ llvm-symbolizer "FILE:test.elf 0x400490" "DATA BUILDID:123456789abcdef 0x601028"
baz()
/tmp/test.cpp:11:0
bar
6295592 4
$ cat addr3.txt
FILE:test.elf 0x400490
DATA BUILDID:123456789abcdef 0x601028
$ llvm-symbolizer < addr3.txt
baz()
/tmp/test.cpp:11:0
bar
6295592 4

$ llvm-symbolizer --obj=test.elf "CODE 0x400490" "DATA 0x601028"
baz()
/tmp/test.cpp:11:0
bar
6295592 4
$ cat addr4.txt
CODE test.elf 0x4004a0
DATA inlined.elf 0x601028
$ llvm-symbolizer < addr4.txt
main
/tmp/test.cpp:15:0
bar
6295592 4

$ pwd
/tmp
$ clang -g foo/test.cpp -o test.elf
$ llvm-symbolizer --obj=test.elf 0x4004a0
main
/tmp/foo/test.cpp:15:0
$ llvm-symbolizer --obj=test.elf 0x4004a0 --basenames
main
test.cpp:15:0
$ llvm-symbolizer --obj=test.elf 0x4004a0 --relativenames
main
foo/test.cpp:15:0

$ llvm-symbolizer --obj=test.elf main
main
/tmp/test.cpp:14:0
$ llvm-symbolizer --obj=test.elf "CODE foz"
foz
/tmp/test.h:1:0

// test.c
int foo = 0;
int x = 1234;
int main() {
  if (x)
    return foo;
  else
    return x;
}

$ clang -g -O2 -S test.c -o test.s
$ llvm-mc -filetype=obj -triple=x86_64-unknown-linux  test.s -o test.o

$ llvm-symbolizer --obj=test.o --skip-line-zero 0xa
main
/tmp/test.c:5:7 (approximate)

--adjust-vma <offset>

هنگام انجام جستجوها، آفست مشخص‌شده را به آدرس‌های فایل شیء اضافه می‌کند. از این گزینه می‌توان برای انجام جستجوها به گونه‌ای استفاده کرد که گویی شیء به اندازه آفست بازآرایی (relocated) شده است.

--skip-line-zero

اگر آدرسی فاقد شماره خط مرتبط باشد، از آخرین شماره خط توالی جاری در جدول خطوط (line-table) استفاده می‌کند. این خطوط در خروجی با عنوان "approximate" (تقریبی) برچسب‌گذاری می‌شوند زیرا ممکن است گمراه‌کننده باشند.

--basenames, -s

به جای مسیر مطلق، تنها نام فایل را بدون هیچ دایرکتوری چاپ می‌کند.

--build-id

شیء را با استفاده از شناسه ساخت (build ID) داده‌شده که به صورت یک رشته هگزادسیمال مشخص شده، جستجو می‌کند. با --obj مانعة‌الجمع است.

--color [=<always|auto|never>]

تعیین می‌کند که آیا در حالت --filter-markup از رنگ استفاده شود یا خیر. پیش‌فرض auto است که پشتیبانی خروجی استاندارد از رنگ را شناسایی می‌کند. مشخص کردن --color به تنهایی معادل --color=always است.

--debug-file-directory <path>

مسیری به یک دایرکتوری دارای زیردایرکتوری .build-id برای جستجوی اطلاعات اشکال‌زدایی باینری‌های استریپ‌شده (stripped) فراهم می‌کند. در صورت وجود چندین نمونه از این آرگومان، به ترتیب مشخص‌شده جستجو می‌شوند.

--debuginfod, --no-debuginfod

تعیین می‌کند که جستجوهای debuginfod برای باینری‌های اشکال‌زدایی انجام شوند یا خیر. در صورت عدم تعیین، debuginfod تنها زمانی فعال است که libcurl در زمان کامپایل فعال شده باشد (LLVM_ENABLE_CURL) و دست‌کم نشانی یک سرور توسط متغیر محیطی DEBUGINFOD_URLS فراهم شده باشد.

--demangle, -C

در صورت درهم‌ریخته (mangled) بودن نام توابع، نام‌های مرتب‌شده (demangled) را چاپ می‌کند (برای نمونه، نام درهم‌ریخته _Z3bazv به baz() تبدیل می‌شود، در حالی که نام غیردرهم‌ریخته foz همان‌گونه که هست چاپ می‌شود). پیش‌فرض true است.

--dwp <path>

از فایل DWP مشخص‌شده در <path> برای هر CU که داده‌های اشکال‌زدایی تفکیک‌شده DWARF دارد استفاده می‌کند.

--fallback-debug-path <path>

هنگامی که یک فایل مجزا شامل داده‌های اشکال‌زدایی بوده و توسط یک بخش پیوند اشکال‌زدایی گنو (GNU debug link) به آن ارجاع داده شده باشد، در صورتی که نتوان داده‌ها را نسبت به فایل شیء پیدا کرد، از مسیر مشخص‌شده به عنوان مبنایی برای مکان‌یابی داده‌های اشکال‌زدایی استفاده می‌کند.

--filter-markup

داده‌ها را از ورودی استاندارد خوانده، نشانه‌گذاری نمادگذار (Symbolizer Markup) درون آن <> را به قالبی خوانا برای انسان تبدیل کرده و نتایج را در خروجی استاندارد چاپ می‌کند. مؤلفه‌های نشانه‌گذاری زیر هنوز پشتیبانی نمی‌شوند:

مؤلفه ردگیری بازگشتی {{{bt}}} فریم‌ها را با نحو زیر گزارش می‌دهد:

#<number>[.<inline>] <address> <function> <file>:<line>:<col> (<module>+<relative address>)

<inline> شماره فریم‌ها را برای فراخوانی‌های درون‌خطی‌شده (inlined) درون فراخواننده متناظر با <number> فراهم می‌کند. شماره فراخوانی‌های درون‌خطی از ۱ آغاز شده و از فراخوانده (callee) به فراخواننده (caller) افزایش می‌یابد.

<address> آدرسی درون دستور فراخوانی تابع است. این آدرس لزوماً نقطه آغاز دستور نیست. <relative address> آفست مجازی متناظر در <module> بارگذاری‌شده در آن آدرس است.

--functions [=<none|short|linkage>], -f

نحوه چاپ نام توابع را تعیین می‌کند (به ترتیب: حذف نام تابع، چاپ نام کوتاه تابع، یا چاپ نام کامل پیوند/linkage). پیش‌فرض linkage است.

--help, -h

راهنما و نحوه استفاده از این دستور را نمایش می‌دهد.

--inlining, --inlines, -i

اگر موقعیت کد مبدأ درون یک تابع درون‌خطی (inlined) باشد، تمام فریم‌های درون‌خطی را چاپ می‌کند. این رفتار پیش‌فرض است.

--no-inlines

فریم‌های درون‌خطی را چاپ نمی‌کند.

--no-demangle

نام‌های مرتب‌شده (demangled) توابع را چاپ نمی‌کند.

--obj <path>, --exe, -e

مسیر فایل شیء مورد نظر برای نمادگذاری. اگر - مشخص شود، شیء مستقیماً از جریان ورودی استاندارد خوانده می‌شود. با --build-id مانعة‌الجمع است.

--output-style <LLVM|GNU|JSON>

سبک خروجی ترجیحی را مشخص می‌کند. پیش‌فرض LLVM است. هنگامی که سبک خروجی روی GNU تنظیم شود، ابزار از سبک addr2line گنو پیروی می‌کند. تفاوت‌ها با سبک LLVM عبارتند از:

$ llvm-symbolizer --obj=inlined.elf 0x4004be 0x400486 -p
baz() at /tmp/test.cpp:11:18
 (inlined by) main at /tmp/test.cpp:15:0
foo() at /tmp/test.cpp:6:3
$ llvm-symbolizer --output-style=LLVM --obj=inlined.elf 0x4004be 0x400486 -p --no-inlines
main at /tmp/test.cpp:11:18
foo() at /tmp/test.cpp:6:3
$ llvm-symbolizer --output-style=GNU --obj=inlined.elf 0x4004be 0x400486 -p --no-inlines
baz() at /tmp/test.cpp:11
foo() at /tmp/test.cpp:6
$ clang -g -fdebug-info-for-profiling test.cpp -o profiling.elf
$ llvm-symbolizer --output-style=GNU --obj=profiling.elf 0x401167 -p --no-inlines
main at /tmp/test.cpp:15 (discriminator 2)
$ llvm-symbolizer --output-style=JSON --obj=inlined.elf 0x4004be 0x400486 -p
[
  {
    "Address": "0x4004be",
    "ModuleName": "inlined.elf",
    "Symbol": [
      {
        "Column": 18,
        "Discriminator": 0,
        "FileName": "/tmp/test.cpp",
        "FunctionName": "baz()",
        "Line": 11,
        "StartAddress": "0x4004be",
        "StartFileName": "/tmp/test.cpp",
        "StartLine": 9
      },
      {
        "Column": 0,
        "Discriminator": 0,
        "FileName": "/tmp/test.cpp",
        "FunctionName": "main",
        "Line": 15,
        "StartAddress": "0x4004be",
        "StartFileName": "/tmp/test.cpp",
        "StartLine": 14
      }
    ]
  },
  {
    "Address": "0x400486",
    "ModuleName": "inlined.elf",
    "Symbol": [
      {
        "Column": 3,
        "Discriminator": 0,
        "FileName": "/tmp/test.cpp",
        "FunctionName": "foo()",
        "Line": 6,
        "StartAddress": "0x400486",
        "StartFileName": "/tmp/test.cpp",
        "StartLine": 5
      }
    ]
  }
]

--print-address, --addresses, -a

چاپ آدرس پیش از مکان کد منبع. پیش‌فرض false است.

$ llvm-symbolizer --obj=inlined.elf --print-address 0x4004be
0x4004be
baz()
/tmp/test.cpp:11:18
main
/tmp/test.cpp:15:0
$ llvm-symbolizer --obj=inlined.elf 0x4004be --pretty-print --print-address
0x4004be: baz() at /tmp/test.cpp:11:18
 (inlined by) main at /tmp/test.cpp:15:0

--print-source-context-lines <N>

چاپ N خط از بافت کد منبع برای هر آدرس نمادگذاری‌شده.

$ llvm-symbolizer --obj=test.elf 0x400490 --print-source-context-lines=3
baz()
/tmp/test.cpp:11:0
10  :   volatile int k = 42;
11 >:   return foz() + k;
12  : }

--relativenames

چاپ مسیر فایل به صورت نسبی نسبت به دایرکتوری کامپایل، به جای مسیر مطلق. اگر خط فرمان کامپایلر شامل مسیر کامل بوده باشد، این گزینه همانند حالت پیش‌فرض عمل خواهد کرد.

--verbose

چاپ اطلاعات با جزئیات کامل دربارهٔ آدرس، سطر و ستون.

$ llvm-symbolizer --obj=inlined.elf --verbose 0x4004be
baz()
  Filename: /tmp/test.cpp
  Function start filename: /tmp/test.cpp
  Function start line: 9
  Function start address: 0x4004b6
  Line: 11
  Column: 18
main
  Filename: /tmp/test.cpp
  Function start filename: /tmp/test.cpp
  Function start line: 14
  Function start address: 0x4004b0
  Line: 15
  Column: 18

--version, -v

چاپ اطلاعات نسخهٔ ابزار.

@<FILE>

خواندن گزینه‌های خط فرمان از فایل پاسخ <FILE>.