01: //
02: // Copyright (C) 2005 United States Government as represented by the
03: // Administrator of the National Aeronautics and Space Administration
04: // (NASA). All Rights Reserved.
05: //
06: // This software is distributed under the NASA Open Source Agreement
07: // (NOSA), version 1.3. The NOSA has been approved by the Open Source
08: // Initiative. See the file NOSA-1.3-JPF at the top of the distribution
09: // directory tree for the complete NOSA document.
10: //
11: // THE SUBJECT SOFTWARE IS PROVIDED "AS IS" WITHOUT ANY WARRANTY OF ANY
12: // KIND, EITHER EXPRESSED, IMPLIED, OR STATUTORY, INCLUDING, BUT NOT
13: // LIMITED TO, ANY WARRANTY THAT THE SUBJECT SOFTWARE WILL CONFORM TO
14: // SPECIFICATIONS, ANY IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR
15: // A PARTICULAR PURPOSE, OR FREEDOM FROM INFRINGEMENT, ANY WARRANTY THAT
16: // THE SUBJECT SOFTWARE WILL BE ERROR FREE, OR ANY WARRANTY THAT
17: // DOCUMENTATION, IF PROVIDED, WILL CONFORM TO THE SUBJECT SOFTWARE.
18: //
19: package gov.nasa.jpf;
20:
21: /**
22: * interface to register for callbacks by the VM
23: * Observer role in equally named pattern
24: */
25: public interface VMListener extends JPFListener {
26: /**
27: * VM has executed next instruction
28: * (can be used to analyze branches, monitor PUTFIELD / GETFIELD and
29: * INVOKExx / RETURN instructions)
30: */
31: void instructionExecuted(VM vm);
32:
33: /**
34: * new Thread entered run() method
35: */
36: void threadStarted(VM vm);
37:
38: /**
39: * Thread exited run() method
40: */
41: void threadTerminated(VM vm);
42:
43: /**
44: * new class was loaded
45: */
46: void classLoaded(VM vm);
47:
48: /**
49: * new object was created
50: */
51: void objectCreated(VM vm);
52:
53: /**
54: * object was garbage collected (after potential finalization)
55: */
56: void objectReleased(VM vm);
57:
58: void gcBegin(VM vm);
59:
60: void gcEnd(VM vm);
61:
62: /**
63: * exception was thrown
64: */
65: void exceptionThrown(VM vm);
66: }
|