Subversion Repositories or1k

#

#  This shell script generates the starting template for a manager chapter.

#

FILES="task tasksync semaphore eventflags mailbox msgbuffer rendezvous interrupt memorypool fixedblock time config network"

cat <

@c

@c  This is the chapter from the RTEMS ITRON User's Guide that

@c  documents the services provided by the task

@c  manager.

@c

@c  gen_status_shell,v 1.2 2002/01/17 21:47:45 joel Exp

@c

@chapter ITRON Implementation Status

@section Introduction

This chapter describes the status of the implementation of each

manager in the RTEMS implementataion of the uITRON 3.0 API.   The

status of each manager is presented in terms of documentation and

status relative to the extended level (level 'E') of the uITRON 3.0

API specification.  The extended level of the specification is

the level at which dynamic object creation, deletion, and

reference services are available.  This level is more akin to the other

APIs supported by RTEMS.  This purpose of this chapter is

to make it clear what is required to bring the RTEMS

uITRON API implementation into compliance with the

specification.  The following description of the specification

levels is taken from the uITRON 3.0 API specification.

uITRON 3.0 specification is divided into fewer system call levels than was the

previous uITRON 2.0 specification.  There are now just three levels: Level R

(Required), Level S (Standard) and Level E (Extended).  In addition to these

three levels, there is also Level C for CPU-dependent system calls.

In addition, the uITRON 3.0 API, defines the network level ('N') which

represents system calls that support the connection function

@itemize @bullet

@item [level R] (Required)

The functions in this level are mandatory for all implementations of

uITRON 3.0 specification.  This includes basic functions for achieving

a real-time, multitasking OS.  These functions can be implemented even

without a hardware timer.  This level corresponds to Levels 1 and 2

of uITRON 2.0 specification.

@item [level S] (Standard)

This includes basic functions for achieving a real-time, multitasking

OS.  This level corresponds to Levels 3 and 4 of uITRON 2.0

specification.

@item [level E] (Extended)

This includes additional and extended functions.  This corresponds to

functions not included in uITRON 2.0 specification (functions of

ITRON2 specification).  Specifically, this level includes object

creation and deletion functions, rendezvous functions, memorypools

and the timer handler.

@item [level C] (CPU dependent)

This level provides implementation-dependent functions required due to

the CPU or hardware configuration.

@end itemize

The support level of the connection function is indicated by appending an 'N'

to the end of the level.  For example, connectivity supported at [level S]

would be referred to as [level SN].  The support level for functions which

can only send requests for operations on other nodes but offer no system call

processing on the issuing node itself are indicated by the lower case letter

's' or 'e'.

EOF

for chapter in $FILES

do

  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"

      ;;

    *)

      echo "Unknown chapter name"

      exit 1

      ;;

  esac

  echo "@c"

  echo "@c ${CHAPTER_CAPS}"

  echo "@c"

  echo

  echo "@section ${CHAPTER_CAPS} Status"

cat <

@itemize @bullet

@item Implementation

@itemize @bullet

EOF

   for routine in ${ROUTINES}

   do

     echo "@item ${routine} - Stub, Needs to be Fleshed Out"

   done

cat <

@end itemize

@item Executive Modifications

@itemize @bullet

@item None Expected

@end itemize

@item Testing

@itemize @bullet

@item No Tests Written

@end itemize

@item Documentation

@itemize @bullet

@item Shell, Needs to be Fleshed Out

@end itemize

@item ITRON 3.0 API Conformance

@itemize @bullet

@item Level E - Extended Functionality

@itemize @bullet

@item

@end itemize

@item Level C - CPU Dependent Functionality

@itemize @bullet

@item NA

@end itemize

@item Level N - Connection Functionality

@itemize @bullet

@item Not implemented

@end itemize

@end itemize

@end itemize

EOF

done