.\" 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-READOBJ" "1" "2026-07-15" "22" "LLVM" .SH "نام (NAME)" llvm-readobj \- ابزار خواندن پرونده‌های شیء LLVM .SH "خلاصه دستور (SYNOPSIS)" .sp \fBllvm\-readobj\fP [\fIoptions\fP] [\fIinput...\fP] .SH "توضیحات (DESCRIPTION)" .sp ابزار \fBllvm\-readobj\fP اطلاعات سطح پایین و وابسته به قالب پرونده را درباره یک یا چند پرونده شیء نمایش می‌دهد. .sp اگر \fBinput\fP برابر با \(dq\fB\-\fP\(dq باشد، \fBllvm\-readobj\fP از ورودی استاندارد می‌خواند. در غیر این صورت، از \fBfilenames\fP مشخص‌شده خواهد خواند. .SH "تفاوت‌ها با LLVM-READELF (DIFFERENCES TO LLVM-READELF)" .sp ابزار \fBllvm\-readelf\fP یک نام مستعار برای ابزار \fBllvm\-readobj \%\fP با یک رابط خط فرمان کمی متفاوت و خروجی سازگار با GNU است. در ادامه فهرستی از تفاوت‌های میان \fBllvm\-readelf\fP و \fBllvm\-readobj\fP آورده شده است: .INDENT 0.0 .IP \(bu 2 \fBllvm\-readelf\fP به‌طور پیش‌فرض از \fIGNU\fP برای گزینه \fB\-\-elf\-output\-style\fP استفاده می‌کند. \fBllvm\-readobj\fP از \fILLVM\fP استفاده می‌کند. .IP \(bu 2 \fBllvm\-readelf\fP اجازه استفاده از پرچم‌های تک‌حرفی گروه‌بندی‌شده را می‌دهد (برای مثال \fBllvm\-readelf \-SW\fP مشابه \fBllvm\-readelf \-S \-W\fP است). \fBllvm\-readobj\fP گروه‌بندی را مجاز نمی‌داند. .IP \(bu 2 \fBllvm\-readelf\fP برای سازگاری با \fBreadelf\fP گنو، گزینه \fB\-s\fP را به عنوان یک نام مستعار برای \fB\-\-symbols\fP ارائه می‌دهد، در حالی که در \fBllvm\-readobj\fP نام مستعاری برای \fB\-\-section\-headers\fP است. .IP \(bu 2 \fBllvm\-readobj\fP گزینه \fB\-t\fP را به عنوان نام مستعاری برای \fB\-\-symbols\fP ارائه می‌دهد؛ \fBllvm\-readelf\fP این امکان را فراهم نمی‌کند. .IP \(bu 2 \fBllvm\-readobj\fP به ترتیب \fB\-\-sr\fP، \fB\-\-sd\fP، \fB\-\-st\fP و \fB\-\-dt\fP را به عنوان نام‌های مستعار برای \fB\-\-section\-relocations\fP، \fB\-\-section\-data\fP، \fB\-\-section\-symbols\fP و \fB\-\-dyn\-symbols\fP ارائه می‌دهد. \fBllvm\-readelf\fP برای جلوگیری از تداخل با پرچم‌های گروه‌بندی‌شده، این نام‌های مستعار را ارائه نمی‌کند. .UNINDENT .SH "گزینه‌های عمومی و چندقالبی (GENERAL AND MULTI-FORMAT OPTIONS)" .sp این گزینه‌ها برای بیش از یک قالب پرونده کاربرد دارند، یا ارتباطی با قالب‌های پرونده ندارند. .INDENT 0.0 .TP .B \-\-all معادل با مشخص کردن تمام گزینه‌های اصلی نمایش مربوط به قالب پرونده است. .UNINDENT .INDENT 0.0 .TP .B \-\-addrsig جدول اهمیت نشانی (address\-significance) را نمایش می‌دهد. .UNINDENT .INDENT 0.0 .TP .B \-\-decompress, \-z هنگامی که همراه با \fB\-x\fP یا \fB\-p\fP استفاده شود، محتوای فشرده‌زدایی‌شدهٔ بخش را تخلیه (dump) می‌کند. اگر بخش(ها) فشرده نباشند، همان‌طور که هستند نمایش داده می‌شوند. .UNINDENT .INDENT 0.0 .TP .B \-\-demangle, \-C نام نمادهای ناآراسته (demangled) را در خروجی نمایش می‌دهد. این گزینه فقط برای قالب‌های پرونده ELF و XCOFF است. .UNINDENT .INDENT 0.0 .TP .B \-\-expand\-relocs هنگامی که همراه با \fB\-\-relocs\fP استفاده شود، هر بازنشانی (relocation) را در قالبی بازشده و چندخطی نمایش می‌دهد. .UNINDENT .INDENT 0.0 .TP .B \-\-file\-header, \-h سرایندهای پرونده را نمایش می‌دهد. .UNINDENT .INDENT 0.0 .TP .B \-\-headers, \-e معادل با مشخص کردن: \fB\-\-file\-header\fP، \fB\-\-program\-headers\fP و \fB\-\-sections\fP\&. .UNINDENT .INDENT 0.0 .TP .B \-\-help خلاصه‌ای از گزینه‌های خط فرمان را نمایش می‌دهد. .UNINDENT .INDENT 0.0 .TP .B \-\-hex\-dump=, \-x بخش(های) مشخص‌شده را به صورت بایت‌های شانزده‌شانزدهی (هگزادسیمال) نمایش می‌دهد. \fBsection\fP می‌تواند یک نمایه بخش یا نام بخش باشد. .INDENT 7.0 .TP .B \-\-memtag .UNINDENT .sp اطلاعات مربوط به برچسب‌گذاری حافظه (memory tagging) موجود در باینری را نمایش می‌دهد. این شامل ورودی‌های پویای گوناگون مختص به memtag، بخش‌های توصیف‌گر سراسری رمزگشایی‌شده، و یادداشت‌های ELF رمزگشایی‌شده مختص به Android است. .UNINDENT .INDENT 0.0 .TP .B \-\-needed\-libs کتابخانه‌های مورد نیاز را نمایش می‌دهد. .UNINDENT .INDENT 0.0 .TP .B \-\-no\-demangle نام نمادها را در خروجی ناآراسته (demangle) نمی‌کند. این گزینه فقط برای قالب‌های پرونده ELF و XCOFF است. این گزینه به‌طور پیش‌فرض فعال است. .UNINDENT .INDENT 0.0 .TP .B \-\-offloading فهرست بسته‌های باراندازی (offload) HIP را نمایش می‌دهد. .UNINDENT .INDENT 0.0 .TP .B \-\-relocations, \-\-relocs, \-r ورودی‌های بازنشانی (relocation) موجود در پرونده را نمایش می‌دهد. .UNINDENT .INDENT 0.0 .TP .B \-\-sections, \-\-section\-headers, \-S همه بخش‌ها را نمایش می‌دهد. .UNINDENT .INDENT 0.0 .TP .B \-\-section\-data, \-\-sd هنگامی که همراه با \fB\-\-sections\fP استفاده شود، داده‌های بخش را برای هر بخش نمایش‌داده‌شده نشان می‌دهد. این گزینه برای خروجی به سبک GNU هیچ اثری ندارد. .UNINDENT .INDENT 0.0 .TP .B \-\-section\-relocations, \-\-sr هنگامی که همراه با \fB\-\-sections\fP استفاده شود، بازنشانی‌ها را برای هر بخش نمایش‌داده‌شده نشان می‌دهد. این گزینه برای خروجی به سبک GNU هیچ اثری ندارد. .UNINDENT .INDENT 0.0 .TP .B \-\-section\-symbols, \-\-st هنگامی که همراه با \fB\-\-sections\fP استفاده شود، نمادها را برای هر بخش نمایش‌داده‌شده نشان می‌دهد. این گزینه برای خروجی به سبک GNU هیچ اثری ندارد. .UNINDENT .INDENT 0.0 .TP .B \-\-sort\-symbols= کلیدها را برای مرتب‌سازی نمادها پیش از نمایش symtab مشخص می‌کند. مقادیر معتبر برای sort_key عبارتند از \fBname\fP و \fBtype\fP\&. .UNINDENT .INDENT 0.0.TP .B \-\-stackmap نمایش محتویات بخش stackmap. .UNINDENT .INDENT 0.0 .TP .B \-\-string\-dump=, \-p نمایش بخش(های) مشخص‌شده به‌صورت فهرستی از رشته‌ها. \fBsection\fP می‌تواند یک نمایه بخش یا نام بخش باشد. .UNINDENT .INDENT 0.0 .TP .B \-\-string\-table نمایش محتویات جدول رشته‌ها. .UNINDENT .INDENT 0.0 .TP .B \-\-symbols, \-\-syms, \-s نمایش جدول نمادها. .UNINDENT .INDENT 0.0 .TP .B \-\-unwind, \-u نمایش اطلاعات بازگشت پشته (unwind). .UNINDENT .INDENT 0.0 .TP .B \-\-version نمایش نسخه فایل اجرایی \fBllvm\-readobj\fP. .UNINDENT .INDENT 0.0 .TP .B @ خواندن گزینه‌های خط فرمان از فایل پاسخ \fI\fP\&. .UNINDENT .SH "گزینه‌های ویژه ELF (ELF SPECIFIC OPTIONS)" .sp گزینه‌های زیر فقط برای قالب پرونده ELF پیاده‌سازی شده‌اند. .INDENT 0.0 .TP .B \-\-arch\-specific, \-A نمایش اطلاعات وابسته به معماری؛ مانند بخش ویژگی‌های ARM در ARM. .UNINDENT .INDENT 0.0 .TP .B \-\-bb\-addr\-map نمایش محتویات بخش(های) نگاشت آدرس بلوک‌های پایه (basic block)، که شامل آدرس هر تابع به‌همراه آفست نسبی هر بلوک پایه است. .sp هنگامی که نگاشت‌های تحلیل pgo موجود باشند، تمام تحلیل‌ها به‌صورت مقدار خام آنها چاپ می‌شوند. .UNINDENT .INDENT 0.0 .TP .B \-\-pretty\-pgo\-analysis\-map هنگامی که نگاشت‌های تحلیل pgo در بخش(های) نگاشت آدرس بلوک پایه موجود باشند، تحلیل‌های دارای قالب‌های ویژه (مانند BlockFrequency، BranchProbability و غیره) با همان قالبی که در مرحله تحلیل مربوطه دارند چاپ می‌شوند. .sp برای اعمال، نیازمند گزینه \fB\-\-bb\-addr\-map\fP است. .UNINDENT .INDENT 0.0 .TP .B \-\-dependent\-libraries نمایش بخش کتابخانه‌های وابسته. .UNINDENT .INDENT 0.0 .TP .B \-\-dyn\-relocations نمایش مدخل‌های بازنشانی پویا. .UNINDENT .INDENT 0.0 .TP .B \-\-dyn\-symbols, \-\-dyn\-syms, \-\-dt نمایش جدول نمادهای پویا. .UNINDENT .INDENT 0.0 .TP .B \-\-dynamic\-table, \-\-dynamic, \-d نمایش جدول پویا. .UNINDENT .INDENT 0.0 .TP .B \-\-cg\-profile نمایش بخش پروفایل گراف فراخوانی (callgraph). .UNINDENT .INDENT 0.0 .TP .B \-\-histogram, \-I نمایش بافت‌نگار فهرست باکت‌ها برای جدول‌های درهم‌سازی نماد پویا. .UNINDENT .INDENT 0.0 .TP .B \-\-elf\-linker\-options نمایش بخش گزینه‌های پیونددهنده. .UNINDENT .INDENT 0.0 .TP .B \-\-elf\-output\-style= قالب‌بندی اطلاعات ELF بر اساس سبک مشخص‌شده. گزینه‌های معتبر عبارتند از \fBLLVM\fP، \fBGNU\fP و \fBJSON\fP\&. خروجی \fBLLVM\fP (پیش‌فرض) قالبی بسط‌یافته و ساختاریافته است. خروجی \fBGNU\fP ساختار خروجی معادل دستور \fBreadelf\fP در GNU را شبیه‌سازی می‌کند. خروجی \fBJSON\fP خروجی با ساختار JSON است که برای پردازش ماشینی در نظر گرفته شده است. .UNINDENT .INDENT 0.0 .TP .B \-\-section\-groups, \-g نمایش گروه‌های بخش‌ها. .UNINDENT .INDENT 0.0 .TP .B \-\-gnu\-hash\-table نمایش جدول درهم‌سازی GNU برای نمادهای پویا. .UNINDENT .INDENT 0.0 .TP .B \-\-hash\-symbols نمایش جدول درهم‌سازی بسط‌یافته به‌همراه داده‌های نمادهای پویا. .UNINDENT .INDENT 0.0 .TP .B \-\-hash\-table نمایش جدول درهم‌سازی برای نمادهای پویا. .UNINDENT .INDENT 0.0 .TP .B \-\-memtag نمایش اطلاعات برچسب‌گذاری حافظه (memory tagging) موجود در باینری. این اطلاعات شامل مدخل‌های پویای مختلف، بخش‌های توصیف‌گر سراسری رمزگشایی‌شده و یادداشت‌های رمزگشایی‌شده ELF ویژه Android است. .UNINDENT .INDENT 0.0 .TP .B \-\-notes, \-n نمایش تمام یادداشت‌ها (notes). .UNINDENT .INDENT 0.0 .TP .B \-\-pretty\-print هنگام استفاده به‌همراه \fB\-\-elf\-output\-style\fP، خروجی JSON در قالبی خواناتر و مرتب‌تر قالب‌بندی می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-\-program\-headers, \-\-segments, \-l نمایش سرآیندهای برنامه. .UNINDENT .INDENT 0.0 .TP .B \-\-section\-mapping نمایش نگاشت بخش به قطعه (segment). .UNINDENT .INDENT 0.0 .TP .B \-\-stack\-sizes نمایش محتویات بخش(های) اندازه پشته، یعنی جفت نام‌های توابع و اندازه فریم پشته آنها. در حال حاضر فقط برای سبک خروجی GNU پیاده‌سازی شده است. .UNINDENT .INDENT 0.0 .TP .B \-\-version\-info, \-V نمایش بخش‌های نسخه. .UNINDENT.SH "گزینه‌های مختص MACH-O (MACH-O SPECIFIC OPTIONS)" .sp گزینه‌های زیر تنها برای قالب فایل Mach\-O پیاده‌سازی شده‌اند. .INDENT 0.0 .TP .B \-\-macho\-data\-in\-code نمایش دستور Data in Code. .UNINDENT .INDENT 0.0 .TP .B \-\-macho\-dsymtab نمایش دستور Dsymtab. .UNINDENT .INDENT 0.0 .TP .B \-\-macho\-indirect\-symbols نمایش نمادهای غیرمستقیم (indirect symbols). .UNINDENT .INDENT 0.0 .TP .B \-\-macho\-linker\-options نمایش گزینه‌های پیونددهنده مختص Mach\-O. .UNINDENT .INDENT 0.0 .TP .B \-\-macho\-segment نمایش دستور Segment. .UNINDENT .INDENT 0.0 .TP .B \-\-macho\-version\-min نمایش دستور version min. .UNINDENT .SH "گزینه‌های مختص PE/COFF (PE/COFF SPECIFIC OPTIONS)" .sp گزینه‌های زیر تنها برای قالب فایل PE/COFF پیاده‌سازی شده‌اند. .INDENT 0.0 .TP .B \-\-codeview نمایش اطلاعات اشکال‌زدایی CodeView. .UNINDENT .INDENT 0.0 .TP .B \-\-codeview\-ghash فعال‌سازی هشینگ سراسری جهت حذف موارد تکراری در جریان نوع (type stream) متعلق به CodeView. .UNINDENT .INDENT 0.0 .TP .B \-\-codeview\-merged\-types نمایش جریان نوع ادغام‌شده CodeView. .UNINDENT .INDENT 0.0 .TP .B \-\-codeview\-subsection\-bytes تخلیه محتوای خام رکوردها و بخش‌های اشکال‌زدایی CodeView. .UNINDENT .INDENT 0.0 .TP .B \-\-coff\-basereloc نمایش بخش .reloc. .UNINDENT .INDENT 0.0 .TP .B \-\-coff\-debug\-directory نمایش دایرکتوری اشکال‌زدایی (debug directory). .UNINDENT .INDENT 0.0 .TP .B \-\-coff\-tls\-directory نمایش دایرکتوری TLS. .UNINDENT .INDENT 0.0 .TP .B \-\-coff\-directives نمایش بخش .drectve. .UNINDENT .INDENT 0.0 .TP .B \-\-coff\-exports نمایش جدول نمادهای صادرشده (export table). .UNINDENT .INDENT 0.0 .TP .B \-\-coff\-imports نمایش جدول نمادهای واردشده (import table). .UNINDENT .INDENT 0.0 .TP .B \-\-coff\-load\-config نمایش ساختار پیکربندی بارگذاری (load config). .UNINDENT .INDENT 0.0 .TP .B \-\-coff\-resources نمایش بخش .rsrc. .UNINDENT.SH "گزینه‌های اختصاصی XCOFF (XCOFF SPECIFIC OPTIONS)" .sp گزینه‌های زیر تنها برای قالب فایل XCOFF پیاده‌سازی شده‌اند. .INDENT 0.0 .TP .B \-\-auxiliary\-header نمایش سرایند کمکی XCOFF. .UNINDENT .INDENT 0.0 .TP .B \-\-exception\-section نمایش مدخل‌های بخش استثنای XCOFF. .UNINDENT .INDENT 0.0 .TP .B \-\-loader\-section\-header نمایش سرایند بخش بارگذار XCOFF. .UNINDENT .INDENT 0.0 .TP .B \-\-loader\-section\-symbols نمایش جدول نمادهای بخش بارگذار. .UNINDENT .INDENT 0.0 .TP .B \-\-loader\-section\-relocations نمایش مدخل‌های بازنشانی بخش بارگذار. .UNINDENT .SH "وضعیت خروج (EXIT STATUS)" .sp دستور \fBllvm\-readobj\fP در شرایط عملکرد عادی مقدار 0 را بازمی‌گرداند. در صورت بروز هرگونه خطا، یک کد خروج غیرصفر برگردانده می‌شود. .SH "همچنین ببینید (SEE ALSO)" .sp \fBllvm\-nm(1) \%\fP، \fBllvm\-objdump(1) \%\fP، \fBllvm\-readelf(1) \%\fP .SH "نویسندگان (AUTHORS)" توسط تیم LLVM نگهداری می‌شود (https://llvm.org). .SH "کپی‌رایت و تکثیر (COPYRIGHT)" 2003-2026، LLVM Project .\" End of generated man page.