HAMMER: MFC to 2.0
[dragonfly.git] / contrib / gdb-6.2.1 / gdb / monitor.c
bloba3f6672f74a7f429c5e7222682f01cee7a3bea48
1 /* Remote debugging interface for boot monitors, for GDB.
3 Copyright 1990, 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998,
4 1999, 2000, 2001, 2002 Free Software Foundation, Inc.
6 Contributed by Cygnus Support. Written by Rob Savoye for Cygnus.
7 Resurrected from the ashes by Stu Grossman.
9 This file is part of GDB.
11 This program is free software; you can redistribute it and/or modify
12 it under the terms of the GNU General Public License as published by
13 the Free Software Foundation; either version 2 of the License, or
14 (at your option) any later version.
16 This program is distributed in the hope that it will be useful,
17 but WITHOUT ANY WARRANTY; without even the implied warranty of
18 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
19 GNU General Public License for more details.
21 You should have received a copy of the GNU General Public License
22 along with this program; if not, write to the Free Software
23 Foundation, Inc., 59 Temple Place - Suite 330,
24 Boston, MA 02111-1307, USA. */
26 /* This file was derived from various remote-* modules. It is a collection
27 of generic support functions so GDB can talk directly to a ROM based
28 monitor. This saves use from having to hack an exception based handler
29 into existence, and makes for quick porting.
31 This module talks to a debug monitor called 'MONITOR', which
32 We communicate with MONITOR via either a direct serial line, or a TCP
33 (or possibly TELNET) stream to a terminal multiplexor,
34 which in turn talks to the target board. */
36 /* FIXME 32x64: This code assumes that registers and addresses are at
37 most 32 bits long. If they can be larger, you will need to declare
38 values as LONGEST and use %llx or some such to print values when
39 building commands to send to the monitor. Since we don't know of
40 any actual 64-bit targets with ROM monitors that use this code,
41 it's not an issue right now. -sts 4/18/96 */
43 #include "defs.h"
44 #include "gdbcore.h"
45 #include "target.h"
46 #include <signal.h>
47 #include <ctype.h>
48 #include "gdb_string.h"
49 #include <sys/types.h>
50 #include "command.h"
51 #include "serial.h"
52 #include "monitor.h"
53 #include "gdbcmd.h"
54 #include "inferior.h"
55 #include "gdb_regex.h"
56 #include "srec.h"
57 #include "regcache.h"
59 static char *dev_name;
60 static struct target_ops *targ_ops;
62 static void monitor_vsprintf (char *sndbuf, char *pattern, va_list args);
64 static int readchar (int timeout);
66 static void monitor_fetch_register (int regno);
67 static void monitor_store_register (int regno);
69 static void monitor_printable_string (char *newstr, char *oldstr, int len);
70 static void monitor_error (char *function, char *message, CORE_ADDR memaddr, int len, char *string, int final_char);
71 static void monitor_detach (char *args, int from_tty);
72 static void monitor_resume (ptid_t ptid, int step, enum target_signal sig);
73 static void monitor_interrupt (int signo);
74 static void monitor_interrupt_twice (int signo);
75 static void monitor_interrupt_query (void);
76 static void monitor_wait_cleanup (void *old_timeout);
78 static ptid_t monitor_wait (ptid_t ptid, struct target_waitstatus *status);
79 static void monitor_fetch_registers (int regno);
80 static void monitor_store_registers (int regno);
81 static void monitor_prepare_to_store (void);
82 static int monitor_xfer_memory (CORE_ADDR memaddr, char *myaddr, int len,
83 int write,
84 struct mem_attrib *attrib,
85 struct target_ops *target);
86 static void monitor_files_info (struct target_ops *ops);
87 static int monitor_insert_breakpoint (CORE_ADDR addr, char *shadow);
88 static int monitor_remove_breakpoint (CORE_ADDR addr, char *shadow);
89 static void monitor_kill (void);
90 static void monitor_load (char *file, int from_tty);
91 static void monitor_mourn_inferior (void);
92 static void monitor_stop (void);
94 static int monitor_read_memory (CORE_ADDR addr, char *myaddr, int len);
95 static int monitor_write_memory (CORE_ADDR addr, char *myaddr, int len);
96 static int monitor_write_memory_bytes (CORE_ADDR addr, char *myaddr, int len);
97 static int monitor_write_memory_block (CORE_ADDR memaddr,
98 char *myaddr, int len);
99 static int monitor_expect_regexp (struct re_pattern_buffer *pat,
100 char *buf, int buflen);
101 static void monitor_dump_regs (void);
102 #if 0
103 static int from_hex (int a);
104 static unsigned long get_hex_word (void);
105 #endif
106 static void parse_register_dump (char *, int);
108 static struct monitor_ops *current_monitor;
110 static int hashmark; /* flag set by "set hash" */
112 static int timeout = 30;
114 static int in_monitor_wait = 0; /* Non-zero means we are in monitor_wait() */
116 static void (*ofunc) (); /* Old SIGINT signal handler */
118 static CORE_ADDR *breakaddr;
120 /* Descriptor for I/O to remote machine. Initialize it to NULL so
121 that monitor_open knows that we don't have a file open when the
122 program starts. */
124 static struct serial *monitor_desc = NULL;
126 /* Pointer to regexp pattern matching data */
128 static struct re_pattern_buffer register_pattern;
129 static char register_fastmap[256];
131 static struct re_pattern_buffer getmem_resp_delim_pattern;
132 static char getmem_resp_delim_fastmap[256];
134 static struct re_pattern_buffer setmem_resp_delim_pattern;
135 static char setmem_resp_delim_fastmap[256];
137 static struct re_pattern_buffer setreg_resp_delim_pattern;
138 static char setreg_resp_delim_fastmap[256];
140 static int dump_reg_flag; /* Non-zero means do a dump_registers cmd when
141 monitor_wait wakes up. */
143 static int first_time = 0; /* is this the first time we're executing after
144 gaving created the child proccess? */
146 #define TARGET_BUF_SIZE 2048
148 /* Monitor specific debugging information. Typically only useful to
149 the developer of a new monitor interface. */
151 static void monitor_debug (const char *fmt, ...) ATTR_FORMAT(printf, 1, 2);
153 static int monitor_debug_p = 0;
155 /* NOTE: This file alternates between monitor_debug_p and remote_debug
156 when determining if debug information is printed. Perhaphs this
157 could be simplified. */
159 static void
160 monitor_debug (const char *fmt, ...)
162 if (monitor_debug_p)
164 va_list args;
165 va_start (args, fmt);
166 vfprintf_filtered (gdb_stdlog, fmt, args);
167 va_end (args);
172 /* Convert a string into a printable representation, Return # byte in
173 the new string. When LEN is >0 it specifies the size of the
174 string. Otherwize strlen(oldstr) is used. */
176 static void
177 monitor_printable_string (char *newstr, char *oldstr, int len)
179 int ch;
180 int i;
182 if (len <= 0)
183 len = strlen (oldstr);
185 for (i = 0; i < len; i++)
187 ch = oldstr[i];
188 switch (ch)
190 default:
191 if (isprint (ch))
192 *newstr++ = ch;
194 else
196 sprintf (newstr, "\\x%02x", ch & 0xff);
197 newstr += 4;
199 break;
201 case '\\':
202 *newstr++ = '\\';
203 *newstr++ = '\\';
204 break;
205 case '\b':
206 *newstr++ = '\\';
207 *newstr++ = 'b';
208 break;
209 case '\f':
210 *newstr++ = '\\';
211 *newstr++ = 't';
212 break;
213 case '\n':
214 *newstr++ = '\\';
215 *newstr++ = 'n';
216 break;
217 case '\r':
218 *newstr++ = '\\';
219 *newstr++ = 'r';
220 break;
221 case '\t':
222 *newstr++ = '\\';
223 *newstr++ = 't';
224 break;
225 case '\v':
226 *newstr++ = '\\';
227 *newstr++ = 'v';
228 break;
232 *newstr++ = '\0';
235 /* Print monitor errors with a string, converting the string to printable
236 representation. */
238 static void
239 monitor_error (char *function, char *message,
240 CORE_ADDR memaddr, int len, char *string, int final_char)
242 int real_len = (len == 0 && string != (char *) 0) ? strlen (string) : len;
243 char *safe_string = alloca ((real_len * 4) + 1);
244 monitor_printable_string (safe_string, string, real_len);
246 if (final_char)
247 error ("%s (0x%s): %s: %s%c", function, paddr_nz (memaddr), message, safe_string, final_char);
248 else
249 error ("%s (0x%s): %s: %s", function, paddr_nz (memaddr), message, safe_string);
252 /* Convert hex digit A to a number. */
254 static int
255 fromhex (int a)
257 if (a >= '0' && a <= '9')
258 return a - '0';
259 else if (a >= 'a' && a <= 'f')
260 return a - 'a' + 10;
261 else if (a >= 'A' && a <= 'F')
262 return a - 'A' + 10;
263 else
264 error ("Invalid hex digit %d", a);
267 /* monitor_vsprintf - similar to vsprintf but handles 64-bit addresses
269 This function exists to get around the problem that many host platforms
270 don't have a printf that can print 64-bit addresses. The %A format
271 specification is recognized as a special case, and causes the argument
272 to be printed as a 64-bit hexadecimal address.
274 Only format specifiers of the form "[0-9]*[a-z]" are recognized.
275 If it is a '%s' format, the argument is a string; otherwise the
276 argument is assumed to be a long integer.
278 %% is also turned into a single %.
281 static void
282 monitor_vsprintf (char *sndbuf, char *pattern, va_list args)
284 char format[10];
285 char fmt;
286 char *p;
287 int i;
288 long arg_int;
289 CORE_ADDR arg_addr;
290 char *arg_string;
292 for (p = pattern; *p; p++)
294 if (*p == '%')
296 /* Copy the format specifier to a separate buffer. */
297 format[0] = *p++;
298 for (i = 1; *p >= '0' && *p <= '9' && i < (int) sizeof (format) - 2;
299 i++, p++)
300 format[i] = *p;
301 format[i] = fmt = *p;
302 format[i + 1] = '\0';
304 /* Fetch the next argument and print it. */
305 switch (fmt)
307 case '%':
308 strcpy (sndbuf, "%");
309 break;
310 case 'A':
311 arg_addr = va_arg (args, CORE_ADDR);
312 strcpy (sndbuf, paddr_nz (arg_addr));
313 break;
314 case 's':
315 arg_string = va_arg (args, char *);
316 sprintf (sndbuf, format, arg_string);
317 break;
318 default:
319 arg_int = va_arg (args, long);
320 sprintf (sndbuf, format, arg_int);
321 break;
323 sndbuf += strlen (sndbuf);
325 else
326 *sndbuf++ = *p;
328 *sndbuf = '\0';
332 /* monitor_printf_noecho -- Send data to monitor, but don't expect an echo.
333 Works just like printf. */
335 void
336 monitor_printf_noecho (char *pattern,...)
338 va_list args;
339 char sndbuf[2000];
340 int len;
342 va_start (args, pattern);
344 monitor_vsprintf (sndbuf, pattern, args);
346 len = strlen (sndbuf);
347 if (len + 1 > sizeof sndbuf)
348 internal_error (__FILE__, __LINE__, "failed internal consistency check");
350 if (monitor_debug_p)
352 char *safe_string = (char *) alloca ((strlen (sndbuf) * 4) + 1);
353 monitor_printable_string (safe_string, sndbuf, 0);
354 fprintf_unfiltered (gdb_stdlog, "sent[%s]\n", safe_string);
357 monitor_write (sndbuf, len);
360 /* monitor_printf -- Send data to monitor and check the echo. Works just like
361 printf. */
363 void
364 monitor_printf (char *pattern,...)
366 va_list args;
367 char sndbuf[2000];
368 int len;
370 va_start (args, pattern);
372 monitor_vsprintf (sndbuf, pattern, args);
374 len = strlen (sndbuf);
375 if (len + 1 > sizeof sndbuf)
376 internal_error (__FILE__, __LINE__, "failed internal consistency check");
378 if (monitor_debug_p)
380 char *safe_string = (char *) alloca ((len * 4) + 1);
381 monitor_printable_string (safe_string, sndbuf, 0);
382 fprintf_unfiltered (gdb_stdlog, "sent[%s]\n", safe_string);
385 monitor_write (sndbuf, len);
387 /* We used to expect that the next immediate output was the characters we
388 just output, but sometimes some extra junk appeared before the characters
389 we expected, like an extra prompt, or a portmaster sending telnet negotiations.
390 So, just start searching for what we sent, and skip anything unknown. */
391 monitor_debug ("ExpectEcho\n");
392 monitor_expect (sndbuf, (char *) 0, 0);
396 /* Write characters to the remote system. */
398 void
399 monitor_write (char *buf, int buflen)
401 if (serial_write (monitor_desc, buf, buflen))
402 fprintf_unfiltered (gdb_stderr, "serial_write failed: %s\n",
403 safe_strerror (errno));
407 /* Read a binary character from the remote system, doing all the fancy
408 timeout stuff, but without interpreting the character in any way,
409 and without printing remote debug information. */
412 monitor_readchar (void)
414 int c;
415 int looping;
419 looping = 0;
420 c = serial_readchar (monitor_desc, timeout);
422 if (c >= 0)
423 c &= 0xff; /* don't lose bit 7 */
425 while (looping);
427 if (c >= 0)
428 return c;
430 if (c == SERIAL_TIMEOUT)
431 error ("Timeout reading from remote system.");
433 perror_with_name ("remote-monitor");
437 /* Read a character from the remote system, doing all the fancy
438 timeout stuff. */
440 static int
441 readchar (int timeout)
443 int c;
444 static enum
446 last_random, last_nl, last_cr, last_crnl
448 state = last_random;
449 int looping;
453 looping = 0;
454 c = serial_readchar (monitor_desc, timeout);
456 if (c >= 0)
458 c &= 0x7f;
459 /* This seems to interfere with proper function of the
460 input stream */
461 if (monitor_debug_p || remote_debug)
463 char buf[2];
464 buf[0] = c;
465 buf[1] = '\0';
466 puts_debug ("read -->", buf, "<--");
471 /* Canonicialize \n\r combinations into one \r */
472 if ((current_monitor->flags & MO_HANDLE_NL) != 0)
474 if ((c == '\r' && state == last_nl)
475 || (c == '\n' && state == last_cr))
477 state = last_crnl;
478 looping = 1;
480 else if (c == '\r')
481 state = last_cr;
482 else if (c != '\n')
483 state = last_random;
484 else
486 state = last_nl;
487 c = '\r';
491 while (looping);
493 if (c >= 0)
494 return c;
496 if (c == SERIAL_TIMEOUT)
497 #if 0
498 /* I fail to see how detaching here can be useful */
499 if (in_monitor_wait) /* Watchdog went off */
501 target_mourn_inferior ();
502 error ("GDB serial timeout has expired. Target detached.\n");
504 else
505 #endif
506 error ("Timeout reading from remote system.");
508 perror_with_name ("remote-monitor");
511 /* Scan input from the remote system, until STRING is found. If BUF is non-
512 zero, then collect input until we have collected either STRING or BUFLEN-1
513 chars. In either case we terminate BUF with a 0. If input overflows BUF
514 because STRING can't be found, return -1, else return number of chars in BUF
515 (minus the terminating NUL). Note that in the non-overflow case, STRING
516 will be at the end of BUF. */
519 monitor_expect (char *string, char *buf, int buflen)
521 char *p = string;
522 int obuflen = buflen;
523 int c;
525 if (monitor_debug_p)
527 char *safe_string = (char *) alloca ((strlen (string) * 4) + 1);
528 monitor_printable_string (safe_string, string, 0);
529 fprintf_unfiltered (gdb_stdlog, "MON Expecting '%s'\n", safe_string);
532 immediate_quit++;
533 while (1)
535 if (buf)
537 if (buflen < 2)
539 *buf = '\000';
540 immediate_quit--;
541 return -1;
544 c = readchar (timeout);
545 if (c == '\000')
546 continue;
547 *buf++ = c;
548 buflen--;
550 else
551 c = readchar (timeout);
553 /* Don't expect any ^C sent to be echoed */
555 if (*p == '\003' || c == *p)
557 p++;
558 if (*p == '\0')
560 immediate_quit--;
562 if (buf)
564 *buf++ = '\000';
565 return obuflen - buflen;
567 else
568 return 0;
571 else
573 /* We got a character that doesn't match the string. We need to
574 back up p, but how far? If we're looking for "..howdy" and the
575 monitor sends "...howdy"? There's certainly a match in there,
576 but when we receive the third ".", we won't find it if we just
577 restart the matching at the beginning of the string.
579 This is a Boyer-Moore kind of situation. We want to reset P to
580 the end of the longest prefix of STRING that is a suffix of
581 what we've read so far. In the example above, that would be
582 ".." --- the longest prefix of "..howdy" that is a suffix of
583 "...". This longest prefix could be the empty string, if C
584 is nowhere to be found in STRING.
586 If this longest prefix is not the empty string, it must contain
587 C, so let's search from the end of STRING for instances of C,
588 and see if the portion of STRING before that is a suffix of
589 what we read before C. Actually, we can search backwards from
590 p, since we know no prefix can be longer than that.
592 Note that we can use STRING itself, along with C, as a record
593 of what we've received so far. :) */
594 int i;
596 for (i = (p - string) - 1; i >= 0; i--)
597 if (string[i] == c)
599 /* Is this prefix a suffix of what we've read so far?
600 In other words, does
601 string[0 .. i-1] == string[p - i, p - 1]? */
602 if (! memcmp (string, p - i, i))
604 p = string + i + 1;
605 break;
608 if (i < 0)
609 p = string;
614 /* Search for a regexp. */
616 static int
617 monitor_expect_regexp (struct re_pattern_buffer *pat, char *buf, int buflen)
619 char *mybuf;
620 char *p;
621 monitor_debug ("MON Expecting regexp\n");
622 if (buf)
623 mybuf = buf;
624 else
626 mybuf = alloca (TARGET_BUF_SIZE);
627 buflen = TARGET_BUF_SIZE;
630 p = mybuf;
631 while (1)
633 int retval;
635 if (p - mybuf >= buflen)
636 { /* Buffer about to overflow */
638 /* On overflow, we copy the upper half of the buffer to the lower half. Not
639 great, but it usually works... */
641 memcpy (mybuf, mybuf + buflen / 2, buflen / 2);
642 p = mybuf + buflen / 2;
645 *p++ = readchar (timeout);
647 retval = re_search (pat, mybuf, p - mybuf, 0, p - mybuf, NULL);
648 if (retval >= 0)
649 return 1;
653 /* Keep discarding input until we see the MONITOR prompt.
655 The convention for dealing with the prompt is that you
656 o give your command
657 o *then* wait for the prompt.
659 Thus the last thing that a procedure does with the serial line will
660 be an monitor_expect_prompt(). Exception: monitor_resume does not
661 wait for the prompt, because the terminal is being handed over to
662 the inferior. However, the next thing which happens after that is
663 a monitor_wait which does wait for the prompt. Note that this
664 includes abnormal exit, e.g. error(). This is necessary to prevent
665 getting into states from which we can't recover. */
668 monitor_expect_prompt (char *buf, int buflen)
670 monitor_debug ("MON Expecting prompt\n");
671 return monitor_expect (current_monitor->prompt, buf, buflen);
674 /* Get N 32-bit words from remote, each preceded by a space, and put
675 them in registers starting at REGNO. */
677 #if 0
678 static unsigned long
679 get_hex_word (void)
681 unsigned long val;
682 int i;
683 int ch;
686 ch = readchar (timeout);
687 while (isspace (ch));
689 val = from_hex (ch);
691 for (i = 7; i >= 1; i--)
693 ch = readchar (timeout);
694 if (!isxdigit (ch))
695 break;
696 val = (val << 4) | from_hex (ch);
699 return val;
701 #endif
703 static void
704 compile_pattern (char *pattern, struct re_pattern_buffer *compiled_pattern,
705 char *fastmap)
707 int tmp;
708 const char *val;
710 compiled_pattern->fastmap = fastmap;
712 tmp = re_set_syntax (RE_SYNTAX_EMACS);
713 val = re_compile_pattern (pattern,
714 strlen (pattern),
715 compiled_pattern);
716 re_set_syntax (tmp);
718 if (val)
719 error ("compile_pattern: Can't compile pattern string `%s': %s!", pattern, val);
721 if (fastmap)
722 re_compile_fastmap (compiled_pattern);
725 /* Open a connection to a remote debugger. NAME is the filename used
726 for communication. */
728 void
729 monitor_open (char *args, struct monitor_ops *mon_ops, int from_tty)
731 char *name;
732 char **p;
734 if (mon_ops->magic != MONITOR_OPS_MAGIC)
735 error ("Magic number of monitor_ops struct wrong.");
737 targ_ops = mon_ops->target;
738 name = targ_ops->to_shortname;
740 if (!args)
741 error ("Use `target %s DEVICE-NAME' to use a serial port, or \n\
742 `target %s HOST-NAME:PORT-NUMBER' to use a network connection.", name, name);
744 target_preopen (from_tty);
746 /* Setup pattern for register dump */
748 if (mon_ops->register_pattern)
749 compile_pattern (mon_ops->register_pattern, &register_pattern,
750 register_fastmap);
752 if (mon_ops->getmem.resp_delim)
753 compile_pattern (mon_ops->getmem.resp_delim, &getmem_resp_delim_pattern,
754 getmem_resp_delim_fastmap);
756 if (mon_ops->setmem.resp_delim)
757 compile_pattern (mon_ops->setmem.resp_delim, &setmem_resp_delim_pattern,
758 setmem_resp_delim_fastmap);
760 if (mon_ops->setreg.resp_delim)
761 compile_pattern (mon_ops->setreg.resp_delim, &setreg_resp_delim_pattern,
762 setreg_resp_delim_fastmap);
764 unpush_target (targ_ops);
766 if (dev_name)
767 xfree (dev_name);
768 dev_name = xstrdup (args);
770 monitor_desc = serial_open (dev_name);
772 if (!monitor_desc)
773 perror_with_name (dev_name);
775 if (baud_rate != -1)
777 if (serial_setbaudrate (monitor_desc, baud_rate))
779 serial_close (monitor_desc);
780 perror_with_name (dev_name);
784 serial_raw (monitor_desc);
786 serial_flush_input (monitor_desc);
788 /* some systems only work with 2 stop bits */
790 serial_setstopbits (monitor_desc, mon_ops->stopbits);
792 current_monitor = mon_ops;
794 /* See if we can wake up the monitor. First, try sending a stop sequence,
795 then send the init strings. Last, remove all breakpoints. */
797 if (current_monitor->stop)
799 monitor_stop ();
800 if ((current_monitor->flags & MO_NO_ECHO_ON_OPEN) == 0)
802 monitor_debug ("EXP Open echo\n");
803 monitor_expect_prompt (NULL, 0);
807 /* wake up the monitor and see if it's alive */
808 for (p = mon_ops->init; *p != NULL; p++)
810 /* Some of the characters we send may not be echoed,
811 but we hope to get a prompt at the end of it all. */
813 if ((current_monitor->flags & MO_NO_ECHO_ON_OPEN) == 0)
814 monitor_printf (*p);
815 else
816 monitor_printf_noecho (*p);
817 monitor_expect_prompt (NULL, 0);
820 serial_flush_input (monitor_desc);
822 /* Alloc breakpoints */
823 if (mon_ops->set_break != NULL)
825 if (mon_ops->num_breakpoints == 0)
826 mon_ops->num_breakpoints = 8;
828 breakaddr = (CORE_ADDR *) xmalloc (mon_ops->num_breakpoints * sizeof (CORE_ADDR));
829 memset (breakaddr, 0, mon_ops->num_breakpoints * sizeof (CORE_ADDR));
832 /* Remove all breakpoints */
834 if (mon_ops->clr_all_break)
836 monitor_printf (mon_ops->clr_all_break);
837 monitor_expect_prompt (NULL, 0);
840 if (from_tty)
841 printf_unfiltered ("Remote target %s connected to %s\n", name, dev_name);
843 push_target (targ_ops);
845 inferior_ptid = pid_to_ptid (42000); /* Make run command think we are busy... */
847 /* Give monitor_wait something to read */
849 monitor_printf (current_monitor->line_term);
851 start_remote ();
854 /* Close out all files and local state before this target loses
855 control. */
857 void
858 monitor_close (int quitting)
860 if (monitor_desc)
861 serial_close (monitor_desc);
863 /* Free breakpoint memory */
864 if (breakaddr != NULL)
866 xfree (breakaddr);
867 breakaddr = NULL;
870 monitor_desc = NULL;
873 /* Terminate the open connection to the remote debugger. Use this
874 when you want to detach and do something else with your gdb. */
876 static void
877 monitor_detach (char *args, int from_tty)
879 pop_target (); /* calls monitor_close to do the real work */
880 if (from_tty)
881 printf_unfiltered ("Ending remote %s debugging\n", target_shortname);
884 /* Convert VALSTR into the target byte-ordered value of REGNO and store it. */
886 char *
887 monitor_supply_register (int regno, char *valstr)
889 ULONGEST val;
890 unsigned char regbuf[MAX_REGISTER_SIZE];
891 char *p;
893 val = 0;
894 p = valstr;
895 while (p && *p != '\0')
897 if (*p == '\r' || *p == '\n')
899 while (*p != '\0')
900 p++;
901 break;
903 if (isspace (*p))
905 p++;
906 continue;
908 if (!isxdigit (*p) && *p != 'x')
910 break;
913 val <<= 4;
914 val += fromhex (*p++);
916 monitor_debug ("Supplying Register %d %s\n", regno, valstr);
918 if (val == 0 && valstr == p)
919 error ("monitor_supply_register (%d): bad value from monitor: %s.",
920 regno, valstr);
922 /* supply register stores in target byte order, so swap here */
924 store_unsigned_integer (regbuf, DEPRECATED_REGISTER_RAW_SIZE (regno), val);
926 supply_register (regno, regbuf);
928 return p;
931 /* Tell the remote machine to resume. */
933 static void
934 monitor_resume (ptid_t ptid, int step, enum target_signal sig)
936 /* Some monitors require a different command when starting a program */
937 monitor_debug ("MON resume\n");
938 if (current_monitor->flags & MO_RUN_FIRST_TIME && first_time == 1)
940 first_time = 0;
941 monitor_printf ("run\r");
942 if (current_monitor->flags & MO_NEED_REGDUMP_AFTER_CONT)
943 dump_reg_flag = 1;
944 return;
946 if (step)
947 monitor_printf (current_monitor->step);
948 else
950 if (current_monitor->continue_hook)
951 (*current_monitor->continue_hook) ();
952 else
953 monitor_printf (current_monitor->cont);
954 if (current_monitor->flags & MO_NEED_REGDUMP_AFTER_CONT)
955 dump_reg_flag = 1;
959 /* Parse the output of a register dump command. A monitor specific
960 regexp is used to extract individual register descriptions of the
961 form REG=VAL. Each description is split up into a name and a value
962 string which are passed down to monitor specific code. */
964 static void
965 parse_register_dump (char *buf, int len)
967 monitor_debug ("MON Parsing register dump\n");
968 while (1)
970 int regnamelen, vallen;
971 char *regname, *val;
972 /* Element 0 points to start of register name, and element 1
973 points to the start of the register value. */
974 struct re_registers register_strings;
976 memset (&register_strings, 0, sizeof (struct re_registers));
978 if (re_search (&register_pattern, buf, len, 0, len,
979 &register_strings) == -1)
980 break;
982 regnamelen = register_strings.end[1] - register_strings.start[1];
983 regname = buf + register_strings.start[1];
984 vallen = register_strings.end[2] - register_strings.start[2];
985 val = buf + register_strings.start[2];
987 current_monitor->supply_register (regname, regnamelen, val, vallen);
989 buf += register_strings.end[0];
990 len -= register_strings.end[0];
994 /* Send ^C to target to halt it. Target will respond, and send us a
995 packet. */
997 static void
998 monitor_interrupt (int signo)
1000 /* If this doesn't work, try more severe steps. */
1001 signal (signo, monitor_interrupt_twice);
1003 if (monitor_debug_p || remote_debug)
1004 fprintf_unfiltered (gdb_stdlog, "monitor_interrupt called\n");
1006 target_stop ();
1009 /* The user typed ^C twice. */
1011 static void
1012 monitor_interrupt_twice (int signo)
1014 signal (signo, ofunc);
1016 monitor_interrupt_query ();
1018 signal (signo, monitor_interrupt);
1021 /* Ask the user what to do when an interrupt is received. */
1023 static void
1024 monitor_interrupt_query (void)
1026 target_terminal_ours ();
1028 if (query ("Interrupted while waiting for the program.\n\
1029 Give up (and stop debugging it)? "))
1031 target_mourn_inferior ();
1032 throw_exception (RETURN_QUIT);
1035 target_terminal_inferior ();
1038 static void
1039 monitor_wait_cleanup (void *old_timeout)
1041 timeout = *(int *) old_timeout;
1042 signal (SIGINT, ofunc);
1043 in_monitor_wait = 0;
1048 static void
1049 monitor_wait_filter (char *buf,
1050 int bufmax,
1051 int *ext_resp_len,
1052 struct target_waitstatus *status)
1054 int resp_len;
1057 resp_len = monitor_expect_prompt (buf, bufmax);
1058 *ext_resp_len = resp_len;
1060 if (resp_len <= 0)
1061 fprintf_unfiltered (gdb_stderr, "monitor_wait: excessive response from monitor: %s.", buf);
1063 while (resp_len < 0);
1065 /* Print any output characters that were preceded by ^O. */
1066 /* FIXME - This would be great as a user settabgle flag */
1067 if (monitor_debug_p || remote_debug
1068 || current_monitor->flags & MO_PRINT_PROGRAM_OUTPUT)
1070 int i;
1072 for (i = 0; i < resp_len - 1; i++)
1073 if (buf[i] == 0x0f)
1074 putchar_unfiltered (buf[++i]);
1080 /* Wait until the remote machine stops, then return, storing status in
1081 status just as `wait' would. */
1083 static ptid_t
1084 monitor_wait (ptid_t ptid, struct target_waitstatus *status)
1086 int old_timeout = timeout;
1087 char buf[TARGET_BUF_SIZE];
1088 int resp_len;
1089 struct cleanup *old_chain;
1091 status->kind = TARGET_WAITKIND_EXITED;
1092 status->value.integer = 0;
1094 old_chain = make_cleanup (monitor_wait_cleanup, &old_timeout);
1095 monitor_debug ("MON wait\n");
1097 #if 0
1098 /* This is somthing other than a maintenance command */
1099 in_monitor_wait = 1;
1100 timeout = watchdog > 0 ? watchdog : -1;
1101 #else
1102 timeout = -1; /* Don't time out -- user program is running. */
1103 #endif
1105 ofunc = (void (*)()) signal (SIGINT, monitor_interrupt);
1107 if (current_monitor->wait_filter)
1108 (*current_monitor->wait_filter) (buf, sizeof (buf), &resp_len, status);
1109 else
1110 monitor_wait_filter (buf, sizeof (buf), &resp_len, status);
1112 #if 0 /* Transferred to monitor wait filter */
1115 resp_len = monitor_expect_prompt (buf, sizeof (buf));
1117 if (resp_len <= 0)
1118 fprintf_unfiltered (gdb_stderr, "monitor_wait: excessive response from monitor: %s.", buf);
1120 while (resp_len < 0);
1122 /* Print any output characters that were preceded by ^O. */
1123 /* FIXME - This would be great as a user settabgle flag */
1124 if (monitor_debug_p || remote_debug
1125 || current_monitor->flags & MO_PRINT_PROGRAM_OUTPUT)
1127 int i;
1129 for (i = 0; i < resp_len - 1; i++)
1130 if (buf[i] == 0x0f)
1131 putchar_unfiltered (buf[++i]);
1133 #endif
1135 signal (SIGINT, ofunc);
1137 timeout = old_timeout;
1138 #if 0
1139 if (dump_reg_flag && current_monitor->dump_registers)
1141 dump_reg_flag = 0;
1142 monitor_printf (current_monitor->dump_registers);
1143 resp_len = monitor_expect_prompt (buf, sizeof (buf));
1146 if (current_monitor->register_pattern)
1147 parse_register_dump (buf, resp_len);
1148 #else
1149 monitor_debug ("Wait fetching registers after stop\n");
1150 monitor_dump_regs ();
1151 #endif
1153 status->kind = TARGET_WAITKIND_STOPPED;
1154 status->value.sig = TARGET_SIGNAL_TRAP;
1156 discard_cleanups (old_chain);
1158 in_monitor_wait = 0;
1160 return inferior_ptid;
1163 /* Fetch register REGNO, or all registers if REGNO is -1. Returns
1164 errno value. */
1166 static void
1167 monitor_fetch_register (int regno)
1169 const char *name;
1170 char *zerobuf;
1171 char *regbuf;
1172 int i;
1174 regbuf = alloca (MAX_REGISTER_SIZE * 2 + 1);
1175 zerobuf = alloca (MAX_REGISTER_SIZE);
1176 memset (zerobuf, 0, MAX_REGISTER_SIZE);
1178 if (current_monitor->regname != NULL)
1179 name = current_monitor->regname (regno);
1180 else
1181 name = current_monitor->regnames[regno];
1182 monitor_debug ("MON fetchreg %d '%s'\n", regno, name ? name : "(null name)");
1184 if (!name || (*name == '\0'))
1186 monitor_debug ("No register known for %d\n", regno);
1187 supply_register (regno, zerobuf);
1188 return;
1191 /* send the register examine command */
1193 monitor_printf (current_monitor->getreg.cmd, name);
1195 /* If RESP_DELIM is specified, we search for that as a leading
1196 delimiter for the register value. Otherwise, we just start
1197 searching from the start of the buf. */
1199 if (current_monitor->getreg.resp_delim)
1201 monitor_debug ("EXP getreg.resp_delim\n");
1202 monitor_expect (current_monitor->getreg.resp_delim, NULL, 0);
1203 /* Handle case of first 32 registers listed in pairs. */
1204 if (current_monitor->flags & MO_32_REGS_PAIRED
1205 && (regno & 1) != 0 && regno < 32)
1207 monitor_debug ("EXP getreg.resp_delim\n");
1208 monitor_expect (current_monitor->getreg.resp_delim, NULL, 0);
1212 /* Skip leading spaces and "0x" if MO_HEX_PREFIX flag is set */
1213 if (current_monitor->flags & MO_HEX_PREFIX)
1215 int c;
1216 c = readchar (timeout);
1217 while (c == ' ')
1218 c = readchar (timeout);
1219 if ((c == '0') && ((c = readchar (timeout)) == 'x'))
1221 else
1222 error ("Bad value returned from monitor while fetching register %x.",
1223 regno);
1226 /* Read upto the maximum number of hex digits for this register, skipping
1227 spaces, but stop reading if something else is seen. Some monitors
1228 like to drop leading zeros. */
1230 for (i = 0; i < DEPRECATED_REGISTER_RAW_SIZE (regno) * 2; i++)
1232 int c;
1233 c = readchar (timeout);
1234 while (c == ' ')
1235 c = readchar (timeout);
1237 if (!isxdigit (c))
1238 break;
1240 regbuf[i] = c;
1243 regbuf[i] = '\000'; /* terminate the number */
1244 monitor_debug ("REGVAL '%s'\n", regbuf);
1246 /* If TERM is present, we wait for that to show up. Also, (if TERM
1247 is present), we will send TERM_CMD if that is present. In any
1248 case, we collect all of the output into buf, and then wait for
1249 the normal prompt. */
1251 if (current_monitor->getreg.term)
1253 monitor_debug ("EXP getreg.term\n");
1254 monitor_expect (current_monitor->getreg.term, NULL, 0); /* get response */
1257 if (current_monitor->getreg.term_cmd)
1259 monitor_debug ("EMIT getreg.term.cmd\n");
1260 monitor_printf (current_monitor->getreg.term_cmd);
1262 if (!current_monitor->getreg.term || /* Already expected or */
1263 current_monitor->getreg.term_cmd) /* ack expected */
1264 monitor_expect_prompt (NULL, 0); /* get response */
1266 monitor_supply_register (regno, regbuf);
1269 /* Sometimes, it takes several commands to dump the registers */
1270 /* This is a primitive for use by variations of monitor interfaces in
1271 case they need to compose the operation.
1274 monitor_dump_reg_block (char *block_cmd)
1276 char buf[TARGET_BUF_SIZE];
1277 int resp_len;
1278 monitor_printf (block_cmd);
1279 resp_len = monitor_expect_prompt (buf, sizeof (buf));
1280 parse_register_dump (buf, resp_len);
1281 return 1;
1285 /* Read the remote registers into the block regs. */
1286 /* Call the specific function if it has been provided */
1288 static void
1289 monitor_dump_regs (void)
1291 char buf[TARGET_BUF_SIZE];
1292 int resp_len;
1293 if (current_monitor->dumpregs)
1294 (*(current_monitor->dumpregs)) (); /* call supplied function */
1295 else if (current_monitor->dump_registers) /* default version */
1297 monitor_printf (current_monitor->dump_registers);
1298 resp_len = monitor_expect_prompt (buf, sizeof (buf));
1299 parse_register_dump (buf, resp_len);
1301 else
1302 internal_error (__FILE__, __LINE__, "failed internal consistency check"); /* Need some way to read registers */
1305 static void
1306 monitor_fetch_registers (int regno)
1308 monitor_debug ("MON fetchregs\n");
1309 if (current_monitor->getreg.cmd)
1311 if (regno >= 0)
1313 monitor_fetch_register (regno);
1314 return;
1317 for (regno = 0; regno < NUM_REGS; regno++)
1318 monitor_fetch_register (regno);
1320 else
1322 monitor_dump_regs ();
1326 /* Store register REGNO, or all if REGNO == 0. Return errno value. */
1328 static void
1329 monitor_store_register (int regno)
1331 const char *name;
1332 ULONGEST val;
1334 if (current_monitor->regname != NULL)
1335 name = current_monitor->regname (regno);
1336 else
1337 name = current_monitor->regnames[regno];
1339 if (!name || (*name == '\0'))
1341 monitor_debug ("MON Cannot store unknown register\n");
1342 return;
1345 val = read_register (regno);
1346 monitor_debug ("MON storeg %d %s\n", regno,
1347 phex (val, DEPRECATED_REGISTER_RAW_SIZE (regno)));
1349 /* send the register deposit command */
1351 if (current_monitor->flags & MO_REGISTER_VALUE_FIRST)
1352 monitor_printf (current_monitor->setreg.cmd, val, name);
1353 else if (current_monitor->flags & MO_SETREG_INTERACTIVE)
1354 monitor_printf (current_monitor->setreg.cmd, name);
1355 else
1356 monitor_printf (current_monitor->setreg.cmd, name, val);
1358 if (current_monitor->setreg.resp_delim)
1360 monitor_debug ("EXP setreg.resp_delim\n");
1361 monitor_expect_regexp (&setreg_resp_delim_pattern, NULL, 0);
1362 if (current_monitor->flags & MO_SETREG_INTERACTIVE)
1363 monitor_printf ("%s\r", paddr_nz (val));
1365 if (current_monitor->setreg.term)
1367 monitor_debug ("EXP setreg.term\n");
1368 monitor_expect (current_monitor->setreg.term, NULL, 0);
1369 if (current_monitor->flags & MO_SETREG_INTERACTIVE)
1370 monitor_printf ("%s\r", paddr_nz (val));
1371 monitor_expect_prompt (NULL, 0);
1373 else
1374 monitor_expect_prompt (NULL, 0);
1375 if (current_monitor->setreg.term_cmd) /* Mode exit required */
1377 monitor_debug ("EXP setreg_termcmd\n");
1378 monitor_printf ("%s", current_monitor->setreg.term_cmd);
1379 monitor_expect_prompt (NULL, 0);
1381 } /* monitor_store_register */
1383 /* Store the remote registers. */
1385 static void
1386 monitor_store_registers (int regno)
1388 if (regno >= 0)
1390 monitor_store_register (regno);
1391 return;
1394 for (regno = 0; regno < NUM_REGS; regno++)
1395 monitor_store_register (regno);
1398 /* Get ready to modify the registers array. On machines which store
1399 individual registers, this doesn't need to do anything. On machines
1400 which store all the registers in one fell swoop, this makes sure
1401 that registers contains all the registers from the program being
1402 debugged. */
1404 static void
1405 monitor_prepare_to_store (void)
1407 /* Do nothing, since we can store individual regs */
1410 static void
1411 monitor_files_info (struct target_ops *ops)
1413 printf_unfiltered ("\tAttached to %s at %d baud.\n", dev_name, baud_rate);
1416 static int
1417 monitor_write_memory (CORE_ADDR memaddr, char *myaddr, int len)
1419 unsigned int val, hostval;
1420 char *cmd;
1421 int i;
1423 monitor_debug ("MON write %d %s\n", len, paddr (memaddr));
1425 if (current_monitor->flags & MO_ADDR_BITS_REMOVE)
1426 memaddr = ADDR_BITS_REMOVE (memaddr);
1428 /* Use memory fill command for leading 0 bytes. */
1430 if (current_monitor->fill)
1432 for (i = 0; i < len; i++)
1433 if (myaddr[i] != 0)
1434 break;
1436 if (i > 4) /* More than 4 zeros is worth doing */
1438 monitor_debug ("MON FILL %d\n", i);
1439 if (current_monitor->flags & MO_FILL_USES_ADDR)
1440 monitor_printf (current_monitor->fill, memaddr, (memaddr + i) - 1, 0);
1441 else
1442 monitor_printf (current_monitor->fill, memaddr, i, 0);
1444 monitor_expect_prompt (NULL, 0);
1446 return i;
1450 #if 0
1451 /* Can't actually use long longs if VAL is an int (nice idea, though). */
1452 if ((memaddr & 0x7) == 0 && len >= 8 && current_monitor->setmem.cmdll)
1454 len = 8;
1455 cmd = current_monitor->setmem.cmdll;
1457 else
1458 #endif
1459 if ((memaddr & 0x3) == 0 && len >= 4 && current_monitor->setmem.cmdl)
1461 len = 4;
1462 cmd = current_monitor->setmem.cmdl;
1464 else if ((memaddr & 0x1) == 0 && len >= 2 && current_monitor->setmem.cmdw)
1466 len = 2;
1467 cmd = current_monitor->setmem.cmdw;
1469 else
1471 len = 1;
1472 cmd = current_monitor->setmem.cmdb;
1475 val = extract_unsigned_integer (myaddr, len);
1477 if (len == 4)
1479 hostval = *(unsigned int *) myaddr;
1480 monitor_debug ("Hostval(%08x) val(%08x)\n", hostval, val);
1484 if (current_monitor->flags & MO_NO_ECHO_ON_SETMEM)
1485 monitor_printf_noecho (cmd, memaddr, val);
1486 else if (current_monitor->flags & MO_SETMEM_INTERACTIVE)
1489 monitor_printf_noecho (cmd, memaddr);
1491 if (current_monitor->setmem.resp_delim)
1493 monitor_debug ("EXP setmem.resp_delim");
1494 monitor_expect_regexp (&setmem_resp_delim_pattern, NULL, 0);
1495 monitor_printf ("%x\r", val);
1497 if (current_monitor->setmem.term)
1499 monitor_debug ("EXP setmem.term");
1500 monitor_expect (current_monitor->setmem.term, NULL, 0);
1501 monitor_printf ("%x\r", val);
1503 if (current_monitor->setmem.term_cmd)
1504 { /* Emit this to get out of the memory editing state */
1505 monitor_printf ("%s", current_monitor->setmem.term_cmd);
1506 /* Drop through to expecting a prompt */
1509 else
1510 monitor_printf (cmd, memaddr, val);
1512 monitor_expect_prompt (NULL, 0);
1514 return len;
1518 static int
1519 monitor_write_memory_bytes (CORE_ADDR memaddr, char *myaddr, int len)
1521 unsigned char val;
1522 int written = 0;
1523 if (len == 0)
1524 return 0;
1525 /* Enter the sub mode */
1526 monitor_printf (current_monitor->setmem.cmdb, memaddr);
1527 monitor_expect_prompt (NULL, 0);
1528 while (len)
1530 val = *myaddr;
1531 monitor_printf ("%x\r", val);
1532 myaddr++;
1533 memaddr++;
1534 written++;
1535 /* If we wanted to, here we could validate the address */
1536 monitor_expect_prompt (NULL, 0);
1537 len--;
1539 /* Now exit the sub mode */
1540 monitor_printf (current_monitor->getreg.term_cmd);
1541 monitor_expect_prompt (NULL, 0);
1542 return written;
1546 static void
1547 longlongendswap (unsigned char *a)
1549 int i, j;
1550 unsigned char x;
1551 i = 0;
1552 j = 7;
1553 while (i < 4)
1555 x = *(a + i);
1556 *(a + i) = *(a + j);
1557 *(a + j) = x;
1558 i++, j--;
1561 /* Format 32 chars of long long value, advance the pointer */
1562 static char *hexlate = "0123456789abcdef";
1563 static char *
1564 longlong_hexchars (unsigned long long value,
1565 char *outbuff)
1567 if (value == 0)
1569 *outbuff++ = '0';
1570 return outbuff;
1572 else
1574 static unsigned char disbuf[8]; /* disassembly buffer */
1575 unsigned char *scan, *limit; /* loop controls */
1576 unsigned char c, nib;
1577 int leadzero = 1;
1578 scan = disbuf;
1579 limit = scan + 8;
1581 unsigned long long *dp;
1582 dp = (unsigned long long *) scan;
1583 *dp = value;
1585 longlongendswap (disbuf); /* FIXME: ONly on big endian hosts */
1586 while (scan < limit)
1588 c = *scan++; /* a byte of our long long value */
1589 if (leadzero)
1591 if (c == 0)
1592 continue;
1593 else
1594 leadzero = 0; /* henceforth we print even zeroes */
1596 nib = c >> 4; /* high nibble bits */
1597 *outbuff++ = hexlate[nib];
1598 nib = c & 0x0f; /* low nibble bits */
1599 *outbuff++ = hexlate[nib];
1601 return outbuff;
1603 } /* longlong_hexchars */
1607 /* I am only going to call this when writing virtual byte streams.
1608 Which possably entails endian conversions
1610 static int
1611 monitor_write_memory_longlongs (CORE_ADDR memaddr, char *myaddr, int len)
1613 static char hexstage[20]; /* At least 16 digits required, plus null */
1614 char *endstring;
1615 long long *llptr;
1616 long long value;
1617 int written = 0;
1618 llptr = (unsigned long long *) myaddr;
1619 if (len == 0)
1620 return 0;
1621 monitor_printf (current_monitor->setmem.cmdll, memaddr);
1622 monitor_expect_prompt (NULL, 0);
1623 while (len >= 8)
1625 value = *llptr;
1626 endstring = longlong_hexchars (*llptr, hexstage);
1627 *endstring = '\0'; /* NUll terminate for printf */
1628 monitor_printf ("%s\r", hexstage);
1629 llptr++;
1630 memaddr += 8;
1631 written += 8;
1632 /* If we wanted to, here we could validate the address */
1633 monitor_expect_prompt (NULL, 0);
1634 len -= 8;
1636 /* Now exit the sub mode */
1637 monitor_printf (current_monitor->getreg.term_cmd);
1638 monitor_expect_prompt (NULL, 0);
1639 return written;
1640 } /* */
1644 /* ----- MONITOR_WRITE_MEMORY_BLOCK ---------------------------- */
1645 /* This is for the large blocks of memory which may occur in downloading.
1646 And for monitors which use interactive entry,
1647 And for monitors which do not have other downloading methods.
1648 Without this, we will end up calling monitor_write_memory many times
1649 and do the entry and exit of the sub mode many times
1650 This currently assumes...
1651 MO_SETMEM_INTERACTIVE
1652 ! MO_NO_ECHO_ON_SETMEM
1653 To use this, the you have to patch the monitor_cmds block with
1654 this function. Otherwise, its not tuned up for use by all
1655 monitor variations.
1658 static int
1659 monitor_write_memory_block (CORE_ADDR memaddr, char *myaddr, int len)
1661 int written;
1662 written = 0;
1663 /* FIXME: This would be a good place to put the zero test */
1664 #if 1
1665 if ((len > 8) && (((len & 0x07)) == 0) && current_monitor->setmem.cmdll)
1667 return monitor_write_memory_longlongs (memaddr, myaddr, len);
1669 #endif
1670 written = monitor_write_memory_bytes (memaddr, myaddr, len);
1671 return written;
1674 /* This is an alternate form of monitor_read_memory which is used for monitors
1675 which can only read a single byte/word/etc. at a time. */
1677 static int
1678 monitor_read_memory_single (CORE_ADDR memaddr, char *myaddr, int len)
1680 unsigned int val;
1681 char membuf[sizeof (int) * 2 + 1];
1682 char *p;
1683 char *cmd;
1685 monitor_debug ("MON read single\n");
1686 #if 0
1687 /* Can't actually use long longs (nice idea, though). In fact, the
1688 call to strtoul below will fail if it tries to convert a value
1689 that's too big to fit in a long. */
1690 if ((memaddr & 0x7) == 0 && len >= 8 && current_monitor->getmem.cmdll)
1692 len = 8;
1693 cmd = current_monitor->getmem.cmdll;
1695 else
1696 #endif
1697 if ((memaddr & 0x3) == 0 && len >= 4 && current_monitor->getmem.cmdl)
1699 len = 4;
1700 cmd = current_monitor->getmem.cmdl;
1702 else if ((memaddr & 0x1) == 0 && len >= 2 && current_monitor->getmem.cmdw)
1704 len = 2;
1705 cmd = current_monitor->getmem.cmdw;
1707 else
1709 len = 1;
1710 cmd = current_monitor->getmem.cmdb;
1713 /* Send the examine command. */
1715 monitor_printf (cmd, memaddr);
1717 /* If RESP_DELIM is specified, we search for that as a leading
1718 delimiter for the memory value. Otherwise, we just start
1719 searching from the start of the buf. */
1721 if (current_monitor->getmem.resp_delim)
1723 monitor_debug ("EXP getmem.resp_delim\n");
1724 monitor_expect_regexp (&getmem_resp_delim_pattern, NULL, 0);
1727 /* Now, read the appropriate number of hex digits for this loc,
1728 skipping spaces. */
1730 /* Skip leading spaces and "0x" if MO_HEX_PREFIX flag is set. */
1731 if (current_monitor->flags & MO_HEX_PREFIX)
1733 int c;
1735 c = readchar (timeout);
1736 while (c == ' ')
1737 c = readchar (timeout);
1738 if ((c == '0') && ((c = readchar (timeout)) == 'x'))
1740 else
1741 monitor_error ("monitor_read_memory_single",
1742 "bad response from monitor",
1743 memaddr, 0, NULL, 0);
1747 int i;
1748 for (i = 0; i < len * 2; i++)
1750 int c;
1752 while (1)
1754 c = readchar (timeout);
1755 if (isxdigit (c))
1756 break;
1757 if (c == ' ')
1758 continue;
1760 monitor_error ("monitor_read_memory_single",
1761 "bad response from monitor",
1762 memaddr, i, membuf, 0);
1764 membuf[i] = c;
1766 membuf[i] = '\000'; /* terminate the number */
1769 /* If TERM is present, we wait for that to show up. Also, (if TERM is
1770 present), we will send TERM_CMD if that is present. In any case, we collect
1771 all of the output into buf, and then wait for the normal prompt. */
1773 if (current_monitor->getmem.term)
1775 monitor_expect (current_monitor->getmem.term, NULL, 0); /* get response */
1777 if (current_monitor->getmem.term_cmd)
1779 monitor_printf (current_monitor->getmem.term_cmd);
1780 monitor_expect_prompt (NULL, 0);
1783 else
1784 monitor_expect_prompt (NULL, 0); /* get response */
1786 p = membuf;
1787 val = strtoul (membuf, &p, 16);
1789 if (val == 0 && membuf == p)
1790 monitor_error ("monitor_read_memory_single",
1791 "bad value from monitor",
1792 memaddr, 0, membuf, 0);
1794 /* supply register stores in target byte order, so swap here */
1796 store_unsigned_integer (myaddr, len, val);
1798 return len;
1801 /* Copy LEN bytes of data from debugger memory at MYADDR to inferior's
1802 memory at MEMADDR. Returns length moved. Currently, we do no more
1803 than 16 bytes at a time. */
1805 static int
1806 monitor_read_memory (CORE_ADDR memaddr, char *myaddr, int len)
1808 unsigned int val;
1809 char buf[512];
1810 char *p, *p1;
1811 int resp_len;
1812 int i;
1813 CORE_ADDR dumpaddr;
1815 if (len <= 0)
1817 monitor_debug ("Zero length call to monitor_read_memory\n");
1818 return 0;
1821 monitor_debug ("MON read block ta(%s) ha(%lx) %d\n",
1822 paddr_nz (memaddr), (long) myaddr, len);
1824 if (current_monitor->flags & MO_ADDR_BITS_REMOVE)
1825 memaddr = ADDR_BITS_REMOVE (memaddr);
1827 if (current_monitor->flags & MO_GETMEM_READ_SINGLE)
1828 return monitor_read_memory_single (memaddr, myaddr, len);
1830 len = min (len, 16);
1832 /* Some dumpers align the first data with the preceeding 16
1833 byte boundary. Some print blanks and start at the
1834 requested boundary. EXACT_DUMPADDR
1837 dumpaddr = (current_monitor->flags & MO_EXACT_DUMPADDR)
1838 ? memaddr : memaddr & ~0x0f;
1840 /* See if xfer would cross a 16 byte boundary. If so, clip it. */
1841 if (((memaddr ^ (memaddr + len - 1)) & ~0xf) != 0)
1842 len = ((memaddr + len) & ~0xf) - memaddr;
1844 /* send the memory examine command */
1846 if (current_monitor->flags & MO_GETMEM_NEEDS_RANGE)
1847 monitor_printf (current_monitor->getmem.cmdb, memaddr, memaddr + len);
1848 else if (current_monitor->flags & MO_GETMEM_16_BOUNDARY)
1849 monitor_printf (current_monitor->getmem.cmdb, dumpaddr);
1850 else
1851 monitor_printf (current_monitor->getmem.cmdb, memaddr, len);
1853 /* If TERM is present, we wait for that to show up. Also, (if TERM
1854 is present), we will send TERM_CMD if that is present. In any
1855 case, we collect all of the output into buf, and then wait for
1856 the normal prompt. */
1858 if (current_monitor->getmem.term)
1860 resp_len = monitor_expect (current_monitor->getmem.term, buf, sizeof buf); /* get response */
1862 if (resp_len <= 0)
1863 monitor_error ("monitor_read_memory",
1864 "excessive response from monitor",
1865 memaddr, resp_len, buf, 0);
1867 if (current_monitor->getmem.term_cmd)
1869 serial_write (monitor_desc, current_monitor->getmem.term_cmd,
1870 strlen (current_monitor->getmem.term_cmd));
1871 monitor_expect_prompt (NULL, 0);
1874 else
1875 resp_len = monitor_expect_prompt (buf, sizeof buf); /* get response */
1877 p = buf;
1879 /* If RESP_DELIM is specified, we search for that as a leading
1880 delimiter for the values. Otherwise, we just start searching
1881 from the start of the buf. */
1883 if (current_monitor->getmem.resp_delim)
1885 int retval, tmp;
1886 struct re_registers resp_strings;
1887 monitor_debug ("MON getmem.resp_delim %s\n", current_monitor->getmem.resp_delim);
1889 memset (&resp_strings, 0, sizeof (struct re_registers));
1890 tmp = strlen (p);
1891 retval = re_search (&getmem_resp_delim_pattern, p, tmp, 0, tmp,
1892 &resp_strings);
1894 if (retval < 0)
1895 monitor_error ("monitor_read_memory",
1896 "bad response from monitor",
1897 memaddr, resp_len, buf, 0);
1899 p += resp_strings.end[0];
1900 #if 0
1901 p = strstr (p, current_monitor->getmem.resp_delim);
1902 if (!p)
1903 monitor_error ("monitor_read_memory",
1904 "bad response from monitor",
1905 memaddr, resp_len, buf, 0);
1906 p += strlen (current_monitor->getmem.resp_delim);
1907 #endif
1909 monitor_debug ("MON scanning %d ,%lx '%s'\n", len, (long) p, p);
1910 if (current_monitor->flags & MO_GETMEM_16_BOUNDARY)
1912 char c;
1913 int fetched = 0;
1914 i = len;
1915 c = *p;
1918 while (!(c == '\000' || c == '\n' || c == '\r') && i > 0)
1920 if (isxdigit (c))
1922 if ((dumpaddr >= memaddr) && (i > 0))
1924 val = fromhex (c) * 16 + fromhex (*(p + 1));
1925 *myaddr++ = val;
1926 if (monitor_debug_p || remote_debug)
1927 fprintf_unfiltered (gdb_stdlog, "[%02x]", val);
1928 --i;
1929 fetched++;
1931 ++dumpaddr;
1932 ++p;
1934 ++p; /* skip a blank or other non hex char */
1935 c = *p;
1937 if (fetched == 0)
1938 error ("Failed to read via monitor");
1939 if (monitor_debug_p || remote_debug)
1940 fprintf_unfiltered (gdb_stdlog, "\n");
1941 return fetched; /* Return the number of bytes actually read */
1943 monitor_debug ("MON scanning bytes\n");
1945 for (i = len; i > 0; i--)
1947 /* Skip non-hex chars, but bomb on end of string and newlines */
1949 while (1)
1951 if (isxdigit (*p))
1952 break;
1954 if (*p == '\000' || *p == '\n' || *p == '\r')
1955 monitor_error ("monitor_read_memory",
1956 "badly terminated response from monitor",
1957 memaddr, resp_len, buf, 0);
1958 p++;
1961 val = strtoul (p, &p1, 16);
1963 if (val == 0 && p == p1)
1964 monitor_error ("monitor_read_memory",
1965 "bad value from monitor",
1966 memaddr, resp_len, buf, 0);
1968 *myaddr++ = val;
1970 if (i == 1)
1971 break;
1973 p = p1;
1976 return len;
1979 /* Transfer LEN bytes between target address MEMADDR and GDB address
1980 MYADDR. Returns 0 for success, errno code for failure. TARGET is
1981 unused. */
1983 static int
1984 monitor_xfer_memory (CORE_ADDR memaddr, char *myaddr, int len, int write,
1985 struct mem_attrib *attrib, struct target_ops *target)
1987 int res;
1989 if (write)
1991 if (current_monitor->flags & MO_HAS_BLOCKWRITES)
1992 res = monitor_write_memory_block(memaddr, myaddr, len);
1993 else
1994 res = monitor_write_memory(memaddr, myaddr, len);
1996 else
1998 res = monitor_read_memory(memaddr, myaddr, len);
2001 return res;
2004 static void
2005 monitor_kill (void)
2007 return; /* ignore attempts to kill target system */
2010 /* All we actually do is set the PC to the start address of exec_bfd, and start
2011 the program at that point. */
2013 static void
2014 monitor_create_inferior (char *exec_file, char *args, char **env,
2015 int from_tty)
2017 if (args && (*args != '\000'))
2018 error ("Args are not supported by the monitor.");
2020 first_time = 1;
2021 clear_proceed_status ();
2022 proceed (bfd_get_start_address (exec_bfd), TARGET_SIGNAL_0, 0);
2025 /* Clean up when a program exits.
2026 The program actually lives on in the remote processor's RAM, and may be
2027 run again without a download. Don't leave it full of breakpoint
2028 instructions. */
2030 static void
2031 monitor_mourn_inferior (void)
2033 unpush_target (targ_ops);
2034 generic_mourn_inferior (); /* Do all the proper things now */
2037 /* Tell the monitor to add a breakpoint. */
2039 static int
2040 monitor_insert_breakpoint (CORE_ADDR addr, char *shadow)
2042 int i;
2043 const unsigned char *bp;
2044 int bplen;
2046 monitor_debug ("MON inst bkpt %s\n", paddr (addr));
2047 if (current_monitor->set_break == NULL)
2048 error ("No set_break defined for this monitor");
2050 if (current_monitor->flags & MO_ADDR_BITS_REMOVE)
2051 addr = ADDR_BITS_REMOVE (addr);
2053 /* Determine appropriate breakpoint size for this address. */
2054 bp = gdbarch_breakpoint_from_pc (current_gdbarch, &addr, &bplen);
2056 for (i = 0; i < current_monitor->num_breakpoints; i++)
2058 if (breakaddr[i] == 0)
2060 breakaddr[i] = addr;
2061 monitor_read_memory (addr, shadow, bplen);
2062 monitor_printf (current_monitor->set_break, addr);
2063 monitor_expect_prompt (NULL, 0);
2064 return 0;
2068 error ("Too many breakpoints (> %d) for monitor.", current_monitor->num_breakpoints);
2071 /* Tell the monitor to remove a breakpoint. */
2073 static int
2074 monitor_remove_breakpoint (CORE_ADDR addr, char *shadow)
2076 int i;
2078 monitor_debug ("MON rmbkpt %s\n", paddr (addr));
2079 if (current_monitor->clr_break == NULL)
2080 error ("No clr_break defined for this monitor");
2082 if (current_monitor->flags & MO_ADDR_BITS_REMOVE)
2083 addr = ADDR_BITS_REMOVE (addr);
2085 for (i = 0; i < current_monitor->num_breakpoints; i++)
2087 if (breakaddr[i] == addr)
2089 breakaddr[i] = 0;
2090 /* some monitors remove breakpoints based on the address */
2091 if (current_monitor->flags & MO_CLR_BREAK_USES_ADDR)
2092 monitor_printf (current_monitor->clr_break, addr);
2093 else if (current_monitor->flags & MO_CLR_BREAK_1_BASED)
2094 monitor_printf (current_monitor->clr_break, i + 1);
2095 else
2096 monitor_printf (current_monitor->clr_break, i);
2097 monitor_expect_prompt (NULL, 0);
2098 return 0;
2101 fprintf_unfiltered (gdb_stderr,
2102 "Can't find breakpoint associated with 0x%s\n",
2103 paddr_nz (addr));
2104 return 1;
2107 /* monitor_wait_srec_ack -- wait for the target to send an acknowledgement for
2108 an S-record. Return non-zero if the ACK is received properly. */
2110 static int
2111 monitor_wait_srec_ack (void)
2113 int ch;
2115 if (current_monitor->flags & MO_SREC_ACK_PLUS)
2117 return (readchar (timeout) == '+');
2119 else if (current_monitor->flags & MO_SREC_ACK_ROTATE)
2121 /* Eat two backspaces, a "rotating" char (|/-\), and a space. */
2122 if ((ch = readchar (1)) < 0)
2123 return 0;
2124 if ((ch = readchar (1)) < 0)
2125 return 0;
2126 if ((ch = readchar (1)) < 0)
2127 return 0;
2128 if ((ch = readchar (1)) < 0)
2129 return 0;
2131 return 1;
2134 /* monitor_load -- download a file. */
2136 static void
2137 monitor_load (char *file, int from_tty)
2139 monitor_debug ("MON load\n");
2141 if (current_monitor->load_routine)
2142 current_monitor->load_routine (monitor_desc, file, hashmark);
2143 else
2144 { /* The default is ascii S-records */
2145 int n;
2146 unsigned long load_offset;
2147 char buf[128];
2149 /* enable user to specify address for downloading as 2nd arg to load */
2150 n = sscanf (file, "%s 0x%lx", buf, &load_offset);
2151 if (n > 1)
2152 file = buf;
2153 else
2154 load_offset = 0;
2156 monitor_printf (current_monitor->load);
2157 if (current_monitor->loadresp)
2158 monitor_expect (current_monitor->loadresp, NULL, 0);
2160 load_srec (monitor_desc, file, (bfd_vma) load_offset,
2161 32, SREC_ALL, hashmark,
2162 current_monitor->flags & MO_SREC_ACK ?
2163 monitor_wait_srec_ack : NULL);
2165 monitor_expect_prompt (NULL, 0);
2168 /* Finally, make the PC point at the start address */
2169 if (exec_bfd)
2170 write_pc (bfd_get_start_address (exec_bfd));
2172 /* There used to be code here which would clear inferior_ptid and
2173 call clear_symtab_users. None of that should be necessary:
2174 monitor targets should behave like remote protocol targets, and
2175 since generic_load does none of those things, this function
2176 shouldn't either.
2178 Furthermore, clearing inferior_ptid is *incorrect*. After doing
2179 a load, we still have a valid connection to the monitor, with a
2180 live processor state to fiddle with. The user can type
2181 `continue' or `jump *start' and make the program run. If they do
2182 these things, however, GDB will be talking to a running program
2183 while inferior_ptid is null_ptid; this makes things like
2184 reinit_frame_cache very confused. */
2187 static void
2188 monitor_stop (void)
2190 monitor_debug ("MON stop\n");
2191 if ((current_monitor->flags & MO_SEND_BREAK_ON_STOP) != 0)
2192 serial_send_break (monitor_desc);
2193 if (current_monitor->stop)
2194 monitor_printf_noecho (current_monitor->stop);
2197 /* Put a COMMAND string out to MONITOR. Output from MONITOR is placed
2198 in OUTPUT until the prompt is seen. FIXME: We read the characters
2199 ourseleves here cause of a nasty echo. */
2201 static void
2202 monitor_rcmd (char *command,
2203 struct ui_file *outbuf)
2205 char *p;
2206 int resp_len;
2207 char buf[1000];
2209 if (monitor_desc == NULL)
2210 error ("monitor target not open.");
2212 p = current_monitor->prompt;
2214 /* Send the command. Note that if no args were supplied, then we're
2215 just sending the monitor a newline, which is sometimes useful. */
2217 monitor_printf ("%s\r", (command ? command : ""));
2219 resp_len = monitor_expect_prompt (buf, sizeof buf);
2221 fputs_unfiltered (buf, outbuf); /* Output the response */
2224 /* Convert hex digit A to a number. */
2226 #if 0
2227 static int
2228 from_hex (int a)
2230 if (a >= '0' && a <= '9')
2231 return a - '0';
2232 if (a >= 'a' && a <= 'f')
2233 return a - 'a' + 10;
2234 if (a >= 'A' && a <= 'F')
2235 return a - 'A' + 10;
2237 error ("Reply contains invalid hex digit 0x%x", a);
2239 #endif
2241 char *
2242 monitor_get_dev_name (void)
2244 return dev_name;
2247 static struct target_ops monitor_ops;
2249 static void
2250 init_base_monitor_ops (void)
2252 monitor_ops.to_close = monitor_close;
2253 monitor_ops.to_detach = monitor_detach;
2254 monitor_ops.to_resume = monitor_resume;
2255 monitor_ops.to_wait = monitor_wait;
2256 monitor_ops.to_fetch_registers = monitor_fetch_registers;
2257 monitor_ops.to_store_registers = monitor_store_registers;
2258 monitor_ops.to_prepare_to_store = monitor_prepare_to_store;
2259 monitor_ops.to_xfer_memory = monitor_xfer_memory;
2260 monitor_ops.to_files_info = monitor_files_info;
2261 monitor_ops.to_insert_breakpoint = monitor_insert_breakpoint;
2262 monitor_ops.to_remove_breakpoint = monitor_remove_breakpoint;
2263 monitor_ops.to_kill = monitor_kill;
2264 monitor_ops.to_load = monitor_load;
2265 monitor_ops.to_create_inferior = monitor_create_inferior;
2266 monitor_ops.to_mourn_inferior = monitor_mourn_inferior;
2267 monitor_ops.to_stop = monitor_stop;
2268 monitor_ops.to_rcmd = monitor_rcmd;
2269 monitor_ops.to_stratum = process_stratum;
2270 monitor_ops.to_has_all_memory = 1;
2271 monitor_ops.to_has_memory = 1;
2272 monitor_ops.to_has_stack = 1;
2273 monitor_ops.to_has_registers = 1;
2274 monitor_ops.to_has_execution = 1;
2275 monitor_ops.to_magic = OPS_MAGIC;
2276 } /* init_base_monitor_ops */
2278 /* Init the target_ops structure pointed at by OPS */
2280 void
2281 init_monitor_ops (struct target_ops *ops)
2283 if (monitor_ops.to_magic != OPS_MAGIC)
2284 init_base_monitor_ops ();
2286 memcpy (ops, &monitor_ops, sizeof monitor_ops);
2289 /* Define additional commands that are usually only used by monitors. */
2291 extern initialize_file_ftype _initialize_remote_monitors; /* -Wmissing-prototypes */
2293 void
2294 _initialize_remote_monitors (void)
2296 init_base_monitor_ops ();
2297 add_show_from_set (add_set_cmd ("hash", no_class, var_boolean,
2298 (char *) &hashmark,
2299 "Set display of activity while downloading a file.\n\
2300 When enabled, a hashmark \'#\' is displayed.",
2301 &setlist),
2302 &showlist);
2304 add_show_from_set
2305 (add_set_cmd ("monitor", no_class, var_zinteger,
2306 (char *) &monitor_debug_p,
2307 "Set debugging of remote monitor communication.\n\
2308 When enabled, communication between GDB and the remote monitor\n\
2309 is displayed.", &setdebuglist),
2310 &showdebuglist);