summary refs log tree commit diff
path: root/core.e
diff options
context:
space:
mode:
Diffstat (limited to 'core.e')
-rw-r--r--core.e17
1 files changed, 17 insertions, 0 deletions
diff --git a/core.e b/core.e
index 0390812..8c14948 100644
--- a/core.e
+++ b/core.e
@@ -1180,3 +1180,20 @@ here !
 ~ (input point, alignment byte count -- input point)
 : unpackalign align-size ;
 
+
+~ Development utilities
+~ ~~~~~~~~~~~~~~~~~~~~~
+
+~   This peforms the "hlt" instruction (Intel's mnemomic, short for "halt"),
+~ which will cause the program to exit with a segmentation fault. If you're
+~ running under a debugger, this is a convenient way to get execution to stop
+~ at a certain point.
+~
+~   It's called "crash" rather than "hlt" to distinguish it from the word
+~ which outputs the instruction as machine code.
+
+: crash
+  [ here @
+    hlt
+    here ! ] ;asm
+