Skip to content

D
dragonwell8_hotspot

openanolis / dragonwell8_hotspot

通知 2
Star 2
Fork 0
D
dragonwell8_hotspot
切换分支/标签
查找文件 普通视图历史永久链接Permalink
clhsdb.html 7.0 KB
Newer Older
D
Initial load  
duke 已提交
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 
<html>
<head>
<title>
Command line HSDB
</title>
</head>
<body>

<h1>Command line HSDB</h1>
<p>
When debugging remote core dumps it is easier to work with command line tools instead of
GUI tools. Command line HSDB (CLHSDB) tool is alternative to SA GUI tool HSDB.
</p>

<p>
There is also JavaScript based SA command line interface called <a href="jsdb.html">jsdb</a>.
But, CLHSDB supports Unix shell-like (or dbx/gdb-like) command line interface with
support for output redirection/appending (familiar >, >>), command history and so on.
Each CLHSDB command can have zero or more arguments and optionally end with output redirection
(or append) to a file. Commands may be stored in a file and run using <b>source</b> command.
<b>help</b> command prints usage message for all supported commands (or a specific command)
</p>

<h3>Shell/batch scripts to run command line HSDB</h3>

<ul>
<li>clhsdbproc.sh
<li>clhsdbproc64.sh
<li>clhsdbwindbg.bat
<li>clhsdbwindbg64.bat
</ul>

<h3>Annotated output of CLHSDB help command</h3>

<pre>
<code>
Available commands:
  assert true | false <font color="red">turn on/off asserts in SA code</font>
  attach pid | exec core  <font color="red">attach SA to a process or core</font>
M
6830717: replay of compilations would help with debugging  
minqi 已提交
40 
  buildreplayjars [all | boot | app] <font color="red">build jars for replay, boot.jar for bootclasses, app.jar for application classes</font>
D
Initial load  
duke 已提交
41 
  class name <font color="red">find a Java class from debuggee and print oop</font>
C
6964458: Reimplement class meta-data storage to use native memory  
coleenp 已提交
42 
  classes <font color="red">print all loaded Java classes with Klass*</font>
D
Initial load  
duke 已提交
43 44 
  detach <font color="red">detach SA from current target</font>
  dis address [ length ]  <font color="red">disassemble (sparc/x86) specified number of instructions from given address</font>
M
6830717: replay of compilations would help with debugging  
minqi 已提交
45 46 
  dissemble address <font color="red">disassemble nmethod</font>
  dumpcfg -a | id <font color="red">Dump the PhaseCFG for every compiler thread that has one live</font>
C
6964458: Reimplement class meta-data storage to use native memory  
coleenp 已提交
47 
  dumpclass { address | name } [ directory ] <font color="red">dump .class file for given Klass* or class name</font>
M
6830717: replay of compilations would help with debugging  
minqi 已提交
48 
  dumpcodecache <font color="red">dump codecache contents</font>
D
Initial load  
duke 已提交
49 
  dumpheap [ file ] <font color="red">dump heap in hprof binary format</font>
M
6830717: replay of compilations would help with debugging  
minqi 已提交
50 51 52 
  dumpideal -a | id <font color="red">dump ideal graph like debug flag -XX:+PrintIdeal</font>
  dumpilt -a | id <font color="red">dump inline tree for C2 compilation</font>
  dumpreplaydata <address> | -a | <thread_id> [>replay.txt] <font color="red">dump replay data into a file</font>
D
Initial load  
duke 已提交
53 54 55 56 57 58 59 60 
  echo [ true | false ] <font color="red">turn on/off command echo mode</font>
  examine [ address/count ] | [ address,address] <font color="red">show contents of memory from given address</font>
  field [ type [ name fieldtype isStatic offset address ] ] <font color="red">print info about a field of HotSpot type</font>
  findpc address <font color="red">print info. about pointer location</font>
  flags [ flag ] <font color="red">show all -XX flag name value pairs. or just show given flag</font>
  help [ command ] <font color="red">print help message for all commands or just given command</font>
  history <font color="red">show command history. usual !command-number syntax works.</font>
  inspect expression <font color="red">inspect a given oop</font>
M
6830717: replay of compilations would help with debugging  
minqi 已提交
61 
  intConstant [ name [ value ] ] <font color="red">print out hotspot integer constant(s)</font>
C
6964458: Reimplement class meta-data storage to use native memory  
coleenp 已提交
62 
  jdis address <font color="red">show bytecode disassembly of a given Method*</font>
D
Initial load  
duke 已提交
63 64 65 66 67 
  jhisto <font color="red">show Java heap histogram</font>
  jseval script <font color="red">evaluate a given string as JavaScript code</font>
  jsload file <font color="red">load and evaluate a JavaScript file</font>
  jstack [-v] <font color="red">show Java stack trace of all Java threads. -v is verbose mode</font>
  livenmethods <font color="red">show all live nmethods</font>
M
6830717: replay of compilations would help with debugging  
minqi 已提交
68 
  longConstant [ name [ value ] ] <font color="red">print out hotspot long constant(s)s</font>
D
Initial load  
duke 已提交
69 70 
  mem address [ length ] <font color="red">show contents of memory -- also shows closest ELF/COFF symbol if found</font>
  pmap <font color="red">show Solaris pmap-like output</font>
C
6964458: Reimplement class meta-data storage to use native memory  
coleenp 已提交
71 
  print expression <font color="red">print given Klass*, Method* or arbitrary address</font>
D
Initial load  
duke 已提交
72 
  printas type expression <font color="red">print given address as given HotSpot type. eg. print JavaThread &lt;address&gt;</font>
M
6830717: replay of compilations would help with debugging  
minqi 已提交
73 
  printmdo -a | expression <font color="red">print method data oop</font>
D
Initial load  
duke 已提交
74 75 76 77 
  printstatics [ type ] <font color="red">print static fields of given HotSpot type (or all types if none specified)</font>
  pstack [-v] <font color="red">show mixed mode stack trace for all Java, non-Java threads. -v is verbose mode</font>
  quit <font color="red">quit CLHSDB tool</font>
  reattach <font color="red">detach and re-attach SA to current target</font>
M
6830717: replay of compilations would help with debugging  
minqi 已提交
78 
  revptrs  <font color="red">find liveness of oops</font>
D
Initial load  
duke 已提交
79 80 81 82 83 
  scanoops start end [ type ] <font color="red">scan a Oop from given start to end address</font>
  search [ heap | codecache | threads ] value <font color="red">search a value in heap or codecache or threads</font>
  source filename <font color="red">load and execute CLHSDB commands from given file</font>
  symbol name <font color="red">show address of a given ELF/COFF symbol</font>
  sysprops <font color="red">show all Java System properties</font>
M
6830717: replay of compilations would help with debugging  
minqi 已提交
84 
  thread id <font color="red">show thread of id</font>
D
Initial load  
duke 已提交
85 86 87 88 
  threads <font color="red">show all Java threads</font>
  tokenize ...
  type [ type [ name super isOop isInteger isUnsigned size ] ] <font color="red">show info. on HotSpot type</font>
  universe <font color="red">print gc universe</font>
M
6830717: replay of compilations would help with debugging  
minqi 已提交
89 
  vmstructsdump <font color="red">dump hotspot type library in text</font>
D
Initial load  
duke 已提交
90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 
  verbose true | false <font color="red">turn on/off verbose mode</font>
  versioncheck [ true | false ] <font color="red">turn on/off debuggee VM version check</font>
  whatis address <font color="red">print info about any arbitrary address</font>
  where { -a | id } <font color="red">print Java stack trace of given Java thread or all Java threads (-a)</font>
</code>
</pre>

<h3>JavaScript integration</h3>

<p>Few CLHSDB commands are already implemented in JavaScript. It is possible to extend CLHSDB command set 
by implementing more commands in a JavaScript file and by loading it by <b>jsload</b> command. <b>jseval</b>
command may be used to evaluate arbitrary JavaScript expression from a string. Any JavaScript function
may be exposed as a CLHSDB command by registering it using JavaScript <b><code>registerCommand</code></b>
function. This function accepts command name, usage and name of the JavaScript implementation function 
as arguments.
</p>

<h3>Simple CLHSDB command implemented in JavaScript</h3>

<b>File: test.js</b>
<pre>
<code>
function helloImpl(name) {
    println("hello, " + name);
}

// register the above JavaScript function as CLHSDB command
registerCommand("hello", "hello name", "helloImpl");
</code>
</pre>
---------<br>

"test.js" can be loaded in CLHSDB prompt using <b>jsload</b> command using

<pre>
<code>
hsdb&gt; jsload test.js
</code>
</pre>
M
6830717: replay of compilations would help with debugging  
minqi 已提交
130 131 132 133 134 135 
<h3>C2 Compilation Replay</h3>
<p>
When a java process crashes in compiled method, usually a core file is saved.
The C2 replay function can reproduce the compiling process in the core.
<a href="c2replay.html">c2replay.html</a>
D
Initial load  
duke 已提交
136 137 
</body>
</html>