Save This Page
Home » openjdk-7 » com.sun.tools » attach » [javadoc | source]
com.sun.tools.attach
public class: AgentInitializationException [javadoc | source]
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.
Field Summary
static final  long serialVersionUID    use serialVersionUID for interoperability 
Fields inherited from java.lang.Exception:
serialVersionUID
Constructor:
 public AgentInitializationException() 
 public AgentInitializationException(String s) 
    Constructs an AgentInitializationException with the specified detail message.
    Parameters:
    s - the detail message.
 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
Method from com.sun.tools.attach.AgentInitializationException Summary:
returnValue
Methods from java.lang.Throwable:
fillInStackTrace,   getCause,   getLocalizedMessage,   getMessage,   getStackTrace,   initCause,   printStackTrace,   printStackTrace,   printStackTrace,   setStackTrace,   toString
Methods from java.lang.Object:
clone,   equals,   finalize,   getClass,   hashCode,   notify,   notifyAll,   toString,   wait,   wait,   wait
Method from com.sun.tools.attach.AgentInitializationException Detail:
 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.