Commit | Line | Data |
---|---|---|
86530b38 AT |
1 | // ========== Copyright Header Begin ========================================== |
2 | // | |
3 | // OpenSPARC T2 Processor File: CTStrategyBase.vr | |
4 | // Copyright (C) 1995-2007 Sun Microsystems, Inc. All Rights Reserved | |
5 | // 4150 Network Circle, Santa Clara, California 95054, U.S.A. | |
6 | // | |
7 | // * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. | |
8 | // | |
9 | // This program is free software; you can redistribute it and/or modify | |
10 | // it under the terms of the GNU General Public License as published by | |
11 | // the Free Software Foundation; version 2 of the License. | |
12 | // | |
13 | // This program is distributed in the hope that it will be useful, | |
14 | // but WITHOUT ANY WARRANTY; without even the implied warranty of | |
15 | // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
16 | // GNU General Public License for more details. | |
17 | // | |
18 | // You should have received a copy of the GNU General Public License | |
19 | // along with this program; if not, write to the Free Software | |
20 | // Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA | |
21 | // | |
22 | // For the avoidance of doubt, and except that if any non-GPL license | |
23 | // choice is available it will apply instead, Sun elects to use only | |
24 | // the General Public License version 2 (GPLv2) at this time for any | |
25 | // software where a choice of GPL license versions is made | |
26 | // available with the language indicating that GPLv2 or any later version | |
27 | // may be used, or where a choice of which version of the GPL is applied is | |
28 | // otherwise unspecified. | |
29 | // | |
30 | // Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara, | |
31 | // CA 95054 USA or visit www.sun.com if you need additional information or | |
32 | // have any questions. | |
33 | // | |
34 | // ========== Copyright Header End ============================================ | |
35 | #include <vera_defines.vrh> | |
36 | #include "CTVerifObjectBase.vrh" | |
37 | #include "CTTransactionID.vrh" | |
38 | #include "CTThreadAttributes.vrh" | |
39 | ||
40 | // NOTE: We must reference the Thread Manager definitions directly | |
41 | // in order to implement the 'handleSignal' method here. | |
42 | #include "ThreadMgr.vri" | |
43 | ||
44 | // | |
45 | // All strategy classes descend from the Strategy class. | |
46 | // | |
47 | virtual class CTStrategyBase extends CTVerifObject { | |
48 | ||
49 | // This object is a triplet of ID information, but only context and strategy IDs | |
50 | // are set at this level. | |
51 | protected CTTransactionID ID = new; | |
52 | ||
53 | // These methods are used within the MIBE verification framework to | |
54 | // relay signals among threads via the ThreadManager. | |
55 | virtual function CTThreadAttributes getAttributes(); | |
56 | virtual task setThreadNumber(integer threadNum); | |
57 | virtual function TMSuccess_T handleSignal(integer sig, CTThreadAttributes senderAttr); | |
58 | ||
59 | // The RunThread() method can be used by subclasses to perform | |
60 | // initialization prior to, and cleanup after, a strategy thread runs. | |
61 | // This is the entry point for calls to a strategy from its context. | |
62 | virtual task RunThread() { | |
63 | // By default, simply call the strategy's Execute() handler. | |
64 | Execute(); | |
65 | } | |
66 | ||
67 | // The only interface type enforced by this class consists of one | |
68 | // signature. Contexts will assume that each strategy provides an | |
69 | // execute method. | |
70 | // At the strategy level, "Execute" is a command to run a single strategy thread. | |
71 | virtual task Execute(); | |
72 | ||
73 | // SetID is provided for the template Execute method in the Context class, where it | |
74 | // is used to stamp each strategy instance with a constant context ID and an | |
75 | // increasing strategy ID. | |
76 | // This task should never be needed by a test writer and only needed by a | |
77 | // context writer if he or she plans on overiding the context Execute | |
78 | // method. | |
79 | task SetID(integer CID, integer PEU_SID) { | |
80 | ID.SetContextID(CID); | |
81 | ID.SetStrategyID(PEU_SID); | |
82 | } | |
83 | ||
84 | function CTTransactionID GetID() { GetID = ID; } | |
85 | } | |
86 | ||
87 |