.TH "EU-READELF" "1" "مه ۲۰۲۵" "elfutils" "دستورهای کاربری"
.SH "نام (NAME)"
eu-readelf \- نمایش اطلاعات فایلهای باینری در قالب ELF
.SH "خلاصه دستور (SYNOPSIS)"
\fBeu-readelf\fP [ \fB\-a\fP|\fB\-\-all\fP ] [ \fB\-h\fP|\fB\-\-file\-header\fP ] [ \fB\-l\fP|\fB\-\-program\-headers\fP|\fB\-\-segments\fP ] [ \fB\-S\fP|\fB\-\-section\-headers\fP|\fB\-\-sections\fP ] [ \fIگزینهها\fP ] \fIفایل_ELF\fP...
.SH "توضیحات (DESCRIPTION)"
دستور \fBeu-readelf\fR اطلاعات ساختاری، بخشها، هدرها و متغیرهای فایلهای باینری با قالب ELF را نمایش میدهد.
گزینه‌ها تعیین می‌کنند که چه اطلاعات خاصی نمایش داده شود.
.PP
\fIفایل_ELF\fR... فایل‌های شیئی هستند که باید بررسی شوند. پرونده‌های ELF ۳۲\-بیتی و ۶۴\-بیتی و همچنین آرشیوهای حاوی پرونده‌های ELF پشتیبانی می‌شوند.
.PP
این برنامه عملکردی مشابه با \fBobjdump\fR دارد، اما جزئیات بیشتری ارائه می‌دهد و کاملاً مستقل از کتابخانه \s-1BFD\s0 کار می‌کند؛ بنابراین اگر اشکالی در \s-1BFD\s0 وجود داشته باشد، عملکرد \fBeu-readelf\fR تحت تأثیر قرار نخواهد گرفت.
.SH "گزینه‌ها (OPTIONS)"
فرم‌های کوتاه و بلند گزینه‌ها که در اینجا به‌صورت جایگزین نشان داده شده‌اند، معادل یکدیگر هستند. حداقل یک گزینه علاوه بر \fB\-v\fR یا \fB\-H\fR باید مشخص شود.
.SS "انتخاب ورودی ELF (ELF Input Selection)"
.TP
\fB\-\-dwarf\-skeleton\fR \fIپرونده\fR
همراه با \fB\-w\fR برای یافتن واحدهای کامپایل اسکلتی (skeleton Compile Units) در \fIپرونده\fR که با واحدهای کامپایل تفکیک‌شده (Split Compile units) در یک پرونده ورودی \fB.dwo\fR مرتبط هستند، استفاده می‌شود.
.TP
\fB\-\-elf\-section\fR [\fIبخش\fR]
استفاده از \fIبخش\fR نام‌برده (به‌طور پیش‌فرض \fB.gnu_debugdata\fR) به‌عنوان داده ورودی ELF (فشرده‌شده).
.SS "انتخاب خروجی ELF (ELF Output Selection)"
.TP
\fB\-a\fR, \fB\-\-all\fR
معادل مشخص کردن گزینه‌های \fB\-\-file\-header\fR، \fB\-\-program\-headers\fR، \fB\-\-sections\fR، \fB\-\-symbols\fR، \fB\-\-relocs\fR، \fB\-\-dynamic\fR، \fB\-\-notes\fR، \fB\-\-version\-info\fR، \fB\-\-arch\-specific\fR، \fB\-\-section\-groups\fR و \fB\-\-histogram\fR است.
.TP
\fB\-h\fR, \fB\-\-file\-header\fR
اطلاعات موجود در هدر ELF در ابتدای پرونده را نمایش می‌دهد.
.TP
\fB\-l\fR, \fB\-\-program\-headers\fR, \fB\-\-segments\fR
اطلاعات موجود در هدرهای سگمنت (قطعه) پرونده را، در صورت وجود، نمایش می‌دهد.
.TP
\fB\-S\fR, \fB\-\-sections\fR, \fB\-\-section\-headers\fR
اطلاعات موجود در هدرهای بخش‌های پرونده را، در صورت وجود، نمایش می‌دهد.
.TP
\fB\-g\fR, \fB\-\-section\-groups\fR
اطلاعات موجود در گروه‌های بخش پرونده را، در صورت وجود، نمایش می‌دهد.
.TP
\fB\-I\fR, \fB\-\-histogram\fR
هنگام نمایش محتویات جدول‌های نماد، یک هیستوگرام (نمودار فراوانی) از طول باکت‌ها نمایش می‌دهد.
.TP
\fB\-s\fR, \fB\-\-syms\fR, \fB\-\-symbols\fR [\fIنام_بخش\fR]
ورودی‌های بخش جدول نماد پرونده را، در صورت وجود، نمایش می‌دهد. اگر نمادی دارای اطلاعات نسخه باشد، آن اطلاعات نیز نمایش داده می‌شود. رشته نسخه به‌عنوان پسوند نام نماد و پس از یک نویسه @ نشان داده می‌شود؛ مانند \fBfoo@VER_1\fR. اگر نسخه، نسخه پیش‌فرضی باشد که برای ارجاعات بدون نسخه به نماد استفاده می‌شود، با دو نویسه @@ نمایش داده می‌شود؛ مانند \fBfoo@@VER_2\fR.
.TP
\fB\-\-dyn\-syms\fR
تنها جدول نمادهای پویا (dynamic symbol table) را نمایش می‌دهد.
.TP
\fB\-e\fR, \fB\-\-exception\fR
بخش‌های مربوط به مدیریت استثناها (exception handling) را نمایش می‌دهد.
.TP
\fB\-n\fR, \fB\-\-notes\fR [\fIنام_بخش\fR]
محتویات سگمنت‌ها یا بخش‌های یادداشت (\s-1NOTE\s0) را در صورت وجود نمایش می‌دهد.
.TP
\fB\-r\fR, \fB\-\-relocs\fR
محتویات بخش بازآرایی (relocation section) پرونده را در صورت وجود نمایش می‌دهد.
.TP
\fB\-d\fR, \fB\-\-dynamic\fR
محتویات بخش پویا (dynamic section) پرونده را در صورت وجود نمایش می‌دهد.
.TP
\fB\-V\fR, \fB\-\-version\-info\fR
محتویات بخش‌های نسخه (version sections) موجود در پرونده را نمایش می‌دهد.
.TP
\fB\-A\fR, \fB\-\-arch\-specific\fR
اطلاعات وابسته به معماری (architecture-specific) موجود در پرونده را در صورت وجود نمایش می‌دهد.
.SS "انتخاب خروجی‌های اضافی (Additional output selection)"
.TP
\fB\-x\fR \fIنام_یا_شماره\fR, \fB\-\-hex\-dump=\fR\fIنام_یا_شماره\fR
محتویات بخش مشخص‌شده را به‌صورت بایت‌های هگزادسیمال نمایش می‌دهد.
.TP
\fB\-w\fR, \fB\-\-debug\-dump\fR[\fB=\fR\fIنوع\fR]
محتویات بخش‌های اشکال‌زدایی \s-1DWARF\s0 پرونده را در صورت وجود نمایش می‌دهد. بخش‌های اشکال‌زدایی فشرده‌شده پیش از نمایش به‌طور خودکار (و موقت) از حالت فشرده خارج می‌شوند. اگر یک یا چند واژه اختیاری پس از سوییچ بیایند، تنها همان دسته‌ها از داده‌ها تخلیه و نمایش داده می‌شوند:
.RS
.TP
\fB=abbrev\fR
نمایش محتویات بخش \fB.debug_abbrev\fR.
.TP
\fB=addr\fR
نمایش محتویات بخش \fB.debug_addr\fR.
.TP
\fB=frames\fR
نمایش محتویات خام بخش \fB.debug_frame\fR.
.TP
\fB=gdb_index\fR
نمایش محتویات بخش‌های \fB.gdb_index\fR یا \fB.debug_names\fR.
.TP
\fB=info\fR
نمایش محتویات بخش \fB.debug_info\fR.
.TP
\fB=info+\fR
نمایش محتویات بخش \fB.debug_info\fR؛ به‌علاوه هر واحد اسکلتی بلافاصله با واحد کامپایل تفکیک‌شده متناظر (از پرونده \fB.dwo\fR) دنبال خواهد شد. برای نمایش تفاوت میان واحدهای کامپایل عادی و تفکیک‌شده، آفست‌ها و ارجاعات بین { و } به‌جای [ و ] چاپ می‌شوند.
.TP
\fB=decodedline\fR
نمایش محتویات تفسیرشده بخش \fB.debug_line\fR.
.TP
\fB=macro\fR
نمایش محتویات بخش‌های \fB.debug_macro\fR یا \fB.debug_macinfo\fR.
.TP
\fB=loc\fR
نمایش محتویات بخش‌های \fB.debug_loc\fR یا \fB.debug_loclists\fR.
.TP
\fB=pubnames\fR
نمایش محتویات بخش‌های \fB.debug_pubnames\fR یا \fB.debug_gnu_pubnames\fR.
.TP
\fB=aranges\fR
نمایش محتویات بخش \fB.debug_aranges\fR.
.TP
\fB=ranges\fR
نمایش محتویات بخش‌های \fB.debug_ranges\fR یا \fB.debug_rnglists\fR.
.TP
\fB=str\fR
نمایش محتویات بخش‌های \fB.debug_str\fR، \fB.debug_line_str\fR یا \fB.debug_str_offsets\fR.
.PP
\fBنکته:\fR نمایش محتویات بخش‌های \fB.debug_static_funcs\fR، \fB.debug_static_vars\fR و \fBdebug_weaknames\fR در حال حاضر پشتیبانی نمی‌شود.
.RE
.TP
\fB\-p\fR \fIنام_یا_شماره\fR, \fB\-\-string\-dump=\fR\fIنام_یا_شماره\fR
محتویات بخش مشخص‌شده را به‌صورت رشته‌های متنی قابل چاپ نمایش می‌دهد. یک عدد، بخش مورد نظر را با نمایه آن در جدول بخش‌ها مشخص می‌کند؛ هر رشته دیگر تمام بخش‌های با آن نام را در فایل شیء مشخص می‌سازد.
.TP
\fB\-c\fR, \fB\-\-archive\-index\fR
اطلاعات نمایه نمادهای پرونده موجود در بخش هدر آرشیوهای باینری را نمایش می‌دهد. این گزینه عملکردی مشابه با دستور \fBt\fR در \fBar\fR ارائه می‌دهد، با این تفاوت که از کتابخانه \s-1BFD\s0 استفاده نمی‌کند.
.SS "کنترل خروجی (Output control)"
.TP
\fB\-z\fR, \fB\-\-decompress\fR
درخواست می‌کند بخش‌هایی که توسط گزینه‌های \fB\-x\fR یا \fB\-p\fR تخلیه می‌شوند، پیش از نمایش از حالت فشرده خارج شوند. اگر بخش‌ها فشرده نباشند، به همان صورت دست‌نخورده نمایش داده می‌شوند.
.TP
\fB\-v\fR, \fB\-\-version\fR
شماره نسخه \fBeu-readelf\fR را نمایش می‌دهد.
.TP
\fB\-W\fR, \fB\-\-wide\fR
برای سازگاری در نظر گرفته شده و نادیده گرفته می‌شود (خطوط خروجی همیشه عریض هستند).
.TP
\fB\-H\fR, \fB\-\-help\fR
فهرست گزینه‌های خط فرمان پشتیبانی‌شده توسط \fBeu-readelf\fR را نمایش می‌دهد.
.TP
\fB@\fR\fIپرونده\fR
گزینه‌های خط فرمان را از \fIپرونده\fR می‌خواند. گزینه‌های خوانده‌شده جایگزین گزینه اصلی \fB@\fR\fIپرونده\fR می‌شوند. اگر \fIپرونده\fR وجود نداشته باشد یا قابل خواندن نباشد، با گزینه به‌صورت لغوی برخورد می‌شود و حذف نخواهد شد.
.PP
گزینه‌ها در \fIپرونده\fR با نویسه فاصله از یکدیگر جدا می‌شوند. یک نویسه فاصله می‌تواند با احاطه کل گزینه درون گیومه تکی یا دوتایی گنجانده شود. هر نویسه‌ای (از جمله اسلش وارونه) می‌تواند با قرار دادن یک اسلش وارونه پیش از آن درج شود. خود \fIپرونده\fR ممکن است حاوی گزینه‌های \fB@\fR\fIپرونده\fR دیگری باشد؛ هر یک از این گزینه‌ها به‌صورت بازگشتی پردازش می‌شوند.
.SH "همچنین ببینید (SEE ALSO)"
\fIobjdump\fR\|(1)، \fIreadelf\fR\|(1) و مدخل‌های Info برای \fIbinutils\fR.
.SH "حق نشر (COPYRIGHT)"
کپی‌رایت \(co ۱۹۹۱\-۲۰۱۸ بنیاد نرم‌افزار آزاد (Free Software Foundation, Inc.)
.PP
کپی‌رایت \(co ۲۰۱۹ شرکت ردهت (Red Hat Inc.)
.PP
مجوز کپی، توزیع یا تغییر این سند تحت شرایط مجوز مستندات آزاد گنو (\s-1GNU\s0 Free Documentation License)، نسخه ۱.۳ یا هر نسخه بعدی منتشرشده توسط بنیاد نرم‌افزار آزاد صادر شده است؛ بدون بخش‌های تغییرناپذیر، بدون متن‌های روی جلد و بدون متن‌های پشت جلد.