VirtualMachine

All tracing is enabled.

Tracing enabled for internal event handling.

All tracing is disabled.

Tracing enabled for internal management of object references.

Tracing enabled for JDWP packets received from target VM.

Tracing enabled for internal managment of reference types.

Tracing enabled for JDWP packets sent to target VM.

Returns all loaded types. For each loaded type in the target VM a ReferenceType will be placed in the returned list. The list will include ReferenceTypes which mirror classes, interfaces, and array types.

The returned list will include reference types loaded at least to the point of preparation and types (like array) for which preparation is not defined.

Returns a list of the currently running threads. For each running thread in the target VM, a ThreadReference that mirrors it is placed in the list. 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. Thread objects that have not yet been started (see Thread.start()) and thread objects that have completed their execution are not included in the returned list.

Determines if the target VM supports the addition of methods when performing class redefinition.

Determines if the target VM is a read-only VM. If a method which would modify the state of the VM is called on a read-only VM, then VMCannotBeModifiedException is thrown.

Determines if the target VM supports the forcing of a method to return early.

Determines if the target VM supports the retrieval of a method's bytecodes.

Determines if the target VM supports reading class file major and minor versions.

Determines if the target VM supports getting constant pool information of a class.

Determines if the target VM supports the retrieval of the monitor for which a thread is currently waiting.

Determines if the target VM supports the accessing of class instances, instance counts, and referring objects.

Determines if the target VM supports the inclusion of return values in MethodExitEvents.

Determines if the target VM supports getting which frame has acquired a monitor.

Determines if the target VM supports the retrieval of the monitor information for an object.

Determines if the target VM supports the retrieval of the monitors owned by a thread.

Determines if the target VM supports getting the source debug extension.

Determines if the target VM supports the query of the synthetic attribute of a method or field.

Determines if the target VM supports popping frames of a threads stack.

Determines if the target VM supports any level of class redefinition.

Determines if the target VM supports the creation of MonitorContendedEnterRequests. MonitorContendedEnteredRequests. MonitorWaitRequests. MonitorWaitedRequests.

Determines if the target VM supports the creation of VMDeathRequests.

Determines if the target VM supports unrestricted changes when performing class redefinition.

Determines if the target VM supports filtering events by specific instance object. For example, see addInstanceFilter(ObjectReference).

Determines if the target VM supports the filtering of class prepare events by source name. see addSourceNameFilter(String).

Determines if the target VM supports watchpoints for field access.

Determines if the target VM supports watchpoints for field modification.

Returns the loaded reference types that match a given name. The name must be fully qualified (for example, java.lang.String). The returned list will contain a ReferenceType for each class or interface found with the given name. The search is confined to loaded classes only; no attempt is made to load a class of the given name.

The returned list will include reference types loaded at least to the point of preparation and types (like array) for which preparation is not defined.

Returns text information on the target VM and the debugger support that mirrors it. No specific format for this information is guaranteed. Typically, this string contains version information for the target VM and debugger interfaces. More precise information on VM and JDI versions is available through version(), majorInterfaceVersion(), and minorInterfaceVersion()

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:

• All event requests are cancelled.
• All threads suspended by suspend() or by suspend() are resumed as many times as necessary for them to run.
• Garbage collection is re-enabled in all cases where it was disabled through disableCollection().

Resources originating in this VirtualMachine (ObjectReferences, ReferenceTypes, etc.) will become invalid.

Returns the event queue for this virtual machine. A virtual machine has only one EventQueue object, this method will return the same instance each time it is invoked.

Returns the event request manager for this virtual machine. The EventRequestManager controls user settable events such as breakpoints. A virtual machine has only one EventRequestManager object, this method will return the same instance each time it is invoked.

Causes the mirrored VM to terminate with the given error code. All resources associated with this VirtualMachine are freed. If the mirrored VM is remote, the communication channel to it will be closed. Resources originating in this VirtualMachine (ObjectReferences, ReferenceTypes, etc.) will become invalid.

Threads running in the mirrored VM are abruptly terminated. A thread death exception is not thrown and finally blocks are not run.

Return this VM's default stratum.

Returns the number of instances of each ReferenceType in the 'refTypes' list. Only instances that are reachable for the purposes of garbage collection are counted.

Not all target virtual machines support this operation. Use canGetInstanceInfo() to determine if the operation is supported.

Creates a BooleanValue for the given value. This value can be used for setting and comparing against a value retrieved from a variable or field in this virtual machine.

Creates a FloatValue for the given value. This value can be used for setting and comparing against a value retrieved from a variable or field in this virtual machine.

Creates a string in this virtual machine. The created string can be used for setting and comparing against a string value retrieved from a variable or field in this virtual machine.

Creates a ByteValue for the given value. This value can be used for setting and comparing against a value retrieved from a variable or field in this virtual machine.

Creates a CharValue for the given value. This value can be used for setting and comparing against a value retrieved from a variable or field in this virtual machine.

Creates a LongValue for the given value. This value can be used for setting and comparing against a value retrieved from a variable or field in this virtual machine.

Creates a ShortValue for the given value. This value can be used for setting and comparing against a value retrieved from a variable or field in this virtual machine.

Creates an IntegerValue for the given value. This value can be used for setting and comparing against a value retrieved from a variable or field in this virtual machine.

Creates a DoubleValue for the given value. This value can be used for setting and comparing against a value retrieved from a variable or field in this virtual machine.

Creates a VoidValue. This value can be passed to forceEarlyReturn(Value) when a void method is to be exited.

Returns the name of the target VM as reported by the property java.vm.name.

Returns the Process object for this virtual machine if launched by a LaunchingConnector

All classes given are redefined according to the definitions supplied. A method in a redefined class is called 'equivalent' (to the old version of the method) if

• their bytecodes are the same except for indicies into the constant pool, and
• the referenced constants are equal.

This function does not cause any initialization except that which would occur under the customary JVM semantics. In other words, redefining a class does not cause its initializers to be run. The values of preexisting static variables will remain as they were prior to the call. However, completely uninitialized (new) static variables will be assigned their default value.

If a redefined class has instances then all those instances will have the fields defined by the redefined class at the completion of the call. Preexisting fields will retain their previous values. Any new fields will have their default values; no instance initializers or constructors are run.

Threads need not be suspended.

No events are generated by this function.

All breakpoints in the redefined classes are deleted.

Not all target virtual machines support this operation. Use canRedefineClasses() to determine if the operation is supported. Use canAddMethod() to determine if the redefinition can add methods. Use canUnrestrictedlyRedefineClasses() to determine if the redefinition can change the schema, delete methods, change the class hierarchy, etc.

Continues the execution of the application running in this virtual machine. All threads are resumed as documented in resume().

Traces the activities performed by the com.sun.jdi implementation. All trace information is output to System.err. The given trace flags are used to limit the output to only the information desired. The given flags are in effect and the corresponding trace will continue until the next call to this method.

Output is implementation dependent and trace mode may be ignored.

Set this VM's default stratum (see Location for a discussion of strata). Overrides the per-class default set in the class file.

Affects location queries (such as, sourceName()) and the line boundaries used in single stepping.

Suspends the execution of the application running in this virtual machine. All threads currently running will be suspended.

Unlike Thread.suspend(), suspends of both the virtual machine and individual threads are counted. Before a thread will run again, it must be resumed (through resume() or resume()) the same number of times it has been suspended.

Returns each thread group which does not have a parent. For each top level thread group a ThreadGroupReference is placed in the returned list.

This command may be used as the first step in building a tree (or trees) of the existing thread groups.

Returns the version of the Java Runtime Environment in the target VM as reported by the property java.version. For obtaining the JDI interface version, use majorInterfaceVersion() and minorInterfaceVersion()