'\" 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 را برای یک فرآیند، فایل core یا کارساز اشکال‌زدایی دوردست چاپ می‌کند\&. این دستور آزمایشی است و پشتیبانی نمی‌شود\&.
.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) که نگاشت حافظه آن باید چاپ شود\&. این فرآیند باید یک فرآیند Java باشد\&. برای دریافت فهرست فرآیندهای Java در حال اجرا روی سامانه، از دستور jps(1) استفاده کنید\&.
.TP     
\fIexecutable\fR
فایل اجرایی Java که روگرفت حافظه (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\fR\f3-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 در \f3filename\fR ذخیره می‌کند\&. زیرگزینه \f3live\fR اختیاری است، اما اگر مشخص شود، تنها اشیاء فعال موجود در heap ذخیره می‌شوند\&. برای بررسی و کاوش روگرفت heap، می‌توانید از دستور jhat(1) برای خواندن فایل تولیدشده استفاده کنید\&.
.TP
-finalizerinfo
.br
اطلاعات مربوط به اشیائی را که در انتظار نهایی‌سازی (finalization) هستند چاپ می‌کند\&.
.TP
-heap
.br
خلاصه‌ای از heap شامل زباله‌روب (garbage collection) استفاده‌شده، پیکربندی heap و میزان مصرف heap به تفکیک نسل را چاپ می‌کند\&. افزون بر این، تعداد و اندازه رشته‌های intern شده (interned Strings) چاپ می‌شود\&.
.TP
-histo[:live]
.br
یک هیستوگرام از حافظه heap چاپ می‌کند\&. برای هر کلاس جاوا، تعداد اشیاء، اندازه حافظه به بایت و نام کامل و رسمی کلاس‌ها (fully qualified class names) چاپ می‌شوند\&. نام کلاس‌های داخلی JVM با پیشوند ستاره (*) چاپ می‌شوند\&. اگر زیرگزینه \f3live\fR مشخص شود، تنها اشیاء فعال شمارش می‌شوند\&.
.TP
-clstats
.br
آمار حافظه heap جاوا را به تفکیک بارگذار کلاس (class loader) چاپ می‌کند\&. برای هر بارگذار کلاس، نام آن، میزان فعال بودن، نشانی، بارگذار کلاس والد و تعداد و اندازه کلاس‌های بارگذاری‌شده توسط آن چاپ می‌شود\&.
.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