[PATCH] c-user: Add scheduler glossary terms
gedare at rtems.org
Mon Apr 12 15:00:09 UTC 2021
On Mon, Apr 12, 2021 at 3:30 AM Sebastian Huber
<sebastian.huber at embedded-brains.de> wrote:
> Add glossary terms which characterize the relationship of a scheduler to
> a task.
> c-user/glossary.rst | 22 ++++++++++++++++++++++
> 1 file changed, 22 insertions(+)
> diff --git a/c-user/glossary.rst b/c-user/glossary.rst
> index 4e375de..fe9ad4a 100644
> --- a/c-user/glossary.rst
> +++ b/c-user/glossary.rst
> @@ -17,6 +17,10 @@ Glossary
> A term used to describe an object which has been created by an
> + alien scheduler
> + An alien scheduler of a :term:`task` is a :term:`scheduler` which is not an
> + :term:`eligible scheduler`.
Why not ineligible?
or "Foreign" may be better. I have never seen this "alien" term in
technical use like this before.
> This term is an acronym for Arbitrary Processor Affinity. APA schedulers
> allow a thread to have an arbitrary affinity to a processor set, rather than
> @@ -240,6 +244,10 @@ Glossary
> This term is an acronym for
> `Executable and Linkable Format <https://en.wikipedia.org/wiki/Executable_and_Linkable_Format>`_.
> + eligible scheduler
> + An eligible scheduler of a :term:`task` is a :term:`scheduler` which can be
> + used by the task to allocate a processor for the task.
> An application that is delivered as a hidden part of a larger system.
> For example, the software in a fuel-injection control system is an
> @@ -340,9 +348,20 @@ Glossary
> dispatch is marked as necessary, then the next thread dispatch will make
> the heir task the executing task.
> + helping scheduler
> + A helping scheduler of a :term:`task` is a :term:`scheduler` which is a
> + :term:`eligible scheduler` and which is not the :term:`home scheduler` of
> + the task.
> A multiprocessor computer system composed of dissimilar processors.
> + home scheduler
> + The home scheduler of a :term:`task` is a :term:`scheduler` which is a
> + :term:`eligible scheduler` and which is assigned to the task during the
> + initialization or explicitly via a directive call such as
> + :c:func:`rtems_task_set_scheduler`.
> A multiprocessor computer system composed of a single type of processor.
> @@ -728,6 +747,9 @@ Glossary
> priority number and assign the tasks with the lowest priority number to
> one processor of the set of processors owned by a scheduler instance.
> + A scheduler can be a :term:`home scheduler`, a :term:`helping scheduler`,
> + an :term:`eligible scheduler`, and an :term:`alien scheduler` for a task.
A scheduler cannot possibly be all 4 of these, it can be at most 2 of these?
> scheduler instance
> A scheduler instance is a scheduling algorithm with a corresponding
> context to store its internal state. Each processor in the system is
> devel mailing list
> devel at rtems.org
More information about the devel