.\" Man page generated from reStructuredText
.\" by the Docutils 0.23 manpage writer.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "LLVM-DWARFDUMP" "1" "2026-07-15" "22" "LLVM"
.SH "نام (NAME)"
llvm-dwarfdump \- ابزار چاپ و اعتبارسنجی اطلاعات اشکال‌زدایی DWARF
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBllvm\-dwarfdump\fP [\fIگزینه‌ها\fP] [\fIنام_فایل ...\fP]
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \fBllvm\-dwarfdump\fP بخش‌های DWARF را در فایل‌های شیء (object files)،
بایگانی‌ها و بسته‌های \fI\&.dSYM\fP تجزیه کرده و محتوای آن‌ها را در
قالبی خوانا برای انسان چاپ می‌کند. به‌طور پیش‌فرض تنها بخش .debug_info چاپ می‌شود، مگر اینکه یکی از
گزینه‌های مختص به بخش‌ها یا \fB\-\-all\fP مشخص شده باشد.
.sp
اگر هیچ فایل ورودی مشخص نشود، \fIa.out\fP به جای آن استفاده می‌شود. اگر \fI\-\fP به عنوان
فایل ورودی داده شود، \fBllvm\-dwarfdump\fP ورودی را از جریان ورودی استاندارد (stdin)
می‌خواند.
.SH "گزینه‌ها (OPTIONS)"
.INDENT 0.0
.TP
.B \-a, \-\-all
چاپ تمام بخش‌های پشتیبانی‌شده DWARF.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-arch=<arch>
چاپ اطلاعات اشکال‌زدایی DWARF برای معماری پردازنده مشخص‌شده.
معماری‌ها را می‌توان بر اساس نام یا شماره مشخص کرد. این
گزینه می‌تواند چند بار، برای هر معماری دلخواه، مشخص شود. به‌طور
پیش‌فرض تمامی معماری‌های پردازنده چاپ خواهند شد.
.UNINDENT
.INDENT 0.0
.TP
.B \-c, \-\-show\-children
نمایش فرزندان یک مدخل اطلاعات اشکال‌زدایی (DIE) هنگام چاپ انتخابی با
آرگومان \fI=<offset>\fP در \fB\-\-debug\-info\fP، یا گزینه‌هایی
مانند \fB\-\-find\fP یا \fB\-\-name\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-color
استفاده از رنگ‌ها در خروجی.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-error\-display=<value>
تنظیم سطح جزئیات و خلاصه‌سازی برای نمایش هنگام اعتبارسنجی.
مستلزم \fB\-\-verify\fP است. مقادیر پشتیبانی‌شده عبارتند از:
.sp
\fIquiet\fP   \- تنها وقوع یا عدم وقوع خطاها را نمایش می‌دهد.
\fIsummary\fP \- تنها خلاصه‌ای از خطاهای یافت‌شده را نمایش می‌دهد.
\fIdetails\fP \- هر خطا را با جزئیات کامل بدون خلاصه نمایش می‌دهد.
\fIfull\fP    \- هر خطا را با جزئیات همراه با خلاصه نمایش می‌دهد. [پیش‌فرض]
.UNINDENT
.INDENT 0.0
.TP
.B \-f <name>, \-\-find=<name>
جستجوی متن دقیق <name> در جدول‌های شتاب‌دهنده (accelerator tables)
و چاپ مدخل‌های منطبق اطلاعات اشکال‌زدایی.
هنگامی که جدول شتاب‌دهنده‌ای وجود ندارد یا نام DIE مورد نظر
در جدول‌های شتاب‌دهنده یافت نمی‌شود،
از گزینه کندتر اما کامل‌تر \fB\-\-name\fP استفاده کنید.
.UNINDENT
.INDENT 0.0
.TP
.B \-F, \-\-show\-form
نمایش نوع‌های فرم DWARF پس از نوع‌های مشخصه DWARF.
.UNINDENT
.INDENT 0.0
.TP
.B \-h, \-\-help
نمایش راهنما و نحوه استفاده از این دستور.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-help\-list
نمایش راهنما و نحوه استفاده از دستور بدون گروه‌بندی گزینه‌ها
در دسته‌بندی‌ها.
.UNINDENT
.INDENT 0.0
.TP
.B \-i, \-\-ignore\-case
صرف‌نظر از کوچکی و بزرگی حروف هنگام استفاده از \fB\-\-name\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-n <name>, \-\-name=<name>
یافتن و چاپ تمام مدخل‌های اطلاعات اشکال‌زدایی که نام آن‌ها
(مشخصه \fIDW_AT_name\fP/\fIDW_AT_linkage_name\fP) برابر با <name> باشد.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-lookup=<address>
جستجوی <address> در اطلاعات اشکال‌زدایی و چاپ جزئیات فایل،
تابع، بلوک و جدول خطوط.
.UNINDENT
.INDENT 0.0
.TP
.B \-o <path>
هدایت خروجی به فایل مشخص‌شده توسط <path>، که در آن \fI\-\fP نشان‌دهنده
جریان خروجی استاندارد است.
.UNINDENT
.INDENT 0.0
.TP
.B \-p, \-\-show\-parents
نمایش والدین یک مدخل اطلاعات اشکال‌زدایی هنگام چاپ انتخابی با
آرگومان \fI=<offset>\fP در \fB\-\-debug\-info\fP، یا گزینه‌هایی
مانند \fB\-\-find\fP یا \fB\-\-name\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-parent\-recurse\-depth=<N>
هنگام نمایش والدین مدخل اطلاعات اشکال‌زدایی، تنها تا
حداکثر عمق <N> نمایش داده شوند.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-quiet
استفاده همراه با \fB\-\-verify\fP برای جلوگیری از ارسال پیام‌ها به \fISTDOUT\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-r <N>, \-\-recurse\-depth=<N>
هنگام نمایش مدخل‌های اطلاعات اشکال‌زدایی، فرزندان فقط تا حداکثر
عمق <N> نمایش داده شوند.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-show\-section\-sizes
نمایش اندازه تمام بخش‌های اشکال‌زدایی بر حسب بایت.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-show\-sources
چاپ تمام فایل‌های منبع ذکرشده در اطلاعات اشکال‌زدایی. در صورت امکان،
مسیرهای مطلق ارائه می‌شوند.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-statistics
جمع‌آوری معیارهای کیفیت اطلاعات اشکال‌زدایی و چاپ نتایج
به صورت خروجی تک‌خطی JSON با قابلیت پردازش ماشینی. قالب
خروجی در بخش زیر (قالب خروجی آمار) توضیح داده شده است.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-summarize\-types
خلاصه‌سازی توضیحات مدخل‌های واحد نوع (type unit entries).
.UNINDENT
.INDENT 0.0
.TP
.B \-t, \-\-filter\-child\-tag
تنها فرزندانی تخلیه شوند که برچسب DWARF آن‌ها یکی از برچسب‌های مشخص‌شده باشد.
مثال کاربردی:
.INDENT 7.0
.INDENT 3.5
.sp
.EX
llvm\-dwarfdump \-t DW_TAG_structure_type \-t DW_TAG_member \-c
.EE
.UNINDENT
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B \-x, \-\-regex
در نظر گرفتن هرگونه رشته <name> به عنوان عبارت منظم (regex) هنگام جستجو
با \fB\-\-name\fP\&. اگر \fB\-\-ignore\-case\fP نیز مشخص شده باشد،
عبارت منظم به حروف کوچک و بزرگ غیرحساس می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-u, \-\-uuid
نمایش UUID برای هر معماری.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-diff
چاپ خروجی در قالبی مناسب‌تر برای مقایسه
خروجی DWARF دو فایل متفاوت.
.UNINDENT
.INDENT 0.0
.TP
.B \-v, \-\-verbose
نمایش اطلاعات مشروح هنگام تخلیه. این گزینه می‌تواند در اشکال‌زدایی
مشکلات DWARF مفید باشد.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-verify
اعتبارسنجی ساختار اطلاعات DWARF از طریق بررسی زنجیره‌های واحدهای کامپایل،
گراف روابط DIE، محدوده‌های
آدرس و موارد دیگر.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-verify\-json=<path>
ارسال خلاصه خطای قالب‌بندی‌شده با JSON به فایل مشخص‌شده با
<path>. مستلزم \fB\-\-verify\fP است. قالب خروجی در بخش
زیر (قالب خروجی اعتبارسنجی JSON) شرح داده شده است.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-version
نمایش نسخه ابزار.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-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 بر اساس نام. به‌طور پیش‌فرض تنها
بخش \fI\&.debug_info\fP نمایش داده می‌شود. برخی مدخل‌ها
از افزودن \fI=<offset>\fP برای ارائه یک آفست اختیاری
از مدخل دقیق مورد نظر در بخش مربوطه پشتیبانی می‌کنند.
هنگامی که آفست مشخص شود، تنها مدخل موجود در آن آفست چاپ
خواهد شد؛ در غیر این صورت کل بخش تخلیه می‌شود.
.sp
گزینه \fB\-\-debug\-macro\fP هر دو بخش .debug_macro و .debug_macinfo را چاپ می‌کند.
.sp
گزینه‌های \fB\-\-debug\-frame\fP و \fB\-\-eh\-frame\fP نام‌های مستعار هستند؛ در صورتی که هر دو بخش وجود داشته باشند، یک دستور هر دو را خروجی می‌دهد.
.UNINDENT
.INDENT 0.0
.TP
.B @<FILE>
خواندن گزینه‌های خط فرمان از \fI<FILE>\fP\&.
.UNINDENT
.SH "قالب خروجی آمار (FORMAT OF STATISTICS OUTPUT)"
.sp
گزینه \fB\-\-statistics\fP خروجی تک‌خطی JSON تولید می‌کند که
نشان‌دهنده معیارهای کیفیت اطلاعات اشکال‌زدایی پردازش‌شده است. این معیارها
برای مقایسه تغییرات بین دو کامپایلر مفیدند، به‌ویژه برای ارزیابی
تأثیری که تغییر کامپایلر بر کیفیت اطلاعات اشکال‌زدایی می‌گذارد.
.sp
خروجی به صورت جفت‌های کلید\-مقدار قالب‌بندی می‌شود. نخستین جفت حاوی شماره
نسخه است. الگوی نام‌گذاری زیر برای کلیدها استفاده می‌شود:
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.IP \(bu 2
\fIvariables\fP ==> متغیرهای محلی و پارامترها
.IP \(bu 2
\fIlocal vars\fP ==> متغیرهای محلی
.IP \(bu 2
\fIparams\fP ==> پارامترهای رسمی
.UNINDENT
.INDENT 0.0
.UNINDENT
.UNINDENT
.sp
برای مقادیر تجمیع‌شده، کلیدهای زیر استفاده می‌شوند:
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.IP \(bu 2
\fIsum_of_all_variables(...)\fP ==> مجموع اعمال‌شده بر تمامی متغیرها
.IP \(bu 2
\fI#bytes\fP ==> تعداد بایت‌ها
.IP \(bu 2
\fI#variables \- entry values ...\fP ==> تعداد متغیرها بدون احتساب
مقادیر ورودی و غیره.
.UNINDENT
.UNINDENT
.UNINDENT
.SH "قالب خروجی اعتبارسنجی JSON (FORMAT OF VERIFY JSON OUTPUT)"
.sp
قالب خروجی JSON ایجادشده توسط \fB\-\-verify\-json\fP به صورت زیر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqerror\-categories\(dq: {
    \(dq<first category description>\(dq: {\(dqcount\(dq: 1234},
    \(dq<next category description>\(dq: {\(dqcount\(dq: 4321}
  },
  \(dqerror\-count\(dq: 5555
}
.EE
.UNINDENT
.UNINDENT
.sp
در صورتی که هیچ خطایی گزارش نشود، خروجی زیر تولید می‌گردد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqerror\-categories\(dq: {},
  \(dqerror\-count\(dq: 0
}
.EE
.UNINDENT
.UNINDENT
.SH "وضعیت خروج (EXIT STATUS)"
.sp
اگر فایل‌های ورودی با موفقیت تجزیه و چاپ شوند، \fBllvm\-dwarfdump\fP مقدار 0 را بازمی‌گرداند.
در غیر این صورت، مقدار 1 بازگردانده می‌شود.
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBdsymutil(1) \%<dsymutil\:.html>\fP
.SH "نویسنده (AUTHOR)"
نگه‌داری‌شده توسط تیم LLVM (https://llvm.org).
.SH "حق نشر (COPYRIGHT)"
2003-2026, LLVM Project
.\" End of generated man page.