debug.py revision 11802:be62996c95d1 
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
29from UserDict import DictMixin
30
31import _m5.debug
32from _m5.debug import SimpleFlag, CompoundFlag
33from _m5.debug import schedBreak, setRemoteGDBPort
34from m5.util import printList
35
36def 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
57class 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 flag in _m5.debug.getAllFlags():
69            self._dict[flag.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
104flags = AllFlags()
105