jmap(1) jmap(1)

NAME
       jmap - memory map

SYNOPSIS
       jjmmaapp [ ooppttiioonn ] pid
       jjmmaapp [ option ] executable core
       jjmmaapp [ option ] [ server-id@ ] remote-hostname-or-IP

DESCRIPTION
       jjmmaapp prints shared object memory maps or heap memory details of a given
       process or core file or remote debug server.

       NNOOTTEE - This utility is unsupported and may or may not be  available  in
       future  versions  of  the J2SE SDK.  jjmmaapp iiss nnoott currently available on
       Windows platforms or on the Linux Itanium platform.

PPAARRAAMMEETTEERRSS
       ooppttiioonn         Options are mutually exclusive. Option, if used, should-
                      follow immediately after the command name.

       ppiidd            process  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 may be used.

       eexxeeccuuttaabbllee     Java executable from which the core dump was produced.

       ccoorree           core file for which the memory map is to be printed.

       rreemmoottee-hhoossttnnaammee-oorr-IIPP
                      remote  debug  server's  (see  jsadebugd) hostname or IP
                      address.

       sseerrvveerr-iidd      optional unique id, if multiple debug servers  are  run-
                      ning on the same remote host.

OOPPTTIIOONNSS
        <>   When  no  option  is used jjmmaapp prints shared object map-
                      pings. 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 sim-
                      ilar to the Solaris ppmmaapp utility.

       -hheeaapp          Prints  a heap summary. GC algorithm used, heap configu-
                      ration and generation wise heap usage are printed.

       -hhiissttoo         Prints a histogram of the heap.  For  each  Java  class,
                      number of objects, memory size in bytes, and fully qual-
                      ified class names are printed. VM internal  class  names
                      are printed with '*' prefix.

       -ppeerrmmssttaatt      Prints class loader wise statistics of permanent genera-
                      tion 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.

       -hh             Prints a help message.

       -hheellpp          Prints a help message.

SEE ALSO
       ppmmaapp(1) jjppss(1) jjssaaddeebbuuggdd(1)



                                 13 June 2004                          jmap(1)