| LLVM-OBJDUMP(1) | LLVM | LLVM-OBJDUMP(1) |
نام (NAME)
llvm-objdump - ابزار بررسی و تخلیه محتوای فایل‌های شیء در LLVM
خلاصه دستور (SYNOPSIS)
llvm-objdump [commands] [options] [filenames...]
توضیحات (DESCRIPTION)
ابزار llvm-objdump محتوای فایل‌های شیء و ایمیج‌های نهایی پیوند‌یافتهٔ مشخص‌شده در خط فرمان را چاپ می‌کند. اگر نام فایلی مشخص نشود، llvm-objdump تلاش خواهد کرد از a.out بخواند. اگر از - به عنوان نام فایل استفاده شود، llvm-objdump فایلی را روی جریان ورودی استاندارد خود پردازش خواهد کرد.
دستورها (COMMANDS)
حداقل یکی از دستورهای زیر الزامی است، و برخی از دستورها را می‌توان با دستورهای دیگر ترکیب کرد:
- -a, --archive-headers
- نمایش اطلاعات موجود در سرآیندهای آرشیو.
- -d, --disassemble
- دیزاسمبل کردن تمام بخش‌های اجراییِ موجود در فایل‌های ورودی. در برخی از معماری‌ها (AArch64، PowerPC، x86)، همه دستورالعمل‌های شناخته‌شده به‌طور پیش‌فرض دیزاسمبل می‌شوند. در سایر معماری‌ها، برای فعال‌سازی برخی از مجموعه‌های دستورالعمل به --mcpu یا --mattr نیاز است. دستورالعمل‌های غیرفعال به‌صورت <unknown> نمایش داده می‌شوند.
- -D, --disassemble-all
- دیزاسمبل کردن تمام بخش‌های یافت‌شده در فایل‌های ورودی.
- --disassemble-symbols=<symbol1[,symbol2,...]>
- تنها نمادهای مشخص‌شده را دیزاسمبل می‌کند. در صورت مشخص شدن --demangle، نام‌های نمادِ ساده‌سازی‌شده (demangled) را می‌پذیرد؛ در غیر این صورت نام‌های نمادِ اصلی (mangled) را دریافت می‌کند. به‌طور ضمنی شامل --disassemble است.
- --dwarf=<value>
- تخلیه
بخش‌های
اشکال‌زدایی
DWARF مشخص‌شده.
مقادیر
پشتیبانی‌شده
عبارتند از:
frames - .debug_frame
- -f, --file-headers
- نمایش محتوای سرآیند کلی فایل.
- --fault-map-section
- نمایش محتوای بخش fault map.
- -h, --headers, --section-headers
- نمایش خلاصه‌ای از سرآیندهای مربوط به هر بخش.
- --help
- نمایش اطلاعات نحوه استفاده و خروج. با دستورهای دیگر ترکیب نمی‌شود.
- -p, --private-headers
- نمایش سرآیندهای اختصاصی قالب فایل.
- -r, --reloc
- نمایش مدخل‌های بازنشانی (relocation) در فایل.
- -R, --dynamic-reloc
- نمایش مدخل‌های بازنشانی پویا (dynamic relocation) در فایل.
- --raw-clang-ast
- تخلیه محتوای دودویی خامِ بخش clang AST.
- -s, --full-contents
- نمایش محتویات هر بخش.
- -t, --syms
- نمایش جدول نمادها.
- -T, --dynamic-syms
- نمایش محتوای جدول نمادهای پویا.
- -u, --unwind-info
- نمایش
اطلاعات
بازگشایی (unwind
info) ورودی(ها).
این عملیات در حال حاضر فقط برای فایل‌های شیء COFF و Mach-O پشتیبانی می‌شود.
- -v, --version
- نمایش نسخه فایل اجرایی llvm-objdump. با دستورهای دیگر ترکیب نمی‌شود.
- -x, --all-headers
- نمایش تمام
اطلاعات
موجود
سرآیندها.
معادل با
مشخص کردن
گزینه‌های
--archive-headers،
--file-headers،
--private-headers، --reloc،
--section-headers و --syms.
llvm-objdump از گزینه‌های زیر پشتیبانی می‌کند:
- --adjust-vma=<offset>
- نشانی نمایش‌یافته در دیس‌اسمبل یا چاپ سرآیند بخش را به میزان افست مشخص‌شده افزایش می‌دهد.
- --arch-name=<string>
- معماری هدف را هنگام دیس‌اسمبل کردن مشخص می‌کند. برای دیدن فهرستی از هدف‌های در دسترس از --version استفاده کنید.
- --build-id=<string>
- جستجوی شیء (object) با استفاده از شناسه ساخت (build ID) داده‌شده، که به صورت یک رشته هگزادسیمال مشخص می‌شود. شیء یافت‌شده طوری مدیریت می‌شود که گویی یک نام فایل ورودی بوده است.
- -C, --demangle
- رمزگشایی (demangle) نام نمادها در خروجی.
- --debug-file-directory <path>
- مسیری به یک دایرکتوری دارای زیردایرکتوری .build-id جهت جستجوی اطلاعات اشکال‌زدایی برای باینری‌های پیراسته‌شده (stripped) ارائه می‌دهد. نمونه‌های چندگانه از این آرگومان به ترتیبی که داده شده‌اند جستجو می‌شوند.
- --debug-indent=<width>
- فاصله‌ی تورفتگی نمایش متغیرهای سطح کد منبع یا توابع درون‌خطی (inlined)، نسبت به ابتدای دیس‌اسمبل. مقدار پیش‌فرض ۵۲ نویسه است.
- --debug-inlined-funcs[=<format>]
- مکان توابع درون‌خطی (inlined) را در کنار دیس‌اسمبل چاپ می‌کند. format می‌تواند ascii، limits-only یا unicode باشد، که در صورت حذف به صورت پیش‌فرض unicode است.
- --debug-vars[=<format>]
- مکان متغیرهای سطح کد منبع (در ثبات‌ها یا حافظه) را در کنار دیس‌اسمبل چاپ می‌کند. format می‌تواند ascii یا unicode باشد، که در صورت حذف به صورت پیش‌فرض unicode است.
- --debuginfod, --no-debuginfod
- تلاش یا عدم تلاش برای جستجو در debuginfod جهت باینری‌های اشکال‌زدایی. مگر اینکه صراحتاً مشخص شود، debuginfod تنها در صورتی فعال است که libcurl در حین کامپایل گنجانده شده باشد (LLVM_ENABLE_CURL) و دست‌کم یک URL سرور توسط متغیر محیطی DEBUGINFOD_URLS ارائه شده باشد.
- -j, --section=<section1[,section2,...]>
- اجرای دستورها تنها روی بخش‌های مشخص‌شده. برای Mach-O از segment,section برای مشخص کردن نام بخش استفاده کنید.
- -l, --line-numbers
- هنگام دیس‌اسمبل کردن، شماره خطوط کد منبع را نمایش می‌دهد. مستلزم گزینه --disassemble است.
- -M, --disassembler-options=<opt1[,opt2,...]>
- ارسال گزینه‌های دیس‌اسمبلر مختص به معماری هدف. گزینه‌های موجود:
- reg-names-std: فقط ARM (پیش‌فرض). خروجی را مطابق مستندات مجموعه دستورالعمل ARM چاپ می‌کند، به طوری که r13/r14/r15 با sp/lr/pc جایگزین می‌شوند.
- reg-names-raw: فقط ARM. استفاده از r به همراه شماره ثبات.
- no-aliases: فقط AArch64 و RISC-V. چاپ نماد یادآور خام دستورالعمل (raw mnemonic) به جای نماد شبه‌دستور.
- numeric: فقط RISC-V. چاپ نام‌های خام ثبات به جای نماد یادآور ABI (مثلاً چاپ x1 به جای ra).
- att: فقط x86 (پیش‌فرض). چاپ بر اساس نحو (syntax) مربوط به AT&T.
- intel: فقط x86. چاپ بر اساس نحو (syntax) مربوط به intel.
- --disassembler-color=<mode>
- فعال یا غیرفعال کردن خروجی رنگی دیس‌اسمبلر.
- off: غیرفعال کردن خروجی رنگی دیس‌اسمبلر.
- on: فعال کردن خروجی رنگی دیس‌اسمبلر.
- terminal: فعال کردن خروجی رنگی دیس‌اسمبلر در صورتی که ترمینال از آن پشتیبانی کند (پیش‌فرض).
- --mcpu=<cpu-name>
- یک نوع CPU خاص را برای دیس‌اسمبل کردن هدف قرار می‌دهد. برای نمایش پردازنده‌های در دسترس --mcpu=help را مشخص کنید.
- --mattr=<a1,+a2,-a3,...>
- فعال/غیرفعال کردن ویژگی‌های مختص هدف. برای نمایش ویژگی‌های در دسترس --mattr=help را مشخص کنید.
- -mllvm <arg>
- مشخص کردن یک آرگومان جهت ارسال به کتابخانه CommandLine متعلق به LLVM.
- --no-leading-addr, --no-addresses
- هنگام دیس‌اسمبل کردن، نشانی‌های ابتدایی دستورالعمل‌ها یا بازنشانی‌های درون‌خطی (inline relocations) چاپ نشود.
- --no-print-imm-hex
- عدم استفاده از قالب هگزادسیمال برای مقادیر فوری (immediate) در خروجی دیس‌اسمبل.
- --no-show-raw-insn
- هنگام دیس‌اسمبل کردن، بایت‌های خام هر دستورالعمل چاپ نشود.
- --offloading
- نمایش محتوای بخش‌های offloading در LLVM و دسته‌های HIP offload.
- --prefix=<prefix>
- هنگام دیس‌اسمبل کردن با گزینه --source، پیشوند prefix را به ابتدای مسیرهای مطلق اضافه می‌کند.
- --prefix-strip=<level>
- هنگام دیس‌اسمبل کردن با گزینه --source، به تعداد level دایرکتوری ابتدایی را از مسیرهای مطلق حذف می‌کند. این گزینه بدون --prefix هیچ تأثیری ندارد.
- --print-imm-hex
- استفاده از قالب هگزادسیمال هنگام چاپ مقادیر فوری (immediate) در خروجی دیس‌اسمبل (پیش‌فرض).
- -S, --source
- هنگام دیس‌اسمبل کردن، کد منبع را به صورت درهم‌آمیخته با دیس‌اسمبل نمایش می‌دهد. مستلزم گزینه --disassemble است.
- --show-all-symbols
- نمایش همه نمادها حین دیس‌اسمبل، حتی اگر چند نماد در یک مکان یکسان تعریف شده باشند.
- --show-lma
- نمایش ستون LMA هنگام استخراج سرآیندهای بخش ELF. در حالت پیش‌فرض خاموش است مگر آنکه بخشی مقادیر متفاوتی برای VMA و LMA داشته باشد.
هنگام چاپ بازنشانی‌ها، فقط بازنشانی‌هایی که آفست وصله‌کاری آن‌ها حداقل برابر با address باشد چاپ می‌شوند.
هنگام چاپ نمادها، فقط نمادهایی با مقداری حداقل برابر با address چاپ می‌شوند.
- --stop-address=<address>
- هنگام
دیزاسمبل،
دیزاسمبل
فقط تا آدرس
مشخص‌شده
(بدون در بر
گرفتن خود
آن) انجام
می‌شود.
هنگام چاپ بازنشانی‌ها، فقط بازنشانی‌هایی با آفست وصله‌کاری تا سقف address چاپ می‌شوند.
هنگام چاپ نمادها، فقط نمادهایی با مقداری تا سقف address چاپ می‌شوند.
- --symbolize-operands
- هنگام
دیزاسمبل،
عملوند
مقصد
انشعاب را
نمادگذاری
می‌کند تا
به جای یک
آدرس
واقعی، یک
برچسب چاپ
شود.
هنگام چاپ یک مرجع نماد سراسری وابسته به PC، آن را به عنوان یک آفست از نماد پیشرو چاپ می‌کند.
هنگامی که یک بخش bb-address-map موجود باشد (یعنی فایل شیء با -fbasic-block-address-map ساخته شده باشد)، برچسب‌ها در عوض از آن بخش بازیابی می‌شوند. اگر یک pgo-analysis-map در کنار bb-address-map موجود باشد، هر تحلیل موجود پس از برچسب بلوک مربوطه چاپ می‌شود. به‌طور پیش‌فرض، هر تحلیلی با نمایش ویژه (مانند BlockFrequency، BranchProbability و غیره) به صورت مقادیر هگزادسیمال خام چاپ می‌شود.
تنها برای AArch64، BPF، PowerPC و X86 پشتیبانی می‌شود.
- مثال:
- یک دستور انشعاب نمادگذاری‌نشده با یک مقصد محلی و دسترسی به حافظه وابسته به PC مانند
cmp eax, dword ptr [rip + 4112] jge 0x20117e <_start+0x25>
ممکن است به این شکل تبدیل شود:
<L0>: cmp eax, dword ptr <g> jge <L0>
- --pretty-pgo-analysis-map
- هنگام
استفاده از
--symbolize-operands به
همراه bb-address-map و
pgo-analysis-map،
تحلیل‌ها
با استفاده
از همان
قالبی که
گذرهای
تحلیلی
آن‌ها
نمایش
می‌دهند
چاپ
می‌شوند.
نمونه‌ای
از قالب
خوانا (pretty format)،
چاپ فرکانس
بلوک‌ها
نسبت به
بلوک
ورودی،
مشابه BFI است.
فقط زمانی کار می‌کند که --symbolize-operands فعال باشد.
- --triple=<string>
- سه‌گانه هدف (Target triple) برای انجام دیزاسمبل؛ برای مشاهده اهداف موجود --version را ببینید.
- -w, --wide
- جهت سازگاری با GNU objdump نادیده گرفته می‌شود.
- --x86-asm-syntax=<style>
- منسوخ شده است. هنگامی که همراه با --disassemble استفاده شود، سبک کدی که باید از پسانه X86 تولید شود را انتخاب می‌کند. مقادیر پشتیبانی‌شده عبارتند از:
سبک پیش‌فرض دیزاسمبل att است.
- -z, --disassemble-zeroes
- هنگام دیزاسمبل، بلوک‌های صفر رد نمی‌شوند.
- @<FILE>
- گزینه‌ها و دستورهای خط فرمان را از فایل پاسخ <FILE> می‌خواند.
- --arch=<architecture>
- معماری مد نظر برای دیس‌اسمبل را مشخص می‌کند. برای دیدن معماری‌های موجود --version را ببینید.
- --archive-member-offsets
- آفست هر عضو آرشیو را برای آرشیوهای Mach-O چاپ می‌کند (نیازمند --archive-headers است).
- --bind
- اطلاعات بایندینگ (binding) را نمایش می‌دهد.
- --data-in-code
- جدول داده در کد (data in code) را نمایش می‌دهد.
- --dis-symname=<name>
- تنها دستورالعمل‌های نماد مشخص‌شده را دیس‌اسمبل می‌کند.
- --chained-fixups
- اطلاعات اصلاحات زنجیره‌ای (chained fixups) را چاپ می‌کند.
- --dyld-info
- اطلاعات بایند و تغییر مبنا (rebase) را که توسط dyld برای حل ارجاعات خارجی در یک باینری نهایی پیوندخورده به کار می‌رود، چاپ می‌کند.
- --dylibs-used
- کتابخانه‌های اشتراکی استفاده‌شده برای فایل‌های پیوندخورده را نمایش می‌دهد.
- --dsym=<string>
- برای اطلاعات اشکال‌زدایی از فایل .dSYM استفاده می‌کند.
- --dylib-id
- شناسهٔ کتابخانهٔ اشتراکی را برای فایل‌های dylib نمایش می‌دهد.
- --exports-trie
- نمادهای صادرشده را نمایش می‌دهد.
- --function-starts [=<addrs|names|both>]
- جدول شروع توابع را برای شیءهای Mach-O چاپ می‌کند. یا addrs (پیش‌فرض) برای چاپ صرفاً نشانی‌های توابع، names برای چاپ صرفاً نام‌های توابع (در صورت وجود)، یا both برای چاپ نام‌ها در کنار نشانی‌ها.
- -g
- در صورت وجود، اطلاعات شماره خط را از اطلاعات اشکال‌زدایی چاپ می‌کند.
- --full-leading-addr
- هنگام دیس‌اسمبل کردن، نشانی ابتدایی کامل را چاپ می‌کند.
- --indirect-symbols
- جدول نمادهای غیرمستقیم را نمایش می‌دهد.
- --info-plist
- بخش info plist را به صورت رشته نمایش می‌دهد.
- --lazy-bind
- اطلاعات بایندینگ با تاخیر (lazy binding) را نمایش می‌دهد.
- --link-opt-hints
- نکات بهینه‌سازی پیونددهنده (linker) را نمایش می‌دهد.
- -m, --macho
- از تجزیه‌کنندهٔ فایل شیء مخصوص Mach-O استفاده می‌کند. دستورها و سایر گزینه‌ها ممکن است هنگام استفاده به همراه --macho رفتار متفاوتی داشته باشند.
- --no-leading-headers
- هیچ سرآیند ابتدایی را چاپ نمی‌کند.
- --no-symbolic-operands
- هنگام دیس‌اسمبل کردن، عملوندهای نمادین را چاپ نمی‌کند.
- --non-verbose
- اطلاعات شیءهای Mach-O را به شکل غیرمفصل یا عددی نمایش می‌دهد.
- --objc-meta-data
- فرادهاده‌های زمان اجرای Objective-C را نمایش می‌دهد.
- --private-header
- تنها اولین سرآیند فایلِ ویژهٔ قالب را نمایش می‌دهد.
- --rebase
- اطلاعات تغییر مبنا (rebasing) را نمایش می‌دهد.
- --rpaths
- مسیرهای جستجوی زمان اجرا را برای باینری نمایش می‌دهد.
- --universal-headers
- سرآیندهای جامع (universal headers) را نمایش می‌دهد.
- --weak-bind
- اطلاعات بایندینگ ضعیف (weak binding) را نمایش می‌دهد.
- --symbol-description
- افزودن توضیحات نماد به خروجی دیس‌اسمبل.
- --traceback-table
- رمزگشایی جدول traceback در خروجی دیس‌اسمبل. مستلزم --disassemble است.
گزارش باگ‌ها (BUGS)
برای گزارش باگ‌ها، لطفاً به <https://github.com/llvm/llvm-project/labels/tools:llvm-objdump> مراجعه کنید.
همچنین ببینید (SEE ALSO)
llvm-nm(1) <llvm-nm.html>, llvm-otool(1) <llvm-otool.html>, llvm-readelf(1) <llvm-readelf.html>, llvm-readobj(1) <llvm-readobj.html>
نویسندگان (AUTHORS)
نگهداری‌شده توسط تیم LLVM (https://llvm.org).
کپی‌رایت و تکثیر (COPYRIGHT)
2003-2026, LLVM Project
| 2026-07-15 | 22 |