xref: /dragonfly/contrib/gdb-7/gdb/stubs/i386-stub.c (revision 0db87cb7)
1 /****************************************************************************
2 
3 		THIS SOFTWARE IS NOT COPYRIGHTED
4 
5    HP offers the following for use in the public domain.  HP makes no
6    warranty with regard to the software or it's performance and the
7    user accepts the software "AS IS" with all faults.
8 
9    HP DISCLAIMS ANY WARRANTIES, EXPRESS OR IMPLIED, WITH REGARD
10    TO THIS SOFTWARE INCLUDING BUT NOT LIMITED TO THE WARRANTIES
11    OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
12 
13 ****************************************************************************/
14 
15 /****************************************************************************
16  *  Header: remcom.c,v 1.34 91/03/09 12:29:49 glenne Exp $
17  *
18  *  Module name: remcom.c $
19  *  Revision: 1.34 $
20  *  Date: 91/03/09 12:29:49 $
21  *  Contributor:     Lake Stevens Instrument Division$
22  *
23  *  Description:     low level support for gdb debugger. $
24  *
25  *  Considerations:  only works on target hardware $
26  *
27  *  Written by:      Glenn Engel $
28  *  ModuleState:     Experimental $
29  *
30  *  NOTES:           See Below $
31  *
32  *  Modified for 386 by Jim Kingdon, Cygnus Support.
33  *
34  *  To enable debugger support, two things need to happen.  One, a
35  *  call to set_debug_traps() is necessary in order to allow any breakpoints
36  *  or error conditions to be properly intercepted and reported to gdb.
37  *  Two, a breakpoint needs to be generated to begin communication.  This
38  *  is most easily accomplished by a call to breakpoint().  Breakpoint()
39  *  simulates a breakpoint by executing a trap #1.
40  *
41  *  The external function exceptionHandler() is
42  *  used to attach a specific handler to a specific 386 vector number.
43  *  It should use the same privilege level it runs at.  It should
44  *  install it as an interrupt gate so that interrupts are masked
45  *  while the handler runs.
46  *
47  *  Because gdb will sometimes write to the stack area to execute function
48  *  calls, this program cannot rely on using the supervisor stack so it
49  *  uses it's own stack area reserved in the int array remcomStack.
50  *
51  *************
52  *
53  *    The following gdb commands are supported:
54  *
55  * command          function                               Return value
56  *
57  *    g             return the value of the CPU registers  hex data or ENN
58  *    G             set the value of the CPU registers     OK or ENN
59  *
60  *    mAA..AA,LLLL  Read LLLL bytes at address AA..AA      hex data or ENN
61  *    MAA..AA,LLLL: Write LLLL bytes at address AA.AA      OK or ENN
62  *
63  *    c             Resume at current address              SNN   ( signal NN)
64  *    cAA..AA       Continue at address AA..AA             SNN
65  *
66  *    s             Step one instruction                   SNN
67  *    sAA..AA       Step one instruction from AA..AA       SNN
68  *
69  *    k             kill
70  *
71  *    ?             What was the last sigval ?             SNN   (signal NN)
72  *
73  * All commands and responses are sent with a packet which includes a
74  * checksum.  A packet consists of
75  *
76  * $<packet info>#<checksum>.
77  *
78  * where
79  * <packet info> :: <characters representing the command or response>
80  * <checksum>    :: < two hex digits computed as modulo 256 sum of <packetinfo>>
81  *
82  * When a packet is received, it is first acknowledged with either '+' or '-'.
83  * '+' indicates a successful transfer.  '-' indicates a failed transfer.
84  *
85  * Example:
86  *
87  * Host:                  Reply:
88  * $m0,10#2a               +$00010203040506070809101112131415#42
89  *
90  ****************************************************************************/
91 
92 #include <stdio.h>
93 #include <string.h>
94 
95 /************************************************************************
96  *
97  * external low-level support routines
98  */
99 
100 extern void putDebugChar();	/* write a single character      */
101 extern int getDebugChar();	/* read and return a single char */
102 extern void exceptionHandler();	/* assign an exception handler   */
103 
104 /************************************************************************/
105 /* BUFMAX defines the maximum number of characters in inbound/outbound buffers*/
106 /* at least NUMREGBYTES*2 are needed for register packets */
107 #define BUFMAX 400
108 
109 static char initialized;  /* boolean flag. != 0 means we've been initialized */
110 
111 int     remote_debug;
112 /*  debug >  0 prints ill-formed commands in valid packets & checksum errors */
113 
114 static const char hexchars[]="0123456789abcdef";
115 
116 /* Number of registers.  */
117 #define NUMREGS	16
118 
119 /* Number of bytes of registers.  */
120 #define NUMREGBYTES (NUMREGS * 4)
121 
122 enum regnames {EAX, ECX, EDX, EBX, ESP, EBP, ESI, EDI,
123 	       PC /* also known as eip */,
124 	       PS /* also known as eflags */,
125 	       CS, SS, DS, ES, FS, GS};
126 
127 /*
128  * these should not be static cuz they can be used outside this module
129  */
130 int registers[NUMREGS];
131 
132 #define STACKSIZE 10000
133 int remcomStack[STACKSIZE/sizeof(int)];
134 static int* stackPtr = &remcomStack[STACKSIZE/sizeof(int) - 1];
135 
136 /***************************  ASSEMBLY CODE MACROS *************************/
137 /* 									   */
138 
139 extern void
140 return_to_prog ();
141 
142 /* Restore the program's registers (including the stack pointer, which
143    means we get the right stack and don't have to worry about popping our
144    return address and any stack frames and so on) and return.  */
145 asm(".text");
146 asm(".globl _return_to_prog");
147 asm("_return_to_prog:");
148 asm("        movw _registers+44, %ss");
149 asm("        movl _registers+16, %esp");
150 asm("        movl _registers+4, %ecx");
151 asm("        movl _registers+8, %edx");
152 asm("        movl _registers+12, %ebx");
153 asm("        movl _registers+20, %ebp");
154 asm("        movl _registers+24, %esi");
155 asm("        movl _registers+28, %edi");
156 asm("        movw _registers+48, %ds");
157 asm("        movw _registers+52, %es");
158 asm("        movw _registers+56, %fs");
159 asm("        movw _registers+60, %gs");
160 asm("        movl _registers+36, %eax");
161 asm("        pushl %eax");  /* saved eflags */
162 asm("        movl _registers+40, %eax");
163 asm("        pushl %eax");  /* saved cs */
164 asm("        movl _registers+32, %eax");
165 asm("        pushl %eax");  /* saved eip */
166 asm("        movl _registers, %eax");
167 /* use iret to restore pc and flags together so
168    that trace flag works right.  */
169 asm("        iret");
170 
171 #define BREAKPOINT() asm("   int $3");
172 
173 /* Put the error code here just in case the user cares.  */
174 int gdb_i386errcode;
175 /* Likewise, the vector number here (since GDB only gets the signal
176    number through the usual means, and that's not very specific).  */
177 int gdb_i386vector = -1;
178 
179 /* GDB stores segment registers in 32-bit words (that's just the way
180    m-i386v.h is written).  So zero the appropriate areas in registers.  */
181 #define SAVE_REGISTERS1() \
182   asm ("movl %eax, _registers");                                   	  \
183   asm ("movl %ecx, _registers+4");			  		     \
184   asm ("movl %edx, _registers+8");			  		     \
185   asm ("movl %ebx, _registers+12");			  		     \
186   asm ("movl %ebp, _registers+20");			  		     \
187   asm ("movl %esi, _registers+24");			  		     \
188   asm ("movl %edi, _registers+28");			  		     \
189   asm ("movw $0, %ax");							     \
190   asm ("movw %ds, _registers+48");			  		     \
191   asm ("movw %ax, _registers+50");					     \
192   asm ("movw %es, _registers+52");			  		     \
193   asm ("movw %ax, _registers+54");					     \
194   asm ("movw %fs, _registers+56");			  		     \
195   asm ("movw %ax, _registers+58");					     \
196   asm ("movw %gs, _registers+60");			  		     \
197   asm ("movw %ax, _registers+62");
198 #define SAVE_ERRCODE() \
199   asm ("popl %ebx");                                  \
200   asm ("movl %ebx, _gdb_i386errcode");
201 #define SAVE_REGISTERS2() \
202   asm ("popl %ebx"); /* old eip */			  		     \
203   asm ("movl %ebx, _registers+32");			  		     \
204   asm ("popl %ebx");	 /* old cs */			  		     \
205   asm ("movl %ebx, _registers+40");			  		     \
206   asm ("movw %ax, _registers+42");                                           \
207   asm ("popl %ebx");	 /* old eflags */		  		     \
208   asm ("movl %ebx, _registers+36");			 		     \
209   /* Now that we've done the pops, we can save the stack pointer.");  */   \
210   asm ("movw %ss, _registers+44");					     \
211   asm ("movw %ax, _registers+46");     	       	       	       	       	     \
212   asm ("movl %esp, _registers+16");
213 
214 /* See if mem_fault_routine is set, if so just IRET to that address.  */
215 #define CHECK_FAULT() \
216   asm ("cmpl $0, _mem_fault_routine");					   \
217   asm ("jne mem_fault");
218 
219 asm (".text");
220 asm ("mem_fault:");
221 /* OK to clobber temp registers; we're just going to end up in set_mem_err.  */
222 /* Pop error code from the stack and save it.  */
223 asm ("     popl %eax");
224 asm ("     movl %eax, _gdb_i386errcode");
225 
226 asm ("     popl %eax"); /* eip */
227 /* We don't want to return there, we want to return to the function
228    pointed to by mem_fault_routine instead.  */
229 asm ("     movl _mem_fault_routine, %eax");
230 asm ("     popl %ecx"); /* cs (low 16 bits; junk in hi 16 bits).  */
231 asm ("     popl %edx"); /* eflags */
232 
233 /* Remove this stack frame; when we do the iret, we will be going to
234    the start of a function, so we want the stack to look just like it
235    would after a "call" instruction.  */
236 asm ("     leave");
237 
238 /* Push the stuff that iret wants.  */
239 asm ("     pushl %edx"); /* eflags */
240 asm ("     pushl %ecx"); /* cs */
241 asm ("     pushl %eax"); /* eip */
242 
243 /* Zero mem_fault_routine.  */
244 asm ("     movl $0, %eax");
245 asm ("     movl %eax, _mem_fault_routine");
246 
247 asm ("iret");
248 
249 #define CALL_HOOK() asm("call _remcomHandler");
250 
251 /* This function is called when a i386 exception occurs.  It saves
252  * all the cpu regs in the _registers array, munges the stack a bit,
253  * and invokes an exception handler (remcom_handler).
254  *
255  * stack on entry:                       stack on exit:
256  *   old eflags                          vector number
257  *   old cs (zero-filled to 32 bits)
258  *   old eip
259  *
260  */
261 extern void _catchException3();
262 asm(".text");
263 asm(".globl __catchException3");
264 asm("__catchException3:");
265 SAVE_REGISTERS1();
266 SAVE_REGISTERS2();
267 asm ("pushl $3");
268 CALL_HOOK();
269 
270 /* Same thing for exception 1.  */
271 extern void _catchException1();
272 asm(".text");
273 asm(".globl __catchException1");
274 asm("__catchException1:");
275 SAVE_REGISTERS1();
276 SAVE_REGISTERS2();
277 asm ("pushl $1");
278 CALL_HOOK();
279 
280 /* Same thing for exception 0.  */
281 extern void _catchException0();
282 asm(".text");
283 asm(".globl __catchException0");
284 asm("__catchException0:");
285 SAVE_REGISTERS1();
286 SAVE_REGISTERS2();
287 asm ("pushl $0");
288 CALL_HOOK();
289 
290 /* Same thing for exception 4.  */
291 extern void _catchException4();
292 asm(".text");
293 asm(".globl __catchException4");
294 asm("__catchException4:");
295 SAVE_REGISTERS1();
296 SAVE_REGISTERS2();
297 asm ("pushl $4");
298 CALL_HOOK();
299 
300 /* Same thing for exception 5.  */
301 extern void _catchException5();
302 asm(".text");
303 asm(".globl __catchException5");
304 asm("__catchException5:");
305 SAVE_REGISTERS1();
306 SAVE_REGISTERS2();
307 asm ("pushl $5");
308 CALL_HOOK();
309 
310 /* Same thing for exception 6.  */
311 extern void _catchException6();
312 asm(".text");
313 asm(".globl __catchException6");
314 asm("__catchException6:");
315 SAVE_REGISTERS1();
316 SAVE_REGISTERS2();
317 asm ("pushl $6");
318 CALL_HOOK();
319 
320 /* Same thing for exception 7.  */
321 extern void _catchException7();
322 asm(".text");
323 asm(".globl __catchException7");
324 asm("__catchException7:");
325 SAVE_REGISTERS1();
326 SAVE_REGISTERS2();
327 asm ("pushl $7");
328 CALL_HOOK();
329 
330 /* Same thing for exception 8.  */
331 extern void _catchException8();
332 asm(".text");
333 asm(".globl __catchException8");
334 asm("__catchException8:");
335 SAVE_REGISTERS1();
336 SAVE_ERRCODE();
337 SAVE_REGISTERS2();
338 asm ("pushl $8");
339 CALL_HOOK();
340 
341 /* Same thing for exception 9.  */
342 extern void _catchException9();
343 asm(".text");
344 asm(".globl __catchException9");
345 asm("__catchException9:");
346 SAVE_REGISTERS1();
347 SAVE_REGISTERS2();
348 asm ("pushl $9");
349 CALL_HOOK();
350 
351 /* Same thing for exception 10.  */
352 extern void _catchException10();
353 asm(".text");
354 asm(".globl __catchException10");
355 asm("__catchException10:");
356 SAVE_REGISTERS1();
357 SAVE_ERRCODE();
358 SAVE_REGISTERS2();
359 asm ("pushl $10");
360 CALL_HOOK();
361 
362 /* Same thing for exception 12.  */
363 extern void _catchException12();
364 asm(".text");
365 asm(".globl __catchException12");
366 asm("__catchException12:");
367 SAVE_REGISTERS1();
368 SAVE_ERRCODE();
369 SAVE_REGISTERS2();
370 asm ("pushl $12");
371 CALL_HOOK();
372 
373 /* Same thing for exception 16.  */
374 extern void _catchException16();
375 asm(".text");
376 asm(".globl __catchException16");
377 asm("__catchException16:");
378 SAVE_REGISTERS1();
379 SAVE_REGISTERS2();
380 asm ("pushl $16");
381 CALL_HOOK();
382 
383 /* For 13, 11, and 14 we have to deal with the CHECK_FAULT stuff.  */
384 
385 /* Same thing for exception 13.  */
386 extern void _catchException13 ();
387 asm (".text");
388 asm (".globl __catchException13");
389 asm ("__catchException13:");
390 CHECK_FAULT();
391 SAVE_REGISTERS1();
392 SAVE_ERRCODE();
393 SAVE_REGISTERS2();
394 asm ("pushl $13");
395 CALL_HOOK();
396 
397 /* Same thing for exception 11.  */
398 extern void _catchException11 ();
399 asm (".text");
400 asm (".globl __catchException11");
401 asm ("__catchException11:");
402 CHECK_FAULT();
403 SAVE_REGISTERS1();
404 SAVE_ERRCODE();
405 SAVE_REGISTERS2();
406 asm ("pushl $11");
407 CALL_HOOK();
408 
409 /* Same thing for exception 14.  */
410 extern void _catchException14 ();
411 asm (".text");
412 asm (".globl __catchException14");
413 asm ("__catchException14:");
414 CHECK_FAULT();
415 SAVE_REGISTERS1();
416 SAVE_ERRCODE();
417 SAVE_REGISTERS2();
418 asm ("pushl $14");
419 CALL_HOOK();
420 
421 /*
422  * remcomHandler is a front end for handle_exception.  It moves the
423  * stack pointer into an area reserved for debugger use.
424  */
425 asm("_remcomHandler:");
426 asm("           popl %eax");        /* pop off return address     */
427 asm("           popl %eax");      /* get the exception number   */
428 asm("		movl _stackPtr, %esp"); /* move to remcom stack area  */
429 asm("		pushl %eax");	/* push exception onto stack  */
430 asm("		call  _handle_exception");    /* this never returns */
431 
432 void
433 _returnFromException ()
434 {
435   return_to_prog ();
436 }
437 
438 int
439 hex (ch)
440      char ch;
441 {
442   if ((ch >= 'a') && (ch <= 'f'))
443     return (ch - 'a' + 10);
444   if ((ch >= '0') && (ch <= '9'))
445     return (ch - '0');
446   if ((ch >= 'A') && (ch <= 'F'))
447     return (ch - 'A' + 10);
448   return (-1);
449 }
450 
451 static char remcomInBuffer[BUFMAX];
452 static char remcomOutBuffer[BUFMAX];
453 
454 /* scan for the sequence $<data>#<checksum>     */
455 
456 unsigned char *
457 getpacket (void)
458 {
459   unsigned char *buffer = &remcomInBuffer[0];
460   unsigned char checksum;
461   unsigned char xmitcsum;
462   int count;
463   char ch;
464 
465   while (1)
466     {
467       /* wait around for the start character, ignore all other characters */
468       while ((ch = getDebugChar ()) != '$')
469 	;
470 
471     retry:
472       checksum = 0;
473       xmitcsum = -1;
474       count = 0;
475 
476       /* now, read until a # or end of buffer is found */
477       while (count < BUFMAX - 1)
478 	{
479 	  ch = getDebugChar ();
480 	  if (ch == '$')
481 	    goto retry;
482 	  if (ch == '#')
483 	    break;
484 	  checksum = checksum + ch;
485 	  buffer[count] = ch;
486 	  count = count + 1;
487 	}
488       buffer[count] = 0;
489 
490       if (ch == '#')
491 	{
492 	  ch = getDebugChar ();
493 	  xmitcsum = hex (ch) << 4;
494 	  ch = getDebugChar ();
495 	  xmitcsum += hex (ch);
496 
497 	  if (checksum != xmitcsum)
498 	    {
499 	      if (remote_debug)
500 		{
501 		  fprintf (stderr,
502 			   "bad checksum.  My count = 0x%x, sent=0x%x. buf=%s\n",
503 			   checksum, xmitcsum, buffer);
504 		}
505 	      putDebugChar ('-');	/* failed checksum */
506 	    }
507 	  else
508 	    {
509 	      putDebugChar ('+');	/* successful transfer */
510 
511 	      /* if a sequence char is present, reply the sequence ID */
512 	      if (buffer[2] == ':')
513 		{
514 		  putDebugChar (buffer[0]);
515 		  putDebugChar (buffer[1]);
516 
517 		  return &buffer[3];
518 		}
519 
520 	      return &buffer[0];
521 	    }
522 	}
523     }
524 }
525 
526 /* send the packet in buffer.  */
527 
528 void
529 putpacket (unsigned char *buffer)
530 {
531   unsigned char checksum;
532   int count;
533   char ch;
534 
535   /*  $<packet info>#<checksum>.  */
536   do
537     {
538       putDebugChar ('$');
539       checksum = 0;
540       count = 0;
541 
542       while (ch = buffer[count])
543 	{
544 	  putDebugChar (ch);
545 	  checksum += ch;
546 	  count += 1;
547 	}
548 
549       putDebugChar ('#');
550       putDebugChar (hexchars[checksum >> 4]);
551       putDebugChar (hexchars[checksum % 16]);
552 
553     }
554   while (getDebugChar () != '+');
555 }
556 
557 void
558 debug_error (format, parm)
559      char *format;
560      char *parm;
561 {
562   if (remote_debug)
563     fprintf (stderr, format, parm);
564 }
565 
566 /* Address of a routine to RTE to if we get a memory fault.  */
567 static void (*volatile mem_fault_routine) () = NULL;
568 
569 /* Indicate to caller of mem2hex or hex2mem that there has been an
570    error.  */
571 static volatile int mem_err = 0;
572 
573 void
574 set_mem_err (void)
575 {
576   mem_err = 1;
577 }
578 
579 /* These are separate functions so that they are so short and sweet
580    that the compiler won't save any registers (if there is a fault
581    to mem_fault, they won't get restored, so there better not be any
582    saved).  */
583 int
584 get_char (char *addr)
585 {
586   return *addr;
587 }
588 
589 void
590 set_char (char *addr, int val)
591 {
592   *addr = val;
593 }
594 
595 /* convert the memory pointed to by mem into hex, placing result in buf */
596 /* return a pointer to the last char put in buf (null) */
597 /* If MAY_FAULT is non-zero, then we should set mem_err in response to
598    a fault; if zero treat a fault like any other fault in the stub.  */
599 char *
600 mem2hex (mem, buf, count, may_fault)
601      char *mem;
602      char *buf;
603      int count;
604      int may_fault;
605 {
606   int i;
607   unsigned char ch;
608 
609   if (may_fault)
610     mem_fault_routine = set_mem_err;
611   for (i = 0; i < count; i++)
612     {
613       ch = get_char (mem++);
614       if (may_fault && mem_err)
615 	return (buf);
616       *buf++ = hexchars[ch >> 4];
617       *buf++ = hexchars[ch % 16];
618     }
619   *buf = 0;
620   if (may_fault)
621     mem_fault_routine = NULL;
622   return (buf);
623 }
624 
625 /* convert the hex array pointed to by buf into binary to be placed in mem */
626 /* return a pointer to the character AFTER the last byte written */
627 char *
628 hex2mem (buf, mem, count, may_fault)
629      char *buf;
630      char *mem;
631      int count;
632      int may_fault;
633 {
634   int i;
635   unsigned char ch;
636 
637   if (may_fault)
638     mem_fault_routine = set_mem_err;
639   for (i = 0; i < count; i++)
640     {
641       ch = hex (*buf++) << 4;
642       ch = ch + hex (*buf++);
643       set_char (mem++, ch);
644       if (may_fault && mem_err)
645 	return (mem);
646     }
647   if (may_fault)
648     mem_fault_routine = NULL;
649   return (mem);
650 }
651 
652 /* this function takes the 386 exception vector and attempts to
653    translate this number into a unix compatible signal value */
654 int
655 computeSignal (int exceptionVector)
656 {
657   int sigval;
658   switch (exceptionVector)
659     {
660     case 0:
661       sigval = 8;
662       break;			/* divide by zero */
663     case 1:
664       sigval = 5;
665       break;			/* debug exception */
666     case 3:
667       sigval = 5;
668       break;			/* breakpoint */
669     case 4:
670       sigval = 16;
671       break;			/* into instruction (overflow) */
672     case 5:
673       sigval = 16;
674       break;			/* bound instruction */
675     case 6:
676       sigval = 4;
677       break;			/* Invalid opcode */
678     case 7:
679       sigval = 8;
680       break;			/* coprocessor not available */
681     case 8:
682       sigval = 7;
683       break;			/* double fault */
684     case 9:
685       sigval = 11;
686       break;			/* coprocessor segment overrun */
687     case 10:
688       sigval = 11;
689       break;			/* Invalid TSS */
690     case 11:
691       sigval = 11;
692       break;			/* Segment not present */
693     case 12:
694       sigval = 11;
695       break;			/* stack exception */
696     case 13:
697       sigval = 11;
698       break;			/* general protection */
699     case 14:
700       sigval = 11;
701       break;			/* page fault */
702     case 16:
703       sigval = 7;
704       break;			/* coprocessor error */
705     default:
706       sigval = 7;		/* "software generated" */
707     }
708   return (sigval);
709 }
710 
711 /**********************************************/
712 /* WHILE WE FIND NICE HEX CHARS, BUILD AN INT */
713 /* RETURN NUMBER OF CHARS PROCESSED           */
714 /**********************************************/
715 int
716 hexToInt (char **ptr, int *intValue)
717 {
718   int numChars = 0;
719   int hexValue;
720 
721   *intValue = 0;
722 
723   while (**ptr)
724     {
725       hexValue = hex (**ptr);
726       if (hexValue >= 0)
727 	{
728 	  *intValue = (*intValue << 4) | hexValue;
729 	  numChars++;
730 	}
731       else
732 	break;
733 
734       (*ptr)++;
735     }
736 
737   return (numChars);
738 }
739 
740 /*
741  * This function does all command procesing for interfacing to gdb.
742  */
743 void
744 handle_exception (int exceptionVector)
745 {
746   int sigval, stepping;
747   int addr, length;
748   char *ptr;
749   int newPC;
750 
751   gdb_i386vector = exceptionVector;
752 
753   if (remote_debug)
754     {
755       printf ("vector=%d, sr=0x%x, pc=0x%x\n",
756 	      exceptionVector, registers[PS], registers[PC]);
757     }
758 
759   /* reply to host that an exception has occurred */
760   sigval = computeSignal (exceptionVector);
761 
762   ptr = remcomOutBuffer;
763 
764   *ptr++ = 'T';			/* notify gdb with signo, PC, FP and SP */
765   *ptr++ = hexchars[sigval >> 4];
766   *ptr++ = hexchars[sigval & 0xf];
767 
768   *ptr++ = hexchars[ESP];
769   *ptr++ = ':';
770   ptr = mem2hex((char *)&registers[ESP], ptr, 4, 0);	/* SP */
771   *ptr++ = ';';
772 
773   *ptr++ = hexchars[EBP];
774   *ptr++ = ':';
775   ptr = mem2hex((char *)&registers[EBP], ptr, 4, 0); 	/* FP */
776   *ptr++ = ';';
777 
778   *ptr++ = hexchars[PC];
779   *ptr++ = ':';
780   ptr = mem2hex((char *)&registers[PC], ptr, 4, 0); 	/* PC */
781   *ptr++ = ';';
782 
783   *ptr = '\0'
784 
785   putpacket (remcomOutBuffer);
786 
787   stepping = 0;
788 
789   while (1 == 1)
790     {
791       remcomOutBuffer[0] = 0;
792       ptr = getpacket ();
793 
794       switch (*ptr++)
795 	{
796 	case '?':
797 	  remcomOutBuffer[0] = 'S';
798 	  remcomOutBuffer[1] = hexchars[sigval >> 4];
799 	  remcomOutBuffer[2] = hexchars[sigval % 16];
800 	  remcomOutBuffer[3] = 0;
801 	  break;
802 	case 'd':
803 	  remote_debug = !(remote_debug);	/* toggle debug flag */
804 	  break;
805 	case 'g':		/* return the value of the CPU registers */
806 	  mem2hex ((char *) registers, remcomOutBuffer, NUMREGBYTES, 0);
807 	  break;
808 	case 'G':		/* set the value of the CPU registers - return OK */
809 	  hex2mem (ptr, (char *) registers, NUMREGBYTES, 0);
810 	  strcpy (remcomOutBuffer, "OK");
811 	  break;
812 	case 'P':		/* set the value of a single CPU register - return OK */
813 	  {
814 	    int regno;
815 
816 	    if (hexToInt (&ptr, &regno) && *ptr++ == '=')
817 	      if (regno >= 0 && regno < NUMREGS)
818 		{
819 		  hex2mem (ptr, (char *) &registers[regno], 4, 0);
820 		  strcpy (remcomOutBuffer, "OK");
821 		  break;
822 		}
823 
824 	    strcpy (remcomOutBuffer, "E01");
825 	    break;
826 	  }
827 
828 	  /* mAA..AA,LLLL  Read LLLL bytes at address AA..AA */
829 	case 'm':
830 	  /* TRY TO READ %x,%x.  IF SUCCEED, SET PTR = 0 */
831 	  if (hexToInt (&ptr, &addr))
832 	    if (*(ptr++) == ',')
833 	      if (hexToInt (&ptr, &length))
834 		{
835 		  ptr = 0;
836 		  mem_err = 0;
837 		  mem2hex ((char *) addr, remcomOutBuffer, length, 1);
838 		  if (mem_err)
839 		    {
840 		      strcpy (remcomOutBuffer, "E03");
841 		      debug_error ("memory fault");
842 		    }
843 		}
844 
845 	  if (ptr)
846 	    {
847 	      strcpy (remcomOutBuffer, "E01");
848 	    }
849 	  break;
850 
851 	  /* MAA..AA,LLLL: Write LLLL bytes at address AA.AA return OK */
852 	case 'M':
853 	  /* TRY TO READ '%x,%x:'.  IF SUCCEED, SET PTR = 0 */
854 	  if (hexToInt (&ptr, &addr))
855 	    if (*(ptr++) == ',')
856 	      if (hexToInt (&ptr, &length))
857 		if (*(ptr++) == ':')
858 		  {
859 		    mem_err = 0;
860 		    hex2mem (ptr, (char *) addr, length, 1);
861 
862 		    if (mem_err)
863 		      {
864 			strcpy (remcomOutBuffer, "E03");
865 			debug_error ("memory fault");
866 		      }
867 		    else
868 		      {
869 			strcpy (remcomOutBuffer, "OK");
870 		      }
871 
872 		    ptr = 0;
873 		  }
874 	  if (ptr)
875 	    {
876 	      strcpy (remcomOutBuffer, "E02");
877 	    }
878 	  break;
879 
880 	  /* cAA..AA    Continue at address AA..AA(optional) */
881 	  /* sAA..AA   Step one instruction from AA..AA(optional) */
882 	case 's':
883 	  stepping = 1;
884 	case 'c':
885 	  /* try to read optional parameter, pc unchanged if no parm */
886 	  if (hexToInt (&ptr, &addr))
887 	    registers[PC] = addr;
888 
889 	  newPC = registers[PC];
890 
891 	  /* clear the trace bit */
892 	  registers[PS] &= 0xfffffeff;
893 
894 	  /* set the trace bit if we're stepping */
895 	  if (stepping)
896 	    registers[PS] |= 0x100;
897 
898 	  _returnFromException ();	/* this is a jump */
899 	  break;
900 
901 	  /* kill the program */
902 	case 'k':		/* do nothing */
903 #if 0
904 	  /* Huh? This doesn't look like "nothing".
905 	     m68k-stub.c and sparc-stub.c don't have it.  */
906 	  BREAKPOINT ();
907 #endif
908 	  break;
909 	}			/* switch */
910 
911       /* reply to the request */
912       putpacket (remcomOutBuffer);
913     }
914 }
915 
916 /* this function is used to set up exception handlers for tracing and
917    breakpoints */
918 void
919 set_debug_traps (void)
920 {
921   stackPtr = &remcomStack[STACKSIZE / sizeof (int) - 1];
922 
923   exceptionHandler (0, _catchException0);
924   exceptionHandler (1, _catchException1);
925   exceptionHandler (3, _catchException3);
926   exceptionHandler (4, _catchException4);
927   exceptionHandler (5, _catchException5);
928   exceptionHandler (6, _catchException6);
929   exceptionHandler (7, _catchException7);
930   exceptionHandler (8, _catchException8);
931   exceptionHandler (9, _catchException9);
932   exceptionHandler (10, _catchException10);
933   exceptionHandler (11, _catchException11);
934   exceptionHandler (12, _catchException12);
935   exceptionHandler (13, _catchException13);
936   exceptionHandler (14, _catchException14);
937   exceptionHandler (16, _catchException16);
938 
939   initialized = 1;
940 }
941 
942 /* This function will generate a breakpoint exception.  It is used at the
943    beginning of a program to sync up with a debugger and can be used
944    otherwise as a quick means to stop program execution and "break" into
945    the debugger.  */
946 
947 void
948 breakpoint (void)
949 {
950   if (initialized)
951     BREAKPOINT ();
952 }
953