diff options
Diffstat (limited to 'cpukit/include/rtems/score/scheduler.h')
| -rw-r--r-- | cpukit/include/rtems/score/scheduler.h | 121 |
1 files changed, 99 insertions, 22 deletions
diff --git a/cpukit/include/rtems/score/scheduler.h b/cpukit/include/rtems/score/scheduler.h index df9477fbeb..d0fe2a8626 100644 --- a/cpukit/include/rtems/score/scheduler.h +++ b/cpukit/include/rtems/score/scheduler.h @@ -1,3 +1,5 @@ +/* SPDX-License-Identifier: BSD-2-Clause */ + /** * @file * @@ -12,9 +14,26 @@ * 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.org/license/LICENSE. + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" + * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE + * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR + * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF + * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS + * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN + * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) + * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE + * POSSIBILITY OF SUCH DAMAGE. */ #ifndef _RTEMS_SCORE_SCHEDULER_H @@ -135,6 +154,61 @@ typedef struct { ); /** + * @brief Makes the node sticky. + * + * This operation is used by _Thread_Priority_update_and_make_sticky(). It + * is only called for the scheduler node of the home scheduler. + * + * Uniprocessor schedulers schould provide + * _Scheduler_default_Sticky_do_nothing() for this operation. + * + * SMP schedulers should provide this operation using + * _Scheduler_SMP_Make_sticky(). + * + * The make and clean sticky operations are an optimization to simplify the + * control flow in the update priority operation. The update priority + * operation is used for all scheduler nodes and not just the scheduler node + * of home schedulers. The update priority operation is a commonly used + * operations together with block and unblock. The make and clean sticky + * operations are used only in specific scenarios. + * + * @param scheduler is the scheduler of the node. + * + * @param[in, out] the_thread is the thread owning the node. + * + * @param[in, out] node is the scheduler node to make sticky. + */ + void ( *make_sticky )( + const Scheduler_Control *scheduler, + Thread_Control *the_thread, + Scheduler_Node *node + ); + + /** + * @brief Cleans the sticky property from the node. + * + * This operation is used by _Thread_Priority_update_and_clean_sticky(). It + * is only called for the scheduler node of the home scheduler. + * + * Uniprocessor schedulers schould provide + * _Scheduler_default_Sticky_do_nothing() for this operation. + * + * SMP schedulers should provide this operation using + * _Scheduler_SMP_Clean_sticky(). + * + * @param scheduler is the scheduler of the node. + * + * @param[in, out] the_thread is the thread owning the node. + * + * @param[in, out] node is the scheduler node to clean the sticky property. + */ + void ( *clean_sticky )( + const Scheduler_Control *scheduler, + Thread_Control *the_thread, + Scheduler_Node *node + ); + + /** * @brief Pin thread operation. * * @param[in] scheduler The scheduler instance of the specified processor. @@ -217,9 +291,6 @@ typedef struct { Thread_queue_Context * ); - /** @see _Scheduler_Tick() */ - void ( *tick )( const Scheduler_Control *, Thread_Control * ); - /** @see _Scheduler_Start_idle() */ void ( *start_idle )( const Scheduler_Control *, @@ -245,12 +316,12 @@ typedef struct { * this structure at the begin of its context structure. */ typedef struct Scheduler_Context { +#if defined(RTEMS_SMP) /** * @brief Lock to protect this scheduler instance. */ - ISR_LOCK_MEMBER( Lock ) + ISR_lock_Control Lock; -#if defined(RTEMS_SMP) /** * @brief The set of processors owned by this scheduler instance. */ @@ -403,6 +474,24 @@ Priority_Control _Scheduler_default_Unmap_priority( /** * @brief Does nothing. * + * This default implementation for the make and clean sticky operations + * should be used by uniprocessor schedulers if SMP support is enabled. + * + * @param scheduler is an unused parameter. + * + * @param the_thread is an unused parameter. + * + * @param node is an unused parameter. + */ + void _Scheduler_default_Sticky_do_nothing( + const Scheduler_Control *scheduler, + Thread_Control *the_thread, + Scheduler_Node *node + ); + + /** + * @brief Does nothing. + * * This default implementation for the thread pin or unpin operations should * be used by uniprocessor schedulers if SMP support is enabled. * @@ -462,6 +551,8 @@ Priority_Control _Scheduler_default_Unmap_priority( NULL, \ NULL, \ NULL, \ + _Scheduler_default_Sticky_do_nothing, \ + _Scheduler_default_Sticky_do_nothing, \ _Scheduler_default_Pin_or_unpin_do_nothing, \ _Scheduler_default_Pin_or_unpin_do_nothing, \ NULL, \ @@ -544,20 +635,6 @@ void _Scheduler_default_Cancel_job( ); /** - * @brief Performs tick operations depending on the CPU budget algorithm for - * each executing thread. - * - * This routine is invoked as part of processing each clock tick. - * - * @param scheduler The scheduler. - * @param[in, out] executing An executing thread. - */ -void _Scheduler_default_Tick( - const Scheduler_Control *scheduler, - Thread_Control *executing -); - -/** * @brief Starts an idle thread. * * @param scheduler This parameter is unused. |