< prev index next >

make/data/jdwp/jdwp.spec

Print this page
rev 60127 : 8249205: Remove unnecessary trademark symbols


 513         "Set the default stratum. Requires canSetDefaultStratum capability - see "
 514         "<a href=\"#JDWP_VirtualMachine_CapabilitiesNew\">CapabilitiesNew</a>."
 515         (Out
 516             (string stratumID "default stratum, or empty string to use "
 517                               "reference type default.")
 518         )
 519         (Reply
 520         )
 521         (ErrorSet
 522             (Error NOT_IMPLEMENTED)
 523             (Error VM_DEAD)
 524         )
 525     )
 526     (Command AllClassesWithGeneric=20
 527         "Returns reference types for all classes currently loaded by the "
 528         "target VM.  "
 529         "Both the JNI signature and the generic signature are "
 530         "returned for each class.  "
 531         "Generic signatures are described in the signature attribute "
 532         "section in "
 533         "<cite>The Java&trade; Virtual Machine Specification</cite>. "
 534         "Since JDWP version 1.5."
 535         (Out
 536         )
 537         (Reply
 538             (Repeat classes "Number of reference types that follow."
 539                 (Group ClassInfo
 540                     (byte refTypeTag  "<a href=\"#JDWP_TypeTag\">Kind</a> "
 541                                       "of following reference type. ")
 542                     (referenceTypeID typeID "Loaded reference type")
 543                     (string signature
 544                                 "The JNI signature of the loaded reference type.")
 545                     (string genericSignature
 546                                 "The generic signature of the loaded reference type "
 547                                 "or an empty string if there is none.")
 548                     (int status "The current class "
 549                                 "<a href=\"#JDWP_ClassStatus\">status.</a> ")
 550                 )
 551             )
 552         )
 553         (ErrorSet


 626             (classLoaderObject classLoader "The class loader for the reference type. ")
 627         )
 628         (ErrorSet
 629             (Error INVALID_CLASS     "refType is not the ID of a reference "
 630                                      "type.")
 631             (Error INVALID_OBJECT    "refType is not a known ID.")
 632             (Error VM_DEAD)
 633         )
 634     )
 635     (Command Modifiers=3
 636         "Returns the modifiers (also known as access flags) for a reference type. "
 637         "The returned bit mask contains information on the declaration "
 638         "of the reference type. If the reference type is an array or "
 639         "a primitive class (for example, java.lang.Integer.TYPE), the "
 640         "value of the returned bit mask is undefined."
 641         (Out
 642             (referenceType refType "The reference type ID.")
 643         )
 644         (Reply
 645             (int modBits "Modifier bits as defined in Chapter 4 of "
 646                          "<cite>The Java&trade; Virtual Machine Specification</cite>")
 647         )
 648         (ErrorSet
 649             (Error INVALID_CLASS     "refType is not the ID of a reference "
 650                                      "type.")
 651             (Error INVALID_OBJECT    "refType is not a known ID.")
 652             (Error VM_DEAD)
 653         )
 654     )
 655     (Command Fields=4
 656         "Returns information for each field in a reference type. "
 657         "Inherited fields are not included. "
 658         "The field list will include any synthetic fields created "
 659         "by the compiler. "
 660         "Fields are returned in the order they occur in the class file."
 661         (Out
 662             (referenceType refType "The reference type ID.")
 663         )
 664         (Reply
 665             (Repeat declared "Number of declared fields."
 666                 (Group FieldInfo
 667                     (field fieldID "Field ID.")
 668                     (string name "Name of field.")
 669                     (string signature "JNI Signature of field.")
 670                     (int modBits "The modifier bit flags (also known as access flags) "
 671                                  "which provide additional information on the  "
 672                                  "field declaration. Individual flag values are "
 673                                  "defined in Chapter 4 of "
 674                                  "<cite>The Java&trade; Virtual Machine Specification</cite>. "
 675                                  "In addition, The <code>0xf0000000</code> bit identifies "
 676                                  "the field as synthetic, if the synthetic attribute "
 677                                  "<a href=\"#JDWP_VirtualMachine_Capabilities\">capability</a> is available.")
 678                 )
 679             )
 680         )
 681         (ErrorSet
 682             (Error CLASS_NOT_PREPARED)
 683             (Error INVALID_CLASS     "refType is not the ID of a reference "
 684                                      "type.")
 685             (Error INVALID_OBJECT    "refType is not a known ID.")
 686             (Error VM_DEAD)
 687         )
 688     )
 689     (Command Methods=5
 690         "Returns information for each method in a reference type. "
 691         "Inherited methods are not included. The list of methods will "
 692         "include constructors (identified with the name \"&lt;init&gt;\"), "
 693         "the initialization method (identified with the name \"&lt;clinit&gt;\") "
 694         "if present, and any synthetic methods created by the compiler. "
 695         "Methods are returned in the order they occur in the class file."
 696         (Out
 697             (referenceType refType "The reference type ID.")
 698         )
 699         (Reply
 700             (Repeat declared "Number of declared methods."
 701                 (Group MethodInfo
 702                     (method methodID "Method ID.")
 703                     (string name "Name of method.")
 704                     (string signature "JNI signature of method.")
 705                     (int modBits "The modifier bit flags (also known as access flags) "
 706                                  "which provide additional information on the  "
 707                                  "method declaration. Individual flag values are "
 708                                  "defined in Chapter 4 of "
 709                                  "<cite>The Java&trade; Virtual Machine Specification</cite>. "
 710                                  "In addition, The <code>0xf0000000</code> bit identifies "
 711                                  "the method as synthetic, if the synthetic attribute "
 712                                  "<a href=\"#JDWP_VirtualMachine_Capabilities\">capability</a> is available.")
 713                 )
 714             )
 715         )
 716         (ErrorSet
 717             (Error CLASS_NOT_PREPARED)
 718             (Error INVALID_CLASS     "refType is not the ID of a reference "
 719                                      "type.")
 720             (Error INVALID_OBJECT    "refType is not a known ID.")
 721             (Error VM_DEAD)
 722         )
 723     )
 724     (Command GetValues=6
 725         "Returns the value of one or more static fields of the "
 726         "reference type. Each field must be member of the reference type "
 727         "or one of its superclasses, superinterfaces, or implemented interfaces. "
 728         "Access control is not enforced; for example, the values of private "
 729         "fields can be obtained."


 776         (Reply
 777             (Repeat classes "The number of nested classes and interfaces"
 778                 (Group TypeInfo
 779                     (byte refTypeTag  "<a href=\"#JDWP_TypeTag\">Kind</a> "
 780                                       "of following reference type. ")
 781                     (referenceTypeID typeID "The nested class or interface ID.")
 782                 )
 783             )
 784         )
 785         (ErrorSet
 786             (Error INVALID_CLASS     "refType is not the ID of a reference "
 787                                      "type.")
 788             (Error INVALID_OBJECT    "refType is not a known ID.")
 789             (Error VM_DEAD)
 790         )
 791     )
 792     (Command Status=9
 793         "Returns the current status of the reference type. The status "
 794         "indicates the extent to which the reference type has been "
 795         "initialized, as described in section 2.1.6 of "
 796         "<cite>The Java&trade; Virtual Machine Specification</cite>. "
 797         "If the class is linked the PREPARED and VERIFIED bits in the returned status bits "
 798         "will be set. If the class is initialized the INITIALIZED bit in the returned "
 799         "status bits will be set. If an error occured during initialization then the "
 800         "ERROR bit in the returned status bits will be set. "
 801         "The returned status bits are undefined for array types and for "
 802         "primitive classes (such as java.lang.Integer.TYPE). "
 803         (Out
 804             (referenceType refType "The reference type ID.")
 805         )
 806         (Reply
 807             (int status "<a href=\"#JDWP_ClassStatus\">Status</a> bits:"
 808                         "See <a href=\"#JDWP_ClassStatus\">JDWP.ClassStatus</a>")
 809         )
 810         (ErrorSet
 811             (Error INVALID_CLASS     "refType is not the ID of a reference "
 812                                      "type.")
 813             (Error INVALID_OBJECT    "refType is not a known ID.")
 814             (Error VM_DEAD)
 815         )
 816     )


 855         (Out
 856             (referenceType refType "The reference type ID.")
 857         )
 858         (Reply
 859             (string extension "extension attribute")
 860         )
 861         (ErrorSet
 862             (Error INVALID_CLASS      "refType is not the ID of a reference "
 863                                       "type.")
 864             (Error INVALID_OBJECT     "refType is not a known ID.")
 865             (Error ABSENT_INFORMATION "If the extension is not specified.")
 866             (Error NOT_IMPLEMENTED)
 867             (Error VM_DEAD)
 868         )
 869     )
 870     (Command SignatureWithGeneric=13
 871         "Returns the JNI signature of a reference type along with the "
 872         "generic signature if there is one.  "
 873         "Generic signatures are described in the signature attribute "
 874         "section in "
 875         "<cite>The Java&trade; Virtual Machine Specification</cite>. "
 876         "Since JDWP version 1.5."
 877         (Out
 878             (referenceType refType "The reference type ID.")
 879         )
 880         (Reply
 881             (string signature
 882                 "The JNI signature for the reference type.")
 883             (string genericSignature
 884                 "The generic signature for the reference type or an empty "
 885                 "string if there is none.")
 886         )
 887         (ErrorSet
 888             (Error INVALID_CLASS     "refType is not the ID of a reference "
 889                                      "type.")
 890             (Error INVALID_OBJECT    "refType is not a known ID.")
 891             (Error VM_DEAD)
 892         )
 893     )
 894     (Command FieldsWithGeneric=14
 895         "Returns information, including the generic signature if any, "
 896         "for each field in a reference type. "
 897         "Inherited fields are not included. "
 898         "The field list will include any synthetic fields created "
 899         "by the compiler. "
 900         "Fields are returned in the order they occur in the class file.  "
 901         "Generic signatures are described in the signature attribute "
 902         "section in "
 903         "<cite>The Java&trade; Virtual Machine Specification</cite>. "
 904         "Since JDWP version 1.5."
 905         (Out
 906             (referenceType refType "The reference type ID.")
 907         )
 908         (Reply
 909             (Repeat declared "Number of declared fields."
 910                 (Group FieldInfo
 911                     (field fieldID "Field ID.")
 912                     (string name "The name of the field.")
 913                     (string signature "The JNI signature of the field.")
 914                     (string genericSignature "The generic signature of the "
 915                                              "field, or an empty string if there is none.")
 916                     (int modBits "The modifier bit flags (also known as access flags) "
 917                                  "which provide additional information on the  "
 918                                  "field declaration. Individual flag values are "
 919                                  "defined in Chapter 4 of "
 920                                  "<cite>The Java&trade; Virtual Machine Specification</cite>. "
 921                                  "In addition, The <code>0xf0000000</code> bit identifies "
 922                                  "the field as synthetic, if the synthetic attribute "
 923                                  "<a href=\"#JDWP_VirtualMachine_Capabilities\">capability</a> is available.")
 924                 )
 925             )
 926         )
 927         (ErrorSet
 928             (Error CLASS_NOT_PREPARED)
 929             (Error INVALID_CLASS     "refType is not the ID of a reference "
 930                                      "type.")
 931             (Error INVALID_OBJECT    "refType is not a known ID.")
 932             (Error VM_DEAD)
 933         )
 934     )
 935     (Command MethodsWithGeneric=15
 936         "Returns information, including the generic signature if any, "
 937         "for each method in a reference type. "
 938         "Inherited methodss are not included. The list of methods will "
 939         "include constructors (identified with the name \"&lt;init&gt;\"), "
 940         "the initialization method (identified with the name \"&lt;clinit&gt;\") "
 941         "if present, and any synthetic methods created by the compiler. "
 942         "Methods are returned in the order they occur in the class file.  "
 943         "Generic signatures are described in the signature attribute "
 944         "section in "
 945         "<cite>The Java&trade; Virtual Machine Specification</cite>. "
 946         "Since JDWP version 1.5."
 947         (Out
 948             (referenceType refType "The reference type ID.")
 949         )
 950         (Reply
 951             (Repeat declared "Number of declared methods."
 952                 (Group MethodInfo
 953                     (method methodID "Method ID.")
 954                     (string name "The name of the method.")
 955                     (string signature "The JNI signature of the method.")
 956                     (string genericSignature "The generic signature of the method, or "
 957                                              "an empty string if there is none.")
 958                     (int modBits "The modifier bit flags (also known as access flags) "
 959                                  "which provide additional information on the  "
 960                                  "method declaration. Individual flag values are "
 961                                  "defined in Chapter 4 of "
 962                                  "<cite>The Java&trade; Virtual Machine Specification</cite>. "
 963                                  "In addition, The <code>0xf0000000</code> bit identifies "
 964                                  "the method as synthetic, if the synthetic attribute "
 965                                  "<a href=\"#JDWP_VirtualMachine_Capabilities\">capability</a> is available.")
 966                 )
 967             )
 968         )
 969         (ErrorSet
 970             (Error CLASS_NOT_PREPARED)
 971             (Error INVALID_CLASS     "refType is not the ID of a reference "
 972                                      "type.")
 973             (Error INVALID_OBJECT    "refType is not a known ID.")
 974             (Error VM_DEAD)
 975         )
 976     )
 977     (Command Instances=16
 978         "Returns instances of this reference type. "
 979         "Only instances that are reachable for the purposes of "
 980         "garbage collection are returned. "
 981         "<p>Since JDWP version 1.6. Requires canGetInstanceInfo capability - see "
 982         "<a href=\"#JDWP_VirtualMachine_CapabilitiesNew\">CapabilitiesNew</a>."


1005          "<p>Since JDWP version 1.6. "
1006         (Out
1007             (referenceType refType "The class.")
1008         )
1009         (Reply
1010             (int majorVersion "Major version number")
1011             (int minorVersion "Minor version number")
1012         )
1013         (ErrorSet
1014             (Error INVALID_CLASS     "refType is not the ID of a reference "
1015                                      "type.")
1016             (Error INVALID_OBJECT    "refType is not a known ID.")
1017             (Error ABSENT_INFORMATION "The class file version information is "
1018                                       "absent for primitive and array types.")
1019             (Error VM_DEAD)
1020         )
1021     )
1022     (Command ConstantPool=18
1023         "Return the raw bytes of the constant pool in the format of the "
1024         "constant_pool item of the Class File Format in "
1025         "<cite>The Java&trade; Virtual Machine Specification</cite>. "
1026         "<p>Since JDWP version 1.6. Requires canGetConstantPool capability - see "
1027         "<a href=\"#JDWP_VirtualMachine_CapabilitiesNew\">CapabilitiesNew</a>.""
1028         (Out
1029             (referenceType refType "The class.")
1030         )
1031         (Reply
1032             (int count "Total number of constant pool entries plus one. This "
1033                        "corresponds to the constant_pool_count item of the "
1034                        "Class File Format in "
1035                        "<cite>The Java&trade; Virtual Machine Specification</cite>. ")
1036             (Repeat bytes
1037                 (byte cpbytes "Raw bytes of constant pool")
1038             )
1039         )
1040         (ErrorSet
1041             (Error INVALID_CLASS     "refType is not the ID of a reference "
1042                                      "type.")
1043             (Error INVALID_OBJECT    "refType is not a known ID.")
1044             (Error NOT_IMPLEMENTED   "If the target virtual machine does not "
1045                                      "support the retrieval of constant pool information.")
1046             (Error ABSENT_INFORMATION "The Constant Pool information is "
1047                                       "absent for primitive and array types.")
1048             (Error VM_DEAD)
1049         )
1050     )
1051     (Command Module=19
1052         "Returns the module that this reference type belongs to."
1053         "<p>Since JDWP version 9."
1054         (Out
1055             (referenceType refType "The reference type.")


1418                     (string signature "The variable type's JNI signature.")
1419                     (int length
1420                         "Unsigned value used in conjunction with <code>codeIndex</code>. "
1421                         "The variable can be get or set only when the current "
1422                         "<code>codeIndex</code> &lt;= current frame code index &lt; <code>code index + length</code> ")
1423                     (int slot "The local variable's index in its frame")
1424                 )
1425             )
1426         )
1427         (ErrorSet
1428             (Error INVALID_CLASS     "refType is not the ID of a reference "
1429                                      "type.")
1430             (Error INVALID_OBJECT    "refType is not a known ID.")
1431             (Error INVALID_METHODID  "methodID is not the ID of a method.")
1432             (Error ABSENT_INFORMATION "there is no variable information for the method.")
1433             (Error VM_DEAD)
1434         )
1435     )
1436     (Command Bytecodes=3
1437         "Retrieve the method's bytecodes as defined in "
1438         "<cite>The Java&trade; Virtual Machine Specification</cite>. "
1439         "Requires canGetBytecodes capability - see "
1440         "<a href=\"#JDWP_VirtualMachine_CapabilitiesNew\">CapabilitiesNew</a>."
1441         (Out
1442             (referenceType refType "The class.")
1443             (method methodID "The method.")
1444         )
1445         (Reply
1446             (Repeat bytes
1447                 (byte bytecode "A Java bytecode.")
1448             )
1449         )
1450         (ErrorSet
1451             (Error INVALID_CLASS     "refType is not the ID of a reference "
1452                                      "type.")
1453             (Error INVALID_OBJECT    "refType is not a known ID.")
1454             (Error INVALID_METHODID  "methodID is not the ID of a method.")
1455             (Error NOT_IMPLEMENTED   "If the target virtual machine does not "
1456                                      "support the retrieval of bytecodes.")
1457             (Error VM_DEAD)
1458         )


1474                                    "the RedefineClasses command.")
1475         )
1476         (ErrorSet
1477             (Error INVALID_CLASS     "refType is not the ID of a reference "
1478                                      "type.")
1479             (Error INVALID_OBJECT    "refType is not a known ID.")
1480             (Error INVALID_METHODID  "methodID is not the ID of a method.")
1481             (Error NOT_IMPLEMENTED   "If the target virtual machine does "
1482                                      "not support this query.")
1483             (Error VM_DEAD)
1484         )
1485     )
1486     (Command VariableTableWithGeneric=5
1487         "Returns variable information for the method, including "
1488         "generic signatures for the variables. The variable table "
1489         "includes arguments and locals declared within the method. For "
1490         "instance methods, the \"this\" reference is included in the "
1491         "table. Also, synthetic variables may be present. "
1492         "Generic signatures are described in the signature attribute "
1493         "section in "
1494         "<cite>The Java&trade; Virtual Machine Specification</cite>. "
1495         "Since JDWP version 1.5."
1496         (Out
1497             (referenceType refType "The class.")
1498             (method methodID "The method.")
1499         )
1500         (Reply
1501             (int argCnt "The number of words in the frame used by arguments. "
1502                         "Eight-byte arguments use two words; all others use one. ")
1503             (Repeat slots "The number of variables."
1504                 (Group SlotInfo "Information about the variable."
1505                     (long codeIndex
1506                         "First code index at which the variable is visible (unsigned). "
1507                         "Used in conjunction with <code>length</code>. "
1508                         "The variable can be get or set only when the current "
1509                         "<code>codeIndex</code> &lt;= current frame code index &lt; <code>codeIndex + length</code> ")
1510                     (string name "The variable's name.")
1511                     (string signature "The variable type's JNI signature.")
1512                     (string genericSignature "The variable type's generic "
1513                          "signature or an empty string if there is none.")
1514                     (int length


2065                (Group monitor
2066                   (tagged-object monitor "An owned monitor")
2067                   (int stack_depth "Stack depth location where monitor was acquired")
2068                )
2069             )
2070         )
2071         (ErrorSet
2072             (Error INVALID_THREAD)
2073             (Error INVALID_OBJECT    "thread is not a known ID.")
2074             (Error NOT_IMPLEMENTED)
2075             (Error VM_DEAD)
2076         )
2077     )
2078     (Command ForceEarlyReturn=14
2079         "Force a method to return before it reaches a return "
2080         "statement.  "
2081         "<p>"
2082         "The method which will return early is referred to as the "
2083         "called method. The called method is the current method (as "
2084         "defined by the Frames section in "
2085         "<cite>The Java&trade; Virtual Machine Specification</cite>) "
2086         "for the specified thread at the time this command "
2087         "is received. "
2088         "<p>"
2089         "The specified thread must be suspended. "
2090         "The return occurs when execution of Java programming "
2091         "language code is resumed on this thread. Between sending this "
2092         "command and resumption of thread execution, the "
2093         "state of the stack is undefined. "
2094         "<p>"
2095         "No further instructions are executed in the called "
2096         "method. Specifically, finally blocks are not executed. Note: "
2097         "this can cause inconsistent states in the application. "
2098         "<p>"
2099         "A lock acquired by calling the called method (if it is a "
2100         "synchronized method) and locks acquired by entering "
2101         "synchronized blocks within the called method are "
2102         "released. Note: this does not apply to JNI locks or "
2103         "java.util.concurrent.locks locks. "
2104         "<p>"
2105         "Events, such as MethodExit, are generated as they would be in "




 513         "Set the default stratum. Requires canSetDefaultStratum capability - see "
 514         "<a href=\"#JDWP_VirtualMachine_CapabilitiesNew\">CapabilitiesNew</a>."
 515         (Out
 516             (string stratumID "default stratum, or empty string to use "
 517                               "reference type default.")
 518         )
 519         (Reply
 520         )
 521         (ErrorSet
 522             (Error NOT_IMPLEMENTED)
 523             (Error VM_DEAD)
 524         )
 525     )
 526     (Command AllClassesWithGeneric=20
 527         "Returns reference types for all classes currently loaded by the "
 528         "target VM.  "
 529         "Both the JNI signature and the generic signature are "
 530         "returned for each class.  "
 531         "Generic signatures are described in the signature attribute "
 532         "section in "
 533         "<cite>The Java Virtual Machine Specification</cite>. "
 534         "Since JDWP version 1.5."
 535         (Out
 536         )
 537         (Reply
 538             (Repeat classes "Number of reference types that follow."
 539                 (Group ClassInfo
 540                     (byte refTypeTag  "<a href=\"#JDWP_TypeTag\">Kind</a> "
 541                                       "of following reference type. ")
 542                     (referenceTypeID typeID "Loaded reference type")
 543                     (string signature
 544                                 "The JNI signature of the loaded reference type.")
 545                     (string genericSignature
 546                                 "The generic signature of the loaded reference type "
 547                                 "or an empty string if there is none.")
 548                     (int status "The current class "
 549                                 "<a href=\"#JDWP_ClassStatus\">status.</a> ")
 550                 )
 551             )
 552         )
 553         (ErrorSet


 626             (classLoaderObject classLoader "The class loader for the reference type. ")
 627         )
 628         (ErrorSet
 629             (Error INVALID_CLASS     "refType is not the ID of a reference "
 630                                      "type.")
 631             (Error INVALID_OBJECT    "refType is not a known ID.")
 632             (Error VM_DEAD)
 633         )
 634     )
 635     (Command Modifiers=3
 636         "Returns the modifiers (also known as access flags) for a reference type. "
 637         "The returned bit mask contains information on the declaration "
 638         "of the reference type. If the reference type is an array or "
 639         "a primitive class (for example, java.lang.Integer.TYPE), the "
 640         "value of the returned bit mask is undefined."
 641         (Out
 642             (referenceType refType "The reference type ID.")
 643         )
 644         (Reply
 645             (int modBits "Modifier bits as defined in Chapter 4 of "
 646                          "<cite>The Java Virtual Machine Specification</cite>")
 647         )
 648         (ErrorSet
 649             (Error INVALID_CLASS     "refType is not the ID of a reference "
 650                                      "type.")
 651             (Error INVALID_OBJECT    "refType is not a known ID.")
 652             (Error VM_DEAD)
 653         )
 654     )
 655     (Command Fields=4
 656         "Returns information for each field in a reference type. "
 657         "Inherited fields are not included. "
 658         "The field list will include any synthetic fields created "
 659         "by the compiler. "
 660         "Fields are returned in the order they occur in the class file."
 661         (Out
 662             (referenceType refType "The reference type ID.")
 663         )
 664         (Reply
 665             (Repeat declared "Number of declared fields."
 666                 (Group FieldInfo
 667                     (field fieldID "Field ID.")
 668                     (string name "Name of field.")
 669                     (string signature "JNI Signature of field.")
 670                     (int modBits "The modifier bit flags (also known as access flags) "
 671                                  "which provide additional information on the  "
 672                                  "field declaration. Individual flag values are "
 673                                  "defined in Chapter 4 of "
 674                                  "<cite>The Java Virtual Machine Specification</cite>. "
 675                                  "In addition, The <code>0xf0000000</code> bit identifies "
 676                                  "the field as synthetic, if the synthetic attribute "
 677                                  "<a href=\"#JDWP_VirtualMachine_Capabilities\">capability</a> is available.")
 678                 )
 679             )
 680         )
 681         (ErrorSet
 682             (Error CLASS_NOT_PREPARED)
 683             (Error INVALID_CLASS     "refType is not the ID of a reference "
 684                                      "type.")
 685             (Error INVALID_OBJECT    "refType is not a known ID.")
 686             (Error VM_DEAD)
 687         )
 688     )
 689     (Command Methods=5
 690         "Returns information for each method in a reference type. "
 691         "Inherited methods are not included. The list of methods will "
 692         "include constructors (identified with the name \"&lt;init&gt;\"), "
 693         "the initialization method (identified with the name \"&lt;clinit&gt;\") "
 694         "if present, and any synthetic methods created by the compiler. "
 695         "Methods are returned in the order they occur in the class file."
 696         (Out
 697             (referenceType refType "The reference type ID.")
 698         )
 699         (Reply
 700             (Repeat declared "Number of declared methods."
 701                 (Group MethodInfo
 702                     (method methodID "Method ID.")
 703                     (string name "Name of method.")
 704                     (string signature "JNI signature of method.")
 705                     (int modBits "The modifier bit flags (also known as access flags) "
 706                                  "which provide additional information on the  "
 707                                  "method declaration. Individual flag values are "
 708                                  "defined in Chapter 4 of "
 709                                  "<cite>The Java Virtual Machine Specification</cite>. "
 710                                  "In addition, The <code>0xf0000000</code> bit identifies "
 711                                  "the method as synthetic, if the synthetic attribute "
 712                                  "<a href=\"#JDWP_VirtualMachine_Capabilities\">capability</a> is available.")
 713                 )
 714             )
 715         )
 716         (ErrorSet
 717             (Error CLASS_NOT_PREPARED)
 718             (Error INVALID_CLASS     "refType is not the ID of a reference "
 719                                      "type.")
 720             (Error INVALID_OBJECT    "refType is not a known ID.")
 721             (Error VM_DEAD)
 722         )
 723     )
 724     (Command GetValues=6
 725         "Returns the value of one or more static fields of the "
 726         "reference type. Each field must be member of the reference type "
 727         "or one of its superclasses, superinterfaces, or implemented interfaces. "
 728         "Access control is not enforced; for example, the values of private "
 729         "fields can be obtained."


 776         (Reply
 777             (Repeat classes "The number of nested classes and interfaces"
 778                 (Group TypeInfo
 779                     (byte refTypeTag  "<a href=\"#JDWP_TypeTag\">Kind</a> "
 780                                       "of following reference type. ")
 781                     (referenceTypeID typeID "The nested class or interface ID.")
 782                 )
 783             )
 784         )
 785         (ErrorSet
 786             (Error INVALID_CLASS     "refType is not the ID of a reference "
 787                                      "type.")
 788             (Error INVALID_OBJECT    "refType is not a known ID.")
 789             (Error VM_DEAD)
 790         )
 791     )
 792     (Command Status=9
 793         "Returns the current status of the reference type. The status "
 794         "indicates the extent to which the reference type has been "
 795         "initialized, as described in section 2.1.6 of "
 796         "<cite>The Java Virtual Machine Specification</cite>. "
 797         "If the class is linked the PREPARED and VERIFIED bits in the returned status bits "
 798         "will be set. If the class is initialized the INITIALIZED bit in the returned "
 799         "status bits will be set. If an error occured during initialization then the "
 800         "ERROR bit in the returned status bits will be set. "
 801         "The returned status bits are undefined for array types and for "
 802         "primitive classes (such as java.lang.Integer.TYPE). "
 803         (Out
 804             (referenceType refType "The reference type ID.")
 805         )
 806         (Reply
 807             (int status "<a href=\"#JDWP_ClassStatus\">Status</a> bits:"
 808                         "See <a href=\"#JDWP_ClassStatus\">JDWP.ClassStatus</a>")
 809         )
 810         (ErrorSet
 811             (Error INVALID_CLASS     "refType is not the ID of a reference "
 812                                      "type.")
 813             (Error INVALID_OBJECT    "refType is not a known ID.")
 814             (Error VM_DEAD)
 815         )
 816     )


 855         (Out
 856             (referenceType refType "The reference type ID.")
 857         )
 858         (Reply
 859             (string extension "extension attribute")
 860         )
 861         (ErrorSet
 862             (Error INVALID_CLASS      "refType is not the ID of a reference "
 863                                       "type.")
 864             (Error INVALID_OBJECT     "refType is not a known ID.")
 865             (Error ABSENT_INFORMATION "If the extension is not specified.")
 866             (Error NOT_IMPLEMENTED)
 867             (Error VM_DEAD)
 868         )
 869     )
 870     (Command SignatureWithGeneric=13
 871         "Returns the JNI signature of a reference type along with the "
 872         "generic signature if there is one.  "
 873         "Generic signatures are described in the signature attribute "
 874         "section in "
 875         "<cite>The Java Virtual Machine Specification</cite>. "
 876         "Since JDWP version 1.5."
 877         (Out
 878             (referenceType refType "The reference type ID.")
 879         )
 880         (Reply
 881             (string signature
 882                 "The JNI signature for the reference type.")
 883             (string genericSignature
 884                 "The generic signature for the reference type or an empty "
 885                 "string if there is none.")
 886         )
 887         (ErrorSet
 888             (Error INVALID_CLASS     "refType is not the ID of a reference "
 889                                      "type.")
 890             (Error INVALID_OBJECT    "refType is not a known ID.")
 891             (Error VM_DEAD)
 892         )
 893     )
 894     (Command FieldsWithGeneric=14
 895         "Returns information, including the generic signature if any, "
 896         "for each field in a reference type. "
 897         "Inherited fields are not included. "
 898         "The field list will include any synthetic fields created "
 899         "by the compiler. "
 900         "Fields are returned in the order they occur in the class file.  "
 901         "Generic signatures are described in the signature attribute "
 902         "section in "
 903         "<cite>The Java Virtual Machine Specification</cite>. "
 904         "Since JDWP version 1.5."
 905         (Out
 906             (referenceType refType "The reference type ID.")
 907         )
 908         (Reply
 909             (Repeat declared "Number of declared fields."
 910                 (Group FieldInfo
 911                     (field fieldID "Field ID.")
 912                     (string name "The name of the field.")
 913                     (string signature "The JNI signature of the field.")
 914                     (string genericSignature "The generic signature of the "
 915                                              "field, or an empty string if there is none.")
 916                     (int modBits "The modifier bit flags (also known as access flags) "
 917                                  "which provide additional information on the  "
 918                                  "field declaration. Individual flag values are "
 919                                  "defined in Chapter 4 of "
 920                                  "<cite>The Java Virtual Machine Specification</cite>. "
 921                                  "In addition, The <code>0xf0000000</code> bit identifies "
 922                                  "the field as synthetic, if the synthetic attribute "
 923                                  "<a href=\"#JDWP_VirtualMachine_Capabilities\">capability</a> is available.")
 924                 )
 925             )
 926         )
 927         (ErrorSet
 928             (Error CLASS_NOT_PREPARED)
 929             (Error INVALID_CLASS     "refType is not the ID of a reference "
 930                                      "type.")
 931             (Error INVALID_OBJECT    "refType is not a known ID.")
 932             (Error VM_DEAD)
 933         )
 934     )
 935     (Command MethodsWithGeneric=15
 936         "Returns information, including the generic signature if any, "
 937         "for each method in a reference type. "
 938         "Inherited methodss are not included. The list of methods will "
 939         "include constructors (identified with the name \"&lt;init&gt;\"), "
 940         "the initialization method (identified with the name \"&lt;clinit&gt;\") "
 941         "if present, and any synthetic methods created by the compiler. "
 942         "Methods are returned in the order they occur in the class file.  "
 943         "Generic signatures are described in the signature attribute "
 944         "section in "
 945         "<cite>The Java Virtual Machine Specification</cite>. "
 946         "Since JDWP version 1.5."
 947         (Out
 948             (referenceType refType "The reference type ID.")
 949         )
 950         (Reply
 951             (Repeat declared "Number of declared methods."
 952                 (Group MethodInfo
 953                     (method methodID "Method ID.")
 954                     (string name "The name of the method.")
 955                     (string signature "The JNI signature of the method.")
 956                     (string genericSignature "The generic signature of the method, or "
 957                                              "an empty string if there is none.")
 958                     (int modBits "The modifier bit flags (also known as access flags) "
 959                                  "which provide additional information on the  "
 960                                  "method declaration. Individual flag values are "
 961                                  "defined in Chapter 4 of "
 962                                  "<cite>The Java Virtual Machine Specification</cite>. "
 963                                  "In addition, The <code>0xf0000000</code> bit identifies "
 964                                  "the method as synthetic, if the synthetic attribute "
 965                                  "<a href=\"#JDWP_VirtualMachine_Capabilities\">capability</a> is available.")
 966                 )
 967             )
 968         )
 969         (ErrorSet
 970             (Error CLASS_NOT_PREPARED)
 971             (Error INVALID_CLASS     "refType is not the ID of a reference "
 972                                      "type.")
 973             (Error INVALID_OBJECT    "refType is not a known ID.")
 974             (Error VM_DEAD)
 975         )
 976     )
 977     (Command Instances=16
 978         "Returns instances of this reference type. "
 979         "Only instances that are reachable for the purposes of "
 980         "garbage collection are returned. "
 981         "<p>Since JDWP version 1.6. Requires canGetInstanceInfo capability - see "
 982         "<a href=\"#JDWP_VirtualMachine_CapabilitiesNew\">CapabilitiesNew</a>."


1005          "<p>Since JDWP version 1.6. "
1006         (Out
1007             (referenceType refType "The class.")
1008         )
1009         (Reply
1010             (int majorVersion "Major version number")
1011             (int minorVersion "Minor version number")
1012         )
1013         (ErrorSet
1014             (Error INVALID_CLASS     "refType is not the ID of a reference "
1015                                      "type.")
1016             (Error INVALID_OBJECT    "refType is not a known ID.")
1017             (Error ABSENT_INFORMATION "The class file version information is "
1018                                       "absent for primitive and array types.")
1019             (Error VM_DEAD)
1020         )
1021     )
1022     (Command ConstantPool=18
1023         "Return the raw bytes of the constant pool in the format of the "
1024         "constant_pool item of the Class File Format in "
1025         "<cite>The Java Virtual Machine Specification</cite>. "
1026         "<p>Since JDWP version 1.6. Requires canGetConstantPool capability - see "
1027         "<a href=\"#JDWP_VirtualMachine_CapabilitiesNew\">CapabilitiesNew</a>.""
1028         (Out
1029             (referenceType refType "The class.")
1030         )
1031         (Reply
1032             (int count "Total number of constant pool entries plus one. This "
1033                        "corresponds to the constant_pool_count item of the "
1034                        "Class File Format in "
1035                        "<cite>The Java Virtual Machine Specification</cite>. ")
1036             (Repeat bytes
1037                 (byte cpbytes "Raw bytes of constant pool")
1038             )
1039         )
1040         (ErrorSet
1041             (Error INVALID_CLASS     "refType is not the ID of a reference "
1042                                      "type.")
1043             (Error INVALID_OBJECT    "refType is not a known ID.")
1044             (Error NOT_IMPLEMENTED   "If the target virtual machine does not "
1045                                      "support the retrieval of constant pool information.")
1046             (Error ABSENT_INFORMATION "The Constant Pool information is "
1047                                       "absent for primitive and array types.")
1048             (Error VM_DEAD)
1049         )
1050     )
1051     (Command Module=19
1052         "Returns the module that this reference type belongs to."
1053         "<p>Since JDWP version 9."
1054         (Out
1055             (referenceType refType "The reference type.")


1418                     (string signature "The variable type's JNI signature.")
1419                     (int length
1420                         "Unsigned value used in conjunction with <code>codeIndex</code>. "
1421                         "The variable can be get or set only when the current "
1422                         "<code>codeIndex</code> &lt;= current frame code index &lt; <code>code index + length</code> ")
1423                     (int slot "The local variable's index in its frame")
1424                 )
1425             )
1426         )
1427         (ErrorSet
1428             (Error INVALID_CLASS     "refType is not the ID of a reference "
1429                                      "type.")
1430             (Error INVALID_OBJECT    "refType is not a known ID.")
1431             (Error INVALID_METHODID  "methodID is not the ID of a method.")
1432             (Error ABSENT_INFORMATION "there is no variable information for the method.")
1433             (Error VM_DEAD)
1434         )
1435     )
1436     (Command Bytecodes=3
1437         "Retrieve the method's bytecodes as defined in "
1438         "<cite>The Java Virtual Machine Specification</cite>. "
1439         "Requires canGetBytecodes capability - see "
1440         "<a href=\"#JDWP_VirtualMachine_CapabilitiesNew\">CapabilitiesNew</a>."
1441         (Out
1442             (referenceType refType "The class.")
1443             (method methodID "The method.")
1444         )
1445         (Reply
1446             (Repeat bytes
1447                 (byte bytecode "A Java bytecode.")
1448             )
1449         )
1450         (ErrorSet
1451             (Error INVALID_CLASS     "refType is not the ID of a reference "
1452                                      "type.")
1453             (Error INVALID_OBJECT    "refType is not a known ID.")
1454             (Error INVALID_METHODID  "methodID is not the ID of a method.")
1455             (Error NOT_IMPLEMENTED   "If the target virtual machine does not "
1456                                      "support the retrieval of bytecodes.")
1457             (Error VM_DEAD)
1458         )


1474                                    "the RedefineClasses command.")
1475         )
1476         (ErrorSet
1477             (Error INVALID_CLASS     "refType is not the ID of a reference "
1478                                      "type.")
1479             (Error INVALID_OBJECT    "refType is not a known ID.")
1480             (Error INVALID_METHODID  "methodID is not the ID of a method.")
1481             (Error NOT_IMPLEMENTED   "If the target virtual machine does "
1482                                      "not support this query.")
1483             (Error VM_DEAD)
1484         )
1485     )
1486     (Command VariableTableWithGeneric=5
1487         "Returns variable information for the method, including "
1488         "generic signatures for the variables. The variable table "
1489         "includes arguments and locals declared within the method. For "
1490         "instance methods, the \"this\" reference is included in the "
1491         "table. Also, synthetic variables may be present. "
1492         "Generic signatures are described in the signature attribute "
1493         "section in "
1494         "<cite>The Java Virtual Machine Specification</cite>. "
1495         "Since JDWP version 1.5."
1496         (Out
1497             (referenceType refType "The class.")
1498             (method methodID "The method.")
1499         )
1500         (Reply
1501             (int argCnt "The number of words in the frame used by arguments. "
1502                         "Eight-byte arguments use two words; all others use one. ")
1503             (Repeat slots "The number of variables."
1504                 (Group SlotInfo "Information about the variable."
1505                     (long codeIndex
1506                         "First code index at which the variable is visible (unsigned). "
1507                         "Used in conjunction with <code>length</code>. "
1508                         "The variable can be get or set only when the current "
1509                         "<code>codeIndex</code> &lt;= current frame code index &lt; <code>codeIndex + length</code> ")
1510                     (string name "The variable's name.")
1511                     (string signature "The variable type's JNI signature.")
1512                     (string genericSignature "The variable type's generic "
1513                          "signature or an empty string if there is none.")
1514                     (int length


2065                (Group monitor
2066                   (tagged-object monitor "An owned monitor")
2067                   (int stack_depth "Stack depth location where monitor was acquired")
2068                )
2069             )
2070         )
2071         (ErrorSet
2072             (Error INVALID_THREAD)
2073             (Error INVALID_OBJECT    "thread is not a known ID.")
2074             (Error NOT_IMPLEMENTED)
2075             (Error VM_DEAD)
2076         )
2077     )
2078     (Command ForceEarlyReturn=14
2079         "Force a method to return before it reaches a return "
2080         "statement.  "
2081         "<p>"
2082         "The method which will return early is referred to as the "
2083         "called method. The called method is the current method (as "
2084         "defined by the Frames section in "
2085         "<cite>The Java Virtual Machine Specification</cite>) "
2086         "for the specified thread at the time this command "
2087         "is received. "
2088         "<p>"
2089         "The specified thread must be suspended. "
2090         "The return occurs when execution of Java programming "
2091         "language code is resumed on this thread. Between sending this "
2092         "command and resumption of thread execution, the "
2093         "state of the stack is undefined. "
2094         "<p>"
2095         "No further instructions are executed in the called "
2096         "method. Specifically, finally blocks are not executed. Note: "
2097         "this can cause inconsistent states in the application. "
2098         "<p>"
2099         "A lock acquired by calling the called method (if it is a "
2100         "synchronized method) and locks acquired by entering "
2101         "synchronized blocks within the called method are "
2102         "released. Note: this does not apply to JNI locks or "
2103         "java.util.concurrent.locks locks. "
2104         "<p>"
2105         "Events, such as MethodExit, are generated as they would be in "


< prev index next >