forked from Imagelibrary/rtems
The following scheduler operations return a thread in need for help
- unblock,
- change priority, and
- yield.
A thread in need for help is a thread that encounters a scheduler state
change from scheduled to ready or a thread that cannot be scheduled in
an unblock operation. Such a thread can ask threads which depend on
resources owned by this thread for help.
Add a new ask for help scheduler operation. This operation is used by
_Scheduler_Ask_for_help() to help threads in need for help returned by
the operations mentioned above. This operation is also used by
_Scheduler_Thread_change_resource_root() in case the root of a resource
sub-tree changes. A use case is the ownership change of a resource.
In case it is not possible to schedule a thread in need for help, then
the corresponding scheduler node will be placed into the set of ready
scheduler nodes of the scheduler instance. Once a state change from
ready to scheduled happens for this scheduler node it may be used to
schedule the thread in need for help.
Tools Required ============== The following tools are used in the production of this documentation: TeX texi2html 1.82 texinfo-tex 4.13a texi2html will be deprecated in the upcomine texinfo release. At that point, we will need to provide support for texi2any.pl as an alternative means to produce html output. This was used by the authors to generate the directory tree figure in the texinfo printed version: tree (from the CTAN Archives -- see http://jasper.ora.com/ctan.html) Changing the Version Number and Timestamp ========================================= RTEMS Version number is in configure.in. Edit that file and run bootstrap. Documentation date is in common/setup.texi.in and also must be modified by hand. bootstrap does not have to be run after modifying this file. Making the Documentation ======================== cd rtems-XXX/doc ../bootstrap ./configure --enable-maintainer-mode make all make install Cleaning ======== make clean make distclean make maintainer-clean Making a Source Distribution ============================ This generates a rtems-<version>.tar.gz in the toplevel directory. Making a Preformatted Distribution ================================== Install and tar it up. :)