gem5  v20.1.0.0
group.hh
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2019, 2020 Arm Limited
3  * All rights reserved
4  *
5  * The license below extends only to copyright in the software and shall
6  * not be construed as granting a license to any other intellectual
7  * property including but not limited to intellectual property relating
8  * to a hardware implementation of the functionality of the software
9  * licensed hereunder. You may use the software subject to the license
10  * terms below provided that you ensure that this notice is replicated
11  * unmodified and in its entirety in all distributions of the software,
12  * modified or unmodified, in source code or in binary form.
13  *
14  * Redistribution and use in source and binary forms, with or without
15  * modification, are permitted provided that the following conditions are
16  * met: redistributions of source code must retain the above copyright
17  * notice, this list of conditions and the following disclaimer;
18  * redistributions in binary form must reproduce the above copyright
19  * notice, this list of conditions and the following disclaimer in the
20  * documentation and/or other materials provided with the distribution;
21  * neither the name of the copyright holders nor the names of its
22  * contributors may be used to endorse or promote products derived from
23  * this software without specific prior written permission.
24  *
25  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
26  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
27  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
28  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
29  * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
30  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
31  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
32  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
33  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
34  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
35  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
36  */
37 
38 #ifndef __BASE_STATS_GROUP_HH__
39 #define __BASE_STATS_GROUP_HH__
40 
41 #include <map>
42 #include <vector>
43 #include <string>
44 
67 #define ADD_STAT(n, ...) n(this, # n, __VA_ARGS__)
68 
69 namespace Stats {
70 
71 class Info;
72 
83 class Group
84 {
85  public:
90  Group() = delete;
91  Group(const Group &) = delete;
92  Group &operator=(const Group &) = delete; //end of api_stats
94 
115  Group(Group *parent, const char *name = nullptr);
116 
117  virtual ~Group();
118 
130  virtual void regStats();
131 
137  virtual void resetStats();
138 
146  virtual void preDumpStats();
147 
154  void addStat(Stats::Info *info);
155 
161  const std::map<std::string, Group *> &getStatGroups() const;
162 
168  const std::vector<Info *> &getStats() const;
169 
179  void addStatGroup(const char *name, Group *block);
180 
195  const Info * resolveStat(std::string name) const;
196 
197  private:
204  void mergeStatGroup(Group *block);
205 
206  private:
209 
210  std::map<std::string, Group *> statGroups;
213 };
214 
215 } // namespace Stats
216 
217 #endif // __BASE_STATS_GROUP_HH__
Stats::Group::regStats
virtual void regStats()
Callback to set stat parameters.
Definition: group.cc:64
Stats::Group::mergedParent
Group *const mergedParent
Parent pointer if merged into parent.
Definition: group.hh:208
Stats::Group::getStatGroups
const std::map< std::string, Group * > & getStatGroups() const
Get all child groups associated with this object.
Definition: group.cc:159
Stats::Group::Group
Group()=delete
Stats::Group::preDumpStats
virtual void preDumpStats()
Callback before stats are dumped.
Definition: group.cc:95
std::vector
STL vector class.
Definition: stl.hh:37
Stats::Group::operator=
Group & operator=(const Group &)=delete
Stats::Group::mergedStatGroups
std::vector< Group * > mergedStatGroups
Definition: group.hh:211
Stats::Group::resetStats
virtual void resetStats()
Callback to reset stats.
Definition: group.cc:82
Stats::Group::resolveStat
const Info * resolveStat(std::string name) const
Resolve a stat by its name within this group.
Definition: group.cc:121
Stats::Group::stats
std::vector< Info * > stats
Definition: group.hh:212
name
const std::string & name()
Definition: trace.cc:50
Stats::Group::statGroups
std::map< std::string, Group * > statGroups
Definition: group.hh:210
Stats::Info
Definition: info.hh:69
Stats::Group::~Group
virtual ~Group()
Definition: group.cc:59
Stats::Group::mergeStatGroup
void mergeStatGroup(Group *block)
Merge the contents (stats & children) of a block to this block.
Definition: group.cc:153
Stats::Group::getStats
const std::vector< Info * > & getStats() const
Get all stats associated with this object.
Definition: group.cc:165
Stats::Group
Statistics container.
Definition: group.hh:83
Stats
Definition: statistics.cc:61
Stats::Group::addStat
void addStat(Stats::Info *info)
Register a stat with this group.
Definition: group.cc:105
Stats::Group::addStatGroup
void addStatGroup(const char *name, Group *block)
Add a stat block as a child of this block.
Definition: group.cc:113

Generated on Wed Sep 30 2020 14:02:08 for gem5 by doxygen 1.8.17