| 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)
گزینه‌های حالت JSNAP (OPTIONS FOR THE JSNAP MODE)
- --all
- تمام شمارنده‌های کارایی را چاپ می‌کند.
| 2026 | JDK 25.0.4.1 |