1# Copyright (c) 2005 The Regents of The University of Michigan 2# All rights reserved. 3# 4# Redistribution and use in source and binary forms, with or without 5# modification, are permitted provided that the following conditions are 6# met: redistributions of source code must retain the above copyright 7# notice, this list of conditions and the following disclaimer; 8# redistributions in binary form must reproduce the above copyright 9# notice, this list of conditions and the following disclaimer in the 10# documentation and/or other materials provided with the distribution; 11# neither the name of the copyright holders nor the names of its 12# contributors may be used to endorse or promote products derived from 13# this software without specific prior written permission. 14# 15# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 16# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 17# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR 18# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 19# OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 20# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 21# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 22# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 23# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 24# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 25# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 26# 27# Authors: Nathan Binkert 28 29import code, optparse, os, socket, sys 30from datetime import datetime 31from attrdict import attrdict 32 33__all__ = [ 'options', 'arguments', 'main' ] 34 35usage="%prog [m5 options] script.py [script options]" 36version="%prog 2.0" 37brief_copyright=''' 38Copyright (c) 2001-2006 39The Regents of The University of Michigan 40All Rights Reserved 41''' 42 43# there's only one option parsing done, so make it global and add some 44# helper functions to make it work well. 45parser = optparse.OptionParser(usage=usage, version=version, 46 description=brief_copyright, 47 formatter=optparse.TitledHelpFormatter()) 48parser.disable_interspersed_args() 49 50# current option group 51group = None 52 53def set_group(*args, **kwargs): 54 '''set the current option group''' 55 global group 56 if not args and not kwargs: 57 group = None 58 else: 59 group = parser.add_option_group(*args, **kwargs) 60 61class splitter(object): 62 def __init__(self, split): 63 self.split = split 64 def __call__(self, option, opt_str, value, parser): 65 getattr(parser.values, option.dest).extend(value.split(self.split)) 66 67def add_option(*args, **kwargs): 68 '''add an option to the current option group, or global none set''' 69 70 # if action=split, but allows the option arguments 71 # themselves to be lists separated by the split variable''' 72 73 if kwargs.get('action', None) == 'append' and 'split' in kwargs: 74 split = kwargs.pop('split') 75 kwargs['default'] = [] 76 kwargs['type'] = 'string' 77 kwargs['action'] = 'callback' 78 kwargs['callback'] = splitter(split) 79 80 if group: 81 return group.add_option(*args, **kwargs) 82 83 return parser.add_option(*args, **kwargs) 84 85def bool_option(name, default, help): 86 '''add a boolean option called --name and --no-name. 87 Display help depending on which is the default''' 88 89 tname = '--%s' % name 90 fname = '--no-%s' % name 91 dest = name.replace('-', '_') 92 if default: 93 thelp = optparse.SUPPRESS_HELP 94 fhelp = help 95 else: 96 thelp = help 97 fhelp = optparse.SUPPRESS_HELP 98 99 add_option(tname, action="store_true", default=default, help=thelp) 100 add_option(fname, action="store_false", dest=dest, help=fhelp) 101 102# Help options 103add_option('-A', "--authors", action="store_true", default=False, 104 help="Show author information") 105add_option('-C', "--copyright", action="store_true", default=False, 106 help="Show full copyright information") 107add_option('-R', "--readme", action="store_true", default=False, 108 help="Show the readme") 109add_option('-N', "--release-notes", action="store_true", default=False, 110 help="Show the release notes") 111 112# Options for configuring the base simulator 113add_option('-d', "--outdir", metavar="DIR", default=".", 114 help="Set the output directory to DIR [Default: %default]") 115add_option('-i', "--interactive", action="store_true", default=False, 116 help="Invoke the interactive interpreter after running the script") 117add_option("--pdb", action="store_true", default=False, 118 help="Invoke the python debugger before running the script") 119add_option('-p', "--path", metavar="PATH[:PATH]", action='append', split=':', 120 help="Prepend PATH to the system path when invoking the script") 121add_option('-q', "--quiet", action="count", default=0, 122 help="Reduce verbosity") 123add_option('-v', "--verbose", action="count", default=0, 124 help="Increase verbosity") 125 126# Statistics options 127set_group("Statistics Options") 128add_option("--stats-file", metavar="FILE", default="m5stats.txt", 129 help="Sets the output file for statistics [Default: %default]") 130 131# Debugging options 132set_group("Debugging Options") 133add_option("--debug-break", metavar="TIME[,TIME]", action='append', split=',', 134 help="Cycle to create a breakpoint") 135 136# Tracing options 137set_group("Trace Options") 138add_option("--trace-flags", metavar="FLAG[,FLAG]", action='append', split=',', 139 help="Sets the flags for tracing")
| 1# Copyright (c) 2005 The Regents of The University of Michigan 2# All rights reserved. 3# 4# Redistribution and use in source and binary forms, with or without 5# modification, are permitted provided that the following conditions are 6# met: redistributions of source code must retain the above copyright 7# notice, this list of conditions and the following disclaimer; 8# redistributions in binary form must reproduce the above copyright 9# notice, this list of conditions and the following disclaimer in the 10# documentation and/or other materials provided with the distribution; 11# neither the name of the copyright holders nor the names of its 12# contributors may be used to endorse or promote products derived from 13# this software without specific prior written permission. 14# 15# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 16# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 17# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR 18# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 19# OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 20# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 21# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 22# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 23# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 24# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 25# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 26# 27# Authors: Nathan Binkert 28 29import code, optparse, os, socket, sys 30from datetime import datetime 31from attrdict import attrdict 32 33__all__ = [ 'options', 'arguments', 'main' ] 34 35usage="%prog [m5 options] script.py [script options]" 36version="%prog 2.0" 37brief_copyright=''' 38Copyright (c) 2001-2006 39The Regents of The University of Michigan 40All Rights Reserved 41''' 42 43# there's only one option parsing done, so make it global and add some 44# helper functions to make it work well. 45parser = optparse.OptionParser(usage=usage, version=version, 46 description=brief_copyright, 47 formatter=optparse.TitledHelpFormatter()) 48parser.disable_interspersed_args() 49 50# current option group 51group = None 52 53def set_group(*args, **kwargs): 54 '''set the current option group''' 55 global group 56 if not args and not kwargs: 57 group = None 58 else: 59 group = parser.add_option_group(*args, **kwargs) 60 61class splitter(object): 62 def __init__(self, split): 63 self.split = split 64 def __call__(self, option, opt_str, value, parser): 65 getattr(parser.values, option.dest).extend(value.split(self.split)) 66 67def add_option(*args, **kwargs): 68 '''add an option to the current option group, or global none set''' 69 70 # if action=split, but allows the option arguments 71 # themselves to be lists separated by the split variable''' 72 73 if kwargs.get('action', None) == 'append' and 'split' in kwargs: 74 split = kwargs.pop('split') 75 kwargs['default'] = [] 76 kwargs['type'] = 'string' 77 kwargs['action'] = 'callback' 78 kwargs['callback'] = splitter(split) 79 80 if group: 81 return group.add_option(*args, **kwargs) 82 83 return parser.add_option(*args, **kwargs) 84 85def bool_option(name, default, help): 86 '''add a boolean option called --name and --no-name. 87 Display help depending on which is the default''' 88 89 tname = '--%s' % name 90 fname = '--no-%s' % name 91 dest = name.replace('-', '_') 92 if default: 93 thelp = optparse.SUPPRESS_HELP 94 fhelp = help 95 else: 96 thelp = help 97 fhelp = optparse.SUPPRESS_HELP 98 99 add_option(tname, action="store_true", default=default, help=thelp) 100 add_option(fname, action="store_false", dest=dest, help=fhelp) 101 102# Help options 103add_option('-A', "--authors", action="store_true", default=False, 104 help="Show author information") 105add_option('-C', "--copyright", action="store_true", default=False, 106 help="Show full copyright information") 107add_option('-R', "--readme", action="store_true", default=False, 108 help="Show the readme") 109add_option('-N', "--release-notes", action="store_true", default=False, 110 help="Show the release notes") 111 112# Options for configuring the base simulator 113add_option('-d', "--outdir", metavar="DIR", default=".", 114 help="Set the output directory to DIR [Default: %default]") 115add_option('-i', "--interactive", action="store_true", default=False, 116 help="Invoke the interactive interpreter after running the script") 117add_option("--pdb", action="store_true", default=False, 118 help="Invoke the python debugger before running the script") 119add_option('-p', "--path", metavar="PATH[:PATH]", action='append', split=':', 120 help="Prepend PATH to the system path when invoking the script") 121add_option('-q', "--quiet", action="count", default=0, 122 help="Reduce verbosity") 123add_option('-v', "--verbose", action="count", default=0, 124 help="Increase verbosity") 125 126# Statistics options 127set_group("Statistics Options") 128add_option("--stats-file", metavar="FILE", default="m5stats.txt", 129 help="Sets the output file for statistics [Default: %default]") 130 131# Debugging options 132set_group("Debugging Options") 133add_option("--debug-break", metavar="TIME[,TIME]", action='append', split=',', 134 help="Cycle to create a breakpoint") 135 136# Tracing options 137set_group("Trace Options") 138add_option("--trace-flags", metavar="FLAG[,FLAG]", action='append', split=',', 139 help="Sets the flags for tracing")
|
150add_option("--trace-ignore", metavar="EXPR", action='append', split=':', 151 help="Ignore EXPR sim objects") 152 153# Execution Trace options 154set_group("Execution Trace Options") 155bool_option("speculative", default=True, 156 help="Don't capture speculative instructions") 157bool_option("print-cycle", default=True, 158 help="Don't print cycle numbers in trace output") 159bool_option("print-symbol", default=True, 160 help="Disable PC symbols in trace output") 161bool_option("print-opclass", default=True, 162 help="Don't print op class type in trace output") 163bool_option("print-thread", default=True, 164 help="Don't print thread number in trace output") 165bool_option("print-effaddr", default=True, 166 help="Don't print effective address in trace output") 167bool_option("print-data", default=True, 168 help="Don't print result data in trace output") 169bool_option("print-iregs", default=False, 170 help="Print fetch sequence numbers in trace output") 171bool_option("print-fetch-seq", default=False, 172 help="Print fetch sequence numbers in trace output") 173bool_option("print-cpseq", default=False, 174 help="Print correct path sequence numbers in trace output") 175#bool_option("print-reg-delta", default=False, 176# help="Print which registers changed to what in trace output") 177bool_option("legion-lock", default=False, 178 help="Compare simulator state with Legion simulator every cycle") 179 180options = attrdict() 181arguments = [] 182 183def usage(exitcode=None): 184 parser.print_help() 185 if exitcode is not None: 186 sys.exit(exitcode) 187 188def parse_args(): 189 _opts,args = parser.parse_args() 190 opts = attrdict(_opts.__dict__) 191 192 # setting verbose and quiet at the same time doesn't make sense 193 if opts.verbose > 0 and opts.quiet > 0: 194 usage(2) 195 196 # store the verbosity in a single variable. 0 is default, 197 # negative numbers represent quiet and positive values indicate verbose 198 opts.verbose -= opts.quiet 199 200 del opts.quiet 201 202 options.update(opts) 203 arguments.extend(args) 204 return opts,args 205 206def main(): 207 import defines 208 import info 209 import internal 210 211 parse_args() 212 213 done = False 214 if options.copyright: 215 done = True 216 print info.LICENSE 217 print 218 219 if options.authors: 220 done = True 221 print 'Author information:' 222 print 223 print info.AUTHORS 224 print 225 226 if options.readme: 227 done = True 228 print 'Readme:' 229 print 230 print info.README 231 print 232 233 if options.release_notes: 234 done = True 235 print 'Release Notes:' 236 print 237 print info.RELEASE_NOTES 238 print 239 240 if done: 241 sys.exit(0) 242 243 if options.verbose >= 0: 244 print "M5 Simulator System" 245 print brief_copyright 246 print 247 print "M5 compiled %s" % internal.main.cvar.compileDate; 248 print "M5 started %s" % datetime.now().ctime() 249 print "M5 executing on %s" % socket.gethostname() 250 print "command line:", 251 for argv in sys.argv: 252 print argv, 253 print 254 255 # check to make sure we can find the listed script 256 if not arguments or not os.path.isfile(arguments[0]): 257 if arguments and not os.path.isfile(arguments[0]): 258 print "Script %s not found" % arguments[0] 259 usage(2) 260 261 # tell C++ about output directory 262 internal.main.setOutputDir(options.outdir) 263 264 # update the system path with elements from the -p option 265 sys.path[0:0] = options.path 266 267 import objects 268 269 # set stats options 270 objects.Statistics.text_file = options.stats_file 271 272 # set debugging options 273 for when in options.debug_break: 274 internal.debug.schedBreakCycle(int(when)) 275 276 for flag in options.trace_flags: 277 internal.trace.setFlag(flag) 278 279 if options.trace_start is not None: 280 internal.trace.enabled = False 281 def enable_trace(): 282 internal.event.enabled = True 283 internal.event.create(enable_trace, options.trace_start) 284
| 144add_option("--trace-ignore", metavar="EXPR", action='append', split=':', 145 help="Ignore EXPR sim objects") 146 147# Execution Trace options 148set_group("Execution Trace Options") 149bool_option("speculative", default=True, 150 help="Don't capture speculative instructions") 151bool_option("print-cycle", default=True, 152 help="Don't print cycle numbers in trace output") 153bool_option("print-symbol", default=True, 154 help="Disable PC symbols in trace output") 155bool_option("print-opclass", default=True, 156 help="Don't print op class type in trace output") 157bool_option("print-thread", default=True, 158 help="Don't print thread number in trace output") 159bool_option("print-effaddr", default=True, 160 help="Don't print effective address in trace output") 161bool_option("print-data", default=True, 162 help="Don't print result data in trace output") 163bool_option("print-iregs", default=False, 164 help="Print fetch sequence numbers in trace output") 165bool_option("print-fetch-seq", default=False, 166 help="Print fetch sequence numbers in trace output") 167bool_option("print-cpseq", default=False, 168 help="Print correct path sequence numbers in trace output") 169#bool_option("print-reg-delta", default=False, 170# help="Print which registers changed to what in trace output") 171bool_option("legion-lock", default=False, 172 help="Compare simulator state with Legion simulator every cycle") 173 174options = attrdict() 175arguments = [] 176 177def usage(exitcode=None): 178 parser.print_help() 179 if exitcode is not None: 180 sys.exit(exitcode) 181 182def parse_args(): 183 _opts,args = parser.parse_args() 184 opts = attrdict(_opts.__dict__) 185 186 # setting verbose and quiet at the same time doesn't make sense 187 if opts.verbose > 0 and opts.quiet > 0: 188 usage(2) 189 190 # store the verbosity in a single variable. 0 is default, 191 # negative numbers represent quiet and positive values indicate verbose 192 opts.verbose -= opts.quiet 193 194 del opts.quiet 195 196 options.update(opts) 197 arguments.extend(args) 198 return opts,args 199 200def main(): 201 import defines 202 import info 203 import internal 204 205 parse_args() 206 207 done = False 208 if options.copyright: 209 done = True 210 print info.LICENSE 211 print 212 213 if options.authors: 214 done = True 215 print 'Author information:' 216 print 217 print info.AUTHORS 218 print 219 220 if options.readme: 221 done = True 222 print 'Readme:' 223 print 224 print info.README 225 print 226 227 if options.release_notes: 228 done = True 229 print 'Release Notes:' 230 print 231 print info.RELEASE_NOTES 232 print 233 234 if done: 235 sys.exit(0) 236 237 if options.verbose >= 0: 238 print "M5 Simulator System" 239 print brief_copyright 240 print 241 print "M5 compiled %s" % internal.main.cvar.compileDate; 242 print "M5 started %s" % datetime.now().ctime() 243 print "M5 executing on %s" % socket.gethostname() 244 print "command line:", 245 for argv in sys.argv: 246 print argv, 247 print 248 249 # check to make sure we can find the listed script 250 if not arguments or not os.path.isfile(arguments[0]): 251 if arguments and not os.path.isfile(arguments[0]): 252 print "Script %s not found" % arguments[0] 253 usage(2) 254 255 # tell C++ about output directory 256 internal.main.setOutputDir(options.outdir) 257 258 # update the system path with elements from the -p option 259 sys.path[0:0] = options.path 260 261 import objects 262 263 # set stats options 264 objects.Statistics.text_file = options.stats_file 265 266 # set debugging options 267 for when in options.debug_break: 268 internal.debug.schedBreakCycle(int(when)) 269 270 for flag in options.trace_flags: 271 internal.trace.setFlag(flag) 272 273 if options.trace_start is not None: 274 internal.trace.enabled = False 275 def enable_trace(): 276 internal.event.enabled = True 277 internal.event.create(enable_trace, options.trace_start) 278
|