jdwp.spec

This is a resource based on j2me embedded,if you dont understand,you can connection with me .

	"for example) but may not be garbage collected any time soon. "
	"<p>"
        "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
	    (Repeat requests "Number of object dispose requests that follow"
		(Group Request
	 	    (object 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
        )
        (ErrorSet
        )
    )
    (Command HoldEvents=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
        )
        (Reply
        )
        (ErrorSet
        )
    )
    (Command ReleaseEvents=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
        )
        (Reply
        )
        (ErrorSet
        )
    )
    (Command CapabilitiesNew=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
        )
        (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 the "
	"<a href=\"http://java.sun.com/docs/books/vmspec\">
        "Java Virtual Machine Specification, 3rd Edition.</a>  "
        "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 "
                                  "in 'Out Data'.")
            )
        )
        (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)