base/traceflags.py

   1 #!/usr/bin/env python
   2
   3 # Copyright (c) 2004 The Regents of The University of Michigan
   4 # All rights reserved.
   5 #
   6 # Redistribution and use in source and binary forms, with or without
   7 # modification, are permitted provided that the following conditions are
   8 # met: redistributions of source code must retain the above copyright
   9 # notice, this list of conditions and the following disclaimer;
  10 # redistributions in binary form must reproduce the above copyright
  11 # notice, this list of conditions and the following disclaimer in the
  12 # documentation and/or other materials provided with the distribution;
  13 # neither the name of the copyright holders nor the names of its
  14 # contributors may be used to endorse or promote products derived from
  15 # this software without specific prior written permission.
  16 #
  17 # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  18 # "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  19 # LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
  20 # A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
  21 # OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  22 # SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  23 # LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  24 # DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  25 # THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  26 # (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  27 # OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  28
  29 #
  30 # This file generates the header and source files for the flags
  31 # that control the tracing facility.
  32 #
  33 hhfilename="traceflags.hh"
  34 ccfilename="traceflags.cc"
  35
  36 #
  37 # The list of trace flags that can be used to condition DPRINTFs etc.
  38 # To define a new flag, simply add it to this list.
  39 #
  40 baseFlags = [
  41     'TCPIP',
  42     'Bus',
  43     'ScsiDisk',
  44     'ScsiCtrl',
  45     'ScsiNone',
  46     'DMA',
  47     'DMAReadVerbose',
  48     'DMAWriteVerbose',
  49     'TLB',
  50     'SimpleDisk',
  51     'SimpleDiskData',
  52     'Clock',
  53     'Regs',
  54     'MC146818',
  55     'IPI',
  56     'Timer',
  57     'Mbox',
  58     'PCIA',
  59     'PCIDEV',
  60     'ISP',
  61     'BADADDR',
  62     'Console',
  63     'ConsolePoll',
  64     'ConsoleVerbose',
  65     'TlaserUart',
  66     'AlphaConsole',
  67     'Flow',
  68     'Interrupt',
  69     'Cycle',
  70     'Loader',
  71     'MMU',
  72     'Ethernet',
  73     'EthernetPIO',
  74     'EthernetDMA',
  75     'EthernetData',
  76     'GDBMisc',
  77     'GDBAcc',
  78     'GDBRead',
  79     'GDBWrite',
  80     'GDBSend',
  81     'GDBRecv',
  82     'GDBExtra',
  83     'VtoPhys',
  84     'Printf',
  85     'DebugPrintf',
  86     'Serialize',
  87     'Event',
  88     'PCEvent',
  89     'SyscallWarnings',
  90     'SyscallVerbose',
  91     'DiskImage',
  92     'DiskImageRead',
  93     'DiskImageWrite',
  94     'InstExec',
  95     'BPredRAS',
  96     'Cache',
  97     'IIC',
  98     'IICMore',
  99     'MSHR',
 100     'Chains',
 101     'Dispatch',
 102     'Stats',
 103     'Context',
 104     'Config',
 105     'Sampler',
 106     'WriteBarrier'
 107     ]
 108
 109 #
 110 # "Compound" flags correspond to a set of base flags.  These exist
 111 # solely for convenience in setting them via the command line: if a
 112 # compound flag is specified, all of the corresponding base flags are
 113 # set.  Compound flags cannot be used directly in DPRINTFs etc.
 114 # To define a new compound flag, add a new entry to this hash
 115 # following the existing examples.
 116 #
 117 compoundFlagMap = {
 118     'GDBAll' : [ 'GDBMisc', 'GDBAcc', 'GDBRead', 'GDBWrite', 'GDBSend', 'GDBRecv', 'GDBExtra' ],
 119     'ScsiAll' : [ 'ScsiDisk', 'ScsiCtrl', 'ScsiNone' ],
 120     'DiskImageAll' : [ 'DiskImage', 'DiskImageRead', 'DiskImageWrite' ],
 121     'EthernetAll' : [ 'Ethernet', 'EthernetPIO', 'EthernetDMA', 'EthernetData' ]
 122 }
 123
 124 #############################################################
 125 #
 126 # Everything below this point generates the appropriate C++
 127 # declarations and definitions for the trace flags.  If you are simply
 128 # adding or modifying flag definitions, you should not have to change
 129 # anything below.
 130 #
 131
 132 import sys
 133
 134 # extract just the compound flag names into a list
 135 compoundFlags = []
 136 compoundFlags.extend(compoundFlagMap.keys())
 137 compoundFlags.sort()
 138
 139 #
 140 # First generate the header file.  This defines the Flag enum
 141 # and some extern declarations for the .cc file.
 142 #
 143 try:
 144     hhfile = file(hhfilename, 'w')
 145 except IOError, e:
 146     sys.exit("can't open %s: %s" % (hhfilename, e))
 147
 148 # file header boilerplate
 149 print >>hhfile, '''/* $Id $ */
 150
 151 /*
 152  * Copyright (c) 2004
 153  * The Regents of The University of Michigan
 154  * All Rights Reserved
 155  *
 156  * This code is part of the M5 simulator, developed by Nathan Binkert,
 157  * Erik Hallnor, Steve Raasch, and Steve Reinhardt, with contributions
 158  * from Ron Dreslinski, Dave Greene, and Lisa Hsu.
 159  *
 160  * Permission is granted to use, copy, create derivative works and
 161  * redistribute this software and such derivative works for any
 162  * purpose, so long as the copyright notice above, this grant of
 163  * permission, and the disclaimer below appear in all copies made; and
 164  * so long as the name of The University of Michigan is not used in
 165  * any advertising or publicity pertaining to the use or distribution
 166  * of this software without specific, written prior authorization.
 167  *
 168  * THIS SOFTWARE IS PROVIDED AS IS, WITHOUT REPRESENTATION FROM THE
 169  * UNIVERSITY OF MICHIGAN AS TO ITS FITNESS FOR ANY PURPOSE, AND
 170  * WITHOUT WARRANTY BY THE UNIVERSITY OF MICHIGAN OF ANY KIND, EITHER
 171  * EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION THE IMPLIED
 172  * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
 173  * PURPOSE. THE REGENTS OF THE UNIVERSITY OF MICHIGAN SHALL NOT BE
 174  * LIABLE FOR ANY DAMAGES, INCLUDING DIRECT, SPECIAL, INDIRECT,
 175  * INCIDENTAL, OR CONSEQUENTIAL DAMAGES, WITH RESPECT TO ANY CLAIM
 176  * ARISING OUT OF OR IN CONNECTION WITH THE USE OF THE SOFTWARE, EVEN
 177  * IF IT HAS BEEN OR IS HEREAFTER ADVISED OF THE POSSIBILITY OF SUCH
 178  * DAMAGES.
 179  */
 180
 181 /*
 182  * DO NOT EDIT THIS FILE!
 183  *
 184  * Automatically generated from traceflags.py
 185  */
 186
 187 #ifndef __BASE_TRACE_FLAGS_HH__
 188 #define __BASE_TRACE_FLAGS_HH__
 189
 190 namespace Trace {
 191
 192 enum Flags {
 193 ''',
 194
 195 # Generate the enum.  Base flags come first, then compound flags.
 196 idx = 0
 197 for flag in baseFlags:
 198     print >>hhfile, '    %s = %d,' % (flag, idx)
 199     idx += 1
 200
 201 numBaseFlags = idx
 202 print >>hhfile, '    NumFlags = %d,' % idx
 203
 204 # put a comment in here to separate base from compound flags
 205 print >>hhfile, '''
 206     // The remaining enum values are *not* valid indices for Trace::flags.
 207     // They are "compound" flags, which correspond to sets of base
 208     // flags, and are used only by TraceParamContext::setFlags().
 209 ''',
 210
 211 for flag in compoundFlags:
 212     print >>hhfile, '    %s = %d,' % (flag, idx)
 213     idx += 1
 214
 215 numCompoundFlags = idx - numBaseFlags
 216 print >>hhfile, '    NumCompoundFlags = %d' % numCompoundFlags
 217
 218 # trailer boilerplate
 219 print >>hhfile, '''\
 220 }; // enum Flags
 221
 222 // Array of strings for SimpleEnumParam
 223 extern const char *flagStrings[];
 224 extern const int numFlagStrings;
 225
 226 // Array of arraay pointers: for each compound flag, gives the list of
 227 // base flags to set.  Inidividual flag arrays are terminated by -1.
 228 extern const Flags *compoundFlags[];
 229
 230 /* namespace Trace */ }
 231
 232 #endif // __BASE_TRACE_FLAGS_HH__
 233 ''',
 234
 235 hhfile.close()
 236
 237 #
 238 #
 239 # Print out .cc file with array definitions.
 240 #
 241 #
 242 try:
 243     ccfile = file(ccfilename, 'w')
 244 except OSError, e:
 245     sys.exit("can't open %s: %s" % (ccfilename, e))
 246
 247 # file header
 248 print >>ccfile, '''\
 249 /* $Id $ */
 250
 251 /*
 252  * Copyright (c) 2004
 253  * The Regents of The University of Michigan
 254  * All Rights Reserved
 255  *
 256  * This code is part of the M5 simulator, developed by Nathan Binkert,
 257  * Erik Hallnor, Steve Raasch, and Steve Reinhardt, with contributions
 258  * from Ron Dreslinski, Dave Greene, and Lisa Hsu.
 259  *
 260  * Permission is granted to use, copy, create derivative works and
 261  * redistribute this software and such derivative works for any
 262  * purpose, so long as the copyright notice above, this grant of
 263  * permission, and the disclaimer below appear in all copies made; and
 264  * so long as the name of The University of Michigan is not used in
 265  * any advertising or publicity pertaining to the use or distribution
 266  * of this software without specific, written prior authorization.
 267  *
 268  * THIS SOFTWARE IS PROVIDED AS IS, WITHOUT REPRESENTATION FROM THE
 269  * UNIVERSITY OF MICHIGAN AS TO ITS FITNESS FOR ANY PURPOSE, AND
 270  * WITHOUT WARRANTY BY THE UNIVERSITY OF MICHIGAN OF ANY KIND, EITHER
 271  * EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION THE IMPLIED
 272  * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
 273  * PURPOSE. THE REGENTS OF THE UNIVERSITY OF MICHIGAN SHALL NOT BE
 274  * LIABLE FOR ANY DAMAGES, INCLUDING DIRECT, SPECIAL, INDIRECT,
 275  * INCIDENTAL, OR CONSEQUENTIAL DAMAGES, WITH RESPECT TO ANY CLAIM
 276  * ARISING OUT OF OR IN CONNECTION WITH THE USE OF THE SOFTWARE, EVEN
 277  * IF IT HAS BEEN OR IS HEREAFTER ADVISED OF THE POSSIBILITY OF SUCH
 278  * DAMAGES.
 279  */
 280
 281 /*
 282  * DO NOT EDIT THIS FILE!
 283  *
 284  * Automatically generated from traceflags.pl.
 285  */
 286
 287 #include "base/traceflags.hh"
 288
 289 using namespace Trace;
 290
 291 const char *Trace::flagStrings[] =
 292 {
 293 ''',
 294
 295 # The string array is used by SimpleEnumParam to map the strings
 296 # provided by the user to enum values.
 297 for flag in baseFlags:
 298     print >>ccfile, '    "%s",' % flag
 299
 300 for flag in compoundFlags:
 301     print >>ccfile, '    "%s",' % flag
 302
 303 print >>ccfile, '};\n'
 304
 305 numFlagStrings = len(baseFlags) + len(compoundFlags);
 306
 307 print >>ccfile, 'const int Trace::numFlagStrings = %d;' % numFlagStrings
 308 print >>ccfile
 309
 310 #
 311 # Now define the individual compound flag arrays.  There is an array
 312 # for each compound flag listing the component base flags.
 313 #
 314
 315 for flag in compoundFlags:
 316     flags = compoundFlagMap[flag]
 317     flags.append('(Flags)-1')
 318     print >>ccfile, 'static const Flags %sMap[] =' % flag
 319     print >>ccfile, '{ %s };' % (', '.join(flags))
 320     print >>ccfile
 321
 322 #
 323 # Finally the compoundFlags[] array maps the compound flags
 324 # to their individual arrays/
 325 #
 326 print >>ccfile, 'const Flags *Trace::compoundFlags[] ='
 327 print >>ccfile, '{'
 328
 329 for flag in compoundFlags:
 330     print >>ccfile, '    %sMap,' % flag
 331
 332 # file trailer
 333 print >>ccfile, '};'
 334
 335 ccfile.close()
 336