JMAP(1)                           دستورات JDK                          JMAP(1)

نام (NAME)
       jmap - چاپ جزئیات و نقشه حافظه هیپ یک فرایند جاوا در OpenJDK 17

خلاصه دستور (SYNOPSIS)
       نکته: این دستور آزمایشی است و پشتیبانی نمی‌شود.

       jmap [options] pid

       options
              گزینه‌های خط فرمان jmap را مشخص می‌کند.  بخش گزینه‌های دستور JMAP
              را ببینید.

       pid    شناسه فرایند که اطلاعات مشخص‌شده توسط options باید برای آن چاپ
              شود.  فرایند باید یک فرایند جاوا باشد.  برای دریافت فهرستی از
              فرایندهای جاوا در حال اجرا روی سیستم، از دستور ps یا اگر
              فرایندهای JVM در کانتینر داکر جداگانه اجرا نمی‌شوند از دستور jps
              استفاده کنید.

توضیحات (DESCRIPTION)
       دستور jmap جزئیات یک فرایند در حال اجرای مشخص را چاپ می‌کند.

       نکته:

       این دستور پشتیبانی نمی‌شود و ممکن است در نسخه‌های آینده JDK در دسترس
       نباشد.  در سیستم‌های ویندوزی که فایل dbgeng.dll وجود ندارد، ابزارهای
       اشکال‌زدایی ویندوز (Debugging Tools for Windows) باید نصب شوند تا این
       ابزارها کار کنند.  متغیر محیطی PATH باید شامل مکان فایل jvm.dll مورد
       استفاده توسط فرایند هدف یا مکانی باشد که فایل رونوشت خرابی (core dump)
       از آن تولید شده است.

گزینه‌های دستور JMAP (OPTIONS FOR THE JMAP COMMAND)
       -clstats pid
              به یک فرایند در حال اجرا متصل می‌شود و آمار بارگذار کلاس (class
              loader) حافظه هیپ جاوا را چاپ می‌کند.

       -finalizerinfo pid
              به یک فرایند در حال اجرا متصل می‌شود و اطلاعات اشیای در انتظار
              نهایی‌سازی (finalization) را چاپ می‌کند.

       -histo[:live] pid
              به یک فرایند در حال اجرا متصل می‌شود و یک هیستوگرام از حافظه هیپ
              اشیای جاوا چاپ می‌کند.  اگر زیرگزینه live مشخص شده باشد، تنها
              اشیای زنده شمرده می‌شوند.

       -dump:dump_options pid
              به یک فرایند در حال اجرا متصل می‌شود و از حافظه هیپ جاوا یک
              رونوشت (dump) تهیه می‌کند.  گزینه‌های dump_options شامل موارد زیر
              است:

              • live --- در صورت تعیین، فقط اشیای زنده را دامپ می‌کند؛ در غیر
                این صورت، تمام اشیای موجود در هیپ دامپ می‌شوند.

              • format=b --- حافظه هیپ جاوا را در قالب باینری hprof ذخیره
                می‌کند

              • file=filename --- هیپ را در فایل filename ذخیره می‌کند

              مثال: jmap -dump:live,format=b,file=heap.bin pid

JDK 17                               2021                              JMAP(1)