.\" Automatically generated by Pandoc 3.10.2
.\"
.TH "JHSDB" "1" "2026" "JDK 26.0.2.1" "JDK Commands"
.SH "نام (NAME)"
jhsdb \- اتصال به یک فرایند جاوا یا راه‌اندازی اشکال‌زدا برای تحلیل core dump ناشی از کرش ماشین مجازی جاوا (JVM)
.SH "خلاصه دستور (SYNOPSIS)"
\f[B]هشدار:\f[R] زیرفرمان \f[CR]debugd\f[R] و
گزینه‌های \f[CR]\-\-connect\f[R] منسوخ شده‌اند.
آن‌ها در نسخه‌های آینده حذف خواهند شد.
.PP
\f[CR]jhsdb\f[R] \f[CR]clhsdb\f[R] [\f[CR]\-\-pid\f[R] \f[I]pid\f[R] |
\f[CR]\-\-exe\f[R] \f[I]executable\f[R] \f[CR]\-\-core\f[R]
\f[I]coredump\f[R]]
.PP
\f[CR]jhsdb\f[R] \f[CR]hsdb\f[R] [\f[CR]\-\-pid\f[R] \f[I]pid\f[R] |
\f[CR]\-\-exe\f[R] \f[I]executable\f[R] \f[CR]\-\-core\f[R]
\f[I]coredump\f[R]]
.PP
\f[CR]jhsdb\f[R] \f[CR]debugd\f[R] (\f[CR]\-\-pid\f[R] \f[I]pid\f[R] |
\f[CR]\-\-exe\f[R] \f[I]executable\f[R] \f[CR]\-\-core\f[R]
\f[I]coredump\f[R]) [\f[I]options\f[R]]
.PP
\f[CR]jhsdb\f[R] \f[CR]jstack\f[R] (\f[CR]\-\-pid\f[R] \f[I]pid\f[R] |
\f[CR]\-\-exe\f[R] \f[I]executable\f[R] \f[CR]\-\-core\f[R]
\f[I]coredump\f[R] | \f[CR]\-\-connect\f[R]
\f[I][server\-id\(at]debugd\-host\f[R]) [\f[I]options\f[R]]
.PP
\f[CR]jhsdb\f[R] \f[CR]jmap\f[R] (\f[CR]\-\-pid\f[R] \f[I]pid\f[R] |
\f[CR]\-\-exe\f[R] \f[I]executable\f[R] \f[CR]\-\-core\f[R]
\f[I]coredump\f[R] | \f[CR]\-\-connect\f[R]
\f[I][server\-id\(at]debugd\-host\f[R]) [\f[I]options\f[R]]
.PP
\f[CR]jhsdb\f[R] \f[CR]jinfo\f[R] (\f[CR]\-\-pid\f[R] \f[I]pid\f[R] |
\f[CR]\-\-exe\f[R] \f[I]executable\f[R] \f[CR]\-\-core\f[R]
\f[I]coredump\f[R] | \f[CR]\-\-connect\f[R]
\f[I][server\-id\(at]debugd\-host\f[R]) [\f[I]options\f[R]]
.PP
\f[CR]jhsdb\f[R] \f[CR]jsnap\f[R] (\f[CR]\-\-pid\f[R] \f[I]pid\f[R] |
\f[CR]\-\-exe\f[R] \f[I]executable\f[R] \f[CR]\-\-core\f[R]
\f[I]coredump\f[R] | \f[CR]\-\-connect\f[R]
\f[I][server\-id\(at]debugd\-host\f[R]) [\f[I]options\f[R]]
.TP
\f[I]pid\f[R]
شناسه فرایندی که ابزار \f[CR]jhsdb\f[R] باید به آن متصل شود.
فرایند موردنظر باید یک فرایند جاوا باشد.
جهت دریافت فهرست فرایندهای جاوای در حال اجرا روی یک سیستم، از دستور
\f[CR]ps\f[R] یا، در صورتی که فرایندهای JVM در نمونه مجزای docker اجرا نمی‌شوند، از دستور \f[B]jps\f[R] استفاده کنید.
.TP
\f[I]executable\f[R]
فایل اجرایی جاوایی که core dump از آن تولید شده است.
.TP
\f[I]coredump\f[R]
فایل core که ابزار \f[CR]jhsdb\f[R] باید به آن متصل شود.
.TP
\f[I][server\-id\(at]debugd\-host\f[R]
شناسه سرور اختیاری و نشانی سرور اشکال‌زدایی از راه دور (debugd).
.TP
\f[I]options\f[R]
گزینه‌های خط فرمان برای یک حالت \f[CR]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[CR]debugd\f[R]، \f[CR]jstack\f[R]، \f[CR]jmap\f[R]،
\f[CR]jinfo\f[R] و \f[CR]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)"
می‌توانید از ابزار \f[CR]jhsdb\f[R] برای اتصال به یک فرایند جاوا یا راه‌اندازی یک اشکال‌زدای پس از خرابی (postmortem debugger) جهت تحلیل محتوای core dump ناشی از کرش یک ماشین مجازی جاوا (JVM) استفاده کنید.
این دستور آزمایشی بوده و پشتیبانی نمی‌شود.
.PP
\f[B]نکته:\f[R]
.PP
اتصال ابزار \f[CR]jhsdb\f[R] به یک فرایند در حال اجرا، موجب متوقف شدن آن فرایند می‌شود و احتمالاً با جدا شدن (detach) اشکال‌زدا، فرایند کرش خواهد کرد.
.PP
ابزار \f[CR]jhsdb\f[R] می‌تواند در هر یک از حالت‌های زیر اجرا شود:
.TP
\f[CR]jhsdb clhsdb\f[R]
اشکال‌زدای تعاملی خط فرمان را اجرا می‌کند.
.TP
\f[CR]jhsdb hsdb\f[R]
اشکال‌زدای تعاملی گرافیکی (GUI) را اجرا می‌کند.
.TP
\f[CR]jhsdb debugd\f[R]
سرور اشکال‌زدایی از راه دور را اجرا می‌کند.
.TP
\f[CR]jhsdb jstack\f[R]
اطلاعات پشته (stack) و قفل‌ها را چاپ می‌کند.
.TP
\f[CR]jhsdb jmap\f[R]
اطلاعات حافظه هیپ (heap) را چاپ می‌کند.
.TP
\f[CR]jhsdb jinfo\f[R]
اطلاعات پایه‌ای JVM را چاپ می‌کند.
.TP
\f[CR]jhsdb jsnap\f[R]
اطلاعات شمارنده‌های عملکرد (performance counters) را چاپ می‌کند.
.TP
\f[CR]jhsdb\f[R] \f[I]command\f[R] \f[CR]\-\-help\f[R]
گزینه‌های موجود برای دستور \f[I]command\f[R] را نمایش می‌دهد.
.SH "گزینه‌های حالت DEBUGD (OPTIONS FOR THE DEBUGD MODE)"
.TP
\f[CR]\-\-serverid\f[R] \f[I]server\-id\f[R]
یک شناسه یکتای اختیاری برای این سرور اشکال‌زدایی.
در صورتی که چندین سرور اشکال‌زدایی روی یک سیستم اجرا شوند، مشخص کردن این گزینه الزامی است.
.TP
\f[CR]\-\-rmiport\f[R] \f[I]port\f[R]
شماره پورتی که رابط RMI به آن متصل (bind) می‌شود را تعیین می‌کند.
در صورت عدم تعیین، از یک پورت تصادفیِ آزاد استفاده می‌شود.
.TP
\f[CR]\-\-registryport\f[R] \f[I]port\f[R]
پورت رجیستری RMI را تعیین می‌کند.
این گزینه مقدار مشخصه سیستمی
\(aqsun.jvm.hotspot.rmi.port\(aq را بازنویسی می‌کند.
در صورت عدم تعیین، از مشخصه سیستمی استفاده می‌شود.
اگر مشخصه سیستمی تنظیم نشده باشد، پورت پیش‌فرض 1099 استفاده خواهد شد.
.TP
\f[CR]\-\-hostname\f[R] \f[I]hostname\f[R]
نام میزبان یا نشانی شبکه‌ای که رابط RMI به آن متصل می‌شود را تعیین می‌کند.
این مقدار می‌تواند یک hostname یا یک نشانی IPv4/IPv6 باشد.
این گزینه مقدار مشخصه سیستمی
\(aqjava.rmi.server.hostname\(aq را بازنویسی می‌کند.
در صورت عدم تعیین، از مشخصه سیستمی استفاده می‌شود.
اگر مشخصه سیستمی تنظیم نشده باشد، از hostname سیستم استفاده خواهد شد.
.SH "گزینه‌های حالت JINFO (OPTIONS FOR THE JINFO MODE)"
.TP
\f[CR]\-\-flags\f[R]
پرچم‌های VM را چاپ می‌کند.
.TP
\f[CR]\-\-sysprops\f[R]
مشخصه‌های سیستمی جاوا را چاپ می‌کند.
.TP
بدون گزینه
پرچم‌های VM و مشخصه‌های سیستمی جاوا را چاپ می‌کند.
.SH "گزینه‌های حالت JMAP (OPTIONS FOR THE JMAP MODE)"
.TP
بدون گزینه
اطلاعاتی مشابه با دستور \f[CR]pmap\f[R] در Solaris را چاپ می‌کند.
.TP
\f[CR]\-\-heap\f[R]
خلاصه‌ای از وضعیت هیپ \f[CR]java\f[R] را چاپ می‌کند.
.TP
\f[CR]\-\-binaryheap\f[R]
هیپ \f[CR]java\f[R] را در قالب باینری \f[CR]hprof\f[R] ذخیره (dump) می‌کند.
.TP
\f[CR]\-\-dumpfile\f[R] \f[I]name\f[R]
نام فایل dump.
.TP
\f[CR]\-\-histo\f[R]
هیستوگرام اشیاء هیپ \f[CR]java\f[R] را چاپ می‌کند.
.TP
\f[CR]\-\-clstats\f[R]
آمار بارگذار کلاس (class loader) را چاپ می‌کند.
.TP
\f[CR]\-\-finalizerinfo\f[R]
اطلاعات اشیاء در انتظار نهایی‌سازی (finalization) را چاپ می‌کند.
.SH "گزینه‌های حالت JSTACK (OPTIONS FOR THE JSTACK MODE)"
.TP
\f[CR]\-\-locks\f[R]
اطلاعات قفل‌های \f[CR]java.util.concurrent\f[R] را چاپ می‌کند.
.TP
\f[CR]\-\-mixed\f[R]
در صورت پشتیبانی پلتفرم، تلاش می‌کند هم فریم‌های \f[CR]java\f[R] و هم فریم‌های بومی (native) را چاپ کند.
.SH "گزینه‌های حالت JSNAP (OPTIONS FOR THE JSNAP MODE)"
.TP
\f[CR]\-\-all\f[R]
تمام شمارنده‌های عملکرد را چاپ می‌کند.