الاسم¶

readelf - يعرض معلومات عن ملفات ELF

موجز¶

readelf [-a|--all]
[-h|--file-header]
[-l|--program-headers|--segments]
[-S|--section-headers|--sections]
[-g|--section-groups]
[-t|--section-details]
[-e|--headers]
[-s|--syms|--symbols]
[--dyn-syms|--lto-syms]
[--sym-base=[0|8|10|16]]
[--demangle=نمط|--no-demangle]
[--quiet]
[--recurse-limit|--no-recurse-limit]
[-U طريقة|--unicode=طريقة]
[-X|--extra-sym-info|--no-extra-sym-info]
[-n|--notes]
[-r|--relocs]
[-u|--unwind]
[-d|--dynamic]
[-V|--version-info]
[-A|--arch-specific]
[-D|--use-dynamic]
[-L|--lint|--enable-checks]
[-x <رقم أو اسم>|--hex-dump=<رقم أو اسم>]
[-p <رقم أو اسم>|--string-dump=<رقم أو اسم>]
[-R <رقم أو اسم>|--relocated-dump=<رقم أو اسم>]
[-j <رقم أو اسم>|--display-section=<رقم أو اسم>]
[-z|--decompress]
[-c|--archive-index]
[-w[lLiaprmfFsoORtUuTgAck]|
--debug-dump[=rawline,=decodedline,=info,=abbrev,=pubnames,=aranges,=macro,=frames,=frames-interp,=str,=str-offsets,=loc,=Ranges,=pubtypes,=trace_info,=trace_abbrev,=trace_aranges,=gdb_index,=addr,=cu_index,=links]]
[-wK|--debug-dump=follow-links]
[-wN|--debug-dump=no-follow-links]
[-wD|--debug-dump=use-debuginfod]
[-wE|--debug-dump=do-not-use-debuginfod]
[-P|--process-links]
[--dwarf-depth=n]
[--dwarf-start=n]
[--ctf=قسم]
[--ctf-parent=قسم]
[--ctf-symbols=قسم]
[--ctf-strings=قسم]
[--sframe=قسم]
[-I|--histogram]
[--got-contents]
[-v|--version]
[-W|--wide]
[-T|--silent-truncation]
[-H|--help]
ملف_elf...

الوصف¶

يعرض readelf معلومات عن ملف كائن أو أكثر بتنسيق ELF. وتتحكم الخيارات في المعلومات المحددة المراد عرضها.

ملف_elf... هي ملفات الكائنات المراد فحصها. ملفات ELF بنظام 32 بت و64 بت مدعومة، وكذلك الأرشيفات التي تحتوي على ملفات ELF.

يؤدي هذا البرنامج وظيفة مشابهة لـ objdump ولكنه يخوض في تفاصيل أكثر ويوجد بشكل مستقل عن مكتبة BFD، لذا إذا كان هناك علة في BFD فلن يتأثر readelf.

الخيارات¶

الأشكال الطويلة والقصيرة للخيارات، الموضحة هنا كبدائل، متكافئة. يجب تقديم خيار واحد على الأقل بجانب -v أو -H.

-a

--all

يكافئ تحديد --file-header، و--program-headers، و--sections، و--symbols، و--relocs، و--dynamic، و--notes، و--got-contents، و--version-info، و--arch-specific، و--unwind، و--section-groups و--histogram.

ملاحظة - هذا الخيار لا يفعل --use-dynamic بحد ذاته، لذا إذا لم يكن هذا الخيار موجودًا في سطر الأوامر فلن تُعرض الرموز الديناميكية وعمليات النقل (relocs) الديناميكية.

-h

--file-header

يعرض المعلومات الموجودة في ترويسة ELF في بداية الملف.

-l

--program-headers

--segments

يُعرض المعلومات الواردة في ترويسات مقاطع الملف، إن وجدت.

--quiet

يكتم تشخيص "لا توجد رموز".

-S

--sections

--section-headers

يُعرض المعلومات الواردة في ترويسات أقسام الملف، إن وجدت.

-g

--section-groups

يُعرض المعلومات الواردة في مجموعات أقسام الملف، إن وجدت.

-t

--section-details

يعرض معلومات القسم التفصيلية. يتضمن الخيار -S.

-s

--symbols

--syms

يعرض المدخلات في قسم جدول الرموز في الملف، إن وجد. إذا كان للرمز معلومات إصدار مرتبطة به، فستُعرض هذه المعلومات أيضاً. تظهر سلسلة الإصدار كلاحقة لاسم الرمز، مسبوقة بحرف @. على سبيل المثال foo@VER_1. إذا كان الإصدار هو الإصدار المبدئي الذي سيُستخدم عند حل المراجع غير المؤرخة للرمز، فسيظهر كلاحقة مسبوقة بحرفي @@. على سبيل المثال foo@@VER_2.

--dyn-syms

يعرض المدخلات في قسم جدول الرموز الديناميكية في الملف، إن وجد. تنسيق المخرجات هو نفسه التنسيق المستخدم في الخيار --syms.

--lto-syms

يعرض محتويات أي جداول رموز LTO في الملف.

--sym-base=[0|8|10|16]

يجبر حقل الحجم في جدول الرموز على استخدام الأساس المعطى. وتُعامل أي خيارات غير معروفة على أنها 0. ويمثل --sym-base=0 السلوك المبدئي والقديم. حيث سيخرج الأحجام كأرقام عشرية للأرقام الأقل من 100000. وللأحجام 100000 وأكبر، سيُستخدم الترميز الست عشري مع بادئة 0x. سيعطي --sym-base=8 أحجام الرموز بالنظام الثماني. وسيعطي --sym-base=10 دائماً أحجام الرموز بالنظام العشري. وسيعطي --sym-base=16 دائماً أحجام الرموز بالنظام الست عشري مع بادئة 0x.

-C

--demangle[=style]

فك ترميز (demangle) أسماء الرموز منخفضة المستوى إلى أسماء بمستوى المستخدم. هذا يجعل أسماء دوال ++C قابلة للقراءة. للمجمعات المختلفة أنماط تشويه (mangling) مختلفة. يمكن استخدام وسيط نمط فك الترميز الاختياري لاختيار نمط فك ترميز مناسب لمجمعك.

--no-demangle

لا تفك ترميز (demangle) أسماء الرموز منخفضة المستوى. هذا هو الوضع المبدئي.

--recurse-limit

--no-recurse-limit

--recursion-limit

--no-recursion-limit

يمكن أو يعطل حداً لمقدار التكرار المنفذ أثناء فك تشويه السلاسل النصية. بما أن تنسيقات تشويه الأسماء تسمح بمستوى غير محدود من التكرار، فمن الممكن إنشاء سلاسل سيؤدي فك تشفيرها إلى استنفاد مساحة المكدس المتاحة على الجهاز المضيف، مما يتسبب في خطأ في الذاكرة. يحاول هذا الحد منع حدوث ذلك عن طريق تقييد التكرار بـ 2048 مستوى من التداخل.

المبدئي هو تفعيل هذا الحد، لكن تعطيله قد يكون ضروريًا من أجل حل (demangle) الأسماء المعقدة حقًا. لاحظ مع ذلك أنه إذا عُطل حد العودية، فإن استنفاد المكدس وارد وأي تقارير عن أخطاء بشأن مثل هذا الحدث ستُرفض.

-U [d|i|l|e|x|h]

--unicode=[default|invalid|locale|escape|hex|highlight]

يتحكم في عرض أحرف غير ASCII في أسماء المعرفات. الوضع المبدئي (--unicode=locale أو --unicode=default) هو معاملتها كأحرف متعددة البايت وعرضها في الإعدادات المحلية الحالية. تعالج جميع الإصدارات الأخرى من هذا الخيار البايتات كقيم مشفرة بتنسيق UTF-8 وتحاول تفسيرها. إذا تعذر تفسيرها أو إذا استُخدم الخيار --unicode=invalid، فتُعرض كتسلسل من بايتات ست عشرية، محاطة بأقواس متعرجة.

سيؤدي استخدام خيار --unicode=escape إلى عرض الأحرف كمتواليات هروب يونيكود (\uxxxx). وسيعرض استخدام --unicode=hex الأحرف كمتواليات بايتات ست عشرية محصورة بين أقواس زاوية.

سيؤدي استخدام --unicode=highlight إلى عرض الأحرف كمتواليات هروب يونيكود ولكنه سيميزها أيضاً باللون الأحمر، بافتراض أن جهاز الإخراج يدعم التلوين. يهدف التلوين إلى جذب الانتباه إلى وجود متواليات يونيكود عندما قد لا تكون متوقعة.

-X

--extra-sym-info

عند عرض تفاصيل الرموز، يُضمّن معلومات إضافية لا تُقدّم عادةً. في الوقت الحالي، يضيف هذا فقط اسم القسم المشار إليه بواسطة حقل فهرس الرمز، في حال وجد. قد تُعرض مزيد من المعلومات في المستقبل عند تفعيل هذا الخيار.

يؤدي تفعيل هذا الخيار فعلياً إلى تفعيل الخيار --wide أيضاً، على الأقل عند عرض معلومات الرمز.

--no-extra-sym-info

يُعطّل مفعول الخيار --extra-sym-info. وهذا هو الوضع المبدئي.

-e

--headers

يُعرض كافة الترويسات في الملف. يكافئ -h -l -S.

-n

--notes

يُعرض محتويات مقاطع و/أو أقسام NOTE (الملاحظة)، إن وجدت.

-r

--relocs

يُعرض محتويات قسم إعادة التوطين الخاص بالملف، إن وجد.

-u

--unwind

يُعرض محتويات قسم unwind الخاص بالملف، إن وجد. تدعم حالياً أقسام unwind لملفات IA64 ELF فقط، بالإضافة إلى جداول unwind الخاصة بـ ARM (".ARM.exidx" / ".ARM.extab"). إذا لم يُنفّذ الدعم بعد لهيكلية حاسوبك، يمكنك تجربة تفريغ محتويات قسم .eh_frames باستخدام خيارَي --debug-dump=frames أو --debug-dump=frames-interp.

-d

--dynamic

يُعرض محتويات القسم الديناميكي للملف، إن وجد.

-V

--version-info

يُعرض محتويات أقسام الإصدار في الملف، إن وجدت.

-A

--arch-specific

يُعرض المعلومات الخاصة بالهيكلية في الملف، إن وجدت.

-D

--use-dynamic

عند عرض الرموز، يجعل هذا الخيار readelf يستخدم جداول تلبيد الرموز في القسم الديناميكي للملف، بدلاً من أقسام جدول الرموز.

عند عرض عمليات إعادة التوطين، يجعل هذا الخيار readelf يعرض عمليات إعادة التوطين الديناميكية بدلاً من الساكنة.

-L

--lint

--enable-checks

يُعرض رسائل تحذير حول المشاكل المحتملة في الملف (أو الملفات) التي تُفحص. إذا استُخدم بمفرده، فسيُفحص كامل محتويات الملف (أو الملفات). أما إذا استُخدم مع أحد خيارات التفريغ، فستُنتج رسائل التحذير فقط للأجزاء التي تُعرض.

-x <الرقم أو الاسم>

--hex-dump=<الرقم أو الاسم>

يُعرض محتويات القسم المحدد كبايتات ست عشرية. يحدد الرقم قسماً معيناً حسب الفهرس في جدول الأقسام؛ بينما تحدد أي سلسلة نصية أخرى جميع الأقسام التي تحمل ذلك الاسم في ملف الكائن. يمكن تكرار هذا الخيار عدة مرات في سطر الأوامر لطلب تفريغات ست عشرية متعددة.

-R <الرقم أو الاسم>

--relocated-dump=<الرقم أو الاسم>

يُعرض محتويات القسم المحدد كبايتات ست عشرية. يحدد الرقم قسماً معيناً حسب الفهرس في جدول الأقسام؛ بينما تحدد أي سلسلة نصية أخرى جميع الأقسام التي تحمل ذلك الاسم في ملف الكائن. ستُعاد توطين محتويات القسم قبل عرضها. يمكن تكرار هذا الخيار عدة مرات في سطر الأوامر لطلب تفريغات معاد توطينها متعددة.

-p <الرقم أو الاسم>

--string-dump=<الرقم أو الاسم>

يُعرض محتويات القسم المحدد كسلاسل نصية قابلة للطباعة. يحدد الرقم قسماً معيناً حسب الفهرس في جدول الأقسام؛ بينما تحدد أي سلسلة نصية أخرى جميع الأقسام التي تحمل ذلك الاسم في ملف الكائن. يمكن تكرار هذا الخيار عدة مرات في سطر الأوامر لطلب تفريغات نصية متعددة.

-j <الرقم أو الاسم>

--display-section

يُعرض محتويات القسم المحدد وفقاً لنوع ترويسة القسم الخاص به. الأقسام التي تحتوي على عمليات إعادة توطين ستُعرض كما لو استُخدم الخيار --relocations، والأقسام التي تحتوي على رموز ستُعرض كما لو استُخدم الخيار --syms، وهكذا.

يحدد الرقم قسماً معيناً حسب الفهرس في جدول الأقسام؛ بينما تحدد أي سلسلة نصية أخرى جميع الأقسام التي تحمل ذلك الاسم في ملف (أو ملفات) المدخلات.

يمكن تكرار هذا الخيار عدة مرات في سطر الأوامر لطلب تفريغات أقسام متعددة.

-z

--decompress

يطلب فك ضغط القسم (أو الأقسام) التي تُفرغ بواسطة خيارات x أو R أو p قبل عرضها. إذا لم تكن الأقسام مضغوطة، فستُعرض كما هي.

-c

--archive-index

يُعرض معلومات فهرس رموز الملف الموجودة في جزء الترويسة من الأرشيفات الثنائية. يؤدي نفس وظيفة الأمر t للأداة ar، ولكن دون استخدام مكتبة BFD.

-w[lLiaprmfFsOoRtUuTgAckK]

--debug-dump[=rawline,=decodedline,=info,=abbrev,=pubnames,=aranges,=macro,=frames,=frames-interp,=str,=str-offsets,=loc,=Ranges,=pubtypes,=trace_info,=trace_abbrev,=trace_aranges,=gdb_index,=addr,=cu_index,=links,=follow-links]

يعرض محتويات أقسام تنقيح DWARF في الملف، إن وجدت. يتم فك ضغط أقسام التنقيح المضغوطة آلياً (مؤقتاً) قبل عرضها. إذا تبع المفتاح حرف واحد أو أكثر من الحروف أو الكلمات الاختيارية، فسيتم تفريغ تلك الأنواع من البيانات فقط. تشير الحروف والكلمات إلى المعلومات التالية:

--dwarf-depth=n

يُقيد تفريغ قسم ".debug_info" إلى n من الأبناء. هذا مفيد فقط مع --debug-dump=info. المبدئي هو طباعة كل DIEs؛ القيمة الخاصة 0 لـ n سيكون لها نفس التأثير.

باستخدام قيمة غير صفرية لـ n، لن تُطبع مدخلات DIE عند المستوى n أو أعمق منه. النطاق لـ n يبدأ من الصفر.

--dwarf-start=n

اطبع فقط DIEs التي تبدأ بالـ DIE المرقمة n. هذا مفيد فقط مع --debug-dump=info.

إذا جرى تحديده، فسيقوم هذا الخيار بمنع طباعة أي معلومات رأس وجميع DIEs قبل DIE المرقم بـ n. سيتم طباعة الأشقاء والأطفال لـ DIE المحدد فقط.

يمكن استخدام هذا بالاقتران مع --dwarf-depth.

-P

--process-links

يُعرض محتويات الأقسام غير المتعلقة بالتنقيح الموجودة في ملفات معلومات التنقيح (debuginfo) المنفصلة والمرتبطة بالملف الرئيس. يتضمن هذا الخيار آلياً الخيار -wK، وستُعرض فقط الأقسام المطلوبة عبر خيارات سطر الأوامر الأخرى.

--ctf[=قسم]

اعرض محتويات قسم CTF المحدد. تحتوي أقسام CTF نفسها على العديد من الأقسام الفرعية، والتي يتم عرضها جميعاً بالترتيب.

مبدئيًا، اعرض اسم القسم المسمى .ctf، وهو الاسم الصادر عن ld.

--ctf-parent=عضو

إذا احتوى قسم CTF على أنواع معرفة بشكل غامض، فسيتكون من أرشيف للعديد من قواميس CTF، ترث جميعها من قاموس واحد يحتوي على أنواع غير غامضة. يسمى هذا العضو افتراضيًا .ctf، مثل القسم الذي يحتويه، ولكن من الممكن تغيير هذا الاسم باستخدام دالة "ctf_link_set_memb_name_changer" في وقت الربط. عند النظر إلى أرشيفات CTF التي تم إنشاؤها بواسطة رابط يستخدم مغير الأسماء لإعادة تسمية عضو الأرشيف الأصل، يمكن استخدام --ctf-parent لتحديد الاسم المستخدم للأصل.

--ctf-parent-section=قسم

يتيح لك هذا الخيار اختيار قسم مختلف تمامًا لقاموس CTF الأب الذي يحتوي على أنواع غير غامضة عن القواميس الأبناء التي تحتوي على البقية الغامضة. لا يُصدر الموصل كائنات ELF مهيكلة بهذا الشكل، ولكن قد تفعل بعض الموصلات التابعة لجهات خارجية ذلك. ومن المناسب أيضًا فحص ملفات CTF المكتوبة كملفات خام متعددة لتأليفها باستخدام objcopy، والذي يمكنه وضعها في أقسام ELF مختلفة ولكن ليس في أعضاء مختلفة من قاموس CTF واحد.

--ctf-symbols=section

--ctf-strings=section

يحدد اسم قسم آخر يمكن لملف CTF أن يرث منه السلاسل والرموز. بشكل مبدئي، يُستخدم ".symtab" وجدول السلاسل المرتبط به.

إذا حُدّد أي من --ctf-symbols أو --ctf-strings، فيجب تحديد الآخر أيضاً.

--got-contents

يُعرض محتويات أقسام جدول الإزاحة العام (GOT) للملف، إن وجدت. بالنسبة لـ MIPS، يشبه هذا الخيار --arch-specific، ولكنه يعرض فقط المحتويات المتعلقة بـ GOT ويُتجاهل عند استخدام --arch-specific.

-I

--histogram

يُعرض مدرجاً تكرارياً (histogram) لأطوال قوائم الجراف (bucket list) عند عرض محتويات جداول الرموز.

-v

--version

يُعرض رقم إصدار readelf.

-W

--wide

لا تقسم أسطر المخرجات لتناسب 80 عموداً. يقوم readelf مبدئياً بقسمة أسطر ترويسة القسم وقائمة المقاطع لملفات ELF ذات 64 بت، بحيث تناسب 80 عموداً. يجعل هذا الخيار readelf يطبع كل ترويسة قسم أو كل مقطع في سطر واحد، وهو أمر أكثر قابلية للقراءة على الشاشات التي يزيد عرضها عن 80 عموداً.

-T

--silent-truncation

عادةً عندما يعرض readelf اسم رمز ويضطر لاقتطاعه ليناسب عرض 80 عموداً، فإنه يضيف لاحقة "[...]" إلى الاسم. يُعطل خيار سطر الأوامر هذا هذا السلوك، مما يسمح بعرض 5 أحرف إضافية من الاسم واستعادة سلوك readelf القديم (قبل الإصدار 2.35).

-H

--help

يُعرض خيارات سطر الأوامر التي يفهمها readelf.

@الملف

اقرأ خيارات سطر الأوامر من file. تُدرج الخيارات المقروءة مكان خيار @file الأصلي. إذا كان file غير موجود، أو لا يمكن قراءته، فسيُعامل الخيار حرفيًا ولن يُزال.

تُفصل الخيارات في file بمسافات فارغة. يمكن تضمين حرف مسافة فارغة في خيار ما عن طريق إحاطة الخيار بالكامل إما بعلامات اقتباس مفردة أو مزدوجة. يمكن تضمين أي حرف (بما في ذلك الشرطة المائلة العكسية) عن طريق سبق الحرف المراد تضمينه بشرطة مائلة عكسية. يمكن لـ file نفسه أن يحتوي على خيارات @file إضافية؛ وتُعالج أي خيارات من هذا القبيل بشكل متكرر (recursively).

انظر أيضًا¶

objdump(1)، ومدخلات Info لـ binutils.

حقوق النسخ¶

حقوق الطبع والنشر (c) لعام 1991-2026 لمؤسسة البرمجيات الحرة، المحدودة.

يُمنح الإذن بنسخ وتوزيع و/أو تعديل هذا المستند بموجب شروط رخصة جنو للوثائق الحرة (GNU Free Documentation License)، الإصدار 1.3 أو أي إصدار لاحق تنشره مؤسسة البرمجيات الحرة؛ مع عدم وجود أقسام ثابتة، وبدون نصوص غلاف أمامي، وبدون نصوص غلاف خلفي. نُسخة من الرخصة مضمنة في القسم المعنون "GNU Free Documentation License".

ترجمة¶

تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي <zayed.alsaidi@gmail.com>

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: kde-l10n-ar@kde.org.