JHSDB(1)                         JDK Commands                         JHSDB(1)

نام (NAME)
       jhsdb - اتصال به یک فرایند Java یا راه‌اندازی یک اشکال‌زدا برای تحلیل
       محتوای core dump ناشی از کرش ماشین مجازی جاوا (JVM)

خلاصه دستور (SYNOPSIS)
       هشدار: زیرفرمان debugd و گزینه‌های --connect منسوخ شده‌اند.  آن‌ها در
       نسخه‌های آتی حذف خواهند شد.

       jhsdb clhsdb [--pid pid | --exe executable --core coredump]

       jhsdb hsdb [--pid pid | --exe executable --core coredump]

       jhsdb debugd (--pid pid | --exe executable --core coredump) [options]

       jhsdb jstack (--pid pid | --exe executable --core coredump | --connect
       [server-id@]debugd-host) [options]

       jhsdb jmap (--pid pid | --exe executable --core coredump | --connect
       [server-id@]debugd-host) [options]

       jhsdb jinfo (--pid pid | --exe executable --core coredump | --connect
       [server-id@]debugd-host) [options]

       jhsdb jsnap (--pid pid | --exe executable --core coredump | --connect
       [server-id@]debugd-host) [options]

       pid    شناسه فرایند (Process ID) که ابزار jhsdb باید به آن متصل شود.
              فرایند باید یک فرایند Java باشد.  برای دریافت فهرستی از
              فرایندهای Java در حال اجرا روی یک ماشین، از دستور ps یا، در
              صورتی که فرایندهای JVM در یک نمونه مجزای docker اجرا نمی‌شوند، از
              دستور jps استفاده کنید.

       executable
              فایل اجرایی Java که core dump از آن تولید شده است.

       coredump
              فایل core که ابزار jhsdb باید به آن متصل شود.

       [server-id@]debugd-host
              شناسه اختیاری سرور و نشانی سرور اشکال‌زدایی از راه دور (debugd).

       options
              گزینه‌های خط فرمان برای یک حالت jhsdb.  بخش‌های گزینه‌های حالت
              DEBUGD (OPTIONS FOR THE DEBUGD MODE)، گزینه‌های حالت JSTACK
              (OPTIONS FOR THE JSTACK MODE)، گزینه‌های حالت JMAP (OPTIONS FOR
              THE JMAP MODE)، گزینه‌های حالت JINFO (OPTIONS FOR THE JINFO MODE)
              و گزینه‌های حالت JSNAP (OPTIONS FOR THE JSNAP MODE) را ببینید.

       نکته:

       برای حالت‌های debugd، jstack، jmap، jinfo و jsnap، باید یا pid، یا جفت
       فایل‌های executable و core، و یا [server-id@]debugd-host مشخص شوند.

توضیحات (DESCRIPTION)
       می‌توانید از ابزار jhsdb برای اتصال به یک فرایند Java یا راه‌اندازی یک
       اشکال‌زدا برای تحلیل محتوای یک core dump حاصل از کرش یک ماشین مجازی جاوا
       (JVM) استفاده کنید.  این دستور آزمایشی بوده و پشتیبانی نمی‌شود.

       نکته:

       اتصال ابزار jhsdb به یک فرایند زنده (live) باعث متوقف و معلق شدن فرایند
       شده و به احتمال زیاد هنگام جدا شدن (detach) اشکال‌زدا، فرایند کرش خواهد
       کرد.

       ابزار jhsdb می‌تواند در هر یک از حالت‌های زیر اجرا شود:

       jhsdb clhsdb
              اشکال‌زدای تعاملی خط فرمان را اجرا می‌کند.

       jhsdb hsdb
              اشکال‌زدای تعاملی با رابط گرافیکی (GUI) را اجرا می‌کند.

       jhsdb debugd
              سرور اشکال‌زدایی از راه دور را اجرا می‌کند.

       jhsdb jstack
              اطلاعات پشته (stack) و قفل‌ها را چاپ می‌کند.

       jhsdb jmap
              اطلاعات heap را چاپ می‌کند.

       jhsdb jinfo
              اطلاعات پایه‌ای JVM را چاپ می‌کند.

       jhsdb jsnap
              اطلاعات شمارنده‌های کارایی (performance counters) را چاپ می‌کند.

       jhsdb command --help
              گزینه‌های در دسترس برای command را نمایش می‌دهد.

گزینه‌های حالت DEBUGD (OPTIONS FOR THE DEBUGD MODE)
       --serverid server-id
              شناسه یکتا و اختیاری برای این سرور اشکال‌زدایی.  در صورتی که
              چندین سرور اشکال‌زدایی روی یک ماشین اجرا شوند، استفاده از این
              گزینه الزامی است.

       --rmiport port
              شماره پورتی که اتصال‌دهنده RMI به آن متصل (bind) می‌شود را تنظیم
              می‌کند.  در صورت عدم تعیین، از یک پورت آزاد تصادفی استفاده می‌شود.

       --registryport port
              پورت رجیستری RMI را تنظیم می‌کند.  این گزینه مقدار ویژگی سیستمی
              'sun.jvm.hotspot.rmi.port' را بازنویسی می‌کند.  اگر تعیین نشود،
              از ویژگی سیستمی استفاده می‌شود.  اگر ویژگی سیستمی تنظیم نشده
              باشد، پورت پیش‌فرض 1099 به کار می‌رود.

       --hostname hostname
              نام میزبانی (hostname) که اتصال‌دهنده RMI به آن متصل می‌شود را
              تنظیم می‌کند.  این مقدار می‌تواند یک نام میزبان یا یک نشانی
              IPv4/IPv6 باشد.  این گزینه مقدار ویژگی سیستمی
              'java.rmi.server.hostname' را بازنویسی می‌کند.  اگر تعیین نشود،
              از ویژگی سیستمی استفاده می‌شود.  اگر ویژگی سیستمی تنظیم نشده
              باشد، از نام میزبان سیستم استفاده خواهد شد.

گزینه‌های حالت JINFO (OPTIONS FOR THE JINFO MODE)
       --flags
              فلگ‌های VM را چاپ می‌کند.

       --sysprops
              ویژگی‌های سیستمی Java را چاپ می‌کند.

       بدون گزینه (no option)
              فلگ‌های VM و ویژگی‌های سیستمی Java را چاپ می‌کند.

گزینه‌های حالت JMAP (OPTIONS FOR THE JMAP MODE)
       بدون گزینه (no option)
              اطلاعات مشابه با دستور pmap در Solaris را چاپ می‌کند.

       --heap خلاصه وضعیت java heap را چاپ می‌کند.

       --binaryheap
              از java heap در قالب باینری hprof خروجی dump می‌گیرد.

       --dumpfile name
              نام فایل dumpfile.

       --histo
              هیستوگرام اشیاء java در heap را چاپ می‌کند.

       --clstats
              آمار بارگذار کلاس (class loader) را چاپ می‌کند.

       --finalizerinfo
              اطلاعات مربوط به اشیای در انتظار نهایی‌سازی (finalization) را چاپ
              می‌کند.

گزینه‌های حالت JSTACK (OPTIONS FOR THE JSTACK MODE)
       --locks
              اطلاعات قفل‌های java.util.concurrent را چاپ می‌کند.

       --mixed
              در صورت پشتیبانی پلتفرم، تلاش می‌کند هم فریم‌های java و هم فریم‌های
              محلی (native) را چاپ کند.

گزینه‌های حالت JSNAP (OPTIONS FOR THE JSNAP MODE)
       --all  تمام شمارنده‌های کارایی را چاپ می‌کند.

JDK 25.0.4.1                         2026                             JHSDB(1)