src/python/m5/debug.py

   1 # Copyright (c) 2008 The Hewlett-Packard Development Company
   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
  29 from UserDict import DictMixin
  30
  31 import _m5.debug
  32 from _m5.debug import SimpleFlag, CompoundFlag
  33 from _m5.debug import schedBreak, setRemoteGDBPort
  34 from m5.util import printList
  35
  36 def help():
  37     print "Base Flags:"
  38     for name in sorted(flags):
  39         if name == 'All':
  40             continue
  41         flag = flags[name]
  42         children = [c for c in flag.kids() ]
  43         if not children:
  44             print "    %s: %s" % (name, flag.desc())
  45     print
  46     print "Compound Flags:"
  47     for name in sorted(flags):
  48         if name == 'All':
  49             continue
  50         flag = flags[name]
  51         children = [c for c in flag.kids() ]
  52         if children:
  53             print "    %s: %s" % (name, flag.desc())
  54             printList([ c.name() for c in children ], indent=8)
  55     print
  56
  57 class AllFlags(DictMixin):
  58     def __init__(self):
  59         self._version = -1
  60         self._dict = {}
  61
  62     def _update(self):
  63         current_version = _m5.debug.getAllFlagsVersion()
  64         if self._version == current_version:
  65             return
  66
  67         self._dict.clear()
  68         for name, flag in _m5.debug.allFlags().items():
  69             self._dict[name] = flag
  70         self._version = current_version
  71
  72     def __contains__(self, item):
  73         self._update()
  74         return item in self._dict
  75
  76     def __getitem__(self, item):
  77         self._update()
  78         return self._dict[item]
  79
  80     def keys(self):
  81         self._update()
  82         return self._dict.keys()
  83
  84     def values(self):
  85         self._update()
  86         return self._dict.values()
  87
  88     def items(self):
  89         self._update()
  90         return self._dict.items()
  91
  92     def iterkeys(self):
  93         self._update()
  94         return self._dict.iterkeys()
  95
  96     def itervalues(self):
  97         self._update()
  98         return self._dict.itervalues()
  99
 100     def iteritems(self):
 101         self._update()
 102         return self._dict.iteritems()
 103
 104 flags = AllFlags()