0N/A/*
2362N/A * Copyright (c) 1998, 2006, Oracle and/or its affiliates. All rights reserved.
0N/A * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
0N/A *
0N/A * This code is free software; you can redistribute it and/or modify it
0N/A * under the terms of the GNU General Public License version 2 only, as
2362N/A * published by the Free Software Foundation. Oracle designates this
0N/A * particular file as subject to the "Classpath" exception as provided
2362N/A * by Oracle in the LICENSE file that accompanied this code.
0N/A *
0N/A * This code is distributed in the hope that it will be useful, but WITHOUT
0N/A * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
0N/A * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
0N/A * version 2 for more details (a copy is included in the LICENSE file that
0N/A * accompanied this code).
0N/A *
0N/A * You should have received a copy of the GNU General Public License version
0N/A * 2 along with this work; if not, write to the Free Software Foundation,
0N/A * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
0N/A *
2362N/A * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
2362N/A * or visit www.oracle.com if you need additional information or have any
2362N/A * questions.
0N/A */
0N/A
0N/AJDWP "Java(tm) Debug Wire Protocol"
0N/A(CommandSet VirtualMachine=1
0N/A (Command Version=1
0N/A "Returns the JDWP version implemented by the target VM. "
0N/A "The version string format is implementation dependent. "
0N/A (Out
0N/A )
0N/A (Reply
0N/A (string description "Text information on the VM version")
0N/A (int jdwpMajor "Major JDWP Version number")
0N/A (int jdwpMinor "Minor JDWP Version number")
0N/A (string vmVersion "Target VM JRE version, as in the java.version property")
0N/A (string vmName "Target VM name, as in the java.vm.name property")
0N/A )
0N/A (ErrorSet
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A (Command ClassesBySignature=2
0N/A "Returns reference types for all the classes loaded by the target VM "
0N/A "which match the given signature. "
0N/A "Multple reference types will be returned if two or more class "
0N/A "loaders have loaded a class of the same name. "
0N/A "The search is confined to loaded classes only; no attempt is made "
0N/A "to load a class of the given signature. "
0N/A (Out
0N/A (string signature "JNI signature of the class to find "
0N/A "(for example, \"Ljava/lang/String;\"). "
0N/A )
0N/A )
0N/A (Reply
0N/A (Repeat classes "Number of reference types that follow."
0N/A (Group ClassInfo
0N/A (byte refTypeTag "<a href=\"#JDWP_TypeTag\">Kind</a> "
0N/A "of following reference type. ")
0N/A (referenceTypeID typeID "Matching loaded reference type")
0N/A (int status "The current class "
0N/A "<a href=\"#JDWP_ClassStatus\">status.</a> ")
0N/A )
0N/A )
0N/A )
0N/A (ErrorSet
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A (Command AllClasses=3
0N/A "Returns reference types for all classes currently loaded by the "
0N/A "target VM."
0N/A (Out
0N/A )
0N/A (Reply
0N/A (Repeat classes "Number of reference types that follow."
0N/A (Group ClassInfo
0N/A (byte refTypeTag "<a href=\"#JDWP_TypeTag\">Kind</a> "
0N/A "of following reference type. ")
0N/A (referenceTypeID typeID "Loaded reference type")
0N/A (string signature
0N/A "The JNI signature of the loaded reference type")
0N/A (int status "The current class "
0N/A "<a href=\"#JDWP_ClassStatus\">status.</a> ")
0N/A )
0N/A )
0N/A )
0N/A (ErrorSet
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A (Command AllThreads=4
0N/A "Returns all threads currently running in the target VM . "
0N/A "The returned list contains threads created through "
0N/A "java.lang.Thread, all native threads attached to "
0N/A "the target VM through JNI, and system threads created "
0N/A "by the target VM. Threads that have not yet been started "
0N/A "and threads that have completed their execution are not "
0N/A "included in the returned list. "
0N/A (Out
0N/A )
0N/A (Reply
0N/A (Repeat threads "Number of threads that follow."
0N/A (threadObject thread "A running thread")
0N/A )
0N/A )
0N/A (ErrorSet
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A (Command TopLevelThreadGroups=5
0N/A "Returns all thread groups that do not have a parent. This command "
0N/A "may be used as the first step in building a tree (or trees) of the "
0N/A "existing thread groups."
0N/A (Out
0N/A )
0N/A (Reply
0N/A (Repeat groups "Number of thread groups that follow."
0N/A (threadGroupObject group "A top level thread group")
0N/A )
0N/A )
0N/A (ErrorSet
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A (Command Dispose=6
0N/A "Invalidates this virtual machine mirror. "
0N/A "The communication channel to the target VM is closed, and "
0N/A "the target VM prepares to accept another subsequent connection "
0N/A "from this debugger or another debugger, including the "
0N/A "following tasks: "
0N/A "<ul>"
0N/A "<li>All event requests are cancelled. "
0N/A "<li>All threads suspended by the thread-level "
0N/A "<a href=\"#JDWP_ThreadReference_Resume\">resume</a> command "
0N/A "or the VM-level "
0N/A "<a href=\"#JDWP_VirtualMachine_Resume\">resume</a> command "
0N/A "are resumed as many times as necessary for them to run. "
0N/A "<li>Garbage collection is re-enabled in all cases where it was "
0N/A "<a href=\"#JDWP_ObjectReference_DisableCollection\">disabled</a> "
0N/A "</ul>"
0N/A "Any current method invocations executing in the target VM "
0N/A "are continued after the disconnection. Upon completion of any such "
0N/A "method invocation, the invoking thread continues from the "
0N/A "location where it was originally stopped. "
0N/A "<p>"
0N/A "Resources originating in "
0N/A "this VirtualMachine (ObjectReferences, ReferenceTypes, etc.) "
0N/A "will become invalid. "
0N/A (Out
0N/A )
0N/A (Reply
0N/A )
0N/A (ErrorSet
0N/A )
0N/A )
0N/A (Command IDSizes=7
0N/A "Returns the sizes of variably-sized data types in the target VM."
0N/A "The returned values indicate the number of bytes used by the "
0N/A "identifiers in command and reply packets."
0N/A (Out
0N/A )
0N/A (Reply
0N/A (int fieldIDSize "fieldID size in bytes ")
0N/A (int methodIDSize "methodID size in bytes ")
0N/A (int objectIDSize "objectID size in bytes ")
0N/A (int referenceTypeIDSize "referenceTypeID size in bytes ")
0N/A (int frameIDSize "frameID size in bytes ")
0N/A )
0N/A (ErrorSet
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A (Command Suspend=8
0N/A "Suspends the execution of the application running in the target "
0N/A "VM. All Java threads currently running will be suspended. "
0N/A "<p>"
0N/A "Unlike java.lang.Thread.suspend, "
0N/A "suspends of both the virtual machine and individual threads are "
0N/A "counted. Before a thread will run again, it must be resumed through "
0N/A "the <a href=\"#JDWP_VirtualMachine_Resume\">VM-level resume</a> command "
0N/A "or the <a href=\"#JDWP_ThreadReference_Resume\">thread-level resume</a> command "
0N/A "the same number of times it has been suspended. "
0N/A (Out
0N/A )
0N/A (Reply
0N/A )
0N/A (ErrorSet
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A (Command Resume=9
0N/A "Resumes execution of the application after the suspend "
0N/A "command or an event has stopped it. "
0N/A "Suspensions of the Virtual Machine and individual threads are "
0N/A "counted. If a particular thread is suspended n times, it must "
0N/A "resumed n times before it will continue. "
0N/A (Out
0N/A )
0N/A (Reply
0N/A )
0N/A (ErrorSet
0N/A )
0N/A )
0N/A (Command Exit=10
0N/A "Terminates the target VM with the given exit code. "
0N/A "On some platforms, the exit code might be truncated, for "
0N/A "example, to the low order 8 bits. "
0N/A "All ids previously returned from the target VM become invalid. "
0N/A "Threads running in the VM are abruptly terminated. "
0N/A "A thread death exception is not thrown and "
0N/A "finally blocks are not run."
0N/A (Out
0N/A (int exitCode "the exit code")
0N/A )
0N/A (Reply
0N/A )
0N/A (ErrorSet
0N/A )
0N/A )
0N/A (Command CreateString=11
0N/A "Creates a new string object in the target VM and returns "
0N/A "its id. "
0N/A (Out
0N/A (string utf "UTF-8 characters to use in the created string. ")
0N/A )
0N/A (Reply
0N/A (stringObject stringObject
0N/A "Created string (instance of java.lang.String) ")
0N/A )
0N/A (ErrorSet
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A (Command Capabilities=12
0N/A "Retrieve this VM's capabilities. The capabilities are returned "
0N/A "as booleans, each indicating the presence or absence of a "
0N/A "capability. The commands associated with each capability will "
0N/A "return the NOT_IMPLEMENTED error if the cabability is not "
0N/A "available."
0N/A (Out
0N/A )
0N/A (Reply
0N/A (boolean canWatchFieldModification
0N/A "Can the VM watch field modification, and therefore "
0N/A "can it send the Modification Watchpoint Event?")
0N/A (boolean canWatchFieldAccess
0N/A "Can the VM watch field access, and therefore "
0N/A "can it send the Access Watchpoint Event?")
0N/A (boolean canGetBytecodes
0N/A "Can the VM get the bytecodes of a given method? ")
0N/A (boolean canGetSyntheticAttribute
0N/A "Can the VM determine whether a field or method is "
0N/A "synthetic? (that is, can the VM determine if the "
0N/A "method or the field was invented by the compiler?) ")
0N/A (boolean canGetOwnedMonitorInfo
0N/A "Can the VM get the owned monitors infornation for "
0N/A "a thread?")
0N/A (boolean canGetCurrentContendedMonitor
0N/A "Can the VM get the current contended monitor of a thread?")
0N/A (boolean canGetMonitorInfo
0N/A "Can the VM get the monitor information for a given object? ")
0N/A )
0N/A (ErrorSet
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A (Command ClassPaths=13
0N/A "Retrieve the classpath and bootclasspath of the target VM. "
0N/A "If the classpath is not defined, returns an empty list. If the "
0N/A "bootclasspath is not defined returns an empty list."
0N/A (Out
0N/A )
0N/A (Reply
0N/A (string baseDir "Base directory used to resolve relative "
0N/A "paths in either of the following lists.")
0N/A (Repeat classpaths "Number of paths in classpath."
0N/A (string path "One component of classpath") )
0N/A (Repeat bootclasspaths "Number of paths in bootclasspath."
0N/A (string path "One component of bootclasspath") )
0N/A )
0N/A (ErrorSet
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A (Command DisposeObjects=14
0N/A "Releases a list of object IDs. For each object in the list, the "
0N/A "following applies. "
0N/A "The count of references held by the back-end (the reference "
0N/A "count) will be decremented by refCnt. "
0N/A "If thereafter the reference count is less than "
0N/A "or equal to zero, the ID is freed. "
0N/A "Any back-end resources associated with the freed ID may "
0N/A "be freed, and if garbage collection was "
0N/A "disabled for the object, it will be re-enabled. "
0N/A "The sender of this command "
0N/A "promises that no further commands will be sent "
0N/A "referencing a freed ID.
0N/A "<p>"
0N/A "Use of this command is not required. If it is not sent, "
0N/A "resources associated with each ID will be freed by the back-end "
0N/A "at some time after the corresponding object is garbage collected. "
0N/A "It is most useful to use this command to reduce the load on the "
0N/A "back-end if a very large number of "
0N/A "objects has been retrieved from the back-end (a large array, "
0N/A "for example) but may not be garbage collected any time soon. "
0N/A "<p>"
0N/A "IDs may be re-used by the back-end after they "
0N/A "have been freed with this command."
0N/A "This description assumes reference counting, "
0N/A "a back-end may use any implementation which operates "
0N/A "equivalently. "
0N/A (Out
0N/A (Repeat requests "Number of object dispose requests that follow"
0N/A (Group Request
0N/A (object object "The object ID")
0N/A (int refCnt "The number of times this object ID has been "
0N/A "part of a packet received from the back-end. "
0N/A "An accurate count prevents the object ID "
0N/A "from being freed on the back-end if "
0N/A "it is part of an incoming packet, not yet "
0N/A "handled by the front-end.")
0N/A )
0N/A )
0N/A )
0N/A (Reply
0N/A )
0N/A (ErrorSet
0N/A )
0N/A )
0N/A (Command HoldEvents=15
0N/A "Tells the target VM to stop sending events. Events are not discarded; "
0N/A "they are held until a subsequent ReleaseEvents command is sent. "
0N/A "This command is useful to control the number of events sent "
0N/A "to the debugger VM in situations where very large numbers of events "
0N/A "are generated. "
0N/A "While events are held by the debugger back-end, application "
0N/A "execution may be frozen by the debugger back-end to prevent "
0N/A "buffer overflows on the back end.
0N/A "Responses to commands are never held and are not affected by this
0N/A "command. If events are already being held, this command is "
0N/A "ignored."
0N/A (Out
0N/A )
0N/A (Reply
0N/A )
0N/A (ErrorSet
0N/A )
0N/A )
0N/A (Command ReleaseEvents=16
0N/A "Tells the target VM to continue sending events. This command is "
0N/A "used to restore normal activity after a HoldEvents command. If "
0N/A "there is no current HoldEvents command in effect, this command is "
0N/A "ignored."
0N/A (Out
0N/A )
0N/A (Reply
0N/A )
0N/A (ErrorSet
0N/A )
0N/A )
0N/A (Command CapabilitiesNew=17
0N/A "Retrieve all of this VM's capabilities. The capabilities are returned "
0N/A "as booleans, each indicating the presence or absence of a "
0N/A "capability. The commands associated with each capability will "
0N/A "return the NOT_IMPLEMENTED error if the cabability is not "
0N/A "available."
0N/A "Since JDWP version 1.4."
0N/A (Out
0N/A )
0N/A (Reply
0N/A (boolean canWatchFieldModification
0N/A "Can the VM watch field modification, and therefore "
0N/A "can it send the Modification Watchpoint Event?")
0N/A (boolean canWatchFieldAccess
0N/A "Can the VM watch field access, and therefore "
0N/A "can it send the Access Watchpoint Event?")
0N/A (boolean canGetBytecodes
0N/A "Can the VM get the bytecodes of a given method? ")
0N/A (boolean canGetSyntheticAttribute
0N/A "Can the VM determine whether a field or method is "
0N/A "synthetic? (that is, can the VM determine if the "
0N/A "method or the field was invented by the compiler?) ")
0N/A (boolean canGetOwnedMonitorInfo
0N/A "Can the VM get the owned monitors infornation for "
0N/A "a thread?")
0N/A (boolean canGetCurrentContendedMonitor
0N/A "Can the VM get the current contended monitor of a thread?")
0N/A (boolean canGetMonitorInfo
0N/A "Can the VM get the monitor information for a given object? ")
0N/A (boolean canRedefineClasses
0N/A "Can the VM redefine classes?")
0N/A (boolean canAddMethod
0N/A "Can the VM add methods when redefining "
0N/A "classes?")
0N/A (boolean canUnrestrictedlyRedefineClasses
0N/A "Can the VM redefine classes"
0N/A "in arbitrary ways?")
0N/A (boolean canPopFrames
0N/A "Can the VM pop stack frames?")
0N/A (boolean canUseInstanceFilters
0N/A "Can the VM filter events by specific object?")
0N/A (boolean canGetSourceDebugExtension
0N/A "Can the VM get the source debug extension?")
0N/A (boolean canRequestVMDeathEvent
0N/A "Can the VM request VM death events?")
0N/A (boolean canSetDefaultStratum
0N/A "Can the VM set a default stratum?")
0N/A (boolean canGetInstanceInfo
0N/A "Can the VM return instances, counts of instances of classes "
0N/A "and referring objects?")
0N/A (boolean canRequestMonitorEvents
0N/A "Can the VM request monitor events?")
0N/A (boolean canGetMonitorFrameInfo
0N/A "Can the VM get monitors with frame depth info?")
0N/A (boolean canUseSourceNameFilters
0N/A "Can the VM filter class prepare events by source name?")
0N/A (boolean canGetConstantPool
0N/A "Can the VM return the constant pool information?")
0N/A (boolean canForceEarlyReturn
0N/A "Can the VM force early return from a method?")
0N/A (boolean reserved22
0N/A "Reserved for future capability")
0N/A (boolean reserved23
0N/A "Reserved for future capability")
0N/A (boolean reserved24
0N/A "Reserved for future capability")
0N/A (boolean reserved25
0N/A "Reserved for future capability")
0N/A (boolean reserved26
0N/A "Reserved for future capability")
0N/A (boolean reserved27
0N/A "Reserved for future capability")
0N/A (boolean reserved28
0N/A "Reserved for future capability")
0N/A (boolean reserved29
0N/A "Reserved for future capability")
0N/A (boolean reserved30
0N/A "Reserved for future capability")
0N/A (boolean reserved31
0N/A "Reserved for future capability")
0N/A (boolean reserved32
0N/A "Reserved for future capability")
0N/A )
0N/A (ErrorSet
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A (Command RedefineClasses=18
0N/A "Installs new class definitions. "
0N/A "If there are active stack frames in methods of the redefined classes in the "
0N/A "target VM then those active frames continue to run the bytecodes of the "
0N/A "original method. These methods are considered obsolete - see "
0N/A "<a href=\"#JDWP_Method_IsObsolete\">IsObsolete</a>. The methods in the "
0N/A "redefined classes will be used for new invokes in the target VM. "
0N/A "The original method ID refers to the redefined method. "
0N/A "All breakpoints in the redefined classes are cleared."
0N/A "If resetting of stack frames is desired, the "
0N/A "<a href=\"#JDWP_StackFrame_PopFrames\">PopFrames</a> command can be used "
0N/A "to pop frames with obsolete methods."
0N/A "<p>"
0N/A "Requires canRedefineClasses capability - see "
0N/A "<a href=\"#JDWP_VirtualMachine_CapabilitiesNew\">CapabilitiesNew</a>. "
0N/A "In addition to the canRedefineClasses capability, the target VM must "
0N/A "have the canAddMethod capability to add methods when redefining classes, "
0N/A "or the canUnrestrictedlyRedefineClasses to redefine classes in arbitrary "
0N/A "ways."
0N/A (Out
0N/A (Repeat classes "Number of reference types that follow."
0N/A (Group ClassDef
0N/A (referenceType refType "The reference type.")
0N/A (Repeat classfile "Number of bytes defining class (below)"
0N/A (byte classbyte "byte in JVM class file "
0N/A "format.")
0N/A )
0N/A )
0N/A )
0N/A )
0N/A (Reply
0N/A )
0N/A (ErrorSet
0N/A (Error INVALID_CLASS "One of the refTypes is not the ID of a reference "
0N/A "type.")
0N/A (Error INVALID_OBJECT "One of the refTypes is not a known ID.")
0N/A (Error UNSUPPORTED_VERSION)
0N/A (Error INVALID_CLASS_FORMAT)
0N/A (Error CIRCULAR_CLASS_DEFINITION)
0N/A (Error FAILS_VERIFICATION)
0N/A (Error NAMES_DONT_MATCH)
0N/A (Error NOT_IMPLEMENTED "No aspect of this functionality is implemented "
0N/A "(CapabilitiesNew.canRedefineClasses is false)")
0N/A (Error ADD_METHOD_NOT_IMPLEMENTED)
0N/A (Error SCHEMA_CHANGE_NOT_IMPLEMENTED)
0N/A (Error HIERARCHY_CHANGE_NOT_IMPLEMENTED)
0N/A (Error DELETE_METHOD_NOT_IMPLEMENTED)
0N/A (Error CLASS_MODIFIERS_CHANGE_NOT_IMPLEMENTED)
0N/A (Error METHOD_MODIFIERS_CHANGE_NOT_IMPLEMENTED)
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A (Command SetDefaultStratum=19
0N/A "Set the default stratum. Requires canSetDefaultStratum capability - see "
0N/A "<a href=\"#JDWP_VirtualMachine_CapabilitiesNew\">CapabilitiesNew</a>."
0N/A (Out
0N/A (string stratumID "default stratum, or empty string to use "
0N/A "reference type default.")
0N/A )
0N/A (Reply
0N/A )
0N/A (ErrorSet
0N/A (Error NOT_IMPLEMENTED)
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A (Command AllClassesWithGeneric=20
0N/A "Returns reference types for all classes currently loaded by the "
0N/A "target VM. "
0N/A "Both the JNI signature and the generic signature are "
0N/A "returned for each class. "
0N/A "Generic signatures are described in the signature attribute "
4008N/A "section in "
4008N/A "<cite>The Java&trade; Virtual Machine Specification</cite>. "
0N/A "Since JDWP version 1.5."
0N/A (Out
0N/A )
0N/A (Reply
0N/A (Repeat classes "Number of reference types that follow."
0N/A (Group ClassInfo
0N/A (byte refTypeTag "<a href=\"#JDWP_TypeTag\">Kind</a> "
0N/A "of following reference type. ")
0N/A (referenceTypeID typeID "Loaded reference type")
0N/A (string signature
0N/A "The JNI signature of the loaded reference type.")
0N/A (string genericSignature
0N/A "The generic signature of the loaded reference type "
0N/A "or an empty string if there is none.")
0N/A (int status "The current class "
0N/A "<a href=\"#JDWP_ClassStatus\">status.</a> ")
0N/A )
0N/A )
0N/A )
0N/A (ErrorSet
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A
0N/A (Command InstanceCounts=21
0N/A "Returns the number of instances of each reference type in the input list. "
0N/A "Only instances that are reachable for the purposes of "
0N/A "garbage collection are counted. If a reference type is invalid, "
0N/A "eg. it has been unloaded, zero is returned for its instance count."
0N/A "<p>Since JDWP version 1.6. Requires canGetInstanceInfo capability - see "
0N/A "<a href=\"#JDWP_VirtualMachine_CapabilitiesNew\">CapabilitiesNew</a>."
0N/A (Out
0N/A (Repeat refTypesCount "Number of reference types that follow. Must be non-negative."
0N/A (referenceType refType "A reference type ID.")
0N/A )
0N/A )
0N/A (Reply
0N/A (Repeat counts "The number of counts that follow."
0N/A (long instanceCount "The number of instances for the corresponding reference type "
0N/A "in 'Out Data'.")
0N/A )
0N/A )
0N/A (ErrorSet
0N/A (Error ILLEGAL_ARGUMENT "refTypesCount is less than zero.")
0N/A (Error NOT_IMPLEMENTED)
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A)
0N/A
0N/A(CommandSet ReferenceType=2
0N/A (Command Signature=1
0N/A "Returns the JNI signature of a reference type. "
0N/A "JNI signature formats are described in the "
0N/A "<a href=\"http://java.sun.com/products/jdk/1.2/docs/guide/jni/index.html\">Java Native Inteface Specification</a>"
0N/A "<p>
0N/A "For primitive classes "
0N/A "the returned signature is the signature of the corresponding primitive "
0N/A "type; for example, \"I\" is returned as the signature of the class "
0N/A "represented by java.lang.Integer.TYPE."
0N/A (Out
0N/A (referenceType refType "The reference type ID.")
0N/A )
0N/A (Reply
0N/A (string signature
0N/A "The JNI signature for the reference type.")
0N/A )
0N/A (ErrorSet
0N/A (Error INVALID_CLASS "refType is not the ID of a reference "
0N/A "type.")
0N/A (Error INVALID_OBJECT "refType is not a known ID.")
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A (Command ClassLoader=2
0N/A "Returns the instance of java.lang.ClassLoader which loaded "
0N/A "a given reference type. If the reference type was loaded by the "
0N/A "system class loader, the returned object ID is null."
0N/A (Out
0N/A (referenceType refType "The reference type ID.")
0N/A )
0N/A (Reply
0N/A (classLoaderObject classLoader "The class loader for the reference type. ")
0N/A )
0N/A (ErrorSet
0N/A (Error INVALID_CLASS "refType is not the ID of a reference "
0N/A "type.")
0N/A (Error INVALID_OBJECT "refType is not a known ID.")
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A (Command Modifiers=3
0N/A "Returns the modifiers (also known as access flags) for a reference type. "
0N/A "The returned bit mask contains information on the declaration "
0N/A "of the reference type. If the reference type is an array or "
0N/A "a primitive class (for example, java.lang.Integer.TYPE), the "
0N/A "value of the returned bit mask is undefined."
0N/A (Out
0N/A (referenceType refType "The reference type ID.")
0N/A )
0N/A (Reply
4008N/A (int modBits "Modifier bits as defined in Chapter 4 of "
4008N/A "<cite>The Java&trade; Virtual Machine Specification</cite>")
0N/A )
0N/A (ErrorSet
0N/A (Error INVALID_CLASS "refType is not the ID of a reference "
0N/A "type.")
0N/A (Error INVALID_OBJECT "refType is not a known ID.")
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A (Command Fields=4
0N/A "Returns information for each field in a reference type. "
0N/A "Inherited fields are not included. "
0N/A "The field list will include any synthetic fields created "
0N/A "by the compiler. "
0N/A "Fields are returned in the order they occur in the class file."
0N/A (Out
0N/A (referenceType refType "The reference type ID.")
0N/A )
0N/A (Reply
0N/A (Repeat declared "Number of declared fields."
0N/A (Group FieldInfo
0N/A (field fieldID "Field ID.")
0N/A (string name "Name of field.")
0N/A (string signature "JNI Signature of field.")
0N/A (int modBits "The modifier bit flags (also known as access flags) "
0N/A "which provide additional information on the "
0N/A "field declaration. Individual flag values are "
4008N/A "defined in Chapter 4 of "
4008N/A "<cite>The Java&trade; Virtual Machine Specification</cite>. "
0N/A "In addition, The <code>0xf0000000</code> bit identifies "
0N/A "the field as synthetic, if the synthetic attribute "
0N/A "<a href=\"#JDWP_VirtualMachine_Capabilities\">capability</a> is available.")
0N/A )
0N/A )
0N/A )
0N/A (ErrorSet
0N/A (Error CLASS_NOT_PREPARED)
0N/A (Error INVALID_CLASS "refType is not the ID of a reference "
0N/A "type.")
0N/A (Error INVALID_OBJECT "refType is not a known ID.")
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A (Command Methods=5
0N/A "Returns information for each method in a reference type. "
0N/A "Inherited methods are not included. The list of methods will "
0N/A "include constructors (identified with the name \"&lt;init&gt;\"), "
0N/A "the initialization method (identified with the name \"&lt;clinit&gt;\") "
0N/A "if present, and any synthetic methods created by the compiler. "
0N/A "Methods are returned in the order they occur in the class file."
0N/A (Out
0N/A (referenceType refType "The reference type ID.")
0N/A )
0N/A (Reply
0N/A (Repeat declared "Number of declared methods."
0N/A (Group MethodInfo
0N/A (method methodID "Method ID.")
0N/A (string name "Name of method.")
0N/A (string signature "JNI signature of method.")
0N/A (int modBits "The modifier bit flags (also known as access flags) "
0N/A "which provide additional information on the "
0N/A "method declaration. Individual flag values are "
4008N/A "defined in Chapter 4 of "
4008N/A "<cite>The Java&trade; Virtual Machine Specification</cite>. "
0N/A "In addition, The <code>0xf0000000</code> bit identifies "
0N/A "the method as synthetic, if the synthetic attribute "
0N/A "<a href=\"#JDWP_VirtualMachine_Capabilities\">capability</a> is available.")
0N/A )
0N/A )
0N/A )
0N/A (ErrorSet
0N/A (Error CLASS_NOT_PREPARED)
0N/A (Error INVALID_CLASS "refType is not the ID of a reference "
0N/A "type.")
0N/A (Error INVALID_OBJECT "refType is not a known ID.")
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A (Command GetValues=6
0N/A "Returns the value of one or more static fields of the "
0N/A "reference type. Each field must be member of the reference type "
0N/A "or one of its superclasses, superinterfaces, or implemented interfaces. "
0N/A "Access control is not enforced; for example, the values of private "
0N/A "fields can be obtained."
0N/A (Out
0N/A (referenceType refType "The reference type ID.")
0N/A (Repeat fields "The number of values to get"
0N/A (Group Field
0N/A (field fieldID "A field to get")
0N/A )
0N/A )
0N/A )
0N/A (Reply
0N/A (Repeat values "The number of values returned, always equal to fields, "
0N/A "the number of values to get."
0N/A (value value "The field value")
0N/A )
0N/A )
0N/A (ErrorSet
0N/A (Error INVALID_CLASS "refType is not the ID of a reference "
0N/A "type.")
0N/A (Error INVALID_OBJECT "refType is not a known ID.")
0N/A (Error INVALID_FIELDID)
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A (Command SourceFile=7
0N/A "Returns the name of source file in which a reference type was "
0N/A "declared. "
0N/A (Out
0N/A (referenceType refType "The reference type ID.")
0N/A )
0N/A (Reply
0N/A (string sourceFile "The source file name. No path information "
0N/A "for the file is included")
0N/A )
0N/A (ErrorSet
0N/A (Error INVALID_CLASS "refType is not the ID of a reference "
0N/A "type.")
0N/A (Error INVALID_OBJECT "refType is not a known ID.")
0N/A (Error ABSENT_INFORMATION "The source file attribute is absent.")
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A (Command NestedTypes=8
0N/A "Returns the classes and interfaces directly nested within this type."
0N/A "Types further nested within those types are not included. "
0N/A (Out
0N/A (referenceType refType "The reference type ID.")
0N/A )
0N/A (Reply
0N/A (Repeat classes "The number of nested classes and interfaces"
0N/A (Group TypeInfo
0N/A (byte refTypeTag "<a href=\"#JDWP_TypeTag\">Kind</a> "
0N/A "of following reference type. ")
0N/A (referenceTypeID typeID "The nested class or interface ID.")
0N/A )
0N/A )
0N/A )
0N/A (ErrorSet
0N/A (Error INVALID_CLASS "refType is not the ID of a reference "
0N/A "type.")
0N/A (Error INVALID_OBJECT "refType is not a known ID.")
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A (Command Status=9
0N/A "Returns the current status of the reference type. The status "
0N/A "indicates the extent to which the reference type has been "
4008N/A "initialized, as described in section 2.1.6 of "
4008N/A "<cite>The Java&trade; Virtual Machine Specification</cite>. "
0N/A "If the class is linked the PREPARED and VERIFIED bits in the returned status bits "
0N/A "will be set. If the class is initialized the INITIALIZED bit in the returned "
0N/A "status bits will be set. If an error occured during initialization then the "
0N/A "ERROR bit in the returned status bits will be set. "
0N/A "The returned status bits are undefined for array types and for "
0N/A "primitive classes (such as java.lang.Integer.TYPE). "
0N/A (Out
0N/A (referenceType refType "The reference type ID.")
0N/A )
0N/A (Reply
0N/A (int status "<a href=\"#JDWP_ClassStatus\">Status</a> bits:"
0N/A "See <a href=\"#JDWP_ClassStatus\">JDWP.ClassStatus</a>")
0N/A )
0N/A (ErrorSet
0N/A (Error INVALID_CLASS "refType is not the ID of a reference "
0N/A "type.")
0N/A (Error INVALID_OBJECT "refType is not a known ID.")
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A (Command Interfaces=10
0N/A "Returns the interfaces declared as implemented by this class. "
0N/A "Interfaces indirectly implemented (extended by the implemented "
0N/A "interface or implemented by a superclass) are not included."
0N/A (Out
0N/A (referenceType refType "The reference type ID.")
0N/A )
0N/A (Reply
0N/A (Repeat interfaces "The number of implemented interfaces"
0N/A (interfaceType interfaceType "implemented interface.")
0N/A )
0N/A )
0N/A (ErrorSet
0N/A (Error INVALID_CLASS "refType is not the ID of a reference "
0N/A "type.")
0N/A (Error INVALID_OBJECT "refType is not a known ID.")
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A (Command ClassObject=11
0N/A "Returns the class object corresponding to this type. "
0N/A (Out
0N/A (referenceType refType "The reference type ID.")
0N/A )
0N/A (Reply
0N/A (classObject classObject "class object.")
0N/A )
0N/A (ErrorSet
0N/A (Error INVALID_CLASS "refType is not the ID of a reference "
0N/A "type.")
0N/A (Error INVALID_OBJECT "refType is not a known ID.")
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A (Command SourceDebugExtension=12
0N/A "Returns the value of the SourceDebugExtension attribute. "
0N/A "Since JDWP version 1.4. Requires canGetSourceDebugExtension capability - see "
0N/A "<a href=\"#JDWP_VirtualMachine_CapabilitiesNew\">CapabilitiesNew</a>."
0N/A (Out
0N/A (referenceType refType "The reference type ID.")
0N/A )
0N/A (Reply
0N/A (string extension "extension attribute")
0N/A )
0N/A (ErrorSet
0N/A (Error INVALID_CLASS "refType is not the ID of a reference "
0N/A "type.")
0N/A (Error INVALID_OBJECT "refType is not a known ID.")
0N/A (Error ABSENT_INFORMATION "If the extension is not specified.")
0N/A (Error NOT_IMPLEMENTED)
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A (Command SignatureWithGeneric=13
0N/A "Returns the JNI signature of a reference type along with the "
0N/A "generic signature if there is one. "
0N/A "Generic signatures are described in the signature attribute "
4008N/A "section in "
4008N/A "<cite>The Java&trade; Virtual Machine Specification</cite>. "
0N/A "Since JDWP version 1.5."
0N/A "<p>
0N/A (Out
0N/A (referenceType refType "The reference type ID.")
0N/A )
0N/A (Reply
0N/A (string signature
0N/A "The JNI signature for the reference type.")
0N/A (string genericSignature
0N/A "The generic signature for the reference type or an empty "
0N/A "string if there is none.")
0N/A )
0N/A (ErrorSet
0N/A (Error INVALID_CLASS "refType is not the ID of a reference "
0N/A "type.")
0N/A (Error INVALID_OBJECT "refType is not a known ID.")
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A (Command FieldsWithGeneric=14
0N/A "Returns information, including the generic signature if any, "
0N/A "for each field in a reference type. "
0N/A "Inherited fields are not included. "
0N/A "The field list will include any synthetic fields created "
0N/A "by the compiler. "
0N/A "Fields are returned in the order they occur in the class file. "
0N/A "Generic signatures are described in the signature attribute "
4008N/A "section in "
4008N/A "<cite>The Java&trade; Virtual Machine Specification</cite>. "
0N/A "Since JDWP version 1.5."
0N/A (Out
0N/A (referenceType refType "The reference type ID.")
0N/A )
0N/A (Reply
0N/A (Repeat declared "Number of declared fields."
0N/A (Group FieldInfo
0N/A (field fieldID "Field ID.")
0N/A (string name "The name of the field.")
0N/A (string signature "The JNI signature of the field.")
0N/A (string genericSignature "The generic signature of the "
0N/A "field, or an empty string if there is none.")
0N/A (int modBits "The modifier bit flags (also known as access flags) "
0N/A "which provide additional information on the "
0N/A "field declaration. Individual flag values are "
4008N/A "defined in Chapter 4 of "
4008N/A "<cite>The Java&trade; Virtual Machine Specification</cite>. "
0N/A "In addition, The <code>0xf0000000</code> bit identifies "
0N/A "the field as synthetic, if the synthetic attribute "
0N/A "<a href=\"#JDWP_VirtualMachine_Capabilities\">capability</a> is available.")
0N/A )
0N/A )
0N/A )
0N/A (ErrorSet
0N/A (Error CLASS_NOT_PREPARED)
0N/A (Error INVALID_CLASS "refType is not the ID of a reference "
0N/A "type.")
0N/A (Error INVALID_OBJECT "refType is not a known ID.")
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A (Command MethodsWithGeneric=15
0N/A "Returns information, including the generic signature if any, "
0N/A "for each method in a reference type. "
0N/A "Inherited methodss are not included. The list of methods will "
0N/A "include constructors (identified with the name \"&lt;init&gt;\"), "
0N/A "the initialization method (identified with the name \"&lt;clinit&gt;\") "
0N/A "if present, and any synthetic methods created by the compiler. "
0N/A "Methods are returned in the order they occur in the class file. "
0N/A "Generic signatures are described in the signature attribute "
4008N/A "section in "
4008N/A "<cite>The Java&trade; Virtual Machine Specification</cite>. "
0N/A "Since JDWP version 1.5."
0N/A (Out
0N/A (referenceType refType "The reference type ID.")
0N/A )
0N/A (Reply
0N/A (Repeat declared "Number of declared methods."
0N/A (Group MethodInfo
0N/A (method methodID "Method ID.")
0N/A (string name "The name of the method.")
0N/A (string signature "The JNI signature of the method.")
0N/A (string genericSignature "The generic signature of the method, or "
0N/A "an empty string if there is none.")
0N/A (int modBits "The modifier bit flags (also known as access flags) "
0N/A "which provide additional information on the "
0N/A "method declaration. Individual flag values are "
4008N/A "defined in Chapter 4 of "
4008N/A "<cite>The Java&trade; Virtual Machine Specification</cite>. "
0N/A "In addition, The <code>0xf0000000</code> bit identifies "
0N/A "the method as synthetic, if the synthetic attribute "
0N/A "<a href=\"#JDWP_VirtualMachine_Capabilities\">capability</a> is available.")
0N/A )
0N/A )
0N/A )
0N/A (ErrorSet
0N/A (Error CLASS_NOT_PREPARED)
0N/A (Error INVALID_CLASS "refType is not the ID of a reference "
0N/A "type.")
0N/A (Error INVALID_OBJECT "refType is not a known ID.")
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A (Command Instances=16
0N/A "Returns instances of this reference type. "
0N/A "Only instances that are reachable for the purposes of "
0N/A "garbage collection are returned. "
0N/A "<p>Since JDWP version 1.6. Requires canGetInstanceInfo capability - see "
0N/A "<a href=\"#JDWP_VirtualMachine_CapabilitiesNew\">CapabilitiesNew</a>."
0N/A (Out
0N/A (referenceType refType "The reference type ID.")
0N/A (int maxInstances "Maximum number of instances to return. Must be non-negative. "
0N/A "If zero, all instances are returned.")
0N/A )
0N/A (Reply
0N/A (Repeat instances "The number of instances that follow."
0N/A (tagged-object instance "An instance of this reference type.")
0N/A )
0N/A )
0N/A (ErrorSet
0N/A (Error INVALID_CLASS "refType is not the ID of a reference "
0N/A "type.")
0N/A (Error INVALID_OBJECT "refType is not a known ID.")
0N/A (Error ILLEGAL_ARGUMENT "maxInstances is less than zero.")
0N/A (Error NOT_IMPLEMENTED)
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A (Command ClassFileVersion=17
0N/A "Returns the class file major and minor version numbers, as defined in the class "
0N/A "file format of the Java Virtual Machine specification. "
0N/A "<p>Since JDWP version 1.6. "
0N/A (Out
0N/A (referenceType refType "The class.")
0N/A )
0N/A (Reply
0N/A (int majorVersion "Major version number")
0N/A (int minorVersion "Minor version number")
0N/A )
0N/A (ErrorSet
0N/A (Error INVALID_CLASS "refType is not the ID of a reference "
0N/A "type.")
0N/A (Error INVALID_OBJECT "refType is not a known ID.")
0N/A (Error ABSENT_INFORMATION "The class file version information is "
0N/A "absent for primitive and array types.")
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A (Command ConstantPool=18
0N/A "Return the raw bytes of the constant pool in the format of the "
4008N/A "constant_pool item of the Class File Format in "
4008N/A "<cite>The Java&trade; Virtual Machine Specification</cite>. "
0N/A "<p>Since JDWP version 1.6. Requires canGetConstantPool capability - see "
0N/A "<a href=\"#JDWP_VirtualMachine_CapabilitiesNew\">CapabilitiesNew</a>.""
0N/A (Out
0N/A (referenceType refType "The class.")
0N/A )
0N/A (Reply
0N/A (int count "Total number of constant pool entries plus one. This "
0N/A "corresponds to the constant_pool_count item of the "
4008N/A "Class File Format in "
4008N/A "<cite>The Java&trade; Virtual Machine Specification</cite>. ")
0N/A (Repeat bytes
0N/A (byte cpbytes "Raw bytes of constant pool")
0N/A )
0N/A )
0N/A (ErrorSet
0N/A (Error INVALID_CLASS "refType is not the ID of a reference "
0N/A "type.")
0N/A (Error INVALID_OBJECT "refType is not a known ID.")
0N/A (Error NOT_IMPLEMENTED "If the target virtual machine does not "
0N/A "support the retrieval of constant pool information.")
0N/A (Error ABSENT_INFORMATION "The Constant Pool information is "
0N/A "absent for primitive and array types.")
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A)
0N/A(CommandSet ClassType=3
0N/A (Command Superclass=1
0N/A "Returns the immediate superclass of a class."
0N/A (Out
0N/A (classType clazz "The class type ID.")
0N/A )
0N/A (Reply
0N/A (classType superclass
0N/A "The superclass (null if the class ID for java.lang.Object is specified).")
0N/A )
0N/A (ErrorSet
0N/A (Error INVALID_CLASS "clazz is not the ID of a class.")
0N/A (Error INVALID_OBJECT "clazz is not a known ID.")
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A (Command SetValues=2
0N/A "Sets the value of one or more static fields. "
0N/A "Each field must be member of the class type "
0N/A "or one of its superclasses, superinterfaces, or implemented interfaces. "
0N/A "Access control is not enforced; for example, the values of private "
0N/A "fields can be set. Final fields cannot be set."
0N/A "For primitive values, the value's type must match the "
0N/A "field's type exactly. For object values, there must exist a "
0N/A "widening reference conversion from the value's type to the
0N/A "field's type and the field's type must be loaded. "
0N/A (Out
0N/A (classType clazz "The class type ID.")
0N/A (Repeat values "The number of fields to set."
0N/A (Group FieldValue "A Field/Value pair."
0N/A (field fieldID "Field to set.")
0N/A (untagged-value value "Value to put in the field.")
0N/A )
0N/A )
0N/A )
0N/A (Reply "none"
0N/A )
0N/A (ErrorSet
0N/A (Error INVALID_CLASS "clazz is not the ID of a class.")
0N/A (Error CLASS_NOT_PREPARED)
0N/A (Error INVALID_OBJECT "clazz is not a known ID or a value of an "
0N/A "object field is not a known ID.")
0N/A (Error INVALID_FIELDID)
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A (Command InvokeMethod=3
0N/A "Invokes a static method. "
0N/A "The method must be member of the class type "
0N/A "or one of its superclasses, superinterfaces, or implemented interfaces. "
0N/A "Access control is not enforced; for example, private "
0N/A "methods can be invoked."
0N/A "<p>"
0N/A "The method invocation will occur in the specified thread. "
0N/A "Method invocation can occur only if the specified thread "
0N/A "has been suspended by an event. "
0N/A "Method invocation is not supported "
0N/A "when the target VM has been suspended by the front-end. "
0N/A "<p>"
0N/A "The specified method is invoked with the arguments in the specified "
0N/A "argument list. "
0N/A "The method invocation is synchronous; the reply packet is not "
0N/A "sent until the invoked method returns in the target VM. "
0N/A "The return value (possibly the void value) is "
0N/A "included in the reply packet. "
0N/A "If the invoked method throws an exception, the "
0N/A "exception object ID is set in the reply packet; otherwise, the "
0N/A "exception object ID is null. "
0N/A "<p>"
0N/A "For primitive arguments, the argument value's type must match the "
0N/A "argument's type exactly. For object arguments, there must exist a "
0N/A "widening reference conversion from the argument value's type to the "
0N/A "argument's type and the argument's type must be loaded. "
0N/A "<p>"
0N/A "By default, all threads in the target VM are resumed while "
0N/A "the method is being invoked if they were previously "
0N/A "suspended by an event or by command. "
0N/A "This is done to prevent the deadlocks "
0N/A "that will occur if any of the threads own monitors "
0N/A "that will be needed by the invoked method. It is possible that "
0N/A "breakpoints or other events might occur during the invocation. "
0N/A "Note, however, that this implicit resume acts exactly like "
0N/A "the ThreadReference resume command, so if the thread's suspend "
0N/A "count is greater than 1, it will remain in a suspended state "
0N/A "during the invocation. By default, when the invocation completes, "
0N/A "all threads in the target VM are suspended, regardless their state "
0N/A "before the invocation. "
0N/A "<p>"
0N/A "The resumption of other threads during the invoke can be prevented "
0N/A "by specifying the INVOKE_SINGLE_THREADED "
0N/A "bit flag in the <code>options</code> field; however, "
0N/A "there is no protection against or recovery from the deadlocks "
0N/A "described above, so this option should be used with great caution. "
0N/A "Only the specified thread will be resumed (as described for all "
0N/A "threads above). Upon completion of a single threaded invoke, the invoking thread "
0N/A "will be suspended once again. Note that any threads started during "
0N/A "the single threaded invocation will not be suspended when the "
0N/A "invocation completes. "
0N/A "<p>"
0N/A "If the target VM is disconnected during the invoke (for example, through "
0N/A "the VirtualMachine dispose command) the method invocation continues. "
0N/A (Out
0N/A (classType clazz "The class type ID.")
0N/A (threadObject thread "The thread in which to invoke.")
0N/A (method methodID "The method to invoke.")
0N/A (Repeat arguments
0N/A (value arg "The argument value.")
0N/A )
0N/A (int options "Invocation <a href=\"#JDWP_InvokeOptions\">options</a>")
0N/A )
0N/A (Reply
0N/A (value returnValue "The returned value.")
0N/A (tagged-object exception "The thrown exception.")
0N/A )
0N/A (ErrorSet
0N/A (Error INVALID_CLASS "clazz is not the ID of a class.")
0N/A (Error INVALID_OBJECT "clazz is not a known ID.")
0N/A (Error INVALID_METHODID "methodID is not the ID of a method.")
0N/A (Error INVALID_THREAD)
0N/A (Error THREAD_NOT_SUSPENDED)
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A (Command NewInstance=4
0N/A "Creates a new object of this type, invoking the specified "
0N/A "constructor. The constructor method ID must be a member of "
0N/A "the class type."
0N/A "<p>"
0N/A "Instance creation will occur in the specified thread. "
0N/A "Instance creation can occur only if the specified thread "
0N/A "has been suspended by an event. "
0N/A "Method invocation is not supported "
0N/A "when the target VM has been suspended by the front-end. "
0N/A "<p>"
0N/A "The specified constructor is invoked with the arguments in the specified "
0N/A "argument list. "
0N/A "The constructor invocation is synchronous; the reply packet is not "
0N/A "sent until the invoked method returns in the target VM. "
0N/A "The return value (possibly the void value) is "
0N/A "included in the reply packet. "
0N/A "If the constructor throws an exception, the "
0N/A "exception object ID is set in the reply packet; otherwise, the "
0N/A "exception object ID is null. "
0N/A "<p>"
0N/A "For primitive arguments, the argument value's type must match the "
0N/A "argument's type exactly. For object arguments, there must exist a "
0N/A "widening reference conversion from the argument value's type to the "
0N/A "argument's type and the argument's type must be loaded. "
0N/A "<p>"
0N/A "By default, all threads in the target VM are resumed while "
0N/A "the method is being invoked if they were previously "
0N/A "suspended by an event or by command. "
0N/A "This is done to prevent the deadlocks "
0N/A "that will occur if any of the threads own monitors "
0N/A "that will be needed by the invoked method. It is possible that "
0N/A "breakpoints or other events might occur during the invocation. "
0N/A "Note, however, that this implicit resume acts exactly like "
0N/A "the ThreadReference resume command, so if the thread's suspend "
0N/A "count is greater than 1, it will remain in a suspended state "
0N/A "during the invocation. By default, when the invocation completes, "
0N/A "all threads in the target VM are suspended, regardless their state "
0N/A "before the invocation. "
0N/A "<p>"
0N/A "The resumption of other threads during the invoke can be prevented "
0N/A "by specifying the INVOKE_SINGLE_THREADED "
0N/A "bit flag in the <code>options</code> field; however, "
0N/A "there is no protection against or recovery from the deadlocks "
0N/A "described above, so this option should be used with great caution. "
0N/A "Only the specified thread will be resumed (as described for all "
0N/A "threads above). Upon completion of a single threaded invoke, the invoking thread "
0N/A "will be suspended once again. Note that any threads started during "
0N/A "the single threaded invocation will not be suspended when the "
0N/A "invocation completes. "
0N/A "<p>"
0N/A "If the target VM is disconnected during the invoke (for example, through "
0N/A "the VirtualMachine dispose command) the method invocation continues. "
0N/A (Out
0N/A (classType clazz "The class type ID.")
0N/A (threadObject thread "The thread in which to invoke the constructor.")
0N/A (method methodID "The constructor to invoke.")
0N/A (Repeat arguments
0N/A (value arg "The argument value.")
0N/A )
0N/A (int options "Constructor invocation <a href=\"#JDWP_InvokeOptions\">options</a>")
0N/A )
0N/A (Reply
0N/A (tagged-object newObject "The newly created object, or null "
0N/A "if the constructor threw an exception.")
0N/A (tagged-object exception "The thrown exception, if any; otherwise, null.")
0N/A )
0N/A (ErrorSet
0N/A (Error INVALID_CLASS "clazz is not the ID of a class.")
0N/A (Error INVALID_OBJECT "clazz is not a known ID or a value of an "
0N/A "object parameter is not a known ID..")
0N/A (Error INVALID_METHODID "methodID is not the ID of a method.")
0N/A (Error INVALID_OBJECT)
0N/A (Error INVALID_THREAD)
0N/A (Error THREAD_NOT_SUSPENDED)
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A)
0N/A(CommandSet ArrayType=4
0N/A (Command NewInstance=1
0N/A "Creates a new array object of this type with a given length."
0N/A (Out
0N/A (arrayType arrType "The array type of the new instance.")
0N/A (int length "The length of the array.")
0N/A )
0N/A (Reply
0N/A (tagged-object newArray "The newly created array object. ")
0N/A )
0N/A (ErrorSet
0N/A (Error INVALID_ARRAY)
0N/A (Error INVALID_OBJECT)
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A)
0N/A(CommandSet InterfaceType=5
0N/A)
0N/A(CommandSet Method=6
0N/A (Command LineTable=1
0N/A "Returns line number information for the method, if present. "
0N/A "The line table maps source line numbers to the initial code index "
0N/A "of the line. The line table "
0N/A "is ordered by code index (from lowest to highest). The line number "
0N/A "information is constant unless a new class definition is installed "
0N/A "using <a href=\"#JDWP_VirtualMachine_RedefineClasses\">RedefineClasses</a>."
0N/A (Out
0N/A (referenceType refType "The class.")
0N/A (method methodID "The method.")
0N/A )
0N/A (Reply
0N/A (long start "Lowest valid code index for the method, >=0, or -1 if the method is native ")
0N/A (long end "Highest valid code index for the method, >=0, or -1 if the method is native")
0N/A (Repeat lines "The number of entries in the line table for this method."
0N/A (Group LineInfo
0N/A (long lineCodeIndex "Initial code index of the line, "
0N/A "start <= lineCodeIndex < end")
0N/A (int lineNumber "Line number.")
0N/A )
0N/A )
0N/A )
0N/A (ErrorSet
0N/A (Error INVALID_CLASS "refType is not the ID of a reference "
0N/A "type.")
0N/A (Error INVALID_OBJECT "refType is not a known ID.")
0N/A (Error INVALID_METHODID "methodID is not the ID of a method.")
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A (Command VariableTable=2
0N/A "Returns variable information for the method. The variable table "
0N/A "includes arguments and locals declared within the method. For "
0N/A "instance methods, the \"this\" reference is included in the "
0N/A "table. Also, synthetic variables may be present. "
0N/A (Out
0N/A (referenceType refType "The class.")
0N/A (method methodID "The method.")
0N/A )
0N/A (Reply
0N/A (int argCnt "The number of words in the frame used by arguments. "
0N/A "Eight-byte arguments use two words; all others use one. ")
0N/A (Repeat slots "The number of variables."
0N/A (Group SlotInfo "Information about the variable."
0N/A (long codeIndex
0N/A "First code index at which the variable is visible (unsigned). "
0N/A "Used in conjunction with <code>length</code>. "
0N/A "The variable can be get or set only when the current "
0N/A "<code>codeIndex</code> <= current frame code index < <code>codeIndex + length</code> ")
0N/A (string name "The variable's name.")
0N/A (string signature "The variable type's JNI signature.")
0N/A (int length
0N/A "Unsigned value used in conjunction with <code>codeIndex</code>. "
0N/A "The variable can be get or set only when the current "
0N/A "<code>codeIndex</code> <= current frame code index < <code>code index + length</code> ")
0N/A (int slot "The local variable's index in its frame")
0N/A )
0N/A )
0N/A )
0N/A (ErrorSet
0N/A (Error INVALID_CLASS "refType is not the ID of a reference "
0N/A "type.")
0N/A (Error INVALID_OBJECT "refType is not a known ID.")
0N/A (Error INVALID_METHODID "methodID is not the ID of a method.")
0N/A (Error ABSENT_INFORMATION "there is no variable information for the method.")
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A (Command Bytecodes=3
4008N/A "Retrieve the method's bytecodes as defined in "
4008N/A "<cite>The Java&trade; Virtual Machine Specification</cite>. "
0N/A "Requires canGetBytecodes capability - see "
0N/A "<a href=\"#JDWP_VirtualMachine_CapabilitiesNew\">CapabilitiesNew</a>."
0N/A (Out
0N/A (referenceType refType "The class.")
0N/A (method methodID "The method.")
0N/A )
0N/A (Reply
0N/A (Repeat bytes
0N/A (byte bytecode "A Java bytecode.")
0N/A )
0N/A )
0N/A (ErrorSet
0N/A (Error INVALID_CLASS "refType is not the ID of a reference "
0N/A "type.")
0N/A (Error INVALID_OBJECT "refType is not a known ID.")
0N/A (Error INVALID_METHODID "methodID is not the ID of a method.")
0N/A (Error NOT_IMPLEMENTED "If the target virtual machine does not "
0N/A "support the retrieval of bytecodes.")
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A (Command IsObsolete=4
0N/A "Determine if this method is obsolete. A method is obsolete if it has been replaced "
0N/A "by a non-equivalent method using the "
0N/A "<a href=\"#JDWP_VirtualMachine_RedefineClasses\">RedefineClasses</a> command. "
0N/A "The original and redefined methods are considered equivalent if their bytecodes are "
0N/A "the same except for indices into the constant pool and the referenced constants are "
0N/A "equal."
0N/A (Out
0N/A (referenceType refType "The class.")
0N/A (method methodID "The method.")
0N/A )
0N/A (Reply
0N/A (boolean isObsolete "true if this method has been replaced"
0N/A "by a non-equivalent method using"
0N/A "the RedefineClasses command.")
0N/A )
0N/A (ErrorSet
0N/A (Error INVALID_CLASS "refType is not the ID of a reference "
0N/A "type.")
0N/A (Error INVALID_OBJECT "refType is not a known ID.")
0N/A (Error INVALID_METHODID "methodID is not the ID of a method.")
0N/A (Error NOT_IMPLEMENTED "If the target virtual machine does "
0N/A "not support this query.")
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A (Command VariableTableWithGeneric=5
0N/A "Returns variable information for the method, including "
0N/A "generic signatures for the variables. The variable table "
0N/A "includes arguments and locals declared within the method. For "
0N/A "instance methods, the \"this\" reference is included in the "
0N/A "table. Also, synthetic variables may be present. "
0N/A "Generic signatures are described in the signature attribute "
4008N/A "section in "
4008N/A "<cite>The Java&trade; Virtual Machine Specification</cite>. "
0N/A "Since JDWP version 1.5."
0N/A (Out
0N/A (referenceType refType "The class.")
0N/A (method methodID "The method.")
0N/A )
0N/A (Reply
0N/A (int argCnt "The number of words in the frame used by arguments. "
0N/A "Eight-byte arguments use two words; all others use one. ")
0N/A (Repeat slots "The number of variables."
0N/A (Group SlotInfo "Information about the variable."
0N/A (long codeIndex
0N/A "First code index at which the variable is visible (unsigned). "
0N/A "Used in conjunction with <code>length</code>. "
0N/A "The variable can be get or set only when the current "
0N/A "<code>codeIndex</code> <= current frame code index < <code>codeIndex + length</code> ")
0N/A (string name "The variable's name.")
0N/A (string signature "The variable type's JNI signature.")
0N/A (string genericSignature "The variable type's generic "
0N/A "signature or an empty string if there is none.")
0N/A (int length
0N/A "Unsigned value used in conjunction with <code>codeIndex</code>. "
0N/A "The variable can be get or set only when the current "
0N/A "<code>codeIndex</code> <= current frame code index < <code>code index + length</code> ")
0N/A (int slot "The local variable's index in its frame")
0N/A )
0N/A )
0N/A )
0N/A (ErrorSet
0N/A (Error INVALID_CLASS "refType is not the ID of a reference "
0N/A "type.")
0N/A (Error INVALID_OBJECT "refType is not a known ID.")
0N/A (Error INVALID_METHODID "methodID is not the ID of a method.")
0N/A (Error ABSENT_INFORMATION "there is no variable information for the method.")
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A
0N/A)
0N/A(CommandSet Field=8
0N/A)
0N/A(CommandSet ObjectReference=9
0N/A (Command ReferenceType=1
0N/A "Returns the runtime type of the object. "
0N/A "The runtime type will be a class or an array. "
0N/A (Out
0N/A (object object "The object ID")
0N/A )
0N/A (Reply
0N/A (byte refTypeTag "<a href=\"#JDWP_TypeTag\">Kind</a> "
0N/A "of following reference type. ")
0N/A (referenceTypeID typeID "The runtime reference type.")
0N/A )
0N/A (ErrorSet
0N/A (Error INVALID_OBJECT)
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A (Command GetValues=2
0N/A "Returns the value of one or more instance fields. "
0N/A "Each field must be member of the object's type "
0N/A "or one of its superclasses, superinterfaces, or implemented interfaces. "
0N/A "Access control is not enforced; for example, the values of private "
0N/A "fields can be obtained."
0N/A (Out
0N/A (object object "The object ID")
0N/A (Repeat fields "The number of values to get"
0N/A (Group Field
0N/A (field fieldID "Field to get.")
0N/A )
0N/A )
0N/A )
0N/A (Reply
0N/A (Repeat values "The number of values returned, always equal to 'fields', "
0N/A "the number of values to get. Field values are ordered "
0N/A "in the reply in the same order as corresponding fieldIDs "
0N/A "in the command."
0N/A (value value "The field value")
0N/A )
0N/A )
0N/A (ErrorSet
0N/A (Error INVALID_OBJECT)
0N/A (Error INVALID_FIELDID)
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A (Command SetValues=3
0N/A "Sets the value of one or more instance fields. "
0N/A "Each field must be member of the object's type "
0N/A "or one of its superclasses, superinterfaces, or implemented interfaces. "
0N/A "Access control is not enforced; for example, the values of private "
0N/A "fields can be set. "
0N/A "For primitive values, the value's type must match the "
0N/A "field's type exactly. For object values, there must be a "
0N/A "widening reference conversion from the value's type to the
0N/A "field's type and the field's type must be loaded. "
0N/A (Out
0N/A (object object "The object ID")
0N/A (Repeat values "The number of fields to set."
0N/A (Group FieldValue "A Field/Value pair."
0N/A (field fieldID "Field to set.")
0N/A (untagged-value value "Value to put in the field.")
0N/A )
0N/A )
0N/A )
0N/A (Reply "none"
0N/A )
0N/A (ErrorSet
0N/A (Error INVALID_OBJECT)
0N/A (Error INVALID_FIELDID)
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A (Command MonitorInfo=5
0N/A "Returns monitor information for an object. All threads int the VM must "
0N/A "be suspended."
0N/A "Requires canGetMonitorInfo capability - see "
0N/A "<a href=\"#JDWP_VirtualMachine_CapabilitiesNew\">CapabilitiesNew</a>."
0N/A (Out
0N/A (object object "The object ID")
0N/A )
0N/A (Reply
0N/A (threadObject owner "The monitor owner, or null if it is not currently owned.")
0N/A (int entryCount "The number of times the monitor has been entered.")
0N/A (Repeat waiters "The number of threads that are waiting for the monitor "
0N/A "0 if there is no current owner"
0N/A (threadObject thread "A thread waiting for this monitor.")
0N/A )
0N/A )
0N/A (ErrorSet
0N/A (Error INVALID_OBJECT)
0N/A (Error NOT_IMPLEMENTED)
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A (Command InvokeMethod=6
0N/A "Invokes a instance method. "
0N/A "The method must be member of the object's type "
0N/A "or one of its superclasses, superinterfaces, or implemented interfaces. "
0N/A "Access control is not enforced; for example, private "
0N/A "methods can be invoked."
0N/A "<p>"
0N/A "The method invocation will occur in the specified thread. "
0N/A "Method invocation can occur only if the specified thread "
0N/A "has been suspended by an event. "
0N/A "Method invocation is not supported "
0N/A "when the target VM has been suspended by the front-end. "
0N/A "<p>"
0N/A "The specified method is invoked with the arguments in the specified "
0N/A "argument list. "
0N/A "The method invocation is synchronous; the reply packet is not "
0N/A "sent until the invoked method returns in the target VM. "
0N/A "The return value (possibly the void value) is "
0N/A "included in the reply packet. "
0N/A "If the invoked method throws an exception, the "
0N/A "exception object ID is set in the reply packet; otherwise, the "
0N/A "exception object ID is null. "
0N/A "<p>"
0N/A "For primitive arguments, the argument value's type must match the "
0N/A "argument's type exactly. For object arguments, there must be a "
0N/A "widening reference conversion from the argument value's type to the "
0N/A "argument's type and the argument's type must be loaded. "
0N/A "<p>"
0N/A "By default, all threads in the target VM are resumed while "
0N/A "the method is being invoked if they were previously "
0N/A "suspended by an event or by command. "
0N/A "This is done to prevent the deadlocks "
0N/A "that will occur if any of the threads own monitors "
0N/A "that will be needed by the invoked method. It is possible that "
0N/A "breakpoints or other events might occur during the invocation. "
0N/A "Note, however, that this implicit resume acts exactly like "
0N/A "the ThreadReference resume command, so if the thread's suspend "
0N/A "count is greater than 1, it will remain in a suspended state "
0N/A "during the invocation. By default, when the invocation completes, "
0N/A "all threads in the target VM are suspended, regardless their state "
0N/A "before the invocation. "
0N/A "<p>"
0N/A "The resumption of other threads during the invoke can be prevented "
0N/A "by specifying the INVOKE_SINGLE_THREADED "
0N/A "bit flag in the <code>options</code> field; however, "
0N/A "there is no protection against or recovery from the deadlocks "
0N/A "described above, so this option should be used with great caution. "
0N/A "Only the specified thread will be resumed (as described for all "
0N/A "threads above). Upon completion of a single threaded invoke, the invoking thread "
0N/A "will be suspended once again. Note that any threads started during "
0N/A "the single threaded invocation will not be suspended when the "
0N/A "invocation completes. "
0N/A "<p>"
0N/A "If the target VM is disconnected during the invoke (for example, through "
0N/A "the VirtualMachine dispose command) the method invocation continues. "
0N/A (Out
0N/A (object object "The object ID")
0N/A (threadObject thread "The thread in which to invoke.")
0N/A (classType clazz "The class type.")
0N/A (method methodID "The method to invoke.")
0N/A (Repeat arguments "The number of arguments."
0N/A (value arg "The argument value.")
0N/A )
0N/A (int options "Invocation <a href=\"#JDWP_InvokeOptions\">options</a>")
0N/A )
0N/A (Reply
0N/A (value returnValue "The returned value, or null if an exception is thrown.")
0N/A (tagged-object exception "The thrown exception, if any.")
0N/A )
0N/A (ErrorSet
0N/A (Error INVALID_OBJECT)
0N/A (Error INVALID_CLASS "clazz is not the ID of a reference "
0N/A "type.")
0N/A (Error INVALID_METHODID "methodID is not the ID of a method.")
0N/A (Error INVALID_THREAD)
0N/A (Error THREAD_NOT_SUSPENDED)
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A (Command DisableCollection=7
0N/A "Prevents garbage collection for the given object. By "
0N/A "default all objects in back-end replies may be "
0N/A "collected at any time the target VM is running. A call to "
0N/A "this command guarantees that the object will not be "
0N/A "collected. The "
0N/A "<a href=\"#JDWP_ObjectReference_EnableCollection\">EnableCollection</a> "
0N/A "command can be used to "
0N/A "allow collection once again. "
0N/A "<p>"
0N/A "Note that while the target VM is suspended, no garbage "
0N/A "collection will occur because all threads are suspended. "
0N/A "The typical examination of variables, fields, and arrays "
0N/A "during the suspension is safe without explicitly disabling "
0N/A "garbage collection. "
0N/A "<p>"
0N/A "This method should be used sparingly, as it alters the "
0N/A "pattern of garbage collection in the target VM and, "
0N/A "consequently, may result in application behavior under the "
0N/A "debugger that differs from its non-debugged behavior. "
0N/A (Out
0N/A (object object "The object ID")
0N/A )
0N/A (Reply "none"
0N/A )
0N/A (ErrorSet
0N/A (Error INVALID_OBJECT)
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A (Command EnableCollection=8
0N/A "Permits garbage collection for this object. By default all "
0N/A "objects returned by JDWP may become unreachable in the target VM, "
0N/A "and hence may be garbage collected. A call to this command is "
0N/A "necessary only if garbage collection was previously disabled with "
0N/A "the <a href=\"#JDWP_ObjectReference_DisableCollection\">DisableCollection</a> "
0N/A "command."
0N/A (Out
0N/A (object object "The object ID")
0N/A )
0N/A (Reply "none"
0N/A )
0N/A (ErrorSet
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A (Command IsCollected=9
0N/A "Determines whether an object has been garbage collected in the "
0N/A "target VM. "
0N/A (Out
0N/A (object object "The object ID")
0N/A )
0N/A (Reply
0N/A (boolean isCollected "true if the object has been collected; false otherwise")
0N/A )
0N/A (ErrorSet
0N/A (Error INVALID_OBJECT)
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A (Command ReferringObjects=10
0N/A "Returns objects that directly reference this object. "
0N/A "Only objects that are reachable for the purposes "
0N/A "of garbage collection are returned. "
0N/A "Note that an object can also be referenced in other ways, "
0N/A "such as from a local variable in a stack frame, or from a JNI global "
0N/A "reference. Such non-object referrers are not returned by this command. "
0N/A "<p>Since JDWP version 1.6. Requires canGetInstanceInfo capability - see "
0N/A "<a href=\"#JDWP_VirtualMachine_CapabilitiesNew\">CapabilitiesNew</a>."
0N/A (Out
0N/A (object object "The object ID")
0N/A (int maxReferrers "Maximum number of referring objects to return. "
0N/A "Must be non-negative. If zero, all referring "
0N/A "objects are returned.")
0N/A )
0N/A (Reply
0N/A (Repeat referringObjects "The number of objects that follow."
0N/A (tagged-object instance "An object that references this object.")
0N/A )
0N/A )
0N/A (ErrorSet
0N/A (Error INVALID_OBJECT "object is not a known ID.")
0N/A (Error ILLEGAL_ARGUMENT "maxReferrers is less than zero.")
0N/A (Error NOT_IMPLEMENTED)
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A)
0N/A
0N/A(CommandSet StringReference=10
0N/A (Command Value=1
0N/A "Returns the characters contained in the string. "
0N/A (Out
0N/A (object stringObject "The String object ID. ")
0N/A )
0N/A (Reply
0N/A (string stringValue "UTF-8 representation of the string value.")
0N/A )
0N/A (ErrorSet
0N/A (Error INVALID_STRING)
0N/A (Error INVALID_OBJECT)
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A)
0N/A(CommandSet ThreadReference=11
0N/A (Command Name=1
0N/A "Returns the thread name. "
0N/A (Out
0N/A (threadObject thread "The thread object ID. ")
0N/A )
0N/A (Reply
0N/A (string threadName "The thread name.")
0N/A )
0N/A (ErrorSet
0N/A (Error INVALID_THREAD)
0N/A (Error INVALID_OBJECT "thread is not a known ID.")
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A (Command Suspend=2
0N/A "Suspends the thread. "
0N/A "<p>"
0N/A "Unlike java.lang.Thread.suspend(), suspends of both "
0N/A "the virtual machine and individual threads are counted. Before "
0N/A "a thread will run again, it must be resumed the same number "
0N/A "of times it has been suspended. "
0N/A "<p>"
0N/A "Suspending single threads with command has the same "
0N/A "dangers java.lang.Thread.suspend(). If the suspended "
0N/A "thread holds a monitor needed by another running thread, "
0N/A "deadlock is possible in the target VM (at least until the "
0N/A "suspended thread is resumed again). "
0N/A "<p>"
0N/A "The suspended thread is guaranteed to remain suspended until "
0N/A "resumed through one of the JDI resume methods mentioned above; "
0N/A "the application in the target VM cannot resume the suspended thread "
0N/A "through {@link java.lang.Thread#resume}. "
0N/A "<p>"
0N/A "Note that this doesn't change the status of the thread (see the "
0N/A "<a href=\"#JDWP_ThreadReference_Status\">ThreadStatus</a> command.) "
0N/A "For example, if it was "
0N/A "Running, it will still appear running to other threads. "
0N/A (Out
0N/A (threadObject thread "The thread object ID. ")
0N/A )
0N/A (Reply "none"
0N/A )
0N/A (ErrorSet
0N/A (Error INVALID_THREAD)
0N/A (Error INVALID_OBJECT "thread is not a known ID.")
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A (Command Resume=3
0N/A "Resumes the execution of a given thread. If this thread was "
0N/A "not previously suspended by the front-end, "
0N/A "calling this command has no effect. "
0N/A "Otherwise, the count of pending suspends on this thread is "
0N/A "decremented. If it is decremented to 0, the thread will "
0N/A "continue to execute. "
0N/A (Out
0N/A (threadObject thread "The thread object ID. ")
0N/A )
0N/A (Reply "none"
0N/A )
0N/A (ErrorSet
0N/A (Error INVALID_THREAD)
0N/A (Error INVALID_OBJECT "thread is not a known ID.")
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A (Command Status=4
0N/A "Returns the current status of a thread. The thread status "
0N/A "reply indicates the thread status the last time it was running. "
0N/A "the suspend status provides information on the thread's "
0N/A "suspension, if any."
0N/A (Out
0N/A (threadObject thread "The thread object ID. ")
0N/A )
0N/A (Reply
0N/A (int threadStatus "One of the thread status codes "
0N/A "See <a href=\"#JDWP_ThreadStatus\">JDWP.ThreadStatus</a>")
0N/A (int suspendStatus "One of the suspend status codes "
0N/A "See <a href=\"#JDWP_SuspendStatus\">JDWP.SuspendStatus</a>")
0N/A )
0N/A (ErrorSet
0N/A (Error INVALID_THREAD)
0N/A (Error INVALID_OBJECT "thread is not a known ID.")
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A (Command ThreadGroup=5
0N/A "Returns the thread group that contains a given thread. "
0N/A (Out
0N/A (threadObject thread "The thread object ID. ")
0N/A )
0N/A (Reply
0N/A (threadGroupObject group "The thread group of this thread. ")
0N/A )
0N/A (ErrorSet
0N/A (Error INVALID_THREAD)
0N/A (Error INVALID_OBJECT "thread is not a known ID.")
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A (Command Frames=6
0N/A "Returns the current call stack of a suspended thread. "
0N/A "The sequence of frames starts with "
0N/A "the currently executing frame, followed by its caller, "
0N/A "and so on. The thread must be suspended, and the returned "
0N/A "frameID is valid only while the thread is suspended. "
0N/A (Out
0N/A (threadObject thread "The thread object ID. ")
0N/A (int startFrame "The index of the first frame to retrieve.")
0N/A (int length
0N/A "The count of frames to retrieve "
0N/A "(-1 means all remaining). ")
0N/A )
0N/A (Reply
0N/A (Repeat frames "The number of frames retreived"
0N/A (Group Frame
0N/A (frame frameID "The ID of this frame. ")
0N/A (location location "The current location of this frame")
0N/A )
0N/A )
0N/A )
0N/A (ErrorSet
0N/A (Error INVALID_THREAD)
0N/A (Error INVALID_OBJECT "thread is not a known ID.")
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A (Command FrameCount=7
0N/A "Returns the count of frames on this thread's stack. "
0N/A "The thread must be suspended, and the returned "
0N/A "count is valid only while the thread is suspended. "
0N/A "Returns JDWP.Error.errorThreadNotSuspended if not suspended. "
0N/A (Out
0N/A (threadObject thread "The thread object ID. ")
0N/A )
0N/A (Reply
0N/A (int frameCount "The count of frames on this thread's stack. ")
0N/A )
0N/A (ErrorSet
0N/A (Error INVALID_THREAD)
0N/A (Error INVALID_OBJECT "thread is not a known ID.")
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A (Command OwnedMonitors=8
0N/A "Returns the objects whose monitors have been entered by this thread. "
0N/A "The thread must be suspended, and the returned information is "
0N/A "relevant only while the thread is suspended. "
0N/A "Requires canGetOwnedMonitorInfo capability - see "
0N/A "<a href=\"#JDWP_VirtualMachine_CapabilitiesNew\">CapabilitiesNew</a>."
0N/A (Out
0N/A (threadObject thread "The thread object ID. ")
0N/A )
0N/A (Reply
0N/A (Repeat owned "The number of owned monitors"
0N/A (tagged-object monitor "An owned monitor")
0N/A )
0N/A )
0N/A (ErrorSet
0N/A (Error INVALID_THREAD)
0N/A (Error INVALID_OBJECT "thread is not a known ID.")
0N/A (Error NOT_IMPLEMENTED)
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A (Command CurrentContendedMonitor=9
0N/A "Returns the object, if any, for which this thread is waiting. The "
0N/A "thread may be waiting to enter a monitor, or it may be waiting, via "
0N/A "the java.lang.Object.wait method, for another thread to invoke the "
0N/A "notify method. "
0N/A "The thread must be suspended, and the returned information is "
0N/A "relevant only while the thread is suspended. "
0N/A "Requires canGetCurrentContendedMonitor capability - see "
0N/A "<a href=\"#JDWP_VirtualMachine_CapabilitiesNew\">CapabilitiesNew</a>."
0N/A (Out
0N/A (threadObject thread "The thread object ID. ")
0N/A )
0N/A (Reply
0N/A (tagged-object monitor "The contended monitor, or null if "
0N/A "there is no current contended monitor. ")
0N/A )
0N/A (ErrorSet
0N/A (Error INVALID_THREAD)
0N/A (Error INVALID_OBJECT "thread is not a known ID.")
0N/A (Error NOT_IMPLEMENTED)
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A (Command Stop=10
0N/A "Stops the thread with an asynchronous exception, as if done by "
0N/A "java.lang.Thread.stop "
0N/A (Out
0N/A (threadObject thread "The thread object ID. ")
0N/A (object throwable "Asynchronous exception. This object must "
0N/A "be an instance of java.lang.Throwable or a subclass")
0N/A )
0N/A (Reply "none"
0N/A )
0N/A (ErrorSet
0N/A (Error INVALID_THREAD)
0N/A (Error INVALID_OBJECT "If thread is not a known ID or the asynchronous "
0N/A "exception has been garbage collected.")
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A (Command Interrupt=11
0N/A "Interrupt the thread, as if done by java.lang.Thread.interrupt "
0N/A (Out
0N/A (threadObject thread "The thread object ID. ")
0N/A )
0N/A (Reply "none"
0N/A )
0N/A (ErrorSet
0N/A (Error INVALID_THREAD)
0N/A (Error INVALID_OBJECT "thread is not a known ID.")
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A (Command SuspendCount=12
0N/A "Get the suspend count for this thread. The suspend count is the "
0N/A "number of times the thread has been suspended through the "
0N/A "thread-level or VM-level suspend commands without a corresponding resume "
0N/A (Out
0N/A (threadObject thread "The thread object ID. ")
0N/A )
0N/A (Reply
0N/A (int suspendCount "The number of outstanding suspends of this thread. ")
0N/A )
0N/A (ErrorSet
0N/A (Error INVALID_THREAD)
0N/A (Error INVALID_OBJECT "thread is not a known ID.")
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A (Command OwnedMonitorsStackDepthInfo=13
0N/A "Returns monitor objects owned by the thread, along with stack depth at which "
0N/A "the monitor was acquired. Returns stack depth of -1 if "
0N/A "the implementation cannot determine the stack depth "
0N/A "(e.g., for monitors acquired by JNI MonitorEnter)."
0N/A "The thread must be suspended, and the returned information is "
0N/A "relevant only while the thread is suspended. "
0N/A "Requires canGetMonitorFrameInfo capability - see "
0N/A "<a href=\"#JDWP_VirtualMachine_CapabilitiesNew\">CapabilitiesNew</a>. "
0N/A "<p>Since JDWP version 1.6. "
0N/A
0N/A (Out
0N/A (threadObject thread "The thread object ID. ")
0N/A )
0N/A (Reply
0N/A (Repeat owned "The number of owned monitors"
0N/A (Group monitor
0N/A (tagged-object monitor "An owned monitor")
0N/A (int stack_depth "Stack depth location where monitor was acquired")
0N/A )
0N/A )
0N/A )
0N/A (ErrorSet
0N/A (Error INVALID_THREAD)
0N/A (Error INVALID_OBJECT "thread is not a known ID.")
0N/A (Error NOT_IMPLEMENTED)
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A (Command ForceEarlyReturn=14
0N/A "Force a method to return before it reaches a return "
0N/A "statement. "
0N/A "<p>"
0N/A "The method which will return early is referred to as the "
0N/A "called method. The called method is the current method (as "
4008N/A "defined by the Frames section in "
4008N/A "<cite>The Java&trade; Virtual Machine Specification</cite>) "
4008N/A "for the specified thread at the time this command "
0N/A "is received. "
0N/A "<p>"
0N/A "The specified thread must be suspended. "
0N/A "The return occurs when execution of Java programming "
0N/A "language code is resumed on this thread. Between sending this "
0N/A "command and resumption of thread execution, the "
0N/A "state of the stack is undefined. "
0N/A "<p>"
0N/A "No further instructions are executed in the called "
0N/A "method. Specifically, finally blocks are not executed. Note: "
0N/A "this can cause inconsistent states in the application. "
0N/A "<p>"
0N/A "A lock acquired by calling the called method (if it is a "
0N/A "synchronized method) and locks acquired by entering "
0N/A "synchronized blocks within the called method are "
0N/A "released. Note: this does not apply to JNI locks or "
0N/A "java.util.concurrent.locks locks. "
0N/A "<p>"
0N/A "Events, such as MethodExit, are generated as they would be in "
0N/A "a normal return. "
0N/A "<p>"
0N/A "The called method must be a non-native Java programming "
0N/A "language method. Forcing return on a thread with only one "
0N/A "frame on the stack causes the thread to exit when resumed. "
0N/A "<p>"
0N/A "For void methods, the value must be a void value. "
0N/A "For methods that return primitive values, the value's type must "
0N/A "match the return type exactly. For object values, there must be a "
0N/A "widening reference conversion from the value's type to the "
0N/A "return type type and the return type must be loaded. "
0N/A "<p>"
0N/A "Since JDWP version 1.6. Requires canForceEarlyReturn capability - see "
0N/A "<a href=\"#JDWP_VirtualMachine_CapabilitiesNew\">CapabilitiesNew</a>."
0N/A (Out
0N/A (threadObject thread "The thread object ID. ")
0N/A (value value "The value to return. ")
0N/A )
0N/A (Reply "none"
0N/A )
0N/A (ErrorSet
0N/A (Error INVALID_THREAD)
0N/A (Error INVALID_OBJECT "Thread or value is not a known ID.")
0N/A (Error THREAD_NOT_SUSPENDED)
0N/A (Error THREAD_NOT_ALIVE)
0N/A (Error OPAQUE_FRAME "Attempted to return early from "
0N/A "a frame corresponding to a native "
0N/A "method. Or the implementation is "
0N/A "unable to provide this functionality "
0N/A "on this frame.")
0N/A (Error NO_MORE_FRAMES)
0N/A (Error NOT_IMPLEMENTED)
0N/A (Error TYPE_MISMATCH "Value is not an appropriate type for the "
0N/A "return value of the method.")
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A
0N/A)
0N/A(CommandSet ThreadGroupReference=12
0N/A (Command Name=1
0N/A "Returns the thread group name. "
0N/A (Out
0N/A (threadGroupObject group "The thread group object ID. ")
0N/A )
0N/A (Reply
0N/A (string groupName "The thread group's name.")
0N/A )
0N/A (ErrorSet
0N/A (Error INVALID_THREAD_GROUP)
0N/A (Error INVALID_OBJECT "group is not a known ID.")
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A (Command Parent=2
0N/A "Returns the thread group, if any, which contains a given thread group. "
0N/A (Out
0N/A (threadGroupObject group "The thread group object ID. ")
0N/A )
0N/A (Reply
0N/A (threadGroupObject parentGroup "The parent thread group object, or "
0N/A "null if the given thread group "
0N/A "is a top-level thread group")
0N/A )
0N/A (ErrorSet
0N/A (Error INVALID_THREAD_GROUP)
0N/A (Error INVALID_OBJECT "group is not a known ID.")
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A (Command Children=3
0N/A "Returns the live threads and active thread groups directly contained "
0N/A "in this thread group. Threads and thread groups in child "
0N/A "thread groups are not included. "
0N/A "A thread is alive if it has been started and has not yet been stopped. "
0N/A "See <a href=../../../api/java/lang/ThreadGroup.html>java.lang.ThreadGroup </a>
0N/A "for information about active ThreadGroups.
0N/A (Out
0N/A (threadGroupObject group "The thread group object ID. ")
0N/A )
0N/A (Reply
0N/A (Repeat childThreads "The number of live child threads. "
0N/A (threadObject childThread "A direct child thread ID. ")
0N/A )
0N/A (Repeat childGroups "The number of active child thread groups. "
0N/A (threadGroupObject childGroup "A direct child thread group ID. ")
0N/A )
0N/A )
0N/A (ErrorSet
0N/A (Error INVALID_THREAD_GROUP)
0N/A (Error INVALID_OBJECT "group is not a known ID.")
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A)
0N/A(CommandSet ArrayReference=13
0N/A (Command Length=1
0N/A "Returns the number of components in a given array. "
0N/A (Out
0N/A (arrayObject arrayObject "The array object ID. ")
0N/A )
0N/A (Reply
0N/A (int arrayLength "The length of the array.")
0N/A )
0N/A (ErrorSet
0N/A (Error INVALID_OBJECT "arrayObject is not a known ID.")
0N/A (Error INVALID_ARRAY)
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A (Command GetValues=2
0N/A "Returns a range of array components. The specified range must "
0N/A "be within the bounds of the array. "
0N/A (Out
0N/A (arrayObject arrayObject "The array object ID. ")
0N/A (int firstIndex "The first index to retrieve.")
0N/A (int length "The number of components to retrieve.")
0N/A )
0N/A (Reply
0N/A (typed-sequence values "The retrieved values. If the values "
0N/A "are objects, they are tagged-values; "
0N/A "otherwise, they are untagged-values")
0N/A )
0N/A (ErrorSet
0N/A (Error INVALID_LENGTH "If index is beyond the end of this array.")
0N/A (Error INVALID_OBJECT "arrayObject is not a known ID.")
0N/A (Error INVALID_ARRAY)
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A (Command SetValues=3
0N/A "Sets a range of array components. The specified range must "
0N/A "be within the bounds of the array. "
0N/A "For primitive values, each value's type must match the "
0N/A "array component type exactly. For object values, there must be a "
0N/A "widening reference conversion from the value's type to the
0N/A "array component type and the array component type must be loaded. "
0N/A (Out
0N/A (arrayObject arrayObject "The array object ID. ")
0N/A (int firstIndex "The first index to set.")
0N/A (Repeat values "The number of values to set. "
0N/A (untagged-value value "A value to set. ")
0N/A )
0N/A )
0N/A (Reply "none"
0N/A )
0N/A (ErrorSet
0N/A (Error INVALID_LENGTH "If index is beyond the end of this array.")
0N/A (Error INVALID_OBJECT "arrayObject is not a known ID.")
0N/A (Error INVALID_ARRAY)
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A)
0N/A(CommandSet ClassLoaderReference=14
0N/A (Command VisibleClasses=1
0N/A "Returns a list of all classes which this class loader has "
0N/A "been requested to load. This class loader is considered to be "
0N/A "an <i>initiating</i> class loader for each class in the returned "
0N/A "list. The list contains each "
0N/A "reference type defined by this loader and any types for which "
0N/A "loading was delegated by this class loader to another class loader. "
0N/A "<p>"
0N/A "The visible class list has useful properties with respect to "
0N/A "the type namespace. A particular type name will occur at most "
0N/A "once in the list. Each field or variable declared with that "
0N/A "type name in a class defined by "
0N/A "this class loader must be resolved to that single type. "
0N/A "<p>"
0N/A "No ordering of the returned list is guaranteed. "
0N/A (Out
0N/A (classLoaderObject classLoaderObject "The class loader object ID. ")
0N/A )
0N/A (Reply
0N/A (Repeat classes "The number of visible classes. "
0N/A (Group ClassInfo
0N/A (byte refTypeTag "<a href=\"#JDWP_TypeTag\">Kind</a> "
0N/A "of following reference type. ")
0N/A (referenceTypeID typeID
0N/A "A class visible to this class loader.")
0N/A )
0N/A )
0N/A )
0N/A (ErrorSet
0N/A (Error INVALID_OBJECT)
0N/A (Error INVALID_CLASS_LOADER)
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A)
0N/A(CommandSet EventRequest=15
0N/A (Command Set=1
0N/A "Set an event request. When the event described by this request "
0N/A "occurs, an <a href=\"#JDWP_Event\">event</a> is sent from the "
0N/A "target VM. If an event occurs that has not been requested then it is not sent "
0N/A "from the target VM. The two exceptions to this are the VM Start Event and "
0N/A "the VM Death Event which are automatically generated events - see "
0N/A "<a href=\"#JDWP_Event_Composite\">Composite Command</a> for further details."
0N/A (Out
0N/A (byte eventKind "Event kind to request. "
0N/A "See <a href=\"#JDWP_EventKind\">JDWP.EventKind</a> "
4119N/A "for a complete list of events that can be requested; "
4119N/A "some events may require a capability in order to be requested. "
0N/A )
0N/A (byte suspendPolicy
0N/A "What threads are suspended when this event occurs? "
0N/A "Note that the order of events and command replies "
0N/A "accurately reflects the order in which threads are "
0N/A "suspended and resumed. For example, if a "
0N/A "<a href=\"#JDWP_VirtualMachine_Resume\">VM-wide resume</a> "
0N/A "is processed before an event occurs which suspends the "
0N/A "VM, the reply to the resume command will be written to "
0N/A "the transport before the suspending event.")
0N/A (Repeat modifiers "Constraints used to control the number "
0N/A "of generated events."
0N/A "Modifiers specify additional tests that "
0N/A "an event must satisfy before it is placed "
0N/A "in the event queue. Events are filtered by "
0N/A "applying each modifier to an event in the "
0N/A "order they are specified in this collection "
0N/A "Only events that satisfy all modifiers "
0N/A "are reported. A value of 0 means there are no "
0N/A "modifiers in the request."
0N/A "<p>"
0N/A "Filtering can improve "
0N/A "debugger performance dramatically by
0N/A "reducing the "
0N/A "amount of event traffic sent from the "
0N/A "target VM to the debugger VM. "
0N/A (Select Modifier
0N/A (byte modKind "Modifier kind")
0N/A (Alt Count=1
0N/A "Limit the requested event to be reported at most once after a "
0N/A "given number of occurrences. The event is not reported "
0N/A "the first <code>count - 1</code> times this filter is reached. "
0N/A "To request a one-off event, call this method with a count of 1. "
0N/A "<p>"
0N/A "Once the count reaches 0, any subsequent filters in this request "
0N/A "are applied. If none of those filters cause the event to be "
0N/A "suppressed, the event is reported. Otherwise, the event is not "
0N/A "reported. In either case subsequent events are never reported for "
0N/A "this request. "
0N/A "This modifier can be used with any event kind."
0N/A
0N/A (int count "Count before event. One for one-off.")
0N/A )
0N/A (Alt Conditional=2 "Conditional on expression"
0N/A (int exprID "For the future")
0N/A )
0N/A (Alt ThreadOnly=3
0N/A "Restricts reported events to "
0N/A "those in the given thread. "
0N/A "This modifier can be used with any event kind "
0N/A "except for class unload. "
0N/A
0N/A (threadObject thread "Required thread")
0N/A )
0N/A (Alt ClassOnly=4
0N/A "For class prepare events, restricts the events "
0N/A "generated by this request to be the "
0N/A "preparation of the given reference type and any subtypes. "
0N/A "For monitor wait and waited events, restricts the events "
0N/A "generated by this request to those whose monitor object "
0N/A "is of the given reference type or any of its subtypes. "
0N/A "For other events, restricts the events generated "
0N/A "by this request to those "
0N/A "whose location is in the given reference type or any of its subtypes. "
0N/A "An event will be generated for any location in a reference type that can "
0N/A "be safely cast to the given reference type. "
0N/A "This modifier can be used with any event kind except "
0N/A "class unload, thread start, and thread end. "
0N/A
0N/A (referenceType clazz "Required class")
0N/A )
0N/A (Alt ClassMatch=5
0N/A "Restricts reported events to those for classes whose name "
0N/A "matches the given restricted regular expression. "
0N/A "For class prepare events, the prepared class name "
0N/A "is matched. For class unload events, the "
0N/A "unloaded class name is matched. For monitor wait "
0N/A "and waited events, the name of the class of the "
0N/A "monitor object is matched. For other events, "
0N/A "the class name of the event's location is matched. "
0N/A "This modifier can be used with any event kind except "
0N/A "thread start and thread end. "
0N/A
0N/A (string classPattern "Required class pattern. "
0N/A "Matches are limited to exact matches of the "
0N/A "given class pattern and matches of patterns that "
0N/A "begin or end with '*'; for example, "
0N/A "\"*.Foo\" or \"java.*\". "
0N/A )
0N/A
0N/A )
0N/A (Alt ClassExclude=6
0N/A "Restricts reported events to those for classes whose name "
0N/A "does not match the given restricted regular expression. "
0N/A "For class prepare events, the prepared class name "
0N/A "is matched. For class unload events, the "
0N/A "unloaded class name is matched. For monitor wait and "
0N/A "waited events, the name of the class of the monitor "
0N/A "object is matched. For other events, "
0N/A "the class name of the event's location is matched. "
0N/A "This modifier can be used with any event kind except "
0N/A "thread start and thread end. "
0N/A
0N/A (string classPattern "Disallowed class pattern. "
0N/A "Matches are limited to exact matches of the "
0N/A "given class pattern and matches of patterns that "
0N/A "begin or end with '*'; for example, "
0N/A "\"*.Foo\" or \"java.*\". "
0N/A )
0N/A )
0N/A (Alt LocationOnly=7
0N/A "Restricts reported events to those that occur at "
0N/A "the given location. "
0N/A "This modifier can be used with "
0N/A "breakpoint, field access, field modification, "
0N/A "step, and exception event kinds. "
0N/A
0N/A (location loc "Required location")
0N/A )
0N/A (Alt ExceptionOnly=8
0N/A "Restricts reported exceptions by their class and "
0N/A "whether they are caught or uncaught. "
0N/A "This modifier can be used with "
0N/A "exception event kinds only. "
0N/A
0N/A (referenceType exceptionOrNull
0N/A "Exception to report. Null (0) means report "
0N/A "exceptions of all types. "
0N/A "A non-null type restricts the reported exception "
0N/A "events to exceptions of the given type or "
0N/A "any of its subtypes. "
0N/A )
0N/A (boolean caught "Report caught exceptions")
0N/A (boolean uncaught "Report uncaught exceptions. "
0N/A "Note that it "
0N/A "is not always possible to determine whether an "
0N/A "exception is caught or uncaught at the time it is "
0N/A "thrown. See the exception event catch location under "
0N/A "<a href=\"#JDWP_Event_Composite\">composite events</a> "
0N/A "for more information. "
0N/A )
0N/A
0N/A )
0N/A (Alt FieldOnly=9
0N/A "Restricts reported events to those that occur for "
0N/A "a given field. "
0N/A "This modifier can be used with "
0N/A "field access and field modification event kinds only. "
0N/A
0N/A (referenceType declaring "Type in which field is declared.")
0N/A (field fieldID "Required field")
0N/A )
0N/A (Alt Step=10
0N/A "Restricts reported step events "
0N/A "to those which satisfy "
0N/A "depth and size constraints. "
0N/A "This modifier can be used with "
0N/A "step event kinds only. "
0N/A
0N/A (threadObject thread "Thread in which to step")
0N/A (int size "size of each step. "
0N/A "See <a href=\"#JDWP_StepSize\">JDWP.StepSize</a>")
0N/A (int depth "relative call stack limit. "
0N/A "See <a href=\"#JDWP_StepDepth\">JDWP.StepDepth</a>")
0N/A )
0N/A (Alt InstanceOnly=11
0N/A "Restricts reported events to those whose "
0N/A "active 'this' object is the given object. "
0N/A "Match value is the null object for static methods. "
0N/A "This modifier can be used with any event kind "
0N/A "except class prepare, class unload, thread start, "
0N/A "and thread end. Introduced in JDWP version 1.4."
0N/A
0N/A (object instance "Required 'this' object")
0N/A )
0N/A (Alt SourceNameMatch=12
0N/A "Restricts reported class prepare events to those "
0N/A "for reference types which have a source name "
0N/A "which matches the given restricted regular expression. "
0N/A "The source names are determined by the reference type's "
0N/A "<a href=\"#JDWP_ReferenceType_SourceDebugExtension\"> "
0N/A "SourceDebugExtension</a>. "
0N/A "This modifier can only be used with class prepare "
0N/A "events. "
0N/A "Since JDWP version 1.6. Requires the canUseSourceNameFilters "
0N/A "capability - see "
0N/A "<a href=\"#JDWP_VirtualMachine_CapabilitiesNew\">CapabilitiesNew</a>."
0N/A
0N/A (string sourceNamePattern "Required source name pattern. "
0N/A "Matches are limited to exact matches of the "
0N/A "given pattern and matches of patterns that "
0N/A "begin or end with '*'; for example, "
0N/A "\"*.Foo\" or \"java.*\". "
0N/A )
0N/A )
0N/A
0N/A )
0N/A )
0N/A )
0N/A (Reply
0N/A (int requestID "ID of created request")
0N/A )
0N/A (ErrorSet
0N/A (Error INVALID_THREAD)
0N/A (Error INVALID_CLASS)
0N/A (Error INVALID_STRING)
0N/A (Error INVALID_OBJECT)
0N/A (Error INVALID_COUNT)
0N/A (Error INVALID_FIELDID)
0N/A (Error INVALID_METHODID)
0N/A (Error INVALID_LOCATION)
0N/A (Error INVALID_EVENT_TYPE)
0N/A (Error NOT_IMPLEMENTED)
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A (Command Clear=2
0N/A "Clear an event request. See <a href=\"#JDWP_EventKind\">JDWP.EventKind</a> "
0N/A "for a complete list of events that can be cleared. Only the event request matching "
0N/A "the specified event kind and requestID is cleared. If there isn't a matching event "
0N/A "request the command is a no-op and does not result in an error. Automatically "
0N/A "generated events do not have a corresponding event request and may not be cleared "
0N/A "using this command."
0N/A (Out
0N/A (byte eventKind "Event kind to clear")
0N/A (int requestID "ID of request to clear")
0N/A )
0N/A (Reply "none"
0N/A )
0N/A (ErrorSet
0N/A (Error VM_DEAD)
0N/A (Error INVALID_EVENT_TYPE)
0N/A )
0N/A )
0N/A (Command ClearAllBreakpoints=3
0N/A "Removes all set breakpoints, a no-op if there are no breakpoints set."
0N/A (Out "none"
0N/A )
0N/A (Reply "none"
0N/A )
0N/A (ErrorSet
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A)
0N/A(CommandSet StackFrame=16
0N/A (Command GetValues=1
0N/A "Returns the value of one or more local variables in a "
0N/A "given frame. Each variable must be visible at the frame's code index. "
0N/A "Even if local variable information is not available, values can "
0N/A "be retrieved if the front-end is able to "
0N/A "determine the correct local variable index. (Typically, this "
0N/A "index can be determined for method arguments from the method "
0N/A "signature without access to the local variable table information.) "
0N/A (Out
0N/A (threadObject thread "The frame's thread. ")
0N/A (frame frame "The frame ID. ")
0N/A (Repeat slots "The number of values to get. "
0N/A (Group SlotInfo
0N/A (int slot "The local variable's index in the frame. ")
0N/A (byte sigbyte "A <a href=\"#JDWP_Tag\">tag</a> "
0N/A "identifying the type of the variable ")
0N/A )
0N/A )
0N/A )
0N/A (Reply
0N/A (Repeat values "The number of values retrieved, always equal to slots, "
0N/A "the number of values to get."
0N/A (value slotValue "The value of the local variable. ")
0N/A )
0N/A )
0N/A (ErrorSet
0N/A (Error INVALID_THREAD)
0N/A (Error INVALID_OBJECT)
0N/A (Error INVALID_FRAMEID)
0N/A (Error INVALID_SLOT)
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A (Command SetValues=2
0N/A "Sets the value of one or more local variables. "
0N/A "Each variable must be visible at the current frame code index. "
0N/A "For primitive values, the value's type must match the "
0N/A "variable's type exactly. For object values, there must be a "
0N/A "widening reference conversion from the value's type to the
0N/A "variable's type and the variable's type must be loaded. "
0N/A "<p>"
0N/A "Even if local variable information is not available, values can "
0N/A "be set, if the front-end is able to "
0N/A "determine the correct local variable index. (Typically, this
0N/A "index can be determined for method arguments from the method "
0N/A "signature without access to the local variable table information.) "
0N/A (Out
0N/A (threadObject thread "The frame's thread. ")
0N/A (frame frame "The frame ID. ")
0N/A (Repeat slotValues "The number of values to set. "
0N/A (Group SlotInfo
0N/A (int slot "The slot ID. ")
0N/A (value slotValue "The value to set. ")
0N/A )
0N/A )
0N/A )
0N/A (Reply "none"
0N/A )
0N/A (ErrorSet
0N/A (Error INVALID_THREAD)
0N/A (Error INVALID_OBJECT)
0N/A (Error INVALID_FRAMEID)
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A (Command ThisObject=3
0N/A "Returns the value of the 'this' reference for this frame. "
0N/A "If the frame's method is static or native, the reply "
0N/A "will contain the null object reference. "
0N/A (Out
0N/A (threadObject thread "The frame's thread. ")
0N/A (frame frame "The frame ID. ")
0N/A )
0N/A (Reply
0N/A (tagged-object objectThis "The 'this' object for this frame. ")
0N/A )
0N/A (ErrorSet
0N/A (Error INVALID_THREAD)
0N/A (Error INVALID_OBJECT)
0N/A (Error INVALID_FRAMEID)
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A (Command PopFrames=4
0N/A "Pop the top-most stack frames of the thread stack, up to, and including 'frame'. "
0N/A "The thread must be suspended to perform this command. "
0N/A "The top-most stack frames are discarded and the stack frame previous to 'frame' "
0N/A "becomes the current frame. The operand stack is restored -- the argument values "
0N/A "are added back and if the invoke was not <code>invokestatic</code>, "
0N/A "<code>objectref</code> is added back as well. The Java virtual machine "
0N/A "program counter is restored to the opcode of the invoke instruction."
0N/A "<p>"
0N/A "Since JDWP version 1.4. Requires canPopFrames capability - see "
0N/A "<a href=\"#JDWP_VirtualMachine_CapabilitiesNew\">CapabilitiesNew</a>."
0N/A (Out
0N/A (threadObject thread "The thread object ID. ")
0N/A (frame frame "The frame ID. ")
0N/A )
0N/A (Reply "none"
0N/A )
0N/A (ErrorSet
0N/A (Error INVALID_THREAD)
0N/A (Error INVALID_OBJECT "thread is not a known ID.")
0N/A (Error INVALID_FRAMEID)
0N/A (Error THREAD_NOT_SUSPENDED)
0N/A (Error NO_MORE_FRAMES)
0N/A (Error INVALID_FRAMEID)
0N/A (Error NOT_IMPLEMENTED)
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A)
0N/A(CommandSet ClassObjectReference=17
0N/A (Command ReflectedType = 1
0N/A "Returns the reference type reflected by this class object."
0N/A (Out
0N/A (classObject classObject "The class object. ")
0N/A )
0N/A (Reply
0N/A (byte refTypeTag "<a href=\"#JDWP_TypeTag\">Kind</a> "
0N/A "of following reference type. ")
0N/A (referenceTypeID typeID "reflected reference type")
0N/A )
0N/A (ErrorSet
0N/A (Error INVALID_OBJECT)
0N/A (Error VM_DEAD)
0N/A )
0N/A )
0N/A)
0N/A(CommandSet Event=64
0N/A (Command Composite=100
0N/A "Several events may occur at a given time in the target VM. "
0N/A "For example, there may be more than one breakpoint request "
0N/A "for a given location "
0N/A "or you might single step to the same location as a "
0N/A "breakpoint request. These events are delivered "
0N/A "together as a composite event. For uniformity, a "
0N/A "composite event is always used "
0N/A "to deliver events, even if there is only one event to report. "
0N/A "<P>"
0N/A "The events that are grouped in a composite event are restricted in the "
0N/A "following ways: "
0N/A "<P>"
0N/A "<UL>"
0N/A "<LI>Only with other thread start events for the same thread:"
0N/A " <UL>"
0N/A " <LI>Thread Start Event"
0N/A " </UL>"
0N/A "<LI>Only with other thread death events for the same thread:"
0N/A " <UL>"
0N/A " <LI>Thread Death Event"
0N/A " </UL>"
0N/A "<LI>Only with other class prepare events for the same class:"
0N/A " <UL>"
0N/A " <LI>Class Prepare Event"
0N/A " </UL>"
0N/A "<LI>Only with other class unload events for the same class:"
0N/A " <UL>"
0N/A " <LI>Class Unload Event"
0N/A " </UL>"
0N/A "<LI>Only with other access watchpoint events for the same field access:"
0N/A " <UL>"
0N/A " <LI>Access Watchpoint Event"
0N/A " </UL>"
0N/A "<LI>Only with other modification watchpoint events for the same field "
0N/A "modification:"
0N/A " <UL>"
0N/A " <LI>Modification Watchpoint Event"
0N/A " </UL>"
0N/A "<LI>Only with other Monitor contended enter events for the same monitor object: "
0N/A " <UL>"
0N/A " <LI>Monitor Contended Enter Event"
0N/A " </UL>"
0N/A "<LI>Only with other Monitor contended entered events for the same monitor object: "
0N/A " <UL>"
0N/A " <LI>Monitor Contended Entered Event"
0N/A " </UL>"
0N/A "<LI>Only with other Monitor wait events for the same monitor object: "
0N/A " <UL>"
0N/A " <LI>Monitor Wait Event"
0N/A " </UL>"
0N/A "<LI>Only with other Monitor waited events for the same monitor object: "
0N/A " <UL>"
0N/A " <LI>Monitor Waited Event"
0N/A " </UL>"
0N/A "<LI>Only with other ExceptionEvents for the same exception occurrance:"
0N/A " <UL>"
0N/A " <LI>ExceptionEvent"
0N/A " </UL>"
0N/A "<LI>Only with other members of this group, at the same location "
0N/A "and in the same thread: "
0N/A " <UL>"
0N/A " <LI>Breakpoint Event"
0N/A " <LI>Step Event"
0N/A " <LI>Method Entry Event"
0N/A " <LI>Method Exit Event"
0N/A " </UL>"
0N/A "</UL>"
0N/A "<P>"
0N/A "The VM Start Event and VM Death Event are automatically generated events. "
0N/A "This means they do not need to be requested using the "
0N/A "<a href=\"#JDWP_EventRequest_Set\">EventRequest.Set</a> command. "
0N/A "The VM Start event signals the completion of VM initialization. The VM Death "
0N/A "event signals the termination of the VM."
0N/A "If there is a debugger connected at the time when an automatically generated "
0N/A "event occurs it is sent from the target VM. Automatically generated events may "
0N/A "also be requested using the EventRequest.Set command and thus multiple events "
0N/A "of the same event kind will be sent from the target VM when an event occurs."
0N/A "Automatically generated events are sent with the requestID field "
0N/A "in the Event Data set to 0. The value of the suspendPolicy field in the "
0N/A "Event Data depends on the event. For the automatically generated VM Start "
0N/A "Event the value of suspendPolicy is not defined and is therefore implementation "
0N/A "or configuration specific. In the Sun implementation, for example, the "
0N/A "suspendPolicy is specified as an option to the JDWP agent at launch-time."
0N/A "The automatically generated VM Death Event will have the suspendPolicy set to "
0N/A "NONE."
0N/A
0N/A (Event "Generated event"
0N/A (byte suspendPolicy
0N/A "Which threads where suspended by this composite event?")
0N/A (Repeat events "Events in set."
0N/A (Select Events
0N/A (byte eventKind "Event kind selector")
0N/A (Alt VMStart=JDWP.EventKind.VM_START
0N/A "Notification of initialization of a target VM. This event is "
0N/A "received before the main thread is started and before any "
0N/A "application code has been executed. Before this event occurs "
0N/A "a significant amount of system code has executed and a number "
0N/A "of system classes have been loaded. "
0N/A "This event is always generated by the target VM, even "
0N/A "if not explicitly requested."
0N/A
0N/A (int requestID
0N/A "Request that generated event (or 0 if this "
0N/A "event is automatically generated.")
0N/A (threadObject thread "Initial thread")
0N/A )
0N/A (Alt SingleStep=JDWP.EventKind.SINGLE_STEP
0N/A "Notification of step completion in the target VM. The step event "
0N/A "is generated before the code at its location is executed. "
0N/A
0N/A (int requestID "Request that generated event")
0N/A (threadObject thread "Stepped thread")
0N/A (location location "Location stepped to")
0N/A )
0N/A (Alt Breakpoint=JDWP.EventKind.BREAKPOINT
0N/A "Notification of a breakpoint in the target VM. The breakpoint event "
0N/A "is generated before the code at its location is executed. "
0N/A
0N/A (int requestID "Request that generated event")
0N/A (threadObject thread "Thread which hit breakpoint")
0N/A (location location "Location hit")
0N/A )
0N/A (Alt MethodEntry=JDWP.EventKind.METHOD_ENTRY
0N/A "Notification of a method invocation in the target VM. This event "
0N/A "is generated before any code in the invoked method has executed. "
0N/A "Method entry events are generated for both native and non-native "
0N/A "methods. "
0N/A "<P>"
0N/A "In some VMs method entry events can occur for a particular thread "
0N/A "before its thread start event occurs if methods are called "
0N/A "as part of the thread's initialization. "
0N/A
0N/A (int requestID "Request that generated event")
0N/A (threadObject thread "Thread which entered method")
0N/A (location location "The initial executable location in the method.")
0N/A )
0N/A (Alt MethodExit=JDWP.EventKind.METHOD_EXIT
0N/A "Notification of a method return in the target VM. This event "
0N/A "is generated after all code in the method has executed, but the "
0N/A "location of this event is the last executed location in the method. "
0N/A "Method exit events are generated for both native and non-native "
0N/A "methods. Method exit events are not generated if the method terminates "
0N/A "with a thrown exception. "
0N/A
0N/A (int requestID "Request that generated event")
0N/A (threadObject thread "Thread which exited method")
0N/A (location location "Location of exit")
0N/A )
0N/A (Alt MethodExitWithReturnValue=JDWP.EventKind.METHOD_EXIT_WITH_RETURN_VALUE
0N/A "Notification of a method return in the target VM. This event "
0N/A "is generated after all code in the method has executed, but the "
0N/A "location of this event is the last executed location in the method. "
0N/A "Method exit events are generated for both native and non-native "
0N/A "methods. Method exit events are not generated if the method terminates "
0N/A "with a thrown exception. <p>Since JDWP version 1.6. "
0N/A
0N/A (int requestID "Request that generated event")
0N/A (threadObject thread "Thread which exited method")
0N/A (location location "Location of exit")
0N/A (value value "Value that will be returned by the method")
0N/A )
0N/A (Alt MonitorContendedEnter=JDWP.EventKind.MONITOR_CONTENDED_ENTER
0N/A "Notification that a thread in the target VM is attempting "
0N/A "to enter a monitor that is already acquired by another thread. "
4119N/A "Requires canRequestMonitorEvents capability - see "
4119N/A "<a href=\"#JDWP_VirtualMachine_CapabilitiesNew\">CapabilitiesNew</a>. "
0N/A "<p>Since JDWP version 1.6. "
0N/A
0N/A (int requestID
0N/A "Request that generated event")
0N/A (threadObject thread "Thread which is trying to enter the monitor")
0N/A (tagged-object object "Monitor object reference")
0N/A (location location "Location of contended monitor enter")
0N/A )
0N/A (Alt MonitorContendedEntered=JDWP.EventKind.MONITOR_CONTENDED_ENTERED
0N/A "Notification of a thread in the target VM is entering a monitor "
0N/A "after waiting for it to be released by another thread. "
4119N/A "Requires canRequestMonitorEvents capability - see "
4119N/A "<a href=\"#JDWP_VirtualMachine_CapabilitiesNew\">CapabilitiesNew</a>. "
0N/A "<p>Since JDWP version 1.6. "
0N/A
0N/A (int requestID
0N/A "Request that generated event")
0N/A (threadObject thread "Thread which entered monitor")
0N/A (tagged-object object "Monitor object reference")
0N/A (location location "Location of contended monitor enter")
0N/A )
0N/A (Alt MonitorWait=JDWP.EventKind.MONITOR_WAIT
0N/A "Notification of a thread about to wait on a monitor object. "
4119N/A "Requires canRequestMonitorEvents capability - see "
4119N/A "<a href=\"#JDWP_VirtualMachine_CapabilitiesNew\">CapabilitiesNew</a>. "
0N/A "<p>Since JDWP version 1.6. "
0N/A
0N/A (int requestID
0N/A "Request that generated event")
0N/A (threadObject thread "Thread which is about to wait")
0N/A (tagged-object object "Monitor object reference")
0N/A (location location "Location at which the wait will occur")
0N/A (long timeout "Thread wait time in milliseconds")
0N/A )
0N/A (Alt MonitorWaited=JDWP.EventKind.MONITOR_WAITED
0N/A "Notification that a thread in the target VM has finished waiting on "
4119N/A "Requires canRequestMonitorEvents capability - see "
4119N/A "<a href=\"#JDWP_VirtualMachine_CapabilitiesNew\">CapabilitiesNew</a>. "
0N/A "a monitor object. "
0N/A "<p>Since JDWP version 1.6. "
0N/A
0N/A (int requestID
0N/A "Request that generated event")
0N/A (threadObject thread "Thread which waited")
0N/A (tagged-object object "Monitor object reference")
0N/A (location location "Location at which the wait occured")
0N/A (boolean timed_out "True if timed out")
0N/A )
0N/A (Alt Exception=JDWP.EventKind.EXCEPTION
0N/A "Notification of an exception in the target VM. "
0N/A "If the exception is thrown from a non-native method, "
0N/A "the exception event is generated at the location where the "
0N/A "exception is thrown. "
0N/A "If the exception is thrown from a native method, the exception event "
0N/A "is generated at the first non-native location reached after the exception "
0N/A "is thrown. "
0N/A
0N/A (int requestID "Request that generated event")
0N/A (threadObject thread "Thread with exception")
0N/A (location location "Location of exception throw "
0N/A "(or first non-native location after throw if thrown from a native method)")
0N/A (tagged-object exception "Thrown exception")
0N/A (location catchLocation
0N/A "Location of catch, or 0 if not caught. An exception "
0N/A "is considered to be caught if, at the point of the throw, the "
0N/A "current location is dynamically enclosed in a try statement that "
0N/A "handles the exception. (See the JVM specification for details). "
0N/A "If there is such a try statement, the catch location is the "
0N/A "first location in the appropriate catch clause. "
0N/A "<p>"
0N/A "If there are native methods in the call stack at the time of the "
0N/A "exception, there are important restrictions to note about the "
0N/A "returned catch location. In such cases, "
0N/A "it is not possible to predict whether an exception will be handled "
0N/A "by some native method on the call stack. "
0N/A "Thus, it is possible that exceptions considered uncaught "
0N/A "here will, in fact, be handled by a native method and not cause "
0N/A "termination of the target VM. Furthermore, it cannot be assumed that the "
0N/A "catch location returned here will ever be reached by the throwing "
0N/A "thread. If there is "
0N/A "a native frame between the current location and the catch location, "
0N/A "the exception might be handled and cleared in that native method "
0N/A "instead. "
0N/A "<p>"
0N/A "Note that compilers can generate try-catch blocks in some cases "
0N/A "where they are not explicit in the source code; for example, "
0N/A "the code generated for <code>synchronized</code> and "
0N/A "<code>finally</code> blocks can contain implicit try-catch blocks. "
0N/A "If such an implicitly generated try-catch is "
0N/A "present on the call stack at the time of the throw, the exception "
0N/A "will be considered caught even though it appears to be uncaught from "
0N/A "examination of the source code. "
0N/A )
0N/A )
0N/A (Alt ThreadStart=JDWP.EventKind.THREAD_START
0N/A "Notification of a new running thread in the target VM. "
0N/A "The new thread can be the result of a call to "
0N/A "<code>java.lang.Thread.start</code> or the result of "
0N/A "attaching a new thread to the VM though JNI. The "
0N/A "notification is generated by the new thread some time before "
0N/A "its execution starts. "
0N/A "Because of this timing, it is possible to receive other events "
0N/A "for the thread before this event is received. (Notably, "
0N/A "Method Entry Events and Method Exit Events might occur "
0N/A "during thread initialization. "
0N/A "It is also possible for the "
0N/A "<a href=\"#JDWP_VirtualMachine_AllThreads\">VirtualMachine AllThreads</a> "
0N/A "command to return "
0N/A "a thread before its thread start event is received. "
0N/A "<p>"
0N/A "Note that this event gives no information "
0N/A "about the creation of the thread object which may have happened "
0N/A "much earlier, depending on the VM being debugged. "
0N/A
0N/A (int requestID "Request that generated event")
0N/A (threadObject thread "Started thread")
0N/A )
0N/A (Alt ThreadDeath=JDWP.EventKind.THREAD_DEATH
0N/A "Notification of a completed thread in the target VM. The "
0N/A "notification is generated by the dying thread before it terminates. "
0N/A "Because of this timing, it is possible "
0N/A "for {@link VirtualMachine#allThreads} to return this thread "
0N/A "after this event is received. "
0N/A "<p>"
0N/A "Note that this event gives no information "
0N/A "about the lifetime of the thread object. It may or may not be collected "
0N/A "soon depending on what references exist in the target VM. "
0N/A
0N/A (int requestID "Request that generated event")
0N/A (threadObject thread "Ending thread")
0N/A )
0N/A (Alt ClassPrepare=JDWP.EventKind.CLASS_PREPARE
0N/A "Notification of a class prepare in the target VM. See the JVM "
0N/A "specification for a definition of class preparation. Class prepare "
0N/A "events are not generated for primtiive classes (for example, "
0N/A "java.lang.Integer.TYPE). "
0N/A
0N/A (int requestID "Request that generated event")
0N/A (threadObject thread "Preparing thread. "
0N/A "In rare cases, this event may occur in a debugger system "
0N/A "thread within the target VM. Debugger threads take precautions "
0N/A "to prevent these events, but they cannot be avoided under some "
0N/A "conditions, especially for some subclasses of "
0N/A "java.lang.Error. "
0N/A "If the event was generated by a debugger system thread, the "
0N/A "value returned by this method is null, and if the requested "
0N/A "<a href=\"#JDWP_SuspendPolicy\">suspend policy</a> "
0N/A "for the event was EVENT_THREAD "
0N/A "all threads will be suspended instead, and the "
0N/A "composite event's suspend policy will reflect this change. "
0N/A "<p>"
0N/A "Note that the discussion above does not apply to system threads "
0N/A "created by the target VM during its normal (non-debug) operation. "
0N/A )
0N/A (byte refTypeTag "Kind of reference type. "
0N/A "See <a href=\"#JDWP_TypeTag\">JDWP.TypeTag</a>")
0N/A (referenceTypeID typeID "Type being prepared")
0N/A (string signature "Type signature")
0N/A (int status "Status of type. "
0N/A "See <a href=\"#JDWP_ClassStatus\">JDWP.ClassStatus</a>")
0N/A )
0N/A (Alt ClassUnload=JDWP.EventKind.CLASS_UNLOAD
0N/A "Notification of a class unload in the target VM. "
0N/A "<p>"
0N/A "There are severe constraints on the debugger back-end during "
0N/A "garbage collection, so unload information is greatly limited. "
0N/A
0N/A (int requestID "Request that generated event")
0N/A (string signature "Type signature")
0N/A )
0N/A (Alt FieldAccess=JDWP.EventKind.FIELD_ACCESS
0N/A "Notification of a field access in the target VM. "
0N/A "Field modifications "
0N/A "are not considered field accesses. "
0N/A "Requires canWatchFieldAccess capability - see "
0N/A "<a href=\"#JDWP_VirtualMachine_CapabilitiesNew\">CapabilitiesNew</a>."
0N/A
0N/A (int requestID "Request that generated event")
0N/A (threadObject thread "Accessing thread")
0N/A (location location "Location of access")
0N/A (byte refTypeTag "Kind of reference type. "
0N/A "See <a href=\"#JDWP_TypeTag\">JDWP.TypeTag</a>")
0N/A (referenceTypeID typeID "Type of field")
0N/A (field fieldID "Field being accessed")
0N/A (tagged-object object
0N/A "Object being accessed (null=0 for statics")
0N/A )
0N/A (Alt FieldModification=JDWP.EventKind.FIELD_MODIFICATION
0N/A "Notification of a field modification in the target VM. "
0N/A "Requires canWatchFieldModification capability - see "
0N/A "<a href=\"#JDWP_VirtualMachine_CapabilitiesNew\">CapabilitiesNew</a>."
0N/A
0N/A (int requestID "Request that generated event")
0N/A (threadObject thread "Modifying thread")
0N/A (location location "Location of modify")
0N/A (byte refTypeTag "Kind of reference type. "
0N/A "See <a href=\"#JDWP_TypeTag\">JDWP.TypeTag</a>")
0N/A (referenceTypeID typeID "Type of field")
0N/A (field fieldID "Field being modified")
0N/A (tagged-object object
0N/A "Object being modified (null=0 for statics")
0N/A (value valueToBe "Value to be assigned")
0N/A )
0N/A (Alt VMDeath=JDWP.EventKind.VM_DEATH
0N/A (int requestID
0N/A "Request that generated event")
0N/A )
0N/A )
0N/A )
0N/A )
0N/A )
0N/A)
0N/A(ConstantSet Error
0N/A (Constant NONE =0 "No error has occurred.")
0N/A (Constant INVALID_THREAD =10 "Passed thread is null, is not a valid thread or has exited.")
0N/A (Constant INVALID_THREAD_GROUP =11 "Thread group invalid.")
0N/A (Constant INVALID_PRIORITY =12 "Invalid priority.")
0N/A (Constant THREAD_NOT_SUSPENDED =13 "If the specified thread has not been "
0N/A "suspended by an event.")
0N/A (Constant THREAD_SUSPENDED =14 "Thread already suspended.")
0N/A (Constant THREAD_NOT_ALIVE =15 "Thread has not been started or is now dead.")
0N/A
0N/A (Constant INVALID_OBJECT =20 "If this reference type has been unloaded "
0N/A "and garbage collected.")
0N/A (Constant INVALID_CLASS =21 "Invalid class.")
0N/A (Constant CLASS_NOT_PREPARED =22 "Class has been loaded but not yet prepared.")
0N/A (Constant INVALID_METHODID =23 "Invalid method.")
0N/A (Constant INVALID_LOCATION =24 "Invalid location.")
0N/A (Constant INVALID_FIELDID =25 "Invalid field.")
0N/A (Constant INVALID_FRAMEID =30 "Invalid jframeID.")
0N/A (Constant NO_MORE_FRAMES =31 "There are no more Java or JNI frames on the "
0N/A "call stack.")
0N/A (Constant OPAQUE_FRAME =32 "Information about the frame is not available.")
0N/A (Constant NOT_CURRENT_FRAME =33 "Operation can only be performed on current frame.")
0N/A (Constant TYPE_MISMATCH =34 "The variable is not an appropriate type for "
0N/A "the function used.")
0N/A (Constant INVALID_SLOT =35 "Invalid slot.")
0N/A (Constant DUPLICATE =40 "Item already set.")
0N/A (Constant NOT_FOUND =41 "Desired element not found.")
0N/A (Constant INVALID_MONITOR =50 "Invalid monitor.")
0N/A (Constant NOT_MONITOR_OWNER =51 "This thread doesn't own the monitor.")
0N/A (Constant INTERRUPT =52 "The call has been interrupted before completion.")
0N/A (Constant INVALID_CLASS_FORMAT =60 "The virtual machine attempted to read a class "
0N/A "file and determined that the file is malformed "
0N/A "or otherwise cannot be interpreted as a class file.")
0N/A (Constant CIRCULAR_CLASS_DEFINITION
0N/A =61 "A circularity has been detected while "
0N/A "initializing a class.")
0N/A (Constant FAILS_VERIFICATION =62 "The verifier detected that a class file, "
0N/A "though well formed, contained some sort of "
0N/A "internal inconsistency or security problem.")
0N/A (Constant ADD_METHOD_NOT_IMPLEMENTED
0N/A =63 "Adding methods has not been implemented.")
0N/A (Constant SCHEMA_CHANGE_NOT_IMPLEMENTED
0N/A =64 "Schema change has not been implemented.")
0N/A (Constant INVALID_TYPESTATE =65 "The state of the thread has been modified, "
0N/A "and is now inconsistent.")
0N/A (Constant HIERARCHY_CHANGE_NOT_IMPLEMENTED
0N/A =66 "A direct superclass is different for the new class "
0N/A "version, or the set of directly implemented "
0N/A "interfaces is different "
0N/A "and canUnrestrictedlyRedefineClasses is false.")
0N/A (Constant DELETE_METHOD_NOT_IMPLEMENTED
0N/A =67 "The new class version does not declare a method "
0N/A "declared in the old class version "
0N/A "and canUnrestrictedlyRedefineClasses is false.")
0N/A (Constant UNSUPPORTED_VERSION =68 "A class file has a version number not supported "
0N/A "by this VM.")
0N/A (Constant NAMES_DONT_MATCH =69 "The class name defined in the new class file is "
0N/A "different from the name in the old class object.")
0N/A (Constant CLASS_MODIFIERS_CHANGE_NOT_IMPLEMENTED
0N/A =70 "The new class version has different modifiers and "
0N/A "and canUnrestrictedlyRedefineClasses is false.")
0N/A (Constant METHOD_MODIFIERS_CHANGE_NOT_IMPLEMENTED
0N/A =71 "A method in the new class version has "
0N/A "different modifiers "
0N/A "than its counterpart in the old class version and "
0N/A "and canUnrestrictedlyRedefineClasses is false.")
0N/A (Constant NOT_IMPLEMENTED =99 "The functionality is not implemented in "
0N/A "this virtual machine.")
0N/A (Constant NULL_POINTER =100 "Invalid pointer.")
0N/A (Constant ABSENT_INFORMATION =101 "Desired information is not available.")
0N/A (Constant INVALID_EVENT_TYPE =102 "The specified event type id is not recognized.")
0N/A (Constant ILLEGAL_ARGUMENT =103 "Illegal argument.")
0N/A (Constant OUT_OF_MEMORY =110 "The function needed to allocate memory and "
0N/A "no more memory was available for allocation.")
0N/A (Constant ACCESS_DENIED =111 "Debugging has not been enabled in this "
0N/A "virtual machine. JVMTI cannot be used.")
0N/A (Constant VM_DEAD =112 "The virtual machine is not running.")
0N/A (Constant INTERNAL =113 "An unexpected internal error has occurred.")
0N/A (Constant UNATTACHED_THREAD =115 "The thread being used to call this function "
0N/A "is not attached to the virtual machine. "
0N/A "Calls must be made from attached threads.")
0N/A (Constant INVALID_TAG =500 "object type id or class tag.")
0N/A (Constant ALREADY_INVOKING =502 "Previous invoke not complete.")
0N/A (Constant INVALID_INDEX =503 "Index is invalid.")
0N/A (Constant INVALID_LENGTH =504 "The length is invalid.")
0N/A (Constant INVALID_STRING =506 "The string is invalid.")
0N/A (Constant INVALID_CLASS_LOADER =507 "The class loader is invalid.")
0N/A (Constant INVALID_ARRAY =508 "The array is invalid.")
0N/A (Constant TRANSPORT_LOAD =509 "Unable to load the transport.")
0N/A (Constant TRANSPORT_INIT =510 "Unable to initialize the transport.")
0N/A (Constant NATIVE_METHOD =511 )
0N/A (Constant INVALID_COUNT =512 "The count is invalid.")
0N/A)
0N/A(ConstantSet EventKind
0N/A (Constant SINGLE_STEP =1 )
0N/A (Constant BREAKPOINT =2 )
0N/A (Constant FRAME_POP =3 )
0N/A (Constant EXCEPTION =4 )
0N/A (Constant USER_DEFINED =5 )
0N/A (Constant THREAD_START =6 )
0N/A (Constant THREAD_DEATH =7 )
0N/A (Constant THREAD_END =7 "obsolete - was used in jvmdi")
0N/A (Constant CLASS_PREPARE =8 )
0N/A (Constant CLASS_UNLOAD =9 )
0N/A (Constant CLASS_LOAD =10 )
0N/A (Constant FIELD_ACCESS =20 )
0N/A (Constant FIELD_MODIFICATION =21 )
0N/A (Constant EXCEPTION_CATCH =30 )
0N/A (Constant METHOD_ENTRY =40 )
0N/A (Constant METHOD_EXIT =41 )
0N/A (Constant METHOD_EXIT_WITH_RETURN_VALUE =42 )
0N/A (Constant MONITOR_CONTENDED_ENTER =43 )
4119N/A (Constant MONITOR_CONTENDED_ENTERED =44 )
4119N/A (Constant MONITOR_WAIT =45 )
4119N/A (Constant MONITOR_WAITED =46 )
0N/A (Constant VM_START =90 )
0N/A (Constant VM_INIT =90 "obsolete - was used in jvmdi")
0N/A (Constant VM_DEATH =99 )
0N/A (Constant VM_DISCONNECTED =100 "Never sent across JDWP")
0N/A)
0N/A
0N/A(ConstantSet ThreadStatus
0N/A (Constant ZOMBIE =0 )
0N/A (Constant RUNNING =1 )
0N/A (Constant SLEEPING =2 )
0N/A (Constant MONITOR =3 )
0N/A (Constant WAIT =4 )
0N/A)
0N/A
0N/A(ConstantSet SuspendStatus
0N/A (Constant SUSPEND_STATUS_SUSPENDED = 0x1 )
0N/A)
0N/A(ConstantSet ClassStatus
0N/A (Constant VERIFIED =1 )
0N/A (Constant PREPARED =2 )
0N/A (Constant INITIALIZED =4 )
0N/A (Constant ERROR =8 )
0N/A)
0N/A(ConstantSet TypeTag
0N/A (Constant CLASS=1 "ReferenceType is a class. ")
0N/A (Constant INTERFACE=2 "ReferenceType is an interface. ")
0N/A (Constant ARRAY=3 "ReferenceType is an array. ")
0N/A)
0N/A(ConstantSet Tag
0N/A (Constant ARRAY = '[' "'[' - an array object (objectID size). ")
0N/A (Constant BYTE = 'B' "'B' - a byte value (1 byte).")
0N/A (Constant CHAR = 'C' "'C' - a character value (2 bytes).")
0N/A (Constant OBJECT = 'L' "'L' - an object (objectID size).")
0N/A (Constant FLOAT = 'F' "'F' - a float value (4 bytes).")
0N/A (Constant DOUBLE = 'D' "'D' - a double value (8 bytes).")
0N/A (Constant INT = 'I' "'I' - an int value (4 bytes).")
0N/A (Constant LONG = 'J' "'J' - a long value (8 bytes).")
0N/A (Constant SHORT = 'S' "'S' - a short value (2 bytes).")
0N/A (Constant VOID = 'V' "'V' - a void value (no bytes).")
0N/A (Constant BOOLEAN = 'Z' "'Z' - a boolean value (1 byte).")
0N/A (Constant STRING = 's' "'s' - a String object (objectID size). ")
0N/A (Constant THREAD = 't' "'t' - a Thread object (objectID size). ")
0N/A (Constant THREAD_GROUP = 'g'
0N/A "'g' - a ThreadGroup object (objectID size). ")
0N/A (Constant CLASS_LOADER = 'l'
0N/A "'l' - a ClassLoader object (objectID size). ")
0N/A (Constant CLASS_OBJECT = 'c'
0N/A "'c' - a class object object (objectID size). ")
0N/A)
0N/A
0N/A(ConstantSet StepDepth
0N/A (Constant INTO = 0
0N/A "Step into any method calls that occur before the end of the step. ")
0N/A (Constant OVER = 1
0N/A "Step over any method calls that occur before the end of the step. ")
0N/A (Constant OUT = 2
0N/A "Step out of the current method. ")
0N/A)
0N/A
0N/A(ConstantSet StepSize
0N/A (Constant MIN = 0
0N/A "Step by the minimum possible amount (often a bytecode instruction). ")
0N/A (Constant LINE = 1
0N/A "Step to the next source line unless there is no line number information in which case a MIN step is done instead.")
0N/A)
0N/A
0N/A(ConstantSet SuspendPolicy
0N/A (Constant NONE = 0
0N/A "Suspend no threads when this event is encountered. ")
0N/A (Constant EVENT_THREAD = 1
0N/A "Suspend the event thread when this event is encountered. ")
0N/A (Constant ALL = 2
0N/A "Suspend all threads when this event is encountered. ")
0N/A)
0N/A
0N/A(ConstantSet InvokeOptions
0N/A "The invoke options are a combination of zero or more of the following bit flags:"
0N/A (Constant INVOKE_SINGLE_THREADED = 0x01
0N/A "otherwise, all threads started. ")
0N/A (Constant INVOKE_NONVIRTUAL = 0x02
0N/A "otherwise, normal virtual invoke (instance methods only)")
0N/A)
0N/A
0N/A