The compressed data is composed of multiple pattern entries. More...

#include <dictionary_compressor.hh>

Inheritance diagram for gem5::compression::DictionaryCompressor< T >::Pattern:

Public Member Functions
	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.

virtual DictionaryEntry	decompress (const DictionaryEntry dict_bytes) const =0
	Decompress the pattern.

Protected Attributes
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>
class gem5::compression::DictionaryCompressor< T >::Pattern

The compressed data is composed of multiple pattern entries.

To add a new pattern one should inherit from this class and implement isPattern() and decompress(). Then the new pattern must be added to the PatternFactory declaration in crescent order of size (in the DictionaryCompressor class).

Definition at line 285 of file dictionary_compressor.hh.

Constructor & Destructor Documentation

◆ Pattern()

template<class T >

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 )

inline

Default constructor.

Parameters

number	Pattern number.
code	Code associated to this pattern.
metadata_length	Length, in bits, of the code and match location.
num_unmatched_bits	Number of unmatched bits.
match_location	Index of the match location.

Definition at line 316 of file dictionary_compressor.hh.

◆ ~Pattern()

template<class T >

virtual gem5::compression::DictionaryCompressor< T >::Pattern::~Pattern ( )

virtualdefault

Default destructor.

Member Function Documentation

◆ decompress()

template<class T >

virtual DictionaryEntry gem5::compression::DictionaryCompressor< T >::Pattern::decompress ( const DictionaryEntry dict_bytes ) const

pure virtual

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.

Implemented in gem5::compression::DictionaryCompressor< T >::DeltaPattern< DeltaSizeBits >, gem5::compression::DictionaryCompressor< T >::MaskedPattern< mask >, gem5::compression::DictionaryCompressor< T >::MaskedValuePattern< value, mask >, gem5::compression::DictionaryCompressor< T >::MaskedValuePattern< 0, 0xFFFFFFFFFFFFFFFF >, gem5::compression::DictionaryCompressor< T >::RepeatedValuePattern< RepT >, gem5::compression::DictionaryCompressor< T >::SignExtendedPattern< N >, and gem5::compression::DictionaryCompressor< T >::UncompressedPattern.

Referenced by gem5::compression::DictionaryCompressor< T >::decompressValue().

◆ getCode()

template<class T >

uint8_t gem5::compression::DictionaryCompressor< T >::Pattern::getCode ( ) const

inline

Get code of this pattern.

Returns: The code.

Definition at line 340 of file dictionary_compressor.hh.

◆ getMatchLocation()

template<class T >

uint8_t gem5::compression::DictionaryCompressor< T >::Pattern::getMatchLocation ( ) const

inline

Get the index of the dictionary match location.

Returns: The index of the match location.

Definition at line 347 of file dictionary_compressor.hh.

Referenced by gem5::compression::DictionaryCompressor< T >::decompressValue().

◆ getPatternNumber()

template<class T >

int gem5::compression::DictionaryCompressor< T >::Pattern::getPatternNumber ( ) const

inline

Get enum number associated to this pattern.

Returns: The pattern enum number.

Definition at line 333 of file dictionary_compressor.hh.

◆ getSizeBits()

template<class T >

virtual std::size_t gem5::compression::DictionaryCompressor< T >::Pattern::getSizeBits ( ) const

inlinevirtual

Get size, in bits, of the pattern (excluding prefix).

Corresponds to unmatched_data_size + code_length.

Returns: The size.

Definition at line 356 of file dictionary_compressor.hh.

◆ print()

template<class T >

std::string gem5::compression::DictionaryCompressor< T >::Pattern::print ( ) const

inline

Extract pattern's information to a string.

Returns: A string containing the relevant pattern metadata.

Definition at line 374 of file dictionary_compressor.hh.

References gem5::csprintf().

◆ shouldAllocate()

template<class T >

bool gem5::compression::DictionaryCompressor< T >::Pattern::shouldAllocate ( ) const

inline

Determine if pattern allocates a dictionary entry.

Returns: True if should allocate a dictionary entry.

protected

Pattern enum number.

Definition at line 289 of file dictionary_compressor.hh.

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

mem/cache/compressors/dictionary_compressor.hh

Public Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ Pattern()

◆ ~Pattern()

Member Function Documentation

◆ decompress()

◆ getCode()

◆ getMatchLocation()

◆ getPatternNumber()

◆ getSizeBits()

◆ print()

◆ shouldAllocate()

Member Data Documentation

◆ allocate

◆ code

◆ length

◆ matchLocation

◆ numUnmatchedBits

◆ patternNumber