1 /* Main code for remote server for GDB.
2 Copyright (C) 1989, 1993, 1994, 1995, 1997, 1998, 1999, 2000, 2002, 2003,
3 2004, 2005, 2006, 2007, 2008, 2009 Free Software Foundation, Inc.
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 3 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, see <http://www.gnu.org/licenses/>. */
35 unsigned long cont_thread;
36 unsigned long general_thread;
37 unsigned long step_thread;
38 unsigned long thread_from_wait;
39 unsigned long old_thread_from_wait;
42 static int extended_protocol;
44 static int response_needed;
45 static int exit_requested;
47 static char **program_argv, **wrapper_argv;
49 /* Enable miscellaneous debugging output. The name is historical - it
50 was originally used to debug LinuxThreads support. */
53 int pass_signals[TARGET_SIGNAL_LAST];
57 const char *gdbserver_xmltarget;
59 /* The PID of the originally created or attached inferior. Used to
60 send signals to the process when GDB sends us an asynchronous interrupt
61 (user hitting Control-C in the client), and to wait for the child to exit
62 when no longer debugging it. */
64 unsigned long signal_pid;
67 /* A file descriptor for the controlling terminal. */
70 /* TERMINAL_FD's original foreground group. */
71 pid_t old_foreground_pgrp;
73 /* Hand back terminal ownership to the original foreground group. */
76 restore_old_foreground_pgrp (void)
78 tcsetpgrp (terminal_fd, old_foreground_pgrp);
82 /* Set if you want to disable optional thread related packets support
83 in gdbserver, for the sake of testing GDB against stubs that don't
85 int disable_packet_vCont;
86 int disable_packet_Tthread;
87 int disable_packet_qC;
88 int disable_packet_qfThreadInfo;
93 return all_threads.head != NULL;
97 start_inferior (char **argv, char *statusptr)
99 char **new_argv = argv;
102 if (wrapper_argv != NULL)
106 for (i = 0; wrapper_argv[i] != NULL; i++)
108 for (i = 0; argv[i] != NULL; i++)
110 new_argv = alloca (sizeof (char *) * count);
112 for (i = 0; wrapper_argv[i] != NULL; i++)
113 new_argv[count++] = wrapper_argv[i];
114 for (i = 0; argv[i] != NULL; i++)
115 new_argv[count++] = argv[i];
116 new_argv[count] = NULL;
120 signal (SIGTTOU, SIG_DFL);
121 signal (SIGTTIN, SIG_DFL);
124 signal_pid = create_inferior (new_argv[0], new_argv);
126 /* FIXME: we don't actually know at this point that the create
127 actually succeeded. We won't know that until we wait. */
128 fprintf (stderr, "Process %s created; pid = %ld\n", argv[0],
133 signal (SIGTTOU, SIG_IGN);
134 signal (SIGTTIN, SIG_IGN);
135 terminal_fd = fileno (stderr);
136 old_foreground_pgrp = tcgetpgrp (terminal_fd);
137 tcsetpgrp (terminal_fd, signal_pid);
138 atexit (restore_old_foreground_pgrp);
141 if (wrapper_argv != NULL)
143 struct thread_resume resume_info;
146 resume_info.thread = -1;
147 resume_info.step = 0;
149 resume_info.leave_stopped = 0;
151 sig = mywait (statusptr, 0);
152 if (*statusptr != 'T')
157 (*the_target->resume) (&resume_info);
159 sig = mywait (statusptr, 0);
160 if (*statusptr != 'T')
163 while (sig != TARGET_SIGNAL_TRAP);
168 /* Wait till we are at 1st instruction in program, return signal
169 number (assuming success). */
170 return mywait (statusptr, 0);
174 attach_inferior (int pid, char *statusptr, int *sigptr)
176 /* myattach should return -1 if attaching is unsupported,
177 0 if it succeeded, and call error() otherwise. */
179 if (myattach (pid) != 0)
184 fprintf (stderr, "Attached; pid = %d\n", pid);
187 /* FIXME - It may be that we should get the SIGNAL_PID from the
188 attach function, so that it can be the main thread instead of
189 whichever we were told to attach to. */
192 *sigptr = mywait (statusptr, 0);
194 /* GDB knows to ignore the first SIGSTOP after attaching to a running
195 process using the "attach" command, but this is different; it's
196 just using "target remote". Pretend it's just starting up. */
197 if (*statusptr == 'T' && *sigptr == TARGET_SIGNAL_STOP)
198 *sigptr = TARGET_SIGNAL_TRAP;
203 extern int remote_debug;
205 /* Decode a qXfer read request. Return 0 if everything looks OK,
209 decode_xfer_read (char *buf, char **annex, CORE_ADDR *ofs, unsigned int *len)
211 /* Extract and NUL-terminate the annex. */
213 while (*buf && *buf != ':')
219 /* After the read marker and annex, qXfer looks like a
220 traditional 'm' packet. */
221 decode_m_packet (buf, ofs, len);
226 /* Write the response to a successful qXfer read. Returns the
227 length of the (binary) data stored in BUF, corresponding
228 to as much of DATA/LEN as we could fit. IS_MORE controls
229 the first character of the response. */
231 write_qxfer_response (char *buf, const void *data, int len, int is_more)
240 return remote_escape_output (data, len, (unsigned char *) buf + 1, &out_len,
244 /* Handle all of the extended 'Q' packets. */
246 handle_general_set (char *own_buf)
248 if (strncmp ("QPassSignals:", own_buf, strlen ("QPassSignals:")) == 0)
250 int numsigs = (int) TARGET_SIGNAL_LAST, i;
251 const char *p = own_buf + strlen ("QPassSignals:");
254 p = decode_address_to_semicolon (&cursig, p);
255 for (i = 0; i < numsigs; i++)
261 /* Keep looping, to clear the remaining signals. */
264 p = decode_address_to_semicolon (&cursig, p);
269 strcpy (own_buf, "OK");
273 if (strcmp (own_buf, "QStartNoAckMode") == 0)
277 fprintf (stderr, "[noack mode enabled]\n");
286 /* Otherwise we didn't know what packet it was. Say we didn't
292 get_features_xml (const char *annex)
294 /* gdbserver_xmltarget defines what to return when looking
295 for the "target.xml" file. Its contents can either be
296 verbatim XML code (prefixed with a '@') or else the name
297 of the actual XML file to be used in place of "target.xml".
299 This variable is set up from the auto-generated
300 init_registers_... routine for the current target. */
302 if (gdbserver_xmltarget
303 && strcmp (annex, "target.xml") == 0)
305 if (*gdbserver_xmltarget == '@')
306 return gdbserver_xmltarget + 1;
308 annex = gdbserver_xmltarget;
313 extern const char *const xml_builtin[][2];
316 /* Look for the annex. */
317 for (i = 0; xml_builtin[i][0] != NULL; i++)
318 if (strcmp (annex, xml_builtin[i][0]) == 0)
321 if (xml_builtin[i][0] != NULL)
322 return xml_builtin[i][1];
330 monitor_show_help (void)
332 monitor_output ("The following monitor commands are supported:\n");
333 monitor_output (" set debug <0|1>\n");
334 monitor_output (" Enable general debugging messages\n");
335 monitor_output (" set remote-debug <0|1>\n");
336 monitor_output (" Enable remote protocol debugging messages\n");
337 monitor_output (" exit\n");
338 monitor_output (" Quit GDBserver\n");
341 /* Subroutine of handle_search_memory to simplify it. */
344 handle_search_memory_1 (CORE_ADDR start_addr, CORE_ADDR search_space_len,
345 gdb_byte *pattern, unsigned pattern_len,
346 gdb_byte *search_buf,
347 unsigned chunk_size, unsigned search_buf_size,
348 CORE_ADDR *found_addrp)
350 /* Prime the search buffer. */
352 if (read_inferior_memory (start_addr, search_buf, search_buf_size) != 0)
354 warning ("Unable to access target memory at 0x%lx, halting search.",
359 /* Perform the search.
361 The loop is kept simple by allocating [N + pattern-length - 1] bytes.
362 When we've scanned N bytes we copy the trailing bytes to the start and
363 read in another N bytes. */
365 while (search_space_len >= pattern_len)
368 unsigned nr_search_bytes = (search_space_len < search_buf_size
372 found_ptr = memmem (search_buf, nr_search_bytes, pattern, pattern_len);
374 if (found_ptr != NULL)
376 CORE_ADDR found_addr = start_addr + (found_ptr - search_buf);
377 *found_addrp = found_addr;
381 /* Not found in this chunk, skip to next chunk. */
383 /* Don't let search_space_len wrap here, it's unsigned. */
384 if (search_space_len >= chunk_size)
385 search_space_len -= chunk_size;
387 search_space_len = 0;
389 if (search_space_len >= pattern_len)
391 unsigned keep_len = search_buf_size - chunk_size;
392 CORE_ADDR read_addr = start_addr + keep_len;
395 /* Copy the trailing part of the previous iteration to the front
396 of the buffer for the next iteration. */
397 memcpy (search_buf, search_buf + chunk_size, keep_len);
399 nr_to_read = (search_space_len - keep_len < chunk_size
400 ? search_space_len - keep_len
403 if (read_inferior_memory (read_addr, search_buf + keep_len,
406 warning ("Unable to access target memory at 0x%lx, halting search.",
411 start_addr += chunk_size;
420 /* Handle qSearch:memory packets. */
423 handle_search_memory (char *own_buf, int packet_len)
425 CORE_ADDR start_addr;
426 CORE_ADDR search_space_len;
428 unsigned int pattern_len;
429 /* NOTE: also defined in find.c testcase. */
430 #define SEARCH_CHUNK_SIZE 16000
431 const unsigned chunk_size = SEARCH_CHUNK_SIZE;
432 /* Buffer to hold memory contents for searching. */
433 gdb_byte *search_buf;
434 unsigned search_buf_size;
436 CORE_ADDR found_addr;
437 int cmd_name_len = sizeof ("qSearch:memory:") - 1;
439 pattern = xmalloc (packet_len);
442 error ("Unable to allocate memory to perform the search");
443 strcpy (own_buf, "E00");
446 if (decode_search_memory_packet (own_buf + cmd_name_len,
447 packet_len - cmd_name_len,
448 &start_addr, &search_space_len,
449 pattern, &pattern_len) < 0)
452 error ("Error in parsing qSearch:memory packet");
453 strcpy (own_buf, "E00");
457 search_buf_size = chunk_size + pattern_len - 1;
459 /* No point in trying to allocate a buffer larger than the search space. */
460 if (search_space_len < search_buf_size)
461 search_buf_size = search_space_len;
463 search_buf = xmalloc (search_buf_size);
464 if (search_buf == NULL)
467 error ("Unable to allocate memory to perform the search");
468 strcpy (own_buf, "E00");
472 found = handle_search_memory_1 (start_addr, search_space_len,
473 pattern, pattern_len,
474 search_buf, chunk_size, search_buf_size,
478 sprintf (own_buf, "1,%lx", (long) found_addr);
480 strcpy (own_buf, "0");
482 strcpy (own_buf, "E00");
488 #define require_running(BUF) \
489 if (!target_running ()) \
495 /* Handle all of the extended 'q' packets. */
497 handle_query (char *own_buf, int packet_len, int *new_packet_len_p)
499 static struct inferior_list_entry *thread_ptr;
501 /* Reply the current thread id. */
502 if (strcmp ("qC", own_buf) == 0 && !disable_packet_qC)
504 require_running (own_buf);
505 thread_ptr = all_threads.head;
506 sprintf (own_buf, "QC%x",
507 thread_to_gdb_id ((struct thread_info *)thread_ptr));
511 if (strcmp ("qSymbol::", own_buf) == 0)
513 if (target_running () && the_target->look_up_symbols != NULL)
514 (*the_target->look_up_symbols) ();
516 strcpy (own_buf, "OK");
520 if (!disable_packet_qfThreadInfo)
522 if (strcmp ("qfThreadInfo", own_buf) == 0)
524 require_running (own_buf);
525 thread_ptr = all_threads.head;
526 sprintf (own_buf, "m%x", thread_to_gdb_id ((struct thread_info *)thread_ptr));
527 thread_ptr = thread_ptr->next;
531 if (strcmp ("qsThreadInfo", own_buf) == 0)
533 require_running (own_buf);
534 if (thread_ptr != NULL)
536 sprintf (own_buf, "m%x", thread_to_gdb_id ((struct thread_info *)thread_ptr));
537 thread_ptr = thread_ptr->next;
542 sprintf (own_buf, "l");
548 if (the_target->read_offsets != NULL
549 && strcmp ("qOffsets", own_buf) == 0)
551 CORE_ADDR text, data;
553 require_running (own_buf);
554 if (the_target->read_offsets (&text, &data))
555 sprintf (own_buf, "Text=%lX;Data=%lX;Bss=%lX",
556 (long)text, (long)data, (long)data);
563 if (the_target->qxfer_spu != NULL
564 && strncmp ("qXfer:spu:read:", own_buf, 15) == 0)
570 unsigned char *spu_buf;
572 require_running (own_buf);
573 strcpy (own_buf, "E00");
574 if (decode_xfer_read (own_buf + 15, &annex, &ofs, &len) < 0)
576 if (len > PBUFSIZ - 2)
578 spu_buf = xmalloc (len + 1);
582 n = (*the_target->qxfer_spu) (annex, spu_buf, NULL, ofs, len + 1);
586 *new_packet_len_p = write_qxfer_response
587 (own_buf, spu_buf, len, 1);
589 *new_packet_len_p = write_qxfer_response
590 (own_buf, spu_buf, n, 0);
596 if (the_target->qxfer_spu != NULL
597 && strncmp ("qXfer:spu:write:", own_buf, 16) == 0)
603 unsigned char *spu_buf;
605 require_running (own_buf);
606 strcpy (own_buf, "E00");
607 spu_buf = xmalloc (packet_len - 15);
610 if (decode_xfer_write (own_buf + 16, packet_len - 16, &annex,
611 &ofs, &len, spu_buf) < 0)
617 n = (*the_target->qxfer_spu)
618 (annex, NULL, (unsigned const char *)spu_buf, ofs, len);
622 sprintf (own_buf, "%x", n);
628 if (the_target->read_auxv != NULL
629 && strncmp ("qXfer:auxv:read:", own_buf, 16) == 0)
637 require_running (own_buf);
639 /* Reject any annex; grab the offset and length. */
640 if (decode_xfer_read (own_buf + 16, &annex, &ofs, &len) < 0
643 strcpy (own_buf, "E00");
647 /* Read one extra byte, as an indicator of whether there is
649 if (len > PBUFSIZ - 2)
651 data = xmalloc (len + 1);
652 n = (*the_target->read_auxv) (ofs, data, len + 1);
656 *new_packet_len_p = write_qxfer_response (own_buf, data, len, 1);
658 *new_packet_len_p = write_qxfer_response (own_buf, data, n, 0);
665 if (strncmp ("qXfer:features:read:", own_buf, 20) == 0)
668 unsigned int len, total_len;
669 const char *document;
672 require_running (own_buf);
674 /* Grab the annex, offset, and length. */
675 if (decode_xfer_read (own_buf + 20, &annex, &ofs, &len) < 0)
677 strcpy (own_buf, "E00");
681 /* Now grab the correct annex. */
682 document = get_features_xml (annex);
683 if (document == NULL)
685 strcpy (own_buf, "E00");
689 total_len = strlen (document);
690 if (len > PBUFSIZ - 2)
695 else if (len < total_len - ofs)
696 *new_packet_len_p = write_qxfer_response (own_buf, document + ofs,
699 *new_packet_len_p = write_qxfer_response (own_buf, document + ofs,
705 if (strncmp ("qXfer:libraries:read:", own_buf, 21) == 0)
708 unsigned int len, total_len;
710 struct inferior_list_entry *dll_ptr;
713 require_running (own_buf);
715 /* Reject any annex; grab the offset and length. */
716 if (decode_xfer_read (own_buf + 21, &annex, &ofs, &len) < 0
719 strcpy (own_buf, "E00");
723 /* Over-estimate the necessary memory. Assume that every character
724 in the library name must be escaped. */
726 for (dll_ptr = all_dlls.head; dll_ptr != NULL; dll_ptr = dll_ptr->next)
727 total_len += 128 + 6 * strlen (((struct dll_info *) dll_ptr)->name);
729 document = xmalloc (total_len);
730 strcpy (document, "<library-list>\n");
731 p = document + strlen (document);
733 for (dll_ptr = all_dlls.head; dll_ptr != NULL; dll_ptr = dll_ptr->next)
735 struct dll_info *dll = (struct dll_info *) dll_ptr;
738 strcpy (p, " <library name=\"");
740 name = xml_escape_text (dll->name);
744 strcpy (p, "\"><segment address=\"");
746 sprintf (p, "0x%lx", (long) dll->base_addr);
748 strcpy (p, "\"/></library>\n");
752 strcpy (p, "</library-list>\n");
754 total_len = strlen (document);
755 if (len > PBUFSIZ - 2)
760 else if (len < total_len - ofs)
761 *new_packet_len_p = write_qxfer_response (own_buf, document + ofs,
764 *new_packet_len_p = write_qxfer_response (own_buf, document + ofs,
771 if (the_target->qxfer_osdata != NULL
772 && strncmp ("qXfer:osdata:read:", own_buf, 18) == 0)
778 unsigned char *workbuf;
780 strcpy (own_buf, "E00");
781 if (decode_xfer_read (own_buf + 18, &annex, &ofs, &len) < 0)
783 if (len > PBUFSIZ - 2)
785 workbuf = xmalloc (len + 1);
789 n = (*the_target->qxfer_osdata) (annex, workbuf, NULL, ofs, len + 1);
793 *new_packet_len_p = write_qxfer_response
794 (own_buf, workbuf, len, 1);
796 *new_packet_len_p = write_qxfer_response
797 (own_buf, workbuf, n, 0);
803 /* Protocol features query. */
804 if (strncmp ("qSupported", own_buf, 10) == 0
805 && (own_buf[10] == ':' || own_buf[10] == '\0'))
807 sprintf (own_buf, "PacketSize=%x;QPassSignals+", PBUFSIZ - 1);
809 /* We do not have any hook to indicate whether the target backend
810 supports qXfer:libraries:read, so always report it. */
811 strcat (own_buf, ";qXfer:libraries:read+");
813 if (the_target->read_auxv != NULL)
814 strcat (own_buf, ";qXfer:auxv:read+");
816 if (the_target->qxfer_spu != NULL)
817 strcat (own_buf, ";qXfer:spu:read+;qXfer:spu:write+");
819 /* We always report qXfer:features:read, as targets may
820 install XML files on a subsequent call to arch_setup.
821 If we reported to GDB on startup that we don't support
822 qXfer:feature:read at all, we will never be re-queried. */
823 strcat (own_buf, ";qXfer:features:read+");
825 if (transport_is_reliable)
826 strcat (own_buf, ";QStartNoAckMode+");
828 if (the_target->qxfer_osdata != NULL)
829 strcat (own_buf, ";qXfer:osdata:read+");
834 /* Thread-local storage support. */
835 if (the_target->get_tls_address != NULL
836 && strncmp ("qGetTLSAddr:", own_buf, 12) == 0)
838 char *p = own_buf + 12;
839 CORE_ADDR parts[3], address = 0;
842 require_running (own_buf);
844 for (i = 0; i < 3; i++)
852 p2 = strchr (p, ',');
864 decode_address (&parts[i], p, len);
868 if (p != NULL || i < 3)
872 struct thread_info *thread = gdb_id_to_thread (parts[0]);
877 err = the_target->get_tls_address (thread, parts[1], parts[2],
883 sprintf (own_buf, "%llx", address);
892 /* Otherwise, pretend we do not understand this packet. */
895 /* Handle "monitor" commands. */
896 if (strncmp ("qRcmd,", own_buf, 6) == 0)
898 char *mon = xmalloc (PBUFSIZ);
899 int len = strlen (own_buf + 6);
901 if ((len % 2) != 0 || unhexify (mon, own_buf + 6, len / 2) != len / 2)
911 if (strcmp (mon, "set debug 1") == 0)
914 monitor_output ("Debug output enabled.\n");
916 else if (strcmp (mon, "set debug 0") == 0)
919 monitor_output ("Debug output disabled.\n");
921 else if (strcmp (mon, "set remote-debug 1") == 0)
924 monitor_output ("Protocol debug output enabled.\n");
926 else if (strcmp (mon, "set remote-debug 0") == 0)
929 monitor_output ("Protocol debug output disabled.\n");
931 else if (strcmp (mon, "help") == 0)
932 monitor_show_help ();
933 else if (strcmp (mon, "exit") == 0)
937 monitor_output ("Unknown monitor command.\n\n");
938 monitor_show_help ();
946 if (strncmp ("qSearch:memory:", own_buf, sizeof ("qSearch:memory:") - 1) == 0)
948 require_running (own_buf);
949 handle_search_memory (own_buf, packet_len);
953 /* Otherwise we didn't know what packet it was. Say we didn't
958 /* Parse vCont packets. */
960 handle_v_cont (char *own_buf, char *status, int *signal)
964 struct thread_resume *resume_info, default_action;
966 /* Count the number of semicolons in the packet. There should be one
975 /* Allocate room for one extra action, for the default remain-stopped
976 behavior; if no default action is in the list, we'll need the extra
978 resume_info = xmalloc ((n + 1) * sizeof (resume_info[0]));
980 default_action.thread = -1;
981 default_action.leave_stopped = 1;
982 default_action.step = 0;
983 default_action.sig = 0;
991 resume_info[i].leave_stopped = 0;
993 if (p[0] == 's' || p[0] == 'S')
994 resume_info[i].step = 1;
995 else if (p[0] == 'c' || p[0] == 'C')
996 resume_info[i].step = 0;
1000 if (p[0] == 'S' || p[0] == 'C')
1003 sig = strtol (p + 1, &q, 16);
1008 if (!target_signal_to_host_p (sig))
1010 resume_info[i].sig = target_signal_to_host (sig);
1014 resume_info[i].sig = 0;
1020 resume_info[i].thread = -1;
1021 default_action = resume_info[i];
1023 /* Note: we don't increment i here, we'll overwrite this entry
1024 the next time through. */
1026 else if (p[0] == ':')
1028 unsigned int gdb_id = strtoul (p + 1, &q, 16);
1029 unsigned long thread_id;
1034 if (p[0] != ';' && p[0] != 0)
1037 thread_id = gdb_id_to_thread_id (gdb_id);
1039 resume_info[i].thread = thread_id;
1047 resume_info[i] = default_action;
1049 /* Still used in occasional places in the backend. */
1050 if (n == 1 && resume_info[0].thread != -1)
1051 cont_thread = resume_info[0].thread;
1054 set_desired_inferior (0);
1057 (*the_target->resume) (resume_info);
1061 *signal = mywait (status, 1);
1062 prepare_resume_reply (own_buf, *status, *signal);
1063 disable_async_io ();
1067 write_enn (own_buf);
1072 /* Attach to a new program. Return 1 if successful, 0 if failure. */
1074 handle_v_attach (char *own_buf, char *status, int *signal)
1078 pid = strtol (own_buf + 8, NULL, 16);
1079 if (pid != 0 && attach_inferior (pid, status, signal) == 0)
1081 /* Don't report shared library events after attaching, even if
1082 some libraries are preloaded. GDB will always poll the
1083 library list. Avoids the "stopped by shared library event"
1084 notice on the GDB side. */
1086 prepare_resume_reply (own_buf, *status, *signal);
1091 write_enn (own_buf);
1096 /* Run a new program. Return 1 if successful, 0 if failure. */
1098 handle_v_run (char *own_buf, char *status, int *signal)
1100 char *p, **pp, *next_p, **new_argv;
1104 for (p = own_buf + strlen ("vRun;"); p && *p; p = strchr (p, ';'))
1110 new_argv = xcalloc (new_argc + 2, sizeof (char *));
1112 for (p = own_buf + strlen ("vRun;"); *p; p = next_p)
1114 next_p = strchr (p, ';');
1116 next_p = p + strlen (p);
1118 if (i == 0 && p == next_p)
1122 new_argv[i] = xmalloc (1 + (next_p - p) / 2);
1123 unhexify (new_argv[i], p, (next_p - p) / 2);
1124 new_argv[i][(next_p - p) / 2] = '\0';
1133 if (new_argv[0] == NULL)
1135 /* GDB didn't specify a program to run. Use the program from the
1136 last run with the new argument list. */
1138 if (program_argv == NULL)
1140 write_enn (own_buf);
1144 new_argv[0] = xstrdup (program_argv[0]);
1147 /* Free the old argv. */
1150 for (pp = program_argv; *pp != NULL; pp++)
1152 free (program_argv);
1154 program_argv = new_argv;
1156 *signal = start_inferior (program_argv, status);
1159 prepare_resume_reply (own_buf, *status, *signal);
1164 write_enn (own_buf);
1169 /* Handle all of the extended 'v' packets. */
1171 handle_v_requests (char *own_buf, char *status, int *signal,
1172 int packet_len, int *new_packet_len)
1174 if (!disable_packet_vCont)
1176 if (strncmp (own_buf, "vCont;", 6) == 0)
1178 require_running (own_buf);
1179 handle_v_cont (own_buf, status, signal);
1183 if (strncmp (own_buf, "vCont?", 6) == 0)
1185 strcpy (own_buf, "vCont;c;C;s;S");
1190 if (strncmp (own_buf, "vFile:", 6) == 0
1191 && handle_vFile (own_buf, packet_len, new_packet_len))
1194 if (strncmp (own_buf, "vAttach;", 8) == 0)
1196 if (target_running ())
1198 fprintf (stderr, "Already debugging a process\n");
1199 write_enn (own_buf);
1202 handle_v_attach (own_buf, status, signal);
1206 if (strncmp (own_buf, "vRun;", 5) == 0)
1208 if (target_running ())
1210 fprintf (stderr, "Already debugging a process\n");
1211 write_enn (own_buf);
1214 handle_v_run (own_buf, status, signal);
1218 /* Otherwise we didn't know what packet it was. Say we didn't
1225 myresume (char *own_buf, int step, int *signalp, char *statusp)
1227 struct thread_resume resume_info[2];
1231 set_desired_inferior (0);
1233 if (step || sig || (cont_thread != 0 && cont_thread != -1))
1235 resume_info[0].thread
1236 = ((struct inferior_list_entry *) current_inferior)->id;
1237 resume_info[0].step = step;
1238 resume_info[0].sig = sig;
1239 resume_info[0].leave_stopped = 0;
1242 resume_info[n].thread = -1;
1243 resume_info[n].step = 0;
1244 resume_info[n].sig = 0;
1245 resume_info[n].leave_stopped = (cont_thread != 0 && cont_thread != -1);
1248 (*the_target->resume) (resume_info);
1249 *signalp = mywait (statusp, 1);
1250 prepare_resume_reply (own_buf, *statusp, *signalp);
1251 disable_async_io ();
1255 gdbserver_version (void)
1257 printf ("GNU gdbserver %s%s\n"
1258 "Copyright (C) 2009 Free Software Foundation, Inc.\n"
1259 "gdbserver is free software, covered by the GNU General Public License.\n"
1260 "This gdbserver was configured as \"%s\"\n",
1261 PKGVERSION, version, host_name);
1265 gdbserver_usage (FILE *stream)
1267 fprintf (stream, "Usage:\tgdbserver [OPTIONS] COMM PROG [ARGS ...]\n"
1268 "\tgdbserver [OPTIONS] --attach COMM PID\n"
1269 "\tgdbserver [OPTIONS] --multi COMM\n"
1271 "COMM may either be a tty device (for serial debugging), or \n"
1272 "HOST:PORT to listen for a TCP connection.\n"
1275 " --debug\t\tEnable debugging output.\n"
1276 " --version\t\tDisplay version information and exit.\n"
1277 " --wrapper WRAPPER --\tRun WRAPPER to start new programs.\n");
1278 if (REPORT_BUGS_TO[0] && stream == stdout)
1279 fprintf (stream, "Report bugs to \"%s\".\n", REPORT_BUGS_TO);
1283 gdbserver_show_disableable (FILE *stream)
1285 fprintf (stream, "Disableable packets:\n"
1286 " vCont \tAll vCont packets\n"
1287 " qC \tQuerying the current thread\n"
1288 " qfThreadInfo\tThread listing\n"
1289 " Tthread \tPassing the thread specifier in the T stop reply packet\n"
1290 " threads \tAll of the above\n");
1294 #undef require_running
1295 #define require_running(BUF) \
1296 if (!target_running ()) \
1303 main (int argc, char *argv[])
1305 char ch, status, *own_buf;
1306 unsigned char *mem_buf;
1313 char *arg_end, *port;
1314 char **next_arg = &argv[1];
1319 while (*next_arg != NULL && **next_arg == '-')
1321 if (strcmp (*next_arg, "--version") == 0)
1323 gdbserver_version ();
1326 else if (strcmp (*next_arg, "--help") == 0)
1328 gdbserver_usage (stdout);
1331 else if (strcmp (*next_arg, "--attach") == 0)
1333 else if (strcmp (*next_arg, "--multi") == 0)
1335 else if (strcmp (*next_arg, "--wrapper") == 0)
1339 wrapper_argv = next_arg;
1340 while (*next_arg != NULL && strcmp (*next_arg, "--") != 0)
1343 if (next_arg == wrapper_argv || *next_arg == NULL)
1345 gdbserver_usage (stderr);
1349 /* Consume the "--". */
1352 else if (strcmp (*next_arg, "--debug") == 0)
1354 else if (strcmp (*next_arg, "--disable-packet") == 0)
1356 gdbserver_show_disableable (stdout);
1359 else if (strncmp (*next_arg,
1360 "--disable-packet=",
1361 sizeof ("--disable-packet=") - 1) == 0)
1363 char *packets, *tok;
1365 packets = *next_arg += sizeof ("--disable-packet=") - 1;
1366 for (tok = strtok (packets, ",");
1368 tok = strtok (NULL, ","))
1370 if (strcmp ("vCont", tok) == 0)
1371 disable_packet_vCont = 1;
1372 else if (strcmp ("Tthread", tok) == 0)
1373 disable_packet_Tthread = 1;
1374 else if (strcmp ("qC", tok) == 0)
1375 disable_packet_qC = 1;
1376 else if (strcmp ("qfThreadInfo", tok) == 0)
1377 disable_packet_qfThreadInfo = 1;
1378 else if (strcmp ("threads", tok) == 0)
1380 disable_packet_vCont = 1;
1381 disable_packet_Tthread = 1;
1382 disable_packet_qC = 1;
1383 disable_packet_qfThreadInfo = 1;
1387 fprintf (stderr, "Don't know how to disable \"%s\".\n\n",
1389 gdbserver_show_disableable (stderr);
1396 fprintf (stderr, "Unknown argument: %s\n", *next_arg);
1404 if (setjmp (toplevel))
1406 fprintf (stderr, "Exiting\n");
1412 if (port == NULL || (!attach && !multi_mode && *next_arg == NULL))
1414 gdbserver_usage (stderr);
1421 /* --attach used to come after PORT, so allow it there for
1423 if (*next_arg != NULL && strcmp (*next_arg, "--attach") == 0)
1430 && (*next_arg == NULL
1431 || (*next_arg)[0] == '\0'
1432 || (pid = strtoul (*next_arg, &arg_end, 0)) == 0
1434 || next_arg[1] != NULL))
1439 gdbserver_usage (stderr);
1443 initialize_async_io ();
1446 own_buf = xmalloc (PBUFSIZ + 1);
1447 mem_buf = xmalloc (PBUFSIZ);
1449 if (pid == 0 && *next_arg != NULL)
1453 n = argc - (next_arg - argv);
1454 program_argv = xmalloc (sizeof (char *) * (n + 1));
1455 for (i = 0; i < n; i++)
1456 program_argv[i] = xstrdup (next_arg[i]);
1457 program_argv[i] = NULL;
1459 /* Wait till we are at first instruction in program. */
1460 signal = start_inferior (program_argv, &status);
1462 /* We are now (hopefully) stopped at the first instruction of
1463 the target process. This assumes that the target process was
1464 successfully created. */
1468 if (attach_inferior (pid, &status, &signal) == -1)
1469 error ("Attaching not supported on this target");
1471 /* Otherwise succeeded. */
1479 /* Don't report shared library events on the initial connection,
1480 even if some libraries are preloaded. Avoids the "stopped by
1481 shared library event" notice on gdb side. */
1484 if (setjmp (toplevel))
1486 fprintf (stderr, "Killing inferior\n");
1491 if (status == 'W' || status == 'X')
1496 if (!was_running && !multi_mode)
1498 fprintf (stderr, "No program to debug. GDBserver exiting.\n");
1508 if (setjmp (toplevel) != 0)
1510 /* An error occurred. */
1511 if (response_needed)
1513 write_enn (own_buf);
1518 disable_async_io ();
1519 while (!exit_requested)
1523 int new_packet_len = -1;
1525 response_needed = 0;
1526 packet_len = getpkt (own_buf);
1527 if (packet_len <= 0)
1529 response_needed = 1;
1536 handle_query (own_buf, packet_len, &new_packet_len);
1539 handle_general_set (own_buf);
1542 require_running (own_buf);
1543 fprintf (stderr, "Detaching from inferior\n");
1544 if (detach_inferior () != 0)
1545 write_enn (own_buf);
1550 if (extended_protocol)
1552 /* Treat this like a normal program exit. */
1561 /* If we are attached, then we can exit. Otherwise, we
1562 need to hang around doing nothing, until the child
1572 extended_protocol = 1;
1576 prepare_resume_reply (own_buf, status, signal);
1579 if (own_buf[1] == 'c' || own_buf[1] == 'g' || own_buf[1] == 's')
1581 unsigned long gdb_id, thread_id;
1583 require_running (own_buf);
1584 gdb_id = strtoul (&own_buf[2], NULL, 16);
1585 if (gdb_id == 0 || gdb_id == -1)
1589 thread_id = gdb_id_to_thread_id (gdb_id);
1592 write_enn (own_buf);
1597 if (own_buf[1] == 'g')
1599 general_thread = thread_id;
1600 set_desired_inferior (1);
1602 else if (own_buf[1] == 'c')
1603 cont_thread = thread_id;
1604 else if (own_buf[1] == 's')
1605 step_thread = thread_id;
1611 /* Silently ignore it so that gdb can extend the protocol
1612 without compatibility headaches. */
1617 require_running (own_buf);
1618 set_desired_inferior (1);
1619 registers_to_string (own_buf);
1622 require_running (own_buf);
1623 set_desired_inferior (1);
1624 registers_from_string (&own_buf[1]);
1628 require_running (own_buf);
1629 decode_m_packet (&own_buf[1], &mem_addr, &len);
1630 if (read_inferior_memory (mem_addr, mem_buf, len) == 0)
1631 convert_int_to_ascii (mem_buf, own_buf, len);
1633 write_enn (own_buf);
1636 require_running (own_buf);
1637 decode_M_packet (&own_buf[1], &mem_addr, &len, mem_buf);
1638 if (write_inferior_memory (mem_addr, mem_buf, len) == 0)
1641 write_enn (own_buf);
1644 require_running (own_buf);
1645 if (decode_X_packet (&own_buf[1], packet_len - 1,
1646 &mem_addr, &len, mem_buf) < 0
1647 || write_inferior_memory (mem_addr, mem_buf, len) != 0)
1648 write_enn (own_buf);
1653 require_running (own_buf);
1654 convert_ascii_to_int (own_buf + 1, &sig, 1);
1655 if (target_signal_to_host_p (sig))
1656 signal = target_signal_to_host (sig);
1659 myresume (own_buf, 0, &signal, &status);
1662 require_running (own_buf);
1663 convert_ascii_to_int (own_buf + 1, &sig, 1);
1664 if (target_signal_to_host_p (sig))
1665 signal = target_signal_to_host (sig);
1668 myresume (own_buf, 1, &signal, &status);
1671 require_running (own_buf);
1673 myresume (own_buf, 0, &signal, &status);
1676 require_running (own_buf);
1678 myresume (own_buf, 1, &signal, &status);
1684 CORE_ADDR addr = strtoul (&own_buf[3], &lenptr, 16);
1685 int len = strtol (lenptr + 1, &dataptr, 16);
1686 char type = own_buf[1];
1688 if (the_target->insert_watchpoint == NULL
1689 || (type < '2' || type > '4'))
1691 /* No watchpoint support or not a watchpoint command;
1692 unrecognized either way. */
1699 require_running (own_buf);
1700 res = (*the_target->insert_watchpoint) (type, addr, len);
1707 write_enn (own_buf);
1715 CORE_ADDR addr = strtoul (&own_buf[3], &lenptr, 16);
1716 int len = strtol (lenptr + 1, &dataptr, 16);
1717 char type = own_buf[1];
1719 if (the_target->remove_watchpoint == NULL
1720 || (type < '2' || type > '4'))
1722 /* No watchpoint support or not a watchpoint command;
1723 unrecognized either way. */
1730 require_running (own_buf);
1731 res = (*the_target->remove_watchpoint) (type, addr, len);
1738 write_enn (own_buf);
1743 response_needed = 0;
1744 if (!target_running ())
1745 /* The packet we received doesn't make sense - but we
1746 can't reply to it, either. */
1749 fprintf (stderr, "Killing inferior\n");
1752 /* When using the extended protocol, we wait with no
1753 program running. The traditional protocol will exit
1755 if (extended_protocol)
1758 signal = TARGET_SIGNAL_KILL;
1769 unsigned long gdb_id, thread_id;
1771 require_running (own_buf);
1772 gdb_id = strtoul (&own_buf[1], NULL, 16);
1773 thread_id = gdb_id_to_thread_id (gdb_id);
1776 write_enn (own_buf);
1780 if (mythread_alive (thread_id))
1783 write_enn (own_buf);
1787 response_needed = 0;
1789 /* Restarting the inferior is only supported in the
1790 extended protocol. */
1791 if (extended_protocol)
1793 if (target_running ())
1795 fprintf (stderr, "GDBserver restarting\n");
1797 /* Wait till we are at 1st instruction in prog. */
1798 if (program_argv != NULL)
1799 signal = start_inferior (program_argv, &status);
1803 signal = TARGET_SIGNAL_KILL;
1809 /* It is a request we don't understand. Respond with an
1810 empty packet so that gdb knows that we don't support this
1816 /* Extended (long) request. */
1817 handle_v_requests (own_buf, &status, &signal,
1818 packet_len, &new_packet_len);
1822 /* It is a request we don't understand. Respond with an
1823 empty packet so that gdb knows that we don't support this
1829 if (new_packet_len != -1)
1830 putpkt_binary (own_buf, new_packet_len);
1834 response_needed = 0;
1836 if (was_running && (status == 'W' || status == 'X'))
1842 "\nChild exited with status %d\n", signal);
1844 fprintf (stderr, "\nChild terminated with signal = 0x%x (%s)\n",
1845 target_signal_to_host (signal),
1846 target_signal_to_name (signal));
1848 if (extended_protocol)
1852 fprintf (stderr, "GDBserver exiting\n");
1857 if (status != 'W' && status != 'X')
1861 /* If an exit was requested (using the "monitor exit" command),
1862 terminate now. The only other way to get here is for
1863 getpkt to fail; close the connection and reopen it at the
1869 if (attached && target_running ())
1871 else if (target_running ())
1877 fprintf (stderr, "Remote side has terminated connection. "
1878 "GDBserver will reopen the connection.\n");