gem5  v22.1.0.0
multi.hh
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2019-2020 Inria
3  * All rights reserved.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions are
7  * met: redistributions of source code must retain the above copyright
8  * notice, this list of conditions and the following disclaimer;
9  * redistributions in binary form must reproduce the above copyright
10  * notice, this list of conditions and the following disclaimer in the
11  * documentation and/or other materials provided with the distribution;
12  * neither the name of the copyright holders nor the names of its
13  * contributors may be used to endorse or promote products derived from
14  * this software without specific prior written permission.
15  *
16  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
17  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
18  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
19  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
20  * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
21  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
22  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
23  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
24  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
25  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
26  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
27  */
28 
34 #ifndef __MEM_CACHE_COMPRESSORS_MULTI_HH__
35 #define __MEM_CACHE_COMPRESSORS_MULTI_HH__
36 
37 #include <cstdint>
38 #include <vector>
39 
40 #include "base/statistics.hh"
41 #include "base/types.hh"
43 
44 namespace gem5
45 {
46 
47 struct MultiCompressorParams;
48 
49 GEM5_DEPRECATED_NAMESPACE(Compressor, compression);
50 namespace compression
51 {
52 
53 class Multi : public Base
54 {
55  protected:
61  class MultiCompData;
62 
65 
81  const std::size_t numEncodingBits;
82 
89 
90  struct MultiStats : public statistics::Group
91  {
92  const Multi& compressor;
93 
94  MultiStats(BaseStats &base_group, Multi& _compressor);
95 
96  void regStats() override;
97 
103 
104  public:
105  typedef MultiCompressorParams Params;
106  Multi(const Params &p);
107  ~Multi();
108 
109  void setCache(BaseCache *_cache) override;
110 
111  std::unique_ptr<Base::CompressionData> compress(
112  const std::vector<Base::Chunk>& chunks,
113  Cycles& comp_lat, Cycles& decomp_lat) override;
114 
115  void decompress(const CompressionData* comp_data, uint64_t* data) override;
116 };
117 
119 {
120  private:
122  const uint8_t index;
123 
124  public:
126  std::unique_ptr<Base::CompressionData> compData;
127 
134  MultiCompData(unsigned index,
135  std::unique_ptr<Base::CompressionData> comp_data);
136 
138  ~MultiCompData() = default;
139 
141  uint8_t getIndex() const;
142 };
143 
144 } // namespace compression
145 } // namespace gem5
146 
147 #endif //__MEM_CACHE_COMPRESSORS_MULTI_HH__
Defines global host-dependent types: Counter, Tick, and (indirectly) {int,uint}{8,...
const char data[]
A basic cache interface.
Definition: base.hh:96
Cycles is a wrapper class for representing cycle counts, i.e.
Definition: types.hh:79
Base cache compressor interface.
Definition: base.hh:66
BaseCacheCompressorParams Params
Definition: base.hh:202
friend class Multi
This compressor must be able to access the protected functions of its sub-compressors.
Definition: base.hh:89
~MultiCompData()=default
Default destructor.
const uint8_t index
Index of the compressor that provided these compression results.
Definition: multi.hh:122
uint8_t getIndex() const
Get the index of the best compressor.
Definition: multi.cc:60
MultiCompData(unsigned index, std::unique_ptr< Base::CompressionData > comp_data)
Default constructor.
Definition: multi.cc:52
std::unique_ptr< Base::CompressionData > compData
Compression data of the best compressor.
Definition: multi.hh:126
void setCache(BaseCache *_cache) override
The cache can only be set once.
Definition: multi.cc:82
const std::size_t numEncodingBits
An encoding is associated to each sub-compressor to inform which sub-compressor to use when decompres...
Definition: multi.hh:81
MultiCompressorParams Params
Definition: multi.hh:105
std::vector< Base * > compressors
List of sub-compressors.
Definition: multi.hh:61
std::unique_ptr< Base::CompressionData > compress(const std::vector< Base::Chunk > &chunks, Cycles &comp_lat, Cycles &decomp_lat) override
Apply the compression process to the cache line.
Definition: multi.cc:91
gem5::compression::Multi::MultiStats multiStats
void decompress(const CompressionData *comp_data, uint64_t *data) override
Apply the decompression process to the compressed data.
Definition: multi.cc:185
const Cycles extraDecompressionLatency
Extra decompression latency to be added to the sub-compressor's decompression latency.
Definition: multi.hh:88
Statistics container.
Definition: group.hh:94
A 2-Dimensional vecto of scalar stats.
Definition: statistics.hh:2059
STL vector class.
Definition: stl.hh:37
Definition of a basic cache compressor.
Bitfield< 54 > p
Definition: pagetable.hh:70
Reference material can be found at the JEDEC website: UFS standard http://www.jedec....
GEM5_DEPRECATED_NAMESPACE(GuestABI, guest_abi)
Declaration of Statistics objects.
void regStats() override
Callback to set stat parameters.
Definition: multi.cc:202
MultiStats(BaseStats &base_group, Multi &_compressor)
Definition: multi.cc:194
statistics::Vector2d ranks
Number of times each compressor provided the nth best compression.
Definition: multi.hh:101

Generated on Wed Dec 21 2022 10:22:36 for gem5 by doxygen 1.9.1