.\" 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 "DSYMUTIL" "1" "2026-07-15" "22" "LLVM"
.SH "نام (NAME)"
dsymutil \- دستکاری فایل‌های نماد اشکال‌زدایی آرشیو شدهٔ DWARF
.SH "خلاصه دستور (SYNOPSIS)"
.nf
\fBdsymutil\fP [\fIoptions\fP] \fIexecutable\fP
.fi
.sp
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \fBdsymutil\fP اطلاعات اشکال‌زدایی DWARF موجود در فایل‌های شیء را برای فایل اجرایی \fIexecutable\fP با استفاده از اطلاعات نمادهای اشکال‌زدایی موجود در جدول نماد آن پیوند می‌دهد. به‌طور پیش‌فرض، اطلاعات اشکال‌زدایی پیوند داده‌شده در یک بستهٔ \fB\&.dSYM\fP هم‌نام با فایل اجرایی قرار می‌گیرد.
.SH "گزینه‌ها (OPTIONS)"
.INDENT 0.0
.TP
.B \-\-accelerator=<accelerator type>
نوع مورد نظر جدول شتاب‌دهنده را مشخص می‌کند. گزینه‌های معتبر عبارتند از \(aqApple\(aq، \(aqDwarf\(aq، \(aqDefault\(aq و \(aqNone\(aq.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-arch <arch>
اطلاعات اشکال‌زدایی DWARF را فقط برای انواع معماری CPU مشخص‌شده پیوند می‌دهد. معماری‌ها را می‌توان با نام مشخص کرد. هنگام استفاده از این گزینه، در صورتی که هر یک از معماری‌ها نتوانند به درستی پیوند داده شوند، خطایی بازگردانده می‌شود. این گزینه می‌تواند چندین بار مشخص شود؛ یک‌بار به ازای هر معماری مورد نظر. به‌طور پیش‌فرض تمام معماری‌های CPU پیوند داده خواهند شد و هر معماری که نتواند به درستی پیوند یابد باعث بازگرداندن خطا از سوی \fBdsymutil\fP می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-build\-variant\-suffix <suffix=buildvariant>
پسوند گونهٔ ساخت مورد استفاده برای ساخت فایل اجرایی را مشخص می‌کند. یک محصول ممکن است چندین گونهٔ باینری داشته باشد که هر کدام کمی متفاوت ساخته شده‌اند. رایج‌ترین گونه‌های ساخت \(aqdebug\(aq و \(aqprofile\(aq هستند. تنظیم متغیر محیطی DYLD_IMAGE_SUFFIX باعث می‌شود dyld گونهٔ مشخص‌شده را در زمان اجرا بارگذاری کند.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-dump\-debug\-map
نقشهٔ اشکال‌زدایی (debug\-map) مربوط به \fIexecutable\fP (فهرست فایل‌های شیء حاوی اطلاعات اشکال‌زدایی) را در قالب YAML نمایش داده و خارج می‌شود. هیچ پیوند DWARFای انجام نخواهد شد.
.INDENT 7.0
.TP
.B \-D <path>
.UNINDENT
.sp
دایرکتوری حاوی فایل‌های dSYM را برای جستجو مشخص می‌کند.
این گزینه برای کتابخانه‌های ادغام‌پذیر استفاده می‌شود تا dsymutil بداند فایل‌های dSYM حاوی اطلاعات اشکال‌زدایی مربوط به نمادهای موجود در آن کتابخانه‌ها را در کجا جستجو کند.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-fat64
هنگام صدور باینری‌های universal، از یک سرایند ۶۴ بیتی استفاده می‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-flat, \-f
یک فایل مسطح (flat) dSYM تولید می‌کند. پسوند \fB\&.dwarf\fP به انتهای نام فایل اجرایی افزوده خواهد شد، مگر اینکه فایل خروجی با استفاده از گزینهٔ \fB\-o\fP مشخص شده باشد.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-gen\-reproducer
یک بازتولیدکننده (reproducer) متشکل از فایل‌های شیء ورودی تولید می‌کند. نام مستعار برای \-\-reproducer=GenerateOnExit.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-help, \-h
نمایش این پیام راهنما.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-include\-swiftmodules\-from\-interface
تعیین می‌کند که آیا swiftmoduleهای باینری ساخته‌شده از فایل‌های متنی .swiftinterface در بستهٔ dSYM کپی شوند یا خیر. این‌ها معمولاً فقط از طریق SDK ارائه می‌شوند (زیرا واسط‌های متنی نیازمند تکامل کتابخانه هستند) و بنابراین کپی کردن آن‌ها درون بسته هدر دادن فضا است. در صورتی که swiftmoduleها با موارد موجود در SDK تفاوت دارند، این گزینه را فعال کنید.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-keep\-function\-for\-static
باعث می‌شود که یک متغیر ایستا، تابع دربرگیرندهٔ خود را حفظ کند، حتی اگر در غیر این صورت حذف می‌شد.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-no\-object\-timestamp
برچسب زمانی (timestamp) فایل‌های شیء را بررسی نمی‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-no\-odr
عدم استفاده از ODR (قاعدهٔ یک تعریف یا One Definition Rule) برای یکتاسازی انواع ++C.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-no\-output
عملیات پیوند را در حافظه انجام می‌دهد، اما فایل نتیجه را صادر نمی‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-no\-swiftmodule\-timestamp
برچسب زمانی را برای فایل‌های swiftmodule بررسی نمی‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-num\-threads <threads>, \-j <threads>
حداکثر تعداد (\fBn\fP) ریسمان‌های هم‌زمان را برای استفاده هنگام پیوند چندین معماری مشخص می‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-object\-prefix\-map <prefix=remapped>
مسیرهای فایل‌های شیء (و نه مسیرهای سورس) را قبل از پردازش بازنگاشت می‌کند. از این گزینه برای اشیاء Clang که مکان حافظهٔ پنهان ماژول آن‌ها با استفاده از \fB\-fdebug\-prefix\-map\fP بازنگاشت شده است استفاده کنید، تا به dsymutil در یافتن حافظهٔ پنهان ماژول‌های Clang کمک شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-oso\-prepend\-path <path>
یک \fBpath\fP را جهت اضافه شدن به ابتدای تمام مسیرهای فایل شیء نماد اشکال‌زدایی مشخص می‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-out <filename>, \-o <filename>
یک \fBpath\fP جایگزین را برای قرار دادن بستهٔ dSYM مشخص می‌کند. مسیر پیش‌فرض بستهٔ dSYM با افزودن \fB\&.dSYM\fP به انتهای نام فایل اجرایی ایجاد می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-q, \-\-quiet
فعال‌سازی حالت بی‌صدا و محدود کردن خروجی.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-remarks\-drop\-without\-debug
پیام‌های remark فاقد مکان‌های معتبر اشکال‌زدایی را نادیده می‌گیرد. بدون این گزینه، تمامی remarkها حفظ می‌شوند.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-remarks\-output\-format <format>
قالبی که هنگام سریال‌سازی remarkهای پیوند داده شده استفاده می‌شود را مشخص می‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-remarks\-prepend\-path <path>
دایرکتوری مورد نظر را جهت الحاق به ابتدای مسیرهای فایل‌های remark خارجی مشخص می‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-reproducer <mode>
حالت تولید بازتولیدکننده (reproducer) را مشخص می‌کند. گزینه‌های معتبر عبارتند از \(aqGenerateOnExit\(aq، \(aqGenerateOnCrash\(aq، \(aqUse\(aq و \(aqOff\(aq.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-statistics
آمارهایی دربارهٔ سهم هر فایل شیء در اطلاعات اشکال‌زدایی پیوند داده شده چاپ می‌کند. این گزینه پس از پیوند، جدولی شامل نام فایل شیء، اندازهٔ اطلاعات اشکال‌زدایی در فایل شیء (به بایت) و اندازهٔ سهم مشارکت داده شده (به بایت) در dSYM پیوند خورده را چاپ می‌کند. این جدول بر اساس اندازهٔ خروجی مرتب شده و فایل‌های شیء با بیشترین سهم را ابتدا فهرست می‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B \-s, \-\-symtab
جدول نمادهای موجود در \fIexecutable\fP یا فایل(های) شیء را تخلیه (dump) کرده و خارج می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-S
به جای یک فایل همراه dSYM باینری، کد متنی اسمبلی در خروجی تولید می‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-toolchain <toolchain>
زنجیره ابزار (toolchain) را در فهرست ویژگی‌ها (property list) بستهٔ dSYM تعبیه می‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B \-u, \-\-update
یک فایل dSYM موجود را به‌روزرسانی می‌کند تا حاوی جدیدترین جداول شتاب‌دهنده و سایر بهینه‌سازی‌های DWARF باشد. این گزینه جداول شتاب‌دهندهٔ درهم‌سازی‌شدهٔ \(aq.apple_names\(aq و \(aq.apple_types\(aq را دوباره می‌سازد.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-use\-reproducer <path>
از فایل‌های شیء موجود در مسیر بازتولیدکنندهٔ داده‌شده استفاده می‌کند. نام مستعار برای \-\-reproducer=Use.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-verbose
نمایش اطلاعات مفصل هنگام پیوند دادن.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-verify
بررسی‌کننده (verifier) DWARF را روی اطلاعات اشکال‌زدایی DWARF پیوند داده شده اجرا می‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B \-v, \-\-version
نسخهٔ ابزار را نمایش می‌دهد.
.UNINDENT
.INDENT 0.0
.TP
.B \-y
با \fIexecutable\fP مانند یک debug\-map با قالب YAML رفتار می‌کند، نه یک فایل اجرایی.
.UNINDENT
.SH "وضعیت خروج (EXIT STATUS)"
.sp
اگر پیوند اطلاعات اشکال‌زدایی DWARF با موفقیت انجام شود، \fBdsymutil\fP مقدار 0 را بازمی‌گرداند؛ در غیر این صورت، مقدار 1 بازگردانده می‌شود.
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBllvm\-dwarfdump(1) \%<llvm-dwarfdump\:.html>\fP
.SH "نویسندگان (AUTHORS)"
توسط تیم LLVM نگهداری می‌شود (https://llvm.org).
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
2003-2026, LLVM Project
.\" End of generated man page.