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
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
|
.. _debugger-exceptionpoint-list:
Exception Point Debugger Commands
=================================
:ref:`debugger-command-epset`
sets a new exception point
:ref:`debugger-command-epclear`
clears a specific exception point or all exception points
:ref:`debugger-command-epdisable`
disables a specific exception point or all exception points
:ref:`debugger-command-epenable`
enables a specific exception point or all exception points
:ref:`debugger-command-eplist`
lists exception points
Exception points halt execution and activate the debugger when
a CPU raises a particular exception number.
.. _debugger-command-epset:
epset
-----
**ep[set] <type>[,<condition>[,<action>]]**
Sets a new exception point for exceptions of type **<type>**. The
optional **<condition>** parameter lets you specify an expression that
will be evaluated each time the exception point is hit. If the result
of the expression is true (non-zero), the exception point will actually
halt execution at the start of the exception handler; otherwise,
execution will continue with no notification. The optional **<action>**
parameter provides a command that is executed whenever the exception
point is hit and the **<condition>** is true. Note that you may need to
embed the action within braces ``{ }`` in order to prevent commas and
semicolons from being interpreted as applying to the ``epset`` command
itself.
The numbering of exceptions depends upon the CPU type. Causes of
exceptions may include internally or externally vectored interrupts,
errors occurring within instructions and system calls.
Each exception point that is set is assigned an index which can be used
in other exception point commands to reference this exception point.
Examples:
``ep 2``
Set an exception that will halt execution whenever the visible CPU
raises exception number 2.
Back to :ref:`debugger-exceptionpoint-list`
.. _debugger-command-epclear:
epclear
-------
**epclear [<epnum>[,…]]**
The epclear command clears exception points. If **<epnum>** is
specified, only the requested exception points are cleared, otherwise
all exception points are cleared.
Examples:
``epclear 3``
Clear exception point index 3.
``epclear``
Clear all exception points.
Back to :ref:`debugger-exceptionpoint-list`
.. _debugger-command-epdisable:
epdisable
---------
**epdisable [<epnum>[,…]]**
The epdisable command disables exception points. If **<epnum>** is
specified, only the requested exception points are disabled, otherwise
all exception points are disabled. Note that disabling an exception
point does not delete it, it just temporarily marks the exception
point as inactive.
Examples:
``epdisable 3``
Disable exception point index 3.
``epdisable``
Disable all exception points.
Back to :ref:`debugger-exceptionpoint-list`
.. _debugger-command-epenable:
epenable
--------
**epenable [<epnum>[,…]]**
The epenable command enables exception points. If **<epnum>** is
specified, only the requested exception points are enabled, otherwise
all exception points are enabled.
Examples:
``epenable 3``
Enable exception point index 3.
``epenable``
Enable all exception points.
Back to :ref:`debugger-exceptionpoint-list`
.. _debugger-command-eplist:
eplist
------
**eplist**
The eplist command lists all the current exception points, along with
their index and any conditions or actions attached to them.
Back to :ref:`debugger-exceptionpoint-list`
|