[PATCH] Added APA terms

[Richi Dubey]

Hi,

Thanks a lot for your quick review and a detailed explanation of all my
mistakes. I have sent in the new patch. Please let me know if it looks okay.

Thanks!

On Mon, Jun 15, 2020 at 9:26 PM Sebastian Huber <
sebastian.huber at embedded-brains.de> wrote:

> On 15/06/2020 16:38, Richi Dubey wrote:
>
> > ---
> >   c-user/glossary.rst | 13 ++++++++++++-
> >   1 file changed, 12 insertions(+), 1 deletion(-)
> >
> > diff --git a/c-user/glossary.rst b/c-user/glossary.rst
> > index 86350a8..589d41b 100644
> > --- a/c-user/glossary.rst
> > +++ b/c-user/glossary.rst
> > @@ -1,6 +1,6 @@
> >   .. SPDX-License-Identifier: CC-BY-SA-4.0
> >
> > -.. Copyright (C) 2017, 2019 embedded brains GmbH (
> http://www.embedded-brains.de)
> > +.. Copyright (C) 2017, 2020 embedded brains GmbH (
> http://www.embedded-brains.de)
> The stuff should probably have your copyright.
> >   .. Copyright (C) 1988, 1998 On-Line Applications Research Corporation
> (OAR)
> >
> >   Glossary
> > @@ -16,6 +16,10 @@ Glossary
> >           A term used to describe an object which has been created by an
> >           application.
> >
> > +    APA
> > +        Arbitrary Processor Affinity.
> > +        In this model, a thread is allowed to have an arbitrary
> affinity to the processor set, rather than a global mapping from one thread
> to all processors or one thread to one processor. It has two variants,
> :term:`Weak APA` and :term:`Strong APA`
>
> Please fix the line width (max. 79 chars). Please have a look at the
> phrase for acronyms:
>
>
> https://docs.rtems.org/branches/master/eng/req/howto.html#glossary-specification
>
> > +
> >       aperiodic task
> >           A task which must execute only at irregular intervals and has
> only a soft
> >           deadline.
> > @@ -777,6 +781,9 @@ Glossary
> >           :term:`return value` to indicate a successful operation or
> error
> >           conditions.
> >
> > +    Strong APA
> > +        Strong APA is a specialization of :term:`APA`. In this model,
> on the arrival of a :term:`thread`, every thread reachable from the newly
> arrived thread is checked to see if an existing thread can be shifted (or
> deallocated its processor)
> It is a "model" of what? What means "arrival", "reachable from", and
> "shifted"?
> >   and the newly arrived thread take its place if the newly arrived
> thread has a higher priority. Similar analysis is done when a thread
> finishes its execution (Here, the terms task and thread have
> interchangeable definitions).
> Task/thread statement is superfluous.
> > :cite:`Cerqueira:2014:LPA`
> Please make sure that your text is built from complete sentences.
> > +
> >       suspend
> >           A term used to describe a task that is not competing for the
> CPU because it
> >           has had a ``rtems_task_suspend`` directive.
> > @@ -905,6 +912,10 @@ Glossary
> >           Message queues, regions, and semaphores have a wait queue
> associated with
> >           them.
> >
> > +    Weak APA
> > +        Weak APA is a specialization of :term:`APA`. This refers to
> Linux's pull push implementation of APA model. On the arrival of a thread,
> the thread is scheduled when a processor in its affinity set is idle or a
> processor is executing a thread which is at a lower priority.
> > +        :cite:`Cerqueira:2014:LPA`
> > +
> >       YAML
> >           This term is an acronym for `YAML Ain't Markup Language <
> https://yaml.org/>`_.
> >
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.rtems.org/pipermail/devel/attachments/20200617/a15e7960/attachment.html>