diff options
Diffstat (limited to 'docs/source/debugger/exceptionpoint.rst')
-rw-r--r-- | docs/source/debugger/exceptionpoint.rst | 134 |
1 files changed, 134 insertions, 0 deletions
diff --git a/docs/source/debugger/exceptionpoint.rst b/docs/source/debugger/exceptionpoint.rst new file mode 100644 index 00000000000..46ce7b8d41a --- /dev/null +++ b/docs/source/debugger/exceptionpoint.rst @@ -0,0 +1,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` |