gem5::compression::DictionaryCompressor< T >::MaskedValuePattern< value, mask > Class Template Reference

A pattern that compares masked values to a masked portion of a fixed value. More...

#include <dictionary_compressor.hh>

Inheritance diagram for gem5::compression::DictionaryCompressor< T >::MaskedValuePattern< value, mask >:

Public Member Functions
	MaskedValuePattern (const int number, const uint64_t code, const uint64_t metadata_length, const int match_location, const DictionaryEntry bytes, const bool allocate=false)
DictionaryEntry	decompress (const DictionaryEntry dict_bytes) const override
	Decompress the pattern.
Public Member Functions inherited from gem5::compression::DictionaryCompressor< T >::MaskedPattern< mask >
	MaskedPattern (const int number, const uint64_t code, const uint64_t metadata_length, const int match_location, const DictionaryEntry bytes, const bool allocate=true)
Public Member Functions inherited from gem5::compression::DictionaryCompressor< T >::Pattern
	Pattern (const int number, const uint64_t code, const uint64_t metadata_length, const uint64_t num_unmatched_bits, const int match_location, const bool allocate=true)
	Default constructor.
virtual	~Pattern ()=default
	Default destructor.
int	getPatternNumber () const
	Get enum number associated to this pattern.
uint8_t	getCode () const
	Get code of this pattern.
uint8_t	getMatchLocation () const
	Get the index of the dictionary match location.
virtual std::size_t	getSizeBits () const
	Get size, in bits, of the pattern (excluding prefix).
bool	shouldAllocate () const
	Determine if pattern allocates a dictionary entry.
std::string	print () const
	Extract pattern's information to a string.

Static Public Member Functions
static bool	isPattern (const DictionaryEntry &bytes, const DictionaryEntry &dict_bytes, const int match_location)
Static Public Member Functions inherited from gem5::compression::DictionaryCompressor< T >::MaskedPattern< mask >
static bool	isPattern (const DictionaryEntry &bytes, const DictionaryEntry &dict_bytes, const int match_location)

Additional Inherited Members
Protected Attributes inherited from gem5::compression::DictionaryCompressor< T >::Pattern
const int	patternNumber
	Pattern enum number.
const uint8_t	code
	Code associated to the pattern.
const uint8_t	length
	Length, in bits, of the code and match location.
const uint8_t	numUnmatchedBits
	Number of unmatched bits.
const int	matchLocation
	Index representing the the match location.
const bool	allocate
	Wether the pattern allocates a dictionary entry or not.

Detailed Description

template<class T>
template<T value, T mask>
class gem5::compression::DictionaryCompressor< T >::MaskedValuePattern< value, mask >

A pattern that compares masked values to a masked portion of a fixed value.

If all the masked bits match the provided non-dictionary value, there is a pattern match.

For example, assume the mask is 0xFF00 (that is, this pattern matches the MSB), and we are searching for data containing only ones (i.e., the fixed value is 0xFFFF). If the value (V) 0xFF20 is being compressed, this is a match (V & mask == 0xFF00 == 0xFFFF & mask), and 0x20 is added to the list of unmatched bits. If the value (V2) 0x0120 is being compressed, this is not a match ((V2 & mask == 0x0100) != (0xFF00 == 0xFFFF & mask).

Template Parameters

value	The value that is being matched against.
mask	A mask containing the bits that must match the given value.

Definition at line 525 of file dictionary_compressor.hh.

Constructor & Destructor Documentation

MaskedValuePattern()

template<class T >

template<T value, T mask>

gem5::compression::DictionaryCompressor< T >::MaskedValuePattern< value, mask >::MaskedValuePattern ( const int number, const uint64_t code, const uint64_t metadata_length, const int match_location, const DictionaryEntry bytes, const bool allocate = false )

inline

Definition at line 532 of file dictionary_compressor.hh.

Member Function Documentation

decompress()

template<class T >

template<T value, T mask>

DictionaryEntry gem5::compression::DictionaryCompressor< T >::MaskedValuePattern< value, mask >::decompress ( const DictionaryEntry dict_bytes ) const

inlineoverridevirtual

Decompress the pattern.

Each pattern has its own way of interpreting its data.

Parameters

dict_bytes

The bytes in the corresponding matching entry.

Returns

The decompressed pattern.

Reimplemented from gem5::compression::DictionaryCompressor< T >::MaskedPattern< mask >.

Definition at line 556 of file dictionary_compressor.hh.

References gem5::compression::DictionaryCompressor< T >::MaskedPattern< mask >::decompress().

isPattern()

template<class T >

template<T value, T mask>

static bool gem5::compression::DictionaryCompressor< T >::MaskedValuePattern< value, mask >::isPattern ( const DictionaryEntry & bytes, const DictionaryEntry & dict_bytes, const int match_location )

inlinestatic

Definition at line 544 of file dictionary_compressor.hh.

References gem5::compression::DictionaryCompressor< T >::fromDictionaryEntry(), and gem5::ArmISA::mask.

---

The documentation for this class was generated from the following file:

• mem/cache/compressors/dictionary_compressor.hh