mitron3.02.txt

rtai-3.1-test3的源代码(Real-Time Application Interface )

            Data Types
            High-Level Language Support Routines
      5.3 Error Codes

  Chapter 6 References
      6.1 System Call Support Level Categories
      6.2 System Calls
      6.3 Function Codes
      6.4 Data Types
            General-Purpose Data Types
            Data Types Dependent on ITRON Specification
      6.5 C Language Interfaces
      6.6 Common Constants and Data Structure Packet Formats
      6.7 Error Codes

  Chapter 7 Appendices
      7.1 Maker Codes and CPU Codes
            Maker Codes
            CPU Codes
      7.2 Specification Maintenance System
            Assigning Version Numbers
            Who to Contact with Questions Regarding Specifications
      7.3 Bibliography of the TRON Project and ITRON Specification

****************************************************************************
***    Index of Figures and Tables                                       ***
****************************************************************************

    Figure 1  -------- Development of the ITRON Specification
    Figure 2  -------- System Call Naming Conventions in ITRON Specification
    Table 1  --------- Abbreviations Used in Naming Conventions of ITRON
                       Specification
    Table 2  --------- Distinction of System Calls Acting on the Issuing Task
                       or Another Task and Associated State Transitions
    Figure 3  -------- Task State Transition Diagram in ITRON Specification
    Figure 4(a)  ----- Beginning State of the Ready Queue
    Figure 4(b)  ----- State of the Ready Queue After Task A Enters the WAIT
                       State
    Figure 5  -------- System States in ITRON Specification
    Figure 6  -------- Interrupt Nesting and Delayed Dispatching
    Figure 7  -------- Connecting CPUs with uITRON 3.0 Specification OS
    Figure 8  -------- Accessing Objects on Other Nodes
    Figure 9  -------- Specification Defined for the Connection Function
    Figure 10  ------- tskatr Format
    Table 3  --------- Results of Executing ter_tsk on Tasks in Various States
    Figure 11(a)  ---- Ready Queue Before Executing rot_rdq
    Figure 11(b)  ---- Ready Queue After Executing rot_rdq(tskpri=2)
    Table 4  --------- Results of Executing rel_wai on Tasks in Various States
    Table 5  --------- tskwait and wid Values
    Figure 12  ------- Message Format Used by Mailboxes
    Figure 13  ------- sematr Format
    Figure 14  ------- flgatr Format
    Figure 15  ------- The Multiple Task Wait Feature of Eventflags
    Figure 16  ------- mbxatr Format
    Figure 17  ------- Rendezvous Operation and Changes in Task Status
    Figure 18  ------- mbfatr Format
    Figure 19  ------- Synchronous Communications Using a MessageBuffer of
                       bufsz = 0
    Figure 20  ------- poratr Format
    Figure 21(a)  ---- ADA Program Sample Using the select Statement
    Figure 21(b)  ---- Implementing the ADA select Feature Using the
                       Rendezvous Function of ITRON Specification
    Figure 22  ------- Server Task Operation Using fwd_por
    Figure 23  ------- intatr Format
    Table 6  --------- State Transitions Related to dis_dsp and loc_cpu
    Table 7  --------- System Status when loc_cpu has Executed Versus Task-
                       Independent Portions
    Figure 24  ------- Typical Hardware Model for Considering Interrupt
                       Processing
    Figure 25  ------- mplatr Format
    Figure 26  ------- mpfatr Format
    Figure 27  ------- cycatr Format
    Figure 28  ------- almatr Format
    Figure 29(a)  ---- maker Format
    Figure 29(b)  ---- id Format
    Figure 29(c)  ---- spver Format
    Figure 29(d)  ---- prver Format
    Figure 29(e)  ---- prno Format
    Figure 29(f)  ---- cpu Format
    Figure 29(g)  ---- var Format
    Figure 30  ------- svcatr Format
    Figure 31  ------- excatr Format
    Figure 32  ------- Position of Communications Protocols
    Figure 33  ------- Configuration of the Connection Interface
    Figure 34  ------- Packet Flow for sig_sem and wai_sem
    Figure 35  ------- Packet Flow for psnd_mbf and rcv_mbf
    Table 8  --------- Connection Function Error Codes and Packet Flow
    Figure 36  ------- The Two Types of EN_PAR Error
    Figure 37  ------- How TC Packets are Used
    Figure 38  ------- Packet Flow When cal_por Immediately Establishes a
                       Rendezvous
    Figure 39  ------- Packet Flow When cal_por Does Not Immediately Establish
                       a Rendezvous
    Figure 40  ------- Packet Flow When a Rendezvous is Forwarded to Another
                       Node
    Figure 41  ------- Packet Flow When tcal_por Results in a Timeout
    Figure 42  ------- Packet Flow When pcal_por Establishes a Rendezvous
    Figure 43  ------- Packet Flow When pcal_por Does Not Establish a
                       Rendezvous
    Figure 44  ------- Operation of a High-Level Language Support Routine
    Figure 45  ------- Error Code Formats
    Figure 46  ------- Format of maker Returned by get_ver
    Figure 47  ------- Format of cpu Returned by get_ver

****************************************************************************
***    System Call Description Conventions                               ***
****************************************************************************

Each system call described in the system call description sections of this
specification document is described in the following manner.


========================================================================
|| [Level] || - System Call Name - || - English Description -
========================================================================
  System Call Name:  English Origin of Name

  * The letters used in [Level] indicate the support level required by the
    implementation to support the given system call.  In order of least to
    most strict support level, this is expressed by 'R', 'S' and 'E'.

  * System calls for [Level] suffixed with 'N' represent system calls which
    can support the connection function (network function).

[Parameters]

  - This section lists system call parameters, and gives a description of
    information passed to the OS when the system call is issued. -

[Return Parameters]

  - This section lists system call return parameters, and gives a description
    of information returned from the OS when the system call completes
    execution. -

[C Language Interface]

  - This section gives the C language interface of the system call. -

[Description]

  - This section describes the function of the system call. -

  * When several values may be selected for system call parameters, a
    description like that given below is included regarding the options
    available.

        ( x || y || z ) --- Indicates that one of x, y or z must be selected
        x | y           --- Indicates both x and y may be specified
                            simultaneously (x and y, if specified at a time,
                            are ORed)
        [ x ]           --- Indicates x may or may not be freely specified

    Example:
        If wfmode := (TWF_ANDW || TWF_ORW) | [TWF_CLR], any of the following
        four options can be specified for wfmode:
                TWF_ANDW
                TWF_ORW
                (TWF_ANDW | TWF_CLR)
                (TWF_ORW | TWF_CLR)

[Supplemental Information]

  - This section gives supplemental information describing special points of
    interest or points to be aware of. -

[Error Codes]

  - This section gives a description of errors which may occur when the system
    call is issued. -

  * The description of each of the following error codes is not included for
    every system call, even though it is possible that they may be detected
    upon the execution of any system call.
        E_SYS, E_NOSPT, E_RSFN, E_MACV

  * A description is given for the E_CTX error code for those system calls
    only when the conditions of the error detected are known (such as for
    system calls which may result in a WAIT state).  Note, however, that
    the E_CTX error may be detected even on other system calls due to
    implementation restrictions.  The E_CTX error code is not listed in this
    section when it occurs depending on implementation.

  * The description of following error codes, detected when the connection
    function is used, is not included in this section for every such system
    call, even though they may be detected upon the execution of any system
    call which supports the connection function (system calls of [level RN],
    [level SN], or [level EN]).
        EN_NOND, EN_PROTO, EN_RSFN, EN_COMM, EN_RLWAI, EN_EXEC

[Differences from uITRON 2.0 and ITRON2 Specifications]

  - This section describes differences between uITRON 3.0 specification
    and uITRON (Ver. 2.0) or ITRON2 specification. -

[Rationale]

  - This section describes reasons for specifications which may be unclear. -

****************************************************************************
***    System Call Index                                                 ***
****************************************************************************

This index lists all system calls of uITRON 3.0 specification described in
this document in alphabetical order.

        acp_por [E]     Accept Port for Rendezvous
        act_cyc [E]     Activate Cyclic Handler
        cal_por [EN]    Call Port for Rendezvous
        can_wup [SN]    Cancel Wakeup Request
        chg_iXX [C]     Change Interrupt Mask (Level or Priority)
        chg_pri [SN]    Change Task Priority
        clr_flg [SN]    Clear Eventflag
        cre_flg [EN]    Create Eventflag
        cre_mbf [EN]    Create MessageBuffer
        cre_mbx [E]     Create Mailbox
        cre_mpf [E]     Create Fixed-Size Memorypool
        cre_mpl [E]     Create Variable-Size Memorypool
        cre_por [EN]    Create Port for Rendezvous
        cre_sem [EN]    Create Semaphore
        cre_tsk [EN]    Create Task
        def_alm [E]     Define Alarm Handler
        def_cyc [E]     Define Cyclic Handler
        def_exc [C]     Define Exception Handler
        def_int [C]     Define Interrupt Handler
        def_svc [C]     Define Extended SVC Handler
        del_flg [EN]    Delete Eventflag
        del_mbf [EN]    Delete MessageBuffer
        del_mbx [E]     Delete Mailbox
        del_mpf [E]     Delete Fixed-Size Memorypool