mirror of
https://gitlab.rtems.org/rtems/rtos/rtems.git
synced 2025-12-20 03:05:47 +08:00
final corrections before 4.1.0 documentation freeze.
This commit is contained in:
@@ -1,3 +1,3 @@
|
||||
<HR>
|
||||
<P>Back to the <A HREF="../rtems.html">RTEMS On-Line Library</A>.</P>
|
||||
<P>Back to the <A HREF="../rtems.html">RTEMS 4.1.0 On-Line Library</A>.</P>
|
||||
<P>Copyright © 1997 <A HREF="http://www.oarcorp.com" target="Text Frame">OAR Corporation</A>
|
||||
|
||||
@@ -2,5 +2,5 @@
|
||||
<A HREF="http://www.oarcorp.com" target="Text Frame">
|
||||
<IMG align=right BORDER=0 SRC="../oaronly.jpg" ALT="OAR"> </A>
|
||||
<FONT SIZE=-1>
|
||||
<H1>RTEMS On-Line Library</H1>
|
||||
<H1>RTEMS 4.1.0 On-Line Library</H1>
|
||||
<HR>
|
||||
|
||||
@@ -67,7 +67,7 @@ specified by the user in the Configuration Table.
|
||||
|
||||
The clock facilities of the clock manager operate
|
||||
upon calendar time. These directives utilize the following date
|
||||
and time structure for the native time and date format:
|
||||
and time @value{STRUCTURE} for the native time and date format:
|
||||
|
||||
@ifset is-C
|
||||
@example
|
||||
@@ -106,7 +106,7 @@ supported when setting the system date and time using the
|
||||
clock_get directive. Some applications expect to operate on a
|
||||
"UNIX-style" date and time data structure. The clock_get
|
||||
directive can optionally return the current date and time in the
|
||||
following structure:
|
||||
following @value{STRUCTURE}:
|
||||
|
||||
@ifset is-C
|
||||
@example
|
||||
@@ -129,7 +129,7 @@ type Clock_Time_Value is
|
||||
@end example
|
||||
@end ifset
|
||||
|
||||
The seconds field in this structure is the number of
|
||||
The seconds field in this @value{STRUCTURE} is the number of
|
||||
seconds since the RTEMS epoch of January 1, 1988.
|
||||
|
||||
@ifinfo
|
||||
@@ -306,7 +306,7 @@ procedure Clock_Set (
|
||||
@subheading DESCRIPTION:
|
||||
|
||||
This directive sets the system date and time. The
|
||||
date, time, and ticks in the time_buffer structure are all
|
||||
date, time, and ticks in the time_buffer @value{STRUCTURE} are all
|
||||
range-checked, and an error is returned if any one is out of its
|
||||
valid range.
|
||||
|
||||
|
||||
@@ -333,7 +333,7 @@ initialization threads must be configured.
|
||||
is the address of the Initialization Threads Table. This table contains the
|
||||
information needed to create and start each of the initialization threads.
|
||||
The format of each entry in this table is defined in the
|
||||
posix_initialization_threads_table structure.
|
||||
posix_initialization_threads_table @value{STRUCTURE}.
|
||||
|
||||
@end table
|
||||
|
||||
@@ -363,8 +363,8 @@ data structure directly correspond to arguments to the
|
||||
task_create and task_start directives. The number of entries is
|
||||
found in the number_of_initialization_tasks entry in the
|
||||
Configuration Table. The format of each entry in the
|
||||
Initialization Task Table is defined in the following C
|
||||
structure:
|
||||
Initialization Task Table is defined in the following @value{LANGUAGE}
|
||||
@value{STRUCTURE}:
|
||||
|
||||
@ifset is-C
|
||||
@example
|
||||
@@ -581,8 +581,8 @@ contains one entry for each possible extension. The entries are
|
||||
called at critical times in the life of the system and
|
||||
individual tasks. The application may create dynamic extensions
|
||||
in addition to this single static set. The format of each entry
|
||||
in the User Extensions Table is defined in the following C
|
||||
structure:
|
||||
in the User Extensions Table is defined in the following @value{LANGUAGE}
|
||||
@value{STRUCTURE}:
|
||||
|
||||
typedef User_extensions_routine rtems_extension;
|
||||
typedef User_extensions_thread_create_extension rtems_task_create_extension;
|
||||
|
||||
@@ -90,7 +90,7 @@ The fatal_error_occurred directive is invoked when a
|
||||
fatal error is detected. Before invoking any user-supplied
|
||||
fatal error handlers or the RTEMS fatal error handler, the
|
||||
fatal_error_occurred directive stores useful information in the
|
||||
variable @code{_Internal_errors_What_happened}. This structure
|
||||
variable @code{_Internal_errors_What_happened}. This @value{STRUCTURE}
|
||||
contains three pieces of information:
|
||||
|
||||
@itemize @bullet
|
||||
|
||||
@@ -211,8 +211,7 @@ the memory.
|
||||
An acronym for First In First Out.
|
||||
|
||||
@item First In First Out
|
||||
A discipline for manipulating
|
||||
entries in a data structure.
|
||||
A discipline for manipulating entries in a data structure.
|
||||
|
||||
@item floating point coprocessor
|
||||
A component used in
|
||||
@@ -247,12 +246,10 @@ A data structure used to dynamically allocate
|
||||
and deallocate variable sized blocks of memory.
|
||||
|
||||
@item heterogeneous
|
||||
A multiprocessor computer system
|
||||
composed of dissimilar processors.
|
||||
A multiprocessor computer system composed of dissimilar processors.
|
||||
|
||||
@item homogeneous
|
||||
A multiprocessor computer system
|
||||
composed of a single type of processor.
|
||||
A multiprocessor computer system composed of a single type of processor.
|
||||
|
||||
@item ID
|
||||
An RTEMS assigned identification tag used to
|
||||
@@ -350,9 +347,8 @@ and communicate between tasks by transporting messages between
|
||||
sending and receiving tasks.
|
||||
|
||||
@item Message Queue Control Block
|
||||
A data structure
|
||||
associated with each message queue used by RTEMS to manage that
|
||||
message queue.
|
||||
A data structure associated with each message queue used by RTEMS
|
||||
to manage that message queue.
|
||||
|
||||
@item minor number
|
||||
A numeric value passed to a device
|
||||
@@ -382,8 +378,7 @@ of user-provided routines which enable the nodes in a
|
||||
multiprocessor system to communicate with one another.
|
||||
|
||||
@item Multiprocessor Configuration Table
|
||||
The data
|
||||
structure defining the characteristics of the multiprocessor
|
||||
The data structure defining the characteristics of the multiprocessor
|
||||
target system with which RTEMS will communicate.
|
||||
|
||||
@item multitasking
|
||||
|
||||
@@ -33,6 +33,10 @@ directive:
|
||||
|
||||
@itemize @bullet
|
||||
@item @code{interrupt_catch} - Establish an ISR
|
||||
@item @code{interrupt_disable} - Disable Interrupts
|
||||
@item @code{interrupt_enable} - Enable Interrupts
|
||||
@item @code{interrupt_flash} - Flash Interrupt
|
||||
@item @code{interrupt_is_in_progress} - Is an ISR in Progress
|
||||
@end itemize
|
||||
|
||||
@ifinfo
|
||||
@@ -315,9 +319,9 @@ procedure Interrupt_Catch (
|
||||
|
||||
This directive establishes an interrupt service
|
||||
routine (ISR) for the specified interrupt vector number. The
|
||||
new_isr_handler parameter specifies the entry point of the ISR.
|
||||
@code{new_isr_handler} parameter specifies the entry point of the ISR.
|
||||
The entry point of the previous ISR for the specified vector is
|
||||
returned in old_isr_handler.
|
||||
returned in @code{old_isr_handler}.
|
||||
|
||||
@subheading NOTES:
|
||||
|
||||
|
||||
@@ -437,7 +437,7 @@ names are printed in bold type.
|
||||
@item Items in bold capital letters are constants defined by
|
||||
RTEMS. Each language interface provided by RTEMS includes a
|
||||
file containing the standard set of constants, data types, and
|
||||
structure definitions which can be incorporated into the user
|
||||
@value{STRUCTURE} definitions which can be incorporated into the user
|
||||
application.
|
||||
|
||||
@item A number of type definitions are provided by RTEMS and
|
||||
|
||||
@@ -1194,7 +1194,7 @@ procedure Rate_Monotonic_Get_Status (
|
||||
@subheading DESCRIPTION:
|
||||
|
||||
This directive returns status information associated with
|
||||
the rate monotonic period id in the following data structure:
|
||||
the rate monotonic period id in the following data @value{STRUCTURE}:
|
||||
|
||||
@ifset is-C
|
||||
@example
|
||||
|
||||
@@ -1483,5 +1483,5 @@ in time_buffer. At the requested date and time, the calling
|
||||
task will be unblocked and made ready to execute.
|
||||
|
||||
@subheading NOTES:
|
||||
The ticks portion of time_buffer structure is ignored. The
|
||||
The ticks portion of time_buffer @value{STRUCTURE} is ignored. The
|
||||
timing granularity of this directive is a second.
|
||||
|
||||
@@ -85,7 +85,7 @@ user extension routines are invoked. Together a set of these
|
||||
routines typically perform a specific functionality such as
|
||||
performance monitoring or debugger support. RTEMS is informed of
|
||||
the entry points which constitute an extension set via the
|
||||
following structure:
|
||||
following @value{STRUCTURE}:
|
||||
|
||||
@ifset is-C
|
||||
@example
|
||||
|
||||
Reference in New Issue
Block a user