<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>change log for rtems (2011-02-18)</title>
</head>
<body text='#000000' bgcolor='#ffffff'>
<a name='cs1'></a>
<table border='0' cellspacing='0' cellpadding='5' width='100%' bgcolor='#eeeeee'>
<tr><td colspan='3' bgcolor='#dddddd'>
<font color='#bb2222'><strong>joel</strong></font>
</td></tr>
<tr><td colspan='3' bgcolor='#dddddd'><pre>2011-02-18 Joel Sherrill <joel.sherrill@oarcorp.com>
* sapi/include/confdefs.h, score/Makefile.am,
score/include/rtems/score/scheduler.h,
score/include/rtems/score/schedulerpriority.h,
score/include/rtems/score/thread.h,
score/inline/rtems/score/scheduler.inl,
score/inline/rtems/score/schedulerpriority.inl,
score/src/scheduler.c, score/src/schedulerpriority.c,
score/src/schedulerpriorityblock.c,
score/src/schedulerpriorityschedule.c,
score/src/schedulerpriorityunblock.c,
score/src/schedulerpriorityyield.c, score/src/threadchangepriority.c,
score/src/threadclose.c, score/src/threadinitialize.c,
score/src/threadsetpriority.c, score/src/threadsettransient.c:
Significant clean up on Scheduler Plugin Interface. Names were
shortened. Missing operations added. Many scheduler files had
unneeded includes removed. Made pointer to scheduler information in
Thread_Control and Scheduler_Control a void * pointer because the
thread and scheduler wrapper should be unaware of scheduler types AND
this is broken for user provided schedulers.
* score/src/schedulerpriorityallocate.c,
score/src/schedulerpriorityenqueue.c,
score/src/schedulerpriorityenqueuefirst.c,
score/src/schedulerpriorityextract.c,
score/src/schedulerpriorityfree.c,
score/src/schedulerpriorityupdate.c: New files.
* score/src/schedulerprioritythreadschedulerallocate.c,
score/src/schedulerprioritythreadschedulerfree.c,
score/src/schedulerprioritythreadschedulerupdate.c: Removed.
</pre></td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/cpukit/ChangeLog.diff?r1=text&tr1=1.2718&r2=text&tr2=1.2719&diff_format=h">M</a></td><td width='1%'>1.2719</td><td width='100%'>cpukit/ChangeLog</td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/cpukit/sapi/include/confdefs.h.diff?r1=text&tr1=1.155&r2=text&tr2=1.156&diff_format=h">M</a></td><td width='1%'>1.156</td><td width='100%'>cpukit/sapi/include/confdefs.h</td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/cpukit/score/Makefile.am.diff?r1=text&tr1=1.90&r2=text&tr2=1.91&diff_format=h">M</a></td><td width='1%'>1.91</td><td width='100%'>cpukit/score/Makefile.am</td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/cpukit/score/include/rtems/score/scheduler.h.diff?r1=text&tr1=1.4&r2=text&tr2=1.5&diff_format=h">M</a></td><td width='1%'>1.5</td><td width='100%'>cpukit/score/include/rtems/score/scheduler.h</td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/cpukit/score/include/rtems/score/schedulerpriority.h.diff?r1=text&tr1=1.3&r2=text&tr2=1.4&diff_format=h">M</a></td><td width='1%'>1.4</td><td width='100%'>cpukit/score/include/rtems/score/schedulerpriority.h</td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/cpukit/score/include/rtems/score/thread.h.diff?r1=text&tr1=1.98&r2=text&tr2=1.99&diff_format=h">M</a></td><td width='1%'>1.99</td><td width='100%'>cpukit/score/include/rtems/score/thread.h</td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/cpukit/score/inline/rtems/score/scheduler.inl.diff?r1=text&tr1=1.3&r2=text&tr2=1.4&diff_format=h">M</a></td><td width='1%'>1.4</td><td width='100%'>cpukit/score/inline/rtems/score/scheduler.inl</td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/cpukit/score/inline/rtems/score/schedulerpriority.inl.diff?r1=text&tr1=1.4&r2=text&tr2=1.5&diff_format=h">M</a></td><td width='1%'>1.5</td><td width='100%'>cpukit/score/inline/rtems/score/schedulerpriority.inl</td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/cpukit/score/src/scheduler.c.diff?r1=text&tr1=1.2&r2=text&tr2=1.3&diff_format=h">M</a></td><td width='1%'>1.3</td><td width='100%'>cpukit/score/src/scheduler.c</td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/cpukit/score/src/schedulerpriority.c.diff?r1=text&tr1=1.3&r2=text&tr2=1.4&diff_format=h">M</a></td><td width='1%'>1.4</td><td width='100%'>cpukit/score/src/schedulerpriority.c</td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/cpukit/score/src/schedulerpriorityallocate.c?rev=1.1&content-type=text/vnd.viewcvs-markup">A</a></td><td width='1%'><font color="#000088">1.1</font></td><td width='100%'><font color="#000088">cpukit/score/src/schedulerpriorityallocate.c</font></td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/cpukit/score/src/schedulerpriorityblock.c.diff?r1=text&tr1=1.3&r2=text&tr2=1.4&diff_format=h">M</a></td><td width='1%'>1.4</td><td width='100%'>cpukit/score/src/schedulerpriorityblock.c</td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/cpukit/score/src/schedulerpriorityenqueue.c?rev=1.1&content-type=text/vnd.viewcvs-markup">A</a></td><td width='1%'><font color="#000088">1.1</font></td><td width='100%'><font color="#000088">cpukit/score/src/schedulerpriorityenqueue.c</font></td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/cpukit/score/src/schedulerpriorityenqueuefirst.c?rev=1.1&content-type=text/vnd.viewcvs-markup">A</a></td><td width='1%'><font color="#000088">1.1</font></td><td width='100%'><font color="#000088">cpukit/score/src/schedulerpriorityenqueuefirst.c</font></td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/cpukit/score/src/schedulerpriorityextract.c?rev=1.1&content-type=text/vnd.viewcvs-markup">A</a></td><td width='1%'><font color="#000088">1.1</font></td><td width='100%'><font color="#000088">cpukit/score/src/schedulerpriorityextract.c</font></td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/cpukit/score/src/schedulerpriorityfree.c?rev=1.1&content-type=text/vnd.viewcvs-markup">A</a></td><td width='1%'><font color="#000088">1.1</font></td><td width='100%'><font color="#000088">cpukit/score/src/schedulerpriorityfree.c</font></td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/cpukit/score/src/schedulerpriorityschedule.c.diff?r1=text&tr1=1.3&r2=text&tr2=1.4&diff_format=h">M</a></td><td width='1%'>1.4</td><td width='100%'>cpukit/score/src/schedulerpriorityschedule.c</td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/cpukit/score/src/schedulerprioritythreadschedulerallocate.c?rev=1.3&content-type=text/vnd.viewcvs-markup">R</a></td><td width='1%'><font color="#880000">1.3</font></td><td width='100%'><font color="#880000">cpukit/score/src/schedulerprioritythreadschedulerallocate.c</font></td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/cpukit/score/src/schedulerprioritythreadschedulerfree.c?rev=1.3&content-type=text/vnd.viewcvs-markup">R</a></td><td width='1%'><font color="#880000">1.3</font></td><td width='100%'><font color="#880000">cpukit/score/src/schedulerprioritythreadschedulerfree.c</font></td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/cpukit/score/src/schedulerprioritythreadschedulerupdate.c?rev=1.3&content-type=text/vnd.viewcvs-markup">R</a></td><td width='1%'><font color="#880000">1.3</font></td><td width='100%'><font color="#880000">cpukit/score/src/schedulerprioritythreadschedulerupdate.c</font></td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/cpukit/score/src/schedulerpriorityunblock.c.diff?r1=text&tr1=1.3&r2=text&tr2=1.4&diff_format=h">M</a></td><td width='1%'>1.4</td><td width='100%'>cpukit/score/src/schedulerpriorityunblock.c</td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/cpukit/score/src/schedulerpriorityupdate.c?rev=1.1&content-type=text/vnd.viewcvs-markup">A</a></td><td width='1%'><font color="#000088">1.1</font></td><td width='100%'><font color="#000088">cpukit/score/src/schedulerpriorityupdate.c</font></td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/cpukit/score/src/schedulerpriorityyield.c.diff?r1=text&tr1=1.5&r2=text&tr2=1.6&diff_format=h">M</a></td><td width='1%'>1.6</td><td width='100%'>cpukit/score/src/schedulerpriorityyield.c</td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/cpukit/score/src/threadchangepriority.c.diff?r1=text&tr1=1.17&r2=text&tr2=1.18&diff_format=h">M</a></td><td width='1%'>1.18</td><td width='100%'>cpukit/score/src/threadchangepriority.c</td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/cpukit/score/src/threadclose.c.diff?r1=text&tr1=1.16&r2=text&tr2=1.17&diff_format=h">M</a></td><td width='1%'>1.17</td><td width='100%'>cpukit/score/src/threadclose.c</td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/cpukit/score/src/threadinitialize.c.diff?r1=text&tr1=1.43&r2=text&tr2=1.44&diff_format=h">M</a></td><td width='1%'>1.44</td><td width='100%'>cpukit/score/src/threadinitialize.c</td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/cpukit/score/src/threadsetpriority.c.diff?r1=text&tr1=1.8&r2=text&tr2=1.9&diff_format=h">M</a></td><td width='1%'>1.9</td><td width='100%'>cpukit/score/src/threadsetpriority.c</td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/cpukit/score/src/threadsettransient.c.diff?r1=text&tr1=1.8&r2=text&tr2=1.9&diff_format=h">M</a></td><td width='1%'>1.9</td><td width='100%'>cpukit/score/src/threadsettransient.c</td></tr>
</table>
<pre>
<font color='#006600'>diff -u rtems/cpukit/ChangeLog:1.2718 rtems/cpukit/ChangeLog:1.2719
--- rtems/cpukit/ChangeLog:1.2718 Thu Feb 17 16:21:43 2011
+++ rtems/cpukit/ChangeLog Fri Feb 18 09:12:43 2011
</font><font color='#997700'>@@ -1,3 +1,34 @@
</font><font color='#000088'>+2011-02-18 Joel Sherrill <joel.sherrill@oarcorp.com>
+
+ * sapi/include/confdefs.h, score/Makefile.am,
+ score/include/rtems/score/scheduler.h,
+ score/include/rtems/score/schedulerpriority.h,
+ score/include/rtems/score/thread.h,
+ score/inline/rtems/score/scheduler.inl,
+ score/inline/rtems/score/schedulerpriority.inl,
+ score/src/scheduler.c, score/src/schedulerpriority.c,
+ score/src/schedulerpriorityblock.c,
+ score/src/schedulerpriorityschedule.c,
+ score/src/schedulerpriorityunblock.c,
+ score/src/schedulerpriorityyield.c, score/src/threadchangepriority.c,
+ score/src/threadclose.c, score/src/threadinitialize.c,
+ score/src/threadsetpriority.c, score/src/threadsettransient.c:
+ Significant clean up on Scheduler Plugin Interface. Names were
+ shortened. Missing operations added. Many scheduler files had
+ unneeded includes removed. Made pointer to scheduler information in
+ Thread_Control and Scheduler_Control a void * pointer because the
+ thread and scheduler wrapper should be unaware of scheduler types AND
+ this is broken for user provided schedulers.
+ * score/src/schedulerpriorityallocate.c,
+ score/src/schedulerpriorityenqueue.c,
+ score/src/schedulerpriorityenqueuefirst.c,
+ score/src/schedulerpriorityextract.c,
+ score/src/schedulerpriorityfree.c,
+ score/src/schedulerpriorityupdate.c: New files.
+ * score/src/schedulerprioritythreadschedulerallocate.c,
+ score/src/schedulerprioritythreadschedulerfree.c,
+ score/src/schedulerprioritythreadschedulerupdate.c: Removed.
+
</font> 2011-02-17 Joel Sherrill <joel.sherrill@oarcorp.com>
* sapi/include/confdefs.h, sapi/include/rtems/config.h,
<font color='#006600'>diff -u rtems/cpukit/sapi/include/confdefs.h:1.155 rtems/cpukit/sapi/include/confdefs.h:1.156
--- rtems/cpukit/sapi/include/confdefs.h:1.155 Thu Feb 17 16:21:44 2011
+++ rtems/cpukit/sapi/include/confdefs.h Fri Feb 18 09:12:43 2011
</font><font color='#997700'>@@ -603,8 +603,8 @@
</font> */
#ifdef CONFIGURE_INIT
Scheduler_Control _Scheduler = {
<font color='#880000'>- .Ready_queues.priority = NULL,
- .Operations = SCHEDULER_ENTRY_POINTS
</font><font color='#000088'>+ .information = NULL,
+ .Operations = SCHEDULER_ENTRY_POINTS
</font> };
#endif
<font color='#006600'>diff -u rtems/cpukit/score/Makefile.am:1.90 rtems/cpukit/score/Makefile.am:1.91
--- rtems/cpukit/score/Makefile.am:1.90 Thu Dec 16 08:50:12 2010
+++ rtems/cpukit/score/Makefile.am Fri Feb 18 09:12:43 2011
</font><font color='#997700'>@@ -144,13 +144,16 @@
</font>
## SCHEDULERPRIORITY_C_FILES
libscore_a_SOURCES += src/schedulerpriority.c \
<font color='#880000'>- src/schedulerpriorityblock.c \
- src/schedulerprioritythreadschedulerallocate.c \
- src/schedulerprioritythreadschedulerfree.c \
- src/schedulerprioritythreadschedulerupdate.c \
- src/schedulerpriorityschedule.c \
- src/schedulerpriorityunblock.c \
- src/schedulerpriorityyield.c
</font><font color='#000088'>+ src/schedulerpriorityallocate.c \
+ src/schedulerpriorityblock.c \
+ src/schedulerpriorityenqueue.c \
+ src/schedulerpriorityenqueuefirst.c \
+ src/schedulerpriorityextract.c \
+ src/schedulerpriorityfree.c \
+ src/schedulerpriorityschedule.c \
+ src/schedulerpriorityunblock.c \
+ src/schedulerpriorityupdate.c \
+ src/schedulerpriorityyield.c
</font>
## PROTECTED_HEAP_C_FILES
libscore_a_SOURCES += src/pheapallocate.c \
<font color='#006600'>diff -u rtems/cpukit/score/include/rtems/score/scheduler.h:1.4 rtems/cpukit/score/include/rtems/score/scheduler.h:1.5
--- rtems/cpukit/score/include/rtems/score/scheduler.h:1.4 Thu Feb 17 16:21:44 2011
+++ rtems/cpukit/score/include/rtems/score/scheduler.h Fri Feb 18 09:12:43 2011
</font><font color='#997700'>@@ -36,35 +36,6 @@
</font> */
/**@{*/
<font color='#880000'>-typedef struct Scheduler_Control_struct Scheduler_Control;
-
-/*
- * This type defines the scheduler initialization table entry, which is set up
- * by confdefs.h based on the user's choice of scheduler policy.
- */
-typedef struct {
- void ( *scheduler_init )( Scheduler_Control * );
-} Scheduler_Table_entry;
-
-/**
- * The following Scheduler_Per_thread_xxx structures are used to
- * hold per-thread data used by the scheduler. Thread_Control->scheduler is a
- * union of pointers, one for each of the following structures. The
- * scheduler->xxx field points to an instantion of one of these structures,
- * which is allocated from the workspace during _Thread_Start.
- */
-
-/**
- * Per-thread data related to the _Scheduler_PRIORITY scheduling policy.
- */
-typedef struct {
- /** This field points to the Ready FIFO for this thread's priority. */
- Chain_Control *ready_chain;
-
- /** This field contains precalculated priority map indices. */
- Priority_bit_map_Information Priority_map;
-} Scheduler_priority_Per_thread;
-
</font> /**
* function jump table that holds pointers to the functions that
* implement specific schedulers.
<font color='#997700'>@@ -86,37 +57,39 @@
</font> void ( *unblock )(Thread_Control *);
/** allocates the scheduler field of the given thread */
<font color='#880000'>- void * ( *scheduler_allocate )(Thread_Control *);
</font><font color='#000088'>+ void * ( *allocate )(Thread_Control *);
</font>
/** frees the scheduler field of the given thread */
<font color='#880000'>- void ( *scheduler_free )(Thread_Control *);
</font><font color='#000088'>+ void ( *free )(Thread_Control *);
</font>
/** updates the scheduler field of the given thread -- primarily used
* when changing the thread's priority. */
<font color='#880000'>- void ( *scheduler_update )(Thread_Control *);
</font><font color='#000088'>+ void ( *update )(Thread_Control *);
+
+ /** enqueue a thread as the last of its priority group */
+ void ( *enqueue )(Thread_Control *);
+
+ /** enqueue a thread as the first of its priority group */
+ void ( *enqueue_first )(Thread_Control *);
+
+ /** extract a thread from the ready set */
+ void ( *extract )(Thread_Control *);
</font> } Scheduler_Operations;
/**
* This is the structure used to manage the scheduler.
*/
<font color='#880000'>-struct Scheduler_Control_struct {
</font><font color='#000088'>+typedef struct {
</font> /**
<font color='#880000'>- * This union contains the pointer to the data structure used to manage
- * the ready set of tasks. The pointer varies based upon the type of
</font><font color='#000088'>+ * This points to the data structure used to manage the ready set of
+ * tasks. The pointer varies based upon the type of
</font> * ready queue required by the scheduler.
*/
<font color='#880000'>- union {
- /**
- * This is the set of lists (an array of Chain_Control) for
- * priority scheduling.
- */
- Chain_Control *priority;
-
- } Ready_queues;
</font><font color='#000088'>+ void *information;
</font>
/** The jump table for scheduler-specific functions */
<font color='#880000'>- Scheduler_Operations Operations;
-};
</font><font color='#000088'>+ Scheduler_Operations Operations;
+} Scheduler_Control;
</font>
/**
* The _Scheduler holds the structures used to manage the
<font color='#006600'>diff -u rtems/cpukit/score/include/rtems/score/schedulerpriority.h:1.3 rtems/cpukit/score/include/rtems/score/schedulerpriority.h:1.4
--- rtems/cpukit/score/include/rtems/score/schedulerpriority.h:1.3 Thu Feb 17 16:21:44 2011
+++ rtems/cpukit/score/include/rtems/score/schedulerpriority.h Fri Feb 18 09:12:43 2011
</font><font color='#997700'>@@ -21,9 +21,7 @@
</font>
#include <rtems/score/chain.h>
#include <rtems/score/priority.h>
<font color='#880000'>-#include <rtems/score/percpu.h>
</font> #include <rtems/score/scheduler.h>
<font color='#880000'>-#include <rtems/score/wkspace.h>
</font>
#ifdef __cplusplus
extern "C" {
<font color='#997700'>@@ -40,17 +38,31 @@
</font> */
#define SCHEDULER_PRIORITY_ENTRY_POINTS \
{ \
<font color='#880000'>- .initialize = _Scheduler_priority_Initialize, \
- .schedule = _Scheduler_priority_Schedule, \
- .yield = _Scheduler_priority_Yield, \
- .block = _Scheduler_priority_Block, \
- .unblock = _Scheduler_priority_Unblock, \
- .scheduler_allocate = _Scheduler_priority_Thread_scheduler_allocate, \
- .scheduler_free = _Scheduler_priority_Thread_scheduler_free, \
- .scheduler_update = _Scheduler_priority_Thread_scheduler_update \
</font><font color='#000088'>+ .initialize = _Scheduler_priority_Initialize, \
+ .schedule = _Scheduler_priority_Schedule, \
+ .yield = _Scheduler_priority_Yield, \
+ .block = _Scheduler_priority_Block, \
+ .unblock = _Scheduler_priority_Unblock, \
+ .allocate = _Scheduler_priority_Allocate, \
+ .free = _Scheduler_priority_Free, \
+ .update = _Scheduler_priority_Update, \
+ .enqueue = _Scheduler_priority_Enqueue, \
+ .enqueue_first = _Scheduler_priority_Enqueue_first, \
+ .extract = _Scheduler_priority_Extract \
</font> }
/**
<font color='#000088'>+ * Per-thread data related to the _Scheduler_PRIORITY scheduling policy.
+ */
+typedef struct {
+ /** This field points to the Ready FIFO for this thread's priority. */
+ Chain_Control *ready_chain;
+
+ /** This field contains precalculated priority map indices. */
+ Priority_bit_map_Information Priority_map;
+} Scheduler_priority_Per_thread;
+
+/**
</font> * This routine initializes the priority scheduler.
*/
void _Scheduler_priority_Initialize(void);
<font color='#997700'>@@ -60,6 +72,8 @@
</font> * that is, removes it from the ready queue. It performs
* any necessary scheduling operations including the selection of
* a new heir thread.
<font color='#000088'>+ *
+ * @param[in] the_thread is the thread to be blocked
</font> */
void _Scheduler_priority_Block(<span style="background-color: #FF0000"> </span>
Thread_Control *the_thread<span style="background-color: #FF0000"> </span>
<font color='#997700'>@@ -72,24 +86,33 @@
</font> void _Scheduler_priority_Schedule(void);
/**
<font color='#880000'>- * This routine allocates @a the_thread->scheduler.
</font><font color='#000088'>+ * This routine allocates @a the_thread->scheduler.
+ *
+ * @param[in] the_thread is the thread the scheduler is allocating
+ * management memory for
</font> */
<font color='#880000'>-void * _Scheduler_priority_Thread_scheduler_allocate(
</font><font color='#000088'>+void * _Scheduler_priority_Allocate(
</font> Thread_Control *the_thread
);
/**
<font color='#880000'>- * This routine frees @a the_thread->scheduler.
</font><font color='#000088'>+ * This routine frees @a the_thread->scheduler.
+ *
+ * @param[in] the_thread is the thread whose scheduler specific information
+ * will be deallocated.
</font> */
<font color='#880000'>-void _Scheduler_priority_Thread_scheduler_free(
</font><font color='#000088'>+void _Scheduler_priority_Free(
</font> Thread_Control *the_thread
);
/**
<font color='#880000'>- * This routine updates @a the_thread->scheduler based on @a the_scheduler<span style="background-color: #FF0000"> </span>
- * structures and thread state
</font><font color='#000088'>+ * This routine updates @a the_thread->scheduler based on @a the_scheduler<span style="background-color: #FF0000"> </span>
+ * structures and thread state.
+ *
+ * @param[in] the_thread will have its scheduler specific information
+ * structure updated.
</font> */
<font color='#880000'>-void _Scheduler_priority_Thread_scheduler_update(
</font><font color='#000088'>+void _Scheduler_priority_Update(
</font> Thread_Control *the_thread
);
<font color='#997700'>@@ -97,6 +120,8 @@
</font> * This routine adds @a the_thread to the scheduling decision,<span style="background-color: #FF0000"> </span>
* that is, adds it to the ready queue and<span style="background-color: #FF0000"> </span>
* updates any appropriate scheduling variables, for example the heir thread.
<font color='#000088'>+ *
+ * @param[in] the_thread will be unblocked
</font> */
void _Scheduler_priority_Unblock(
Thread_Control *the_thread<span style="background-color: #FF0000"> </span>
<font color='#997700'>@@ -115,6 +140,36 @@
</font> */
void _Scheduler_priority_Yield( void );
<font color='#000088'>+/**
+ * This routine puts @a the_thread on to the priority-based ready queue.
+ *
+ * @param[in] the_thread will be enqueued at the TAIL of its priority.
+ */
+void _Scheduler_priority_Enqueue(
+ Thread_Control *the_thread
+);
+
+/**
+ * This routine puts @a the_thread to the head of the ready queue.<span style="background-color: #FF0000"> </span>
+ * For priority-based ready queues, the thread will be the first thread
+ * at its priority level.
+ *
+ * @param[in] the_thread will be enqueued at the HEAD of its priority.
+ */
+void _Scheduler_priority_Enqueue_first(
+ Thread_Control *the_thread
+);
+
+/**
+ * This routine removes a specific thread from the scheduler's set
+ * of ready threads.
+ *
+ * @param[in] the_thread will be extracted from the ready set.
+ */
+void _Scheduler_priority_Extract(
+ Thread_Control *the_thread
+);
+
</font> #ifndef __RTEMS_APPLICATION__
#include <rtems/score/schedulerpriority.inl>
#endif
<font color='#006600'>diff -u rtems/cpukit/score/include/rtems/score/thread.h:1.98 rtems/cpukit/score/include/rtems/score/thread.h:1.99
--- rtems/cpukit/score/include/rtems/score/thread.h:1.98 Wed Nov 24 09:51:27 2010
+++ rtems/cpukit/score/include/rtems/score/thread.h Fri Feb 18 09:12:43 2011
</font><font color='#997700'>@@ -6,7 +6,7 @@
</font> */
/*
<font color='#880000'>- * COPYRIGHT (c) 1989-2009.
</font><font color='#000088'>+ * COPYRIGHT (c) 1989-2011.
</font> * On-Line Applications Research Corporation (OAR).
*
* The license and distribution terms for this file may be
<font color='#997700'>@@ -390,10 +390,10 @@
</font> * since it was created.
*/
Thread_CPU_usage_t cpu_time_used;
<font color='#880000'>- /** This union holds per-thread data for the scheduler and ready queue. */
- union {
- Scheduler_priority_Per_thread *priority;
- } scheduler;
</font><font color='#000088'>+
+ /** This pointer holds per-thread data for the scheduler and ready queue. */
+ void *scheduler_info;
+
</font> /** This field contains information about the starting state of
* this thread.
*/
<font color='#006600'>diff -u rtems/cpukit/score/inline/rtems/score/scheduler.inl:1.3 rtems/cpukit/score/inline/rtems/score/scheduler.inl:1.4
--- rtems/cpukit/score/inline/rtems/score/scheduler.inl:1.3 Thu Feb 17 16:21:44 2011
+++ rtems/cpukit/score/inline/rtems/score/scheduler.inl Fri Feb 18 09:12:43 2011
</font><font color='#997700'>@@ -93,37 +93,70 @@
</font> _Scheduler.Operations.unblock( the_thread );
}
<font color='#880000'>-/** @brief _Scheduler_Thread_scheduler_allocate
</font><font color='#000088'>+/** @brief _Scheduler_Allocate
</font> *
* This routine allocates @a the_thread->scheduler
*/
<font color='#880000'>-RTEMS_INLINE_ROUTINE void* _Scheduler_Thread_scheduler_allocate(<span style="background-color: #FF0000"> </span>
</font><font color='#000088'>+RTEMS_INLINE_ROUTINE void* _Scheduler_Allocate(<span style="background-color: #FF0000"> </span>
</font> Thread_Control *the_thread
)
{
<font color='#880000'>- return _Scheduler.Operations.scheduler_allocate( the_thread );
</font><font color='#000088'>+ return _Scheduler.Operations.allocate( the_thread );
</font> }
<font color='#880000'>-/** @brief _Scheduler_Thread_scheduler_free
</font><font color='#000088'>+/** @brief _Scheduler_Free
</font> *
* This routine frees @a the_thread->scheduler
*/
<font color='#880000'>-RTEMS_INLINE_ROUTINE void _Scheduler_Thread_scheduler_free(<span style="background-color: #FF0000"> </span>
</font><font color='#000088'>+RTEMS_INLINE_ROUTINE void _Scheduler_Free(<span style="background-color: #FF0000"> </span>
</font> Thread_Control *the_thread
)
{
<font color='#880000'>- return _Scheduler.Operations.scheduler_free( the_thread );
</font><font color='#000088'>+ return _Scheduler.Operations.free( the_thread );
</font> }
<font color='#880000'>-/** @brief _Scheduler_Thread_scheduler_update
</font><font color='#000088'>+/** @brief _Scheduler_Update
</font> *
* This routine updates @a the_thread->scheduler
*/
<font color='#880000'>-RTEMS_INLINE_ROUTINE void _Scheduler_Thread_scheduler_update(<span style="background-color: #FF0000"> </span>
</font><font color='#000088'>+RTEMS_INLINE_ROUTINE void _Scheduler_Update(<span style="background-color: #FF0000"> </span>
</font> Thread_Control *the_thread
)
{
<font color='#880000'>- _Scheduler.Operations.scheduler_update( the_thread );
</font><font color='#000088'>+ _Scheduler.Operations.update( the_thread );
+}
+
+/** @brief _Scheduler_Enqueue
+ *
+ * This routine enqueue @a the_thread->scheduler
+ */
+RTEMS_INLINE_ROUTINE void _Scheduler_Enqueue(<span style="background-color: #FF0000"> </span>
+ Thread_Control *the_thread
+)
+{
+ _Scheduler.Operations.enqueue( the_thread );
+}
+
+/** @brief _Scheduler_Enqueue_first
+ *
+ * This routine enqueue_first @a the_thread->scheduler
+ */
+RTEMS_INLINE_ROUTINE void _Scheduler_Enqueue_first(<span style="background-color: #FF0000"> </span>
+ Thread_Control *the_thread
+)
+{
+ _Scheduler.Operations.enqueue_first( the_thread );
+}
+
+/** @brief _Scheduler_Extract
+ *
+ * This routine extract @a the_thread->scheduler
+ */
+RTEMS_INLINE_ROUTINE void _Scheduler_Extract(<span style="background-color: #FF0000"> </span>
+ Thread_Control *the_thread
+)
+{
+ _Scheduler.Operations.extract( the_thread );
</font> }
/**@}*/
<font color='#006600'>diff -u rtems/cpukit/score/inline/rtems/score/schedulerpriority.inl:1.4 rtems/cpukit/score/inline/rtems/score/schedulerpriority.inl:1.5
--- rtems/cpukit/score/inline/rtems/score/schedulerpriority.inl:1.4 Thu Feb 17 16:21:44 2011
+++ rtems/cpukit/score/inline/rtems/score/schedulerpriority.inl Fri Feb 18 09:12:43 2011
</font><font color='#997700'>@@ -23,6 +23,8 @@
</font> #ifndef _RTEMS_SCORE_SCHEDULERPRIORITY_INL
#define _RTEMS_SCORE_SCHEDULERPRIORITY_INL
<font color='#000088'>+#include <rtems/score/wkspace.h>
+
</font> /**
* @addtogroup ScoreScheduler
* @{
<font color='#997700'>@@ -34,17 +36,18 @@
</font> */
RTEMS_INLINE_ROUTINE void _Scheduler_priority_Ready_queue_initialize(void)
{
<font color='#880000'>- size_t index;
</font><font color='#000088'>+ size_t index;
+ Chain_Control *ready_queues;
</font>
/* allocate ready queue structures */
<font color='#880000'>- _Scheduler.Ready_queues.priority = (Chain_Control *)<span style="background-color: #FF0000"> </span>
- _Workspace_Allocate_or_fatal_error(
- ((size_t) PRIORITY_MAXIMUM + 1) * sizeof(Chain_Control)
- );
</font><font color='#000088'>+ _Scheduler.information = _Workspace_Allocate_or_fatal_error(
+ ((size_t) PRIORITY_MAXIMUM + 1) * sizeof(Chain_Control)
+ );
</font>
/* initialize ready queue structures */
<font color='#000088'>+ ready_queues = (Chain_Control *) _Scheduler.information;
</font> for( index=0; index <= PRIORITY_MAXIMUM; index++)
<font color='#880000'>- _Chain_Initialize_empty( &_Scheduler.Ready_queues.priority[index] );
</font><font color='#000088'>+ _Chain_Initialize_empty( &ready_queues[index] );
</font> }
/**
<font color='#997700'>@@ -58,10 +61,15 @@
</font> Thread_Control *the_thread
)
{
<font color='#880000'>- _Priority_bit_map_Add( &the_thread->scheduler.priority->Priority_map );
</font><font color='#000088'>+ Scheduler_priority_Per_thread *sched_info;
+ Chain_Control *ready;
+
+ sched_info = (Scheduler_priority_Per_thread *) the_thread->scheduler_info;
+ ready = sched_info->ready_chain;
+
+ _Priority_bit_map_Add( &sched_info->Priority_map );
</font>
<font color='#880000'>- _Chain_Append_unprotected( the_thread->scheduler.priority->ready_chain,<span style="background-color: #FF0000"> </span>
- &the_thread->Object.Node );
</font><font color='#000088'>+ _Chain_Append_unprotected( ready, &the_thread->Object.Node );
</font> }
/**
<font color='#997700'>@@ -77,10 +85,18 @@
</font> Thread_Control *the_thread
)
{
<font color='#880000'>- _Priority_bit_map_Add( &the_thread->scheduler.priority->Priority_map );
</font><font color='#000088'>+ Scheduler_priority_Per_thread *sched_info;
+ Chain_Control *ready;
</font>
<font color='#880000'>- _Chain_Prepend_unprotected( the_thread->scheduler.priority->ready_chain,<span style="background-color: #FF0000"> </span>
- &the_thread->Object.Node );
</font><font color='#000088'>+ sched_info = (Scheduler_priority_Per_thread *) the_thread->scheduler_info;
+ ready = sched_info->ready_chain;
+
+ _Priority_bit_map_Add( &sched_info->Priority_map );
+
+ _Chain_Prepend_unprotected(
+ sched_info->ready_chain,
+ &the_thread->Object.Node
+ );
</font> }
/**
<font color='#997700'>@@ -95,13 +111,18 @@
</font> Thread_Control *the_thread
)
{
<font color='#880000'>- Chain_Control *ready = the_thread->scheduler.priority->ready_chain;
</font><font color='#000088'>+ Scheduler_priority_Per_thread *sched_info;
+ Chain_Control *ready;
+
+ sched_info = (Scheduler_priority_Per_thread *) the_thread->scheduler_info;
+ ready = sched_info->ready_chain;
</font>
if ( _Chain_Has_only_one_node( ready ) ) {
_Chain_Initialize_empty( ready );
<font color='#880000'>- _Priority_bit_map_Remove( &the_thread->scheduler.priority->Priority_map );
- } else
</font><font color='#000088'>+ _Priority_bit_map_Remove( &sched_info->Priority_map );
+ } else {
</font> _Chain_Extract_unprotected( &the_thread->Object.Node );
<font color='#000088'>+ }
</font> }
/**
<font color='#997700'>@@ -137,13 +158,19 @@
</font> Thread_Control *the_thread
)
{
<font color='#880000'>- if ( !_Chain_Has_only_one_node(
- the_thread->scheduler.priority->ready_chain
- ) ) {
</font><font color='#000088'>+ Scheduler_priority_Per_thread *sched_info;
+ Chain_Control *ready;
+
+ sched_info = (Scheduler_priority_Per_thread *) the_thread->scheduler_info;
+ ready = sched_info->ready_chain;
+
+ if ( !_Chain_Has_only_one_node( sched_info->ready_chain ) ) {
</font> _Chain_Extract_unprotected( &the_thread->Object.Node );
<font color='#880000'>- _Chain_Append_unprotected( the_thread->scheduler.priority->ready_chain,<span style="background-color: #FF0000"> </span>
- &the_thread->Object.Node );
</font><font color='#000088'>+ _Chain_Append_unprotected(
+ sched_info->ready_chain,<span style="background-color: #FF0000"> </span>
+ &the_thread->Object.Node
+ );
</font> }
}
<font color='#997700'>@@ -158,74 +185,10 @@
</font> RTEMS_INLINE_ROUTINE void _Scheduler_priority_Schedule_body(void)
{
_Thread_Heir = _Scheduler_priority_Ready_queue_first(
<font color='#880000'>- _Scheduler.Ready_queues.priority
</font><font color='#000088'>+ (Chain_Control *) _Scheduler.information
</font> );
}
<font color='#880000'>-/**
- * @brief _Scheduler_priority_Block_body
- *
- * This kernel routine removes the_thread from scheduling decisions based<span style="background-color: #FF0000"> </span>
- * on simple queue extraction.
- *
- * @param[in] the_thread - pointer to thread
- */
-RTEMS_INLINE_ROUTINE void _Scheduler_priority_Block_body(
- Thread_Control *the_thread
-)
-{
- _Scheduler_priority_Ready_queue_extract(the_thread);
-
- /* TODO: flash critical section */
-
- if ( _Thread_Is_heir( the_thread ) )
- _Scheduler_priority_Schedule_body();
-
- if ( _Thread_Is_executing( the_thread ) )
- _Thread_Dispatch_necessary = true;
-
- return;
-}
-
-/**
- * @brief _Scheduler_priority_Unblock_body
- *
- * This kernel routine readies the requested thread according to the queuing<span style="background-color: #FF0000"> </span>
- * discipline. A new heir thread may be selected.
- *
- * @param[in] the_thread - pointer to thread
- *
- * @note This routine uses the "blocking" heir selection mechanism.
- * This ensures the correct heir after a thread restart.
- */
-RTEMS_INLINE_ROUTINE void _Scheduler_priority_Unblock_body (
- Thread_Control *the_thread
-)
-{
- _Scheduler_priority_Ready_queue_enqueue(the_thread);
-
- /* TODO: flash critical section */
-
- /*
- * If the thread that was unblocked is more important than the heir,
- * then we have a new heir. This may or may not result in a
- * context switch.
- *
- * Normal case:
- * If the current thread is preemptible, then we need to do
- * a context switch.
- * Pseudo-ISR case:
- * Even if the thread isn't preemptible, if the new heir is
- * a pseudo-ISR system task, we need to do a context switch.
- */
- if ( the_thread->current_priority < _Thread_Heir->current_priority ) {
- _Thread_Heir = the_thread;
- if ( _Thread_Executing->is_preemptible ||
- the_thread->current_priority == 0 )
- _Thread_Dispatch_necessary = true;
- }
-}
-
</font> /**@}*/
#endif
<font color='#006600'>diff -u rtems/cpukit/score/src/scheduler.c:1.2 rtems/cpukit/score/src/scheduler.c:1.3
--- rtems/cpukit/score/src/scheduler.c:1.2 Thu Feb 17 16:21:44 2011
+++ rtems/cpukit/score/src/scheduler.c Fri Feb 18 09:12:43 2011
</font><font color='#997700'>@@ -1,5 +1,5 @@
</font> /*
<font color='#880000'>- * Scheduler Handler
</font><font color='#000088'>+ * Scheduler Handler / Initialization
</font> *
* Copyright (C) 2010 Gedare Bloom.
* Copyright (C) 2011 On-Line Applications Research Corporation (OAR).
<font color='#997700'>@@ -17,24 +17,8 @@
</font>
#include <rtems/system.h>
#include <rtems/config.h>
<font color='#880000'>-#include <rtems/score/chain.h>
-#include <rtems/score/isr.h>
-#include <rtems/score/object.h>
</font> #include <rtems/score/scheduler.h>
<font color='#880000'>-#include <rtems/score/schedulerpriority.h>
-#include <rtems/score/states.h>
-#include <rtems/score/thread.h>
</font>
<font color='#880000'>-/*
- * _Scheduler_Handler_initialization
- *
- * This routine initializes the scheduler by calling the scheduler
- * initialize function registered in the Configuration Scheduler Table.
- *
- * Input parameters: NONE
- *
- * Output parameters: NONE
- */
</font> void _Scheduler_Handler_initialization(void)
{
(*_Scheduler.Operations.initialize)();
<font color='#006600'>diff -u rtems/cpukit/score/src/schedulerpriority.c:1.3 rtems/cpukit/score/src/schedulerpriority.c:1.4
--- rtems/cpukit/score/src/schedulerpriority.c:1.3 Thu Feb 17 16:21:44 2011
+++ rtems/cpukit/score/src/schedulerpriority.c Fri Feb 18 09:12:43 2011
</font><font color='#997700'>@@ -17,13 +17,9 @@
</font>
#include <rtems/system.h>
#include <rtems/config.h>
<font color='#880000'>-#include <rtems/score/chain.h>
-#include <rtems/score/isr.h>
-#include <rtems/score/object.h>
</font><font color='#000088'>+#include <rtems/score/prioritybitmap.h>
</font> #include <rtems/score/scheduler.h>
#include <rtems/score/schedulerpriority.h>
<font color='#880000'>-#include <rtems/score/states.h>
-#include <rtems/score/thread.h>
</font>
/* Instantiate any global variables needed by the priority scheduler */
volatile Priority_bit_map_Control _Priority_Major_bit_map;
<font color='#006600'>diff -u /dev/null rtems/cpukit/score/src/schedulerpriorityallocate.c:1.1
--- /dev/null Fri Feb 18 10:10:30 2011
+++ rtems/cpukit/score/src/schedulerpriorityallocate.c Fri Feb 18 09:12:43 2011
</font><font color='#997700'>@@ -0,0 +1,35 @@
</font><font color='#000088'>+/*
+ * Scheduler Priority Handler / Allocate
+ *
+ * Copyright (C) 2010 Gedare Bloom.
+ * Copyright (C) 2011 On-Line Applications Research Corporation (OAR).
+ *
+ * The license and distribution terms for this file may be
+ * found in the file LICENSE in this distribution or at
+ * http://www.rtems.com/license/LICENSE.
+ *
+ * $Id$
+ */
+
+#if HAVE_CONFIG_H
+#include "config.h"
+#endif
+
+#include <rtems/system.h>
+#include <rtems/config.h>
+#include <rtems/score/scheduler.h>
+#include <rtems/score/schedulerpriority.h>
+#include <rtems/score/wkspace.h>
+
+void* _Scheduler_priority_Allocate (
+ Thread_Control *the_thread
+)
+{
+ void *sched;
+
+ sched = _Workspace_Allocate( sizeof(Scheduler_priority_Per_thread) );
+
+ the_thread->scheduler_info = (Scheduler_priority_Per_thread*) sched;
+
+ return sched;
+}
</font>
<font color='#006600'>diff -u rtems/cpukit/score/src/schedulerpriorityblock.c:1.3 rtems/cpukit/score/src/schedulerpriorityblock.c:1.4
--- rtems/cpukit/score/src/schedulerpriorityblock.c:1.3 Thu Feb 17 16:21:44 2011
+++ rtems/cpukit/score/src/schedulerpriorityblock.c Fri Feb 18 09:12:43 2011
</font><font color='#997700'>@@ -29,5 +29,14 @@
</font> Thread_Control *the_thread
)
{
<font color='#880000'>- _Scheduler_priority_Block_body(the_thread);
</font><font color='#000088'>+ _Scheduler_priority_Ready_queue_extract( the_thread );
+
+ /* TODO: flash critical section? */
+
+ if ( _Thread_Is_heir( the_thread ) )
+ _Scheduler_priority_Schedule_body();
+
+ if ( _Thread_Is_executing( the_thread ) )
+ _Thread_Dispatch_necessary = true;
+
</font> }
<font color='#006600'>diff -u /dev/null rtems/cpukit/score/src/schedulerpriorityenqueue.c:1.1
--- /dev/null Fri Feb 18 10:10:30 2011
+++ rtems/cpukit/score/src/schedulerpriorityenqueue.c Fri Feb 18 09:12:44 2011
</font><font color='#997700'>@@ -0,0 +1,26 @@
</font><font color='#000088'>+/*
+ * COPYRIGHT (c) 2011.
+ * On-Line Applications Research Corporation (OAR).
+ *
+ * The license and distribution terms for this file may be
+ * found in the file LICENSE in this distribution or at
+ * http://www.rtems.com/license/LICENSE.
+ *
+ * $Id$
+ */
+
+#if HAVE_CONFIG_H
+#include "config.h"
+#endif
+
+#include <rtems/system.h>
+#include <rtems/config.h>
+#include <rtems/score/scheduler.h>
+#include <rtems/score/schedulerpriority.h>
+
+void _Scheduler_priority_Enqueue(<span style="background-color: #FF0000"> </span>
+ Thread_Control *the_thread
+)
+{
+ _Scheduler_priority_Ready_queue_enqueue( the_thread );
+}
</font>
<font color='#006600'>diff -u /dev/null rtems/cpukit/score/src/schedulerpriorityenqueuefirst.c:1.1
--- /dev/null Fri Feb 18 10:10:30 2011
+++ rtems/cpukit/score/src/schedulerpriorityenqueuefirst.c Fri Feb 18 09:12:44 2011
</font><font color='#997700'>@@ -0,0 +1,27 @@
</font><font color='#000088'>+/*
+ * COPYRIGHT (c) 2011.
+ * On-Line Applications Research Corporation (OAR).
+ *
+ * The license and distribution terms for this file may be
+ * found in the file LICENSE in this distribution or at
+ * http://www.rtems.com/license/LICENSE.
+ *
+ * $Id$
+ */
+
+#if HAVE_CONFIG_H
+#include "config.h"
+#endif
+
+#include <rtems/system.h>
+#include <rtems/config.h>
+#include <rtems/score/chain.h>
+#include <rtems/score/schedulerpriority.h>
+
+void _Scheduler_priority_Enqueue_first(<span style="background-color: #FF0000"> </span>
+ Thread_Control *the_thread
+)
+{
+ _Scheduler_priority_Ready_queue_enqueue_first( the_thread );
+}
+
</font>
<font color='#006600'>diff -u /dev/null rtems/cpukit/score/src/schedulerpriorityextract.c:1.1
--- /dev/null Fri Feb 18 10:10:31 2011
+++ rtems/cpukit/score/src/schedulerpriorityextract.c Fri Feb 18 09:12:44 2011
</font><font color='#997700'>@@ -0,0 +1,26 @@
</font><font color='#000088'>+/*
+ * COPYRIGHT (c) 2011.
+ * On-Line Applications Research Corporation (OAR).
+ *
+ * The license and distribution terms for this file may be
+ * found in the file LICENSE in this distribution or at
+ * http://www.rtems.com/license/LICENSE.
+ *
+ * $Id$
+ */
+
+#if HAVE_CONFIG_H
+#include "config.h"
+#endif
+
+#include <rtems/system.h>
+#include <rtems/config.h>
+#include <rtems/score/chain.h>
+#include <rtems/score/schedulerpriority.h>
+
+void _Scheduler_priority_Extract(<span style="background-color: #FF0000"> </span>
+ Thread_Control *the_thread
+)
+{
+ _Scheduler_priority_Ready_queue_extract( the_thread );
+}
</font>
<font color='#006600'>diff -u /dev/null rtems/cpukit/score/src/schedulerpriorityfree.c:1.1
--- /dev/null Fri Feb 18 10:10:31 2011
+++ rtems/cpukit/score/src/schedulerpriorityfree.c Fri Feb 18 09:12:44 2011
</font><font color='#997700'>@@ -0,0 +1,29 @@
</font><font color='#000088'>+/*
+ * Scheduler Handler
+ *
+ * Copyright (C) 2010 Gedare Bloom.
+ * Copyright (C) 2011 On-Line Applications Research Corporation (OAR).
+ *
+ * The license and distribution terms for this file may be
+ * found in the file LICENSE in this distribution or at
+ * http://www.rtems.com/license/LICENSE.
+ *
+ * $Id$
+ */
+
+#if HAVE_CONFIG_H
+#include "config.h"
+#endif
+
+#include <rtems/system.h>
+#include <rtems/config.h>
+#include <rtems/score/scheduler.h>
+#include <rtems/score/schedulerpriority.h>
+#include <rtems/score/wkspace.h>
+
+void _Scheduler_priority_Free (
+ Thread_Control *the_thread
+)
+{
+ _Workspace_Free( the_thread->scheduler_info );
+}
</font>
<font color='#006600'>diff -u rtems/cpukit/score/src/schedulerpriorityschedule.c:1.3 rtems/cpukit/score/src/schedulerpriorityschedule.c:1.4
--- rtems/cpukit/score/src/schedulerpriorityschedule.c:1.3 Thu Feb 17 16:21:44 2011
+++ rtems/cpukit/score/src/schedulerpriorityschedule.c Fri Feb 18 09:12:44 2011
</font><font color='#997700'>@@ -1,5 +1,5 @@
</font> /*
<font color='#880000'>- * Scheduler Handler
</font><font color='#000088'>+ * Scheduler Handler / Scheduler
</font> *
* Copyright (C) 2010 Gedare Bloom.
* Copyright (C) 2011 On-Line Applications Research Corporation (OAR).
<font color='#006600'>diff -u rtems/cpukit/score/src/schedulerpriorityunblock.c:1.3 rtems/cpukit/score/src/schedulerpriorityunblock.c:1.4
--- rtems/cpukit/score/src/schedulerpriorityunblock.c:1.3 Thu Feb 17 16:21:44 2011
+++ rtems/cpukit/score/src/schedulerpriorityunblock.c Fri Feb 18 09:12:44 2011
</font><font color='#997700'>@@ -23,5 +23,26 @@
</font> Thread_Control *the_thread
)
{
<font color='#880000'>- _Scheduler_priority_Unblock_body(the_thread);
</font><font color='#000088'>+ _Scheduler_priority_Ready_queue_enqueue(the_thread);
+
+ /* TODO: flash critical section? */
+
+ /*
+ * If the thread that was unblocked is more important than the heir,
+ * then we have a new heir. This may or may not result in a
+ * context switch.
+ *
+ * Normal case:
+ * If the current thread is preemptible, then we need to do
+ * a context switch.
+ * Pseudo-ISR case:
+ * Even if the thread isn't preemptible, if the new heir is
+ * a pseudo-ISR system task, we need to do a context switch.
+ */
+ if ( the_thread->current_priority < _Thread_Heir->current_priority ) {
+ _Thread_Heir = the_thread;
+ if ( _Thread_Executing->is_preemptible ||
+ the_thread->current_priority == 0 )
+ _Thread_Dispatch_necessary = true;
+ }
</font> }
<font color='#006600'>diff -u /dev/null rtems/cpukit/score/src/schedulerpriorityupdate.c:1.1
--- /dev/null Fri Feb 18 10:10:31 2011
+++ rtems/cpukit/score/src/schedulerpriorityupdate.c Fri Feb 18 09:12:44 2011
</font><font color='#997700'>@@ -0,0 +1,43 @@
</font><font color='#000088'>+/*
+ * Scheduler Handler
+ *
+ * Copyright (C) 2010 Gedare Bloom.
+ * Copyright (C) 2011 On-Line Applications Research Corporation (OAR).
+ *
+ * The license and distribution terms for this file may be
+ * found in the file LICENSE in this distribution or at
+ * http://www.rtems.com/license/LICENSE.
+ *
+ * $Id$
+ */
+
+#if HAVE_CONFIG_H
+#include "config.h"
+#endif
+
+#include <rtems/system.h>
+#include <rtems/config.h>
+#include <rtems/score/priority.h>
+#include <rtems/score/prioritybitmap.h>
+#include <rtems/score/scheduler.h>
+#include <rtems/score/schedulerpriority.h>
+#include <rtems/score/thread.h>
+
+void _Scheduler_priority_Update(
+ Thread_Control *the_thread
+)
+{
+ Scheduler_priority_Per_thread *sched_info;
+ Chain_Control *rq;
+
+ sched_info = (Scheduler_priority_Per_thread *) the_thread->scheduler_info;
+ rq = (Chain_Control *) _Scheduler.information;
+
+
+ sched_info->ready_chain = &rq[ the_thread->current_priority ];
+
+ _Priority_bit_map_Initialize_information(<span style="background-color: #FF0000"> </span>
+ &sched_info->Priority_map,<span style="background-color: #FF0000"> </span>
+ the_thread->current_priority<span style="background-color: #FF0000"> </span>
+ );
+}
</font>
<font color='#006600'>diff -u rtems/cpukit/score/src/schedulerpriorityyield.c:1.5 rtems/cpukit/score/src/schedulerpriorityyield.c:1.6
--- rtems/cpukit/score/src/schedulerpriorityyield.c:1.5 Thu Feb 17 16:21:44 2011
+++ rtems/cpukit/score/src/schedulerpriorityyield.c Fri Feb 18 09:12:44 2011
</font><font color='#997700'>@@ -1,7 +1,8 @@
</font> /*
<font color='#880000'>- * Scheduler Handler
</font><font color='#000088'>+ * Scheduler Priority Handler / Yield
</font> *
* Copyright (C) 2010 Gedare Bloom.
<font color='#000088'>+ * Copyright (C) 2011 On-Line Applications Research Corporation (OAR).
</font> *
* The license and distribution terms for this file may be
* found in the file LICENSE in this distribution or at
<font color='#997700'>@@ -15,19 +16,10 @@
</font> #endif
#include <rtems/system.h>
<font color='#880000'>-#include <rtems/score/apiext.h>
-#include <rtems/score/context.h>
-#include <rtems/score/interr.h>
</font> #include <rtems/score/isr.h>
<font color='#880000'>-#include <rtems/score/object.h>
-#include <rtems/score/priority.h>
</font> #include <rtems/score/scheduler.h>
<font color='#880000'>-#include <rtems/score/states.h>
-#include <rtems/score/sysstate.h>
</font><font color='#000088'>+#include <rtems/score/schedulerpriority.h>
</font> #include <rtems/score/thread.h>
<font color='#880000'>-#include <rtems/score/threadq.h>
-#include <rtems/score/userext.h>
-#include <rtems/score/wkspace.h>
</font>
/*
* INTERRUPT LATENCY:
<font color='#997700'>@@ -37,12 +29,14 @@
</font>
void _Scheduler_priority_Yield(void)
{
<font color='#880000'>- ISR_Level level;
- Thread_Control *executing;
- Chain_Control *ready;
-
- executing = _Thread_Executing;
- ready = executing->scheduler.priority->ready_chain;
</font><font color='#000088'>+ Scheduler_priority_Per_thread *sched_info;
+ ISR_Level level;
+ Thread_Control *executing;
+ Chain_Control *ready;
+
+ executing = _Thread_Executing;
+ sched_info = (Scheduler_priority_Per_thread *) executing->scheduler_info;
+ ready = sched_info->ready_chain;
</font> _ISR_Disable( level );
if ( !_Chain_Has_only_one_node( ready ) ) {
_Chain_Extract_unprotected( &executing->Object.Node );
<font color='#006600'>diff -u rtems/cpukit/score/src/threadchangepriority.c:1.17 rtems/cpukit/score/src/threadchangepriority.c:1.18
--- rtems/cpukit/score/src/threadchangepriority.c:1.17 Thu Feb 17 16:21:44 2011
+++ rtems/cpukit/score/src/threadchangepriority.c Fri Feb 18 09:12:44 2011
</font><font color='#997700'>@@ -1,8 +1,7 @@
</font> /*
<font color='#880000'>- * Thread Handler
</font><font color='#000088'>+ * Thread Handler / Change Priority
</font> *
<font color='#880000'>- *
- * COPYRIGHT (c) 1989-2006.
</font><font color='#000088'>+ * COPYRIGHT (c) 1989-2011.
</font> * On-Line Applications Research Corporation (OAR).
*
* The license and distribution terms for this file may be
<font color='#997700'>@@ -33,21 +32,6 @@
</font> States_Control state, original_state;
/*
<font color='#880000'>- * If this is a case where prepending the task to its priority is
- * potentially desired, then we need to consider whether to do it.
- * This usually occurs when a task lowers its priority implcitly as
- * the result of losing inherited priority. Normal explicit priority
- * change calls (e.g. rtems_task_set_priority) should always do an
- * append not a prepend.
- */
-/*
- if ( prepend_it &&
- _Thread_Is_executing( the_thread ) &&
- new_priority >= the_thread->current_priority )
- prepend_it = true;
-*/
-
- /*
</font> * Save original state
*/
original_state = the_thread->current_state;
<font color='#997700'>@@ -91,16 +75,13 @@
</font> * We now know the thread will be in the READY state when we remove
* the TRANSIENT state. So we have to place it on the appropriate
* Ready Queue with interrupts off.
<font color='#880000'>- *
- * FIXME: hard-coded for priority scheduling. Might be ok since this<span style="background-color: #FF0000"> </span>
- * function is specific to priority scheduling?
</font> */
the_thread->current_state = _States_Clear( STATES_TRANSIENT, state );
if ( prepend_it )
<font color='#880000'>- _Scheduler_priority_Ready_queue_enqueue_first( the_thread );
</font><font color='#000088'>+ _Scheduler_Enqueue_first( the_thread );
</font> else
<font color='#880000'>- _Scheduler_priority_Ready_queue_enqueue( the_thread );
</font><font color='#000088'>+ _Scheduler_Enqueue( the_thread );
</font> }
_ISR_Flash( level );
<font color='#006600'>diff -u rtems/cpukit/score/src/threadclose.c:1.16 rtems/cpukit/score/src/threadclose.c:1.17
--- rtems/cpukit/score/src/threadclose.c:1.16 Thu Feb 17 16:21:44 2011
+++ rtems/cpukit/score/src/threadclose.c Fri Feb 18 09:12:44 2011
</font><font color='#997700'>@@ -35,7 +35,6 @@
</font> Thread_Control *the_thread
)
{
<font color='#880000'>-
</font> /*
* Now we are in a dispatching critical section again and we
* can take the thread OUT of the published set. It is invalid
<font color='#997700'>@@ -78,7 +77,7 @@
</font> /*
* Free the per-thread scheduling information.
*/
<font color='#880000'>- _Scheduler_Thread_scheduler_free( the_thread );
</font><font color='#000088'>+ _Scheduler_Free( the_thread );
</font>
/*
* The thread might have been FP. So deal with that.
<font color='#006600'>diff -u rtems/cpukit/score/src/threadinitialize.c:1.43 rtems/cpukit/score/src/threadinitialize.c:1.44
--- rtems/cpukit/score/src/threadinitialize.c:1.43 Thu Feb 17 16:21:44 2011
+++ rtems/cpukit/score/src/threadinitialize.c Fri Feb 18 09:12:44 2011
</font><font color='#997700'>@@ -193,7 +193,7 @@
</font> the_thread->resource_count = 0;
the_thread->real_priority = priority;
the_thread->Start.initial_priority = priority;
<font color='#880000'>- sched =_Scheduler_Thread_scheduler_allocate( the_thread );
</font><font color='#000088'>+ sched =_Scheduler_Allocate( the_thread );
</font> if ( !sched )
goto failed;
_Thread_Set_priority( the_thread, priority );
<font color='#006600'>diff -u rtems/cpukit/score/src/threadsetpriority.c:1.8 rtems/cpukit/score/src/threadsetpriority.c:1.9
--- rtems/cpukit/score/src/threadsetpriority.c:1.8 Thu Feb 17 16:21:44 2011
+++ rtems/cpukit/score/src/threadsetpriority.c Fri Feb 18 09:12:44 2011
</font><font color='#997700'>@@ -16,19 +16,8 @@
</font> #endif
#include <rtems/system.h>
<font color='#880000'>-#include <rtems/score/apiext.h>
-#include <rtems/score/context.h>
-#include <rtems/score/interr.h>
-#include <rtems/score/isr.h>
-#include <rtems/score/object.h>
-#include <rtems/score/priority.h>
</font> #include <rtems/score/scheduler.h>
<font color='#880000'>-#include <rtems/score/states.h>
-#include <rtems/score/sysstate.h>
</font> #include <rtems/score/thread.h>
<font color='#880000'>-#include <rtems/score/threadq.h>
-#include <rtems/score/userext.h>
-#include <rtems/score/wkspace.h>
</font>
void _Thread_Set_priority(
Thread_Control *the_thread,
<font color='#997700'>@@ -37,5 +26,5 @@
</font> {
the_thread->current_priority = new_priority;
<font color='#880000'>- _Scheduler_Thread_scheduler_update( the_thread );
</font><font color='#000088'>+ _Scheduler_Update( the_thread );
</font> }
<font color='#006600'>diff -u rtems/cpukit/score/src/threadsettransient.c:1.8 rtems/cpukit/score/src/threadsettransient.c:1.9
--- rtems/cpukit/score/src/threadsettransient.c:1.8 Fri Jan 28 14:24:54 2011
+++ rtems/cpukit/score/src/threadsettransient.c Fri Feb 18 09:12:44 2011
</font><font color='#997700'>@@ -1,8 +1,7 @@
</font> /*
<font color='#880000'>- * Thread Handler
</font><font color='#000088'>+ * Thread Handler / Thread Set Transient
</font> *
<font color='#880000'>- *
- * COPYRIGHT (c) 1989-1999.
</font><font color='#000088'>+ * COPYRIGHT (c) 1989-2011.
</font> * On-Line Applications Research Corporation (OAR).
*
* The license and distribution terms for this file may be
<font color='#997700'>@@ -32,24 +31,10 @@
</font> #include <rtems/score/userext.h>
#include <rtems/score/wkspace.h>
<font color='#880000'>-/*PAGE
- *
- * _Thread_Set_transient
- *
- * This kernel routine places the requested thread in the transient state
- * which will remove it from the ready queue, if necessary. No
- * rescheduling is necessary because it is assumed that the transient
- * state will be cleared before dispatching is enabled.
- *
- * Input parameters:
- * the_thread - pointer to thread control block
- *
- * Output parameters: NONE
- *
</font><font color='#000088'>+/*
</font> * INTERRUPT LATENCY:
* only case
*/
<font color='#880000'>-
</font> void _Thread_Set_transient(
Thread_Control *the_thread
)
<font color='#997700'>@@ -62,9 +47,8 @@
</font> old_state = the_thread->current_state;
the_thread->current_state = _States_Set( STATES_TRANSIENT, old_state );
<font color='#880000'>- /* FIXME: need to check which scheduler to use? */
</font> if ( _States_Is_ready( old_state ) ) {
<font color='#880000'>- _Scheduler_priority_Ready_queue_extract( the_thread);
</font><font color='#000088'>+ _Scheduler_Extract( the_thread );
</font> }
_ISR_Enable( level );
</pre>
<p> </p>
<a name='cs2'></a>
<table border='0' cellspacing='0' cellpadding='5' width='100%' bgcolor='#eeeeee'>
<tr><td colspan='3' bgcolor='#dddddd'>
<font color='#bb2222'><strong>joel</strong></font>
</td></tr>
<tr><td colspan='3' bgcolor='#dddddd'><pre>2011-02-18 Joel Sherrill <joel.sherrill@oarcorp.com>
* tm26/task1.c, tm27/task1.c: Adjust for name changes.
</pre></td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/testsuites/tmtests/ChangeLog.diff?r1=text&tr1=1.94&r2=text&tr2=1.95&diff_format=h">M</a></td><td width='1%'>1.95</td><td width='100%'>testsuites/tmtests/ChangeLog</td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/testsuites/tmtests/tm26/task1.c.diff?r1=text&tr1=1.34&r2=text&tr2=1.35&diff_format=h">M</a></td><td width='1%'>1.35</td><td width='100%'>testsuites/tmtests/tm26/task1.c</td></tr>
<tr><td width='1%'><a href="http://www.rtems.com/cgi-bin/viewcvs.cgi//rtems/testsuites/tmtests/tm27/task1.c.diff?r1=text&tr1=1.31&r2=text&tr2=1.32&diff_format=h">M</a></td><td width='1%'>1.32</td><td width='100%'>testsuites/tmtests/tm27/task1.c</td></tr>
</table>
<pre>
<font color='#006600'>diff -u rtems/testsuites/tmtests/ChangeLog:1.94 rtems/testsuites/tmtests/ChangeLog:1.95
--- rtems/testsuites/tmtests/ChangeLog:1.94 Wed Feb 2 09:01:32 2011
+++ rtems/testsuites/tmtests/ChangeLog Fri Feb 18 09:12:55 2011
</font><font color='#997700'>@@ -1,3 +1,7 @@
</font><font color='#000088'>+2011-02-18 Joel Sherrill <joel.sherrill@oarcorp.com>
+
+ * tm26/task1.c, tm27/task1.c: Adjust for name changes.
+
</font> 2011-02-02 Ralf Corsépius <ralf.corsepius@rtems.org>
* configure.ac: Require autoconf-2.68, automake-1.11.1.
<font color='#006600'>diff -u rtems/testsuites/tmtests/tm26/task1.c:1.34 rtems/testsuites/tmtests/tm26/task1.c:1.35
--- rtems/testsuites/tmtests/tm26/task1.c:1.34 Thu Nov 25 07:26:45 2010
+++ rtems/testsuites/tmtests/tm26/task1.c Fri Feb 18 09:12:55 2011
</font><font color='#997700'>@@ -1,5 +1,5 @@
</font> /*
<font color='#880000'>- * COPYRIGHT (c) 1989-2009.
</font><font color='#000088'>+ * COPYRIGHT (c) 1989-2011.
</font> * On-Line Applications Research Corporation (OAR).
*
* The license and distribution terms for this file may be
<font color='#997700'>@@ -235,15 +235,17 @@
</font> rtems_task_argument argument
)
{
<font color='#000088'>+ Chain_Control *ready_queues;
+
</font> thread_dispatch_no_fp_time = benchmark_timer_read();
_Thread_Set_state( _Thread_Executing, STATES_SUSPENDED );
Middle_tcb = _Thread_Executing;
<font color='#000088'>+ ready_queues = (Chain_Control *) _Scheduler.information;
</font> _Thread_Executing =
<font color='#880000'>- (Thread_Control *)<span style="background-color: #FF0000"> </span>
- _Chain_First(&_Scheduler.Ready_queues.priority[LOW_PRIORITY]);
</font><font color='#000088'>+ (Thread_Control *) _Chain_First(&ready_queues[LOW_PRIORITY]);
</font>
/* do not force context switch */
<font color='#997700'>@@ -263,6 +265,9 @@
</font> )
{
Thread_Control *executing;
<font color='#000088'>+ Chain_Control *ready_queues;
+
+ ready_queues = (Chain_Control *) _Scheduler.information;
</font>
context_switch_no_fp_time = benchmark_timer_read();
<font color='#997700'>@@ -280,8 +285,7 @@
</font> context_switch_another_task_time = benchmark_timer_read();
_Thread_Executing =
<font color='#880000'>- (Thread_Control *)<span style="background-color: #FF0000"> </span>
- _Chain_First(&_Scheduler.Ready_queues.priority[FP1_PRIORITY]);
</font><font color='#000088'>+ (Thread_Control *) _Chain_First(&ready_queues[FP1_PRIORITY]);
</font>
/* do not force context switch */
<font color='#997700'>@@ -300,16 +304,17 @@
</font> rtems_task_argument argument
)
{
<font color='#880000'>- Thread_Control *executing;
</font><font color='#000088'>+ Chain_Control *ready_queues;
+ Thread_Control *executing;
</font> FP_DECLARE;
context_switch_restore_1st_fp_time = benchmark_timer_read();
executing = _Thread_Executing;
<font color='#000088'>+ ready_queues = (Chain_Control *) _Scheduler.information;
</font> _Thread_Executing =
<font color='#880000'>- (Thread_Control *)<span style="background-color: #FF0000"> </span>
- _Chain_First(&_Scheduler.Ready_queues.priority[FP2_PRIORITY]);
</font><font color='#000088'>+ (Thread_Control *) _Chain_First(&ready_queues[FP2_PRIORITY]);
</font>
/* do not force context switch */
<font color='#997700'>@@ -331,9 +336,9 @@
</font>
executing = _Thread_Executing;
<font color='#000088'>+ ready_queues = (Chain_Control *) _Scheduler.information;
</font> _Thread_Executing =
<font color='#880000'>- (Thread_Control *)
- _Chain_First(&_Scheduler.Ready_queues.priority[FP2_PRIORITY]);
</font><font color='#000088'>+ (Thread_Control *) _Chain_First(&ready_queues[FP2_PRIORITY]);
</font>
/* do not force context switch */
<font color='#997700'>@@ -354,6 +359,7 @@
</font> rtems_task_argument argument
)
{
<font color='#000088'>+ Chain_Control *ready_queues;
</font> Thread_Control *executing;
FP_DECLARE;
<font color='#997700'>@@ -361,9 +367,9 @@
</font>
executing = _Thread_Executing;
<font color='#000088'>+ ready_queues = (Chain_Control *) _Scheduler.information;
</font> _Thread_Executing =
<font color='#880000'>- (Thread_Control *)
- _Chain_First(&_Scheduler.Ready_queues.priority[FP1_PRIORITY]);
</font><font color='#000088'>+ (Thread_Control *) _Chain_First(&ready_queues[FP1_PRIORITY]);
</font>
FP_LOAD( 1.0 );
<font color='#006600'>diff -u rtems/testsuites/tmtests/tm27/task1.c:1.31 rtems/testsuites/tmtests/tm27/task1.c:1.32
--- rtems/testsuites/tmtests/tm27/task1.c:1.31 Thu Nov 25 07:26:45 2010
+++ rtems/testsuites/tmtests/tm27/task1.c Fri Feb 18 09:12:55 2011
</font><font color='#997700'>@@ -1,5 +1,5 @@
</font> /*
<font color='#880000'>- * COPYRIGHT (c) 1989-2009.
</font><font color='#000088'>+ * COPYRIGHT (c) 1989-2011.
</font> * On-Line Applications Research Corporation (OAR).
*
* The license and distribution terms for this file may be
<font color='#997700'>@@ -91,6 +91,8 @@
</font> rtems_task_argument argument
)
{
<font color='#000088'>+ Chain_Control *ready_queues;
+
</font> Install_tm27_vector( Isr_handler );
/*
<font color='#997700'>@@ -170,8 +172,9 @@
</font>
_Thread_Dispatch_disable_level = 0;
<font color='#880000'>- _Thread_Heir = (rtems_tcb *)<span style="background-color: #FF0000"> </span>
- _Chain_Last(&_Scheduler.Ready_queues.priority[LOW_PRIORITY]);
</font><font color='#000088'>+ ready_queues = (Chain_Control *) _Scheduler.information;
+ _Thread_Executing =
+ (Thread_Control *) _Chain_First(&ready_queues[LOW_PRIORITY]);
</font>
_Thread_Dispatch_necessary = 1;
<font color='#997700'>@@ -199,6 +202,8 @@
</font> rtems_task_argument argument
)
{
<font color='#000088'>+ Chain_Control *ready_queues;
+
</font> #if (MUST_WAIT_FOR_INTERRUPT == 1)
while ( Interrupt_occurred == 0 );
#endif
<font color='#997700'>@@ -228,8 +233,9 @@
</font>
_Thread_Dispatch_disable_level = 0;
<font color='#880000'>- _Thread_Heir = (rtems_tcb *)
- _Chain_First(&_Scheduler.Ready_queues.priority[LOW_PRIORITY]);
</font><font color='#000088'>+ ready_queues = (Chain_Control *) _Scheduler.information;
+ _Thread_Executing =
+ (Thread_Control *) _Chain_First(&ready_queues[LOW_PRIORITY]);
</font>
_Thread_Dispatch_necessary = 1;
</pre>
<p> </p>
<p>--<br />
<small>Generated by <a href="http://www.codewiz.org/projects/index.html#loginfo">Deluxe Loginfo</a> 2.122 by Bernardo Innocenti <bernie@develer.com></small></p>
</body>
</html>