mirror of
https://github.com/libretro/mame.git
synced 2025-04-05 23:21:41 +00:00
b860e736f6
Changed "Exception Points" to "Exceptionpoints" in the debugger documentation and help. This better matches "Watchpoints" and "Registerpoints". Also, it's very confusing that you see the help topic listing showing "Exception Points" but typing "help Exception Points" doesn't actually work. cpu/e132xs: Fixed a flags issue in the recompiler. misc/dgpix.cpp: Demoted The X-Files to not working with unemulated protection. skeleton/turnierdart.cpp: The srcclean on this file was missed.
135 lines
3.4 KiB
ReStructuredText
135 lines
3.4 KiB
ReStructuredText
.. _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`
|