jmap.1 revision 4169
f80c797d42f213e026478a0e767a8dbbc2352e7fAndreas Gustafsson." Copyright (c) 2004, 2010, Oracle and/or its affiliates. All rights reserved.
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
40f53fa8d9c6a4fc38c0014495e7a42b08f52481David Lawrence." This code is free software; you can redistribute it and/or modify it
f80c797d42f213e026478a0e767a8dbbc2352e7fAndreas Gustafsson." under the terms of the GNU General Public License version 2 only, as
f80c797d42f213e026478a0e767a8dbbc2352e7fAndreas Gustafsson." published by the Free Software Foundation.
40f53fa8d9c6a4fc38c0014495e7a42b08f52481David Lawrence." This code is distributed in the hope that it will be useful, but WITHOUT
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews." version 2 for more details (a copy is included in the LICENSE file that
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews." accompanied this code).
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews." You should have received a copy of the GNU General Public License version
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews." 2 along with this work; if not, write to the Free Software Foundation,
f80c797d42f213e026478a0e767a8dbbc2352e7fAndreas Gustafsson." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
fa81ddd7b9a65cca5c95fa9356acd78f86730827Mark Andrews." Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
9c3531d72aeaad6c5f01efe6a1c82023e1379e4dDavid Lawrence." or visit www.oracle.com if you need additional information or have any
08fd94c483877b9117e44a407d03ca3bd505bbb1Bob Halley.TH jmap 1 "02 Jun 2010"
08fd94c483877b9117e44a407d03ca3bd505bbb1Bob Halleyjmap \- Memory Map
33e49e8fdcc83c97eea168e0c9232f5ffa6c71fcBrian Wellington\fP\f3jmap\fP [ option ] pid
9cd6d409b78a6f833b681c13a68fbdc7c024fe66David Lawrence\f3jmap\fP [ option ] executable core
f80c797d42f213e026478a0e767a8dbbc2352e7fAndreas Gustafsson\f3jmap\fP [ option ] [server\-id@]remote\-hostname\-or\-IP
f80c797d42f213e026478a0e767a8dbbc2352e7fAndreas Gustafsson.SH "PARAMETERS"
ca485ab26fffa241a3eac1899b2d2012dd1fdb73Andreas GustafssonOptions are mutually exclusive. Option, if used, should follow immediately after the command name.
3b84ea68c0764dc9143ef37cdcf3f270ac225212Andreas Gustafssonprocess id for which the memory map is to be printed. The process must be a Java process. To get a list of Java processes running on a machine, jps(1) may be used.
3b84ea68c0764dc9143ef37cdcf3f270ac225212Andreas GustafssonJava executable from which the core dump was produced.
40f53fa8d9c6a4fc38c0014495e7a42b08f52481David Lawrencecore file for which the memory map is to be printed.
846f974d5737710588eb676b64ba138da27c45ddMark Andrewsremote\-hostname\-or\-IP
6526fd032fc418411da3af4201214e95c113d3e2Mark Andrewsremote debug server's (see jsadebugd(1)) hostname or IP address.
aebe37a4619864fa0d1a083f3e5171bb3b6e116fMark Andrewsoptional unique id, if multiple debug servers are running on the same remote host.
f80c797d42f213e026478a0e767a8dbbc2352e7fAndreas Gustafsson.SH "DESCRIPTION"
6526fd032fc418411da3af4201214e95c113d3e2Mark Andrews\f3jmap\fP prints shared object memory maps or heap memory details of a given process or core file or a remote debug server. If the given process is running on a 64\-bit VM, you may need to specify the \f2\-J\-d64\fP option, e.g.:
6526fd032fc418411da3af4201214e95c113d3e2Mark Andrewsjmap \-J\-d64 \-heap pid
6526fd032fc418411da3af4201214e95c113d3e2Mark Andrews\f3NOTE \- This utility is unsupported and may or may not be available in future versions of the JDK. In Windows Systems where dbgeng.dll is not present, 'Debugging Tools For Windows' needs to be installed to have these tools working. Also, \fP\f4PATH\fP\f3 environment variable should contain the location of \fP\f4jvm.dll\fP\f3 used by the target process or the location from which the Crash Dump file was produced.\fP
6526fd032fc418411da3af4201214e95c113d3e2Mark Andrews\f3For example, \fP\f4set PATH=<jdk>\\jre\\bin\\client;%PATH%\fP
846f974d5737710588eb676b64ba138da27c45ddMark Andrews.SH "OPTIONS"
fa81ddd7b9a65cca5c95fa9356acd78f86730827Mark AndrewsWhen no option is used \f3jmap\fP prints shared object mappings. For each shared object loaded in the target VM, start address, the size of the mapping, and the full path of the shared object file are printed. This is similar to the Solaris \f3pmap\fP utility.
846f974d5737710588eb676b64ba138da27c45ddMark Andrews\-dump:[live,]format=b,file=<filename>
846f974d5737710588eb676b64ba138da27c45ddMark AndrewsDumps the Java heap in hprof binary format to filename. The \f2live\fP suboption is optional. If specified, only the live objects in the heap are dumped. To browse the heap dump, you can use jhat(1) (Java Heap Analysis Tool) to read the generated file.
846f974d5737710588eb676b64ba138da27c45ddMark Andrews\-finalizerinfo
846f974d5737710588eb676b64ba138da27c45ddMark AndrewsPrints information on objects awaiting finalization.
846f974d5737710588eb676b64ba138da27c45ddMark AndrewsPrints a heap summary. GC algorithm used, heap configuration and generation wise heap usage are printed.
fa81ddd7b9a65cca5c95fa9356acd78f86730827Mark Andrews\-histo[:live]
6526fd032fc418411da3af4201214e95c113d3e2Mark AndrewsPrints a histogram of the heap. For each Java class, number of objects, memory size in bytes, and fully qualified class names are printed. VM internal class names are printed with '*' prefix. If the \f2live\fP suboption is specified, only live objects are counted.
5e2b6219d2a7e3dafc17e4979d081639996bbf9fMark AndrewsPrints class loader wise statistics of permanent generation of Java heap. For each class loader, its name, liveness, address, parent class loader, and the number and size of classes it has loaded are printed. In addition, the number and size of interned Strings are printed.
f80c797d42f213e026478a0e767a8dbbc2352e7fAndreas GustafssonForce. Use with jmap \-dump or jmap \-histo option if the pid does not respond. The \f2live\fP suboption is not supported in this mode.
ca485ab26fffa241a3eac1899b2d2012dd1fdb73Andreas GustafssonPrints a help message.
8ca42f6318be756354b70260050132545aa680d3Mark AndrewsPrints a help message.
f80c797d42f213e026478a0e767a8dbbc2352e7fAndreas GustafssonPasses <flag> to the Java virtual machine on which jmap is run.