Package es.bsc.dataclay.extrae

Class DataClayExtrae

java.lang.Object

es.bsc.dataclay.extrae.DataClayExtrae

public final class DataClayExtrae
extends Object

This utility class contains functions for Extrae tracing.

Field Summary

Fields

Modifier and Type	Field	Description
static boolean	COMPILE_EXTRAE
static boolean	extraeTracing	Indicates that Extrae tracing is activated.

Constructor Summary

Constructors

Constructor	Description
DataClayExtrae()

Method Summary

Modifier and Type	Method	Description
static void	defineEventTypes()	Method to define event types for Extrae/Paraver based on current known called methods.
static void	disableExtraeTracing()	Disable Extrae tracing
static void	disablePThreads()	When using extrae's tracing, this call disables the instrumentation of any created threads from here onwards.
static void	emitEvent(boolean enter, String methodSignature)	Add an event
static void	enableExtraeTracing()	Enable Extrae tracing
static void	enablePThreads()	When using extrae's tracing, this call enables the instrumentation of ALL created threads from here onwards.
static boolean	extraeTracingIsEnabled()	Indicates if Extrae tracing is enabled
static void	finishTracing(boolean finalizeWrapper)	Finish tracing
static int	getAndIncrementCurrentAvailableTaskID()	Get current available task ID and increment it by one.
static int	getCurrentAvailableTaskID()	Get current available task ID
static int	getTaskID()	Get Extrae task ID
static Map<String,byte[]>	getTraces()	Get Extrae traces in workspace directory
static int	getWrapperTaskID()	Get WRAPPER Extrae task ID
static void	initializeExtrae(boolean initializeWrapper)	Prepare Extrae tracing
static boolean	isGeneratedTraces()	Indicates there are generated traces ready.
static void	setCurrentAvailableTaskID(int thecurrentAvailableTaskID)	Set current available task ID

Methods inherited from class java.lang.Object

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

Field Detail

COMPILE_EXTRAE

public static final boolean COMPILE_EXTRAE

See Also:

Constant Field Values

extraeTracing

public static boolean extraeTracing

Indicates that Extrae tracing is activated.

Constructor Detail

DataClayExtrae

public DataClayExtrae()

Method Detail

initializeExtrae

public static void initializeExtrae(boolean initializeWrapper)

Prepare Extrae tracing

enableExtraeTracing

public static void enableExtraeTracing()

Enable Extrae tracing

disableExtraeTracing

public static void disableExtraeTracing()

Disable Extrae tracing

finishTracing

public static void finishTracing(boolean finalizeWrapper)

Finish tracing

emitEvent

public static void emitEvent(boolean enter,
                             String methodSignature)

Add an event

Parameters:

enter - Event type (enter, exit, exception)

methodSignature - Method signature

enablePThreads

public static void enablePThreads()

When using extrae's tracing, this call enables the instrumentation of ALL created threads from here onwards. To deactivate it use disablePThreads().

disablePThreads

public static void disablePThreads()

When using extrae's tracing, this call disables the instrumentation of any created threads from here onwards. To reactivate it use enablePThreads()

defineEventTypes

public static void defineEventTypes()

Method to define event types for Extrae/Paraver based on current known called methods.

extraeTracingIsEnabled

public static boolean extraeTracingIsEnabled()

Indicates if Extrae tracing is enabled

Returns:

True if it is active.

getTaskID

public static int getTaskID()

Get Extrae task ID

Returns:

task ID

getWrapperTaskID

public static int getWrapperTaskID()

Get WRAPPER Extrae task ID

Returns:

task ID

getCurrentAvailableTaskID

public static int getCurrentAvailableTaskID()

Get current available task ID

Returns:

Current available task ID

getAndIncrementCurrentAvailableTaskID

public static int getAndIncrementCurrentAvailableTaskID()

Get current available task ID and increment it by one.

Returns:

Current available task ID

setCurrentAvailableTaskID

public static void setCurrentAvailableTaskID(int thecurrentAvailableTaskID)

Set current available task ID

Parameters:

thecurrentAvailableTaskID - Current available task ID

getTraces

public static Map<String,byte[]> getTraces()

Get Extrae traces in workspace directory

Returns:

isGeneratedTraces

public static boolean isGeneratedTraces()

Indicates there are generated traces ready.

Returns:

TRUE if there are generated traces ready.