arm: udf instruction

README.adoc

@@ -12678,6 +12678,15 @@ gdb-multiarch -batch -ex 'arch arm' -ex "file v7/nop.out" -ex "disassemble/rs as
 
 Bibliography: https://stackoverflow.com/questions/1875491/nop-for-iphone-binaries
 
+==== ARM udf instruction
+
+Guaranteed undefined! Therefore raise illegal instruction signal. Used by GCC `__builtin_trap` apparently: https://stackoverflow.com/questions/16081618/programmatically-cause-undefined-instruction-exception
+
+* link:userland/arch/arm/udf.S[]
+* link:userland/arch/aarch64/udf.S[]
+
+TODO: why GNU GAS 2.29 does not have a mnemonic for it?
+
 === ARM SIMD
 
 ==== ARM VFP

path_properties.py

@@ -313,6 +313,10 @@ path_properties_tuples = (
                                     },
                                 ),
                                 'freestanding': freestanding_properties,
+                                'udf.S': {
+                                    'exit_status': 132,
+                                    'receives_signal': True
+                                },
                             }
                         ),
                         'aarch64': (
@@ -327,6 +331,10 @@ path_properties_tuples = (
                                     },
                                 ),
                                 'freestanding': freestanding_properties,
+                                'udf.S': {
+                                    'exit_status': 132,
+                                    'receives_signal': True
+                                },
                             }
                         ),
                         'fail.S': {'exit_status': 1},

userland/arch/aarch64/udf.S

@@ -0,0 +1,10 @@
+/* https://github.com/cirosantilli/linux-kernel-module-cheat#arm-udf-instruction */
+
+#include "common.h"
+
+ENTRY
+    .long 0
+#if 0
+    udf 0
+#endif
+EXIT

userland/arch/arm/udf.S

@@ -0,0 +1,7 @@
+/* https://github.com/cirosantilli/linux-kernel-module-cheat#arm-udf-instruction */
+
+#include "common.h"
+
+ENTRY
+    udf 0
+EXIT