old-autovect-branch/gcc/ada/s-osinte-vxworks.ads

   1 ------------------------------------------------------------------------------
   2 --                                                                          --
   3 --                  GNAT RUN-TIME LIBRARY (GNARL) COMPONENTS                --
   4 --                                                                          --
   5 --                    S Y S T E M . O S _ I N T E R F A C E                 --
   6 --                                                                          --
   7 --                                   S p e c                                --
   8 --                                                                          --
   9 --             Copyright (C) 1991-1994, Florida State University            --
  10 --             Copyright (C) 1995-2005, Free Software Foundation, Inc.      --
  11 --                                                                          --
  12 -- GNARL is free software; you can  redistribute it  and/or modify it under --
  13 -- terms of the  GNU General Public License as published  by the Free Soft- --
  14 -- ware  Foundation;  either version 2,  or (at your option) any later ver- --
  15 -- sion. GNARL is distributed in the hope that it will be useful, but WITH- --
  16 -- OUT ANY WARRANTY;  without even the  implied warranty of MERCHANTABILITY --
  17 -- or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License --
  18 -- for  more details.  You should have  received  a copy of the GNU General --
  19 -- Public License  distributed with GNARL; see file COPYING.  If not, write --
  20 -- to  the  Free Software Foundation,  51  Franklin  Street,  Fifth  Floor, --
  21 -- Boston, MA 02110-1301, USA.                                              --
  22 --                                                                          --
  23 -- As a special exception,  if other files  instantiate  generics from this --
  24 -- unit, or you link  this unit with other files  to produce an executable, --
  25 -- this  unit  does not  by itself cause  the resulting  executable  to  be --
  26 -- covered  by the  GNU  General  Public  License.  This exception does not --
  27 -- however invalidate  any other reasons why  the executable file  might be --
  28 -- covered by the  GNU Public License.                                      --
  29 --                                                                          --
  30 -- GNARL was developed by the GNARL team at Florida State University.       --
  31 -- Extensive contributions were provided by Ada Core Technologies, Inc.     --
  32 --                                                                          --
  33 ------------------------------------------------------------------------------
  34
  35 --  This is the VxWorks version of this package
  36
  37 --  This package encapsulates all direct interfaces to OS services
  38 --  that are needed by children of System.
  39
  40 --  PLEASE DO NOT add any with-clauses to this package or remove the pragma
  41 --  Preelaborate. This package is designed to be a bottom-level (leaf) package.
  42
  43 with Interfaces.C;
  44 with System.VxWorks;
  45
  46 package System.OS_Interface is
  47    pragma Preelaborate;
  48
  49    subtype int        is Interfaces.C.int;
  50    subtype short      is Short_Integer;
  51    type long          is new Long_Integer;
  52    type unsigned_long is mod 2 ** long'Size;
  53    type size_t        is mod 2 ** Standard'Address_Size;
  54
  55    -----------
  56    -- Errno --
  57    -----------
  58
  59    function errno return int;
  60    pragma Import (C, errno, "errnoGet");
  61
  62    EINTR     : constant := 4;
  63    EAGAIN    : constant := 35;
  64    ENOMEM    : constant := 12;
  65    EINVAL    : constant := 22;
  66    ETIMEDOUT : constant := 60;
  67
  68    FUNC_ERR  : constant := -1;
  69
  70    ----------------------------
  71    -- Signals and Interrupts --
  72    ----------------------------
  73
  74    NSIG : constant := 32;
  75    --  Number of signals on the target OS
  76    type Signal is new int range 0 .. Interfaces.C."-" (NSIG, 1);
  77
  78    Max_HW_Interrupt : constant := System.VxWorks.Num_HW_Interrupts - 1;
  79    type HW_Interrupt is new int range 0 .. Max_HW_Interrupt;
  80
  81    Max_Interrupt : constant := Max_HW_Interrupt;
  82
  83    SIGILL  : constant :=  4; --  illegal instruction (not reset)
  84    SIGABRT : constant :=  6; --  used by abort, replace SIGIOT in the future
  85    SIGFPE  : constant :=  8; --  floating point exception
  86    SIGBUS  : constant := 10; --  bus error
  87    SIGSEGV : constant := 11; --  segmentation violation
  88
  89    -----------------------------------
  90    -- Signal processing definitions --
  91    -----------------------------------
  92
  93    --  The how in sigprocmask().
  94    SIG_BLOCK   : constant := 1;
  95    SIG_UNBLOCK : constant := 2;
  96    SIG_SETMASK : constant := 3;
  97
  98    --  The sa_flags in struct sigaction.
  99    SA_SIGINFO   : constant := 16#0002#;
 100    SA_ONSTACK   : constant := 16#0004#;
 101
 102    SIG_DFL : constant := 0;
 103    SIG_IGN : constant := 1;
 104
 105    type sigset_t is private;
 106
 107    type struct_sigaction is record
 108       sa_handler : System.Address;
 109       sa_mask    : sigset_t;
 110       sa_flags   : int;
 111    end record;
 112    pragma Convention (C, struct_sigaction);
 113    type struct_sigaction_ptr is access all struct_sigaction;
 114
 115    function sigaddset (set : access sigset_t; sig : Signal) return int;
 116    pragma Import (C, sigaddset, "sigaddset");
 117
 118    function sigdelset (set : access sigset_t; sig : Signal) return int;
 119    pragma Import (C, sigdelset, "sigdelset");
 120
 121    function sigfillset (set : access sigset_t) return int;
 122    pragma Import (C, sigfillset, "sigfillset");
 123
 124    function sigismember (set : access sigset_t; sig : Signal) return int;
 125    pragma Import (C, sigismember, "sigismember");
 126
 127    function sigemptyset (set : access sigset_t) return int;
 128    pragma Import (C, sigemptyset, "sigemptyset");
 129
 130    function sigaction
 131      (sig  : Signal;
 132       act  : struct_sigaction_ptr;
 133       oact : struct_sigaction_ptr) return int;
 134    pragma Import (C, sigaction, "sigaction");
 135
 136    type isr_address is access procedure (sig : int);
 137
 138    function c_signal (sig : Signal; handler : isr_address) return isr_address;
 139    pragma Import (C, c_signal, "signal");
 140
 141    function sigwait (set : access sigset_t; sig : access Signal) return int;
 142    pragma Inline (sigwait);
 143
 144    type sigset_t_ptr is access all sigset_t;
 145
 146    function pthread_sigmask
 147      (how  : int;
 148       set  : sigset_t_ptr;
 149       oset : sigset_t_ptr) return int;
 150    pragma Import (C, pthread_sigmask, "sigprocmask");
 151
 152    type t_id is new long;
 153    subtype Thread_Id is t_id;
 154
 155    function kill (pid : t_id; sig : Signal) return int;
 156    pragma Inline (kill);
 157
 158    function getpid return t_id;
 159    pragma Import (C, getpid, "taskIdSelf");
 160    --  VxWorks doesn't have getpid; taskIdSelf is the equivalent routine.
 161
 162    ----------
 163    -- Time --
 164    ----------
 165
 166    type time_t is new unsigned_long;
 167
 168    type timespec is record
 169       ts_sec  : time_t;
 170       ts_nsec : long;
 171    end record;
 172    pragma Convention (C, timespec);
 173
 174    type clockid_t is private;
 175
 176    CLOCK_REALTIME : constant clockid_t;   --  System wide realtime clock
 177
 178    function To_Duration (TS : timespec) return Duration;
 179    pragma Inline (To_Duration);
 180
 181    function To_Timespec (D : Duration) return timespec;
 182    pragma Inline (To_Timespec);
 183
 184    function To_Clock_Ticks (D : Duration) return int;
 185    --  Convert a duration value (in seconds) into clock ticks
 186
 187    function clock_gettime
 188      (clock_id : clockid_t; tp : access timespec) return int;
 189    pragma Import (C, clock_gettime, "clock_gettime");
 190
 191    type ULONG is new unsigned_long;
 192
 193    procedure tickSet (ticks : ULONG);
 194    pragma Import (C, tickSet, "tickSet");
 195
 196    function tickGet return ULONG;
 197    pragma Import (C, tickGet, "tickGet");
 198
 199    ----------------------
 200    -- Utility Routines --
 201    ----------------------
 202
 203    function To_VxWorks_Priority (Priority : in int) return int;
 204    pragma Inline (To_VxWorks_Priority);
 205    --  Convenience routine to convert between VxWorks priority and Ada priority
 206
 207    --------------------------
 208    -- VxWorks specific API --
 209    --------------------------
 210
 211    subtype STATUS is int;
 212    --  Equivalent of the C type STATUS
 213
 214    OK    : constant STATUS := 0;
 215    ERROR : constant STATUS := Interfaces.C.int (-1);
 216
 217    function taskIdVerify (tid : t_id)  return STATUS;
 218    pragma Import (C, taskIdVerify, "taskIdVerify");
 219
 220    function taskIdSelf return t_id;
 221    pragma Import (C, taskIdSelf, "taskIdSelf");
 222
 223    function taskSuspend (tid : t_id) return int;
 224    pragma Import (C, taskSuspend, "taskSuspend");
 225
 226    function taskResume (tid : t_id) return int;
 227    pragma Import (C, taskResume, "taskResume");
 228
 229    function taskIsSuspended (tid : t_id) return int;
 230    pragma Import (C, taskIsSuspended, "taskIsSuspended");
 231
 232    function taskDelay (ticks : int) return int;
 233    procedure taskDelay (ticks : int);
 234    pragma Import (C, taskDelay, "taskDelay");
 235
 236    function sysClkRateGet return int;
 237    pragma Import (C, sysClkRateGet, "sysClkRateGet");
 238
 239    --  VxWorks 5.x specific functions
 240
 241    function taskVarAdd
 242      (tid : t_id; pVar : access System.Address) return int;
 243    pragma Import (C, taskVarAdd, "taskVarAdd");
 244
 245    function taskVarDelete
 246      (tid : t_id; pVar : access System.Address) return int;
 247    pragma Import (C, taskVarDelete, "taskVarDelete");
 248
 249    function taskVarSet
 250      (tid   : t_id;
 251       pVar  : access System.Address;
 252       value : System.Address) return int;
 253    pragma Import (C, taskVarSet, "taskVarSet");
 254
 255    function taskVarGet
 256      (tid  : t_id;
 257       pVar : access System.Address) return int;
 258    pragma Import (C, taskVarGet, "taskVarGet");
 259
 260    --  VxWorks 6.x specific functions
 261
 262    function tlsKeyCreate return int;
 263    pragma Import (C, tlsKeyCreate, "tlsKeyCreate");
 264
 265    function tlsValueGet (key : int) return System.Address;
 266    pragma Import (C, tlsValueGet, "tlsValueGet");
 267
 268    function tlsValueSet (key : int; value : System.Address) return STATUS;
 269    pragma Import (C, tlsValueSet, "tlsValueSet");
 270
 271    --  Option flags for taskSpawn
 272
 273    VX_UNBREAKABLE    : constant := 16#0002#;
 274    VX_FP_PRIVATE_ENV : constant := 16#0080#;
 275    VX_NO_STACK_FILL  : constant := 16#0100#;
 276
 277    function VX_FP_TASK return int;
 278    pragma Inline (VX_FP_TASK);
 279
 280    function taskSpawn
 281      (name          : System.Address;  --  Pointer to task name
 282       priority      : int;
 283       options       : int;
 284       stacksize     : size_t;
 285       start_routine : System.Address;
 286       arg1          : System.Address;
 287       arg2          : int := 0;
 288       arg3          : int := 0;
 289       arg4          : int := 0;
 290       arg5          : int := 0;
 291       arg6          : int := 0;
 292       arg7          : int := 0;
 293       arg8          : int := 0;
 294       arg9          : int := 0;
 295       arg10         : int := 0) return t_id;
 296    pragma Import (C, taskSpawn, "taskSpawn");
 297
 298    procedure taskDelete (tid : t_id);
 299    pragma Import (C, taskDelete, "taskDelete");
 300
 301    function Set_Time_Slice (ticks : int) return int;
 302    pragma Inline (Set_Time_Slice);
 303    --  Calls kernelTimeSlice under VxWorks 5.x
 304    --  Do nothing under VxWorks 6.x
 305
 306    function taskPriorityGet (tid : t_id; pPriority : access int) return int;
 307    pragma Import (C, taskPriorityGet, "taskPriorityGet");
 308
 309    function taskPrioritySet (tid : t_id; newPriority : int) return int;
 310    pragma Import (C, taskPrioritySet, "taskPrioritySet");
 311
 312    --  Semaphore creation flags
 313
 314    SEM_Q_FIFO         : constant := 0;
 315    SEM_Q_PRIORITY     : constant := 1;
 316    SEM_DELETE_SAFE    : constant := 4;  -- only valid for binary semaphore
 317    SEM_INVERSION_SAFE : constant := 8;  -- only valid for binary semaphore
 318
 319    --  Semaphore initial state flags
 320
 321    SEM_EMPTY : constant := 0;
 322    SEM_FULL  : constant := 1;
 323
 324    --  Semaphore take (semTake) time constants
 325
 326    WAIT_FOREVER : constant := -1;
 327    NO_WAIT      : constant := 0;
 328
 329    --  Error codes (errno). The lower level 16 bits are the error code, with
 330    --  the upper 16 bits representing the module number in which the error
 331    --  occurred. By convention, the module number is 0 for UNIX errors. VxWorks
 332    --  reserves module numbers 1-500, with the remaining module numbers being
 333    --  available for user applications.
 334
 335    M_objLib                 : constant := 61 * 2**16;
 336    --  semTake() failure with ticks = NO_WAIT
 337    S_objLib_OBJ_UNAVAILABLE : constant := M_objLib + 2;
 338    --  semTake() timeout with ticks > NO_WAIT
 339    S_objLib_OBJ_TIMEOUT     : constant := M_objLib + 4;
 340
 341    type SEM_ID is new System.Address;
 342    --  typedef struct semaphore *SEM_ID;
 343
 344    --  We use two different kinds of VxWorks semaphores: mutex and binary
 345    --  semaphores. A null ID is returned when a semaphore cannot be created.
 346
 347    function semBCreate (options : int; initial_state : int) return SEM_ID;
 348    pragma Import (C, semBCreate, "semBCreate");
 349    --  Create a binary semaphore. Return ID, or 0 if memory could not
 350    --  be allocated.
 351
 352    function semMCreate (options : int) return SEM_ID;
 353    pragma Import (C, semMCreate, "semMCreate");
 354
 355    function semDelete (Sem : SEM_ID) return int;
 356    pragma Import (C, semDelete, "semDelete");
 357    --  Delete a semaphore
 358
 359    function semGive (Sem : SEM_ID) return int;
 360    pragma Import (C, semGive, "semGive");
 361
 362    function semTake (Sem : SEM_ID; timeout : int) return int;
 363    pragma Import (C, semTake, "semTake");
 364    --  Attempt to take binary semaphore.  Error is returned if operation
 365    --  times out
 366
 367    function semFlush (SemID : SEM_ID) return STATUS;
 368    pragma Import (C, semFlush, "semFlush");
 369    --  Release all threads blocked on the semaphore
 370
 371 private
 372    type sigset_t is new long;
 373
 374    type pid_t is new int;
 375
 376    ERROR_PID : constant pid_t := -1;
 377
 378    type clockid_t is new int;
 379    CLOCK_REALTIME : constant clockid_t := 0;
 380
 381 end System.OS_Interface;