ecos: packages/kernel/current/include/sched.hxx annotate

annotate packages/kernel/current/include/sched.hxx @ 115:6ed91473a1cd ecos-sw-2000-08-21

Merge from eCos master repository on 2000-08-21-22:40:54-BST

author	jlarmour
date	Fri, 25 Aug 2000 17:32:38 +0000
parents	bf00f99aec69
children	0ec04793409a

rev	line source
0 3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	1 #ifndef CYGONCE_KERNEL_SCHED_HXX
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	2 #define CYGONCE_KERNEL_SCHED_HXX
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	3
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	4 //==========================================================================
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	5 //
2 443894e2e912 Block commit of eCos version 1.2.1 jlarmour parents: 0 diff changeset	6 // sched.hxx
0 3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	7 //
2 443894e2e912 Block commit of eCos version 1.2.1 jlarmour parents: 0 diff changeset	8 // Scheduler class declaration(s)
0 3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	9 //
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	10 //==========================================================================
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	11 //####COPYRIGHTBEGIN####
64 c38311975d4f Merge from eCos master repository on 2000-01-28-04:28:11-GMT jlarmour parents: 62 diff changeset	12 //
c38311975d4f Merge from eCos master repository on 2000-01-28-04:28:11-GMT jlarmour parents: 62 diff changeset	13 // -------------------------------------------
c38311975d4f Merge from eCos master repository on 2000-01-28-04:28:11-GMT jlarmour parents: 62 diff changeset	14 // The contents of this file are subject to the Red Hat eCos Public License
66 bf00f99aec69 Merge from eCos master repository on 2000-02-02-19:16:44-GMT jlarmour parents: 64 diff changeset	15 // Version 1.1 (the "License"); you may not use this file except in
64 c38311975d4f Merge from eCos master repository on 2000-01-28-04:28:11-GMT jlarmour parents: 62 diff changeset	16 // compliance with the License. You may obtain a copy of the License at
66 bf00f99aec69 Merge from eCos master repository on 2000-02-02-19:16:44-GMT jlarmour parents: 64 diff changeset	17 // http://www.redhat.com/
64 c38311975d4f Merge from eCos master repository on 2000-01-28-04:28:11-GMT jlarmour parents: 62 diff changeset	18 //
66 bf00f99aec69 Merge from eCos master repository on 2000-02-02-19:16:44-GMT jlarmour parents: 64 diff changeset	19 // Software distributed under the License is distributed on an "AS IS"
64 c38311975d4f Merge from eCos master repository on 2000-01-28-04:28:11-GMT jlarmour parents: 62 diff changeset	20 // basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See the
c38311975d4f Merge from eCos master repository on 2000-01-28-04:28:11-GMT jlarmour parents: 62 diff changeset	21 // License for the specific language governing rights and limitations under
c38311975d4f Merge from eCos master repository on 2000-01-28-04:28:11-GMT jlarmour parents: 62 diff changeset	22 // the License.
c38311975d4f Merge from eCos master repository on 2000-01-28-04:28:11-GMT jlarmour parents: 62 diff changeset	23 //
c38311975d4f Merge from eCos master repository on 2000-01-28-04:28:11-GMT jlarmour parents: 62 diff changeset	24 // The Original Code is eCos - Embedded Configurable Operating System,
c38311975d4f Merge from eCos master repository on 2000-01-28-04:28:11-GMT jlarmour parents: 62 diff changeset	25 // released September 30, 1998.
c38311975d4f Merge from eCos master repository on 2000-01-28-04:28:11-GMT jlarmour parents: 62 diff changeset	26 //
c38311975d4f Merge from eCos master repository on 2000-01-28-04:28:11-GMT jlarmour parents: 62 diff changeset	27 // The Initial Developer of the Original Code is Red Hat.
c38311975d4f Merge from eCos master repository on 2000-01-28-04:28:11-GMT jlarmour parents: 62 diff changeset	28 // Portions created by Red Hat are
c38311975d4f Merge from eCos master repository on 2000-01-28-04:28:11-GMT jlarmour parents: 62 diff changeset	29 // Copyright (C) 1998, 1999, 2000 Red Hat, Inc.
c38311975d4f Merge from eCos master repository on 2000-01-28-04:28:11-GMT jlarmour parents: 62 diff changeset	30 // All Rights Reserved.
c38311975d4f Merge from eCos master repository on 2000-01-28-04:28:11-GMT jlarmour parents: 62 diff changeset	31 // -------------------------------------------
c38311975d4f Merge from eCos master repository on 2000-01-28-04:28:11-GMT jlarmour parents: 62 diff changeset	32 //
0 3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	33 //####COPYRIGHTEND####
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	34 //==========================================================================
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	35 //#####DESCRIPTIONBEGIN####
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	36 //
2 443894e2e912 Block commit of eCos version 1.2.1 jlarmour parents: 0 diff changeset	37 // Author(s): nickg
443894e2e912 Block commit of eCos version 1.2.1 jlarmour parents: 0 diff changeset	38 // Contributors: nickg
443894e2e912 Block commit of eCos version 1.2.1 jlarmour parents: 0 diff changeset	39 // Date: 1997-09-09
443894e2e912 Block commit of eCos version 1.2.1 jlarmour parents: 0 diff changeset	40 // Purpose: Define Scheduler class interfaces
443894e2e912 Block commit of eCos version 1.2.1 jlarmour parents: 0 diff changeset	41 // Description: These class definitions supply the internal API
0 3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	42 // used to scheduler threads.
2 443894e2e912 Block commit of eCos version 1.2.1 jlarmour parents: 0 diff changeset	43 // Usage: #include <cyg/kernel/sched.hxx>
0 3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	44 //
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	45 //####DESCRIPTIONEND####
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	46 //
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	47 //==========================================================================
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	48
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	49 #include <cyg/kernel/ktypes.h>
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	50 #include <cyg/infra/cyg_ass.h> // assertion macros
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	51
115 6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	52
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	53 // -------------------------------------------------------------------------
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	54 // Miscellaneous types
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	55
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	56 #ifdef CYGSEM_KERNEL_SCHED_ASR_SUPPORT
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	57
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	58 typedef void Cyg_ASR( CYG_ADDRWORD data ); // ASR type signature
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	59
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	60 #endif
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	61
0 3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	62 // -------------------------------------------------------------------------
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	63 // Scheduler base class. This defines stuff that is needed by the
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	64 // specific scheduler implementation. Each scheduler comprises three
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	65 // classes: Cyg_Scheduler_Base, Cyg_Scheduler_Implementation which
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	66 // inherits from it and Cyg_Scheduler which inherits from _it_ in turn.
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	67
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	68 class Cyg_Scheduler_Base
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	69 {
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	70 friend class Cyg_HardwareThread;
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	71 friend class Cyg_SchedThread;
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	72
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	73 protected:
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	74 // The following variables are implicit in the API, but are
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	75 // not publically visible.
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	76
2 443894e2e912 Block commit of eCos version 1.2.1 jlarmour parents: 0 diff changeset	77 static volatile cyg_ucount32 sched_lock // lock counter
443894e2e912 Block commit of eCos version 1.2.1 jlarmour parents: 0 diff changeset	78 CYGBLD_ATTRIB_ASM_ALIAS( cyg_scheduler_sched_lock );
443894e2e912 Block commit of eCos version 1.2.1 jlarmour parents: 0 diff changeset	79
0 3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	80 static Cyg_Thread *current_thread; // current running thread
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	81
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	82 static cyg_bool need_reschedule; // set when schedule needed
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	83
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	84 static cyg_ucount32 thread_switches; // count of number of thread switches
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	85 };
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	86
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	87 // -------------------------------------------------------------------------
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	88 // Include the scheduler implementation header
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	89
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	90 #include CYGPRI_KERNEL_SCHED_IMPL_HXX
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	91
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	92 // Do some checking that we have a consistent universe.
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	93
115 6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	94 #ifdef CYGSEM_KERNEL_SYNCH_MUTEX_PRIORITY_INVERSION_PROTOCOL
0 3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	95 # ifndef CYGIMP_THREAD_PRIORITY
115 6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	96 # error Priority inversion protocols will not work without priorities!!!
0 3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	97 # endif
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	98 # if CYG_SCHED_UNIQUE_PRIORITIES
115 6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	99 # error Priority inversion protocols need non-unique priorities!!!
0 3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	100 # endif
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	101 #endif
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	102
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	103 // -------------------------------------------------------------------------
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	104 // Scheduler class. This is the public scheduler interface seen by the
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	105 // rest of the kernel.
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	106
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	107 class Cyg_Scheduler
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	108 : public Cyg_Scheduler_Implementation
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	109 {
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	110 friend class Cyg_Thread;
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	111
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	112 // This function is the actual implementation of the unlock
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	113 // function. The unlock() later is an inline shell that deals
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	114 // with the common case.
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	115
115 6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	116 static void unlock_inner(cyg_uint32 new_lock = 0);
0 3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	117
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	118 public:
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	119
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	120 CYGDBG_DEFINE_CHECK_THIS
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	121
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	122 // The following API functions are common to all scheduler
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	123 // implementations.
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	124
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	125 // claim the preemption lock
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	126 static void lock();
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	127
2 443894e2e912 Block commit of eCos version 1.2.1 jlarmour parents: 0 diff changeset	128 // release the preemption lock and possibly reschedule
0 3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	129 static void unlock();
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	130
115 6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	131 // release and reclaim the lock atomically
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	132 static void reschedule();
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	133
2 443894e2e912 Block commit of eCos version 1.2.1 jlarmour parents: 0 diff changeset	134 // release the preemption lock without rescheduling
443894e2e912 Block commit of eCos version 1.2.1 jlarmour parents: 0 diff changeset	135 static void unlock_simple();
443894e2e912 Block commit of eCos version 1.2.1 jlarmour parents: 0 diff changeset	136
0 3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	137 // return a pointer to the current thread
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	138 static Cyg_Thread *get_current_thread();
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	139
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	140 // Return current value of lock
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	141 static cyg_ucount32 get_sched_lock();
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	142
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	143 // Return current number of thread switches
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	144 static cyg_ucount32 get_thread_switches();
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	145
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	146 // Start execution of the scheduler
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	147 static void start() __attribute__ ((noreturn));
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	148
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	149 // The only scheduler instance should be this one...
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	150 static Cyg_Scheduler scheduler;
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	151
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	152 };
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	153
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	154 // -------------------------------------------------------------------------
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	155 // This class encapsulates the scheduling abstractions in a thread.
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	156 // Cyg_SchedThread is included as a base class of Cyg_Thread. The actual
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	157 // implementation of the abstractions is in Cyg_SchedThread_Implementation
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	158 // so this class has little to do.
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	159
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	160 class Cyg_SchedThread
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	161 : public Cyg_SchedThread_Implementation
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	162 {
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	163 friend class Cyg_ThreadQueue_Implementation;
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	164 friend class Cyg_Scheduler_Implementation;
115 6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	165 friend class Cyg_Scheduler;
0 3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	166
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	167 Cyg_ThreadQueue *queue;
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	168
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	169
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	170 public:
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	171
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	172 Cyg_SchedThread(Cyg_Thread *thread, CYG_ADDRWORD sched_info);
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	173
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	174 // Return current queue pointer
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	175
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	176 Cyg_ThreadQueue *get_current_queue();
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	177
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	178 // Remove this thread from current queue
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	179 void remove();
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	180
115 6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	181 #ifdef CYGSEM_KERNEL_SCHED_ASR_SUPPORT
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	182
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	183 // ASR support.
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	184 // An ASR is an Asynchronous Service Routine. When set pending it
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	185 // is called when the thread exits the scheduler. ASRs are mainly
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	186 // used by compatibility subsystems, such as POSIX, to implement
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	187 // such things as thread cancellation and signal delivery.
0 3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	188
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	189 private:
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	190
115 6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	191 volatile cyg_bool asr_inhibit; // If true, blocks calls to ASRs
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	192
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	193 volatile cyg_bool asr_pending; // If true, this thread's ASR should be called.
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	194
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	195 #ifdef CYGSEM_KERNEL_SCHED_ASR_GLOBAL
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	196 static
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	197 #endif
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	198 Cyg_ASR *asr; // ASR function
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	199 #ifdef CYGSEM_KERNEL_SCHED_ASR_DATA_GLOBAL
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	200 static
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	201 #endif
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	202 CYG_ADDRWORD asr_data; // ASR data pointer
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	203
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	204 // Default ASR function
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	205 static void asr_default(CYG_ADDRWORD data);
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	206
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	207 public:
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	208
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	209 // Public interface to ASR mechanism
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	210
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	211 // Set, clear and get inhibit flag.
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	212 inline void set_asr_inhibit() { asr_inhibit = true; }
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	213 inline void clear_asr_inhibit() { asr_inhibit = false; }
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	214 inline cyg_bool get_asr_inhibit() { return asr_inhibit; }
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	215
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	216 // Set and get pending flag. The flag is only cleared when the
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	217 // ASR is called.
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	218 inline void set_asr_pending() { asr_pending = true; }
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	219 inline cyg_bool get_asr_pending() { return asr_pending; }
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	220
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	221 // Set a new ASR, returning the old one.
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	222 void set_asr( Cyg_ASR *new_asr, CYG_ADDRWORD new_data,
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	223 Cyg_ASR *old_asr, CYG_ADDRWORD old_data);
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	224
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	225 // Clear the ASR function back to the default.
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	226 void clear_asr();
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	227
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	228 #else
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	229
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	230 public:
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	231
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	232 // Even when we do not have ASRs enabled, we keep these functions
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	233 // available. This avoids excessive ifdefs in the rest of the
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	234 // kernel code.
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	235 inline void set_asr_inhibit() { }
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	236 inline void clear_asr_inhibit() { }
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	237
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	238 #endif
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	239
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	240 #ifdef CYGSEM_KERNEL_SYNCH_MUTEX_PRIORITY_INVERSION_PROTOCOL
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	241
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	242 private:
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	243
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	244 // For all priority inversion protocols we need to keep track of how
62 7a6ac9edc838 Merge from eCos master repository on 2000-01-24-19:43:49-GMT jlarmour parents: 2 diff changeset	245 // many mutexes we have locked, including one which we are waiting to
7a6ac9edc838 Merge from eCos master repository on 2000-01-24-19:43:49-GMT jlarmour parents: 2 diff changeset	246 // lock, because we can inherit priority while sleeping just prior to
7a6ac9edc838 Merge from eCos master repository on 2000-01-24-19:43:49-GMT jlarmour parents: 2 diff changeset	247 // wakeup.
115 6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	248
0 3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	249 cyg_count32 mutex_count;
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	250
115 6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	251 protected:
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	252 // These are implementation functions that are common to all protocols.
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	253
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	254 // Inherit the given priority. If thread is non-NULL the priority is
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	255 // being inherited from it, otherwise it has come from the mutex.
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	256 void set_inherited_priority( cyg_priority pri, Cyg_Thread *thread = 0 );
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	257
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	258 // Relay the priority of the ex-owner thread or from the queue if it
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	259 // has a higher priority than ours.
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	260 void relay_inherited_priority( Cyg_Thread ex_owner, Cyg_ThreadQueue pqueue);
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	261
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	262 // Lose priority inheritance
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	263 void clear_inherited_priority();
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	264
0 3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	265 public:
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	266 // Count and uncount the number of mutexes held by
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	267 // this thread.
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	268 void count_mutex() { mutex_count++; };
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	269 void uncount_mutex() { mutex_count--; };
115 6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	270
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	271 #if defined(CYGSEM_KERNEL_SYNCH_MUTEX_PRIORITY_INVERSION_PROTOCOL_SIMPLE)
0 3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	272
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	273 protected:
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	274
115 6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	275 // The simple priority inversion protocols simply needs
0 3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	276 // somewhere to store the base priority of the current thread.
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	277
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	278 cyg_priority original_priority; // our original priority
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	279
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	280 cyg_bool priority_inherited; // have we inherited?
115 6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	281
0 3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	282 #endif
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	283
115 6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	284 #ifdef CYGSEM_KERNEL_SYNCH_MUTEX_PRIORITY_INVERSION_PROTOCOL_INHERIT
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	285
0 3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	286 public:
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	287
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	288 // Inherit the priority of the provided thread if it
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	289 // has higher priority than this.
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	290 void inherit_priority( Cyg_Thread *thread);
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	291
62 7a6ac9edc838 Merge from eCos master repository on 2000-01-24-19:43:49-GMT jlarmour parents: 2 diff changeset	292 // Relay the priority of the ex-owner thread or from the queue if it
7a6ac9edc838 Merge from eCos master repository on 2000-01-24-19:43:49-GMT jlarmour parents: 2 diff changeset	293 // has a higher priority than ours.
7a6ac9edc838 Merge from eCos master repository on 2000-01-24-19:43:49-GMT jlarmour parents: 2 diff changeset	294 void relay_priority( Cyg_Thread ex_owner, Cyg_ThreadQueue pqueue);
7a6ac9edc838 Merge from eCos master repository on 2000-01-24-19:43:49-GMT jlarmour parents: 2 diff changeset	295
0 3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	296 // Lose priority inheritance
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	297 void disinherit_priority();
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	298
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	299 #endif
115 6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	300
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	301 #ifdef CYGSEM_KERNEL_SYNCH_MUTEX_PRIORITY_INVERSION_PROTOCOL_CEILING
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	302
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	303 public:
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	304
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	305 // Set the priority of this thread to the given ceiling.
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	306 void set_priority_ceiling( cyg_priority pri );
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	307
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	308 // Clear the ceiling, if necessary.
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	309 void clear_priority_ceiling();
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	310
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	311 #endif
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	312
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	313 #endif
0 3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	314
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	315 };
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	316
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	317 // -------------------------------------------------------------------------
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	318 // Simple inline accessor functions
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	319
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	320 inline Cyg_Thread *Cyg_Scheduler::get_current_thread()
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	321 {
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	322 return current_thread;
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	323 }
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	324
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	325 // Return current value of lock
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	326 inline cyg_ucount32 Cyg_Scheduler::get_sched_lock()
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	327 {
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	328 return sched_lock;
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	329 }
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	330
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	331 // Return current number of thread switches
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	332 inline cyg_ucount32 Cyg_Scheduler::get_thread_switches()
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	333 {
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	334 return thread_switches;
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	335 }
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	336
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	337 // Return current queue pointer
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	338 inline Cyg_ThreadQueue *Cyg_SchedThread::get_current_queue()
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	339 {
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	340 return queue;
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	341 }
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	342
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	343 // -------------------------------------------------------------------------
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	344 #endif // ifndef __SCHED_HXX__
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	345 // EOF sched.hxx

Mercurial > ecos

annotate packages/kernel/current/include/sched.hxx @ 115:6ed91473a1cd ecos-sw-2000-08-21