-
Notifications
You must be signed in to change notification settings - Fork 99
/
jdwp.spec
3299 lines (3253 loc) · 153 KB
/
jdwp.spec
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
/*
* Copyright (c) 1998, 2020, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
* under the terms of the GNU General Public License version 2 only, as
* published by the Free Software Foundation. Oracle designates this
* particular file as subject to the "Classpath" exception as provided
* by Oracle in the LICENSE file that accompanied this code.
*
* This code is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
* version 2 for more details (a copy is included in the LICENSE file that
* accompanied this code).
*
* You should have received a copy of the GNU General Public License version
* 2 along with this work; if not, write to the Free Software Foundation,
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
* or visit www.oracle.com if you need additional information or have any
* questions.
*/
JDWP "Java(tm) Debug Wire Protocol"
(CommandSet VirtualMachine=1
(Command Version=1
"Returns the JDWP version implemented by the target VM. "
"The version string format is implementation dependent. "
(Out
)
(Reply
(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")
)
(ErrorSet
(Error VM_DEAD)
)
)
(Command ClassesBySignature=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
(string signature "JNI signature of the class to find "
"(for example, \"Ljava/lang/String;\"). "
)
)
(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 "Matching loaded reference type")
(int status "The current class "
"<a href=\"#JDWP_ClassStatus\">status.</a> ")
)
)
)
(ErrorSet
(Error VM_DEAD)
)
)
(Command AllClasses=3
"Returns reference types for all classes currently loaded by the "
"target VM. "
"See <a href=\"../jvmti.html#GetLoadedClasses\">JVM TI GetLoadedClasses</a>."
(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")
(int status "The current class "
"<a href=\"#JDWP_ClassStatus\">status.</a> ")
)
)
)
(ErrorSet
(Error VM_DEAD)
)
)
(Command AllThreads=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
)
(Reply
(Repeat threads "Number of threads that follow."
(threadObject thread "A running thread")
)
)
(ErrorSet
(Error VM_DEAD)
)
)
(Command TopLevelThreadGroups=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
)
(Reply
(Repeat groups "Number of thread groups that follow."
(threadGroupObject group "A top level thread group")
)
)
(ErrorSet
(Error VM_DEAD)
)
)
(Command Dispose=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: "
"<ul>"
"<li>All event requests are cancelled. "
"<li>All threads suspended by the thread-level "
"<a href=\"#JDWP_ThreadReference_Resume\">resume</a> command "
"or the VM-level "
"<a href=\"#JDWP_VirtualMachine_Resume\">resume</a> command "
"are resumed as many times as necessary for them to run. "
"<li>Garbage collection is re-enabled in all cases where it was "
"<a href=\"#JDWP_ObjectReference_DisableCollection\">disabled</a> "
"</ul>"
"Any current method invocations executing in the target VM "
"are continued after the disconnection. Upon completion of any such "
"method invocation, the invoking thread continues from the "
"location where it was originally stopped. "
"<p>"
"Resources originating in "
"this VirtualMachine (ObjectReferences, ReferenceTypes, etc.) "
"will become invalid. "
(Out
)
(Reply
)
(ErrorSet
)
)
(Command IDSizes=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
)
(Reply
(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 ")
)
(ErrorSet
(Error VM_DEAD)
)
)
(Command Suspend=8
"Suspends the execution of the application running in the target "
"VM. All Java threads currently running will be suspended. "
"<p>"
"Unlike java.lang.Thread.suspend, "
"suspends of both the virtual machine and individual threads are "
"counted. Before a thread will run again, it must be resumed through "
"the <a href=\"#JDWP_VirtualMachine_Resume\">VM-level resume</a> command "
"or the <a href=\"#JDWP_ThreadReference_Resume\">thread-level resume</a> command "
"the same number of times it has been suspended. "
(Out
)
(Reply
)
(ErrorSet
(Error VM_DEAD)
)
)
(Command Resume=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
)
(Reply
)
(ErrorSet
)
)
(Command Exit=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
(int exitCode "the exit code")
)
(Reply
)
(ErrorSet
)
)
(Command CreateString=11
"Creates a new string object in the target VM and returns "
"its id. "
(Out
(string utf "UTF-8 characters to use in the created string. ")
)
(Reply
(stringObject stringObject
"Created string (instance of java.lang.String) ")
)
(ErrorSet
(Error VM_DEAD)
)
)
(Command Capabilities=12
"Retrieve this VM's capabilities. The capabilities are returned "
"as booleans, each indicating the presence or absence of a "
"capability. The commands associated with each capability will "
"return the NOT_IMPLEMENTED error if the cabability is not "
"available."
(Out
)
(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? ")
)
(ErrorSet
(Error VM_DEAD)
)
)
(Command ClassPaths=13
"Retrieve the classpath and bootclasspath of the target VM. "
"If the classpath is not defined, returns an empty list. If the "
"bootclasspath is not defined returns an empty list."
(Out
)
(Reply
(string baseDir "Base directory used to resolve relative "
"paths in either of the following lists.")
(Repeat classpaths "Number of paths in classpath."
(string path "One component of classpath") )
(Repeat bootclasspaths "Number of paths in bootclasspath."
(string path "One component of bootclasspath") )
)
(ErrorSet
(Error VM_DEAD)
)
)
(Command DisposeObjects=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.
"<p>"
"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. "
"<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? "
"<p>@Deprecated(since=\"15\") A JVM TI based JDWP back-end "
"will never set this capability to true.")
(boolean canUnrestrictedlyRedefineClasses
"Can the VM redefine classes "
"in ways that are normally restricted?"
"<p>@Deprecated(since=\"15\") A JVM TI based JDWP back-end "
"will never set this capability to true.")
(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>"
"Unless the canUnrestrictedlyRedefineClasses capability is present "
"the redefinition must follow the restrictions described in "
"<a href=\"../jvmti.html#RedefineClasses\">JVM TI RedefineClasses</a>."
"<p>"
"Requires canRedefineClasses capability - see "
"<a href=\"#JDWP_VirtualMachine_CapabilitiesNew\">CapabilitiesNew</a>. "
"<p>@Deprecated(since=\"15\") "
"In addition to the canRedefineClasses capability, the target VM must "
"have the canAddMethod capability to add methods when redefining classes, "
"or the canUnrestrictedlyRedefineClasses capability to redefine classes in ways "
"that are normally restricted."
(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 CLASS_ATTRIBUTE_CHANGE_NOT_IMPLEMENTED)
(Error VM_DEAD)
)
)
(Command SetDefaultStratum=19
"Set the default stratum. Requires canSetDefaultStratum capability - see "
"<a href=\"#JDWP_VirtualMachine_CapabilitiesNew\">CapabilitiesNew</a>."
(Out
(string stratumID "default stratum, or empty string to use "
"reference type default.")
)
(Reply
)
(ErrorSet
(Error NOT_IMPLEMENTED)
(Error VM_DEAD)
)
)
(Command AllClassesWithGeneric=20
"Returns reference types for all classes currently loaded by the "
"target VM. "
"Both the JNI signature and the generic signature are "
"returned for each class. "
"Generic signatures are described in the signature attribute "
"section in "
"<cite>The Java Virtual Machine Specification</cite>. "
"Since JDWP version 1.5."
(Out
)
(Reply
(Repeat classes "Number of reference types that follow."
(Group ClassInfo
(byte refTypeTag "<a href=\"#JDWP_TypeTag\">Kind</a> "
"of following reference type. ")
(referenceTypeID typeID "Loaded reference type")
(string signature
"The JNI signature of the loaded reference type.")
(string genericSignature
"The generic signature of the loaded reference type "
"or an empty string if there is none.")
(int status "The current class "
"<a href=\"#JDWP_ClassStatus\">status.</a> ")
)
)
)
(ErrorSet
(Error VM_DEAD)
)
)
(Command InstanceCounts=21
"Returns the number of instances of each reference type in the input list. "
"Only instances that are reachable for the purposes of "
"garbage collection are counted. If a reference type is invalid, "
"eg. it has been unloaded, zero is returned for its instance count."
"<p>Since JDWP version 1.6. Requires canGetInstanceInfo capability - see "
"<a href=\"#JDWP_VirtualMachine_CapabilitiesNew\">CapabilitiesNew</a>."
(Out
(Repeat refTypesCount "Number of reference types that follow. Must be non-negative."
(referenceType refType "A reference type ID.")
)
)
(Reply
(Repeat counts "The number of counts that follow."
(long instanceCount "The number of instances for the corresponding reference type "
"in 'Out Data'.")
)
)
(ErrorSet
(Error ILLEGAL_ARGUMENT "refTypesCount is less than zero.")
(Error NOT_IMPLEMENTED)
(Error VM_DEAD)
)
)
(Command AllModules=22
"Returns all modules in the target VM."
"<p>Since JDWP version 9."
(Out
)
(Reply
(Repeat modules "The number of the modules that follow."
(moduleID module "One of the modules.")
)
)
(ErrorSet
(Error NOT_IMPLEMENTED)
(Error VM_DEAD)
)
)
)
(CommandSet ReferenceType=2
(Command Signature=1
"Returns the type signature of a reference type. "
"Type signature formats are the same as specified in "
"<a href=\"../jvmti.html#GetClassSignature\">JVM TI GetClassSignature</a>."
(Out
(referenceType refType "The reference type ID.")
)
(Reply
(string signature
"The JNI signature for the reference type.")
)
(ErrorSet
(Error INVALID_CLASS "refType is not the ID of a reference "
"type.")
(Error INVALID_OBJECT "refType is not a known ID.")
(Error VM_DEAD)
)
)
(Command ClassLoader=2
"Returns the instance of java.lang.ClassLoader which loaded "
"a given reference type. If the reference type was loaded by the "
"system class loader, the returned object ID is null."
(Out
(referenceType refType "The reference type ID.")
)
(Reply
(classLoaderObject classLoader "The class loader for the reference type. ")
)
(ErrorSet
(Error INVALID_CLASS "refType is not the ID of a reference "
"type.")
(Error INVALID_OBJECT "refType is not a known ID.")
(Error VM_DEAD)
)
)
(Command Modifiers=3
"Returns the modifiers (also known as access flags) for a reference type. "
"The returned bit mask contains information on the declaration "
"of the reference type. If the reference type is an array or "
"a primitive class (for example, java.lang.Integer.TYPE), the "
"value of the returned bit mask is undefined."
(Out
(referenceType refType "The reference type ID.")
)
(Reply
(int modBits "Modifier bits as defined in Chapter 4 of "
"<cite>The Java Virtual Machine Specification</cite>")
)
(ErrorSet
(Error INVALID_CLASS "refType is not the ID of a reference "
"type.")
(Error INVALID_OBJECT "refType is not a known ID.")
(Error VM_DEAD)
)
)
(Command Fields=4
"Returns information for each field in a reference type. "
"Inherited fields are not included. "
"The field list will include any synthetic fields created "
"by the compiler. "
"Fields are returned in the order they occur in the class file."
(Out
(referenceType refType "The reference type ID.")
)
(Reply
(Repeat declared "Number of declared fields."
(Group FieldInfo
(field fieldID "Field ID.")
(string name "Name of field.")
(string signature "JNI Signature of field.")
(int modBits "The modifier bit flags (also known as access flags) "
"which provide additional information on the "
"field declaration. Individual flag values are "
"defined in Chapter 4 of "
"<cite>The Java Virtual Machine Specification</cite>. "
"In addition, The <code>0xf0000000</code> bit identifies "
"the field as synthetic, if the synthetic attribute "
"<a href=\"#JDWP_VirtualMachine_Capabilities\">capability</a> is available.")
)
)
)
(ErrorSet
(Error CLASS_NOT_PREPARED)
(Error INVALID_CLASS "refType is not the ID of a reference "
"type.")
(Error INVALID_OBJECT "refType is not a known ID.")
(Error VM_DEAD)
)
)
(Command Methods=5
"Returns information for each method in a reference type. "
"Inherited methods are not included. The list of methods will "
"include constructors (identified with the name \"<init>\"), "
"the initialization method (identified with the name \"<clinit>\") "
"if present, and any synthetic methods created by the compiler. "
"Methods are returned in the order they occur in the class file."
(Out
(referenceType refType "The reference type ID.")
)
(Reply
(Repeat declared "Number of declared methods."
(Group MethodInfo
(method methodID "Method ID.")
(string name "Name of method.")
(string signature "JNI signature of method.")
(int modBits "The modifier bit flags (also known as access flags) "
"which provide additional information on the "
"method declaration. Individual flag values are "
"defined in Chapter 4 of "
"<cite>The Java Virtual Machine Specification</cite>. "
"In addition, The <code>0xf0000000</code> bit identifies "
"the method as synthetic, if the synthetic attribute "
"<a href=\"#JDWP_VirtualMachine_Capabilities\">capability</a> is available.")
)
)
)
(ErrorSet
(Error CLASS_NOT_PREPARED)
(Error INVALID_CLASS "refType is not the ID of a reference "
"type.")
(Error INVALID_OBJECT "refType is not a known ID.")
(Error VM_DEAD)
)
)
(Command GetValues=6
"Returns the value of one or more static fields of the "
"reference type. Each field must be member of the reference type "
"or one of its superclasses, superinterfaces, or implemented interfaces. "
"Access control is not enforced; for example, the values of private "
"fields can be obtained."
(Out
(referenceType refType "The reference type ID.")
(Repeat fields "The number of values to get"
(Group Field
(field fieldID "A field to get")
)
)
)
(Reply
(Repeat values "The number of values returned, always equal to fields, "
"the number of values to get."
(value value "The field value")
)
)
(ErrorSet
(Error INVALID_CLASS "refType is not the ID of a reference "
"type.")
(Error INVALID_OBJECT "refType is not a known ID.")
(Error INVALID_FIELDID)
(Error VM_DEAD)
)
)
(Command SourceFile=7
"Returns the name of source file in which a reference type was "
"declared. "
(Out
(referenceType refType "The reference type ID.")
)
(Reply
(string sourceFile "The source file name. No path information "
"for the file is included")
)
(ErrorSet
(Error INVALID_CLASS "refType is not the ID of a reference "
"type.")
(Error INVALID_OBJECT "refType is not a known ID.")
(Error ABSENT_INFORMATION "The source file attribute is absent.")
(Error VM_DEAD)
)
)
(Command NestedTypes=8
"Returns the classes and interfaces directly nested within this type."
"Types further nested within those types are not included. "
(Out
(referenceType refType "The reference type ID.")
)
(Reply
(Repeat classes "The number of nested classes and interfaces"
(Group TypeInfo
(byte refTypeTag "<a href=\"#JDWP_TypeTag\">Kind</a> "
"of following reference type. ")
(referenceTypeID typeID "The nested class or interface ID.")
)
)
)
(ErrorSet
(Error INVALID_CLASS "refType is not the ID of a reference "
"type.")
(Error INVALID_OBJECT "refType is not a known ID.")
(Error VM_DEAD)
)
)
(Command Status=9
"Returns the current status of the reference type. The status "
"indicates the extent to which the reference type has been "
"initialized, as described in section 2.1.6 of "
"<cite>The Java Virtual Machine Specification</cite>. "
"If the class is linked the PREPARED and VERIFIED bits in the returned status bits "
"will be set. If the class is initialized the INITIALIZED bit in the returned "
"status bits will be set. If an error occured during initialization then the "
"ERROR bit in the returned status bits will be set. "
"The returned status bits are undefined for array types and for "
"primitive classes (such as java.lang.Integer.TYPE). "
(Out
(referenceType refType "The reference type ID.")
)
(Reply
(int status "<a href=\"#JDWP_ClassStatus\">Status</a> bits:"
"See <a href=\"#JDWP_ClassStatus\">JDWP.ClassStatus</a>")
)
(ErrorSet
(Error INVALID_CLASS "refType is not the ID of a reference "
"type.")
(Error INVALID_OBJECT "refType is not a known ID.")
(Error VM_DEAD)
)
)
(Command Interfaces=10
"Returns the interfaces declared as implemented by this class. "
"Interfaces indirectly implemented (extended by the implemented "
"interface or implemented by a superclass) are not included."
(Out
(referenceType refType "The reference type ID.")
)
(Reply
(Repeat interfaces "The number of implemented interfaces"
(interfaceType interfaceType "implemented interface.")
)
)
(ErrorSet
(Error INVALID_CLASS "refType is not the ID of a reference "
"type.")
(Error INVALID_OBJECT "refType is not a known ID.")
(Error VM_DEAD)
)
)
(Command ClassObject=11
"Returns the class object corresponding to this type. "
(Out
(referenceType refType "The reference type ID.")
)
(Reply
(classObject classObject "class object.")
)
(ErrorSet
(Error INVALID_CLASS "refType is not the ID of a reference "
"type.")
(Error INVALID_OBJECT "refType is not a known ID.")
(Error VM_DEAD)
)
)
(Command SourceDebugExtension=12
"Returns the value of the SourceDebugExtension attribute. "
"Since JDWP version 1.4. Requires canGetSourceDebugExtension capability - see "
"<a href=\"#JDWP_VirtualMachine_CapabilitiesNew\">CapabilitiesNew</a>."
(Out
(referenceType refType "The reference type ID.")
)
(Reply
(string extension "extension attribute")
)
(ErrorSet
(Error INVALID_CLASS "refType is not the ID of a reference "
"type.")
(Error INVALID_OBJECT "refType is not a known ID.")
(Error ABSENT_INFORMATION "If the extension is not specified.")
(Error NOT_IMPLEMENTED)
(Error VM_DEAD)
)
)
(Command SignatureWithGeneric=13
"Returns the JNI signature of a reference type along with the "
"generic signature if there is one. "
"Generic signatures are described in the signature attribute "
"section in "
"<cite>The Java Virtual Machine Specification</cite>. "
"Since JDWP version 1.5."
(Out
(referenceType refType "The reference type ID.")
)
(Reply
(string signature
"The JNI signature for the reference type.")
(string genericSignature
"The generic signature for the reference type or an empty "
"string if there is none.")
)
(ErrorSet
(Error INVALID_CLASS "refType is not the ID of a reference "
"type.")
(Error INVALID_OBJECT "refType is not a known ID.")
(Error VM_DEAD)
)
)
(Command FieldsWithGeneric=14
"Returns information, including the generic signature if any, "
"for each field in a reference type. "
"Inherited fields are not included. "
"The field list will include any synthetic fields created "
"by the compiler. "
"Fields are returned in the order they occur in the class file. "
"Generic signatures are described in the signature attribute "
"section in "
"<cite>The Java Virtual Machine Specification</cite>. "
"Since JDWP version 1.5."
(Out
(referenceType refType "The reference type ID.")
)
(Reply
(Repeat declared "Number of declared fields."
(Group FieldInfo
(field fieldID "Field ID.")
(string name "The name of the field.")
(string signature "The JNI signature of the field.")
(string genericSignature "The generic signature of the "
"field, or an empty string if there is none.")
(int modBits "The modifier bit flags (also known as access flags) "
"which provide additional information on the "
"field declaration. Individual flag values are "
"defined in Chapter 4 of "
"<cite>The Java Virtual Machine Specification</cite>. "
"In addition, The <code>0xf0000000</code> bit identifies "
"the field as synthetic, if the synthetic attribute "
"<a href=\"#JDWP_VirtualMachine_Capabilities\">capability</a> is available.")
)
)
)
(ErrorSet
(Error CLASS_NOT_PREPARED)
(Error INVALID_CLASS "refType is not the ID of a reference "
"type.")
(Error INVALID_OBJECT "refType is not a known ID.")
(Error VM_DEAD)
)
)
(Command MethodsWithGeneric=15
"Returns information, including the generic signature if any, "
"for each method in a reference type. "
"Inherited methodss are not included. The list of methods will "
"include constructors (identified with the name \"<init>\"), "
"the initialization method (identified with the name \"<clinit>\") "
"if present, and any synthetic methods created by the compiler. "
"Methods are returned in the order they occur in the class file. "
"Generic signatures are described in the signature attribute "
"section in "
"<cite>The Java Virtual Machine Specification</cite>. "
"Since JDWP version 1.5."
(Out
(referenceType refType "The reference type ID.")
)
(Reply
(Repeat declared "Number of declared methods."
(Group MethodInfo
(method methodID "Method ID.")
(string name "The name of the method.")
(string signature "The JNI signature of the method.")
(string genericSignature "The generic signature of the method, or "
"an empty string if there is none.")
(int modBits "The modifier bit flags (also known as access flags) "
"which provide additional information on the "
"method declaration. Individual flag values are "
"defined in Chapter 4 of "
"<cite>The Java Virtual Machine Specification</cite>. "
"In addition, The <code>0xf0000000</code> bit identifies "
"the method as synthetic, if the synthetic attribute "
"<a href=\"#JDWP_VirtualMachine_Capabilities\">capability</a> is available.")
)
)
)
(ErrorSet
(Error CLASS_NOT_PREPARED)
(Error INVALID_CLASS "refType is not the ID of a reference "
"type.")
(Error INVALID_OBJECT "refType is not a known ID.")
(Error VM_DEAD)
)
)
(Command Instances=16
"Returns instances of this reference type. "
"Only instances that are reachable for the purposes of "
"garbage collection are returned. "
"<p>Since JDWP version 1.6. Requires canGetInstanceInfo capability - see "
"<a href=\"#JDWP_VirtualMachine_CapabilitiesNew\">CapabilitiesNew</a>."
(Out
(referenceType refType "The reference type ID.")
(int maxInstances "Maximum number of instances to return. Must be non-negative. "
"If zero, all instances are returned.")
)
(Reply
(Repeat instances "The number of instances that follow."
(tagged-object instance "An instance of this reference type.")
)
)
(ErrorSet
(Error INVALID_CLASS "refType is not the ID of a reference "
"type.")
(Error INVALID_OBJECT "refType is not a known ID.")
(Error ILLEGAL_ARGUMENT "maxInstances is less than zero.")
(Error NOT_IMPLEMENTED)
(Error VM_DEAD)
)