'\" t
.\" Man page generated from reStructuredText
.\" by the Docutils 0.23 manpage writer.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "LLVM-STRIP" "1" "2026-07-15" "22" "LLVM"
.SH "نام (NAME)"
llvm-strip \- ابزار پیراستن فایل‌های شیء
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBllvm\-strip\fP [\fIگزینه‌ها\fP] \fIورودی‌ها...\fP
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \fBllvm\-strip\fP ابزاری برای پیراستن بخش‌ها و نمادها از فایل‌های شیء است.
اگر هیچ گزینهٔ پیراستن یا حذف دیگری مشخص نشود، \fB\-\-strip\-all\fP
به‌طور پیش‌فرض فعال خواهد شد.
.sp
به‌طور پیش‌فرض، فایل‌های ورودی درجا اصلاح می‌شوند. اگر برای فایل
ورودی مقدار \(dq\-\(dq مشخص شود، ورودی از جریان ورودی استاندارد برنامه خوانده می‌شود.
.sp
اگر ورودی یک بایگانی باشد، هر عملیات درخواستی بر روی تک‌تک اعضای
بایگانی به‌صورت جداگانه اعمال خواهد شد.
.sp
این ابزار همچنان در حال توسعهٔ فعال است، اما در بیشتر سناریوها می‌تواند به‌عنوان یک
جایگزین مستقیم برای \fBstrip\fP گنو (GNU) عمل کند.
.SH "گزینه‌های عمومی و چندسکویی (GENERIC AND CROSS-PLATFORM OPTIONS)"
.sp
گزینه‌های زیر یا مستقل از قالب فایل هستند، یا بر چندین قالب فایل
اعمال می‌شوند.
.INDENT 0.0
.TP
.B \-\-disable\-deterministic\-archives, \-U
استفاده از مقادیر واقعی برای UIDها، GIDها و برچسب‌های زمانی هنگام به‌روزرسانی سرآیند اعضای
بایگانی.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-discard\-all, \-x
حذف بیشتر نمادهای محلی که در بازنشانی‌ها ارجاع داده نشده‌اند از خروجی.
قالب‌های مختلف فایل ممکن است این مورد را به زیرمجموعه‌ای از نمادهای محلی محدود کنند؛ برای
نمونه، نمادهای فایل و بخش در اشیاء ELF دور ریخته نخواهند شد.
علاوه بر این، تمام بخش‌های اشکال‌زدایی نیز حذف می‌شوند.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-enable\-deterministic\-archives, \-D
فعال‌سازی حالت قطعی هنگام پیراستن بایگانی‌ها؛ یعنی استفاده از مقدار ۰ برای فیلدهای UID، GID
و برچسب زمان در سرآیند اعضای بایگانی. به‌طور پیش‌فرض فعال است.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-help, \-h
چاپ خلاصه‌ای از گزینه‌های خط فرمان.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-no\-strip\-all
غیرفعال کردن \fB\-\-strip\-all\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-o <file>
نوشتن خروجی در <file>. نمی‌توان چندین فایل ورودی را در ترکیب با
\-o استفاده کرد.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-only\-keep\-debug
تولید یک فایل اشکال‌زدایی به‌عنوان خروجی که تنها محتویات بخش‌های مفید برای
مقاصد اشکال‌زدایی را حفظ می‌کند.
.sp
برای اشیاء ELF، این گزینه محتویات بخش‌های \fISHF_ALLOC\fP را که از نوع
\fISHT_NOTE\fP نیستند، با تبدیل آن‌ها به \fISHT_NOBITS\fP و در صورت امکان کاهش اندازهٔ
سرآیندهای برنامه، حذف می‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-regex
در صورت مشخص شدن، با نام‌های نماد و بخش تعیین‌شده توسط دیگر سوئیچ‌ها،
به‌صورت الگوهای عبارت منظم تعمیم‌یافتهٔ POSIX رفتار می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-remove\-section <section>, \-R
حذف بخش مشخص‌شده از خروجی. این گزینه می‌تواند چندین بار مشخص شود
تا چندین بخش به‌طور هم‌زمان حذف گردند.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-strip\-all\-gnu
حذف تمامی نمادها، بخش‌های اشکال‌زدایی و بازنشانی‌ها از خروجی. این گزینه
معادل سوئیچ \fB\-\-strip\-all\fP در دستور \fBstrip\fP متعلق به GNU است.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-strip\-all, \-s
برای اشیاء ELF، تمام نمادها و بخش‌های غیرتخصیصی خارج از قطعه‌ها را از خروجی
حذف می‌کند، به جز بخش‌های .gnu.warning و .ARM.attribute و
جدول نام بخش‌ها.
.sp
برای اشیاء COFF، تمام نمادها، بخش‌های اشکال‌زدایی و بازنشانی‌ها را از
خروجی حذف می‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-strip\-debug, \-d, \-g, \-S
حذف تمام بخش‌های اشکال‌زدایی از خروجی.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-strip\-symbol <symbol>, \-N
حذف تمام نمادهای دارای نام \fB<symbol>\fP از خروجی. برای حذف چندین نماد
می‌توان این گزینه را چند بار مشخص کرد.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-strip\-unneeded
حذف تمام نمادهای محلی یا تعریف‌نشده‌ای که برای بازنشانی‌ها لازم نیستند
از خروجی. همچنین تمام بخش‌های اشکال‌زدایی را حذف می‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-version, \-V
نمایش نسخهٔ فایل اجرایی \fBllvm\-strip\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-wildcard, \-w
مجاز ساختن نحو نویسهٔ عام برای پرچم‌های مربوط به نمادها. به‌طور پیش‌فرض برای
پرچم‌های مربوط به بخش‌ها فعال است. ناسازگار با \-\-regex.
.sp
نحو نویسهٔ عام نمادهای ویژهٔ زیر را مجاز می‌داند:
.TS
box center;
l|l|l.
T{
نویسه
T}	T{
معنی
T}	T{
معادل
T}
_
T{
\fB*\fP
T}	T{
هر تعداد نویسه
T}	T{
\fB\&.*\fP
T}
_
T{
\fB?\fP
T}	T{
هر نویسهٔ تکی
T}	T{
\fB\&.\fP
T}
_
T{
\fB\e\fP
T}	T{
گریز دادن نویسهٔ بعدی
T}	T{
\fB\e\fP
T}
_
T{
\fB[a\-z]\fP
T}	T{
کلاس نویسه
T}	T{
\fB[a\-z]\fP
T}
_
T{
\fB[!a\-z]\fP, \fB[^a\-z]\fP
T}	T{
کلاس نویسهٔ نفی‌شده
T}	T{
\fB[^a\-z]\fP
T}
.TE
.sp
علاوه بر این، شروع یک نویسهٔ عام با \(aq!\(aq از تطابق جلوگیری می‌کند، حتی اگر
پرچم دیگری تطابق داشته باشد. برای نمونه \fB\-w \-N \(aq*\(aq \-N \(aq!x\(aq\fP تمام نمادها
را به جز \fBx\fP می‌پیراید.
.sp
ترتیب نویسه‌های عام اهمیتی ندارد. برای نمونه، \fB\-w \-N \(aq*\(aq \-N \(aq!x\(aq\fP با
\fB\-w \-N \(aq!x\(aq \-N \(aq*\(aq\fP یکسان است.
.UNINDENT
.INDENT 0.0
.TP
.B @<FILE>
خواندن گزینه‌ها و دستورات خط فرمان از فایل پاسخ \fI<FILE>\fP\&.
.UNINDENT
.SH "گزینه‌های مختص ELF (ELF-SPECIFIC OPTIONS)"
.sp
گزینه‌های زیر تنها برای اشیاء ELF پیاده‌سازی شده‌اند. در صورت استفاده با سایر
اشیاء، \fBllvm\-strip\fP یا خطایی صادر می‌کند یا در سکوت از
آن‌ها چشم‌پوشی می‌نماید.
.INDENT 0.0
.TP
.B \-\-allow\-broken\-links
به \fBllvm\-strip\fP اجازه می‌دهد بخش‌ها را حذف کند حتی اگر به مراجع نامعتبر
بخش منجر شود. هر فیلد نامعتبر sh_link روی صفر تنظیم خواهد شد.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-discard\-locals, \-X
حذف نمادهای محلی که با \(dq.L\(dq آغاز می‌شوند و در بازنشانی‌ها به آن‌ها ارجاع داده نشده است از خروجی.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-keep\-file\-symbols
نگه‌داشتن نمادهای از نوع \fISTT_FILE\fP، حتی اگر در غیر این صورت پیراسته می‌شدند.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-keep\-section <section>
هنگام حذف بخش‌ها از خروجی، بخش‌های با نام \fB<section>\fP را حذف
نکن. این گزینه می‌تواند چندین بار برای نگه‌داشتن چندین بخش مشخص شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-keep\-symbol <symbol>, \-K
هنگام حذف نمادها از خروجی، نمادهای با نام \fB<symbol>\fP را حذف
نکن. این گزینه می‌تواند چندین بار برای نگه‌داشتن چندین نماد مشخص شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-preserve\-dates, \-p
حفظ برچسب‌های زمان دسترسی و تغییر در خروجی.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-strip\-sections
حذف تمام سرآیندهای بخش و تمام داده‌های بخشی که درون قطعه‌ها نیستند از
خروجی. توجه داشته باشید که بسیاری از ابزارها قادر به استفاده از شیء فاقد
سرآیند بخش نخواهند بود.
.UNINDENT
.SH "گزینه‌های مختص MACH-O (MACH-O-SPECIFIC OPTIONS)"
.sp
گزینه‌های زیر تنها برای اشیاء Mach\-O پیاده‌سازی شده‌اند. در صورت استفاده با سایر
اشیاء، \fBllvm\-strip\fP یا خطایی صادر می‌کند یا در سکوت از
آن‌ها چشم‌پوشی می‌نماید.
.INDENT 0.0
.TP
.B \-T
حذف نمادهای Swift.
.UNINDENT
.SH "وضعیت خروج (EXIT STATUS)"
.sp
در صورت بروز خطا، \fBllvm\-strip\fP با یک کد خروج غیرصفر خارج می‌شود.
در غیر این صورت، با کد 0 خارج می‌شود.
.SH "گزارش باگ‌ها (BUGS)"
.sp
برای گزارش باگ‌ها، لطفاً به <\%<https://\:github\:.com/\:llvm/\:llvm-project/\:labels/\:tools:llvm-objcopy%2Fstrip>> مراجعه کنید.
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBllvm\-objcopy(1) \%<llvm-objcopy\:.html>\fP
.SH "نویسندگان (AUTHORS)"
نگه‌داری‌شده توسط تیم LLVM (https://llvm.org).
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
2003-2026, LLVM Project
.\" End of generated man page.