'\" t
.\" Copyright (c) 2006, 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: jhat.1
.\"
.if n .pl 99999
.TH jhat 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)"
jhat \- هیپ جاوا را تحلیل می‌کند؛ این دستور آزمایشی است و پشتیبانی نمی‌شود\&.
.SH "خلاصه دستور (SYNOPSIS)"
.sp     
.nf     

\fBjhat\fR [ \fIoptions\fR ] \fIheap\-dump\-file\fR 
.fi     
.sp     
.TP     
\fIoptions\fR
گزینه‌های خط فرمان\&. گزینه‌ها را ببینید\&.
.TP     
\fIheap-dump-file\fR
فایل باینری دامپ هیپ جاوا برای مرور\&. برای فایل دامپی که شامل چندین دامپ هیپ است، می‌توانید با افزودن \f3#<number>\fR به انتهای نام فایل، دامپ مورد نظر در فایل را مشخص کنید؛ برای نمونه: \f3myfile\&.hprof#3\fR\&.
.SH "توضیحات (DESCRIPTION)"
دستور \f3jhat\fR یک فایل دامپ هیپ جاوا را تجزیه کرده و یک وب‌سرور را راه‌اندازی می‌کند\&. دستور \f3jhat\fR به شما امکان می‌دهد دامپ‌های هیپ را با مرورگر وب دلخواه خود مرور کنید\&. دستور \f3jhat\fR از پرس‌وجوهای از پیش طراحی‌شده مانند نمایش تمام نمونه‌های یک کلاس مشخص \f3MyClass\fR، و همچنین Object Query Language (OQL) پشتیبانی می‌کند\&. زبان OQL مشابه SQL است، اما برای پرس‌وجو از دامپ‌های هیپ کاربرد دارد\&. راهنمای OQL در صفحه راهنمای OQL که توسط دستور \f3jhat\fR ارائه می‌شود در دسترس است\&. با درگاه پیش‌فرض، راهنمای OQL در آدرس http://localhost:7000/oqlhelp در دسترس است\&.
.PP
چندین روش برای تولید دامپ هیپ جاوا وجود دارد:
.TP 0.2i    
\(bu
استفاده از گزینه \f3jmap -dump\fR برای دریافت دامپ هیپ در زمان اجرا\&. به jmap(1) مراجعه کنید\&.
.TP 0.2i    
\(bu
استفاده از گزینه \f3jconsole\fR برای دریافت دامپ هیپ از طریق \f3HotSpotDiagnosticMXBean\fR در زمان اجرا\&. به jconsole(1) و توضیحات رابط \f3HotSpotDiagnosticMXBean\fR در http://docs\&.oracle\&.com/javase/8/docs/jre/api/management/extension/com/sun/management/HotSpotDiagnosticMXBean\&.html مراجعه کنید\&.
.TP 0.2i    
\(bu
تولید دامپ هیپ هنگام پرتاب خطای \f3OutOfMemoryError\fR با تعیین گزینه \f3-XX:+HeapDumpOnOutOfMemoryError\fR در ماشین مجازی جاوا (JVM)\&.
.TP 0.2i    
\(bu
استفاده از دستور \f3hprof\fR\&. به HPROF: A Heap/CPU Profiling Tool در http://docs\&.oracle\&.com/javase/8/docs/technotes/samples/hprof\&.html مراجعه کنید\&.
.SH "گزینه‌ها (OPTIONS)"
.TP
-stack false|true
.br
ردیابی پشته فراخوانیِ تخصیص شیء را خاموش می‌کند\&. اگر اطلاعات محل تخصیص در دامپ هیپ موجود نباشد، باید این پرچم را روی \f3false\fR تنظیم کنید\&. مقدار پیش‌فرض \f3true\fR است\&.
.TP
-refs false|true
.br
ردیابی ارجاعات به اشیاء را خاموش می‌کند\&. مقدار پیش‌فرض \f3true\fR است\&. به‌طور پیش‌فرض، اشاره‌گرهای معکوس (اشیاء اشاره‌کننده به یک شیء مشخص مانند ارجاع‌دهنده‌ها یا ارجاعات ورودی) برای تمام اشیاء موجود در هیپ محاسبه می‌شوند\&.
.TP
-port \fIport-number\fR
.br
درگاه سرور HTTP مربوط به \f3jhat\fR را تنظیم می‌کند\&. مقدار پیش‌فرض 7000 است\&.
.TP
-exclude \fIexclude-file\fR
.br
فایلی را مشخص می‌کند که اعضای داده‌ایِ مورد نظر برای مستثنی شدن از پرس‌وجوی اشیاء در دسترس را فهرست کرده است\&. برای نمونه، اگر در فایل عبارت \f3java\&.lang\&.String\&.value\fR فهرست شده باشد، هر زمان که فهرست اشیاء در دسترس از یک شیء مشخص \f3o\fR محاسبه شود، مسیرهای ارجاعی شامل فیلد \f3java\&.lang\&.String\&.value\fR نادیده گرفته می‌شوند\&.
.TP
-baseline \fIexclude-file\fR
.br
یک دامپ هیپ پایه (baseline) را مشخص می‌کند\&. اشیایی در هر دو دامپ هیپ که دارای شناسه شیء یکسانی هستند، به عنوان غیرجدید علامت‌گذاری می‌شوند\&. سایر اشیاء به عنوان جدید علامت می‌خورند\&. این گزینه برای مقایسه دو دامپ هیپ مختلف مفید است\&.
.TP
-debug \fIint\fR
.br
سطح اشکال‌زدایی را برای این ابزار تنظیم می‌کند\&. مقدار 0 به معنای عدم تولید خروجی اشکال‌زدایی است\&. مقادیر بالاتر را برای حالت‌های پرگوتر تنظیم کنید\&.
.TP
-version
.br
شماره نگارش انتشار را گزارش داده و خارج می‌شود\&.
.TP
-h
.br
پیام راهنما را نمایش داده و خارج می‌شود\&.
.TP
-help
.br
پیام راهنما را نمایش داده و خارج می‌شود\&.
.TP
-J\fIflag\fR
.br
پرچم \f3flag\fR را به ماشین مجازی جاوا که دستور \f3jhat\fR روی آن اجرا می‌شود ارسال می‌کند\&. برای نمونه، \f3-J-Xmx512m\fR برای استفاده از حداکثر اندازه هیپ ۵۱۲ مگابایت\&.
.SH "همچنین ببینید (SEE ALSO)"
.TP 0.2i    
\(bu
jmap(1)
.TP 0.2i    
\(bu
jconsole(1)
.TP 0.2i    
\(bu
HPROF: A Heap/CPU Profiling Tool در http://docs\&.oracle\&.com/javase/8/docs/technotes/samples/hprof\&.html
.RE
.br
'pl 8.5i
'bp