LLVM-DWARFDUMP(1)

LLVM

LLVM-DWARFDUMP(1)

نام (NAME)

llvm-dwarfdump - ابزار چاپ و اعتبارسنجی اطلاعات اشکال‌زدایی DWARF

خلاصه دستور (SYNOPSIS)

llvm-dwarfdump [گزینه‌ها] [نام_فایل ...]

توضیحات (DESCRIPTION)

دستور llvm-dwarfdump بخش‌های DWARF را در فایل‌های شیء (object files)، بایگانی‌ها و بسته‌های .dSYM تجزیه کرده و محتوای آن‌ها را در قالبی خوانا برای انسان چاپ می‌کند. به‌طور پیش‌فرض تنها بخش .debug_info چاپ می‌شود، مگر اینکه یکی از گزینه‌های مختص به بخش‌ها یا --all مشخص شده باشد.

اگر هیچ فایل ورودی مشخص نشود، a.out به جای آن استفاده می‌شود. اگر - به عنوان فایل ورودی داده شود، llvm-dwarfdump ورودی را از جریان ورودی استاندارد (stdin) می‌خواند.

گزینه‌ها (OPTIONS)

-a, --all: چاپ تمام بخش‌های پشتیبانی‌شده DWARF.

--arch=<arch>: چاپ اطلاعات اشکال‌زدایی DWARF برای معماری پردازنده مشخص‌شده. معماری‌ها را می‌توان بر اساس نام یا شماره مشخص کرد. این گزینه می‌تواند چند بار، برای هر معماری دلخواه، مشخص شود. به‌طور پیش‌فرض تمامی معماری‌های پردازنده چاپ خواهند شد.

-c, --show-children: نمایش فرزندان یک مدخل اطلاعات اشکال‌زدایی (DIE) هنگام چاپ انتخابی با آرگومان =<offset> در --debug-info، یا گزینه‌هایی مانند --find یا --name.

--color: استفاده از رنگ‌ها در خروجی.

--error-display=<value>: تنظیم سطح جزئیات و خلاصه‌سازی برای نمایش هنگام اعتبارسنجی. مستلزم --verify است. مقادیر پشتیبانی‌شده عبارتند از:
quiet - تنها وقوع یا عدم وقوع خطاها را نمایش می‌دهد. summary - تنها خلاصه‌ای از خطاهای یافت‌شده را نمایش می‌دهد. details - هر خطا را با جزئیات کامل بدون خلاصه نمایش می‌دهد. full - هر خطا را با جزئیات همراه با خلاصه نمایش می‌دهد. [پیش‌فرض]

-f <name>, --find=<name>: جستجوی متن دقیق <name> در جدول‌های شتاب‌دهنده (accelerator tables) و چاپ مدخل‌های منطبق اطلاعات اشکال‌زدایی. هنگامی که جدول شتاب‌دهنده‌ای وجود ندارد یا نام DIE مورد نظر در جدول‌های شتاب‌دهنده یافت نمی‌شود، از گزینه کندتر اما کامل‌تر --name استفاده کنید.

-F, --show-form: نمایش نوع‌های فرم DWARF پس از نوع‌های مشخصه DWARF.

-h, --help: نمایش راهنما و نحوه استفاده از این دستور.

--help-list: نمایش راهنما و نحوه استفاده از دستور بدون گروه‌بندی گزینه‌ها در دسته‌بندی‌ها.

-i, --ignore-case: صرف‌نظر از کوچکی و بزرگی حروف هنگام استفاده از --name.

-n <name>, --name=<name>: یافتن و چاپ تمام مدخل‌های اطلاعات اشکال‌زدایی که نام آن‌ها (مشخصه DW_AT_name/DW_AT_linkage_name) برابر با <name> باشد.

--lookup=<address>: جستجوی <address> در اطلاعات اشکال‌زدایی و چاپ جزئیات فایل، تابع، بلوک و جدول خطوط.

-o <path>: هدایت خروجی به فایل مشخص‌شده توسط <path>، که در آن - نشان‌دهنده جریان خروجی استاندارد است.

-p, --show-parents: نمایش والدین یک مدخل اطلاعات اشکال‌زدایی هنگام چاپ انتخابی با آرگومان =<offset> در --debug-info، یا گزینه‌هایی مانند --find یا --name.

--parent-recurse-depth=<N>: هنگام نمایش والدین مدخل اطلاعات اشکال‌زدایی، تنها تا حداکثر عمق <N> نمایش داده شوند.

--quiet: استفاده همراه با --verify برای جلوگیری از ارسال پیام‌ها به STDOUT.

-r <N>, --recurse-depth=<N>: هنگام نمایش مدخل‌های اطلاعات اشکال‌زدایی، فرزندان فقط تا حداکثر عمق <N> نمایش داده شوند.

--show-section-sizes: نمایش اندازه تمام بخش‌های اشکال‌زدایی بر حسب بایت.

--show-sources: چاپ تمام فایل‌های منبع ذکرشده در اطلاعات اشکال‌زدایی. در صورت امکان، مسیرهای مطلق ارائه می‌شوند.

--statistics: جمع‌آوری معیارهای کیفیت اطلاعات اشکال‌زدایی و چاپ نتایج به صورت خروجی تک‌خطی JSON با قابلیت پردازش ماشینی. قالب خروجی در بخش زیر (قالب خروجی آمار) توضیح داده شده است.

--summarize-types: خلاصه‌سازی توضیحات مدخل‌های واحد نوع (type unit entries).

-t, --filter-child-tag: تنها فرزندانی تخلیه شوند که برچسب DWARF آن‌ها یکی از برچسب‌های مشخص‌شده باشد. مثال کاربردی:

llvm-dwarfdump -t DW_TAG_structure_type -t DW_TAG_member -c

-x, --regex: در نظر گرفتن هرگونه رشته <name> به عنوان عبارت منظم (regex) هنگام جستجو با --name. اگر --ignore-case نیز مشخص شده باشد، عبارت منظم به حروف کوچک و بزرگ غیرحساس می‌شود.

-u, --uuid: نمایش UUID برای هر معماری.

--diff: چاپ خروجی در قالبی مناسب‌تر برای مقایسه خروجی DWARF دو فایل متفاوت.

-v, --verbose: نمایش اطلاعات مشروح هنگام تخلیه. این گزینه می‌تواند در اشکال‌زدایی مشکلات DWARF مفید باشد.

--verify: اعتبارسنجی ساختار اطلاعات DWARF از طریق بررسی زنجیره‌های واحدهای کامپایل، گراف روابط DIE، محدوده‌های آدرس و موارد دیگر.

--verify-json=<path>: ارسال خلاصه خطای قالب‌بندی‌شده با JSON به فایل مشخص‌شده با <path>. مستلزم --verify است. قالب خروجی در بخش زیر (قالب خروجی اعتبارسنجی JSON) شرح داده شده است.

--version: نمایش نسخه ابزار.

--debug-abbrev, --debug-addr, --debug-aranges, --debug-cu-index, --debug-frame [=<offset>], --debug-gnu-pubnames, --debug-gnu-pubtypes, --debug-info [=<offset>], --debug-line [=<offset>], --debug-line-str, --debug-loc [=<offset>], --debug-loclists [=<offset>], --debug-macro, --debug-names, --debug-pubnames, --debug-pubtypes, --debug-ranges, --debug-rnglists, --debug-str, --debug-str-offsets, --debug-tu-index, --debug-types [=<offset>], --eh-frame [=<offset>], --gdb-index, --apple-names, --apple-types, --apple-namespaces, --apple-objc

چاپ بخش مشخص‌شده DWARF بر اساس نام. به‌طور پیش‌فرض تنها بخش .debug_info نمایش داده می‌شود. برخی مدخل‌ها از افزودن =<offset> برای ارائه یک آفست اختیاری از مدخل دقیق مورد نظر در بخش مربوطه پشتیبانی می‌کنند. هنگامی که آفست مشخص شود، تنها مدخل موجود در آن آفست چاپ خواهد شد؛ در غیر این صورت کل بخش تخلیه می‌شود.

گزینه --debug-macro هر دو بخش .debug_macro و .debug_macinfo را چاپ می‌کند.

گزینه‌های --debug-frame و --eh-frame نام‌های مستعار هستند؛ در صورتی که هر دو بخش وجود داشته باشند، یک دستور هر دو را خروجی می‌دهد.

@<FILE>: خواندن گزینه‌های خط فرمان از <FILE>.

قالب خروجی آمار (FORMAT OF STATISTICS OUTPUT)

گزینه --statistics خروجی تک‌خطی JSON تولید می‌کند که نشان‌دهنده معیارهای کیفیت اطلاعات اشکال‌زدایی پردازش‌شده است. این معیارها برای مقایسه تغییرات بین دو کامپایلر مفیدند، به‌ویژه برای ارزیابی تأثیری که تغییر کامپایلر بر کیفیت اطلاعات اشکال‌زدایی می‌گذارد.

خروجی به صورت جفت‌های کلید-مقدار قالب‌بندی می‌شود. نخستین جفت حاوی شماره نسخه است. الگوی نام‌گذاری زیر برای کلیدها استفاده می‌شود:

variables ==> متغیرهای محلی و پارامترها
local vars ==> متغیرهای محلی
params ==> پارامترهای رسمی

برای مقادیر تجمیع‌شده، کلیدهای زیر استفاده می‌شوند:

sum_of_all_variables(...) ==> مجموع اعمال‌شده بر تمامی متغیرها
#bytes ==> تعداد بایت‌ها
#variables - entry values ... ==> تعداد متغیرها بدون احتساب مقادیر ورودی و غیره.

قالب خروجی اعتبارسنجی JSON (FORMAT OF VERIFY JSON OUTPUT)

قالب خروجی JSON ایجادشده توسط --verify-json به صورت زیر است:

{
  "error-categories": {
    "<first category description>": {"count": 1234},
    "<next category description>": {"count": 4321}
  },
  "error-count": 5555
}

در صورتی که هیچ خطایی گزارش نشود، خروجی زیر تولید می‌گردد:

{
  "error-categories": {},
  "error-count": 0
}

وضعیت خروج (EXIT STATUS)

اگر فایل‌های ورودی با موفقیت تجزیه و چاپ شوند، llvm-dwarfdump مقدار 0 را بازمی‌گرداند. در غیر این صورت، مقدار 1 بازگردانده می‌شود.

همچنین ببینید (SEE ALSO)

dsymutil(1) <dsymutil.html>

نویسنده (AUTHOR)

نگه‌داری‌شده توسط تیم LLVM (https://llvm.org).

حق نشر (COPYRIGHT)

2003-2026, LLVM Project

2026-07-15