.TH mlprof 1 "December 30, 2024"
.SH "نام (NAME)"
\fBmlprof\fP \- نمایش اطلاعات پروفایلینگ برای فایل اجرایی کامپایل‌شده با MLton
.SH "خلاصه دستور (SYNOPSIS)"
\fBmlprof \fI[option ...] a.out [mlmon.out ...]\fR
.SH "توضیحات (DESCRIPTION)"
.PP
ابزار \fBmlprof\fP اطلاعات را از یک فایل اجرایی کامپایل‌شده توسط
\fBMLton\fP با \fB-profile alloc\fP یا \fB-profile time\fP و فایل
\fBmlmon.out\fP حاصل از اجرای آن فایل اجرایی، استخراج می‌کند.

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

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

.SH "گزینه‌ها (OPTIONS)"
.TP
\fB-call-graph \fIfile\fP
یک گراف فراخوانی (call graph) حاوی داده‌های جدول را در یک فایل dot می‌نویسد.
برای جزئیات بیشتر به \fBMLton User Guide\fP مراجعه کنید.
.TP
\fB-graph-title \fIstring\fP
عنوان گراف فراخوانی را تعیین می‌کند.
.TP
\fB-gray \fI{\fBfalse\fP|\fBtrue\fP}\fP
گره‌های گراف فراخوانی را بر اساس درصد پشته، خاکستری می‌کند. این گزینه
تنها در صورتی معنا دارد که فایل اجرایی با \fB-profile-stack true\fP
کامپایل شده باشد.
.TP
\fB-keep \fIexp\fP
تنها توابعی را نمایش می‌دهد که توسط \fIexp\fP مشخص شده‌اند. برای جزئیات
دربارهٔ عبارت‌های مجاز، به \fBMLton User Guide\fP مراجعه کنید. استفاده از
چندین عبارت \fB-keep\fP مجاز نیست.
.TP
\fB-mlmon \fIfile\fP
فهرستی از فایل‌های \fBmlmon.out\fP جداشده با نویسه‌های فاصله‌ساز
(whitespace) را که در فایل مشخص‌شده قرار دارند، پردازش می‌کند.
.TP
\fB-raw \fI{\fBfalse\fP|\fBtrue\fP}\fP
شمارش‌های خام را علاوه بر درصدها نمایش می‌دهد.
.TP
\fB-show-line \fI{\fBfalse\fP|\fBtrue\fP}\fP
فایل و شماره خط مربوط به هر تابع را نمایش می‌دهد.
.TP
\fB-split \fIregexp\fP
با نسخه‌های تکراری توابعی که نامشان با \fIregexp\fP مطابقت دارد، مانند
توابع مجزا رفتار می‌کند.
.TP
\fB-thresh \fIx\fP
مختصری برای \fB-keep '(thresh x)'\fP است که تنها اطلاعات توابعی را چاپ
می‌کند که درصد آن‌ها بزرگتر یا مساوی با \fBx\fP باشد؛ به‌طوری‌که
0 <= \fBx\fP <= 100.0 است.
.TP
\fB-tolerant \fI{\fBfalse\fP|\fBtrue\fP}\fP
در مورد فایل‌های خراب \fBmlmon.out\fP هشدار چاپ می‌کند، اما از برنامه
خارج نمی‌شود.
.SH "همچنین ببینید (SEE ALSO)"
.BR mlton (1)
و \fBMLton Guide\fP.