.\" 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-DWARFUTIL" "1" "2026-07-15" "22" "LLVM"
.SH "نام (NAME)"
llvm-dwarfutil \- ابزاری برای رونویسی و دستکاری اطلاعات اشکال‌زدایی
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBllvm\-dwarfutil\fP [\fIoptions\fP] \fIinput\fP \fIoutput\fP
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \fBllvm\-dwarfutil\fP ابزاری برای رونویسی و دستکاری اطلاعات اشکال‌زدایی (debug info) است.
.sp
در کاربرد پایه‌ای، این ابزار یک رونوشت معنایی از ورودی به خروجی تهیه می‌کند. در صورت مشخص شدن هر گزینه‌ای، ممکن است خروجی در طول فرایند تغییر یابد؛ برای نمونه از طریق حذف اطلاعات اشکال‌زدایی بلااستفاده.
.sp
اگر برای فایل ورودی عبارت \(dq\-\(dq مشخص شود، ورودی از جریان ورودی استاندارد برنامه خوانده می‌شود. اگر برای فایل خروجی عبارت \(dq\-\(dq مشخص شود، خروجی در جریان خروجی استاندارد برنامه نوشته خواهد شد.
.sp
این ابزار همچنان در دست توسعهٔ فعال است.
.SH "گزینه‌های خط فرمان (COMMAND-LINE OPTIONS)"
.INDENT 0.0
.TP
.B \-\-garbage\-collection
بخش‌هایی از اطلاعات اشکال‌زدایی مربوط به بخش‌های دور ریخته‌شده را حذف می‌کند.
هنگامی که پیونددهنده عمل پاک‌سازی بخش‌های بلااستفاده (section garbage collection) را انجام می‌دهد، اطلاعات اشکال‌زدایی رهاشده بر جای می‌ماند. چنین اطلاعاتی با استفاده از مقادیر سنگ قبر (tombstone values) به بازه‌های آدرس ارجاع می‌دهند. از این رو، با مشخص کردن این گزینه، ابزار اطلاعات اشکال‌زدایی علامت‌گذاری‌شده با مقدار tombstone را حذف می‌کند.
.sp
این گزینه به صورت پیش‌فرض فعال است.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-odr\-deduplication
انواع (types) تکراری را حذف می‌کند (در صورتی که قاعدهٔ تعریف یگانه یا \(dqOne Definition Rule\(dq توسط زبان مبدأ پشتیبانی شود). نخستین تعریف نوع را نگه می‌دارد و سایر تعریف‌ها را حذف می‌کند، که به طور بالقوه حجم اطلاعات اشکال‌زدایی خروجی را به طور چشمگیری کاهش می‌دهد.
.sp
این گزینه به صورت پیش‌فرض فعال است.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-help, \-h
نمایش خلاصه‌ای از گزینه‌های خط فرمان.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-no\-garbage\-collection
غیرفعال کردن \fB\-\-garbage\-collection\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-no\-odr\-deduplication
غیرفعال کردن \fB\-\-odr\-deduplication\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-no\-separate\-debug\-file
غیرفعال کردن \fB\-\-separate\-debug\-file\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-num\-threads=<n>, \-j
حداکثر تعداد (\fIn\fP) رشته‌های هم‌روند (threads) هم‌زمان را برای استفاده در پردازش مشخص می‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-separate\-debug\-file
تولید یک فایل جداگانه حاوی اطلاعات اشکال‌زدایی خروجی. استفاده از \fBllvm\-dwarfutil\fP با این گزینه معادل با مجموعه دستورهای زیر است:
.UNINDENT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
:program:\(gallvm\-objcopy\(ga \-\-only\-keep\-debug in\-file out\-file.debug
:program:\(gallvm\-objcopy\(ga \-\-strip\-debug in\-file out\-file
:program:\(gallvm\-objcopy\(ga \-\-add\-gnu\-debuglink=out\-file.debug out\-file
.EE
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B \-\-tombstone=<value>
مقدار <value> می‌تواند یکی از مقادیر زیر باشد:
.INDENT 7.0
.INDENT 3.5
.INDENT 0.0
.IP \(bu 2
\fIbfd\fP: صفر برای تمام آدرس‌ها و [1,1] برای بازه‌های آدرس DWARF v4 (یا کمتر) و exec.
.IP \(bu 2
\fImaxpc\fP: مقدار \-1 برای تمام آدرس‌ها و \-2 برای بازه‌های آدرس DWARF v4 (یا کمتر).
.IP \(bu 2
\fIuniversal\fP: هر دو مقدار \fIbfd\fP و \fImaxpc\fP\&.
.IP \(bu 2
\fIexec\fP: تطبیق با بازه‌های آدرس بخش‌های اجرایی (executable).
.UNINDENT
.sp
مقدار \fIuniversal\fP به صورت پیش‌فرض استفاده می‌شود.
.UNINDENT
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B \-\-verbose
فعال‌سازی گزارش‌گیری مشروح (verbose). این گزینه حالت چندرشته‌ای را غیرفعال می‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-verify
اجرای اعتبارسنج DWARF روی اطلاعات اشکال‌زدایی DWARF خروجی.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-version
نمایش نسخهٔ این برنامه.
.UNINDENT
.SH "قالب‌های پشتیبانی‌شده (SUPPORTED FORMATS)"
.sp
قالب‌های زیر در حال حاضر توسط \fBllvm\-dwarfutil\fP پشتیبانی می‌شوند:
.sp
ELF
.SH "وضعیت خروج (EXIT STATUS)"
.sp
در صورت بروز خطا، \fBllvm\-dwarfutil\fP با یک کد خروج غیرصفر خارج می‌شود. در غیر این صورت، با کد 0 خارج می‌شود.
.SH "گزارش باگ‌ها (BUGS)"
.sp
برای گزارش باگ‌ها، لطفاً به نشانی <\%<https://\:github\:.com/\:llvm/\:llvm-project/\:labels/\:tools:llvm-dwarfutil>> مراجعه کنید.
.SH "نویسندگان (AUTHORS)"
توسط تیم LLVM نگهداری می‌شود (<https://llvm.org>).
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
2003-2026, LLVM Project
.\" End of generated man page.