نام (NAME)

llvm-readobj - ابزار خواندن پرونده‌های شیء LLVM

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

llvm-readobj [options] [input...]

توضیحات (DESCRIPTION)

ابزار llvm-readobj اطلاعات سطح پایین و وابسته به قالب پرونده را درباره یک یا چند پرونده شیء نمایش می‌دهد.

اگر input برابر با "-" باشد، llvm-readobj از ورودی استاندارد می‌خواند. در غیر این صورت، از filenames مشخص‌شده خواهد خواند.

تفاوت‌ها با LLVM-READELF (DIFFERENCES TO LLVM-READELF)

ابزار llvm-readelf یک نام مستعار برای ابزار llvm-readobj <llvm-readobj.html> با یک رابط خط فرمان کمی متفاوت و خروجی سازگار با GNU است. در ادامه فهرستی از تفاوت‌های میان llvm-readelf و llvm-readobj آورده شده است:

llvm-readelf به‌طور پیش‌فرض از GNU برای گزینه --elf-output-style استفاده می‌کند. llvm-readobj از LLVM استفاده می‌کند.
llvm-readelf اجازه استفاده از پرچم‌های تک‌حرفی گروه‌بندی‌شده را می‌دهد (برای مثال llvm-readelf -SW مشابه llvm-readelf -S -W است). llvm-readobj گروه‌بندی را مجاز نمی‌داند.
llvm-readelf برای سازگاری با readelf گنو، گزینه -s را به عنوان یک نام مستعار برای --symbols ارائه می‌دهد، در حالی که در llvm-readobj نام مستعاری برای --section-headers است.
llvm-readobj گزینه -t را به عنوان نام مستعاری برای --symbols ارائه می‌دهد؛ llvm-readelf این امکان را فراهم نمی‌کند.
llvm-readobj به ترتیب --sr، --sd، --st و --dt را به عنوان نام‌های مستعار برای --section-relocations، --section-data، --section-symbols و --dyn-symbols ارائه می‌دهد. llvm-readelf برای جلوگیری از تداخل با پرچم‌های گروه‌بندی‌شده، این نام‌های مستعار را ارائه نمی‌کند.

گزینه‌های عمومی و چندقالبی (GENERAL AND MULTI-FORMAT OPTIONS)

این گزینه‌ها برای بیش از یک قالب پرونده کاربرد دارند، یا ارتباطی با قالب‌های پرونده ندارند.

--all: معادل با مشخص کردن تمام گزینه‌های اصلی نمایش مربوط به قالب پرونده است.

--addrsig: جدول اهمیت نشانی (address-significance) را نمایش می‌دهد.

--decompress, -z: هنگامی که همراه با -x یا -p استفاده شود، محتوای فشرده‌زدایی‌شدهٔ بخش را تخلیه (dump) می‌کند. اگر بخش(ها) فشرده نباشند، همان‌طور که هستند نمایش داده می‌شوند.

--demangle, -C: نام نمادهای ناآراسته (demangled) را در خروجی نمایش می‌دهد. این گزینه فقط برای قالب‌های پرونده ELF و XCOFF است.

--expand-relocs: هنگامی که همراه با --relocs استفاده شود، هر بازنشانی (relocation) را در قالبی بازشده و چندخطی نمایش می‌دهد.

--file-header, -h: سرایندهای پرونده را نمایش می‌دهد.

--headers, -e: معادل با مشخص کردن: --file-header، --program-headers و --sections.

--help: خلاصه‌ای از گزینه‌های خط فرمان را نمایش می‌دهد.

--hex-dump=<section[,section,...]>, -x: بخش(های) مشخص‌شده را به صورت بایت‌های شانزده‌شانزدهی (هگزادسیمال) نمایش می‌دهد. section می‌تواند یک نمایه بخش یا نام بخش باشد.

--memtag

اطلاعات مربوط به برچسب‌گذاری حافظه (memory tagging) موجود در باینری را نمایش می‌دهد. این شامل ورودی‌های پویای گوناگون مختص به memtag، بخش‌های توصیف‌گر سراسری رمزگشایی‌شده، و یادداشت‌های ELF رمزگشایی‌شده مختص به Android است.

--needed-libs: کتابخانه‌های مورد نیاز را نمایش می‌دهد.

--no-demangle: نام نمادها را در خروجی ناآراسته (demangle) نمی‌کند. این گزینه فقط برای قالب‌های پرونده ELF و XCOFF است. این گزینه به‌طور پیش‌فرض فعال است.

--offloading: فهرست بسته‌های باراندازی (offload) HIP را نمایش می‌دهد.

--relocations, --relocs, -r: ورودی‌های بازنشانی (relocation) موجود در پرونده را نمایش می‌دهد.

--sections, --section-headers, -S: همه بخش‌ها را نمایش می‌دهد.

--section-data, --sd: هنگامی که همراه با --sections استفاده شود، داده‌های بخش را برای هر بخش نمایش‌داده‌شده نشان می‌دهد. این گزینه برای خروجی به سبک GNU هیچ اثری ندارد.

--section-relocations, --sr: هنگامی که همراه با --sections استفاده شود، بازنشانی‌ها را برای هر بخش نمایش‌داده‌شده نشان می‌دهد. این گزینه برای خروجی به سبک GNU هیچ اثری ندارد.

--section-symbols, --st: هنگامی که همراه با --sections استفاده شود، نمادها را برای هر بخش نمایش‌داده‌شده نشان می‌دهد. این گزینه برای خروجی به سبک GNU هیچ اثری ندارد.

--sort-symbols=<sort_key[,sort_key]>: کلیدها را برای مرتب‌سازی نمادها پیش از نمایش symtab مشخص می‌کند. مقادیر معتبر برای sort_key عبارتند از name و type.

--stackmap نمایش محتویات بخش stackmap.

--string-dump=<section[,section,...]>, -p: نمایش بخش(های) مشخص‌شده به‌صورت فهرستی از رشته‌ها. section می‌تواند یک نمایه بخش یا نام بخش باشد.

--string-table: نمایش محتویات جدول رشته‌ها.

--symbols, --syms, -s: نمایش جدول نمادها.

--unwind, -u: نمایش اطلاعات بازگشت پشته (unwind).

--version: نمایش نسخه فایل اجرایی llvm-readobj.

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

گزینه‌های ویژه ELF (ELF SPECIFIC OPTIONS)

گزینه‌های زیر فقط برای قالب پرونده ELF پیاده‌سازی شده‌اند.

--arch-specific, -A: نمایش اطلاعات وابسته به معماری؛ مانند بخش ویژگی‌های ARM در ARM.

--bb-addr-map: نمایش محتویات بخش(های) نگاشت آدرس بلوک‌های پایه (basic block)، که شامل آدرس هر تابع به‌همراه آفست نسبی هر بلوک پایه است.
هنگامی که نگاشت‌های تحلیل pgo موجود باشند، تمام تحلیل‌ها به‌صورت مقدار خام آنها چاپ می‌شوند.

--pretty-pgo-analysis-map: هنگامی که نگاشت‌های تحلیل pgo در بخش(های) نگاشت آدرس بلوک پایه موجود باشند، تحلیل‌های دارای قالب‌های ویژه (مانند BlockFrequency، BranchProbability و غیره) با همان قالبی که در مرحله تحلیل مربوطه دارند چاپ می‌شوند.
برای اعمال، نیازمند گزینه --bb-addr-map است.

--dependent-libraries: نمایش بخش کتابخانه‌های وابسته.

--dyn-relocations: نمایش مدخل‌های بازنشانی پویا.

--dyn-symbols, --dyn-syms, --dt: نمایش جدول نمادهای پویا.

--dynamic-table, --dynamic, -d: نمایش جدول پویا.

--cg-profile: نمایش بخش پروفایل گراف فراخوانی (callgraph).

--histogram, -I: نمایش بافت‌نگار فهرست باکت‌ها برای جدول‌های درهم‌سازی نماد پویا.

--elf-linker-options: نمایش بخش گزینه‌های پیونددهنده.

--elf-output-style=<value>: قالب‌بندی اطلاعات ELF بر اساس سبک مشخص‌شده. گزینه‌های معتبر عبارتند از LLVM، GNU و JSON. خروجی LLVM (پیش‌فرض) قالبی بسط‌یافته و ساختاریافته است. خروجی GNU ساختار خروجی معادل دستور readelf در GNU را شبیه‌سازی می‌کند. خروجی JSON خروجی با ساختار JSON است که برای پردازش ماشینی در نظر گرفته شده است.

--section-groups, -g: نمایش گروه‌های بخش‌ها.

--gnu-hash-table: نمایش جدول درهم‌سازی GNU برای نمادهای پویا.

--hash-symbols: نمایش جدول درهم‌سازی بسط‌یافته به‌همراه داده‌های نمادهای پویا.

--hash-table: نمایش جدول درهم‌سازی برای نمادهای پویا.

--memtag: نمایش اطلاعات برچسب‌گذاری حافظه (memory tagging) موجود در باینری. این اطلاعات شامل مدخل‌های پویای مختلف، بخش‌های توصیف‌گر سراسری رمزگشایی‌شده و یادداشت‌های رمزگشایی‌شده ELF ویژه Android است.

--notes, -n: نمایش تمام یادداشت‌ها (notes).

--pretty-print: هنگام استفاده به‌همراه --elf-output-style، خروجی JSON در قالبی خواناتر و مرتب‌تر قالب‌بندی می‌شود.

--program-headers, --segments, -l: نمایش سرآیندهای برنامه.

--section-mapping: نمایش نگاشت بخش به قطعه (segment).

--stack-sizes: نمایش محتویات بخش(های) اندازه پشته، یعنی جفت نام‌های توابع و اندازه فریم پشته آنها. در حال حاضر فقط برای سبک خروجی GNU پیاده‌سازی شده است.

--version-info, -V: نمایش بخش‌های نسخه.
گزینه‌های زیر تنها برای قالب فایل Mach-O پیاده‌سازی شده‌اند.

--macho-data-in-code: نمایش دستور Data in Code.

--macho-dsymtab: نمایش دستور Dsymtab.

--macho-indirect-symbols: نمایش نمادهای غیرمستقیم (indirect symbols).

--macho-linker-options: نمایش گزینه‌های پیونددهنده مختص Mach-O.

--macho-segment: نمایش دستور Segment.

--macho-version-min: نمایش دستور version min.

گزینه‌های مختص PE/COFF (PE/COFF SPECIFIC OPTIONS)

گزینه‌های زیر تنها برای قالب فایل PE/COFF پیاده‌سازی شده‌اند.

--codeview: نمایش اطلاعات اشکال‌زدایی CodeView.

--codeview-ghash: فعال‌سازی هشینگ سراسری جهت حذف موارد تکراری در جریان نوع (type stream) متعلق به CodeView.

--codeview-merged-types: نمایش جریان نوع ادغام‌شده CodeView.

--codeview-subsection-bytes: تخلیه محتوای خام رکوردها و بخش‌های اشکال‌زدایی CodeView.

--coff-basereloc: نمایش بخش .reloc.

--coff-debug-directory: نمایش دایرکتوری اشکال‌زدایی (debug directory).

--coff-tls-directory: نمایش دایرکتوری TLS.

--coff-directives: نمایش بخش .drectve.

--coff-exports: نمایش جدول نمادهای صادرشده (export table).

--coff-imports: نمایش جدول نمادهای واردشده (import table).

--coff-load-config: نمایش ساختار پیکربندی بارگذاری (load config).

--coff-resources: نمایش بخش .rsrc.
گزینه‌های زیر تنها برای قالب فایل XCOFF پیاده‌سازی شده‌اند.

--auxiliary-header: نمایش سرایند کمکی XCOFF.

--exception-section: نمایش مدخل‌های بخش استثنای XCOFF.

--loader-section-header: نمایش سرایند بخش بارگذار XCOFF.

--loader-section-symbols: نمایش جدول نمادهای بخش بارگذار.

--loader-section-relocations: نمایش مدخل‌های بازنشانی بخش بارگذار.

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

دستور llvm-readobj در شرایط عملکرد عادی مقدار 0 را بازمی‌گرداند. در صورت بروز هرگونه خطا، یک کد خروج غیرصفر برگردانده می‌شود.

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

llvm-nm(1) <llvm-nm.html>، llvm-objdump(1) <llvm-objdump.html>، llvm-readelf(1) <llvm-readelf.html>

نویسندگان (AUTHORS)

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

کپی‌رایت و تکثیر (COPYRIGHT)

2003-2026، LLVM Project