org.openjdk.jmh.profile

Class AbstractPerfAsmProfiler

java.lang.Object

org.openjdk.jmh.profile.AbstractPerfAsmProfiler

All Implemented Interfaces:

ExternalProfiler, Profiler

Direct Known Subclasses:

LinuxPerfAsmProfiler, WinPerfAsmProfiler

public abstract class AbstractPerfAsmProfiler
extends Object
implements ExternalProfiler

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static class	AbstractPerfAsmProfiler.PerfEvents

Field Summary

Fields

Modifier and Type	Field and Description
protected String	hsLog
protected String	perfBinData
protected String	perfParsedData
protected String[]	tracedEvents

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractPerfAsmProfiler(String[] events)

Method Summary

Methods

Modifier and Type	Method and Description
Collection<String>	addJVMOptions(BenchmarkParams params) Add JVM these options to the run.
Collection<? extends Result>	afterTrial(BenchmarkResult br, long pid, File stdOut, File stdErr) Run this code after the trial is done.
boolean	allowPrintErr() If target VM communicates with profiler with standard error, this method can be used to shun the output to console.
boolean	allowPrintOut() If target VM communicates with profiler with standard output, this method can be used to shun the output to console.
void	beforeTrial(BenchmarkParams params) Run this code before starting the trial.
abstract boolean	checkSupport(List<String> msgs) Check the support for a given profiler.
protected abstract void	parseEvents() Parse profiler events from binary to text form.
protected abstract String	perfBinaryExtension() Get perf binary data extension (optional).
protected abstract AbstractPerfAsmProfiler.PerfEvents	readEvents(double skipSec) Read parsed events.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.openjdk.jmh.profile.ExternalProfiler

addJVMInvokeOptions

Methods inherited from interface org.openjdk.jmh.profile.Profiler

getDescription, label

Field Detail

tracedEvents

protected final String[] tracedEvents

hsLog

protected String hsLog

perfBinData

protected String perfBinData

perfParsedData

protected String perfParsedData

Constructor Detail

AbstractPerfAsmProfiler

protected AbstractPerfAsmProfiler(String[] events)
                           throws IOException

Throws:

IOException

Method Detail

checkSupport

public abstract boolean checkSupport(List<String> msgs)

Description copied from interface: Profiler

Check the support for a given profiler.

Specified by:

checkSupport in interface Profiler

Parameters:

msgs - where to put the diagnostic messages

Returns:

true, if supported

addJVMOptions

public Collection<String> addJVMOptions(BenchmarkParams params)

Description copied from interface: ExternalProfiler

Add JVM these options to the run.

Specified by:

addJVMOptions in interface ExternalProfiler

Parameters:

params - benchmark parameters used for current launch

Returns:

options to add to JVM launch

beforeTrial

public void beforeTrial(BenchmarkParams params)

Description copied from interface: ExternalProfiler

Run this code before starting the trial. This method will execute before starting the benchmark JVM.

Specified by:

beforeTrial in interface ExternalProfiler

Parameters:

params - benchmark parameters used for current launch

afterTrial

public Collection<? extends Result> afterTrial(BenchmarkResult br,
                                      long pid,
                                      File stdOut,
                                      File stdErr)

Description copied from interface: ExternalProfiler

Run this code after the trial is done. This method will execute after benchmark JVM had stopped.

Specified by:

afterTrial in interface ExternalProfiler

Parameters:

br - benchmark result that was the result of the trial

stdOut - file containing the standard output from the benchmark JVM

stdErr - file containing the standard error from the benchmark JVM

Returns:

profiler results

allowPrintOut

public boolean allowPrintOut()

Description copied from interface: ExternalProfiler

If target VM communicates with profiler with standard output, this method can be used to shun the output to console. Profiler is responsible for consuming the standard output and printing the relevant data from there.

Specified by:

allowPrintOut in interface ExternalProfiler

Returns:

returns true, if profiler allows harness to print out the standard output

allowPrintErr

public boolean allowPrintErr()

Description copied from interface: ExternalProfiler

If target VM communicates with profiler with standard error, this method can be used to shun the output to console. Profiler is responsible for consuming the standard error and printing the relevant data from there.

Specified by:

allowPrintErr in interface ExternalProfiler

Returns:

returns true, if profiler allows harness to print out the standard errpr

parseEvents

protected abstract void parseEvents()

Parse profiler events from binary to text form.

readEvents

protected abstract AbstractPerfAsmProfiler.PerfEvents readEvents(double skipSec)

Read parsed events.

Parameters:

skipSec - Seconds to skip.

Returns:

Events.

perfBinaryExtension

protected abstract String perfBinaryExtension()

Get perf binary data extension (optional).

Returns:

Extension.