نام (NAME)

loongarch64-linux-gnu-strip - حذف نمادها و متادیتاهای غیرضروری از فایل‌های شیء LoongArch64

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

loongarch64-linux-gnu-strip [-F bfdname |--target=bfdname]
[-I bfdname |--input-target=bfdname]
[-O bfdname |--output-target=bfdname]
[-s|--strip-all]
[-S|-g|-d|--strip-debug]
[--strip-dwo]
[-K symbolname|--keep-symbol=symbolname]
[-M|--merge-notes][--no-merge-notes]
[-N symbolname |--strip-symbol=symbolname]
[-w|--wildcard]
[-x|--discard-all] [-X |--discard-locals]
[-R sectionname |--remove-section=sectionname]
[--keep-section=sectionpattern]
[--remove-relocations=sectionpattern]
[--strip-section-headers]
[-o file] [-p|--preserve-dates]
[-D|--enable-deterministic-archives]
[-U|--disable-deterministic-archives]
[--keep-section-symbols]
[--keep-file-symbols]
[--only-keep-debug]
[--plugin name]
[-v |--verbose] [-V|--version]
[--help] [--info]
objfile...

توضیحات (DESCRIPTION)

ابزار strip گنو تمامی نمادها را از فایل‌های شیء objfile حذف می‌کند. فهرست فایل‌های شیء می‌تواند شامل بایگانی‌ها نیز باشد. حداقل یک فایل شیء باید مشخص شود.

strip فایل‌های نام‌برده‌شده در آرگومان‌هایش را مستقیماً تغییر می‌دهد، به جای آن‌که نسخه‌های اصلاح‌شده را با نام‌های متفاوتی ذخیره کند.

گزینه‌ها (OPTIONS)

-F bfdname

--target=bfdname

فایل شیء اصلی objfile را به عنوان فایلی با قالب کد شیء bfdname در نظر می‌گیرد و آن را با همان قالب بازنویسی می‌کند.

--help

نمایش خلاصه‌ای از گزینه‌های strip و خروج.

--info

نمایش فهرستی شامل تمامی معماری‌ها و قالب‌های شیء موجود.

-I bfdname

--input-target=bfdname

فایل شیء اصلی objfile را به عنوان فایلی با قالب کد شیء bfdname در نظر می‌گیرد.

-O bfdname

--output-target=bfdname

جایگزینی objfile با فایلی در قالب خروجی bfdname.

-R sectionname

--remove-section=sectionname

حذف هر بخش با نام sectionname از فایل خروجی، علاوه بر بخش‌هایی که در حالت عادی حذف می‌شوند. این گزینه می‌تواند بیش از یک بار مشخص شود. توجه داشته باشید که استفاده نادرست از این گزینه ممکن است فایل خروجی را غیرقابل استفاده کند. نویسه عام * می‌تواند در انتهای sectionname قرار گیرد؛ در این صورت، هر بخشی که با sectionname شروع شود حذف خواهد شد.

اگر نخستین نویسه sectionpattern علامت تعجب (!) باشد، بخش‌های منطبق حذف نخواهند شد حتی اگر استفاده قبلی از --remove-section در همان خط فرمان موجب حذف آن‌ها می‌شد. برای نمونه:

--remove-section=.text.* --remove-section=!.text.foo

تمامی بخش‌های منطبق با الگوی '.text.*' را حذف می‌کند، اما بخش '.text.foo' را حذف نخواهد کرد.

--keep-section=sectionpattern

هنگام حذف بخش‌ها از فایل خروجی، بخش‌های منطبق با sectionpattern را حفظ می‌کند.

--remove-relocations=sectionpattern

حذف اطلاعات بازآرایی (relocations) از فایل خروجی برای هر بخشی که با sectionpattern مطابقت دارد. این گزینه می‌تواند بیش از یک بار مشخص شود. توجه داشته باشید که استفاده نادرست از این گزینه ممکن است فایل خروجی را غیرقابل استفاده کند. نویسه‌های عام در sectionpattern پذیرفته می‌شوند. برای نمونه:

--remove-relocations=.text.*

اطلاعات بازآرایی را برای تمامی بخش‌های منطبق با الگوی '.text.*' حذف خواهد کرد.

اگر نخستین نویسه sectionpattern علامت تعجب (!) باشد، اطلاعات بازآرایی بخش‌های منطبق حذف نخواهد شد حتی اگر استفاده قبلی از --remove-relocations در همان خط فرمان موجب حذف آن‌ها می‌شد. برای نمونه:

--remove-relocations=.text.* --remove-relocations=!.text.foo

تمامی اطلاعات بازآرایی بخش‌های منطبق با الگوی '.text.*' را حذف می‌کند، اما بازآرایی‌های بخش '.text.foo' را حذف نخواهد کرد.

--strip-section-headers

حذف سرایندهای بخش‌ها (section headers). این گزینه مختص فایل‌های ELF است. گزینه‌های --strip-all و --merge-notes را نیز فعال می‌کند.

-s

--strip-all

حذف تمامی نمادها.

-g

-S

-d

--strip-debug

فقط حذف نمادهای اشکال‌زدایی.

--strip-dwo

حذف محتوای تمامی بخش‌های DWARF .dwo، در حالی که باقی بخش‌های اشکال‌زدایی و تمامی نمادها دست‌نخورده باقی می‌مانند. برای اطلاعات بیشتر، توضیحات این گزینه را در بخش objcopy ببینید.

--strip-unneeded

حذف تمامی نمادهایی که برای پردازش بازآرایی لازم نیستند، علاوه بر نمادهای اشکال‌زدایی و بخش‌هایی که توسط --strip-debug حذف می‌شوند.

-K symbolname

--keep-symbol=symbolname

هنگام حذف نمادها، نماد symbolname حفظ شود حتی اگر در حالت عادی حذف می‌شد. این گزینه می‌تواند بیش از یک بار مشخص شود.

-M

--merge-notes

--no-merge-notes

برای فایل‌های ELF، تلاش برای کاهش حجم (یا عدم کاهش حجم) بخش‌های از نوع SHT_NOTE از طریق حذف یادداشت‌های تکراری. حالت پیش‌فرض تلاش برای این کاهش است مگر این‌که اطلاعات اشکال‌زدایی یا DWO در حال حذف باشند.

-N symbolname

--strip-symbol=symbolname

حذف نماد symbolname از فایل مبدا. این گزینه می‌تواند بیش از یک بار مشخص شود و با سایر گزینه‌های strip به جز -K ترکیب گردد.

-o file

قرار دادن خروجی تغییریافته در file، به جای جایگزینی فایل موجود. با استفاده از این آرگومان، تنها یک آرگومان objfile می‌تواند مشخص شود.

-p

--preserve-dates

حفظ تاریخ‌های دسترسی و تغییر فایل.

-D

--enable-deterministic-archives

فعالیت در حالت قطعیت‌پذیر (deterministic). هنگام کپی اعضای بایگانی و نوشتن نمایه بایگانی، از مقدار صفر برای UIDها، GIDها و برچسب‌های زمانی و از حالت‌های دسترسی یکپارچه برای تمامی فایل‌ها استفاده می‌کند.

اگر binutils با گزینه --enable-deterministic-archives پیکربندی شده باشد، این حالت به طور پیش‌فرض فعال است. می‌توان آن را با گزینه -U غیرفعال کرد.

-U

--disable-deterministic-archives

عدم فعالیت در حالت قطعیت‌پذیر. این برعکس گزینه -D در بالا است: هنگام کپی اعضای بایگانی و نوشتن نمایه بایگانی، از مقادیر واقعی UID، GID، برچسب زمانی و حالت‌های دسترسی فایل استفاده می‌کند.

این حالت پیش‌فرض است مگر این‌که binutils با گزینه --enable-deterministic-archives پیکربندی شده باشد.

-w

--wildcard

مجاز کردن الگوهای عمومی و عبارات منظم در symbolnameهای استفاده‌شده در سایر گزینه‌های خط فرمان. عملگرهای علامت سوال (?)، ستاره (*)، بک‌اسلش (\) و قلاب‌ها ([]) می‌توانند در هر کجای نام نماد استفاده شوند. اگر نخستین نویسه نام نماد علامت تعجب (!) باشد، معنای سوییچ برای آن نماد معکوس می‌شود. برای نمونه:

-w -K !foo -K fo*

باعث می‌شود strip فقط نمادهایی را نگه دارد که با حروف "fo" شروع می‌شوند، اما نماد "foo" را حذف کند.

-x

--discard-all

حذف نمادهای غیرسراسری.

-X

--discard-locals

حذف نمادهای محلی تولیدشده توسط کامپایلر. (این نمادها معمولاً با L یا . شروع می‌شوند.)

--keep-section-symbols

هنگام استریپ کردن یک فایل (مثلاً با --strip-debug یا --strip-unneeded)، نگه‌داشتن هر نمادی که مشخص‌کننده نام بخش‌ها است و در غیر این صورت حذف می‌شد.

--keep-file-symbols

هنگام استریپ کردن یک فایل (مثلاً با --strip-debug یا --strip-unneeded)، نگه‌داشتن هر نمادی که مشخص‌کننده نام فایل‌های مبدا است و در غیر این صورت حذف می‌شد.

--only-keep-debug

استریپ کردن فایل، خالی کردن محتوای هر بخشی که توسط --strip-debug حذف نمی‌شد و دست‌نخورده گذاشتن بخش‌های اشکال‌زدایی. در فایل‌های ELF، این گزینه تمامی بخش‌های note را نیز در خروجی حفظ می‌کند.

نکته - سرایندهای بخش‌های استریپ‌شده، از جمله اندازه آن‌ها، حفظ می‌شوند اما محتوای بخش دور ریخته می‌شود. سرایندهای بخش حفظ می‌شوند تا سایر ابزارها بتوانند فایل debuginfo را با فایل اجرایی واقعی تطبیق دهند، حتی اگر آن فایل اجرایی به فضای آدرس متفاوتی منتقل شده باشد.

هدف این است که این گزینه در ترکیب با --add-gnu-debuglink برای ایجاد یک فایل اجرایی دو بخشی استفاده شود: یکی یک باینری استریپ‌شده که فضای کمتری در RAM و در توزیع اشغال می‌کند و دومی یک فایل اطلاعات اشکال‌زدایی که تنها در صورت نیاز به قابلیت‌های اشکال‌زدایی مورد نیاز است. روش پیشنهادی برای ایجاد این فایل‌ها به شرح زیر است:

--plugin name

بارگذاری افزونه به نام name برای افزودن پشتیبانی از انواع هدف‌های اضافی. این گزینه تنها زمانی در دسترس است که زنجیره ابزار با پشتیبانی از افزونه‌ها ساخته شده باشد.

اگر --plugin مشخص نشود، اما پشتیبانی از افزونه فعال باشد، strip فایل‌های موجود در ${libdir}/bfd-plugins را به ترتیب الفبایی بررسی کرده و از نخستین افزونه‌ای که شیء مورد نظر را پشتیبانی کند استفاده می‌نماید.

لطفاً توجه داشته باشید که این دایرکتوری جستجوی افزونه، همان دایرکتوری مورد استفاده توسط گزینه -plugin در ld نیست. برای این‌که strip از افزونه پیونددهنده استفاده کند، افزونه باید در دایرکتوری ${libdir}/bfd-plugins کپی شود. برای کامپایل‌های مبتنی بر GCC، افزونه پیونددهنده liblto_plugin.so.0.0.0 نام دارد. برای کامپایل‌های مبتنی بر Clang نام آن LLVMgold.so است. افزونه GCC همواره با نسخه‌های قبلی سازگار است، بنابراین کپی کردن جدیدترین نسخه کفایت می‌کند.

-V

--version

نمایش شماره نسخه strip.

-v

--verbose

خروجی با جزئیات: فهرست کردن تمامی فایل‌های شیء اصلاح‌شده. در مورد بایگانی‌ها، strip -v تمامی اعضای بایگانی را فهرست می‌کند.

@file

خواندن گزینه‌های خط فرمان از file. گزینه‌های خوانده‌شده به جای گزینه اصلی @file درج می‌شوند. اگر file وجود نداشته باشد یا قابل خواندن نباشد، با گزینه به صورت تحت‌اللفظی رفتار شده و حذف نخواهد شد.

گزینه‌ها در file با نویسه‌های فاصله جدا می‌شوند. یک نویسه فاصله می‌تواند با قرار دادن کل گزینه در گیومه تکی یا دوتایی گنجانده شود. هر نویسه‌ای (شامل بک‌اسلش) می‌تواند با قرار دادن پیشوند بک‌اسلش قبل از آن درج شود. خود file ممکن است حاوی گزینه‌های @file دیگری باشد؛ چنین گزینه‌هایی به صورت بازگشتی پردازش می‌شوند.

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

مدخل‌های Info برای binutils.

حق نشر (COPYRIGHT)

حق نشر © ۱۹۹۱-۲۰۲۶ بنیاد نرم‌افزار آزاد (Free Software Foundation, Inc.)

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