------------------------------------------------------------------------------
|
------------------------------------------------------------------------------
|
-- --
|
-- --
|
-- GNAT RUN-TIME COMPONENTS --
|
-- GNAT RUN-TIME COMPONENTS --
|
-- --
|
-- --
|
-- A D A . E X E C U T I O N _ T I M E . G R O U P _ B U D G E T S --
|
-- A D A . E X E C U T I O N _ T I M E . G R O U P _ B U D G E T S --
|
-- --
|
-- --
|
-- S p e c --
|
-- S p e c --
|
-- --
|
-- --
|
-- This specification is derived from the Ada Reference Manual for use with --
|
-- This specification is derived from the Ada Reference Manual for use with --
|
-- GNAT. In accordance with the copyright of that document, you can freely --
|
-- GNAT. In accordance with the copyright of that document, you can freely --
|
-- copy and modify this specification, provided that if you redistribute a --
|
-- copy and modify this specification, provided that if you redistribute a --
|
-- modified version, any changes that you have made are clearly indicated. --
|
-- modified version, any changes that you have made are clearly indicated. --
|
-- --
|
-- --
|
------------------------------------------------------------------------------
|
------------------------------------------------------------------------------
|
|
|
-- This unit is not implemented in typical GNAT implementations that lie on
|
-- This unit is not implemented in typical GNAT implementations that lie on
|
-- top of operating systems, because it is infeasible to implement in such
|
-- top of operating systems, because it is infeasible to implement in such
|
-- environments.
|
-- environments.
|
|
|
-- If a target environment provides appropriate support for this package,
|
-- If a target environment provides appropriate support for this package,
|
-- then the Unimplemented_Unit pragma should be removed from this spec and
|
-- then the Unimplemented_Unit pragma should be removed from this spec and
|
-- an appropriate body provided.
|
-- an appropriate body provided.
|
|
|
with System;
|
with System;
|
|
|
package Ada.Execution_Time.Group_Budgets is
|
package Ada.Execution_Time.Group_Budgets is
|
pragma Preelaborate;
|
pragma Preelaborate;
|
|
|
pragma Unimplemented_Unit;
|
pragma Unimplemented_Unit;
|
|
|
type Group_Budget is tagged limited private;
|
type Group_Budget is tagged limited private;
|
|
|
type Group_Budget_Handler is access
|
type Group_Budget_Handler is access
|
protected procedure (GB : in out Group_Budget);
|
protected procedure (GB : in out Group_Budget);
|
|
|
type Task_Array is
|
type Task_Array is
|
array (Positive range <>) of Ada.Task_Identification.Task_Id;
|
array (Positive range <>) of Ada.Task_Identification.Task_Id;
|
|
|
Min_Handler_Ceiling : constant System.Any_Priority :=
|
Min_Handler_Ceiling : constant System.Any_Priority :=
|
System.Any_Priority'First;
|
System.Any_Priority'First;
|
-- Initial value is an arbitrary choice ???
|
-- Initial value is an arbitrary choice ???
|
|
|
procedure Add_Task
|
procedure Add_Task
|
(GB : in out Group_Budget;
|
(GB : in out Group_Budget;
|
T : Ada.Task_Identification.Task_Id);
|
T : Ada.Task_Identification.Task_Id);
|
|
|
procedure Remove_Task
|
procedure Remove_Task
|
(GB : in out Group_Budget;
|
(GB : in out Group_Budget;
|
T : Ada.Task_Identification.Task_Id);
|
T : Ada.Task_Identification.Task_Id);
|
|
|
function Is_Member
|
function Is_Member
|
(GB : Group_Budget;
|
(GB : Group_Budget;
|
T : Ada.Task_Identification.Task_Id) return Boolean;
|
T : Ada.Task_Identification.Task_Id) return Boolean;
|
|
|
function Is_A_Group_Member
|
function Is_A_Group_Member
|
(T : Ada.Task_Identification.Task_Id) return Boolean;
|
(T : Ada.Task_Identification.Task_Id) return Boolean;
|
|
|
function Members (GB : Group_Budget) return Task_Array;
|
function Members (GB : Group_Budget) return Task_Array;
|
|
|
procedure Replenish
|
procedure Replenish
|
(GB : in out Group_Budget;
|
(GB : in out Group_Budget;
|
To : Ada.Real_Time.Time_Span);
|
To : Ada.Real_Time.Time_Span);
|
|
|
procedure Add
|
procedure Add
|
(GB : in out Group_Budget;
|
(GB : in out Group_Budget;
|
Interval : Ada.Real_Time.Time_Span);
|
Interval : Ada.Real_Time.Time_Span);
|
|
|
function Budget_Has_Expired (GB : Group_Budget) return Boolean;
|
function Budget_Has_Expired (GB : Group_Budget) return Boolean;
|
|
|
function Budget_Remaining
|
function Budget_Remaining
|
(GB : Group_Budget) return Ada.Real_Time.Time_Span;
|
(GB : Group_Budget) return Ada.Real_Time.Time_Span;
|
|
|
procedure Set_Handler
|
procedure Set_Handler
|
(GB : in out Group_Budget;
|
(GB : in out Group_Budget;
|
Handler : Group_Budget_Handler);
|
Handler : Group_Budget_Handler);
|
|
|
function Current_Handler (GB : Group_Budget) return Group_Budget_Handler;
|
function Current_Handler (GB : Group_Budget) return Group_Budget_Handler;
|
|
|
procedure Cancel_Handler
|
procedure Cancel_Handler
|
(GB : in out Group_Budget;
|
(GB : in out Group_Budget;
|
Cancelled : out Boolean);
|
Cancelled : out Boolean);
|
|
|
Group_Budget_Error : exception;
|
Group_Budget_Error : exception;
|
|
|
private
|
private
|
type Group_Budget is tagged limited null record;
|
type Group_Budget is tagged limited null record;
|
end Ada.Execution_Time.Group_Budgets;
|
end Ada.Execution_Time.Group_Budgets;
|
|
|
