.\" Automatically generated by Pandoc 3.10.2
.\"
.TH "JHSDB" "1" "2026" "JDK 25.0.4.1" "JDK Commands"
.SH "نام (NAME)"
jhsdb \- اتصال به یک فرایند Java یا راه‌اندازی یک اشکال‌زدا برای تحلیل محتوای 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]
شناسه فرایند (Process ID) که ابزار \f[CR]jhsdb\f[R] باید به آن متصل شود.
فرایند باید یک فرایند Java باشد.
برای دریافت فهرستی از فرایندهای Java در حال اجرا روی یک ماشین، از دستور
\f[CR]ps\f[R] یا، در صورتی که فرایندهای JVM در یک نمونه مجزای docker اجرا نمی‌شوند، از دستور \f[B]jps\f[R] استفاده کنید.
.TP
\f[I]executable\f[R]
فایل اجرایی Java که 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 (OPTIONS FOR THE DEBUGD MODE)\f[R]، \f[B]گزینه‌های حالت JSTACK (OPTIONS FOR THE JSTACK MODE)\f[R]، \f[B]گزینه‌های حالت JMAP (OPTIONS FOR THE JMAP MODE)\f[R]، \f[B]گزینه‌های حالت JINFO (OPTIONS FOR THE JINFO MODE)\f[R] و \f[B]گزینه‌های حالت JSNAP (OPTIONS FOR THE JSNAP MODE)\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] برای اتصال به یک فرایند Java یا راه‌اندازی
یک اشکال‌زدا برای تحلیل محتوای یک core dump حاصل از کرش یک ماشین مجازی جاوا (JVM)
استفاده کنید.
این دستور آزمایشی بوده و پشتیبانی نمی‌شود.
.PP
\f[B]نکته:\f[R]
.PP
اتصال ابزار \f[CR]jhsdb\f[R] به یک فرایند زنده (live) باعث متوقف و معلق شدن
فرایند شده و به احتمال زیاد هنگام جدا شدن (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]
نام میزبانی (hostname) که اتصال‌دهنده RMI به آن متصل می‌شود را تنظیم می‌کند.
این مقدار می‌تواند یک نام میزبان یا یک نشانی IPv4/IPv6 باشد.
این گزینه مقدار ویژگی سیستمی
\(aqjava.rmi.server.hostname\(aq
را بازنویسی می‌کند.
اگر تعیین نشود، از ویژگی سیستمی استفاده می‌شود.
اگر ویژگی سیستمی تنظیم نشده باشد، از نام میزبان سیستم استفاده خواهد شد.
.SH "گزینه‌های حالت JINFO (OPTIONS FOR THE JINFO MODE)"
.TP
\f[CR]\-\-flags\f[R]
فلگ‌های VM را چاپ می‌کند.
.TP
\f[CR]\-\-sysprops\f[R]
ویژگی‌های سیستمی Java را چاپ می‌کند.
.TP
بدون گزینه (no option)
فلگ‌های VM و ویژگی‌های سیستمی Java را چاپ می‌کند.
.SH "گزینه‌های حالت JMAP (OPTIONS FOR THE JMAP MODE)"
.TP
بدون گزینه (no option)
اطلاعات مشابه با دستور \f[CR]pmap\f[R] در Solaris را چاپ می‌کند.
.TP
\f[CR]\-\-heap\f[R]
خلاصه وضعیت \f[CR]java\f[R] heap را چاپ می‌کند.
.TP
\f[CR]\-\-binaryheap\f[R]
از \f[CR]java\f[R] heap در قالب باینری \f[CR]hprof\f[R] خروجی dump می‌گیرد.
.TP
\f[CR]\-\-dumpfile\f[R] \f[I]name\f[R]
نام فایل dumpfile.
.TP
\f[CR]\-\-histo\f[R]
هیستوگرام اشیاء \f[CR]java\f[R] در heap را چاپ می‌کند.
.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]
تمام شمارنده‌های کارایی را چاپ می‌کند.