1 # Copyright (c) 2012 ARM Limited
4 # The license below extends only to copyright in the software and shall
5 # not be construed as granting a license to any other intellectual
6 # property including but not limited to intellectual property relating
7 # to a hardware implementation of the functionality of the software
8 # licensed hereunder. You may use the software subject to the license
9 # terms below provided that you ensure that this notice is replicated
10 # unmodified and in its entirety in all distributions of the software,
11 # modified or unmodified, in source code or in binary form.
13 # Copyright (c) 2006-2007 The Regents of The University of Michigan
14 # All rights reserved.
16 # Redistribution and use in source and binary forms, with or without
17 # modification, are permitted provided that the following conditions are
18 # met: redistributions of source code must retain the above copyright
19 # notice, this list of conditions and the following disclaimer;
20 # redistributions in binary form must reproduce the above copyright
21 # notice, this list of conditions and the following disclaimer in the
22 # documentation and/or other materials provided with the distribution;
23 # neither the name of the copyright holders nor the names of its
24 # contributors may be used to endorse or promote products derived from
25 # this software without specific prior written permission.
27 # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
28 # "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
29 # LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
30 # A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
31 # OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
32 # SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
33 # LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
34 # DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
35 # THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
36 # (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
37 # OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
39 # Authors: Steve Reinhardt
46 from os
.path
import join
as joinpath
52 def skip_test(reason
=""):
53 """Signal that a test should be skipped and optionally print why.
56 reason -- Reason why the test failed. Output is omitted if empty.
60 print "Skipping test: %s" % reason
63 def has_sim_object(name
):
64 """Test if a SimObject exists in the simulator.
67 name -- Name of SimObject (string)
69 Returns: True if the object exists, False otherwise.
73 cls
= getattr(m5
.objects
, name
)
74 return issubclass(cls
, m5
.objects
.SimObject
)
75 except AttributeError:
78 def require_sim_object(name
, fatal
=False):
79 """Test if a SimObject exists and abort/skip test if not.
82 name -- Name of SimObject (string)
85 fatal -- Set to True to indicate that the test should fail
86 instead of being skipped.
89 if has_sim_object(name
):
92 msg
= "Test requires the '%s' SimObject." % name
99 def require_file(path
, fatal
=False, mode
=os
.F_OK
):
100 """Test if a file exists and abort/skip test if not.
103 path -- File to test for.
106 fatal -- Set to True to indicate that the test should fail
107 instead of being skipped.
108 modes -- Mode to test for, default to existence. See the
109 Python documentation for os.access().
112 if os
.access(path
, mode
):
115 msg
= "Test requires '%s'" % path
116 if not os
.path
.exists(path
):
117 msg
+= " which does not exist."
119 msg
+= " which has incorrect permissions."
126 def require_kvm(kvm_dev
="/dev/kvm", fatal
=False):
127 """Test if KVM is available.
130 kvm_dev -- Device to test (normally /dev/kvm)
131 fatal -- Set to True to indicate that the test should fail
132 instead of being skipped.
135 require_sim_object("BaseKvmCPU", fatal
=fatal
)
136 require_file(kvm_dev
, fatal
=fatal
, mode
=os
.R_OK | os
.W_OK
)
139 """Default run_test implementations. Scripts can override it."""
141 # instantiate configuration
144 # simulate until program terminates
145 exit_event
= m5
.simulate(maxtick
)
146 print 'Exiting @ tick', m5
.curTick(), 'because', exit_event
.getCause()
148 # Since we're in batch mode, dont allow tcp socket connections
149 m5
.disableAllListeners()
151 # single "path" arg encodes everything we need to know about test
152 (category
, mode
, name
, isa
, opsys
, config
) = sys
.argv
[1].split('/')[-6:]
154 # find path to directory containing this file
155 tests_root
= os
.path
.dirname(__file__
)
156 test_progs
= os
.environ
.get('M5_TEST_PROGS', '/dist/m5/regression/test-progs')
157 if not os
.path
.isdir(test_progs
):
158 test_progs
= joinpath(tests_root
, 'test-progs')
160 # generate path to binary file
161 def binpath(app
, file=None):
162 # executable has same name as app unless specified otherwise
165 return joinpath(test_progs
, app
, 'bin', isa
, opsys
, file)
167 # generate path to input file
168 def inputpath(app
, file=None):
169 # input file has same name as app unless specified otherwise
172 return joinpath(test_progs
, app
, 'input', file)
174 # build configuration
175 sys
.path
.append(joinpath(tests_root
, 'configs'))
176 test_filename
= config
177 # for ruby configurations, remove the protocol name from the test filename
178 if re
.search('-ruby', test_filename
):
179 test_filename
= test_filename
.split('-ruby')[0]+'-ruby'
180 execfile(joinpath(tests_root
, 'configs', test_filename
+ '.py'))
182 # set default maxtick... script can override
183 # -1 means run forever
186 # tweak configuration for specific test
187 sys
.path
.append(joinpath(tests_root
, category
, mode
, name
))
188 execfile(joinpath(tests_root
, category
, mode
, name
, 'test.py'))
190 # Initialize all CPUs in a system
193 # We might actually have a MemTest object or something similar
194 # here that just pretends to be a CPU.
200 # The CPU attribute doesn't exist in some cases, e.g. the Ruby
202 if not hasattr(sys
, "cpu"):
205 # The CPU can either be a list of CPUs or a single object.
206 if isinstance(sys
.cpu
, list):
207 [ initCPU(cpu
) for cpu
in sys
.cpu
]
211 # We might be creating a single system or a dual system. Try
212 # initializing the CPUs in all known system attributes.
213 for sysattr
in [ "system", "testsys", "drivesys" ]:
214 if hasattr(root
, sysattr
):
215 initCPUs(getattr(root
, sysattr
))