1------------------------------------------------------------------------------
2--                                                                          --
3--                 GNAT RUN-TIME LIBRARY (GNARL) COMPONENTS                 --
4--                                                                          --
5--                         S Y S T E M . T R A C E S                        --
6--                                                                          --
7--                                  S p e c                                 --
8--                                                                          --
9--          Copyright (C) 2001-2009, Free Software Foundation, Inc.         --
10--                                                                          --
11-- GNARL 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 3,  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.                                     --
17--                                                                          --
18-- As a special exception under Section 7 of GPL version 3, you are granted --
19-- additional permissions described in the GCC Runtime Library Exception,   --
20-- version 3.1, as published by the Free Software Foundation.               --
21--                                                                          --
22-- You should have received a copy of the GNU General Public License and    --
23-- a copy of the GCC Runtime Library Exception along with this program;     --
24-- see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see    --
25-- <http://www.gnu.org/licenses/>.                                          --
26--                                                                          --
27-- GNAT was originally developed  by the GNAT team at  New York University. --
28-- Extensive contributions were provided by Ada Core Technologies Inc.      --
29--                                                                          --
30------------------------------------------------------------------------------
31
32--  This package implements functions for traces when tasking is not involved
33
34--  Warning : NO dependencies to tasking should be created here
35
36--  This package, and all its children are used to implement debug
37--  informations
38
39--  A new primitive, Send_Trace_Info (Id : Trace_T; 'data') is introduced.
40--  Trace_T is an event identifier, 'data' are the informations to pass
41--  with the event. This procedure is used from within the Runtime to send
42--  debug informations.
43
44--  This primitive is overloaded in System.Traces.Tasking and this package
45
46--  Send_Trace_Info calls Send_Trace, in System.Traces.Send, which is target
47--  dependent, to send the debug informations to a debugger, stream ..
48
49--  To add a new event, just add them to the Trace_T type, and write the
50--  corresponding Send_Trace_Info procedure. It may be required for some
51--  target to modify Send_Trace (e.g. VxWorks).
52
53--  To add a new target, just adapt System.Traces.Send to your own purposes
54
55package System.Traces is
56   pragma Preelaborate;
57
58   type Trace_T is
59     (
60      --  Events handled
61
62      --  Messages
63
64      M_Accept_Complete,
65      M_Select_Else,
66      M_RDV_Complete,
67      M_Call_Complete,
68      M_Delay,
69
70      --  Errors
71
72      E_Missed,
73      E_Timeout,
74      E_Kill,
75
76      --  Waiting events
77
78      W_Call,
79      W_Accept,
80      W_Select,
81      W_Completion,
82      W_Delay,
83      WU_Delay,
84
85      WT_Call,
86      WT_Select,
87      WT_Completion,
88
89      --  Protected objects events
90
91      PO_Call,
92      POT_Call,
93      PO_Run,
94      PO_Lock,
95      PO_Unlock,
96      PO_Done,
97
98      --  Task handling events
99
100      T_Create,
101      T_Activate,
102      T_Abort,
103      T_Terminate);
104
105   --  Send_Trace_Info procedures
106
107   --  They are overloaded, depending on the parameters passed with
108   --  the event, e.g. Time information, Task name, Accept name ...
109
110   procedure Send_Trace_Info (Id : Trace_T);
111
112   procedure Send_Trace_Info (Id : Trace_T; Timeout : Duration);
113
114end System.Traces;
115