STRIP(1)                     GNU Development Tools                    STRIP(1)


نام (NAME)
       ppc64le-elf-strip - حذف نمادها و سایر داده‌ها از فایل‌های شیء

خلاصه دستور (SYNOPSIS)
       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 را نیز از فایل خروجی حذف می‌کند. این گزینه می‌تواند بیش
           از یک بار مشخص شود. توجه داشته باشید که استفاده نادرست از این گزینه
           ممکن است فایل خروجی را غیرقابل استفاده کند. نویسه عمومی (wildcard)
           * می‌تواند در انتهای 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
           محتوای تمامی بخش‌های dwo. از استاندارد DWARF را حذف می‌کند، اما سایر
           بخش‌های اشکال‌زدایی و تمامی نمادها را دست‌نخورده باقی می‌گذارد. برای
           اطلاعات بیشتر، توضیحات این گزینه را در بخش 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 را از فایل مبدأ حذف می‌کند. این گزینه می‌تواند بیش از
           یک بار مشخص شود و می‌تواند با سایر گزینه‌های پیراستن به‌جز -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
           اجازه استفاده از عبارت‌های باقاعده (regular expressions) را در
           symbolnameهای به‌کاررفته در سایر گزینه‌های خط فرمان می‌دهد. عملگرهای
           علامت سؤال (?)، ستاره (*)، بک‌اسلش (\) و قلاب‌ها ([]) می‌توانند در هر
           کجای نام نماد استفاده شوند. اگر نخستین نویسه نام نماد علامت تعجب
           (!) باشد، معنای سوییچ برای آن نماد معکوس می‌شود. برای نمونه:

                     -w -K !foo -K fo*

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

       -x
       --discard-all
           نمادهای غیرسراسری (non-global) را حذف می‌کند.

       -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 sections) را
           نیز در خروجی حفظ می‌کند.

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

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

           1.  فایل اجرایی را به‌طور معمول پیوند (link) دهید. با فرض اینکه نام
               آن "foo" باشد، سپس...

           2.  دستور "objcopy --only-keep-debug foo foo.dbg" را اجرا کنید تا
               فایلی حاوی اطلاعات اشکال‌زدایی ایجاد شود.

           3.  دستور "strip --strip-debug foo" را اجرا کنید تا یک فایل اجرایی
               پیراسته‌شده ایجاد شود.

           4.  دستور "objcopy --add-gnu-debuglink=foo.dbg foo" را اجرا کنید تا
               پیوندی به اطلاعات اشکال‌زدایی به فایل اجرایی پیراسته‌شده اضافه
               شود.

           توجه --- انتخاب ".dbg" به‌عنوان پسوند فایل اطلاعات اشکال‌زدایی
           اختیاری است. همچنین مرحله "--only-keep-debug" اختیاری است. در عوض
           می‌توانید این کار را انجام دهید:

           1.  فایل اجرایی را به‌طور معمول پیوند دهید.

           2.  "foo" را به "foo.full" کپی کنید.

           3.  دستور "strip --strip-debug foo" را اجرا کنید.

           4.  دستور "objcopy --add-gnu-debuglink=foo.full foo" را اجرا کنید.

           به این معنی که فایلی که توسط --add-gnu-debuglink به آن اشاره می‌شود
           می‌تواند همان فایل اجرایی کامل باشد و نیازی نیست حتماً فایلی باشد که
           توسط سوئیچ --only-keep-debug ایجاد شده است.

           توجه --- این سوئیچ تنها برای استفاده در فایل‌های کاملاً پیوندیافته
           (fully linked) در نظر گرفته شده است. استفاده از آن روی فایل‌های شیء
           که اطلاعات اشکال‌زدایی در آن‌ها ممکن است ناقص باشد منطقی نیست. علاوه
           بر این، قابلیت gnu_debuglink در حال حاضر تنها از وجود یک نام فایل
           حاوی اطلاعات اشکال‌زدایی پشتیبانی می‌کند، نه چندین نام فایل بر اساس
           هر فایل شیء.

       --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 با نویسه‌های فاصله خالی (whitespace) جدا می‌شوند. یک
           نویسه فاصله خالی می‌تواند با محصور کردن کل گزینه در نقل‌قول‌های تکی یا
           دوتایی درون یک گزینه گنجانده شود. هر نویسه‌ای (از جمله بک‌اسلش)
           می‌تواند با پیشوند کردن یک بک‌اسلش به آن درج گردد. پرونده file خود
           می‌تواند شامل گزینه‌های @file بیشتری باشد؛ هر یک از این گزینه‌ها
           به‌صورت بازگشتی پردازش خواهند شد.

همچنین ببینید (SEE ALSO)
       مدخل‌های Info برای binutils.

حق نشر (COPYRIGHT)
       حق نشر (c) ۱۹۹۱-۲۰۲۵ Free Software Foundation, Inc.

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

binutils-2.45.1                   2026-01-23                          STRIP(1)