نام (NAME)

eu-srcfiles - فهرست کردن پرونده‌های منبع یک پرونده DWARF/ELF

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

eu-srcfiles [-0|--null] [-c|--cu-only] [-v|--verbose] [-z|--zip] INPUT

توضیحات (DESCRIPTION)

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

توجه داشته باشید که تمام رخدادهای '/./' و '/../' در نام مسیر متعارف‌سازی می‌شوند.

گزینه‌های ورودی (INPUT OPTIONS)

فرم‌های بلند و کوتاه گزینه‌ها که در اینجا به‌عنوان جایگزین نشان داده شده‌اند، معادل یکدیگر هستند.

--core=COREFILE: یافتن نشانی‌ها از امضاهای یافت‌شده در COREFILE.
--debuginfo-path=PATH: مسیر جستجو برای پرونده‌های مجزای debuginfo.
-e FILE, --executable=FILE: یافتن نشانی‌ها در FILE.
-k, --kernel: یافتن نشانی‌ها در هسته در حال اجرا.
-K, --offline-kernel[=RELEASE]: هسته به همراه تمام ماژول‌ها.
-M FILE, --linux-process-map=FILE: یافتن نشانی‌ها در پرونده‌های نگاشت‌شده بر اساس خواندن از FILE در قالب /proc/PID/maps لینوکس.
-p PID, --pid=PID: یافتن نشانی‌ها در پرونده‌های نگاشت‌شده به فرایند PID.
-?, --help: ارائه این فهرست راهنما.
--usage: ارائه یک پیام کوتاه درباره نحوه استفاده.
-V, --version: چاپ نسخه برنامه.

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

-0, --null: جداسازی موارد با یک نویسه تهی (null) به‌جای خط جدید.
-b, --no-backup: غیرفعال کردن جستجوی پرونده‌های منبع محلی هنگامی که debuginfod در واکشی پرونده‌ها ناموفق است. این گزینه تنها هنگام واکشی و فشرده‌سازی پرونده‌ها به صورت zip کاربرد دارد.
-c, --cu-only: تنها نام‌های CU (واحد کامپایل) را فهرست می‌کند.
-v, --verbose: افزایش پرگویی پیام‌های گزارش‌گیری (لاگ).
-z, --zip: فشرده‌سازی تمام پرونده‌های منبع در قالب zip و ارسال به خروجی استاندارد. به‌طور پیش‌فرض، پرونده‌ها به‌صورت خودکار توسط debuginfod (در صورت امکان) یا به‌صورت محلی به‌عنوان پشتیبان واکشی می‌شوند. هر پرونده منبعی که پیدا نشود بایگانی نخواهد شد.

مثال‌ها (EXAMPLES)

فهرست کردن تمام پرونده‌های منبع برای یک باینری.


eu-srcfiles -e /bin/ls

فهرست کردن تمام نام‌های واحدهای کامپایل (CU) برای یک فرایند مشخص (شامل کتابخانه‌های اشتراکی).


eu-srcfiles -c -p $$

فهرست کردن پرونده‌های منبع یک باینری بر اساس buildid آن، با استفاده از debuginfod.


binary=`debuginfod-find executable 9c22d8d9e42bd051ffdc1064fdfd456ba781c629`
eu-srcfiles -c -e $binary

نمایش کد منبع اولین CU از یک کتابخانه اشتراکی.


binary=/usr/lib64/libc.so.6
srcfile=`eu-srcfiles -c -e $binary | head -1`
cat `debuginfod-find source $binary $srcfile`

فهرست کردن پرونده‌های منبع یک ایمیج هسته.


eu-srcfiles -e /boot/vmlinuz-`uname -r`

فشرده‌سازی تمام پرونده‌های منبع برای یک باینری در قالب zip.


eu-srcfiles -z -e /bin/ls > ls.zip

نویسندگان (AUTHORS)

نوشته‌شده توسط Housam Alamour.

گزارش باگ‌ها (REPORTING BUGS)

لطفاً باگ‌ها را در https://sourceware.org/bugzilla گزارش دهید.

کپی‌رایت (COPYRIGHT)

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