/*
*
*
* accompanied this code).
*
*
* questions.
*/
JDWP "Java(tm) Debug Wire Protocol"
"Returns the JDWP version implemented by the target VM. "
"The version string format is implementation dependent. "
(Out
)
)
)
)
"Returns reference types for all the classes loaded by the target VM "
"which match the given signature. "
"Multple reference types will be returned if two or more class "
"loaders have loaded a class of the same name. "
"The search is confined to loaded classes only; no attempt is made "
"to load a class of the given signature. "
(Out
)
)
"of following reference type. ")
"<a href=\"#JDWP_ClassStatus\">status.</a> ")
)
)
)
)
)
"Returns reference types for all classes currently loaded by the "
"target VM."
(Out
)
"of following reference type. ")
"The JNI signature of the loaded reference type")
"<a href=\"#JDWP_ClassStatus\">status.</a> ")
)
)
)
)
)
"Returns all threads currently running in the target VM . "
"The returned list contains threads created through "
"java.lang.Thread, all native threads attached to "
"the target VM through JNI, and system threads created "
"by the target VM. Threads that have not yet been started "
"and threads that have completed their execution are not "
"included in the returned list. "
(Out
)
)
)
)
)
"Returns all thread groups that do not have a parent. This command "
"may be used as the first step in building a tree (or trees) of the "
"existing thread groups."
(Out
)
)
)
)
)
"Invalidates this virtual machine mirror. "
"The communication channel to the target VM is closed, and "
"the target VM prepares to accept another subsequent connection "
"from this debugger or another debugger, including the "
"following tasks: "
"<ul>"
"<li>All event requests are cancelled. "
"<li>All threads suspended by the thread-level "
"<a href=\"#JDWP_ThreadReference_Resume\">resume</a> command "
"or the VM-level "
"<a href=\"#JDWP_VirtualMachine_Resume\">resume</a> command "
"are resumed as many times as necessary for them to run. "
"<li>Garbage collection is re-enabled in all cases where it was "
"<a href=\"#JDWP_ObjectReference_DisableCollection\">disabled</a> "
"</ul>"
"Any current method invocations executing in the target VM "
"are continued after the disconnection. Upon completion of any such "
"method invocation, the invoking thread continues from the "
"location where it was originally stopped. "
"<p>"
"Resources originating in "
"this VirtualMachine (ObjectReferences, ReferenceTypes, etc.) "
"will become invalid. "
(Out
)
)
)
)
"Returns the sizes of variably-sized data types in the target VM."
"The returned values indicate the number of bytes used by the "
"identifiers in command and reply packets."
(Out
)
)
)
)
"Suspends the execution of the application running in the target "
"VM. All Java threads currently running will be suspended. "
"<p>"
"Unlike java.lang.Thread.suspend, "
"suspends of both the virtual machine and individual threads are "
"counted. Before a thread will run again, it must be resumed through "
"the <a href=\"#JDWP_VirtualMachine_Resume\">VM-level resume</a> command "
"or the <a href=\"#JDWP_ThreadReference_Resume\">thread-level resume</a> command "
"the same number of times it has been suspended. "
(Out
)
)
)
)
"Resumes execution of the application after the suspend "
"command or an event has stopped it. "
"Suspensions of the Virtual Machine and individual threads are "
"counted. If a particular thread is suspended n times, it must "
"resumed n times before it will continue. "
(Out
)
)
)
)
"Terminates the target VM with the given exit code. "
"On some platforms, the exit code might be truncated, for "
"example, to the low order 8 bits. "
"All ids previously returned from the target VM become invalid. "
"Threads running in the VM are abruptly terminated. "
"A thread death exception is not thrown and "
"finally blocks are not run."
(Out
)
)
)
)
(Command CreateString=11
"Creates a new string object in the target VM and returns "
"its id. "
(Out
)
)
)
)
(Command Capabilities=12
"Retrieve this VM's capabilities. The capabilities are returned "
"as booleans, each indicating the presence or absence of a "
"capability. The commands associated with each capability will "
"return the NOT_IMPLEMENTED error if the cabability is not "
"available."
(Out
)
(boolean canWatchFieldModification
"Can the VM watch field modification, and therefore "
"can it send the Modification Watchpoint Event?")
(boolean canWatchFieldAccess
"Can the VM watch field access, and therefore "
"can it send the Access Watchpoint Event?")
(boolean canGetBytecodes
"Can the VM get the bytecodes of a given method? ")
(boolean canGetSyntheticAttribute
"Can the VM determine whether a field or method is "
"synthetic? (that is, can the VM determine if the "
"method or the field was invented by the compiler?) ")
(boolean canGetOwnedMonitorInfo
"Can the VM get the owned monitors infornation for "
"a thread?")
(boolean canGetCurrentContendedMonitor
"Can the VM get the current contended monitor of a thread?")
(boolean canGetMonitorInfo
"Can the VM get the monitor information for a given object? ")
)
)
)
(Command ClassPaths=13
"Retrieve the classpath and bootclasspath of the target VM. "
"If the classpath is not defined, returns an empty list. If the "
"bootclasspath is not defined returns an empty list."
(Out
)
"paths in either of the following lists.")
)
)
)
"Releases a list of object IDs. For each object in the list, the "
"following applies. "
"The count of references held by the back-end (the reference "
"count) will be decremented by refCnt. "
"If thereafter the reference count is less than "
"or equal to zero, the ID is freed. "
"Any back-end resources associated with the freed ID may "
"be freed, and if garbage collection was "
"disabled for the object, it will be re-enabled. "
"The sender of this command "
"promises that no further commands will be sent "
"referencing a freed ID.
"<p>"
"<p>"
(Out
(Group Request
)
)
)
(Reply
)
(ErrorSet
)
)
(Command HoldEvents=15
"Responses to commands are never held and are not affected by this
(Out
)
(Reply
)
(ErrorSet
)
)
(Command ReleaseEvents=16
(Out
)
(Reply
)
(ErrorSet
)
)
(Command CapabilitiesNew=17
"as booleans, each indicating the presence or absence of a "
"capability. The commands associated with each capability will "
"return the NOT_IMPLEMENTED error if the cabability is not "
"available."
"Since JDWP version 1.4."
(Out
)
(Reply
(boolean canWatchFieldModification
"Can the VM watch field modification, and therefore "
"can it send the Modification Watchpoint Event?")
(boolean canWatchFieldAccess
"Can the VM watch field access, and therefore "
"can it send the Access Watchpoint Event?")
(boolean canGetBytecodes
"Can the VM get the bytecodes of a given method? ")
(boolean canGetSyntheticAttribute
"Can the VM determine whether a field or method is "
"synthetic? (that is, can the VM determine if the "
"method or the field was invented by the compiler?) ")
(boolean canGetOwnedMonitorInfo
"Can the VM get the owned monitors infornation for "
"a thread?")
(boolean canGetCurrentContendedMonitor
"Can the VM get the current contended monitor of a thread?")
(boolean canGetMonitorInfo
"Can the VM get the monitor information for a given object? ")
(boolean canRedefineClasses
"Can the VM redefine classes?")
(boolean canAddMethod
"Can the VM add methods when redefining "
"classes?")
(boolean canUnrestrictedlyRedefineClasses
"Can the VM redefine classes"
"in arbitrary ways?")
(boolean canPopFrames
"Can the VM pop stack frames?")
(boolean canUseInstanceFilters
"Can the VM filter events by specific object?")
(boolean canGetSourceDebugExtension
"Can the VM get the source debug extension?")
(boolean canRequestVMDeathEvent
"Can the VM request VM death events?")
(boolean canSetDefaultStratum
"Can the VM set a default stratum?")
(boolean canGetInstanceInfo
"Can the VM return instances, counts of instances of classes "
"and referring objects?")
(boolean canRequestMonitorEvents
"Can the VM request monitor events?")
(boolean canGetMonitorFrameInfo
"Can the VM get monitors with frame depth info?")
(boolean canUseSourceNameFilters
"Can the VM filter class prepare events by source name?")
(boolean canGetConstantPool
"Can the VM return the constant pool information?")
(boolean canForceEarlyReturn
"Can the VM force early return from a method?")
(boolean reserved22
"Reserved for future capability")
(boolean reserved23
"Reserved for future capability")
(boolean reserved24
"Reserved for future capability")
(boolean reserved25
"Reserved for future capability")
(boolean reserved26
"Reserved for future capability")
(boolean reserved27
"Reserved for future capability")
(boolean reserved28
"Reserved for future capability")
(boolean reserved29
"Reserved for future capability")
(boolean reserved30
"Reserved for future capability")
(boolean reserved31
"Reserved for future capability")
(boolean reserved32
"Reserved for future capability")
)
(ErrorSet
(Error VM_DEAD)
)
)
(Command RedefineClasses=18
"Installs new class definitions. "
"If there are active stack frames in methods of the redefined classes in the "
"target VM then those active frames continue to run the bytecodes of the "
"original method. These methods are considered obsolete - see "
"<a href=\"#JDWP_Method_IsObsolete\">IsObsolete</a>. The methods in the "
"redefined classes will be used for new invokes in the target VM. "
"The original method ID refers to the redefined method. "
"All breakpoints in the redefined classes are cleared."
"If resetting of stack frames is desired, the "
"<a href=\"#JDWP_StackFrame_PopFrames\">PopFrames</a> command can be used "
"to pop frames with obsolete methods."
"<p>"
"Requires canRedefineClasses capability - see "
"<a href=\"#JDWP_VirtualMachine_CapabilitiesNew\">CapabilitiesNew</a>. "
"In addition to the canRedefineClasses capability, the target VM must "
"have the canAddMethod capability to add methods when redefining classes, "
"or the canUnrestrictedlyRedefineClasses to redefine classes in arbitrary "
"ways."
(Out
(Repeat classes "Number of reference types that follow."
(Group ClassDef
(referenceType refType "The reference type.")
(Repeat classfile "Number of bytes defining class (below)"
(byte classbyte "byte in JVM class file "
"format.")
)
)
)
)
(Reply
)
(ErrorSet
(Error INVALID_CLASS "One of the refTypes is not the ID of a reference "
"type.")
(Error INVALID_OBJECT "One of the refTypes is not a known ID.")
(Error UNSUPPORTED_VERSION)
(Error INVALID_CLASS_FORMAT)
(Error CIRCULAR_CLASS_DEFINITION)
(Error FAILS_VERIFICATION)
(Error NAMES_DONT_MATCH)
(Error NOT_IMPLEMENTED "No aspect of this functionality is implemented "
"(CapabilitiesNew.canRedefineClasses is false)")
(Error ADD_METHOD_NOT_IMPLEMENTED)
(Error SCHEMA_CHANGE_NOT_IMPLEMENTED)
(Error HIERARCHY_CHANGE_NOT_IMPLEMENTED)
(Error DELETE_METHOD_NOT_IMPLEMENTED)
(Error CLASS_MODIFIERS_CHANGE_NOT_IMPLEMENTED)
(Error METHOD_MODIFIERS_CHANGE_NOT_IMPLEMENTED)
(Error VM_DEAD)
)
)
(Command SetDefaultStratum=19
"Set the default stratum. Requires canSetDefaultStratum capability - see "
"<a href=\"#JDWP_VirtualMachine_CapabilitiesNew\">CapabilitiesNew</a>."
(Out
(string stratumID "default stratum, or empty string to use "
"reference type default.")
)
(Reply
)
(ErrorSet
(Error NOT_IMPLEMENTED)
(Error VM_DEAD)
)
)
(Command AllClassesWithGeneric=20
"Returns reference types for all classes currently loaded by the "
"target VM. "
"Both the JNI signature and the generic signature are "
"returned for each class. "
"Generic signatures are described in the signature attribute "
"section in "
"<cite>The Java™ Virtual Machine Specification</cite>. "
"Since JDWP version 1.5."
(Out
)
(Reply
(Repeat classes "Number of reference types that follow."
(Group ClassInfo
(byte refTypeTag "<a href=\"#JDWP_TypeTag\">Kind</a> "
"of following reference type. ")
(referenceTypeID typeID "Loaded reference type")
(string signature
"The JNI signature of the loaded reference type.")
(string genericSignature
"The generic signature of the loaded reference type "
"or an empty string if there is none.")
(int status "The current class "
"<a href=\"#JDWP_ClassStatus\">status.</a> ")
)
)
)
(ErrorSet
(Error VM_DEAD)
)
)
(Command InstanceCounts=21
"Returns the number of instances of each reference type in the input list. "
"Only instances that are reachable for the purposes of "
"garbage collection are counted. If a reference type is invalid, "
"eg. it has been unloaded, zero is returned for its instance count."
"<p>Since JDWP version 1.6. Requires canGetInstanceInfo capability - see "
"<a href=\"#JDWP_VirtualMachine_CapabilitiesNew\">CapabilitiesNew</a>."
(Out
(Repeat refTypesCount "Number of reference types that follow. Must be non-negative."
(referenceType refType "A reference type ID.")
)
)
(Reply
(Repeat counts "The number of counts that follow."
(long instanceCount "The number of instances for the corresponding reference type "
)
)
(ErrorSet
(Error ILLEGAL_ARGUMENT "refTypesCount is less than zero.")
(Error NOT_IMPLEMENTED)
(Error VM_DEAD)
)
)
)
(CommandSet ReferenceType=2
(Command Signature=1
"Returns the JNI signature of a reference type. "
"JNI signature formats are described in the "
"<a href=\"http://java.sun.com/products/jdk/1.2/docs/guide/jni/index.html\">Java Native Inteface Specification</a>"
"<p>
"For primitive classes "
"the returned signature is the signature of the corresponding primitive "
"type; for example, \"I\" is returned as the signature of the class "
"represented by java.lang.Integer.TYPE."
(Out
(referenceType refType "The reference type ID.")
)
(Reply
(string signature
"The JNI signature for the reference type.")
)
(ErrorSet
(Error INVALID_CLASS "refType is not the ID of a reference "
"type.")
(Error INVALID_OBJECT "refType is not a known ID.")
(Error VM_DEAD)
)
)
(Command ClassLoader=2
"Returns the instance of java.lang.ClassLoader which loaded "
"a given reference type. If the reference type was loaded by the "
"system class loader, the returned object ID is null."
(Out
(referenceType refType "The reference type ID.")
)
(Reply
(classLoaderObject classLoader "The class loader for the reference type. ")
)
(ErrorSet
(Error INVALID_CLASS "refType is not the ID of a reference "
"type.")
(Error INVALID_OBJECT "refType is not a known ID.")
(Error VM_DEAD)
)
)
(Command Modifiers=3
"Returns the modifiers (also known as access flags) for a reference type. "
"The returned bit mask contains information on the declaration "
"of the reference type. If the reference type is an array or "
"a primitive class (for example, java.lang.Integer.TYPE), the "
"value of the returned bit mask is undefined."
(Out
(referenceType refType "The reference type ID.")
)
(Reply
(int modBits "Modifier bits as defined in Chapter 4 of "
"<cite>The Java™ Virtual Machine Specification</cite>")
)
(ErrorSet
(Error INVALID_CLASS "refType is not the ID of a reference "
"type.")
(Error INVALID_OBJECT "refType is not a known ID.")
(Error VM_DEAD)
)
)
(Command Fields=4
"Returns information for each field in a reference type. "
"Inherited fields are not included. "
"The field list will include any synthetic fields created "
"by the compiler. "
"Fields are returned in the order they occur in the class file."
(Out
(referenceType refType "The reference type ID.")
)
(Reply
(Repeat declared "Number of declared fields."
(Group FieldInfo
(field fieldID "Field ID.")
(string name "Name of field.")
(string signature "JNI Signature of field.")
(int modBits "The modifier bit flags (also known as access flags) "
"which provide additional information on the "
"field declaration. Individual flag values are "
"defined in Chapter 4 of "
"<cite>The Java™ Virtual Machine Specification</cite>. "
"In addition, The <code>0xf0000000</code> bit identifies "
"the field as synthetic, if the synthetic attribute "
"<a href=\"#JDWP_VirtualMachine_Capabilities\">capability</a> is available.")
)
)
)
(ErrorSet
(Error CLASS_NOT_PREPARED)
(Error INVALID_CLASS "refType is not the ID of a reference "
"type.")
(Error INVALID_OBJECT "refType is not a known ID.")
(Error VM_DEAD)
)
)
(Command Methods=5
"Returns information for each method in a reference type. "
"Inherited methods are not included. The list of methods will "
"include constructors (identified with the name \"<init>\"), "
"the initialization method (identified with the name \"<clinit>\") "
"if present, and any synthetic methods created by the compiler. "
"Methods are returned in the order they occur in the class file."
(Out
(referenceType refType "The reference type ID.")
)
(Reply
(Repeat declared "Number of declared methods."
(Group MethodInfo
(method methodID "Method ID.")
(string name "Name of method.")
(string signature "JNI signature of method.")
(int modBits "The modifier bit flags (also known as access flags) "
"which provide additional information on the "
"method declaration. Individual flag values are "
"defined in Chapter 4 of "
"<cite>The Java™ Virtual Machine Specification</cite>. "
"In addition, The <code>0xf0000000</code> bit identifies "
"the method as synthetic, if the synthetic attribute "
"<a href=\"#JDWP_VirtualMachine_Capabilities\">capability</a> is available.")
)
)
)
(ErrorSet
(Error CLASS_NOT_PREPARED)
(Error INVALID_CLASS "refType is not the ID of a reference "
"type.")
(Error INVALID_OBJECT "refType is not a known ID.")
(Error VM_DEAD)
)
)
(Command GetValues=6
"Returns the value of one or more static fields of the "
"reference type. Each field must be member of the reference type "
"or one of its superclasses, superinterfaces, or implemented interfaces. "
"Access control is not enforced; for example, the values of private "
"fields can be obtained."
(Out
(referenceType refType "The reference type ID.")
(Repeat fields "The number of values to get"
(Group Field
(field fieldID "A field to get")
)
)
)
(Reply
(Repeat values "The number of values returned, always equal to fields, "
"the number of values to get."
(value value "The field value")
)
)
(ErrorSet
(Error INVALID_CLASS "refType is not the ID of a reference "
"type.")
(Error INVALID_OBJECT "refType is not a known ID.")
(Error INVALID_FIELDID)
(Error VM_DEAD)
)
)
(Command SourceFile=7
"Returns the name of source file in which a reference type was "
"declared. "
(Out
(referenceType refType "The reference type ID.")
)
(Reply
(string sourceFile "The source file name. No path information "
"for the file is included")
)
(ErrorSet
(Error INVALID_CLASS "refType is not the ID of a reference "
"type.")
(Error INVALID_OBJECT "refType is not a known ID.")
(Error ABSENT_INFORMATION "The source file attribute is absent.")
(Error VM_DEAD)
)
)
(Command NestedTypes=8
"Returns the classes and interfaces directly nested within this type."
"Types further nested within those types are not included. "
(Out
(referenceType refType "The reference type ID.")
)
(Reply
(Repeat classes "The number of nested classes and interfaces"
(Group TypeInfo
(byte refTypeTag "<a href=\"#JDWP_TypeTag\">Kind</a> "
"of following reference type. ")
(referenceTypeID typeID "The nested class or interface ID.")
)
)
)
(ErrorSet
(Error INVALID_CLASS "refType is not the ID of a reference "
"type.")
(Error INVALID_OBJECT "refType is not a known ID.")
(Error VM_DEAD)
)
)
(Command Status=9
"Returns the current status of the reference type. The status "
"indicates the extent to which the reference type has been "
"initialized, as described in section 2.1.6 of "
"<cite>The Java™ Virtual Machine Specification</cite>. "
"If the class is linked the PREPARED and VERIFIED bits in the returned status bits "
"will be set. If the class is initialized the INITIALIZED bit in the returned "
"status bits will be set. If an error occured during initialization then the "
"ERROR bit in the returned status bits will be set. "
"The returned status bits are undefined for array types and for "
"primitive classes (such as java.lang.Integer.TYPE). "
(Out
(referenceType refType "The reference type ID.")
)
(Reply
(int status "<a href=\"#JDWP_ClassStatus\">Status</a> bits:"
"See <a href=\"#JDWP_ClassStatus\">JDWP.ClassStatus</a>")
)
(ErrorSet
(Error INVALID_CLASS "refType is not the ID of a reference "
"type.")
(Error INVALID_OBJECT "refType is not a known ID.")
(Error VM_DEAD)
)
)
(Command Interfaces=10
"Returns the interfaces declared as implemented by this class. "
"Interfaces indirectly implemented (extended by the implemented "
"interface or implemented by a superclass) are not included."
(Out
(referenceType refType "The reference type ID.")
)
(Reply
(Repeat interfaces "The number of implemented interfaces"
(interfaceType interfaceType "implemented interface.")
)
)
(ErrorSet
(Error INVALID_CLASS "refType is not the ID of a reference "
"type.")
(Error INVALID_OBJECT "refType is not a known ID.")
(Error VM_DEAD)
)
)
(Command ClassObject=11
"Returns the class object corresponding to this type. "
(Out
(referenceType refType "The reference type ID.")
)
(Reply
(classObject classObject "class object.")
)
(ErrorSet
(Error INVALID_CLASS "refType is not the ID of a reference "
"type.")
(Error INVALID_OBJECT "refType is not a known ID.")
(Error VM_DEAD)
)
)
(Command SourceDebugExtension=12
"Returns the value of the SourceDebugExtension attribute. "
"Since JDWP version 1.4. Requires canGetSourceDebugExtension capability - see "
"<a href=\"#JDWP_VirtualMachine_CapabilitiesNew\">CapabilitiesNew</a>."
(Out
(referenceType refType "The reference type ID.")
)
(Reply
(string extension "extension attribute")
)
(ErrorSet
(Error INVALID_CLASS "refType is not the ID of a reference "
"type.")
(Error INVALID_OBJECT "refType is not a known ID.")
(Error ABSENT_INFORMATION "If the extension is not specified.")
(Error NOT_IMPLEMENTED)
(Error VM_DEAD)
)
)
(Command SignatureWithGeneric=13
"Returns the JNI signature of a reference type along with the "
"generic signature if there is one. "
"Generic signatures are described in the signature attribute "
"section in "
"<cite>The Java™ Virtual Machine Specification</cite>. "
"Since JDWP version 1.5."
"<p>
(Out
(referenceType refType "The reference type ID.")
)
(Reply
(string signature
"The JNI signature for the reference type.")
(string genericSignature
"The generic signature for the reference type or an empty "
"string if there is none.")
)
(ErrorSet
(Error INVALID_CLASS "refType is not the ID of a reference "
"type.")
(Error INVALID_OBJECT "refType is not a known ID.")
(Error VM_DEAD)
)
)
(Command FieldsWithGeneric=14
"Returns information, including the generic signature if any, "
"for each field in a reference type. "
"Inherited fields are not included. "
"The field list will include any synthetic fields created "
"by the compiler. "
"Fields are returned in the order they occur in the class file. "
"Generic signatures are described in the signature attribute "
"section in "
"<cite>The Java™ Virtual Machine Specification</cite>. "
"Since JDWP version 1.5."
(Out
(referenceType refType "The reference type ID.")
)
(Reply
(Repeat declared "Number of declared fields."
(Group FieldInfo
(field fieldID "Field ID.")
(string name "The name of the field.")
(string signature "The JNI signature of the field.")
(string genericSignature "The generic signature of the "
"field, or an empty string if there is none.")
(int modBits "The modifier bit flags (also known as access flags) "
"which provide additional information on the "
"field declaration. Individual flag values are "
"defined in Chapter 4 of "
"<cite>The Java™ Virtual Machine Specification</cite>. "
"In addition, The <code>0xf0000000</code> bit identifies "
"the field as synthetic, if the synthetic attribute "
"<a href=\"#JDWP_VirtualMachine_Capabilities\">capability</a> is available.")
)
)
)
(ErrorSet
(Error CLASS_NOT_PREPARED)
(Error INVALID_CLASS "refType is not the ID of a reference "
"type.")
(Error INVALID_OBJECT "refType is not a known ID.")
(Error VM_DEAD)
)
)
(Command MethodsWithGeneric=15
"Returns information, including the generic signature if any, "
"for each method in a reference type. "
"Inherited methodss are not included. The list of methods will "
"include constructors (identified with the name \"<init>\"), "
"the initialization method (identified with the name \"<clinit>\") "
"if present, and any synthetic methods created by the compiler. "
"Methods are returned in the order they occur in the class file. "
"Generic signatures are described in the signature attribute "
"section in "
"<cite>The Java™ Virtual Machine Specification</cite>. "
"Since JDWP version 1.5."
(Out
(referenceType refType "The reference type ID.")
)
(Reply
(Repeat declared "Number of declared methods."
(Group MethodInfo
(method methodID "Method ID.")
(string name "The name of the method.")
(string signature "The JNI signature of the method.")
(string genericSignature "The generic signature of the method, or "
"an empty string if there is none.")
(int modBits "The modifier bit flags (also known as access flags) "
"which provide additional information on the "
"method declaration. Individual flag values are "
"defined in Chapter 4 of "
"<cite>The Java™ Virtual Machine Specification</cite>. "
"In addition, The <code>0xf0000000</code> bit identifies "
"the method as synthetic, if the synthetic attribute "
"<a href=\"#JDWP_VirtualMachine_Capabilities\">capability</a> is available.")
)
)
)
(ErrorSet
(Error CLASS_NOT_PREPARED)
(Error INVALID_CLASS "refType is not the ID of a reference "
"type.")
(Error INVALID_OBJECT "refType is not a known ID.")
(Error VM_DEAD)
)
)
(Command Instances=16
"Returns instances of this reference type. "
"Only instances that are reachable for the purposes of "
"garbage collection are returned. "
"<p>Since JDWP version 1.6. Requires canGetInstanceInfo capability - see "
"<a href=\"#JDWP_VirtualMachine_CapabilitiesNew\">CapabilitiesNew</a>."
(Out
(referenceType refType "The reference type ID.")
(int maxInstances "Maximum number of instances to return. Must be non-negative. "
"If zero, all instances are returned.")
)
(Reply
(Repeat instances "The number of instances that follow."
(tagged-object instance "An instance of this reference type.")
)
)
(ErrorSet
(Error INVALID_CLASS "refType is not the ID of a reference "
"type.")
(Error INVALID_OBJECT "refType is not a known ID.")
(Error ILLEGAL_ARGUMENT "maxInstances is less than zero.")
(Error NOT_IMPLEMENTED)
(Error VM_DEAD)
)
)
(Command ClassFileVersion=17
"Returns the class file major and minor version numbers, as defined in the class "
"file format of the Java Virtual Machine specification. "
"<p>Since JDWP version 1.6. "
(Out
(referenceType refType "The class.")
)
(Reply
(int majorVersion "Major version number")
(int minorVersion "Minor version number")
)
(ErrorSet
(Error INVALID_CLASS "refType is not the ID of a reference "
"type.")
(Error INVALID_OBJECT "refType is not a known ID.")
(Error ABSENT_INFORMATION "The class file version information is "
"absent for primitive and array types.")
(Error VM_DEAD)
)
)
(Command ConstantPool=18
"Return the raw bytes of the constant pool in the format of the "
"constant_pool item of the Class File Format in "
"<cite>The Java™ Virtual Machine Specification</cite>. "
"<p>Since JDWP version 1.6. Requires canGetConstantPool capability - see "
"<a href=\"#JDWP_VirtualMachine_CapabilitiesNew\">CapabilitiesNew</a>.""
(Out
(referenceType refType "The class.")
)
(Reply
(int count "Total number of constant pool entries plus one. This "
"corresponds to the constant_pool_count item of the "
"Class File Format in "
"<cite>The Java™ Virtual Machine Specification</cite>. ")
(Repeat bytes
(byte cpbytes "Raw bytes of constant pool")
)
)
(ErrorSet
(Error INVALID_CLASS "refType is not the ID of a reference "
"type.")
(Error INVALID_OBJECT "refType is not a known ID.")
(Error NOT_IMPLEMENTED "If the target virtual machine does not "
"support the retrieval of constant pool information.")
(Error ABSENT_INFORMATION "The Constant Pool information is "
"absent for primitive and array types.")
(Error VM_DEAD)
)
)
)
(CommandSet ClassType=3
(Command Superclass=1
"Returns the immediate superclass of a class."
(Out
(classType clazz "The class type ID.")
)
(Reply
(classType superclass
"The superclass (null if the class ID for java.lang.Object is specified).")
)
(ErrorSet
(Error INVALID_CLASS "clazz is not the ID of a class.")
(Error INVALID_OBJECT "clazz is not a known ID.")
(Error VM_DEAD)
)
)
(Command SetValues=2
"Sets the value of one or more static fields. "
"Each field must be member of the class type "
"or one of its superclasses, superinterfaces, or implemented interfaces. "
"Access control is not enforced; for example, the values of private "
"fields can be set. Final fields cannot be set."
"field's type and the field's type must be loaded. "
(Out
)
)
)
)
"object field is not a known ID.")
)
)
"Invokes a static method. "
"The method must be member of the class type "
"or one of its superclasses, superinterfaces, or implemented interfaces. "
"Access control is not enforced; for example, private "
"methods can be invoked."
"<p>"
"The method invocation will occur in the specified thread. "
"Method invocation can occur only if the specified thread "
"has been suspended by an event. "
"Method invocation is not supported "
"when the target VM has been suspended by the front-end. "
"<p>"
"The specified method is invoked with the arguments in the specified "
"argument list. "
"The method invocation is synchronous; the reply packet is not "
"sent until the invoked method returns in the target VM. "
"The return value (possibly the void value) is "
"included in the reply packet. "
"If the invoked method throws an exception, the "
"exception object ID is set in the reply packet; otherwise, the "
"exception object ID is null. "
"<p>"
"For primitive arguments, the argument value's type must match the "
"argument's type exactly. For object arguments, there must exist a "
"widening reference conversion from the argument value's type to the "
"argument's type and the argument's type must be loaded. "
"<p>"
"By default, all threads in the target VM are resumed while "
"the method is being invoked if they were previously "
"suspended by an event or by command. "
"This is done to prevent the deadlocks "
"that will occur if any of the threads own monitors "
"that will be needed by the invoked method. It is possible that "
"breakpoints or other events might occur during the invocation. "
"Note, however, that this implicit resume acts exactly like "
"the ThreadReference resume command, so if the thread's suspend "
"count is greater than 1, it will remain in a suspended state "
"during the invocation. By default, when the invocation completes, "
"all threads in the target VM are suspended, regardless their state "
"before the invocation. "
"<p>"
"The resumption of other threads during the invoke can be prevented "
"by specifying the INVOKE_SINGLE_THREADED "
"bit flag in the <code>options</code> field; however, "
"there is no protection against or recovery from the deadlocks "
"described above, so this option should be used with great caution. "
"Only the specified thread will be resumed (as described for all "
"threads above). Upon completion of a single threaded invoke, the invoking thread "
"will be suspended once again. Note that any threads started during "
"the single threaded invocation will not be suspended when the "
"invocation completes. "
"<p>"
"If the target VM is disconnected during the invoke (for example, through "
"the VirtualMachine dispose command) the method invocation continues. "
(Out
)
)
)
)
)
"Creates a new object of this type, invoking the specified "
"constructor. The constructor method ID must be a member of "
"the class type."
"<p>"
"Instance creation will occur in the specified thread. "
"Instance creation can occur only if the specified thread "
"has been suspended by an event. "
"Method invocation is not supported "
"when the target VM has been suspended by the front-end. "
"<p>"
"The specified constructor is invoked with the arguments in the specified "
"argument list. "
"The constructor invocation is synchronous; the reply packet is not "
"sent until the invoked method returns in the target VM. "
"The return value (possibly the void value) is "
"included in the reply packet. "
"If the constructor throws an exception, the "
"exception object ID is set in the reply packet; otherwise, the "
"exception object ID is null. "
"<p>"
"For primitive arguments, the argument value's type must match the "
"argument's type exactly. For object arguments, there must exist a "
"widening reference conversion from the argument value's type to the "
"argument's type and the argument's type must be loaded. "
"<p>"
"By default, all threads in the target VM are resumed while "
"the method is being invoked if they were previously "
"suspended by an event or by command. "
"This is done to prevent the deadlocks "
"that will occur if any of the threads own monitors "
"that will be needed by the invoked method. It is possible that "
"breakpoints or other events might occur during the invocation. "
"Note, however, that this implicit resume acts exactly like "
"the ThreadReference resume command, so if the thread's suspend "
"count is greater than 1, it will remain in a suspended state "
"during the invocation. By default, when the invocation completes, "
"all threads in the target VM are suspended, regardless their state "
"before the invocation. "
"<p>"
"The resumption of other threads during the invoke can be prevented "
"by specifying the INVOKE_SINGLE_THREADED "
"bit flag in the <code>options</code> field; however, "
"there is no protection against or recovery from the deadlocks "
"described above, so this option should be used with great caution. "
"Only the specified thread will be resumed (as described for all "
"threads above). Upon completion of a single threaded invoke, the invoking thread "
"will be suspended once again. Note that any threads started during "
"the single threaded invocation will not be suspended when the "
"invocation completes. "
"<p>"
"If the target VM is disconnected during the invoke (for example, through "
"the VirtualMachine dispose command) the method invocation continues. "
(Out
)
)
"if the constructor threw an exception.")
)
"object parameter is not a known ID..")
)
)
)
"Creates a new array object of this type with a given length."
(Out
)
)
)
)
)
)
(CommandSet Method=6
"Returns line number information for the method, if present. "
"The line table maps source line numbers to the initial code index "
"of the line. The line table "
"is ordered by code index (from lowest to highest). The line number "
"information is constant unless a new class definition is installed "
"using <a href=\"#JDWP_VirtualMachine_RedefineClasses\">RedefineClasses</a>."
(Out
)
(long end "Highest valid code index for the method, >=0, or -1 if the method is native")
"start <= lineCodeIndex < end")
)
)
)
"type.")
)
)
"Returns variable information for the method. The variable table "
"includes arguments and locals declared within the method. For "
"instance methods, the \"this\" reference is included in the "
"table. Also, synthetic variables may be present. "
(Out
)
"Eight-byte arguments use two words; all others use one. ")
(long codeIndex
"First code index at which the variable is visible (unsigned). "
"Used in conjunction with <code>length</code>. "
"The variable can be get or set only when the current "
"<code>codeIndex</code> <= current frame code index < <code>codeIndex + length</code> ")
(int length
"Unsigned value used in conjunction with <code>codeIndex</code>. "
"The variable can be get or set only when the current "
"<code>codeIndex</code> <= current frame code index < <code>code index + length</code> ")
)
)
)
"type.")
)
)
"Retrieve the method's bytecodes as defined in "
"<cite>The Java™ Virtual Machine Specification</cite>. "
"Requires canGetBytecodes capability - see "
"<a href=\"#JDWP_VirtualMachine_CapabilitiesNew\">CapabilitiesNew</a>."
(Out
)
)
)
"type.")
"support the retrieval of bytecodes.")
)
)
"Determine if this method is obsolete. A method is obsolete if it has been replaced "
"by a non-equivalent method using the "
"<a href=\"#JDWP_VirtualMachine_RedefineClasses\">RedefineClasses</a> command. "
"The original and redefined methods are considered equivalent if their bytecodes are "
"the same except for indices into the constant pool and the referenced constants are "
"equal."
(Out
)
"by a non-equivalent method using"
"the RedefineClasses command.")
)
"type.")
"not support this query.")
)
)
"Returns variable information for the method, including "
"generic signatures for the variables. The variable table "
"includes arguments and locals declared within the method. For "
"instance methods, the \"this\" reference is included in the "
"table. Also, synthetic variables may be present. "
"Generic signatures are described in the signature attribute "
"section in "
"<cite>The Java™ Virtual Machine Specification</cite>. "
"Since JDWP version 1.5."
(Out
)
"Eight-byte arguments use two words; all others use one. ")
(long codeIndex
"First code index at which the variable is visible (unsigned). "
"Used in conjunction with <code>length</code>. "
"The variable can be get or set only when the current "
"<code>codeIndex</code> <= current frame code index < <code>codeIndex + length</code> ")
"signature or an empty string if there is none.")
(int length
"Unsigned value used in conjunction with <code>codeIndex</code>. "
"The variable can be get or set only when the current "
"<code>codeIndex</code> <= current frame code index < <code>code index + length</code> ")
)
)
)
"type.")
)
)
)
(CommandSet Field=8
)
"Returns the runtime type of the object. "
"The runtime type will be a class or an array. "
(Out
)
"of following reference type. ")
)
)
)
"Returns the value of one or more instance fields. "
"Each field must be member of the object's type "
"or one of its superclasses, superinterfaces, or implemented interfaces. "
"Access control is not enforced; for example, the values of private "
"fields can be obtained."
(Out
)
)
)
"the number of values to get. Field values are ordered "
"in the reply in the same order as corresponding fieldIDs "
"in the command."
)
)
)
)
"Sets the value of one or more instance fields. "
"Each field must be member of the object's type "
"or one of its superclasses, superinterfaces, or implemented interfaces. "
"Access control is not enforced; for example, the values of private "
"fields can be set. "
"For primitive values, the value's type must match the "
"field's type exactly. For object values, there must be a "
"widening reference conversion from the value's type to the
(Out
)
)
)
)
(ErrorSet
(Error INVALID_OBJECT)
(Error INVALID_FIELDID)
(Error VM_DEAD)
)
)
(Command MonitorInfo=5
(Out
)
"0 if there is no current owner"
)
)
)
)
"Invokes a instance method. "
"The method must be member of the object's type "
"or one of its superclasses, superinterfaces, or implemented interfaces. "
"Access control is not enforced; for example, private "
"methods can be invoked."
"<p>"
"The method invocation will occur in the specified thread. "
"Method invocation can occur only if the specified thread "
"has been suspended by an event. "
"Method invocation is not supported "
"when the target VM has been suspended by the front-end. "
"<p>"
"The specified method is invoked with the arguments in the specified "
"argument list. "
"The method invocation is synchronous; the reply packet is not "
"sent until the invoked method returns in the target VM. "
"The return value (possibly the void value) is "
"included in the reply packet. "
"If the invoked method throws an exception, the "
"exception object ID is set in the reply packet; otherwise, the "
"exception object ID is null. "
"<p>"
"For primitive arguments, the argument value's type must match the "
"argument's type exactly. For object arguments, there must be a "
"widening reference conversion from the argument value's type to the "
"argument's type and the argument's type must be loaded. "
"<p>"
"By default, all threads in the target VM are resumed while "
"the method is being invoked if they were previously "
"suspended by an event or by command. "
"This is done to prevent the deadlocks "
"that will occur if any of the threads own monitors "
"that will be needed by the invoked method. It is possible that "
"breakpoints or other events might occur during the invocation. "
"Note, however, that this implicit resume acts exactly like "
"the ThreadReference resume command, so if the thread's suspend "
"count is greater than 1, it will remain in a suspended state "
"during the invocation. By default, when the invocation completes, "
"all threads in the target VM are suspended, regardless their state "
"before the invocation. "
"<p>"
"The resumption of other threads during the invoke can be prevented "
"by specifying the INVOKE_SINGLE_THREADED "
"bit flag in the <code>options</code> field; however, "
"there is no protection against or recovery from the deadlocks "
"described above, so this option should be used with great caution. "
"Only the specified thread will be resumed (as described for all "
"threads above). Upon completion of a single threaded invoke, the invoking thread "
"will be suspended once again. Note that any threads started during "
"the single threaded invocation will not be suspended when the "
"invocation completes. "
"<p>"
"If the target VM is disconnected during the invoke (for example, through "
"the VirtualMachine dispose command) the method invocation continues. "
(Out
)
)
)
"type.")
)
)
"Prevents garbage collection for the given object. By "
"default all objects in back-end replies may be "
"collected at any time the target VM is running. A call to "
"this command guarantees that the object will not be "
"collected. The "
"<a href=\"#JDWP_ObjectReference_EnableCollection\">EnableCollection</a> "
"command can be used to "
"allow collection once again. "
"<p>"
"Note that while the target VM is suspended, no garbage "
"collection will occur because all threads are suspended. "
"The typical examination of variables, fields, and arrays "
"during the suspension is safe without explicitly disabling "
"garbage collection. "
"<p>"
"This method should be used sparingly, as it alters the "
"pattern of garbage collection in the target VM and, "
"consequently, may result in application behavior under the "
"debugger that differs from its non-debugged behavior. "
(Out
)
)
)
)
"Permits garbage collection for this object. By default all "
"objects returned by JDWP may become unreachable in the target VM, "
"and hence may be garbage collected. A call to this command is "
"necessary only if garbage collection was previously disabled with "
"the <a href=\"#JDWP_ObjectReference_DisableCollection\">DisableCollection</a> "
"command."
(Out
)
)
)
)
"Determines whether an object has been garbage collected in the "
"target VM. "
(Out
)
)
)
)
"Returns objects that directly reference this object. "
"Only objects that are reachable for the purposes "
"of garbage collection are returned. "
"Note that an object can also be referenced in other ways, "
"such as from a local variable in a stack frame, or from a JNI global "
"reference. Such non-object referrers are not returned by this command. "
"<p>Since JDWP version 1.6. Requires canGetInstanceInfo capability - see "
"<a href=\"#JDWP_VirtualMachine_CapabilitiesNew\">CapabilitiesNew</a>."
(Out
"Must be non-negative. If zero, all referring "
"objects are returned.")
)
)
)
)
)
)
"Returns the characters contained in the string. "
(Out
)
)
)
)
)
"Returns the thread name. "
(Out
)
)
)
)
"Suspends the thread. "
"<p>"
"Unlike java.lang.Thread.suspend(), suspends of both "
"the virtual machine and individual threads are counted. Before "
"a thread will run again, it must be resumed the same number "
"of times it has been suspended. "
"<p>"
"Suspending single threads with command has the same "
"dangers java.lang.Thread.suspend(). If the suspended "
"thread holds a monitor needed by another running thread, "
"deadlock is possible in the target VM (at least until the "
"suspended thread is resumed again). "
"<p>"
"The suspended thread is guaranteed to remain suspended until "
"resumed through one of the JDI resume methods mentioned above; "
"the application in the target VM cannot resume the suspended thread "
"through {@link java.lang.Thread#resume}. "
"<p>"
"Note that this doesn't change the status of the thread (see the "
"<a href=\"#JDWP_ThreadReference_Status\">ThreadStatus</a> command.) "
"For example, if it was "
"Running, it will still appear running to other threads. "
(Out
)
)
)
)
"Resumes the execution of a given thread. If this thread was "
"not previously suspended by the front-end, "
"calling this command has no effect. "
"Otherwise, the count of pending suspends on this thread is "
"decremented. If it is decremented to 0, the thread will "
"continue to execute. "
(Out
)
)
)
)
"Returns the current status of a thread. The thread status "
"reply indicates the thread status the last time it was running. "
"the suspend status provides information on the thread's "
"suspension, if any."
(Out
)
)
)
)
"Returns the thread group that contains a given thread. "
(Out
)
)
)
)
"Returns the current call stack of a suspended thread. "
"The sequence of frames starts with "
"the currently executing frame, followed by its caller, "
"and so on. The thread must be suspended, and the returned "
"frameID is valid only while the thread is suspended. "
(Out
(int length
"The count of frames to retrieve "
"(-1 means all remaining). ")
)
)
)
)
)
)
"Returns the count of frames on this thread's stack. "
"The thread must be suspended, and the returned "
"count is valid only while the thread is suspended. "
"Returns JDWP.Error.errorThreadNotSuspended if not suspended. "
(Out
)
)
)
)
"Returns the objects whose monitors have been entered by this thread. "
"The thread must be suspended, and the returned information is "
"relevant only while the thread is suspended. "
"Requires canGetOwnedMonitorInfo capability - see "
"<a href=\"#JDWP_VirtualMachine_CapabilitiesNew\">CapabilitiesNew</a>."
(Out
)
)
)
)
)
"Returns the object, if any, for which this thread is waiting. The "
"thread may be waiting to enter a monitor, or it may be waiting, via "
"the java.lang.Object.wait method, for another thread to invoke the "
"notify method. "
"The thread must be suspended, and the returned information is "
"relevant only while the thread is suspended. "
"Requires canGetCurrentContendedMonitor capability - see "
"<a href=\"#JDWP_VirtualMachine_CapabilitiesNew\">CapabilitiesNew</a>."
(Out
)
"there is no current contended monitor. ")
)
)
)
"Stops the thread with an asynchronous exception, as if done by "
(Out
)
)
"exception has been garbage collected.")
)
)
"Interrupt the thread, as if done by java.lang.Thread.interrupt "
(Out
)
)
)
)
(Command SuspendCount=12
"Get the suspend count for this thread. The suspend count is the "
"number of times the thread has been suspended through the "
"thread-level or VM-level suspend commands without a corresponding resume "
(Out
)
)
)
)
"Returns monitor objects owned by the thread, along with stack depth at which "
"the monitor was acquired. Returns stack depth of -1 if "
"the implementation cannot determine the stack depth "
"(e.g., for monitors acquired by JNI MonitorEnter)."
"The thread must be suspended, and the returned information is "
"relevant only while the thread is suspended. "
"Requires canGetMonitorFrameInfo capability - see "
"<a href=\"#JDWP_VirtualMachine_CapabilitiesNew\">CapabilitiesNew</a>. "
"<p>Since JDWP version 1.6. "
(Out
)
)
)
)
)
)
"Force a method to return before it reaches a return "
"statement. "
"<p>"
"The method which will return early is referred to as the "
"called method. The called method is the current method (as "
"defined by the Frames section in "
"<cite>The Java™ Virtual Machine Specification</cite>) "
"for the specified thread at the time this command "
"is received. "
"<p>"
"The specified thread must be suspended. "
"The return occurs when execution of Java programming "
"language code is resumed on this thread. Between sending this "
"command and resumption of thread execution, the "
"state of the stack is undefined. "
"<p>"
"No further instructions are executed in the called "
"method. Specifically, finally blocks are not executed. Note: "
"this can cause inconsistent states in the application. "
"<p>"
"A lock acquired by calling the called method (if it is a "
"synchronized method) and locks acquired by entering "
"synchronized blocks within the called method are "
"released. Note: this does not apply to JNI locks or "
"java.util.concurrent.locks locks. "
"<p>"
"Events, such as MethodExit, are generated as they would be in "
"a normal return. "
"<p>"
"The called method must be a non-native Java programming "
"language method. Forcing return on a thread with only one "
"frame on the stack causes the thread to exit when resumed. "
"<p>"
"For void methods, the value must be a void value. "
"For methods that return primitive values, the value's type must "
"match the return type exactly. For object values, there must be a "
"widening reference conversion from the value's type to the "
"return type type and the return type must be loaded. "
"<p>"
"Since JDWP version 1.6. Requires canForceEarlyReturn capability - see "
"<a href=\"#JDWP_VirtualMachine_CapabilitiesNew\">CapabilitiesNew</a>."
(Out
)
)
"a frame corresponding to a native "
"method. Or the implementation is "
"unable to provide this functionality "
"on this frame.")
"return value of the method.")
)
)
)
"Returns the thread group name. "
(Out
)
)
)
)
"Returns the thread group, if any, which contains a given thread group. "
(Out
)
"null if the given thread group "
"is a top-level thread group")
)
)
)
"Returns the live threads and active thread groups directly contained "
"in this thread group. Threads and thread groups in child "
"thread groups are not included. "
"A thread is alive if it has been started and has not yet been stopped. "
"See <a href=../../../api/java/lang/ThreadGroup.html>java.lang.ThreadGroup </a>
"for information about active ThreadGroups.
(Out
)
)
)
)
)
)
)
"Returns the number of components in a given array. "
(Out
)
)
)
)
"Returns a range of array components. The specified range must "
"be within the bounds of the array. "
(Out
)
"are objects, they are tagged-values; "
"otherwise, they are untagged-values")
)
)
)
"Sets a range of array components. The specified range must "
"be within the bounds of the array. "
"For primitive values, each value's type must match the "
"array component type exactly. For object values, there must be a "
"widening reference conversion from the value's type to the
(Out
)
)
)
(ErrorSet
(Error INVALID_ARRAY)
(Error VM_DEAD)
)
)
)
(CommandSet ClassLoaderReference=14
(Command VisibleClasses=1
"<p>"
"<p>"
(Out
)
(Reply
(Group ClassInfo
"of following reference type. ")
"A class visible to this class loader.")
)
)
)
)
)
)
"Set an event request. When the event described by this request "
"occurs, an <a href=\"#JDWP_Event\">event</a> is sent from the "
"target VM. If an event occurs that has not been requested then it is not sent "
"from the target VM. The two exceptions to this are the VM Start Event and "
"the VM Death Event which are automatically generated events - see "
"<a href=\"#JDWP_Event_Composite\">Composite Command</a> for further details."
(Out
"See <a href=\"#JDWP_EventKind\">JDWP.EventKind</a> "
"for a complete list of events that can be requested; "
"some events may require a capability in order to be requested. "
)
"What threads are suspended when this event occurs? "
"Note that the order of events and command replies "
"accurately reflects the order in which threads are "
"suspended and resumed. For example, if a "
"<a href=\"#JDWP_VirtualMachine_Resume\">VM-wide resume</a> "
"is processed before an event occurs which suspends the "
"VM, the reply to the resume command will be written to "
"the transport before the suspending event.")
"of generated events."
"Modifiers specify additional tests that "
"an event must satisfy before it is placed "
"in the event queue. Events are filtered by "
"applying each modifier to an event in the "
"order they are specified in this collection "
"Only events that satisfy all modifiers "
"are reported. A value of 0 means there are no "
"modifiers in the request."
"<p>"
"Filtering can improve "
"debugger performance dramatically by
(Select Modifier
(Alt Count=1
"<p>"
)
)
(Alt ThreadOnly=3
)
(Alt ClassOnly=4
)
(Alt ClassMatch=5
"This modifier can be used with any event kind except "
"thread start and thread end. "
(string classPattern "Required class pattern. "
"Matches are limited to exact matches of the "
"given class pattern and matches of patterns that "
"begin or end with '*'; for example, "
"\"*.Foo\" or \"java.*\". "
)
)
(Alt ClassExclude=6
"Restricts reported events to those for classes whose name "
"does not match the given restricted regular expression. "
"For class prepare events, the prepared class name "
"is matched. For class unload events, the "
"unloaded class name is matched. For monitor wait and "
"waited events, the name of the class of the monitor "
"object is matched. For other events, "
)
)
(Alt LocationOnly=7
)
(Alt ExceptionOnly=8
(referenceType exceptionOrNull
)
"for more information. "
)
)
"Restricts reported events to those that occur for "
"a given field. "
"This modifier can be used with "
"field access and field modification event kinds only. "
)
"Restricts reported step events "
"to those which satisfy "
"depth and size constraints. "
"This modifier can be used with "
"step event kinds only. "
)
(Alt InstanceOnly=11
"Restricts reported events to those whose "
"active 'this' object is the given object. "
"Match value is the null object for static methods. "
"This modifier can be used with any event kind "
"except class prepare, class unload, thread start, "
"and thread end. Introduced in JDWP version 1.4."
)
(Alt SourceNameMatch=12
"Restricts reported class prepare events to those "
"for reference types which have a source name "
"which matches the given restricted regular expression. "
"The source names are determined by the reference type's "
"<a href=\"#JDWP_ReferenceType_SourceDebugExtension\"> "
"SourceDebugExtension</a>. "
"This modifier can only be used with class prepare "
"events. "
"Since JDWP version 1.6. Requires the canUseSourceNameFilters "
"capability - see "
"<a href=\"#JDWP_VirtualMachine_CapabilitiesNew\">CapabilitiesNew</a>."
"Matches are limited to exact matches of the "
"given pattern and matches of patterns that "
"begin or end with '*'; for example, "
"\"*.Foo\" or \"java.*\". "
)
)
)
)
)
)
)
)
"Clear an event request. See <a href=\"#JDWP_EventKind\">JDWP.EventKind</a> "
"for a complete list of events that can be cleared. Only the event request matching "
"the specified event kind and requestID is cleared. If there isn't a matching event "
"request the command is a no-op and does not result in an error. Automatically "
"generated events do not have a corresponding event request and may not be cleared "
"using this command."
(Out
)
)
)
)
"Removes all set breakpoints, a no-op if there are no breakpoints set."
)
)
)
)
)
(CommandSet StackFrame=16
"Returns the value of one or more local variables in a "
"given frame. Each variable must be visible at the frame's code index. "
"Even if local variable information is not available, values can "
"be retrieved if the front-end is able to "
"determine the correct local variable index. (Typically, this "
"index can be determined for method arguments from the method "
"signature without access to the local variable table information.) "
(Out
"identifying the type of the variable ")
)
)
)
"the number of values to get."
)
)
)
)
"Sets the value of one or more local variables. "
"Each variable must be visible at the current frame code index. "
"For primitive values, the value's type must match the "
"variable's type exactly. For object values, there must be a "
"widening reference conversion from the value's type to the
"<p>"
"index can be determined for method arguments from the method "
"signature without access to the local variable table information.) "
(Out
)
)
)
)
)
)
"Returns the value of the 'this' reference for this frame. "
"If the frame's method is static or native, the reply "
"will contain the null object reference. "
(Out
)
)
)
)
"Pop the top-most stack frames of the thread stack, up to, and including 'frame'. "
"The thread must be suspended to perform this command. "
"The top-most stack frames are discarded and the stack frame previous to 'frame' "
"becomes the current frame. The operand stack is restored -- the argument values "
"are added back and if the invoke was not <code>invokestatic</code>, "
"<code>objectref</code> is added back as well. The Java virtual machine "
"program counter is restored to the opcode of the invoke instruction."
"<p>"
"Since JDWP version 1.4. Requires canPopFrames capability - see "
"<a href=\"#JDWP_VirtualMachine_CapabilitiesNew\">CapabilitiesNew</a>."
(Out
)
)
)
)
)
(Command ReflectedType = 1
"Returns the reference type reflected by this class object."
(Out
)
"of following reference type. ")
)
)
)
)
(CommandSet Event=64
"Several events may occur at a given time in the target VM. "
"For example, there may be more than one breakpoint request "
"for a given location "
"or you might single step to the same location as a "
"breakpoint request. These events are delivered "
"together as a composite event. For uniformity, a "
"composite event is always used "
"to deliver events, even if there is only one event to report. "
"<P>"
"The events that are grouped in a composite event are restricted in the "
"following ways: "
"<P>"
"<UL>"
"<LI>Only with other thread start events for the same thread:"
" <UL>"
" <LI>Thread Start Event"
" </UL>"
"<LI>Only with other thread death events for the same thread:"
" <UL>"
" <LI>Thread Death Event"
" </UL>"
"<LI>Only with other class prepare events for the same class:"
" <UL>"
" <LI>Class Prepare Event"
" </UL>"
"<LI>Only with other class unload events for the same class:"
" <UL>"
" <LI>Class Unload Event"
" </UL>"
"<LI>Only with other access watchpoint events for the same field access:"
" <UL>"
" <LI>Access Watchpoint Event"
" </UL>"
"<LI>Only with other modification watchpoint events for the same field "
"modification:"
" <UL>"
" <LI>Modification Watchpoint Event"
" </UL>"
"<LI>Only with other Monitor contended enter events for the same monitor object: "
" <UL>"
" <LI>Monitor Contended Enter Event"
" </UL>"
"<LI>Only with other Monitor contended entered events for the same monitor object: "
" <UL>"
" <LI>Monitor Contended Entered Event"
" </UL>"
"<LI>Only with other Monitor wait events for the same monitor object: "
" <UL>"
" <LI>Monitor Wait Event"
" </UL>"
"<LI>Only with other Monitor waited events for the same monitor object: "
" <UL>"
" <LI>Monitor Waited Event"
" </UL>"
"<LI>Only with other ExceptionEvents for the same exception occurrance:"
" <UL>"
" <LI>ExceptionEvent"
" </UL>"
"<LI>Only with other members of this group, at the same location "
"and in the same thread: "
" <UL>"
" <LI>Breakpoint Event"
" <LI>Step Event"
" <LI>Method Entry Event"
" <LI>Method Exit Event"
" </UL>"
"</UL>"
"<P>"
"The VM Start Event and VM Death Event are automatically generated events. "
"This means they do not need to be requested using the "
"<a href=\"#JDWP_EventRequest_Set\">EventRequest.Set</a> command. "
"The VM Start event signals the completion of VM initialization. The VM Death "
"event signals the termination of the VM."
"If there is a debugger connected at the time when an automatically generated "
"event occurs it is sent from the target VM. Automatically generated events may "
"also be requested using the EventRequest.Set command and thus multiple events "
"of the same event kind will be sent from the target VM when an event occurs."
"Automatically generated events are sent with the requestID field "
"in the Event Data set to 0. The value of the suspendPolicy field in the "
"Event Data depends on the event. For the automatically generated VM Start "
"Event the value of suspendPolicy is not defined and is therefore implementation "
"or configuration specific. In the Sun implementation, for example, the "
"suspendPolicy is specified as an option to the JDWP agent at launch-time."
"The automatically generated VM Death Event will have the suspendPolicy set to "
"NONE."
"Which threads where suspended by this composite event?")
"Notification of initialization of a target VM. This event is "
"received before the main thread is started and before any "
"application code has been executed. Before this event occurs "
"a significant amount of system code has executed and a number "
"of system classes have been loaded. "
"This event is always generated by the target VM, even "
"if not explicitly requested."
(int requestID
"Request that generated event (or 0 if this "
"event is automatically generated.")
)
"Notification of step completion in the target VM. The step event "
"is generated before the code at its location is executed. "
)
"Notification of a breakpoint in the target VM. The breakpoint event "
"is generated before the code at its location is executed. "
)
"Notification of a method invocation in the target VM. This event "
"is generated before any code in the invoked method has executed. "
"Method entry events are generated for both native and non-native "
"methods. "
"<P>"
"In some VMs method entry events can occur for a particular thread "
"before its thread start event occurs if methods are called "
"as part of the thread's initialization. "
)
"Notification of a method return in the target VM. This event "
"is generated after all code in the method has executed, but the "
"location of this event is the last executed location in the method. "
"Method exit events are generated for both native and non-native "
"methods. Method exit events are not generated if the method terminates "
"with a thrown exception. "
)
"Notification of a method return in the target VM. This event "
"is generated after all code in the method has executed, but the "
"location of this event is the last executed location in the method. "
"Method exit events are generated for both native and non-native "
"methods. Method exit events are not generated if the method terminates "
"with a thrown exception. <p>Since JDWP version 1.6. "
)
"Notification that a thread in the target VM is attempting "
"to enter a monitor that is already acquired by another thread. "
"Requires canRequestMonitorEvents capability - see "
"<a href=\"#JDWP_VirtualMachine_CapabilitiesNew\">CapabilitiesNew</a>. "
"<p>Since JDWP version 1.6. "
(int requestID
"Request that generated event")
)
"Notification of a thread in the target VM is entering a monitor "
"after waiting for it to be released by another thread. "
"Requires canRequestMonitorEvents capability - see "
"<a href=\"#JDWP_VirtualMachine_CapabilitiesNew\">CapabilitiesNew</a>. "
"<p>Since JDWP version 1.6. "
(int requestID
"Request that generated event")
)
"Notification of a thread about to wait on a monitor object. "
"Requires canRequestMonitorEvents capability - see "
"<a href=\"#JDWP_VirtualMachine_CapabilitiesNew\">CapabilitiesNew</a>. "
"<p>Since JDWP version 1.6. "
(int requestID
"Request that generated event")
)
"Notification that a thread in the target VM has finished waiting on "
"Requires canRequestMonitorEvents capability - see "
"<a href=\"#JDWP_VirtualMachine_CapabilitiesNew\">CapabilitiesNew</a>. "
"a monitor object. "
"<p>Since JDWP version 1.6. "
(int requestID
"Request that generated event")
)
"Notification of an exception in the target VM. "
"If the exception is thrown from a non-native method, "
"the exception event is generated at the location where the "
"exception is thrown. "
"If the exception is thrown from a native method, the exception event "
"is generated at the first non-native location reached after the exception "
"is thrown. "
"(or first non-native location after throw if thrown from a native method)")
"Location of catch, or 0 if not caught. An exception "
"is considered to be caught if, at the point of the throw, the "
"current location is dynamically enclosed in a try statement that "
"handles the exception. (See the JVM specification for details). "
"If there is such a try statement, the catch location is the "
"first location in the appropriate catch clause. "
"<p>"
"If there are native methods in the call stack at the time of the "
"exception, there are important restrictions to note about the "
"returned catch location. In such cases, "
"it is not possible to predict whether an exception will be handled "
"by some native method on the call stack. "
"Thus, it is possible that exceptions considered uncaught "
"here will, in fact, be handled by a native method and not cause "
"termination of the target VM. Furthermore, it cannot be assumed that the "
"catch location returned here will ever be reached by the throwing "
"thread. If there is "
"a native frame between the current location and the catch location, "
"the exception might be handled and cleared in that native method "
"instead. "
"<p>"
"Note that compilers can generate try-catch blocks in some cases "
"where they are not explicit in the source code; for example, "
"the code generated for <code>synchronized</code> and "
"<code>finally</code> blocks can contain implicit try-catch blocks. "
"If such an implicitly generated try-catch is "
"present on the call stack at the time of the throw, the exception "
"will be considered caught even though it appears to be uncaught from "
"examination of the source code. "
)
)
"Notification of a new running thread in the target VM. "
"The new thread can be the result of a call to "
"<code>java.lang.Thread.start</code> or the result of "
"attaching a new thread to the VM though JNI. The "
"notification is generated by the new thread some time before "
"its execution starts. "
"Because of this timing, it is possible to receive other events "
"for the thread before this event is received. (Notably, "
"Method Entry Events and Method Exit Events might occur "
"during thread initialization. "
"It is also possible for the "
"<a href=\"#JDWP_VirtualMachine_AllThreads\">VirtualMachine AllThreads</a> "
"command to return "
"a thread before its thread start event is received. "
"<p>"
"Note that this event gives no information "
"about the creation of the thread object which may have happened "
"much earlier, depending on the VM being debugged. "
)
"Notification of a completed thread in the target VM. The "
"notification is generated by the dying thread before it terminates. "
"Because of this timing, it is possible "
"for {@link VirtualMachine#allThreads} to return this thread "
"after this event is received. "
"<p>"
"Note that this event gives no information "
"about the lifetime of the thread object. It may or may not be collected "
"soon depending on what references exist in the target VM. "
)
"Notification of a class prepare in the target VM. See the JVM "
"specification for a definition of class preparation. Class prepare "
"events are not generated for primtiive classes (for example, "
"In rare cases, this event may occur in a debugger system "
"thread within the target VM. Debugger threads take precautions "
"to prevent these events, but they cannot be avoided under some "
"conditions, especially for some subclasses of "
"java.lang.Error. "
"If the event was generated by a debugger system thread, the "
"value returned by this method is null, and if the requested "
"<a href=\"#JDWP_SuspendPolicy\">suspend policy</a> "
"for the event was EVENT_THREAD "
"all threads will be suspended instead, and the "
"composite event's suspend policy will reflect this change. "
"<p>"
"Note that the discussion above does not apply to system threads "
"created by the target VM during its normal (non-debug) operation. "
)
)
"Notification of a class unload in the target VM. "
"<p>"
"There are severe constraints on the debugger back-end during "
"garbage collection, so unload information is greatly limited. "
)
"Notification of a field access in the target VM. "
"Field modifications "
"are not considered field accesses. "
"Requires canWatchFieldAccess capability - see "
"<a href=\"#JDWP_VirtualMachine_CapabilitiesNew\">CapabilitiesNew</a>."
"Object being accessed (null=0 for statics")
)
"Notification of a field modification in the target VM. "
"Requires canWatchFieldModification capability - see "
"<a href=\"#JDWP_VirtualMachine_CapabilitiesNew\">CapabilitiesNew</a>."
"Object being modified (null=0 for statics")
)
(int requestID
"Request that generated event")
)
)
)
)
)
)
"suspended by an event.")
"and garbage collected.")
"call stack.")
"the function used.")
"file and determined that the file is malformed "
"or otherwise cannot be interpreted as a class file.")
=61 "A circularity has been detected while "
"initializing a class.")
"though well formed, contained some sort of "
"internal inconsistency or security problem.")
=63 "Adding methods has not been implemented.")
=64 "Schema change has not been implemented.")
"and is now inconsistent.")
=66 "A direct superclass is different for the new class "
"version, or the set of directly implemented "
"interfaces is different "
"and canUnrestrictedlyRedefineClasses is false.")
=67 "The new class version does not declare a method "
"declared in the old class version "
"and canUnrestrictedlyRedefineClasses is false.")
"by this VM.")
"different from the name in the old class object.")
=70 "The new class version has different modifiers and "
"and canUnrestrictedlyRedefineClasses is false.")
=71 "A method in the new class version has "
"different modifiers "
"than its counterpart in the old class version and "
"and canUnrestrictedlyRedefineClasses is false.")
"this virtual machine.")
"no more memory was available for allocation.")
"virtual machine. JVMTI cannot be used.")
"is not attached to the virtual machine. "
"Calls must be made from attached threads.")
(Constant NATIVE_METHOD =511 )
)
(Constant SINGLE_STEP =1 )
(Constant BREAKPOINT =2 )
(Constant USER_DEFINED =5 )
(Constant THREAD_START =6 )
(Constant THREAD_DEATH =7 )
(Constant CLASS_PREPARE =8 )
(Constant CLASS_UNLOAD =9 )
(Constant CLASS_LOAD =10 )
(Constant FIELD_ACCESS =20 )
(Constant FIELD_MODIFICATION =21 )
(Constant EXCEPTION_CATCH =30 )
(Constant METHOD_ENTRY =40 )
(Constant METHOD_EXIT =41 )
(Constant MONITOR_CONTENDED_ENTER =43 )
(Constant MONITOR_WAIT =45 )
(Constant MONITOR_WAITED =46 )
)
)
)
(Constant INITIALIZED =4 )
)
)
"'g' - a ThreadGroup object (objectID size). ")
"'l' - a ClassLoader object (objectID size). ")
"'c' - a class object object (objectID size). ")
)
"Step into any method calls that occur before the end of the step. ")
"Step over any method calls that occur before the end of the step. ")
"Step out of the current method. ")
)
"Step by the minimum possible amount (often a bytecode instruction). ")
"Step to the next source line unless there is no line number information in which case a MIN step is done instead.")
)
"Suspend no threads when this event is encountered. ")
(Constant EVENT_THREAD = 1
"Suspend the event thread when this event is encountered. ")
"Suspend all threads when this event is encountered. ")
)
"The invoke options are a combination of zero or more of the following bit flags:"
(Constant INVOKE_SINGLE_THREADED = 0x01
"otherwise, all threads started. ")
(Constant INVOKE_NONVIRTUAL = 0x02
"otherwise, normal virtual invoke (instance methods only)")
)