Java(tm) Debug Wire Protocol


string	description	Text information on the VM version
int	jdwpMajor	Major JDWP Version number
int	jdwpMinor	Minor JDWP Version number
string	vmVersion	Target VM JRE version, as in the java.version property
string	vmName	Target VM name, as in the java.vm.name property

Error Data

VM_DEAD

The virtual machine is not running.

ClassesBySignature Command (2)

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 Data


string					signature	JNI signature of the class to find (for example, "Ljava/lang/String;").

Reply Data


int		classes	Number of reference types that follow.
Repeated classes times:
	byte	refTypeTag	Kind of following reference type.
	referenceTypeID	typeID	Matching loaded reference type
	int	status	The current class status.

Error Data

VM_DEAD

The virtual machine is not running.

AllClasses Command (3)

Returns reference types for all classes currently loaded by the target VM.

Out Data

(None)

Reply Data


int		classes	Number of reference types that follow.
Repeated classes times:
	byte	refTypeTag	Kind of following reference type.
	referenceTypeID	typeID	Loaded reference type
	string	signature	The JNI signature of the loaded reference type
	int	status	The current class status.

Error Data

VM_DEAD

The virtual machine is not running.

AllThreads Command (4)

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 Data

(None)

Reply Data


int		threads	Number of threads that follow.
Repeated threads times:
	threadID	thread	A running thread

Error Data

VM_DEAD

The virtual machine is not running.

TopLevelThreadGroups Command (5)

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 Data

(None)

Reply Data


int		groups	Number of thread groups that follow.
Repeated groups times:
	threadGroupID	group	A top level thread group

Error Data

VM_DEAD

The virtual machine is not running.

Dispose Command (6)

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 the thread-level resume command or the VM-level resume command are resumed as many times as necessary for them to run.
Garbage collection is re-enabled in all cases where it was disabled

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.

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

Out Data: (None)
Reply Data: (None)
Error Data: (None)

IDSizes Command (7)

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 Data

(None)

Reply Data


int	fieldIDSize	fieldID size in bytes
int	methodIDSize	methodID size in bytes
int	objectIDSize	objectID size in bytes
int	referenceTypeIDSize	referenceTypeID size in bytes
int	frameIDSize	frameID size in bytes

Error Data

VM_DEAD

The virtual machine is not running.

Suspend Command (8)

Suspends the execution of the application running in the target VM. All Java threads currently running will be suspended.

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 VM-level resume command or the thread-level resume command the same number of times it has been suspended.

Out Data

(None)

Reply Data

(None)

Error Data

VM_DEAD

The virtual machine is not running.

Resume Command (9)

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 Data: (None)
Reply Data: (None)
Error Data: (None)

Exit Command (10)

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 Data


int					exitCode	the exit code

Reply Data

(None)

Error Data

(None)

CreateString Command (11)

Creates a new string object in the target VM and returns its id.

Out Data


string					utf	UTF-8 characters to use in the created string.

Reply Data


stringID					stringObject	Created string (instance of java.lang.String)

Error Data

VM_DEAD

The virtual machine is not running.

Capabilities Command (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 Data

(None)

Reply Data


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?

Error Data

VM_DEAD

The virtual machine is not running.

ClassPaths Command (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 Data

(None)

Reply Data


string		baseDir	Base directory used to resolve relative paths in either of the following lists.
int		classpaths	Number of paths in classpath.
Repeated classpaths times:
	string	path	One component of classpath
int		bootclasspaths	Number of paths in bootclasspath.
Repeated bootclasspaths times:
	string	path	One component of bootclasspath

Error Data

VM_DEAD

The virtual machine is not running.

DisposeObjects Command (14)

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.

Use of this command is not required. If it is not sent, resources associated with each ID will be freed by the back-end at some time after the corresponding object is garbage collected. It is most useful to use this command to reduce the load on the back-end if a very large number of objects has been retrieved from the back-end (a large array, for example) but may not be garbage collected any time soon.

IDs may be re-used by the back-end after they have been freed with this command.This description assumes reference counting, a back-end may use any implementation which operates equivalently.

Out Data


int		requests	Number of object dispose requests that follow
Repeated requests times:
	objectID	object	The object ID
	int	refCnt	The number of times this object ID has been part of a packet received from the back-end. An accurate count prevents the object ID from being freed on the back-end if it is part of an incoming packet, not yet handled by the front-end.

Reply Data

(None)

Error Data

(None)

HoldEvents Command (15)

Tells the target VM to stop sending events. Events are not discarded; they are held until a subsequent ReleaseEvents command is sent. This command is useful to control the number of events sent to the debugger VM in situations where very large numbers of events are generated. While events are held by the debugger back-end, application execution may be frozen by the debugger back-end to prevent buffer overflows on the back end. Responses to commands are never held and are not affected by this command. If events are already being held, this command is ignored.

Out Data: (None)
Reply Data: (None)
Error Data: (None)

ReleaseEvents Command (16)

Tells the target VM to continue sending events. This command is used to restore normal activity after a HoldEvents command. If there is no current HoldEvents command in effect, this command is ignored.

Out Data: (None)
Reply Data: (None)
Error Data: (None)

CapabilitiesNew Command (17)

Retrieve all of 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.Since JDWP version 1.4.

Out Data

(None)

Reply Data


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 classesin 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	reserved16	Reserved for future capability
boolean	reserved17	Reserved for future capability
boolean	reserved18	Reserved for future capability
boolean	reserved19	Reserved for future capability
boolean	reserved20	Reserved for future capability
boolean	reserved21	Reserved for future capability
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

Error Data

VM_DEAD

The virtual machine is not running.

RedefineClasses Command (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 IsObsolete. 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 PopFrames command can be used to pop frames with obsolete methods.

Requires canRedefineClasses capability - see CapabilitiesNew. 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 Data


int			classes	Number of reference types that follow.
Repeated classes times:
	referenceTypeID		refType	The reference type.
	int		classfile	Number of bytes defining class (below)
	Repeated classfile times:
		byte	classbyte	byte in JVM class file format.

Reply Data

(None)

Error Data

INVALID_CLASS	One of the refType is not the ID of a reference type.
INVALID_OBJECT	One of the refType is not a known ID.
UNSUPPORTED_VERSION	A class file has a version number not supported by this VM.
INVALID_CLASS_FORMAT	The virtual machine attempted to read a class file and determined that the file is malformed or otherwise cannot be interpreted as a class file.
CIRCULAR_CLASS_DEFINITION	A circularity has been detected while initializing a class.
FAILS_VERIFICATION	The verifier detected that a class file, though well formed, contained some sort of internal inconsistency or security problem.
NAMES_DONT_MATCH	The class name defined in the new class file is different from the name in the old class object.
NOT_IMPLEMENTED	No aspect of this functionality is implemented (CapabilitiesNew.canRedefineClasses is false)
ADD_METHOD_NOT_IMPLEMENTED	Adding methods has not been implemented.
SCHEMA_CHANGE_NOT_IMPLEMENTED	Schema change has not been implemented.
HIERARCHY_CHANGE_NOT_IMPLEMENTED	A direct superclass is different for the new class version, or the set of directly implemented interfaces is different and canUnrestrictedlyRedefineClasses is false.
DELETE_METHOD_NOT_IMPLEMENTED	The new class version does not declare a method declared in the old class version and canUnrestrictedlyRedefineClasses is false.
CLASS_MODIFIERS_CHANGE_NOT_IMPLEMENTED	The new class version has different modifiers and and canUnrestrictedlyRedefineClasses is false.
METHOD_MODIFIERS_CHANGE_NOT_IMPLEMENTED	A method in the new class version has different modifiers than its counterpart in the old class version and and canUnrestrictedlyRedefineClasses is false.
VM_DEAD	The virtual machine is not running.

SetDefaultStratum Command (19)

Set the default stratum. Requires canSetDefaultStratum capability - see CapabilitiesNew.

Out Data


string					stratumID	default stratum, or empty string to use reference type default.

Reply Data

(None)

Error Data

NOT_IMPLEMENTED	The functionality is not implemented in this virtual machine.
VM_DEAD	The virtual machine is not running.

AllClassesWithGeneric Command (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 the Java Virtual Machine Specification, 3rd Edition. Since JDWP version 1.5.

Out Data

(None)

Reply Data


int		classes	Number of reference types that follow.
Repeated classes times:
	byte	refTypeTag	Kind 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 status.

Error Data

VM_DEAD

The virtual machine is not running.

ReferenceType Command Set (2)

Signature Command (1)

Returns the JNI signature of a reference type. JNI signature formats are described in the Java Native Inteface Specification

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 Data


referenceTypeID					refType	The reference type ID.

Reply Data


string					signature	The JNI signature for the reference type.

Error Data

INVALID_CLASS	refType is not the ID of a reference type.
INVALID_OBJECT	refType is not a known ID.
VM_DEAD	The virtual machine is not running.

ClassLoader Command (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 Data


referenceTypeID					refType	The reference type ID.

Reply Data


classLoaderID					classLoader	The class loader for the reference type.

Error Data

INVALID_CLASS	refType is not the ID of a reference type.
INVALID_OBJECT	refType is not a known ID.
VM_DEAD	The virtual machine is not running.

Modifiers Command (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 Data


referenceTypeID					refType	The reference type ID.

Reply Data


int					modBits	Modifier bits as defined in the VM Specification

Error Data

INVALID_CLASS	refType is not the ID of a reference type.
INVALID_OBJECT	refType is not a known ID.
VM_DEAD	The virtual machine is not running.

Fields Command (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 Data


referenceTypeID					refType	The reference type ID.

Reply Data


int		declared	Number of declared fields.
Repeated declared times:
	fieldID	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 the VM Specification.In addition, The `0xf0000000` bit identifies the field as synthetic, if the synthetic attribute capability is available.

Error Data

CLASS_NOT_PREPARED	Class has been loaded but not yet prepared.
INVALID_CLASS	refType is not the ID of a reference type.
INVALID_OBJECT	refType is not a known ID.
VM_DEAD	The virtual machine is not running.

Methods Command (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 Data


referenceTypeID					refType	The reference type ID.

Reply Data


int		declared	Number of declared methods.
Repeated declared times:
	methodID	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 the VM Specification.In addition, The `0xf0000000` bit identifies the method as synthetic, if the synthetic attribute capability is available.

Error Data

CLASS_NOT_PREPARED	Class has been loaded but not yet prepared.
INVALID_CLASS	refType is not the ID of a reference type.
INVALID_OBJECT	refType is not a known ID.
VM_DEAD	The virtual machine is not running.

GetValues Command (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 Data


referenceTypeID		refType	The reference type ID.
int		fields	The number of values to get
Repeated fields times:
	fieldID	fieldID	A field to get

Reply Data


int		values	The number of values returned, always equal to fields, the number of values to get.
Repeated values times:
	value	value	The field value

Error Data

INVALID_CLASS	refType is not the ID of a reference type.
INVALID_OBJECT	refType is not a known ID.
INVALID_FIELDID	Invalid field.
VM_DEAD	The virtual machine is not running.

SourceFile Command (7)

Returns the name of source file in which a reference type was declared.

Out Data


referenceTypeID					refType	The reference type ID.

Reply Data


string					sourceFile	The source file name. No path information for the file is included

Error Data

INVALID_CLASS	refType is not the ID of a reference type.
INVALID_OBJECT	refType is not a known ID.
ABSENT_INFORMATION	The source file attribute is absent.
VM_DEAD	The virtual machine is not running.

NestedTypes Command (8)

Returns the classes and interfaces directly nested within this type.Types further nested within those types are not included.

Out Data


referenceTypeID					refType	The reference type ID.

Reply Data


int		classes	The number of nested classes and interfaces
Repeated classes times:
	byte	refTypeTag	Kind of following reference type.
	referenceTypeID	typeID	The nested class or interface ID.

Error Data

INVALID_CLASS	refType is not the ID of a reference type.
INVALID_OBJECT	refType is not a known ID.
VM_DEAD	The virtual machine is not running.

Status Command (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 the VM specification. 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 Data


referenceTypeID					refType	The reference type ID.

Reply Data


int					status	Status bits:See JDWP.ClassStatus

Error Data

INVALID_CLASS	refType is not the ID of a reference type.
INVALID_OBJECT	refType is not a known ID.
VM_DEAD	The virtual machine is not running.

Interfaces Command (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 Data


referenceTypeID					refType	The reference type ID.

Reply Data


int		interfaces	The number of implemented interfaces
Repeated interfaces times:
	interfaceID	interfaceType	implemented interface.

Error Data

INVALID_CLASS	refType is not the ID of a reference type.
INVALID_OBJECT	refType is not a known ID.
VM_DEAD	The virtual machine is not running.

ClassObject Command (11)

Returns the class object corresponding to this type.

Out Data


referenceTypeID					refType	The reference type ID.

Reply Data


classObjectID					classObject	class object.

Error Data

INVALID_CLASS	refType is not the ID of a reference type.
INVALID_OBJECT	refType is not a known ID.
VM_DEAD	The virtual machine is not running.

SourceDebugExtension Command (12)

Returns the value of the SourceDebugExtension attribute. Since JDWP version 1.4. Requires canGetSourceDebugExtension capability - see CapabilitiesNew.

Out Data


referenceTypeID					refType	The reference type ID.

Reply Data


string					extension	extension attribute

Error Data

INVALID_CLASS	refType is not the ID of a reference type.
INVALID_OBJECT	refType is not a known ID.
ABSENT_INFORMATION	If the extension is not specified.
NOT_IMPLEMENTED	The functionality is not implemented in this virtual machine.
VM_DEAD	The virtual machine is not running.

SignatureWithGeneric Command (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 the Java Virtual Machine Specification, 3rd Edition. Since JDWP version 1.5.

Out Data


referenceTypeID					refType	The reference type ID.

Reply Data


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.

Error Data

INVALID_CLASS	refType is not the ID of a reference type.
INVALID_OBJECT	refType is not a known ID.
VM_DEAD	The virtual machine is not running.

FieldsWithGeneric Command (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 the Java Virtual Machine Specification, 3rd Edition. Since JDWP version 1.5.

Out Data


referenceTypeID					refType	The reference type ID.

Reply Data


int		declared	Number of declared fields.
Repeated declared times:
	fieldID	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 the VM Specification.In addition, The `0xf0000000` bit identifies the field as synthetic, if the synthetic attribute capability is available.

Error Data

CLASS_NOT_PREPARED	Class has been loaded but not yet prepared.
INVALID_CLASS	refType is not the ID of a reference type.
INVALID_OBJECT	refType is not a known ID.
VM_DEAD	The virtual machine is not running.

MethodsWithGeneric Command (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 the Java Virtual Machine Specification, 3rd Edition. Since JDWP version 1.5.

Out Data


referenceTypeID					refType	The reference type ID.

Reply Data


int		declared	Number of declared methods.
Repeated declared times:
	methodID	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 the VM Specification.In addition, The `0xf0000000` bit identifies the method as synthetic, if the synthetic attribute capability is available.

Error Data

CLASS_NOT_PREPARED	Class has been loaded but not yet prepared.
INVALID_CLASS	refType is not the ID of a reference type.
INVALID_OBJECT	refType is not a known ID.
VM_DEAD	The virtual machine is not running.

ClassType Command Set (3)

Superclass Command (1)

Returns the immediate superclass of a class.

Out Data


classID					clazz	The class type ID.

Reply Data


classID					superclass	The superclass (null if the class ID for java.lang.Object is specified).

Error Data

INVALID_CLASS	clazz is not the ID of a class.
INVALID_OBJECT	clazz is not a known ID.
VM_DEAD	The virtual machine is not running.

SetValues Command (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.For primitive values, the value's type must match the field's type exactly. For object values, there must exist a widening reference conversion from the value's type to the field's type and the field's type must be loaded.

Out Data


classID		clazz	The class type ID.
int		values	The number of fields to set.
Repeated values times:
	fieldID	fieldID	Field to set.
	untagged-value	value	Value to put in the field.

Reply Data

(None)

Error Data

INVALID_CLASS	clazz is not the ID of a class.
CLASS_NOT_PREPARED	Class has been loaded but not yet prepared.
INVALID_OBJECT	clazz is not a known ID or a value of an object field is not a known ID.
INVALID_FIELDID	Invalid field.
VM_DEAD	The virtual machine is not running.

InvokeMethod Command (3)

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.

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.

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.

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.

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.

The resumption of other threads during the invoke can be prevented by specifying the INVOKE_SINGLE_THREADED bit flag in the options 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.

If the target VM is disconnected during the invoke (for example, through the VirtualMachine dispose command) the method invocation continues.

Out Data


classID		clazz	The class type ID.
threadID		thread	The thread in which to invoke.
methodID		methodID	The method to invoke.
int		arguments
Repeated arguments times:
	value	arg	The argument value.
int		options	Invocation options

Reply Data


value					returnValue	The returned value.
tagged-objectID					exception	The thrown exception.

Error Data

INVALID_CLASS	clazz is not the ID of a class.
INVALID_OBJECT	clazz is not a known ID.
INVALID_METHODID	methodID is not the ID of a method.
INVALID_THREAD	Passed thread is null, is not a valid thread or has exited.
THREAD_NOT_SUSPENDED	If the specified thread has not been suspended by an event.
VM_DEAD	The virtual machine is not running.

NewInstance Command (4)

Creates a new object of this type, invoking the specified constructor. The constructor method ID must be a member of the class type.

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.

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.

If the target VM is disconnected during the invoke (for example, through the VirtualMachine dispose command) the method invocation continues.

Out Data


classID		clazz	The class type ID.
threadID		thread	The thread in which to invoke the constructor.
methodID		methodID	The constructor to invoke.
int		arguments
Repeated arguments times:
	value	arg	The argument value.
int		options	Constructor invocation options

Reply Data


tagged-objectID					newObject	The newly created object, or null if the constructor threw an exception.
tagged-objectID					exception	The thrown exception, if any; otherwise, null.

Error Data

INVALID_CLASS	clazz is not the ID of a class.
INVALID_OBJECT	clazz is not a known ID or a value of an object parameter is not a known ID..
INVALID_METHODID	methodID is not the ID of a method.
INVALID_OBJECT	If this reference type has been unloaded and garbage collected.
INVALID_THREAD	Passed thread is null, is not a valid thread or has exited.
THREAD_NOT_SUSPENDED	If the specified thread has not been suspended by an event.
VM_DEAD	The virtual machine is not running.

ArrayType Command Set (4)

NewInstance Command (1)

Creates a new array object of this type with a given length.

Out Data


arrayTypeID					arrType	The array type of the new instance.
int					length	The length of the array.

Reply Data


tagged-objectID					newArray	The newly created array object.

Error Data

INVALID_ARRAY	The array is invalid.
INVALID_OBJECT	If this reference type has been unloaded and garbage collected.
VM_DEAD	The virtual machine is not running.

InterfaceType Command Set (5)

Method Command Set (6)

LineTable Command (1)

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 RedefineClasses.

Out Data


referenceTypeID					refType	The class.
methodID					methodID	The method.

Reply Data


long		start	Lowest valid code index for the method, >=0, or -1 if the method is native
long		end	Highest valid code index for the method, >=0, or -1 if the method is native
int		lines	The number of entries in the line table for this method.
Repeated lines times:
	long	lineCodeIndex	Initial code index of the line, start <= lineCodeIndex < end
	int	lineNumber	Line number.

Error Data

INVALID_CLASS	refType is not the ID of a reference type.
INVALID_OBJECT	refType is not a known ID.
INVALID_METHODID	methodID is not the ID of a method.
VM_DEAD	The virtual machine is not running.

VariableTable Command (2)

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 Data


referenceTypeID					refType	The class.
methodID					methodID	The method.

Reply Data


int		argCnt	The number of words in the frame used by arguments. Eight-byte arguments use two words; all others use one.
int		slots	The number of variables.
Repeated slots times:
	long	codeIndex	First code index at which the variable is visible (unsigned). Used in conjunction with `length`. The variable can be get or set only when the current `codeIndex` <= current frame code index < `codeIndex + length`
	string	name	The variable's name.
	string	signature	The variable type's JNI signature.
	int	length	Unsigned value used in conjunction with `codeIndex`. The variable can be get or set only when the current `codeIndex` <= current frame code index < `code index + length`
	int	slot	The local variable's index in its frame

Error Data

INVALID_CLASS	refType is not the ID of a reference type.
INVALID_OBJECT	refType is not a known ID.
INVALID_METHODID	methodID is not the ID of a method.
ABSENT_INFORMATION	there is no variable information for the method.
VM_DEAD	The virtual machine is not running.

Bytecodes Command (3)

Retrieve the method's bytecodes as defined in the JVM Specification.Requires canGetBytecodes capability - see CapabilitiesNew.

Out Data


referenceTypeID					refType	The class.
methodID					methodID	The method.

Reply Data


int		bytes
Repeated bytes times:
	byte	bytecode	A Java bytecode.

Error Data

INVALID_CLASS	refType is not the ID of a reference type.
INVALID_OBJECT	refType is not a known ID.
INVALID_METHODID	methodID is not the ID of a method.
NOT_IMPLEMENTED	If the target virtual machine does not support the retrieval of bytecodes.
VM_DEAD	The virtual machine is not running.

IsObsolete Command (4)

Determine if this method is obsolete. A method is obsolete if it has been replaced by a non-equivalent method using the RedefineClasses 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 Data


referenceTypeID					refType	The class.
methodID					methodID	The method.

Reply Data


boolean					isObsolete	true if this method has been replacedby a non-equivalent method usingthe RedefineClasses command.

Error Data

INVALID_CLASS	refType is not the ID of a reference type.
INVALID_OBJECT	refType is not a known ID.
INVALID_METHODID	methodID is not the ID of a method.
NOT_IMPLEMENTED	If the target virtual machine does not support this query.
VM_DEAD	The virtual machine is not running.

VariableTableWithGeneric Command (5)

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 the Java Virtual Machine Specification, 3rd Edition. Since JDWP version 1.5.

Out Data


referenceTypeID					refType	The class.
methodID					methodID	The method.

Reply Data


int		argCnt	The number of words in the frame used by arguments. Eight-byte arguments use two words; all others use one.
int		slots	The number of variables.
Repeated slots times:
	long	codeIndex	First code index at which the variable is visible (unsigned). Used in conjunction with `length`. The variable can be get or set only when the current `codeIndex` <= current frame code index < `codeIndex + length`
	string	name	The variable's name.
	string	signature	The variable type's JNI signature.
	string	genericSignature	The variable type's generic signature or an empty string if there is none.
	int	length	Unsigned value used in conjunction with `codeIndex`. The variable can be get or set only when the current `codeIndex` <= current frame code index < `code index + length`
	int	slot	The local variable's index in its frame

Error Data

INVALID_CLASS	refType is not the ID of a reference type.
INVALID_OBJECT	refType is not a known ID.
INVALID_METHODID	methodID is not the ID of a method.
ABSENT_INFORMATION	there is no variable information for the method.
VM_DEAD	The virtual machine is not running.

Field Command Set (8)

ObjectReference Command Set (9)

ReferenceType Command (1)

Returns the runtime type of the object. The runtime type will be a class or an array.

Out Data


objectID					object	The object ID

Reply Data


byte					refTypeTag	Kind of following reference type.
referenceTypeID					typeID	The runtime reference type.

Error Data

INVALID_OBJECT	If this reference type has been unloaded and garbage collected.
VM_DEAD	The virtual machine is not running.

GetValues Command (2)

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 Data


objectID		object	The object ID
int		fields	The number of values to get
Repeated fields times:
	fieldID	fieldID	Field to get.

Reply Data


int		values	The number of values returned, always equal to 'fields', the number of values to get. Field values are ordered in the reply in the same order as corresponding fieldIDs in the command.
Repeated values times:
	value	value	The field value

Error Data

INVALID_OBJECT	If this reference type has been unloaded and garbage collected.
INVALID_FIELDID	Invalid field.
VM_DEAD	The virtual machine is not running.

SetValues Command (3)

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 field's type and the field's type must be loaded.

Out Data


objectID		object	The object ID
int		values	The number of fields to set.
Repeated values times:
	fieldID	fieldID	Field to set.
	untagged-value	value	Value to put in the field.

Reply Data

(None)

Error Data

INVALID_OBJECT	If this reference type has been unloaded and garbage collected.
INVALID_FIELDID	Invalid field.
VM_DEAD	The virtual machine is not running.

MonitorInfo Command (5)

Returns monitor information for an object. All threads int the VM must be suspended.Requires canGetMonitorInfo capability - see CapabilitiesNew.

Out Data


objectID					object	The object ID

Reply Data


threadID		owner	The monitor owner, or null if it is not currently owned.
int		entryCount	The number of times the monitor has been entered.
int		waiters	The number of threads that are waiting for the monitor 0 if there is no current owner
Repeated waiters times:
	threadID	thread	A thread waiting for this monitor.

Error Data

INVALID_OBJECT	If this reference type has been unloaded and garbage collected.
NOT_IMPLEMENTED	The functionality is not implemented in this virtual machine.
VM_DEAD	The virtual machine is not running.

InvokeMethod Command (6)

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.

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.

If the target VM is disconnected during the invoke (for example, through the VirtualMachine dispose command) the method invocation continues.

Out Data


objectID		object	The object ID
threadID		thread	The thread in which to invoke.
classID		clazz	The class type.
methodID		methodID	The method to invoke.
int		arguments	The number of arguments.
Repeated arguments times:
	value	arg	The argument value.
int		options	Invocation options

Reply Data


value					returnValue	The returned value, or null if an exception is thrown.
tagged-objectID					exception	The thrown exception, if any.

Error Data

INVALID_OBJECT	If this reference type has been unloaded and garbage collected.
INVALID_CLASS	clazz is not the ID of a reference type.
INVALID_METHODID	methodID is not the ID of a method.
INVALID_THREAD	Passed thread is null, is not a valid thread or has exited.
THREAD_NOT_SUSPENDED	If the specified thread has not been suspended by an event.
VM_DEAD	The virtual machine is not running.

DisableCollection Command (7)

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 EnableCollection command can be used to allow collection once again.

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.

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 Data


objectID					object	The object ID

Reply Data

(None)

Error Data

INVALID_OBJECT	If this reference type has been unloaded and garbage collected.
VM_DEAD	The virtual machine is not running.

EnableCollection Command (8)

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 DisableCollection command.

Out Data


objectID					object	The object ID

Reply Data

(None)

Error Data

VM_DEAD

The virtual machine is not running.

IsCollected Command (9)

Determines whether an object has been garbage collected in the target VM.

Out Data


objectID					object	The object ID

Reply Data


boolean					isCollected	true if the object has been collected; false otherwise

Error Data

INVALID_OBJECT	If this reference type has been unloaded and garbage collected.
VM_DEAD	The virtual machine is not running.

StringReference Command Set (10)

Value Command (1)

Returns the characters contained in the string.

Out Data


objectID					stringObject	The String object ID.

Reply Data


string					stringValue	UTF-8 representation of the string value.

Error Data

INVALID_STRING	The string is invalid.
INVALID_OBJECT	If this reference type has been unloaded and garbage collected.
VM_DEAD	The virtual machine is not running.

ThreadReference Command Set (11)

Name Command (1)

Returns the thread name.

Out Data


threadID					thread	The thread object ID.

Reply Data


string					threadName	The thread name.

Error Data

INVALID_THREAD	Passed thread is null, is not a valid thread or has exited.
INVALID_OBJECT	thread is not a known ID.
VM_DEAD	The virtual machine is not running.

Suspend Command (2)

Suspends the thread.

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.

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).

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}.

Note that this doesn't change the status of the thread (see the ThreadStatus command.) For example, if it was Running, it will still appear running to other threads.

Out Data


threadID					thread	The thread object ID.

Reply Data

(None)

Error Data

INVALID_THREAD	Passed thread is null, is not a valid thread or has exited.
INVALID_OBJECT	thread is not a known ID.
VM_DEAD	The virtual machine is not running.

Resume Command (3)

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 Data


threadID					thread	The thread object ID.

Reply Data

(None)

Error Data

INVALID_THREAD	Passed thread is null, is not a valid thread or has exited.
INVALID_OBJECT	thread is not a known ID.
VM_DEAD	The virtual machine is not running.

Status Command (4)

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 Data


threadID					thread	The thread object ID.

Reply Data


int					threadStatus	One of the thread status codes See JDWP.ThreadStatus
int					suspendStatus	One of the suspend status codes See JDWP.SuspendStatus

Error Data

INVALID_THREAD	Passed thread is null, is not a valid thread or has exited.
INVALID_OBJECT	thread is not a known ID.
VM_DEAD	The virtual machine is not running.

ThreadGroup Command (5)

Returns the thread group that contains a given thread.

Out Data


threadID					thread	The thread object ID.

Reply Data


threadGroupID					group	The thread group of this thread.

Error Data

INVALID_THREAD	Passed thread is null, is not a valid thread or has exited.
INVALID_OBJECT	thread is not a known ID.
VM_DEAD	The virtual machine is not running.

Frames Command (6)

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 Data


threadID	thread	The thread object ID.
int	startFrame	The index of the first frame to retrieve.
int	length	The count of frames to retrieve (-1 means all remaining).

Reply Data


int		frames	The number of frames retreived
Repeated frames times:
	frameID	frameID	The ID of this frame.
	location	location	The current location of this frame

Error Data

INVALID_THREAD	Passed thread is null, is not a valid thread or has exited.
INVALID_OBJECT	thread is not a known ID.
VM_DEAD	The virtual machine is not running.

FrameCount Command (7)

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 Data


threadID					thread	The thread object ID.

Reply Data


int					frameCount	The count of frames on this thread's stack.

Error Data

INVALID_THREAD	Passed thread is null, is not a valid thread or has exited.
INVALID_OBJECT	thread is not a known ID.
VM_DEAD	The virtual machine is not running.

OwnedMonitors Command (8)

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 CapabilitiesNew.

Out Data


threadID					thread	The thread object ID.

Reply Data


int		owned	The number of owned monitors
Repeated owned times:
	tagged-objectID	monitor	An owned monitor

Error Data

INVALID_THREAD	Passed thread is null, is not a valid thread or has exited.
INVALID_OBJECT	thread is not a known ID.
NOT_IMPLEMENTED	The functionality is not implemented in this virtual machine.
VM_DEAD	The virtual machine is not running.

CurrentContendedMonitor Command (9)

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 CapabilitiesNew.

Out Data


threadID					thread	The thread object ID.

Reply Data


tagged-objectID					monitor	The contended monitor, or null if there is no current contended monitor.

Error Data

INVALID_THREAD	Passed thread is null, is not a valid thread or has exited.
INVALID_OBJECT	thread is not a known ID.
NOT_IMPLEMENTED	The functionality is not implemented in this virtual machine.
VM_DEAD	The virtual machine is not running.

Stop Command (10)

Stops the thread with an asynchronous exception, as if done by java.lang.Thread.stop

Out Data


threadID					thread	The thread object ID.
objectID					throwable	Asynchronous exception. This object must be an instance of java.lang.Throwable or a subclass

Reply Data

(None)

Error Data

INVALID_THREAD	Passed thread is null, is not a valid thread or has exited.
INVALID_OBJECT	If thread is not a known ID or the asynchronous exception has been garbage collected.
VM_DEAD	The virtual machine is not running.

Interrupt Command (11)

Interrupt the thread, as if done by java.lang.Thread.interrupt

Out Data


threadID					thread	The thread object ID.

Reply Data

(None)

Error Data

INVALID_THREAD	Passed thread is null, is not a valid thread or has exited.
INVALID_OBJECT	thread is not a known ID.
VM_DEAD	The virtual machine is not running.

SuspendCount Command (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 Data


threadID					thread	The thread object ID.

Reply Data


int					suspendCount	The number of outstanding suspends of this thread.

Error Data

INVALID_THREAD	Passed thread is null, is not a valid thread or has exited.
INVALID_OBJECT	thread is not a known ID.
VM_DEAD	The virtual machine is not running.

ThreadGroupReference Command Set (12)

Name Command (1)

Returns the thread group name.

Out Data


threadGroupID					group	The thread group object ID.

Reply Data


string					groupName	The thread group's name.

Error Data

INVALID_THREAD_GROUP	Thread group invalid.
INVALID_OBJECT	group is not a known ID.
VM_DEAD	The virtual machine is not running.

Parent Command (2)

Returns the thread group, if any, which contains a given thread group.

Out Data


threadGroupID					group	The thread group object ID.

Reply Data


threadGroupID					parentGroup	The parent thread group object, or null if the given thread group is a top-level thread group

Error Data

INVALID_THREAD_GROUP	Thread group invalid.
INVALID_OBJECT	group is not a known ID.
VM_DEAD	The virtual machine is not running.

Children Command (3)

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 java.lang.ThreadGroup for information about active ThreadGroups.

Out Data


threadGroupID					group	The thread group object ID.

Reply Data


int		childThreads	The number of live child threads.
Repeated childThreads times:
	threadID	childThread	A direct child thread ID.
int		childGroups	The number of active child thread groups.
Repeated childGroups times:
	threadGroupID	childGroup	A direct child thread group ID.

Error Data

INVALID_THREAD_GROUP	Thread group invalid.
INVALID_OBJECT	group is not a known ID.
VM_DEAD	The virtual machine is not running.

ArrayReference Command Set (13)

Length Command (1)

Returns the number of components in a given array.

Out Data


arrayID					arrayObject	The array object ID.

Reply Data


int					arrayLength	The length of the array.

Error Data

INVALID_OBJECT	arrayObject is not a known ID.
INVALID_ARRAY	The array is invalid.
VM_DEAD	The virtual machine is not running.

GetValues Command (2)

Returns a range of array components. The specified range must be within the bounds of the array.

Out Data


arrayID	arrayObject	The array object ID.
int	firstIndex	The first index to retrieve.
int	length	The number of components to retrieve.

Reply Data


arrayregion					values	The retrieved values. If the values are objects, they are tagged-values; otherwise, they are untagged-values

Error Data

INVALID_LENGTH	If index is beyond the end of this array.
INVALID_OBJECT	arrayObject is not a known ID.
INVALID_ARRAY	The array is invalid.
VM_DEAD	The virtual machine is not running.

SetValues Command (3)

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 array component type and the array component type must be loaded.

Out Data