jhsdb-openjdk17(1)

jhsdb-openjdk171

Attach to a java process or launch a postmortem debugger to analyze the content of a core dump from a crashed java virtual machine (jvm)

Usage

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]}

Note:

Overview

You can use the jhsdb tool to attach to a Java process or to launch a postmortem debugger to analyze the content of a core-dump from a crashed Java Virtual Machine (JVM). This command is experimental and unsupported.

Note:

Attaching the jhsdb tool to a live process will cause the process to hang and the process will probably crash when the debugger detaches.

The jhsdb tool can be launched in any one of the following modes:

jhsdb clhsdb

Starts the interactive command-line debugger.

jhsdb hsdb

Starts the interactive GUI debugger.

jhsdb debugd

Starts the remote debug server.

jhsdb jstack

Prints stack and locks information.

jhsdb jmap

Prints heap information.

jhsdb jinfo

Prints basic JVM information.

jhsdb jsnap

Prints performance counter information.

jhsdb command --help

Displays the options available for the command.

Options for the debugd mode

--serverid server-id

An optional unique ID for this debug server. This is required if multiple debug servers are run on the same machine.

--rmiport port

Sets the port number to which the RMI connector is bound. If not specified a random available port is used.

--registryport port

Sets the RMI registry port. This option overrides the system property 'sun.jvm.hotspot.rmi.port'. If not specified, the system property is used. If the system property is not set, the default port 1099 is used.

--hostname hostname

Sets the hostname the RMI connector is bound. The value could be a hostname or an IPv4/IPv6 address. This option overrides the system property 'java.rmi.server.hostname'. If not specified, the system property is used. If the system property is not set, a system hostname is used.

Options for the jinfo mode

--flags

Prints the VM flags.

--sysprops

Prints the Java system properties.

no option

Prints the VM flags and the Java system properties.

Options for the jmap mode

no option

Prints the same information as Solaris pmap.

--heap

Prints the java heap summary.

--binaryheap

Dumps the java heap in hprof binary format.

--dumpfile name

The name of the dumpfile.

--histo

Prints the histogram of java object heap.

--clstats

Prints the class loader statistics.

--finalizerinfo

Prints the information on objects awaiting finalization.

Options for the jstack mode

--locks

Prints the java.util.concurrent locks information.

--mixed

Attempts to print both java and native frames if the platform allows it.

Options for the jsnap mode

--all

Prints all performance counters.

From jdk17-openjdk 17.0.21.0.3.u1-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.