نام (NAME)

arm-none-eabi-elfedit - به‌روزرسانی هدر پرونده‌های ELF و ویژگی برنامه در پرونده‌های ELF

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

arm-none-eabi-elfedit [--input-mach=machine]
[--input-type=type]
[--input-osabi=osabi]
[--input-abiversion=version]
--output-mach=machine
--output-type=type
--output-osabi=osabi
--output-abiversion=version
--enable-x86-feature=feature
--disable-x86-feature=feature
[-v|--version]
[-h|--help]
elffile...

توضیحات (DESCRIPTION)

دستور arm-none-eabi-elfedit هدر پرونده‌های ELF و ویژگی برنامه (program property) را در پرونده‌های ELF که دارای نوع ماشین و نوع پرونده منطبق هستند، به‌روزرسانی می‌کند. گزینه‌ها چگونگی و فیلدهایی از هدر پرونده‌های ELF و ویژگی برنامه را که باید به‌روزرسانی شوند کنترل می‌کنند.

elffile... پرونده‌های ELF هستند که باید به‌روزرسانی شوند. پرونده‌های ELF ۳۲-بیتی و ۶۴-بیتی و همچنین آرشیوهای حاوی پرونده‌های ELF پشتیبانی می‌شوند.

گزینه‌ها (OPTIONS)

شکل‌های بلند و کوتاه گزینه‌ها که در اینجا به‌عنوان جایگزین نشان داده شده‌اند، معادل یکدیگرند. دست‌کم یکی از گزینه‌های --output-mach، --output-type، --output-osabi، --output-abiversion، --enable-x86-feature و --disable-x86-feature باید مشخص شود.

--input-mach=machine: نوع ماشین ELF ورودی را جهت تطابق روی machine تنظیم می‌کند. اگر --input-mach مشخص نشود، با هر نوع ماشین ELF تطابق داده خواهد شد.
انواع ماشین‌های ELF پشتیبانی‌شده عبارتند از: i386، IAMCU، L1OM، K1OM و x86-64.
--output-mach=machine: نوع ماشین ELF را در هدر پرونده‌های ELF به machine تغییر می‌دهد. انواع ماشین‌های ELF پشتیبانی‌شده همان موارد --input-mach هستند.
--input-type=type: نوع پرونده ELF ورودی را جهت تطابق روی type تنظیم می‌کند. اگر --input-type مشخص نشود، با هر نوع پرونده ELF تطابق داده خواهد شد.
انواع پرونده‌های ELF پشتیبانی‌شده عبارتند از: rel، exec و dyn.
--output-type=type: نوع پرونده ELF را در هدر پرونده‌های ELF به type تغییر می‌دهد. انواع پرونده‌های ELF پشتیبانی‌شده همان موارد --input-type هستند.
--input-osabi=osabi: مقدار OSABI پرونده ELF ورودی را جهت تطابق روی osabi تنظیم می‌کند. اگر --input-osabi مشخص نشود، با هر مقدار OSABI در ELF تطابق داده خواهد شد.
مقادیر OSABI پشتیبانی‌شده در ELF عبارتند از: none، HPUX، NetBSD، GNU، Linux (نام مستعار برای GNU)، Solaris، AIX، Irix، FreeBSD، TRU64، Modesto، OpenBSD، OpenVMS، NSK، AROS و FenixOS.
--output-osabi=osabi: مقدار OSABI را در هدر پرونده‌های ELF به osabi تغییر می‌دهد. مقادیر OSABI پشتیبانی‌شده همان موارد --input-osabi هستند.
--input-abiversion=version: مقدار ABIVERSION پرونده ELF ورودی را جهت تطابق روی version تنظیم می‌کند. version باید مقداری بین ۰ تا ۲۵۵ باشد. اگر --input-abiversion مشخص نشود، با هر مقدار ABIVERSION در ELF تطابق داده خواهد شد.
--output-abiversion=version: مقدار ABIVERSION را در هدر پرونده‌های ELF به version تغییر می‌دهد. version باید مقداری بین ۰ تا ۲۵۵ باشد.
--enable-x86-feature=feature: بیت feature را در ویژگی برنامه (program property) در پرونده‌های ELF از نوع exec یا dyn با نوع ماشین i386 یا x86-64 فعال (تنظیم) می‌کند. ویژگی‌های پشتیبانی‌شده عبارتند از: ibt، shstk، lam_u48 و lam_u57.
--disable-x86-feature=feature: بیت feature را در ویژگی برنامه (program property) در پرونده‌های ELF از نوع exec یا dyn با نوع ماشین i386 یا x86-64 غیرفعال (پاک) می‌کند. ویژگی‌های پشتیبانی‌شده همان موارد --enable-x86-feature هستند.
نکته: گزینه‌های --enable-x86-feature و --disable-x86-feature تنها در میزبان‌هایی با پشتیبانی از mmap در دسترس هستند.
-v
--version: نمایش شماره نسخه arm-none-eabi-elfedit.
-h
--help: نمایش گزینه‌های خط فرمان قابل فهم برای arm-none-eabi-elfedit.
@file: خواندن گزینه‌های خط فرمان از file. گزینه‌های خوانده‌شده در جایگاه گزینه اولیه @file جایگزین می‌شوند. چنانچه file وجود نداشته باشد یا قابل خواندن نباشد، با گزینه به‌صورت لفظی برخورد شده و حذف نمی‌شود.
گزینه‌ها در file با نویسه‌های فاصله خالی (Whitespace) تفکیک می‌شوند. در صورتی که نیاز باشد نویسه فاصله در یک گزینه گنجانده شود، می‌توان کل آن گزینه را درون علامت نقل‌قول تکی یا دوتایی محصور کرد. هر نویسه‌ای (از جمله بک‌اسلش) را می‌توان با افزودن یک بک‌اسلش به عنوان پیشوند به آن وارد نمود. پرونده file ممکن است خود شامل گزینه‌های @file بیشتری باشد؛ هر یک از این گزینه‌ها به‌صورت بازگشتی پردازش خواهند شد.

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

readelf(1) و مدخل‌های Info برای binutils.

کپی‌رایت (COPYRIGHT)

مجوز نسخه‌برداری، توزیع و/یا تغییر این سند تحت شرایط مجوز مستندات آزاد گنو (GNU Free Documentation License) نسخه ۱.۳ یا هر نسخه جدیدتر منتشرشده توسط بنیاد نرم‌افزارهای آزاد اعطا می‌شود؛ بدون بخش‌های تغییرناپذیر، بدون متون روی جلد و بدون متون پشت جلد. نسخه‌ای از این مجوز در بخشی با عنوان "GNU Free Documentation License" درج شده است.