DataMuseum.dk

Presents historical artifacts from the history of:

Rational R1000/400 Tapes

This is an automatic "excavation" of a thematic subset of
artifacts from Datamuseum.dk's BitArchive.

See our Wiki for more about Rational R1000/400 Tapes

Excavated with: AutoArchaeologist - Free & Open Source Software.


top - download
Index: ┃ S T

⟦4bbc21448⟧ TextFile

    Length: 43606 (0xaa56)
    Types: TextFile
    Names: »SEMAPHORE_LIST«

Derivation

└─⟦afbc8121e⟧ Bits:30000532 8mm tape, Rational 1000, MC68020_OS2000 7_2_2
    └─ ⟦77aa8350c⟧ »DATA« 
        └─⟦f794ecd1d⟧ 
            └─⟦24d1ddd49⟧ 
                └─⟦this⟧ 

TextFile

                                                ;    The use of this system is subject to the software license terms and
                                                ;    conditions agreed upon between Rational and the Customer.
                                                ;
                                                ;                Copyright 1988 by Rational.
                                                ;
                                                ;                          RESTRICTED RIGHTS LEGEND
                                                ;
                                                ;    Use, duplication, or disclosure by the Government is subject to
                                                ;    restrictions as set forth in subdivision (b)(3)(ii) of the Rights in
                                                ;    Technical Data and Computer Software clause at 52.227-7013.
                                                ;
                                                ;
                                                ;                Rational
                                                ;                3320 Scott Boulevard
                                                ;                Santa Clara, California 95054-3197
                                                ;
                                                ;   PROPRIETARY AND CONFIDENTIAL INFORMATION OF RATIONAL;
                                                ;   USE OR COPYING WITHOUT EXPRESS WRITTEN AUTHORIZATION
                                                ;   IS STRICTLY PROHIBITED.  THIS MATERIAL IS PROTECTED AS
                                                ;   AN UNPUBLISHED WORK UNDER THE U.S. COPYRIGHT ACT OF
                                                ;   1976.  CREATED 1988.  ALL RIGHTS RESERVED.
                                                ;
                                                ;
                                                
                                                        .module "SEMAPHORE"
                                                
                                                ;
                                                ;    Implements operations which depend on the location and
                                                ;    organization of OS-9 and OS2000 internal data structures. 
                                                ;    
                                                ;    THIS CODE IS HIGHLY DEPENDENT ON UNDOCUMENTED ASPECTS OF OS-9
                                                ;    CURRENTLY WORKS WITH OS-9 REV 2.1;
                                                ;
                                                
                                                        .include "^standard_assembler_include_file"
        00000000                                        .push_list
        00000000                                        .pop_list
        00000000                                        .list macro_expansion = none
                                                        .include "^common.os2000_definitions"
                                                ;
                                                ;       Definitions for CCT (Communication Control Table)
                                                ;
                                                
                                                cct_start       equ     1024     ; CCT offset from window start
                                                pi_cpt          equ     88       ; Offset for pointer to CPT
                                                ;
                                                ;       HSI addressing conventions
                                                ;
                                                a32_size        equ     16#02000000#;
                                                ;
                                                ;       Offsets in the Configuration Parameter Table.
                                                ;
                                                CPT_System_Time         equ     0       ; Offset to system time HW pointer
                                                
                                                CPT_Political_Time      equ     4       ; Offset to political time offset
                                                
                                                CPT_Current_Proc        equ     64      ; Offset to Os9 current process pointer 
                                                 
                                                
                                                CPT_MsgQ_Pointer        equ     144     ; Offset to Message_Queues pointer
                                                                                        ; points to MqGlobals control block
                                                
                                                CPT_Ada_Runtime_Ptr     equ     152     ; Offset in CPT to Ada Runtime pointer
                                                                                        ; points to beginning of table of
                                                                                        ; runtime entry points
                                                ;
                                                ;       OS9 system call definitions
                                                ;
                                                        os9_call        equ     0
                                                ;
                                                ;       An OS9 system call is perform with the following sequence:
                                                ;               trap    #OS9_Call
                                                ;               .dc.w   call_code
                                                ;
                                                ;       where call code is one of the following user mode calls
                                                ;       or I/O calls
                                                ;    
                                                ;       User mode system call definitions
                                                ;
                                                        F$Exit          equ     16#006#
                                                        F$Fork          equ     16#003#
                                                        F$Icpt          equ     16#009#
                                                        F$Julian        equ     16#020#
                                                        F$Link          equ     16#000#
                                                        F$PEAB          equ     16#0FA#
                                                        F$PErr          equ     16#00F#
                                                        F$RTE           equ     16#01E#
                                                        F$SPrior        equ     16#00D#
                                                        F$SRqMem        equ     16#028#
                                                        F$STime         equ     16#016#
                                                        F$STrap         equ     16#00E#
                                                        F$Send          equ     16#008#
                                                        F$Sleep         equ     16#00A#
                                                        F$Time          equ     16#015#
                                                ;
                                                ;       OS9 I/O system call definitions
                                                ;
                                                        I$Close         equ     16#08F#
                                                        I$Create        equ     16#083#
                                                        I$Delete        equ     16#087#
                                                        I$GetStt        equ     16#08D#
                                                        I$Last          equ     16#093#
                                                        I$Open          equ     16#084#
                                                        I$Read          equ     16#089#
                                                        I$ReadLn        equ     16#08B#
                                                        I$SGetSt        equ     16#092#
                                                        I$Seek          equ     16#088#
                                                        I$SetStt        equ     16#08E#
                                                        I$WritLn        equ     16#08C#
                                                        I$Write         equ     16#08A#;
                                                ;
                                                ;       Access mode for Open
                                                ;
                                                        Read_Mode       equ     1
                                                        Write_Mode      equ     2
                                                        Execute         equ     4
                                                ;
                                                ;       Function codes for the I$GetStt call
                                                ;
                                                        SS_Opt          equ     16#0000#
                                                        SS_Size         equ     16#0002#
                                                        SS_Pos          equ     16#0005#
                                                        SS_EOF          equ     16#0006#
                                                        SS_DevNm        equ     16#000E#
                                                ;
                                                ;       Standard paths
                                                ;
                                                        Standard_Input  equ     0
                                                        Standard_Output equ     1
                                                        Standard_Error  equ     2
                                                ;
                                                ;       I/O Error Codes
                                                ;
                                                        E$BPNum         equ     16#00C9#        ; bad path number
                                                ;
                                                ;       OS9 trap definitions
                                                ;
                                                        T_AddErr        equ     16#000C#
                                                        T_BusErr        equ     16#0008#
                                                        T_IllIns        equ     16#0010#
                                                        T_CHK           equ     16#0018#
                                                        T_TRAPV         equ     16#001C#
                                                        T_FPDivZer      equ     16#00C8#
                                                        T_FPInxact      equ     16#00C4#
                                                        T_FPNotNum      equ     16#00D8#
                                                        T_FPOprErr      equ     16#00D0#
                                                        T_FPOverFl      equ     16#00D4#
                                                        T_FPUndrFl      equ     16#00CC#
                                                        T_FPUnordC      equ     16#00C0#
                                                        T_ZerDiv        equ     16#0014#
                                                ;
                                                ;       OS2000 process descriptor definitions
                                                ;
                                                P$DefIOSiz      equ 32          ; Default I/O data area size
                                                P$NumPaths      equ 32          ; Number of local paths            
                                                P$MemBlks       equ 32          ; Number of separate memory blocks per process
                                                
                                                                .offset 0       ; Process descriptor
        00000398                                p$JobCon:
        000003A8                                P$AdaWrk:
        000003E8                                P$Last:                         ; Size of a process header
        00000800                                P$Stack:                        ; Top of system stack for process
        00000800                                P$Size:                         ; Size of process descriptor
                                                ;
                                                ;       Values for process state (P$STATE)
                                                ;
                                                P$SysState      equ     16#80#  ; Executing system state routine
                                                P$TimSleep      equ     16#40#  ; Timed sleep
                                                P$TimOut        equ     16#20#  ; time slice has expired
                                                P$ImgChg        equ     16#10#  ; SPU/MMU protection map has changed
                                                P$Condemn       equ     16#02#  ; process is condemned
                                                P$Dead          equ     16#01#  ; Process has terminated
                                                ;
                                                ;       Values for process queue id (P$QUEUID
                                                ;
                                                P$QActive       equ     'a'     ; active process queue
                                                P$QSleep        equ     's'     ; sleep queue
                                                P$QWait         equ     'w'     ; Waiting queue
                                                P$QEvent        equ     'e'     ; Event queue
                                                P$QCurrnt       equ     '*'     ; No queue, currently running
                                                P$QDebug        equ     'd'     ; No queue, inactively debugging
                                                P$QDead         equ     '-'     ; No queue, dead process
                                                ;
                                                ; User register stack image
                                                ;
                                                                .offset 0
        00000048                                R$Size:                         ; Size of register package
                                                
                                                ;
                                                ; Status register equates
                                                ;
                                                R$TraceBit      equ     16#8000#    ; Trace bit in SR word
                                                R$SupvrBit      equ     16#2000#    ; Supervisor bit in SR word
                                                R$IntMask       equ     16#0700#    ; Interrupt mask in SR word
                                                R$Extend        equ     16#0010#    ; Extend bit
                                                R$Negative      equ     16#0008#    ; Negative bit
                                                R$Zero          equ     16#0004#    ; Zero bit
                                                R$Ov            equ     16#0002#    ; Overflow
                                                R$Carry         equ     16#0001#    ; Carry 
                                                
                                                ; 68881 FPU context save area
                                                                .offset 0
                                                        .include "^common.runtime_definitions"
                                                ;
                                                ;   This number is used to check the compatibility
                                                ;   of the program and the loaded shared runtime.
                                                ;   The value must be incremented whenever an execution
                                                ;   incompatible change is made in the runtime.
                                                ;
                                                ;       Version         Incompatible changes in this version
                                                ;       -------         ------------------------------------
                                                ;           0           Initial release of shared runtime
                                                ;
                                                ;           1           Changed Os2000_Process_Defs to use
                                                ;                       special Ada work area rather than
                                                ;                       user accounting area.
                                                ;
                                                ;           2           Added 12 long words of spare storage
                                                ;                       in Runtime_Data; this will permit
                                                ;                       some addition of data in the shared
                                                ;                       runtime to be compatible. 
                                                ;
                                                ;           3           1.) Rev 6 compiler
                                                ;                       2.) Runtime entry point table now 16-bit
                                                ;                           offset from table to entry in words.
                                                ;                       3.) Deleted some unnecessary shared data items.
                                                ;                       4.) General cleanup
                                                        compatibility_version   equ 3
                                                ;
                                                ;   Amount of stack space reserved for the runtime in bytes
                                                ;
                                                        runtime$stack$cushion  equ 1024  
                                                ;
                                                ;   Values for certain runtime error messages and warnings.
                                                ;
                                                        error$code                      equ     16#8000#    
                                                        warning$code                    equ     16#8100#
                                                
                                                        elaboration$ferror              equ     1
                                                        finalization$ferror             equ     2
                                                        unhandled$main$trap$ferror      equ     3
                                                        lib$exception$ferror            equ     5
                                                        main$exception$ferror           equ     6
                                                        init$trap$handler$ferror        equ     37
                                                        insufficient$stack$ferror       equ     44
                                                        no$runtime$ferror               equ     45
                                                        rt$incompatible$ferror          equ     46
                                                
                                                        task$exception$warning          equ     1
                                                        heap$create$warning             equ     2       
                                                        stack$request$warning           equ     4
                                                
                                                ;
                                                ;   Values used in exit system call
                                                ;
                                                
                                                        No$Error                        equ     0
                                                        Some$Error                      equ     1
                                                ;
                                                ;   Comp Unit id for all runtime units except predefined exceptions 
                                                ;
                                                        runtime_compunit                equ     17      
                                                ;
                                                ;   Comp Unit id for predefined exception
                                                ;
                                                        exception_compunit              equ     1
                                                ;
                                                ;   Subprogram kind for runtime suprograms
                                                ;
                                                        sp_rt                           equ     1
                                                ;
                                                ;   Special statement numbers
                                                ;
                                                        stmt.end_prolog                 equ     1
                                                        stmt.begin_epilog               equ     16#7FFF#
                                                ;
                                                ;   Subprogram ids for debug directives within runtime
                                                ;   entry points.
                                                ;
                                                        sp.internal                             equ     16#0_00#
                                                
                                                        sp.enum_image                           equ     16#1_00#
                                                        sp.enum_pos                             equ     16#1_01#
                                                        sp.enum_pred                            equ     16#1_02#
                                                        sp.enum_succ                            equ     16#1_03#
                                                        sp.enum_value                           equ     16#1_04#
                                                        sp.enum_width                           equ     16#1_05#
                                                        sp.int_image                            equ     16#1_06#
                                                        sp.int_value                            equ     16#1_07#
                                                        sp.int_width                            equ     16#1_08#
                                                
                                                        sp.allocate_collection                  equ     16#2_00#
                                                        sp.allocate_fixed_cell                  equ     16#2_01#
                                                        sp.deallocate_collection                equ     16#2_02#
                                                        sp.deallocate_fixed_cell                equ     16#2_03#
                                                        sp.collection_size                      equ     16#2_04#
                                                   
                                                        sp.initialize_master                    equ     16#3_00#
                                                        sp.create_task                          equ     16#3_01#
                                                        sp.activate_offspring                   equ     16#3_02#
                                                        sp.notify_parent                        equ     16#3_03#
                                                        sp.task_end                             equ     16#3_04#
                                                        sp.await_dependents                     equ     16#3_05#
                                                        sp.task_completion                      equ     16#3_06#
                                                        sp.terminate_allocated_offspring        equ     16#3_07#
                                                        sp.terminate_dependent_offspring        equ     16#3_08#
                                                        sp.entry_call                           equ     16#3_09#
                                                        sp.conditional_entry_call               equ     16#3_0A#
                                                        sp.timed_entry_call                     equ     16#3_0B#
                                                        sp.begin_accept                         equ     16#3_0C#
                                                        sp.end_accept                           equ     16#3_0D#
                                                        sp.quick_accept                         equ     16#3_0E#
                                                        sp.close_alternatives                   equ     16#3_0F#
                                                        sp.open_delay                           equ     16#3_10#
                                                        sp.open_entry                           equ     16#3_11#
                                                        sp.open_terminate                       equ     16#3_12#
                                                        sp.select_rendezvous                    equ     16#3_13#
                                                        sp.abort_multiple_tasks                 equ     16#3_14#
                                                        sp.check_return_task                    equ     16#3_15#
                                                        sp.delay_statement                      equ     16#3_16#
                                                        sp.entry_count                          equ     16#3_17#
                                                        sp.task_callable                        equ     16#3_18#
                                                        sp.task_stack_size                      equ     16#3_19#
                                                        sp.task_terminated                      equ     16#3_1A#
                                                
                                                        sp.raise_exception                      equ     16#4_00#
                                                        sp.raise_constraint_error               equ     16#4_01#
                                                        sp.propagate_exception                  equ     16#4_02#
                                                        sp.stack_check                          equ     16#4_03#
                                                
                                                        sp.mantissa                             equ     16#5_00#
                                                        sp.large                                equ     16#5_01#
                                                        sp.fixed_multiply                       equ     16#5_02#
                                                        sp.compare_8_bit_unsigned               equ     16#5_03#
                                                        sp.compare_8_bit_signed                 equ     16#5_04#
                                                        sp.compare_16_bit_unsigned              equ     16#5_05#
                                                        sp.compare_16_bit_signed                equ     16#5_06#
                                                        sp.compare_32_bit_unsigned              equ     16#5_07#
                                                        sp.compare_32_bit_signed                equ     16#5_08#
                                                ;
                                                ;   Linkage mechanisms used in assembly routines.
                                                ;
                                                ;       Identification of the mechanism in a .subprogram directive
                                                ;       and information provided in .statement directives enable
                                                ;       the debugger to find the return pc.
                                                ;
                                                        linkage.frame   equ 16#00_00_00_00#     ; return pc may be found at
                                                                                                ; offset from frame pointer
                                                
                                                        linkage.simple  equ 16#10_00_00_00#     ; return pc may be found at
                                                                                                ; offset from stack pointer
                                                
                                                        linkage.none    equ 16#50_00_00_00#     ; no return pc exists,
                                                                                                ; in bottom routine
                                                
                                                        linkage.trap    equ 16#60_00_00_00#     ; in trap handling code
                                                ;
                                                ;       Definitions for locking primitives
                                                ;
                                                
                                                                .offset 0       ;  type Q_Element is
                                                                                ;      record
        00000008                                element'size:                   ;      end record;
                                                ;
                                                ;       Ada task control block (TCB) definitions
                                                ;
                                                                                .offset 0
                                                
                                                                                
                                                
        00000050                                tcb'size:
                                                
                                                b.action_state.exception_pending        equ     3
                                                
                                                
                                                        comp_unit  runtime_compunit
                                                 
                                                
                                                        .sect   predefined_code,code,relocatable,alignment:=2
                                                    
                                                        .gbl.l  __semaphore_acquire
                                                        .gbl.l  __semaphore_release
                                                        .ext.a  __process_descriptor_pointer
                                                
                                                ;
                                                ;    procedure Acquire (The_Lock : in out Lock);
                                                ;
                                                        subprogram sp_rt,sp.internal,linkage.simple
                                                 
        00000000                                __semaphore_acquire:
                                                        .local
                                                        
                                                        $lock'offset    equ 4+4
                                                
        00000000   2F03                                 move.l  d3,-(sp)
                                                        statement 0,0,1
                                                 
                                                
        00000002   206F0008                             movea.l ($lock'offset,sp),a0    ; get address of The_Lock
        00000006   2275017100000000                     movea.l ([__process_descriptor_pointer,a5]),a1
        0000000E   262903A8                             move.l  (art$tsk_id,a1),d3      ; fetch current task id
        00000012   2F03                                 move.l  d3,-(sp)                ; Element.Key  := Get_Current_Task_Id
                                                        statement 0,0,2
                                                 
        00000014   598F                                 subq.l  #4,sp                   ; Element.Next uninitialized 
                                                        statement 0,0,3
                                                 
                                                
        00000016   2248                                 movea.l a0,a1                   ; The_Lock'Address is in A0 
        00000018   5889                                 addq.l  #element.key,a1         ; The_Lock.Key'Address
                                                
        0000001A   7200                         $retry: moveq.l #0,d1                   ; null
        0000001C   0ED100C1                             cas.l   d1,d3,(a1)              ; if The_Lock.Key = 0 then
                                                                                        ;     The_Lock.Key  := The_Element.Key;
        00000020   6600                                 bne.b   $failed                 ; if Key /= 0 then failed
                                                
        00000022                                $acquired:                              ; else succeeded
        00000022   20280004                             move.l  (element.key,a0),d0     ; get The_Lock.Key
        00000026   508F                                 addq.l  #8,sp                   ; restore stack
                                                        statement 0,0,1
                                                 
        00000028   261F                                 move.l  (sp)+,d3                ; restore d3
                                                        statement 0,0,0
                                                 
        0000002A   4E740004                             rtd     #4
                                                
        0000002E   2010                         $failed:move.l  (a0),d0                 ; get The_Lock.Next
        00000030   2E80                                 move.l  d0,(sp)                 ; Item.Next := Lock.Next
                                                
        00000032   260F                                 move.l  sp,d3                   ; The_Element.Next'Address
        00000034   0EFC80C09041                         cas2.l  d0:d1,d3:d1,(a0):(a1)   ; if Lock unchanged then
                                                                                        ;     Lock.Next := Item and
        0000003A   6700                                 beq.b   $sleep                  ; if equal then properly enqueued 
                                                                                        ; else concurrent interference,
        0000003C   262F0004                             move.l  (element.key,sp),d3     ; so get The_Element.Key
        00000040   60D8                                 bra.b   $retry                  ; and try again to enqueue
                                                ;
                                                ;   Didn't get lock, so sleep until become head of queue
                                                ;   and lock is released.  Don't sleep indefinitely, because
                                                ;   OS-9 signals are lost (not queued) if receiver is not
                                                ;   already sleeping when signal is sent.  This introduces
                                                ;   a race condition.
                                                ;
                                                
        00000042   203C80000004                 $sleep: move.l  #-2147483644,d0         ; sleep time
        00000048   4E40                                 trap    #os9_call               ; do system call
        0000004A   000A                                 .dc.w   f$sleep
                                                    
        0000004C   20280004                             move.l  (element.key,a0),d0     ; get The_Lock.Key
        00000050   B0AF0004                             cmp.l   (element.key,sp),d0     ; compare to The_Element.Key
        00000054   67CC                                 beq.b   $acquired               ; if equal then got the lock
        00000056   60EA                                 bra.b   $sleep                  ; else try again 
                                                ;
                                                ;    procedure Release (The_Lock : in out Lock);
                                                ;
                                                        subprogram sp_rt,sp.internal,linkage.simple
                                                 
        00000058                                __semaphore_release:
                                                        .local
                                                
                                                        $lock'offset    equ 4
                                                
        00000058   206F0004                             movea.l ($lock'offset,sp),a0    ; get address of The_Lock
        0000005C   2248                                 movea.l a0,a1                   ; in a1, too
        0000005E   5889                                 addq.l  #Element.Key,a1         ; Lock.Key'Address
        00000060   2211                                 move.l  (a1),d1                 ; Lock.Key
        00000062   7000                                 moveq   #0,d0                   ; null, null id
        00000064   0EFC80009001                         cas2.l  d0:d1,d0:d0,(a0):(a1)   ; if Lock.Next = null and
                                                                                        ;    Lock.Key =  Lock.Key then
                                                                                        ;     Lock.Next := null; and
                                                                                        ;     Lock.Key  := null id; 
        0000006A   6600                                 bne.b   $waiters
        0000006C   4E740004                             rtd     #4                      ; released the lock, no waiters
                                                
        00000070                                $waiters:
        00000070   48E73010                             movem.l d2/d3/a3,-(a7)
                                                        statement 0,0,3
                                                 
                                                
        00000074   2640                         $retry: movea.l d0,a3                   ; Lock.Next
        00000076   2413                                 move.l  (a3),d2                 ; Lock.Next.Next
        00000078   262B0004                             move.l  (Element.Key,a3),d3     ; Lock.Next.Key 
        0000007C   0EFC808090C1                         cas2.l  d0:d1,d2:d3,(a0):(a1)   ; if Lock unchanged then
                                                                                        ;     Lock.Next := Lock.Next.Next;
                                                                                        ;     Lock.Key  := Lock.Next.Key;
        00000082   66F0                                 bne.b   $retry                  ; concurrent interference
                                                
        00000084   2043                                 movea.l d3,a0                   ; get The_Lock.Key
        00000086   4CDF080C                             movem.l (a7)+,d2/d3/a3
                                                        statement 0,0,0
                                                 
                                                
        0000008A   7201                                 moveq.l #1,d1                   ; wakeup signal
        0000008C   20280014                             move.l  (Tcb.Process_Id,a0),d0  ; get The_Lock.Key.Process_Id
        00000090   4E40                                 trap    #OS9_Call                     ; do system call
        00000092   0008                                 .dc.w   F$Send              
        00000094   4E740004                             rtd     #4
                                                
                                                        end_subprograms
                                                 
                                                
                                                        .end


      Program Section Name       Kind   Length   Patches Fixups
-------------------------------- ---- ---------- ------- -------
PREDEFINED_CODE                   Rel        152       3       3
DEBUG_BODY                        Rel         97      11       2
DEBUG_HDR_CU                      Rel         19       2       0


Standard include file: <none>
Object module version: 11

        Assembled 1941 lines in 19.325 elapsed, 14.462 CPU.
         6026 lines per elapsed minute.
         8053 lines per CPU minute.
         91 disk waits for this job.
         710061 bytes of heap used by this job.