1 /* Remote debugging interface for AMD 29000 EBMON on IBM PC, for GDB.
2 Copyright 1990-1991 Free Software Foundation, Inc.
3 Contributed by Cygnus Support. Written by Jim Kingdon for Cygnus.
5 This file is part of GDB.
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 2 of the License, or
10 (at your option) any later version.
12 This program is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with this program; if not, write to the Free Software
19 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. */
21 /* This is like remote.c but is for an esoteric situation--
22 having a 29k board in a PC hooked up to a unix machine with
23 a serial line, and running ctty com1 on the PC, through which
24 the unix machine can run ebmon. Not to mention that the PC
25 has PC/NFS, so it can access the same executables that gdb can,
26 over the net in real time. */
32 #include "param-no-tm.h"
43 extern void add_syms_addr_command ();
44 extern struct value *call_function_by_hand();
46 extern struct target_ops eb_ops; /* Forward declaration */
48 #define LOG_FILE "eb.log"
49 #if defined (LOG_FILE)
53 static int timeout = 5;
55 /* Descriptor for I/O to remote machine. Initialize it to -1 so that
56 eb_open knows that we don't have a file open when the program
60 /* stream which is fdopen'd from eb_desc. Only valid when
64 /* Read a character from the remote system, doing all the fancy
73 /* termio does the timeout for us. */
74 read (eb_desc, &buf, 1);
77 if (read (eb_desc, &buf, 1) < 0)
80 error ("Timeout reading from remote system.");
82 perror_with_name ("remote");
88 error ("Timeout reading from remote system.");
89 #if defined (LOG_FILE)
90 putc (buf & 0x7f, log_file);
95 /* Keep discarding input from the remote system, until STRING is found.
96 Let the user break out immediately. */
106 if (readchar() == *p)
120 /* Keep discarding input until we see the ebmon prompt.
122 The convention for dealing with the prompt is that you
124 o *then* wait for the prompt.
126 Thus the last thing that a procedure does with the serial line
127 will be an expect_prompt(). Exception: eb_resume does not
128 wait for the prompt, because the terminal is being handed over
129 to the inferior. However, the next thing which happens after that
130 is a eb_wait which does wait for the prompt.
131 Note that this includes abnormal exit, e.g. error(). This is
132 necessary to prevent getting into states from which we can't
137 #if defined (LOG_FILE)
138 /* This is a convenient place to do this. The idea is to do it often
139 enough that we never lose much data if we terminate abnormally. */
145 /* Get a hex digit from the remote system & return its value.
146 If ignore_space is nonzero, ignore spaces (not newline, tab, etc). */
148 get_hex_digit (ignore_space)
155 if (ch >= '0' && ch <= '9')
157 else if (ch >= 'A' && ch <= 'F')
158 return ch - 'A' + 10;
159 else if (ch >= 'a' && ch <= 'f')
160 return ch - 'a' + 10;
161 else if (ch == ' ' && ignore_space)
166 error ("Invalid hex digit from remote system.");
171 /* Get a byte from eb_desc and put it in *BYT. Accept any number
179 val = get_hex_digit (1) << 4;
180 val |= get_hex_digit (0);
184 /* Get N 32-bit words from remote, each preceded by a space,
185 and put them in registers starting at REGNO. */
187 get_hex_regs (n, regno)
194 for (i = 0; i < n; i++)
199 for (j = 0; j < 8; j++)
200 val = (val << 4) + get_hex_digit (j == 0);
201 supply_register (regno++, &val);
205 /* Called when SIGALRM signal sent due to alarm() timeout. */
209 #define volatile /**/
211 volatile int n_alarms;
218 printf ("eb_timer called\n");
224 /* malloc'd name of the program on the remote system. */
225 static char *prog_name = NULL;
227 /* Nonzero if we have loaded the file ("yc") and not yet issued a "gi"
228 command. "gi" is supposed to happen exactly once for each "yc". */
229 static int need_gi = 0;
231 /* Number of SIGTRAPs we need to simulate. That is, the next
232 NEED_ARTIFICIAL_TRAP calls to eb_wait should just return
233 SIGTRAP without actually waiting for anything. */
235 static int need_artificial_trap = 0;
237 /* This is called not only when we first attach, but also when the
238 user types "run" after having attached. */
240 eb_start (inferior_args)
243 /* OK, now read in the file. Y=read, C=COFF, D=no symbols
244 0=start address, %s=filename. */
246 fprintf (eb_stream, "YC D,0:%s", prog_name);
248 if (inferior_args != NULL)
249 fprintf(eb_stream, " %s", inferior_args);
251 fprintf (eb_stream, "\n");
259 /* Translate baud rates from integers to damn B_codes. Unix should
260 have outgrown this crap years ago, but even POSIX wouldn't buck it. */
269 struct {int rate, damn_b;} baudtab[] = {
294 for (i = 0; baudtab[i].rate != -1; i++)
295 if (rate == baudtab[i].rate) return baudtab[i].damn_b;
296 return B38400; /* Random */
300 /* Open a connection to a remote debugger.
301 NAME is the filename used for communication, then a space,
302 then the name of the program as we should name it to EBMON. */
304 static int baudrate = 9600;
305 static char *dev_name;
307 eb_open (name, from_tty)
315 target_preopen (from_tty);
317 /* Find the first whitespace character, it separates dev_name from
323 *p != '\0' && !isspace (*p); p++)
328 Please include the name of the device for the serial port,\n\
329 the baud rate, and the name of the program to run on the remote system.");
330 dev_name = alloca (p - name + 1);
331 strncpy (dev_name, name, p - name);
332 dev_name[p - name] = '\0';
334 /* Skip over the whitespace after dev_name */
335 for (; isspace (*p); p++)
338 if (1 != sscanf (p, "%d ", &baudrate))
341 /* Skip the number and then the spaces */
342 for (; isdigit (*p); p++)
344 for (; isspace (*p); p++)
347 if (prog_name != NULL)
349 prog_name = savestring (p, strlen (p));
353 eb_desc = open (dev_name, O_RDWR);
355 perror_with_name (dev_name);
356 ioctl (eb_desc, TIOCGETP, &sg);
358 sg.c_cc[VMIN] = 0; /* read with timeout. */
359 sg.c_cc[VTIME] = timeout * 10;
360 sg.c_lflag &= ~(ICANON | ECHO);
361 sg.c_cflag = (sg.c_cflag & ~CBAUD) | damn_b (baudrate);
363 sg.sg_ispeed = damn_b (baudrate);
364 sg.sg_ospeed = damn_b (baudrate);
365 sg.sg_flags |= RAW | ANYP;
366 sg.sg_flags &= ~ECHO;
369 ioctl (eb_desc, TIOCSETP, &sg);
370 eb_stream = fdopen (eb_desc, "r+");
372 push_target (&eb_ops);
374 printf ("Remote %s debugging %s using %s\n", target_shortname,
375 prog_name, dev_name);
378 #ifndef NO_SIGINTERRUPT
379 /* Cause SIGALRM's to make reads fail with EINTR instead of resuming
381 if (siginterrupt (SIGALRM, 1) != 0)
382 perror ("eb_open: error in siginterrupt");
385 /* Set up read timeout timer. */
386 if ((void (*)) signal (SIGALRM, eb_timer) == (void (*)) -1)
387 perror ("eb_open: error in signal");
390 #if defined (LOG_FILE)
391 log_file = fopen (LOG_FILE, "w");
392 if (log_file == NULL)
393 perror_with_name (LOG_FILE);
396 /* Hello? Are you there? */
397 write (eb_desc, "\n", 1);
402 /* Close out all files and local state before this target loses control. */
409 /* Due to a bug in Unix, fclose closes not only the stdio stream,
410 but also the file descriptor. So we don't actually close
413 fclose (eb_stream); /* This also closes eb_desc */
415 /* close (eb_desc); */
417 /* Do not try to close eb_desc again, later in the program. */
421 #if defined (LOG_FILE)
422 if (ferror (log_file))
423 printf ("Error writing log file.\n");
424 if (fclose (log_file) != 0)
425 printf ("Error closing log file.\n");
429 /* Terminate the open connection to the remote debugger.
430 Use this when you want to detach and do something else
436 pop_target(); /* calls eb_close to do the real work */
438 printf ("Ending remote %s debugging\n", target_shortname);
441 /* Tell the remote machine to resume. */
444 eb_resume (step, sig)
449 write (eb_desc, "t 1,s\n", 6);
450 /* Wait for the echo. */
452 /* Then comes a line containing the instruction we stepped to. */
454 /* Then we get the prompt. */
457 /* Force the next eb_wait to return a trap. Not doing anything
458 about I/O from the target means that the user has to type
459 "continue" to see any. This should be fixed. */
460 need_artificial_trap = 1;
467 write (eb_desc, "gi\n", 3);
469 /* Swallow the echo of "gi". */
474 write (eb_desc, "GR\n", 3);
475 /* Swallow the echo. */
481 /* Wait until the remote machine stops, then return,
482 storing status in STATUS just as `wait' would. */
488 /* Strings to look for. '?' means match any single character.
489 Note that with the algorithm we use, the initial character
490 of the string cannot recur in the string, or we will not
491 find some cases of the string in the input. */
493 static char bpt[] = "Invalid interrupt taken - #0x50 - ";
494 /* It would be tempting to look for "\n[__exit + 0x8]\n"
495 but that requires loading symbols with "yc i" and even if
496 we did do that we don't know that the file has symbols. */
497 static char exitmsg[] = "\n@????????I JMPTI GR121,LR0";
501 /* Large enough for either sizeof (bpt) or sizeof (exitmsg) chars. */
503 /* Current position in swallowed. */
504 char *swallowed_p = swallowed;
509 int old_timeout = timeout;
511 WSETEXIT ((*status), 0);
513 if (need_artificial_trap != 0)
515 WSETSTOP ((*status), SIGTRAP);
516 need_artificial_trap--;
520 timeout = 0; /* Don't time out -- user program is running. */
537 if (ch == *ep || *ep == '?')
554 /* Print out any characters which have been swallowed. */
555 for (p = swallowed; p < swallowed_p; ++p)
557 swallowed_p = swallowed;
564 WSETSTOP ((*status), SIGTRAP);
566 WSETEXIT ((*status), 0);
567 timeout = old_timeout;
572 /* Return the name of register number REGNO
573 in the form input and output by EBMON.
575 Returns a pointer to a static buffer containing the answer. */
581 if (regno >= GR96_REGNUM && regno < GR96_REGNUM + 32)
582 sprintf (buf, "GR%03d", regno - GR96_REGNUM + 96);
583 else if (regno >= LR0_REGNUM && regno < LR0_REGNUM + 128)
584 sprintf (buf, "LR%03d", regno - LR0_REGNUM);
585 else if (regno == Q_REGNUM)
586 strcpy (buf, "SR131");
587 else if (regno >= BP_REGNUM && regno <= CR_REGNUM)
588 sprintf (buf, "SR%03d", regno - BP_REGNUM + 133);
589 else if (regno == ALU_REGNUM)
590 strcpy (buf, "SR132");
591 else if (regno >= IPC_REGNUM && regno <= IPB_REGNUM)
592 sprintf (buf, "SR%03d", regno - IPC_REGNUM + 128);
593 else if (regno >= VAB_REGNUM && regno <= LRU_REGNUM)
594 sprintf (buf, "SR%03d", regno - VAB_REGNUM);
595 else if (regno == GR1_REGNUM)
596 strcpy (buf, "GR001");
600 /* Read the remote registers into the block REGS. */
603 eb_fetch_registers ()
611 /* This should not be necessary, because one is supposed to read the
612 registers only when the inferior is stopped (at least with
613 ptrace() and why not make it the same for remote?). */
614 /* ^A is the "normal character" used to make sure we are talking to EBMON
615 and not to the program being debugged. */
616 write (eb_desc, "\001\n");
620 write (eb_desc, "dw gr96,gr127\n", 14);
621 for (reg_index = 96, regnum_index = GR96_REGNUM;
623 reg_index += 4, regnum_index += 4)
625 sprintf (tempbuf, "GR%03d ", reg_index);
627 get_hex_regs (4, regnum_index);
631 for (i = 0; i < 128; i += 32)
633 /* The PC has a tendency to hang if we get these
634 all in one fell swoop ("dw lr0,lr127"). */
635 sprintf (tempbuf, "dw lr%d\n", i);
636 write (eb_desc, tempbuf, strlen (tempbuf));
637 for (reg_index = i, regnum_index = LR0_REGNUM + i;
639 reg_index += 4, regnum_index += 4)
641 sprintf (tempbuf, "LR%03d ", reg_index);
643 get_hex_regs (4, regnum_index);
648 write (eb_desc, "dw sr133,sr133\n", 15);
650 get_hex_regs (1, BP_REGNUM);
653 write (eb_desc, "dw sr134,sr134\n", 15);
655 get_hex_regs (1, FC_REGNUM);
658 write (eb_desc, "dw sr135,sr135\n", 15);
660 get_hex_regs (1, CR_REGNUM);
663 write (eb_desc, "dw sr131,sr131\n", 15);
665 get_hex_regs (1, Q_REGNUM);
668 write (eb_desc, "dw sr0,sr14\n", 12);
669 for (reg_index = 0, regnum_index = VAB_REGNUM;
670 regnum_index <= LRU_REGNUM;
671 regnum_index += 4, reg_index += 4)
673 sprintf (tempbuf, "SR%03d ", reg_index);
675 get_hex_regs (reg_index == 12 ? 3 : 4, regnum_index);
679 /* There doesn't seem to be any way to get these. */
682 supply_register (FPE_REGNUM, &val);
683 supply_register (INT_REGNUM, &val);
684 supply_register (FPS_REGNUM, &val);
685 supply_register (EXO_REGNUM, &val);
688 write (eb_desc, "dw gr1,gr1\n", 11);
690 get_hex_regs (1, GR1_REGNUM);
694 /* Fetch register REGNO, or all registers if REGNO is -1.
695 Returns errno value. */
697 eb_fetch_register (regno)
701 eb_fetch_registers ();
704 char *name = get_reg_name (regno);
705 fprintf (eb_stream, "dw %s,%s\n", name, name);
708 get_hex_regs (1, regno);
714 /* Store the remote registers from the contents of the block REGS. */
717 eb_store_registers ()
720 fprintf (eb_stream, "s gr1,%x\n", read_register (GR1_REGNUM));
723 for (j = 0; j < 32; j += 16)
725 fprintf (eb_stream, "s gr%d,", j + 96);
726 for (i = 0; i < 15; ++i)
727 fprintf (eb_stream, "%x,", read_register (GR96_REGNUM + j + i));
728 fprintf (eb_stream, "%x\n", read_register (GR96_REGNUM + j + 15));
732 for (j = 0; j < 128; j += 16)
734 fprintf (eb_stream, "s lr%d,", j);
735 for (i = 0; i < 15; ++i)
736 fprintf (eb_stream, "%x,", read_register (LR0_REGNUM + j + i));
737 fprintf (eb_stream, "%x\n", read_register (LR0_REGNUM + j + 15));
741 fprintf (eb_stream, "s sr133,%x,%x,%x\n", read_register (BP_REGNUM),
742 read_register (FC_REGNUM), read_register (CR_REGNUM));
744 fprintf (eb_stream, "s sr131,%x\n", read_register (Q_REGNUM));
746 fprintf (eb_stream, "s sr0,");
747 for (i = 0; i < 11; ++i)
748 fprintf (eb_stream, "%x,", read_register (VAB_REGNUM + i));
749 fprintf (eb_stream, "%x\n", read_register (VAB_REGNUM + 11));
753 /* Store register REGNO, or all if REGNO == 0.
754 Return errno value. */
756 eb_store_register (regno)
760 eb_store_registers ();
763 char *name = get_reg_name (regno);
764 fprintf (eb_stream, "s %s,%x\n", name, read_register (regno));
765 /* Setting GR1 changes the numbers of all the locals, so
766 invalidate the register cache. Do this *after* calling
767 read_register, because we want read_register to return the
768 value that write_register has just stuffed into the registers
769 array, not the value of the register fetched from the
771 if (regno == GR1_REGNUM)
772 registers_changed ();
778 /* Get ready to modify the registers array. On machines which store
779 individual registers, this doesn't need to do anything. On machines
780 which store all the registers in one fell swoop, this makes sure
781 that registers contains all the registers from the program being
785 eb_prepare_to_store ()
787 /* Do nothing, since we can store individual regs */
790 /* FIXME! Merge these two. */
792 eb_xfer_inferior_memory (memaddr, myaddr, len, write)
799 return eb_write_inferior_memory (memaddr, myaddr, len);
801 return eb_write_inferior_memory (memaddr, myaddr, len);
807 printf ("\tAttached to %s at %d baud and running program %s.\n",
808 dev_name, baudrate, prog_name);
811 /* Copy LEN bytes of data from debugger memory at MYADDR
812 to inferior's memory at MEMADDR. Returns errno value. */
814 eb_write_inferior_memory (memaddr, myaddr, len)
821 for (i = 0; i < len; i++)
824 fprintf (eb_stream, "sb %x,", memaddr + i);
825 if ((i % 16) == 15 || i == len - 1)
827 fprintf (eb_stream, "%x\n", ((unsigned char *)myaddr)[i]);
831 fprintf (eb_stream, "%x,", ((unsigned char *)myaddr)[i]);
836 /* Read LEN bytes from inferior memory at MEMADDR. Put the result
837 at debugger address MYADDR. Returns errno value. */
839 eb_read_inferior_memory(memaddr, myaddr, len)
846 /* Number of bytes read so far. */
849 /* Starting address of this pass. */
850 unsigned long startaddr;
852 /* Number of bytes to read in this pass. */
855 /* Note that this code works correctly if startaddr is just less
856 than UINT_MAX (well, really CORE_ADDR_MAX if there was such a
857 thing). That is, something like
858 eb_read_bytes (CORE_ADDR_MAX - 4, foo, 4)
859 works--it never adds len to memaddr and gets 0. */
860 /* However, something like
861 eb_read_bytes (CORE_ADDR_MAX - 3, foo, 4)
862 doesn't need to work. Detect it and give up if there's an attempt
864 if (((memaddr - 1) + len) < memaddr)
872 if ((startaddr % 16) != 0)
873 len_this_pass -= startaddr % 16;
874 if (len_this_pass > (len - count))
875 len_this_pass = (len - count);
877 fprintf (eb_stream, "db %x,%x\n", startaddr,
878 (startaddr - 1) + len_this_pass);
881 /* Look for 8 hex digits. */
885 if (isxdigit (readchar ()))
890 error ("Hex digit expected from remote system.");
898 for (i = 0; i < len_this_pass; i++)
899 get_hex_byte (&myaddr[count++]);
903 startaddr += len_this_pass;
908 /* Define the target subroutine names */
910 struct target_ops eb_ops = {
911 "amd-eb", "Remote serial AMD EBMON target",
912 "Use a remote computer running EBMON connected by a serial line.\n\
913 Arguments are the name of the device for the serial line,\n\
914 the speed to connect at in bits per second, and the filename of the\n\
915 executable as it exists on the remote computer. For example,\n\
916 target amd-eb /dev/ttya 9600 demo",
918 0, eb_detach, eb_resume, eb_wait,
919 eb_fetch_register, eb_store_register,
920 eb_prepare_to_store, 0, 0, /* conv_to, conv_from */
921 eb_xfer_inferior_memory, eb_files_info,
922 0, 0, /* Breakpoints */
923 0, 0, 0, 0, 0, /* Terminal handling */
925 0, add_syms_addr_command, /* load */
926 call_function_by_hand,
927 0, /* lookup_symbol */
928 0, /* create_inferior FIXME, eb_start here or something? */
929 0, /* mourn_inferior FIXME */
930 process_stratum, 0, /* next */
931 1, 1, 1, 1, 1, /* all mem, mem, stack, regs, exec */
932 OPS_MAGIC, /* Always the last thing */
936 _initialize_remote_eb ()
938 add_target (&eb_ops);