summaryrefslogtreecommitdiffstats
path: root/doc/new_chapters
diff options
context:
space:
mode:
authorJoel Sherrill <joel.sherrill@OARcorp.com>2006-09-13 16:21:09 +0000
committerJoel Sherrill <joel.sherrill@OARcorp.com>2006-09-13 16:21:09 +0000
commitaba8a85d4bd98a84d8e2b1e94bfb77fdd0b8a57e (patch)
tree425aca7cb19535d60a41a9c7ed2afd15f1ebb6ac /doc/new_chapters
parentNew. (diff)
downloadrtems-aba8a85d4bd98a84d8e2b1e94bfb77fdd0b8a57e.tar.bz2
2006-09-13 Joel Sherrill <joel@OARcorp.com>
* new_chapters/Makefile.am, user/Makefile.am, user/c_user.texi, user/dirstat.texi, user/task.t: Move stack to first class citizen status. Include it in User Manual and rename to start with rtems_. * user/stackchk.t: New file. * new_chapters/stackchk.t: Removed.
Diffstat (limited to '')
-rw-r--r--doc/new_chapters/Makefile.am11
-rw-r--r--doc/user/stackchk.t (renamed from doc/new_chapters/stackchk.t)18
2 files changed, 11 insertions, 18 deletions
diff --git a/doc/new_chapters/Makefile.am b/doc/new_chapters/Makefile.am
index 03bc2a8083..017bbd6d93 100644
--- a/doc/new_chapters/Makefile.am
+++ b/doc/new_chapters/Makefile.am
@@ -13,8 +13,7 @@ include $(top_srcdir)/project.am
include $(top_srcdir)/main.am
GENERATED_FILES = \
- stackchk.texi rtmonuse.texi cpuuse.texi error.texi \
- monitor.texi
+ rtmonuse.texi cpuuse.texi error.texi monitor.texi
COMMON_FILES += $(top_srcdir)/common/cpright.texi
@@ -23,11 +22,6 @@ FILES =
info_TEXINFOS = new_chapters.texi
new_chapters_TEXINFOS = $(FILES) $(COMMON_FILES) $(GENERATED_FILES)
-stackchk.texi: stackchk.t
- $(BMENU2) -p "" \
- -u "Top" \
- -n "" < $< > $@
-
rtmonuse.texi: rtmonuse.t
$(BMENU2) -p "" \
-u "Top" \
@@ -50,8 +44,7 @@ monitor.texi: monitor.t
noinst_SCRIPTS = gen_section
-EXTRA_DIST = cpuuse.t error.t \
- monitor.t rtmonuse.t stackchk.t STATUS TODO \
+EXTRA_DIST = cpuuse.t error.t monitor.t rtmonuse.t STATUS TODO \
$(noinst_SCRIPTS)
CLEANFILES += new_chapters.info new_chapters.info-?
diff --git a/doc/new_chapters/stackchk.t b/doc/user/stackchk.t
index 1994ea5d49..00cde1b386 100644
--- a/doc/new_chapters/stackchk.t
+++ b/doc/user/stackchk.t
@@ -1,5 +1,5 @@
@c
-@c COPYRIGHT (c) 1988-2002.
+@c COPYRIGHT (c) 1988-2006.
@c On-Line Applications Research Corporation (OAR).
@c All rights reserved.
@c
@@ -15,8 +15,8 @@ if a task has overflowed its run-time stack. The routines provided
by the stack bounds checker manager are:
@itemize @bullet
-@item @code{Stack_check_Initialize} - Initialize the Stack Bounds Checker
-@item @code{Stack_check_Dump_usage} - Report Task Stack Usage
+@item @code{@value{DIRPREFIX}stack_checker_initialize} - Initialize the Stack Bounds Checker
+@item @code{@value{DIRPREFIX}stack_checker_dump_usage} - Report Task Stack Usage
@end itemize
@section Background
@@ -68,7 +68,7 @@ provided by every RTEMS port to get for this information.
The stack checker is initialized automatically when its task
create extension runs for the first time. When this occurs,
-the @code{Stack_check_Initialize} is invoked.
+the @code{@value{DIRPREFIX}stack_checker_initialize} is invoked.
The application must include the stack bounds checker extension set
in its set of Initial Extensions. This set of extensions is
@@ -88,7 +88,7 @@ to define the macro @code{STACK_CHECKER_ON} before including
@subsection Reporting Task Stack Usage
The application may dynamically report the stack usage for every task
-in the system by calling the @code{Stack_check_Dump_usage} routine.
+in the system by calling the @code{@value{DIRPREFIX}stack_checker_dump_usage} routine.
This routine prints a table with the peak usage and stack size of
every task in the system. The following is an example of the
report generated:
@@ -136,13 +136,13 @@ and describes the calling sequence, related constants, usage,
and status codes.
@page
-@subsection Stack_check_Initialize - Initialize the Stack Bounds Checker
+@subsection stack_checker_initialize - Initialize the Stack Bounds Checker
@subheading CALLING SEQUENCE:
@ifset is-C
@example
-void Stack_check_Initialize( void );
+void rtems_stack_checker_initialize( void );
@end example
@end ifset
@@ -164,13 +164,13 @@ This is performed automatically the first time the stack bounds checker
task create extension executes.
@page
-@subsection Stack_check_Dump_usage - Report Task Stack Usage
+@subsection stack_checker_dump_usage - Report Task Stack Usage
@subheading CALLING SEQUENCE:
@ifset is-C
@example
-void Stack_check_Dump_usage( void );
+void rtems_stack_checker_dump_usage( void );
@end example
@end ifset