Serializable
public class AgentInitializationException extends Exception
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.
Constructor | Description |
---|---|
AgentInitializationException() |
Constructs an AgentInitializationException with no detail message. |
AgentInitializationException |
Constructs an AgentInitializationException with the specified detail message. |
AgentInitializationException |
Constructs an AgentInitializationException with the specified detail message and the return value from the execution of the agent's Agent_OnAttach function. |
Modifier and Type | Method | Description |
---|---|---|
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 . |
addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
public AgentInitializationException()
AgentInitializationException
with no detail message.public AgentInitializationException(String s)
AgentInitializationException
with the specified detail message.s
- the detail message.public AgentInitializationException(String s, int returnValue)
AgentInitializationException
with the specified detail message and the return value from the execution of the agent's Agent_OnAttach
function.s
- the detail message.returnValue
- the return valuepublic int returnValue()
Agent_OnAttach
function then this returns that value, otherwise returns 0
.
© 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/jdk.attach/com/sun/tools/attach/AgentInitializationException.html