1JMAP(1) JDK Commands JMAP(1)
2
3
4
6 jmap - print details of a specified process
7
9 Note: This command is experimental and unsupported.
10
11 jmap [options] pid
12
13 options
14 This represents the jmap command-line options. See Options for
15 the jmap Command.
16
17 pid The process ID for which the information specified by the op‐
18 tions is to be printed. The process must be a Java process. To
19 get a list of Java processes running on a machine, use either
20 the ps command or, if the JVM processes are not running in a
21 separate docker instance, the jps command.
22
24 The jmap command prints details of a specified running process.
25
26 Note:
27
28 This command is unsupported and might not be available in future re‐
29 leases of the JDK. On Windows Systems where the dbgeng.dll file isn't
30 present, the Debugging Tools for Windows must be installed to make
31 these tools work. The PATH environment variable should contain the lo‐
32 cation of the jvm.dll file that's used by the target process or the lo‐
33 cation from which the core dump file was produced.
34
36 -clstats pid
37 Connects to a running process and prints class loader statistics
38 of Java heap.
39
40 -finalizerinfo pid
41 Connects to a running process and prints information on objects
42 awaiting finalization.
43
44 -histo[:live] pid
45 Connects to a running process and prints a histogram of the Java
46 object heap. If the live suboption is specified, it then counts
47 only live objects.
48
49 -dump:dump_options pid
50 Connects to a running process and dumps the Java heap. The
51 dump_options include:
52
53 • live --- When specified, dumps only the live objects; if not
54 specified, then dumps all objects in the heap.
55
56 • format=b --- Dumps the Java heap in hprof binary format
57
58 • file=filename --- Dumps the heap to filename
59
60 Example: jmap -dump:live,format=b,file=heap.bin pid
61
62
63
64JDK 17 2021 JMAP(1)