.TH "FIND\-DEBUGINFO" "1" "سپتامبر ۲۰۲۲" "debugedit" "دستورهای کاربری"
.SH "نام (NAME)"
find-debuginfo \- استخراج اطلاعات دیباگ از فایلهای باینری ELF
.SH "خلاصه دستور (SYNOPSIS)"
.B find-debuginfo
[\fIگزینهها\fR] [\fIپوشه_ساخت\fR]
.SH "توضیحات (DESCRIPTION)"
استخراج اطلاعات دیباگ از فایلهای اجرایی ELF و کتابخانهها به فایلهای .debug مجزا.
.SH "گزینه‌ها (OPTIONS)"
.nf
[\-\-strict\-build\-id] [\-g] [\-r] [\-m] [\-i] [\-n]
[\-\-keep\-section SECTION] [\-\-remove\-section SECTION]
[\-\-g\-libs]
[\-j N] [\-\-jobs N]
[\-o debugfiles.list]
[\-S debugsourcefiles.list]
[\-\-run\-dwz] [\-\-dwz\-low\-mem\-die\-limit N]
[\-\-dwz\-max\-die\-limit N]
[\-\-dwz\-single\-file\-mode]
[\-\-build\-id\-seed SEED]
[\-\-unique\-debug\-suffix SUFFIX]
[\-\-unique\-debug\-src\-base BASE]
[[\-l filelist]... [\-p 'pattern'] \fB\-o\fR debuginfo.list]
[\fIپوشه_ساخت\fR]
.fi
.PP
فلگ
.B \-g
مشخص می‌کند که به جای حذف کامل نمادها (full strip)، از
.B strip \-g
روی اشیاء اشتراکی پویا (DSOs) یا فایلهای اجرایی (EXEs) استفاده شود.
فلگ
.B \-\-g\-libs
مشخص می‌کند که
.B strip \-g
به جای حذف کامل، تنها روی اشیاء اشتراکی پویا (DSOs) اعمال شود.
گزینه‌های
.B \-g
و
.B \-\-g\-libs
ناسازگار با یکدیگر هستند.
.PP
فلگ
.B \-r
مشخص می‌کند که از
.B eu\-strip \-\-reloc\-debug\-sections
استفاده شود.
.PP
از
.BI \-\-keep\-section " SECTION"
یا
.BI \-\-remove\-section " SECTION"
برای نگه‌داشتن صریح یک بخش (تخصیص‌نیافته) در فایل اجرایی اصلی یا حذف صریح آن و انتقال به فایل
.B .debug
استفاده کنید.
.I SECTION
یک الگوی تطبیق با نویسه‌های عمومی گسترده (wildcard) است.
هر دو گزینه می‌توانند بیش از یک بار مشخص شوند.
.PP
فلگ
.B \-\-strict\-build\-id
مشخص می‌کند که اگر هر باینری ELF پردازش‌شده فاقد یادداشت
.I build\-id
باشد، برنامه با وضعیت شکست (خطا) خارج شود.
.PP
فلگ
.B \-m
مشخص می‌کند که بخش
.I .gnu_debugdata
در فایل باینری اصلی گنجانده شود.
.PP
فلگ
.B \-i
مشخص می‌کند که بخش
.I .gdb_index
در فایل
.B .debug
گنجانده شود.
.PP
فلگ
.B \-n
مشخص می‌کند که شناسه ساخت (build\-id) دوباره محاسبه نشود.
.PP
گزینه
.BR \-j "، " \-\-jobs " \fIN\fR"
تعداد
.I N
پردازش موازی را برای انجام همزمان استخراج اطلاعات دیباگ اجرا می‌کند.
.PP
یک سوییچ
.B \-o
منفرد پیش از هرگونه سوییچ
.B \-l
یا
.B \-p
تنها نام فایل خروجی اصلی را از
.B debugfiles.list
به نام دیگری تغییر می‌دهد.
یک سوییچ
.B \-o
که پس از یک سوییچ
.B \-p
یا چند سوییچ
.B \-l
بیاید، یک فایل خروجی اضافی شامل اطلاعات دیباگ برای فایلهای فهرست‌شده در فایل
.BI \-l " filelist"
یا فایلهایی که نام آن‌ها با الگوی
.B \-p
تطبیق دارد، تولید می‌کند.
آرگومان
.B \-p
یک عبارت باقاعده (regex) به سبک
.B grep \-E
برای تطبیق نام فایل است و نباید شامل لنگرها (^ یا $) باشد.
.PP
فلگ
.B \-\-run\-dwz
به
.B find\-debuginfo
دستور می‌دهد که در صورت در دسترس بودن، ابزار
.B dwz
را اجرا کند؛ و گزینه‌های
.B \-\-dwz\-low\-mem\-die\-limit
و
.B \-\-dwz\-max\-die\-limit
محدودیت‌های تفصیلی را تعیین می‌کنند.
برای جزئیات بیشتر به گزینه‌های
.B \-l
و
.B \-L
در
.BR dwz (1)
مراجعه کنید.
برای غیرفعال کردن حالت چندفایلی از
.B \-\-dwz\-single\-file\-mode
استفاده کنید؛ برای اطلاعات بیشتر
.BR dwz (1)
گزینه
.B \-m
را ببینید.
.PP
اگر
.BI \-\-build\-id\-seed " SEED"
مشخص شود، ابزار
.B debugedit
فراخوانی می‌شود تا شناسه‌های ساخت (build\-ids) یافته‌شده را به‌روز کند و از
.I SEED
به عنوان بذر (seed) برای محاسبه مجدد هش شناسه ساخت استفاده نماید.
این کار تضمین می‌کند که شناسه‌های ساخت در فایلهای ELF بین نگارش‌ها و انتشار‌های مختلف یک بسته یکتا باشند.
(از
.B \-\-build\-id\-seed "%{VERSION}\-%{RELEASE}"
استفاده کنید).
.PP
اگر
.BI \-\-unique\-debug\-suffix " SUFFIX"
مشخص شود، فایلهای دیباگ ایجادشده برای
.I <FILE>
به نام
.I <FILE>\-<SUFFIX>.debug
خوانده خواهند شد.
این کار تضمین می‌کند که فایلهای
.B .debug
بین نسخه بسته، انتشار و معماری یکتا باشند.
(از
.B \-\-unique\-debug\-suffix "\-%{VERSION}\-%{RELEASE}.%{_arch}"
استفاده کنید).
.PP
اگر
.BI \-\-unique\-debug\-src\-base " BASE"
مشخص شود، پوشه منبع (source directory) به نام
.I /usr/debug/src/<BASE>
نامیده خواهد شد.
این کار تضمین می‌کند که پوشه‌های سورس دیباگ بین نسخه بسته، انتشار و معماری یکتا باشند (از
.B \-\-unique\-debug\-src\-base "%{name}\-%{VERSION}\-%{RELEASE}.%{_arch}"
استفاده کنید).
.PP
تمامی نام‌های فایل در سوییچ‌ها نسبت به
.I پوشه_ساخت
(در صورت مشخص نشدن، '.') در نظر گرفته می‌شوند.
.SH "همچنین ببینید (SEE ALSO)"
.BR debugedit (1),
.BR dwz (1),
.BR strip (1),
.BR eu\-strip (1),
.BR elf (5)