java.lang.Object
java.lang.Throwable
java.lang.Exception
com.sun.tools.attach.AgentInitializationException
- All Implemented Interfaces:
- Serializable
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.
- See Also:
- 
Constructor SummaryConstructorsConstructorDescriptionConstructs anAgentInitializationExceptionwith no detail message.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 SummaryModifier and TypeMethodDescriptionintIf 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.ThrowableaddSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
- 
Constructor Details- 
AgentInitializationExceptionpublic AgentInitializationException()Constructs anAgentInitializationExceptionwith no detail message.
- 
AgentInitializationExceptionConstructs anAgentInitializationExceptionwith the specified detail message.- Parameters:
- s- the detail message.
 
- 
AgentInitializationExceptionConstructs 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
 
 
- 
- 
Method Details- 
returnValuepublic int returnValue()If the exception was created with the return value from the agentAgent_OnAttachfunction then this returns that value, otherwise returns0.- Returns:
- the return value
 
 
-