نام (NAME)

mlprof - نمایش اطلاعات پروفایلینگ برای فایل اجرایی کامپایل‌شده با MLton

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

mlprof [option ...] a.out [mlmon.out ...]

توضیحات (DESCRIPTION)

ابزار mlprof اطلاعات را از یک فایل اجرایی کامپایل‌شده توسط MLton با -profile alloc یا -profile time و فایل mlmon.out حاصل از اجرای آن فایل اجرایی، استخراج می‌کند.

خروجی mlprof شامل یک خط ابتدایی است که میزان کل زمان CPU یا بایت‌های تخصیص‌یافته را مشخص می‌کند. پس از آن، توابع مبدأ به همراه درصد استفاده‌شان از این مقدار کل، به ترتیب نزولی فهرست می‌شوند. اگر برنامه با -profile-stack true کامپایل شده باشد، mlprof علاوه بر زمان یا بایت‌هایی که تابع مستقیماً مسئول آن‌هاست، زمان سپری‌شده یا بایت‌های تخصیص‌یافته در حین حضور تابع در پشته و در GC را نیز نمایش می‌دهد.

در صورت ارائهٔ چندین فایل mlmon.out، mlprof اطلاعات پروفایلینگ آن‌ها را با یکدیگر جمع می‌زند.

گزینه‌ها (OPTIONS)

-call-graph file: یک گراف فراخوانی (call graph) حاوی داده‌های جدول را در یک فایل dot می‌نویسد. برای جزئیات بیشتر به MLton User Guide مراجعه کنید.
-graph-title string: عنوان گراف فراخوانی را تعیین می‌کند.
-gray {false|true}: گره‌های گراف فراخوانی را بر اساس درصد پشته، خاکستری می‌کند. این گزینه تنها در صورتی معنا دارد که فایل اجرایی با -profile-stack true کامپایل شده باشد.
-keep exp: تنها توابعی را نمایش می‌دهد که توسط exp مشخص شده‌اند. برای جزئیات دربارهٔ عبارت‌های مجاز، به MLton User Guide مراجعه کنید. استفاده از چندین عبارت -keep مجاز نیست.
-mlmon file: فهرستی از فایل‌های mlmon.out جداشده با نویسه‌های فاصله‌ساز (whitespace) را که در فایل مشخص‌شده قرار دارند، پردازش می‌کند.
-raw {false|true}: شمارش‌های خام را علاوه بر درصدها نمایش می‌دهد.
-show-line {false|true}: فایل و شماره خط مربوط به هر تابع را نمایش می‌دهد.
-split regexp: با نسخه‌های تکراری توابعی که نامشان با regexp مطابقت دارد، مانند توابع مجزا رفتار می‌کند.
-thresh x: مختصری برای -keep '(thresh x)' است که تنها اطلاعات توابعی را چاپ می‌کند که درصد آن‌ها بزرگتر یا مساوی با x باشد؛ به‌طوری‌که 0 <= x <= 100.0 است.
-tolerant {false|true}: در مورد فایل‌های خراب mlmon.out هشدار چاپ می‌کند، اما از برنامه خارج نمی‌شود.

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

mlton(1) و MLton Guide.