annotate agent/make/marks_notes.html @ 18408:2c3666f44855

Truffle: initial commit of object API implementation
author Andreas Woess <andreas.woess@jku.at>
date Tue, 18 Nov 2014 23:19:43 +0100
parents 5ed317b25e23
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
a61af66fc99e Initial load
duke
parents:
diff changeset
1 <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN">
a61af66fc99e Initial load
duke
parents:
diff changeset
2 <html>
a61af66fc99e Initial load
duke
parents:
diff changeset
3 <head>
a61af66fc99e Initial load
duke
parents:
diff changeset
4 <title>Hotspot SA User Interface Notes</title>
a61af66fc99e Initial load
duke
parents:
diff changeset
5 </head>
a61af66fc99e Initial load
duke
parents:
diff changeset
6
a61af66fc99e Initial load
duke
parents:
diff changeset
7 <body>
a61af66fc99e Initial load
duke
parents:
diff changeset
8 <h1>Hotspot SA User Interface Notes</h1>
a61af66fc99e Initial load
duke
parents:
diff changeset
9
a61af66fc99e Initial load
duke
parents:
diff changeset
10 <h2>Workspace and Building</h2>
a61af66fc99e Initial load
duke
parents:
diff changeset
11
a61af66fc99e Initial load
duke
parents:
diff changeset
12 <p>
a61af66fc99e Initial load
duke
parents:
diff changeset
13 All the source code for the Serviceability Agent is in
a61af66fc99e Initial load
duke
parents:
diff changeset
14 <code>src/share/vm/agent</code> in the HotSport workspace
a61af66fc99e Initial load
duke
parents:
diff changeset
15 <code>/net/jano.sfbay/export/disk05/hotspot/ws/1.4/sa_baseline</code>
a61af66fc99e Initial load
duke
parents:
diff changeset
16 <p>
a61af66fc99e Initial load
duke
parents:
diff changeset
17 You can build the project by typing <code>gnumake</code> in the
a61af66fc99e Initial load
duke
parents:
diff changeset
18 <code>src/share/vm/agent</code> directory.
a61af66fc99e Initial load
duke
parents:
diff changeset
19 <p>
a61af66fc99e Initial load
duke
parents:
diff changeset
20 You can also use the default build target using the Ant build file (build.xml). You can download Ant from
a61af66fc99e Initial load
duke
parents:
diff changeset
21 <a href="http://jakarta.apache.org/ant">http://jakarta.apache.org/ant</a>. Documentation for Ant can be
a61af66fc99e Initial load
duke
parents:
diff changeset
22 found at <a href="http://jakarta.apache.org/ant/manual/index.html">http://jakarta.apache.org/ant/manual/index.html</a>
a61af66fc99e Initial load
duke
parents:
diff changeset
23
a61af66fc99e Initial load
duke
parents:
diff changeset
24
a61af66fc99e Initial load
duke
parents:
diff changeset
25 <h2>Running the project</h2>
a61af66fc99e Initial load
duke
parents:
diff changeset
26
a61af66fc99e Initial load
duke
parents:
diff changeset
27 <ul>
a61af66fc99e Initial load
duke
parents:
diff changeset
28 <li><code>java -cp classes sun.jvm.hotspot.HSDB</code>
a61af66fc99e Initial load
duke
parents:
diff changeset
29 </ul>
a61af66fc99e Initial load
duke
parents:
diff changeset
30
a61af66fc99e Initial load
duke
parents:
diff changeset
31 <h2>Feedback</h2>
a61af66fc99e Initial load
duke
parents:
diff changeset
32 <p>
a61af66fc99e Initial load
duke
parents:
diff changeset
33 Refactoring of package hierarchy. All user interface components should be in
8103
5ed317b25e23 7165259: Remove BugSpot
sla
parents: 0
diff changeset
34 the ui package. Perhaps: sun.jvm.hotspot.ui.hsdb.Main for the HSDB.
0
a61af66fc99e Initial load
duke
parents:
diff changeset
35 <p>
a61af66fc99e Initial load
duke
parents:
diff changeset
36 The src\share\vm\agent area seems like a workspace so it should be organized like
a61af66fc99e Initial load
duke
parents:
diff changeset
37 one. In particular, I'd like to suggest the following directory layout:<br>
a61af66fc99e Initial load
duke
parents:
diff changeset
38
a61af66fc99e Initial load
duke
parents:
diff changeset
39 <ul>
a61af66fc99e Initial load
duke
parents:
diff changeset
40 <li>src: All sources that are curently under the sun directory.
a61af66fc99e Initial load
duke
parents:
diff changeset
41 <li>classes: compiled class files.
a61af66fc99e Initial load
duke
parents:
diff changeset
42 <li>lib: Resources like images, icons and jar files.
a61af66fc99e Initial load
duke
parents:
diff changeset
43 <li>docs: Documentation
a61af66fc99e Initial load
duke
parents:
diff changeset
44 <li>deploy: distribution bundles for Java Web Start.
a61af66fc99e Initial load
duke
parents:
diff changeset
45 </ul>
a61af66fc99e Initial load
duke
parents:
diff changeset
46
a61af66fc99e Initial load
duke
parents:
diff changeset
47 <p>
8103
5ed317b25e23 7165259: Remove BugSpot
sla
parents: 0
diff changeset
48 Seems like there is a lot of redundant functionality. Perhaps
0
a61af66fc99e Initial load
duke
parents:
diff changeset
49 this can be consolidated with a <code>javax.swing.Actions</code> architecture.
a61af66fc99e Initial load
duke
parents:
diff changeset
50
a61af66fc99e Initial load
duke
parents:
diff changeset
51 <h2>Tasklist</h2>
a61af66fc99e Initial load
duke
parents:
diff changeset
52
a61af66fc99e Initial load
duke
parents:
diff changeset
53 <p>
a61af66fc99e Initial load
duke
parents:
diff changeset
54 <b>Stack memory pane</b>:
a61af66fc99e Initial load
duke
parents:
diff changeset
55 It's one of the more useful JVM debugging tools in the SA. However, it
8103
5ed317b25e23 7165259: Remove BugSpot
sla
parents: 0
diff changeset
56 doesn't support any interaction with the text.
0
a61af66fc99e Initial load
duke
parents:
diff changeset
57 <p>
a61af66fc99e Initial load
duke
parents:
diff changeset
58 <b>Integrations with the NetBeans architecture (plug in).</b> See the
a61af66fc99e Initial load
duke
parents:
diff changeset
59 <a href="http://openide.netbeans.org">Netbeans Open APIs homepage</a>
a61af66fc99e Initial load
duke
parents:
diff changeset
60
a61af66fc99e Initial load
duke
parents:
diff changeset
61
a61af66fc99e Initial load
duke
parents:
diff changeset
62 <p>
a61af66fc99e Initial load
duke
parents:
diff changeset
63 HSDB: Object Histogram. Column sizes should be sized according the the
a61af66fc99e Initial load
duke
parents:
diff changeset
64 contents. i.e, The size and count columns should be narrow enought to
a61af66fc99e Initial load
duke
parents:
diff changeset
65 handle the largest window. Since there is a lot of data, sorting
a61af66fc99e Initial load
duke
parents:
diff changeset
66 and searching should be implemented.
a61af66fc99e Initial load
duke
parents:
diff changeset
67 <p>
a61af66fc99e Initial load
duke
parents:
diff changeset
68
a61af66fc99e Initial load
duke
parents:
diff changeset
69 <h2>Log</h2>
a61af66fc99e Initial load
duke
parents:
diff changeset
70
a61af66fc99e Initial load
duke
parents:
diff changeset
71 <i>Last modified: Tue Feb 05 19:15:12 Pacific Standard Time 2002</i>
a61af66fc99e Initial load
duke
parents:
diff changeset
72 <p>
a61af66fc99e Initial load
duke
parents:
diff changeset
73 sun.jvm.hotspot.oops.ObjectHistogram should be the underlying data
a61af66fc99e Initial load
duke
parents:
diff changeset
74 structure for the TableModels. It shouldnt bother with sorting the data -
a61af66fc99e Initial load
duke
parents:
diff changeset
75 the table model should do that. It should implement these methods:
a61af66fc99e Initial load
duke
parents:
diff changeset
76
a61af66fc99e Initial load
duke
parents:
diff changeset
77 <pre>
a61af66fc99e Initial load
duke
parents:
diff changeset
78 public int getSize()
a61af66fc99e Initial load
duke
parents:
diff changeset
79 public ObjectHistogramElement getElementAt(int row);
a61af66fc99e Initial load
duke
parents:
diff changeset
80 </pre>
a61af66fc99e Initial load
duke
parents:
diff changeset
81 <p>
a61af66fc99e Initial load
duke
parents:
diff changeset
82 ObjectHistogramElement should return the String that represents
a61af66fc99e Initial load
duke
parents:
diff changeset
83 the third column
a61af66fc99e Initial load
duke
parents:
diff changeset
84
a61af66fc99e Initial load
duke
parents:
diff changeset
85
a61af66fc99e Initial load
duke
parents:
diff changeset
86 <hr>
a61af66fc99e Initial load
duke
parents:
diff changeset
87 <address><a href="mailto:mark.davidson@sun.com">Mark Davidson</a></address>
a61af66fc99e Initial load
duke
parents:
diff changeset
88 <!-- Created: Mon Jan 28 14:33:47 Pacific Standard Time 2002 -->
a61af66fc99e Initial load
duke
parents:
diff changeset
89 <!-- hhmts start -->
a61af66fc99e Initial load
duke
parents:
diff changeset
90 Last modified: Tue Feb 05 20:05:13 Pacific Standard Time 2002
a61af66fc99e Initial load
duke
parents:
diff changeset
91 <!-- hhmts end -->
a61af66fc99e Initial load
duke
parents:
diff changeset
92 </body>
a61af66fc99e Initial load
duke
parents:
diff changeset
93 </html>