2 * This software is part of the SBCL system. See the README file for
5 * This software is derived from the CMU CL system, which was
6 * written at Carnegie Mellon University and released into the
7 * public domain. The software is in the public domain and is
8 * provided with absolutely no warranty. See the COPYING and CREDITS
9 * files for more information.
23 #include "interrupt.h"
25 #include "breakpoint.h"
27 #include "pseudo-atomic.h"
29 #include "genesis/static-symbols.h"
30 #include "genesis/symbol.h"
32 #define BREAKPOINT_INST 0xcc /* INT3 */
34 unsigned long fast_random_state = 1;
39 #ifndef LISP_FEATURE_WIN32
41 arch_get_bad_addr(int sig, siginfo_t *code, os_context_t *context)
43 return (os_vm_address_t)code->si_addr;
49 * hacking signal contexts
51 * (This depends both on architecture, which determines what we might
52 * want to get to, and on OS, which determines how we get to it.)
56 context_eflags_addr(os_context_t *context)
58 #if defined __linux__ || defined __sun
59 /* KLUDGE: As of kernel 2.2.14 on Red Hat 6.2, there's code in the
60 * <sys/ucontext.h> file to define symbolic names for offsets into
61 * gregs[], but it's conditional on __USE_GNU and not defined, so
62 * we need to do this nasty absolute index magic number thing
64 return &context->uc_mcontext.gregs[16];
65 #elif defined __FreeBSD__
66 return &context->uc_mcontext.mc_eflags;
67 #elif defined __OpenBSD__
68 return &context->sc_eflags;
69 #elif defined LISP_FEATURE_DARWIN
70 return (int *)(&context->uc_mcontext->SS.EFLAGS);
71 #elif defined __NetBSD__
72 return &(context->uc_mcontext.__gregs[_REG_EFL]);
73 #elif defined LISP_FEATURE_WIN32
74 return (int *)&context->EFlags;
80 void arch_skip_instruction(os_context_t *context)
82 /* Assuming we get here via an INT3 xxx instruction, the PC now
83 * points to the interrupt code (a Lisp value) so we just move
84 * past it. Skip the code; after that, if the code is an
85 * error-trap or cerror-trap then skip the data bytes that follow. */
91 /* Get and skip the Lisp interrupt code. */
92 code = *(char*)(*os_context_pc_addr(context))++;
97 /* Lisp error arg vector length */
98 vlen = *(char*)(*os_context_pc_addr(context))++;
99 /* Skip Lisp error arg data bytes. */
101 ++*os_context_pc_addr(context);
105 case trap_Breakpoint: /* not tested */
106 case trap_FunEndBreakpoint: /* not tested */
109 case trap_PendingInterrupt:
111 case trap_SingleStepAround:
112 case trap_SingleStepBefore:
113 /* only needed to skip the Code */
117 fprintf(stderr,"[arch_skip_inst invalid code %d\n]\n",code);
122 "/[arch_skip_inst resuming at %x]\n",
123 *os_context_pc_addr(context)));
127 arch_internal_error_arguments(os_context_t *context)
129 return 1 + (unsigned char *)(*os_context_pc_addr(context));
133 arch_pseudo_atomic_atomic(os_context_t *context)
135 return get_pseudo_atomic_atomic(arch_os_get_current_thread());
139 arch_set_pseudo_atomic_interrupted(os_context_t *context)
141 struct thread *thread = arch_os_get_current_thread();
142 set_pseudo_atomic_interrupted(thread);
146 arch_clear_pseudo_atomic_interrupted(os_context_t *context)
148 struct thread *thread = arch_os_get_current_thread();
149 clear_pseudo_atomic_interrupted(thread);
153 * This stuff seems to get called for TRACE and debug activity.
157 arch_install_breakpoint(void *pc)
159 unsigned int result = *(unsigned int*)pc;
161 *(char*)pc = BREAKPOINT_INST; /* x86 INT3 */
162 *((char*)pc+1) = trap_Breakpoint; /* Lisp trap code */
168 arch_remove_breakpoint(void *pc, unsigned int orig_inst)
170 *((char *)pc) = orig_inst & 0xff;
171 *((char *)pc + 1) = (orig_inst & 0xff00) >> 8;
174 /* When single stepping, single_stepping holds the original instruction
176 unsigned int *single_stepping = NULL;
177 #ifdef CANNOT_GET_TO_SINGLE_STEP_FLAG
178 unsigned int single_step_save1;
179 unsigned int single_step_save2;
180 unsigned int single_step_save3;
184 arch_do_displaced_inst(os_context_t *context, unsigned int orig_inst)
186 unsigned int *pc = (unsigned int*)(*os_context_pc_addr(context));
188 /* Put the original instruction back. */
189 *((char *)pc) = orig_inst & 0xff;
190 *((char *)pc + 1) = (orig_inst & 0xff00) >> 8;
192 #ifdef CANNOT_GET_TO_SINGLE_STEP_FLAG
193 /* Install helper instructions for the single step:
194 * pushf; or [esp],0x100; popf. */
195 single_step_save1 = *(pc-3);
196 single_step_save2 = *(pc-2);
197 single_step_save3 = *(pc-1);
198 *(pc-3) = 0x9c909090;
199 *(pc-2) = 0x00240c81;
200 *(pc-1) = 0x9d000001;
202 *context_eflags_addr(context) |= 0x100;
205 single_stepping = pc;
207 #ifdef CANNOT_GET_TO_SINGLE_STEP_FLAG
208 *os_context_pc_addr(context) = (os_context_register_t)((char *)pc - 9);
213 restore_breakpoint_from_single_step(os_context_t * context)
215 /* fprintf(stderr,"* single step trap %x\n", single_stepping); */
216 #ifdef CANNOT_GET_TO_SINGLE_STEP_FLAG
217 /* Un-install single step helper instructions. */
218 *(single_stepping-3) = single_step_save1;
219 *(single_stepping-2) = single_step_save2;
220 *(single_stepping-1) = single_step_save3;
222 *context_eflags_addr(context) &= ~0x100;
224 /* Re-install the breakpoint if possible. */
225 if (*os_context_pc_addr(context) == (int)single_stepping + 1) {
226 fprintf(stderr, "warning: couldn't reinstall breakpoint\n");
228 *((char *)single_stepping) = BREAKPOINT_INST; /* x86 INT3 */
229 *((char *)single_stepping+1) = trap_Breakpoint;
232 single_stepping = NULL;
237 arch_handle_breakpoint(os_context_t *context)
239 --*os_context_pc_addr(context);
240 handle_breakpoint(context);
244 arch_handle_fun_end_breakpoint(os_context_t *context)
246 --*os_context_pc_addr(context);
247 *os_context_pc_addr(context) =
248 (int)handle_fun_end_breakpoint(context);
252 arch_handle_single_step_trap(os_context_t *context, int trap)
254 arch_skip_instruction(context);
255 /* On x86 the fdefn / function is always in EAX, so we pass 0
256 * as the register_offset. */
257 handle_single_step_trap(context, trap, 0);
260 #ifndef LISP_FEATURE_WIN32
262 sigtrap_handler(int signal, siginfo_t *info, os_context_t *context)
266 if (single_stepping && (signal==SIGTRAP)) {
267 restore_breakpoint_from_single_step(context);
271 /* This is just for info in case the monitor wants to print an
273 current_control_stack_pointer =
274 (lispobj *)*os_context_sp_addr(context);
276 #ifdef LISP_FEATURE_SUNOS
277 /* For some reason the breakpoints that :ENCAPSULATE NIL tracing sets up
278 * cause a trace trap (i.e. processor single-stepping trap) on the following
279 * instruction on Solaris 10/x86. -- JES, 2006-04-07
281 if (info->si_code == TRAP_TRACE) {
287 /* On entry %eip points just after the INT3 byte and aims at the
288 * 'kind' value (eg trap_Cerror). For error-trap and Cerror-trap a
289 * number of bytes will follow, the first is the length of the byte
290 * arguments to follow. */
291 trap = *(unsigned char *)(*os_context_pc_addr(context));
292 handle_trap(context, trap);
296 sigill_handler(int signal, siginfo_t *siginfo, os_context_t *context) {
297 /* Triggering SIGTRAP using int3 is unreliable on OS X/x86, so
298 * we need to use illegal instructions for traps.
300 #if defined(LISP_FEATURE_DARWIN) && !defined(LISP_FEATURE_MACH_EXCEPTION_HANDLER)
301 if (*((unsigned short *)*os_context_pc_addr(context)) == 0x0b0f) {
302 *os_context_pc_addr(context) += 2;
303 return sigtrap_handler(signal, siginfo, context);
306 fake_foreign_function_call(context);
307 lose("Unhandled SIGILL");
309 #endif /* not LISP_FEATURE_WIN32 */
312 arch_install_interrupt_handlers()
314 SHOW("entering arch_install_interrupt_handlers()");
316 /* Note: The old CMU CL code here used sigtrap_handler() to handle
317 * SIGILL as well as SIGTRAP. I couldn't see any reason to do
318 * things that way. So, I changed to separate handlers when
319 * debugging a problem on OpenBSD, where SBCL wasn't catching
320 * SIGILL properly, but was instead letting the process be
321 * terminated with an "Illegal instruction" output. If this change
322 * turns out to break something (maybe breakpoint handling on some
323 * OS I haven't tested on?) and we have to go back to the old CMU
324 * CL way, I hope there will at least be a comment to explain
325 * why.. -- WHN 2001-06-07 */
326 #if !defined(LISP_FEATURE_WIN32) && !defined(LISP_FEATURE_MACH_EXCEPTION_HANDLER)
327 undoably_install_low_level_interrupt_handler(SIGILL , sigill_handler);
328 undoably_install_low_level_interrupt_handler(SIGTRAP, sigtrap_handler);
330 SHOW("returning from arch_install_interrupt_handlers()");
333 #ifdef LISP_FEATURE_LINKAGE_TABLE
334 /* FIXME: It might be cleaner to generate these from the lisp side of
339 arch_write_linkage_table_jmp(char * reloc, void * fun)
341 /* Make JMP to function entry. JMP offset is calculated from next
344 long offset = (char *)fun - (reloc + 5);
347 *reloc++ = 0xe9; /* opcode for JMP rel32 */
348 for (i = 0; i < 4; i++) {
349 *reloc++ = offset & 0xff;
353 /* write a nop for good measure. */
358 arch_write_linkage_table_ref(void * reloc, void * data)
360 *(unsigned long *)reloc = (unsigned long)data;