نام (NAME)

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

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

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)

دستور 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 تغییر می‌دهد. انواع پرونده‌های پشتیبانی‌شده همان موارد ذکرشده برای --input-type هستند.
--input-osabi=osabi: مقدار OSABI پروندهٔ ELF ورودی برای مطابقت را روی osabi تنظیم می‌کند. اگر --input-osabi مشخص نشده باشد، با هر مقدار ELF OSABI مطابقت داده خواهد شد.
مقادیر 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 باید عددی بین 0 و 255 باشد. اگر --input-abiversion مشخص نشده باشد، با هر مقدار ELF ABIVERSION مطابقت داده خواهد شد.
--output-abiversion=version: مقدار ABIVERSION را در سرایند ELF به version تغییر می‌دهد. version باید عددی بین 0 و 255 باشد.
--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: نمایش شماره نسخهٔ elfedit.
-h
--help: نمایش گزینه‌های خط فرمان که توسط elfedit پشتیبانی می‌شوند.
@file: خواندن گزینه‌های خط فرمان از file. گزینه‌های خوانده‌شده به‌جای گزینهٔ اصلی @file جایگزین می‌شوند. اگر file وجود نداشته باشد یا قابل خواندن نباشد، با گزینه به‌صورت تحت‌اللفظی رفتار شده و حذف نخواهد شد.
گزینه‌ها در file با فاصله (whitespace) از هم جدا می‌شوند. یک نویسهٔ فاصله می‌تواند با قرار دادن کل گزینه در میان گیومهٔ تکی یا دوتایی در گزینه گنجانده شود. هر نویسه‌ای (از جمله بک‌اسلش) را می‌توان با افزودن یک پیشوند بک‌اسلش به آن درج کرد. پروندهٔ file ممکن است خود حاوی گزینه‌های @file بیشتری باشد؛ هرکدام از این گزینه‌ها به‌صورت بازگشتی پردازش خواهند شد.

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

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

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

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