<div dir="ltr">Hi,<div><br></div><div>Thanks for another review and your patience. I've sent in a patch with the suggested changes. Please let me know if it looks okay.</div><div><br></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Fri, Jun 19, 2020 at 4:46 PM Sebastian Huber <<a href="mailto:sebastian.huber@embedded-brains.de" target="_blank">sebastian.huber@embedded-brains.de</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">Hello Richi,<br>
<br>
thanks for the update, we are getting closer to the final version.<br>
<br>
On 19/06/2020 11:49, Richi Dubey wrote:<br>
> ---<br>
>   c-user/glossary.rst | 31 +++++++++++++++++++++++++++++++<br>
>   1 file changed, 31 insertions(+)<br>
><br>
> diff --git a/c-user/glossary.rst b/c-user/glossary.rst<br>
> index 86350a8..691ba52 100644<br>
> --- a/c-user/glossary.rst<br>
> +++ b/c-user/glossary.rst<br>
> @@ -1,5 +1,6 @@<br>
>   .. SPDX-License-Identifier: CC-BY-SA-4.0<br>
>   <br>
> +.. Copyright (C) 2020 Richi Dubey (<a href="mailto:richidubey@gmail.com" target="_blank">richidubey@gmail.com</a>)<br>
>   .. Copyright (C) 2017, 2019 embedded brains GmbH (<a href="http://www.embedded-brains.de" rel="noreferrer" target="_blank">http://www.embedded-brains.de</a>)<br>
>   .. Copyright (C) 1988, 1998 On-Line Applications Research Corporation (OAR)<br>
>   <br>
> @@ -16,6 +17,13 @@ Glossary<br>
>           A term used to describe an object which has been created by an<br>
>           application.<br>
>   <br>
> +    APA<br>
> +        This term is an acronym for Arbitrary Processor Affinity.<br>
> +        APA schedulers allow a thread to have an arbitrary affinity to<br>
> +        a processor set, rather than a restricted mapping to only one<br>
> +        processor of the set or the ability to run on all processors of<br>
> +        the set. It has two variants, :term:`Weak APA` and :term:`Strong APA`<br>
Looks good, except the missing dot to end the last sentence. Please try <br>
the vim "gq" to format the text.<br>
> +<br>
>       aperiodic task<br>
>           A task which must execute only at irregular intervals and has only a soft<br>
>           deadline.<br>
> @@ -777,6 +785,19 @@ Glossary<br>
>           :term:`return value` to indicate a successful operation or error<br>
>           conditions.<br>
>   <br>
> +    Strong APA<br>
> +        Strong APA is a specialization of :term:`APA`.<br>
> +        Whenever a :term:`thread` becomes ready for execution, schedulers which<br>
> +        implement strong APA recursively search for a processor in the thread's<br>
> +        affinity set, followed by the processors in the affinity set of threads<br>
> +        that are assigned the processor present in the ready thread's affinity set.<br>
> +        This is done to find a thread to processor mapping that does not violate the<br>
> +        priority ordering and to provide a schedule with a higher total priority of<br>
Sorry for being pedantic, but please keep in mind that RTEMS users <br>
interested in this stuff may not have read many scheduler papers. They <br>
may ask what "a schedule" is.<br>
> +        the threads scheduled.<br>
> +        Similar analysis is done when a thread finishes its execution.<br>
"finishes its execution" -> "blocks".<br>
> +<br>
> +        See also :cite:`Cerqueira:2014:LPA`.<br>
> +<br>
>       suspend<br>
>           A term used to describe a task that is not competing for the CPU because it<br>
>           has had a ``rtems_task_suspend`` directive.<br>
> @@ -905,6 +926,16 @@ Glossary<br>
>           Message queues, regions, and semaphores have a wait queue associated with<br>
>           them.<br>
>   <br>
> +    Weak APA<br>
> +        Weak APA is a specialization of :term:`APA`. This refers to Linux's push and<br>
> +        pull implementation of APA model. On the arrival of a thread,<br>
Please avoid this "arrival", use a phrase like "Whenever a <br>
:term:`thread` becomes ready for execution" like above.<br>
> the thread is<br>
> +        scheduled when a processor in its affinity set is idle or a processor in its<br>
> +        affinity set is executing a thread which is at a lower priority.<br>
> +        Unlike :term:`Strong APA`, no thread is migrated from its processor to find<br>
> +        a thread to processor mapping.<br>
> +<br>
> +        See also :cite:`Cerqueira:2014:LPA`.<br>
> +<br>
>       YAML<br>
>           This term is an acronym for `YAML Ain't Markup Language <<a href="https://yaml.org/" rel="noreferrer" target="_blank">https://yaml.org/</a>>`_.<br>
>   <br>
</blockquote></div></div>