.\" Automatically generated by Pandoc 3.10.2
.\"
.TH "JMAP" "1" "2026" "JDK 25.0.4.1" "JDK Commands"
.SH "نام (NAME)"
jmap \- چاپ جزئیات یک فرایند مشخص‌شده
.SH "خلاصه دستور (SYNOPSIS)"
\f[B]نکته:\f[R] این دستور آزمایشی است و پشتیبانی نمی‌شود.
.PP
\f[CR]jmap\f[R] [\f[I]options\f[R]] \f[I]pid\f[R]
.TP
\f[I]options\f[R]
نمایانگر گزینه‌های خط فرمان \f[CR]jmap\f[R] است.
بخش \f[B]گزینه‌های دستور JMAP\f[R] را ببینید.
.TP
\f[I]pid\f[R]
شناسه فرایندی (PID) که اطلاعات مشخص‌شده توسط \f[I]options\f[R] باید برای آن چاپ شود.
این فرایند باید یک فرایند جاوا باشد.
برای دریافت فهرستی از فرایندهای جاوای در حال اجرا روی یک ماشین، از دستور \f[CR]ps\f[R] یا، در صورتی که فرایندهای JVM در یک نمونه مجزای docker اجرا نمی‌شوند، از دستور \f[B]jps\f[R] استفاده کنید.
.SH "توضیحات (DESCRIPTION)"
دستور \f[CR]jmap\f[R] جزئیات یک فرایند در حال اجرای مشخص‌شده را چاپ می‌کند.
.PP
\f[B]نکته:\f[R]
.PP
این دستور پشتیبانی نمی‌شود و ممکن است در نسخه‌های آینده JDK در دسترس نباشد.
در سیستم‌های ویندوز که در آن‌ها فایل \f[CR]dbgeng.dll\f[R] وجود ندارد، برای کارکرد این ابزارها باید Debugging Tools for Windows نصب شود.
متغیر محیطی \f[CR]PATH\f[R] باید حاوی مسیر فایل \f[CR]jvm.dll\f[R] باشد که توسط فرایند هدف استفاده می‌شود یا مسیری که فایل core dump از آن تولید شده است.
.SH "گزینه‌های دستور JMAP (OPTIONS FOR THE JMAP COMMAND)"
.TP
\f[CR]\-clstats\f[R] \f[I]pid\f[R]
به یک فرایند در حال اجرا متصل می‌شود و آمار بارگذار کلاس (class loader) در heap جاوا را چاپ می‌کند.
.TP
\f[CR]\-finalizerinfo\f[R] \f[I]pid\f[R]
به یک فرایند در حال اجرا متصل می‌شود و اطلاعات اشیاء در انتظار نهایی‌سازی (finalization) را چاپ می‌کند.
.TP
\f[CR]\-histo\f[R][\f[CR]:live\f[R]] \f[I]pid\f[R]
به یک فرایند در حال اجرا متصل می‌شود و یک هیستوگرام از heap اشیاء جاوا را چاپ می‌کند.
اگر زیرگزینه \f[CR]live\f[R] مشخص شده باشد، تنها اشیاء زنده شمرده می‌شوند.
.TP
\f[CR]\-dump:\f[R]\f[I]dump_options\f[R] \f[I]pid\f[R]
به یک فرایند در حال اجرا متصل می‌شود و از heap جاوا نسخه خروجی (dump) تهیه می‌کند.
گزینه‌های \f[I]dump_options\f[R] عبارتند از:
.RS
.IP \(bu 2
\f[CR]live\f[R] \-\-\- در صورت تعیین، تنها از اشیاء زنده خروجی (dump) می‌گیرد؛ اگر تعیین نشود، از تمام اشیاء موجود در heap خروجی گرفته می‌شود.
.IP \(bu 2
\f[CR]format=b\f[R] \-\-\- از heap جاوا در قالب دودویی (binary) \f[CR]hprof\f[R] خروجی (dump) می‌گیرد
.IP \(bu 2
\f[CR]file=\f[R]\f[I]filename\f[R] \-\-\- خروجی heap را در فایل \f[I]filename\f[R] ذخیره می‌کند
مثال: \f[CR]jmap \-dump:live,format=b,file=heap.bin\f[R]
\f[I]pid\f[R]
.RE