Package org.agrona.agent

Class BufferAlignmentAgent

java.lang.Object

org.agrona.agent.BufferAlignmentAgent

public final class BufferAlignmentAgent
extends Object

A Java agent that verifies that all memory accesses in DirectBuffer implementations are aligned.

Unaligned accesses can be slower or even make the JVM crash on some architectures.

Using this agent will avoid such crashes, but it has a performance overhead and should only be used for testing and debugging.

Method Summary

Modifier and Type	Method	Description
static void	agentmain(String agentArgs, Instrumentation instrumentation)	Invoked when the agent is attached to an already running application.
static void	premain(String agentArgs, Instrumentation instrumentation)	Invoked when the agent is launched with the JVM and before the main application.
static void	removeTransformer()	Remove the bytecode transformer and associated bytecode weaving so the alignment checks are not made.

Methods inherited from class java.lang.Object

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

Method Details

premain

public static void premain(String agentArgs,
 Instrumentation instrumentation)

Invoked when the agent is launched with the JVM and before the main application.

Parameters:

agentArgs - ignored for buffer alignment agent.

instrumentation - for adding bytecode to classes.

agentmain

public static void agentmain(String agentArgs,
 Instrumentation instrumentation)

Invoked when the agent is attached to an already running application.

Parameters:

agentArgs - ignored for buffer alignment agent.

instrumentation - for adding bytecode to classes.

removeTransformer

public static void removeTransformer()

Remove the bytecode transformer and associated bytecode weaving so the alignment checks are not made.