.\" Automatically generated by Pandoc 3.10.2
.\"
.TH "JMAP" "1" "2026" "JDK 26.0.2.1" "JDK Commands"
.SH "نام (NAME)"
jmap \- چاپ جزئیات و اطلاعات حافظه یک فرایند مشخص جاوا
.SH "خلاصه دستور (SYNOPSIS)"
\f[B]نکته:\f[R] این دستور آزمایشی است و پشتیبانی نمی‌شود.
.PP
\f[CR]jmap\f[R] [\f[I]گزینه‌ها\f[R]] \f[I]pid\f[R]
.TP
\f[I]گزینه‌ها\f[R]
نشان‌دهنده گزینه‌های خط فرمان \f[CR]jmap\f[R] است.
بخش \f[B]گزینه‌های دستور jmap\f[R] را ببینید.
.TP
\f[I]pid\f[R]
شناسه فرایند (PID) که اطلاعات مشخص‌شده توسط \f[I]گزینه‌ها\f[R] باید برای آن چاپ شود.
این فرایند باید یک فرایند جاوا باشد.
برای دریافت فهرستی از فرایندهای جاوای در حال اجرا روی سیستم، از دستور \f[CR]ps\f[R] یا چنانچه فرایندهای JVM در یک نمونه داکر جداگانه اجرا نمی‌شوند، از دستور \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) حافظه هیپ جاوا را چاپ می‌کند.
.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]
به یک فرایند در حال اجرا متصل می‌شود و هیستوگرام اشیاء حافظه هیپ جاوا را چاپ می‌کند.
اگر زیرگزینه \f[CR]live\f[R] مشخص شود، فقط اشیاء زنده شمرده می‌شوند.
.TP
\f[CR]\-dump:\f[R]\f[I]dump_options\f[R] \f[I]pid\f[R]
به یک فرایند در حال اجرا متصل می‌شود و از حافظه هیپ جاوا نسخه پشتیبان (dump) تهیه می‌کند.
گزینه‌های \f[I]dump_options\f[R] شامل موارد زیر است:
.RS
.IP \(bu 2
\f[CR]live\f[R] \-\-\- در صورت تعیین، تنها از اشیاء زنده دامپ می‌گیرد؛ در صورت عدم تعیین، از تمام اشیاء موجود در هیپ دامپ گرفته می‌شود.
.IP \(bu 2
\f[CR]format=b\f[R] \-\-\- از هیپ جاوا در قالب باینری \f[CR]hprof\f[R] دامپ تهیه می‌کند.
.IP \(bu 2
\f[CR]file=\f[R]\f[I]filename\f[R] \-\-\- دامپ هیپ را در فایل \f[I]filename\f[R] ذخیره می‌کند.
مثال: \f[CR]jmap \-dump:live,format=b,file=heap.bin\f[R]
\f[I]pid\f[R]
.RE