aboutsummaryrefslogtreecommitdiff
path: root/doc/usage/exception.rst
diff options
context:
space:
mode:
Diffstat (limited to 'doc/usage/exception.rst')
-rw-r--r--doc/usage/exception.rst68
1 files changed, 68 insertions, 0 deletions
diff --git a/doc/usage/exception.rst b/doc/usage/exception.rst
new file mode 100644
index 0000000..412a03b
--- /dev/null
+++ b/doc/usage/exception.rst
@@ -0,0 +1,68 @@
+exception command
+=================
+
+Synopsis
+--------
+
+::
+
+ exception <type>
+
+Description
+-----------
+
+The exception command is used to test the handling of exceptions like undefined
+instructions, segmentation faults or alignment faults.
+
+type
+ type of exception to be generated. The available types are architecture
+ dependent. Use 'help exception' to determine which are available.
+
+ **ARM:**
+
+ breakpoint
+ prefetch abort
+
+ unaligned
+ data abort
+
+ undefined
+ undefined instruction
+
+ **RISC-V:**
+
+ unaligned
+ load address misaligned
+
+ undefined
+ undefined instruction
+
+ **Sandbox:**
+
+ sigsegv
+ illegal memory access
+
+ undefined
+ undefined instruction
+
+ **x86:**
+
+ undefined
+ undefined instruction
+
+Examples
+--------
+
+::
+
+ => exception undefined
+
+ Illegal instruction
+ pc = 0x56076dd1a0f9, pc_reloc = 0x540f9
+
+ resetting ...
+
+Return value
+------------
+
+The return value $? is always set to 0 (true).