.\" Copyright (c) 2019, 2020, 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.
.\"
.\" Automatically generated by Pandoc 2.19.2
.\"
.\" Define V font for inline verbatim, using C font in formats
.\" that render this, and otherwise B font.
.ie "\f[CB]x\f[R]"x" \{\
. ftr V B
. ftr VI BI
. ftr VB B
. ftr VBI BI
.\}
.el \{\
. ftr V CR
. ftr VI CI
. ftr VB CB
. ftr VBI CBI
.\}
.TH "JHSDB" "1" "2023" "JDK 21" "JDK Commands"
.hy
.SH "نام (NAME)"
.PP
jhsdb-openjdk21 \- ابزار دیباگر و تحلیل‌گر وضعیت HotSpot جاوا در OpenJDK 21
.SH "خلاصه دستور (SYNOPSIS)"
.PP
\f[V]jhsdb\f[R] \f[V]clhsdb\f[R] [\f[V]--pid\f[R] \f[I]pid\f[R] |
\f[V]--exe\f[R] \f[I]executable\f[R] \f[V]--core\f[R]
\f[I]coredump\f[R]]
.PP
\f[V]jhsdb\f[R] \f[V]hsdb\f[R] [\f[V]--pid\f[R] \f[I]pid\f[R] |
\f[V]--exe\f[R] \f[I]executable\f[R] \f[V]--core\f[R]
\f[I]coredump\f[R]]
.PP
\f[V]jhsdb\f[R] \f[V]debugd\f[R] (\f[V]--pid\f[R] \f[I]pid\f[R] |
\f[V]--exe\f[R] \f[I]executable\f[R] \f[V]--core\f[R]
\f[I]coredump\f[R]) [\f[I]گزینه‌ها\f[R]]
.PP
\f[V]jhsdb\f[R] \f[V]jstack\f[R] (\f[V]--pid\f[R] \f[I]pid\f[R] |
\f[V]--exe\f[R] \f[I]executable\f[R] \f[V]--core\f[R] \f[I]coredump\f[R]
| \f[V]--connect\f[R] \f[I][server-id\[at]]debugd-host\f[R])
[\f[I]گزینه‌ها\f[R]]
.PP
\f[V]jhsdb\f[R] \f[V]jmap\f[R] (\f[V]--pid\f[R] \f[I]pid\f[R] |
\f[V]--exe\f[R] \f[I]executable\f[R] \f[V]--core\f[R] \f[I]coredump\f[R]
| \f[V]--connect\f[R] \f[I][server-id\[at]]debugd-host\f[R])
[\f[I]گزینه‌ها\f[R]]
.PP
\f[V]jhsdb\f[R] \f[V]jinfo\f[R] (\f[V]--pid\f[R] \f[I]pid\f[R] |
\f[V]--exe\f[R] \f[I]executable\f[R] \f[V]--core\f[R] \f[I]coredump\f[R]
| \f[V]--connect\f[R] \f[I][server-id\[at]]debugd-host\f[R])
[\f[I]گزینه‌ها\f[R]]
.PP
\f[V]jhsdb\f[R] \f[V]jsnap\f[R] (\f[V]--pid\f[R] \f[I]pid\f[R] |
\f[V]--exe\f[R] \f[I]executable\f[R] \f[V]--core\f[R] \f[I]coredump\f[R]
| \f[V]--connect\f[R] \f[I][server-id\[at]]debugd-host\f[R])
[\f[I]گزینه‌ها\f[R]]
.TP
\f[I]pid\f[R]
شناسه فرآیندی که ابزار \f[V]jhsdb\f[R] باید به آن متصل شود.
فرآیند باید یک فرآیند جاوا باشد.
برای دریافت فهرستی از فرآیندهای جاوای در حال اجرا روی سیستم، از دستور
\f[V]ps\f[R] یا چنانچه فرآیندهای JVM در نمونه داکر مجزا اجرا نمی‌شوند، از دستور \f[B]jps\f[R] استفاده کنید.
.TP
\f[I]executable\f[R]
فایل اجرایی جاوا که core dump از آن تولید شده است.
.TP
\f[I]coredump\f[R]
فایل core که ابزار \f[V]jhsdb\f[R] باید به آن متصل شود.
.TP
\f[I][server-id\[at]]debugd-host\f[R]
یک شناسه سرور اختیاری و نشانی سرور دیباگ از راه دور (debugd).
.TP
\f[I]گزینه‌ها\f[R]
گزینه‌های خط فرمان برای یک حالت \f[V]jhsdb\f[R].
به بخش‌های \f[B]گزینه‌های حالت debugd\f[R]، \f[B]گزینه‌های حالت jstack\f[R]، \f[B]گزینه‌های حالت jmap\f[R]، \f[B]گزینه‌های حالت jinfo\f[R] و \f[B]گزینه‌های حالت jsnap\f[R] مراجعه کنید.
.PP
\f[B]نکته:\f[R]
.PP
برای حالت‌های \f[V]debugd\f[R]، \f[V]jstack\f[R]، \f[V]jmap\f[R]، \f[V]jinfo\f[R] و \f[V]jsnap\f[R] باید یا \f[I]pid\f[R] یا جفت فایل‌های \f[I]executable\f[R] و \f[I]core\f[R] یا \f[I][server-id\[at]]debugd-host\f[R] مشخص شوند.
.SH "توضیحات (DESCRIPTION)"
.PP
می‌توانید از ابزار \f[V]jhsdb\f[R] برای اتصال به یک فرآیند جاوا یا راه‌اندازی یک دیباگر پس از مرگ (postmortem) جهت تحلیل محتوای core dump ناشی از کرش ماشین مجازی جاوا (JVM) استفاده کنید.
این دستور آزمایشی بوده و رسماً پشتیبانی نمی‌شود.
.PP
\f[B]نکته:\f[R]
.PP
اتصال ابزار \f[V]jhsdb\f[R] به یک فرآیند زنده باعث معلق شدن (hang) فرآیند می‌شود و با جدا شدن دیباگر، احتمالاً فرآیند کرش خواهد کرد.
.PP
ابزار \f[V]jhsdb\f[R] می‌تواند در هر یک از حالت‌های زیر اجرا شود:
.TP
\f[V]jhsdb clhsdb\f[R]
دیباگر تعاملی خط فرمان را اجرا می‌کند.
.TP
\f[V]jhsdb hsdb\f[R]
دیباگر تعاملی گرافیکی (GUI) را اجرا می‌کند.
.TP
\f[V]jhsdb debugd\f[R]
سرور دیباگ از راه دور را اجرا می‌کند.
.TP
\f[V]jhsdb jstack\f[R]
اطلاعات پشته (stack) و قفل‌ها را چاپ می‌کند.
.TP
\f[V]jhsdb jmap\f[R]
اطلاعات هیپ (heap) را چاپ می‌کند.
.TP
\f[V]jhsdb jinfo\f[R]
اطلاعات پایه JVM را چاپ می‌کند.
.TP
\f[V]jhsdb jsnap\f[R]
اطلاعات شمارنده‌های کارایی (performance counters) را چاپ می‌کند.
.TP
\f[V]jhsdb\f[R] \f[I]command\f[R] \f[V]--help\f[R]
گزینه‌های موجود برای \f[I]command\f[R] مورد نظر را نمایش می‌دهد.
.SH "گزینه‌های حالت DEBUGD (OPTIONS FOR THE DEBUGD MODE)"
.TP
\f[V]--serverid\f[R] \f[I]server-id\f[R]
یک شناسه یکتای اختیاری برای این سرور دیباگ.
در صورتی که چند سرور دیباگ روی یک سیستم اجرا شوند، این گزینه الزامی است.
.TP
\f[V]--rmiport\f[R] \f[I]port\f[R]
شماره پورتی که اتصال RMI به آن متصل می‌شود را تنظیم می‌کند.
در صورت عدم تعیین، از یک پورت تصادفی در دسترس استفاده می‌شود.
.TP
\f[V]--registryport\f[R] \f[I]port\f[R]
پورت رجیستری RMI را تنظیم می‌کند.
این گزینه ویژگی سیستمی
\[aq]sun.jvm.hotspot.rmi.port\[aq]
را بازنویسی می‌کند.
در صورت عدم تعیین، از ویژگی سیستمی استفاده می‌شود.
اگر ویژگی سیستمی تنظیم نشده باشد، پورت پیش‌فرض 1099 به کار می‌رود.
.TP
\f[V]--hostname\f[R] \f[I]hostname\f[R]
نام هاستی که رابط RMI به آن متصل می‌شود را تنظیم می‌کند.
مقدار می‌تواند یک نام هاست یا نشانی IPv4/IPv6 باشد.
این گزینه ویژگی سیستمی
\[aq]java.rmi.server.hostname\[aq]
را بازنویسی می‌کند.
در صورت عدم تعیین، از ویژگی سیستمی استفاده می‌شود.
اگر ویژگی سیستمی تنظیم نشده باشد، نام هاست سیستم به کار می‌رود.
.SH "گزینه‌های حالت JINFO (OPTIONS FOR THE JINFO MODE)"
.TP
\f[V]--flags\f[R]
فلگ‌های VM را چاپ می‌کند.
.TP
\f[V]--sysprops\f[R]
ویژگی‌های سیستمی جاوا را چاپ می‌کند.
.TP
بدون گزینه
فلگ‌های VM و ویژگی‌های سیستمی جاوا را چاپ می‌کند.
.SH "گزینه‌های حالت JMAP (OPTIONS FOR THE JMAP MODE)"
.TP
بدون گزینه
اطلاعاتی مشابه با \f[V]pmap\f[R] در سولاریس را چاپ می‌کند.
.TP
\f[V]--heap\f[R]
خلاصه‌ای از وضعیت هیپ \f[V]java\f[R] را چاپ می‌کند.
.TP
\f[V]--binaryheap\f[R]
هیپ \f[V]java\f[R] را با قالب باینری \f[V]hprof\f[R] ذخیره (dump) می‌کند.
.TP
\f[V]--dumpfile\f[R] \f[I]name\f[R]
نام فایل خروجی ذخیره‌سازی (dumpfile).
.TP
\f[V]--histo\f[R]
هیستوگرام اشیاء هیپ \f[V]java\f[R] را چاپ می‌کند.
.TP
\f[V]--clstats\f[R]
آمار بارگذار کلاس (class loader) را چاپ می‌کند.
.TP
\f[V]--finalizerinfo\f[R]
اطلاعات اشیاء در انتظار نهایی‌سازی (finalization) را چاپ می‌کند.
.SH "گزینه‌های حالت JSTACK (OPTIONS FOR THE JSTACK MODE)"
.TP
\f[V]--locks\f[R]
اطلاعات قفل‌های \f[V]java.util.concurrent\f[R] را چاپ می‌کند.
.TP
\f[V]--mixed\f[R]
در صورت پشتیبانی پلتفرم، تلاش می‌کند هم فریم‌های \f[V]java\f[R] و هم فریم‌های محلی (native) را چاپ کند.
.SH "گزینه‌های حالت JSNAP (OPTIONS FOR THE JSNAP MODE)"
.TP
\f[V]--all\f[R]
تمام شمارنده‌های کارایی را چاپ می‌کند.