How do I pass arguments to a Java instrumentation agent?

java arguments instrumentation javaagents
Duncan Jones picture Duncan Jones · Apr 25, 2014 · Viewed 9.4k times · Source

How do I pass arguments to a java.lang.instrument instrumentation agent? The documentation simply states:

-javaagent:jarpath[=options]

What options can I select?

Answer

Duncan Jones picture Duncan Jones · Apr 25, 2014

To pass arguments to a Java agent, append them after the equals sign:

java -javaagent:/path/to/agent.jar=argumentstring -cp jar-under-test.jar Foo.Main

The arguments are treated as a single string and passed to your premain method. You are responsible for any further processing of the arguments, e.g. splitting on commas or separating key=value pairs.

public static void premain(String agentArgument,Instrumentation instrumentation){
  // args passed in 'agentArgument'
}

Note: if you don't pass any arguments to your agent (i.e. omitting the equals sign), the agentArgument argument will be null, rather than an empty string.

Related questions

Mockito match any class argument

Is there a way to match any class argument of the below sample routine? class A { public B method(Class<? extends A> a) {} } How can I always return a new B() regardless of which class is passed into …

Read More
Java variable number or arguments for a method

Is it possible to declare a method that will allow a variable number of parameters ? What is the symbolism used in the definition that indicate that the method should allow a variable number of parameters? Answer: varargs

Read More
Netbeans how to set command line arguments in Java

I am trying to set command line arguments in a Netbeans 7.1 Java project on Windows 7 64 bit. Netbeans is not passing the arguments I give it. I go to Project --> Properties --> Run --> and type the …

Read More