AgentInitializationException

extends Exception

java.lang.Object
↳	java.lang.Throwable
	↳	java.lang.Exception
		↳	com.sun.tools.attach.AgentInitializationException

Class Overview

The exception thrown when an agent fails to initialize in the target Java virtual machine.

This exception is thrown by VirtualMachine.loadAgent, VirtualMachine.loadAgentLibrary, VirtualMachine.loadAgentPath methods if an agent, or agent library, cannot be initialized. When thrown by VirtualMachine.loadAgentLibrary, or VirtualMachine.loadAgentPath then the exception encapsulates the error returned by the agent's Agent_OnAttach function. This error code can be obtained by invoking the returnValue method.

Summary

Public Constructors
	AgentInitializationException() Constructs an `AgentInitializationException` with no detail message.
	AgentInitializationException(String s) Constructs an `AgentInitializationException` with the specified detail message.
	AgentInitializationException(String s, int returnValue) Constructs an `AgentInitializationException` with the specified detail message and the return value from the execution of the agent's `Agent_OnAttach` function.

Public Methods
int	returnValue() If the exception was created with the return value from the agent `Agent_OnAttach` function then this returns that value, otherwise returns `0`.

[Expand]

Inherited Methods

From class java.lang.Throwable

From class java.lang.Object

Object	clone() Creates and returns a copy of this object.
boolean	equals(Object obj) Indicates whether some other object is "equal to" this one.
void	finalize() Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
final Class<?>	getClass() Returns the runtime class of this `Object`.
int	hashCode() Returns a hash code value for the object.
final void	notify() Wakes up a single thread that is waiting on this object's monitor.
final void	notifyAll() Wakes up all threads that are waiting on this object's monitor.
String	toString() Returns a string representation of the object.
final void	wait() Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object.
final void	wait(long timeout, int nanos) Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object, or some other thread interrupts the current thread, or a certain amount of real time has elapsed.
final void	wait(long timeout) Causes the current thread to wait until either another thread invokes the `notify()` method or the `notifyAll()` method for this object, or a specified amount of time has elapsed.

Public Constructors

public AgentInitializationException ()

Constructs an AgentInitializationException with no detail message.

public AgentInitializationException (String s)

Constructs an AgentInitializationException with the specified detail message.

Parameters

s	the detail message.

public AgentInitializationException (String s, int returnValue)

Constructs an AgentInitializationException with the specified detail message and the return value from the execution of the agent's Agent_OnAttach function.

Parameters

s	the detail message.
returnValue	the return value

Public Methods

public int returnValue ()

If the exception was created with the return value from the agent Agent_OnAttach function then this returns that value, otherwise returns 0.

Returns

the return value

Classes

Exceptions

AgentInitializationException

Class Overview

Summary

Public Constructors

public AgentInitializationException ()

public AgentInitializationException (String s)

Parameters

public AgentInitializationException (String s, int returnValue)

Parameters

Public Methods

public int returnValue ()

Returns