From 1ac1126801ff5709bb7adaf993aa41b0fbf0e528 Mon Sep 17 00:00:00 2001 From: Sebastian Huber Date: Mon, 15 Jun 2020 11:10:02 +0200 Subject: rtems: Generate Change license to BSD-2-Clause according to file histories and documentation re-licensing agreement. Update #3899. Update #3993. --- cpukit/include/rtems/rtems/mainpage.h | 2 +- cpukit/include/rtems/rtems/tasks.h | 1838 ++++++++++++++++++++++----------- 2 files changed, 1248 insertions(+), 592 deletions(-) diff --git a/cpukit/include/rtems/rtems/mainpage.h b/cpukit/include/rtems/rtems/mainpage.h index 2209d56bd4..05bae7fe70 100644 --- a/cpukit/include/rtems/rtems/mainpage.h +++ b/cpukit/include/rtems/rtems/mainpage.h @@ -651,7 +651,7 @@ */ /** - * @addtogroup ClassicTasks + * @addtogroup RTEMSAPIClassicTasks * * @section ClassicTasksSecTaskDefinition Task Definition * diff --git a/cpukit/include/rtems/rtems/tasks.h b/cpukit/include/rtems/rtems/tasks.h index f71cb1ec6b..a8fe267884 100644 --- a/cpukit/include/rtems/rtems/tasks.h +++ b/cpukit/include/rtems/rtems/tasks.h @@ -1,231 +1,477 @@ +/* SPDX-License-Identifier: BSD-2-Clause */ + /** * @file * - * @ingroup ClassicTasks - * - * @brief Classic Task Manager API + * @brief This header file defines the main parts of the Tasks Manager API. + */ + +/* + * Copyright (C) 2013, 2021 embedded brains GmbH (http://www.embedded-brains.de) + * Copyright (C) 1988, 2017 On-Line Applications Research Corporation (OAR) + * + * 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. */ /* - * COPYRIGHT (c) 1989-2014. - * On-Line Applications Research Corporation (OAR). + * This file is part of the RTEMS quality process and was automatically + * generated. If you find something that needs to be fixed or + * worded better please post a report or patch to an RTEMS mailing list + * or raise a bug report: + * + * https://www.rtems.org/bugs.html * - * 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. + * For information on updating and regenerating please refer to the How-To + * section in the Software Requirements Engineering chapter of the + * RTEMS Software Engineering manual. The manual is provided as a part of + * a release. For development sources please refer to the online + * documentation at: + * + * https://docs.rtems.org */ +/* Generated from spec:/rtems/task/if/header */ + #ifndef _RTEMS_RTEMS_TASKS_H #define _RTEMS_RTEMS_TASKS_H +#include +#include +#include +#include #include +#include #include #include +#include #include +#include +#include #include #include +#include #ifdef __cplusplus extern "C" { #endif +/* Generated from spec:/rtems/scheduler/if/group */ + /** - * @defgroup ClassicTasks Tasks + * @defgroup RTEMSAPIClassicScheduler Scheduler Manager + * + * @ingroup RTEMSAPIClassic * - * @ingroup RTEMSAPIClassic + * @brief The scheduling concepts relate to the allocation of processing time + * for tasks. * - * This encapsulates the functionality of the Classic API Task Manager. - * This functionality includes task services such as creation, deletion, - * delays, suspend/resume, and manipulation of execution mode and priority. + * The concept of scheduling in real-time systems dictates the ability to + * provide an immediate response to specific external events, particularly the + * necessity of scheduling tasks to run within a specified time limit after the + * occurrence of an event. For example, software embedded in life-support + * systems used to monitor hospital patients must take instant action if a + * change in the patient’s status is detected. + * + * The component of RTEMS responsible for providing this capability is + * appropriately called the scheduler. The scheduler’s sole purpose is to + * allocate the all important resource of processor time to the various tasks + * competing for attention. */ -/**@{*/ -/** - * Constant to be used as the ID of current task - */ -#define RTEMS_SELF OBJECTS_ID_OF_SELF +/* Generated from spec:/rtems/task/if/group */ /** - * This constant is passed to the rtems_task_wake_after directive as the - * interval when a task wishes to yield the CPU. + * @defgroup RTEMSAPIClassicTasks Task Manager + * + * @ingroup RTEMSAPIClassic + * + * @brief The Task Manager provides a comprehensive set of directives to + * create, delete, and administer tasks. */ -#define RTEMS_YIELD_PROCESSOR WATCHDOG_NO_TIMEOUT + +/* Generated from spec:/rtems/scheduler/if/add-processor */ /** - * @brief Minimum stack size which every thread must exceed. + * @ingroup RTEMSAPIClassicScheduler + * + * @brief Adds the processor to the set of processors owned by the scheduler + * instance. + * + * @param scheduler_id is the scheduler instance identifier. + * + * @param cpu_index is the index of the processor to add. + * + * @retval ::RTEMS_SUCCESSFUL The requested operation was successful. + * + * @retval ::RTEMS_INCORRECT_STATE The processor was configured to be used by + * the application, however, it was not online. + * + * @retval ::RTEMS_INVALID_ID There was no scheduler associated with the + * identifier specified by ``scheduler_id``. * - * It is the minimum stack size recommended for use on this processor. This - * value is selected by the RTEMS developers conservatively to minimize the - * risk of blown stacks for most user applications. Using this constant when - * specifying the task stack size, indicates that the stack size will be at - * least RTEMS_MINIMUM_STACK_SIZE bytes in size. If the user configured minimum - * stack size is larger than the recommended minimum, then it will be used. + * @retval ::RTEMS_NOT_CONFIGURED The processor was not configured to be used + * by the application. + * + * @retval ::RTEMS_RESOURCE_IN_USE The processor was already assigned to a + * scheduler instance. + * + * @par Notes + * This directive shall be called from task context. It obtains and releases + * the objects allocator lock. */ -#define RTEMS_MINIMUM_STACK_SIZE STACK_MINIMUM_SIZE +rtems_status_code rtems_scheduler_add_processor( + rtems_id scheduler_id, + uint32_t cpu_index +); + +/* Generated from spec:/rtems/scheduler/if/get-maximum-priority */ /** - * @brief Specifies that the task should be created with the configured minimum - * stack size. + * @ingroup RTEMSAPIClassicScheduler * - * Using this constant when specifying the task stack size indicates that this - * task is to be created with a stack size of the minimum stack size that was - * configured by the application. If not explicitly configured by the - * application, the default configured minimum stack size is the processor - * dependent value RTEMS_MINIMUM_STACK_SIZE. Since this uses the configured - * minimum stack size value, you may get a stack size that is smaller or larger - * than the recommended minimum. This can be used to provide large stacks for - * all tasks on complex applications or small stacks on applications that are - * trying to conserve memory. + * @brief Gets the maximum task priority of the scheduler instance. + * + * @param scheduler_id is the scheduler instance identifier. + * + * @param[out] priority is the pointer to a task priority variable. The + * maximum priority of the scheduler instance will be stored in this + * variable, if the operation is successful. + * + * @retval ::RTEMS_SUCCESSFUL The requested operation was successful. + * + * @retval ::RTEMS_INVALID_ADDRESS The ``priority`` parameter was NULL. + * + * @retval ::RTEMS_INVALID_ID There was no scheduler associated with the + * identifier specified by ``scheduler_id``. */ -#define RTEMS_CONFIGURED_MINIMUM_STACK_SIZE 0 +rtems_status_code rtems_scheduler_get_maximum_priority( + rtems_id scheduler_id, + rtems_task_priority *priority +); -/** - * Define the type for an RTEMS API task priority. - */ -typedef uint32_t rtems_task_priority; +/* Generated from spec:/rtems/scheduler/if/get-processor */ /** - * This is the constant used with the rtems_task_set_priority - * directive to indicate that the caller wants to obtain its - * current priority rather than set it as the name of the - * directive indicates. + * @ingroup RTEMSAPIClassicScheduler + * + * @brief Returns the index of the current processor. + * + * In uniprocessor configurations, this macro evaluates to a compile time + * constant of zero. + * + * In SMP configurations, an architecture-specific method is used to obtain the + * index of the current processor in the system. The set of processor indices + * is the range of integers starting with zero up to + * rtems_scheduler_get_processor_maximum() minus one. + * + * @return The index of the current processor is returned. + * + * @par Notes + * Outside of sections with disabled thread dispatching the current processor + * index may change after every instruction since the thread may migrate from + * one processor to another. Sections with disabled interrupts are sections + * with thread dispatching disabled. */ -#define RTEMS_NO_PRIORITY RTEMS_CURRENT_PRIORITY +#define rtems_scheduler_get_processor() _SMP_Get_current_processor() + +/* Generated from spec:/rtems/scheduler/if/get-processor-maximum */ /** - * This constant is the least valid value for a Classic API - * task priority. + * @ingroup RTEMSAPIClassicScheduler + * + * @brief Returns the processor maximum supported by the system. + * + * In uniprocessor configurations, this macro evaluates to a compile time + * constant of one. + * + * In SMP configurations, this macro returns the minimum of the processors + * (physically or virtually) available by the platform and the configured + * processor maximum. Not all processors in the range from processor index + * zero to the last processor index (which is the processor maximum minus one) + * may be configured to be used by a scheduler or may be online (online + * processors have a scheduler assigned). + * + * @return The processor maximum supported by the system is returned. */ -#define RTEMS_MINIMUM_PRIORITY 1 +#define rtems_scheduler_get_processor_maximum() _SMP_Get_processor_maximum() -rtems_task_priority _RTEMS_Maximum_priority( void ); +/* Generated from spec:/rtems/scheduler/if/get-processor-set */ /** - * This run-time constant is the maximum valid value for a Classic API - * task priority. + * @ingroup RTEMSAPIClassicScheduler + * + * @brief Gets the set of processors owned by the scheduler. + * + * @param scheduler_id is the scheduler identifier. + * + * @param cpusetsize is the size of the referenced processor set variable in + * bytes. This value shall be positive. + * + * @param[out] cpuset is the pointer to a processor set variable. When the + * directive call is successful, the processor set of the scheduler will be + * stored in this variable. A set bit in the processor set means that the + * corresponding processor is owned by the scheduler, otherwise the bit is + * cleared. + * + * @retval ::RTEMS_SUCCESSFUL The requested operation was successful. + * + * @retval ::RTEMS_INVALID_ADDRESS The ``cpuset`` parameter was NULL. * - * @note This is actually the priority of the IDLE thread so - * using this priority will result in having a task - * which never executes. This could be useful if you - * want to ensure that a task does not executes during - * certain operations such as a system mode change. + * @retval ::RTEMS_INVALID_ID There was no scheduler associated with the + * identifier specified by ``scheduler_id``. + * + * @retval ::RTEMS_INVALID_NUMBER The provided processor set was too small for + * the set of processors owned by the scheduler. */ -#define RTEMS_MAXIMUM_PRIORITY _RTEMS_Maximum_priority() +rtems_status_code rtems_scheduler_get_processor_set( + rtems_id scheduler_id, + size_t cpusetsize, + cpu_set_t *cpuset +); + +/* Generated from spec:/rtems/scheduler/if/ident */ /** - * The following constant is passed to rtems_task_set_priority when the - * caller wants to obtain the current priority. + * @ingroup RTEMSAPIClassicScheduler + * + * @brief Identifies a scheduler by the object name. + * + * @param name is the scheduler name to look up. + * + * @param[out] id is the pointer to an object identifier variable. When the + * directive call is successful, the identifier of the scheduler instance + * will be stored in this variable. + * + * This directive obtains a scheduler identifier associated with the scheduler + * name specified in ``name``. + * + * @retval ::RTEMS_SUCCESSFUL The requested operation was successful. + * + * @retval ::RTEMS_INVALID_ADDRESS The ``id`` parameter was NULL. + * + * @retval ::RTEMS_INVALID_NAME The scheduler name was invalid. + * + * @par Notes + * @parblock + * The scheduler name is determined by the scheduler configuration. + * + * The scheduler identifier is used with other scheduler related directives to + * access the scheduler. + * @endparblock + * + * @par Constraints + * @parblock + * The following constraints apply to this directive: + * + * * The directive may be called from within any runtime context. + * + * * The directive will not cause the calling task to be preempted. + * @endparblock */ -#define RTEMS_CURRENT_PRIORITY 0 +rtems_status_code rtems_scheduler_ident( rtems_name name, rtems_id *id ); -struct _Thread_Control; +/* Generated from spec:/rtems/scheduler/if/ident-by-processor */ /** - * External API name for Thread_Control + * @ingroup RTEMSAPIClassicScheduler + * + * @brief Identifies a scheduler instance by a processor index. + * + * @param cpu_index is the processor index to identify the scheduler instance. + * + * @param[out] id is the pointer to an object identifier variable. When the + * directive call is successful, the identifier of the scheduler instance + * will be stored in this variable. + * + * @retval ::RTEMS_SUCCESSFUL The requested operation was successful. + * + * @retval ::RTEMS_INCORRECT_STATE The processor index was valid, however, the + * corresponding processor was not owned by a scheduler instance. + * + * @retval ::RTEMS_INVALID_ADDRESS The ``id`` parameter was NULL. + * + * @retval ::RTEMS_INVALID_NAME The processor index was invalid. */ -typedef struct _Thread_Control rtems_tcb; +rtems_status_code rtems_scheduler_ident_by_processor( + uint32_t cpu_index, + rtems_id *id +); -/** - * The following defines the "return type" of an RTEMS task. - */ -typedef void rtems_task; +/* Generated from spec:/rtems/scheduler/if/ident-by-processor-set */ /** - * The following defines the argument to an RTEMS task. + * @ingroup RTEMSAPIClassicScheduler + * + * @brief Identifies a scheduler by a processor set. + * + * @param cpusetsize is the size of the referenced processor set variable in + * bytes. This value shall be positive. + * + * @param cpuset is the pointer to a processor set variable. The referenced + * processor set will be used to identify the scheduler. + * + * @param[out] id is the pointer to an object identifier variable. When the + * directive call is successful, the identifier of the scheduler will be + * stored in this variable. + * + * The scheduler is selected according to the highest numbered online processor + * in the specified processor set. + * + * @retval ::RTEMS_SUCCESSFUL The requested operation was successful. + * + * @retval ::RTEMS_INCORRECT_STATE The processor set was valid, however, the + * highest numbered online processor in the processor set was not owned by a + * scheduler. + * + * @retval ::RTEMS_INVALID_ADDRESS The ``id`` parameter was NULL. + * + * @retval ::RTEMS_INVALID_NAME The processor set contained no online + * processor. + * + * @retval ::RTEMS_INVALID_SIZE The processor set size was invalid. */ -typedef CPU_Uint32ptr rtems_task_argument; +rtems_status_code rtems_scheduler_ident_by_processor_set( + size_t cpusetsize, + const cpu_set_t *cpuset, + rtems_id *id +); -/** - * The following defines the type for the entry point of an RTEMS task. - */ -typedef rtems_task ( *rtems_task_entry )( - rtems_task_argument - ); +/* Generated from spec:/rtems/scheduler/if/map-priority-from-posix */ /** - * The following records define the Initialization Tasks Table. - * Each entry contains the information required by RTEMS to - * create and start a user task automatically at executive - * initialization time. + * @ingroup RTEMSAPIClassicScheduler + * + * @brief Maps a POSIX thread priority to the corresponding Classic API task + * priority. + * + * @param scheduler_id is the scheduler identifier. + * + * @param posix_priority is the POSIX thread priority to map. + * + * @param[out] priority is the pointer to a Classic API task priority variable. + * When the directive call is successful, the Classic API task priority value + * corresponding to the specified POSIX thread priority value will be stored + * in this variable. + * + * @retval ::RTEMS_SUCCESSFUL The requested operation was successful. + * + * @retval ::RTEMS_INVALID_ADDRESS The ``priority`` parameter was NULL. + * + * @retval ::RTEMS_INVALID_ID There was no scheduler associated with the + * identifier specified by ``scheduler_id``. + * + * @retval ::RTEMS_INVALID_PRIORITY The POSIX thread priority was invalid. */ -typedef struct { - /** This is the Initialization Task's name. */ - rtems_name name; - /** This is the Initialization Task's stack size. */ - size_t stack_size; - /** This is the Initialization Task's priority. */ - rtems_task_priority initial_priority; - /** This is the Initialization Task's attributes. */ - rtems_attribute attribute_set; - /** This is the Initialization Task's entry point. */ - rtems_task_entry entry_point; - /** This is the Initialization Task's initial mode. */ - rtems_mode mode_set; - /** This is the Initialization Task's argument. */ - rtems_task_argument argument; -} rtems_initialization_tasks_table; +rtems_status_code rtems_scheduler_map_priority_from_posix( + rtems_id scheduler_id, + int posix_priority, + rtems_task_priority *priority +); + +/* Generated from spec:/rtems/scheduler/if/map-priority-to-posix */ /** - * @brief RTEMS Task Create + * @ingroup RTEMSAPIClassicScheduler + * + * @brief Maps a Classic API task priority to the corresponding POSIX thread + * priority. + * + * @param scheduler_id is the scheduler instance identifier. * - * This routine implements the rtems_task_create directive. The task - * will have the name name. The attribute_set can be used to indicate - * that the task will be globally accessible or utilize floating point. - * The task's stack will be stack_size bytes. The task will begin - * execution with initial_priority and initial_modes. It returns the - * id of the created task in ID. + * @param priority is the Classic API task priority to map. * - * @param[in] name is the user defined thread name - * @param[in] initial_priority is the thread priority - * @param[in] stack_size is the stack size in bytes - * @param[in] initial_modes is the initial thread mode - * @param[in] attribute_set is the thread attributes - * @param[in] id is the pointer to thread id + * @param[out] posix_priority is the pointer to a POSIX thread priority + * variable. When the directive call is successful, the POSIX thread + * priority value corresponding to the specified Classic API task priority + * value will be stored in this variable. * - * @retval RTEMS_SUCCESSFUL if successful or error code if unsuccessful - * and *id thread id filled in + * @retval ::RTEMS_SUCCESSFUL The requested operation was successful. + * + * @retval ::RTEMS_INVALID_ADDRESS The ``posix_priority`` parameter was NULL. + * + * @retval ::RTEMS_INVALID_ID There was no scheduler associated with the + * identifier specified by ``scheduler_id``. + * + * @retval ::RTEMS_INVALID_PRIORITY The Classic API task priority was invalid. */ -rtems_status_code rtems_task_create( - rtems_name name, - rtems_task_priority initial_priority, - size_t stack_size, - rtems_mode initial_modes, - rtems_attribute attribute_set, - rtems_id *id +rtems_status_code rtems_scheduler_map_priority_to_posix( + rtems_id scheduler_id, + rtems_task_priority priority, + int *posix_priority ); +/* Generated from spec:/rtems/scheduler/if/remove-processor */ + /** - * @brief This constant defines the recommended alignment of a task storage - * area in bytes. + * @ingroup RTEMSAPIClassicScheduler * - * Use it with RTEMS_ALIGNED() to define the alignment of a statically - * allocated task storage area. + * @brief Removes a processor from set of processors owned by the scheduler + * instance. + * + * @param scheduler_id is the scheduler instance identifier. + * + * @param cpu_index is the index of the processor to remove. + * + * @retval ::RTEMS_SUCCESSFUL The requested operation was successful. + * + * @retval ::RTEMS_INVALID_ID There was no scheduler associated with the + * identifier specified by ``scheduler_id``. + * + * @retval ::RTEMS_INVALID_NUMBER The processor was not owned by the specified + * scheduler instance. + * + * @retval ::RTEMS_RESOURCE_IN_USE The set of processors owned by the specified + * scheduler instance would have been empty after the processor removal and + * there was at least one non-idle task that used this scheduler instance as + * its home scheduler instance. + * + * @par Notes + * This directive shall be called from task context. It obtains and releases + * the objects allocator lock. Removing a processor from a scheduler instance + * is a complex operation that involves all tasks of the system. */ -#define RTEMS_TASK_STORAGE_ALIGNMENT CPU_STACK_ALIGNMENT +rtems_status_code rtems_scheduler_remove_processor( + rtems_id scheduler_id, + uint32_t cpu_index +); + +/* Generated from spec:/rtems/task/if/argument */ /** - * @brief Returns the recommended task storage area size for the specified size - * and task attributes. - * - * @param _size is the size dedicated to the task stack and thread-local - * storage in bytes. + * @ingroup RTEMSAPIClassicTasks * - * @param _attributes is the attribute set of the task using the storage area. + * @brief This type is used to represent task argument values. * - * @return The recommended task storage area size calculated from the input - * parameters is returned. + * @par Notes + * The type is an architecture-specific unsigned integer type which is large + * enough to represent pointer values and 32-bit unsigned integers. */ -#if CPU_ALL_TASKS_ARE_FP == TRUE - #define RTEMS_TASK_STORAGE_SIZE( _size, _attributes ) \ - ( ( _size ) + CONTEXT_FP_SIZE ) -#else - #define RTEMS_TASK_STORAGE_SIZE( _size, _attributes ) \ - ( ( _size ) + \ - ( ( ( _attributes ) & RTEMS_FLOATING_POINT ) != 0 ? \ - CONTEXT_FP_SIZE : 0 ) ) -#endif +typedef CPU_Uint32ptr rtems_task_argument; + +/* Generated from spec:/rtems/task/if/config */ /** + * @ingroup RTEMSAPIClassicTasks + * * @brief This structure defines the configuration of a task constructed by * rtems_task_construct(). */ @@ -310,46 +556,31 @@ typedef struct { rtems_attribute attributes; } rtems_task_config; +/* Generated from spec:/rtems/task/if/configured-minimum-stack-size */ + /** - * @brief Constructs a task from the specified the task configuration. - * - * In contrast to tasks created by rtems_task_create(), the tasks constructed - * by this directive use a user-provided task storage area. The task storage - * area contains the task stack, the thread-local storage, and the - * floating-point context on architectures with a separate floating-point - * context. - * - * This directive is intended for applications which do not want to use the - * RTEMS Workspace and instead statically allocate all operating system - * resources. It is not recommended to use rtems_task_create() and - * rtems_task_construct() together in an application. It is also not - * recommended to use rtems_task_construct() for drivers or general purpose - * libraries. The reason for these recommendations is that the task - * configuration needs settings which can be only given with a through - * knowledge of the application resources. + * @ingroup RTEMSAPIClassicTasks * - * An application based solely on static allocation can avoid any runtime - * memory allocators. This can simplify the application architecture as well - * as any analysis that may be required. - * - * The stack space estimate done by assumes that all tasks - * are created by rtems_task_create(). The estimate can be adjusted to take - * user-provided task storage areas into account through the - * #CONFIGURE_MINIMUM_TASKS_WITH_USER_PROVIDED_STORAGE application - * configuration option. + * @brief % + */ +#define RTEMS_CONFIGURED_MINIMUM_STACK_SIZE 0 + +/* Generated from spec:/rtems/task/if/construct */ + +/** + * @ingroup RTEMSAPIClassicTasks * - * The #CONFIGURE_MAXIMUM_TASKS should include tasks constructed by - * rtems_task_construct(). + * @brief Constructs a task from the specified the task configuration. * * @param config is the task configuration. * - * @param[out] id is the pointer to an object identifier variable. The - * identifier of the constructed task object will be stored in this variable, - * in case of a successful operation. + * @param[out] id is the pointer to an object identifier variable. When the + * directive call is successful, the identifier of the constructed task will + * be stored in this variable. * * @retval ::RTEMS_SUCCESSFUL The requested operation was successful. * - * @retval ::RTEMS_INVALID_ADDRESS The id parameter was NULL. + * @retval ::RTEMS_INVALID_ADDRESS The ``id`` parameter was NULL. * * @retval ::RTEMS_INVALID_NAME The task name was invalid. * @@ -380,172 +611,454 @@ typedef struct { * * @retval ::RTEMS_UNSATISFIED In SMP configurations, the interrupt level mode * was not supported. - */ -rtems_status_code rtems_task_construct( - const rtems_task_config *config, - rtems_id *id -); - -/** - * @brief RTEMS Task Name to Id * - * This routine implements the rtems_task_ident directive. - * This directive returns the task ID associated with name. - * If more than one task is named name, then the task to - * which the ID belongs is arbitrary. node indicates the - * extent of the search for the ID of the task named name. - * The search can be limited to a particular node or allowed to - * encompass all nodes. + * @par Notes + * @parblock + * In contrast to tasks created by rtems_task_create(), the tasks constructed + * by this directive use a user-provided task storage area. The task storage + * area contains the task stack, the thread-local storage, and the + * floating-point context on architectures with a separate floating-point + * context. * - * @param[in] name is the user defined thread name - * @param[in] node is(are) the node(s) to be searched - * @param[in] id is the pointer to thread id + * This directive is intended for applications which do not want to use the + * RTEMS Workspace and instead statically allocate all operating system + * resources. It is not recommended to use rtems_task_create() and + * rtems_task_construct() together in an application. It is also not + * recommended to use rtems_task_construct() for drivers or general purpose + * libraries. The reason for these recommendations is that the task + * configuration needs settings which can be only given with a through + * knowledge of the application resources. * - * @retval This method returns RTEMS_SUCCESSFUL if there was not an - * error. Otherwise, a status code is returned indicating the - * source of the error. If successful, the id will - * be filled in with the thread id. - */ -rtems_status_code rtems_task_ident( - rtems_name name, - uint32_t node, - rtems_id *id -); - -/** - * @brief RTEMS Delete Task + * An application based solely on static allocation can avoid any runtime + * memory allocators. This can simplify the application architecture as well + * as any analysis that may be required. + * + * The stack space estimate done by assumes that all tasks + * are created by rtems_task_create(). The estimate can be adjusted to take + * user-provided task storage areas into account through the + * #CONFIGURE_MINIMUM_TASKS_WITH_USER_PROVIDED_STORAGE application + * configuration option. + * + * The #CONFIGURE_MAXIMUM_TASKS should include tasks constructed by + * rtems_task_construct(). + * @endparblock * - * This routine implements the rtems_task_delete directive. The - * task indicated by ID is deleted. The executive halts execution - * of the thread and frees the thread control block. + * @par Constraints + * @parblock + * The following constraints apply to this directive: * - * @param[in] id is the thread id + * * The directive may be called from within device driver initialization + * context. * - * @retval This method returns RTEMS_SUCCESSFUL if there was not an - * error and id is not the requesting thread. Status code is - * returned indicating the source of the error. Nothing - * is returned if id is the requesting thread (always succeeds). + * * The directive may be called from within task context. + * + * * The directive may obtain and release the object allocator mutex. This may + * cause the calling task to be preempted. + * + * * When the directive operates on a global object, the directive sends a + * message to remote nodes. This may preempt the calling task. + * + * * The number of tasks available to the application is configured through the + * #CONFIGURE_MAXIMUM_TASKS application configuration option. + * + * * Where the object class corresponding to the directive is configured to use + * unlimited objects, the directive may allocate memory from the RTEMS + * Workspace. + * + * * The number of global objects available to the application is configured + * through the #CONFIGURE_MP_MAXIMUM_GLOBAL_OBJECTS application configuration + * option. + * @endparblock */ -rtems_status_code rtems_task_delete( - rtems_id id +rtems_status_code rtems_task_construct( + const rtems_task_config *config, + rtems_id *id ); -RTEMS_NO_RETURN void rtems_task_exit( void ); +/* Generated from spec:/rtems/task/if/create */ /** - * @brief RTEMS Task Mode + * @ingroup RTEMSAPIClassicTasks + * + * @brief Creates a task. + * + * @param name is the object name of the task. + * + * @param initial_priority is the initial task priority. + * + * @param stack_size is the task stack size in bytes. + * + * @param initial_modes is the initial mode set of the task. + * + * @param attribute_set is the attribute set of the task. + * + * @param[out] id is the pointer to an object identifier variable. When the + * directive call is successful, the identifier of the created task will be + * stored in this variable. + * + * This directive creates a task which resides on the local node. The task has + * the user-defined object name specified in ``name``. The assigned object + * identifier is returned in ``id``. This identifier is used to access the + * task with other task related directives. + * + * The **initial priority** of the task is specified in ``initial_priority``. + * The scheduler of the created task is the scheduler of the calling task at + * some point during the task creation. The initial task priority specified in + * ``initial_priority`` shall be valid for this scheduler. + * + * The **stack size** of the task is specified in ``stack_size``. If the + * requested stack size is less than the configured minimum stack size, then + * RTEMS will use the configured minimum as the stack size for this task. The + * configured minimum stack size is defined by the + * #CONFIGURE_MINIMUM_TASK_STACK_SIZE application configuration option. In + * addition to being able to specify the task stack size as a integer, there + * are two constants which may be specified: + * + * * The #RTEMS_MINIMUM_STACK_SIZE constant can be specified to use the + * **recommended minimum stack size** for the target processor. This value + * is selected by the RTEMS maintainers conservatively to minimize the risk + * of blown stacks for most user applications. Using this constant when + * specifying the task stack size, indicates that the stack size will be at + * least #RTEMS_MINIMUM_STACK_SIZE bytes in size. If the user configured + * minimum stack size is larger than the recommended minimum, then it will be + * used. + * + * * The #RTEMS_CONFIGURED_MINIMUM_STACK_SIZE constant can be specified to use + * the minimum stack size that was configured by the application. If not + * explicitly configured by the application, the default configured minimum + * stack size is the target processor dependent value + * #RTEMS_MINIMUM_STACK_SIZE. Since this uses the configured minimum stack + * size value, you may get a stack size that is smaller or larger than the + * recommended minimum. This can be used to provide large stacks for all + * tasks on complex applications or small stacks on applications that are + * trying to conserve memory. + * + * The **initial mode set** specified in ``initial_modes`` is built through a + * *bitwise or* of the mode constants described below. Not all combinations of + * modes are allowed. Some modes are mutually exclusive. If mutually + * exclusive modes are combined, the behaviour is undefined. Default task + * modes can be selected by using the #RTEMS_DEFAULT_MODES constant. The task + * mode set defines + * + * * the preemption mode of the task: #RTEMS_PREEMPT (default) or + * #RTEMS_NO_PREEMPT, + * + * * the timeslicing mode of the task: #RTEMS_TIMESLICE or #RTEMS_NO_TIMESLICE + * (default), + * + * * the ASR processing mode of the task: #RTEMS_ASR (default) or + * #RTEMS_NO_ASR, + * + * * the interrupt level of the task: RTEMS_INTERRUPT_LEVEL() with a default of + * ``RTEMS_INTERRUPT_LEVEL( 0 )`` which is associated with enabled + * interrupts. + * + * The **initial preemption mode** of the task is enabled or disabled. + * + * * An **enabled preemption** is the default and can be emphasized through the + * use of the #RTEMS_PREEMPT mode constant. + * + * * A **disabled preemption** is set by the #RTEMS_NO_PREEMPT mode constant. + * + * The **initial timeslicing mode** of the task is enabled or disabled. + * + * * A **disabled timeslicing** is the default and can be emphasized through + * the use of the #RTEMS_NO_TIMESLICE mode constant. + * + * * An **enabled timeslicing** is set by the #RTEMS_TIMESLICE mode constant. + * + * The **initial ASR processing mode** of the task is enabled or disabled. + * + * * An **enabled ASR processing** is the default and can be emphasized through + * the use of the #RTEMS_ASR mode constant. + * + * * A **disabled ASR processing** is set by the #RTEMS_NO_ASR mode constant. + * + * The **initial interrupt level mode** of the task is defined by + * RTEMS_INTERRUPT_LEVEL(). + * + * * Task execution with **interrupts enabled** the default and can be + * emphasized through the use of the RTEMS_INTERRUPT_LEVEL() mode macro with + * a value of zero (0) for the parameter. An interrupt level of zero is + * associated with enabled interrupts on all target processors. * - * This routine implements the rtems_task_mode directive. The current - * values of the modes indicated by mask of the calling task are changed - * to that indicated in mode_set. The former mode of the task is - * returned in mode_set. + * * Task execution at a **non-zero interrupt level** can be specified by the + * RTEMS_INTERRUPT_LEVEL() mode macro with a non-zero value for the + * parameter. The interrupt level portion of the task mode supports a + * maximum of 256 interrupt levels. These levels are mapped onto the + * interrupt levels actually supported by the target processor in a processor + * dependent fashion. + * + * The **attribute set** specified in ``attribute_set`` is built through a + * *bitwise or* of the attribute constants described below. Not all + * combinations of attributes are allowed. Some attributes are mutually + * exclusive. If mutually exclusive attributes are combined, the behaviour is + * undefined. Attributes not mentioned below are not evaluated by this + * directive and have no effect. Default attributes can be selected by using + * the #RTEMS_DEFAULT_ATTRIBUTES constant. The attribute set defines + * + * * the scope of the task: #RTEMS_LOCAL (default) or #RTEMS_GLOBAL and + * + * * the floating-point unit use of the task: #RTEMS_FLOATING_POINT or + * #RTEMS_NO_FLOATING_POINT (default). + * + * The task has a local or global **scope** in a multiprocessing network (this + * attribute does not refer to SMP systems). The scope is selected by the + * mutually exclusive #RTEMS_LOCAL and #RTEMS_GLOBAL attributes. * - * @param[in] mode_set is the new mode - * @param[in] mask is the mask - * @param[in] previous_mode_set is the address of previous mode set + * * A **local scope** is the default and can be emphasized through the use of + * the #RTEMS_LOCAL attribute. A local task can be only used by the node + * which created it. * - * @retval RTEMS_SUCCESSFUL and previous_mode_set filled in with the - * previous mode set + * * A **global scope** is established if the #RTEMS_GLOBAL attribute is set. + * Setting the global attribute in a single node system has no effect.the + * + * The **use of the floating-point unit** is selected by the mutually exclusive + * #RTEMS_FLOATING_POINT and #RTEMS_NO_FLOATING_POINT attributes. On some + * target processors, the use of the floating-point unit can be enabled or + * disabled for each task. Other target processors may have no hardware + * floating-point unit or enable the use of the floating-point unit for all + * tasks. Consult the *RTEMS CPU Architecture Supplement* for the details. + * + * * A **disabled floating-point unit** is the default and can be emphasized + * through use of the #RTEMS_NO_FLOATING_POINT attribute. For performance + * reasons, it is recommended that tasks not using the floating-point unit + * should specify this attribute. + * + * * An **enabled floating-point unit** is selected by the + * #RTEMS_FLOATING_POINT attribute. + * + * @retval ::RTEMS_SUCCESSFUL The requested operation was successful. + * + * @retval ::RTEMS_INVALID_NAME The ``name`` parameter was invalid. + * + * @retval ::RTEMS_INVALID_ADDRESS The ``id`` parameter was NULL. + * + * @retval ::RTEMS_INVALID_PRIORITY The ``initial_priority`` was invalid. + * + * @retval ::RTEMS_TOO_MANY There was no inactive object available to create a + * task. The number of tasks available to the application is configured + * through the #CONFIGURE_MAXIMUM_TASKS application configuration option. + * + * @retval ::RTEMS_TOO_MANY In multiprocessing configurations, there was no + * inactive global object available to create a global task. The number of + * global objects available to the application is configured through the + * #CONFIGURE_MP_MAXIMUM_GLOBAL_OBJECTS application configuration option. + * + * @retval ::RTEMS_UNSATISFIED There was not enough memory to allocate the task + * storage area. The task storage area contains the task stack, the + * thread-local storage, and the floating point context. + * + * @retval ::RTEMS_UNSATISFIED One of the task create extensions failed to + * create the task. + * + * @retval ::RTEMS_UNSATISFIED In SMP configurations, the non-preemption mode + * was not supported. + * + * @retval ::RTEMS_UNSATISFIED In SMP configurations, the interrupt level mode + * was not supported. + * + * @par Notes + * @parblock + * The task processor affinity is initialized to the set of online processors. + * + * When created, a task is placed in the dormant state and can only be made + * ready to execute using the directive rtems_task_start(). + * + * Application developers should consider the stack usage of the device drivers + * when calculating the stack size required for tasks which utilize the driver. + * The task stack size shall account for an target processor dependent + * interrupt stack frame which may be placed on the stack of the interrupted + * task while servicing an interrupt. The stack checker may be used to monitor + * the stack usage, see #CONFIGURE_STACK_CHECKER_ENABLED. + * + * For control and maintenance of the task, RTEMS allocates a TCB from the + * local TCB free pool and initializes it. + * + * The TCB for a global task is allocated on the local node. Task should not + * be made global unless remote tasks must interact with the task. This is to + * avoid the system overhead incurred by the creation of a global task. When a + * global task is created, the task's name and identifier must be transmitted + * to every node in the system for insertion in the local copy of the global + * object table. + * @endparblock + * + * @par Constraints + * @parblock + * The following constraints apply to this directive: + * + * * The directive may be called from within device driver initialization + * context. + * + * * The directive may be called from within task context. + * + * * The directive may obtain and release the object allocator mutex. This may + * cause the calling task to be preempted. + * + * * When the directive operates on a global object, the directive sends a + * message to remote nodes. This may preempt the calling task. + * + * * The number of tasks available to the application is configured through the + * #CONFIGURE_MAXIMUM_TASKS application configuration option. + * + * * Where the object class corresponding to the directive is configured to use + * unlimited objects, the directive may allocate memory from the RTEMS + * Workspace. + * + * * The number of global objects available to the application is configured + * through the #CONFIGURE_MP_MAXIMUM_GLOBAL_OBJECTS application configuration + * option. + * @endparblock */ -rtems_status_code rtems_task_mode( - rtems_mode mode_set, - rtems_mode mask, - rtems_mode *previous_mode_set +rtems_status_code rtems_task_create( + rtems_name name, + rtems_task_priority initial_priority, + size_t stack_size, + rtems_mode initial_modes, + rtems_attribute attribute_set, + rtems_id *id ); +/* Generated from spec:/rtems/task/if/current-priority */ + /** - * @brief RTEMS Task Restart + * @ingroup RTEMSAPIClassicTasks * - * This routine implements the rtems_task_restart directive. The - * task associated with ID is restarted at its initial entry - * point with the new argument. - * - * @param[in] id is the thread id - * @param[in] argument is the thread argument - * - * @retval RTEMS_SUCCESSFUL if successful or error code if unsuccessful + * @brief This constant is passed to {set-priority:/name}() when the caller + * wants to obtain the current priority. */ -rtems_status_code rtems_task_restart( - rtems_id id, - rtems_task_argument argument -); +#define RTEMS_CURRENT_PRIORITY 0 + +/* Generated from spec:/rtems/task/if/delete */ /** - * @brief RTEMS Suspend Task + * @ingroup RTEMSAPIClassicTasks + * + * @brief Deletes the task. + * + * @param id is the task identifier. + * + * This directive deletes the task, either the calling task or another task, as + * specified by ``id``. + * + * @retval ::RTEMS_SUCCESSFUL The requested operation was successful. * - * This routine implements the rtems_task_suspend directive. The - * SUSPENDED state is set for task associated with ID. Note that the - * suspended state can be in addition to other waiting states. + * @retval ::RTEMS_INVALID_ID There was no task associated with the identifier + * specified by ``id``. * - * @param[in] id is the thread id + * @retval ::RTEMS_ILLEGAL_ON_REMOTE_OBJECT The task resided on a remote node. * - * @retval This method returns RTEMS_SUCCESSFUL if there was not an - * error. Otherwise, a status code is returned indicating the - * source of the error. + * @par Notes + * @parblock + * RTEMS stops the execution of the task and reclaims the stack memory, any + * allocated delay or timeout timers, the TCB, and, if the task is + * #RTEMS_FLOATING_POINT, its floating point context area. RTEMS explicitly + * does not reclaim the following resources: region segments, partition + * buffers, semaphores, timers, or rate monotonic periods. + * + * A task is responsible for releasing its resources back to RTEMS before + * deletion. To insure proper deallocation of resources, a task should not be + * deleted unless it is unable to execute or does not hold any RTEMS resources. + * If a task holds RTEMS resources, the task should be allowed to deallocate + * its resources before deletion. A task can be directed to release its + * resources and delete itself by restarting it with a special argument or by + * sending it a message, an event, or a signal. + * + * Deletion of the current task (#RTEMS_SELF) will force RTEMS to select + * another task to execute. + * + * The TCB for the deleted task is reclaimed by RTEMS. + * + * When a global task is deleted, the task identifier must be transmitted to + * every node in the system for deletion from the local copy of the global + * object table. + * + * The task must reside on the local node, even if the task was created with + * the #RTEMS_GLOBAL attribute. + * @endparblock + * + * @par Constraints + * @parblock + * The following constraints apply to this directive: + * + * * The directive may be called from within device driver initialization + * context. + * + * * The directive may be called from within task context. + * + * * The directive may obtain and release the object allocator mutex. This may + * cause the calling task to be preempted. + * + * * When the directive operates on a global object, the directive sends a + * message to remote nodes. This may preempt the calling task. + * + * * The calling task does not have to be the task that created the object. + * Any local task that knows the object identifier can delete the object. + * + * * Where the object class corresponding to the directive is configured to use + * unlimited objects, the directive may free memory to the RTEMS Workspace. + * @endparblock */ -rtems_status_code rtems_task_suspend( - rtems_id id -); +rtems_status_code rtems_task_delete( rtems_id id ); + +/* Generated from spec:/rtems/task/if/task */ /** - * @brief RTEMS Resume Task + * @ingroup RTEMSAPIClassicTasks * - * This routine implements the rtems_task_resume Directive. The - * SUSPENDED state is cleared for task associated with ID. + * @brief % + */ +typedef void rtems_task; + +/* Generated from spec:/rtems/task/if/entry */ + +/** + * @ingroup RTEMSAPIClassicTasks * - * @param[in] id is the thread id + * @brief This type defines the entry point of an RTEMS task. + */ +typedef rtems_task ( *rtems_task_entry )( rtems_task_argument ); + +/* Generated from spec:/rtems/task/if/exit */ + +/** + * @ingroup RTEMSAPIClassicTasks * - * @retval This method returns RTEMS_SUCCESSFUL if there was not an - * error. Otherwise, a status code is returned indicating the - * source of the error. + * @brief % */ -rtems_status_code rtems_task_resume( - rtems_id id -); +RTEMS_NO_RETURN void rtems_task_exit( void ); + +/* Generated from spec:/rtems/task/if/get-affinity */ /** - * @brief RTEMS Set Task Priority + * @ingroup RTEMSAPIClassicTasks + * + * @brief % * - * This routine implements the rtems_task_set_priority directive. The - * current priority of the task associated with ID is set to - * new_priority. The former priority of that task is returned - * in old_priority. + * @param id % * - * @param[in] id is the thread to extract - * @param[in] new_priority is the thread to extract - * @param[in] old_priority is the thread to extract + * @param cpusetsize % * - * @retval RTEMS_SUCCESSFUL if successful or error code if unsuccessful and - * and *old_priority filled in with the previous previous priority + * @param cpuset % */ -rtems_status_code rtems_task_set_priority( - rtems_id id, - rtems_task_priority new_priority, - rtems_task_priority *old_priority +rtems_status_code rtems_task_get_affinity( + rtems_id id, + size_t cpusetsize, + cpu_set_t *cpuset ); +/* Generated from spec:/rtems/task/if/get-priority */ + /** - * @brief Gets the current priority of the specified task with respect to the - * specified scheduler instance. + * @ingroup RTEMSAPIClassicTasks * - * The current priority reflects temporary priority adjustments due to locking - * protocols, the rate-monotonic period objects on some schedulers and other - * mechanisms. + * @brief % * - * @param[in] task_id Identifier of the task. Use @ref RTEMS_SELF to select - * the executing task. - * @param[in] scheduler_id Identifier of the scheduler instance. - * @param[out] priority Returns the current priority of the specified task with - * respect to the specified scheduler instance. + * @param task_id % * - * @retval RTEMS_SUCCESSFUL Successful operation. - * @retval RTEMS_ILLEGAL_ON_REMOTE_OBJECT Directive is illegal on remote tasks. - * @retval RTEMS_INVALID_ADDRESS The priority parameter is @c NULL. - * @retval RTEMS_INVALID_ID Invalid task or scheduler identifier. - * @retval RTEMS_NOT_DEFINED The task has no priority within the specified - * scheduler instance. This error is only possible on SMP configurations. + * @param scheduler_id % * - * @see rtems_scheduler_ident(). + * @param priority % */ rtems_status_code rtems_task_get_priority( rtems_id task_id, @@ -553,423 +1066,566 @@ rtems_status_code rtems_task_get_priority( rtems_task_priority *priority ); +/* Generated from spec:/rtems/task/if/get-scheduler */ + /** - * @brief RTEMS Start Task + * @ingroup RTEMSAPIClassicTasks + * + * @brief % * - * RTEMS Task Manager + * @param task_id % * - * This routine implements the rtems_task_start directive. The - * starting execution point of the task associated with ID is - * set to entry_point with the initial argument. + * @param scheduler_id % */ -rtems_status_code rtems_task_start( - rtems_id id, - rtems_task_entry entry_point, - rtems_task_argument argument +rtems_status_code rtems_task_get_scheduler( + rtems_id task_id, + rtems_id *scheduler_id ); +/* Generated from spec:/rtems/task/if/ident */ + /** - * @brief RTEMS Task Wake When + * @ingroup RTEMSAPIClassicTasks + * + * @brief Identifies a task by the object name. + * + * @param name is the object name to look up. + * + * @param node is the node or node set to search for a matching object. + * + * @param[out] id is the pointer to an object identifier variable. When the + * directive call is successful, the object identifier of an object with the + * specified name will be stored in this variable. + * + * This directive obtains a task identifier associated with the task name + * specified in ``name``. + * + * A task may obtain its own identifier by specifying #RTEMS_SELF for the name. + * + * The node to search is specified in ``node``. It shall be * - * This routine implements the rtems_task_wake_when directive. The - * calling task is blocked until the current time of day is - * equal to that indicated by time_buffer. + * * a valid node number, * - * @param[in] time_buffer is the pointer to the time and date structure + * * the constant #RTEMS_SEARCH_ALL_NODES to search in all nodes, * - * @retval RTEMS_SUCCESSFUL if successful or error code if unsuccessful + * * the constant #RTEMS_SEARCH_LOCAL_NODE to search in the local node only, or + * + * * the constant #RTEMS_SEARCH_OTHER_NODES to search in all nodes except the + * local node. + * + * @retval ::RTEMS_SUCCESSFUL The requested operation was successful. + * + * @retval ::RTEMS_INVALID_ADDRESS The ``id`` parameter was NULL. + * + * @retval ::RTEMS_INVALID_NAME There was no object with the specified name on + * the specified nodes. + * + * @retval ::RTEMS_INVALID_NODE In multiprocessing configurations, the + * specified node was invalid. + * + * @par Notes + * @parblock + * If the task name is not unique, then the task identifier will match the + * first task with that name in the search order. However, this task + * identifier is not guaranteed to correspond to the desired task. + * + * The objects are searched from lowest to the highest index. If ``node`` is + * #RTEMS_SEARCH_ALL_NODES, all nodes are searched with the local node being + * searched first. All other nodes are searched from lowest to the highest + * node number. + * + * If node is a valid node number which does not represent the local node, then + * only the tasks exported by the designated node are searched. + * + * This directive does not generate activity on remote nodes. It accesses only + * the local copy of the global object table. + * + * The task identifier is used with other task related directives to access the + * task. + * @endparblock + * + * @par Constraints + * @parblock + * The following constraints apply to this directive: + * + * * The directive may be called from within any runtime context. + * + * * The directive will not cause the calling task to be preempted. + * @endparblock */ -rtems_status_code rtems_task_wake_when( - rtems_time_of_day *time_buffer +rtems_status_code rtems_task_ident( + rtems_name name, + uint32_t node, + rtems_id *id ); +/* Generated from spec:/rtems/task/if/initialization-table */ + /** - * @brief RTEMS Task Wake After + * @ingroup RTEMSAPIClassicTasks * - * This routine implements the rtems_task_wake_after directive. The - * calling task is blocked until the indicated number of clock - * ticks have occurred. - * - * @param[in] ticks is the number of ticks to wait - * @retval RTEMS_SUCCESSFUL + * @brief % */ -rtems_status_code rtems_task_wake_after( - rtems_interval ticks -); +typedef struct { + /** + * @brief % + * + * % + */ + rtems_name name; + + /** + * @brief % + * + * % + */ + size_t stack_size; + + /** + * @brief % + * + * % + */ + rtems_task_priority initial_priority; + + /** + * @brief % + * + * % + */ + rtems_attribute attribute_set; + + /** + * @brief % + * + * % + */ + rtems_task_entry entry_point; + + /** + * @brief % + * + * % + */ + rtems_mode mode_set; + + /** + * @brief % + * + * % + */ + rtems_task_argument argument; +} rtems_initialization_tasks_table; + +/* Generated from spec:/rtems/task/if/is-suspended */ /** - * @brief rtems_task_is_suspended + * @ingroup RTEMSAPIClassicTasks + * + * @brief % * - * This directive returns a status indicating whether or not - * the specified task is suspended. + * @param id % */ -rtems_status_code rtems_task_is_suspended( - rtems_id id -); +rtems_status_code rtems_task_is_suspended( rtems_id id ); + +/* Generated from spec:/rtems/task/if/minimum-priority */ /** - * @brief Gets the processor affinity set of a task. + * @ingroup RTEMSAPIClassicTasks * - * @param[in] id Identifier of the task. Use @ref RTEMS_SELF to select the - * executing task. - * @param[in] cpusetsize Size of the specified affinity set buffer in - * bytes. This value must be positive. - * @param[out] cpuset The current processor affinity set of the task. A set - * bit in the affinity set means that the task can execute on this processor - * and a cleared bit means the opposite. - * - * @retval RTEMS_SUCCESSFUL Successful operation. - * @retval RTEMS_INVALID_ADDRESS The @a cpuset parameter is @c NULL. - * @retval RTEMS_INVALID_ID Invalid task identifier. - * @retval RTEMS_INVALID_NUMBER The affinity set buffer is too small for the - * current processor affinity set of the task. + * @brief % */ -rtems_status_code rtems_task_get_affinity( - rtems_id id, - size_t cpusetsize, - cpu_set_t *cpuset -); +#define RTEMS_MINIMUM_PRIORITY 1 + +/* Generated from spec:/rtems/task/if/minimum-stack-size */ /** - * @brief Sets the processor affinity set of a task. - * - * This function will not change the scheduler of the task. The intersection - * of the processor affinity set and the set of processors owned by the - * scheduler of the task must be non-empty. It is not an error if the - * processor affinity set contains processors that are not part of the set of - * processors owned by the scheduler instance of the task. A task will simply - * not run under normal circumstances on these processors since the scheduler - * ignores them. Some locking protocols may temporarily use processors that - * are not included in the processor affinity set of the task. It is also not - * an error if the processor affinity set contains processors that are not part - * of the system. - * - * @param[in] id Identifier of the task. Use @ref RTEMS_SELF to select the - * executing task. - * @param[in] cpusetsize Size of the specified affinity set buffer in - * bytes. This value must be positive. - * @param[in] cpuset The new processor affinity set for the task. A set bit in - * the affinity set means that the task can execute on this processor and a - * cleared bit means the opposite. - * - * @retval RTEMS_SUCCESSFUL Successful operation. - * @retval RTEMS_INVALID_ADDRESS The @a cpuset parameter is @c NULL. - * @retval RTEMS_INVALID_ID Invalid task identifier. - * @retval RTEMS_INVALID_NUMBER Invalid processor affinity set. + * @ingroup RTEMSAPIClassicTasks + * + * @brief % */ -rtems_status_code rtems_task_set_affinity( - rtems_id id, - size_t cpusetsize, - const cpu_set_t *cpuset -); +#define RTEMS_MINIMUM_STACK_SIZE STACK_MINIMUM_SIZE + +/* Generated from spec:/rtems/task/if/mode */ /** - * @brief Gets the scheduler of a task. + * @ingroup RTEMSAPIClassicTasks + * + * @brief Gets and optionally sets the mode of the calling task. + * + * @param mode_set is the mode set to apply to the calling task. When ``mask`` + * is set to #RTEMS_CURRENT_MODE, the value of this parameter is ignored. + * Only modes requested by ``mask`` are applied to the calling task. + * + * @param mask is the mode mask which specifies which modes in ``mode_set`` are + * applied to the calling task. When the value is #RTEMS_CURRENT_MODE, the + * mode of the calling task is not changed. + * + * @param previous_mode_set is the pointer to a mode variable. When the + * directive call is successful, the mode of the task before any mode changes + * done by the directive call will be stored in this variable. + * + * This directive queries and optionally manipulates the execution mode of the + * calling task. A task's execution mode enables and disables preemption, + * timeslicing, asynchronous signal processing, as well as specifying the + * interrupt level. To modify an execution mode, the mode class(es) to be + * changed must be specified in the ``mask`` parameter and the desired mode(s) + * must be specified in the ``mode_set`` parameter. + * + * A task can obtain its current execution mode, without modifying it, by + * calling this directive with a ``mask`` value of #RTEMS_CURRENT_MODE. + * + * The **mode set** specified in ``mode_set`` is built through a *bitwise or* + * of the mode constants described below. Not all combinations of modes are + * allowed. Some modes are mutually exclusive. If mutually exclusive modes + * are combined, the behaviour is undefined. Default task modes can be + * selected by using the #RTEMS_DEFAULT_MODES constant. The task mode set + * defines + * + * * the preemption mode of the task: #RTEMS_PREEMPT (default) or + * #RTEMS_NO_PREEMPT, + * + * * the timeslicing mode of the task: #RTEMS_TIMESLICE or #RTEMS_NO_TIMESLICE + * (default), * - * @param[in] task_id Identifier of the task. Use @ref RTEMS_SELF to select - * the executing task. - * @param[out] scheduler_id Identifier of the scheduler instance. + * * the ASR processing mode of the task: #RTEMS_ASR (default) or + * #RTEMS_NO_ASR, * - * @retval RTEMS_SUCCESSFUL Successful operation. - * @retval RTEMS_INVALID_ADDRESS The @a scheduler_id parameter is @c NULL. - * @retval RTEMS_INVALID_ID Invalid task identifier. + * * the interrupt level of the task: RTEMS_INTERRUPT_LEVEL() with a default of + * ``RTEMS_INTERRUPT_LEVEL( 0 )`` which is associated with enabled + * interrupts. + * + * The **mode mask** specified in ``mask`` is built through a *bitwise or* of + * the mode mask constants described below. + * + * When the #RTEMS_PREEMPT_MASK is set in ``mask``, the **preemption mode** of + * the calling task is + * + * * enabled by using the #RTEMS_PREEMPT mode constant in ``mode_set`` and + * + * * disabled by using the #RTEMS_NO_PREEMPT mode constant in ``mode_set``. + * + * When the #RTEMS_TIMESLICE_MASK is set in ``mask``, the **timeslicing mode** + * of the calling task is + * + * * enabled by using the #RTEMS_TIMESLICE mode constant in ``mode_set`` and + * + * * disabled by using the #RTEMS_NO_TIMESLICE mode constant in ``mode_set``. + * + * Enabling timeslicing has no effect if preemption is disabled. For a task to + * be timesliced, that task must have both preemption and timeslicing enabled. + * + * When the #RTEMS_ASR_MASK is set in ``mask``, the **ASR processing mode** of + * the calling task is + * + * * enabled by using the #RTEMS_ASR mode constant in ``mode_set`` and + * + * * disabled by using the #RTEMS_NO_ASR mode constant in ``mode_set``. + * + * When the #RTEMS_INTERRUPT_MASK is set in ``mask``, **interrupts** of the + * calling task are + * + * * enabled by using the RTEMS_INTERRUPT_LEVEL() mode macro with a value of + * zero (0) in ``mode_set`` and + * + * * disabled up to the specified level by using the RTEMS_INTERRUPT_LEVEL() + * mode macro with a positive value in ``mode_set``. + * + * An interrupt level of zero is associated with enabled interrupts on all + * target processors. The interrupt level portion of the task mode supports a + * maximum of 256 interrupt levels. These levels are mapped onto the interrupt + * levels actually supported by the target processor in a processor dependent + * fashion. + * + * @retval ::RTEMS_SUCCESSFUL The requested operation was successful. + * + * @retval ::RTEMS_NOT_IMPLEMENTED The #RTEMS_NO_PREEMPT was set in + * ``mode_set`` and setting the preemption mode was requested by + * #RTEMS_PREEMPT_MASK in ``mask`` and the system configuration had no + * implementation for this mode. + * + * @retval ::RTEMS_NOT_IMPLEMENTED The RTEMS_INTERRUPT_LEVEL() was set to a + * positive level in ``mode_set`` and setting the interrupt level was + * requested by #RTEMS_INTERRUPT_MASK in ``mask`` and the system + * configuration had no implementation for this mode. + * + * @par Constraints + * @parblock + * The following constraints apply to this directive: + * + * * The directive may be called from within task context. + * + * * When the directive enables preemption for the calling task, another task + * may preempt the calling task. + * @endparblock */ -rtems_status_code rtems_task_get_scheduler( - rtems_id task_id, - rtems_id *scheduler_id +rtems_status_code rtems_task_mode( + rtems_mode mode_set, + rtems_mode mask, + rtems_mode *previous_mode_set ); +/* Generated from spec:/rtems/task/if/no-priority */ + /** - * @brief Sets the scheduler instance of a task. + * @ingroup RTEMSAPIClassicTasks * - * Initially, the scheduler instance of a task is set to the scheduler instance - * of the task that created it. This directive allows to move a task from its - * current scheduler instance to another specified by the scheduler identifier. + * @brief % + */ +#define RTEMS_NO_PRIORITY RTEMS_CURRENT_PRIORITY + +/* Generated from spec:/rtems/task/if/restart */ + +/** + * @ingroup RTEMSAPIClassicTasks * - * @param[in] task_id Identifier of the task. Use @ref RTEMS_SELF to select - * the executing task. - * @param[in] scheduler_id Identifier of the scheduler instance. - * @param[in] priority The task priority with respect to the new scheduler - * instance. The real and initial priority of the task is set to this value. - * The initial priority is used by rtems_task_restart() for example. + * @brief % * - * @retval RTEMS_SUCCESSFUL Successful operation. - * @retval RTEMS_ILLEGAL_ON_REMOTE_OBJECT Directive is illegal on remote tasks. - * @retval RTEMS_INVALID_ID Invalid task or scheduler identifier. - * @retval RTEMS_INVALID_PRIORITY Invalid priority. - * @retval RTEMS_RESOURCE_IN_USE The task owns resources which deny a scheduler - * change. + * @param id % * - * @see rtems_scheduler_ident(). + * @param argument % */ -rtems_status_code rtems_task_set_scheduler( - rtems_id task_id, - rtems_id scheduler_id, - rtems_task_priority priority +rtems_status_code rtems_task_restart( + rtems_id id, + rtems_task_argument argument ); +/* Generated from spec:/rtems/task/if/resume */ + /** - * @brief RTEMS Get Self Task Id + * @ingroup RTEMSAPIClassicTasks + * + * @brief % * - * This directive returns the ID of the currently executing task. + * @param id % */ -rtems_id rtems_task_self(void); +rtems_status_code rtems_task_resume( rtems_id id ); + +/* Generated from spec:/rtems/task/if/self */ /** - * @brief Task visitor. + * @ingroup RTEMSAPIClassicTasks * - * @param[in] tcb The task control block. - * @param[in] arg The visitor argument. - * - * @retval true Stop the iteration. - * @retval false Otherwise. + * @brief % + */ +rtems_id rtems_task_self( void ); + +/* Generated from spec:/rtems/task/if/self-define */ + +/** + * @ingroup RTEMSAPIClassicTasks * - * @see rtems_task_iterate(). + * @brief % */ -typedef bool ( *rtems_task_visitor )( rtems_tcb *tcb, void *arg ); +#define RTEMS_SELF OBJECTS_ID_OF_SELF + +/* Generated from spec:/rtems/task/if/set-affinity */ /** - * @brief Iterates over all tasks in the system. + * @ingroup RTEMSAPIClassicTasks * - * This operation covers all tasks of all APIs. + * @brief % * - * Must be called from task context. This operation obtains and releases the - * objects allocator lock. The task visitor is called while owning the objects - * allocator lock. It is possible to perform blocking operations in the task - * visitor, however, take care that no deadlocks via the object allocator lock - * can occur. + * @param id % * - * @param[in] visitor The task visitor. - * @param[in] arg The visitor argument. + * @param cpusetsize % + * + * @param cpuset % */ -void rtems_task_iterate( - rtems_task_visitor visitor, - void *arg +rtems_status_code rtems_task_set_affinity( + rtems_id id, + size_t cpusetsize, + const cpu_set_t *cpuset ); +/* Generated from spec:/rtems/task/if/set-priority */ + /** - * @brief Identifies a scheduler by its name. + * @ingroup RTEMSAPIClassicTasks * - * The scheduler name is determined by the scheduler configuration. + * @brief % + * + * @param id % * - * @param[in] name The scheduler name. - * @param[out] id The scheduler identifier associated with the name. + * @param new_priority % * - * @retval RTEMS_SUCCESSFUL Successful operation. - * @retval RTEMS_INVALID_ADDRESS The @a id parameter is @c NULL. - * @retval RTEMS_INVALID_NAME Invalid scheduler name. + * @param old_priority % */ -rtems_status_code rtems_scheduler_ident( - rtems_name name, - rtems_id *id +rtems_status_code rtems_task_set_priority( + rtems_id id, + rtems_task_priority new_priority, + rtems_task_priority *old_priority ); +/* Generated from spec:/rtems/task/if/set-scheduler */ + /** - * @brief Identifies a scheduler by a processor index. + * @ingroup RTEMSAPIClassicTasks + * + * @brief % + * + * @param task_id % * - * @param[in] cpu_index The processor index. - * @param[out] id The scheduler identifier associated with the processor index. + * @param scheduler_id % * - * @retval RTEMS_SUCCESSFUL Successful operation. - * @retval RTEMS_INVALID_ADDRESS The @a id parameter is @c NULL. - * @retval RTEMS_INVALID_NAME Invalid processor index. - * @retval RTEMS_INCORRECT_STATE The processor index is valid, however, this - * processor is not owned by a scheduler. + * @param priority % */ -rtems_status_code rtems_scheduler_ident_by_processor( - uint32_t cpu_index, - rtems_id *id +rtems_status_code rtems_task_set_scheduler( + rtems_id task_id, + rtems_id scheduler_id, + rtems_task_priority priority ); +/* Generated from spec:/rtems/task/if/start */ + /** - * @brief Identifies a scheduler by a processor set. + * @ingroup RTEMSAPIClassicTasks * - * The scheduler is selected according to the highest numbered online processor - * in the specified processor set. + * @brief % * - * @param[in] cpusetsize Size of the specified processor set buffer in - * bytes. This value must be positive. - * @param[out] cpuset The processor set to identify the scheduler. - * @param[out] id The scheduler identifier associated with the processor set. + * @param id % * - * @retval RTEMS_SUCCESSFUL Successful operation. - * @retval RTEMS_INVALID_ADDRESS The @a id parameter is @c NULL. - * @retval RTEMS_INVALID_SIZE Invalid processor set size. - * @retval RTEMS_INVALID_NAME The processor set contains no online processor. - * @retval RTEMS_INCORRECT_STATE The processor set is valid, however, the - * highest numbered online processor in the specified processor set is not - * owned by a scheduler. + * @param entry_point % + * + * @param argument % */ -rtems_status_code rtems_scheduler_ident_by_processor_set( - size_t cpusetsize, - const cpu_set_t *cpuset, - rtems_id *id +rtems_status_code rtems_task_start( + rtems_id id, + rtems_task_entry entry_point, + rtems_task_argument argument ); +/* Generated from spec:/rtems/task/if/storage-alignment */ + /** - * @brief Returns the index of the current processor. - * - * In uniprocessor configurations, a value of zero will be returned. + * @ingroup RTEMSAPIClassicTasks * - * In SMP configurations, an architecture specific method is used to obtain the - * index of the current processor in the system. The set of processor indices - * is the range of integers starting with zero up to the processor count minus - * one. - * - * Outside of sections with disabled thread dispatching the current processor - * index may change after every instruction since the thread may migrate from - * one processor to another. Sections with disabled interrupts are sections - * with thread dispatching disabled. + * @brief This constant defines the recommended alignment of a task storage + * area in bytes. * - * @return The index of the current processor. + * @par Notes + * Use it with RTEMS_ALIGNED() to define the alignment of a statically + * allocated task storage area. */ -#define rtems_scheduler_get_processor() _SMP_Get_current_processor() +#define RTEMS_TASK_STORAGE_ALIGNMENT CPU_STACK_ALIGNMENT + +/* Generated from spec:/rtems/task/if/storage-size */ /** - * @brief Returns the processor maximum supported by the system. + * @ingroup RTEMSAPIClassicTasks * - * In uniprocessor configurations, a value of one will be returned. + * @brief Returns the recommended task storage area size for the specified size + * and task attributes. * - * In SMP configurations, this function returns the minimum of the processors - * (physically or virtually) available by the platform and the configured - * processor maximum. Not all processors in the range from processor index - * zero to the last processor index (which is the processor maximum minus one) - * may be configured to be used by a scheduler or online (online processors - * have a scheduler assigned). + * @param _size is the size dedicated to the task stack and thread-local + * storage in bytes. * - * @return The processor maximum supported by the system. + * @param _attributes is the attribute set of the task using the storage area. * - * @see rtems_scheduler_add_processor() and rtems_scheduler_remove_processor(). + * @return The recommended task storage area size calculated from the input + * parameters is returned. */ -#define rtems_scheduler_get_processor_maximum() _SMP_Get_processor_maximum() +#if CPU_ALL_TASKS_ARE_FP == TRUE + #define RTEMS_TASK_STORAGE_SIZE( _size, _attributes ) \ + ( ( _size ) + CONTEXT_FP_SIZE ) +#else + #define RTEMS_TASK_STORAGE_SIZE( _size, _attributes ) \ + ( ( _size ) + \ + ( ( ( _attributes ) & RTEMS_FLOATING_POINT ) != 0 ? \ + CONTEXT_FP_SIZE : 0 ) ) +#endif + +/* Generated from spec:/rtems/task/if/suspend */ /** - * @brief Gets the set of processors owned by the specified scheduler instance. + * @ingroup RTEMSAPIClassicTasks * - * @param[in] scheduler_id Identifier of the scheduler instance. - * @param[in] cpusetsize Size of the specified processor set buffer in - * bytes. This value must be positive. - * @param[out] cpuset The processor set owned by the scheduler. A set bit in - * the processor set means that this processor is owned by the scheduler and a - * cleared bit means the opposite. + * @brief % * - * @retval RTEMS_SUCCESSFUL Successful operation. - * @retval RTEMS_INVALID_ADDRESS The @a cpuset parameter is @c NULL. - * @retval RTEMS_INVALID_ID Invalid scheduler instance identifier. - * @retval RTEMS_INVALID_NUMBER The processor set buffer is too small for the - * set of processors owned by the scheduler. + * @param id % */ -rtems_status_code rtems_scheduler_get_processor_set( - rtems_id scheduler_id, - size_t cpusetsize, - cpu_set_t *cpuset -); +rtems_status_code rtems_task_suspend( rtems_id id ); + +/* Generated from spec:/rtems/task/if/tcb */ /** - * @brief Adds a processor to the set of processors owned by the specified - * scheduler instance. + * @ingroup RTEMSAPIClassicTasks * - * Must be called from task context. This operation obtains and releases the - * objects allocator lock. - * - * @param[in] scheduler_id Identifier of the scheduler instance. - * @param[in] cpu_index Index of the processor to add. + * @brief % + */ +typedef struct _Thread_Control rtems_tcb; + +/* Generated from spec:/rtems/task/if/visitor */ + +/** + * @ingroup RTEMSAPIClassicTasks * - * @retval RTEMS_SUCCESSFUL Successful operation. - * @retval RTEMS_INVALID_ID Invalid scheduler instance identifier. - * @retval RTEMS_NOT_CONFIGURED The processor is not configured to be used by - * the application. - * @retval RTEMS_INCORRECT_STATE The processor is configured to be used by - * the application, however, it is not online. - * @retval RTEMS_RESOURCE_IN_USE The processor is already assigned to a - * scheduler instance. + * @brief % */ -rtems_status_code rtems_scheduler_add_processor( - rtems_id scheduler_id, - uint32_t cpu_index -); +typedef bool( *rtems_task_visitor )( rtems_tcb *, void * ); + +/* Generated from spec:/rtems/task/if/iterate */ /** - * @brief Removes a processor from set of processors owned by the specified - * scheduler instance. + * @ingroup RTEMSAPIClassicTasks * - * Must be called from task context. This operation obtains and releases the - * objects allocator lock. Removing a processor from a scheduler is a complex - * operation that involves all tasks of the system. + * @brief % * - * @param[in] scheduler_id Identifier of the scheduler instance. - * @param[in] cpu_index Index of the processor to add. + * @param visitor % * - * @retval RTEMS_SUCCESSFUL Successful operation. - * @retval RTEMS_INVALID_ID Invalid scheduler instance identifier. - * @retval RTEMS_INVALID_NUMBER The processor is not owned by the specified - * scheduler instance. - * @retval RTEMS_RESOURCE_IN_USE The set of processors owned by the specified - * scheduler instance would be empty after the processor removal and there - * exists a non-idle task that uses this scheduler instance as its home - * scheduler instance. + * @param arg % */ -rtems_status_code rtems_scheduler_remove_processor( - rtems_id scheduler_id, - uint32_t cpu_index -); +void rtems_task_iterate( rtems_task_visitor visitor, void *arg ); + +/* Generated from spec:/rtems/task/if/wake-after */ /** - * @brief Gets the maximum task priority of the specified scheduler instance. + * @ingroup RTEMSAPIClassicTasks * - * @param[in] scheduler_id Identifier of the scheduler instance. - * @param[out] priority Pointer to a task priority value. + * @brief % * - * @retval RTEMS_SUCCESSFUL Successful operation. - * @retval RTEMS_INVALID_ADDRESS The @a priority parameter is @c NULL. - * @retval RTEMS_INVALID_ID Invalid scheduler instance identifier. + * @param ticks % */ -rtems_status_code rtems_scheduler_get_maximum_priority( - rtems_id scheduler_id, - rtems_task_priority *priority -); +rtems_status_code rtems_task_wake_after( rtems_interval ticks ); + +/* Generated from spec:/rtems/task/if/wake-when */ /** - * @brief Map a task priority to the corresponding POSIX thread priority. + * @ingroup RTEMSAPIClassicTasks * - * @param scheduler_id Identifier of the scheduler instance. - * @param priority The task priority to map. - * @param[out] posix_priority Pointer to a POSIX thread priority value. + * @brief % * - * @retval RTEMS_SUCCESSFUL Successful operation. - * @retval RTEMS_INVALID_ADDRESS The @a posix_priority parameter is @c NULL. - * @retval RTEMS_INVALID_ID Invalid scheduler instance identifier. - * @retval RTEMS_INVALID_PRIORITY Invalid task priority. + * @param time_buffer % */ -rtems_status_code rtems_scheduler_map_priority_to_posix( - rtems_id scheduler_id, - rtems_task_priority priority, - int *posix_priority -); +rtems_status_code rtems_task_wake_when( rtems_time_of_day *time_buffer ); + +/* Generated from spec:/rtems/task/if/yield-processor */ /** - * @brief Map a POSIX thread priority to the corresponding task priority. - * - * @param scheduler_id Identifier of the scheduler instance. - * @param posix_priority The POSIX thread priority to map. - * @param[out] priority Pointer to a task priority value. + * @ingroup RTEMSAPIClassicTasks * - * @retval RTEMS_SUCCESSFUL Successful operation. - * @retval RTEMS_INVALID_ADDRESS The @a priority parameter is @c NULL. - * @retval RTEMS_INVALID_ID Invalid scheduler instance identifier. - * @retval RTEMS_INVALID_PRIORITY Invalid POSIX thread priority. + * @brief % */ -rtems_status_code rtems_scheduler_map_priority_from_posix( - rtems_id scheduler_id, - int posix_priority, - rtems_task_priority *priority -); +#define RTEMS_YIELD_PROCESSOR WATCHDOG_NO_TIMEOUT + +/* Generated from spec:/score/if/maximum-priority */ + +/** + * @brief Returns the maximum priority of the scheduler with index zero. + */ +rtems_task_priority _RTEMS_Maximum_priority( void ); + +/* Generated from spec:/rtems/task/if/maximum-priority */ -/**@}*/ +/** + * @ingroup RTEMSAPIClassicTasks + * + * @brief % + */ +#define RTEMS_MAXIMUM_PRIORITY _RTEMS_Maximum_priority() #ifdef __cplusplus } #endif -#endif -/* end of include file */ +#endif /* _RTEMS_RTEMS_TASKS_H */ -- cgit v1.2.3