mirror of
https://gitlab.rtems.org/rtems/rtos/rtems.git
synced 2026-11-09 08:37:58 +08:00
2010-06-17 Joel Sherrill <joel.sherrill@oarcorp.com>
* Makefile.am, configure.ac, index.html.in, develenv/direct.t, posix_users/gen_size_report, started/nextstep.t, started_ada/buildada.t, user/conf.t, user/object.t: Remove ITRON API. * itron3.0/.cvsignore, itron3.0/Makefile.am, itron3.0/config.t, itron3.0/eventflags.t, itron3.0/fixedblock.t, itron3.0/gen_all, itron3.0/gen_section, itron3.0/gen_status_shell, itron3.0/interrupt.t, itron3.0/itron.texi, itron3.0/mailbox.t, itron3.0/memorypool.t, itron3.0/msgbuffer.t, itron3.0/network.t, itron3.0/preface.texi, itron3.0/rendezvous.t, itron3.0/semaphore.t, itron3.0/stamp-vti, itron3.0/status.t, itron3.0/task.t, itron3.0/tasksync.t, itron3.0/time.t, itron3.0/version.texi: Removed.
This commit is contained in:
Joel Sherrill committed
1 parent
97e2fc3f61
commit
11be37d1e3
33 files changed
+20
-7817
No files matched your search
@@ -1,3 +1,17 @@
|
||||
2010-06-17 Joel Sherrill <joel.sherrill@oarcorp.com>
|
||||
|
||||
* Makefile.am, configure.ac, index.html.in, develenv/direct.t,
|
||||
posix_users/gen_size_report, started/nextstep.t,
|
||||
started_ada/buildada.t, user/conf.t, user/object.t: Remove ITRON API.
|
||||
* itron3.0/.cvsignore, itron3.0/Makefile.am, itron3.0/config.t,
|
||||
itron3.0/eventflags.t, itron3.0/fixedblock.t, itron3.0/gen_all,
|
||||
itron3.0/gen_section, itron3.0/gen_status_shell,
|
||||
itron3.0/interrupt.t, itron3.0/itron.texi, itron3.0/mailbox.t,
|
||||
itron3.0/memorypool.t, itron3.0/msgbuffer.t, itron3.0/network.t,
|
||||
itron3.0/preface.texi, itron3.0/rendezvous.t, itron3.0/semaphore.t,
|
||||
itron3.0/stamp-vti, itron3.0/status.t, itron3.0/task.t,
|
||||
itron3.0/tasksync.t, itron3.0/time.t, itron3.0/version.texi: Removed.
|
||||
|
||||
2010-06-16 Joel Sherrill <joel.sherrilL@OARcorp.com>
|
||||
|
||||
PR 1568/doc
|
||||
|
||||
+1
-1
@@ -8,7 +8,7 @@ ACLOCAL_AMFLAGS = -I ../aclocal
|
||||
# + tools, common and images are shared across many documents
|
||||
|
||||
SUBDIRS = tools started user bsp_howto porting develenv posix_users \
|
||||
posix1003.1 filesystem itron3.0 networking ada_user started_ada \
|
||||
posix1003.1 filesystem networking ada_user started_ada \
|
||||
new_chapters relnotes cpu_supplement shell
|
||||
|
||||
if USE_HTML
|
||||
|
||||
@@ -206,7 +206,6 @@ networking/Makefile
|
||||
posix_users/Makefile
|
||||
posix1003.1/Makefile
|
||||
filesystem/Makefile
|
||||
itron3.0/Makefile
|
||||
ada_user/Makefile
|
||||
started_ada/Makefile
|
||||
relnotes/Makefile
|
||||
|
||||
+3
-19
@@ -404,10 +404,6 @@ This directory contains header files which are private to
|
||||
RTEMS and not considered to be owned by any other component
|
||||
in the CPU Kit.
|
||||
|
||||
@item $@{RTEMS_ROOT@}/cpukit/itron/
|
||||
This directory contains the implementation of the
|
||||
ITRON API.
|
||||
|
||||
@item $@{RTEMS_ROOT@}/cpukit/libblock/
|
||||
This directory contains support code for using
|
||||
Block Devices such as hard drives, floppies, and
|
||||
@@ -476,8 +472,8 @@ initialization, shutdown, and IO services.
|
||||
@item $@{RTEMS_ROOT@}/cpukit/score/
|
||||
This directory contains the "SuperCore" of RTEMS.
|
||||
All APIs are implemented in terms of SuperCore services.
|
||||
For example, Classic API tasks, POSIX threads, and ITRON
|
||||
tasks are all implemented in terms of SuperCore threads.
|
||||
For example, Classic API tasks and POSIX threads
|
||||
are all implemented in terms of SuperCore threads.
|
||||
This provides a common infrastructure and a high degree
|
||||
of interoperability between the APIs. For example,
|
||||
services from all APIs may be used by any task/thread
|
||||
@@ -529,10 +525,6 @@ they may be located:
|
||||
|
||||
@table @code
|
||||
|
||||
@item $@{RTEMS_ROOT@}/testsuites/itrontests/
|
||||
This directory contains the test suite for the
|
||||
RTEMS ITRON API.
|
||||
|
||||
@item $@{RTEMS_ROOT@}/testsuites/libtests/
|
||||
This directory contains the test suite for the
|
||||
various RTEMS support components.
|
||||
@@ -564,16 +556,12 @@ executive code. With the addition of multiple APIs,
|
||||
this is no longer the case as some SuperCore functionality
|
||||
is not available through the Classic API. Thus
|
||||
some functionality in the SuperCore is only covered
|
||||
by tests in the POSIX API and ITRON API Test Suites.
|
||||
by tests in the POSIX API Test Suites.
|
||||
|
||||
@item $@{RTEMS_ROOT@}/testsuites/support/
|
||||
This directory contains support software and header files
|
||||
for the various test suites.
|
||||
|
||||
@item $@{RTEMS_ROOT@}/testsuites/tmitrontests/
|
||||
This directory contains the timing test suite for
|
||||
the RTEMS ITRON API.
|
||||
|
||||
@item $@{RTEMS_ROOT@}/testsuites/tmtests/
|
||||
This directory contains the timing test suite for
|
||||
the RTEMS Classic API. This include tests that
|
||||
@@ -651,10 +639,6 @@ information required by those implementing filesystems.
|
||||
This directory contains the source code for the graphics
|
||||
used in the HTML version of the RTEMS Documentation.
|
||||
|
||||
@item $@{RTEMS_ROOT@}/doc/itron3.0/
|
||||
This directory contains the source code for the
|
||||
@cite{RTEMS ITRON 3.0 API User's Guide}.
|
||||
|
||||
@item $@{RTEMS_ROOT@}/doc/networking/
|
||||
This directory contains the source code for the
|
||||
@cite{RTEMS Network Supplement}.
|
||||
|
||||
@@ -40,16 +40,6 @@
|
||||
RTEMS POSIX API User's Guide</A>
|
||||
</LI>
|
||||
|
||||
<LI><A HREF="../pdf/itron.pdf">
|
||||
<IMG SRC="images/pdf1.gif" HEIGHT=18 WIDTH=16></A>
|
||||
<A HREF="../ps/itron.ps">
|
||||
<IMG SRC="images/ps.gif" HEIGHT=18 WIDTH=16></A>
|
||||
<A HREF="../dvi/itron.dvi">
|
||||
<IMG SRC="images/dvi.gif" HEIGHT=18 WIDTH=16></A>
|
||||
<A HREF="itron/index.html">
|
||||
RTEMS ITRON 3.0 API User's Guide</A>
|
||||
</LI>
|
||||
|
||||
<LI><A HREF="../pdf/networking.pdf">
|
||||
<IMG SRC="images/pdf1.gif" HEIGHT=18 WIDTH=16></A>
|
||||
<A HREF="../ps/networking.ps">
|
||||
|
||||
@@ -1,37 +0,0 @@
|
||||
config.texi
|
||||
eventflags.texi
|
||||
fixedblock.texi
|
||||
index.html
|
||||
interrupt.texi
|
||||
itron
|
||||
itron-?
|
||||
itron-??
|
||||
itron.aux
|
||||
itron.cp
|
||||
itron.dvi
|
||||
itron.fn
|
||||
itron*.html
|
||||
itron.info
|
||||
itron.ky
|
||||
itron.log
|
||||
itron.pdf
|
||||
itron.pg
|
||||
itron.ps
|
||||
itron.toc
|
||||
itron.tp
|
||||
itron.vr
|
||||
mailbox.texi
|
||||
Makefile
|
||||
Makefile.in
|
||||
mdate-sh
|
||||
memorypool.texi
|
||||
msgbuffer.texi
|
||||
network.texi
|
||||
rendezvous.texi
|
||||
rtems_footer.html
|
||||
rtems_header.html
|
||||
semaphore.texi
|
||||
status.texi
|
||||
tasksync.texi
|
||||
task.texi
|
||||
time.texi
|
||||
@@ -1,102 +0,0 @@
|
||||
#
|
||||
# COPYRIGHT (c) 1988-2002.
|
||||
# On-Line Applications Research Corporation (OAR).
|
||||
# All rights reserved.
|
||||
#
|
||||
# $Id$
|
||||
#
|
||||
|
||||
PROJECT = itron
|
||||
|
||||
include $(top_srcdir)/project.am
|
||||
include $(top_srcdir)/main.am
|
||||
|
||||
GENERATED_FILES = status.texi task.texi tasksync.texi semaphore.texi \
|
||||
eventflags.texi mailbox.texi msgbuffer.texi rendezvous.texi \
|
||||
interrupt.texi memorypool.texi fixedblock.texi time.texi config.texi \
|
||||
network.texi
|
||||
|
||||
COMMON_FILES += $(top_srcdir)/common/cpright.texi
|
||||
|
||||
FILES = preface.texi
|
||||
|
||||
info_TEXINFOS = itron.texi
|
||||
itron_TEXINFOS = $(FILES) $(COMMON_FILES) $(GENERATED_FILES)
|
||||
|
||||
status.texi: status.t
|
||||
$(BMENU2) -p "" \
|
||||
-u "Top" \
|
||||
-n "" < $< > $@
|
||||
|
||||
task.texi: task.t
|
||||
$(BMENU2) -p "" \
|
||||
-u "Top" \
|
||||
-n "" < $< > $@
|
||||
|
||||
tasksync.texi: tasksync.t
|
||||
$(BMENU2) -p "" \
|
||||
-u "Top" \
|
||||
-n "" < $< > $@
|
||||
|
||||
semaphore.texi: semaphore.t
|
||||
$(BMENU2) -p "" \
|
||||
-u "Top" \
|
||||
-n "" < $< > $@
|
||||
|
||||
eventflags.texi: eventflags.t
|
||||
$(BMENU2) -p "" \
|
||||
-u "Top" \
|
||||
-n "" < $< > $@
|
||||
|
||||
mailbox.texi: mailbox.t
|
||||
$(BMENU2) -p "" \
|
||||
-u "Top" \
|
||||
-n "" < $< > $@
|
||||
|
||||
msgbuffer.texi: msgbuffer.t
|
||||
$(BMENU2) -p "" \
|
||||
-u "Top" \
|
||||
-n "" < $< > $@
|
||||
|
||||
rendezvous.texi: rendezvous.t
|
||||
$(BMENU2) -p "" \
|
||||
-u "Top" \
|
||||
-n "" < $< > $@
|
||||
|
||||
interrupt.texi: interrupt.t
|
||||
$(BMENU2) -p "" \
|
||||
-u "Top" \
|
||||
-n "" < $< > $@
|
||||
|
||||
memorypool.texi: memorypool.t
|
||||
$(BMENU2) -p "" \
|
||||
-u "Top" \
|
||||
-n "" < $< > $@
|
||||
|
||||
fixedblock.texi: fixedblock.t
|
||||
$(BMENU2) -p "" \
|
||||
-u "Top" \
|
||||
-n "" < $< > $@
|
||||
|
||||
time.texi: time.t
|
||||
$(BMENU2) -p "" \
|
||||
-u "Top" \
|
||||
-n "" < $< > $@
|
||||
|
||||
config.texi: config.t
|
||||
$(BMENU2) -p "" \
|
||||
-u "Top" \
|
||||
-n "" < $< > $@
|
||||
|
||||
network.texi: network.t
|
||||
$(BMENU2) -p "" \
|
||||
-u "Top" \
|
||||
-n "" < $< > $@
|
||||
|
||||
noinst_SCRIPTS = gen_all gen_section gen_status_shell
|
||||
|
||||
EXTRA_DIST = config.t eventflags.t fixedblock.t interrupt.t mailbox.t \
|
||||
memorypool.t msgbuffer.t network.t rendezvous.t semaphore.t status.t \
|
||||
task.t tasksync.t time.t $(noinst_SCRIPTS)
|
||||
|
||||
CLEANFILES += itron.info itron.info-?
|
||||
@@ -1,187 +0,0 @@
|
||||
@c
|
||||
@c COPYRIGHT (c) 1988-2002.
|
||||
@c On-Line Applications Research Corporation (OAR).
|
||||
@c All rights reserved.
|
||||
@c
|
||||
@c This is the chapter from the RTEMS ITRON User's Guide that
|
||||
@c documents the services provided by the system
|
||||
@c manager.
|
||||
@c
|
||||
@c $Id$
|
||||
@c
|
||||
|
||||
@chapter System Manager
|
||||
|
||||
@section Introduction
|
||||
|
||||
The
|
||||
system manager is ...
|
||||
|
||||
The services provided by the system manager are:
|
||||
|
||||
@itemize @bullet
|
||||
@item @code{get_ver} - Get Version Information
|
||||
@item @code{ref_sys} - Reference Semaphore Status
|
||||
@item @code{ref_cfg} - Reference Configuration Information
|
||||
@item @code{def_svc} - Define Extended SVC Handler
|
||||
@item @code{def_exc} - Define Exception Handler
|
||||
@end itemize
|
||||
|
||||
@section Background
|
||||
|
||||
@section Operations
|
||||
|
||||
@section System Calls
|
||||
|
||||
This section details the system manager's services.
|
||||
A subsection is dedicated to each of this manager's services
|
||||
and describes the calling sequence, related constants, usage,
|
||||
and status codes.
|
||||
|
||||
|
||||
@c
|
||||
@c get_ver
|
||||
@c
|
||||
|
||||
@page
|
||||
@subsection get_ver - Get Version Information
|
||||
|
||||
@subheading CALLING SEQUENCE:
|
||||
|
||||
@ifset is-C
|
||||
@example
|
||||
ER get_ver(
|
||||
T_VER *pk_ver
|
||||
);
|
||||
@end example
|
||||
@end ifset
|
||||
|
||||
@ifset is-Ada
|
||||
@end ifset
|
||||
|
||||
@subheading STATUS CODES:
|
||||
|
||||
@code{EXXX} -
|
||||
|
||||
@subheading DESCRIPTION:
|
||||
|
||||
@subheading NOTES:
|
||||
|
||||
|
||||
@c
|
||||
@c ref_sys
|
||||
@c
|
||||
|
||||
@page
|
||||
@subsection ref_sys - Reference Semaphore Status
|
||||
|
||||
@subheading CALLING SEQUENCE:
|
||||
|
||||
@ifset is-C
|
||||
@example
|
||||
ER ref_sys(
|
||||
T_RSYS *pk_rsys
|
||||
);
|
||||
@end example
|
||||
@end ifset
|
||||
|
||||
@ifset is-Ada
|
||||
@end ifset
|
||||
|
||||
@subheading STATUS CODES:
|
||||
|
||||
@code{EXXX} -
|
||||
|
||||
@subheading DESCRIPTION:
|
||||
|
||||
@subheading NOTES:
|
||||
|
||||
|
||||
@c
|
||||
@c ref_cfg
|
||||
@c
|
||||
|
||||
@page
|
||||
@subsection ref_cfg - Reference Configuration Information
|
||||
|
||||
@subheading CALLING SEQUENCE:
|
||||
|
||||
@ifset is-C
|
||||
@example
|
||||
ER ref_cfg(
|
||||
T_RCFG *pk_rcfg
|
||||
);
|
||||
@end example
|
||||
@end ifset
|
||||
|
||||
@ifset is-Ada
|
||||
@end ifset
|
||||
|
||||
@subheading STATUS CODES:
|
||||
|
||||
@code{EXXX} -
|
||||
|
||||
@subheading DESCRIPTION:
|
||||
|
||||
@subheading NOTES:
|
||||
|
||||
|
||||
@c
|
||||
@c def_svc
|
||||
@c
|
||||
|
||||
@page
|
||||
@subsection def_svc - Define Extended SVC Handler
|
||||
|
||||
@subheading CALLING SEQUENCE:
|
||||
|
||||
@ifset is-C
|
||||
@example
|
||||
ER def_svc(
|
||||
FN s_fncd,
|
||||
T_DSVC *pk_dsvc
|
||||
);
|
||||
@end example
|
||||
@end ifset
|
||||
|
||||
@ifset is-Ada
|
||||
@end ifset
|
||||
|
||||
@subheading STATUS CODES:
|
||||
|
||||
@code{EXXX} -
|
||||
|
||||
@subheading DESCRIPTION:
|
||||
|
||||
@subheading NOTES:
|
||||
|
||||
|
||||
@c
|
||||
@c def_exc
|
||||
@c
|
||||
|
||||
@page
|
||||
@subsection def_exc - Define Exception Handler
|
||||
|
||||
@subheading CALLING SEQUENCE:
|
||||
|
||||
@ifset is-C
|
||||
@example
|
||||
ER def_exc(
|
||||
UINT exckind,
|
||||
T_DEXC *pk_dexc
|
||||
);
|
||||
@end example
|
||||
@end ifset
|
||||
|
||||
@ifset is-Ada
|
||||
@end ifset
|
||||
|
||||
@subheading STATUS CODES:
|
||||
|
||||
@code{EXXX} -
|
||||
|
||||
@subheading DESCRIPTION:
|
||||
|
||||
@subheading NOTES:
|
||||
|
||||
File diff suppressed because it is too large.
Load diff
File diff suppressed because it is too large.
Load diff
@@ -1,4 +0,0 @@
|
||||
for i in config eventflags fixedblock interrupt mailbox memorypool msgbuffer network rendezvous task tasksync time
|
||||
do
|
||||
sh ./gen_section $i | tr -d "\r" >${i}.t
|
||||
done
|
||||
@@ -1,191 +0,0 @@
|
||||
#
|
||||
# This shell script generates the starting template for a manager chapter.
|
||||
#
|
||||
|
||||
|
||||
# Set this based on which chapter you want to generate a template for.
|
||||
chapter=$1
|
||||
|
||||
case ${chapter} in
|
||||
task)
|
||||
CHAPTER_CAPS="Task"
|
||||
CHAPTER_LOWER="task"
|
||||
ROUTINES=" cre_tsk del_tsk sta_tsk ext_tsk exd_tsk ter_tsk \
|
||||
dis_dsp ena_dsp chg_pri rot_rdq rel_wai get_tid ref_tsk"
|
||||
;;
|
||||
|
||||
tasksync)
|
||||
CHAPTER_CAPS="Task-Dependent Synchronization"
|
||||
CHAPTER_LOWER="task-dependent synchronization"
|
||||
ROUTINES=" sus_tsk rsm_tsk frsm_tsk \
|
||||
slp_tsk tslp_tsk wup_tsk can_wup"
|
||||
;;
|
||||
|
||||
semaphore)
|
||||
CHAPTER_CAPS="Semaphore"
|
||||
CHAPTER_LOWER="semaphore"
|
||||
ROUTINES="cre_sem del_sem sig_sem wai_sem preq_sem twai_sem ref_sem "
|
||||
;;
|
||||
|
||||
eventflags)
|
||||
CHAPTER_CAPS="Eventflags"
|
||||
CHAPTER_LOWER="eventflags"
|
||||
ROUTINES=" cre_flg del_flg set_flg clr_flg wai_flg pol_flg \
|
||||
twai_flg ref_flg "
|
||||
;;
|
||||
|
||||
mailbox)
|
||||
CHAPTER_CAPS="Mailbox"
|
||||
CHAPTER_LOWER="mailbox"
|
||||
ROUTINES="cre_mbx del_mbx snd_msg rcv_msg prcv_msg trcv_msg ref_mbx"
|
||||
;;
|
||||
|
||||
msgbuffer)
|
||||
CHAPTER_CAPS="Message Buffer"
|
||||
CHAPTER_LOWER="message buffer"
|
||||
ROUTINES=" cre_mbf del_mbf snd_mbf psnd_mbf tsnd_mbf rcv_mbf prcv_mbf \
|
||||
trcv_mbf ref_mbf "
|
||||
;;
|
||||
|
||||
rendezvous)
|
||||
CHAPTER_CAPS="Rendezvous"
|
||||
CHAPTER_LOWER="rendezvous"
|
||||
ROUTINES=" cre_por del_por cal_por pcal_por tcal_por acp_por pacp_por \
|
||||
tacp_por fwd_por rpl_rdv ref_por"
|
||||
;;
|
||||
|
||||
interrupt)
|
||||
CHAPTER_CAPS="Interrupt"
|
||||
CHAPTER_LOWER="interrupt"
|
||||
ROUTINES=" def_int ret_int ret_wup loc_cpu unl_cpu dis_int ena_int
|
||||
chg_iXX ref_iXX"
|
||||
;;
|
||||
|
||||
memorypool)
|
||||
CHAPTER_CAPS="Memory Pool"
|
||||
CHAPTER_LOWER="memory pool"
|
||||
ROUTINES=" cre_mpl del_mpl get_blk pget_blk tget_blk rel_blk ref_mpl"
|
||||
;;
|
||||
|
||||
fixedblock)
|
||||
CHAPTER_CAPS="Fixed Block"
|
||||
CHAPTER_LOWER="fixed block"
|
||||
ROUTINES=" cre_mpf del_mpf get_blf pget_blf tget_blf rel_blf ref_mpf"
|
||||
;;
|
||||
|
||||
|
||||
time)
|
||||
CHAPTER_CAPS="Time"
|
||||
CHAPTER_LOWER="time"
|
||||
ROUTINES=" get_tim set_tim dly_tsk \
|
||||
def_cyc act_cyc ref_cyc \
|
||||
def_alm ref_alm ret_tmr"
|
||||
;;
|
||||
|
||||
config)
|
||||
CHAPTER_CAPS="System"
|
||||
CHAPTER_LOWER="system"
|
||||
ROUTINES=" get_ver ref_sys ref_cfg def_svc def_exc"
|
||||
;;
|
||||
|
||||
network)
|
||||
CHAPTER_CAPS="Network Support"
|
||||
CHAPTER_LOWER="network support"
|
||||
ROUTINES=" nrea_dat nwri_dat nget_nod nget_ver"
|
||||
;;
|
||||
psxtimer)
|
||||
CHAPTER_CAPS="Timer"
|
||||
CHAPTER_LOWER="timer"
|
||||
ROUTINES="timer_create timer_delete timer_settime timer_gettime timer_getoverrun"
|
||||
;;
|
||||
*)
|
||||
echo "Unknown chapter name"
|
||||
exit 1
|
||||
;;
|
||||
esac
|
||||
|
||||
if [ "x${CHAPTER_CAPS}" = "x" -o "x${CHAPTER_LOWER}" = "x" \
|
||||
-o "x${ROUTINES}" = "x" ] ; then
|
||||
echo "initialization problem"
|
||||
exit 1
|
||||
fi
|
||||
|
||||
echo "@c"
|
||||
echo "@c This is the chapter from the RTEMS ITRON User's Guide that"
|
||||
echo "@c documents the services provided by the ${CHAPTER_LOWER}"
|
||||
echo "@c manager."
|
||||
echo "@c"
|
||||
echo "@c \$Id\$"
|
||||
echo "@c"
|
||||
echo ""
|
||||
echo "@chapter ${CHAPTER_CAPS}" Manager
|
||||
echo ""
|
||||
echo "@section Introduction"
|
||||
echo ""
|
||||
echo "The "
|
||||
echo "${CHAPTER_LOWER} manager is ..."
|
||||
echo ""
|
||||
echo "The services provided by the ${CHAPTER_LOWER} manager are:"
|
||||
echo ""
|
||||
echo "@itemize @bullet"
|
||||
|
||||
for routine in ${ROUTINES}
|
||||
do
|
||||
description=`grep " ${routine} " ../../itron_spec/itron3-1.txt | grep "]" | cut -d']' -f2 `
|
||||
description=`echo ${description}`
|
||||
echo "@item @code{${routine}} - ${description}"
|
||||
done
|
||||
echo "@end itemize"
|
||||
|
||||
echo ""
|
||||
echo "@section Background"
|
||||
echo ""
|
||||
echo "@section Operations"
|
||||
echo ""
|
||||
echo "@section System Calls"
|
||||
echo ""
|
||||
echo "This section details the ${CHAPTER_LOWER} manager's services."
|
||||
echo "A subsection is dedicated to each of this manager's services"
|
||||
echo "and describes the calling sequence, related constants, usage,"
|
||||
echo "and status codes."
|
||||
echo ""
|
||||
|
||||
for routine in ${ROUTINES}
|
||||
do
|
||||
description=`grep ${routine} ../../itron_spec/itron3-1.txt | grep "]" | cut -d']' -f2`
|
||||
description=`echo -n ${description}`
|
||||
echo ""
|
||||
echo "@c"
|
||||
echo "@c ${routine}"
|
||||
echo "@c"
|
||||
echo ""
|
||||
echo "@page"
|
||||
echo "@subsection ${routine} - " ${description}
|
||||
echo ""
|
||||
echo "@subheading CALLING SEQUENCE:"
|
||||
echo ""
|
||||
echo "@ifset is-C"
|
||||
echo "@example"
|
||||
proto=`grep "${routine} (" ../../itron_spec/itron3-6.txt | sed -e 's/ercd = //'` # | sed -e 's/ \\(/(/'`
|
||||
|
||||
echo `echo -n ${proto} | cut -d'(' -f1`"("
|
||||
echo ${proto} | cut -d'(' -f2 | sed -e 's/ .;//'
|
||||
echo ");"
|
||||
# echo "int ${routine}("
|
||||
# echo ");"
|
||||
echo "@end example"
|
||||
echo "@end ifset"
|
||||
echo ""
|
||||
echo "@ifset is-Ada"
|
||||
echo "@end ifset"
|
||||
echo ""
|
||||
echo "@subheading STATUS CODES:"
|
||||
echo ""
|
||||
echo "@code{EXXX} - "
|
||||
echo ""
|
||||
echo "@subheading DESCRIPTION:"
|
||||
echo ""
|
||||
echo "@subheading NOTES:"
|
||||
echo ""
|
||||
done
|
||||
|
||||
File diff suppressed because it is too large.
Load diff
File diff suppressed because it is too large.
Load diff
@@ -1,144 +0,0 @@
|
||||
\input texinfo @c -*-texinfo-*-
|
||||
@c %**start of header
|
||||
@setfilename itron.info
|
||||
@setcontentsaftertitlepage
|
||||
@syncodeindex vr fn
|
||||
@synindex ky cp
|
||||
@paragraphindent 0
|
||||
@c %**end of header
|
||||
|
||||
@c
|
||||
@c COPYRIGHT (c) 1988-2002.
|
||||
@c On-Line Applications Research Corporation (OAR).
|
||||
@c All rights reserved.
|
||||
@c
|
||||
@c $Id$
|
||||
@c
|
||||
|
||||
@c
|
||||
@c Master file for the RTEMS ITRON 3.0 API User's Guide
|
||||
@c
|
||||
|
||||
@c Joel's Questions
|
||||
@c
|
||||
@c 1. Why does paragraphindent only impact makeinfo?
|
||||
@c 2. Why does paragraphindent show up in HTML?
|
||||
@c
|
||||
|
||||
@include version.texi
|
||||
@include common/setup.texi
|
||||
@include common/rtems.texi
|
||||
|
||||
@ifset use-ascii
|
||||
@dircategory RTEMS On-Line Manual
|
||||
@direntry
|
||||
* RTEMS ITRON 3.0 API User's Guide: (itron).
|
||||
ITRON Guide
|
||||
@end direntry
|
||||
@end ifset
|
||||
|
||||
@c variable substitution info:
|
||||
@c
|
||||
@c Note: At the moment there is not an Ada interface to ITRON.
|
||||
@set is-C
|
||||
@clear is-Ada
|
||||
@set LANGUAGE C
|
||||
@set STRUCTURE structure
|
||||
@set ROUTINE function
|
||||
@set OR |
|
||||
@set RPREFIX RTEMS_
|
||||
@set DIRPREFIX rtems_
|
||||
@c the language is @value{LANGUAGE}
|
||||
@c NOTE: don't use underscore in the name
|
||||
@c
|
||||
|
||||
@c
|
||||
@c Title Page Stuff
|
||||
@c
|
||||
|
||||
@c
|
||||
@c I don't really like having a short title page. --joel
|
||||
@c
|
||||
@c @shorttitlepage RTEMS ITRON 3.0 API User's Guide
|
||||
|
||||
@setchapternewpage odd
|
||||
@settitle RTEMS ITRON 3.0 API User's Guide
|
||||
@titlepage
|
||||
@finalout
|
||||
|
||||
@title RTEMS ITRON 3.0 User's Guide
|
||||
@subtitle Edition @value{EDITION}, for RTEMS @value{VERSION}
|
||||
@sp 1
|
||||
@subtitle @value{UPDATED}
|
||||
@author On-Line Applications Research Corporation
|
||||
@page
|
||||
@include common/cpright.texi
|
||||
@end titlepage
|
||||
|
||||
@c This prevents a black box from being printed on "overflow" lines.
|
||||
@c The alternative is to rework a sentence to avoid this problem.
|
||||
|
||||
@contents
|
||||
|
||||
@include preface.texi
|
||||
@include task.texi
|
||||
@include tasksync.texi
|
||||
@include semaphore.texi
|
||||
@include eventflags.texi
|
||||
@include mailbox.texi
|
||||
@include msgbuffer.texi
|
||||
@include rendezvous.texi
|
||||
@include interrupt.texi
|
||||
@include memorypool.texi
|
||||
@include fixedblock.texi
|
||||
@include time.texi
|
||||
@include config.texi
|
||||
@include network.texi
|
||||
@include status.texi
|
||||
@ifinfo
|
||||
@node Top, , (dir), (dir)
|
||||
@top itron
|
||||
|
||||
This is the online version of the RTEMS ITRON 3.0 API User's Guide.
|
||||
|
||||
@menu
|
||||
* Preface::
|
||||
* Task Manager::
|
||||
* Task-Dependent Synchronization Manager::
|
||||
* Semaphore Manager::
|
||||
* Eventflags Manager::
|
||||
* Mailbox Manager::
|
||||
* Message Buffer Manager::
|
||||
* Rendezvous Manager::
|
||||
* Interrupt Manager::
|
||||
* Memory Pool Manager::
|
||||
* Fixed Block Manager::
|
||||
* Time Manager::
|
||||
* System Manager::
|
||||
* Network Support Manager::
|
||||
* ITRON Implementation Status::
|
||||
* Command and Variable Index::
|
||||
* Concept Index::
|
||||
@end menu
|
||||
|
||||
@end ifinfo
|
||||
@c
|
||||
@c
|
||||
@c Need to copy the emacs stuff and "trailer stuff" (index, toc) into here
|
||||
@c
|
||||
|
||||
@node Command and Variable Index, Concept Index, , Top
|
||||
@unnumbered Command and Variable Index
|
||||
|
||||
There are currently no Command and Variable Index entries.
|
||||
|
||||
@c @printindex fn
|
||||
|
||||
@node Concept Index, , Command and Variable Index, Top
|
||||
@unnumbered Concept Index
|
||||
|
||||
There are currently no Concept Index entries.
|
||||
@c @printindex cp
|
||||
|
||||
@bye
|
||||
|
||||
File diff suppressed because it is too large.
Load diff
File diff suppressed because it is too large.
Load diff
File diff suppressed because it is too large.
Load diff
@@ -1,162 +0,0 @@
|
||||
@c
|
||||
@c COPYRIGHT (c) 1988-2002.
|
||||
@c On-Line Applications Research Corporation (OAR).
|
||||
@c All rights reserved.
|
||||
@c
|
||||
@c This is the chapter from the RTEMS ITRON User's Guide that
|
||||
@c documents the services provided by the network support
|
||||
@c manager.
|
||||
@c
|
||||
@c $Id$
|
||||
@c
|
||||
|
||||
@chapter Network Support Manager
|
||||
|
||||
@section Introduction
|
||||
|
||||
The
|
||||
network support manager is ...
|
||||
|
||||
The services provided by the network support manager are:
|
||||
|
||||
@itemize @bullet
|
||||
@item @code{nrea_dat} - Read Data from another Node
|
||||
@item @code{nwri_dat} - Write Data to another Node
|
||||
@item @code{nget_nod} - Get Local Node Number
|
||||
@item @code{nget_ver} - Get Version Information of another Node
|
||||
@end itemize
|
||||
|
||||
@section Background
|
||||
|
||||
@section Operations
|
||||
|
||||
@section System Calls
|
||||
|
||||
This section details the network support manager's services.
|
||||
A subsection is dedicated to each of this manager's services
|
||||
and describes the calling sequence, related constants, usage,
|
||||
and status codes.
|
||||
|
||||
|
||||
@c
|
||||
@c nrea_dat
|
||||
@c
|
||||
|
||||
@page
|
||||
@subsection nrea_dat - Read Data from another Node
|
||||
|
||||
@subheading CALLING SEQUENCE:
|
||||
|
||||
@ifset is-C
|
||||
@example
|
||||
ER nrea_dat(
|
||||
INT *p_reasz,
|
||||
VP dstadr,
|
||||
NODE srcnode,
|
||||
VP srcadr,
|
||||
);
|
||||
@end example
|
||||
@end ifset
|
||||
|
||||
@ifset is-Ada
|
||||
@end ifset
|
||||
|
||||
@subheading STATUS CODES:
|
||||
|
||||
@code{EXXX} -
|
||||
|
||||
@subheading DESCRIPTION:
|
||||
|
||||
@subheading NOTES:
|
||||
|
||||
|
||||
@c
|
||||
@c nwri_dat
|
||||
@c
|
||||
|
||||
@page
|
||||
@subsection nwri_dat - Write Data to another Node
|
||||
|
||||
@subheading CALLING SEQUENCE:
|
||||
|
||||
@ifset is-C
|
||||
@example
|
||||
ER nwri_dat(
|
||||
INT *p_wrisz,
|
||||
NODE dstnode,
|
||||
VP dstadr,
|
||||
VP srcadr,
|
||||
);
|
||||
@end example
|
||||
@end ifset
|
||||
|
||||
@ifset is-Ada
|
||||
@end ifset
|
||||
|
||||
@subheading STATUS CODES:
|
||||
|
||||
@code{EXXX} -
|
||||
|
||||
@subheading DESCRIPTION:
|
||||
|
||||
@subheading NOTES:
|
||||
|
||||
|
||||
@c
|
||||
@c nget_nod
|
||||
@c
|
||||
|
||||
@page
|
||||
@subsection nget_nod - Get Local Node Number
|
||||
|
||||
@subheading CALLING SEQUENCE:
|
||||
|
||||
@ifset is-C
|
||||
@example
|
||||
ER nget_nod(
|
||||
NODE *p_node
|
||||
);
|
||||
@end example
|
||||
@end ifset
|
||||
|
||||
@ifset is-Ada
|
||||
@end ifset
|
||||
|
||||
@subheading STATUS CODES:
|
||||
|
||||
@code{EXXX} -
|
||||
|
||||
@subheading DESCRIPTION:
|
||||
|
||||
@subheading NOTES:
|
||||
|
||||
|
||||
@c
|
||||
@c nget_ver
|
||||
@c
|
||||
|
||||
@page
|
||||
@subsection nget_ver - Get Version Information of another Node
|
||||
|
||||
@subheading CALLING SEQUENCE:
|
||||
|
||||
@ifset is-C
|
||||
@example
|
||||
ER nget_ver(
|
||||
T_VER *pk_ver,
|
||||
NODE node
|
||||
);
|
||||
@end example
|
||||
@end ifset
|
||||
|
||||
@ifset is-Ada
|
||||
@end ifset
|
||||
|
||||
@subheading STATUS CODES:
|
||||
|
||||
@code{EXXX} -
|
||||
|
||||
@subheading DESCRIPTION:
|
||||
|
||||
@subheading NOTES:
|
||||
|
||||
@@ -1,14 +0,0 @@
|
||||
@c
|
||||
@c COPYRIGHT (c) 1988-2002.
|
||||
@c On-Line Applications Research Corporation (OAR).
|
||||
@c All rights reserved.
|
||||
@c
|
||||
@c $Id$
|
||||
@c
|
||||
|
||||
@ifinfo
|
||||
@node Preface, , Top, Top
|
||||
@end ifinfo
|
||||
@unnumbered Preface
|
||||
|
||||
There needs to be a preface to this manual.
|
||||
File diff suppressed because it is too large.
Load diff
File diff suppressed because it is too large.
Load diff
@@ -1,4 +0,0 @@
|
||||
@set UPDATED 27 June 2007
|
||||
@set UPDATED-MONTH June 2007
|
||||
@set EDITION 4.10.99.0
|
||||
@set VERSION 4.10.99.0
|
||||
File diff suppressed because it is too large.
Load diff
File diff suppressed because it is too large.
Load diff
File diff suppressed because it is too large.
Load diff
File diff suppressed because it is too large.
Load diff
@@ -1,4 +0,0 @@
|
||||
@set UPDATED 27 June 2007
|
||||
@set UPDATED-MONTH June 2007
|
||||
@set EDITION 4.10.99.0
|
||||
@set VERSION 4.10.99.0
|
||||
@@ -190,24 +190,4 @@ do
|
||||
per_manager $i exec/posix/src lib/libc libm_extract
|
||||
done
|
||||
|
||||
# Grab the size of the ITRON API
|
||||
cd ${docdir}/itron3.0
|
||||
echo
|
||||
echo "=============================================================="
|
||||
echo "=============================================================="
|
||||
echo "==== ===="
|
||||
echo "==== ITRON 3.0 API SIZE INFORMATION ===="
|
||||
echo "==== ===="
|
||||
echo "=============================================================="
|
||||
echo "=============================================================="
|
||||
echo
|
||||
if [ -r ${objdir}/../../../${bsp}/lib/libitron.a ] ; then
|
||||
for i in *.t
|
||||
do
|
||||
per_manager $i exec/itron/src
|
||||
done
|
||||
else
|
||||
echo "ITRON API not configured."
|
||||
fi
|
||||
|
||||
|
||||
@@ -44,9 +44,6 @@ Classic RTEMS API based on the RTEID specification.
|
||||
@item @b{RTEMS POSIX API User's Guide} describes the
|
||||
RTEMS POSIX API that is based on the POSIX 1003.1b API.
|
||||
|
||||
@item @b{RTEMS ITRON 3.0 API User's Guide} describes
|
||||
the RTEMS implementation of the ITRON 3.0 API.
|
||||
|
||||
@item @b{RTEMS Network Supplement} provides information
|
||||
on the network services provided by RTEMS.
|
||||
|
||||
@@ -103,7 +100,7 @@ initialization tasks or threads. It is possible
|
||||
to configure an application to start with a
|
||||
single thread that whose entry point is @code{main()}.
|
||||
|
||||
Each API supported by RTEMS (Classic, POSIX, and ITRON)
|
||||
Each API supported by RTEMS (Internal, Classic, and POSIX)
|
||||
allows the user to configure a set of one or more tasks
|
||||
that are created and started automatically
|
||||
during RTEMS initialization. The RTEMS Automatic
|
||||
@@ -117,8 +114,6 @@ initialization task varies based up API.
|
||||
@item @code{Init} - single Classic API Initialization Task
|
||||
|
||||
@item @code{POSIX_Init} - single POSIX API Initialization Thread
|
||||
|
||||
@item @code{ITRON_Init} - single ITRON API Initialization Task
|
||||
@end itemize
|
||||
|
||||
Regardless of the API used, when the initialization task executes,
|
||||
|
||||
@@ -492,11 +492,6 @@ This corresponds to the
|
||||
|
||||
This must be enabled to support the GNAT/RTEMS run-time.
|
||||
|
||||
@item ENABLE_RTEMS_ITRON
|
||||
is set to "yes" if you want to enable the RTEMS ITRON API support.
|
||||
This corresponds to the
|
||||
@code{configure} option @code{--enable-itron}.
|
||||
|
||||
@item ENABLE_RTEMS_MP
|
||||
is set to "yes" if you want to enable the RTEMS multiprocessing
|
||||
support. This feature is not supported by all RTEMS BSPs and
|
||||
|
||||
-110
@@ -764,115 +764,6 @@ value is twice the configured minimum stack size.
|
||||
|
||||
@end itemize
|
||||
|
||||
@subsection ITRON API Configuration
|
||||
|
||||
The parameters in this section are used to configure resources
|
||||
for the RTEMS ITRON API. They are only relevant if the POSIX API
|
||||
is enabled at configure time using the @code{--enable-itron} option.
|
||||
|
||||
@itemize @bullet
|
||||
@findex CONFIGURE_MAXIMUM_ITRON_TASKS
|
||||
@item @code{CONFIGURE_MAXIMUM_ITRON_TASKS}
|
||||
is the maximum number of
|
||||
ITRON API tasks that can be concurrently active.
|
||||
The default is 0.
|
||||
|
||||
@findex CONFIGURE_MAXIMUM_ITRON_SEMAPHORES
|
||||
@item @code{CONFIGURE_MAXIMUM_ITRON_SEMAPHORES}
|
||||
is the maximum number of
|
||||
ITRON API semaphores that can be concurrently active.
|
||||
The default is 0.
|
||||
|
||||
@findex CONFIGURE_MAXIMUM_ITRON_EVENTFLAGS
|
||||
@item @code{CONFIGURE_MAXIMUM_ITRON_EVENTFLAGS}
|
||||
is the maximum number of
|
||||
ITRON API eventflags that can be concurrently active.
|
||||
The default is 0.
|
||||
|
||||
@findex CONFIGURE_MAXIMUM_ITRON_MAILBOXES
|
||||
@item @code{CONFIGURE_MAXIMUM_ITRON_MAILBOXES}
|
||||
is the maximum number of
|
||||
ITRON API mailboxes that can be concurrently active.
|
||||
The default is 0.
|
||||
|
||||
@findex CONFIGURE_MAXIMUM_ITRON_MESSAGE_BUFFERS
|
||||
@item @code{CONFIGURE_MAXIMUM_ITRON_MESSAGE_BUFFERS}
|
||||
is the maximum number of
|
||||
ITRON API message buffers that can be concurrently active.
|
||||
The default is 0.
|
||||
|
||||
@findex CONFIGURE_MAXIMUM_ITRON_PORTS
|
||||
@item @code{CONFIGURE_MAXIMUM_ITRON_PORTS}
|
||||
is the maximum number of
|
||||
ITRON API ports that can be concurrently active.
|
||||
The default is 0.
|
||||
|
||||
@findex CONFIGURE_MAXIMUM_ITRON_MEMORY_POOLS
|
||||
@item @code{CONFIGURE_MAXIMUM_ITRON_MEMORY_POOLS}
|
||||
is the maximum number of
|
||||
ITRON API memory pools that can be concurrently active.
|
||||
The default is 0.
|
||||
|
||||
@findex CONFIGURE_MAXIMUM_ITRON_FIXED_MEMORY_POOLS
|
||||
@item @code{CONFIGURE_MAXIMUM_ITRON_FIXED_MEMORY_POOLS}
|
||||
is the maximum number of
|
||||
ITRON API fixed memory pools that can be concurrently active.
|
||||
The default is 0.
|
||||
|
||||
@end itemize
|
||||
|
||||
@subsection ITRON Initialization Task Table Configuration
|
||||
|
||||
The @code{rtems/confdefs.h} configuration system can automatically
|
||||
generate an ITRON Initialization Tasks Table named
|
||||
@code{ITRON_Initialization_tasks} with a single entry. The following
|
||||
parameters control the generation of that table.
|
||||
|
||||
@itemize @bullet
|
||||
@findex CONFIGURE_ITRON_INIT_TASK_TABLE
|
||||
@item @code{CONFIGURE_ITRON_INIT_TASK_TABLE} is defined
|
||||
if the user wishes to use a ITRON API Initialization
|
||||
Tasks Table. The application may choose to use the initialization
|
||||
tasks or threads table from another API. By default, this
|
||||
field is not defined as the user MUST select their own
|
||||
API for initialization tasks.
|
||||
|
||||
@findex CONFIGURE_ITRON_HAS_OWN_INIT_TASK_TABLE
|
||||
@item @code{CONFIGURE_ITRON_HAS_OWN_INIT_TASK_TABLE}
|
||||
is defined if the user wishes to define their own ITRON API Initialization
|
||||
Tasks Table. This table should be named @code{ITRON_Initialization_tasks}.
|
||||
By default, this is not defined.
|
||||
|
||||
@findex CONFIGURE_ITRON_INIT_TASK_ENTRY_POINT
|
||||
@item @code{CONFIGURE_ITRON_INIT_TASK_ENTRY_POINT}
|
||||
is the entry point (a.k.a. function name)
|
||||
of the single initialization task defined by the
|
||||
ITRON API Initialization Tasks Table. By default
|
||||
the value is @code{ITRON_Init}.
|
||||
|
||||
@findex CONFIGURE_ITRON_INIT_TASK_ATTRIBUTES
|
||||
@item @code{CONFIGURE_ITRON_INIT_TASK_ATTRIBUTES}
|
||||
is the attribute set
|
||||
of the single initialization task defined by the
|
||||
ITRON API Initialization Tasks Table. By default
|
||||
the value is @code{TA_HLNG}.
|
||||
|
||||
@findex CONFIGURE_ITRON_INIT_TASK_PRIORITY
|
||||
@item @code{CONFIGURE_ITRON_INIT_TASK_PRIORITY}
|
||||
is the initial priority
|
||||
of the single initialization task defined by the
|
||||
ITRON API Initialization Tasks Table. By default
|
||||
the value is @code{1} which is the highest priority
|
||||
in the ITRON API.
|
||||
|
||||
@findex CONFIGURE_ITRON_INIT_TASK_STACK_SIZE
|
||||
@item @code{CONFIGURE_ITRON_INIT_TASK_STACK_SIZE}
|
||||
is the stack size of the single initialization task defined by the
|
||||
ITRON API Initialization Tasks Table. By default
|
||||
value is the configured minimum stack size.
|
||||
|
||||
@end itemize
|
||||
|
||||
@subsection Ada Tasks
|
||||
|
||||
This section defines the system configuration parameters supported
|
||||
@@ -941,7 +832,6 @@ typedef struct @{
|
||||
#endif
|
||||
rtems_api_configuration_table *RTEMS_api_configuration;
|
||||
posix_api_configuration_table *POSIX_api_configuration;
|
||||
itron_api_configuration *ITRON_api_configuration;
|
||||
@} rtems_configuration_table;
|
||||
@end group
|
||||
@end example
|
||||
|
||||
+1
-1
@@ -44,7 +44,7 @@ RTEMS are:
|
||||
@subsection APIs
|
||||
|
||||
RTEMS implements multiple APIs including an Internal API,
|
||||
the Classic API, the POSIX API, and the uITRON API. These
|
||||
the Classic API, and the POSIX API. These
|
||||
APIs share the common foundation of SuperCore objects and
|
||||
thus share object management code. This includes a common
|
||||
scheme for object Ids and for managing object names whether
|
||||
|
||||
Reference in new issue
Block a user