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