Changeset bd861cc6 in rtems for doc/user/sem.t


Ignore:
Timestamp:
Nov 9, 2009, 2:36:14 PM (11 years ago)
Author:
Joel Sherrill <joel.sherrill@…>
Branches:
4.10, 4.11, 5, master
Children:
2393825
Parents:
3ee8430b
Message:

2009-11-09 Joel Sherrill <joel.sherrill@…>

  • ada_user/Makefile.am, ada_user/ada_user.texi, user/Makefile.am, user/c_user.texi, user/concepts.t, user/overview.t, user/preface.texi, user/schedule.t, user/sem.t: Add table of figures. Add text and graphic of tree illustrating valid combinations of semaphore attributes.
  • user/semaphore_attributes.eps, user/semaphore_attributes.png: New files.
File:
1 edited

Legend:

Unmodified
Added
Removed
  • doc/user/sem.t

    r3ee8430b rbd861cc6  
    232232globally, then the attribute_set parameter would be
    233233@code{@value{RPREFIX}GLOBAL @value{OR} @value{RPREFIX}PRIORITY}.
     234
     235Some combinatinos of these attributes are invalid.  For example, priority
     236ordered blocking discipline must be applied to a binary semaphore in order
     237to use either the priority inheritance or priority ceiling functionality.
     238The following tree figure illustrates the valid combinations.
     239
     240@float Figure,fig:semaphore-attributes
     241@caption{Valid Semaphore Attributes Combinations}
     242
     243@ifset use-ascii
     244@example
     245@group
     246Not available in ASCII representation
     247@end group
     248@end example
     249@end ifset
     250
     251@ifset use-tex
     252@example
     253@image{semaphore_attributes,5in,3.5in}
     254@end example
     255@end ifset
     256
     257@ifset use-html
     258@html
     259<IMG SRC="semaphore_attributes.png" WIDTH=550 HEIGHT=400 ALT="Valid Semaphore Attribute Combinations">
     260@end html
     261@end ifset
     262@end float
    234263
    235264@subsection Building a SEMAPHORE_OBTAIN Option Set
     
    469498ceiling (default)
    470499
    471 @item @code{@value{RPREFIX}LOCAL} - local task (default)
    472 
    473 @item @code{@value{RPREFIX}GLOBAL} - global task
     500@item @code{@value{RPREFIX}LOCAL} - local semaphore (default)
     501
     502@item @code{@value{RPREFIX}GLOBAL} - global semaphore
    474503@end itemize
    475504
     
    481510insertion in the local copy of the global object table.
    482511
    483 The total number of global objects, including
    484 semaphores, is limited by the maximum_global_objects field in
    485 the Configuration Table.
     512Note that some combinations of attributes are not valid.  See the
     513earlier discussion on this.
     514
     515The total number of global objects, including semaphores, is limited by
     516the maximum_global_objects field in the Configuration Table.
    486517
    487518@c
Note: See TracChangeset for help on using the changeset viewer.