'\" t
.\" Copyright (c) 2004, 2013, Oracle and/or its affiliates. All rights reserved.
.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
.\"
.\" This code is free software; you can redistribute it and/or modify it
.\" under the terms of the GNU General Public License version 2 only, as
.\" published by the Free Software Foundation.
.\"
.\" This code is distributed in the hope that it will be useful, but WITHOUT
.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
.\" FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
.\" version 2 for more details (a copy is included in the LICENSE file that
.\" accompanied this code).
.\"
.\" You should have received a copy of the GNU General Public License version
.\" 2 along with this work; if not, write to the Free Software Foundation,
.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
.\"
.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
.\" or visit www.oracle.com if you need additional information or have any
.\" questions.
.\"
.\"     Arch: generic
.\"     Software: JDK 8
.\"     Date: 21 November 2013
.\"     SectDesc: Troubleshooting Tools
.\"     Title: jmap.1
.\"
.if n .pl 99999
.TH jmap 1 "21 November 2013" "JDK 8" "Troubleshooting Tools"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------

.SH "نام (NAME)"
jmap \- نگاشت حافظه و تهیه گزارش تفصیلی از Heap ماشین مجازی جاوا (JVM) (نسخه ۱۱)
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf

\fBjmap\fR [ \fIoptions\fR ] \fIpid\fR
.fi
.nf

\fBjmap\fR [ \fIoptions\fR ] \fIexecutable\fR \fIcore\fR
.fi
.nf

\fBjmap\fR [ \fIoptions\fR ] [ \fIpid\fR ] \fIserver\-id\fR@ ] \fIremote\-hostname\-or\-IP\fR
.fi
.sp
.TP
\fIoptions\fR
گزینه‌های خط فرمان\&. بخش «گزینه‌ها» را ببینید\&.
.TP
\fIpid\fR
شناسه فرایند (PID) که باید نگاشت حافظه آن چاپ شود\&. این فرایند باید یک فرایند جاوا باشد\&. برای دریافت فهرست فرایندهای جاوای در حال اجرا روی سیستم، از دستور jps(1) استفاده کنید\&.
.TP
\fIexecutable\fR
فایل اجرایی جاوا که فایل Core Dump توسط آن ایجاد شده است\&.
.TP
\fIcore\fR
فایل Core که باید نگاشت حافظه آن چاپ شود\&.
.TP
\fIremote-hostname-or-IP\fR
نام میزبان (\f3hostname\fR) یا نشانی \f3IP\fR سرور اشکال‌زدایی از راه دور\&. راهنمای jsadebugd(1) را ببینید\&.
.TP
\fIserver-id\fR
شناسه یکتای اختیاری برای زمانی که چندین سرور اشکال‌زدایی روی یک میزبان راه دور در حال اجرا هستند\&.
.SH "توضیحات (DESCRIPTION)"
دستور \f3jmap\fR نگاشت‌های حافظه اشیاء اشتراکی یا جزئیات حافظه Heap را برای یک فرایند مشخص، فایل Core، یا سرور اشکال‌زدایی راه دور چاپ می‌کند\&. اگر فرایند مشخص‌شده روی یک ماشین مجازی جاوای ۶۴ بیتی (JVM) اجرا می‌شود، ممکن است نیاز به تعیین گزینه \f3-J-d64\fR داشته باشید، برای مثال: \f3jmap -J-d64 -heap pid\fR\&.
.PP
\fIنکته:\fR این ابزار آزمایشی و پشتیبانی‌نشده است و ممکن است در نسخه‌های بعدی JDK در دسترس نباشد\&. در سیستم‌های ویندوزی که فایل \f3dbgeng\&.dll\fR وجود ندارد، باید Debugging Tools For Windows نصب شود تا این ابزارها کار کنند\&. متغیر محیطی \f3PATH\fR باید حاوی مسیر فایل \f3jvm\&.dll\fR باشد که توسط فرایند هدف استفاده می‌شود یا مسیری که فایل Crash Dump از آنجا ایجاد شده است، برای مثال: \f3set PATH=%JDK_HOME%\ejre\ebin\eclient;%PATH%\fR\&.
.SH "گزینه‌ها (OPTIONS)"
.TP
<no option>
هنگامی که هیچ گزینه‌ای استفاده نشود، دستور \f3jmap\fR نگاشت‌های اشیاء اشتراکی را چاپ می‌کند\&. برای هر شیء اشتراکی بارگذاری‌شده در JVM هدف، نشانی شروع، اندازه نگاشت و مسیر کامل فایل شیء اشتراکی چاپ می‌شود\&. این رفتار مشابه ابزار \f3pmap\fR در Oracle Solaris است\&.
.TP
-dump:[live,] format=b, file=\fIfilename\fR
.br
حافظه Heap جاوا را با فرمت باینری \f3hprof\fR در فایل \fIfilename\fR ذخیره (Dump) می‌کند\&. زیرگزینه \f3live\fR اختیاری است، اما در صورت تعیین آن، فقط اشیاء فعال در Heap ذخیره می‌شوند\&. برای بررسی فایل Heap Dump تولیدشده، می‌توانید از دستور jhat(1) برای خواندن فایل استفاده کنید\&.
.TP
-finalizerinfo
.br
اطلاعات مربوط به اشیایی را که در انتظار Finalization هستند چاپ می‌کند\&.
.TP
-heap
.br
خلاصه‌ای از وضعیت Heap شامل الگوریتم زباله‌روب (GC) مورداستفاده، پیکربندی Heap و میزان مصرف حافظه Heap به تفکیک نسل‌ها را چاپ می‌کند\&. علاوه بر این، تعداد و اندازه رشته‌های Intern‌شده (Interned Strings) چاپ می‌شود\&.
.TP
-histo[:live]
.br
نمودار هیستوگرام Heap را چاپ می‌کند\&. برای هر کلاس جاوا، تعداد اشیاء، اندازه حافظه به بایت و نام کامل کلاس (Fully Qualified Class Name) چاپ می‌شود\&. نام کلاس‌های داخلی JVM با پیشوند ستاره (*) چاپ می‌شوند\&. در صورت تعیین زیرگزینه \f3live\fR، فقط اشیاء فعال شمارش می‌شوند\&.
.TP
-clstats
.br
آمار بارگذار کلاس (Class Loader) مربوط به Heap جاوا را چاپ می‌کند\&. برای هر بارگذار کلاس، نام، میزان فعالیت، نشانی حافظه، بارگذار کلاس والد و تعداد و اندازه کلاس‌های بارگذاری‌شده توسط آن چاپ می‌شود\&.
.TP
-F
.br
اجبار (Force)\&. زمانی که شناسه فرایند (PID) پاسخ نمی‌دهد، از این گزینه به همراه گزینه \f3jmap -dump\fR یا \f3jmap -histo\fR استفاده کنید\&. زیرگزینه \f3live\fR در این حالت پشتیبانی نمی‌شود\&.
.TP
-h
.br
پیام راهنما را چاپ می‌کند\&.
.TP
-help
.br
پیام راهنما را چاپ می‌کند\&.
.TP
-J\fIflag\fR
.br
پرچم \f3flag\fR را به ماشین مجازی جاوایی که دستور \f3jmap\fR در آن اجرا می‌شود ارسال می‌کند\&.
.SH "همچنین ببینید (SEE ALSO)"
.TP 0.2i
\(bu
jhat(1)
.TP 0.2i
\(bu
jps(1)
.TP 0.2i
\(bu
jsadebugd(1)
.RE
.br
'pl 8.5i
'bp