StrictPolicyImpl Class Reference

Collaboration diagram for StrictPolicyImpl:

[legend]List of all members.

---

Detailed Description

An implementation of the StrictPolicy interface.

Definition at line 34 of file StrictPolicyImpl.hh.

Public Member Functions
	StrictPolicyImpl (const char *name)
	Construct a StrictPolicyImpl object with the given values.
virtual	~StrictPolicyImpl ()
	Deconstruct the policy.
virtual char *	Name (void) throw (CORBA::SystemException)
	Mostly useful for debugging.
virtual void	AddTask (Broker::Task_ptr new_task, const Broker::ScheduleParameters &sp) throw (CORBA::SystemException, Broker::DuplicateScheduleParameter, Broker::InvalidScheduleParameter, Broker::MissingScheduleParameter)
	NOTE: This method will be called before the reservation is made, giving the policy a chance to adjust any values. See also: RemoveTask Parameters: new_task  The newly created Task object. sp  The tasks's scheduling parameters. Exceptions: CORBA::BAD_PARAM  if task is nil. CORBA::BAD_PARAM  if task has already been added. CORBA::BAD_INV_ORDER  if the method is called without Activate() being called first.
virtual void	RemoveTask (Broker::Task_ptr added_task) throw (CORBA::SystemException)
	NOTE: This method will be called after the reservation has been destroyed, so it can safely reallocate the newly freed CPU time. See also: AddTask Parameters: added_task  The task to remove. Exceptions: CORBA::BAD_PARAM  if task is nil. CORBA::BAD_PARAM  if task has already been removed. CORBA::BAD_INV_ORDER  if the method is called without Activate() being called first.
virtual Broker::TaskList *	GetTaskList (void) throw (CORBA::SystemException)
	Returns: The list of task's managed by this policy.
virtual void	Activate (const Broker::TaskList &tasks) throw (CORBA::SystemException)
	NOTE: The policy is expected to discover and adjust the scheduling parameters of any currently executing tasks. See also: Deactivate Parameters: tasks  The list of tasks the policy needs to manage. Exceptions: CORBA::BAD_INV_ORDER  if the method is called without intervening calls to Deactivate().
virtual void	Deactivate (void) throw (CORBA::SystemException)
	NOTE: The policy should change any scheduling parameters of the currently executing tasks, the next policy to be activated will handle any changes. See also: Deactivate Exceptions: CORBA::BAD_INV_ORDER  if the method is called on an inactive policy.
virtual Broker::CPUReserve	ChangeTaskCPU (Broker::RealTimeTask_ptr task, const Broker::CPUReserve &advice) throw (CORBA::SystemException, Broker::InvalidState)
	Parameters: task  The Task object requesting a CPU time change. advice  The CPU time advice from the Task object. Returns: The actual CPU reserve given to the task.
virtual CORBA::Float	GetMaxCPUAllocation (void) throw (CORBA::SystemException)
	Returns: The maximum percentage of CPU that can be allocated to all of the tasks.
virtual void	SetMaxCPUAllocation (CORBA::Float amount) throw (CORBA::SystemException)
	Parameters: amount  The maximum percentage of CPU that can be allocated to all of the tasks.
virtual void	SetTaskPriority (Broker::Task_ptr task, CORBA::Short priority) throw (CORBA::SystemException)
	Parameters: task  The task whose priority should be changed. priority  The new priority. Exceptions: CORBA::BAD_PARAM  if task is nil. CORBA::BAD_PARAM  if task is not managed by this policy.
virtual CORBA::Short	GetTaskPriority (Broker::Task_ptr task) throw (CORBA::SystemException)
	Parameters: task  The task whose priority should be retrieved. Returns: The task's priority. Exceptions: CORBA::BAD_PARAM  if task is nil. CORBA::BAD_PARAM  if task is not managed by this policy.
Static Public Attributes
const float	DEFAULT_MAX_USED_CPU = 0.75
	Maximum percentage of CPU to allocate to tasks.
const float	DEFAULT_MIN_TASK_CPU = 0.02
	Minimum percentage of CPU to allocate to a single task.
Private Member Functions
void	RepairTaskList (void)
	Repair the task list by removing any dead/unreachable objects.
TaskPriority *	FindTaskPriority (Broker::RealTimeTask_ptr task)
	Find the TaskPriority node that corresponds to the given task.
void	RedistributeCPU (void)
	Detect changes in the amount of requested/available compute time or priorities, and map them onto the OS scheduler.
Private Attributes
CORBA::String_var	sp_Name
	The name of this object as registered with the NamingService.
float	sp_MaxUsedCPU
	The maximum percentage of CPU time that we are allowed to allocate.
float	sp_MinTaskCPU
	The minimum percentage of CPU time that a task must have.
lnList	sp_List
	A list of TaskPriority objects.
CORBA::ULong	sp_MaxDeadline
	The largest deadline of the tasks managed by this policy.

---

Constructor & Destructor Documentation

StrictPolicyImpl::StrictPolicyImpl (  const char *  name  )

Construct a StrictPolicyImpl object with the given values. Parameters: name  The name of this object as registered with the NamingService. Definition at line 31 of file StrictPolicyImpl.cc. References lnNewList(), require, sp_MaxUsedCPU, and sp_MinTaskCPU.

Here is the call graph for this function:

---

Member Function Documentation

void StrictPolicyImpl::Activate (  const Broker::TaskList &  tl  )  throw (CORBA::SystemException) [virtual]

NOTE: The policy is expected to discover and adjust the scheduling parameters of any currently executing tasks. See also: Deactivate Parameters: tasks  The list of tasks the policy needs to manage. Exceptions: CORBA::BAD_INV_ORDER  if the method is called without intervening calls to Deactivate(). Todo: implement Definition at line 193 of file StrictPolicyImpl.cc.

void StrictPolicyImpl::AddTask (  Broker::Task_ptr  task, const Broker::ScheduleParameters &  sp )  throw (CORBA::SystemException, Broker::DuplicateScheduleParameter, Broker::InvalidScheduleParameter, Broker::MissingScheduleParameter) [virtual]

NOTE: This method will be called before the reservation is made, giving the policy a chance to adjust any values. See also: RemoveTask Parameters: new_task  The newly created Task object. sp  The tasks's scheduling parameters. Exceptions: CORBA::BAD_PARAM  if task is nil. CORBA::BAD_PARAM  if task has already been added. CORBA::BAD_INV_ORDER  if the method is called without Activate() being called first. Todo: Handle other types of tasks. Definition at line 76 of file StrictPolicyImpl.cc. References lnNode::ln_Pred, lnNode::ln_Pri, lnNode::ln_Succ, lnEnqueue(), rts_grab_schedulable(), RealTimeSchedule::rts_PID, rtt, RealTimeSchedule::setParameters(), StrictPolicyImpl::TaskPriority::tp_ComputeTime, StrictPolicyImpl::TaskPriority::tp_Link, StrictPolicyImpl::TaskPriority::tp_RequestedTime, StrictPolicyImpl::TaskPriority::tp_Schedulable, StrictPolicyImpl::TaskPriority::tp_Schedule, and StrictPolicyImpl::TaskPriority::tp_Task.

Here is the call graph for this function:

void StrictPolicyImpl::Deactivate (  void   )  throw (CORBA::SystemException) [virtual]

NOTE: The policy should change any scheduling parameters of the currently executing tasks, the next policy to be activated will handle any changes. See also: Deactivate Exceptions: CORBA::BAD_INV_ORDER  if the method is called on an inactive policy. Todo: implement Definition at line 199 of file StrictPolicyImpl.cc.

struct StrictPolicyImpl::TaskPriority * StrictPolicyImpl::FindTaskPriority (  Broker::RealTimeTask_ptr  task  )  [private]

Find the TaskPriority node that corresponds to the given task. Parameters: task  The Broker::RealTimeTask object to look up. Returns: The TaskPriority list node that has the given task object. Exceptions: Broker::Internal  If no TaskPriority node exists for the given task. Definition at line 390 of file StrictPolicyImpl.cc. References lnList::lh_Head, lnNode::ln_Succ, require, sp_List, StrictPolicyImpl::TaskPriority::tp_Link, and StrictPolicyImpl::TaskPriority::tp_Task.

---

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

• StrictPolicyImpl.hh
• StrictPolicyImpl.cc

---