2 * UNIX signal handling for processor emulation for support of ntoskrnl of libcaptive
3 * Copyright (C) 2002 Jan Kratochvil <project-captive@jankratochvil.net>
5 * This program is free software; you can redistribute it and/or modify
6 * it under the terms of the GNU General Public License as published by
7 * the Free Software Foundation; exactly version 2 of June 1991 is required
9 * This program is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 * GNU General Public License for more details.
14 * You should have received a copy of the GNU General Public License
15 * along with this program; if not, write to the Free Software
16 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
20 #define _GNU_SOURCE 1 /* for sys/ucontext.h for REG_* */
24 #include "captive/signal.h" /* self */
25 #include <glib/gtypes.h>
26 #include <glib/gmessages.h>
28 #include "captive/macros.h"
29 #include <sys/ucontext.h> /* for struct ucontext */
30 #include "captive/mm.h" /* for captive_mmap_map_get() */
32 #include "reactos/internal/mm.h" /* for PAGE_SIZE */
33 #include "captive/ldr.h" /* for captive_ModuleList_patchpoint_find() */
34 #include "captive/ldr_exports.h" /* for struct captive_ModuleList_patchpoint */
37 int _abnormal_termination_orig(void);
38 extern greg_t fs_KPCR_ExceptionList;
41 * _abnormal_termination_wrap:
43 * This call can be also accessed as AbnormalTermination() or _abnormal_termination().
44 * It is a captive wrapper around _abnormal_termination() function.
46 * Returns whether some exception occured in the current #try block we are currently
47 * #finish -ing. Any functions called from current #finish block will be considered
48 * for returning zero back again. It is forbidden to call this function outside
49 * of #finish block, result of such call is undefined.
51 * Exception handlers are registered from W32 binary in stack frames stored in "fs:[0x00000000]"
52 * value which gets mapped by libcaptive/ps/signal.c to #fs_KPCR_ExceptionList
55 * If no exception handler was registered yet this function returns zero.
57 * See also RtlpDispatchException().
59 * Returns: non-zero if some exception is now being handled as pending.
61 int _abnormal_termination_wrap(void)
63 /* No handler registered yet? ntoskrnl _abnormal_termination() does not handle it
64 * and I do not want to bother with registering toplevel handler.
66 if (fs_KPCR_ExceptionList==(greg_t)-1)
69 return _abnormal_termination_orig();
76 * RtlpDispatchException:
77 * @ExceptionRecord: Ignored by libcaptive.
78 * @Context: Ignored by libcaptive.
80 * Function definition to prevent inclusion of real RtlpDispatchException() implementation.
81 * Currently libcaptive never raises any exception - fix _abnormal_termination() if it changes.
83 * Returns: Never returns. Value %0 if it returns although it is impossible.
85 ULONG RtlpDispatchException(IN PEXCEPTION_RECORD ExceptionRecord,IN PCONTEXT Context)
87 g_assert_not_reached();
88 g_return_val_if_reached(0);
94 /* =='KeGetCurrentKPCR()->ExceptionList';
95 * libcaptive has reduced KPCR (named 'captive_KPCR') which
96 * does not contain this field
98 greg_t fs_KPCR_ExceptionList=(greg_t)-1;
101 static greg_t fs_KPCR_Unknown638=0;
104 static gboolean instr_mov_greg_to_fsmem(int greg,const void *fsmem,struct ucontext *ucontext)
106 if (fsmem==(const void *)0x00000000) { /* exception stack top pointer */
107 /* moving from %esp is required to pass! */
108 fs_KPCR_ExceptionList=ucontext->uc_mcontext.gregs[greg];
111 g_return_val_if_reached(FALSE);
114 static gboolean instr_mov_immed_to_fsmem(greg_t immed,const void *fsmem,struct ucontext *ucontext)
116 if (fsmem==(const void *)0x00000000) { /* exception stack top pointer */
117 fs_KPCR_ExceptionList=immed;
120 g_return_val_if_reached(FALSE);
123 static gboolean instr_mov_fsmem_to_greg(const void *fsmem,int greg,struct ucontext *ucontext)
125 if (fsmem==(const void *)0x00000000) { /* exception stack top pointer */
126 /* moving to %esp is required to pass! */
127 ucontext->uc_mcontext.gregs[greg]=fs_KPCR_ExceptionList;
130 if (fsmem==(const void *)0x00000051) { /* =='KeGetCurrentKPCR()->Number' */
131 g_return_val_if_fail(greg!=REG_ESP,FALSE);
132 ucontext->uc_mcontext.gregs[greg]=(greg_t)0; /* ==libcaptive version of KeGetCurrentProcessorNumber() */
135 if (fsmem==(const void *)0x00000124) { /* =='KeGetCurrentKPCR()->CurrentThread' */
136 g_return_val_if_fail(greg!=REG_ESP,FALSE);
137 ucontext->uc_mcontext.gregs[greg]=(greg_t)captive_KeGetCurrentKPCR()->CurrentThread;
140 g_return_val_if_reached(FALSE);
143 static gboolean instr_push_fsmem(const void *fsmem,struct ucontext *ucontext)
145 if (fsmem==(const void *)0x00000000) { /* exception stack top pointer */
146 ucontext->uc_mcontext.gregs[REG_ESP]-=4;
147 *(greg_t *)ucontext->uc_mcontext.gregs[REG_ESP]=fs_KPCR_ExceptionList;
150 g_return_val_if_reached(FALSE);
153 static gboolean instr_pop_fsmem(const void *fsmem,struct ucontext *ucontext)
155 if (fsmem==(const void *)0x00000000) { /* exception stack top pointer */
156 fs_KPCR_ExceptionList=*(greg_t *)ucontext->uc_mcontext.gregs[REG_ESP];
157 ucontext->uc_mcontext.gregs[REG_ESP]+=4;
160 g_return_val_if_reached(FALSE);
163 static gboolean instr_incl_fsmem(const void *fsmem,struct ucontext *ucontext)
165 if (fsmem==(const void *)0x00000638) { /* Unknown638 */
166 fs_KPCR_Unknown638++;
169 g_return_val_if_reached(FALSE);
172 static int op_regcode_to_greg(guint8 regcode)
175 case 0x00: return REG_EAX;
176 case 0x01: return REG_ECX;
177 case 0x02: return REG_EDX;
178 case 0x03: return REG_EBX;
179 case 0x04: return REG_ESP;
180 case 0x05: return REG_EBP;
181 case 0x06: return REG_ESI;
182 case 0x07: return REG_EDI;
184 g_return_val_if_reached(REG_EAX);
187 static void sigaction_SIGSEGV(int signo,siginfo_t *siginfo,struct ucontext *ucontext)
190 const void *reg_eip_aligned;
192 g_return_if_fail(signo==SIGSEGV);
193 g_return_if_fail(siginfo->si_signo==SIGSEGV);
194 /* siginfo->si_code is weird, seen to have value 128 */
196 reg_eip=(void *)ucontext->uc_mcontext.gregs[REG_EIP];
198 /* 'reg_eip' is not yet PAGE_SIZE-aligned but we need the aligned ptr for captive_mmap_map_get().
199 * glib NOTE: YOU MAY NOT STORE POINTERS IN INTEGERS.
201 reg_eip_aligned=(const void *)(((char *)reg_eip)-(GPOINTER_TO_UINT(reg_eip)&(PAGE_SIZE-1)));
202 g_assert(reg_eip_aligned!=NULL);
203 g_return_if_fail(!(captive_mmap_map_get(reg_eip_aligned)&PROT_EXEC));
205 /* all instruction notation comments are written in AT&T 'instr src,dest' syntax! */
206 if (*reg_eip==0x64) { /* prefix '%fs:' */
208 /* TODO:thread; %fs: is CPU-dependent */
209 if (*reg_eip==0x0F) { /* two-byte opcode */
211 if (*reg_eip==0xB6) { /* ??? */
213 if (*reg_eip==0x05) { /* movzbl %fs:{reg_eip[1..4]},%eax */
215 if (instr_mov_fsmem_to_greg(*(const void **)reg_eip,REG_EAX,ucontext)) {
219 g_assert_not_reached();
221 g_assert_not_reached();
223 g_assert_not_reached();
225 if (*reg_eip==0xA3) { /* 'mov %eax,%fs:{reg_eip[1..4]}' */
227 if (instr_mov_greg_to_fsmem(REG_EAX,*(const void **)reg_eip,ucontext)) {
231 g_assert_not_reached();
233 if (*reg_eip==0x89) { /* prefix 0x89 */
235 if ((*reg_eip & ~0x38)==0x05) { /* 'mov %{op_regcode_to_greg(*reg_eip[b3..b5])},%fs:{reg_eip[1..4]} */
237 if (instr_mov_greg_to_fsmem(op_regcode_to_greg(reg_eip[-1]>>3U),*(const void **)reg_eip,ucontext)) {
241 g_assert_not_reached();
243 g_assert_not_reached();
245 if (*reg_eip==0xA1) { /* 'mov %fs:{reg_eip[1..4]},%eax' */
247 if (instr_mov_fsmem_to_greg(*(const void **)reg_eip,REG_EAX,ucontext)) {
251 g_assert_not_reached();
253 if (*reg_eip==0x8B) { /* prefix 0x8B */
255 if ((*reg_eip & ~0x38)==0x05) { /* 'mov %fs:{reg_eip[1..4]},%{op_regcode_to_greg(*reg_eip[b3..b5])}' */
257 if (instr_mov_fsmem_to_greg(*(const void **)reg_eip,op_regcode_to_greg(reg_eip[-1]>>3U),ucontext)) {
261 g_assert_not_reached();
263 g_assert_not_reached();
265 if (*reg_eip==0xFF) { /* prefix 0xFF */
267 if (*reg_eip==0x05) { /* 'incl %fs:{reg_eip[1..4]}' */
269 if (instr_incl_fsmem(*(const void **)reg_eip,ucontext)) {
273 g_assert_not_reached();
275 if (*reg_eip==0x35) { /* 'pushl %fs:{reg_eip[1..4]}' */
277 if (instr_push_fsmem(*(const void **)reg_eip,ucontext)) {
281 g_assert_not_reached();
283 g_assert_not_reached();
285 if (*reg_eip==0x8F) { /* prefix 0x0F */
287 if (*reg_eip==0x05) { /* 'popl %fs:{reg_eip[1..4]}' */
289 if (instr_pop_fsmem(*(const void **)reg_eip,ucontext)) {
293 g_assert_not_reached();
295 g_assert_not_reached();
297 if (*reg_eip==0xC7) { /* prefix 0xC7 */
299 if (*reg_eip==0x05) { /* 'movl ${reg_eip[5..8]},%fs:{reg_eip[1..4]}' */
301 if (instr_mov_immed_to_fsmem(((greg_t *)reg_eip)[1],*(const void **)reg_eip,ucontext)) {
305 g_assert_not_reached();
307 g_assert_not_reached();
309 g_assert_not_reached();
312 /* all instruction notation comments are written in AT&T 'instr src,dest' syntax! */
313 if (*reg_eip==0x66) { /* prefix '%fs:' */
315 /* TODO:thread; %fs: is CPU-dependent */
316 if (*reg_eip==0x8E) { /* two-byte opcode */
318 if (*reg_eip==0xE3) { /* 'mov %bx,%fs' */
320 g_assert(0x30==(0xFFFF&ucontext->uc_mcontext.gregs[REG_EBX]));
321 /* 'reload' of %fs can be ignored */
324 g_assert_not_reached();
326 g_assert_not_reached();
329 if (*reg_eip==0xF4) { /* hlt; from captive_ModuleList_patch() */
330 struct captive_ModuleList_patchpoint *patchpoint;
331 const gchar *funcname_disabled;
333 g_log(G_LOG_DOMAIN,G_LOG_LEVEL_DEBUG,"%s: reg_eip=%p; 0xF4 hit",G_STRLOC,reg_eip);
335 if ((funcname_disabled=captive_ModuleList_function_disable_find(
336 reg_eip))) { /* ExportAddress */
337 g_error("%s: Reached disabled W32 function: %s",G_STRLOC,funcname_disabled);
338 g_assert_not_reached();
340 patchpoint=captive_ModuleList_patchpoint_find(
341 reg_eip); /* ExportAddress */
342 g_assert(patchpoint!=NULL);
343 if (reg_eip==patchpoint->orig_w32_func) {
344 g_assert(0xF4 /* hlt */ ==*patchpoint->orig_w32_func);
345 g_assert(patchpoint->orig_w32_2ndinstr_byte ==*patchpoint->orig_w32_2ndinstr);
346 if (patchpoint->through_w32_func) {
347 *patchpoint->orig_w32_func=patchpoint->orig_w32_func_byte;
348 *patchpoint->orig_w32_2ndinstr=0xF4; /* hlt */
350 else { /* !patchpoint->through_w32_func */
351 reg_eip=(guint8 *)patchpoint->wrap_wrap_func;
355 if (reg_eip==patchpoint->orig_w32_2ndinstr) {
356 g_assert(patchpoint->orig_w32_func_byte ==*patchpoint->orig_w32_func);
357 g_assert(0xF4 /* hlt */ ==*patchpoint->orig_w32_2ndinstr);
358 g_assert(patchpoint->through_w32_func==TRUE);
359 *patchpoint->orig_w32_func=0xF4; /* hlt */
360 *patchpoint->orig_w32_2ndinstr=patchpoint->orig_w32_2ndinstr_byte;
361 patchpoint->through_w32_func=FALSE;
364 g_assert_not_reached();
367 if (*reg_eip==0xFA) { /* cli */
368 g_log(G_LOG_DOMAIN,G_LOG_LEVEL_DEBUG,"%s: reg_eip=%p; CLI neutralized",G_STRLOC,reg_eip);
369 *reg_eip=0x90; /* nop */
373 if (*reg_eip==0xFB) { /* sti */
374 g_log(G_LOG_DOMAIN,G_LOG_LEVEL_DEBUG,"%s: reg_eip=%p; STI neutralized",G_STRLOC,reg_eip);
375 *reg_eip=0x90; /* nop */
379 g_assert_not_reached();
382 ucontext->uc_mcontext.gregs[REG_EIP]=(greg_t)reg_eip;
387 * captive_signal_init:
389 * Initialize UNIX signal handling to be able to emulate foreign W32
390 * instructions. These instructions must be located inside address
391 * space of foreign W32 binary code which is identified by successful
392 * call to captive_mmap_map_get() returning #PROT_EXEC bit set.
393 * This bit should be set from MmAllocateSection() called from
394 * ntoskrnl/ldr/loader.c/LdrPEProcessModule().
396 * Currently emulated set is the access to %fs register offset %0
397 * where the exception stack top pointer is located.
399 * Returns: %TRUE if successful.
401 gboolean captive_signal_init(void)
404 struct sigaction sigaction_struct;
407 CAPTIVE_MEMZERO(&sigaction_struct); /* this structure may have unpredictable fields */
409 /* Init 'sigaction_struct.sa_mask'. */
410 errint=sigemptyset(&sigaction_struct.sa_mask);
411 g_return_val_if_fail(errint==0,FALSE);
412 errint=sigaddset(&sigaction_struct.sa_mask,SIGSEGV);
413 g_return_val_if_fail(errint==0,FALSE);
415 /* Set the signal sigaction handler. */
416 sigaction_struct.sa_sigaction=(void (*)(int,siginfo_t *,void *))sigaction_SIGSEGV;
417 sigaction_struct.sa_flags=0
418 |SA_SIGINFO; /* Use 'sa_sigaction' (not 'sa_handler') */
419 errint=sigaction(SIGSEGV,
420 &sigaction_struct, /* act */
422 g_return_val_if_fail(errint==0,FALSE);
424 /* Enable SIGSEGV signal (should be default). */
425 errint=sigemptyset(&sigset);
426 g_return_val_if_fail(errint==0,FALSE);
427 errint=sigaddset(&sigset,SIGSEGV);
428 g_return_val_if_fail(errint==0,FALSE);
429 errint=sigprocmask(SIG_UNBLOCK,
432 g_return_val_if_fail(errint==0,FALSE);