1 ------------------------------------------------------------------------------
3 -- GNAT COMPILER COMPONENTS --
5 -- S Y S T E M . T A S K _ I N F O --
9 -- Copyright (C) 1992-2003 Free Software Foundation, Inc. --
11 -- GNAT is free software; you can redistribute it and/or modify it under --
12 -- terms of the GNU General Public License as published by the Free Soft- --
13 -- ware Foundation; either version 2, or (at your option) any later ver- --
14 -- sion. GNAT is distributed in the hope that it will be useful, but WITH- --
15 -- OUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY --
16 -- or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License --
17 -- for more details. You should have received a copy of the GNU General --
18 -- Public License distributed with GNAT; see file COPYING. If not, write --
19 -- to the Free Software Foundation, 59 Temple Place - Suite 330, Boston, --
20 -- MA 02111-1307, USA. --
22 -- As a special exception, if other files instantiate generics from this --
23 -- unit, or you link this unit with other files to produce an executable, --
24 -- this unit does not by itself cause the resulting executable to be --
25 -- covered by the GNU General Public License. This exception does not --
26 -- however invalidate any other reasons why the executable file might be --
27 -- covered by the GNU Public License. --
29 -- GNAT was originally developed by the GNAT team at New York University. --
30 -- Extensive contributions were provided by Ada Core Technologies Inc. --
32 ------------------------------------------------------------------------------
34 -- This package contains the definitions and routines associated with the
35 -- implementation and use of the Task_Info pragma. It is specialized
36 -- appropriately for targets that make use of this pragma.
38 -- Note: the compiler generates direct calls to this interface, via Rtsfind.
39 -- Any changes to this interface may require corresponding compiler changes.
41 -- This unit may be used directly from an application program by providing
42 -- an appropriate WITH, and the interface can be expected to remain stable.
44 -- This is the IRIX (kernel threads) version of this package
47 with System
.OS_Interface
;
49 package System
.Task_Info
is
50 pragma Elaborate_Body
;
51 -- To ensure that a body is allowed
53 package OSI
renames System
.OS_Interface
;
55 -----------------------------------------
56 -- Implementation of Task_Info Feature --
57 -----------------------------------------
59 -- Pragma Task_Info allows an application to set the underlying
60 -- pthread scheduling attributes for a specific task.
66 type Thread_Scheduling_Scope
is
67 (PTHREAD_SCOPE_PROCESS
, PTHREAD_SCOPE_SYSTEM
);
69 for Thread_Scheduling_Scope
'Size use Interfaces
.C
.int
'Size;
71 type Thread_Scheduling_Inheritance
is
72 (PTHREAD_EXPLICIT_SCHED
, PTHREAD_INHERIT_SCHED
);
74 for Thread_Scheduling_Inheritance
'Size use Interfaces
.C
.int
'Size;
76 type Thread_Scheduling_Policy
is
77 (SCHED_FIFO
, -- The first-in-first-out real-time policy
78 SCHED_RR
, -- The round-robin real-time scheduling policy
79 SCHED_TS
); -- The timeshare earnings based scheduling policy
81 for Thread_Scheduling_Policy
'Size use Interfaces
.C
.int
'Size;
82 for Thread_Scheduling_Policy
use
87 function SCHED_OTHER
return Thread_Scheduling_Policy
renames SCHED_TS
;
89 No_Specified_Priority
: constant := -1;
91 subtype Thread_Scheduling_Priority
is Integer range
92 No_Specified_Priority
.. 255;
94 function Min
(Policy
: Interfaces
.C
.int
) return Interfaces
.C
.int
95 renames OSI
.sched_get_priority_min
;
97 function Max
(Policy
: Interfaces
.C
.int
) return Interfaces
.C
.int
98 renames OSI
.sched_get_priority_max
;
100 subtype FIFO_Priority
is Thread_Scheduling_Priority
range
101 Thread_Scheduling_Priority
(Min
(OSI
.SCHED_FIFO
)) ..
102 Thread_Scheduling_Priority
(Max
(OSI
.SCHED_FIFO
));
104 subtype RR_Priority
is Thread_Scheduling_Priority
range
105 Thread_Scheduling_Priority
(Min
(OSI
.SCHED_RR
)) ..
106 Thread_Scheduling_Priority
(Max
(OSI
.SCHED_RR
));
108 subtype TS_Priority
is Thread_Scheduling_Priority
range
109 Thread_Scheduling_Priority
(Min
(OSI
.SCHED_TS
)) ..
110 Thread_Scheduling_Priority
(Max
(OSI
.SCHED_TS
));
112 subtype OTHER_Priority
is Thread_Scheduling_Priority
range
113 Thread_Scheduling_Priority
(Min
(OSI
.SCHED_OTHER
)) ..
114 Thread_Scheduling_Priority
(Max
(OSI
.SCHED_OTHER
));
116 subtype CPU_Number
is Integer range -1 .. Integer'Last;
117 ANY_CPU
: constant CPU_Number
:= CPU_Number
'First;
119 type Thread_Attributes
is record
120 Scope
: Thread_Scheduling_Scope
:= PTHREAD_SCOPE_PROCESS
;
121 Inheritance
: Thread_Scheduling_Inheritance
:= PTHREAD_EXPLICIT_SCHED
;
122 Policy
: Thread_Scheduling_Policy
:= SCHED_RR
;
123 Priority
: Thread_Scheduling_Priority
:= No_Specified_Priority
;
124 Runon_CPU
: CPU_Number
:= ANY_CPU
;
127 Default_Thread_Attributes
: constant Thread_Attributes
:=
128 (PTHREAD_SCOPE_PROCESS
, PTHREAD_EXPLICIT_SCHED
, SCHED_RR
,
129 No_Specified_Priority
, ANY_CPU
);
131 type Task_Info_Type
is access all Thread_Attributes
;
133 Unspecified_Task_Info
: constant Task_Info_Type
:= null;
134 -- Value passed to task in the absence of a Task_Info pragma
136 end System
.Task_Info
;