.TH mprof-report 1
.SH "نام (NAME)"
mprof\-report \- تحلیل و تولید گزارش از داده‌های پروفایلر لاگ Mono
.SH "خلاصه دستور (SYNOPSIS)"
\fBmprof\-report\fR [\fIگزینه‌ها\fR]... \fIfile.mlpd\fR
.SH "توضیحات (DESCRIPTION)"
\fBmprof\-report\fR ابزار تولید گزارش برای پروفایلر \fBlog\fR
مربوط به Mono است. این ابزار فایل‌های لاگ MLPD ایجادشده توسط پروفایلر لاگ را می‌خواند
و بر اساس گزینه‌های داده‌شده، گزارشی تولید می‌کند.
خروجی بر پایه گزارش‌های جداگانه است که می‌توان آن‌ها را فعال یا غیرفعال کرد.
به‌طور پیش‌فرض، همه گزارش‌ها در قالب خلاصه (یعنی خروجی غیرمشروح) تولید می‌شوند.
.PP
دستور \fBmprof\-report\fR می‌تواند هر دو نوع فایل لاگ عادی و فشرده‌شده با \fBgzip\fR(1)
را به‌صورت شفاف بخواند.
.PP
برای اطلاعات درباره نحوه استفاده از پروفایلر لاگ همراه با یک برنامه،
صفحه \fBmono\-profilers\fR(1) و بخش \fBLOG PROFILER\fR را ببینید.
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های زیر در دسترس هستند:
.TP
\fB\-\-help\fR
دستورالعمل‌های استفاده را نمایش می‌دهد.
.TP
\fB\-\-out\fR=\fIfile\fR
خروجی گزارش را به‌جای خروجی استاندارد، در \fIfile\fR می‌نویسد.
.TP
\fB\-\-traces\fR
ردیابی پشته (backtrace) را در صورت موجود بودن در گزارش‌ها نشان می‌دهد.
.TP
\fB\-\-maxframes\fR=\fInum\fR
ردیابی پشته را به \fInum\fR فریم محدود می‌کند.
.TP
\fB\-\-reports\fR=\fIreports\fR
فقط گزارش‌های مشخص‌شده را تولید می‌کند. \fIreports\fR فهرستی از
گزارش‌ها است که با کاما از هم جدا شده‌اند. بخش \fBگزارش‌ها (REPORTS)\fR را ببینید.
.TP
\fB\-\-method\-sort\fR=\fImode\fR
متدها را بر اساس \fImode\fR مرتب می‌کند که می‌تواند یکی از موارد زیر باشد:
.RS
.TP
\fBtotal\fR (پیش‌فرض)
مرتب‌سازی بر اساس کل زمان صرف‌شده در یک متد و فراخوانی‌شدگان آن.
.TP
\fBself\fR
مرتب‌سازی بر اساس زمان صرف‌شده فقط در داخل خود متد.
.TP
\fBcalls\fR
مرتب‌سازی بر اساس تعداد کل فراخوانی‌های انجام‌شده به یک متد.
.RE
.TP
\fB\-\-alloc\-sort\fR=\fImode\fR
تخصیص‌ها را بر اساس \fImode\fR مرتب می‌کند که می‌تواند یکی از موارد زیر باشد:
.RS
.TP
\fBbytes\fR (پیش‌فرض)
مرتب‌سازی بر اساس مقدار بایت‌های حافظه هیپ (heap) اشغال‌شده توسط تمام اشیای تخصیص‌یافته از یک نوع.
.TP
\fBcount\fR
مرتب‌سازی بر اساس تعداد کل تخصیص‌های یک نوع.
.RE
.TP
\fB\-\-counters\-sort\fR=\fImode\fR
شمارنده‌ها را بر اساس \fImode\fR مرتب می‌کند. این گزینه نحوه ارائه گزارش
\fBcounters\fR را تغییر می‌دهد و می‌تواند یکی از موارد زیر باشد:
.RS
.TP
\fBtime\fR (پیش‌فرض)
ارائه فهرستی از نمونه‌ها، که هر کدام شامل فهرستی از جفت‌های نام-مقدار شمارنده است.
.TP
\fBcategory\fR
ارائه فهرستی از نام‌های شمارنده، که هر کدام شامل فهرستی از مقادیر نمونه‌برداری‌شده است.
.RE
.IP
این گزینه هیچ تأثیری ندارد مگر اینکه \fB\-\-verbose\fR داده شده باشد.
.TP
\fB\-\-track\fR=\fIobjects\fR
ردیابی رویدادهای مربوط به اشیای مشخص‌شده. \fIobjects\fR فهرستی از
آدرس‌های اشیا است که با کاما از هم جدا شده‌اند.
.TP
\fB\-\-find\fR=\fIspec\fR
یافتن و ردیابی رویدادهای مربوط به اشیای منطبق با \fIspec\fR، که
می‌تواند یکی از این قالب‌ها را داشته باشد:
.RS
.TP
\fBS\fR:\fIminimum_size\fR
جستجوی اشیایی که اندازه آن‌ها حداقل \fIminimum_size\fR بایت باشد.
.TP
\fBT\fR:\fIname_fragment\fR
جستجوی اشیایی که نام نوع آن‌ها شامل \fIname_fragment\fR باشد.
.RE
.IP
می‌توان با دوبار دادن این گزینه، هم مشخصه \fBS\fR و هم مشخصه \fBT\fR را تعیین کرد.
.TP
\fB\-\-thread\fR=\fItid\fR
فقط رویدادهای مربوط به رشته (thread) با شناسه \fItid\fR را در نظر می‌گیرد.
.TP
\fB\-\-time\fR=\fIspan\fR
فقط رویدادهای رخ‌داده در بازه زمانی مشخص‌شده را در نظر می‌گیرد. \fIspan\fR
باید به فرمت \fIfrom\fR\-\fIto\fR باشد که در آن \fIfrom\fR و
\fIto\fR ثانیه‌های سپری‌شده از زمان شروع برنامه هستند.
.TP
\fB\-\-verbose\fR
چاپ خروجی با جزئیات کامل.
.TP
\fB\-\-debug\fR
چاپ خروجی بسیار دقیق خطایابی. بیشتر کاربران نباید از این گزینه استفاده کنند.
.SH "گزارش‌ها (REPORTS)"
گزارش‌های زیر در دسترس هستند:
.TP
\fBheader\fR
اطلاعات راه‌اندازی برنامه، نسخه پروفایلر و وضعیت عملیاتی.
.TP
\fBjit\fR
آمار کامپایلر درجا (JIT).
.TP
\fBgc\fR
آمار جمع‌آوری زباله (GC) و هندل‌ها.
.TP
\fBsample\fR
پروفایل نمونه‌برداری آماری ساده.
.TP
\fBalloc\fR
آمار تخصیص GC به تفکیک کلاس و ردیابی پشته.
.TP
\fBcall\fR
آمار فراخوانی متدها و ردیابی پشته.
.TP
\fBmetadata\fR
تصاویر (images) و اسمبلی‌های بارگذاری‌شده.
.TP
\fBexception\fR
آمار استثناها و ردیابی پشته.
.TP
\fBmonitor\fR
آمار قفل‌های مانیتور و ردیابی پشته.
.TP
\fBthread\fR
نام رشته‌های مدیریت‌شده.
.TP
\fBdomain\fR
دامنه‌های کاربردی (AppDomain) بارگذاری‌شده.
.TP
\fBcontext\fR
زمینه‌های ریموتینگ (remoting contexts) بارگذاری‌شده.
.TP
\fBheapshot\fR
اطلاعات عکس‌های لحظه‌ای از حافظه هیپ (heap snapshot).
.TP
\fBcounters\fR
نمونه‌های شمارنده‌های کارایی (performance counters).
.SH "همچنین ببینید (SEE ALSO)"
\fBmono\fR(1), \fBmono\-profilers\fR(1)