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:
Exceptionpoint Debugger Commands
================================
:ref:`debugger-command-epset`
sets a new exceptionpoint
:ref:`debugger-command-epclear`
clears a specific exceptionpoint or all exceptionpoints
:ref:`debugger-command-epdisable`
disables a specific exceptionpoint or all exceptionpoints
:ref:`debugger-command-epenable`
enables a specific exceptionpoint or all exceptionpoints
:ref:`debugger-command-eplist`
lists exceptionpoints
Exceptionpoints 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 exceptionpoint for exceptions of type **<type>**. The
optional **<condition>** parameter lets you specify an expression that
will be evaluated each time the exceptionpoint is hit. If the result
of the expression is true (non-zero), the exceptionpoint 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
exceptionpoint 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 exceptionpoint that is set is assigned an index which can be used
in other exceptionpoint commands to reference this exceptionpoint.
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 exceptionpoints. If **<epnum>** is
specified, only the requested exceptionpoints are cleared, otherwise
all exceptionpoints are cleared.
Examples:
``epclear 3``
Clear exceptionpoint index 3.
``epclear``
Clear all exceptionpoints.
Back to :ref:`debugger-exceptionpoint-list`
.. _debugger-command-epdisable:
epdisable
---------
**epdisable [<epnum>[,…]]**
The epdisable command disables exceptionpoints. If **<epnum>** is
specified, only the requested exceptionpoints are disabled, otherwise
all exceptionpoints are disabled. Note that disabling an
exceptionpoint does not delete it, it just temporarily marks the
exceptionpoint as inactive.
Examples:
``epdisable 3``
Disable exceptionpoint index 3.
``epdisable``
Disable all exceptionpoints.
Back to :ref:`debugger-exceptionpoint-list`
.. _debugger-command-epenable:
epenable
--------
**epenable [<epnum>[,…]]**
The epenable command enables exceptionpoints. If **<epnum>** is
specified, only the requested exceptionpoints are enabled, otherwise
all exceptionpoints are enabled.
Examples:
``epenable 3``
Enable exceptionpoint index 3.
``epenable``
Enable all exceptionpoints.
Back to :ref:`debugger-exceptionpoint-list`
.. _debugger-command-eplist:
eplist
------
**eplist**
The eplist command lists all the current exceptionpoints, along with
their index and any conditions or actions attached to them.
Back to :ref:`debugger-exceptionpoint-list`
|