نام (NAME)

elftoc - تبدیل یک فایل ELF به ساختار (struct) در زبان C

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

elftoc [OPTIONS] FILE

توضیحات (DESCRIPTION)

دستور elftoc یک فایل ELF را به عنوان ورودی دریافت کرده و محتوای آن را به یک فایل منبع C تبدیل می‌کند که ساختاری با مقداردهی اولیه منطبق با تصویر حافظه فایل ELF را توصیف می‌کند. در صورت امکان، مقادیر صریح با نمادهای پیش‌پردازنده و محاسبات مبتنی بر sizeof جایگزین می‌شوند.

گزینه‌ها (OPTIONS)

-e, --force-end: اجبار به گنجاندن فیلد پایانی _end در ساختار C. به صورت پیش‌فرض، فیلد _end فقط زمانی گنجانده می‌شود که لایه‌بندی و فاصله‌گذاری (padding) باعث شود ساختار بزرگتر از فایل اصلی ELF گردد. با این گزینه، ساختاری بدون فاصله‌گذاری اضافی، فیلد _end را به عنوان آرایه‌ای با طول صفر تعریف می‌کند.
-E, --exclude-end: عدم گنجاندن فیلد پایانی _end، حتی اگر فاصله‌گذاری در انتهای ساختار C وجود داشته باشد.
-w, --width=N: تنظیم حداکثر پهنای خط در خروجی روی N. حداکثر پهنای پیش‌فرض خط ۸۰ است.
-i, --indent=N: تنظیم تعداد فاصله‌ها برای تورفتگی روی N. مقدار تورفتگی پیش‌فرض ۲ است.
-s, --structname=NAME: تنظیم نام ساختار C در کد منبع تولیدشده روی NAME. به صورت پیش‌فرض نام ساختار "elf" است.
-v, --varname=NAME: تنظیم نام متغیر در کد منبع تولیدشده روی NAME. به صورت پیش‌فرض نام متغیر "foo" است.
-m, --allow-misaligned: یک بخش ترازنشده در فایل ELF باعث درج بایت‌های فاصله (padding) در ساختار C می‌شود. برای جلوگیری از این وضعیت، elftoc بخش‌های ترازنشده را بدون توجه به نوع اصلی آن‌ها، به صورت آرایه‌های بایت تفسیرنشده بازنمایی می‌کند. این گزینه مانع این رفتار می‌شود، به‌طوری که بخش‌های ترازنشده نوع واقعی خود را حفظ کنند، حتی اگر تصویری نادرست در ساختار C ایجاد شود.
-q, --quiet: نادیده‌گرفتن پیام‌های هشدار درباره مقادیر نامعتبر و متناقض در فایل ELF.
-o, --output=FILENAME: نوشتن کد منبع C در FILENAME به جای ارسال به خروجی استاندارد.
--help: نمایش راهنما و خروج.
--version: نمایش اطلاعات نگارش و خروج.

حق نشر (COPYRIGHT)

مجوز GPLv2+: گنو GPL نگارش ۲ یا بالاتر. این یک نرم‌افزار آزاد است: شما آزادید آن را تغییر داده و بازتوزیع کنید. هیچ ضمانتی وجود ندارد، تا میزانی که قانون اجازه می‌دهد.