- java.lang.Object
-
- java.lang.Throwable
-
- java.lang.Exception
-
- com.sun.tools.attach.AgentInitializationException
-
- All Implemented Interfaces:
Serializable
public class AgentInitializationException extends Exception
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.loadAgentPathmethods if an agent, or agent library, cannot be initialized. When thrown byVirtualMachine.loadAgentLibrary, orVirtualMachine.loadAgentPaththen the exception encapsulates the error returned by the agent'sAgent_OnAttachfunction. This error code can be obtained by invoking thereturnValuemethod.- See Also:
- Serialized Form
-
-
Constructor Summary
Constructors Constructor Description AgentInitializationException()Constructs anAgentInitializationExceptionwith no detail message.AgentInitializationException(String s)Constructs anAgentInitializationExceptionwith the specified detail message.AgentInitializationException(String s, int returnValue)Constructs anAgentInitializationExceptionwith the specified detail message and the return value from the execution of the agent'sAgent_OnAttachfunction.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description intreturnValue()If the exception was created with the return value from the agentAgent_OnAttachfunction then this returns that value, otherwise returns0.-
Methods declared in class java.lang.Throwable
addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
-
-
-
-
Constructor Detail
-
AgentInitializationException
public AgentInitializationException()
Constructs anAgentInitializationExceptionwith no detail message.
-
AgentInitializationException
public AgentInitializationException(String s)
Constructs anAgentInitializationExceptionwith the specified detail message.- Parameters:
s- the detail message.
-
AgentInitializationException
public AgentInitializationException(String s, int returnValue)
Constructs anAgentInitializationExceptionwith the specified detail message and the return value from the execution of the agent'sAgent_OnAttachfunction.- Parameters:
s- the detail message.returnValue- the return value
-
-