Stream Description. More...

#include <streamdescription.h>

Public Member Functions
	StreamDescription ()
	~StreamDescription ()
void	init (ManagedStreamInterface stream, const ServiceLevelAgreement sla, const cardinal maxPoints, const card64 bwThreshold, const double utThreshold, const double systemDelayTolerance, const bool unlayeredAllocation)
bool	tryAllocation (const ServiceLevelAgreement sla, card64 &totalAvailableBandwidth, card64 classAvailableBandwidthArray, ResourceUtilizationPoint &rup, const card64 bandwidthLimit=(card64)-1)
Public Attributes
ManagedStreamInterface *	Interface
AbstractQoSDescription *	QoSDescription
SessionDescription *	Session
card64	StreamID
cardinal	Layers
cardinal	RUEntries
ResourceUtilizationPoint	RUList [MaxRUEntries]
cardinal	NewLayerClassNumber [RTPConstants::RTPMaxQualityLayers]
card64	NewLayerClassBandwidth [RTPConstants::RTPMaxQualityLayers]
double	NewCostPerSecond
ResourceUtilizationPoint	NewQuality
double	LastUtilization
cardinal	CurrentLayerClassNumber [RTPConstants::RTPMaxQualityLayers]
card64	CurrentLayerClassBandwidth [RTPConstants::RTPMaxQualityLayers]
double	CurrentCostPerSecond
ResourceUtilizationPoint	CurrentQuality
card64	ReservationTimeStamp
double	TotalCost
double	TotalBandwidthUsage
double	TotalUtilization
double	TotalRuntime
cardinal	TotalReservationUpdates
cardinal	PartialRemappings
cardinal	CompleteRemappings
cardinal	Inits
cardinal	BufferFlushes
card64	LastInitDuration
double	ReportedLossRate [RTPConstants::RTPMaxQualityLayers]
double	ReportedJitter [RTPConstants::RTPMaxQualityLayers]
double	MeasuredTransferDelay [TrafficClassValues::MaxValues]
InternetAddress	RoundTripTimeDestination
card64	NextInterval
bool	MaximumReached
bool	UnlayeredAllocation
Static Public Attributes
static const cardinal	MaxRUEntries = 256
Private Member Functions
bool	calculatePossibleLayerClassMappings (ResourceUtilizationPoint &rup, const ServiceLevelAgreement sla, const AbstractQoSDescription aqd)

Detailed Description

Stream Description.

This class contains a description of a stream. It is used for the bandwidth manager's remapping algorithm.

Author:: Thomas Dreibholz

Version:: 1.0

Constructor & Destructor Documentation

Coral::StreamDescription::StreamDescription ( )

Constructor.

Coral::StreamDescription::~StreamDescription ( )

Destructor.

Member Function Documentation

bool Coral::StreamDescription::calculatePossibleLayerClassMappings	(	ResourceUtilizationPoint &	rup,
		const ServiceLevelAgreement *	sla,
		const AbstractQoSDescription *	aqd
	)		`[private]`

void Coral::StreamDescription::init	(	ManagedStreamInterface *	stream,
		const ServiceLevelAgreement *	sla,
		const cardinal	maxPoints,
		const card64	bwThreshold,
		const double	utThreshold,
		const double	systemDelayTolerance,
		const bool	unlayeredAllocation
	)

Initialize.

Parameters:

stream	ManagedStreamInterface.
sla	Service level agreement.
maxPoints	Maximum number of resource/utilization points for each stream.
bwThreshold	Bandwidth threshold.
utThreshold	Utilization threshold.
systemDelayTolerance	The system's delay tolerance for the buffering optimization.
unlayeredAllocation	True, to use the same DiffServ class for all layers; false otherwise.

bool Coral::StreamDescription::tryAllocation	(	const ServiceLevelAgreement *	sla,
		card64 &	totalAvailableBandwidth,
		card64 *	classAvailableBandwidthArray,
		ResourceUtilizationPoint &	rup,
		const card64	bandwidthLimit = `(card64)-1`
	)

Try to allocate given layer bandwidths to a stream. If allocation is successful, the availability references are decremented by the bandwidth allocation. The allocated bandwidths and buffer delays will be stored into the resource/utilization point.

Parameters:

sla	Service level agreement.
totalAvailableBandwidth	Reference to total available bandwidth.
classAvailableBandwidthArray	Available bandwidths for each DiffServ class.
rup	Resource/utilization point to do allocation for.
session	Session of the stream.
bandwidthLimit	Upper bandwidth limit (e.g. the session's maximum bandwidth).

Member Data Documentation

cardinal Coral::StreamDescription::BufferFlushes

Number of buffer flushes.

cardinal Coral::StreamDescription::CompleteRemappings

Number of complete remappings forced by this stream.

double Coral::StreamDescription::CurrentCostPerSecond

Current bandwidth cost per second.

card64 Coral::StreamDescription::CurrentLayerClassBandwidth[RTPConstants::RTPMaxQualityLayers]

Current layer's allocated bandwidth currently used.

cardinal Coral::StreamDescription::CurrentLayerClassNumber[RTPConstants::RTPMaxQualityLayers]

Layer's allocated DiffServ class number currently used.

ResourceUtilizationPoint Coral::StreamDescription::CurrentQuality

Current quality.

cardinal Coral::StreamDescription::Inits

Number of init() calls.

See also:: init

ManagedStreamInterface* Coral::StreamDescription::Interface

Stream's manager interface.

card64 Coral::StreamDescription::LastInitDuration

Duration of last init() call.

double Coral::StreamDescription::LastUtilization

Last *complete* remapping's utilization.

cardinal Coral::StreamDescription::Layers

Number of layers.

bool Coral::StreamDescription::MaximumReached

True, if all following higher bandwidth allocations will fail (no more bandwidth available to achieve higher quality -> no more allocation trials necessary); false otherwise.

const cardinal Coral::StreamDescription::MaxRUEntries = 256 [static]

Maximum number of entries in the list.

double Coral::StreamDescription::MeasuredTransferDelay[TrafficClassValues::MaxValues]

Smoothed measured transfer delay from ICMP echo replies for each DiffServ class.

double Coral::StreamDescription::NewCostPerSecond

New remapping's bandwidth cost per second.

card64 Coral::StreamDescription::NewLayerClassBandwidth[RTPConstants::RTPMaxQualityLayers]

New remapping's layer's allocated bandwidth.

cardinal Coral::StreamDescription::NewLayerClassNumber[RTPConstants::RTPMaxQualityLayers]

New remapping's layer's allocated DiffServ class number.

ResourceUtilizationPoint Coral::StreamDescription::NewQuality

New remapping's quality.