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