summaryrefslogtreecommitdiffstats
path: root/doc/user/concepts.t
diff options
context:
space:
mode:
authorGlenn Humphrey <glenn.humphrey@oarcorp.com>2007-10-25 19:46:41 +0000
committerGlenn Humphrey <glenn.humphrey@oarcorp.com>2007-10-25 19:46:41 +0000
commit4ffbc495141dedadf3d0a9b0748c4176fd0acde0 (patch)
treec9a339022218fd5985125755c62cfdceec3067de /doc/user/concepts.t
parentadded documentation to libi2c (diff)
downloadrtems-4ffbc495141dedadf3d0a9b0748c4176fd0acde0.tar.bz2
2007-10-25 Glenn Humphrey <glenn.humphrey@OARcorp.com>
* user/barrier.t, user/clock.t, user/concepts.t, user/cpuuse.t, user/init.t, user/intr.t, user/io.t, user/mp.t, user/rtmon.t, user/sem.t, user/stackchk.t, user/task.t, user/timer.t: Updated the Ada documentation to reflect the current binding.
Diffstat (limited to 'doc/user/concepts.t')
-rw-r--r--doc/user/concepts.t14
1 files changed, 11 insertions, 3 deletions
diff --git a/doc/user/concepts.t b/doc/user/concepts.t
index 5f26703a37..61a79f1191 100644
--- a/doc/user/concepts.t
+++ b/doc/user/concepts.t
@@ -1,5 +1,5 @@
@c
-@c COPYRIGHT (c) 1988-2002.
+@c COPYRIGHT (c) 1988-2007.
@c On-Line Applications Research Corporation (OAR).
@c All rights reserved.
@c
@@ -59,9 +59,9 @@ composed of four ASCII characters which help identify that object.
For example, a task which causes a light to blink might be
called "LITE". The @code{@value{DIRPREFIX}build_name} routine
is provided to build an object name from four ASCII characters.
-@ifset is-C
The following example illustrates this:
+@ifset is-C
@example
rtems_object_name my_name;
@@ -69,6 +69,14 @@ my_name = rtems_build_name( 'L', 'I', 'T', 'E' );
@end example
@end ifset
+@ifset is-Ada
+@example
+My_Name : RTEMS.Name;
+
+My_Name = RTEMS.Build_Name( 'L', 'I', 'T', 'E' );
+@end example
+@end ifset
+
However, it is not required that the application use ASCII
characters to build object names. For example, if an
application requires one-hundred tasks, it would be difficult to
@@ -76,13 +84,13 @@ assign meaningful ASCII names to each task. A more convenient
approach would be to name them the binary values one through
one-hundred, respectively.
+@ifset is-C
@findex rtems_get_object_name
RTEMS provides a helper routine, @code{@value{DIRPREFIX}get_object_name},
which can be used to obtain the name of any RTEMS object using just
its ID. This routine attempts to convert the name into a printable string.
-@ifset is-C
The following example illustrates the use of this method to print
an object name: