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 Summary
ConstructorDescriptionConstructs anAgentInitializationException
with no detail message.Constructs anAgentInitializationException
with the specified detail message.AgentInitializationException
(String s, int returnValue) Constructs anAgentInitializationException
with the specified detail message and the return value from the execution of the agent'sAgent_OnAttach
function. -
Method Summary
Modifier and TypeMethodDescriptionint
If the exception was created with the return value from the agentAgent_OnAttach
function 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 Details
-
AgentInitializationException
public AgentInitializationException()Constructs anAgentInitializationException
with no detail message. -
AgentInitializationException
Constructs anAgentInitializationException
with the specified detail message.- Parameters:
s
- the detail message.
-
AgentInitializationException
Constructs anAgentInitializationException
with the specified detail message and the return value from the execution of the agent'sAgent_OnAttach
function.- Parameters:
s
- the detail message.returnValue
- the return value
-
-
Method Details
-
returnValue
public int returnValue()If the exception was created with the return value from the agentAgent_OnAttach
function then this returns that value, otherwise returns0
.- Returns:
- the return value
-