[PATCH v2] c-user: Add scheduler glossary terms

[Joel Sherrill]

On Tue, Apr 13, 2021 at 2:31 AM Sebastian Huber <
sebastian.huber at embedded-brains.de> wrote:

> Add glossary terms which characterize the relationship of a scheduler to
> a task.
> ---
>
> v2:
>
> Address review comments.  Use "foreign" instead of "alien".
>
>  c-user/glossary.rst | 24 ++++++++++++++++++++++++
>  1 file changed, 24 insertions(+)
>
> diff --git a/c-user/glossary.rst b/c-user/glossary.rst
> index 4e375de..0350033 100644
> --- a/c-user/glossary.rst
> +++ b/c-user/glossary.rst
> @@ -240,6 +240,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
> @@ -301,6 +305,10 @@ Glossary
>          mathematically intensive situations.  It is typically viewed as a
> logical
>          extension of the primary processor.
>
> +    foreign scheduler
> +        An foreign scheduler of a :term:`task` is a :term:`scheduler`
> which is not
> +        an :term:`eligible scheduler`.
> +
>

Can we come up with an adjective other than foreign. The scheduler did not
originate in a different way/place and is not fundamentally different. The
best I
have is "unassociated"

>      freed
>          A resource that has been released by the application to RTEMS.
>
> @@ -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,11 @@ 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 is either an :term:`eligible scheduler` or a
> +        :term:`foreign scheduler` for a task.  An :term:`eligible
> scheduler` is
> +        either the :term:`home scheduler` or a :term:`helping scheduler`
> for a
> +        task.
> +
>      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
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.rtems.org/pipermail/devel/attachments/20210413/3e886359/attachment.html>