1 '\" t
   2 .\" Copyright 2006 Sun Microsystems, Inc.  All Rights Reserved.
   3 .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   4 .\"
   5 .\" This code is free software; you can redistribute it and/or modify it
   6 .\" under the terms of the GNU General Public License version 2 only, as
   7 .\" published by the Free Software Foundation.
   8 .\"
   9 .\" This code is distributed in the hope that it will be useful, but WITHOUT
  10 .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  11 .\" FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  12 .\" version 2 for more details (a copy is included in the LICENSE file that
  13 .\" accompanied this code).
  14 .\"
  15 .\" You should have received a copy of the GNU General Public License version
  16 .\" 2 along with this work; if not, write to the Free Software Foundation,
  17 .\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  18 .\"
  19 .\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  20 .\" or visit www.oracle.com if you need additional information or have any
  21 .\" questions.
  22 .\" ` 
  23 .TH jmap 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
  24 .SH 名前
  25 jmap \- メモリマップ
  26 .\"
  27 .SH 形式
  28 .B jmap 
  29 .BI [ option ] " pid" 
  30 .br
  31 .B jmap
  32 .BI [ option ] " executable core" 
  33 .br
  34 .B jmap
  35 .BI [ option ] " [server-id@]remote-hostname-or-IP"
  36 .SH パラメータ
  37 .if t .TP 20
  38 .if n .TP 15
  39 .BI option
  40 オプションは相互に排他的です。オプションを使用する場合は、コマンド名の直後に指定する必要があります。
  41 .if t .TP 20
  42 .if n .TP 15
  43 .I pid
  44 メモリマップを表示するプロセス ID。プロセスは Java プロセスでなければなりません。マシン上で実行している Java プロセスのリストを取得するには、
  45 .B jps 
  46 を使用します。
  47 .if t .TP 20
  48 .if n .TP 15
  49 .I executable
  50 コアダンプが生成された Java 実行可能ファイル。
  51 .if t .TP 20
  52 .if n .TP 15
  53 .I core
  54 メモリマップを表示するコアファイル。
  55 .if t .TP 20
  56 .if n .TP 15
  57 .I remote-hostname-or-IP
  58 リモートデバッグサーバ (
  59 .B jsadebugd
  60 を参照) のホスト名または IP アドレス。
  61 .if t .TP 20
  62 .if n .TP 15
  63 .I server-id
  64 同じリモートホスト上で複数のデバッグサーバが実行している場合、オプションの一意 ID。
  65 .SH 機能説明
  66 .B jmap
  67 は、指定されたプロセスまたはコアファイルまたはリモートデバッグサーバの、共有オブジェクトメモリマップまたはヒープメモリの詳細を表示します。
  68 指定されたプロセスが 64 ビット VM 上で実行されている場合、\f2\-J\-d64\fP オプションを指定しなければならない場合があります。次に例を示します。
  69 .LP
  70 .RS 3
  71 
  72 .LP
  73 .nf
  74 \f3
  75 .fl
  76 jmap \-J\-d64 \-heap pid
  77 .fl
  78 \fP
  79 .fi
  80 .RE
  81 
  82 .LP
  83 注 - このユーティリティはサポートされていないため、JDK の将来のバージョンでは使用できない可能性があります。
  84 .br
  85 
  86 .LP
  87 Windows プラットフォーム上で使用可能な唯一の jmap 形式は、次のとおりです。
  88 .RS 3
  89 
  90 .LP
  91 jmap \-dump:<\f2dump\-options\fP> pid
  92 .RE
  93 および 
  94 .RS 3
  95 
  96 .LP
  97 jmap \-histo[:live] pid
  98 .RE
  99 .SH オプション
 100 .if t .TP 20
 101 .if n .TP 15
 102 .BI " <no option>"
 103 オプションが使用されなかった場合、
 104 .B jmap 
 105 は共有オブジェクトマッピングを表示します。ターゲット VM に読み込まれた各共有オブジェクトについて、開始アドレス、マッピングのサイズ、および共有オブジェクトファイルのフルパスが表示されます。これは、Solaris の
 106 .B pmap 
 107 ユーティリティと同様です。
 108 .TP 3
 109 \-dump:[live,]format=b,file=<filename> 
 110 Java ヒープを hprof バイナリ形式で filename にダンプします。\f2live\fP サブオプションは省略可能です。これが指定された場合、ヒープ内で生存中のオブジェクトのみがダンプされます。ヒープダンプを参照するには、生成されたファイルを jhat (Java Heap Analysis Tool) を使って読み取ります。
 111 .TP 3
 112 \-finalizerinfo 
 113 ファイナライズを待っているオブジェクトに関する情報を出力します。
 114 .if t .TP 20
 115 .if n .TP 15
 116 .B \-heap
 117 ヒープのサマリを表示します。使用された GC アルゴリズム、ヒープ構成、および生成規模のヒープ使用率が表示されます。
 118 .if t .TP 20
 119 .if n .TP 15
 120 .B \-histo[:live] 
 121 ヒープのヒストグラムを表示します。各 Java クラスについて、オブジェクト数、メモリサイズ（バイト数）、および完全修飾クラス名が表示されます。VM 内部クラス名の前には '*' が表示されます。\f2live\fP サブオプションが指定された場合、生存中のオブジェクトのみがカウントされます。
 122 .if t .TP 20
 123 .if n .TP 15
 124 .B \-permstat
 125 Java ヒープの永続的生成のクラスローダ規模の統計を表示します。各クラスローダについて、名前、活動性、アドレス、親クラスローダ、および読み込まれたクラスのサイズが表示されます。
 126 さらに、intern された文字列の数とサイズも出力されます。
 127 .TP 3
 128 \-F 
 129 強制 (Force)。pid が応答しない場合に、jmap \-dump または jmap \-histo オプションとともに使用します。このモードでは、\f2live\fP サブオプションはサポートされません。
 130 .if t .TP 20
 131 .if n .TP 15
 132 .B \-h
 133 ヘルプメッセージを表示します。
 134 .if t .TP 20
 135 .if n .TP 15
 136 .B \-help
 137 ヘルプメッセージを表示します。
 138 .br
 139 .TP 3
 140 \-J<flag> 
 141 jmap が実行されている Java 仮想マシンに <flag> を渡します。
 142 
 143 .LP
 144 .SH 関連項目
 145 .LP
 146 .RS 3
 147 .TP 2
 148 *
 149 pmap (1) 
 150 .TP 2
 151 *
 152 jhat 
 153 .TP 2
 154 *
 155 jps 
 156 .TP 2
 157 *
 158 jsadebugd 
 159 .RE
 160 
 161 .LP
 162 
 163 .LP
 164