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
|
-- Debugger for interpreter
-- Copyright (C) 2014 Tristan Gingold
--
-- GHDL is free software; you can redistribute it and/or modify it under
-- the terms of the GNU General Public License as published by the Free
-- Software Foundation; either version 2, or (at your option) any later
-- version.
--
-- GHDL is distributed in the hope that it will be useful, but WITHOUT ANY
-- WARRANTY; without even the implied warranty of MERCHANTABILITY or
-- FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
-- for more details.
--
-- You should have received a copy of the GNU General Public License
-- along with GHDL; see the file COPYING. If not, write to the Free
-- Software Foundation, 59 Temple Place - Suite 330, Boston, MA
-- 02111-1307, USA.
with Elaboration; use Elaboration;
with Iirs; use Iirs;
package Debugger is
Flag_Need_Debug : Boolean := False;
-- Disp a message for a constraint error.
-- And raise the exception execution_constraint_error.
procedure Error_Msg_Constraint (Expr: Iir);
pragma No_Return (Error_Msg_Constraint);
-- Disp a message during execution.
procedure Error_Msg_Exec (Msg: String; Loc: Iir);
pragma No_Return (Error_Msg_Exec);
procedure Warning_Msg_Exec (Msg: String; Loc: Iir);
-- Disp a block instance, in a human readable way.
-- Used to debug.
procedure Disp_Block_Instance (Instance: Block_Instance_Acc);
-- Disp the instance tree.
procedure Disp_Instances_Tree;
-- Disp the name of an instance, without newline. The name of
-- architectures is displayed unless Short is True.
procedure Disp_Instance_Name (Instance: Block_Instance_Acc;
Short : Boolean := False);
-- Disp the resulting processes of elaboration.
-- procedure Disp_Processes;
-- Disp the label of PROCESS, or <unlabeled> if PROCESS has no label.
procedure Disp_Label (Process : Iir);
-- Disp all signals name and values.
procedure Disp_Signals_Value;
procedure Disp_Objects_Value;
-- Disp stats about the design (number of process, number of signals...)
procedure Disp_Design_Stats;
-- The reason why the debugger is invoked.
type Debug_Reason is
(-- Called from an external debugger while debugging ghdl.
Reason_Internal_Debug,
-- Interractive session, elaboration not done
Reason_Start,
-- At end of elaboration, for an interractive session
Reason_Elab,
-- Before execution of a statement.
Reason_Break,
-- Assertion failure
Reason_Assert,
-- Non recoverable error occurred (such as index error, overflow...)
Reason_Error
);
Debugger_Quit : exception;
-- Interractive debugger.
procedure Debug (Reason: Debug_Reason);
-- Call the debugger in case of error.
procedure Debug_Error;
end Debugger;
|
