File: posix-process_scheduling.ads

package info (click to toggle)
libflorist 2017-9
  • links: PTS, VCS
  • area: main
  • in suites: bullseye
  • size: 2,212 kB
  • sloc: ada: 11,902; ansic: 7,195; makefile: 137; sh: 18
file content (93 lines) | stat: -rw-r--r-- 5,021 bytes parent folder | download | duplicates (5)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
------------------------------------------------------------------------------
--                                                                          --
--            FLORIST (FSU Implementation of POSIX.5) COMPONENTS            --
--                                                                          --
--              P O S I X . P R O C E S S _ S C H E D U L I N G             --
--                                                                          --
--                                  S p e c                                 --
--                                                                          --
--                                                                          --
--  This  file is a component  of FLORIST,  an implementation of the POSIX  --
--  Ada  bindings  for  use with the GNAT Ada compiler and the FSU Gnu Ada  --
--  Runtime Library (GNARL).                                                --
--                                                                          --
--  This package specification contains some text extracted from  IEEE STD  --
--  1003.5: 1990, Information Technology -- POSIX Ada Language  Interfaces  --
--  Part 1: Binding  for  System Application Program Interface, as amended  --
--  by IEEE STD 1003.5b: 1996, Amendment 1: Realtime Extensions, copyright  --
--  1996 by the Institute of Electrical and Electronics Engineers, Inc.     --
--                                                                          --
--  The package specifications in the IEEE standards cited above represent  --
--  only a  portion  of  the  documents  and  are  not to be interpreteted  --
--  outside the context  of  the documents.  The standards must be used in  --
--  conjunction  with  the  package   specifications  in  order  to  claim  --
--  conformance.   The IEEE takes no responsibility for and will assume no  --
--  liability for damages resulting from the reader's misinterpretation of  --
--  said  information resulting from its out-of-context nature.   To order  --
--  copies of the IEEE standards,  please contact the  IEEE Service Center  --
--  at 445 Hoes Lane, PO Box 1331, Piscataway, NJ 08855-1331; via phone at  --
--  1-800-678-IEEE, 908-981-1393; or via fax at 908-981-9667.               --
--                                                                          --
--  These  package  specifications are  distributed in  the hope that they  --
--  will  be useful, but  WITHOUT  ANY  WARRANTY; without even the implied  --
--  warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.        --
--                                                                          --
------------------------------------------------------------------------------

with POSIX.C,
     POSIX_Process_Identification;
package POSIX.Process_Scheduling is

   subtype Scheduling_Priority is Integer;
   type Scheduling_Parameters is private;
   function Get_Priority (Parameters : Scheduling_Parameters)
     return Scheduling_Priority;
   procedure Set_Priority
     (Parameters : in out Scheduling_Parameters;
      Priority   : Scheduling_Priority);

   type Scheduling_Policy is new Integer;

   --  One might consider auto-configuring
   --  the upper and lower bounds of this range to more tightly fit
   --  the range of values supported by the underlying OS.
   --  However, that would not help much.  For example, LynxOS is
   --  reputed to have the following values:
   --    Sched_Fifo : constant := 2097152;
   --    Sched_Other : constant := 4194304;
   --    Sched_Rr : constant := 1048576;
   --  Also, we should not limit it to the just three values shown below,
   --  because we might want to use these interfaces with implementation
   --  defined policies.

   Sched_FIFO  : constant Scheduling_Policy := POSIX.C.SCHED_FIFO;
   Sched_RR    : constant Scheduling_Policy := POSIX.C.SCHED_RR;
   Sched_Other : constant Scheduling_Policy := POSIX.C.SCHED_OTHER;

   procedure Set_Scheduling_Parameters
     (Process    : POSIX_Process_Identification.Process_ID;
      Parameters : Scheduling_Parameters);
   function Get_Scheduling_Parameters
     (Process : POSIX_Process_Identification.Process_ID)
     return Scheduling_Parameters;
   procedure Set_Scheduling_Policy
     (Process    : POSIX_Process_Identification.Process_ID;
      New_Policy : Scheduling_Policy;
      Parameters : Scheduling_Parameters);
   function Get_Scheduling_Policy
     (Process : POSIX_Process_Identification.Process_ID)
     return Scheduling_Policy;
   procedure Yield;
   function Get_Maximum_Priority (Policy : Scheduling_Policy)
     return Scheduling_Priority;
   function Get_Minimum_Priority (Policy : Scheduling_Policy)
     return Scheduling_Priority;
   function Get_Round_Robin_Interval
     (Process : POSIX_Process_Identification.Process_ID)
     return POSIX.Timespec;

private
   type Scheduling_Parameters is record
      Param : aliased POSIX.C.struct_sched_param;
   end record;
end POSIX.Process_Scheduling;