jdk/make/tools/sharing/README.txt
author herrick
Mon, 15 Jun 2009 13:07:18 -0400
changeset 3033 005c4e992893
parent 2 90ce3da70b43
child 19401 d4cc956b926b
permissions -rw-r--r--
Merge
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
2
90ce3da70b43 Initial load
duke
parents:
diff changeset
     1
This directory contains tools and tests associated with creating the
90ce3da70b43 Initial load
duke
parents:
diff changeset
     2
class list for class data sharing.
90ce3da70b43 Initial load
duke
parents:
diff changeset
     3
90ce3da70b43 Initial load
duke
parents:
diff changeset
     4
The class list is produced by running the refWorkload startup3 benchmark with
90ce3da70b43 Initial load
duke
parents:
diff changeset
     5
the -verbose:class option. The -Xshare:off option must also be used so that
90ce3da70b43 Initial load
duke
parents:
diff changeset
     6
bootclasspath classes are loaded from rt.jar.  The MakeClasslist program
90ce3da70b43 Initial load
duke
parents:
diff changeset
     7
should be built into the jar file makeclasslist.jar and is run
90ce3da70b43 Initial load
duke
parents:
diff changeset
     8
on one of the logs from each of the benchmarks in the following fashion:
90ce3da70b43 Initial load
duke
parents:
diff changeset
     9
90ce3da70b43 Initial load
duke
parents:
diff changeset
    10
cd .../results.startup3
90ce3da70b43 Initial load
duke
parents:
diff changeset
    11
$JAVA_HOME/bin/java -jar makeclasslist.jar results.Noop/results_1/log results.Framer/results_1/log results.XFramer/results_1/log results.JEdit/results_1/log results.LimeWire/results_1/log results.NetBeans/results_1/log
90ce3da70b43 Initial load
duke
parents:
diff changeset
    12
90ce3da70b43 Initial load
duke
parents:
diff changeset
    13
Presently, $JAVA_HOME must be the same path used to run the startup3 benchmark.
90ce3da70b43 Initial load
duke
parents:
diff changeset
    14
90ce3da70b43 Initial load
duke
parents:
diff changeset
    15
The logs are deliberately concatenated in roughly smallest to largest
90ce3da70b43 Initial load
duke
parents:
diff changeset
    16
order based on application size. The resulting output is redirected
90ce3da70b43 Initial load
duke
parents:
diff changeset
    17
into a file and results in one of classlist.solaris, classlist.linux,
90ce3da70b43 Initial load
duke
parents:
diff changeset
    18
or classlist.windows. These files are checked in to the workspace. A
90ce3da70b43 Initial load
duke
parents:
diff changeset
    19
necessary checksum (AddJsum.java) is added to the final classlist
90ce3da70b43 Initial load
duke
parents:
diff changeset
    20
(installed in lib/ or jre/lib/) during the build process by the
90ce3da70b43 Initial load
duke
parents:
diff changeset
    21
makefiles in make/java/redist.
90ce3da70b43 Initial load
duke
parents:
diff changeset
    22
90ce3da70b43 Initial load
duke
parents:
diff changeset
    23
In a forthcoming JDK build we plan to manually add the dependent
90ce3da70b43 Initial load
duke
parents:
diff changeset
    24
classes for the calendar manager Glow, which pulls in the Preferences
90ce3da70b43 Initial load
duke
parents:
diff changeset
    25
classes and, on Unix platforms, the XML parsing classes.
90ce3da70b43 Initial load
duke
parents:
diff changeset
    26
90ce3da70b43 Initial load
duke
parents:
diff changeset
    27
The properties file supplied to the refworkload is approximately the
90ce3da70b43 Initial load
duke
parents:
diff changeset
    28
following:
90ce3da70b43 Initial load
duke
parents:
diff changeset
    29
90ce3da70b43 Initial load
duke
parents:
diff changeset
    30
javahome=/usr/java/j2sdk1.5.0
90ce3da70b43 Initial load
duke
parents:
diff changeset
    31
resultsdir=classlist-run
90ce3da70b43 Initial load
duke
parents:
diff changeset
    32
iterations=1
90ce3da70b43 Initial load
duke
parents:
diff changeset
    33
benchmarks=startup3
90ce3da70b43 Initial load
duke
parents:
diff changeset
    34
globalvmoptions=-client -Xshare:off -verbose:class