Class 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.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:
Serialized Form

Constructors

Constructor Description
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.

Methods

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.

Methods declared in class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods declared in class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructors

AgentInitializationException

public AgentInitializationException()

Constructs an AgentInitializationException with no detail message.

AgentInitializationException

public AgentInitializationException(String s)

Constructs an AgentInitializationException with the specified detail message.

Parameters:
s - the detail message.

AgentInitializationException

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

Methods

returnValue

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

© 1993, 2020, 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/11/docs/api/jdk.attach/com/sun/tools/attach/AgentInitializationException.html