This processor is a trivial manager of instruction cache for IPET approach. More...

#include <otawa/ipet/TrivialInstCacheManager.h>

Inheritance diagram for otawa::ipet::TrivialInstCacheManager:

Public Types
enum	log_level_t { LOG_NONE = 0, LOG_PROC = 1, LOG_FILE = 2, LOG_DEPS = LOG_FILE, LOG_FUN = 3, LOG_CFG = LOG_FUN, LOG_BLOCK = 4, LOG_BB = LOG_BLOCK, LOG_INST = 5 }

typedef enum otawa::Monitor::log_level_t	log_level_t

Public Member Functions
	TrivialInstCacheManager (void)

virtual void	configure (const PropList &props)
	Configure the current processor. More...

elm::String	name (void) const

elm::Version	version (void) const

void	process (WorkSpace *ws, const PropList &props=PropList::EMPTY)
	Execute the code processor on the given framework. More...

WorkSpace *	workspace (void)
	Get the current workspace. More...

bool	isVerbose (void) const
	Test if the verbosity is activated. More...

bool	logFor (log_level_t tested) const
	Test if the given log level is activated or not. More...

log_level_t	logLevel (void) const

Public Attributes
elm::io::Output	out
	Provide a stream to perform output for the user. More...

elm::io::Output	log
	Provide a stream to perform log output. More...

Static Public Attributes
static MetaRegistration	reg

static Identifier< PropList * >	STATS
	This property identifiers is used to pass a property list to the processor that will be used to store statistics about the performed work. More...

static Identifier< bool >	TIMED
	If the value of the associated property is true (default to false), time statistics will also be collected with other processor statistics. More...

static Identifier< bool >	RECURSIVE

static Identifier< Progress * >	PROGRESS
	Install. More...

static Identifier< bool >	COLLECT_STATS
	This property allows to activate collection of statistics for the work of the current processor. More...

static Identifier < elm::io::OutStream * > &	OUTPUT = otawa::OUTPUT
	This property identifier is used for setting the output stream used by the processor to write results. More...

static Identifier < elm::io::OutStream * > &	LOG = otawa::LOG
	This property identifier is used for setting the log stream used by the processor to write messages (information, warning, error). More...

static Identifier< bool > &	VERBOSE = otawa::VERBOSE
	This property activates the verbose mode of the processor: information about the processor work will be displayed. More...

static Identifier< log_level_t > &	LOG_LEVEL = otawa::LOG_LEVEL
	Property passed in the configuration property list of a processor to select the log level between LOG_PROC, LOG_CFG or LOG_BB. More...

static Identifier < elm::system::time_t >	RUNTIME
	This property identifier is used to store in the statistics of a processor the overall run time of the processor work. More...

static Monitor &	null = __null_mon
	Monitor that output nothing. More...

Protected Member Functions
virtual void	setup (WorkSpace *ws)
	This method is called before an anlysis to let the processor do some initialization. More...

virtual void	cleanup (WorkSpace *ws)
	This method is called after the end of the processor analysis to let it do some clean up. More...

virtual void	processBB (WorkSpace ws, CFG cfg, BasicBlock *bb)
	Perform the work of the given basic block. More...

virtual void	processCFG (WorkSpace ws, CFG cfg)
	See CFGProcessor::processCFG() More...

virtual void	cleanupCFG (WorkSpace ws, CFG cfg)
	This function may be overridden by a subclass to provide custom cleanup for a CFG. More...

virtual void	cleanupBB (WorkSpace ws, CFG cfg, BasicBlock *bb)
	When the function doCleanup() is called, this function is called for each basic block of the task. More...

template<class T >
void	trackBB (const AbstractFeature &feature, const Identifier< T * > &id)
	Track and delete the content of the given identifier on each basic block. More...

template<class T >
void	trackBB (const AbstractFeature &feature, const Identifier< T > &id)
	Track and remove properties put on basic blocks. More...

virtual void	processWorkSpace (WorkSpace *fw)
	Process the given framework. More...

void	doCleanUp (void)
	Trigger associated with CFG. More...

string	str (const Address &address)
	Transform an address to a smart string, that is, if a source line is available, transform it to "source_file:source_line", if the CFG has a label, it gives "label + 0xoffset", else return the address. More...

string	str (const Address &base, const Address &address)
	Transform an address to a smart string, that is, if a source line is available, transform it to "source_file:source_line", if the CFG has a label, it gives "label + 0xoffset", else return the address. More...

CFG *	cfg (void) const
	Get the current CFG. More...

bool	isTimed (void) const
	Test if the timed mode is activated (recording of timings in the statistics). More...

bool	recordsStats (void) const
	Test if the statictics mode is activated. More...

bool	isAllocated (void) const

bool	isPrepared (void) const

bool	isCollectingStats (void) const

void	require (const AbstractFeature &feature)
	Usually called from a processor constructor, this method records a required feature for the work of the current processor. More...

void	provide (const AbstractFeature &feature)
	Usually called from a processor constructor, this method records a feature provided by the work of the current processor. More...

void	invalidate (const AbstractFeature &feature)
	Usually called from a processor constructor, this method records a feature invalidated by the work of the current processor. More...

void	use (const AbstractFeature &feature)
	Usually called from a processor constructor, this method records a feature as used by the work of the current processor. More...

void	warn (const String &message)
	Display a warning. More...

WorkSpace *	workspace (void) const
	Get the current workspace. More...

Progress &	progress (void)
	Get the current progress handler. More...

void	recordStat (const AbstractFeature &feature, StatCollector *collector)
	Add a statistics collector to the current workspace collection. More...

void	addCleaner (const AbstractFeature &feature, Cleaner *cleaner)
	Add a cleaner for the given feature. More...

template<class T >
void	addRemover (const AbstractFeature &feature, const Ref< T, Identifier< T > > &ref)

template<class T >
void	addDeletor (const AbstractFeature &feature, const Ref< T , Identifier< T > > &ref)

virtual void	prepare (WorkSpace *ws)
	This method called to let the processor customize its requirements according to some generic feature. More...

virtual void	collectStats (WorkSpace *ws)
	This method is invoked if the user has required to collect statistics about the processor. More...

virtual void	processFrameWork (WorkSpace *fw)
	Process the given workspace. More...

template<class T >
T *	track (const AbstractFeature &feature, T *object)

template<class T >
void	track (const AbstractFeature &feature, const Ref< T , Identifier< T > > &ref)
	Track the release of an allocated object assigned to an identifier relatively to the given feature. More...

template<class T >
void	track (const AbstractFeature &feature, const Ref< T , const Identifier< T > > &ref)
	Track the release of an allocated object assigned to an identifier relatively to the given feature. More...

virtual void	requireDyn (WorkSpace *ws, const PropList &props)
	Method called after registration requirements to support dynamic requirements. More...

void	setWorkspace (WorkSpace *workspace)
	Set the current workspace. More...

Protected Attributes
PropList *	stats

t::uint32	flags
	Contains various bit flags. More...

Static Protected Attributes
static const t::uint32	IS_TIMED = 0x01 << CUSTOM_SHIFT

static const t::uint32	IS_ALLOCATED = 0x04 << CUSTOM_SHIFT

static const t::uint32	IS_PREPARED = 0x08 << CUSTOM_SHIFT

static const t::uint32	IS_COLLECTING = 0x10 << CUSTOM_SHIFT

static const t::uint32	IS_VERBOSE = 0x01

static const t::uint32	CUSTOM_SHIFT = 16

Private Attributes
const hard::Cache *	cache

Detailed Description

This processor is a trivial manager of instruction cache for IPET approach.

Basically, it considers that each code line blocks causes a miss.

Provided Features

ipet::INST_CACHE_SUPPORT_FEATURE

Required Features

ipet::BB_TIME_FEATURE

Member Typedef Documentation

typedef enum otawa::Monitor::log_level_t otawa::Monitor::log_level_t

inherited

Member Enumeration Documentation

enum otawa::Monitor::log_level_t

inherited

Enumerator
LOG_NONE
LOG_PROC
LOG_FILE
LOG_DEPS
LOG_FUN
LOG_CFG
LOG_BLOCK
LOG_BB
LOG_INST

Constructor & Destructor Documentation

otawa::ipet::TrivialInstCacheManager::TrivialInstCacheManager ( void )

Member Function Documentation

void otawa::Processor::addCleaner	(	const AbstractFeature &	feature,
		Cleaner *	cleaner
	)

inlineprotectedinherited

Add a cleaner for the given feature.

A cleaner is an object with a virtual destructor that is called when the associated feature is removed: this let the processor to release and clean up the resources it allocated to implement the provided features.

Parameters

feature	Feature the cleaner apply to.
cleaner	Cleaner to add.

Referenced by otawa::DelayedBuilder::cleanup(), otawa::StackAnalysis::cleanup(), otawa::Dominance::processCFG(), otawa::CFGCollector::processWorkSpace(), otawa::clp::Analysis::processWorkSpace(), and otawa::Processor::recordStat().

template<class T >

void otawa::Processor::addDeletor	(	const AbstractFeature &	feature,
		const Ref< T , Identifier< T > > &	ref
	)

inlineprotectedinherited

Referenced by otawa::Virtualizer::cleanup().

template<class T >

void otawa::Processor::addRemover	(	const AbstractFeature &	feature,
		const Ref< T, Identifier< T > > &	ref
	)

inlineprotectedinherited

Referenced by otawa::Virtualizer::cleanup().

CFG * otawa::CFGProcessor::cfg ( void ) const

inlineprotectedinherited

Get the current CFG.

Returns: Current CFG.

References otawa::CFGProcessor::_cfg.

Referenced by otawa::DelayedBuilder::fix(), otawa::PSTBuilder::getVCFG(), otawa::ContextualProcessor::processCFG(), otawa::DelayedBuilder::processWorkSpace(), and otawa::CFGProcessor::processWorkSpace().

void otawa::ipet::TrivialInstCacheManager::cleanup ( WorkSpace * ws )

protectedvirtual

This method is called after the end of the processor analysis to let it do some clean up.

Parameters

ws	Workspace to work on.

Reimplemented from otawa::Processor.

References cache.

void otawa::BBProcessor::cleanupBB	(	WorkSpace *	ws,
		CFG *	cfg,
		BasicBlock *	bb
	)

protectedvirtualinherited

When the function doCleanup() is called, this function is called for each basic block of the task.

As a default do nothing.

Warning: If you override the cleanupCFG() function, do not forget to perform a call to the CFGProcessor original version.

Parameters

ws	Current workspace.
cfg	Current CFG.
bb	Current BB.

Referenced by otawa::BBProcessor::cleanupCFG().

void otawa::BBProcessor::cleanupCFG	(	WorkSpace *	ws,
		CFG *	cfg
	)

protectedvirtualinherited

This function may be overridden by a subclass to provide custom cleanup for a CFG.

It is called for each CFG of the task when doCleanUp() is called. As a default, do nothing.

Parameters

ws	Current workspace.
cfg	Current CFG.

Reimplemented from otawa::CFGProcessor.

References otawa::cfgio::bb(), and otawa::BBProcessor::cleanupBB().

void otawa::Processor::collectStats ( WorkSpace * ws )

protectedvirtualinherited

This method is invoked if the user has required to collect statistics about the processor.

In its default implementation, this method does nothing but it may be customized if the current implementation provides statistics. It is called after the main computation of the processor.

Statistics must be objects inheriting from the class StatCollector and recorded with method recordStat().

Parameters

ws	Current workspace.

Reimplemented in otawa::dcache::CatConstraintBuilder, otawa::ipet::WCETComputation, and otawa::CAT2OnlyConstraintBuilder.

Referenced by otawa::Processor::process().

void otawa::CFGProcessor::configure ( const PropList & props )

virtualinherited

Configure the current processor.

Parameters

props Configuration properties.

Reimplemented from otawa::Processor.

Reimplemented in otawa::GraphBBTime< G >, otawa::GraphBBTime< ParExeGraph >, otawa::AccessedAddressFromStack, otawa::tsim::Delta, otawa::ipet::ConstraintLoader, otawa::bpred::BPredProcessor, otawa::display::CFGOutput, otawa::ipet::VarAssignment, otawa::EdgeCAT2Builder, otawa::ipet::BasicConstraintsBuilder, otawa::etime::StandardEventBuilder, otawa::dcache::BlockBuilder, otawa::CAT2Builder, otawa::branch::OnlyConsBuilder, otawa::BBRatioDisplayer, otawa::etime::EdgeTimeBuilder, otawa::ipet::FlowFactConstraintBuilder, otawa::CFGSaver, otawa::CFGChecker, otawa::ipet::TrivialBBTime, otawa::CFGNormalizer, and otawa::ipet::CachePenaltiesObjectFunctionBuilder.

References otawa::Processor::configure(), and otawa::CFGProcessor::init().

void otawa::CFGProcessor::doCleanUp ( void )

protectedinherited

Trigger associated with CFG.

For each CFG, perform a call to cleanupCFG() that may be customized by a subclass.

References otawa::CFGProcessor::cleanupCFG(), otawa::CFGCollection::count(), otawa::CFGCollection::get(), otawa::INVOLVED_CFGS, and otawa::Processor::workspace().

void otawa::Processor::invalidate ( const AbstractFeature & feature )

protectedinherited

Usually called from a processor constructor, this method records a feature invalidated by the work of the current processor.

Parameters

feature Invalidated feature.

References otawa::Processor::_reg, otawa::AbstractRegistration::features, otawa::Monitor::flags, otawa::FeatureUsage::invalidate, otawa::Processor::IS_ALLOCATED, otawa::Processor::isAllocated(), and otawa::Processor::isPrepared().

Referenced by otawa::LoopReductor::LoopReductor().

bool otawa::Processor::isAllocated ( void ) const

inlineprotectedinherited

References flags.

Referenced by otawa::Processor::invalidate(), otawa::Processor::provide(), otawa::Processor::require(), and otawa::Processor::use().

bool otawa::Processor::isCollectingStats ( void ) const

inlineprotectedinherited

References flags.

Referenced by otawa::Processor::process(), and otawa::Processor::recordStat().

bool otawa::Processor::isPrepared ( void ) const

inlineprotectedinherited

References flags.

Referenced by otawa::Processor::invalidate(), otawa::Processor::process(), otawa::Processor::provide(), otawa::Processor::require(), and otawa::Processor::use().

bool otawa::Processor::isTimed ( void ) const

inlineprotectedinherited

Test if the timed mode is activated (recording of timings in the statistics).

Returns: True if timed mode is activated, false else.

Note: If statistics are not activated, this method returns ever false.

References flags.

Referenced by otawa::Processor::process().

bool otawa::Monitor::isVerbose ( void ) const

inlineinherited

Test if the verbosity is activated.

Returns: True if verbosity is activated, false else.

References flags.

Referenced by otawa::ccg::LBlockBuilder::addLBlock(), otawa::LBlockBuilder::addLBlock(), otawa::etime::EdgeTimeBuilder::applyFloppySplit(), otawa::etime::EdgeTimeBuilder::applyStrictSplit(), otawa::etime::EdgeTimeBuilder::applyWeightedSplit(), otawa::etime::EdgeTimeBuilder::makeSplit(), otawa::etime::EdgeTimeBuilder::processSequence(), and otawa::dcache::BlockBuilder::setup().

bool otawa::Monitor::logFor ( log_level_t tested ) const

inlineinherited

Test if the given log level is activated or not.

Parameters

tested Tested log level.

Returns: True if the log level is activated, false else.

log_level_t otawa::Monitor::logLevel ( void ) const

inlineinherited

Referenced by otawa::script::Script::declareGlobals().

elm::String otawa::Processor::name ( void ) const

inlineinherited

Referenced by otawa::CFGCollector::configure(), otawa::display::ILPSystemDisplayer::displayVar(), otawa::etime::StandardEventBuilder::handleVariableBranchPred(), otawa::script::Script::makeConfig(), otawa::DynProcessor::name(), otawa::display::ILPSystemDisplayer::nameOf(), otawa::FlowFactLoader::onCheckSum(), otawa::Processor::process(), otawa::ccg::ConstraintBuilder::processLBlockSet(), otawa::Processor::Processor(), otawa::ipet::WCETComputation::processWorkSpace(), otawa::dcache::CatConstraintBuilder::processWorkSpace(), otawa::CFGCollector::processWorkSpace(), otawa::FlowFactLoader::scanIgnoreEntry(), otawa::FlowFactLoader::scanMemSet(), otawa::FlowFactLoader::scanRegSet(), otawa::Processor::warn(), and otawa::script::Script::work().

void otawa::Processor::prepare ( WorkSpace * ws )

protectedvirtualinherited

This method called to let the processor customize its requirements according to some generic feature.

When overload, the original method MUST be called at the end of the custom overriding implementation.

Parameters

ws	Current workspace.

References otawa::Monitor::flags, and otawa::Processor::IS_PREPARED.

Referenced by otawa::Processor::process().

void otawa::Processor::process	(	WorkSpace *	fw,
		const PropList &	props = `PropList::EMPTY`
	)

inherited

Execute the code processor on the given framework.

Parameters

fw	Workspace to work on.
props	Configuration properties.

Referenced by otawa::PFGBuilder::finalizeBB(), otawa::WorkSpace::getCFGInfo(), otawa::FlowFactLoader::onIgnoreEntry(), otawa::SilentFeature::process(), otawa::ActualFeature::process(), otawa::DynProcessor::process(), otawa::Feature< T, C >::process(), otawa::p::feature::process(), otawa::TextDecoder::processWorkSpace(), otawa::cat::CATBuilder::processWorkSpace(), and otawa::DelayedBuilder::setup().

void otawa::ipet::TrivialInstCacheManager::processBB	(	WorkSpace *	ws,
		CFG *	cfd,
		BasicBlock *	bb
	)

protectedvirtual

Perform the work of the given basic block.

Parameters

fw	Container framework.
cfg	Parent CFG.
bb	Basic block to process.

Implements otawa::BBProcessor.

References otawa::BasicBlock::address(), otawa::hard::Cache::blockBits(), cache, otawa::hard::Cache::missPenalty(), otawa::hard::Cache::offset(), otawa::BasicBlock::size(), and otawa::ipet::TIME.

void otawa::BBProcessor::processCFG	(	WorkSpace *	ws,
		CFG *	cfg
	)

protectedvirtualinherited

See CFGProcessor::processCFG()

Implements otawa::CFGProcessor.

Reimplemented in otawa::BBRatioDisplayer, otawa::CFGSaver, otawa::CFGChecker, and otawa::cfgio::Output.

References otawa::ot::address(), otawa::cfgio::bb(), otawa::Monitor::log, otawa::Monitor::LOG_BB, otawa::Monitor::logFor(), and otawa::BBProcessor::processBB().

Referenced by otawa::cfgio::Output::processCFG(), otawa::CFGChecker::processCFG(), otawa::CFGSaver::processCFG(), and otawa::BBRatioDisplayer::processCFG().

void otawa::Processor::processFrameWork ( WorkSpace * fw )

protectedvirtualinherited

Process the given workspace.

Parameters

fw	Workspace to process.

Deprecated:: Use processWorkSpace() instead.

Referenced by otawa::Processor::processWorkSpace().

void otawa::CFGProcessor::processWorkSpace ( WorkSpace * fw )

protectedvirtualinherited

Process the given framework.

Parameters

fw	Framework to process.

Deprecated:: Use processWorkSpace() instead.

Reimplemented from otawa::Processor.

Reimplemented in otawa::GraphBBTime< G >, otawa::GraphBBTime< ParExeGraph >, otawa::ExeGraphBBTime< G >, otawa::ExeGraphBBTime< LiExeGraph >, otawa::ExeGraphBBTime< ParamExeGraph >, otawa::ipet::BasicConstraintsBuilder, otawa::DelayedBuilder, otawa::CFGSaver, and otawa::cfgio::Output.

References otawa::CFGProcessor::_cfg, otawa::CFGProcessor::cfg(), otawa::INVOLVED_CFGS, otawa::CFG::label(), otawa::Monitor::log, otawa::Monitor::LOG_CFG, otawa::Monitor::logFor(), otawa::CFGProcessor::processCFG(), otawa::PROCESSED_CFG, otawa::Processor::recordsStats(), and otawa::Processor::stats.

Referenced by otawa::cfgio::Output::processWorkSpace(), otawa::CFGSaver::processWorkSpace(), otawa::DelayedBuilder::processWorkSpace(), otawa::ipet::BasicConstraintsBuilder::processWorkSpace(), otawa::ExeGraphBBTime< G >::processWorkSpace(), and otawa::GraphBBTime< G >::processWorkSpace().

Progress & otawa::Processor::progress ( void )

inlineprotectedinherited

Get the current progress handler.

Returns: Progress handler.

void otawa::Processor::provide ( const AbstractFeature & feature )

protectedinherited

Usually called from a processor constructor, this method records a feature provided by the work of the current processor.

Parameters

feature Provided feature.

References otawa::Processor::_reg, otawa::AbstractRegistration::features, otawa::Monitor::flags, otawa::Processor::IS_ALLOCATED, otawa::Processor::isAllocated(), otawa::Processor::isPrepared(), and otawa::FeatureUsage::provide.

Referenced by otawa::ipet::BasicConstraintsBuilder::BasicConstraintsBuilder(), otawa::CFGBuilder::CFGBuilder(), otawa::CFGCheckSummer::CFGCheckSummer(), otawa::CFGCollector::CFGCollector(), otawa::CFGNormalizer::CFGNormalizer(), otawa::ContextTreeBuilder::ContextTreeBuilder(), otawa::ContextTreeByCFGBuilder::ContextTreeByCFGBuilder(), otawa::DeadCodeAnalysis::DeadCodeAnalysis(), otawa::Dominance::Dominance(), otawa::EdgeACSBuilder::EdgeACSBuilder(), otawa::EdgeCAT2Builder::EdgeCAT2Builder(), otawa::EdgeCAT2ConstraintBuilder::EdgeCAT2ConstraintBuilder(), otawa::ExeGraphBBTime< G >::ExeGraphBBTime(), otawa::FirstLastBuilder::FirstLastBuilder(), otawa::ipet::FlowFactConstraintBuilder::FlowFactConstraintBuilder(), otawa::ipet::ILPSystemGetter::ILPSystemGetter(), otawa::LoopReductor::LoopReductor(), otawa::PCGBuilder::PCGBuilder(), otawa::PFGBuilder::PFGBuilder(), otawa::PostDominance::PostDominance(), otawa::PSTBuilder::PSTBuilder(), otawa::TextDecoder::TextDecoder(), otawa::ipet::TrivialDataCacheManager::TrivialDataCacheManager(), and otawa::VarTextDecoder::VarTextDecoder().

bool otawa::Processor::recordsStats ( void ) const

inlineprotectedinherited

Test if the statictics mode is activated.

Returns: True if the statistics mode is activated, false else.

Referenced by otawa::Processor::init(), otawa::Processor::process(), and otawa::CFGProcessor::processWorkSpace().

void otawa::Processor::recordStat	(	const AbstractFeature &	feature,
		StatCollector *	collector
	)

protectedinherited

Add a statistics collector to the current workspace collection.

The statistics object is tracked and linked to the feature. In case of the feature invalidation, the statistics information instance is purged of the statistics collector.

Parameters

feature	Feature to link the collector to.
collector	Statistics collector to add.

References otawa::StatInfo::add(), otawa::Processor::addCleaner(), otawa::Processor::isCollectingStats(), and otawa::Processor::workspace().

Referenced by otawa::CAT2OnlyConstraintBuilder::collectStats(), otawa::ipet::WCETComputation::collectStats(), and otawa::dcache::CatConstraintBuilder::collectStats().

void otawa::Processor::require ( const AbstractFeature & feature )

protectedinherited

Usually called from a processor constructor, this method records a required feature for the work of the current processor.

Parameters

feature Required feature.

References otawa::Processor::_reg, otawa::AbstractRegistration::features, otawa::Monitor::flags, otawa::Processor::IS_ALLOCATED, otawa::Processor::isAllocated(), otawa::Processor::isPrepared(), and otawa::FeatureUsage::require.

Referenced by otawa::ipet::BasicConstraintsBuilder::BasicConstraintsBuilder(), otawa::CFGBuilder::CFGBuilder(), otawa::CFGCollector::CFGCollector(), otawa::CFGNormalizer::CFGNormalizer(), otawa::ContextTreeBuilder::ContextTreeBuilder(), otawa::ContextTreeByCFGBuilder::ContextTreeByCFGBuilder(), otawa::ContextualProcessor::ContextualProcessor(), otawa::DeadCodeAnalysis::DeadCodeAnalysis(), otawa::EdgeACSBuilder::EdgeACSBuilder(), otawa::EdgeCAT2Builder::EdgeCAT2Builder(), otawa::EdgeCAT2ConstraintBuilder::EdgeCAT2ConstraintBuilder(), otawa::FirstLastBuilder::FirstLastBuilder(), otawa::ipet::FlowFactConstraintBuilder::FlowFactConstraintBuilder(), otawa::LinkedBlocksDetector::LinkedBlocksDetector(), otawa::LoopReductor::LoopReductor(), otawa::PCGBuilder::PCGBuilder(), otawa::PFGBuilder::PFGBuilder(), otawa::PSTBuilder::PSTBuilder(), otawa::FeatureRequirer::require(), otawa::TextDecoder::TextDecoder(), otawa::ipet::TrivialDataCacheManager::TrivialDataCacheManager(), and otawa::script::Script::work().

void otawa::Processor::requireDyn	(	WorkSpace *	ws,
		const PropList &	props
	)

protectedvirtualinherited

Method called after registration requirements to support dynamic requirements.

As a default, do nothing.

Parameters

ws	Current workspace.
props	Current properties.

void otawa::ipet::TrivialInstCacheManager::setup ( WorkSpace * ws )

protectedvirtual

This method is called before an anlysis to let the processor do some initialization.

Parameters

ws	Processed workspace.

Reimplemented from otawa::Processor.

References cache, otawa::hard::CACHE_CONFIGURATION, otawa::hard::CacheConfiguration::instCache(), and otawa::Processor::warn().

void otawa::Monitor::setWorkspace ( WorkSpace * workspace )

inlineprotectedinherited

Set the current workspace.

Parameters

workspace New current workspace.

string otawa::CFGProcessor::str ( const Address & address )

protectedinherited

Transform an address to a smart string, that is, if a source line is available, transform it to "source_file:source_line", if the CFG has a label, it gives "label + 0xoffset", else return the address.

Parameters

address Address to display.

Returns: Address transformed in string.

References otawa::Address::null.

Referenced by otawa::ipet::FlowFactLoader::processBB().

string otawa::CFGProcessor::str	(	const Address &	base,
		const Address &	address
	)

protectedinherited

Transform an address to a smart string, that is, if a source line is available, transform it to "source_file:source_line", if the CFG has a label, it gives "label + 0xoffset", else return the address.

Parameters

base	Base address of the function containing the give address.
address	Address to display.

Returns: Address transformed in string.

References _, otawa::CFGProcessor::_cfg, otawa::ProgItem::address(), otawa::ot::address(), otawa::WorkSpace::findInstAt(), otawa::CFG::firstInst(), otawa::FUNCTION_LABEL, hex(), otawa::Address::isNull(), otawa::Address::offset(), and otawa::Processor::workspace().

template<class T >

T* otawa::Processor::track	(	const AbstractFeature &	feature,
		T *	object
	)

inlineprotectedinherited

Referenced by otawa::SubCFGBuilder::cleanup(), otawa::DelayedBuilder::cleanup(), and otawa::CFGBuilder::processWorkSpace().

template<class T >

void otawa::Processor::track	(	const AbstractFeature &	feature,
		const Ref< T , Identifier< T > > &	ref
	)

inlineprotectedinherited

Track the release of an allocated object assigned to an identifier relatively to the given feature.

When the feature is deleted, the object is fried and the identifier is removed. It is used as below:

track(MY_FEATURE, MY_ID(props) = value);

Parameters

feature	Linked feature.
ref	Reference to the identifier to remove.

template<class T >

void otawa::Processor::track	(	const AbstractFeature &	feature,
		const Ref< T , const Identifier< T > > &	ref
	)

inlineprotectedinherited

Track the release of an allocated object assigned to an identifier relatively to the given feature.

When the feature is deleted, the object is fried and the identifier is removed. It is used as below:

track(MY_FEATURE, MY_ID(props) = value);

Parameters

feature	Linked feature.
ref	Reference to the identifier to remove.

template<class T >

void otawa::BBProcessor::trackBB	(	const AbstractFeature &	feature,
		const Identifier< T * > &	id
	)

inlineprotectedinherited

Track and delete the content of the given identifier on each basic block.

Parameters

feature	Feature this identifier is linked to.
id	Identifier of the properties to remove.

template<class T >

void otawa::BBProcessor::trackBB	(	const AbstractFeature &	feature,
		const Identifier< T > &	id
	)

inlineprotectedinherited

Track and remove properties put on basic blocks.

Parameters

feature	Feature this identifier is linked to.
id	Identifier of the properties to remove.

void otawa::Processor::use ( const AbstractFeature & feature )

protectedinherited

Usually called from a processor constructor, this method records a feature as used by the work of the current processor.

Parameters

feature Used feature.

References otawa::Processor::_reg, otawa::AbstractRegistration::features, otawa::Monitor::flags, otawa::Processor::IS_ALLOCATED, otawa::Processor::isAllocated(), otawa::Processor::isPrepared(), and otawa::FeatureUsage::use.

elm::Version otawa::Processor::version ( void ) const

inlineinherited

Referenced by otawa::Processor::process(), otawa::Processor::Processor(), otawa::DynProcessor::version(), and otawa::Processor::warn().

void otawa::Processor::warn ( const String & message )

protectedinherited

Display a warning.

Parameters

message Message to display.

References otawa::Monitor::log, otawa::Processor::name(), and otawa::Processor::version().

Referenced by otawa::CFGBuilder::addFile(), otawa::CFGBuilder::buildCFG(), otawa::VarTextDecoder::getInst(), otawa::FlowFactLoader::load(), otawa::FlowFactLoader::onWarning(), otawa::ets::FlowFactLoader::processAST(), otawa::ipet::FlowFactLoader::processBB(), otawa::CFGChecker::processBB(), otawa::ipet::FlowFactConstraintBuilder::processBB(), otawa::etime::StandardEventBuilder::processBB(), otawa::CFGNormalizer::processCFG(), otawa::CFGChecker::processCFG(), otawa::VarTextDecoder::processEntry(), otawa::VarTextDecoder::processWorkSpace(), otawa::FixedTextDecoder::processWorkSpace(), otawa::CFGCollector::processWorkSpace(), otawa::FlowFactLoader::processWorkSpace(), otawa::Processor::processWorkSpace(), setup(), and otawa::script::Script::work().

WorkSpace * otawa::Monitor::workspace ( void )

inlineinherited

Get the current workspace.

Returns: Current workspace.

WorkSpace * otawa::Processor::workspace ( void ) const

inlineprotectedinherited

Get the current workspace.

Returns: Current workspace.

Referenced by otawa::CFGProcessor::doCleanUp(), otawa::PFGBuilder::finalizeBB(), otawa::VarTextDecoder::getBytes(), otawa::etime::StandardEventBuilder::handleVariableBranchPred(), otawa::ipet::FlowFactLoader::lookLineAt(), otawa::etime::EdgeTimeBuilder::make(), otawa::DelayedBuilder::makeNOp(), otawa::DelayedBuilder::next(), otawa::FlowFactLoader::onIgnoreEntry(), otawa::VarTextDecoder::processEntry(), otawa::Processor::recordStat(), otawa::DelayedBuilder::setup(), otawa::DelayedBuilder::size(), and otawa::CFGProcessor::str().

Member Data Documentation

const hard::Cache* otawa::ipet::TrivialInstCacheManager::cache

private

Referenced by cleanup(), processBB(), and setup().

Identifier< bool > otawa::Processor::COLLECT_STATS

staticinherited

This property allows to activate collection of statistics for the work of the current processor.

See also: StatInfo class.

Referenced by otawa::Processor::init().

const t::uint32 otawa::Monitor::CUSTOM_SHIFT = 16

staticprotectedinherited

t::uint32 otawa::Monitor::flags

protectedinherited

Contains various bit flags.

Bits from 0 to CUSTOM_SHIFT - 1 are private while bits from CUSTOM_SHIFT to 31 may be customized. To build a bit mask for custom bit i, the CUSTOM_SHIFT may be used as below:

static const t::uint32 MY_MASK = 1 << (i + CUSTOM_SHIFT);

Referenced by otawa::Processor::init(), otawa::Processor::invalidate(), otawa::Processor::prepare(), otawa::Processor::Processor(), otawa::Processor::provide(), otawa::Processor::require(), otawa::Processor::use(), and otawa::Processor::~Processor().