source: rtems/doc/user/Makefile.am @ 8fcafdd5

4.115
Last change on this file since 8fcafdd5 was 8fcafdd5, checked in by Sebastian Huber <sebastian.huber@…>, on 05/21/14 at 08:33:43

score: Multiprocessor Resource Sharing Protocol

Add basic support for the Multiprocessor Resource Sharing Protocol
(MrsP).

The Multiprocessor Resource Sharing Protocol (MrsP) is defined in A.
Burns and A.J. Wellings, A Schedulability Compatible Multiprocessor
Resource Sharing Protocol - MrsP, Proceedings of the 25th Euromicro
Conference on Real-Time Systems (ECRTS 2013), July 2013. It is a
generalization of the Priority Ceiling Protocol to SMP systems. Each
MrsP semaphore uses a ceiling priority per scheduler instance. These
ceiling priorities can be specified with rtems_semaphore_set_priority().
A task obtaining or owning a MrsP semaphore will execute with the
ceiling priority for its scheduler instance as specified by the MrsP
semaphore object. Tasks waiting to get ownership of a MrsP semaphore
will not relinquish the processor voluntarily. In case the owner of a
MrsP semaphore gets preempted it can ask all tasks waiting for this
semaphore to help out and temporarily borrow the right to execute on one
of their assigned processors.

The help out feature is not implemented with this patch.
  • Property mode set to 100644
File size: 6.5 KB
Line 
1#
2#  COPYRIGHT (c) 1988-2011
3#  On-Line Applications Research Corporation (OAR).
4#  All rights reserved.
5
6PROJECT = c_user
7
8include $(top_srcdir)/project.am
9include $(top_srcdir)/main.am
10
11FILES = bsp.texi example.texi glossary.texi preface.texi
12
13GENERATED_FILES = overview.texi concepts.texi datatypes.texi init.texi \
14    task.texi intr.texi clock.texi timer.texi sem.texi msg.texi event.texi \
15    signal.texi part.texi region.texi dpmem.texi io.texi fatal.texi \
16    schedule.texi rtmon.texi barrier.texi bsp.texi userext.texi conf.texi \
17    mp.texi stackchk.texi cpuuse.texi object.texi chains.texi timespec.texi \
18    cbs.texi dirstat.texi smp.texi
19
20COMMON_FILES += $(top_srcdir)/common/cpright.texi
21
22info_TEXINFOS = c_user.texi
23c_user_TEXINFOS = $(FILES) $(COMMON_FILES) $(GENERATED_FILES)
24
25TXT_FILES = rtemsarc.txt rtemspie.txt states.txt
26
27PNG_FILES = rtemsarc.png rtemspie.png states.png ObjectId-32Bits.png \
28    ObjectId-16Bits.png semaphore_attributes.png
29
30EPS_IMAGES = rtemspie.eps states.eps ObjectId-32Bits.eps \
31    ObjectId-32Bits.eps semaphore_attributes.eps
32$(PROJECT).dvi: $(EPS_IMAGES)
33
34PDF_IMAGES = rtemspie.pdf states.pdf ObjectId-16Bits.pdf \
35    ObjectId-32Bits.pdf semaphore_attributes.pdf
36CLEANFILES += $(PDF_IMAGES)
37
38if USE_HTML
39html_project_DATA += $(PNG_FILES)
40endif
41
42overview.texi: overview.t
43        $(BMENU2) -p "Preface" \
44            -u "Top" \
45            -n "Key Concepts" < $< > $@
46
47concepts.texi: concepts.t
48        $(BMENU2) -p "Overview Manual Organization" \
49            -u "Top" \
50            -n "RTEMS Data Types" < $< > $@
51
52datatypes.texi: datatypes.t
53        $(BMENU2) -p "Key Concepts Memory Management" \
54            -u "Top" \
55            -n "Scheduling Concepts" < $< > $@
56
57schedule.texi: schedule.t
58        $(BMENU2) -p "RTEMS Data Types List of Data Types" \
59            -u "Top" \
60            -n "Initialization Manager" < $< > $@
61
62init.texi: init.t
63        $(BMENU2) -p "Scheduling Concepts Task State Transitions" \
64            -u "Top" \
65            -n "Task Manager" < $< > $@
66
67task.texi: task.t
68        $(BMENU2) -p "Initialization Manager SHUTDOWN_EXECUTIVE - Shutdown RTEMS" \
69            -u "Top" \
70            -n "Interrupt Manager" < $< > $@
71
72intr.texi: intr.t
73        $(BMENU2) -p "Task Manager TASK_VARIABLE_DELETE - Remove per task variable" \
74            -u "Top" \
75            -n "Clock Manager" < $< > $@
76
77clock.texi: clock.t
78        $(BMENU2) \
79         -p "Interrupt Manager INTERRUPT_IS_IN_PROGRESS - Is an ISR in Progress" \
80            -u "Top" \
81            -n "Timer Manager" < $< > $@
82
83timer.texi: timer.t
84        $(BMENU2) -p "Clock Manager CLOCK_TICK - Announce a clock tick" \
85            -u "Top" \
86            -n "Rate Monotonic Manager" < $< > $@
87
88rtmon.texi: rtmon.t
89        $(BMENU2) -p "Timer Manager TIMER_RESET - Reset an interval timer" \
90            -u "Top" \
91            -n "Semaphore Manager" < $< > $@
92
93sem.texi: sem.t
94        $(BMENU2) -p "Rate Monotonic Manager RATE_MONOTONIC_REPORT_STATISTICS - Print period statistics report" \
95            -u "Top" \
96            -n "Barrier Manager" < $< > $@
97
98barrier.texi: barrier.t
99        $(BMENU2) -p "Semaphore Manager SEMAPHORE_SET_PRIORITY - Set priority by scheduler for a semaphore" \
100            -u "Top" \
101            -n "Message Manager" < $< > $@
102
103msg.texi: msg.t
104        $(BMENU2) -p "Barrier Manager BARRIER_RELEASE - Release a barrier" \
105            -u "Top" \
106            -n "Event Manager" < $< > $@
107
108event.texi: event.t
109        $(BMENU2) \
110        -p "Message Manager MESSAGE_QUEUE_FLUSH - Flush all messages on a queue" \
111            -u "Top" \
112            -n "Signal Manager" < $< > $@
113
114signal.texi: signal.t
115        $(BMENU2) -p "Event Manager EVENT_RECEIVE - Receive event condition" \
116            -u "Top" \
117            -n "Partition Manager" < $< > $@
118
119part.texi: part.t
120        $(BMENU2) -p "Signal Manager SIGNAL_SEND - Send signal set to a task" \
121            -u "Top" \
122            -n "Region Manager" < $< > $@
123
124region.texi: region.t
125        $(BMENU2) \
126-p "Partition Manager PARTITION_RETURN_BUFFER - Return buffer to a partition" \
127            -u "Top" \
128            -n "Dual-Ported Memory Manager" < $< > $@
129
130dpmem.texi: dpmem.t
131        $(BMENU2) \
132          -p "Region Manager REGION_RESIZE_SEGMENT - Change size of a segment" \
133            -u "Top" \
134            -n "I/O Manager" < $< > $@
135
136io.texi: io.t
137        $(BMENU2) -p "Dual-Ported Memory Manager PORT_INTERNAL_TO_EXTERNAL - Convert internal to external address" \
138            -u "Top" \
139            -n "Fatal Error Manager" < $< > $@
140
141fatal.texi: fatal.t
142        $(BMENU2) -p "I/O Manager IO_CONTROL - Special device services" \
143            -u "Top" \
144            -n "Board Support Packages" < $< > $@
145
146bsp.texi: bsp.t
147        $(BMENU2) -p "Fatal Error Manager INTERNAL_ERROR_TEXT - Returns a text for an internal error code" \
148            -u "Top" \
149            -n "User Extensions Manager" < $< > $@
150
151userext.texi: userext.t
152        $(BMENU2) -p "Board Support Packages Heterogeneous Systems" \
153            -u "Top" \
154            -n "Configuring a System" < $< > $@
155
156conf.texi: conf.t
157        $(BMENU2) -p "User Extensions Manager EXTENSION_DELETE - Delete a extension set" \
158            -u "Top" \
159            -n "Multiprocessing Manager" < $< > $@
160
161mp.texi: mp.t
162        $(BMENU2) -p "Configuring a System Configuration Data Structures" \
163            -u "Top" \
164            -n "Symmetric Multiprocessing Services" < $< > $@
165
166smp.texi: smp.t
167        $(BMENU2) -p  "Multiprocessing Manager MULTIPROCESSING_ANNOUNCE - Announce the arrival of a packet"\
168            -u "Top" \
169            -n "Stack Bounds Checker" < $< > $@
170
171stackchk.texi: stackchk.t
172        $(BMENU2) -p "Symmetric Multiprocessing Services TASK_SET_AFFINITY - Set task processor affinity" \
173            -u "Top" \
174            -n "CPU Usage Statistics" < $< > $@
175
176cpuuse.texi: cpuuse.t
177        $(BMENU2) -p "Stack Bounds Checker STACK_CHECKER_REPORT_USAGE - Report Task Stack Usage" \
178            -u "Top" \
179            -n "Object Services" < $< > $@
180
181object.texi: object.t
182        $(BMENU2) -p "CPU Usage Statistics cpu_usage_reset - Reset CPU Usage Statistics" \
183            -u "Top" \
184            -n "Chains" < $< > $@
185
186chains.texi: chains.t
187        $(BMENU2) -p "Object Services OBJECT_GET_CLASS_INFORMATION - Obtain Class Information" \
188            -u "Top" \
189            -n "Timespec Helpers" < $< > $@
190
191timespec.texi: timespec.t
192        $(BMENU2) -p "Chains Prepend a Node" \
193            -u "Top" \
194            -n "Constant Bandwidth Server Scheduler API" < $< > $@
195
196cbs.texi: cbs.t
197        $(BMENU2) -p "Timespec Helpers TIMESPEC_FROM_TICKS - Convert Ticks to struct timespec Representation" \
198            -u "Top" \
199            -n "Directive Status Codes" < $< > $@
200
201dirstat.texi: dirstat.t
202        $(BMENU2) -p "Constant Bandwidth Server Scheduler API CBS_GET_APPROVED_BUDGET - Get scheduler approved execution time" \
203            -u "Top" \
204            -n "Example Application" < $< > $@
205
206EXTRA_DIST = bsp.t cbs.t clock.t chains.t concepts.t cpuuse.t datatypes.t conf.t \
207    dpmem.t event.t fatal.t init.t intr.t io.t mp.t msg.t overview.t \
208    part.t region.t rtmon.t sem.t schedule.t signal.t stackchk.t \
209    task.t timer.t userext.t dirstat.t $(TXT_FILES) $(PNG_FILES) $(EPS_IMAGES) \
210    $(noinst_DATA)
211
212CLEANFILES += c_user.info c_user.info-? c_user.info-??
Note: See TracBrowser for help on using the repository browser.