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

annotate packages/kernel/current/include/sched.inl @ 171:42f843b391aa

Merge from eCos master repository on 2001-07-18-03:13:25-BST

author	jlarmour
date	Wed, 18 Jul 2001 11:38:39 +0000
parents	0ec04793409a
children	4c750ce71ae3

rev	line source
0 3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	1 #ifndef CYGONCE_KERNEL_SCHED_INL
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	2 #define CYGONCE_KERNEL_SCHED_INL
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.inl
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 inlines
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: 2 diff changeset	12 //
c38311975d4f Merge from eCos master repository on 2000-01-28-04:28:11-GMT jlarmour parents: 2 diff changeset	13 // -------------------------------------------
c38311975d4f Merge from eCos master repository on 2000-01-28-04:28:11-GMT jlarmour parents: 2 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: 2 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: 2 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: 2 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: 2 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: 2 diff changeset	22 // the License.
c38311975d4f Merge from eCos master repository on 2000-01-28-04:28:11-GMT jlarmour parents: 2 diff changeset	23 //
c38311975d4f Merge from eCos master repository on 2000-01-28-04:28:11-GMT jlarmour parents: 2 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: 2 diff changeset	25 // released September 30, 1998.
c38311975d4f Merge from eCos master repository on 2000-01-28-04:28:11-GMT jlarmour parents: 2 diff changeset	26 //
c38311975d4f Merge from eCos master repository on 2000-01-28-04:28:11-GMT jlarmour parents: 2 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: 2 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: 2 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: 2 diff changeset	30 // All Rights Reserved.
c38311975d4f Merge from eCos master repository on 2000-01-28-04:28:11-GMT jlarmour parents: 2 diff changeset	31 // -------------------------------------------
c38311975d4f Merge from eCos master repository on 2000-01-28-04:28:11-GMT jlarmour parents: 2 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 inlines for scheduler classes
443894e2e912 Block commit of eCos version 1.2.1 jlarmour parents: 0 diff changeset	41 // Description: Inline functions for the scheduler classes. These are
0 3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	42 // not defined in the header so that we have the option
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	43 // of making them non-inline.
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	44 // Usage:
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	45 // #include <cyg/kernel/sched.hxx>
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	46 // ...
2 443894e2e912 Block commit of eCos version 1.2.1 jlarmour parents: 0 diff changeset	47 // #include <cyg/kernel/sched.inl>
443894e2e912 Block commit of eCos version 1.2.1 jlarmour parents: 0 diff changeset	48 // ...
0 3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	49 //
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	50 //####DESCRIPTIONEND####
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	51 //
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	52 //==========================================================================
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	53
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	54 #include <cyg/kernel/instrmnt.h>
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	55
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	56 #include <cyg/kernel/thread.inl> // we use some thread inlines here
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	57
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	58 // -------------------------------------------------------------------------
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	59 // Inlines for Cyg_Scheduler class
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	60
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	61 inline void Cyg_Scheduler::lock()
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 // We do not need to do a read-modify-write sequence here because
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	64 // the scheduler lock is strictly nesting. Even if we are interrupted
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	65 // partway through the increment, the lock will be returned to the same
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	66 // value before we are resumed/rescheduled.
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	67
2 443894e2e912 Block commit of eCos version 1.2.1 jlarmour parents: 0 diff changeset	68 HAL_REORDER_BARRIER();
443894e2e912 Block commit of eCos version 1.2.1 jlarmour parents: 0 diff changeset	69
0 3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	70 sched_lock++;
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	71
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	72 HAL_REORDER_BARRIER();
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	73
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	74 CYG_INSTRUMENT_SCHED(LOCK,sched_lock,0);
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	75 };
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	76
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	77 inline void Cyg_Scheduler::unlock()
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	78 {
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	79 // This is an inline wrapper for the real scheduler unlock function in
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	80 // Cyg_Scheduler::unlock_inner().
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 // Only do anything if the lock is about to go zero, otherwise we simply
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	83 // decrement and return. As with lock() we do not need any special code
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	84 // to decrement the lock counter.
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 CYG_INSTRUMENT_SCHED(UNLOCK,sched_lock,0);
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 HAL_REORDER_BARRIER();
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	89
2 443894e2e912 Block commit of eCos version 1.2.1 jlarmour parents: 0 diff changeset	90 cyg_ucount32 __lock = sched_lock - 1;
0 3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	91
115 6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	92 if( __lock == 0 ) unlock_inner(0);
2 443894e2e912 Block commit of eCos version 1.2.1 jlarmour parents: 0 diff changeset	93 else sched_lock = __lock;
443894e2e912 Block commit of eCos version 1.2.1 jlarmour parents: 0 diff changeset	94
443894e2e912 Block commit of eCos version 1.2.1 jlarmour parents: 0 diff changeset	95 HAL_REORDER_BARRIER();
443894e2e912 Block commit of eCos version 1.2.1 jlarmour parents: 0 diff changeset	96 }
443894e2e912 Block commit of eCos version 1.2.1 jlarmour parents: 0 diff changeset	97
115 6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	98 inline void Cyg_Scheduler::reschedule()
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	99 {
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	100 // This function performs the equivalent of calling unlock() and
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	101 // lock() is succession. Unlike that pair, however, it does not
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	102 // leave a brief window between the calls when the lock is unclaimed
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	103 // by the current thread.
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	104
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	105 CYG_INSTRUMENT_SCHED(RESCHEDULE,sched_lock,0);
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	106
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	107 unlock_inner( sched_lock );
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	108 }
6ed91473a1cd Merge from eCos master repository on 2000-08-21-22:40:54-BST jlarmour parents: 66 diff changeset	109
124 0ec04793409a Merge from eCos master repository on 2000-09-11-03:00:13-BST jlarmour parents: 115 diff changeset	110 inline void Cyg_Scheduler:: unlock_reschedule()
0ec04793409a Merge from eCos master repository on 2000-09-11-03:00:13-BST jlarmour parents: 115 diff changeset	111 {
0ec04793409a Merge from eCos master repository on 2000-09-11-03:00:13-BST jlarmour parents: 115 diff changeset	112 // This function decrements the scheduler lock and also looks for
0ec04793409a Merge from eCos master repository on 2000-09-11-03:00:13-BST jlarmour parents: 115 diff changeset	113 // a reschedule opportunity. When the lock is being decremented
0ec04793409a Merge from eCos master repository on 2000-09-11-03:00:13-BST jlarmour parents: 115 diff changeset	114 // from 1 to zero this function is equivalent to unlock. When the
171 42f843b391aa Merge from eCos master repository on 2001-07-18-03:13:25-BST jlarmour parents: 124 diff changeset	115 // lock is being decremented to a non-zero value, it is more or less
42f843b391aa Merge from eCos master repository on 2001-07-18-03:13:25-BST jlarmour parents: 124 diff changeset	116 // equivalent to reschedule() followed by unlock().
124 0ec04793409a Merge from eCos master repository on 2000-09-11-03:00:13-BST jlarmour parents: 115 diff changeset	117
0ec04793409a Merge from eCos master repository on 2000-09-11-03:00:13-BST jlarmour parents: 115 diff changeset	118 CYG_INSTRUMENT_SCHED(UNLOCK,sched_lock,0);
0ec04793409a Merge from eCos master repository on 2000-09-11-03:00:13-BST jlarmour parents: 115 diff changeset	119
0ec04793409a Merge from eCos master repository on 2000-09-11-03:00:13-BST jlarmour parents: 115 diff changeset	120 unlock_inner( sched_lock - 1 );
0ec04793409a Merge from eCos master repository on 2000-09-11-03:00:13-BST jlarmour parents: 115 diff changeset	121 }
0ec04793409a Merge from eCos master repository on 2000-09-11-03:00:13-BST jlarmour parents: 115 diff changeset	122
2 443894e2e912 Block commit of eCos version 1.2.1 jlarmour parents: 0 diff changeset	123 inline void Cyg_Scheduler::unlock_simple()
443894e2e912 Block commit of eCos version 1.2.1 jlarmour parents: 0 diff changeset	124 {
443894e2e912 Block commit of eCos version 1.2.1 jlarmour parents: 0 diff changeset	125 // This function decrements the lock, but does not call unlock_inner().
443894e2e912 Block commit of eCos version 1.2.1 jlarmour parents: 0 diff changeset	126 // Therefore does not immediately allow another thread to run:
443894e2e912 Block commit of eCos version 1.2.1 jlarmour parents: 0 diff changeset	127 // merely makes it possible for some other thread to run at some
443894e2e912 Block commit of eCos version 1.2.1 jlarmour parents: 0 diff changeset	128 // indeterminate future time. This is mainly for use by
443894e2e912 Block commit of eCos version 1.2.1 jlarmour parents: 0 diff changeset	129 // debuggers, it should not normally be used anywhere else.
443894e2e912 Block commit of eCos version 1.2.1 jlarmour parents: 0 diff changeset	130
443894e2e912 Block commit of eCos version 1.2.1 jlarmour parents: 0 diff changeset	131 CYG_INSTRUMENT_SCHED(UNLOCK,sched_lock,0);
443894e2e912 Block commit of eCos version 1.2.1 jlarmour parents: 0 diff changeset	132
443894e2e912 Block commit of eCos version 1.2.1 jlarmour parents: 0 diff changeset	133 HAL_REORDER_BARRIER();
443894e2e912 Block commit of eCos version 1.2.1 jlarmour parents: 0 diff changeset	134
443894e2e912 Block commit of eCos version 1.2.1 jlarmour parents: 0 diff changeset	135 if (sched_lock > 0)
443894e2e912 Block commit of eCos version 1.2.1 jlarmour parents: 0 diff changeset	136 sched_lock = sched_lock - 1;
443894e2e912 Block commit of eCos version 1.2.1 jlarmour parents: 0 diff changeset	137
443894e2e912 Block commit of eCos version 1.2.1 jlarmour parents: 0 diff changeset	138 HAL_REORDER_BARRIER();
0 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
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	141
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 // Inlines for Cyg_SchedThread class
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	144
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	145 inline void Cyg_SchedThread::remove()
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	146 {
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	147 if( queue != NULL )
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 queue->remove((Cyg_Thread *)this);
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	150 queue = NULL;
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
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	156 #endif // ifndef CYGONCE_KERNEL_SCHED_INL
3111d98ba7b3 Initial commit of eCos version 1.1 jlarmour parents: diff changeset	157 // EOF sched.inl

Mercurial > ecos

annotate packages/kernel/current/include/sched.inl @ 171:42f843b391aa