jdk/make/non-build-utils/sharing/README.txt
author asaha
Thu, 12 Feb 2015 14:56:30 -0800 (2015-02-12)
changeset 29251 91308c984504
parent 21805 c7d7946239de
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
19401
d4cc956b926b 8022259: MakeClasslist is buggy and its README is out of date.
hseigel
parents: 2
diff changeset
     5
the -XX:+TraceClassLoadingPreorder option.  The -Xshare:off option must also be
d4cc956b926b 8022259: MakeClasslist is buggy and its README is out of date.
hseigel
parents: 2
diff changeset
     6
used so that bootclasspath classes are loaded from rt.jar.  The MakeClasslist
d4cc956b926b 8022259: MakeClasslist is buggy and its README is out of date.
hseigel
parents: 2
diff changeset
     7
program should be built into the jar file makeclasslist.jar and is run
2
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
19401
d4cc956b926b 8022259: MakeClasslist is buggy and its README is out of date.
hseigel
parents: 2
diff changeset
    10
cd .../<resultsdir>/results.startup3
d4cc956b926b 8022259: MakeClasslist is buggy and its README is out of date.
hseigel
parents: 2
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.NetBeans50/results_1/log
2
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
19401
d4cc956b926b 8022259: MakeClasslist is buggy and its README is out of date.
hseigel
parents: 2
diff changeset
    15
The logs are deliberately concatenated in roughly smallest to largest order
d4cc956b926b 8022259: MakeClasslist is buggy and its README is out of date.
hseigel
parents: 2
diff changeset
    16
based on application size.  The resulting output is redirected into a file
d4cc956b926b 8022259: MakeClasslist is buggy and its README is out of date.
hseigel
parents: 2
diff changeset
    17
and results in one of classlist.solaris, classlist.linux, classlist.macosx,
d4cc956b926b 8022259: MakeClasslist is buggy and its README is out of date.
hseigel
parents: 2
diff changeset
    18
or classlist.windows.  These files are checked in to the workspace.  A
2
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
19401
d4cc956b926b 8022259: MakeClasslist is buggy and its README is out of date.
hseigel
parents: 2
diff changeset
    30
javahome=/usr/java/j2sdk1.8.0
2
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
19401
d4cc956b926b 8022259: MakeClasslist is buggy and its README is out of date.
hseigel
parents: 2
diff changeset
    34
globalvmoptions=-client -Xshare:off -XX:+TraceClassLoadingPreorder