URL
https://opencores.org/ocsvn/openrisc_2011-10-31/openrisc_2011-10-31/trunk
Subversion Repositories openrisc_2011-10-31
[/] [openrisc/] [tags/] [gnu-src/] [gcc-4.5.1/] [gcc-4.5.1-or32-1.0rc2/] [gcc/] [testsuite/] [ada/] [acats/] [tests/] [c9/] [c954014.a] - Rev 294
Go to most recent revision | Compare with Previous | Blame | View Log
-- C954014.A
--
-- Grant of Unlimited Rights
--
-- Under contracts F33600-87-D-0337, F33600-84-D-0280, MDA903-79-C-0687,
-- F08630-91-C-0015, and DCA100-97-D-0025, the U.S. Government obtained
-- unlimited rights in the software and documentation contained herein.
-- Unlimited rights are defined in DFAR 252.227-7013(a)(19). By making
-- this public release, the Government intends to confer upon all
-- recipients unlimited rights equal to those held by the Government.
-- These rights include rights to use, duplicate, release or disclose the
-- released technical data and computer software in whole or in part, in
-- any manner and for any purpose whatsoever, and to have or permit others
-- to do so.
--
-- DISCLAIMER
--
-- ALL MATERIALS OR INFORMATION HEREIN RELEASED, MADE AVAILABLE OR
-- DISCLOSED ARE AS IS. THE GOVERNMENT MAKES NO EXPRESS OR IMPLIED
-- WARRANTY AS TO ANY MATTER WHATSOEVER, INCLUDING THE CONDITIONS OF THE
-- SOFTWARE, DOCUMENTATION OR OTHER INFORMATION RELEASED, MADE AVAILABLE
-- OR DISCLOSED, OR THE OWNERSHIP, MERCHANTABILITY, OR FITNESS FOR A
-- PARTICULAR PURPOSE OF SAID MATERIAL.
--*
--
-- OBJECTIVE:
-- Check that a requeue is not canceled and that the requeueing
-- task is unaffected when a calling task is aborted. Check that the
-- abort is deferred until the entry call is complete.
-- Specifically, check requeue to an entry in a different task,
-- requeue where the entry call has parameters, and requeue
-- without the abort option.
--
-- TEST DESCRIPTION
-- In the Driver create a task that places a call on the
-- Distributor. In the Distributor requeue this call on the Credit task.
-- Abort the calling task when it is known to be in rendezvous with the
-- Credit task. (We arrange this by using artificial synchronization
-- points in the Driver and the accept body of the Credit task) Ensure
-- that the abort is deferred (the task is not terminated) until the
-- accept body completes. Afterwards, send one extra message through
-- the Distributor to check that the requeueing task has not been
-- disrupted.
--
-- This series of tests uses a simulation of a transaction driven
-- processing system. Line Drivers accept input from an external source
-- and build them into transaction records. These records are then
-- encapsulated in message tasks which remain extant for the life of the
-- transaction in the system. The message tasks put themselves on the
-- input queue of a Distributor which, from information in the
-- transaction and/or system load conditions forwards them to other
-- operating tasks. These in turn might forward the transactions to yet
-- other tasks for further action. The routing is, in real life, dynamic
-- and unpredictable at the time of message generation. All rerouting in
-- this model is done by means of requeues.
--
--
-- CHANGE HISTORY:
-- 06 Dec 94 SAIC ACVC 2.0
-- 25 Nov 95 SAIC Replaced global variables with protected objects
-- for ACVC 2.0.1.
--
--!
with Report;
with ImpDef;
procedure C954014 is
-- Arbitrary test values
Credit_Return : constant := 1;
Debit_Return : constant := 2;
protected type Shared_Boolean (Initial_Value : Boolean := False) is
procedure Set_True;
procedure Set_False;
function Value return Boolean;
private
Current_Value : Boolean := Initial_Value;
end Shared_Boolean;
protected body Shared_Boolean is
procedure Set_True is
begin
Current_Value := True;
end Set_True;
procedure Set_False is
begin
Current_Value := False;
end Set_False;
function Value return Boolean is
begin
return Current_Value;
end Value;
end Shared_Boolean;
TC_Debit_Message_Complete : Shared_Boolean (False);
-- Synchronization flags for handshaking between the Line_Driver
-- and the Accept body in the Credit Task
TC_Handshake_A : Shared_Boolean (False);
TC_Handshake_B : Shared_Boolean (False);
TC_Handshake_C : Shared_Boolean (False);
TC_Handshake_D : Shared_Boolean (False);
TC_Handshake_E : Shared_Boolean (False);
TC_Handshake_F : Shared_Boolean (False);
type Transaction_Code is (Credit, Debit);
type Transaction_Record;
type acc_Transaction_Record is access Transaction_Record;
type Transaction_Record is
record
ID : integer := 0;
Code : Transaction_Code := Debit;
Account_Number : integer := 0;
Stock_Number : integer := 0;
Quantity : integer := 0;
Return_Value : integer := 0;
TC_Message_Count : integer := 0;
TC_Thru_Distrib : Boolean;
end record;
task type Message_Task is
entry Accept_Transaction (In_Transaction : acc_Transaction_Record);
end Message_Task;
type acc_Message_Task is access Message_Task;
task Line_Driver is
entry start;
end Line_Driver;
task Distributor is
entry Input(Transaction : acc_Transaction_Record);
end Distributor;
task Credit_Computation is
entry Input(Transaction : acc_Transaction_Record);
end Credit_Computation;
task Debit_Computation is
entry Input(Transaction : acc_Transaction_Record);
end Debit_Computation;
-- Assemble messages received from an external source
-- Creates a message task for each. The message tasks remain extant
-- for the life of the messages in the system.
-- TC: The Line Driver task would normally be designed to loop
-- continuously creating the messages as input is received. Simulate
-- this but limit it to two dummy messages for this test and use
-- special artificial handshaking checks with the Credit accept body
-- to control the test. Allow it to terminate at the end
--
task body Line_Driver is
Current_ID : integer := 1;
TC_First_message_sent: Boolean := false;
procedure Build_Credit_Record
( Next_Transaction : acc_Transaction_Record ) is
Dummy_Account : constant integer := 100;
begin
Next_Transaction.ID := Current_ID;
Next_Transaction.Code := Credit;
Next_Transaction.Account_Number := Dummy_Account;
Current_ID := Current_ID + 1;
end Build_Credit_Record;
procedure Build_Debit_Record
( Next_Transaction : acc_Transaction_Record ) is
Dummy_Account : constant integer := 200;
begin
Next_Transaction.ID := Current_ID;
Next_Transaction.Code := Debit;
Next_Transaction.Account_Number := Dummy_Account;
Current_ID := Current_ID + 1;
end Build_Debit_Record;
begin
accept Start; -- Wait for trigger from main
for i in 1..2 loop -- TC: arbitrarily limit to one credit message
-- and one debit, then complete
declare
-- Create a task for the next message
Next_Message_Task : acc_Message_Task := new Message_Task;
-- Create a record for it
Next_Transaction : acc_Transaction_Record :=
new Transaction_Record;
begin
if not TC_First_Message_Sent then
-- send out the first message which will be aborted
Build_Credit_Record ( Next_Transaction );
Next_Message_Task.Accept_Transaction ( Next_Transaction );
TC_First_Message_Sent := true;
-- Wait for Credit task to get into the accept body
-- The call from the Message Task has been requeued by
-- the distributor
while not TC_Handshake_A.Value loop
delay ImpDef.Minimum_Task_Switch;
end loop;
-- Abort the calling task; the Credit task is guaranteed to
-- be in the accept body
abort Next_Message_Task.all; -- We are still in this declare
-- block
-- Inform the Credit task that the abort has been initiated
TC_Handshake_B.Set_True;
-- Now wait for the "acknowledgment" from the Credit task
-- this ensures a complete task switch (at least)
while not TC_Handshake_C.Value loop
delay ImpDef.Minimum_Task_Switch;
end loop;
-- The aborted task must not terminate till the accept body
-- has completed
if Next_Message_Task'terminated then
Report.Failed ("The abort was not deferred");
end if;
-- Inform the Credit task that the termination has been checked
TC_Handshake_D.Set_True;
-- Now wait for the completion of the accept body in the
-- Credit task
while not TC_Handshake_E.Value loop
delay ImpDef.Minimum_Task_Switch;
end loop;
while not ( Next_Message_Task'terminated ) loop
delay ImpDef.Minimum_Task_Switch;
end loop;
-- Indicate to the Main program that this section is complete
TC_Handshake_F.Set_True;
else
-- The main part of the test is complete. Send one Debit message
-- as further exercise of the Distributor to ensure it has not
-- been affected by the abort of the requeue;
Build_Debit_Record ( Next_Transaction );
Next_Message_Task.Accept_Transaction ( Next_Transaction );
end if;
end; -- declare
end loop;
exception
when others =>
Report.Failed ("Unexpected exception in Line_Driver");
end Line_Driver;
task body Message_Task is
TC_Original_Transaction_Code : Transaction_Code;
This_Transaction : acc_Transaction_Record := new Transaction_Record;
begin
accept Accept_Transaction (In_Transaction : acc_Transaction_Record) do
This_Transaction.all := In_Transaction.all;
end Accept_Transaction;
-- Note the original code to ensure correct return
TC_Original_Transaction_Code := This_Transaction.Code;
-- Queue up on Distributor's Input queue
Distributor.Input ( This_Transaction );
-- This task will now wait for the requeued rendezvous
-- to complete before proceeding
-- After the required computations have been performed
-- return the Transaction_Record appropriately (probably to an output
-- line driver)
null; -- stub
-- For the test check that the return values are as expected
if TC_Original_Transaction_Code /= This_Transaction.Code then
-- Incorrect rendezvous
Report.Failed ("Message Task: Incorrect code returned");
end if;
if This_Transaction.Code = Credit then
-- The only Credit message was the one that should have been aborted
Report.Failed ("Abort was not effective");
else
if This_Transaction.Return_Value /= Debit_Return or
This_Transaction.TC_Message_Count /= 1 or not
This_Transaction.TC_Thru_Distrib then
Report.Failed ("Expected path not traversed");
end if;
TC_Debit_Message_Complete.Set_True;
end if;
exception
when others =>
Report.Failed ("Unexpected exception in Message_Task");
end Message_Task;
-- Dispose each input Transaction_Record to the appropriate
-- computation tasks
--
task body Distributor is
begin
loop
select
accept Input (Transaction : acc_Transaction_Record) do
-- Indicate that the message did pass through the
-- Distributor Task
Transaction.TC_Thru_Distrib := true;
-- Pass this transaction on the appropriate computation
-- task
case Transaction.Code is
when Credit =>
requeue Credit_Computation.Input; -- without abort
when Debit =>
requeue Debit_Computation.Input; -- without abort
end case;
end Input;
or
terminate;
end select;
end loop;
exception
when others =>
Report.Failed ("Unexpected exception in Distributor");
end Distributor;
-- Computation task.
-- Note: After the computation is performed in this task and the
-- accept body is completed the rendezvous in the original
-- message task is completed.
task body Credit_Computation is
Message_Count : integer := 0;
begin
loop
select
accept Input ( Transaction : acc_Transaction_Record) do
-- Perform the computations required for this transaction
--
null; -- stub
-- The rest of this code is for Test Control
--
if not Transaction.TC_Thru_Distrib then
Report.Failed
("Credit Task: Wrong queue, Distributor bypassed");
end if;
if Transaction.code /= Credit then
Report.Failed
("Credit Task: Requeue delivered to the wrong queue");
end if;
-- for the test plug a known value and count
Transaction.Return_Value := Credit_Return;
-- one, and only one message should pass through
if Message_Count /= 0 then
Report.Failed ("Aborted Requeue was not canceled -1");
end if;
Message_Count := Message_Count + 1;
Transaction.TC_Message_Count := Message_Count;
-- Having done the basic housekeeping we now need to signal
-- that we are in the accept body of the credit task. The
-- message has arrived and the Line Driver may now abort the
-- calling task
TC_Handshake_A.Set_True;
-- Now wait for the Line Driver to inform us the calling
-- task has been aborted
while not TC_Handshake_B.Value loop
delay ImpDef.Minimum_Task_Switch;
end loop;
-- The abort has taken place
-- Inform the Line Driver that we are still running in the
-- accept body
TC_Handshake_C.Set_True;
-- Now wait for the Line Driver to digest this information
while not TC_Handshake_D.Value loop
delay ImpDef.Minimum_Task_Switch;
end loop;
-- The Line driver has checked that the caller is not terminated
-- We can now complete the accept
end Input;
-- We are out of the accept
TC_Handshake_E.Set_True;
or
terminate;
end select;
end loop;
exception
when others =>
Report.Failed ("Unexpected exception in Credit_Computation");
end Credit_Computation;
-- Computation task.
-- Note: After the computation is performed in this task and the
-- accept body is completed the rendezvous in the original
-- message task is completed.
task body Debit_Computation is
Message_Count : integer := 0;
begin
loop
select
accept Input (Transaction : acc_Transaction_Record) do
-- Perform the computations required for this message
--
null; -- stub
-- The rest of this code is for Test Control
--
if not Transaction.TC_Thru_Distrib then
Report.Failed
("Debit Task: Wrong queue, Distributor bypassed");
end if;
if Transaction.code /= Debit then
Report.Failed
("Debit Task: Requeue delivered to the wrong queue");
end if;
-- for the test plug a known value and count
Transaction.Return_Value := Debit_Return;
-- one, and only one, message should pass through
Message_Count := Message_Count + 1;
Transaction.TC_Message_Count := Message_Count;
end Input;
or
terminate;
end select;
end loop;
exception
when others =>
Report.Failed ("Unexpected exception in Debit_Computation");
end Debit_Computation;
begin -- c954014
Report.Test ("C954014", "Abort a task that has a call" &
" requeued_without_abort");
Line_Driver.Start; -- Start the test
-- Wait for the message tasks to complete before reporting the result
--
while not (TC_Handshake_F.Value -- abort not effective?
and TC_Debit_Message_Complete.Value -- Distributor affected?
and TC_Handshake_E.Value ) loop -- accept not completed?
delay ImpDef.Minimum_Task_Switch;
end loop;
Report.Result;
end C954014;
Go to most recent revision | Compare with Previous | Blame | View Log