.\" Copyright 2023 Red Hat Inc.
.\" Mon 2023-Sept 23 Housam Alamour <halamour@redhat.com>
.\" Contact elfutils-devel@sourceware.org to correct errors or typos.
.TH EU-SRCFILES 1 "2023-Sept-25" "elfutils" "دستورات کاربر"

.de SAMPLE
.br
.RS 0
.nf
.nh
\fB
..
.de ESAMPLE
\fP
.hy
.fi
.RE
..

.SH "نام (NAME)"
eu-srcfiles \- فهرست کردن پرونده‌های منبع یک پرونده DWARF/ELF

.SH "خلاصه دستور (SYNOPSIS)"
eu-srcfiles [\fB\-0\fR|\fB\-\-null\fR] [\fB\-c\fR|\fB\-\-cu\-only\fR] [\fB\-v\fR|\fB\-\-verbose\fR] [\fB\-z\fR|\fB\-\-zip\fR] INPUT

.SH "توضیحات (DESCRIPTION)"
دستور \fBeu-srcfiles\fR تمام پرونده‌های منبع یک پرونده DWARF/ELF داده‌شده را فهرست می‌کند. این فهرست بر پایه جستجوی اطلاعات اشکال‌زدایی DWARF (debuginfo) است که در صورت امکان ممکن است به‌طور خودکار توسط debuginfod واکشی شود. پرونده هدف می‌تواند یک پرونده اجرایی، یک رونوشت حافظه (coredump)، یک فرایند یا حتی هسته در حال اجرا باشد. ورودی پیش‌فرض، پرونده 'a.out' است. نام پرونده‌های منبع با افزودن مسیر کامل به ابتدای آن‌ها یکتا شده و سپس در خروجی استاندارد چاپ می‌شوند. پرونده‌های منبع را می‌توان درون یک پرونده zip قرار داد که به خروجی استاندارد ارسال می‌شود.
.PP
توجه داشته باشید که تمام رخدادهای '/./' و '/../' در نام مسیر متعارف‌سازی می‌شوند.

.SH "گزینه‌های ورودی (INPUT OPTIONS)"
فرم‌های بلند و کوتاه گزینه‌ها که در اینجا به‌عنوان جایگزین نشان داده شده‌اند، معادل یکدیگر هستند.
.TP
\fB\-\-core=COREFILE\fR
یافتن نشانی‌ها از امضاهای یافت‌شده در COREFILE.

.TP
\fB\-\-debuginfo\-path=PATH\fR
مسیر جستجو برای پرونده‌های مجزای debuginfo.

.TP
\fB\-e FILE\fR, \fB\-\-executable=FILE\fR
یافتن نشانی‌ها در FILE.

.TP
\fB\-k\fR, \fB\-\-kernel\fR
یافتن نشانی‌ها در هسته در حال اجرا.

.TP
\fB\-K\fR, \fB\-\-offline\-kernel[=RELEASE]\fR
هسته به همراه تمام ماژول‌ها.

.TP
\fB\-M FILE\fR, \fB\-\-linux\-process\-map=FILE\fR
یافتن نشانی‌ها در پرونده‌های نگاشت‌شده بر اساس خواندن از FILE در قالب /proc/PID/maps لینوکس.

.TP
\fB\-p PID\fR, \fB\-\-pid=PID\fR
یافتن نشانی‌ها در پرونده‌های نگاشت‌شده به فرایند PID.

.TP
\fB\-?\fR, \fB\-\-help\fR
ارائه این فهرست راهنما.

.TP
\fB\-\-usage\fR
ارائه یک پیام کوتاه درباره نحوه استفاده.

.TP
\fB\-V\fR, \fB\-\-version\fR
چاپ نسخه برنامه.

.SH "گزینه‌های خروجی (OUTPUT OPTIONS)"

.TP
\fB\-0\fR, \fB\-\-null\fR
جداسازی موارد با یک نویسه تهی (null) به‌جای خط جدید.

.TP
\fB\-b\fR, \fB\-\-no\-backup\fR
غیرفعال کردن جستجوی پرونده‌های منبع محلی هنگامی که debuginfod در واکشی پرونده‌ها ناموفق است. این گزینه تنها هنگام واکشی و فشرده‌سازی پرونده‌ها به صورت zip کاربرد دارد.

.TP
\fB\-c\fR, \fB\-\-cu\-only\fR
تنها نام‌های CU (واحد کامپایل) را فهرست می‌کند.

.TP
\fB\-v\fR, \fB\-\-verbose\fR
افزایش پرگویی پیام‌های گزارش‌گیری (لاگ).

.TP
\fB\-z\fR, \fB\-\-zip\fR
فشرده‌سازی تمام پرونده‌های منبع در قالب zip و ارسال به خروجی استاندارد.
به‌طور پیش‌فرض، پرونده‌ها به‌صورت خودکار توسط debuginfod (در صورت امکان) یا به‌صورت محلی به‌عنوان پشتیبان واکشی می‌شوند. هر پرونده منبعی که پیدا نشود بایگانی نخواهد شد.

.SH "مثال‌ها (EXAMPLES)"

فهرست کردن تمام پرونده‌های منبع برای یک باینری.
.SAMPLE
eu-srcfiles -e /bin/ls
.ESAMPLE

فهرست کردن تمام نام‌های واحدهای کامپایل (CU) برای یک فرایند مشخص (شامل کتابخانه‌های اشتراکی).
.SAMPLE
eu-srcfiles -c -p $$
.ESAMPLE

فهرست کردن پرونده‌های منبع یک باینری بر اساس buildid آن، با استفاده از debuginfod.
.SAMPLE
binary=`debuginfod-find executable 9c22d8d9e42bd051ffdc1064fdfd456ba781c629`
eu-srcfiles -c -e $binary
.ESAMPLE

نمایش کد منبع اولین CU از یک کتابخانه اشتراکی.
.SAMPLE
binary=/usr/lib64/libc.so.6
srcfile=`eu-srcfiles -c -e $binary | head -1`
cat `debuginfod-find source $binary $srcfile`
.ESAMPLE

فهرست کردن پرونده‌های منبع یک ایمیج هسته.
.SAMPLE
eu-srcfiles -e /boot/vmlinuz-`uname -r`
.ESAMPLE

فشرده‌سازی تمام پرونده‌های منبع برای یک باینری در قالب zip.
.SAMPLE
eu-srcfiles -z -e /bin/ls > ls.zip
.ESAMPLE

.SH "نویسندگان (AUTHORS)"
نوشته‌شده توسط Housam Alamour.

.SH "گزارش باگ‌ها (REPORTING BUGS)"
لطفاً باگ‌ها را در <https://sourceware.org/bugzilla> گزارش دهید.

.SH "کپی‌رایت (COPYRIGHT)"
کپی‌رایت \(co ۲۰۲۳ شرکت Red Hat Inc.
مجوز GPLv3+: گنو GPL نسخه ۳ یا جدیدتر <https://gnu.org/licenses/gpl.html>.
این یک نرم‌افزار آزاد است: شما در تغییر و بازتوزیع آن آزاد هستید.
هیچ ضمانتی وجود ندارد، تا حدی که توسط قانون مجاز دانسته شده است.