BandwidthManager Class Reference

Bandwidth Manager. More...

#include <bandwidthmanager.h>

Inheritance diagram for BandwidthManager:

List of all members.

Public Member Functions
	BandwidthManager (ServiceLevelAgreement *sla, RoundTripTimePinger *rttp)
	~BandwidthManager ()
void	addStream (ManagedStreamInterface *stream, const cardinal sessionID=0, const char *name=NULL)
void	removeStream (ManagedStreamInterface *stream)
void	updateStream (ManagedStreamInterface *stream)
void	forceCompleteRemapping ()
void	intervalChangeEvent (ManagedStreamInterface *stream, const bool isNew, const card64 when, const bool newRUList)
void	reportEvent (ManagedStreamInterface *stream, const RTCPReceptionReportBlock *report, const cardinal layer)
void	bufferFlushEvent (ManagedStreamInterface *stream, const cardinal layer)
void	timerEvent ()
void	setLogStream (std::ostream *logStream)
void	getPartialRemapping (bool &enabled, double &reservedPortion, double &utilizationTolerance, double &maxRemappingInterval) const
void	setPartialRemapping (const bool enabled, const double reservedPortion, const double utilizationTolerance, const double maxRemappingInterval)
void	getFairness (double &fairnessSession, double &fairnessStream) const
void	setFairness (const double fairnessSession, const double fairnessStream)
void	getQoSOptimizationParameters (cardinal &maxRUPoints, double &utilizationThreshold, card64 &bandwidthThreshold, double &systemDelayTolerance, bool &unlayeredAllocation) const
void	setQoSOptimizationParameters (const cardinal maxRUPoints, const double utilizationThreshold, const card64 bandwidthThreshold, const double systemDelayTolerance, const bool unlayeredAllocation)
void	updateReservation (StreamDescription *streamDescription)
Public Attributes
card64	TotalAvailableBandwidth
card64	ClassAvailableBandwidthArray [TrafficClassValues::MaxValues]
card64	TotalBandwidth
card64	ClassBandwidthArray [TrafficClassValues::MaxValues]
int64	SLAUpdateRecommendation [TrafficClassValues::MaxValues]
card64	StreamIDGenerator
card64	LastCompleteRemapping
card64	LastCompleteRemappingDuration
cardinal	CompleteRemappings
cardinal	PartialRemappings
cardinal	TotalBufferFlushes
std::multimap < ManagedStreamInterface *, StreamDescription * >	StreamSet
std::multimap< cardinal, SessionDescription * >	SessionSet
ServiceLevelAgreement *	SLA
cardinal	Streams
cardinal	Sessions
cardinal	MaxRUPoints
double	UtilizationThreshold
card64	BandwidthThreshold
double	SystemDelayTolerance
double	FairnessSession
double	FairnessStream
double	AlphaLossRate
double	AlphaJitter
double	PartialRemappingPortion
double	PartialRemappingUtilizationTolerance
card64	MaxRemappingInterval
bool	EnablePartialRemappings
bool	UnlayeredAllocation
Static Public Attributes
static card64	SimulatorTime = 0
Private Member Functions
cardinal	calculateSessionMultiPoints (SessionDescription *session, const cardinal offset, const cardinal lastPoint, ResourceUtilizationMultiPoint *rumpList)
void	getRoundTripTimes (StreamDescription *sd)
double	getPriorityFactor (const int8 streamPriority) const
double	getResourcePart (const ResourceUtilizationSimplePoint &rup) const
double	getResourcePart (const ResourceUtilizationMultiPoint &rump) const
double	getStreamSortingValue (const ResourceUtilizationSimplePoint &rup) const
double	getSessionSortingValue (const ResourceUtilizationMultiPoint &rump) const
bool	tryAllocation (ResourceUtilizationMultiPoint &rump, const card64 bandwidthLimit=(card64)-1)
void	doAllocationTrials (ResourceUtilizationMultiPoint *rumpList, const cardinal points, const card64 bandwidthLimit=(card64)-1)
bool	doPartialRemapping (StreamDescription *streamDescription)
void	doCompleteRemapping ()
Static Private Member Functions
static void	smoothedUpdate (double &value, const double measured, const double alpha)
Private Attributes
RoundTripTimePinger *	RTTP
std::ostream *	Log
card64	LogStartupTimeStamp
bool	Changed

---

Detailed Description

Bandwidth Manager.

This is the bandwidth manager.

Author:

Thomas Dreibholz

Version:

1.0

---

Constructor & Destructor Documentation

BandwidthManager::BandwidthManager	(	ServiceLevelAgreement *	sla,
		RoundTripTimePinger *	rttp
	)

Constructor.

Parameters:

sla	ServiceLevelAgreement object.
rttp	RoundTripTimePinger object.

BandwidthManager::~BandwidthManager

(

)

Destructor.

---

Member Function Documentation

void BandwidthManager::addStream	(	ManagedStreamInterface *	stream,
		const cardinal	sessionID = 0,
		const char *	name = NULL
	)		[virtual]

Add stream to management.

Parameters:

stream	Stream to add.
session	SessionID of session to add stream to (0 for no session).
name	Stream name (only for log printing).

Implements QoSManagerInterface.

void BandwidthManager::bufferFlushEvent	(	ManagedStreamInterface *	stream,
		const cardinal	layer
	)		[virtual]

Buffer flush for a given layer.

Parameters:

stream

Stream.

Implements QoSManagerInterface.

cardinal BandwidthManager::calculateSessionMultiPoints	(	SessionDescription *	session,
		const cardinal	offset,
		const cardinal	lastPoint,
		ResourceUtilizationMultiPoint *	rumpList
	)		[private]

void BandwidthManager::doAllocationTrials	(	ResourceUtilizationMultiPoint *	rumpList,
		const cardinal	points,
		const card64	bandwidthLimit = (card64)-1
	)		[private]

void BandwidthManager::doCompleteRemapping

(

)

[private]

bool BandwidthManager::doPartialRemapping

(

StreamDescription *

streamDescription

)

[private]

void BandwidthManager::forceCompleteRemapping

(

)

[inline]

Force a complete remapping.

void BandwidthManager::getFairness	(	double &	fairnessSession,
		double &	fairnessStream
	)		const [inline]

Get fairnes settings.

Parameters:

fairnessSession	Reference to store session fairness.
fairnessStream	Reference to store stream fairness.

void BandwidthManager::getPartialRemapping	(	bool &	enabled,
		double &	reservedPortion,
		double &	utilizationTolerance,
		double &	maxRemappingInterval
	)		const [inline]

Get partial remapping parameters.

Parameters:

enabled	Reference to store true, if partial remappings are enabled; false otherwise.
reservedPortion	Reference to store reserved bandwidth portion (out of [0,1]).
utilizationTolerance	Reference to store utilization tolerance for partial remapping.
maxRemappingInterval	Reference to store maximum interval between two complete remappings.

double BandwidthManager::getPriorityFactor

(

const int8

streamPriority

)

const [inline, private]

void BandwidthManager::getQoSOptimizationParameters	(	cardinal &	maxRUPoints,
		double &	utilizationThreshold,
		card64 &	bandwidthThreshold,
		double &	systemDelayTolerance,
		bool &	unlayeredAllocation
	)		const [inline]

Get QoS optimization parameters.

Parameters:

maxRUPoints	Reference to store maximum number of RU points per stream.
utilizationThreshold	Reference to store utilization threshold.
bandwidthThreshold	Reference to store bandwidth threshold.
systemDelayTolerance	Reference to store the system's delay tolerance for the buffering optimization.

double BandwidthManager::getResourcePart

(

const ResourceUtilizationSimplePoint &

rup

)

const [inline, private]

double BandwidthManager::getResourcePart

(

const ResourceUtilizationMultiPoint &

rump

)

const [inline, private]

void BandwidthManager::getRoundTripTimes

(

StreamDescription *

sd

)

[private]

double BandwidthManager::getSessionSortingValue

(

const ResourceUtilizationMultiPoint &

rump

)

const [inline, private]

double BandwidthManager::getStreamSortingValue

(

const ResourceUtilizationSimplePoint &

rup

)

const [inline, private]

void BandwidthManager::intervalChangeEvent	(	ManagedStreamInterface *	stream,
		const bool	isNew,
		const card64	when,
		const bool	newRUList
	)		[virtual]

Interval has changed.

Parameters:

stream	Stream with changed interval.
isNew	true, if new interval has been reached; false otherwise.
when	Microseconds to next interval.
newRUList	true, if new resource/utiliztion list has been reached; false otherwise.

Implements QoSManagerInterface.

void BandwidthManager::removeStream

(

ManagedStreamInterface *

stream

)

[virtual]

Remove stream from management.

Parameters:

stream

Stream to remove.

Implements QoSManagerInterface.

void BandwidthManager::reportEvent	(	ManagedStreamInterface *	stream,
		const RTCPReceptionReportBlock *	report,
		const cardinal	layer
	)		[virtual]

Report reception for given layer.

Parameters:

stream	Stream.
report	Report.
layer	Layer.

Implements QoSManagerInterface.

void BandwidthManager::setFairness	(	const double	fairnessSession,
		const double	fairnessStream
	)		[inline]

Set fairnes settings.

Parameters:

fairnessSession	Session fairness.
fairnessStream	Stream fairness.

void BandwidthManager::setLogStream

(

std::ostream *

logStream

)

Set log stream.

Parameters:

logStream

Stream to write log information to; NULL to disable logging.

void BandwidthManager::setPartialRemapping	(	const bool	enabled,
		const double	reservedPortion,
		const double	utilizationTolerance,
		const double	maxRemappingInterval
	)		[inline]

Set partial remapping parameters.

Parameters:

enabled	true, if partial remappings are enabled; false otherwise.
reservedPortion	Reserved bandwidth portion (out of [0,1]).
utilizationTolerance	Utilization tolerance for partial remapping.
maxRemappingInterval	Maximum interval between two complete remappings.

void BandwidthManager::setQoSOptimizationParameters	(	const cardinal	maxRUPoints,
		const double	utilizationThreshold,
		const card64	bandwidthThreshold,
		const double	systemDelayTolerance,
		const bool	unlayeredAllocation
	)		[inline]

Set QoS optimization parameters.

Parameters:

maxRUPoints	Maximum number of RU points per stream.
utilizationThreshold	Utilization threshold.
bandwidthThreshold	Bandwidth threshold.
systemDelayTolerance	The system's delay tolerance for the buffering optimization.

static void BandwidthManager::smoothedUpdate	(	double &	value,
		const double	measured,
		const double	alpha
	)		[inline, static, private]

void BandwidthManager::timerEvent

(

)

[virtual]

Implementation of TimedThread's timerEvent() method.

See also:

TimedThread::timerEvent

Implements TimedThread.

bool BandwidthManager::tryAllocation	(	ResourceUtilizationMultiPoint &	rump,
		const card64	bandwidthLimit = (card64)-1
	)		[private]

void BandwidthManager::updateReservation

(

StreamDescription *

streamDescription

)

void BandwidthManager::updateStream

(

ManagedStreamInterface *

stream

)

[virtual]

Update stream.

Parameters:

stream

Stream to be updated.

Implements QoSManagerInterface.

---

Member Data Documentation

double BandwidthManager::AlphaJitter

double BandwidthManager::AlphaLossRate

card64 BandwidthManager::BandwidthThreshold

bool BandwidthManager::Changed [private]

card64 BandwidthManager::ClassAvailableBandwidthArray[TrafficClassValues::MaxValues]

card64 BandwidthManager::ClassBandwidthArray[TrafficClassValues::MaxValues]

cardinal BandwidthManager::CompleteRemappings

bool BandwidthManager::EnablePartialRemappings

double BandwidthManager::FairnessSession

double BandwidthManager::FairnessStream

card64 BandwidthManager::LastCompleteRemapping

card64 BandwidthManager::LastCompleteRemappingDuration

std::ostream* BandwidthManager::Log [private]

card64 BandwidthManager::LogStartupTimeStamp [private]

card64 BandwidthManager::MaxRemappingInterval

cardinal BandwidthManager::MaxRUPoints

double BandwidthManager::PartialRemappingPortion

cardinal BandwidthManager::PartialRemappings

double BandwidthManager::PartialRemappingUtilizationTolerance

RoundTripTimePinger* BandwidthManager::RTTP [private]

cardinal BandwidthManager::Sessions

std::multimap<cardinal,SessionDescription*> BandwidthManager::SessionSet

card64 BandwidthManager::SimulatorTime = 0 [static]

ServiceLevelAgreement* BandwidthManager::SLA

int64 BandwidthManager::SLAUpdateRecommendation[TrafficClassValues::MaxValues]

card64 BandwidthManager::StreamIDGenerator

cardinal BandwidthManager::Streams

std::multimap<ManagedStreamInterface*,StreamDescription*> BandwidthManager::StreamSet

double BandwidthManager::SystemDelayTolerance

card64 BandwidthManager::TotalAvailableBandwidth

card64 BandwidthManager::TotalBandwidth

cardinal BandwidthManager::TotalBufferFlushes

bool BandwidthManager::UnlayeredAllocation

double BandwidthManager::UtilizationThreshold

---

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

• bandwidthmanager.h
• bandwidthmanager.cc