[PATCH] c-user: Add scheduler glossary terms

[Gedare Bloom]

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
>          application.
>
> +    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.

>      APA
>          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.
> +
>      embedded
>          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.
> +
>      heterogeneous
>          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`.
> +
>      homogeneous
>          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.
s/and/or   ?
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
> --
> 2.26.2
>
> _______________________________________________
> devel mailing list
> devel at rtems.org
> http://lists.rtems.org/mailman/listinfo/devel