نام (NAME)

eu-stackprof - پروفایلینگ پشته پشتهای و ردیابی ردپای اجرای برنامهها

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

eu-stackprof [-v|-vv|...] [--gmon] [-o DEST] [OPTION]... [-- CMD...]

توضیحات (DESCRIPTION)

eu-stackprof داده‌های پروفایلینگ پشته را از perf_events لینوکس جمع‌آوری می‌کند، چه در سراسر سیستم در میان تمامی فرایندها یا به‌صورت هدفمند برای یک فرایند خاص (یک PID موجود از طریق -p یا فرایند تازه‌راه‌اندازی‌شده از طریق آرگومان‌های خط فرمان ارائه‌شده) و تمام فرایندهای فرزندی که از آن مشتق می‌شوند. برای دسترسی به رابط perf_events، چه به‌صورت سراسری و چه برای یک فرایند هدفمند خاص، مجوزهای مناسب مورد نیاز است؛ برای خلاصه‌ای از نیازمندی‌های مجوز به بخش «Arguments» در perf_event_open(2) مراجعه کنید.

هنگامی که از گزینه --gmon استفاده می‌شود، نتایج در قالب پرونده‌های gmon.out با فرمت gprof(1) ذخیره می‌شوند. این پرونده‌ها برای جمع‌آوری آمار با profiledb کاربرد دارند.

هنگامی که از گزینه --gmon استفاده نمی‌شود، eu-stackprof آمار پایه درباره داده‌های پروفایلینگ را جمع‌آوری کرده و در خطای استاندارد چاپ می‌کند.

گزینهها (OPTIONS)

-e EVENT, --event=EVENT

پیکربندی نمونه‌برداری perf_events بر اساس مشخصات رویداد libpfm ارائه‌شده (برای نمونه perf::CPU-CLOCK:freq=1000).

--event-list

فهرست کردن رویدادهای موجود libpfm و خروج.

-f, --force

اگر پوشه خروجی برای --gmon از قبل حاوی پرونده‌هایی باشد که با build-idهای مشاهده‌شده شناسایی می‌شوند، آن‌ها را با داده‌های تازه جمع‌آوری‌شده بازنویسی می‌کند.

-g, --gmon

خروجی دادن هیستوگرام‌های شمارنده برنامه و نمودارهای فراخوانی برای هر شیء اجرایی باینری مشاهده‌شده در طول پروفایلینگ در قالب gmon.out متعلق به gprof(1).

-G METHOD, --hist-split=METHOD

تعیین روش مورد استفاده برای تقسیم فضای آدرس به هیستوگرام‌ها برای خروجی --gmon. مقدار METHOD باید یکی از موارد زیر باشد:

-?, --help

چاپ فهرست کوتاهی از گزینه‌ها.

-n MAXFRAMES, --maxframes=MAXFRAMES

حد بالایی بر روی تعداد فریم‌هایی که برای هر نمونه پشته ردگیری و بازگشایی می‌شوند. در صورت فعال بودن --gmon مقدار پیشفرض 1 است، زیرا فریم‌های بیشتر فراتر از فریم نخست برای تولید هیستوگرام gprof و داده‌های یال نمودار فراخوانی نیاز نیستند؛ در غیر این صورت مقدار پیشفرض 256 است.

-o DEST, --output=DEST

پوشه‌ای که هنگام فعال بودن خروجی --gmon نتایج در آن نوشته می‌شوند. پیشفرض، دایرکتوری جاری است.

-p PID, --pid=PID

محدود کردن پروفایلینگ به فرایند PID و فرزندان آتی آن.

-v, --verbose

خروجی دادن اطلاعات بیشتر. می‌تواند یک یا چند بار برای افزایش سطح جزئیات مشخص شود، با ثبت هر باینری جدید، هر نمونه پشته، یا هر فریم.

-V, --version

چاپ نسخه برنامه.

قالب خروجی (OUTPUT FORMAT)

هنگامی که خروجی --gmon فعال باشد، eu-stackprof پرونده‌های زیر را برای هر شیء اجرایی مشاهده‌شده در میان فرایندهای پروفایل‌شده، که با build-id شناسایی می‌شوند، تولید می‌کند:

gmon.BUILDID.exe

پیوند نمادین (symlink) به شیء اجرایی مشاهده‌شده توسط ابزار پروفایلینگ.

gmon.BUILDID.out

شامل یک هیستوگرام از شمارنده‌های برنامه و یک جدول از یال‌های نمودار فراخوانی (مشاهده‌شده از ۲ فریم بالایی ردگیری پشته). با همان قالبی که توسط زیرساخت gprof تولید شده و توسط gprof(1) خوانده می‌شود.

gmon.BUILDID.json

متاداده در قالب JSON، شامل مسیر شیء اجرایی و اطلاعات رویداد libpfm.

مثال‌ها (EXAMPLES)

پروفایلینگ در سراسر سیستم؛ نوشتن پرونده‌های gmon.out در پوشه جاری:

sudo eu-stackprof --gmon

پروفایلینگ PID 1211 و فرزندان منشعب‌شده از آن؛ ثبت یک خط به ازای هر نمونه پشته؛ نوشتن پرونده‌های gmon.out در پوشه results/ و جایگزینی پرونده‌های موجود با همان build-id:

sudo eu-stackprof -vv --gmon -o results/ -p 1211 --force

به همین ترتیب، اجرای vim و پروفایلینگ آن:

sudo eu-stackprof --gmon -o results/ --force -- vim test.txt

پروفایلینگ در سراسر سیستم؛ ثبت یک خط به ازای هر فریم پشته:

sudo eu-stackprof -vvv

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

گزارش اشکالات به <elfutils-devel@sourceware.org> یا https://sourceware.org/bugzilla.

همچنین ببینید (SEE ALSO)

gprof(1), perf_event_open(2)